@ai-billing/nextjs 0.0.0 → 0.0.1

package/README.md

@@ -6,24 +6,52 @@ Next.js UI components for displaying billing usage and managing top-ups.
 npm install @ai-billing/nextjs
 ```
 
-## Components
+## Polar
 
-Import client components from the main entry:
+Display usage for Polar meters and let users purchase credit bundles.
 
 ```tsx
-import { CreditUsagePolar, CreditUsageStripe, CreditTopUpPolar } from '@ai-billing/nextjs';
+import { CreditUsagePolar, CreditTopUpPolar } from '@ai-billing/nextjs';
 
 <CreditUsagePolar userId="user_123" budget={50} />
-<CreditUsageStripe stripeCustomerId="cus_123" budget={100} />
 <CreditTopUpPolar userId="user_123" />
 ```
 
 ### budget vs top-up
 
-- **`budget`** — use when billing is usage-based (e.g. monthly invoice per consumption). Represents a spending cap. The bar shows how much of the cap has been consumed.
-- **No `budget`** — use together with `CreditTopUpPolar` when users pre-purchase credits. Omit `budget` and the cap is automatically set to the account's `creditedUnits` from Polar.
+- **`budget`** — use when billing is usage-based (e.g. monthly invoice per consumption). Represents a spending cap.
+- **No `budget`** — use together with `CreditTopUpPolar` when users pre-purchase credits. Omit `budget` and the cap is automatically set to the account's `creditedUnits`.
 
-Server actions for advanced use cases:
+### Environment Variables
+
+| Variable | Required |
+|----------|----------|
+| `NAREV_API_KEY` | Config fetch |
+| `POLAR_ACCESS_TOKEN` | Meter usage + top-up |
+| `POLAR_SERVER` | `sandbox` or `production` |
+
+## Stripe
+
+Display usage for Stripe billing meters.
+
+```tsx
+import { CreditUsageStripe } from '@ai-billing/nextjs';
+
+<CreditUsageStripe stripeCustomerId="cus_123" budget={100} unit="$" />
+```
+
+Stripe meters report values in nano-units. The component converts them to dollars and displays them with `$` formatting by default. Use the `unit` prop to override.
+
+### Environment Variables
+
+| Variable | Required |
+|----------|----------|
+| `NAREV_API_KEY` | Config fetch |
+| `STRIPE_SECRET_KEY` | Meter usage |
+
+## Server Actions
+
+Server actions are available for advanced use cases:
 
 ```tsx
 import { fetchPolarUsage, fetchStripeUsage, createCheckout } from '@ai-billing/nextjs/server';

package/dist/polar/fetchTopUpConfig.cjs

@@ -42,9 +42,11 @@ async function fetchTopUpConfig() {
       if (tb === "inclusive" || tb === "exclusive" || tb === "location") {
         config.taxBehavior = tb;
       }
-    } catch {
+    } catch (error) {
+      console.error("fetchTopUpConfig: failed to fetch tax behavior", error);
     }
-  } catch {
+  } catch (error) {
+    console.error("fetchTopUpConfig: config fetch failed", error);
   }
   return config;
 }

