@codelitdev/billing 0.1.0-alpha.1

package/dist/config/validate.js

@@ -0,0 +1,227 @@
+import { BillingConfigurationError } from "../core/errors.js";
+export const CANONICAL_TABLE_KEYS = [
+    "priceEntries",
+    "catalogRevisions",
+    "catalogRevisionItems",
+    "providerCustomers",
+    "checkoutAttempts",
+    "planChangeAttempts",
+    "subscriptions",
+    "planStates",
+    "webhookEvents",
+    "reconciliationJobs",
+];
+export const PACKAGE_SCHEMA_VERSION = 2;
+const RESERVED_CANONICAL_FIELDS = new Set([
+    "id",
+    "offerKey",
+    "plan",
+    "billingInterval",
+    "currency",
+    "amountMinor",
+    "provider",
+    "providerProductId",
+    "revision",
+    "checkoutProvider",
+    "status",
+    "verifiedAt",
+    "activatedAt",
+    "retiredAt",
+    "catalogRevisionId",
+    "billingPriceEntryId",
+    "payerId",
+    "payerEmail",
+    "providerCustomerId",
+    "idempotencyKey",
+    "lastError",
+    "attemptId",
+    "billableEntityId",
+    "returnUrl",
+    "catalogRevision",
+    "requestedPlan",
+    "requestedInterval",
+    "quotedAmountMinor",
+    "quotedCurrency",
+    "billingCustomerId",
+    "providerCheckoutSessionId",
+    "checkoutUrlEncrypted",
+    "expiresAt",
+    "completedAt",
+    "originCheckoutAttemptId",
+    "providerSubscriptionId",
+    "currentPeriodStartsAt",
+    "currentPeriodEndsAt",
+    "paidThroughAt",
+    "trialEndsAt",
+    "cancelAtPeriodEnd",
+    "isEntitlementSource",
+    "providerOccurredAt",
+    "providerVersion",
+    "lastObservedAt",
+    "lastReconciledAt",
+    "changeId",
+    "subscriptionId",
+    "actorId",
+    "currentCatalogRevision",
+    "currentBillingPriceEntryId",
+    "currentPlan",
+    "currentInterval",
+    "targetCatalogRevision",
+    "targetBillingPriceEntryId",
+    "targetPlan",
+    "targetInterval",
+    "targetOfferKey",
+    "effectiveAt",
+    "prorationMode",
+    "providerPaymentId",
+    "paymentUrlEncrypted",
+    "activeSubscriptionId",
+    "projectionVersion",
+    "eventType",
+    "occurredAt",
+    "checkoutAttemptId",
+    "payloadEncrypted",
+    "payloadKeyVersion",
+    "verifiedKeyVersion",
+    "processingAttempts",
+    "availableAt",
+    "lockedAt",
+    "leaseExpiresAt",
+    "workerId",
+    "receivedAt",
+    "operation",
+    "createdAt",
+    "updatedAt",
+]);
+const RESERVED_CANONICAL_COLUMNS = new Set([...RESERVED_CANONICAL_FIELDS].map((name) => name.replace(/[A-Z]/g, (character) => `_${character.toLowerCase()}`)));
+export function validateBillingConfig(config) {
+    if (config.dialect !== "postgresql") {
+        throw new BillingConfigurationError("dialect_must_be_postgresql");
+    }
+    if (config.adapter !== "drizzle") {
+        throw new BillingConfigurationError("adapter_must_be_drizzle");
+    }
+    if (!config.output || config.output.includes("\0")) {
+        throw new BillingConfigurationError("output_invalid");
+    }
+    if (config.schemaVersion !== undefined &&
+        (!Number.isSafeInteger(config.schemaVersion) ||
+            config.schemaVersion <= 0)) {
+        throw new BillingConfigurationError("schema_version_invalid");
+    }
+    if (config.tablePrefix !== undefined &&
+        config.tablePrefix !== "" &&
+        !/^[A-Za-z][A-Za-z0-9_]{0,31}$/.test(config.tablePrefix)) {
+        throw new BillingConfigurationError("table_prefix_invalid");
+    }
+    if (config.tableNames !== undefined) {
+        if (!config.tableNames ||
+            typeof config.tableNames !== "object" ||
+            Array.isArray(config.tableNames)) {
+            throw new BillingConfigurationError("table_names_invalid");
+        }
+        for (const [key, value] of Object.entries(config.tableNames)) {
+            if (!CANONICAL_TABLE_KEYS.includes(key)) {
+                throw new BillingConfigurationError(`table_name_key_invalid:${key}`);
+            }
+            if (typeof value !== "string" ||
+                !/^[A-Za-z][A-Za-z0-9_]{0,63}$/.test(value)) {
+                throw new BillingConfigurationError(`table_name_invalid:${key}`);
+            }
+        }
+    }
+    const resolvedTableNames = new Set();
+    for (const key of CANONICAL_TABLE_KEYS) {
+        const defaultName = `${config.tablePrefix ?? "billing_"}${key.replace(/[A-Z]/g, (character) => `_${character.toLowerCase()}`)}`;
+        const resolved = config.tableNames?.[key] ?? defaultName;
+        if (resolvedTableNames.has(resolved)) {
+            throw new BillingConfigurationError("table_names_must_be_unique");
+        }
+        resolvedTableNames.add(resolved);
+    }
+    if (!Array.isArray(config.planIds) || config.planIds.length === 0) {
+        throw new BillingConfigurationError("plan_ids_required");
+    }
+    if (new Set(config.planIds).size !== config.planIds.length) {
+        throw new BillingConfigurationError("plan_ids_must_be_unique");
+    }
+    for (const planId of config.planIds) {
+        if (!/^[a-z][a-z0-9_]{0,31}$/.test(planId)) {
+            throw new BillingConfigurationError("plan_id_invalid");
+        }
+    }
+    if (config.requiredOfferKeys !== undefined) {
+        if (!Array.isArray(config.requiredOfferKeys) ||
+            new Set(config.requiredOfferKeys).size !==
+                config.requiredOfferKeys.length) {
+            throw new BillingConfigurationError("required_offer_keys_invalid");
+        }
+        for (const key of config.requiredOfferKeys) {
+            if (typeof key !== "string" ||
+                !/^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$/.test(key)) {
+                throw new BillingConfigurationError("required_offer_key_invalid");
+            }
+        }
+    }
+    validateModel(config.billableEntity, "billableEntity");
+    validateModel(config.payer, "payer");
+    validateAdditionalFields(config.additionalFields);
+    return config;
+}
+function validateAdditionalFields(fields) {
+    if (fields === undefined)
+        return;
+    if (!fields || typeof fields !== "object" || Array.isArray(fields)) {
+        throw new BillingConfigurationError("additional_fields_invalid");
+    }
+    for (const [table, tableFields] of Object.entries(fields)) {
+        if (!CANONICAL_TABLE_KEYS.includes(table)) {
+            throw new BillingConfigurationError(`additional_fields_table_invalid:${table}`);
+        }
+        if (!tableFields ||
+            typeof tableFields !== "object" ||
+            Array.isArray(tableFields)) {
+            throw new BillingConfigurationError(`additional_fields_invalid:${table}`);
+        }
+        const seenColumns = new Set();
+        for (const [name, spec] of Object.entries(tableFields)) {
+            const column = name.replace(/[A-Z]/g, (character) => `_${character.toLowerCase()}`);
+            if (seenColumns.has(column)) {
+                throw new BillingConfigurationError(`additional_field_name_invalid:${table}.${name}`);
+            }
+            seenColumns.add(column);
+            if (!/^[A-Za-z][A-Za-z0-9_]{0,63}$/.test(name) ||
+                (RESERVED_CANONICAL_FIELDS.has(name) &&
+                    !(table === "planStates" && name === "plan")) ||
+                (RESERVED_CANONICAL_COLUMNS.has(column) &&
+                    !(table === "planStates" && column === "plan"))) {
+                throw new BillingConfigurationError(`additional_field_name_invalid:${table}.${name}`);
+            }
+            if (!spec ||
+                typeof spec !== "object" ||
+                !["text", "integer", "boolean", "timestamp"].includes(spec.type) ||
+                (spec.nullable !== undefined &&
+                    typeof spec.nullable !==
+                        "boolean")) {
+                throw new BillingConfigurationError(`additional_field_spec_invalid:${table}.${name}`);
+            }
+        }
+    }
+}
+function validateModel(model, label) {
+    if (!model.modelName ||
+        !model.tableImport ||
+        !model.tableExport ||
+        !/^[A-Za-z][A-Za-z0-9_]{0,63}$/.test(model.tableExport) ||
+        !/^[A-Za-z][A-Za-z0-9_]{0,63}$/.test(model.idColumn) ||
+        /[\0\r\n"']/.test(model.tableImport)) {
+        throw new BillingConfigurationError(`${label}_mapping_incomplete`);
+    }
+    if (model.idType !== "uuid" && model.idType !== "text") {
+        throw new BillingConfigurationError(`${label}_id_type_invalid`);
+    }
+    if (!["restrict", "cascade", "set null"].includes(model.onDelete)) {
+        throw new BillingConfigurationError(`${label}_on_delete_invalid`);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/config/validate.js.map

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

package/dist/core/checkout-attempt.d.ts

@@ -0,0 +1,29 @@
+export declare const CHECKOUT_STATUSES: readonly ["creating", "open", "completed", "expired", "abandoned", "conflicted"];
+export type CheckoutAttemptStatus = (typeof CHECKOUT_STATUSES)[number];
+export declare const CHECKOUT_NONTERMINAL: ReadonlySet<CheckoutAttemptStatus>;
+export type CheckoutAttempt = {
+    id: string;
+    attemptId: string;
+    billableEntityId: string;
+    payerId: string;
+    payerEmail: string;
+    returnUrl: string;
+    provider: string;
+    catalogRevision: number;
+    offerKey: string;
+    plan: string;
+    interval: "month" | "year";
+    priceEntryId: string;
+    quotedAmountMinor: number;
+    quotedCurrency: string;
+    providerCustomerRowId: string | null;
+    providerCheckoutSessionId: string | null;
+    checkoutUrlEncrypted: string | null;
+    idempotencyKey: string;
+    status: CheckoutAttemptStatus;
+    expiresAt: Date;
+    lastError: string | null;
+    completedAt: Date | null;
+    applicationFields?: Record<string, unknown>;
+};
+//# sourceMappingURL=checkout-attempt.d.ts.map

package/dist/core/checkout-attempt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-attempt.d.ts","sourceRoot":"","sources":["../../src/core/checkout-attempt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,kFAOpB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,qBAAqB,CAEnE,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/C,CAAC"}

package/dist/core/checkout-attempt.js

@@ -0,0 +1,10 @@
+export const CHECKOUT_STATUSES = [
+    "creating",
+    "open",
+    "completed",
+    "expired",
+    "abandoned",
+    "conflicted",
+];
+export const CHECKOUT_NONTERMINAL = new Set(["creating", "open"]);
+//# sourceMappingURL=checkout-attempt.js.map

package/dist/core/checkout-attempt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-attempt.js","sourceRoot":"","sources":["../../src/core/checkout-attempt.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,UAAU;IACV,MAAM;IACN,WAAW;IACX,SAAS;IACT,WAAW;IACX,YAAY;CACN,CAAC;AAIX,MAAM,CAAC,MAAM,oBAAoB,GAAuC,IAAI,GAAG,CAC3E,CAAC,UAAU,EAAE,MAAM,CAAC,CACvB,CAAC"}

package/dist/core/clock.d.ts

@@ -0,0 +1,10 @@
+/** Injected time source. Core decision functions never read wall time. */
+export type Clock = {
+    now(): Date;
+};
+export declare const systemClock: Clock;
+export declare function frozenClock(at: Date): Clock;
+export declare function advancingClock(start: Date, stepMs?: number): Clock & {
+    tick(ms?: number): Date;
+};
+//# sourceMappingURL=clock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../src/core/clock.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,MAAM,KAAK,GAAG;IAChB,GAAG,IAAI,IAAI,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAIzB,CAAC;AAEF,wBAAgB,WAAW,CAAC,EAAE,EAAE,IAAI,GAAG,KAAK,CAO3C;AAED,wBAAgB,cAAc,CAC1B,KAAK,EAAE,IAAI,EACX,MAAM,SAAI,GACX,KAAK,GAAG;IAAE,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAWrC"}

package/dist/core/clock.js

@@ -0,0 +1,26 @@
+export const systemClock = {
+    now() {
+        return new Date();
+    },
+};
+export function frozenClock(at) {
+    const ms = at.getTime();
+    return {
+        now() {
+            return new Date(ms);
+        },
+    };
+}
+export function advancingClock(start, stepMs = 0) {
+    let ms = start.getTime();
+    return {
+        now() {
+            return new Date(ms);
+        },
+        tick(delta = stepMs) {
+            ms += delta;
+            return new Date(ms);
+        },
+    };
+}
+//# sourceMappingURL=clock.js.map

package/dist/core/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../src/core/clock.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,WAAW,GAAU;IAC9B,GAAG;QACC,OAAO,IAAI,IAAI,EAAE,CAAC;IACtB,CAAC;CACJ,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,EAAQ;IAChC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IACxB,OAAO;QACH,GAAG;YACC,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;KACJ,CAAC;AACN,CAAC;AAED,MAAM,UAAU,cAAc,CAC1B,KAAW,EACX,MAAM,GAAG,CAAC;IAEV,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IACzB,OAAO;QACH,GAAG;YACC,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,MAAM;YACf,EAAE,IAAI,KAAK,CAAC;YACZ,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/core/customer.d.ts

@@ -0,0 +1,13 @@
+export declare const CUSTOMER_STATUSES: readonly ["creating", "active", "conflicted"];
+export type ProviderCustomerStatus = (typeof CUSTOMER_STATUSES)[number];
+export type ProviderCustomer = {
+    id: string;
+    provider: string;
+    payerId: string;
+    payerEmail: string;
+    providerCustomerId: string | null;
+    idempotencyKey: string;
+    status: ProviderCustomerStatus;
+    lastError: string | null;
+};
+//# sourceMappingURL=customer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"customer.d.ts","sourceRoot":"","sources":["../../src/core/customer.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,+CAAgD,CAAC;AAC/E,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,MAAM,gBAAgB,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC"}

package/dist/core/customer.js

@@ -0,0 +1,2 @@
+export const CUSTOMER_STATUSES = ["creating", "active", "conflicted"];
+//# sourceMappingURL=customer.js.map

package/dist/core/customer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer.js","sourceRoot":"","sources":["../../src/core/customer.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAU,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,28 @@
+export type WorkflowErrorCode = "catalog_changed" | "catalog_unavailable" | "provider_unavailable" | "active_subscription_exists" | "checkout_pending" | "subscription_required" | "subscription_not_changeable" | "plan_change_pending" | "plan_change_not_supported" | "same_offer" | "invalid_return_url" | "payer_mismatch" | "operation_conflicted" | "operation_quarantined" | "unsupported_operation" | "grant_invalid" | "grant_consumed" | "composition_invalid";
+export type ProviderErrorCode = "invalid" | "unauthorized" | "conflict" | "rate_limited" | "unavailable" | "misconfigured";
+export type WorkflowErrorDetails = {
+    publicCatalog?: unknown;
+    currentRevision?: number;
+};
+export declare class BillingWorkflowError extends Error {
+    readonly code: WorkflowErrorCode;
+    readonly retryable: boolean;
+    readonly details: WorkflowErrorDetails;
+    constructor(code: WorkflowErrorCode, options?: {
+        retryable?: boolean;
+        details?: WorkflowErrorDetails;
+    });
+}
+export declare class BillingProviderError extends Error {
+    readonly code: ProviderErrorCode;
+    readonly cause?: unknown | undefined;
+    constructor(code: ProviderErrorCode, message: string, cause?: unknown | undefined);
+}
+export declare class BillingCompositionError extends Error {
+    constructor(message: string);
+}
+export declare class BillingConfigurationError extends Error {
+    constructor(message: string);
+}
+export declare function providerErrorSummary(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACvB,iBAAiB,GACjB,qBAAqB,GACrB,sBAAsB,GACtB,4BAA4B,GAC5B,kBAAkB,GAClB,uBAAuB,GACvB,6BAA6B,GAC7B,qBAAqB,GACrB,2BAA2B,GAC3B,YAAY,GACZ,oBAAoB,GACpB,gBAAgB,GAChB,sBAAsB,GACtB,uBAAuB,GACvB,uBAAuB,GACvB,eAAe,GACf,gBAAgB,GAChB,qBAAqB,CAAC;AAE5B,MAAM,MAAM,iBAAiB,GACvB,SAAS,GACT,cAAc,GACd,UAAU,GACV,cAAc,GACd,aAAa,GACb,eAAe,CAAC;AAEtB,MAAM,MAAM,oBAAoB,GAAG;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,KAAK;aAKvB,IAAI,EAAE,iBAAiB;IAJ3C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;gBAGnB,IAAI,EAAE,iBAAiB,EACvC,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,oBAAoB,CAAA;KAAO;CAO5E;AAED,qBAAa,oBAAqB,SAAQ,KAAK;aAEvB,IAAI,EAAE,iBAAiB;aAEvB,KAAK,CAAC,EAAE,OAAO;gBAFf,IAAI,EAAE,iBAAiB,EACvC,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKtC;AAED,qBAAa,uBAAwB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI9B;AAED,qBAAa,yBAA0B,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI9B;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG3D"}

package/dist/core/errors.js

@@ -0,0 +1,43 @@
+export class BillingWorkflowError extends Error {
+    code;
+    retryable;
+    details;
+    constructor(code, options = {}) {
+        super(code);
+        this.code = code;
+        this.name = "BillingWorkflowError";
+        this.retryable = options.retryable ?? retryableByDefault(code);
+        this.details = options.details ?? {};
+    }
+}
+export class BillingProviderError extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = "BillingProviderError";
+    }
+}
+export class BillingCompositionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "BillingCompositionError";
+    }
+}
+export class BillingConfigurationError extends Error {
+    constructor(message) {
+        super(`billing_configuration_invalid:${message}`);
+        this.name = "BillingConfigurationError";
+    }
+}
+export function providerErrorSummary(error) {
+    if (error instanceof BillingProviderError)
+        return `provider_${error.code}`;
+    return "provider_error";
+}
+function retryableByDefault(code) {
+    return code === "provider_unavailable" || code === "catalog_unavailable";
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAiCA,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAKvB;IAJX,SAAS,CAAU;IACnB,OAAO,CAAuB;IAEvC,YACoB,IAAuB,EACvC,UAAmE,EAAE;QAErE,KAAK,CAAC,IAAI,CAAC,CAAC;QAHI,SAAI,GAAJ,IAAI,CAAmB;QAIvC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACzC,CAAC;CACJ;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAEvB;IAEA;IAHpB,YACoB,IAAuB,EACvC,OAAe,EACC,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAmB;QAEvB,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACvC,CAAC;CACJ;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IAC1C,CAAC;CACJ;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAChD,YAAY,OAAe;QACvB,KAAK,CAAC,iCAAiC,OAAO,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC5C,CAAC;CACJ;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IAC/C,IAAI,KAAK,YAAY,oBAAoB;QAAE,OAAO,YAAY,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3E,OAAO,gBAAgB,CAAC;AAC5B,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAuB;IAC/C,OAAO,IAAI,KAAK,sBAAsB,IAAI,IAAI,KAAK,qBAAqB,CAAC;AAC7E,CAAC"}

package/dist/core/ids.d.ts

@@ -0,0 +1,15 @@
+export type BillingInterval = "month" | "year";
+export type CanonicalSubscriptionStatus = "pending" | "trialing" | "active" | "past_due" | "cancelled" | "expired";
+export type BillableEntityRef = {
+    kind: string;
+    id: string;
+};
+export type PayerRef = {
+    id: string;
+    email: string;
+    name?: string;
+};
+export declare function assertOpaqueId(value: string, label: string): string;
+export declare function assertProviderId(value: string): string;
+export declare function assertProviderName(value: string): string;
+//# sourceMappingURL=ids.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/core/ids.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;AAE/C,MAAM,MAAM,2BAA2B,GACnC,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAE7E,MAAM,MAAM,iBAAiB,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAYnE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUtD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKxD"}

package/dist/core/ids.js

@@ -0,0 +1,29 @@
+const PROVIDER_ID_MAX = 256;
+const OPAQUE_ID_MAX = 256;
+export function assertOpaqueId(value, label) {
+    if (typeof value !== "string" ||
+        value.length < 1 ||
+        value.length > OPAQUE_ID_MAX) {
+        throw new Error(`${label}_invalid`);
+    }
+    if (value !== value.trim() || /\s/.test(value)) {
+        throw new Error(`${label}_invalid`);
+    }
+    return value;
+}
+export function assertProviderId(value) {
+    if (typeof value !== "string" ||
+        value.length < 2 ||
+        value.length > PROVIDER_ID_MAX ||
+        /\s/.test(value)) {
+        throw new Error("provider_id_invalid");
+    }
+    return value;
+}
+export function assertProviderName(value) {
+    if (!/^[a-z][a-z0-9_-]{1,31}$/.test(value)) {
+        throw new Error("provider_name_invalid");
+    }
+    return value;
+}
+//# sourceMappingURL=ids.js.map

package/dist/core/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/core/ids.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,MAAM,aAAa,GAAG,GAAG,CAAC;AAkB1B,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,KAAa;IACvD,IACI,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,MAAM,GAAG,CAAC;QAChB,KAAK,CAAC,MAAM,GAAG,aAAa,EAC9B,CAAC;QACC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,UAAU,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,KAAK,KAAK,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,UAAU,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC1C,IACI,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,MAAM,GAAG,CAAC;QAChB,KAAK,CAAC,MAAM,GAAG,eAAe;QAC9B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAClB,CAAC;QACC,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC5C,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,14 @@
+export { assertOpaqueId, assertProviderId, assertProviderName, type BillingInterval, type BillableEntityRef, type CanonicalSubscriptionStatus, type PayerRef, } from "./ids.js";
+export { money, assertIso4217, sameMoney, type Money } from "./money.js";
+export { systemClock, frozenClock, advancingClock, type Clock, } from "./clock.js";
+export { BillingWorkflowError, BillingProviderError, BillingCompositionError, BillingConfigurationError, providerErrorSummary, type WorkflowErrorCode, type ProviderErrorCode, } from "./errors.js";
+export { PAID_STATUSES, retainsPaidEntitlement, type CanonicalSubscription, type SubscriptionSnapshot, type VerifiedWebhookEnvelope, } from "./subscription.js";
+export { CHECKOUT_STATUSES, CHECKOUT_NONTERMINAL, type CheckoutAttempt, type CheckoutAttemptStatus, } from "./checkout-attempt.js";
+export { PLAN_CHANGE_STATUSES, PLAN_CHANGE_NONTERMINAL, type PlanChangeAttempt, type PlanChangeAttemptStatus, } from "./plan-change-attempt.js";
+export { WEBHOOK_INBOX_STATUSES, type WebhookInboxRecord, type WebhookInboxStatus, } from "./webhook-inbox.js";
+export { CUSTOMER_STATUSES, type ProviderCustomer, type ProviderCustomerStatus, } from "./customer.js";
+export { RECONCILIATION_STATUSES, reconciliationSubjectKind, type ReconciliationJob, type ReconciliationJobStatus, type ReconciliationSubjectKind, } from "./reconciliation-job.js";
+export { decideSubscriptionTransition, decideCheckoutTransition, decidePlanChangeTransition, decideWebhookInboxTransition, decideCustomerTransition, decideReconciliationTransition, type CheckoutTransitionContext, type TransitionDecision, } from "./transitions.js";
+export { diffProjection, materialFieldsEqual, nextProjectionVersion, type FreshnessFields, type MaterialSnapshotFields, type ProjectionDiff, } from "./projection-diff.js";
+export { billingWebhookRetry, DEFAULT_WEBHOOK_MAX_ATTEMPTS, } from "../maintenance/retry.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,QAAQ,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EACH,WAAW,EACX,WAAW,EACX,cAAc,EACd,KAAK,KAAK,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EACH,aAAa,EACb,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,GAC/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACH,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACH,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,GAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACH,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EACH,uBAAuB,EACvB,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,GACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,4BAA4B,EAC5B,wBAAwB,EACxB,0BAA0B,EAC1B,4BAA4B,EAC5B,wBAAwB,EACxB,8BAA8B,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,mBAAmB,EACnB,4BAA4B,GAC/B,MAAM,yBAAyB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,14 @@
+export { assertOpaqueId, assertProviderId, assertProviderName, } from "./ids.js";
+export { money, assertIso4217, sameMoney } from "./money.js";
+export { systemClock, frozenClock, advancingClock, } from "./clock.js";
+export { BillingWorkflowError, BillingProviderError, BillingCompositionError, BillingConfigurationError, providerErrorSummary, } from "./errors.js";
+export { PAID_STATUSES, retainsPaidEntitlement, } from "./subscription.js";
+export { CHECKOUT_STATUSES, CHECKOUT_NONTERMINAL, } from "./checkout-attempt.js";
+export { PLAN_CHANGE_STATUSES, PLAN_CHANGE_NONTERMINAL, } from "./plan-change-attempt.js";
+export { WEBHOOK_INBOX_STATUSES, } from "./webhook-inbox.js";
+export { CUSTOMER_STATUSES, } from "./customer.js";
+export { RECONCILIATION_STATUSES, reconciliationSubjectKind, } from "./reconciliation-job.js";
+export { decideSubscriptionTransition, decideCheckoutTransition, decidePlanChangeTransition, decideWebhookInboxTransition, decideCustomerTransition, decideReconciliationTransition, } from "./transitions.js";
+export { diffProjection, materialFieldsEqual, nextProjectionVersion, } from "./projection-diff.js";
+export { billingWebhookRetry, DEFAULT_WEBHOOK_MAX_ATTEMPTS, } from "../maintenance/retry.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GAKrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAc,MAAM,YAAY,CAAC;AACzE,OAAO,EACH,WAAW,EACX,WAAW,EACX,cAAc,GAEjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,GAGvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACH,aAAa,EACb,sBAAsB,GAIzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACH,iBAAiB,EACjB,oBAAoB,GAGvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACH,oBAAoB,EACpB,uBAAuB,GAG1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACH,sBAAsB,GAGzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,iBAAiB,GAGpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACH,uBAAuB,EACvB,yBAAyB,GAI5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,4BAA4B,EAC5B,wBAAwB,EACxB,0BAA0B,EAC1B,4BAA4B,EAC5B,wBAAwB,EACxB,8BAA8B,GAGjC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,cAAc,EACd,mBAAmB,EACnB,qBAAqB,GAIxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,mBAAmB,EACnB,4BAA4B,GAC/B,MAAM,yBAAyB,CAAC"}

