@codelitdev/billing 0.1.0-alpha.1

package/dist/core/plan-change-attempt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-change-attempt.js","sourceRoot":"","sources":["../../src/core/plan-change-attempt.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,UAAU;IACV,SAAS;IACT,WAAW;IACX,QAAQ;IACR,YAAY;CACN,CAAC;AAIX,MAAM,CAAC,MAAM,uBAAuB,GAChC,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC"}

package/dist/core/projection-diff.d.ts

@@ -0,0 +1,32 @@
+import type { CanonicalSubscriptionStatus } from "./ids.js";
+export type MaterialSnapshotFields = {
+    status: CanonicalSubscriptionStatus;
+    providerProductId: string;
+    priceEntryId: string;
+    catalogRevision: number;
+    offerKey: string;
+    plan: string;
+    interval: string;
+    currentPeriodStartsAt: Date | null;
+    currentPeriodEndsAt: Date | null;
+    paidThroughAt: Date | null;
+    trialEndsAt: Date | null;
+    cancelAtPeriodEnd: boolean;
+    activeSubscriptionId: string | null;
+};
+export type FreshnessFields = {
+    lastObservedAt: Date | null;
+    lastReconciledAt: Date | null;
+};
+export type ProjectionDiff = {
+    kind: "equivalent";
+    freshness: FreshnessFields;
+} | {
+    kind: "material";
+    next: MaterialSnapshotFields;
+    freshness: FreshnessFields;
+};
+export declare function materialFieldsEqual(previous: MaterialSnapshotFields, next: MaterialSnapshotFields): boolean;
+export declare function diffProjection(previous: MaterialSnapshotFields | null, next: MaterialSnapshotFields, freshness: FreshnessFields): ProjectionDiff;
+export declare function nextProjectionVersion(current: number, diff: ProjectionDiff): number;
+//# sourceMappingURL=projection-diff.d.ts.map

package/dist/core/projection-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-diff.d.ts","sourceRoot":"","sources":["../../src/core/projection-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAE5D,MAAM,MAAM,sBAAsB,GAAG;IACjC,MAAM,EAAE,2BAA2B,CAAC;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,IAAI,GAAG,IAAI,CAAC;IACnC,mBAAmB,EAAE,IAAI,GAAG,IAAI,CAAC;IACjC,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,IAAI,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,cAAc,GACpB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,eAAe,CAAA;CAAE,GAClD;IACI,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,SAAS,EAAE,eAAe,CAAC;CAC9B,CAAC;AAWR,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,sBAAsB,EAChC,IAAI,EAAE,sBAAsB,GAC7B,OAAO,CAgBT;AAED,wBAAgB,cAAc,CAC1B,QAAQ,EAAE,sBAAsB,GAAG,IAAI,EACvC,IAAI,EAAE,sBAAsB,EAC5B,SAAS,EAAE,eAAe,GAC3B,cAAc,CAKhB;AAED,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,GACrB,MAAM,CAER"}

package/dist/core/projection-diff.js

@@ -0,0 +1,32 @@
+function timeEq(a, b) {
+    if (a == null && b == null)
+        return true;
+    if (a == null || b == null)
+        return false;
+    return a.getTime() === b.getTime();
+}
+export function materialFieldsEqual(previous, next) {
+    return (previous.status === next.status &&
+        previous.providerProductId === next.providerProductId &&
+        previous.priceEntryId === next.priceEntryId &&
+        previous.catalogRevision === next.catalogRevision &&
+        previous.offerKey === next.offerKey &&
+        previous.plan === next.plan &&
+        previous.interval === next.interval &&
+        timeEq(previous.currentPeriodStartsAt, next.currentPeriodStartsAt) &&
+        timeEq(previous.currentPeriodEndsAt, next.currentPeriodEndsAt) &&
+        timeEq(previous.paidThroughAt, next.paidThroughAt) &&
+        timeEq(previous.trialEndsAt, next.trialEndsAt) &&
+        previous.cancelAtPeriodEnd === next.cancelAtPeriodEnd &&
+        previous.activeSubscriptionId === next.activeSubscriptionId);
+}
+export function diffProjection(previous, next, freshness) {
+    if (previous && materialFieldsEqual(previous, next)) {
+        return { kind: "equivalent", freshness };
+    }
+    return { kind: "material", next, freshness };
+}
+export function nextProjectionVersion(current, diff) {
+    return diff.kind === "material" ? current + 1 : current;
+}
+//# sourceMappingURL=projection-diff.js.map