package/dist/polar/fetchTopUpConfig.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/polar/fetchTopUpConfig.ts"],"sourcesContent":["'use server';\n\nimport { Polar } from '@polar-sh/sdk';\nimport { fetchPolarConfig } from './fetchPolarConfig.js';\nimport type { CreditPackage } from './types.js';\n\ninterface TopUpConfig {\n  packages: CreditPackage[];\n  taxBehavior?: 'inclusive' | 'exclusive' | 'location';\n}\n\n/** Fetches available top-up packages and optional tax behavior from Polar */\nexport async function fetchTopUpConfig(): Promise<TopUpConfig> {\n  const config: TopUpConfig = { packages: [] };\n\n  try {\n    const polarConfig = await fetchPolarConfig();\n    if (!polarConfig) return config;\n\n    config.packages = polarConfig.topup ?? [];\n\n    const env = polarConfig.environment ?? 'sandbox';\n    try {\n      const polar = new Polar({\n        accessToken: process.env.POLAR_ACCESS_TOKEN,\n        server: env,\n      });\n      const orgs = await polar.organizations.list({ limit: 1 });\n      const org = orgs.result?.items?.[0];\n      const tb = org?.defaultTaxBehavior;\n      if (tb === 'inclusive' || tb === 'exclusive' || tb === 'location') {\n        config.taxBehavior = tb as typeof config.taxBehavior;\n      }\n    } catch {\n      /* no tax */\n    }\n  } catch {\n    /* no config */\n  }\n\n  return config;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,iBAAsB;AACtB,8BAAiC;AASjC,eAAsB,mBAAyC;AAC7D,QAAM,SAAsB,EAAE,UAAU,CAAC,EAAE;AAE3C,MAAI;AACF,UAAM,cAAc,UAAM,0CAAiB;AAC3C,QAAI,CAAC,YAAa,QAAO;AAEzB,WAAO,WAAW,YAAY,SAAS,CAAC;AAExC,UAAM,MAAM,YAAY,eAAe;AACvC,QAAI;AACF,YAAM,QAAQ,IAAI,iBAAM;AAAA,QACtB,aAAa,QAAQ,IAAI;AAAA,QACzB,QAAQ;AAAA,MACV,CAAC;AACD,YAAM,OAAO,MAAM,MAAM,cAAc,KAAK,EAAE,OAAO,EAAE,CAAC;AACxD,YAAM,MAAM,KAAK,QAAQ,QAAQ,CAAC;AAClC,YAAM,KAAK,KAAK;AAChB,UAAI,OAAO,eAAe,OAAO,eAAe,OAAO,YAAY;AACjE,eAAO,cAAc;AAAA,MACvB;AAAA,IACF,QAAQ;AAAA,IAER;AAAA,EACF,QAAQ;AAAA,EAER;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/polar/fetchTopUpConfig.ts"],"sourcesContent":["'use server';\n\nimport { Polar } from '@polar-sh/sdk';\nimport { fetchPolarConfig } from './fetchPolarConfig.js';\nimport type { CreditPackage } from './types.js';\n\ninterface TopUpConfig {\n  packages: CreditPackage[];\n  taxBehavior?: 'inclusive' | 'exclusive' | 'location';\n}\n\n/** Fetches available top-up packages and optional tax behavior from Polar */\nexport async function fetchTopUpConfig(): Promise<TopUpConfig> {\n  const config: TopUpConfig = { packages: [] };\n\n  try {\n    const polarConfig = await fetchPolarConfig();\n    if (!polarConfig) return config;\n\n    config.packages = polarConfig.topup ?? [];\n\n    const env = polarConfig.environment ?? 'sandbox';\n    try {\n      const polar = new Polar({\n        accessToken: process.env.POLAR_ACCESS_TOKEN,\n        server: env,\n      });\n      const orgs = await polar.organizations.list({ limit: 1 });\n      const org = orgs.result?.items?.[0];\n      const tb = org?.defaultTaxBehavior;\n      if (tb === 'inclusive' || tb === 'exclusive' || tb === 'location') {\n        config.taxBehavior = tb as typeof config.taxBehavior;\n      }\n    } catch (error) {\n      console.error('fetchTopUpConfig: failed to fetch tax behavior', error);\n    }\n  } catch (error) {\n    console.error('fetchTopUpConfig: config fetch failed', error);\n  }\n\n  return config;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,iBAAsB;AACtB,8BAAiC;AASjC,eAAsB,mBAAyC;AAC7D,QAAM,SAAsB,EAAE,UAAU,CAAC,EAAE;AAE3C,MAAI;AACF,UAAM,cAAc,UAAM,0CAAiB;AAC3C,QAAI,CAAC,YAAa,QAAO;AAEzB,WAAO,WAAW,YAAY,SAAS,CAAC;AAExC,UAAM,MAAM,YAAY,eAAe;AACvC,QAAI;AACF,YAAM,QAAQ,IAAI,iBAAM;AAAA,QACtB,aAAa,QAAQ,IAAI;AAAA,QACzB,QAAQ;AAAA,MACV,CAAC;AACD,YAAM,OAAO,MAAM,MAAM,cAAc,KAAK,EAAE,OAAO,EAAE,CAAC;AACxD,YAAM,MAAM,KAAK,QAAQ,QAAQ,CAAC;AAClC,YAAM,KAAK,KAAK;AAChB,UAAI,OAAO,eAAe,OAAO,eAAe,OAAO,YAAY;AACjE,eAAO,cAAc;AAAA,MACvB;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,MAAM,kDAAkD,KAAK;AAAA,IACvE;AAAA,EACF,SAAS,OAAO;AACd,YAAQ,MAAM,yCAAyC,KAAK;AAAA,EAC9D;AAEA,SAAO;AACT;","names":[]}

package/dist/polar/fetchTopUpConfig.js

@@ -19,9 +19,11 @@ async function fetchTopUpConfig() {
       if (tb === "inclusive" || tb === "exclusive" || tb === "location") {
         config.taxBehavior = tb;
       }
-    } catch {
+    } catch (error) {
+      console.error("fetchTopUpConfig: failed to fetch tax behavior", error);
     }
-  } catch {
+  } catch (error) {
+    console.error("fetchTopUpConfig: config fetch failed", error);
   }
   return config;
 }

