{"_id":"@a1local/adpages-reporting","name":"@a1local/adpages-reporting","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@a1local/adpages-reporting","version":"0.1.0","description":"Dependency-free report formatting helpers for AdPages audit exports.","type":"module","license":"MIT","author":{"name":"A1 Local","url":"https://a1local.com.au/"},"homepage":"https://github.com/a1local/adpages-reporting#readme","repository":{"type":"git","url":"git+https://github.com/a1local/adpages-reporting.git"},"bugs":{"url":"https://github.com/a1local/adpages-reporting/issues"},"funding":{"type":"custom","url":"https://a1local.com.au/extensions/"},"publishConfig":{"access":"public"},"sideEffects":false,"main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"scripts":{"build":"tsc -p tsconfig.json","lint":"tsc --noEmit -p tsconfig.json","prepublishOnly":"npm run build"},"keywords":["adpages","reporting","csv","landing-pages","google-ads"],"devDependencies":{"typescript":"^5.9.3"},"gitHead":"0051b08e303680b1f851a3980ab4207b2b954405","_id":"@a1local/adpages-reporting@0.1.0","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-0k3fV2e/w1SaI3sLMb3f9suERFNm2hPohQDtXqJ/vZ8zweQsgadfNFuG5NhD3RmphaDPLyeVy5trW//MjvIoTw==","shasum":"dbd7827ffbb46395b7dfccba37aa045b7e4ac45a","tarball":"https://registry.npmjs.org/@a1local/adpages-reporting/-/adpages-reporting-0.1.0.tgz","fileCount":9,"unpackedSize":32665,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD7+IazeryPo1larlHRbXnbcExcDli0zFeSSqhSd6uiTgIhAPKnqBsxr+rlm+gHjIHbJFaBtcqpQ8HauxvhLcCRrMUH"}]},"_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-reporting_0.1.0_1779689324665_0.553756849441027"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-25T06:08:44.504Z","0.1.0":"2026-05-25T06:08:44.807Z","modified":"2026-05-25T06:08:45.028Z"},"maintainers":[{"name":"a1local","email":"extensions@a1local.com.au"}],"description":"Dependency-free report formatting helpers for AdPages audit exports.","homepage":"https://github.com/a1local/adpages-reporting#readme","keywords":["adpages","reporting","csv","landing-pages","google-ads"],"repository":{"type":"git","url":"git+https://github.com/a1local/adpages-reporting.git"},"author":{"name":"A1 Local","url":"https://a1local.com.au/"},"bugs":{"url":"https://github.com/a1local/adpages-reporting/issues"},"license":"MIT","readme":"# @a1local/adpages-reporting\n\nDependency-free report formatting helpers for AdPages exports.\n\nThis package is intentionally separate from `@a1local/adpages-audit-core`. It accepts plain audit-like objects and checklist-like rows, so browser extensions, the CLI, GitHub Actions, Google Sheets, WordPress, and later paid report surfaces can reuse the same export helpers without pulling in a specific audit engine.\n\n## What is included\n\n- CSV escaping and row formatting for spreadsheet-safe checklist exports.\n- Checklist CSV rows from generic result objects with fields like `id`, `category`, `status`, `impact`, `title`, `summary`, `recommendation`, `evidence`, and `weight`.\n- Client report metadata normalization for extension, CLI, GitHub Action, Sheets, WordPress, and paid report sources.\n- A simple JSON artifact wrapper for storing audit payloads, metadata, summaries, results, and report notes.\n- Report surface notes that mark current free exports and planned paid report formats.\n\n## Basic Usage\n\n```ts\nimport {\n  createClientReportMetadata,\n  createJsonArtifact,\n  createReportNotes,\n  renderChecklistCsv\n} from \"@a1local/adpages-reporting\";\n\nconst metadata = createClientReportMetadata({\n  clientName: \"Example Plumbing\",\n  projectName: \"Emergency plumber landing page\",\n  url: \"https://example.com/emergency-plumber/\",\n  source: \"extension\"\n});\n\nconst csv = renderChecklistCsv(audit.results);\nconst artifact = createJsonArtifact({\n  metadata,\n  report: audit,\n  notes: createReportNotes()\n});\n```\n\n## Free and Paid Surfaces\n\nThe free reporting surface should stay practical and portable:\n\n- CSV for spreadsheet review and lightweight handoff.\n- Markdown for readable local, CLI, GitHub Action, and pull-request comments.\n- JSON for extension storage, CLI output, automation artifacts, and integration handoff.\n\nLater paid surfaces can build on the same metadata and normalized artifact:\n\n- branded PDF reports\n- batch client reports\n- white-label agency reports\n- Google Sheets add-on exports\n- WordPress admin reports\n\nThis package only prepares the shared reporting shape. It does not include PDF rendering, billing, license checks, remote crawling, account syncing, or WordPress/Sheets APIs.\n\n## Generic Audit Input\n\nHelpers do not import `@a1local/adpages-audit-core`. They work with audit-core-like results, for example:\n\n```ts\nconst rows = renderChecklistCsv([\n  {\n    id: \"cta-phone\",\n    category: \"conversion\",\n    status: \"warn\",\n    impact: \"important\",\n    title: \"Phone CTA is hard to find\",\n    summary: \"The primary phone CTA appears below the first viewport.\",\n    recommendation: \"Move click-to-call into the hero.\"\n  }\n]);\n```\n","readmeFilename":"README.md","_rev":"1-0c1bf243edf67e5b5c996029c87e6bd1"}