package/dist/core/projection-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-diff.js","sourceRoot":"","sources":["../../src/core/projection-diff.ts"],"names":[],"mappings":"AA+BA,SAAS,MAAM,CACX,CAA0B,EAC1B,CAA0B;IAE1B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IACzC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAC/B,QAAgC,EAChC,IAA4B;IAE5B,OAAO,CACH,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QAC/B,QAAQ,CAAC,iBAAiB,KAAK,IAAI,CAAC,iBAAiB;QACrD,QAAQ,CAAC,YAAY,KAAK,IAAI,CAAC,YAAY;QAC3C,QAAQ,CAAC,eAAe,KAAK,IAAI,CAAC,eAAe;QACjD,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;QACnC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;QAC3B,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;QACnC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,EAAE,IAAI,CAAC,qBAAqB,CAAC;QAClE,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,CAAC;QAC9D,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC;QAClD,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC;QAC9C,QAAQ,CAAC,iBAAiB,KAAK,IAAI,CAAC,iBAAiB;QACrD,QAAQ,CAAC,oBAAoB,KAAK,IAAI,CAAC,oBAAoB,CAC9D,CAAC;AACN,CAAC;AAED,MAAM,UAAU,cAAc,CAC1B,QAAuC,EACvC,IAA4B,EAC5B,SAA0B;IAE1B,IAAI,QAAQ,IAAI,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,qBAAqB,CACjC,OAAe,EACf,IAAoB;IAEpB,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AAC5D,CAAC"}

package/dist/core/reconciliation-job.d.ts

@@ -0,0 +1,21 @@
+export declare const RECONCILIATION_STATUSES: readonly ["pending", "processing", "failed", "completed", "quarantined"];
+export type ReconciliationJobStatus = (typeof RECONCILIATION_STATUSES)[number];
+export type ReconciliationSubjectKind = "checkout_attempt" | "plan_change_attempt" | "subscription" | "provider_customer";
+export type ReconciliationJob = {
+    id: string;
+    provider: string;
+    checkoutAttemptId: string | null;
+    planChangeAttemptId: string | null;
+    subscriptionId: string | null;
+    providerCustomerId: string | null;
+    operation?: "reconcile" | "cancellation";
+    status: ReconciliationJobStatus;
+    attemptCount: number;
+    availableAt: Date;
+    lockedAt: Date | null;
+    leaseExpiresAt: Date | null;
+    workerId: string | null;
+    lastError: string | null;
+};
+export declare function reconciliationSubjectKind(job: Pick<ReconciliationJob, "checkoutAttemptId" | "planChangeAttemptId" | "subscriptionId" | "providerCustomerId">): ReconciliationSubjectKind;
+//# sourceMappingURL=reconciliation-job.d.ts.map

package/dist/core/reconciliation-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation-job.d.ts","sourceRoot":"","sources":["../../src/core/reconciliation-job.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,0EAM1B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/E,MAAM,MAAM,yBAAyB,GAC/B,kBAAkB,GAClB,qBAAqB,GACrB,cAAc,GACd,mBAAmB,CAAC;AAE1B,MAAM,MAAM,iBAAiB,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC;IACzC,MAAM,EAAE,uBAAuB,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,IAAI,CAAC;IAClB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,wBAAgB,yBAAyB,CACrC,GAAG,EAAE,IAAI,CACL,iBAAiB,EACf,mBAAmB,GACnB,qBAAqB,GACrB,gBAAgB,GAChB,oBAAoB,CACzB,GACF,yBAAyB,CAc3B"}

package/dist/core/reconciliation-job.js

@@ -0,0 +1,26 @@
+export const RECONCILIATION_STATUSES = [
+    "pending",
+    "processing",
+    "failed",
+    "completed",
+    "quarantined",
+];
+export function reconciliationSubjectKind(job) {
+    const set = [
+        job.checkoutAttemptId,
+        job.planChangeAttemptId,
+        job.subscriptionId,
+        job.providerCustomerId,
+    ].filter(Boolean);
+    if (set.length !== 1) {
+        throw new Error("reconciliation_subject_invalid");
+    }
+    if (job.checkoutAttemptId)
+        return "checkout_attempt";
+    if (job.planChangeAttemptId)
+        return "plan_change_attempt";
+    if (job.subscriptionId)
+        return "subscription";
+    return "provider_customer";
+}
+//# sourceMappingURL=reconciliation-job.js.map