package/dist/core/money.d.ts

@@ -0,0 +1,8 @@
+export type Money = {
+    amountMinor: number;
+    currency: string;
+};
+export declare function money(amountMinor: number, currency: string): Money;
+export declare function assertIso4217(currency: string): string;
+export declare function sameMoney(left: Money, right: Money): boolean;
+//# sourceMappingURL=money.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../../src/core/money.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAIF,wBAAgB,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CASlE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAK5D"}

package/dist/core/money.js

@@ -0,0 +1,23 @@
+const ISO_4217 = /^[A-Z]{3}$/;
+export function money(amountMinor, currency) {
+    const normalized = currency.toUpperCase();
+    if (!ISO_4217.test(normalized)) {
+        throw new Error("currency_invalid");
+    }
+    if (!Number.isSafeInteger(amountMinor) || amountMinor <= 0) {
+        throw new Error("amount_minor_invalid");
+    }
+    return { amountMinor, currency: normalized };
+}
+export function assertIso4217(currency) {
+    const normalized = currency.toUpperCase();
+    if (!ISO_4217.test(normalized)) {
+        throw new Error("currency_invalid");
+    }
+    return normalized;
+}
+export function sameMoney(left, right) {
+    return (left.amountMinor === right.amountMinor &&
+        left.currency === right.currency);
+}
+//# sourceMappingURL=money.js.map

