usage-sdk-test 0.1.0 → 0.1.1

package/dist/sdk/UsageSdk.d.ts

@@ -0,0 +1,40 @@
+import type { LedgerStore } from "../stores/LedgerStore";
+import type { LimitStore } from "../stores/LimitStore";
+import type { PlanStore } from "../stores/PlanStore";
+import type { UsageStore } from "../stores/UsageStore";
+import type { CheckResult, EnforceInput, EnforceResult, GrantResult, Money, Quote, QuoteInput } from "../types";
+export type UsageSdkDeps = {
+    planStore: PlanStore;
+    ledgerStore: LedgerStore;
+    limitStore: LimitStore;
+    usageStore: UsageStore;
+};
+export declare class UsageSdk {
+    private readonly deps;
+    constructor(deps: UsageSdkDeps);
+    quote(input: QuoteInput): Promise<Quote>;
+    getBalance(input: {
+        accountId: string;
+        currency: Money["currency"];
+    }): Promise<Money>;
+    consumeRpm(input: {
+        accountId: string;
+        rpm: number;
+        requestCount?: number;
+        nowMs?: number;
+    }): Promise<CheckResult>;
+    grant(input: {
+        accountId: string;
+        money: Money;
+        idempotencyKey: string;
+        nowMs?: number;
+        metadata?: Record<string, unknown>;
+    }): Promise<GrantResult>;
+    getUsageCostSum(input: {
+        accountId: string;
+        currency: Money["currency"];
+        fromMs?: number;
+        toMs?: number;
+    }): Promise<Money>;
+    enforce(input: EnforceInput): Promise<EnforceResult>;
+}

package/dist/sdk/UsageSdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsageSdk.d.ts","sourceRoot":"","sources":["../../src/sdk/UsageSdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMzF,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAEzC,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC;IAMxC,UAAU,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IAIrF,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;CAsF3D"}