package/dist/core/reconciliation-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation-job.js","sourceRoot":"","sources":["../../src/core/reconciliation-job.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACnC,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,WAAW;IACX,aAAa;CACP,CAAC;AA2BX,MAAM,UAAU,yBAAyB,CACrC,GAMC;IAED,MAAM,GAAG,GAAG;QACR,GAAG,CAAC,iBAAiB;QACrB,GAAG,CAAC,mBAAmB;QACvB,GAAG,CAAC,cAAc;QAClB,GAAG,CAAC,kBAAkB;KACzB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,GAAG,CAAC,iBAAiB;QAAE,OAAO,kBAAkB,CAAC;IACrD,IAAI,GAAG,CAAC,mBAAmB;QAAE,OAAO,qBAAqB,CAAC;IAC1D,IAAI,GAAG,CAAC,cAAc;QAAE,OAAO,cAAc,CAAC;IAC9C,OAAO,mBAAmB,CAAC;AAC/B,CAAC"}

package/dist/core/subscription.d.ts

@@ -0,0 +1,62 @@
+import type { BillingInterval, CanonicalSubscriptionStatus } from "./ids.js";
+export type SubscriptionSnapshot = {
+    provider: string;
+    providerCustomerId: string;
+    providerSubscriptionId: string;
+    providerProductId: string;
+    status: CanonicalSubscriptionStatus;
+    currentPeriodStartsAt: Date | null;
+    currentPeriodEndsAt: Date | null;
+    paidThroughAt: Date | null;
+    trialEndsAt: Date | null;
+    cancelAtPeriodEnd: boolean;
+    providerOccurredAt: Date | null;
+    providerVersion: string | null;
+    observedAt: Date;
+    metadata: {
+        checkoutAttemptId?: string;
+        catalogKey?: string;
+        [key: string]: string | undefined;
+    };
+};
+export type VerifiedWebhookEnvelope = {
+    provider: string;
+    providerEventId: string;
+    eventType: string;
+    occurredAt: Date;
+    subscriptionId: string | null;
+    verifiedKeyVersion: string | null;
+    correlationMetadata: {
+        checkoutAttemptId?: string;
+        catalogKey?: string;
+    };
+};
+export type CanonicalSubscription = {
+    id: string;
+    billableEntityId: string;
+    payerId: string;
+    provider: string;
+    providerCustomerId: string;
+    providerSubscriptionId: string;
+    providerProductId: string;
+    catalogRevision: number;
+    offerKey: string;
+    plan: string;
+    interval: BillingInterval;
+    priceEntryId: string;
+    status: CanonicalSubscriptionStatus;
+    currentPeriodStartsAt: Date | null;
+    currentPeriodEndsAt: Date | null;
+    paidThroughAt: Date | null;
+    trialEndsAt: Date | null;
+    cancelAtPeriodEnd: boolean;
+    isEntitlementSource: boolean;
+    originCheckoutAttemptId: string | null;
+    providerOccurredAt: Date | null;
+    providerVersion: string | null;
+    lastObservedAt: Date | null;
+    lastReconciledAt: Date | null;
+};
+export declare const PAID_STATUSES: Set<CanonicalSubscriptionStatus>;
+export declare function retainsPaidEntitlement(snapshot: Pick<SubscriptionSnapshot, "status" | "cancelAtPeriodEnd" | "paidThroughAt">, now: Date): boolean;
+//# sourceMappingURL=subscription.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/core/subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAE7E,MAAM,MAAM,oBAAoB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,2BAA2B,CAAC;IACpC,qBAAqB,EAAE,IAAI,GAAG,IAAI,CAAC;IACnC,mBAAmB,EAAE,IAAI,GAAG,IAAI,CAAC;IACjC,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,IAAI,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,IAAI,CAAC;IACjB,QAAQ,EAAE;QACN,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;KACrC,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,IAAI,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mBAAmB,EAAE;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,2BAA2B,CAAC;IACpC,qBAAqB,EAAE,IAAI,GAAG,IAAI,CAAC;IACnC,mBAAmB,EAAE,IAAI,GAAG,IAAI,CAAC;IACjC,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,kBAAkB,EAAE,IAAI,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,IAAI,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,aAAa,kCAIxB,CAAC;AAEH,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,IAAI,CACV,oBAAoB,EACpB,QAAQ,GAAG,mBAAmB,GAAG,eAAe,CACnD,EACD,GAAG,EAAE,IAAI,GACV,OAAO,CAUT"}

package/dist/core/subscription.js

