@venturekit-pro/billing 0.0.0-dev.20260323005827

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Billing Types
+ */
+export * from './subscription.js';
+export * from './payment.js';
+export * from './invoice.js';
+export * from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * Billing Types
+ */
+export * from './subscription.js';
+export * from './payment.js';
+export * from './invoice.js';
+export * from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/types/invoice.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Invoice Types
+ */
+/**
+ * Invoice status
+ */
+export type InvoiceStatus = 'draft' | 'open' | 'paid' | 'void' | 'uncollectible';
+/**
+ * Invoice line item
+ */
+export interface InvoiceLineItem {
+    /** Line item ID */
+    id: string;
+    /** Description */
+    description: string;
+    /** Quantity */
+    quantity: number;
+    /** Unit price in smallest currency unit */
+    unitPrice: number;
+    /** Total amount */
+    amount: number;
+    /** Tax rate (percentage) */
+    taxRate?: number;
+    /** Tax amount */
+    taxAmount?: number;
+}
+/**
+ * Invoice
+ */
+export interface Invoice {
+    /** Invoice ID */
+    id: string;
+    /** Invoice number */
+    number: string;
+    /** Customer ID */
+    customerId: string;
+    /** Subscription ID (if subscription invoice) */
+    subscriptionId?: string;
+    /** Status */
+    status: InvoiceStatus;
+    /** Currency code */
+    currency: string;
+    /** Subtotal (before tax) */
+    subtotal: number;
+    /** Tax amount */
+    tax: number;
+    /** Total amount */
+    total: number;
+    /** Amount paid */
+    amountPaid: number;
+    /** Amount due */
+    amountDue: number;
+    /** Line items */
+    lineItems: InvoiceLineItem[];
+    /** Due date */
+    dueDate?: Date;
+    /** Paid at timestamp */
+    paidAt?: Date;
+    /** Invoice PDF URL */
+    pdfUrl?: string;
+    /** Created timestamp */
+    createdAt: Date;
+    /** Updated timestamp */
+    updatedAt: Date;
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Input for creating an invoice
+ */
+export interface CreateInvoiceInput {
+    customerId: string;
+    currency: string;
+    lineItems: Omit<InvoiceLineItem, 'id'>[];
+    dueDate?: Date;
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=invoice.d.ts.map

package/dist/types/invoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice.d.ts","sourceRoot":"","sources":["../../src/types/invoice.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,MAAM,GACN,MAAM,GACN,MAAM,GACN,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IAEX,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IAEpB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC;IAEjB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAElB,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IAEf,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IAEX,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IAEf,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IAEnB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,aAAa;IACb,MAAM,EAAE,aAAa,CAAC;IAEtB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IAEjB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IAEjB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IAEZ,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IAEd,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IAEnB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAElB,iBAAiB;IACjB,SAAS,EAAE,eAAe,EAAE,CAAC;IAE7B,eAAe;IACf,OAAO,CAAC,EAAE,IAAI,CAAC;IAEf,wBAAwB;IACxB,MAAM,CAAC,EAAE,IAAI,CAAC;IAEd,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,SAAS,EAAE,IAAI,CAAC;IAEhB,wBAAwB;IACxB,SAAS,EAAE,IAAI,CAAC;IAEhB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,EAAE,CAAC;IACzC,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/types/invoice.js

@@ -0,0 +1,5 @@
+/**
+ * Invoice Types
+ */
+export {};
+//# sourceMappingURL=invoice.js.map

package/dist/types/invoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice.js","sourceRoot":"","sources":["../../src/types/invoice.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/payment.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Payment-related types used by the invoicing system.
+ *
+ * This package does NOT implement payment processing.
+ * Integrate any payment provider separately.
+ */
+/**
+ * Payment status (tracked on invoices)
+ */
+export type PaymentStatus = 'pending' | 'succeeded' | 'failed';
+/**
+ * A payment record linked to an invoice.
+ * Created by external payment providers and stored for auditing.
+ */
+export interface PaymentRecord {
+    /** Payment ID (from your provider or internal) */
+    id: string;
+    /** Invoice ID this payment applies to */
+    invoiceId: string;
+    /** Amount in smallest currency unit */
+    amount: number;
+    /** Currency code (ISO 4217) */
+    currency: string;
+    /** Status */
+    status: PaymentStatus;
+    /** External reference from your payment provider */
+    externalRef?: string;
+    /** Created timestamp */
+    createdAt: Date;
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=payment.d.ts.map

package/dist/types/payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../src/types/payment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,WAAW,GACX,QAAQ,CAAC;AAEb;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IAEX,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAElB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IAEf,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IAEjB,aAAa;IACb,MAAM,EAAE,aAAa,CAAC;IAEtB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,wBAAwB;IACxB,SAAS,EAAE,IAAI,CAAC;IAEhB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/types/payment.js

@@ -0,0 +1,8 @@
+/**
+ * Payment-related types used by the invoicing system.
+ *
+ * This package does NOT implement payment processing.
+ * Integrate any payment provider separately.
+ */
+export {};
+//# sourceMappingURL=payment.js.map

package/dist/types/payment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../src/types/payment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/subscription.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Subscription Types
+ */
+/**
+ * Subscription status
+ */
+export type SubscriptionStatus = 'active' | 'canceled' | 'past_due' | 'unpaid' | 'trialing' | 'paused';
+/**
+ * Billing interval
+ */
+export type BillingInterval = 'month' | 'year' | 'week' | 'day';
+/**
+ * Subscription plan
+ */
+export interface SubscriptionPlan {
+    /** Plan ID */
+    id: string;
+    /** Plan name */
+    name: string;
+    /** Plan description */
+    description?: string;
+    /** Price in smallest currency unit (cents) */
+    price: number;
+    /** Currency code (ISO 4217) */
+    currency: string;
+    /** Billing interval */
+    interval: BillingInterval;
+    /** Interval count (e.g., 3 for quarterly) */
+    intervalCount?: number;
+    /** Trial period in days */
+    trialDays?: number;
+    /** Features included */
+    features?: string[];
+    /** Is active/available */
+    active: boolean;
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Subscription
+ */
+export interface Subscription {
+    /** Subscription ID */
+    id: string;
+    /** Customer/tenant ID */
+    customerId: string;
+    /** Plan ID */
+    planId: string;
+    /** Status */
+    status: SubscriptionStatus;
+    /** Current period start */
+    currentPeriodStart: Date;
+    /** Current period end */
+    currentPeriodEnd: Date;
+    /** Cancel at period end */
+    cancelAtPeriodEnd: boolean;
+    /** Canceled at timestamp */
+    canceledAt?: Date;
+    /** Trial start */
+    trialStart?: Date;
+    /** Trial end */
+    trialEnd?: Date;
+    /** Created timestamp */
+    createdAt: Date;
+    /** Updated timestamp */
+    updatedAt: Date;
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Input for creating a subscription
+ */
+export interface CreateSubscriptionInput {
+    customerId: string;
+    planId: string;
+    trialDays?: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Input for updating a subscription
+ */
+export interface UpdateSubscriptionInput {
+    planId?: string;
+    cancelAtPeriodEnd?: boolean;
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=subscription.d.ts.map

package/dist/types/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/types/subscription.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,UAAU,GACV,UAAU,GACV,QAAQ,GACR,UAAU,GACV,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,cAAc;IACd,EAAE,EAAE,MAAM,CAAC;IAEX,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IAEb,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IAEd,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IAEjB,uBAAuB;IACvB,QAAQ,EAAE,eAAe,CAAC;IAE1B,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,0BAA0B;IAC1B,MAAM,EAAE,OAAO,CAAC;IAEhB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IAEX,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IAEnB,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IAEf,aAAa;IACb,MAAM,EAAE,kBAAkB,CAAC;IAE3B,2BAA2B;IAC3B,kBAAkB,EAAE,IAAI,CAAC;IAEzB,yBAAyB;IACzB,gBAAgB,EAAE,IAAI,CAAC;IAEvB,2BAA2B;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAE3B,4BAA4B;IAC5B,UAAU,CAAC,EAAE,IAAI,CAAC;IAElB,kBAAkB;IAClB,UAAU,CAAC,EAAE,IAAI,CAAC;IAElB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAEhB,wBAAwB;IACxB,SAAS,EAAE,IAAI,CAAC;IAEhB,wBAAwB;IACxB,SAAS,EAAE,IAAI,CAAC;IAEhB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/types/subscription.js

@@ -0,0 +1,5 @@
+/**
+ * Subscription Types
+ */
+export {};
+//# sourceMappingURL=subscription.js.map

package/dist/types/subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../../src/types/subscription.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/usage/tracker.d.ts

@@ -0,0 +1,75 @@
+/**
+ * VentureKit Usage Tracker
+ *
+ * Tracks metered usage for billing purposes — API calls, storage,
+ * seats, or any custom metric. Provides aggregation for invoice generation.
+ */
+/**
+ * Usage record
+ */
+export interface UsageRecord {
+    /** Customer/tenant ID */
+    customerId: string;
+    /** Feature key (e.g., 'api_calls', 'storage_gb', 'seats') */
+    featureKey: string;
+    /** Usage amount */
+    quantity: number;
+    /** Timestamp */
+    timestamp: number;
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Aggregated usage for a period
+ */
+export interface UsageSummary {
+    customerId: string;
+    featureKey: string;
+    /** Total usage in the period */
+    total: number;
+    /** Number of records in the period */
+    count: number;
+    /** Period start */
+    periodStart: number;
+    /** Period end */
+    periodEnd: number;
+}
+/**
+ * Usage store interface
+ */
+export interface UsageStore {
+    record(entry: UsageRecord): Promise<void>;
+    query(customerId: string, featureKey: string, from: number, to: number): Promise<UsageRecord[]>;
+    aggregate(customerId: string, from: number, to: number): Promise<UsageSummary[]>;
+}
+/**
+ * Create a usage tracker
+ */
+export declare function createUsageTracker(store: UsageStore): {
+    /**
+     * Record a usage event
+     */
+    record(customerId: string, featureKey: string, quantity?: number, metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * Increment usage (alias for record with quantity=1)
+     */
+    increment(customerId: string, featureKey: string): Promise<void>;
+    /**
+     * Set absolute usage (e.g., current seat count)
+     */
+    set(customerId: string, featureKey: string, quantity: number): Promise<void>;
+    /**
+     * Get usage for a specific feature in a time range
+     */
+    getUsage(customerId: string, featureKey: string, from: number, to: number): Promise<UsageRecord[]>;
+    /**
+     * Get aggregated usage for all features in a period
+     * Returns a map of featureKey → total usage
+     */
+    getSummary(customerId: string, from: number, to: number): Promise<Record<string, number>>;
+};
+/**
+ * In-memory usage store (for dev/testing)
+ */
+export declare function createMemoryUsageStore(): UsageStore;
+//# sourceMappingURL=tracker.d.ts.map

package/dist/usage/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/usage/tracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAChG,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAClF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU;IAEhD;;OAEG;uBAEW,MAAM,cACN,MAAM,aACR,MAAM,aACL,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IAUhB;;OAEG;0BACyB,MAAM,cAAc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE;;OAEG;oBAEW,MAAM,cACN,MAAM,YACR,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAIhB;;OAEG;yBAEW,MAAM,cACN,MAAM,QACZ,MAAM,MACR,MAAM,GACT,OAAO,CAAC,WAAW,EAAE,CAAC;IAIzB;;;OAGG;2BAEW,MAAM,QACZ,MAAM,MACR,MAAM,GACT,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;EASrC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,UAAU,CAyCnD"}

package/dist/usage/tracker.js

@@ -0,0 +1,91 @@
+/**
+ * VentureKit Usage Tracker
+ *
+ * Tracks metered usage for billing purposes — API calls, storage,
+ * seats, or any custom metric. Provides aggregation for invoice generation.
+ */
+/**
+ * Create a usage tracker
+ */
+export function createUsageTracker(store) {
+    return {
+        /**
+         * Record a usage event
+         */
+        async record(customerId, featureKey, quantity = 1, metadata) {
+            await store.record({
+                customerId,
+                featureKey,
+                quantity,
+                timestamp: Date.now(),
+                metadata,
+            });
+        },
+        /**
+         * Increment usage (alias for record with quantity=1)
+         */
+        async increment(customerId, featureKey) {
+            return this.record(customerId, featureKey, 1);
+        },
+        /**
+         * Set absolute usage (e.g., current seat count)
+         */
+        async set(customerId, featureKey, quantity) {
+            return this.record(customerId, featureKey, quantity, { type: 'absolute' });
+        },
+        /**
+         * Get usage for a specific feature in a time range
+         */
+        async getUsage(customerId, featureKey, from, to) {
+            return store.query(customerId, featureKey, from, to);
+        },
+        /**
+         * Get aggregated usage for all features in a period
+         * Returns a map of featureKey → total usage
+         */
+        async getSummary(customerId, from, to) {
+            const summaries = await store.aggregate(customerId, from, to);
+            const result = {};
+            for (const s of summaries) {
+                result[s.featureKey] = s.total;
+            }
+            return result;
+        },
+    };
+}
+/**
+ * In-memory usage store (for dev/testing)
+ */
+export function createMemoryUsageStore() {
+    const records = [];
+    return {
+        async record(entry) {
+            records.push({ ...entry });
+        },
+        async query(customerId, featureKey, from, to) {
+            return records.filter(r => r.customerId === customerId &&
+                r.featureKey === featureKey &&
+                r.timestamp >= from &&
+                r.timestamp <= to);
+        },
+        async aggregate(customerId, from, to) {
+            const filtered = records.filter(r => r.customerId === customerId && r.timestamp >= from && r.timestamp <= to);
+            const byFeature = new Map();
+            for (const r of filtered) {
+                const existing = byFeature.get(r.featureKey) ?? { total: 0, count: 0 };
+                existing.total += r.quantity;
+                existing.count++;
+                byFeature.set(r.featureKey, existing);
+            }
+            return Array.from(byFeature.entries()).map(([featureKey, data]) => ({
+                customerId,
+                featureKey,
+                total: data.total,
+                count: data.count,
+                periodStart: from,
+                periodEnd: to,
+            }));
+        },
+    };
+}
+//# sourceMappingURL=tracker.js.map

package/dist/usage/tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.js","sourceRoot":"","sources":["../../src/usage/tracker.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@venturekit-pro/billing",
+  "version": "0.0.0-dev.20260323005827",
+  "description": "Invoicing, plans, usage tracking, and feature gating for VentureKit",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/venturekit-dev/venturekit-pro.git",
+    "directory": "packages/billing"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "restricted"
+  },
+  "license": "Apache-2.0",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@venturekit/core": "0.0.0-dev.20260312012510"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  }
+}