package/dist/sdk/UsageSdk.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageSdk = void 0;
+const errors_1 = require("../errors");
+const quote_1 = require("../pricing/quote");
+const guards_1 = require("../utils/guards");
+const fingerprint_1 = require("../utils/fingerprint");
+class UsageSdk {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async quote(input) {
+        const plan = await this.deps.planStore.getPlan(input.planId);
+        if (!plan)
+            throw new errors_1.UsageError("INVALID_ARGUMENT", `unknown planId: ${input.planId}`);
+        return (0, quote_1.quoteWithPlan)(input, plan);
+    }
+    async getBalance(input) {
+        return this.deps.ledgerStore.getBalance(input);
+    }
+    async consumeRpm(input) {
+        try {
+            const nowMs = input.nowMs ?? Date.now();
+            const requestCount = input.requestCount ?? 1;
+            (0, guards_1.assertNonNegativeInteger)(nowMs, "nowMs");
+            (0, guards_1.assertNonNegativeInteger)(requestCount, "requestCount");
+            await this.deps.limitStore.consumeRpm({ accountId: input.accountId, rpm: input.rpm, requestCount, nowMs });
+            return { ok: true };
+        }
+        catch (err) {
+            return (0, errors_1.toCheckResultError)(err);
+        }
+    }
+    async grant(input) {
+        try {
+            if (!input.idempotencyKey)
+                throw new errors_1.UsageError("INVALID_ARGUMENT", "idempotencyKey is required");
+            const nowMs = input.nowMs ?? Date.now();
+            (0, guards_1.assertNonNegativeInteger)(nowMs, "nowMs");
+            const fingerprint = (0, fingerprint_1.makeFingerprint)({
+                op: "credit",
+                accountId: input.accountId,
+                idempotencyKey: input.idempotencyKey,
+                money: input.money,
+            });
+            const result = await this.deps.ledgerStore.credit({
+                accountId: input.accountId,
+                money: input.money,
+                idempotencyKey: input.idempotencyKey,
+                fingerprint,
+                metadata: input.metadata,
+                nowMs,
+            });
+            return { ok: true, txId: result.txId, balanceAfter: result.balanceAfter };
+        }
+        catch (err) {
+            return (0, errors_1.toGrantResultError)(err);
+        }
+    }
+    async getUsageCostSum(input) {
+        const records = await this.deps.usageStore.list({ accountId: input.accountId, fromMs: input.fromMs, toMs: input.toMs });
+        let sum = 0;
+        for (const r of records) {
+            if (r.cost.currency !== input.currency)
+                continue;
+            sum += Math.max(0, r.cost.amountMinor);
+        }
+        return { currency: input.currency, amountMinor: sum };
+    }
+    async enforce(input) {
+        try {
+            if (!input.idempotencyKey)
+                throw new errors_1.UsageError("INVALID_ARGUMENT", "idempotencyKey is required");
+            const nowMs = input.nowMs ?? Date.now();
+            (0, guards_1.assertNonNegativeInteger)(nowMs, "nowMs");
+            const quote = await this.quote(input);
+            const debitFingerprint = (0, fingerprint_1.makeFingerprint)({
+                op: "debit",
+                accountId: input.accountId,
+                planId: input.planId,
+                idempotencyKey: input.idempotencyKey,
+                total: quote.total,
+                events: quote.items.map((i) => ({ meter: i.event.meter, quantity: i.event.quantity, dimensions: i.event.dimensions ?? {} })),
+                limits: input.limits ?? null,
+            });
+            const debitResult = await this.deps.ledgerStore.debit({
+                accountId: input.accountId,
+                money: quote.total,
+                idempotencyKey: input.idempotencyKey,
+                fingerprint: debitFingerprint,
+                metadata: input.metadata,
+                nowMs,
+            });
+            try {
+                const requestCount = input.requestCount ?? 1;
+                (0, guards_1.assertNonNegativeInteger)(requestCount, "requestCount");
+                const limits = input.limits;
+                if (limits?.rpm !== undefined) {
+                    await this.deps.limitStore.consumeRpm({ accountId: input.accountId, rpm: limits.rpm, requestCount, nowMs });
+                }
+                if (limits?.dailyLimitMinor !== undefined) {
+                    await this.deps.limitStore.consumeDailyMinor({
+                        accountId: input.accountId,
+                        amountMinor: quote.total.amountMinor,
+                        limitMinor: limits.dailyLimitMinor,
+                        nowMs,
+                    });
+                }
+                if (limits?.monthlyLimitMinor !== undefined) {
+                    await this.deps.limitStore.consumeMonthlyMinor({
+                        accountId: input.accountId,
+                        amountMinor: quote.total.amountMinor,
+                        limitMinor: limits.monthlyLimitMinor,
+                        nowMs,
+                    });
+                }
+            }
+            catch (limitErr) {
+                const refundKey = `${input.idempotencyKey}::refund`;
+                const refundFingerprint = (0, fingerprint_1.makeFingerprint)({
+                    op: "refund",
+                    accountId: input.accountId,
+                    currency: quote.total.currency,
+                    amountMinor: quote.total.amountMinor,
+                    for: input.idempotencyKey,
+                });
+                await this.deps.ledgerStore.credit({
+                    accountId: input.accountId,
+                    money: quote.total,
+                    idempotencyKey: refundKey,
+                    fingerprint: refundFingerprint,
+                    metadata: { reason: "limits_failed", for: input.idempotencyKey },
+                    nowMs,
+                });
+                throw limitErr;
+            }
+            await this.deps.usageStore.append({
+                accountId: input.accountId,
+                planId: input.planId,
+                idempotencyKey: input.idempotencyKey,
+                txId: debitResult.txId,
+                cost: quote.total,
+                events: input.events,
+                tsMs: nowMs,
+                metadata: input.metadata,
+            });
+            return { ok: true, txId: debitResult.txId, cost: quote.total, balanceAfter: debitResult.balanceAfter };
+        }
+        catch (err) {
+            return (0, errors_1.toEnforceResultError)(err);
+        }
+    }
+}
+exports.UsageSdk = UsageSdk;
+//# sourceMappingURL=UsageSdk.js.map

package/dist/sdk/UsageSdk.js.map

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

package/dist/sdk/createUsageSdk.d.ts

