vibezcheck 0.1.0

package/dist/types-CSrSmsd1.d.mts

@@ -0,0 +1,159 @@
+import Stripe from 'stripe';
+
+/**
+ * Detailed token usage breakdown
+ */
+interface TokenUsage {
+    /** Input/Prompt tokens */
+    inputTokens: number;
+    /** Total output/completion tokens (including reasoning) */
+    outputTokens: number;
+    /** Total tokens (input + output) */
+    totalTokens: number;
+    /** Hidden reasoning / thinking tokens (e.g. o1/o3/GPT-5, Claude 3.7 Thinking, Gemini 3.7 Thoughts) */
+    reasoningTokens?: number;
+    /** Visible output tokens (outputTokens - reasoningTokens) */
+    visibleOutputTokens?: number;
+    /** Cached input tokens read from KV cache / prompt cache */
+    cachedTokens?: number;
+    /** Cache write / creation tokens */
+    cacheWriteTokens?: number;
+}
+/**
+ * Calculated inference cost breakdown
+ */
+interface InferenceCost {
+    /** Cost for standard input prompt tokens in USD */
+    inputCostUSD: number;
+    /** Cost for output completion tokens in USD */
+    outputCostUSD: number;
+    /** Cost for reasoning/thinking tokens in USD (if applicable) */
+    reasoningCostUSD?: number;
+    /** Savings from prompt caching in USD */
+    cachedDiscountUSD?: number;
+    /** Total computed base inference cost in USD */
+    totalUSD: number;
+    /** Retail price after developer markup (if markup applied) */
+    retailUSD?: number;
+    /** Currency (defaults to 'USD') */
+    currency: string;
+}
+/**
+ * Full usage event emitted upon completion of an LLM call or stream
+ */
+interface UsageEvent {
+    /** Unique ID for the event */
+    id?: string;
+    /** Timestamp ISO string */
+    timestamp: string;
+    /** Model name (e.g. 'gpt-5.6-sol', 'claude-3-7-sonnet') */
+    model: string;
+    /** Provider (e.g. 'openai', 'anthropic', 'google', 'mistral', 'groq', 'deepseek', 'generic') */
+    provider: string;
+    /** Token breakdown */
+    usage: TokenUsage;
+    /** Computed cost */
+    cost: InferenceCost;
+    /** Customer ID (Stripe customer ID, internal userId, or anonymous) */
+    customerId?: string;
+    /** Optional customer email */
+    customerEmail?: string;
+    /** 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>;
+};
+/**
+ * Configuration options for the VibezCheck Meter
+ */
+interface MeterOptions {
+    /** Stripe API Key (sk_* or rk_*). If omitted, runs in local telemetry/free mode */
+    apiKey?: string;
+    /** Existing Stripe SDK instance (optional) */
+    stripe?: Stripe;
+    /** Default Stripe Meter Event Name (default: 'token-billing-tokens') */
+    eventName?: string;
+    /** Batching options to optimize Stripe API calls */
+    batching?: {
+        /** Max events per batch (default: 50) */
+        maxBatchSize?: number;
+        /** Flush interval in milliseconds (default: 50ms) */
+        flushIntervalMs?: number;
+    };
+    /** Callback fired whenever usage is extracted (works with or without Stripe) */
+    onUsage?: (event: UsageEvent) => void | Promise<void>;
+    /** Error handler callback */
+    onError?: (error: Error, events: UsageEvent[]) => void;
+    /** Markup multiplier for retail price calculations (e.g. 1.3 for 30% profit) */
+    markupMultiplier?: number;
+    /** Enable debug console logging (default: false) */
+    debug?: boolean;
+}
+/**
+ * Stream wrap options
+ */
+interface StreamWrapOptions {
+    /** Customer identifier or email or object */
+    customer?: CustomerParam;
+    /** Direct customer ID string */
+    customerId?: string;
+    /** Model override if not automatically detectable */
+    model?: string;
+    /** Provider override if not automatically detectable */
+    provider?: string;
+    /** Custom metadata attached to the usage event */
+    metadata?: Record<string, string | number | boolean>;
+    /** Custom usage callback for this specific stream */
+    onUsage?: (event: UsageEvent) => void | Promise<void>;
+}
+/**
+ * Direct usage recording options
+ */
+interface RecordUsageOptions {
+    model: string;
+    provider?: string;
+    inputTokens: number;
+    outputTokens: number;
+    reasoningTokens?: number;
+    cachedTokens?: number;
+    customer?: CustomerParam;
+    customerId?: string;
+    metadata?: Record<string, string | number | boolean>;
+}
+/**
+ * Model Pricing Rates (per 1 Million Tokens in USD)
+ */
+interface ModelPricingRates {
+    inputPer1M: number;
+    outputPer1M: number;
+    cachedInputPer1M?: number;
+    reasoningPer1M?: number;
+    cacheWritePer1M?: number;
+    currency?: string;
+}
+/**
+ * Aggregated Usage Summary
+ */
+interface UsageSummary {
+    totalRequests: number;
+    totalTokens: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalReasoningTokens: number;
+    totalCostUSD: number;
+    byModel: Record<string, {
+        requests: number;
+        tokens: number;
+        costUSD: number;
+    }>;
+}
+
+export type { CustomerParam as C, InferenceCost as I, MeterOptions as M, RecordUsageOptions as R, StreamWrapOptions as S, TokenUsage as T, UsageEvent as U, UsageSummary as a, ModelPricingRates as b };

package/dist/types-CSrSmsd1.d.ts

@@ -0,0 +1,159 @@
+import Stripe from 'stripe';
+
+/**
+ * Detailed token usage breakdown
+ */
+interface TokenUsage {
+    /** Input/Prompt tokens */
+    inputTokens: number;
+    /** Total output/completion tokens (including reasoning) */
+    outputTokens: number;
+    /** Total tokens (input + output) */
+    totalTokens: number;
+    /** Hidden reasoning / thinking tokens (e.g. o1/o3/GPT-5, Claude 3.7 Thinking, Gemini 3.7 Thoughts) */
+    reasoningTokens?: number;
+    /** Visible output tokens (outputTokens - reasoningTokens) */
+    visibleOutputTokens?: number;
+    /** Cached input tokens read from KV cache / prompt cache */
+    cachedTokens?: number;
+    /** Cache write / creation tokens */
+    cacheWriteTokens?: number;
+}
+/**
+ * Calculated inference cost breakdown
+ */
+interface InferenceCost {
+    /** Cost for standard input prompt tokens in USD */
+    inputCostUSD: number;
+    /** Cost for output completion tokens in USD */
+    outputCostUSD: number;
+    /** Cost for reasoning/thinking tokens in USD (if applicable) */
+    reasoningCostUSD?: number;
+    /** Savings from prompt caching in USD */
+    cachedDiscountUSD?: number;
+    /** Total computed base inference cost in USD */
+    totalUSD: number;
+    /** Retail price after developer markup (if markup applied) */
+    retailUSD?: number;
+    /** Currency (defaults to 'USD') */
+    currency: string;
+}
+/**
+ * Full usage event emitted upon completion of an LLM call or stream
+ */
+interface UsageEvent {
+    /** Unique ID for the event */
+    id?: string;
+    /** Timestamp ISO string */
+    timestamp: string;
+    /** Model name (e.g. 'gpt-5.6-sol', 'claude-3-7-sonnet') */
+    model: string;
+    /** Provider (e.g. 'openai', 'anthropic', 'google', 'mistral', 'groq', 'deepseek', 'generic') */
+    provider: string;
+    /** Token breakdown */
+    usage: TokenUsage;
+    /** Computed cost */
+    cost: InferenceCost;
+    /** Customer ID (Stripe customer ID, internal userId, or anonymous) */
+    customerId?: string;
+    /** Optional customer email */
+    customerEmail?: string;
+    /** 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>;
+};
+/**
+ * Configuration options for the VibezCheck Meter
+ */
+interface MeterOptions {
+    /** Stripe API Key (sk_* or rk_*). If omitted, runs in local telemetry/free mode */
+    apiKey?: string;
+    /** Existing Stripe SDK instance (optional) */
+    stripe?: Stripe;
+    /** Default Stripe Meter Event Name (default: 'token-billing-tokens') */
+    eventName?: string;
+    /** Batching options to optimize Stripe API calls */
+    batching?: {
+        /** Max events per batch (default: 50) */
+        maxBatchSize?: number;
+        /** Flush interval in milliseconds (default: 50ms) */
+        flushIntervalMs?: number;
+    };
+    /** Callback fired whenever usage is extracted (works with or without Stripe) */
+    onUsage?: (event: UsageEvent) => void | Promise<void>;
+    /** Error handler callback */
+    onError?: (error: Error, events: UsageEvent[]) => void;
+    /** Markup multiplier for retail price calculations (e.g. 1.3 for 30% profit) */
+    markupMultiplier?: number;
+    /** Enable debug console logging (default: false) */
+    debug?: boolean;
+}
+/**
+ * Stream wrap options
+ */
+interface StreamWrapOptions {
+    /** Customer identifier or email or object */
+    customer?: CustomerParam;
+    /** Direct customer ID string */
+    customerId?: string;
+    /** Model override if not automatically detectable */
+    model?: string;
+    /** Provider override if not automatically detectable */
+    provider?: string;
+    /** Custom metadata attached to the usage event */
+    metadata?: Record<string, string | number | boolean>;
+    /** Custom usage callback for this specific stream */
+    onUsage?: (event: UsageEvent) => void | Promise<void>;
+}
+/**
+ * Direct usage recording options
+ */
+interface RecordUsageOptions {
+    model: string;
+    provider?: string;
+    inputTokens: number;
+    outputTokens: number;
+    reasoningTokens?: number;
+    cachedTokens?: number;
+    customer?: CustomerParam;
+    customerId?: string;
+    metadata?: Record<string, string | number | boolean>;
+}
+/**
+ * Model Pricing Rates (per 1 Million Tokens in USD)
+ */
+interface ModelPricingRates {
+    inputPer1M: number;
+    outputPer1M: number;
+    cachedInputPer1M?: number;
+    reasoningPer1M?: number;
+    cacheWritePer1M?: number;
+    currency?: string;
+}
+/**
+ * Aggregated Usage Summary
+ */
+interface UsageSummary {
+    totalRequests: number;
+    totalTokens: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalReasoningTokens: number;
+    totalCostUSD: number;
+    byModel: Record<string, {
+        requests: number;
+        tokens: number;
+        costUSD: number;
+    }>;
+}
+
+export type { CustomerParam as C, InferenceCost as I, MeterOptions as M, RecordUsageOptions as R, StreamWrapOptions as S, TokenUsage as T, UsageEvent as U, UsageSummary as a, ModelPricingRates as b };

package/package.json

@@ -0,0 +1,131 @@
+{
+  "name": "vibezcheck",
+  "version": "0.1.0",
+  "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": "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"
+    }
+  },
+  "files": [
+    "dist",
+    "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",
+    "ai": "^5.0.76",
+    "jest": "^29.7.0",
+    "openai": "^6.6.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",
+    "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
+    },
+    "stripe": {
+      "optional": true
+    }
+  }
+}