{"_id":"@boomin/connect","_rev":"4-6e814af214011ed0800fc55451910030","name":"@boomin/connect","dist-tags":{"latest":"0.3.0"},"versions":{"0.1.0":{"name":"@boomin/connect","version":"0.1.0","keywords":["boomin","partner-connect","creator","referral","instagram","oauth"],"author":{"name":"Boomin"},"license":"UNLICENSED","_id":"@boomin/connect@0.1.0","maintainers":[{"name":"ikleveland","email":"kleveland.bishop@gmail.com"}],"dist":{"shasum":"5c9eaffd761312084d4f0d197ddae216f3a8cefb","tarball":"https://registry.npmjs.org/@boomin/connect/-/connect-0.1.0.tgz","fileCount":6,"integrity":"sha512-lN82lfAvRRSd/uN70/7yCDqmnp2EC1z8oooR3tKZMbURZYpu4bQvhA6qyyPoY5I/vlpD//HZH9T0Xz9Ryj1Bdg==","signatures":[{"sig":"MEQCIF0f5bkuItA426lBTJjfbKmydEjYUohcYZ64ffBjbiCAAiBgJg6vYnAh91JLtLpwwMSOus70aR+HqUotAB8vXMTgnQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57058},"main":"./src/index.js","type":"module","types":"./src/index.d.ts","exports":{".":{"types":"./src/index.d.ts","import":"./src/index.js","default":"./src/index.js"},"./connect.js":"./dist/boomin-connect.js"},"gitHead":"0634f3848fe9682435e7118cf69d6b06e1f41882","scripts":{"build":"node scripts/build.mjs","pack:dry":"npm pack --dry-run"},"_npmUser":{"name":"ikleveland","email":"kleveland.bishop@gmail.com"},"_npmVersion":"11.6.2","description":"Browser SDK for Boomin Partner Connect.","directories":{},"_nodeVersion":"24.12.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/connect_0.1.0_1779993883598_0.2727405336316875","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@boomin/connect","version":"0.1.1","keywords":["boomin","partner-connect","creator","referral","instagram","oauth"],"author":{"name":"Boomin"},"license":"UNLICENSED","_id":"@boomin/connect@0.1.1","maintainers":[{"name":"ikleveland","email":"kleveland.bishop@gmail.com"}],"homepage":"https://github.com/Boomin-Ai/sdk#readme","bugs":{"url":"https://github.com/Boomin-Ai/sdk/issues"},"dist":{"shasum":"6644c252450a4bcc73291415284b8d078928b69d","tarball":"https://registry.npmjs.org/@boomin/connect/-/connect-0.1.1.tgz","fileCount":6,"integrity":"sha512-sM8mzxVWLsu2U+Da7YhVRBiCdH1IrJRb+SFPdHV2UU+UZaLdgJzGArJUlUDoQ/jYwS2KJz2sT9IEECaW5oaEwg==","signatures":[{"sig":"MEUCIGoWoCnaA+VHrGzulYhsRVr3VY0ZwclsxZTku66ghifXAiEA4GlDu/BpYNhRUo7xRZbhzckj3nvGqPQcUTrtjb7LRdY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@boomin%2fconnect@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":57828},"main":"./src/index.js","type":"module","types":"./src/index.d.ts","exports":{".":{"types":"./src/index.d.ts","import":"./src/index.js","default":"./src/index.js"},"./connect.js":"./dist/boomin-connect.js"},"gitHead":"a39ed6dea364cbcd84dd0b2801f8a2c3375b5336","scripts":{"build":"node scripts/build.mjs","pack:dry":"npm pack --dry-run"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3d2f9761-1513-43ff-bf92-35d9b736f7bb"}},"repository":{"url":"git+https://github.com/Boomin-Ai/sdk.git","type":"git","directory":"packages/connect"},"_npmVersion":"11.13.0","description":"Browser SDK for Boomin Partner Connect.","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/connect_0.1.1_1780170703438_0.8617007875450691","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@boomin/connect","version":"0.2.0","keywords":["boomin","partner-connect","creator","referral","instagram","oauth"],"author":{"name":"Boomin"},"license":"MIT","_id":"@boomin/connect@0.2.0","maintainers":[{"name":"ikleveland","email":"kleveland.bishop@gmail.com"}],"homepage":"https://github.com/Boomin-Ai/sdk#readme","bugs":{"url":"https://github.com/Boomin-Ai/sdk/issues"},"dist":{"shasum":"42411a855696c2cc559c1f7a61a5c290409a3713","tarball":"https://registry.npmjs.org/@boomin/connect/-/connect-0.2.0.tgz","fileCount":7,"integrity":"sha512-ZMyV/AmByYpZqVe4E9EukqkfszqVrtNYGDJOUDLepE9BXEL7xQwpB+kMWQ0aC/Btrj7df1Mb1OwtGtjeBMQRFg==","signatures":[{"sig":"MEYCIQDkGKy8TIzHiZEAqQDYTD2rfi5tqd0tiOC0fccsgERKAgIhAPiNOUojGHBOap0mnCFsDH3QuCn/CrIrmZJ0eLrrZgC1","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@boomin%2fconnect@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":65192},"main":"./src/index.js","type":"module","types":"./src/index.d.ts","exports":{".":{"types":"./src/index.d.ts","import":"./src/index.js","default":"./src/index.js"},"./connect.js":"./dist/boomin-connect.js"},"gitHead":"591b6301d9dba9590d3a83559f21fb026573dee3","scripts":{"build":"node scripts/build.mjs","pack:dry":"npm pack --dry-run"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3d2f9761-1513-43ff-bf92-35d9b736f7bb"}},"repository":{"url":"git+https://github.com/Boomin-Ai/sdk.git","type":"git","directory":"packages/connect"},"_npmVersion":"11.16.0","description":"Browser SDK for Boomin Partner Connect.","directories":{},"_nodeVersion":"24.18.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/connect_0.2.0_1785577491128_0.4563144508168746","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"_id":"@boomin/connect@0.3.0","bugs":{"url":"https://github.com/Boomin-Ai/sdk/issues"},"dist":{"shasum":"deb1a40820b36ea2e48aa3cc2029d5e5ee2bc8fd","tarball":"https://registry.npmjs.org/@boomin/connect/-/connect-0.3.0.tgz","fileCount":7,"integrity":"sha512-Yqfepy1fpO4VHVKqgg2JjRekxVFiKSoHlioIOG9boAalbJUENDP6owotlNUCO8YPUMCobvYzo/rYFmmisCnt3Q==","signatures":[{"sig":"MEUCIDZHxWm4fH66JUC6jv3dYKGsRNxOuxBcmsTr/FzZ1vOkAiEAgNlcsl34lIQjBDoKyL/JU7nwE/6V3DhI/mO2gF56vms=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDnaVnDuX4VCM0H1CCSNuaix5xA0KqOlhb8PdJDknm9CAIgHy/R7dfUffCazuQUHBglztQgULGsOPnfBZFV2NyyLco="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@boomin%2fconnect@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":65151},"main":"./src/index.js","name":"@boomin/connect","type":"module","types":"./src/index.d.ts","author":{"name":"Boomin"},"exports":{".":{"types":"./src/index.d.ts","import":"./src/index.js","default":"./src/index.js"},"./connect.js":"./dist/boomin-connect.js"},"gitHead":"c61d91fea908051548d6d2e2f2ce2dfdeae6e4dd","license":"MIT","scripts":{"build":"node scripts/build.mjs","pack:dry":"npm pack --dry-run"},"version":"0.3.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3d2f9761-1513-43ff-bf92-35d9b736f7bb"}},"homepage":"https://github.com/Boomin-Ai/sdk#readme","keywords":["boomin","partner-connect","creator","referral","instagram","oauth"],"repository":{"url":"git+https://github.com/Boomin-Ai/sdk.git","type":"git","directory":"packages/connect"},"_npmVersion":"11.17.0","description":"Browser SDK for Boomin Partner Connect.","directories":{},"maintainers":[{"name":"ikleveland","email":"kleveland.bishop@gmail.com"}],"_nodeVersion":"24.19.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/connect_0.3.0_1788182167036_0.9134592287267211"}}},"time":{"created":"2026-05-28T18:44:43.336Z","modified":"2026-08-31T13:16:07.504Z","0.1.0":"2026-05-28T18:44:43.722Z","0.1.1":"2026-05-30T19:51:43.597Z","0.2.0":"2026-08-01T09:44:51.288Z","0.3.0":"2026-08-31T13:16:07.132Z"},"bugs":{"url":"https://github.com/Boomin-Ai/sdk/issues"},"author":{"name":"Boomin"},"license":"MIT","homepage":"https://github.com/Boomin-Ai/sdk#readme","keywords":["boomin","partner-connect","creator","referral","instagram","oauth"],"repository":{"url":"git+https://github.com/Boomin-Ai/sdk.git","type":"git","directory":"packages/connect"},"description":"Browser SDK for Boomin Partner Connect.","maintainers":[{"name":"ikleveland","email":"kleveland.bishop@gmail.com"}],"readme":"# @boomin/connect\n\nBrowser SDK for Boomin Partner Connect.\n\n```bash\nnpm install @boomin/connect\n```\n\n## Breaking change in 0.2.0\n\n`joinProgram` no longer accepts an `email`. A member is only created for an email that has\nactually been proven, so joining now requires a entity token. The API rejects tokenless\njoins, and the SDK refuses to send one — `joinProgram()` without a token rejects immediately\nwith `error.code === \"missing_entity_token\"` instead of making a doomed request.\n\nMigration: replace `joinProgram({ email })` with the verify-then-join flow below.\n\n## The flow: requestOtp → verifyOtp → joinProgram\n\n```js\nimport Boomin from \"@boomin/connect\";\n\nBoomin.init({\n publicKey: import.meta.env.VITE_BOOMIN_PUBLIC_KEY,\n programId: import.meta.env.VITE_BOOMIN_PROGRAM_ID,\n apiBase: import.meta.env.VITE_BOOMIN_API_BASE,\n redirectUri: window.location.origin + window.location.pathname,\n});\n\n// 1. Email a one-time code.\nawait Boomin.requestOtp({ email: \"entity@example.com\", name: \"Entity\" });\n\n// 2. Exchange the code for a entity token. The SDK stores it for you.\nawait Boomin.verifyOtp({ email: \"entity@example.com\", code: \"123456\" });\n\n// 3. Join, authenticated as the verified entity.\nawait Boomin.joinProgram({ name: \"Entity\" });\n\n// Optional: link a channel.\nawait Boomin.connectInstagram({ requireCreator: true });\n```\n\nIf you hold a entity token from somewhere else — a signed server handoff, for example —\npass it explicitly and skip steps 1 and 2:\n\n```js\nawait Boomin.joinProgram({ authToken: tokenFromHandoff });\n```\n\nReferral-first apps can read the same status shape:\n\n```js\nconst status = await Boomin.getProgramStatus();\nconsole.log(status.referral?.url, status.metrics?.linkClicks);\n```\n\nFor CLI setup, use:\n\n```bash\nnpx @boomin/cli init\n```\n\nThe CDN global remains:\n\n```html\n\n```\n","readmeFilename":"README.md"}