package/dist/polar/fetchTopUpConfig.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/polar/fetchTopUpConfig.ts"],"sourcesContent":["'use server';\n\nimport { Polar } from '@polar-sh/sdk';\nimport { fetchPolarConfig } from './fetchPolarConfig.js';\nimport type { CreditPackage } from './types.js';\n\ninterface TopUpConfig {\n  packages: CreditPackage[];\n  taxBehavior?: 'inclusive' | 'exclusive' | 'location';\n}\n\n/** Fetches available top-up packages and optional tax behavior from Polar */\nexport async function fetchTopUpConfig(): Promise<TopUpConfig> {\n  const config: TopUpConfig = { packages: [] };\n\n  try {\n    const polarConfig = await fetchPolarConfig();\n    if (!polarConfig) return config;\n\n    config.packages = polarConfig.topup ?? [];\n\n    const env = polarConfig.environment ?? 'sandbox';\n    try {\n      const polar = new Polar({\n        accessToken: process.env.POLAR_ACCESS_TOKEN,\n        server: env,\n      });\n      const orgs = await polar.organizations.list({ limit: 1 });\n      const org = orgs.result?.items?.[0];\n      const tb = org?.defaultTaxBehavior;\n      if (tb === 'inclusive' || tb === 'exclusive' || tb === 'location') {\n        config.taxBehavior = tb as typeof config.taxBehavior;\n      }\n    } catch {\n      /* no tax */\n    }\n  } catch {\n    /* no config */\n  }\n\n  return config;\n}\n"],"mappings":";AAEA,SAAS,aAAa;AACtB,SAAS,wBAAwB;AASjC,eAAsB,mBAAyC;AAC7D,QAAM,SAAsB,EAAE,UAAU,CAAC,EAAE;AAE3C,MAAI;AACF,UAAM,cAAc,MAAM,iBAAiB;AAC3C,QAAI,CAAC,YAAa,QAAO;AAEzB,WAAO,WAAW,YAAY,SAAS,CAAC;AAExC,UAAM,MAAM,YAAY,eAAe;AACvC,QAAI;AACF,YAAM,QAAQ,IAAI,MAAM;AAAA,QACtB,aAAa,QAAQ,IAAI;AAAA,QACzB,QAAQ;AAAA,MACV,CAAC;AACD,YAAM,OAAO,MAAM,MAAM,cAAc,KAAK,EAAE,OAAO,EAAE,CAAC;AACxD,YAAM,MAAM,KAAK,QAAQ,QAAQ,CAAC;AAClC,YAAM,KAAK,KAAK;AAChB,UAAI,OAAO,eAAe,OAAO,eAAe,OAAO,YAAY;AACjE,eAAO,cAAc;AAAA,MACvB;AAAA,IACF,QAAQ;AAAA,IAER;AAAA,EACF,QAAQ;AAAA,EAER;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/polar/fetchTopUpConfig.ts"],"sourcesContent":["'use server';\n\nimport { Polar } from '@polar-sh/sdk';\nimport { fetchPolarConfig } from './fetchPolarConfig.js';\nimport type { CreditPackage } from './types.js';\n\ninterface TopUpConfig {\n  packages: CreditPackage[];\n  taxBehavior?: 'inclusive' | 'exclusive' | 'location';\n}\n\n/** Fetches available top-up packages and optional tax behavior from Polar */\nexport async function fetchTopUpConfig(): Promise<TopUpConfig> {\n  const config: TopUpConfig = { packages: [] };\n\n  try {\n    const polarConfig = await fetchPolarConfig();\n    if (!polarConfig) return config;\n\n    config.packages = polarConfig.topup ?? [];\n\n    const env = polarConfig.environment ?? 'sandbox';\n    try {\n      const polar = new Polar({\n        accessToken: process.env.POLAR_ACCESS_TOKEN,\n        server: env,\n      });\n      const orgs = await polar.organizations.list({ limit: 1 });\n      const org = orgs.result?.items?.[0];\n      const tb = org?.defaultTaxBehavior;\n      if (tb === 'inclusive' || tb === 'exclusive' || tb === 'location') {\n        config.taxBehavior = tb as typeof config.taxBehavior;\n      }\n    } catch (error) {\n      console.error('fetchTopUpConfig: failed to fetch tax behavior', error);\n    }\n  } catch (error) {\n    console.error('fetchTopUpConfig: config fetch failed', error);\n  }\n\n  return config;\n}\n"],"mappings":";AAEA,SAAS,aAAa;AACtB,SAAS,wBAAwB;AASjC,eAAsB,mBAAyC;AAC7D,QAAM,SAAsB,EAAE,UAAU,CAAC,EAAE;AAE3C,MAAI;AACF,UAAM,cAAc,MAAM,iBAAiB;AAC3C,QAAI,CAAC,YAAa,QAAO;AAEzB,WAAO,WAAW,YAAY,SAAS,CAAC;AAExC,UAAM,MAAM,YAAY,eAAe;AACvC,QAAI;AACF,YAAM,QAAQ,IAAI,MAAM;AAAA,QACtB,aAAa,QAAQ,IAAI;AAAA,QACzB,QAAQ;AAAA,MACV,CAAC;AACD,YAAM,OAAO,MAAM,MAAM,cAAc,KAAK,EAAE,OAAO,EAAE,CAAC;AACxD,YAAM,MAAM,KAAK,QAAQ,QAAQ,CAAC;AAClC,YAAM,KAAK,KAAK;AAChB,UAAI,OAAO,eAAe,OAAO,eAAe,OAAO,YAAY;AACjE,eAAO,cAAc;AAAA,MACvB;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,MAAM,kDAAkD,KAAK;AAAA,IACvE;AAAA,EACF,SAAS,OAAO;AACd,YAAQ,MAAM,yCAAyC,KAAK;AAAA,EAC9D;AAEA,SAAO;AACT;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-billing/nextjs",
-  "version": "0.0.0",
+  "version": "0.0.1",
   "license": "Apache-2.0",
   "type": "module",
   "repository": {
@@ -33,39 +33,26 @@
     }
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup",
-    "check-types": "tsc --noEmit",
-    "lint": "oxlint",
-    "dev": "tsup --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "docs:generate": "typedoc --options typedoc.json",
-    "prepack": "node -e \"require('fs').copyFileSync('../../LICENSE', 'LICENSE')\"",
-    "postpack": "node -e \"require('fs').rmSync('LICENSE', { force: true })\""
-  },
   "dependencies": {},
   "devDependencies": {
-    "@ai-billing/typescript-config": "workspace:*",
-    "@types/node": "catalog:",
-    "@types/react": "catalog:",
-    "tsup": "catalog:",
-    "typescript": "catalog:",
-    "oxlint": "catalog:",
-    "typedoc": "catalog:",
-    "vitest": "catalog:"
+    "@types/node": "^22.15.3",
+    "@types/react": "19.2.2",
+    "tsup": "^8.5.1",
+    "typescript": "5.9.2",
+    "oxlint": "^1.57.0",
+    "typedoc": "^0.28.19",
+    "vitest": "4.1.1",
+    "@ai-billing/typescript-config": "0.0.1"
   },
   "peerDependencies": {
     "@polar-sh/sdk": "^0.46.7",
-    "next": ">=14",
     "react": "^18 || ^19",
-    "react-dom": "^18 || ^19",
     "stripe": "^21.0.0"
   },
   "peerDependenciesMeta": {
@@ -78,5 +65,15 @@
   },
   "engines": {
     "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "check-types": "tsc --noEmit",
+    "lint": "oxlint",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "docs:generate": "typedoc --options typedoc.json"
   }
-}
+}