vibezcheck 0.4.1 → 0.4.2

package/dist/{types-Zbzxg-Ka.d.mts → types-Mozk4-Mr.d.mts}

@@ -50,6 +50,49 @@ interface InferenceCost {
     /** Currency (defaults to 'USD') */
     currency: string;
 }
+/**
+ * Structured Customer Information with rich metadata, multi-tenancy & billing attributes
+ */
+interface CustomerInfo {
+    /** Internal user ID or Stripe customer ID ('cus_xxx', 'usr_123') */
+    id?: string;
+    /** Explicit user ID */
+    userId?: string;
+    /** Customer email */
+    email?: string;
+    /** Customer full name or business display name */
+    name?: string;
+    /** Phone number */
+    phone?: string;
+    /** Multi-tenant Organization or Company ID */
+    orgId?: string;
+    /** Organization / Company name */
+    orgName?: string;
+    /** Multi-tenant Organization ID alias */
+    organizationId?: string;
+    /** Team / Workspace identifier */
+    teamId?: string;
+    /** Workspace identifier alias */
+    workspaceId?: string;
+    /** User Role within organization (e.g. 'admin', 'member', 'owner') */
+    role?: string;
+    /** Subscription Plan name (e.g. 'free', 'starter', 'pro', 'enterprise') */
+    plan?: string;
+    /** Billing Tier (e.g. 'tier_1', 'growth', 'unlimited') */
+    tier?: string;
+    /** Billing currency (defaults to 'usd') */
+    currency?: string;
+    /** Current prepaid credit balance in USD */
+    balanceUSD?: number;
+    /** Flexible custom metadata (key-value attributes) */
+    metadata?: Record<string, string | number | boolean | null>;
+    /** Arbitrary extra developer fields */
+    [key: string]: any;
+}
+/**
+ * Customer identification parameter: can be a string ('cus_xxx' or 'user@example.com') or a rich structured object
+ */
+type CustomerParam = string | CustomerInfo;
 /**
  * Full usage event emitted upon completion of an LLM call or stream
  */
@@ -70,19 +113,11 @@ interface UsageEvent {
     customerId?: string;
     /** Optional customer email */
     customerEmail?: string;
+    /** Full customer profile snapshot if provided */
+    customer?: CustomerInfo;
     /** Custom developer metadata (e.g. userId, orgId, feature, session) */
     metadata?: Record<string, string | number | boolean>;
 }
-/**
- * Customer identification parameter: can be a string ('cus_xxx' or 'user@example.com') or an object
- */
-type CustomerParam = string | {
-    id?: string;
-    userId?: string;
-    email?: string;
-    name?: string;
-    metadata?: Record<string, string>;
-};
 /**
  * Event emitted when a circuit breaker budget or token limit is reached
  */
