{"_id":"@bluemtx/storefront-sdk","_rev":"4-755763e13ec2611394862b8604fab848","name":"@bluemtx/storefront-sdk","dist-tags":{"latest":"0.2.5"},"versions":{"0.2.2":{"name":"@bluemtx/storefront-sdk","version":"0.2.2","keywords":["bluemtx","storefront","headless","commerce","sdk"],"license":"MIT","_id":"@bluemtx/storefront-sdk@0.2.2","maintainers":[{"name":"myousefblue","email":"m.yousef@blue.me"}],"homepage":"https://github.com/bluemtx/storefront-kit/tree/main/packages/storefront-sdk","bugs":{"url":"https://github.com/bluemtx/storefront-kit/issues"},"dist":{"shasum":"ba8d7fca73bb5b2101ebddc3687f7d41fd36953f","tarball":"https://registry.npmjs.org/@bluemtx/storefront-sdk/-/storefront-sdk-0.2.2.tgz","fileCount":3,"integrity":"sha512-kKQFFpnmI0QwQ9t+tHoM3HjLiOrAP0mgOXNgv1KTssdECnErJHuo+q8MOyzm5BStZv6MXq5JI+Yz1H6Nm4h+Kg==","signatures":[{"sig":"MEQCIFiz++FjntnrFfvb9RmMzTdUUE/E8HOiY+U2OJZdRXMHAiAFtiV3bhDIV++Lj1YpIR5yM4kQTIcrymO/MrN097/ySg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13970},"main":"./src/index.js","type":"module","engines":{"node":">=20"},"exports":{".":"./src/index.js"},"gitHead":"5b64a1c771b414025e57c0c6613effaaed022904","_npmUser":{"name":"myousefblue","email":"m.yousef@blue.me"},"repository":{"url":"git+https://github.com/bluemtx/storefront-kit.git","type":"git","directory":"packages/storefront-sdk"},"_npmVersion":"10.8.2","description":"BlueMTX public storefront API client","directories":{},"_nodeVersion":"20.20.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/storefront-sdk_0.2.2_1789091256535_0.059690886901767604","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@bluemtx/storefront-sdk","version":"0.2.3","keywords":["bluemtx","storefront","headless","commerce","sdk"],"license":"MIT","_id":"@bluemtx/storefront-sdk@0.2.3","maintainers":[{"name":"myousefblue","email":"m.yousef@blue.me"}],"homepage":"https://github.com/bluemtx/storefront-kit/tree/main/packages/storefront-sdk","bugs":{"url":"https://github.com/bluemtx/storefront-kit/issues"},"dist":{"shasum":"63822fc907e05aac235aba58d60428c15897ba87","tarball":"https://registry.npmjs.org/@bluemtx/storefront-sdk/-/storefront-sdk-0.2.3.tgz","fileCount":3,"integrity":"sha512-wEZz12Eion6htnnWcvp+eua5HQarOIF5fKQWkRGkjbFd6dzDY0OcYsgYXfN0NsT0uDNYFHtyeIy05hxnUMsXsQ==","signatures":[{"sig":"MEUCICb6QKwGNqmZKKAFDgVCEXkSBAtXVioQzECJNyDu9gXSAiEA101pHOEjGH4hZBPYapTmJKvcK80VVD8VYDMh/1n1ZNY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13970},"main":"./src/index.js","type":"module","engines":{"node":">=20"},"exports":{".":"./src/index.js"},"gitHead":"5b64a1c771b414025e57c0c6613effaaed022904","_npmUser":{"name":"myousefblue","email":"m.yousef@blue.me"},"repository":{"url":"git+https://github.com/bluemtx/storefront-kit.git","type":"git","directory":"packages/storefront-sdk"},"_npmVersion":"10.8.2","description":"BlueMTX public storefront API client","directories":{},"_nodeVersion":"20.20.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/storefront-sdk_0.2.3_1789091459439_0.3989245531160521","host":"s3://npm-registry-packages-npm-production"}},"0.2.4":{"name":"@bluemtx/storefront-sdk","version":"0.2.4","keywords":["bluemtx","storefront","headless","commerce","sdk"],"license":"MIT","_id":"@bluemtx/storefront-sdk@0.2.4","maintainers":[{"name":"myousefblue","email":"m.yousef@blue.me"}],"homepage":"https://github.com/bluemtx/storefront-kit/tree/main/packages/storefront-sdk","bugs":{"url":"https://github.com/bluemtx/storefront-kit/issues"},"dist":{"shasum":"f19fa87b75d7944850e48eef2e197328f86a310e","tarball":"https://registry.npmjs.org/@bluemtx/storefront-sdk/-/storefront-sdk-0.2.4.tgz","fileCount":3,"integrity":"sha512-KkpSC9WujEeS+G4LBgkiNF/ZCvE/YxrejE2dF6X2sxTojQQRjDTnIQohhi7kEWRQOPmqceLN7Ye6sQ6ZqdlImQ==","signatures":[{"sig":"MEYCIQDTqzEG3M2KYnqg0VhMHlWoRbSQPq21jPKYWUYYrDwh2QIhANIgzkQ+1N3XmR+EM0l37ciR9DVkM/M1lMsP6IUOX/YI","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13970},"main":"./src/index.js","type":"module","engines":{"node":">=20"},"exports":{".":"./src/index.js"},"gitHead":"5b64a1c771b414025e57c0c6613effaaed022904","_npmUser":{"name":"myousefblue","email":"m.yousef@blue.me"},"repository":{"url":"git+https://github.com/bluemtx/storefront-kit.git","type":"git","directory":"packages/storefront-sdk"},"_npmVersion":"10.8.2","description":"BlueMTX public storefront API client","directories":{},"_nodeVersion":"20.20.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/storefront-sdk_0.2.4_1789091608159_0.04054499884100804","host":"s3://npm-registry-packages-npm-production"}},"0.2.5":{"name":"@bluemtx/storefront-sdk","version":"0.2.5","description":"BlueMTX public storefront API client","type":"module","license":"MIT","main":"./src/index.js","exports":{".":"./src/index.js"},"engines":{"node":">=20"},"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/bluemtx/storefront-kit.git","directory":"packages/storefront-sdk"},"homepage":"https://github.com/bluemtx/storefront-kit/tree/main/packages/storefront-sdk","keywords":["bluemtx","storefront","headless","commerce","sdk"],"gitHead":"d4ed080fb16f0a15653cac617c10936a2e7f3fc3","_id":"@bluemtx/storefront-sdk@0.2.5","bugs":{"url":"https://github.com/bluemtx/storefront-kit/issues"},"_nodeVersion":"22.23.2","_npmVersion":"12.0.2","dist":{"integrity":"sha512-ucMTNI6k5h+WTkxLRkptdfBo6CiuuX9kHlK5aH7lUtgLdU0c0OKxbMORAblMkIoML1T/hMImK7ToQeOo4oCEUQ==","shasum":"51d5a0495f5f989307c5ba255587cc5a0986c1b6","tarball":"https://registry.npmjs.org/@bluemtx/storefront-sdk/-/storefront-sdk-0.2.5.tgz","fileCount":3,"unpackedSize":13970,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bluemtx%2fstorefront-sdk@0.2.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCtBp+IJysyiG+9Ila/E9rDztaJiIYMeTvKPUg4Jme7EQIgNzQKHFLJSHVMuI/WIoxahFsComfxUHcf3iq1Ihp5BEc="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:724819de-6952-4468-92ab-5499d91f74a8"}},"directories":{},"maintainers":[{"name":"myousefblue","email":"m.yousef@blue.me"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/storefront-sdk_0.2.5_1789092878555_0.46602037689866327"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-11T01:47:36.307Z","modified":"2026-09-11T02:14:39.061Z","0.2.2":"2026-09-11T01:47:36.663Z","0.2.3":"2026-09-11T01:50:59.660Z","0.2.4":"2026-09-11T01:53:28.303Z","0.2.5":"2026-09-11T02:14:38.681Z"},"bugs":{"url":"https://github.com/bluemtx/storefront-kit/issues"},"license":"MIT","homepage":"https://github.com/bluemtx/storefront-kit/tree/main/packages/storefront-sdk","keywords":["bluemtx","storefront","headless","commerce","sdk"],"repository":{"type":"git","url":"git+https://github.com/bluemtx/storefront-kit.git","directory":"packages/storefront-sdk"},"description":"BlueMTX public storefront API client","maintainers":[{"name":"myousefblue","email":"m.yousef@blue.me"}],"readme":"# `@bluemtx/storefront-sdk`\n\nTyped client for the **BlueMTX Storefront Public API** (`/api/v1/stores/{slug}/*`).\n\n## Install\n\n```bash\nnpm install @bluemtx/storefront-sdk\n```\n\nFallback from a [GitHub Release](https://github.com/bluemtx/storefront-kit/releases) tarball:\n\n```bash\nnpm install https://github.com/bluemtx/storefront-kit/releases/download/v0.2.2/bluemtx-storefront-sdk-0.2.2.tgz\n```\n\nOr clone this repo and link the workspace package locally.\n\n## Usage\n\n```js\nimport { createStorefrontClient } from '@bluemtx/storefront-sdk'\n\n// Production headless (Worker BFF — same origin)\nconst client = createStorefrontClient({\n  baseUrl: '',\n  storeSlug: 'your-store',\n  getCustomerToken: () => localStorage.getItem('bos.commerce.customer.your-store.token'),\n  getAcceptLanguage: () => localStorage.getItem('store.locale') || 'en',\n})\n\n// Direct Commerce (local / non-BFF)\nconst direct = createStorefrontClient({\n  baseUrl: 'https://dev.stores.bluemtx.com',\n  storeSlug: 'your-store',\n})\n```\n\n## Rules\n\n- Call only public `/api/v1/stores/{slug}/*` routes.\n- Prefer `getStorefrontContract()` over raw flat `/config` fields for new apps.\n- Auth/cart use Bearer + opaque session tokens (no cookie credentials required).\n- Cross-origin SPAs need `STOREFRONT_CORS_ORIGINS` allowlisted on Commerce, or use a same-origin Worker BFF.\n\nSee [docs/getting-started.md](../../docs/getting-started.md) and [docs/public-contract.md](../../docs/public-contract.md).\n","readmeFilename":"README.md"}