@sudobility/consumables_service 0.0.2

package/CLAUDE.md

@@ -0,0 +1,92 @@
+# Consumables Service
+
+Shared backend library for consumable credits management with Drizzle ORM.
+
+**npm**: `@sudobility/consumables_service` (public)
+
+## Tech Stack
+
+- **Language**: TypeScript (strict mode)
+- **Runtime**: Bun
+- **Package Manager**: Bun (do not use npm/yarn/pnpm for installing dependencies)
+- **Build**: TypeScript compiler (ESM)
+- **Test**: vitest
+
+## Project Structure
+
+```
+src/
+├── index.ts                    # Main exports
+├── types/
+│   └── index.ts                # All type definitions
+├── schema/
+│   └── index.ts                # Drizzle schema creator
+└── helpers/
+    ├── index.ts                # Helper re-exports
+    ├── ConsumablesHelper.ts    # Core business logic
+    └── WebhookHelper.ts       # RevenueCat webhook validation
+tests/
+├── ConsumablesHelper.test.ts
+└── WebhookHelper.test.ts
+```
+
+## Commands
+
+```bash
+bun run build        # Build ESM
+bun run clean        # Remove dist/
+bun run dev          # Watch mode
+bun test             # Run tests
+bun run lint         # Run ESLint
+bun run typecheck    # TypeScript check
+bun run verify       # All checks + build (use before commit)
+```
+
+## Key Concepts
+
+### Schema Creator
+
+`createConsumablesSchema(pgSchema)` creates three tables within a given Drizzle PgSchema:
+- `consumable_balances` — user balance with stored credit count
+- `consumable_purchases` — purchase audit trail (source, transaction ref, price)
+- `consumable_usages` — usage audit trail (filename, timestamp)
+
+The consuming API passes its own schema so migrations stay in one place.
+
+### ConsumablesHelper
+
+Core business logic class. Constructed with `(db, tables, config)`:
+- `getBalance(userId)` — get-or-create; auto-grants free credits on first access
+- `recordPurchase(userId, request)` — insert purchase + atomic balance increment
+- `recordUsage(userId, filename?)` — atomic decrement with balance > 0 guard
+- `getPurchaseHistory/getUsageHistory` — paginated audit trail queries
+- `recordPurchaseFromWebhook(...)` — idempotent webhook processing
+
+### WebhookHelper
+
+- `validateWebhookSignature(rawBody, signature, secret)` — HMAC-SHA256 validation
+- `parseConsumablePurchaseEvent(event)` — extract purchase data from RevenueCat webhook
+
+## Usage
+
+```typescript
+import {
+  createConsumablesSchema,
+  ConsumablesHelper,
+} from "@sudobility/consumables_service";
+
+// In your API's schema file:
+const tables = createConsumablesSchema(mySchema);
+
+// In your API's service file:
+const helper = new ConsumablesHelper(db, tables, { initialFreeCredits: 3 });
+
+const balance = await helper.getBalance(userId);
+const updated = await helper.recordPurchase(userId, { credits: 25, source: "web", ... });
+const result = await helper.recordUsage(userId, "logo.svg");
+```
+
+## Consuming APIs
+
+APIs using this library:
+- svgr_api

package/dist/helpers/ConsumablesHelper.d.ts

@@ -0,0 +1,27 @@
+import type { ConsumablesSchemaResult } from "../schema";
+import type { BalanceResponse, PurchaseRequest, UseResponse, ConsumablePurchase, ConsumableUsage, ConsumablesConfig, ConsumableSource } from "../types";
+export declare class ConsumablesHelper {
+    private db;
+    private tables;
+    private config;
+    constructor(db: any, tables: ConsumablesSchemaResult, config: ConsumablesConfig);
+    /** Get or create balance record. Auto-grants free credits on first access. */
+    getBalance(userId: string): Promise<BalanceResponse>;
+    /** Record a purchase. Atomically adds credits to balance. */
+    recordPurchase(userId: string, request: PurchaseRequest): Promise<BalanceResponse>;
+    /** Record a usage. Atomically deducts 1 credit. Returns error if insufficient. */
+    recordUsage(userId: string, filename?: string): Promise<UseResponse>;
+    /** Get purchase history (most recent first). */
+    getPurchaseHistory(userId: string, limit?: number, offset?: number): Promise<ConsumablePurchase[]>;
+    /** Get usage history (most recent first). */
+    getUsageHistory(userId: string, limit?: number, offset?: number): Promise<ConsumableUsage[]>;
+    /**
+     * Idempotent purchase recording from webhook.
+     * Checks if transaction_ref_id already exists to prevent duplicates.
+     */
+    recordPurchaseFromWebhook(userId: string, transactionId: string, credits: number, source: ConsumableSource, productId: string, priceCents: number, currency: string): Promise<{
+        alreadyProcessed: boolean;
+        balance: number;
+    }>;
+}
+//# sourceMappingURL=ConsumablesHelper.d.ts.map