@@ -119,7 +154,26 @@ interface CircuitBreakerOptions {
     throwOnBudgetExceeded?: boolean;
 }
 /**
- * Billing Configuration (Postpaid metered invoice vs Prepaid credit wallet)
+ * Pluggable Database / Storage Adapter Interface
+ */
+interface DatabaseAdapter {
+    name: string;
+    save: (event: UsageEvent) => Promise<void> | void;
+    getBalance?: (customerId: string) => Promise<number | undefined>;
+}
+/**
+ * Pluggable Payment Provider Interface
+ */
+interface PaymentProvider {
+    name: string;
+    charge?: (costUSD: number, event: UsageEvent) => Promise<void> | void;
+    checkBalance?: (customerId: string) => Promise<{
+        ok: boolean;
+        balanceUSD?: number;
+    }>;
+}
+/**
+ * Billing Configuration (Universal Auto-Debit, Postpaid metered invoice vs Prepaid credit wallet, Pluggable Providers)
  */
 interface BillingConfig {
     /** 'postpaid' = Invoiced at month's end; 'prepaid' = Deducted from credit wallet, locks at $0 */
@@ -128,6 +182,10 @@ interface BillingConfig {
     balanceUSD?: number;
     /** Action when balance is low: 'warn' logs/sends event, 'throw' throws CreditExhaustedError */
     onLowBalance?: 'warn' | 'throw';
+    /** Payment Provider Gateway (default: 'stripe') */
+    provider?: 'stripe' | 'polar' | 'lemonsqueezy' | 'paystack' | PaymentProvider;
+    /** Custom charge handler for internal credit wallets / bespoke payment logic */
+    charge?: (costUSD: number, event: UsageEvent) => Promise<void> | void;
 }
 /**
  * Profit Pricing & Markup Configuration
@@ -258,4 +316,4 @@ interface UsageSummary {
     }>;
 }
 
-export { type BillingConfig as B, type CustomerParam as C, type InferenceCost as I, type KnownModel as K, type MeterOptions as M, type PricingConfig as P, type RecordUsageOptions as R, type StreamWrapOptions as S, type TokenUsage as T, type UsageEvent as U, VibezCircuitBreakerError as V, type UsageSummary as a, type BudgetExceededEvent as b, type CircuitBreakerOptions as c, type InlineRateConfig as d, type ModelPricingRates as e, type SupportedAnthropicModel as f, type SupportedDeepSeekModel as g, type SupportedGoogleModel as h, type SupportedModel as i, type SupportedOpenAIModel as j, type ToolMeterOptions as k };
+export { type BillingConfig as B, type CustomerParam as C, type DatabaseAdapter as D, type InferenceCost as I, type KnownModel as K, type MeterOptions as M, type PaymentProvider as P, type RecordUsageOptions as R, type StreamWrapOptions as S, type TokenUsage as T, type UsageEvent as U, VibezCircuitBreakerError as V, type UsageSummary as a, type BudgetExceededEvent as b, type CircuitBreakerOptions as c, type CustomerInfo as d, type InlineRateConfig as e, type ModelPricingRates as f, type PricingConfig as g, type SupportedAnthropicModel as h, type SupportedDeepSeekModel as i, type SupportedGoogleModel as j, type SupportedModel as k, type SupportedOpenAIModel as l, type ToolMeterOptions as m };

package/dist/{types-Zbzxg-Ka.d.ts → types-Mozk4-Mr.d.ts}

@@ -50,6 +50,49 @@ interface InferenceCost {
     /** Currency (defaults to 'USD') */
     currency: string;
 }
+/**
+ * Structured Customer Information with rich metadata, multi-tenancy & billing attributes
+ */
+interface CustomerInfo {
+    /** Internal user ID or Stripe customer ID ('cus_xxx', 'usr_123') */
+    id?: string;
+    /** Explicit user ID */
+    userId?: string;
+    /** Customer email */
+    email?: string;
+    /** Customer full name or business display name */
+    name?: string;
+    /** Phone number */
+    phone?: string;
+    /** Multi-tenant Organization or Company ID */
+    orgId?: string;
+    /** Organization / Company name */
+    orgName?: string;
+    /** Multi-tenant Organization ID alias */
+    organizationId?: string;
+    /** Team / Workspace identifier */
+    teamId?: string;
+    /** Workspace identifier alias */
+    workspaceId?: string;
+    /** User Role within organization (e.g. 'admin', 'member', 'owner') */
+    role?: string;
+    /** Subscription Plan name (e.g. 'free', 'starter', 'pro', 'enterprise') */
+    plan?: string;
+    /** Billing Tier (e.g. 'tier_1', 'growth', 'unlimited') */
+    tier?: string;
+    /** Billing currency (defaults to 'usd') */
+    currency?: string;
+    /** Current prepaid credit balance in USD */
+    balanceUSD?: number;
+    /** Flexible custom metadata (key-value attributes) */
+    metadata?: Record<string, string | number | boolean | null>;
+    /** Arbitrary extra developer fields */
+    [key: string]: any;
+}
+/**
+ * Customer identification parameter: can be a string ('cus_xxx' or 'user@example.com') or a rich structured object
+ */
+type CustomerParam = string | CustomerInfo;
 /**
  * Full usage event emitted upon completion of an LLM call or stream
  */
