@absolutejs/billing 0.6.0 → 0.7.0

package/dist/prepaid.d.ts

@@ -0,0 +1,101 @@
+/** Service-credit accounting. Host authorization and payment verification happen
+ * before these commands. Every command and its receipt commit in one transaction. */
+export type CreditAccount = {
+    periodId: string;
+    periodEnd: string | null;
+    periodAllowance: number;
+    periodRemaining: number;
+    purchasedRemaining: number;
+    promotionalRemaining: number;
+    debt: number;
+    reserved: number;
+    consumed: number;
+};
+export type CreditAllocation = {
+    period: number;
+    purchased: number;
+    promotional: number;
+};
+export type CreditReservation = {
+    id: string;
+    periodId: string;
+    allocation: CreditAllocation;
+    status: "reserved" | "settled" | "released";
+    charged: number | null;
+};
+export type CreditCommand = {
+    kind: "grant";
+    bucket: "purchased" | "promotional";
+    credits: number;
+} | {
+    kind: "reverse";
+    bucket: "purchased" | "promotional";
+    credits: number;
+} | {
+    kind: "period";
+    periodId: string;
+    periodEnd: string | null;
+    allowance: number;
+} | {
+    kind: "reserve";
+    reservationId: string;
+    credits: number;
+} | {
+    kind: "settle";
+    reservationId: string;
+    credits: number;
+} | {
+    kind: "release";
+    reservationId: string;
+} | {
+    kind: "debit";
+    credits: number;
+    allowDebt?: boolean;
+    reference?: string;
+};
+export type CreditReceipt = {
+    command: CreditCommand;
+    account: CreditAccount;
+    reservation?: CreditReservation;
+};
+export type CreditTransaction = {
+    account: CreditAccount;
+    receipt: (operationId: string) => Promise<CreditReceipt | null>;
+    reservation: (id: string) => Promise<CreditReservation | null>;
+    save: (operationId: string, receipt: CreditReceipt) => Promise<void>;
+};
+export type CreditAccountStore = {
+    /** Persist seed once. Never overwrite an existing account. */
+    initialize: (accountId: string, seed: CreditAccount) => Promise<void>;
+    read: (accountId: string) => Promise<CreditAccount | null>;
+    /** Lock one account, serialize its commands across processes, and roll back
+     * account, reservation and receipt together if the callback fails. */
+    transaction: <T>(accountId: string, run: (tx: CreditTransaction) => Promise<T>) => Promise<T>;
+};
+export declare const validateCreditAccount: (account: CreditAccount) => void;
+export declare const availableCredits: (account: CreditAccount) => number;
+/** Preserve the currently observable legacy balance without inventing purchase
+ * provenance. Historical mixed bonus grants remain promotional carryover. */
+export declare const migrateLegacyCreditAccount: (input: {
+    periodId: string;
+    periodEnd?: string | null;
+    periodAllowance: number;
+    bonusCredits: number;
+    consumed: number;
+}) => CreditAccount;
+export declare const createCreditAccountLedger: (store: CreditAccountStore) => {
+    initialize: (accountId: string, seed: CreditAccount) => Promise<void>;
+    receipt: (accountId: string, operationId: string) => Promise<CreditReceipt | null>;
+    balance: (accountId: string) => Promise<CreditAccount | null>;
+    execute: (accountId: string, operationId: string, input: CreditCommand) => Promise<CreditReceipt>;
+};
+/** Portal access and funded MCP access are independent. Period-only free
+ * allowances do not silently unlock prepaid work; carryover grants may. */
+export declare const creditEntitlements: (input: {
+    subscribed: boolean;
+    prepaidEnabled: boolean;
+    account: CreditAccount | null;
+}) => {
+    portal: boolean;
+    mcp: "member" | "prepaid" | "free";
+};

package/dist/prepaid.js