package/dist/helpers/ConsumablesHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsumablesHelper.d.ts","sourceRoot":"","sources":["../../src/helpers/ConsumablesHelper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAAM;IAChB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,MAAM,CAAoB;gBAGhC,EAAE,EAAE,GAAG,EACP,MAAM,EAAE,uBAAuB,EAC/B,MAAM,EAAE,iBAAiB;IAO3B,8EAA8E;IACxE,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAkC1D,6DAA6D;IACvD,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,eAAe,CAAC;IAsC3B,kFAAkF;IAC5E,WAAW,CACf,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC;IA8BvB,gDAAgD;IAC1C,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,KAAK,SAAK,EACV,MAAM,SAAI,GACT,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAWhC,6CAA6C;IACvC,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,KAAK,SAAK,EACV,MAAM,SAAI,GACT,OAAO,CAAC,eAAe,EAAE,CAAC;IAW7B;;;OAGG;IACG,yBAAyB,CAC7B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,gBAAgB,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAyB3D"}

package/dist/helpers/ConsumablesHelper.js

@@ -0,0 +1,142 @@
+import { eq, desc, sql } from "drizzle-orm";
+export class ConsumablesHelper {
+    constructor(db, tables, config) {
+        this.db = db;
+        this.tables = tables;
+        this.config = config;
+    }
+    /** Get or create balance record. Auto-grants free credits on first access. */
+    async getBalance(userId) {
+        const { consumableBalances } = this.tables;
+        const existing = await this.db
+            .select()
+            .from(consumableBalances)
+            .where(eq(consumableBalances.user_id, userId));
+        if (existing.length > 0) {
+            return {
+                balance: existing[0].balance,
+                initial_credits: existing[0].initial_credits,
+            };
+        }
+        // First access — create with free credits
+        const freeCredits = this.config.initialFreeCredits;
+        await this.db.insert(consumableBalances).values({
+            user_id: userId,
+            balance: freeCredits,
+            initial_credits: freeCredits,
+        });
+        // Record the free credits as a purchase audit entry
+        if (freeCredits > 0) {
+            await this.db.insert(this.tables.consumablePurchases).values({
+                user_id: userId,
+                credits: freeCredits,
+                source: "free",
+            });
+        }
+        return { balance: freeCredits, initial_credits: freeCredits };
+    }
+    /** Record a purchase. Atomically adds credits to balance. */
+    async recordPurchase(userId, request) {
+        const { consumableBalances, consumablePurchases } = this.tables;
+        // Ensure balance record exists (idempotent)
+        await this.getBalance(userId);
+        // Insert purchase record
+        await this.db.insert(consumablePurchases).values({
+            user_id: userId,
+            credits: request.credits,
+            source: request.source,
+            transaction_ref_id: request.transaction_ref_id ?? null,
+            product_id: request.product_id ?? null,
+            price_cents: request.price_cents ?? null,
+            currency: request.currency ?? null,
+        });
+        // Atomically increment balance
+        await this.db
+            .update(consumableBalances)
+            .set({
+            balance: sql `${consumableBalances.balance} + ${request.credits}`,
+            updated_at: new Date(),
+        })
+            .where(eq(consumableBalances.user_id, userId));
+        // Return updated balance
+        const updated = await this.db
+            .select()
+            .from(consumableBalances)
+            .where(eq(consumableBalances.user_id, userId));
+        return {
+            balance: updated[0].balance,
+            initial_credits: updated[0].initial_credits,
+        };
+    }
+    /** Record a usage. Atomically deducts 1 credit. Returns error if insufficient. */
+    async recordUsage(userId, filename) {
+        const { consumableBalances, consumableUsages } = this.tables;
+        // Atomically decrement (with guard against going negative)
+        const result = await this.db
+            .update(consumableBalances)
+            .set({
+            balance: sql `${consumableBalances.balance} - 1`,
+            updated_at: new Date(),
+        })
+            .where(sql `${consumableBalances.user_id} = ${userId} AND ${consumableBalances.balance} > 0`)
+            .returning({ balance: consumableBalances.balance });
+        if (result.length === 0) {
+            // Either user doesn't exist or balance is 0
+            const current = await this.getBalance(userId);
+            return { balance: current.balance, success: false };
+        }
+        // Record usage
+        await this.db.insert(consumableUsages).values({
+            user_id: userId,
+            filename: filename ?? null,
+        });
+        return { balance: result[0].balance, success: true };
+    }
+    /** Get purchase history (most recent first). */
+    async getPurchaseHistory(userId, limit = 50, offset = 0) {
+        const { consumablePurchases } = this.tables;
+        return this.db
+            .select()
+            .from(consumablePurchases)
+            .where(eq(consumablePurchases.user_id, userId))
+            .orderBy(desc(consumablePurchases.created_at))
+            .limit(limit)
+            .offset(offset);
+    }
+    /** Get usage history (most recent first). */
+    async getUsageHistory(userId, limit = 50, offset = 0) {
+        const { consumableUsages } = this.tables;
+        return this.db
+            .select()
+            .from(consumableUsages)
+            .where(eq(consumableUsages.user_id, userId))
+            .orderBy(desc(consumableUsages.created_at))
+            .limit(limit)
+            .offset(offset);
+    }
+    /**
+     * Idempotent purchase recording from webhook.
+     * Checks if transaction_ref_id already exists to prevent duplicates.
+     */
+    async recordPurchaseFromWebhook(userId, transactionId, credits, source, productId, priceCents, currency) {
+        // Check for duplicate
+        const existing = await this.db
+            .select()
+            .from(this.tables.consumablePurchases)
+            .where(eq(this.tables.consumablePurchases.transaction_ref_id, transactionId));
+        if (existing.length > 0) {
+            const bal = await this.getBalance(userId);
+            return { alreadyProcessed: true, balance: bal.balance };
+        }
+        const result = await this.recordPurchase(userId, {
+            credits,
+            source,
+            transaction_ref_id: transactionId,
+            product_id: productId,
+            price_cents: priceCents,
+            currency,
+        });
+        return { alreadyProcessed: false, balance: result.balance };
+    }
+}
+//# sourceMappingURL=ConsumablesHelper.js.map

