vibezcheck 0.1.0

package/dist/customers/index.mjs

@@ -0,0 +1,119 @@
+// src/customers/manager.ts
+import Stripe from "stripe";
+
+// src/customers/cache.ts
+var CustomerCache = class {
+  cache = /* @__PURE__ */ new Map();
+  defaultTtlMs;
+  constructor(defaultTtlMs = 1e3 * 60 * 60) {
+    this.defaultTtlMs = defaultTtlMs;
+  }
+  get(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return null;
+    if (Date.now() > entry.expiresAt) {
+      this.cache.delete(key);
+      return null;
+    }
+    return entry.customerId;
+  }
+  set(key, customerId, ttlMs) {
+    const expiresAt = Date.now() + (ttlMs ?? this.defaultTtlMs);
+    this.cache.set(key, { customerId, expiresAt });
+  }
+  delete(key) {
+    this.cache.delete(key);
+  }
+  clear() {
+    this.cache.clear();
+  }
+};
+
+// src/customers/manager.ts
+var CustomerManager = class {
+  stripe;
+  cache;
+  constructor(options = {}) {
+    if (options.stripe) {
+      this.stripe = options.stripe;
+    } else {
+      const apiKey = options.apiKey || process.env.STRIPE_SECRET_KEY;
+      if (!apiKey) {
+        throw new Error("[vibezcheck] Stripe API key required for customer management.");
+      }
+      this.stripe = new Stripe(apiKey);
+    }
+    this.cache = new CustomerCache(options.cacheTtlMs);
+  }
+  /**
+   * Retrieves existing Stripe Customer or automatically provisions a new one
+   */
+  async getOrCreate(params) {
+    const cacheKey = params.userId || params.email;
+    if (cacheKey) {
+      const cachedId = this.cache.get(cacheKey);
+      if (cachedId) {
+        return {
+          id: cachedId,
+          isNew: false,
+          customer: { id: cachedId }
+        };
+      }
+    }
+    if (params.userId) {
+      try {
+        const searchResult = await this.stripe.customers.search({
+          query: `metadata['vibez_user_id']:'${params.userId}'`,
+          limit: 1
+        });
+        if (searchResult.data.length > 0) {
+          const customer = searchResult.data[0];
+          if (cacheKey) this.cache.set(cacheKey, customer.id);
+          if (params.email) this.cache.set(params.email, customer.id);
+          return { id: customer.id, isNew: false, customer };
+        }
+      } catch {
+      }
+    }
+    if (params.email) {
+      const listResult = await this.stripe.customers.list({
+        email: params.email,
+        limit: 1
+      });
+      if (listResult.data.length > 0) {
+        const customer = listResult.data[0];
+        if (cacheKey) this.cache.set(cacheKey, customer.id);
+        if (params.userId) this.cache.set(params.userId, customer.id);
+        return { id: customer.id, isNew: false, customer };
+      }
+    }
+    const newCustomer = await this.stripe.customers.create({
+      email: params.email,
+      name: params.name,
+      metadata: {
+        vibez_user_id: params.userId,
+        created_by: "vibezcheck",
+        ...params.metadata || {}
+      }
+    });
+    if (cacheKey) this.cache.set(cacheKey, newCustomer.id);
+    if (params.userId) this.cache.set(params.userId, newCustomer.id);
+    if (params.email) this.cache.set(params.email, newCustomer.id);
+    return { id: newCustomer.id, isNew: true, customer: newCustomer };
+  }
+  /**
+   * Clears in-memory resolution cache
+   */
+  clearCache() {
+    this.cache.clear();
+  }
+};
+function createCustomerManager(options = {}) {
+  return new CustomerManager(options);
+}
+export {
+  CustomerCache,
+  CustomerManager,
+  createCustomerManager
+};
+//# sourceMappingURL=index.mjs.map

