{"_id":"@advertising-chat/sdk","name":"@advertising-chat/sdk","dist-tags":{"latest":"0.2.1"},"versions":{"0.2.1":{"name":"@advertising-chat/sdk","version":"0.2.1","description":"Typed client for the Advertising.chat ads API — fetch, click, and event tracking plus per-channel render helpers","license":"MIT","author":{"name":"Advertising.chat"},"homepage":"https://docs.advertising.chat/","repository":{"type":"git","url":"git+https://github.com/advertising-chat/adkit.git","directory":"packages/sdk"},"keywords":["advertising","ads","chatbot","llm","monetization","conversational-ai"],"main":"bin/index.js","types":"bin/index.d.ts","scripts":{"build":"tsc -p .","clean":"rm -rf ./bin","prepack":"npm run clean && npm run build","test":"mocha"},"engines":{"node":">=18"},"_id":"@advertising-chat/sdk@0.2.1","gitHead":"b2fd51fa84823a3ac6767e0c50d60d6986048486","bugs":{"url":"https://github.com/advertising-chat/adkit/issues"},"_nodeVersion":"22.13.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-WP6uauO07p4dQ2Sco5TXxjfTWX4Td1lZkUlaoK/uFCawuFnyxEzqd9SS9LCC2MGnb9Yoqj9donzF7cbKWICNmA==","shasum":"d985e1f999948d92aea57baff173d49ad3f0093b","tarball":"https://registry.npmjs.org/@advertising-chat/sdk/-/sdk-0.2.1.tgz","fileCount":17,"unpackedSize":35211,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIANYy/mh0CYOD3aDE7NqdS/er3A4GMBj71vpCF+RuQ0fAiBFj0M+VnodYveslVGdmCY2/bavMKwQFVdI6FLg40BsbQ=="}]},"_npmUser":{"name":"myk","email":"myk@mykwillis.com"},"directories":{},"maintainers":[{"name":"myk","email":"myk@mykwillis.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_0.2.1_1783137054723_0.5207179062584437"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-04T03:50:54.570Z","0.2.1":"2026-07-04T03:50:54.849Z","modified":"2026-07-04T03:50:55.121Z"},"maintainers":[{"name":"myk","email":"myk@mykwillis.com"}],"description":"Typed client for the Advertising.chat ads API — fetch, click, and event tracking plus per-channel render helpers","homepage":"https://docs.advertising.chat/","keywords":["advertising","ads","chatbot","llm","monetization","conversational-ai"],"repository":{"type":"git","url":"git+https://github.com/advertising-chat/adkit.git","directory":"packages/sdk"},"author":{"name":"Advertising.chat"},"bugs":{"url":"https://github.com/advertising-chat/adkit/issues"},"license":"MIT","readme":"# @advertising-chat/sdk\n\nTyped client for the [Advertising.chat](https://advertising.chat) ads API —\nfetch ads, track clicks and conversions, and render payloads for your\nchannel. Zero runtime dependencies (uses native `fetch`, Node >= 18).\n\n```bash\nnpm install @advertising-chat/sdk\n```\n\n```ts\nimport { AdChat, renderWebchat, renderWhatsApp, UniversalAdPayload } from '@advertising-chat/sdk';\n\nconst adchat = new AdChat({ apiKey: process.env.ADCHAT_API_KEY! });\n\n// Fetch an ad, passing conversation context for relevance.\nconst ad = await adchat.fetchAd<UniversalAdPayload>({\n  adUnit: 'my-ad-unit',\n  subscriber: sessionId, // anonymous id — enables frequency capping\n  context: [\n    { role: 'user', text: 'Best hotels in Rome?' },\n    { role: 'assistant', text: 'Here are three options...' },\n  ],\n});\n\nif (ad) {\n  // null means no-fill: continue without an ad.\n  const msg = renderWebchat(ad.payload); // { text, imageUrl, buttons, disclosure }\n  const wa = renderWhatsApp(ad.payload); // WhatsApp Cloud API message object\n\n  // Button URLs are click-tracking URLs (302 to the advertiser) — use verbatim.\n  await adchat.recordEvent({ messageId: ad.messageId, type: 'send' });\n  await adchat.recordConversion({ messageId: ad.messageId, name: 'purchase', value: 19.99, currency: 'USD' });\n}\n```\n\nAlways present ads clearly labeled as **Sponsored**.\n\nFull quickstarts: [docs.advertising.chat](https://docs.advertising.chat).\nPart of [AdKit](https://github.com/advertising-chat/adkit) — see also\n`@advertising-chat/mcp` (MCP server) and the Ad Skill.\n","readmeFilename":"README.md","_rev":"1-42623a393f656a19b255797e98d5d794"}