@@ -0,0 +1,271 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/prepaid.ts
+var integer = (value) => {
+  if (!Number.isSafeInteger(value) || value < 0)
+    throw new Error("Credits must be nonnegative safe integers");
+  return value;
+};
+var periodIdentity = (value) => {
+  if (!Number.isFinite(Date.parse(value)) || new Date(value).toISOString() !== value)
+    throw new Error("Credit period ID must be an ISO UTC start timestamp");
+  return value;
+};
+var identity = (value) => {
+  if (!value || value.length > 256)
+    throw new Error("Credit identity is invalid");
+  return value;
+};
+var validateCreditAccount = (account) => {
+  periodIdentity(account.periodId);
+  if (account.periodEnd !== null && periodIdentity(account.periodEnd) <= account.periodId)
+    throw new Error("Credit period end must follow its start");
+  for (const key of [
+    "periodAllowance",
+    "periodRemaining",
+    "purchasedRemaining",
+    "promotionalRemaining",
+    "debt",
+    "reserved",
+    "consumed"
+  ])
+    integer(account[key]);
+  integer(account.periodRemaining + account.purchasedRemaining + account.promotionalRemaining);
+  if (account.periodRemaining > account.periodAllowance)
+    throw new Error("Period balance exceeds its allowance");
+};
+var availableCredits = (account) => Math.max(0, account.periodRemaining + account.purchasedRemaining + account.promotionalRemaining - account.debt);
+var migrateLegacyCreditAccount = (input) => {
+  integer(input.periodAllowance);
+  integer(input.consumed);
+  if (!Number.isSafeInteger(input.bonusCredits))
+    throw new Error("Invalid legacy bonus credits");
+  const account = {
+    periodId: input.periodId,
+    periodEnd: input.periodEnd ?? null,
+    periodAllowance: input.periodAllowance,
+    periodRemaining: Math.max(0, input.periodAllowance - input.consumed),
+    purchasedRemaining: 0,
+    promotionalRemaining: Math.max(0, input.bonusCredits - Math.max(0, input.consumed - input.periodAllowance)),
+    debt: Math.max(0, -input.bonusCredits) + Math.max(0, input.consumed - input.periodAllowance - Math.max(0, input.bonusCredits)),
+    reserved: 0,
+    consumed: input.consumed
+  };
+  validateCreditAccount(account);
+  return account;
+};
+var allocationTotal = (value) => value.period + value.promotional + value.purchased;
+var take = (account, credits) => {
+  let owed = account.debt;
+  for (const key of [
+    "periodRemaining",
+    "promotionalRemaining",
+    "purchasedRemaining"
+  ]) {
+    const covered = Math.min(account[key], owed);
+    account[key] -= covered;
+    owed -= covered;
+  }
+  account.debt = owed;
+  const period = Math.min(account.periodRemaining, credits);
+  const promotional = Math.min(account.promotionalRemaining, credits - period);
+  const purchased = Math.min(account.purchasedRemaining, credits - period - promotional);
+  account.periodRemaining -= period;
+  account.promotionalRemaining -= promotional;
+  account.purchasedRemaining -= purchased;
+  return { period, promotional, purchased };
+};
+var grant = (account, key, credits) => {
+  const covered = Math.min(account.debt, credits);
+  account.debt -= covered;
+  account[key] = integer(account[key] + credits - covered);
+};
+var normalize = (command) => {
+  switch (command.kind) {
+    case "grant":
+    case "reverse":
+      if (command.bucket !== "purchased" && command.bucket !== "promotional")
+        throw new Error("Invalid credit bucket");
+      return {
+        kind: command.kind,
+        bucket: command.bucket,
+        credits: integer(command.credits)
+      };
+    case "period":
+      return {
+        kind: command.kind,
+        periodId: periodIdentity(command.periodId),
+        periodEnd: command.periodEnd === null ? null : periodIdentity(command.periodEnd),
+        allowance: integer(command.allowance)
+      };
+    case "reserve":
+    case "settle":
+      return {
+        kind: command.kind,
+        reservationId: identity(command.reservationId),
+        credits: integer(command.credits)
+      };
+    case "release":
+      return {
+        kind: command.kind,
+        reservationId: identity(command.reservationId)
+      };
+    case "debit":
+      return {
+        kind: command.kind,
+        credits: integer(command.credits),
+        allowDebt: command.allowDebt === true,
+        ...command.reference === undefined ? {} : { reference: identity(command.reference) }
+      };
+    default:
+      throw new Error("Invalid credit command");
+  }
+};
+var createCreditAccountLedger = (store) => ({
+  initialize: async (accountId, seed) => {
+    identity(accountId);
+    validateCreditAccount(seed);
+    await store.initialize(accountId, seed);
+  },
+  receipt: (accountId, operationId) => store.transaction(identity(accountId), (tx) => tx.receipt(identity(operationId))),
+  balance: (accountId) => store.read(identity(accountId)),
+  execute: async (accountId, operationId, input) => {
+    identity(accountId);
+    identity(operationId);
+    const command = normalize(input);
+    return store.transaction(accountId, async (tx) => {
+      const previous = await tx.receipt(operationId);
+      if (previous) {
+        if (JSON.stringify(normalize(previous.command)) !== JSON.stringify(command))
+          throw new Error("Credit operation ID reused with different input");
+        return previous;
+      }
+      const account = { ...tx.account };
+      validateCreditAccount(account);
+      let reservation;
+      switch (command.kind) {
+        case "grant":
+          grant(account, command.bucket === "purchased" ? "purchasedRemaining" : "promotionalRemaining", command.credits);
+          break;
+        case "reverse": {
+          const key = command.bucket === "purchased" ? "purchasedRemaining" : "promotionalRemaining";
+          const covered = Math.min(account[key], command.credits);
+          account[key] -= covered;
+          account.debt += command.credits - covered;
+          break;
+        }
+        case "period":
+          if (command.periodId < account.periodId)
+            throw new Error("Credit period cannot move backwards");
+          if (command.periodId === account.periodId) {
+            const increase = Math.max(0, command.allowance - account.periodAllowance);
+            if (account.periodEnd === null)
+              account.periodEnd = command.periodEnd;
+            account.periodAllowance += increase;
+            grant(account, "periodRemaining", increase);
+          } else {
+            account.periodId = command.periodId;
+            account.periodEnd = command.periodEnd;
+            account.periodAllowance = command.allowance;
+            account.periodRemaining = 0;
+            account.consumed = 0;
+            grant(account, "periodRemaining", command.allowance);
+          }
+          break;
+        case "debit": {
+          if (!command.allowDebt && availableCredits(account) < command.credits)
+            throw new Error("Insufficient credits");
+          const used = allocationTotal(take(account, command.credits));
+          account.debt += command.credits - used;
+          account.consumed += command.credits;
+          break;
+        }
+        case "reserve":
+          if (command.credits === 0)
+            throw new Error("Reservation must be positive");
+          if (await tx.reservation(command.reservationId))
+            throw new Error("Credit reservation already exists");
+          if (availableCredits(account) < command.credits)
+            throw new Error("Insufficient credits");
+          reservation = {
+            id: command.reservationId,
+            periodId: account.periodId,
+            allocation: take(account, command.credits),
+            status: "reserved",
+            charged: null
+          };
+          account.reserved += command.credits;
+          break;
+        case "settle":
+        case "release": {
+          const held = await tx.reservation(command.reservationId);
+          if (!held || held.status !== "reserved")
+            throw new Error("Credit reservation is not active");
+          const total = allocationTotal(held.allocation);
+          const charged = command.kind === "settle" ? command.credits : 0;
+          if (charged > total)
+            throw new Error("Charge exceeds reserved credits");
+          let refund = total - charged;
+          for (const [bucket, key] of [
+            ["purchased", "purchasedRemaining"],
+            ["promotional", "promotionalRemaining"],
+            ["period", "periodRemaining"]
+          ]) {
+            const restored = Math.min(held.allocation[bucket], refund);
+            refund -= restored;
+            if (bucket !== "period" || held.periodId === account.periodId)
+              grant(account, key, restored);
+          }
+          account.reserved -= total;
+          if (held.periodId === account.periodId)
+            account.consumed += charged;
+          reservation = {
+            ...held,
+            status: command.kind === "settle" ? "settled" : "released",
+            charged
+          };
+          break;
+        }
+      }
+      validateCreditAccount(account);
+      const receipt = {
+        command,
+        account,
+        ...reservation ? { reservation } : {}
+      };
+      await tx.save(operationId, receipt);
+      return receipt;
+    });
+  }
+});
+var creditEntitlements = (input) => {
+  const funded = input.prepaidEnabled && input.account !== null && input.account.purchasedRemaining + input.account.promotionalRemaining > 0 && availableCredits(input.account) > 0;
+  return {
+    portal: input.subscribed,
+    mcp: input.subscribed ? "member" : funded ? "prepaid" : "free"
+  };
+};
+export {
+  availableCredits,
+  createCreditAccountLedger,
+  creditEntitlements,
+  migrateLegacyCreditAccount,
+  validateCreditAccount
+};
+
+//# debugId=79D819ADA24F0F9A64756E2164756E21
+//# sourceMappingURL=prepaid.js.map