package/dist/helpers/ConsumablesHelper.js.map

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

package/dist/helpers/WebhookHelper.d.ts

@@ -0,0 +1,18 @@
+import type { RevenueCatWebhookEvent } from "../types";
+/**
+ * Validates RevenueCat webhook HMAC signature.
+ */
+export declare function validateWebhookSignature(rawBody: string, signature: string, secret: string): boolean;
+/**
+ * Parse the webhook event and extract purchase data.
+ * Returns null if the event type is not a consumable purchase.
+ */
+export declare function parseConsumablePurchaseEvent(event: RevenueCatWebhookEvent): {
+    userId: string;
+    transactionId: string;
+    productId: string;
+    priceCents: number;
+    currency: string;
+    store: string;
+} | null;
+//# sourceMappingURL=WebhookHelper.d.ts.map

package/dist/helpers/WebhookHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookHelper.d.ts","sourceRoot":"","sources":["../../src/helpers/WebhookHelper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEvD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAKT;AAQD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,sBAAsB,GAC5B;IACD,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,IAAI,CAeP"}

package/dist/helpers/WebhookHelper.js

@@ -0,0 +1,34 @@
+import { createHmac } from "crypto";
+/**
+ * Validates RevenueCat webhook HMAC signature.
+ */
+export function validateWebhookSignature(rawBody, signature, secret) {
+    const hmac = createHmac("sha256", secret);
+    hmac.update(rawBody);
+    const expected = hmac.digest("hex");
+    return signature === expected;
+}
+const STORE_TO_SOURCE = {
+    STRIPE: "web",
+    APP_STORE: "apple",
+    PLAY_STORE: "google",
+};
+/**
+ * Parse the webhook event and extract purchase data.
+ * Returns null if the event type is not a consumable purchase.
+ */
+export function parseConsumablePurchaseEvent(event) {
+    const validTypes = ["NON_RENEWING_PURCHASE", "INITIAL_PURCHASE"];
+    if (!validTypes.includes(event.event.type)) {
+        return null;
+    }
+    return {
+        userId: event.event.app_user_id,
+        transactionId: event.event.transaction_id,
+        productId: event.event.product_id,
+        priceCents: Math.round(event.event.price_in_purchased_currency * 100),
+        currency: event.event.currency,
+        store: STORE_TO_SOURCE[event.event.store] ?? event.event.store,
+    };
+}
+//# sourceMappingURL=WebhookHelper.js.map