@@ -0,0 +1,41 @@
+import type { Limits, Money, PricePlan } from "../types";
+import type { PersistenceProvider } from "../persistence/PersistenceProvider";
+export type CreateUsageSdkInput = {
+    plans: PricePlan[];
+    persistence: PersistenceProvider;
+    initialBalances?: Array<{
+        accountId: string;
+        money: Money;
+    }>;
+    /**
+     * Optional: default limits applied by callers (you can also pass per-call limits in enforce()).
+     */
+    defaultLimits?: Limits;
+};
+export declare const createUsageSdk: (input: CreateUsageSdkInput) => {
+    quote: (input: import("../types").QuoteInput) => Promise<import("../types").Quote>;
+    enforce: (enforceInput: Parameters<(input: import("../types").EnforceInput) => Promise<import("../types").EnforceResult>>[0]) => Promise<import("../types").EnforceResult>;
+    getBalance: (input: {
+        accountId: string;
+        currency: Money["currency"];
+    }) => Promise<Money>;
+    consumeRpm: (input: {
+        accountId: string;
+        rpm: number;
+        requestCount?: number;
+        nowMs?: number;
+    }) => Promise<import("../types").CheckResult>;
+    grant: (input: {
+        accountId: string;
+        money: Money;
+        idempotencyKey: string;
+        nowMs?: number;
+        metadata?: Record<string, unknown>;
+    }) => Promise<import("../types").GrantResult>;
+    getUsageCostSum: (input: {
+        accountId: string;
+        currency: Money["currency"];
+        fromMs?: number;
+        toMs?: number;
+    }) => Promise<Money>;
+};

package/dist/sdk/createUsageSdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUsageSdk.d.ts","sourceRoot":"","sources":["../../src/sdk/createUsageSdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAG3E,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IAC7D;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,OAAO,mBAAmB;;4BAUvB,UAAU,6FAAoB,CAAC,CAAC,CAAC;;;;;IAM/D;;OAEG;;;;;;;CAGN,CAAC"}

package/dist/sdk/createUsageSdk.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUsageSdk = void 0;
+const UsageSdk_1 = require("./UsageSdk");
+const createUsageSdk = (input) => {
+    const { planStore, ledgerStore, limitStore, usageStore } = input.persistence.create({
+        plans: input.plans,
+        initialBalances: input.initialBalances,
+    });
+    const sdk = new UsageSdk_1.UsageSdk({ planStore, ledgerStore, limitStore, usageStore });
+    return {
+        quote: sdk.quote.bind(sdk),
+        enforce: async (enforceInput) => sdk.enforce({
+            ...enforceInput,
+            limits: enforceInput.limits ?? input.defaultLimits,
+        }),
+        getBalance: sdk.getBalance.bind(sdk),
+        consumeRpm: sdk.consumeRpm.bind(sdk),
+        grant: sdk.grant.bind(sdk),
+        getUsageCostSum: sdk.getUsageCostSum.bind(sdk),
+    };
+};
+exports.createUsageSdk = createUsageSdk;
+//# sourceMappingURL=createUsageSdk.js.map

package/dist/sdk/createUsageSdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUsageSdk.js","sourceRoot":"","sources":["../../src/sdk/createUsageSdk.ts"],"names":[],"mappings":";;;AACA,yCAAsC;AAa/B,MAAM,cAAc,GAAG,CAAC,KAA0B,EAAE,EAAE;IAC3D,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC;QAClF,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,eAAe,EAAE,KAAK,CAAC,eAAe;KACvC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,IAAI,mBAAQ,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IAE7E,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QAC1B,OAAO,EAAE,KAAK,EAAE,YAA+C,EAAE,EAAE,CACjE,GAAG,CAAC,OAAO,CAAC;YACV,GAAG,YAAY;YACf,MAAM,EAAE,YAAY,CAAC,MAAM,IAAI,KAAK,CAAC,aAAa;SACnD,CAAC;QACJ,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;QACpC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;QACpC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QAC1B,eAAe,EAAE,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC;KAC/C,CAAC;AACJ,CAAC,CAAC;AApBW,QAAA,cAAc,kBAoBzB"}

package/dist/stores/LedgerStore.d.ts

@@ -0,0 +1,29 @@
+import type { Money } from "../types";
+export type LedgerDebitInput = {
+    accountId: string;
+    money: Money;
+    idempotencyKey: string;
+    fingerprint: string;
+    metadata?: Record<string, unknown>;
+    nowMs: number;
+};
+export type LedgerCreditInput = {
+    accountId: string;
+    money: Money;
+    idempotencyKey: string;
+    fingerprint: string;
+    metadata?: Record<string, unknown>;
+    nowMs: number;
+};
+export type LedgerApplyResult = {
+    txId: string;
+    balanceAfter: Money;
+};
+export interface LedgerStore {
+    getBalance(input: {
+        accountId: string;
+        currency: Money["currency"];
+    }): Promise<Money>;
+    debit(input: LedgerDebitInput): Promise<LedgerApplyResult>;
+    credit(input: LedgerCreditInput): Promise<LedgerApplyResult>;
+}