package/dist/core/money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.js","sourceRoot":"","sources":["../../src/core/money.ts"],"names":[],"mappings":"AAKA,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,MAAM,UAAU,KAAK,CAAC,WAAmB,EAAE,QAAgB;IACvD,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAW,EAAE,KAAY;IAC/C,OAAO,CACH,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW;QACtC,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,CACnC,CAAC;AACN,CAAC"}

package/dist/core/plan-change-attempt.d.ts

@@ -0,0 +1,30 @@
+export declare const PLAN_CHANGE_STATUSES: readonly ["creating", "pending", "succeeded", "failed", "conflicted"];
+export type PlanChangeAttemptStatus = (typeof PLAN_CHANGE_STATUSES)[number];
+export declare const PLAN_CHANGE_NONTERMINAL: ReadonlySet<PlanChangeAttemptStatus>;
+export type PlanChangeAttempt = {
+    id: string;
+    changeId: string;
+    billableEntityId: string;
+    subscriptionId: string;
+    actorId: string;
+    payerId: string;
+    provider: string;
+    idempotencyKey: string;
+    currentCatalogRevision: number;
+    currentPriceEntryId: string;
+    currentPlan: string;
+    currentInterval: "month" | "year";
+    targetCatalogRevision: number;
+    targetPriceEntryId: string;
+    targetPlan: string;
+    targetInterval: "month" | "year";
+    targetOfferKey: string;
+    effectiveAt: "immediately" | "next_billing_date";
+    prorationMode: "prorated_immediately" | "do_not_bill";
+    status: PlanChangeAttemptStatus;
+    lastError: string | null;
+    providerPaymentId?: string | null;
+    paymentUrlEncrypted?: string | null;
+    completedAt?: Date | null;
+};
+//# sourceMappingURL=plan-change-attempt.d.ts.map

package/dist/core/plan-change-attempt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-change-attempt.d.ts","sourceRoot":"","sources":["../../src/core/plan-change-attempt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,uEAMvB,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,uBAAuB,CACrC,CAAC;AAErC,MAAM,MAAM,iBAAiB,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,OAAO,GAAG,MAAM,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,aAAa,GAAG,mBAAmB,CAAC;IACjD,aAAa,EAAE,sBAAsB,GAAG,aAAa,CAAC;IACtD,MAAM,EAAE,uBAAuB,CAAC;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC7B,CAAC"}

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

@@ -0,0 +1,9 @@
+export const PLAN_CHANGE_STATUSES = [
+    "creating",
+    "pending",
+    "succeeded",
+    "failed",
+    "conflicted",
+];
+export const PLAN_CHANGE_NONTERMINAL = new Set(["creating", "pending"]);
+//# sourceMappingURL=plan-change-attempt.js.map