{"_id":"@crossabc/reloadpi-browse-sdk","name":"@crossabc/reloadpi-browse-sdk","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@crossabc/reloadpi-browse-sdk","version":"0.1.0","description":"Read-only SDK for browsing ReloadPi vouchers, topups, and eSIMs","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"scripts":{"build":"tsc -p tsconfig.json","clean":"rimraf dist","dev":"tsc -w -p tsconfig.json","prepublishOnly":"npm run clean && npm run build","pack:check":"npm pack --dry-run"},"keywords":["reloadpi","sdk","topup","voucher","esim"],"license":"MIT","publishConfig":{"access":"public"},"engines":{"node":">=18"},"devDependencies":{"rimraf":"^6.1.3","typescript":"^5.9.0"},"_id":"@crossabc/reloadpi-browse-sdk@0.1.0","gitHead":"5e6ba71a3f9dba412b20980fff1a8ac3457376ce","_nodeVersion":"22.10.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-oEz4l7gBHB2cwlfZCC/Ysdwtp0fDTLHSh+/bNUY7t4IuxJTTqr1ueJxVoOcafxE3nOn9E1z3cRTWz3VlGrJMWg==","shasum":"9eff2858f69af43ad90bae00321ccadb53a1675e","tarball":"https://registry.npmjs.org/@crossabc/reloadpi-browse-sdk/-/reloadpi-browse-sdk-0.1.0.tgz","fileCount":27,"unpackedSize":25534,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFOLbainRROy1bDWdCv/MuBOr/s7EsWJWQ6YcOv+rJwmAiA7pEvn5dnNrPko85EinbC6xyYXPm2xi41N9CDkVoXmag=="}]},"_npmUser":{"name":"crossabc","email":"razvanalbu32@gmail.com"},"directories":{},"maintainers":[{"name":"crossabc","email":"razvanalbu32@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/reloadpi-browse-sdk_0.1.0_1774994381253_0.6395994345087146"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-31T21:59:41.168Z","0.1.0":"2026-03-31T21:59:41.410Z","modified":"2026-03-31T21:59:41.626Z"},"maintainers":[{"name":"crossabc","email":"razvanalbu32@gmail.com"}],"description":"Read-only SDK for browsing ReloadPi vouchers, topups, and eSIMs","keywords":["reloadpi","sdk","topup","voucher","esim"],"license":"MIT","readme":"# @shoppi/browse-sdk\r\n\r\nOfficial read-only SDK for browsing Shoppi catalog data including:\r\n\r\n- 🎟️ Vouchers (gift cards)\r\n- 📱 Mobile top-ups\r\n- 📶 eSIM plans\r\n\r\nThis SDK is designed for partners integrating Shoppi catalog browsing and referral flows.\r\n\r\n---\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install @crossabc/reloadpi-browse-sdk\r\nQuick Start\r\nimport { ShoppiBrowseSDK } from \"@crossabc/reloadpi-browse-sdk\";\r\n\r\nconst sdk = new ShoppiBrowseSDK({\r\n  baseUrl: \"https://api.shoppi.com/api/\",\r\n  apiKey: \"YOUR_API_KEY\", // required for production access\r\n  referralCode: \"PARTNER_ABC\"\r\n});\r\n\r\n// Search vouchers\r\nconst vouchers = await sdk.vouchers.searchOffers({\r\n  country: \"NG\",\r\n  brand: \"Amazon\",\r\n  limit: 20\r\n});\r\n\r\nconsole.log(vouchers.items);\r\n\r\n// Generate referral link\r\nconst buyUrl = sdk.getBuyUrl(\"vouchers\", \"AMAZON_NG_001\");\r\nconsole.log(buyUrl);\r\nConfiguration\r\nconst sdk = new ShoppiBrowseSDK({\r\n  baseUrl: string,        // required\r\n  apiKey?: string,        // recommended\r\n  accessToken?: string,   // optional alternative auth\r\n  shopUrl?: string,       // default: https://reloadpi.com\r\n  referralCode?: string   // partner tracking\r\n});\r\nNotes\r\nbaseUrl must point to your Shoppi API\r\nAuthentication is enforced server-side\r\nAPI keys are issued by Shoppi\r\nModules\r\nVouchers\r\nconst res = await sdk.vouchers.searchOffers({\r\n  country: \"NG\",\r\n  brand: \"Amazon\",\r\n  limit: 20\r\n});\r\nTop-ups\r\nconst res = await sdk.topups.searchOffers({\r\n  country: \"GH\",\r\n  limit: 10\r\n});\r\neSIMs\r\nconst res = await sdk.esims.searchPlans({\r\n  country: \"US\",\r\n  limit: 5\r\n});\r\nReferral Links\r\nProduct page\r\nsdk.getBuyUrl(\"vouchers\", \"AMAZON_NG_001\");\r\n\r\nExample output:\r\n\r\nhttps://reloadpi.com/vouchers/offer/AMAZON_NG_001?ref=PARTNER_ABC\r\nCatalog page\r\nsdk.getCatalogUrl(\"vouchers\", { country: \"NG\" });\r\nError Handling\r\nimport { ShoppiError } from \"@shoppi/browse-sdk\";\r\n\r\ntry {\r\n  await sdk.vouchers.searchOffers({ country: \"NG\" });\r\n} catch (err) {\r\n  if (err instanceof ShoppiError) {\r\n    console.error(err.status, err.code, err.message);\r\n  }\r\n}\r\nAPI Access & Permissions\r\n\r\nThis SDK is publicly installable, but API access is restricted.\r\n\r\nAll requests require valid credentials\r\nAccess is controlled via API keys or tokens\r\nRate limits and permissions are enforced server-side\r\nKeys may be revoked or limited at any time\r\n\r\nTo request access, contact Shoppi.\r\n\r\nVersioning\r\n\r\nThis package is currently in early release (0.x).\r\n\r\nBreaking changes may occur between minor versions\r\nStable API will be introduced at 1.0.0","readmeFilename":"README.md","_rev":"1-eb739a4267d15e17726bfd9c9cb0241a"}