package/dist/prepaid.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/prepaid.ts"],
+  "sourcesContent": [
+    "/** Service-credit accounting. Host authorization and payment verification happen\n * before these commands. Every command and its receipt commit in one transaction. */\nexport type CreditAccount = {\n  periodId: string;\n  periodEnd: string | null;\n  periodAllowance: number;\n  periodRemaining: number;\n  purchasedRemaining: number;\n  promotionalRemaining: number;\n  debt: number;\n  reserved: number;\n  consumed: number;\n};\nexport type CreditAllocation = {\n  period: number;\n  purchased: number;\n  promotional: number;\n};\nexport type CreditReservation = {\n  id: string;\n  periodId: string;\n  allocation: CreditAllocation;\n  status: \"reserved\" | \"settled\" | \"released\";\n  charged: number | null;\n};\nexport type CreditCommand =\n  | { kind: \"grant\"; bucket: \"purchased\" | \"promotional\"; credits: number }\n  | { kind: \"reverse\"; bucket: \"purchased\" | \"promotional\"; credits: number }\n  | {\n      kind: \"period\";\n      periodId: string;\n      periodEnd: string | null;\n      allowance: number;\n    }\n  | { kind: \"reserve\"; reservationId: string; credits: number }\n  | { kind: \"settle\"; reservationId: string; credits: number }\n  | { kind: \"release\"; reservationId: string }\n  | { kind: \"debit\"; credits: number; allowDebt?: boolean; reference?: string };\nexport type CreditReceipt = {\n  command: CreditCommand;\n  account: CreditAccount;\n  reservation?: CreditReservation;\n};\nexport type CreditTransaction = {\n  account: CreditAccount;\n  receipt: (operationId: string) => Promise<CreditReceipt | null>;\n  reservation: (id: string) => Promise<CreditReservation | null>;\n  save: (operationId: string, receipt: CreditReceipt) => Promise<void>;\n};\nexport type CreditAccountStore = {\n  /** Persist seed once. Never overwrite an existing account. */\n  initialize: (accountId: string, seed: CreditAccount) => Promise<void>;\n  read: (accountId: string) => Promise<CreditAccount | null>;\n  /** Lock one account, serialize its commands across processes, and roll back\n   * account, reservation and receipt together if the callback fails. */\n  transaction: <T>(\n    accountId: string,\n    run: (tx: CreditTransaction) => Promise<T>,\n  ) => Promise<T>;\n};\nconst integer = (value: number) => {\n  if (!Number.isSafeInteger(value) || value < 0)\n    throw new Error(\"Credits must be nonnegative safe integers\");\n  return value;\n};\nconst periodIdentity = (value: string) => {\n  if (\n    !Number.isFinite(Date.parse(value)) ||\n    new Date(value).toISOString() !== value\n  )\n    throw new Error(\"Credit period ID must be an ISO UTC start timestamp\");\n  return value;\n};\nconst identity = (value: string) => {\n  if (!value || value.length > 256)\n    throw new Error(\"Credit identity is invalid\");\n  return value;\n};\nexport const validateCreditAccount = (account: CreditAccount) => {\n  periodIdentity(account.periodId);\n  if (\n    account.periodEnd !== null &&\n    periodIdentity(account.periodEnd) <= account.periodId\n  )\n    throw new Error(\"Credit period end must follow its start\");\n  for (const key of [\n    \"periodAllowance\",\n    \"periodRemaining\",\n    \"purchasedRemaining\",\n    \"promotionalRemaining\",\n    \"debt\",\n    \"reserved\",\n    \"consumed\",\n  ] as const)\n    integer(account[key]);\n  integer(\n    account.periodRemaining +\n      account.purchasedRemaining +\n      account.promotionalRemaining,\n  );\n  if (account.periodRemaining > account.periodAllowance)\n    throw new Error(\"Period balance exceeds its allowance\");\n};\nexport const availableCredits = (account: CreditAccount) =>\n  Math.max(\n    0,\n    account.periodRemaining +\n      account.purchasedRemaining +\n      account.promotionalRemaining -\n      account.debt,\n  );\n\n/** Preserve the currently observable legacy balance without inventing purchase\n * provenance. Historical mixed bonus grants remain promotional carryover. */\nexport const migrateLegacyCreditAccount = (input: {\n  periodId: string;\n  periodEnd?: string | null;\n  periodAllowance: number;\n  bonusCredits: number;\n  consumed: number;\n}): CreditAccount => {\n  integer(input.periodAllowance);\n  integer(input.consumed);\n  if (!Number.isSafeInteger(input.bonusCredits))\n    throw new Error(\"Invalid legacy bonus credits\");\n  const account: CreditAccount = {\n    periodId: input.periodId,\n    periodEnd: input.periodEnd ?? null,\n    periodAllowance: input.periodAllowance,\n    periodRemaining: Math.max(0, input.periodAllowance - input.consumed),\n    purchasedRemaining: 0,\n    promotionalRemaining: Math.max(\n      0,\n      input.bonusCredits - Math.max(0, input.consumed - input.periodAllowance),\n    ),\n    debt:\n      Math.max(0, -input.bonusCredits) +\n      Math.max(\n        0,\n        input.consumed -\n          input.periodAllowance -\n          Math.max(0, input.bonusCredits),\n      ),\n    reserved: 0,\n    consumed: input.consumed,\n  };\n  validateCreditAccount(account);\n  return account;\n};\nconst allocationTotal = (value: CreditAllocation) =>\n  value.period + value.promotional + value.purchased;\nconst take = (account: CreditAccount, credits: number): CreditAllocation => {\n  // A reversal liability consumes existing available credits exactly once.\n  let owed = account.debt;\n  for (const key of [\n    \"periodRemaining\",\n    \"promotionalRemaining\",\n    \"purchasedRemaining\",\n  ] as const) {\n    const covered = Math.min(account[key], owed);\n    account[key] -= covered;\n    owed -= covered;\n  }\n  account.debt = owed;\n  const period = Math.min(account.periodRemaining, credits);\n  const promotional = Math.min(account.promotionalRemaining, credits - period);\n  const purchased = Math.min(\n    account.purchasedRemaining,\n    credits - period - promotional,\n  );\n  account.periodRemaining -= period;\n  account.promotionalRemaining -= promotional;\n  account.purchasedRemaining -= purchased;\n  return { period, promotional, purchased };\n};\nconst grant = (\n  account: CreditAccount,\n  key: \"periodRemaining\" | \"purchasedRemaining\" | \"promotionalRemaining\",\n  credits: number,\n) => {\n  const covered = Math.min(account.debt, credits);\n  account.debt -= covered;\n  account[key] = integer(account[key] + credits - covered);\n};\nconst normalize = (command: CreditCommand): CreditCommand => {\n  switch (command.kind) {\n    case \"grant\":\n    case \"reverse\":\n      if (command.bucket !== \"purchased\" && command.bucket !== \"promotional\")\n        throw new Error(\"Invalid credit bucket\");\n      return {\n        kind: command.kind,\n        bucket: command.bucket,\n        credits: integer(command.credits),\n      };\n    case \"period\":\n      return {\n        kind: command.kind,\n        periodId: periodIdentity(command.periodId),\n        periodEnd:\n          command.periodEnd === null ? null : periodIdentity(command.periodEnd),\n        allowance: integer(command.allowance),\n      };\n    case \"reserve\":\n    case \"settle\":\n      return {\n        kind: command.kind,\n        reservationId: identity(command.reservationId),\n        credits: integer(command.credits),\n      };\n    case \"release\":\n      return {\n        kind: command.kind,\n        reservationId: identity(command.reservationId),\n      };\n    case \"debit\":\n      return {\n        kind: command.kind,\n        credits: integer(command.credits),\n        allowDebt: command.allowDebt === true,\n        ...(command.reference === undefined\n          ? {}\n          : { reference: identity(command.reference) }),\n      };\n    default:\n      throw new Error(\"Invalid credit command\");\n  }\n};\nexport const createCreditAccountLedger = (store: CreditAccountStore) => ({\n  initialize: async (accountId: string, seed: CreditAccount) => {\n    identity(accountId);\n    validateCreditAccount(seed);\n    await store.initialize(accountId, seed);\n  },\n  receipt: (accountId: string, operationId: string) =>\n    store.transaction(identity(accountId), (tx) =>\n      tx.receipt(identity(operationId)),\n    ),\n  balance: (accountId: string) => store.read(identity(accountId)),\n  execute: async (\n    accountId: string,\n    operationId: string,\n    input: CreditCommand,\n  ): Promise<CreditReceipt> => {\n    identity(accountId);\n    identity(operationId);\n    const command = normalize(input);\n    return store.transaction(accountId, async (tx) => {\n      const previous = await tx.receipt(operationId);\n      if (previous) {\n        if (\n          JSON.stringify(normalize(previous.command)) !==\n          JSON.stringify(command)\n        )\n          throw new Error(\"Credit operation ID reused with different input\");\n        return previous;\n      }\n      const account = { ...tx.account };\n      validateCreditAccount(account);\n      let reservation: CreditReservation | undefined;\n      switch (command.kind) {\n        case \"grant\":\n          grant(\n            account,\n            command.bucket === \"purchased\"\n              ? \"purchasedRemaining\"\n              : \"promotionalRemaining\",\n            command.credits,\n          );\n          break;\n        case \"reverse\": {\n          const key =\n            command.bucket === \"purchased\"\n              ? \"purchasedRemaining\"\n              : \"promotionalRemaining\";\n          const covered = Math.min(account[key], command.credits);\n          account[key] -= covered;\n          account.debt += command.credits - covered;\n          break;\n        }\n        case \"period\":\n          if (command.periodId < account.periodId)\n            throw new Error(\"Credit period cannot move backwards\");\n          if (command.periodId === account.periodId) {\n            // Upgrades add only the increase. Downgrades take effect next period.\n            const increase = Math.max(\n              0,\n              command.allowance - account.periodAllowance,\n            );\n            if (account.periodEnd === null)\n              account.periodEnd = command.periodEnd;\n            account.periodAllowance += increase;\n            grant(account, \"periodRemaining\", increase);\n          } else {\n            account.periodId = command.periodId;\n            account.periodEnd = command.periodEnd;\n            account.periodAllowance = command.allowance;\n            account.periodRemaining = 0;\n            account.consumed = 0;\n            grant(account, \"periodRemaining\", command.allowance);\n          }\n          break;\n        case \"debit\": {\n          if (!command.allowDebt && availableCredits(account) < command.credits)\n            throw new Error(\"Insufficient credits\");\n          const used = allocationTotal(take(account, command.credits));\n          account.debt += command.credits - used;\n          account.consumed += command.credits;\n          break;\n        }\n        case \"reserve\":\n          if (command.credits === 0)\n            throw new Error(\"Reservation must be positive\");\n          if (await tx.reservation(command.reservationId))\n            throw new Error(\"Credit reservation already exists\");\n          if (availableCredits(account) < command.credits)\n            throw new Error(\"Insufficient credits\");\n          reservation = {\n            id: command.reservationId,\n            periodId: account.periodId,\n            allocation: take(account, command.credits),\n            status: \"reserved\",\n            charged: null,\n          };\n          account.reserved += command.credits;\n          break;\n        case \"settle\":\n        case \"release\": {\n          const held = await tx.reservation(command.reservationId);\n          if (!held || held.status !== \"reserved\")\n            throw new Error(\"Credit reservation is not active\");\n          const total = allocationTotal(held.allocation);\n          const charged = command.kind === \"settle\" ? command.credits : 0;\n          if (charged > total)\n            throw new Error(\"Charge exceeds reserved credits\");\n          let refund = total - charged;\n          for (const [bucket, key] of [\n            [\"purchased\", \"purchasedRemaining\"],\n            [\"promotional\", \"promotionalRemaining\"],\n            [\"period\", \"periodRemaining\"],\n          ] as const) {\n            const restored = Math.min(held.allocation[bucket], refund);\n            refund -= restored;\n            if (bucket !== \"period\" || held.periodId === account.periodId)\n              grant(account, key, restored);\n          }\n          account.reserved -= total;\n          if (held.periodId === account.periodId) account.consumed += charged;\n          reservation = {\n            ...held,\n            status: command.kind === \"settle\" ? \"settled\" : \"released\",\n            charged,\n          };\n          break;\n        }\n      }\n      validateCreditAccount(account);\n      const receipt: CreditReceipt = {\n        command,\n        account,\n        ...(reservation ? { reservation } : {}),\n      };\n      await tx.save(operationId, receipt);\n      return receipt;\n    });\n  },\n});\n\n/** Portal access and funded MCP access are independent. Period-only free\n * allowances do not silently unlock prepaid work; carryover grants may. */\nexport const creditEntitlements = (input: {\n  subscribed: boolean;\n  prepaidEnabled: boolean;\n  account: CreditAccount | null;\n}) => {\n  const funded =\n    input.prepaidEnabled &&\n    input.account !== null &&\n    input.account.purchasedRemaining + input.account.promotionalRemaining > 0 &&\n    availableCredits(input.account) > 0;\n  return {\n    portal: input.subscribed,\n    mcp: input.subscribed\n      ? (\"member\" as const)\n      : funded\n        ? (\"prepaid\" as const)\n        : (\"free\" as const),\n  };\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "79D819ADA24F0F9A64756E2164756E21",
+  "names": []
+}

package/dist/prepaidPostgres.d.ts

@@ -0,0 +1,11 @@
+import { type CreditAccountStore } from "./prepaid";
+export type CreditSql = {
+    query: (query: string, parameters: readonly unknown[]) => Promise<{
+        rows: Record<string, unknown>[];
+    }>;
+};
+export type CreditSqlClient = CreditSql & {
+    transaction: <T>(run: (sql: CreditSql) => Promise<T>) => Promise<T>;
+};
+export declare const creditAccountPostgresSchemaSql: (schema?: string) => string;
+export declare const createPostgresCreditAccountStore: (client: CreditSqlClient, schema?: string) => CreditAccountStore;