package/dist/helpers/WebhookHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookHelper.js","sourceRoot":"","sources":["../../src/helpers/WebhookHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGpC;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAe,EACf,SAAiB,EACjB,MAAc;IAEd,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,SAAS,KAAK,QAAQ,CAAC;AAChC,CAAC;AAED,MAAM,eAAe,GAA2B;IAC9C,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,OAAO;IAClB,UAAU,EAAE,QAAQ;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC1C,KAA6B;IAS7B,MAAM,UAAU,GAAG,CAAC,uBAAuB,EAAE,kBAAkB,CAAC,CAAC;IAEjE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW;QAC/B,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,cAAc;QACzC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU;QACjC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,2BAA2B,GAAG,GAAG,CAAC;QACrE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ;QAC9B,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK;KAC/D,CAAC;AACJ,CAAC"}

package/dist/helpers/index.d.ts

@@ -0,0 +1,3 @@
+export { ConsumablesHelper } from "./ConsumablesHelper";
+export { validateWebhookSignature, parseConsumablePurchaseEvent, } from "./WebhookHelper";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC"}

package/dist/helpers/index.js

@@ -0,0 +1,3 @@
+export { ConsumablesHelper } from "./ConsumablesHelper";
+export { validateWebhookSignature, parseConsumablePurchaseEvent, } from "./WebhookHelper";
+//# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { ConsumableSource, ConsumableBalanceResponse, ConsumablePurchaseRequest, ConsumableUseRequest, ConsumableUseResponse, ConsumablePurchaseRecord, ConsumableUsageRecord, BalanceResponse, PurchaseRequest, UseRequest, UseResponse, } from "./types";
+export type { ConsumableBalance, ConsumablePurchase, ConsumableUsage, RevenueCatWebhookEvent, ConsumablesConfig, } from "./types";
+export { createConsumablesSchema, type ConsumablesSchemaResult, } from "./schema";
+export { ConsumablesHelper, validateWebhookSignature, parseConsumablePurchaseEvent, } from "./helpers";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,gBAAgB,EAChB,yBAAyB,EACzB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EAErB,eAAe,EACf,eAAe,EACf,UAAU,EACV,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,uBAAuB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// Schema
+export { createConsumablesSchema, } from "./schema";
+// Helpers
+export { ConsumablesHelper, validateWebhookSignature, parseConsumablePurchaseEvent, } from "./helpers";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyBA,SAAS;AACT,OAAO,EACL,uBAAuB,GAExB,MAAM,UAAU,CAAC;AAElB,UAAU;AACV,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,WAAW,CAAC"}

package/dist/schema/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Create consumable tables within a given Drizzle PgSchema.
+ * The consuming API passes its own schema so migrations stay in one place.
+ *
+ * Uses `any` for schema param to avoid drizzle-orm version coupling
+ * between this library and the consuming API.
+ */
+export declare function createConsumablesSchema(schema: any): {
+    consumableBalances: any;
+    consumablePurchases: any;
+    consumableUsages: any;
+};
+export type ConsumablesSchemaResult = ReturnType<typeof createConsumablesSchema>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,GAAG;;;;EA6BlD;AAED,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/schema/index.js

