{"_id":"@agora-sdk/public-read-react-js","_rev":"2-0f83225ad4245211a8627747ba162ef4","name":"@agora-sdk/public-read-react-js","dist-tags":{"latest":"0.11.1"},"versions":{"0.11.0":{"name":"@agora-sdk/public-read-react-js","version":"0.11.0","keywords":["agora","public","anonymous","comments","embed","read-only","react","web","typescript"],"author":{"name":"Agora SDK Plus, maintained by Jenova Marie"},"license":"Apache-2.0","_id":"@agora-sdk/public-read-react-js@0.11.0","maintainers":[{"name":"jenova-marie","email":"jenova-marie@proton.me"}],"homepage":"https://github.com/agora-oss-org/agora-sdk-plus","bugs":{"url":"https://github.com/agora-oss-org/agora-sdk-plus/issues"},"dist":{"shasum":"c5337371214ab469e5ed8cbe67386509dbbcfa18","tarball":"https://registry.npmjs.org/@agora-sdk/public-read-react-js/-/public-read-react-js-0.11.0.tgz","fileCount":13,"integrity":"sha512-YLzIoSlk1UVpGBJjxNS8JF18W4+3LUs6u5ktR78sqmzymwT+52ZR3LVvT7/JS6arVembwB8vBvaFMYKQ04R78w==","signatures":[{"sig":"MEUCIQDpfrfFQbhY5kQ/ReaWVoQSNbYVqI490IDRvMfnicm4UAIgVOMy9jidKIR3we1/yRiT37YnOAQ2N9/XEC9Z+GAiZz0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agora-sdk%2fpublic-read-react-js@0.11.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":46517},"main":"dist/esm/index.js","type":"module","_from":"file:agora-sdk-public-read-react-js-0.11.0.tgz","types":"dist/esm/index.d.ts","module":"dist/esm/index.js","private":false,"scripts":{"build":"rimraf dist && pnpm run build:esm && pnpm run copy:docs","build:esm":"tsc -p tsconfig.esm.json","copy:docs":"cp ../../../docs/PUBLIC-READ.md ./PUBLIC-READ.md","prepublish":"pnpm run build"},"_npmUser":{"name":"jenova-marie","email":"jenova-marie@proton.me"},"_resolved":"/tmp/32df08bb41192602bf0cab6857b4416c/agora-sdk-public-read-react-js-0.11.0.tgz","_integrity":"sha512-YLzIoSlk1UVpGBJjxNS8JF18W4+3LUs6u5ktR78sqmzymwT+52ZR3LVvT7/JS6arVembwB8vBvaFMYKQ04R78w==","repository":{"url":"git+https://github.com/agora-oss-org/agora-sdk-plus.git","type":"git","directory":"packages/public-read/react-js"},"_npmVersion":"10.8.2","description":"Web components for the Agora anonymous public surface: a drop-in, read-only comment thread a blog can embed with no account and no Agora SDK installed. Re-exports @agora-sdk/public-read-core.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"@agora-sdk/public-read-core":"0.11.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"comment:esm-only":"ESM-only to match social-react-js and secure-chat-react-js: web/React consumers always bundle (Vite/webpack), so a CJS build would be dead weight.","peerDependencies":{"react":"^18.0.0 || ^19.0.0","react-dom":"^18.0.0 || ^19.0.0","@types/react":"^18.0.0 || ^19.0.0"},"_npmOperationalInternal":{"tmp":"tmp/public-read-react-js_0.11.0_1784439668482_0.14693023683307005","host":"s3://npm-registry-packages-npm-production"}},"0.11.1":{"name":"@agora-sdk/public-read-react-js","version":"0.11.1","private":false,"license":"Apache-2.0","author":{"name":"Agora SDK Plus, maintained by Jenova Marie"},"description":"Web components for the Agora anonymous public surface: a drop-in, read-only comment thread a blog can embed with no account and no Agora SDK installed. Re-exports @agora-sdk/public-read-core.","keywords":["agora","public","anonymous","comments","embed","read-only","react","web","typescript"],"bugs":{"url":"https://github.com/agora-oss-org/agora-sdk-plus/issues"},"homepage":"https://github.com/agora-oss-org/agora-sdk-plus","repository":{"type":"git","url":"git+https://github.com/agora-oss-org/agora-sdk-plus.git","directory":"packages/public-read/react-js"},"main":"dist/esm/index.js","module":"dist/esm/index.js","types":"dist/esm/index.d.ts","type":"module","comment:esm-only":"ESM-only to match social-react-js and secure-chat-react-js: web/React consumers always bundle (Vite/webpack), so a CJS build would be dead weight.","publishConfig":{"access":"public"},"dependencies":{"@agora-sdk/public-read-core":"0.11.1"},"peerDependencies":{"@types/react":"^18.0.0 || ^19.0.0","react":"^18.0.0 || ^19.0.0","react-dom":"^18.0.0 || ^19.0.0"},"scripts":{"build:esm":"tsc -p tsconfig.esm.json","build":"rimraf dist && pnpm run build:esm && pnpm run copy:docs","prepublish":"pnpm run build","copy:docs":"cp ../../../docs/PUBLIC-READ.md ./PUBLIC-READ.md"},"_id":"@agora-sdk/public-read-react-js@0.11.1","_integrity":"sha512-0UDpmmzPh5zjIYzDRY2EErmG6z8E7nGVCzmLa8lAEPLanOcGXHxMw7OM/Vyt0I5/TCfmMsoFTipE061LwImCdg==","_resolved":"/tmp/e5f120cbe0f310da1f86171f4cdca45b/agora-sdk-public-read-react-js-0.11.1.tgz","_from":"file:agora-sdk-public-read-react-js-0.11.1.tgz","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-0UDpmmzPh5zjIYzDRY2EErmG6z8E7nGVCzmLa8lAEPLanOcGXHxMw7OM/Vyt0I5/TCfmMsoFTipE061LwImCdg==","shasum":"b19f3fede527fb8f7ca0e56a8a43dccfde59f0ab","tarball":"https://registry.npmjs.org/@agora-sdk/public-read-react-js/-/public-read-react-js-0.11.1.tgz","fileCount":13,"unpackedSize":46517,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agora-sdk%2fpublic-read-react-js@0.11.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDMIeNnT9m7trKFYVXPSNQTdo+/IUn0W3n88dp700wRzQIgDNS8C5hYue0len8RtB8jSwSOifFhVMmXFaJDgaZghLA="}]},"_npmUser":{"name":"jenova-marie","email":"jenova-marie@proton.me"},"directories":{},"maintainers":[{"name":"jenova-marie","email":"jenova-marie@proton.me"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/public-read-react-js_0.11.1_1784442014061_0.9436903139397639"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-19T05:41:08.277Z","modified":"2026-07-19T06:20:14.594Z","0.11.0":"2026-07-19T05:41:08.627Z","0.11.1":"2026-07-19T06:20:14.220Z"},"bugs":{"url":"https://github.com/agora-oss-org/agora-sdk-plus/issues"},"author":{"name":"Agora SDK Plus, maintained by Jenova Marie"},"license":"Apache-2.0","homepage":"https://github.com/agora-oss-org/agora-sdk-plus","keywords":["agora","public","anonymous","comments","embed","read-only","react","web","typescript"],"repository":{"type":"git","url":"git+https://github.com/agora-oss-org/agora-sdk-plus.git","directory":"packages/public-read/react-js"},"description":"Web components for the Agora anonymous public surface: a drop-in, read-only comment thread a blog can embed with no account and no Agora SDK installed. Re-exports @agora-sdk/public-read-core.","maintainers":[{"name":"jenova-marie","email":"jenova-marie@proton.me"}],"readme":"# @agora-sdk/public-read-react-js\n\nA drop-in, **read-only** Agora comment thread that anyone can read — no account, no token, and **no\nAgora SDK installed** on the host page. Built for the case the auth wall otherwise blocks: a blog,\nmarketing page, or third-party site embedding a conversation for the open internet.\n\nTokenless by construction. The transport config has no credential field at all, so no code path can\nattach one — which matters, because the server answers `/public/*` with a wildcard\n`Access-Control-Allow-Origin` and never credentials, and a credentialed cross-origin request would\nfail CORS preflight.\n\n## Install\n\n```bash\n# No @agora-sdk/* dependency — this package stands alone.\n# You supply the API base URL and project id directly.\nnpm install @agora-sdk/public-read-react-js\n```\n\n## Usage\n\n```tsx\nimport { PublicReadProvider, PublicComments } from \"@agora-sdk/public-read-react-js\";\n\nexport function BlogComments() {\n  return (\n    <PublicReadProvider\n      projectId=\"11111111-1111-1111-1111-111111111111\"\n      baseUrl=\"https://api.example.com/v7\"\n    >\n      {/* Address the anchor by your own key — the entity uuid is generated per install. */}\n      <PublicComments foreignId=\"homepage-comments\" />\n    </PublicReadProvider>\n  );\n}\n```\n\nNeed the data without the chrome? `usePublicEntity`, `usePublicCommentThread`, and\n`usePublicComments` are re-exported from `@agora-sdk/public-read-core`.\n\n## Full guide\n\nSee [`PUBLIC-READ.md`](./PUBLIC-READ.md), shipped with this package — it covers the addressing\ntwo-step, the auth swap, caching and takedown, and the rules about what you must never render.\n","readmeFilename":"README.md"}