spaps-sdk 1.1.0 → 1.1.2

package/README.md

@@ -1,5 +1,9 @@
 # @spaps/sdk
 
+<a href="https://www.npmjs.com/package/spaps-sdk"><img alt="npm" src="https://img.shields.io/npm/v/spaps-sdk.svg"></a>
+<img alt="node" src="https://img.shields.io/badge/node-%3E%3D14-brightgreen">
+<img alt="types" src="https://img.shields.io/badge/types-TypeScript-blue">
+
 > Sweet Potato Authentication & Payment Service SDK
 
 Zero-config client for SPAPS authentication, payments, and permission checking. Works automatically with local development mode.
@@ -71,17 +75,29 @@ See [PERMISSIONS.md](./PERMISSIONS.md) for React examples and complete documenta
 ## Installation
 
 ```bash
-npm install @spaps/sdk
+npm install spaps-sdk
+# or
+yarn add spaps-sdk
 # or
-yarn add @spaps/sdk
+pnpm add spaps-sdk
 ```
 
+### Compatibility
+
+- ✅ **Node.js**: Fully supported (v14+) with automatic fetch polyfill
+- ✅ **Browser**: Works in all modern browsers  
+- ✅ **TypeScript**: Full type definitions included
+- ✅ **Next.js**: Server and client components supported
+- ✅ **React Native**: Compatible with proper setup
+
+The SDK automatically includes a `cross-fetch` polyfill for Node.js environments that don't have native fetch support.
+
 ## Quick Start
 
 ```javascript
-import { SPAPSClient } from '@spaps/sdk';
+import { SPAPSClient } from 'spaps-sdk';
 // or
-const { SPAPSClient } = require('@spaps/sdk');
+const { SPAPSClient } = require('spaps-sdk');
 
 // Auto-detects local mode - no API key needed for localhost!
 const spaps = new SPAPSClient({
@@ -99,6 +115,38 @@ if (spaps.isAuthenticated()) {
 }
 ```
 
+## Local Mode Explained
+
+- If `apiUrl` is omitted or points to `localhost`/`127.0.0.1`, the SDK runs in local mode.
+- Local mode integrates seamlessly with the `spaps` CLI (`npx spaps local`), defaulting to `http://localhost:3300`.
+- No API key is required in local mode; tokens and data are managed locally for development.
+
+You can check the mode at runtime:
+
+```ts
+spaps.isLocalMode(); // true | false
+```
+
+## Environment Variables
+
+The SDK can read configuration from environment variables (useful in Next.js and Node):
+
+- `SPAPS_API_URL` or `NEXT_PUBLIC_SPAPS_API_URL` — API base URL
+- `SPAPS_API_KEY` — API key for production use
+
+Example (Node):
+
+```bash
+export SPAPS_API_URL=https://api.sweetpotato.dev
+export SPAPS_API_KEY=spaps_xxx
+```
+
+Example (Next.js):
+
+```env
+NEXT_PUBLIC_SPAPS_API_URL=https://api.sweetpotato.dev
+```
+
 ## Features
 
 ### 🚀 Zero Configuration
@@ -149,7 +197,7 @@ await spaps.recordUsage('api-call', 1);
 ### Production Mode
 ```javascript
 const spaps = new SPAPSClient({
-  apiUrl: 'https://api.sweetpotato.com',
+  apiUrl: 'https://api.sweetpotato.dev',
   apiKey: 'spaps_your_api_key_here',
   timeout: 10000 // Optional timeout in ms
 });
@@ -164,11 +212,11 @@ const spaps = new SPAPSClient();
 ### Environment Variables
 ```bash
 # .env
-SPAPS_API_URL=https://api.sweetpotato.com
+SPAPS_API_URL=https://api.sweetpotato.dev
 SPAPS_API_KEY=spaps_your_api_key_here
 
 # Next.js
-NEXT_PUBLIC_SPAPS_API_URL=https://api.sweetpotato.com
+NEXT_PUBLIC_SPAPS_API_URL=https://api.sweetpotato.dev
 ```
 
 ## Helper Methods
@@ -195,16 +243,16 @@ await spaps.health()
 All these work:
 ```javascript
 // ES6 Import
-import { SPAPSClient } from '@spaps/sdk';
-import SPAPSClient from '@spaps/sdk';
+import { SPAPSClient } from 'spaps-sdk';
+import SPAPSClient from 'spaps-sdk';
 
 // CommonJS
-const { SPAPSClient } = require('@spaps/sdk');
-const SPAPSClient = require('@spaps/sdk');
+const { SPAPSClient } = require('spaps-sdk');
+const SPAPSClient = require('spaps-sdk');
 
 // Alternative names
-import { SPAPS } from '@spaps/sdk';
-import { SweetPotatoSDK } from '@spaps/sdk';
+import { SPAPS } from 'spaps-sdk';
+import { SweetPotatoSDK } from 'spaps-sdk';
 ```
 
 ## Admin API Methods
@@ -296,4 +344,4 @@ try {
 
 ## License
 
-MIT
+MIT

package/dist/index.js

@@ -212,6 +212,9 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 var import_axios = __toESM(require("axios"));
 init_permissions();
+if (typeof globalThis.fetch === "undefined") {
+  require("cross-fetch/polyfill");
+}
 var SPAPSClient = class {
   client;
   apiKey;

package/dist/index.mjs

@@ -2,6 +2,12 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
 var __esm = (fn, res) => function __init() {
   return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
 };
@@ -183,6 +189,9 @@ var init_permissions = __esm({
 // src/index.ts
 init_permissions();
 import axios from "axios";
+if (typeof globalThis.fetch === "undefined") {
+  __require("cross-fetch/polyfill");
+}
 var SPAPSClient = class {
   client;
   apiKey;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spaps-sdk",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Sweet Potato Authentication & Payment Service SDK - Zero-config client with built-in permission checking and role-based access control",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,10 +17,11 @@
     }
   },
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "build": "tsup --tsconfig tsconfig.json src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup --tsconfig tsconfig.json src/index.ts --format cjs,esm --dts --watch",
     "test": "echo \"No tests yet\"",
-    "prepublishOnly": "npm run build"
+    "smoke-test": "npm run build && node smoke-test.js",
+    "prepublishOnly": "npm run build && npm run smoke-test"
   },
   "keywords": [
     "authentication",
@@ -36,11 +37,16 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/yourusername/sweet-potato"
+    "url": "https://github.com/buildooor/sweet-potato",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://github.com/buildooor/sweet-potato/tree/main/packages/sdk",
+  "bugs": {
+    "url": "https://github.com/buildooor/sweet-potato/issues"
   },
-  "homepage": "https://sweetpotato.dev",
   "dependencies": {
-    "axios": "^1.6.0"
+    "axios": "^1.6.0",
+    "cross-fetch": "^4.0.0"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",
@@ -58,5 +64,12 @@
   "files": [
     "dist",
     "README.md"
-  ]
-}
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}