package/dist/stores/LedgerStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LedgerStore.d.ts","sourceRoot":"","sources":["../../src/stores/LedgerStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,KAAK,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACtF,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC3D,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC9D"}

package/dist/stores/LedgerStore.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=LedgerStore.js.map

package/dist/stores/LedgerStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LedgerStore.js","sourceRoot":"","sources":["../../src/stores/LedgerStore.ts"],"names":[],"mappings":""}

package/dist/stores/LimitStore.d.ts

@@ -0,0 +1,20 @@
+export interface LimitStore {
+    consumeRpm(input: {
+        accountId: string;
+        rpm: number;
+        requestCount: number;
+        nowMs: number;
+    }): Promise<void>;
+    consumeDailyMinor(input: {
+        accountId: string;
+        amountMinor: number;
+        limitMinor: number;
+        nowMs: number;
+    }): Promise<void>;
+    consumeMonthlyMinor(input: {
+        accountId: string;
+        amountMinor: number;
+        limitMinor: number;
+        nowMs: number;
+    }): Promise<void>;
+}

package/dist/stores/LimitStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LimitStore.d.ts","sourceRoot":"","sources":["../../src/stores/LimitStore.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1G,iBAAiB,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvH,mBAAmB,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1H"}

package/dist/stores/LimitStore.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=LimitStore.js.map

package/dist/stores/LimitStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LimitStore.js","sourceRoot":"","sources":["../../src/stores/LimitStore.ts"],"names":[],"mappings":""}

package/dist/stores/PlanStore.d.ts

@@ -0,0 +1,4 @@
+import type { PricePlan } from "../types";
+export interface PlanStore {
+    getPlan(planId: string): Promise<PricePlan | null>;
+}

package/dist/stores/PlanStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlanStore.d.ts","sourceRoot":"","sources":["../../src/stores/PlanStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;CACpD"}

package/dist/stores/PlanStore.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=PlanStore.js.map

package/dist/stores/PlanStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlanStore.js","sourceRoot":"","sources":["../../src/stores/PlanStore.ts"],"names":[],"mappings":""}

package/dist/stores/UsageStore.d.ts

@@ -0,0 +1,9 @@
+import type { UsageRecord } from "../types";
+export interface UsageStore {
+    append(record: UsageRecord): Promise<void>;
+    list(input: {
+        accountId: string;
+        fromMs?: number;
+        toMs?: number;
+    }): Promise<UsageRecord[]>;
+}

package/dist/stores/UsageStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsageStore.d.ts","sourceRoot":"","sources":["../../src/stores/UsageStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C"}

package/dist/stores/UsageStore.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=UsageStore.js.map