@@ -0,0 +1,14 @@
+export const PAID_STATUSES = new Set([
+    "active",
+    "trialing",
+    "past_due",
+]);
+export function retainsPaidEntitlement(snapshot, now) {
+    if (PAID_STATUSES.has(snapshot.status))
+        return true;
+    return (snapshot.status === "cancelled" &&
+        snapshot.cancelAtPeriodEnd &&
+        Boolean(snapshot.paidThroughAt &&
+            snapshot.paidThroughAt.getTime() > now.getTime()));
+}
+//# sourceMappingURL=subscription.js.map

package/dist/core/subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../../src/core/subscription.ts"],"names":[],"mappings":"AA+DA,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAA8B;IAC9D,QAAQ;IACR,UAAU;IACV,UAAU;CACb,CAAC,CAAC;AAEH,MAAM,UAAU,sBAAsB,CAClC,QAGC,EACD,GAAS;IAET,IAAI,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,OAAO,CACH,QAAQ,CAAC,MAAM,KAAK,WAAW;QAC/B,QAAQ,CAAC,iBAAiB;QAC1B,OAAO,CACH,QAAQ,CAAC,aAAa;YACtB,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CACnD,CACJ,CAAC;AACN,CAAC"}

package/dist/core/transitions.d.ts

@@ -0,0 +1,25 @@
+import type { CheckoutAttemptStatus } from "./checkout-attempt.js";
+import type { ProviderCustomerStatus } from "./customer.js";
+import type { PlanChangeAttemptStatus } from "./plan-change-attempt.js";
+import type { ReconciliationJobStatus } from "./reconciliation-job.js";
+import type { CanonicalSubscriptionStatus } from "./ids.js";
+import type { WebhookInboxStatus } from "./webhook-inbox.js";
+export type TransitionDecision = {
+    allowed: boolean;
+    reason: string;
+};
+export type CheckoutTransitionContext = {
+    now: Date;
+    expiresAt: Date;
+    subscriptionObservedAt?: Date | null;
+    entityUnchanged?: boolean;
+    payerUnchanged?: boolean;
+    operatorRepair?: boolean;
+};
+export declare function decideSubscriptionTransition(from: CanonicalSubscriptionStatus, to: CanonicalSubscriptionStatus): TransitionDecision;
+export declare function decideCheckoutTransition(from: CheckoutAttemptStatus, to: CheckoutAttemptStatus, context: CheckoutTransitionContext): TransitionDecision;
+export declare function decidePlanChangeTransition(from: PlanChangeAttemptStatus, to: PlanChangeAttemptStatus, operatorRepair?: boolean): TransitionDecision;
+export declare function decideWebhookInboxTransition(from: WebhookInboxStatus, to: WebhookInboxStatus, operatorRepair?: boolean): TransitionDecision;
+export declare function decideCustomerTransition(from: ProviderCustomerStatus, to: ProviderCustomerStatus, operatorRepair?: boolean): TransitionDecision;
+export declare function decideReconciliationTransition(from: ReconciliationJobStatus, to: ReconciliationJobStatus, operatorRepair?: boolean): TransitionDecision;
+//# sourceMappingURL=transitions.d.ts.map

package/dist/core/transitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../src/core/transitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,MAAM,kBAAkB,GAAG;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAmCF,MAAM,MAAM,yBAAyB,GAAG;IACpC,GAAG,EAAE,IAAI,CAAC;IACV,SAAS,EAAE,IAAI,CAAC;IAChB,sBAAsB,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,wBAAgB,4BAA4B,CACxC,IAAI,EAAE,2BAA2B,EACjC,EAAE,EAAE,2BAA2B,GAChC,kBAAkB,CAKpB;AAED,wBAAgB,wBAAwB,CACpC,IAAI,EAAE,qBAAqB,EAC3B,EAAE,EAAE,qBAAqB,EACzB,OAAO,EAAE,yBAAyB,GACnC,kBAAkB,CA0DpB;AAED,wBAAgB,0BAA0B,CACtC,IAAI,EAAE,uBAAuB,EAC7B,EAAE,EAAE,uBAAuB,EAC3B,cAAc,UAAQ,GACvB,kBAAkB,CAmBpB;AAoBD,wBAAgB,4BAA4B,CACxC,IAAI,EAAE,kBAAkB,EACxB,EAAE,EAAE,kBAAkB,EACtB,cAAc,UAAQ,GACvB,kBAAkB,CAOpB;AAWD,wBAAgB,wBAAwB,CACpC,IAAI,EAAE,sBAAsB,EAC5B,EAAE,EAAE,sBAAsB,EAC1B,cAAc,UAAQ,GACvB,kBAAkB,CAOpB;AAaD,wBAAgB,8BAA8B,CAC1C,IAAI,EAAE,uBAAuB,EAC7B,EAAE,EAAE,uBAAuB,EAC3B,cAAc,UAAQ,GACvB,kBAAkB,CAOpB"}