@@ -0,0 +1,36 @@
+import { varchar, timestamp, serial, integer, } from "drizzle-orm/pg-core";
+/**
+ * Create consumable tables within a given Drizzle PgSchema.
+ * The consuming API passes its own schema so migrations stay in one place.
+ *
+ * Uses `any` for schema param to avoid drizzle-orm version coupling
+ * between this library and the consuming API.
+ */
+export function createConsumablesSchema(schema) {
+    const consumableBalances = schema.table("consumable_balances", {
+        user_id: varchar("user_id", { length: 128 }).primaryKey(),
+        balance: integer("balance").notNull().default(0),
+        initial_credits: integer("initial_credits").notNull().default(0),
+        created_at: timestamp("created_at").defaultNow().notNull(),
+        updated_at: timestamp("updated_at").defaultNow().notNull(),
+    });
+    const consumablePurchases = schema.table("consumable_purchases", {
+        id: serial("id").primaryKey(),
+        user_id: varchar("user_id", { length: 128 }).notNull(),
+        credits: integer("credits").notNull(),
+        source: varchar("source", { length: 20 }).notNull(),
+        transaction_ref_id: varchar("transaction_ref_id", { length: 255 }),
+        product_id: varchar("product_id", { length: 255 }),
+        price_cents: integer("price_cents"),
+        currency: varchar("currency", { length: 10 }),
+        created_at: timestamp("created_at").defaultNow().notNull(),
+    });
+    const consumableUsages = schema.table("consumable_usages", {
+        id: serial("id").primaryKey(),
+        user_id: varchar("user_id", { length: 128 }).notNull(),
+        filename: varchar("filename", { length: 500 }),
+        created_at: timestamp("created_at").defaultNow().notNull(),
+    });
+    return { consumableBalances, consumablePurchases, consumableUsages };
+}
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,SAAS,EACT,MAAM,EACN,OAAO,GACR,MAAM,qBAAqB,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAW;IACjD,MAAM,kBAAkB,GAAG,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE;QAC7D,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE;QACzD,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAChD,eAAe,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAChE,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE;QAC1D,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE;KAC3D,CAAC,CAAC;IAEH,MAAM,mBAAmB,GAAG,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE;QAC/D,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;QAC7B,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE;QACtD,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;QACrC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;QACnD,kBAAkB,EAAE,OAAO,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAClE,UAAU,EAAE,OAAO,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAClD,WAAW,EAAE,OAAO,CAAC,aAAa,CAAC;QACnC,QAAQ,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAC7C,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE;KAC3D,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE;QACzD,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;QAC7B,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE;QACtD,QAAQ,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAC9C,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE;KAC3D,CAAC,CAAC;IAEH,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,CAAC;AACvE,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,44 @@
+export type { ConsumableSource, ConsumableBalanceResponse, ConsumablePurchaseRequest, ConsumableUseRequest, ConsumableUseResponse, ConsumablePurchaseRecord, ConsumableUsageRecord, } from "@sudobility/types";
+export type { ConsumableBalanceResponse as BalanceResponse, ConsumablePurchaseRequest as PurchaseRequest, ConsumableUseRequest as UseRequest, ConsumableUseResponse as UseResponse, } from "@sudobility/types";
+export interface ConsumableBalance {
+    user_id: string;
+    balance: number;
+    initial_credits: number;
+    created_at: Date;
+    updated_at: Date;
+}
+export interface ConsumablePurchase {
+    id: number;
+    user_id: string;
+    credits: number;
+    source: string;
+    transaction_ref_id: string | null;
+    product_id: string | null;
+    price_cents: number | null;
+    currency: string | null;
+    created_at: Date;
+}
+export interface ConsumableUsage {
+    id: number;
+    user_id: string;
+    filename: string | null;
+    created_at: Date;
+}
+export interface RevenueCatWebhookEvent {
+    api_version: string;
+    event: {
+        type: string;
+        app_user_id: string;
+        product_id: string;
+        price_in_purchased_currency: number;
+        currency: string;
+        store: string;
+        transaction_id: string;
+        purchased_at_ms: number;
+    };
+}
+export interface ConsumablesConfig {
+    initialFreeCredits: number;
+    revenueCatWebhookSecret?: string;
+}
+//# 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":"AACA,YAAY,EACV,gBAAgB,EAChB,yBAAyB,EACzB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,yBAAyB,IAAI,eAAe,EAC5C,yBAAyB,IAAI,eAAe,EAC5C,oBAAoB,IAAI,UAAU,EAClC,qBAAqB,IAAI,WAAW,GACrC,MAAM,mBAAmB,CAAC;AAI3B,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,IAAI,CAAC;CAClB;AAID,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,2BAA2B,EAAE,MAAM,CAAC;QACpC,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAID,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# 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":""}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@sudobility/consumables_service",
+  "version": "0.0.2",
+  "description": "Shared backend library for consumable credits management with Drizzle ORM",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.esm.json",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "verify": "bun run typecheck && bun run lint && bun run test && bun run build",
+    "prepublishOnly": "bun run clean && bun run verify"
+  },
+  "files": [
+    "dist/**/*",
+    "CLAUDE.md"
+  ],
+  "keywords": [
+    "consumables",
+    "credits",
+    "revenuecat",
+    "in-app-purchase",
+    "drizzle"
+  ],
+  "author": "Sudobility",
+  "license": "BUSL-1.1",
+  "peerDependencies": {
+    "@sudobility/types": "^1.9.51",
+    "drizzle-orm": ">=0.44.0"
+  },
+  "devDependencies": {
+    "@sudobility/types": "^1.9.51",
+    "drizzle-orm": "^0.45.1",
+    "vitest": "^4.0.4",
+    "@types/bun": "latest",
+    "@types/node": "^24.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.50.0",
+    "@typescript-eslint/parser": "^8.50.0",
+    "eslint": "^9.39.0",
+    "eslint-plugin-import": "^2.32.0",
+    "prettier": "^3.7.0",
+    "typescript": "^5.9.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}