package/dist/stores/UsageStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsageStore.js","sourceRoot":"","sources":["../../src/stores/UsageStore.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,115 @@
+export type Currency = "CNY" | (string & {});
+export type Money = {
+    currency: Currency;
+    /**
+     * Minor units (e.g. CNY=分). Integer only.
+     */
+    amountMinor: number;
+};
+export type UsageEvent = {
+    meter: string;
+    quantity: number;
+    dimensions?: Record<string, string>;
+    ts?: number;
+};
+export type PriceRule = {
+    /**
+     * A logical meter name, e.g. "tokens.input", "tokens.output", "requests".
+     */
+    meter: string;
+    /**
+     * Dimension matchers. v0 supports:
+     * - "*" wildcard
+     * - string equality
+     * - string[] membership
+     */
+    when?: Record<string, "*" | string | string[]>;
+    /**
+     * Price per unit in minor units (e.g. 分). Integer only.
+     */
+    unitPriceMinor: number;
+    currency: Currency;
+    priority?: number;
+    ruleId?: string;
+};
+export type PricePlan = {
+    planId: string;
+    rules: PriceRule[];
+};
+export type Limits = {
+    /**
+     * Requests per minute. v0: each `enforce()` call consumes 1 request by default.
+     */
+    rpm?: number;
+    /**
+     * Daily spending limit in minor units.
+     */
+    dailyLimitMinor?: number;
+    /**
+     * Monthly spending limit in minor units.
+     */
+    monthlyLimitMinor?: number;
+};
+export type QuoteInput = {
+    accountId: string;
+    planId: string;
+    events: UsageEvent[];
+};
+export type QuoteItem = {
+    event: UsageEvent;
+    costMinor: number;
+    ruleId?: string;
+};
+export type Quote = {
+    total: Money;
+    items: QuoteItem[];
+};
+export type EnforceInput = QuoteInput & {
+    idempotencyKey: string;
+    limits?: Limits;
+    /**
+     * Overrides RPM consumption for this call. Defaults to 1.
+     */
+    requestCount?: number;
+    nowMs?: number;
+    metadata?: Record<string, unknown>;
+};
+export type EnforceErrorCode = "INSUFFICIENT_BALANCE" | "RPM_LIMIT_EXCEEDED" | "DAILY_LIMIT_EXCEEDED" | "MONTHLY_LIMIT_EXCEEDED" | "NO_PRICE_RULE" | "CURRENCY_MISMATCH" | "IDEMPOTENCY_CONFLICT" | "INVALID_ARGUMENT";
+export type EnforceResult = {
+    ok: true;
+    txId: string;
+    cost: Money;
+    balanceAfter: Money;
+} | {
+    ok: false;
+    code: EnforceErrorCode;
+    message?: string;
+    retryAfterMs?: number;
+};
+export type CheckResult = {
+    ok: true;
+} | {
+    ok: false;
+    code: EnforceErrorCode;
+    message?: string;
+    retryAfterMs?: number;
+};
+export type GrantResult = {
+    ok: true;
+    txId: string;
+    balanceAfter: Money;
+} | {
+    ok: false;
+    code: EnforceErrorCode;
+    message?: string;
+};
+export type UsageRecord = {
+    accountId: string;
+    planId: string;
+    idempotencyKey: string;
+    txId: string;
+    cost: Money;
+    events: UsageEvent[];
+    tsMs: number;
+    metadata?: Record<string, unknown>;
+};

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE7C,MAAM,MAAM,KAAK,GAAG;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC/C;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB,sBAAsB,GACtB,oBAAoB,GACpB,sBAAsB,GACtB,wBAAwB,GACxB,eAAe,GACf,mBAAmB,GACnB,sBAAsB,GACtB,kBAAkB,CAAC;AAEvB,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,CAAC;IAAC,YAAY,EAAE,KAAK,CAAA;CAAE,GAC5D;IACE,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/fingerprint.d.ts

@@ -0,0 +1,2 @@
+export declare const stableStringify: (value: unknown) => string;
+export declare const makeFingerprint: (value: unknown) => string;

package/dist/utils/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../src/utils/fingerprint.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,WAAgD,CAAC;AAE/F,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,WAA2B,CAAC"}

package/dist/utils/fingerprint.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeFingerprint = exports.stableStringify = void 0;
+const stableStringifyValue = (value) => {
+    if (Array.isArray(value))
+        return value.map(stableStringifyValue);
+    if (!value || typeof value !== "object")
+        return value;
+    const record = value;
+    const keys = Object.keys(record).sort();
+    const out = {};
+    for (const key of keys)
+        out[key] = stableStringifyValue(record[key]);
+    return out;
+};
+const stableStringify = (value) => JSON.stringify(stableStringifyValue(value));
+exports.stableStringify = stableStringify;
+const makeFingerprint = (value) => (0, exports.stableStringify)(value);
+exports.makeFingerprint = makeFingerprint;
+//# sourceMappingURL=fingerprint.js.map

package/dist/utils/fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../../src/utils/fingerprint.ts"],"names":[],"mappings":";;;AAAA,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAW,EAAE;IACvD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACjE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,GAAG,CAAC,GAAG,CAAC,GAAG,oBAAoB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEK,MAAM,eAAe,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;AAAlF,QAAA,eAAe,mBAAmE;AAExF,MAAM,eAAe,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,IAAA,uBAAe,EAAC,KAAK,CAAC,CAAC;AAA7D,QAAA,eAAe,mBAA8C"}

package/dist/utils/guards.d.ts

@@ -0,0 +1,5 @@
+import type { Money, UsageEvent } from "../types";
+export declare const assertInteger: (value: number, field: string) => void;
+export declare const assertNonNegativeInteger: (value: number, field: string) => void;
+export declare const assertMoney: (money: Money, field: string) => void;
+export declare const assertUsageEvent: (event: UsageEvent, field: string) => void;