package/dist/core/transitions.js

@@ -0,0 +1,161 @@
+const allow = (reason) => ({
+    allowed: true,
+    reason,
+});
+const deny = (reason) => ({
+    allowed: false,
+    reason,
+});
+const SUBSCRIPTION_TRANSITIONS = {
+    pending: new Set(["pending", "trialing", "active", "cancelled", "expired"]),
+    trialing: new Set([
+        "trialing",
+        "active",
+        "past_due",
+        "cancelled",
+        "expired",
+    ]),
+    active: new Set(["active", "past_due", "cancelled", "expired"]),
+    past_due: new Set(["past_due", "active", "cancelled", "expired"]),
+    cancelled: new Set([
+        "cancelled",
+        "trialing",
+        "active",
+        "past_due",
+        "expired",
+    ]),
+    expired: new Set(["expired"]),
+};
+export function decideSubscriptionTransition(from, to) {
+    if (SUBSCRIPTION_TRANSITIONS[from]?.has(to)) {
+        return allow(`subscription:${from}->${to}`);
+    }
+    return deny(`illegal_subscription_transition:${from}->${to}`);
+}
+export function decideCheckoutTransition(from, to, context) {
+    if (from === to)
+        return allow("idempotent");
+    if (context.operatorRepair)
+        return allow("operator_repair");
+    const terminal = from === "completed" || from === "conflicted";
+    if (terminal) {
+        return deny("checkout_terminal");
+    }
+    if (from === "creating") {
+        if (to === "open" ||
+            to === "expired" ||
+            to === "abandoned" ||
+            to === "conflicted") {
+            return allow(`checkout:creating->${to}`);
+        }
+        return deny(`illegal_checkout_transition:creating->${to}`);
+    }
+    if (from === "open") {
+        if (to === "completed" ||
+            to === "expired" ||
+            to === "abandoned" ||
+            to === "conflicted") {
+            return allow(`checkout:open->${to}`);
+        }
+        return deny(`illegal_checkout_transition:open->${to}`);
+    }
+    if (from === "expired") {
+        if (to === "conflicted")
+            return allow("checkout:expired->conflicted");
+        if (to === "completed") {
+            const observed = context.subscriptionObservedAt;
+            const preExpiry = observed != null &&
+                observed.getTime() <= context.expiresAt.getTime();
+            if (preExpiry &&
+                context.entityUnchanged === true &&
+                context.payerUnchanged === true) {
+                return allow("checkout:expired->completed:pre_expiry");
+            }
+            return deny("checkout:expired_completed_requires_pre_expiry");
+        }
+        return deny(`illegal_checkout_transition:expired->${to}`);
+    }
+    if (from === "abandoned") {
+        if (to === "conflicted")
+            return allow("checkout:abandoned->conflicted");
+        return deny("checkout:abandoned_late_subscription_conflicted");
+    }
+    return deny(`illegal_checkout_transition:${from}->${to}`);
+}
+export function decidePlanChangeTransition(from, to, operatorRepair = false) {
+    if (from === to)
+        return allow("idempotent");
+    if (operatorRepair)
+        return allow("operator_repair");
+    if (from === "creating") {
+        if (to === "pending" ||
+            to === "succeeded" ||
+            to === "failed" ||
+            to === "conflicted") {
+            return allow(`plan_change:creating->${to}`);
+        }
+    }
+    if (from === "pending") {
+        if (to === "succeeded" || to === "failed" || to === "conflicted") {
+            return allow(`plan_change:pending->${to}`);
+        }
+    }
+    return deny(`illegal_plan_change_transition:${from}->${to}`);
+}
+const WEBHOOK_TRANSITIONS = {
+    pending: new Set(["processing", "ignored", "quarantined"]),
+    processing: new Set([
+        "processed",
+        "failed",
+        "ignored",
+        "quarantined",
+        "pending",
+    ]),
+    failed: new Set(["processing", "quarantined"]),
+    processed: new Set(),
+    ignored: new Set(),
+    quarantined: new Set(["processing"]),
+};
+export function decideWebhookInboxTransition(from, to, operatorRepair = false) {
+    if (from === to)
+        return allow("idempotent");
+    if (operatorRepair)
+        return allow("operator_repair");
+    if (WEBHOOK_TRANSITIONS[from]?.has(to)) {
+        return allow(`webhook:${from}->${to}`);
+    }
+    return deny(`illegal_webhook_transition:${from}->${to}`);
+}
+const CUSTOMER_TRANSITIONS = {
+    creating: new Set(["active", "conflicted"]),
+    active: new Set(["conflicted"]),
+    conflicted: new Set(),
+};
+export function decideCustomerTransition(from, to, operatorRepair = false) {
+    if (from === to)
+        return allow("idempotent");
+    if (operatorRepair)
+        return allow("operator_repair");
+    if (CUSTOMER_TRANSITIONS[from]?.has(to)) {
+        return allow(`customer:${from}->${to}`);
+    }
+    return deny(`illegal_customer_transition:${from}->${to}`);
+}
+const JOB_TRANSITIONS = {
+    pending: new Set(["processing", "quarantined"]),
+    processing: new Set(["completed", "failed", "pending", "quarantined"]),
+    failed: new Set(["processing", "quarantined", "pending"]),
+    completed: new Set(["pending"]),
+    quarantined: new Set(["pending", "processing"]),
+};
+export function decideReconciliationTransition(from, to, operatorRepair = false) {
+    if (from === to)
+        return allow("idempotent");
+    if (operatorRepair)
+        return allow("operator_repair");
+    if (JOB_TRANSITIONS[from]?.has(to)) {
+        return allow(`reconciliation:${from}->${to}`);
+    }
+    return deny(`illegal_reconciliation_transition:${from}->${to}`);
+}
+//# sourceMappingURL=transitions.js.map

