{"_id":"@a1local/adpages-vercel-deployment-audit","name":"@a1local/adpages-vercel-deployment-audit","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@a1local/adpages-vercel-deployment-audit","version":"0.1.0","private":false,"description":"Local-first Vercel build-step audit for static AdPages and local-service landing pages.","type":"module","license":"MIT","homepage":"https://a1local.com.au/extensions/","repository":{"type":"git","url":"git+https://github.com/a1local/adpages-vercel-deployment-audit.git"},"bugs":{"url":"https://a1local.com.au/extensions/support/"},"bin":{"adpages-vercel-audit":"bin/adpages-vercel-audit.mjs"},"keywords":["adpages","vercel","deployment","landing-page","local-seo","static-site","qa"],"engines":{"node":">=18"},"scripts":{"check":"node --check bin/adpages-vercel-audit.mjs && node --check src/audit.mjs && node --check scripts/check.mjs && node scripts/check.mjs","smoke":"node bin/adpages-vercel-audit.mjs --scan-path examples/site --report-path examples/reports/adpages-vercel-audit.json --fail-on never"},"gitHead":"0051b08e303680b1f851a3980ab4207b2b954405","_id":"@a1local/adpages-vercel-deployment-audit@0.1.0","_nodeVersion":"26.0.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-yaPD2Rg4nn1HiRQlX80V7O+dRoUzAc6k6A3jnrQHMyVPO2Rv5u6ZKks2WI03fOo2io15en5xFFqN054s0vOSfg==","shasum":"d5e81153a55aef374a09b146b99653a02181b0ca","tarball":"https://registry.npmjs.org/@a1local/adpages-vercel-deployment-audit/-/adpages-vercel-deployment-audit-0.1.0.tgz","fileCount":13,"unpackedSize":41649,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICP7HqEzGjin11Lye3FN2HtoOo5fN15Bx0P67au5MCwtAiEAr1Te2WRwRWOuZt3P9wce74hAF/lXibIUmoy/wrlAZUo="}]},"_npmUser":{"name":"a1local","email":"extensions@a1local.com.au"},"directories":{},"maintainers":[{"name":"a1local","email":"extensions@a1local.com.au"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/adpages-vercel-deployment-audit_0.1.0_1779706808753_0.6327709589389041"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-25T11:00:08.574Z","0.1.0":"2026-05-25T11:00:08.882Z","modified":"2026-05-25T11:00:09.037Z"},"maintainers":[{"name":"a1local","email":"extensions@a1local.com.au"}],"description":"Local-first Vercel build-step audit for static AdPages and local-service landing pages.","homepage":"https://a1local.com.au/extensions/","keywords":["adpages","vercel","deployment","landing-page","local-seo","static-site","qa"],"repository":{"type":"git","url":"git+https://github.com/a1local/adpages-vercel-deployment-audit.git"},"bugs":{"url":"https://a1local.com.au/extensions/support/"},"license":"MIT","readme":"# AdPages Deployment Audit for Vercel\n\nLocal-first Vercel build-step scaffold for static AdPages and local-service landing pages.\n\nThe command scans generated HTML after a build and reports common paid-traffic and local SEO deployment risks before the deployment goes live:\n\n- title, meta description, responsive viewport, H1, and canonical signals;\n- CTA, phone, email, form, and service-area signals;\n- JSON-LD, `schema.org`, and LocalBusiness markers;\n- common analytics and conversion tracking markers;\n- placeholder, localhost, preview-domain, and `example.com` leaks;\n- missing local static asset references.\n\nIt does not fetch deployment URLs, execute browser JavaScript, call third-party APIs, inject links, or send page contents anywhere.\n\n## Status\n\nThis is a distribution-ready scaffold, not a submitted Vercel Marketplace native product.\n\nUseful near-term publication paths:\n\n- npm package used from a Vercel `buildCommand`;\n- Vercel docs/tutorial snippet for local-service deployment QA;\n- GitHub template example for static landing pages;\n- future Vercel Marketplace native product if a provider server is intentionally added.\n\n## Local Usage\n\n```sh\nnpm --prefix integrations/vercel/adpages-deployment-audit run check\nnpm --prefix integrations/vercel/adpages-deployment-audit run smoke\n```\n\nRun the CLI against a generated static site:\n\n```sh\nnode integrations/vercel/adpages-deployment-audit/bin/adpages-vercel-audit.mjs \\\n  --scan-path dist \\\n  --report-path adpages-vercel-deployment-audit.json \\\n  --fail-on never\n```\n\n## Vercel Build Usage\n\nAfter publishing the package, install it in a static-site project and add a build audit script:\n\n```json\n{\n  \"scripts\": {\n    \"build\": \"astro build\",\n    \"adpages:vercel-audit\": \"adpages-vercel-audit --scan-path dist --report-path adpages-vercel-deployment-audit.json --fail-on error\",\n    \"vercel-build\": \"npm run build && npm run adpages:vercel-audit\"\n  },\n  \"devDependencies\": {\n    \"@adpages/vercel-deployment-audit\": \"0.1.0\"\n  }\n}\n```\n\nThen configure Vercel to run the combined build step:\n\n```json\n{\n  \"$schema\": \"https://openapi.vercel.sh/vercel.json\",\n  \"buildCommand\": \"npm run vercel-build\",\n  \"outputDirectory\": \"dist\"\n}\n```\n\nThe included `examples/vercel.json` mirrors Vercel's file-based project configuration model, where `buildCommand` and `outputDirectory` can be defined in the repository.\n\n## CLI Options\n\n| Option | Default | Description |\n| --- | --- | --- |\n| `--scan-path` | `dist` | Static output directory or one HTML file to inspect. |\n| `--report-path` | `adpages-vercel-deployment-audit.json` | JSON report path. Pass an empty value to skip writing a report. |\n| `--fail-on` | `never` | Build failure mode: `never`, `error`, or `warning`. |\n| `--max-pages` | `50` | Maximum number of HTML files to inspect. |\n| `--format` | `text` | Console output format: `text` or `json`. |\n\n## Marketplace Notes\n\nThe `marketplace/product-metadata.schema.json` file is a draft configuration schema for a future native Vercel Marketplace product.\n\nIt is intentionally not enough to publish a native product by itself. Vercel native products currently require an approved provider setup and a provider integration server with a Base URL. That is a deliberate blocker for this scaffold because the current artifact avoids hosted backend assumptions.\n\n## Privacy\n\nSee `PRIVACY.md`. In short: this tool reads local build files, reads a small allowlist of public Vercel build metadata environment variables when present, and writes a local report. It does not require secrets.\n\n## Publish Blockers\n\n- Choose final package ownership, public repository URL, support URL, and license file.\n- Test inside at least one real Vercel project using `vercel build`.\n- Decide whether JSON reports should be persisted as build artifacts, ignored, or copied into deployment output.\n- Add screenshots/docs page before template or marketplace promotion.\n- For native Vercel Marketplace publication, add and audit a provider integration server, Base URL, terms, privacy URL, billing stance, and review submission path.\n","readmeFilename":"README.md","_rev":"1-ee719c7a4c9cd6464d3d4663f3717ab7"}