package/dist/utils/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/utils/guards.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,SAEzD,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,SAGpE,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,EAAE,OAAO,MAAM,SAItD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,OAAO,UAAU,EAAE,OAAO,MAAM,SAIhE,CAAC"}

package/dist/utils/guards.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertUsageEvent = exports.assertMoney = exports.assertNonNegativeInteger = exports.assertInteger = void 0;
+const errors_1 = require("../errors");
+const assertInteger = (value, field) => {
+    if (!Number.isInteger(value))
+        throw new errors_1.UsageError("INVALID_ARGUMENT", `${field} must be an integer`);
+};
+exports.assertInteger = assertInteger;
+const assertNonNegativeInteger = (value, field) => {
+    (0, exports.assertInteger)(value, field);
+    if (value < 0)
+        throw new errors_1.UsageError("INVALID_ARGUMENT", `${field} must be >= 0`);
+};
+exports.assertNonNegativeInteger = assertNonNegativeInteger;
+const assertMoney = (money, field) => {
+    if (!money || typeof money !== "object")
+        throw new errors_1.UsageError("INVALID_ARGUMENT", `${field} is required`);
+    if (!money.currency)
+        throw new errors_1.UsageError("INVALID_ARGUMENT", `${field}.currency is required`);
+    (0, exports.assertNonNegativeInteger)(money.amountMinor, `${field}.amountMinor`);
+};
+exports.assertMoney = assertMoney;
+const assertUsageEvent = (event, field) => {
+    if (!event || typeof event !== "object")
+        throw new errors_1.UsageError("INVALID_ARGUMENT", `${field} is required`);
+    if (!event.meter)
+        throw new errors_1.UsageError("INVALID_ARGUMENT", `${field}.meter is required`);
+    (0, exports.assertNonNegativeInteger)(event.quantity, `${field}.quantity`);
+};
+exports.assertUsageEvent = assertUsageEvent;
+//# sourceMappingURL=guards.js.map

package/dist/utils/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../src/utils/guards.ts"],"names":[],"mappings":";;;AAAA,sCAAuC;AAGhC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE;IAC5D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,mBAAU,CAAC,kBAAkB,EAAE,GAAG,KAAK,qBAAqB,CAAC,CAAC;AACxG,CAAC,CAAC;AAFW,QAAA,aAAa,iBAExB;AAEK,MAAM,wBAAwB,GAAG,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE;IACvE,IAAA,qBAAa,EAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC5B,IAAI,KAAK,GAAG,CAAC;QAAE,MAAM,IAAI,mBAAU,CAAC,kBAAkB,EAAE,GAAG,KAAK,eAAe,CAAC,CAAC;AACnF,CAAC,CAAC;AAHW,QAAA,wBAAwB,4BAGnC;AAEK,MAAM,WAAW,GAAG,CAAC,KAAY,EAAE,KAAa,EAAE,EAAE;IACzD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,mBAAU,CAAC,kBAAkB,EAAE,GAAG,KAAK,cAAc,CAAC,CAAC;IAC1G,IAAI,CAAC,KAAK,CAAC,QAAQ;QAAE,MAAM,IAAI,mBAAU,CAAC,kBAAkB,EAAE,GAAG,KAAK,uBAAuB,CAAC,CAAC;IAC/F,IAAA,gCAAwB,EAAC,KAAK,CAAC,WAAW,EAAE,GAAG,KAAK,cAAc,CAAC,CAAC;AACtE,CAAC,CAAC;AAJW,QAAA,WAAW,eAItB;AAEK,MAAM,gBAAgB,GAAG,CAAC,KAAiB,EAAE,KAAa,EAAE,EAAE;IACnE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,mBAAU,CAAC,kBAAkB,EAAE,GAAG,KAAK,cAAc,CAAC,CAAC;IAC1G,IAAI,CAAC,KAAK,CAAC,KAAK;QAAE,MAAM,IAAI,mBAAU,CAAC,kBAAkB,EAAE,GAAG,KAAK,oBAAoB,CAAC,CAAC;IACzF,IAAA,gCAAwB,EAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,KAAK,WAAW,CAAC,CAAC;AAChE,CAAC,CAAC;AAJW,QAAA,gBAAgB,oBAI3B"}