package/dist/core/transitions.js.map

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

package/dist/core/webhook-inbox.d.ts

@@ -0,0 +1,23 @@
+export declare const WEBHOOK_INBOX_STATUSES: readonly ["pending", "processing", "failed", "processed", "ignored", "quarantined"];
+export type WebhookInboxStatus = (typeof WEBHOOK_INBOX_STATUSES)[number];
+export type WebhookInboxRecord = {
+    id: string;
+    provider: string;
+    providerEventId: string;
+    eventType: string;
+    occurredAt: Date;
+    subscriptionId: string | null;
+    checkoutAttemptId: string | null;
+    payloadEncrypted?: string | null;
+    payloadKeyVersion?: string | null;
+    verifiedKeyVersion: string | null;
+    status: WebhookInboxStatus;
+    processingAttempts: number;
+    lastError: string | null;
+    availableAt: Date;
+    lockedAt: Date | null;
+    leaseExpiresAt: Date | null;
+    workerId: string | null;
+    processedAt?: Date | null;
+};
+//# sourceMappingURL=webhook-inbox.d.ts.map

package/dist/core/webhook-inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-inbox.d.ts","sourceRoot":"","sources":["../../src/core/webhook-inbox.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,qFAOzB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,MAAM,kBAAkB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,IAAI,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,IAAI,CAAC;IAClB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC7B,CAAC"}

package/dist/core/webhook-inbox.js

@@ -0,0 +1,9 @@
+export const WEBHOOK_INBOX_STATUSES = [
+    "pending",
+    "processing",
+    "failed",
+    "processed",
+    "ignored",
+    "quarantined",
+];
+//# sourceMappingURL=webhook-inbox.js.map

package/dist/core/webhook-inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-inbox.js","sourceRoot":"","sources":["../../src/core/webhook-inbox.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,WAAW;IACX,SAAS;IACT,aAAa;CACP,CAAC"}

package/dist/maintenance/batches.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_BATCH_LIMIT = 25;
+export declare const DEFAULT_LEASE_MS: number;
+//# sourceMappingURL=batches.d.ts.map

package/dist/maintenance/batches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batches.d.ts","sourceRoot":"","sources":["../../src/maintenance/batches.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,gBAAgB,QAAgB,CAAC"}

package/dist/maintenance/batches.js

@@ -0,0 +1,3 @@
+export const DEFAULT_BATCH_LIMIT = 25;
+export const DEFAULT_LEASE_MS = 5 * 60 * 1000;
+//# sourceMappingURL=batches.js.map

package/dist/maintenance/batches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batches.js","sourceRoot":"","sources":["../../src/maintenance/batches.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC"}

package/dist/maintenance/claims.d.ts

@@ -0,0 +1,2 @@
+export { billingWebhookRetry, DEFAULT_WEBHOOK_MAX_ATTEMPTS } from "./retry.js";
+//# sourceMappingURL=claims.d.ts.map