package/dist/customers/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/customers/manager.ts","../../src/customers/cache.ts"],"sourcesContent":["import Stripe from 'stripe';\nimport { CustomerCache } from './cache';\n\nexport interface GetOrCreateCustomerParams {\n  userId: string;\n  email?: string;\n  name?: string;\n  metadata?: Record<string, string>;\n}\n\nexport interface CustomerManagerOptions {\n  apiKey?: string;\n  stripe?: Stripe;\n  cacheTtlMs?: number;\n}\n\nexport class CustomerManager {\n  private stripe: Stripe;\n  private cache: CustomerCache;\n\n  constructor(options: CustomerManagerOptions = {}) {\n    if (options.stripe) {\n      this.stripe = options.stripe;\n    } else {\n      const apiKey = options.apiKey || process.env.STRIPE_SECRET_KEY;\n      if (!apiKey) {\n        throw new Error('[vibezcheck] Stripe API key required for customer management.');\n      }\n      this.stripe = new Stripe(apiKey);\n    }\n\n    this.cache = new CustomerCache(options.cacheTtlMs);\n  }\n\n  /**\n   * Retrieves existing Stripe Customer or automatically provisions a new one\n   */\n  public async getOrCreate(\n    params: GetOrCreateCustomerParams\n  ): Promise<{ id: string; isNew: boolean; customer: Stripe.Customer }> {\n    const cacheKey = params.userId || params.email;\n    if (cacheKey) {\n      const cachedId = this.cache.get(cacheKey);\n      if (cachedId) {\n        return {\n          id: cachedId,\n          isNew: false,\n          customer: { id: cachedId } as Stripe.Customer,\n        };\n      }\n    }\n\n    // 1. Search by userId in Stripe metadata\n    if (params.userId) {\n      try {\n        const searchResult = await this.stripe.customers.search({\n          query: `metadata['vibez_user_id']:'${params.userId}'`,\n          limit: 1,\n        });\n\n        if (searchResult.data.length > 0) {\n          const customer = searchResult.data[0];\n          if (cacheKey) this.cache.set(cacheKey, customer.id);\n          if (params.email) this.cache.set(params.email, customer.id);\n          return { id: customer.id, isNew: false, customer };\n        }\n      } catch {\n        // Fallback to email search if search query is unsupported or errors\n      }\n    }\n\n    // 2. Search by email if provided\n    if (params.email) {\n      const listResult = await this.stripe.customers.list({\n        email: params.email,\n        limit: 1,\n      });\n\n      if (listResult.data.length > 0) {\n        const customer = listResult.data[0];\n        if (cacheKey) this.cache.set(cacheKey, customer.id);\n        if (params.userId) this.cache.set(params.userId, customer.id);\n        return { id: customer.id, isNew: false, customer };\n      }\n    }\n\n    // 3. Create new Customer in Stripe\n    const newCustomer = await this.stripe.customers.create({\n      email: params.email,\n      name: params.name,\n      metadata: {\n        vibez_user_id: params.userId,\n        created_by: 'vibezcheck',\n        ...(params.metadata || {}),\n      },\n    });\n\n    if (cacheKey) this.cache.set(cacheKey, newCustomer.id);\n    if (params.userId) this.cache.set(params.userId, newCustomer.id);\n    if (params.email) this.cache.set(params.email, newCustomer.id);\n\n    return { id: newCustomer.id, isNew: true, customer: newCustomer };\n  }\n\n  /**\n   * Clears in-memory resolution cache\n   */\n  public clearCache(): void {\n    this.cache.clear();\n  }\n}\n\n/**\n * Factory to create CustomerManager\n */\nexport function createCustomerManager(options: CustomerManagerOptions = {}): CustomerManager {\n  return new CustomerManager(options);\n}\n","interface CacheEntry {\n  customerId: string;\n  expiresAt: number;\n}\n\n/**\n * In-memory Customer Resolution Cache with TTL\n */\nexport class CustomerCache {\n  private cache = new Map<string, CacheEntry>();\n  private readonly defaultTtlMs: number;\n\n  constructor(defaultTtlMs: number = 1000 * 60 * 60) {\n    // Default TTL: 1 hour\n    this.defaultTtlMs = defaultTtlMs;\n  }\n\n  public get(key: string): string | null {\n    const entry = this.cache.get(key);\n    if (!entry) return null;\n\n    if (Date.now() > entry.expiresAt) {\n      this.cache.delete(key);\n      return null;\n    }\n\n    return entry.customerId;\n  }\n\n  public set(key: string, customerId: string, ttlMs?: number): void {\n    const expiresAt = Date.now() + (ttlMs ?? this.defaultTtlMs);\n    this.cache.set(key, { customerId, expiresAt });\n  }\n\n  public delete(key: string): void {\n    this.cache.delete(key);\n  }\n\n  public clear(): void {\n    this.cache.clear();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.mts

@@ -0,0 +1,92 @@
+import { M as MeterOptions, S as StreamWrapOptions, C as CustomerParam, U as UsageEvent, a as UsageSummary } from './types-CSrSmsd1.mjs';
+export { I as InferenceCost, b as ModelPricingRates, R as RecordUsageOptions, T as TokenUsage } from './types-CSrSmsd1.mjs';
+import { V as VibezMeter } from './client-MJ3tl7bz.mjs';
+export { c as createMeter } from './client-MJ3tl7bz.mjs';
+import { CustomerManager } from './customers/index.mjs';
+export { CustomerCache, CustomerManagerOptions, GetOrCreateCustomerParams, createCustomerManager } from './customers/index.mjs';
+import { ApiKeyAuth } from './auth/index.mjs';
+export { ApiKeyRecord, CreateApiKeyParams, VerifyAuthResult, createApiKeyAuth, extractAuthToken } from './auth/index.mjs';
+import { BillingHelper } from './billing/index.mjs';
+export { CreateCheckoutSessionParams, CreatePortalSessionParams, CreateTopUpSessionParams, createBillingHelper } from './billing/index.mjs';
+export { AnthropicStreamAccumulator, ExtractedUsage, MeterBatcher, UsageDispatchedCallback, detectAndExtractUsage, extractAnthropicResponseUsage, extractGeminiResponseUsage, extractGenericResponseUsage, extractOpenAIResponseUsage, inspectOpenAIStreamChunk, trackTokens, wrapAnthropicStream, wrapGeminiStream, wrapOpenAIStream, wrapStream, wrapUniversalStream } from './meter/index.mjs';
+export { CalculateCostParams, MODEL_PRICING_TABLE, calculateCost, calculateUsageCost, getModelPricing, normalizeModelKey, registerModelPricing } from './pricing/index.mjs';
+export { WithBillingOptions, meteredModel, withBilling } from './ai-sdk/index.mjs';
+import 'stripe';
+
+/**
+ * VibezCheck Unified Client Configuration
+ */
+interface VibezCheckConfig extends MeterOptions {
+    /** Auto-initialize CustomerManager (default: true if Stripe key present) */
+    autoCustomers?: boolean;
+}
+/**
+ * VibezCheck Unified Client Instance
+ */
+declare class VibezCheckClient {
+    meter: VibezMeter;
+    customers?: CustomerManager;
+    auth?: ApiKeyAuth;
+    billing?: BillingHelper;
+    private stripeClient?;
+    constructor(config?: VibezCheckConfig);
+    /**
+     * 1-Line Zero-Latency Stream Wrapper for OpenAI, Anthropic, Gemini, etc.
+     */
+    wrapStream<T>(stream: T, options?: StreamWrapOptions): T;
+    /**
+     * Track token usage from a non-streaming response object
+     */
+    track(response: any, options?: {
+        customer?: CustomerParam;
+        model?: string;
+    }): UsageEvent | null;
+    /**
+     * 1-Line Wrapper for Vercel AI SDK LanguageModel
+     */
+    withBilling<T extends object>(model: T, options?: {
+        customer?: CustomerParam;
+    }): T;
+    /**
+     * 1-Line Universal Stream Responder for API Routes (Next.js, Express, Hono)
+     */
+    stream(params: {
+        model: string;
+        messages: Array<{
+            role: string;
+            content: string;
+        }>;
+        customer?: CustomerParam;
+        temperature?: number;
+    }): Promise<Response>;
+    /**
+     * Flush pending meter events (vital for serverless runtimes)
+     */
+    flush(): Promise<void>;
+    /**
+     * In-memory usage statistics
+     */
+    getUsageSummary(): UsageSummary;
+}
+/**
+ * Factory to create VibezCheck client
+ */
+declare function createVibezCheck(config?: VibezCheckConfig): VibezCheckClient;
+/**
+ * vibezcheck factory alias
+ */
+declare const vibezcheck: typeof createVibezCheck;
+/**
+ * vibescheck alias (tolerates spelling difference)
+ */
+declare const vibescheck: typeof createVibezCheck;
+/**
+ * Singleton instance initialized with process.env
+ */
+declare const vibez: VibezCheckClient;
+/**
+ * Singleton alias
+ */
+declare const vibes: VibezCheckClient;
+
+export { ApiKeyAuth, BillingHelper, CustomerManager, CustomerParam, MeterOptions, StreamWrapOptions, UsageEvent, UsageSummary, VibezCheckClient, type VibezCheckConfig, VibezMeter, createVibezCheck, vibes, vibescheck, vibez, vibezcheck };

package/dist/index.d.ts

@@ -0,0 +1,92 @@
+import { M as MeterOptions, S as StreamWrapOptions, C as CustomerParam, U as UsageEvent, a as UsageSummary } from './types-CSrSmsd1.js';
+export { I as InferenceCost, b as ModelPricingRates, R as RecordUsageOptions, T as TokenUsage } from './types-CSrSmsd1.js';
+import { V as VibezMeter } from './client-txrE0D_D.js';
+export { c as createMeter } from './client-txrE0D_D.js';
+import { CustomerManager } from './customers/index.js';
+export { CustomerCache, CustomerManagerOptions, GetOrCreateCustomerParams, createCustomerManager } from './customers/index.js';
+import { ApiKeyAuth } from './auth/index.js';
+export { ApiKeyRecord, CreateApiKeyParams, VerifyAuthResult, createApiKeyAuth, extractAuthToken } from './auth/index.js';
+import { BillingHelper } from './billing/index.js';
+export { CreateCheckoutSessionParams, CreatePortalSessionParams, CreateTopUpSessionParams, createBillingHelper } from './billing/index.js';
+export { AnthropicStreamAccumulator, ExtractedUsage, MeterBatcher, UsageDispatchedCallback, detectAndExtractUsage, extractAnthropicResponseUsage, extractGeminiResponseUsage, extractGenericResponseUsage, extractOpenAIResponseUsage, inspectOpenAIStreamChunk, trackTokens, wrapAnthropicStream, wrapGeminiStream, wrapOpenAIStream, wrapStream, wrapUniversalStream } from './meter/index.js';
+export { CalculateCostParams, MODEL_PRICING_TABLE, calculateCost, calculateUsageCost, getModelPricing, normalizeModelKey, registerModelPricing } from './pricing/index.js';
+export { WithBillingOptions, meteredModel, withBilling } from './ai-sdk/index.js';
+import 'stripe';
+
+/**
+ * VibezCheck Unified Client Configuration
+ */
+interface VibezCheckConfig extends MeterOptions {
+    /** Auto-initialize CustomerManager (default: true if Stripe key present) */
+    autoCustomers?: boolean;
+}
+/**
+ * VibezCheck Unified Client Instance
+ */
+declare class VibezCheckClient {
+    meter: VibezMeter;
+    customers?: CustomerManager;
+    auth?: ApiKeyAuth;
+    billing?: BillingHelper;
+    private stripeClient?;
+    constructor(config?: VibezCheckConfig);
+    /**
+     * 1-Line Zero-Latency Stream Wrapper for OpenAI, Anthropic, Gemini, etc.
+     */
+    wrapStream<T>(stream: T, options?: StreamWrapOptions): T;
+    /**
+     * Track token usage from a non-streaming response object
+     */
+    track(response: any, options?: {
+        customer?: CustomerParam;
+        model?: string;
+    }): UsageEvent | null;
+    /**
+     * 1-Line Wrapper for Vercel AI SDK LanguageModel
+     */
+    withBilling<T extends object>(model: T, options?: {
+        customer?: CustomerParam;
+    }): T;
+    /**
+     * 1-Line Universal Stream Responder for API Routes (Next.js, Express, Hono)
+     */
+    stream(params: {
+        model: string;
+        messages: Array<{
+            role: string;
+            content: string;
+        }>;
+        customer?: CustomerParam;
+        temperature?: number;
+    }): Promise<Response>;
+    /**
+     * Flush pending meter events (vital for serverless runtimes)
+     */
+    flush(): Promise<void>;
+    /**
+     * In-memory usage statistics
+     */
+    getUsageSummary(): UsageSummary;
+}
+/**
+ * Factory to create VibezCheck client
+ */
+declare function createVibezCheck(config?: VibezCheckConfig): VibezCheckClient;
+/**
+ * vibezcheck factory alias
+ */
+declare const vibezcheck: typeof createVibezCheck;
+/**
+ * vibescheck alias (tolerates spelling difference)
+ */
+declare const vibescheck: typeof createVibezCheck;
+/**
+ * Singleton instance initialized with process.env
+ */
+declare const vibez: VibezCheckClient;
+/**
+ * Singleton alias
+ */
+declare const vibes: VibezCheckClient;
+
+export { ApiKeyAuth, BillingHelper, CustomerManager, CustomerParam, MeterOptions, StreamWrapOptions, UsageEvent, UsageSummary, VibezCheckClient, type VibezCheckConfig, VibezMeter, createVibezCheck, vibes, vibescheck, vibez, vibezcheck };