@@ -70,19 +113,11 @@ interface UsageEvent {
     customerId?: string;
     /** Optional customer email */
     customerEmail?: string;
+    /** Full customer profile snapshot if provided */
+    customer?: CustomerInfo;
     /** Custom developer metadata (e.g. userId, orgId, feature, session) */
     metadata?: Record<string, string | number | boolean>;
 }
-/**
- * Customer identification parameter: can be a string ('cus_xxx' or 'user@example.com') or an object
- */
-type CustomerParam = string | {
-    id?: string;
-    userId?: string;
-    email?: string;
-    name?: string;
-    metadata?: Record<string, string>;
-};
 /**
  * Event emitted when a circuit breaker budget or token limit is reached
  */
@@ -119,7 +154,26 @@ interface CircuitBreakerOptions {
     throwOnBudgetExceeded?: boolean;
 }
 /**
- * Billing Configuration (Postpaid metered invoice vs Prepaid credit wallet)
+ * Pluggable Database / Storage Adapter Interface
+ */
+interface DatabaseAdapter {
+    name: string;
+    save: (event: UsageEvent) => Promise<void> | void;
+    getBalance?: (customerId: string) => Promise<number | undefined>;
+}
+/**
+ * Pluggable Payment Provider Interface
+ */
+interface PaymentProvider {
+    name: string;
+    charge?: (costUSD: number, event: UsageEvent) => Promise<void> | void;
+    checkBalance?: (customerId: string) => Promise<{
+        ok: boolean;
+        balanceUSD?: number;
+    }>;
+}
+/**
+ * Billing Configuration (Universal Auto-Debit, Postpaid metered invoice vs Prepaid credit wallet, Pluggable Providers)
  */
 interface BillingConfig {
     /** 'postpaid' = Invoiced at month's end; 'prepaid' = Deducted from credit wallet, locks at $0 */
@@ -128,6 +182,10 @@ interface BillingConfig {
     balanceUSD?: number;
     /** Action when balance is low: 'warn' logs/sends event, 'throw' throws CreditExhaustedError */
     onLowBalance?: 'warn' | 'throw';
+    /** Payment Provider Gateway (default: 'stripe') */
+    provider?: 'stripe' | 'polar' | 'lemonsqueezy' | 'paystack' | PaymentProvider;
+    /** Custom charge handler for internal credit wallets / bespoke payment logic */
+    charge?: (costUSD: number, event: UsageEvent) => Promise<void> | void;
 }
 /**
  * Profit Pricing & Markup Configuration
@@ -258,4 +316,4 @@ interface UsageSummary {
     }>;
 }
 
-export { type BillingConfig as B, type CustomerParam as C, type InferenceCost as I, type KnownModel as K, type MeterOptions as M, type PricingConfig as P, type RecordUsageOptions as R, type StreamWrapOptions as S, type TokenUsage as T, type UsageEvent as U, VibezCircuitBreakerError as V, type UsageSummary as a, type BudgetExceededEvent as b, type CircuitBreakerOptions as c, type InlineRateConfig as d, type ModelPricingRates as e, type SupportedAnthropicModel as f, type SupportedDeepSeekModel as g, type SupportedGoogleModel as h, type SupportedModel as i, type SupportedOpenAIModel as j, type ToolMeterOptions as k };
+export { type BillingConfig as B, type CustomerParam as C, type DatabaseAdapter as D, type InferenceCost as I, type KnownModel as K, type MeterOptions as M, type PaymentProvider as P, type RecordUsageOptions as R, type StreamWrapOptions as S, type TokenUsage as T, type UsageEvent as U, VibezCircuitBreakerError as V, type UsageSummary as a, type BudgetExceededEvent as b, type CircuitBreakerOptions as c, type CustomerInfo as d, type InlineRateConfig as e, type ModelPricingRates as f, type PricingConfig as g, type SupportedAnthropicModel as h, type SupportedDeepSeekModel as i, type SupportedGoogleModel as j, type SupportedModel as k, type SupportedOpenAIModel as l, type ToolMeterOptions as m };

package/package.json

@@ -1,153 +1,161 @@
-{
-  "name": "vibezcheck",
-  "version": "0.4.1",
-  "description": "The 1-line Stripe Billing and Token Metering engine for LLMs. Track tokens, compute real-time dollar costs, and bill customers with 0ms added latency.",
-  "author": "VibezCheck <dev@vibezcheck.xyz> (https://vibezcheck.xyz)",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/seeyouin2x5x/vibezcheck-sdk.git"
-  },
-  "keywords": [
-    "stripe",
-    "ai",
-    "billing",
-    "tokens",
-    "metering",
-    "llm",
-    "openai",
-    "anthropic",
-    "gemini",
-    "vercel-ai",
-    "ai-sdk",
-    "reasoning",
-    "cost-calculator"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
-    },
-    "./meter": {
-      "types": "./dist/meter/index.d.ts",
-      "import": "./dist/meter/index.mjs",
-      "require": "./dist/meter/index.js"
-    },
-    "./pricing": {
-      "types": "./dist/pricing/index.d.ts",
-      "import": "./dist/pricing/index.mjs",
-      "require": "./dist/pricing/index.js"
-    },
-    "./ai-sdk": {
-      "types": "./dist/ai-sdk/index.d.ts",
-      "import": "./dist/ai-sdk/index.mjs",
-      "require": "./dist/ai-sdk/index.js"
-    },
-    "./customers": {
-      "types": "./dist/customers/index.d.ts",
-      "import": "./dist/customers/index.mjs",
-      "require": "./dist/customers/index.js"
-    },
-    "./auth": {
-      "types": "./dist/auth/index.d.ts",
-      "import": "./dist/auth/index.mjs",
-      "require": "./dist/auth/index.js"
-    },
-    "./billing": {
-      "types": "./dist/billing/index.d.ts",
-      "import": "./dist/billing/index.mjs",
-      "require": "./dist/billing/index.js"
-    },
-    "./react": {
-      "types": "./dist/react/index.d.ts",
-      "import": "./dist/react/index.mjs",
-      "require": "./dist/react/index.js"
-    }
-  },
-  "bin": {
-    "vibezcheck": "bin/vibezcheck.js"
-  },
-  "files": [
-    "dist",
-    "bin",
-    "README.md",
-    "LICENSE",
-    "package.json"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "clean": "rm -rf dist",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
-    "prepublishOnly": "npm run build"
-  },
-  "dependencies": {
-    "stripe": "^17.5.0"
-  },
-  "devDependencies": {
-    "@ai-sdk/anthropic": "^2.0.35",
-    "@ai-sdk/google": "^2.0.23",
-    "@ai-sdk/openai": "^2.0.53",
-    "@ai-sdk/provider": "^3.0.0",
-    "@anthropic-ai/sdk": "^0.67.0",
-    "@google/generative-ai": "^0.24.1",
-    "@types/jest": "^29.5.14",
-    "@types/node": "^22.10.5",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "ai": "^5.0.76",
-    "jest": "^29.7.0",
-    "jest-environment-jsdom": "^29.7.0",
-    "openai": "^6.6.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "ts-jest": "^29.2.5",
-    "ts-node": "^10.9.2",
-    "tsup": "^8.3.5",
-    "typescript": "^5.8.3"
-  },
-  "peerDependencies": {
-    "@ai-sdk/provider": "^3.0.0",
-    "@anthropic-ai/sdk": "^0.32.0 || ^0.67.0",
-    "@google/generative-ai": "^0.21.0 || ^0.24.0",
-    "ai": "^3.0.0 || ^4.0.0 || ^5.0.0",
-    "openai": "^4.0.0 || ^6.0.0",
-    "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0",
-    "stripe": "^16.0.0 || ^17.0.0 || ^18.0.0"
-  },
-  "peerDependenciesMeta": {
-    "@ai-sdk/provider": {
-      "optional": true
-    },
-    "@anthropic-ai/sdk": {
-      "optional": true
-    },
-    "@google/generative-ai": {
-      "optional": true
-    },
-    "ai": {
-      "optional": true
-    },
-    "openai": {
-      "optional": true
-    },
-    "react": {
-      "optional": true
-    },
-    "react-dom": {
-      "optional": true
-    },
-    "stripe": {
-      "optional": true
-    }
-  }
-}
+{
+  "name": "vibezcheck",
+  "version": "0.4.2",
+  "description": "The 1-line Stripe Billing and Token Metering engine for LLMs. Track tokens, compute real-time dollar costs, and bill customers with 0ms added latency.",
+  "author": "VibezCheck <dev@vibezcheck.xyz> (https://vibezcheck.xyz)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/seeyouin2x5x/vibezcheck-sdk.git"
+  },
+  "keywords": [
+    "stripe",
+    "ai",
+    "billing",
+    "tokens",
+    "metering",
+    "llm",
+    "openai",
+    "anthropic",
+    "gemini",
+    "vercel-ai",
+    "ai-sdk",
+    "reasoning",
+    "cost-calculator"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./meter": {
+      "types": "./dist/meter/index.d.ts",
+      "import": "./dist/meter/index.mjs",
+      "require": "./dist/meter/index.js"
+    },
+    "./pricing": {
+      "types": "./dist/pricing/index.d.ts",
+      "import": "./dist/pricing/index.mjs",
+      "require": "./dist/pricing/index.js"
+    },
+    "./ai-sdk": {
+      "types": "./dist/ai-sdk/index.d.ts",
+      "import": "./dist/ai-sdk/index.mjs",
+      "require": "./dist/ai-sdk/index.js"
+    },
+    "./customers": {
+      "types": "./dist/customers/index.d.ts",
+      "import": "./dist/customers/index.mjs",
+      "require": "./dist/customers/index.js"
+    },
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "import": "./dist/auth/index.mjs",
+      "require": "./dist/auth/index.js"
+    },
+    "./billing": {
+      "types": "./dist/billing/index.d.ts",
+      "import": "./dist/billing/index.mjs",
+      "require": "./dist/billing/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.mjs",
+      "require": "./dist/react/index.js"
+    }
+  },
+  "bin": {
+    "vibezcheck": "bin/vibezcheck.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "stripe": "^17.5.0"
+  },
+  "devDependencies": {
+    "@ai-sdk/anthropic": "^2.0.35",
+    "@ai-sdk/google": "^2.0.23",
+    "@ai-sdk/openai": "^2.0.53",
+    "@ai-sdk/provider": "^3.0.0",
+    "@anthropic-ai/sdk": "^0.67.0",
+    "@google/generative-ai": "^0.24.1",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.10.5",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "ai": "^5.0.76",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "openai": "^6.6.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "tsup": "^8.3.5",
+    "typescript": "^5.8.3"
+  },
+  "peerDependencies": {
+    "@ai-sdk/provider": "^3.0.0",
+    "@anthropic-ai/sdk": "^0.32.0 || ^0.67.0",
+    "@google/generative-ai": "^0.21.0 || ^0.24.0",
+    "ai": "^3.0.0 || ^4.0.0 || ^5.0.0",
+    "openai": "^4.0.0 || ^6.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "stripe": "^16.0.0 || ^17.0.0 || ^18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/provider": {
+      "optional": true
+    },
+    "@anthropic-ai/sdk": {
+      "optional": true
+    },
+    "@google/generative-ai": {
+      "optional": true
+    },
+    "ai": {
+      "optional": true
+    },
+    "openai": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "stripe": {
+      "optional": true
+    }
+  },
+  "homepage": "https://vibezcheck.xyz",
+  "bugs": {
+    "url": "https://github.com/seeyouin2x5x/vibezcheck-sdk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false
+}