package/dist/maintenance/claims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claims.d.ts","sourceRoot":"","sources":["../../src/maintenance/claims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC"}

package/dist/maintenance/claims.js

@@ -0,0 +1,2 @@
+export { billingWebhookRetry, DEFAULT_WEBHOOK_MAX_ATTEMPTS } from "./retry.js";
+//# sourceMappingURL=claims.js.map

package/dist/maintenance/claims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claims.js","sourceRoot":"","sources":["../../src/maintenance/claims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC"}

package/dist/maintenance/health.d.ts

@@ -0,0 +1,13 @@
+import type { BillingStore } from "../persistence/store.js";
+import type { Clock } from "../core/clock.js";
+export type BillingHealthFacts = {
+    oldestInboxAgeMs: number | null;
+    quarantinedWebhooks: number;
+    quarantinedJobs: number;
+    stuckCreatingCheckouts: number;
+    stuckCreatingCustomers: number;
+    unreconciledSubscriptions: number;
+    invalidRequestedCatalog: boolean;
+};
+export declare function healthFacts(store: BillingStore, clock: Clock, requestedRevision: number | null, checkoutProvider?: string): Promise<BillingHealthFacts>;
+//# sourceMappingURL=health.d.ts.map

package/dist/maintenance/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/maintenance/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,MAAM,kBAAkB,GAAG;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yBAAyB,EAAE,MAAM,CAAC;IAClC,uBAAuB,EAAE,OAAO,CAAC;CACpC,CAAC;AAEF,wBAAsB,WAAW,CAC7B,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,KAAK,EACZ,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,gBAAgB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAkB7B"}

package/dist/maintenance/health.js

@@ -0,0 +1,19 @@
+export async function healthFacts(store, clock, requestedRevision, checkoutProvider) {
+    const now = clock.now();
+    const snapshot = await store.health(now, checkoutProvider);
+    const oldest = snapshot.oldestPendingInboxOccurredAt
+        ? now.getTime() - snapshot.oldestPendingInboxOccurredAt.getTime()
+        : null;
+    return {
+        oldestInboxAgeMs: oldest,
+        quarantinedWebhooks: snapshot.quarantinedWebhooks,
+        quarantinedJobs: snapshot.quarantinedJobs,
+        stuckCreatingCheckouts: snapshot.stuckCreatingCheckouts,
+        stuckCreatingCustomers: snapshot.stuckCreatingCustomers,
+        unreconciledSubscriptions: snapshot.unreconciledSubscriptions,
+        invalidRequestedCatalog: requestedRevision !== null &&
+            (snapshot.activeRevision !== requestedRevision ||
+                snapshot.activeRevision === null),
+    };
+}
+//# sourceMappingURL=health.js.map

package/dist/maintenance/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/maintenance/health.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,KAAK,UAAU,WAAW,CAC7B,KAAmB,EACnB,KAAY,EACZ,iBAAgC,EAChC,gBAAyB;IAEzB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;IACxB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,QAAQ,CAAC,4BAA4B;QAChD,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,4BAA4B,CAAC,OAAO,EAAE;QACjE,CAAC,CAAC,IAAI,CAAC;IACX,OAAO;QACH,gBAAgB,EAAE,MAAM;QACxB,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;QACjD,eAAe,EAAE,QAAQ,CAAC,eAAe;QACzC,sBAAsB,EAAE,QAAQ,CAAC,sBAAsB;QACvD,sBAAsB,EAAE,QAAQ,CAAC,sBAAsB;QACvD,yBAAyB,EAAE,QAAQ,CAAC,yBAAyB;QAC7D,uBAAuB,EACnB,iBAAiB,KAAK,IAAI;YAC1B,CAAC,QAAQ,CAAC,cAAc,KAAK,iBAAiB;gBAC1C,QAAQ,CAAC,cAAc,KAAK,IAAI,CAAC;KAC5C,CAAC;AACN,CAAC"}

package/dist/maintenance/retry.d.ts

@@ -0,0 +1,9 @@
+export declare const DEFAULT_WEBHOOK_MAX_ATTEMPTS = 8;
+export type BillingWebhookRetry = {
+    status: "quarantined";
+} | {
+    status: "failed";
+    delayMs: number;
+};
+export declare function billingWebhookRetry(processingAttempts: number, jitterMs?: number): BillingWebhookRetry;
+//# sourceMappingURL=retry.d.ts.map

package/dist/maintenance/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/maintenance/retry.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAW9C,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE,wBAAgB,mBAAmB,CAC/B,kBAAkB,EAAE,MAAM,EAC1B,QAAQ,SAAI,GACb,mBAAmB,CASrB"}

package/dist/maintenance/retry.js

@@ -0,0 +1,19 @@
+export const DEFAULT_WEBHOOK_MAX_ATTEMPTS = 8;
+const INITIAL_RETRY_DELAYS_MS = [
+    60 * 1000,
+    5 * 60 * 1000,
+    30 * 60 * 1000,
+    2 * 60 * 60 * 1000,
+];
+const TAIL_RETRY_DELAY_MS = 8 * 60 * 60 * 1000;
+export function billingWebhookRetry(processingAttempts, jitterMs = 0) {
+    if (processingAttempts >= DEFAULT_WEBHOOK_MAX_ATTEMPTS) {
+        return { status: "quarantined" };
+    }
+    const index = Math.max(0, processingAttempts - 1);
+    if (index < INITIAL_RETRY_DELAYS_MS.length) {
+        return { status: "failed", delayMs: INITIAL_RETRY_DELAYS_MS[index] };
+    }
+    return { status: "failed", delayMs: TAIL_RETRY_DELAY_MS + jitterMs };
+}
+//# sourceMappingURL=retry.js.map

package/dist/maintenance/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/maintenance/retry.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAE9C,MAAM,uBAAuB,GAAG;IAC5B,EAAE,GAAG,IAAI;IACT,CAAC,GAAG,EAAE,GAAG,IAAI;IACb,EAAE,GAAG,EAAE,GAAG,IAAI;IACd,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;CACZ,CAAC;AAEX,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAK/C,MAAM,UAAU,mBAAmB,CAC/B,kBAA0B,EAC1B,QAAQ,GAAG,CAAC;IAEZ,IAAI,kBAAkB,IAAI,4BAA4B,EAAE,CAAC;QACrD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACrC,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,GAAG,CAAC,CAAC,CAAC;IAClD,IAAI,KAAK,GAAG,uBAAuB,CAAC,MAAM,EAAE,CAAC;QACzC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;IACzE,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,GAAG,QAAQ,EAAE,CAAC;AACzE,CAAC"}

package/dist/operations/index.d.ts

@@ -0,0 +1,28 @@
+import type { BillingEngine, OperatorContext } from "../workflows/engine.js";
+import type { Clock } from "../core/clock.js";
+import type { SensitiveValuePort } from "../ports/sensitive-values.js";
+export type OperationsDeps = {
+    billing: BillingEngine;
+    clock: Clock;
+    requestedRevision: number | null;
+    checkoutProvider?: string;
+    sensitiveValues?: SensitiveValuePort;
+};
+export declare function createOperations(deps: OperationsDeps): {
+    inspectEntity(entityId: string): Promise<import("../workflows/engine.js").CommercialBillingState>;
+    health(): Promise<import("../maintenance/health.js").BillingHealthFacts>;
+    reconcileSubscription(context: OperatorContext, subscriptionId: string): Promise<void>;
+    retryWebhook(context: OperatorContext, providerEventId: string, mode: "preserve_attempts" | "new_budget"): Promise<void>;
+    requestCancellation(context: OperatorContext, subscriptionId: string): Promise<void>;
+    decryptReplay(context: OperatorContext, ciphertext: string): Promise<string>;
+    catalog(): Promise<import("../catalog/types.js").PublicBillingCatalog | null>;
+    catalogRevisions(): import("../persistence/store.js").CatalogRevisionRow[] | Promise<import("../persistence/store.js").CatalogRevisionRow[]>;
+    recordRequestedCatalog(): Promise<import("../persistence/store.js").CatalogRevisionRow | null>;
+    verifyRequestedCatalog(): Promise<{
+        verified: boolean;
+        revision: number | null;
+        mismatches: string[];
+    }>;
+    abandonRequestedCatalog(context: OperatorContext): Promise<import("../persistence/store.js").CatalogRevisionRow>;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE7E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,MAAM,MAAM,cAAc,GAAG;IACzB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,kBAAkB,CAAC;CACxC,CAAC;AAiBF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc;4BAGrB,MAAM;;mCAYjB,eAAe,kBACR,MAAM;0BA+Bb,eAAe,mBACP,MAAM,QACjB,mBAAmB,GAAG,YAAY;iCAuC/B,eAAe,kBACR,MAAM;2BAKb,eAAe,cACZ,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC;;;;;;;;;qCA6Be,eAAe;EAKvD"}