@absolutejs/billing 0.5.0 → 0.7.0

package/dist/creditWork.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/prepaid.ts", "../src/prepaidPostgres.ts", "../src/creditWork.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",
+    "import {\n  validateCreditAccount,\n  type CreditAccount,\n  type CreditAccountStore,\n  type CreditReceipt,\n  type CreditReservation,\n} from \"./prepaid\";\nexport type CreditSql = {\n  query: (\n    query: string,\n    parameters: readonly unknown[],\n  ) => Promise<{ rows: Record<string, unknown>[] }>;\n};\nexport type CreditSqlClient = CreditSql & {\n  transaction: <T>(run: (sql: CreditSql) => Promise<T>) => Promise<T>;\n};\nconst namespace = (value: string) => {\n  if (!/^[a-z][a-z0-9_]*$/.test(value))\n    throw new Error(\"Invalid credit schema name\");\n  return value;\n};\nexport const creditAccountPostgresSchemaSql = (schema = \"billing_credits\") => {\n  const n = namespace(schema);\n  return `CREATE SCHEMA IF NOT EXISTS ${n};\nCREATE TABLE IF NOT EXISTS ${n}.accounts (\n  account_id text PRIMARY KEY, state jsonb NOT NULL, initial_state jsonb NOT NULL,\n  created_at timestamptz NOT NULL DEFAULT now(), updated_at timestamptz NOT NULL DEFAULT now()\n);\nCREATE TABLE IF NOT EXISTS ${n}.operations (\n  account_id text NOT NULL REFERENCES ${n}.accounts(account_id), operation_id text NOT NULL,\n  receipt jsonb NOT NULL, created_at timestamptz NOT NULL DEFAULT now(), PRIMARY KEY (account_id, operation_id)\n);\nCREATE TABLE IF NOT EXISTS ${n}.reservations (\n  account_id text NOT NULL REFERENCES ${n}.accounts(account_id), reservation_id text NOT NULL,\n  state jsonb NOT NULL, updated_at timestamptz NOT NULL DEFAULT now(), PRIMARY KEY (account_id, reservation_id)\n);`;\n};\nexport const createPostgresCreditAccountStore = (\n  client: CreditSqlClient,\n  schema = \"billing_credits\",\n): CreditAccountStore => {\n  const n = namespace(schema);\n  const read = async (sql: CreditSql, accountId: string, lock = false) => {\n    const { rows } = await sql.query(\n      `SELECT state FROM ${n}.accounts WHERE account_id = $1${lock ? \" FOR UPDATE\" : \"\"}`,\n      [accountId],\n    );\n    if (!rows[0]) return null;\n    const state = rows[0].state as CreditAccount;\n    validateCreditAccount(state);\n    return state;\n  };\n  return {\n    initialize: async (accountId, seed) => {\n      validateCreditAccount(seed);\n      await client.query(\n        `INSERT INTO ${n}.accounts (account_id, state, initial_state) VALUES ($1, $2::jsonb, $2::jsonb) ON CONFLICT DO NOTHING`,\n        [accountId, JSON.stringify(seed)],\n      );\n    },\n    read: (accountId) => read(client, accountId),\n    transaction: (accountId, run) =>\n      client.transaction(async (sql) => {\n        const account = await read(sql, accountId, true);\n        if (!account) throw new Error(\"Credit account is not initialized\");\n        return run({\n          account,\n          receipt: async (operationId) => {\n            const { rows } = await sql.query(\n              `SELECT receipt FROM ${n}.operations WHERE account_id = $1 AND operation_id = $2`,\n              [accountId, operationId],\n            );\n            return (rows[0]?.receipt as CreditReceipt | undefined) ?? null;\n          },\n          reservation: async (id) => {\n            const { rows } = await sql.query(\n              `SELECT state FROM ${n}.reservations WHERE account_id = $1 AND reservation_id = $2`,\n              [accountId, id],\n            );\n            return (rows[0]?.state as CreditReservation | undefined) ?? null;\n          },\n          save: async (operationId, receipt) => {\n            await sql.query(\n              `UPDATE ${n}.accounts SET state = $2::jsonb, updated_at = now() WHERE account_id = $1`,\n              [accountId, JSON.stringify(receipt.account)],\n            );\n            if (receipt.reservation)\n              await sql.query(\n                `INSERT INTO ${n}.reservations (account_id, reservation_id, state) VALUES ($1, $2, $3::jsonb) ON CONFLICT (account_id, reservation_id) DO UPDATE SET state = EXCLUDED.state, updated_at = now()`,\n                [\n                  accountId,\n                  receipt.reservation.id,\n                  JSON.stringify(receipt.reservation),\n                ],\n              );\n            await sql.query(\n              `INSERT INTO ${n}.operations (account_id, operation_id, receipt) VALUES ($1, $2, $3::jsonb)`,\n              [accountId, operationId, JSON.stringify(receipt)],\n            );\n          },\n        });\n      }),\n  };\n};\n",
+    "import { createCreditAccountLedger } from \"./prepaid\";\nimport {\n  createPostgresCreditAccountStore,\n  type CreditSql,\n  type CreditSqlClient,\n} from \"./prepaidPostgres\";\nexport type CreditWork = {\n  request: string;\n  budget: number;\n  charged: number;\n  absorbed: number;\n  status: \"running\" | \"completed\" | \"failed\";\n  result: string | null;\n};\nconst namespace = (value: string) => {\n  if (!/^[a-z][a-z0-9_]*$/.test(value))\n    throw new Error(\"Invalid credit schema name\");\n  return value;\n};\nconst id = (value: string) => {\n  if (!value || value.length > 128) throw new Error(\"Invalid credit work ID\");\n};\nconst integer = (value: number) => {\n  if (!Number.isSafeInteger(value) || value < 0)\n    throw new Error(\"Invalid credit work amount\");\n};\nexport const creditWorkPostgresSchemaSql = (schema = \"billing_credits\") => {\n  const n = namespace(schema);\n  return `CREATE TABLE IF NOT EXISTS ${n}.work (\n    account_id text NOT NULL REFERENCES ${n}.accounts(account_id), work_id text NOT NULL,\n    state jsonb NOT NULL, created_at timestamptz NOT NULL DEFAULT now(), updated_at timestamptz NOT NULL DEFAULT now(),\n    PRIMARY KEY(account_id, work_id)\n  );\n  CREATE TABLE IF NOT EXISTS ${n}.work_usage (\n    account_id text NOT NULL, work_id text NOT NULL, event_id text NOT NULL,\n    credits bigint NOT NULL CHECK (credits >= 0), charged bigint NOT NULL CHECK (charged >= 0 AND charged <= credits), reference text NOT NULL,\n    PRIMARY KEY(account_id, work_id, event_id), FOREIGN KEY(account_id, work_id) REFERENCES ${n}.work(account_id, work_id)\n  );`;\n};\n/** Durable execution claim + capped customer charge. A crash leaves work running\n * and its credits held: never automatically rerun an uncertain external effect.\n * Provider cost over the agreed budget is recorded as absorbed, not customer debt. */\nexport const createPostgresCreditWork = (\n  client: CreditSqlClient,\n  schema = \"billing_credits\",\n) => {\n  const n = namespace(schema);\n  const read = async (sql: CreditSql, accountId: string, workId: string) => {\n    const { rows } = await sql.query(\n      `SELECT state FROM ${n}.work WHERE account_id = $1 AND work_id = $2 FOR UPDATE`,\n      [accountId, workId],\n    );\n    return rows[0]?.state as CreditWork | undefined;\n  };\n  const save = (\n    sql: CreditSql,\n    accountId: string,\n    workId: string,\n    state: CreditWork,\n  ) =>\n    sql.query(\n      `UPDATE ${n}.work SET state = $3::jsonb, updated_at = now() WHERE account_id = $1 AND work_id = $2`,\n      [accountId, workId, JSON.stringify(state)],\n    );\n  const ledger = (sql: CreditSql) =>\n    createCreditAccountLedger(\n      createPostgresCreditAccountStore(\n        { ...sql, transaction: (run) => run(sql) },\n        schema,\n      ),\n    );\n  return {\n    get: (accountId: string, workId: string) => {\n      id(accountId);\n      id(workId);\n      return client.transaction(\n        async (sql) => (await read(sql, accountId, workId)) ?? null,\n      );\n    },\n    begin: (\n      accountId: string,\n      workId: string,\n      request: string,\n      budget: number,\n    ) => {\n      id(accountId);\n      id(workId);\n      integer(budget);\n      if (!budget || !request || request.length > 256)\n        throw new Error(\"Invalid credit work request\");\n      return client.transaction(async (sql) => {\n        // One account lock serializes competing claims, including absent work rows.\n        await sql.query(\n          `SELECT account_id FROM ${n}.accounts WHERE account_id = $1 FOR UPDATE`,\n          [accountId],\n        );\n        const existing = await read(sql, accountId, workId);\n        if (existing) {\n          if (existing.request !== request || existing.budget !== budget)\n            throw new Error(\"Credit work ID reused with different input\");\n          return { fresh: false, work: existing };\n        }\n        await ledger(sql).execute(accountId, `work-reserve:${workId}`, {\n          kind: \"reserve\",\n          reservationId: `work:${workId}`,\n          credits: budget,\n        });\n        const work: CreditWork = {\n          request,\n          budget,\n          charged: 0,\n          absorbed: 0,\n          status: \"running\",\n          result: null,\n        };\n        await sql.query(\n          `INSERT INTO ${n}.work (account_id, work_id, state) VALUES ($1, $2, $3::jsonb)`,\n          [accountId, workId, JSON.stringify(work)],\n        );\n        return { fresh: true, work };\n      });\n    },\n    record: (\n      accountId: string,\n      workId: string,\n      eventId: string,\n      credits: number,\n      reference: string,\n    ) => {\n      id(accountId);\n      id(workId);\n      id(eventId);\n      integer(credits);\n      id(reference);\n      return client.transaction(async (sql) => {\n        const work = await read(sql, accountId, workId);\n        if (!work) throw new Error(\"Credit work does not exist\");\n        const { rows } = await sql.query(\n          `SELECT credits, charged, reference FROM ${n}.work_usage WHERE account_id = $1 AND work_id = $2 AND event_id = $3`,\n          [accountId, workId, eventId],\n        );\n        const previous = rows[0];\n        if (previous) {\n          if (\n            Number(previous.credits) !== credits ||\n            previous.reference !== reference\n          )\n            throw new Error(\"Credit work event reused with different input\");\n          return { charged: Number(previous.charged), fresh: false };\n        }\n        if (work.status !== \"running\")\n          throw new Error(\"Credit work already finished\");\n        const charged = Math.min(credits, work.budget - work.charged);\n        work.charged += charged;\n        work.absorbed += credits - charged;\n        integer(work.charged);\n        integer(work.absorbed);\n        await sql.query(\n          `INSERT INTO ${n}.work_usage (account_id, work_id, event_id, credits, charged, reference) VALUES ($1, $2, $3, $4, $5, $6)`,\n          [accountId, workId, eventId, credits, charged, reference],\n        );\n        await save(sql, accountId, workId, work);\n        return { charged, fresh: true };\n      });\n    },\n    finish: (\n      accountId: string,\n      workId: string,\n      result: string,\n      failed = false,\n    ) => {\n      id(accountId);\n      id(workId);\n      return client.transaction(async (sql) => {\n        // Match begin's account -> work lock order to avoid a retry/finalize deadlock.\n        await sql.query(\n          `SELECT account_id FROM ${n}.accounts WHERE account_id = $1 FOR UPDATE`,\n          [accountId],\n        );\n        const work = await read(sql, accountId, workId);\n        if (!work) throw new Error(\"Credit work does not exist\");\n        if (work.status !== \"running\") return work;\n        await ledger(sql).execute(accountId, `work-settle:${workId}`, {\n          kind: \"settle\",\n          reservationId: `work:${workId}`,\n          credits: work.charged,\n        });\n        work.status = failed ? \"failed\" : \"completed\";\n        work.result = result;\n        await save(sql, accountId, workId, work);\n        return work;\n      });\n    },\n  };\n};\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;AA4DA,IAAM,UAAU,CAAC,UAAkB;AAAA,EACjC,IAAI,CAAC,OAAO,cAAc,KAAK,KAAK,QAAQ;AAAA,IAC1C,MAAM,IAAI,MAAM,2CAA2C;AAAA,EAC7D,OAAO;AAAA;AAET,IAAM,iBAAiB,CAAC,UAAkB;AAAA,EACxC,IACE,CAAC,OAAO,SAAS,KAAK,MAAM,KAAK,CAAC,KAClC,IAAI,KAAK,KAAK,EAAE,YAAY,MAAM;AAAA,IAElC,MAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE,OAAO;AAAA;AAET,IAAM,WAAW,CAAC,UAAkB;AAAA,EAClC,IAAI,CAAC,SAAS,MAAM,SAAS;AAAA,IAC3B,MAAM,IAAI,MAAM,4BAA4B;AAAA,EAC9C,OAAO;AAAA;AAEF,IAAM,wBAAwB,CAAC,YAA2B;AAAA,EAC/D,eAAe,QAAQ,QAAQ;AAAA,EAC/B,IACE,QAAQ,cAAc,QACtB,eAAe,QAAQ,SAAS,KAAK,QAAQ;AAAA,IAE7C,MAAM,IAAI,MAAM,yCAAyC;AAAA,EAC3D,WAAW,OAAO;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,IACE,QAAQ,QAAQ,IAAI;AAAA,EACtB,QACE,QAAQ,kBACN,QAAQ,qBACR,QAAQ,oBACZ;AAAA,EACA,IAAI,QAAQ,kBAAkB,QAAQ;AAAA,IACpC,MAAM,IAAI,MAAM,sCAAsC;AAAA;AAEnD,IAAM,mBAAmB,CAAC,YAC/B,KAAK,IACH,GACA,QAAQ,kBACN,QAAQ,qBACR,QAAQ,uBACR,QAAQ,IACZ;AAIK,IAAM,6BAA6B,CAAC,UAMtB;AAAA,EACnB,QAAQ,MAAM,eAAe;AAAA,EAC7B,QAAQ,MAAM,QAAQ;AAAA,EACtB,IAAI,CAAC,OAAO,cAAc,MAAM,YAAY;AAAA,IAC1C,MAAM,IAAI,MAAM,8BAA8B;AAAA,EAChD,MAAM,UAAyB;AAAA,IAC7B,UAAU,MAAM;AAAA,IAChB,WAAW,MAAM,aAAa;AAAA,IAC9B,iBAAiB,MAAM;AAAA,IACvB,iBAAiB,KAAK,IAAI,GAAG,MAAM,kBAAkB,MAAM,QAAQ;AAAA,IACnE,oBAAoB;AAAA,IACpB,sBAAsB,KAAK,IACzB,GACA,MAAM,eAAe,KAAK,IAAI,GAAG,MAAM,WAAW,MAAM,eAAe,CACzE;AAAA,IACA,MACE,KAAK,IAAI,GAAG,CAAC,MAAM,YAAY,IAC/B,KAAK,IACH,GACA,MAAM,WACJ,MAAM,kBACN,KAAK,IAAI,GAAG,MAAM,YAAY,CAClC;AAAA,IACF,UAAU;AAAA,IACV,UAAU,MAAM;AAAA,EAClB;AAAA,EACA,sBAAsB,OAAO;AAAA,EAC7B,OAAO;AAAA;AAET,IAAM,kBAAkB,CAAC,UACvB,MAAM,SAAS,MAAM,cAAc,MAAM;AAC3C,IAAM,OAAO,CAAC,SAAwB,YAAsC;AAAA,EAE1E,IAAI,OAAO,QAAQ;AAAA,EACnB,WAAW,OAAO;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAAY;AAAA,IACV,MAAM,UAAU,KAAK,IAAI,QAAQ,MAAM,IAAI;AAAA,IAC3C,QAAQ,QAAQ;AAAA,IAChB,QAAQ;AAAA,EACV;AAAA,EACA,QAAQ,OAAO;AAAA,EACf,MAAM,SAAS,KAAK,IAAI,QAAQ,iBAAiB,OAAO;AAAA,EACxD,MAAM,cAAc,KAAK,IAAI,QAAQ,sBAAsB,UAAU,MAAM;AAAA,EAC3E,MAAM,YAAY,KAAK,IACrB,QAAQ,oBACR,UAAU,SAAS,WACrB;AAAA,EACA,QAAQ,mBAAmB;AAAA,EAC3B,QAAQ,wBAAwB;AAAA,EAChC,QAAQ,sBAAsB;AAAA,EAC9B,OAAO,EAAE,QAAQ,aAAa,UAAU;AAAA;AAE1C,IAAM,QAAQ,CACZ,SACA,KACA,YACG;AAAA,EACH,MAAM,UAAU,KAAK,IAAI,QAAQ,MAAM,OAAO;AAAA,EAC9C,QAAQ,QAAQ;AAAA,EAChB,QAAQ,OAAO,QAAQ,QAAQ,OAAO,UAAU,OAAO;AAAA;AAEzD,IAAM,YAAY,CAAC,YAA0C;AAAA,EAC3D,QAAQ,QAAQ;AAAA,SACT;AAAA,SACA;AAAA,MACH,IAAI,QAAQ,WAAW,eAAe,QAAQ,WAAW;AAAA,QACvD,MAAM,IAAI,MAAM,uBAAuB;AAAA,MACzC,OAAO;AAAA,QACL,MAAM,QAAQ;AAAA,QACd,QAAQ,QAAQ;AAAA,QAChB,SAAS,QAAQ,QAAQ,OAAO;AAAA,MAClC;AAAA,SACG;AAAA,MACH,OAAO;AAAA,QACL,MAAM,QAAQ;AAAA,QACd,UAAU,eAAe,QAAQ,QAAQ;AAAA,QACzC,WACE,QAAQ,cAAc,OAAO,OAAO,eAAe,QAAQ,SAAS;AAAA,QACtE,WAAW,QAAQ,QAAQ,SAAS;AAAA,MACtC;AAAA,SACG;AAAA,SACA;AAAA,MACH,OAAO;AAAA,QACL,MAAM,QAAQ;AAAA,QACd,eAAe,SAAS,QAAQ,aAAa;AAAA,QAC7C,SAAS,QAAQ,QAAQ,OAAO;AAAA,MAClC;AAAA,SACG;AAAA,MACH,OAAO;AAAA,QACL,MAAM,QAAQ;AAAA,QACd,eAAe,SAAS,QAAQ,aAAa;AAAA,MAC/C;AAAA,SACG;AAAA,MACH,OAAO;AAAA,QACL,MAAM,QAAQ;AAAA,QACd,SAAS,QAAQ,QAAQ,OAAO;AAAA,QAChC,WAAW,QAAQ,cAAc;AAAA,WAC7B,QAAQ,cAAc,YACtB,CAAC,IACD,EAAE,WAAW,SAAS,QAAQ,SAAS,EAAE;AAAA,MAC/C;AAAA;AAAA,MAEA,MAAM,IAAI,MAAM,wBAAwB;AAAA;AAAA;AAGvC,IAAM,4BAA4B,CAAC,WAA+B;AAAA,EACvE,YAAY,OAAO,WAAmB,SAAwB;AAAA,IAC5D,SAAS,SAAS;AAAA,IAClB,sBAAsB,IAAI;AAAA,IAC1B,MAAM,MAAM,WAAW,WAAW,IAAI;AAAA;AAAA,EAExC,SAAS,CAAC,WAAmB,gBAC3B,MAAM,YAAY,SAAS,SAAS,GAAG,CAAC,OACtC,GAAG,QAAQ,SAAS,WAAW,CAAC,CAClC;AAAA,EACF,SAAS,CAAC,cAAsB,MAAM,KAAK,SAAS,SAAS,CAAC;AAAA,EAC9D,SAAS,OACP,WACA,aACA,UAC2B;AAAA,IAC3B,SAAS,SAAS;AAAA,IAClB,SAAS,WAAW;AAAA,IACpB,MAAM,UAAU,UAAU,KAAK;AAAA,IAC/B,OAAO,MAAM,YAAY,WAAW,OAAO,OAAO;AAAA,MAChD,MAAM,WAAW,MAAM,GAAG,QAAQ,WAAW;AAAA,MAC7C,IAAI,UAAU;AAAA,QACZ,IACE,KAAK,UAAU,UAAU,SAAS,OAAO,CAAC,MAC1C,KAAK,UAAU,OAAO;AAAA,UAEtB,MAAM,IAAI,MAAM,iDAAiD;AAAA,QACnE,OAAO;AAAA,MACT;AAAA,MACA,MAAM,UAAU,KAAK,GAAG,QAAQ;AAAA,MAChC,sBAAsB,OAAO;AAAA,MAC7B,IAAI;AAAA,MACJ,QAAQ,QAAQ;AAAA,aACT;AAAA,UACH,MACE,SACA,QAAQ,WAAW,cACf,uBACA,wBACJ,QAAQ,OACV;AAAA,UACA;AAAA,aACG,WAAW;AAAA,UACd,MAAM,MACJ,QAAQ,WAAW,cACf,uBACA;AAAA,UACN,MAAM,UAAU,KAAK,IAAI,QAAQ,MAAM,QAAQ,OAAO;AAAA,UACtD,QAAQ,QAAQ;AAAA,UAChB,QAAQ,QAAQ,QAAQ,UAAU;AAAA,UAClC;AAAA,QACF;AAAA,aACK;AAAA,UACH,IAAI,QAAQ,WAAW,QAAQ;AAAA,YAC7B,MAAM,IAAI,MAAM,qCAAqC;AAAA,UACvD,IAAI,QAAQ,aAAa,QAAQ,UAAU;AAAA,YAEzC,MAAM,WAAW,KAAK,IACpB,GACA,QAAQ,YAAY,QAAQ,eAC9B;AAAA,YACA,IAAI,QAAQ,cAAc;AAAA,cACxB,QAAQ,YAAY,QAAQ;AAAA,YAC9B,QAAQ,mBAAmB;AAAA,YAC3B,MAAM,SAAS,mBAAmB,QAAQ;AAAA,UAC5C,EAAO;AAAA,YACL,QAAQ,WAAW,QAAQ;AAAA,YAC3B,QAAQ,YAAY,QAAQ;AAAA,YAC5B,QAAQ,kBAAkB,QAAQ;AAAA,YAClC,QAAQ,kBAAkB;AAAA,YAC1B,QAAQ,WAAW;AAAA,YACnB,MAAM,SAAS,mBAAmB,QAAQ,SAAS;AAAA;AAAA,UAErD;AAAA,aACG,SAAS;AAAA,UACZ,IAAI,CAAC,QAAQ,aAAa,iBAAiB,OAAO,IAAI,QAAQ;AAAA,YAC5D,MAAM,IAAI,MAAM,sBAAsB;AAAA,UACxC,MAAM,OAAO,gBAAgB,KAAK,SAAS,QAAQ,OAAO,CAAC;AAAA,UAC3D,QAAQ,QAAQ,QAAQ,UAAU;AAAA,UAClC,QAAQ,YAAY,QAAQ;AAAA,UAC5B;AAAA,QACF;AAAA,aACK;AAAA,UACH,IAAI,QAAQ,YAAY;AAAA,YACtB,MAAM,IAAI,MAAM,8BAA8B;AAAA,UAChD,IAAI,MAAM,GAAG,YAAY,QAAQ,aAAa;AAAA,YAC5C,MAAM,IAAI,MAAM,mCAAmC;AAAA,UACrD,IAAI,iBAAiB,OAAO,IAAI,QAAQ;AAAA,YACtC,MAAM,IAAI,MAAM,sBAAsB;AAAA,UACxC,cAAc;AAAA,YACZ,IAAI,QAAQ;AAAA,YACZ,UAAU,QAAQ;AAAA,YAClB,YAAY,KAAK,SAAS,QAAQ,OAAO;AAAA,YACzC,QAAQ;AAAA,YACR,SAAS;AAAA,UACX;AAAA,UACA,QAAQ,YAAY,QAAQ;AAAA,UAC5B;AAAA,aACG;AAAA,aACA,WAAW;AAAA,UACd,MAAM,OAAO,MAAM,GAAG,YAAY,QAAQ,aAAa;AAAA,UACvD,IAAI,CAAC,QAAQ,KAAK,WAAW;AAAA,YAC3B,MAAM,IAAI,MAAM,kCAAkC;AAAA,UACpD,MAAM,QAAQ,gBAAgB,KAAK,UAAU;AAAA,UAC7C,MAAM,UAAU,QAAQ,SAAS,WAAW,QAAQ,UAAU;AAAA,UAC9D,IAAI,UAAU;AAAA,YACZ,MAAM,IAAI,MAAM,iCAAiC;AAAA,UACnD,IAAI,SAAS,QAAQ;AAAA,UACrB,YAAY,QAAQ,QAAQ;AAAA,YAC1B,CAAC,aAAa,oBAAoB;AAAA,YAClC,CAAC,eAAe,sBAAsB;AAAA,YACtC,CAAC,UAAU,iBAAiB;AAAA,UAC9B,GAAY;AAAA,YACV,MAAM,WAAW,KAAK,IAAI,KAAK,WAAW,SAAS,MAAM;AAAA,YACzD,UAAU;AAAA,YACV,IAAI,WAAW,YAAY,KAAK,aAAa,QAAQ;AAAA,cACnD,MAAM,SAAS,KAAK,QAAQ;AAAA,UAChC;AAAA,UACA,QAAQ,YAAY;AAAA,UACpB,IAAI,KAAK,aAAa,QAAQ;AAAA,YAAU,QAAQ,YAAY;AAAA,UAC5D,cAAc;AAAA,eACT;AAAA,YACH,QAAQ,QAAQ,SAAS,WAAW,YAAY;AAAA,YAChD;AAAA,UACF;AAAA,UACA;AAAA,QACF;AAAA;AAAA,MAEF,sBAAsB,OAAO;AAAA,MAC7B,MAAM,UAAyB;AAAA,QAC7B;AAAA,QACA;AAAA,WACI,cAAc,EAAE,YAAY,IAAI,CAAC;AAAA,MACvC;AAAA,MACA,MAAM,GAAG,KAAK,aAAa,OAAO;AAAA,MAClC,OAAO;AAAA,KACR;AAAA;AAEL;AAIO,IAAM,qBAAqB,CAAC,UAI7B;AAAA,EACJ,MAAM,SACJ,MAAM,kBACN,MAAM,YAAY,QAClB,MAAM,QAAQ,qBAAqB,MAAM,QAAQ,uBAAuB,KACxE,iBAAiB,MAAM,OAAO,IAAI;AAAA,EACpC,OAAO;AAAA,IACL,QAAQ,MAAM;AAAA,IACd,KAAK,MAAM,aACN,WACD,SACG,YACA;AAAA,EACT;AAAA;;;ACnXF,IAAM,YAAY,CAAC,UAAkB;AAAA,EACnC,IAAI,CAAC,oBAAoB,KAAK,KAAK;AAAA,IACjC,MAAM,IAAI,MAAM,4BAA4B;AAAA,EAC9C,OAAO;AAAA;AAEF,IAAM,iCAAiC,CAAC,SAAS,sBAAsB;AAAA,EAC5E,MAAM,IAAI,UAAU,MAAM;AAAA,EAC1B,OAAO,+BAA+B;AAAA,6BACX;AAAA;AAAA;AAAA;AAAA,6BAIA;AAAA,wCACW;AAAA;AAAA;AAAA,6BAGX;AAAA,wCACW;AAAA;AAAA;AAAA;AAIjC,IAAM,mCAAmC,CAC9C,QACA,SAAS,sBACc;AAAA,EACvB,MAAM,IAAI,UAAU,MAAM;AAAA,EAC1B,MAAM,OAAO,OAAO,KAAgB,WAAmB,OAAO,UAAU;AAAA,IACtE,QAAQ,SAAS,MAAM,IAAI,MACzB,qBAAqB,mCAAmC,OAAO,gBAAgB,MAC/E,CAAC,SAAS,CACZ;AAAA,IACA,IAAI,CAAC,KAAK;AAAA,MAAI,OAAO;AAAA,IACrB,MAAM,QAAQ,KAAK,GAAG;AAAA,IACtB,sBAAsB,KAAK;AAAA,IAC3B,OAAO;AAAA;AAAA,EAET,OAAO;AAAA,IACL,YAAY,OAAO,WAAW,SAAS;AAAA,MACrC,sBAAsB,IAAI;AAAA,MAC1B,MAAM,OAAO,MACX,eAAe,0GACf,CAAC,WAAW,KAAK,UAAU,IAAI,CAAC,CAClC;AAAA;AAAA,IAEF,MAAM,CAAC,cAAc,KAAK,QAAQ,SAAS;AAAA,IAC3C,aAAa,CAAC,WAAW,QACvB,OAAO,YAAY,OAAO,QAAQ;AAAA,MAChC,MAAM,UAAU,MAAM,KAAK,KAAK,WAAW,IAAI;AAAA,MAC/C,IAAI,CAAC;AAAA,QAAS,MAAM,IAAI,MAAM,mCAAmC;AAAA,MACjE,OAAO,IAAI;AAAA,QACT;AAAA,QACA,SAAS,OAAO,gBAAgB;AAAA,UAC9B,QAAQ,SAAS,MAAM,IAAI,MACzB,uBAAuB,4DACvB,CAAC,WAAW,WAAW,CACzB;AAAA,UACA,OAAQ,KAAK,IAAI,WAAyC;AAAA;AAAA,QAE5D,aAAa,OAAO,OAAO;AAAA,UACzB,QAAQ,SAAS,MAAM,IAAI,MACzB,qBAAqB,gEACrB,CAAC,WAAW,EAAE,CAChB;AAAA,UACA,OAAQ,KAAK,IAAI,SAA2C;AAAA;AAAA,QAE9D,MAAM,OAAO,aAAa,YAAY;AAAA,UACpC,MAAM,IAAI,MACR,UAAU,8EACV,CAAC,WAAW,KAAK,UAAU,QAAQ,OAAO,CAAC,CAC7C;AAAA,UACA,IAAI,QAAQ;AAAA,YACV,MAAM,IAAI,MACR,eAAe,mLACf;AAAA,cACE;AAAA,cACA,QAAQ,YAAY;AAAA,cACpB,KAAK,UAAU,QAAQ,WAAW;AAAA,YACpC,CACF;AAAA,UACF,MAAM,IAAI,MACR,eAAe,+EACf,CAAC,WAAW,aAAa,KAAK,UAAU,OAAO,CAAC,CAClD;AAAA;AAAA,MAEJ,CAAC;AAAA,KACF;AAAA,EACL;AAAA;;;ACxFF,IAAM,aAAY,CAAC,UAAkB;AAAA,EACnC,IAAI,CAAC,oBAAoB,KAAK,KAAK;AAAA,IACjC,MAAM,IAAI,MAAM,4BAA4B;AAAA,EAC9C,OAAO;AAAA;AAET,IAAM,KAAK,CAAC,UAAkB;AAAA,EAC5B,IAAI,CAAC,SAAS,MAAM,SAAS;AAAA,IAAK,MAAM,IAAI,MAAM,wBAAwB;AAAA;AAE5E,IAAM,WAAU,CAAC,UAAkB;AAAA,EACjC,IAAI,CAAC,OAAO,cAAc,KAAK,KAAK,QAAQ;AAAA,IAC1C,MAAM,IAAI,MAAM,4BAA4B;AAAA;AAEzC,IAAM,8BAA8B,CAAC,SAAS,sBAAsB;AAAA,EACzE,MAAM,IAAI,WAAU,MAAM;AAAA,EAC1B,OAAO,8BAA8B;AAAA,0CACG;AAAA;AAAA;AAAA;AAAA,+BAIX;AAAA;AAAA;AAAA,8FAG+D;AAAA;AAAA;AAMvF,IAAM,2BAA2B,CACtC,QACA,SAAS,sBACN;AAAA,EACH,MAAM,IAAI,WAAU,MAAM;AAAA,EAC1B,MAAM,OAAO,OAAO,KAAgB,WAAmB,WAAmB;AAAA,IACxE,QAAQ,SAAS,MAAM,IAAI,MACzB,qBAAqB,4DACrB,CAAC,WAAW,MAAM,CACpB;AAAA,IACA,OAAO,KAAK,IAAI;AAAA;AAAA,EAElB,MAAM,OAAO,CACX,KACA,WACA,QACA,UAEA,IAAI,MACF,UAAU,2FACV,CAAC,WAAW,QAAQ,KAAK,UAAU,KAAK,CAAC,CAC3C;AAAA,EACF,MAAM,SAAS,CAAC,QACd,0BACE,iCACE,KAAK,KAAK,aAAa,CAAC,QAAQ,IAAI,GAAG,EAAE,GACzC,MACF,CACF;AAAA,EACF,OAAO;AAAA,IACL,KAAK,CAAC,WAAmB,WAAmB;AAAA,MAC1C,GAAG,SAAS;AAAA,MACZ,GAAG,MAAM;AAAA,MACT,OAAO,OAAO,YACZ,OAAO,QAAS,MAAM,KAAK,KAAK,WAAW,MAAM,KAAM,IACzD;AAAA;AAAA,IAEF,OAAO,CACL,WACA,QACA,SACA,WACG;AAAA,MACH,GAAG,SAAS;AAAA,MACZ,GAAG,MAAM;AAAA,MACT,SAAQ,MAAM;AAAA,MACd,IAAI,CAAC,UAAU,CAAC,WAAW,QAAQ,SAAS;AAAA,QAC1C,MAAM,IAAI,MAAM,6BAA6B;AAAA,MAC/C,OAAO,OAAO,YAAY,OAAO,QAAQ;AAAA,QAEvC,MAAM,IAAI,MACR,0BAA0B,+CAC1B,CAAC,SAAS,CACZ;AAAA,QACA,MAAM,WAAW,MAAM,KAAK,KAAK,WAAW,MAAM;AAAA,QAClD,IAAI,UAAU;AAAA,UACZ,IAAI,SAAS,YAAY,WAAW,SAAS,WAAW;AAAA,YACtD,MAAM,IAAI,MAAM,4CAA4C;AAAA,UAC9D,OAAO,EAAE,OAAO,OAAO,MAAM,SAAS;AAAA,QACxC;AAAA,QACA,MAAM,OAAO,GAAG,EAAE,QAAQ,WAAW,gBAAgB,UAAU;AAAA,UAC7D,MAAM;AAAA,UACN,eAAe,QAAQ;AAAA,UACvB,SAAS;AAAA,QACX,CAAC;AAAA,QACD,MAAM,OAAmB;AAAA,UACvB;AAAA,UACA;AAAA,UACA,SAAS;AAAA,UACT,UAAU;AAAA,UACV,QAAQ;AAAA,UACR,QAAQ;AAAA,QACV;AAAA,QACA,MAAM,IAAI,MACR,eAAe,kEACf,CAAC,WAAW,QAAQ,KAAK,UAAU,IAAI,CAAC,CAC1C;AAAA,QACA,OAAO,EAAE,OAAO,MAAM,KAAK;AAAA,OAC5B;AAAA;AAAA,IAEH,QAAQ,CACN,WACA,QACA,SACA,SACA,cACG;AAAA,MACH,GAAG,SAAS;AAAA,MACZ,GAAG,MAAM;AAAA,MACT,GAAG,OAAO;AAAA,MACV,SAAQ,OAAO;AAAA,MACf,GAAG,SAAS;AAAA,MACZ,OAAO,OAAO,YAAY,OAAO,QAAQ;AAAA,QACvC,MAAM,OAAO,MAAM,KAAK,KAAK,WAAW,MAAM;AAAA,QAC9C,IAAI,CAAC;AAAA,UAAM,MAAM,IAAI,MAAM,4BAA4B;AAAA,QACvD,QAAQ,SAAS,MAAM,IAAI,MACzB,2CAA2C,yEAC3C,CAAC,WAAW,QAAQ,OAAO,CAC7B;AAAA,QACA,MAAM,WAAW,KAAK;AAAA,QACtB,IAAI,UAAU;AAAA,UACZ,IACE,OAAO,SAAS,OAAO,MAAM,WAC7B,SAAS,cAAc;AAAA,YAEvB,MAAM,IAAI,MAAM,+CAA+C;AAAA,UACjE,OAAO,EAAE,SAAS,OAAO,SAAS,OAAO,GAAG,OAAO,MAAM;AAAA,QAC3D;AAAA,QACA,IAAI,KAAK,WAAW;AAAA,UAClB,MAAM,IAAI,MAAM,8BAA8B;AAAA,QAChD,MAAM,UAAU,KAAK,IAAI,SAAS,KAAK,SAAS,KAAK,OAAO;AAAA,QAC5D,KAAK,WAAW;AAAA,QAChB,KAAK,YAAY,UAAU;AAAA,QAC3B,SAAQ,KAAK,OAAO;AAAA,QACpB,SAAQ,KAAK,QAAQ;AAAA,QACrB,MAAM,IAAI,MACR,eAAe,6GACf,CAAC,WAAW,QAAQ,SAAS,SAAS,SAAS,SAAS,CAC1D;AAAA,QACA,MAAM,KAAK,KAAK,WAAW,QAAQ,IAAI;AAAA,QACvC,OAAO,EAAE,SAAS,OAAO,KAAK;AAAA,OAC/B;AAAA;AAAA,IAEH,QAAQ,CACN,WACA,QACA,QACA,SAAS,UACN;AAAA,MACH,GAAG,SAAS;AAAA,MACZ,GAAG,MAAM;AAAA,MACT,OAAO,OAAO,YAAY,OAAO,QAAQ;AAAA,QAEvC,MAAM,IAAI,MACR,0BAA0B,+CAC1B,CAAC,SAAS,CACZ;AAAA,QACA,MAAM,OAAO,MAAM,KAAK,KAAK,WAAW,MAAM;AAAA,QAC9C,IAAI,CAAC;AAAA,UAAM,MAAM,IAAI,MAAM,4BAA4B;AAAA,QACvD,IAAI,KAAK,WAAW;AAAA,UAAW,OAAO;AAAA,QACtC,MAAM,OAAO,GAAG,EAAE,QAAQ,WAAW,eAAe,UAAU;AAAA,UAC5D,MAAM;AAAA,UACN,eAAe,QAAQ;AAAA,UACvB,SAAS,KAAK;AAAA,QAChB,CAAC;AAAA,QACD,KAAK,SAAS,SAAS,WAAW;AAAA,QAClC,KAAK,SAAS;AAAA,QACd,MAAM,KAAK,KAAK,WAAW,QAAQ,IAAI;AAAA,QACvC,OAAO;AAAA,OACR;AAAA;AAAA,EAEL;AAAA;",
+  "debugId": "AA6CCB44B9F64D8964756E2164756E21",
+  "names": []
+}

package/dist/index.js

@@ -539,13 +539,13 @@ var formatMicros = (amount, currency, {
   return `${sign}${whole}.${fractionStr} ${upper}`;
 };
 export {
-  readProviderBalances,
-  formatMicros,
-  createPlan,
-  computeInvoice,
+  DEFAULT_DENOMINATION,
   NANO_DENOMINATION,
-  DEFAULT_DENOMINATION
+  computeInvoice,
+  createPlan,
+  formatMicros,
+  readProviderBalances
 };
 
-//# debugId=D50F9899A29C0CBA64756E2164756E21
+//# debugId=4B467E2C09E4F21F64756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -6,6 +6,6 @@
     "/**\n * @absolutejs/billing — cost-model substrate for the AbsoluteJS PaaS.\n *\n * Two pieces:\n *\n *   - `createPlan(...)` — declarative pricing config: optional flat\n *     base fee + per-dimension unit prices, with optional graduated\n *     tiers and free-tier allowances per dimension.\n *\n *   - `computeInvoice({ plan, period, tenant, usage, currency? })`\n *     — pure function that turns a `@absolutejs/metering`-shaped\n *     `Usage` snapshot (or any record of metered numbers) into an\n *     `Invoice` of line items + total. All money math is done in\n *     integer **micros** (1 micro = 1/1,000,000 of a currency unit\n *     — the same denomination Stripe uses internally) so float\n *     drift is structurally impossible.\n *\n * Invoice sinks (push to Stripe, post to QuickBooks, mail a PDF)\n * live OUTSIDE this package, in `@absolutejs/billing-adapters/*`.\n * Keeping the substrate pure means the control plane can preview\n * invoices, run dry-run \"would-charge\" projections, and replay an\n * old usage snapshot through a new plan without touching any\n * vendor SDK.\n */\n\n// =============================================================================\n// Money primitives\n// =============================================================================\n\n/**\n * An integer amount in a plan's sub-units. 1,000,000 (micros) by default, but\n * a plan may choose a finer denomination — see `Plan.denomination`.\n */\nexport type Micros = number;\n\n/** Sub-units per currency unit when a plan does not say otherwise. */\nexport const DEFAULT_DENOMINATION = 1_000_000;\n\n/** Nanos — the denomination token-priced APIs need. */\nexport const NANO_DENOMINATION = 1_000_000_000;\n\n/**\n * Round a fractional micros value to an integer. The substrate uses\n * **truncation** (banker's-style would surprise callers expecting\n * \"$0.0009 → $0.00\" not \"$0.0009 → $0.001\"). Plans override per-plan.\n */\nexport type Rounding = \"truncate\" | \"round-half-up\";\n\nconst roundMicros = (value: number, rounding: Rounding): Micros => {\n  if (rounding === \"truncate\") return Math.trunc(value);\n  return Math.round(value);\n};\n\n// =============================================================================\n// Pricing config\n// =============================================================================\n\n/**\n * One step in a graduated-tier price table. `upTo` is the inclusive\n * upper bound (in metered units, NOT micros) for this band.\n * `perUnitMicros` is what the customer pays per single metered unit\n * within this band. The last entry must have `upTo: Infinity` to\n * cover any overflow.\n */\nexport type PricingTier = {\n  upTo: number;\n  perUnitMicros: number;\n};\n\n/**\n * Per-dimension pricing. Three shapes:\n *\n *   - Flat per-unit: `{ perUnitMicros: 200, unit: 1024 * 1024 }`\n *     charges 200 micros ($0.0002) per MB of usage.\n *\n *   - Tiered: `{ tiers: [...], unit: 1 }` charges per the first\n *     matching `PricingTier` band.\n *\n *   - Custom: `{ price: (quantity) => micros, unit: 1 }` — escape\n *     hatch for surge / caps / non-monotonic pricing. The substrate\n *     stays pure; you ship whatever function you want.\n *\n * `freeTier` is subtracted from the metered quantity BEFORE pricing\n * — the conventional \"first N units free\" rule.\n *\n * `unit` is the metered-unit denominator: 1 means \"price per single\n * metered unit\", 1024*1024 means \"price per MB when quantity is in\n * bytes.\" Default 1.\n *\n * `label` overrides the line-item display name.\n */\nexport type PricedDimension = {\n  label?: string;\n  freeTier?: number;\n  unit?: number;\n} & (\n  | { perUnitMicros: number; tiers?: never; price?: never }\n  | { tiers: PricingTier[]; perUnitMicros?: never; price?: never }\n  | {\n      price: (chargedQuantity: number) => Micros;\n      perUnitMicros?: never;\n      tiers?: never;\n    }\n);\n\nexport type Plan = {\n  /** Human label for the invoice (`'pro'`, `'enterprise'`, etc.). */\n  name: string;\n  /**\n   * Sub-units per currency unit. Defaults to 1,000,000 (micros).\n   *\n   * Micros are too coarse for token-priced APIs: at $0.16 per million\n   * embedding tokens a five-token call costs $0.0000008, which truncates to\n   * ZERO in micros — so a plan priced in micros systematically under-bills\n   * its cheapest calls. Set `1_000_000_000` to price in nanos, or any other\n   * power of ten the vendor's rate card needs. Every `*Micros` field on the\n   * plan and the invoice is denominated in these sub-units.\n   */\n  denomination?: number;\n  /** Optional flat base fee charged once per invoice period. */\n  basePriceMicros?: Micros;\n  /**\n   * Dimensions priced from usage. Keys must match keys on the\n   * `usage` record passed to `computeInvoice`. Anything not listed\n   * is ignored.\n   */\n  pricedDimensions: Record<string, PricedDimension>;\n  /** Default currency for invoices generated from this plan. */\n  currency?: string;\n  /** Rounding strategy applied per line item. Default `'truncate'`. */\n  rounding?: Rounding;\n  /**\n   * Minimum charge (in micros) — if the computed total is below\n   * this floor, the invoice total is raised to the floor and a\n   * single `'minimum-charge-adjustment'` line item captures the\n   * difference. Defaults to 0 (no floor).\n   */\n  minimumChargeMicros?: Micros;\n  /** Arbitrary plan-level metadata that flows through to invoices. */\n  metadata?: Record<string, string>;\n};\n\nexport const createPlan = (plan: Plan): Plan => {\n  for (const [key, dim] of Object.entries(plan.pricedDimensions)) {\n    if (dim.tiers !== undefined) {\n      if (dim.tiers.length === 0) {\n        throw new Error(`billing: dimension '${key}' has no tiers`);\n      }\n      const last = dim.tiers[dim.tiers.length - 1];\n      if (last !== undefined && Number.isFinite(last.upTo)) {\n        throw new Error(\n          `billing: dimension '${key}' final tier must have upTo: Infinity`,\n        );\n      }\n      let prev = 0;\n      for (let i = 0; i < dim.tiers.length; i += 1) {\n        const tier = dim.tiers[i]!;\n        if (tier.upTo < prev) {\n          throw new Error(\n            `billing: dimension '${key}' tier #${i} upTo (${tier.upTo}) must be >= previous (${prev})`,\n          );\n        }\n        prev = tier.upTo;\n      }\n    }\n  }\n  return plan;\n};\n\n// =============================================================================\n// Invoice shape\n// =============================================================================\n\nexport type LineItem = {\n  /**\n   * Stable key for the line item. For priced dimensions it's the\n   * usage-record key (`'requests'`, `'cpuMs'`, etc.). For the base\n   * fee it's `'base'`. For minimum-charge top-up it's\n   * `'minimum-charge-adjustment'`.\n   */\n  key: string;\n  /** Human-readable label. */\n  label: string;\n  /** Metered units BEFORE applying free tier. 0 for the base fee. */\n  quantity: number;\n  /** Metered units AFTER applying free tier (what's actually charged). */\n  chargedQuantity: number;\n  /** Free-tier units subtracted from `quantity`. */\n  freeTier?: number;\n  /** Charge for this line in integer micros. */\n  amountMicros: Micros;\n  /**\n   * Tier-by-tier breakdown when graduated pricing was used. Each\n   * entry: `{ tierIndex, unitsInTier, perUnitMicros, amountMicros }`.\n   */\n  tierBreakdown?: Array<{\n    tierIndex: number;\n    unitsInTier: number;\n    perUnitMicros: number;\n    amountMicros: Micros;\n  }>;\n};\n\nexport type InvoicePeriod = {\n  /** Inclusive period start (`Date.now()` ms). */\n  start: number;\n  /** Exclusive period end. */\n  end: number;\n};\n\nexport type Invoice = {\n  tenant: string;\n  plan: string;\n  currency: string;\n  /** Sub-units per currency unit these amounts are in (default micros). */\n  denomination: number;\n  period: InvoicePeriod;\n  lineItems: LineItem[];\n  /** Sum of all `lineItems[].amountMicros`. */\n  totalMicros: Micros;\n  /** Convenience: `totalMicros / 1_000_000` as a number. */\n  totalUnits: number;\n  /** Plan-level metadata copied through unchanged. */\n  metadata?: Record<string, string>;\n};\n\n// =============================================================================\n// Pricing math\n// =============================================================================\n\ntype ComputeDimensionInput = {\n  quantity: number;\n  dim: PricedDimension;\n  rounding: Rounding;\n};\n\ntype ComputeDimensionResult = {\n  amountMicros: Micros;\n  chargedQuantity: number;\n  tierBreakdown?: LineItem[\"tierBreakdown\"];\n};\n\nconst computeDimension = ({\n  quantity,\n  dim,\n  rounding,\n}: ComputeDimensionInput): ComputeDimensionResult => {\n  const free = dim.freeTier ?? 0;\n  const charged = Math.max(0, quantity - free);\n  const unit = dim.unit ?? 1;\n  const chargedUnits = unit === 1 ? charged : charged / unit;\n\n  if (dim.perUnitMicros !== undefined) {\n    const amountMicros = roundMicros(\n      chargedUnits * dim.perUnitMicros,\n      rounding,\n    );\n    return { amountMicros, chargedQuantity: charged };\n  }\n\n  if (dim.price !== undefined) {\n    const amountMicros = roundMicros(dim.price(charged), rounding);\n    return { amountMicros, chargedQuantity: charged };\n  }\n\n  // Tiered pricing — walk tiers, allocate chargedUnits into bands.\n  const tierBreakdown: NonNullable<LineItem[\"tierBreakdown\"]> = [];\n  let remaining = chargedUnits;\n  let bandFloor = 0;\n  let totalMicros = 0;\n  for (let i = 0; i < dim.tiers!.length && remaining > 0; i += 1) {\n    const tier = dim.tiers![i]!;\n    const bandWidth = tier.upTo - bandFloor;\n    const unitsInTier = Math.min(remaining, bandWidth);\n    if (unitsInTier > 0) {\n      const tierMicros = roundMicros(\n        unitsInTier * tier.perUnitMicros,\n        rounding,\n      );\n      tierBreakdown.push({\n        amountMicros: tierMicros,\n        perUnitMicros: tier.perUnitMicros,\n        tierIndex: i,\n        unitsInTier,\n      });\n      totalMicros += tierMicros;\n    }\n    remaining -= unitsInTier;\n    bandFloor = tier.upTo;\n  }\n  return {\n    amountMicros: totalMicros,\n    chargedQuantity: charged,\n    tierBreakdown,\n  };\n};\n\n// =============================================================================\n// computeInvoice — pure\n// =============================================================================\n\nexport type ComputeInvoiceInput = {\n  plan: Plan;\n  tenant: string;\n  period: InvoicePeriod;\n  /** Metered numbers keyed by the same names as `plan.pricedDimensions`. */\n  usage: Record<string, number>;\n  /** Override the plan's currency (e.g. for tenant-local invoicing). */\n  currency?: string;\n};\n\nexport const computeInvoice = ({\n  plan,\n  tenant,\n  period,\n  usage,\n  currency,\n}: ComputeInvoiceInput): Invoice => {\n  const rounding = plan.rounding ?? \"truncate\";\n  const lineItems: LineItem[] = [];\n\n  if (plan.basePriceMicros !== undefined && plan.basePriceMicros > 0) {\n    lineItems.push({\n      amountMicros: plan.basePriceMicros,\n      chargedQuantity: 1,\n      key: \"base\",\n      label: `${plan.name} base fee`,\n      quantity: 1,\n    });\n  }\n\n  for (const [key, dim] of Object.entries(plan.pricedDimensions)) {\n    const quantity = usage[key] ?? 0;\n    if (!Number.isFinite(quantity) || quantity < 0) continue;\n    const result = computeDimension({ dim, quantity, rounding });\n    if (result.amountMicros === 0 && result.chargedQuantity === 0) continue;\n    const item: LineItem = {\n      amountMicros: result.amountMicros,\n      chargedQuantity: result.chargedQuantity,\n      key,\n      label: dim.label ?? key,\n      quantity,\n    };\n    if (dim.freeTier !== undefined) item.freeTier = dim.freeTier;\n    if (result.tierBreakdown !== undefined && result.tierBreakdown.length > 0) {\n      item.tierBreakdown = result.tierBreakdown;\n    }\n    lineItems.push(item);\n  }\n\n  let totalMicros = lineItems.reduce((sum, item) => sum + item.amountMicros, 0);\n\n  const floor = plan.minimumChargeMicros ?? 0;\n  if (floor > 0 && totalMicros < floor) {\n    const gap = floor - totalMicros;\n    lineItems.push({\n      amountMicros: gap,\n      chargedQuantity: 1,\n      key: \"minimum-charge-adjustment\",\n      label: \"Minimum charge adjustment\",\n      quantity: 1,\n    });\n    totalMicros = floor;\n  }\n\n  const denomination = plan.denomination ?? DEFAULT_DENOMINATION;\n  const invoice: Invoice = {\n    currency: currency ?? plan.currency ?? \"usd\",\n    denomination,\n    lineItems,\n    period,\n    plan: plan.name,\n    tenant,\n    totalMicros,\n    totalUnits: totalMicros / denomination,\n  };\n  if (plan.metadata !== undefined) invoice.metadata = plan.metadata;\n  return invoice;\n};\n\n// =============================================================================\n// Display helpers\n// =============================================================================\n\n/**\n * Format an integer micros amount as a human currency string. Pure\n * — no Intl side effects. For locales / advanced formatting, pipe\n * through `Intl.NumberFormat` yourself.\n */\nexport const formatMicros = (\n  amount: Micros,\n  currency: string,\n  {\n    denomination = DEFAULT_DENOMINATION,\n    minorUnits = 2,\n  }: { denomination?: number; minorUnits?: number } = {},\n): string => {\n  const sign = amount < 0 ? \"-\" : \"\";\n  const abs = Math.abs(amount);\n  const exponent = Math.round(Math.log10(denomination));\n  const wholeMicrosPerMinor = 10 ** (exponent - minorUnits);\n  const minorTotal = Math.round(abs / wholeMicrosPerMinor);\n  const divisor = 10 ** minorUnits;\n  const whole = Math.trunc(minorTotal / divisor);\n  const upper = currency.toUpperCase();\n  if (minorUnits === 0) return `${sign}${whole} ${upper}`;\n  const fraction = minorTotal % divisor;\n  const fractionStr = fraction.toString().padStart(minorUnits, \"0\");\n  return `${sign}${whole}.${fractionStr} ${upper}`;\n};\n\n// Provider balances — read upstream vendors' real balance/quota/spend (the\n// inverse of computeInvoice). See ./balances.\nexport {\n  readProviderBalances,\n  type ProviderBalance,\n  type ProviderBalanceConfig,\n  type ProviderBalanceKind,\n  type ProviderBalanceStatus,\n  type BraveUsageSnapshot,\n  type EmbeddingUsageSnapshot,\n} from \"./balances\";\n"
   ],
   "mappings": ";;;;;;;;;;;;;;;;;AAoBA,IAAM,mBAAmB;AAGzB,IAAM,wBAAwB;AAC9B,IAAM,gBAAgB;AACtB,IAAM,aAAa;AACnB,IAAM,UAAU;AAChB,IAAM,WAAW;AACjB,IAAM,mBAAmB;AAkEzB,IAAM,SAAS,MAAM,IAAI,KAAK,EAAE,YAAY;AAE5C,IAAM,WAAW,CAAC,UAChB,OAAO,UAAU,YAAY,UAAU;AAEzC,IAAM,WAAW,CAAC,UAChB,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,IAAI,QAAQ;AAEhE,IAAM,MAAM,CAAC,WAAmB,IAAI,OAAO,QAAQ,CAAC;AAEpD,IAAM,UAAU,CAAC,UAAkB;AAAA,EACjC,IAAI,SAAS;AAAA,IAAS,OAAO,IAAI,QAAQ,SAAS,QAAQ,CAAC;AAAA,EAC3D,IAAI,SAAS;AAAA,IAAU,OAAO,IAAI,QAAQ,UAAU,QAAQ,CAAC;AAAA,EAE7D,OAAO,OAAO,KAAK;AAAA;AAGrB,IAAM,OAAO,CAAC,UAAkB,UAAkB;AAAA,EAChD,MAAM,SAA0B;AAAA,IAC9B,WAAW,OAAO;AAAA,IAClB,QAAQ;AAAA,IACR,MAAM;AAAA,IACN;AAAA,IACA,OAAO;AAAA,IACP,MAAM;AAAA,IACN;AAAA,IACA,WAAW;AAAA,IACX,WAAW;AAAA,IACX,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,EACR;AAAA,EAEA,OAAO;AAAA;AAGT,IAAM,eAAe,CAAC,UAAkB,OAAe,SAAiB;AAAA,EACtE,MAAM,SAA0B;AAAA,OAC3B,KAAK,UAAU,KAAK;AAAA,IACvB;AAAA,IACA,QAAQ;AAAA,EACV;AAAA,EAEA,OAAO;AAAA;AAGT,IAAM,UAAU,CAAC,UAAkB,OAAe,YAAoB;AAAA,EACpE,MAAM,SAA0B;AAAA,OAC3B,KAAK,UAAU,KAAK;AAAA,IACvB,QAAQ;AAAA,IACR,MAAM;AAAA,EACR;AAAA,EAEA,OAAO;AAAA;AAGT,IAAM,YAAY,OAChB,KACA,SACA,OAAgD,CAAC,MAC9C;AAAA,EACH,MAAM,aAAa,IAAI;AAAA,EACvB,MAAM,QAAQ,WACZ,MAAM,WAAW,MAAM,GACvB,KAAK,aAAa,gBACpB;AAAA,EACA,IAAI;AAAA,IACF,MAAM,WAAW,MAAM,MAAM,KAAK;AAAA,MAChC;AAAA,MACA,QAAQ,KAAK,UAAU;AAAA,MACvB,QAAQ,WAAW;AAAA,IACrB,CAAC;AAAA,IACD,IAAI,CAAC,SAAS,IAAI;AAAA,MAGhB,MAAM,OAAO,MAAM,SAAS,KAAK,EAAE,MAAM,MAAM,EAAE;AAAA,MACjD,MAAM,UAAU,KAAK,QAAQ,QAAQ,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG;AAAA,MAC7D,MAAM,IAAI,MACR,UACI,QAAQ,SAAS,WAAW,YAC5B,QAAQ,SAAS,QACvB;AAAA,IACF;AAAA,IACA,MAAM,OAAgB,MAAM,SAAS,KAAK;AAAA,IAE1C,OAAO;AAAA,YACP;AAAA,IACA,aAAa,KAAK;AAAA;AAAA;AAKtB,IAAM,gBAAgB,OAAO,UAGvB;AAAA,EACJ,IAAI,CAAC,MAAM,cAAc,CAAC,MAAM,WAAW;AAAA,IACzC,OAAO,aAAa,UAAU,UAAU,0BAA0B;AAAA,EACpE;AAAA,EACA,IAAI;AAAA,IACF,MAAM,OAAO,OAAO,KAAK,GAAG,MAAM,cAAc,MAAM,WAAW,EAAE,SACjE,QACF;AAAA,IACA,MAAM,UAAkC,EAAE,eAAe,SAAS,OAAO;AAAA,IACzE,OAAO,MAAM,WAAW,MAAM,QAAQ,IAAI;AAAA,MACxC,UACE,8CAA8C,MAAM,2BACpD,OACF;AAAA,MACA,UACE,8CAA8C,MAAM,mBACpD,OACF;AAAA,IACF,CAAC;AAAA,IACD,MAAM,UAAU,SAAS,IAAI,IAAI,SAAS,OAAO,KAAK,OAAO,CAAC,IAAI;AAAA,IAClE,MAAM,WACJ,SAAS,IAAI,KAAK,OAAO,KAAK,aAAa,WACvC,KAAK,WACL;AAAA,IACN,MAAM,cACJ,SAAS,OAAO,KAAK,OAAO,QAAQ,SAAS,WACzC,QAAQ,OACR;AAAA,IACN,IAAI,YAAY;AAAA,MAAM,MAAM,IAAI,MAAM,kBAAkB;AAAA,IACxD,MAAM,SAA0B;AAAA,SAC3B,KAAK,UAAU,QAAQ;AAAA,MAC1B,QAAQ,GAAG,YAAY,QAAQ,QAAQ,CAAC;AAAA,MACxC,MAAM;AAAA,MACN,WAAW;AAAA,MACX,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IAEA,OAAO;AAAA,IACP,OAAO,OAAO;AAAA,IACd,OAAO,QAAQ,UAAU,UAAU,OAAO,KAAK,CAAC;AAAA;AAAA;AAKpD,IAAM,oBAAoB,CAAC,aAAsB;AAAA,EAC/C,MAAM,OACJ,SAAS,QAAQ,KAAK,MAAM,QAAQ,SAAS,QAAQ,IACjD,SAAS,WACT,CAAC;AAAA,EAEP,OAAO,KACJ,IAAI,CAAC,SACJ,SAAS,IAAI,KAAK,OAAO,KAAK,eAAe,WACzC,KAAK,aACL,IACN,EACC,OAAO,CAAC,OAAqB,OAAO,IAAI;AAAA;AAG7C,IAAM,cAAc,CAAC,aAAsB;AAAA,EACzC,MAAM,OACJ,SAAS,QAAQ,KAAK,MAAM,QAAQ,SAAS,QAAQ,IACjD,SAAS,WACT,CAAC;AAAA,EAEP,OAAO,KAAK,OACV,CAAC,OAAO,QAAQ,SAAS,SAAS,GAAG,IAAK,SAAS,IAAI,MAAM,KAAK,IAAK,IACvE,CACF;AAAA;AAGF,IAAM,qBAAqB,OAAO,YAAoC;AAAA,EACpE,MAAM,WAAW,MAAM,UACrB,wCACA,OACF;AAAA,EACA,IAAI,QAAQ;AAAA,EACZ,WAAW,aAAa,kBAAkB,QAAQ,GAAG;AAAA,IAEnD,MAAM,WAAW,MAAM,UACrB,wCAAwC,sBACxC,OACF;AAAA,IACA,SAAS,YAAY,QAAQ;AAAA,EAC/B;AAAA,EAEA,OAAO;AAAA;AAGT,IAAM,kBAAkB,OAAO,UAA8B;AAAA,EAC3D,IAAI,CAAC,MAAM;AAAA,IACT,OAAO,aAAa,YAAY,YAAY,eAAe;AAAA,EAC7D,IAAI;AAAA,IACF,MAAM,QAAQ,MAAM,mBAAmB;AAAA,MACrC,eAAe,SAAS,MAAM;AAAA,IAChC,CAAC;AAAA,IACD,MAAM,SAA0B;AAAA,SAC3B,KAAK,YAAY,UAAU;AAAA,MAC9B,QAAQ,GAAG,IAAI,KAAK;AAAA,MACpB,MAAM;AAAA,MACN,WAAW;AAAA,MACX,QAAQ;AAAA,MACR,MAAM;AAAA,IACR;AAAA,IAEA,OAAO;AAAA,IACP,OAAO,OAAO;AAAA,IACd,OAAO,QAAQ,YAAY,YAAY,OAAO,KAAK,CAAC;AAAA;AAAA;AAKxD,IAAM,oBAAoB,OAAO,UAA8B;AAAA,EAC7D,IAAI,CAAC,MAAM;AAAA,IACT,OAAO,aAAa,cAAc,cAAc,eAAe;AAAA,EACjE,IAAI;AAAA,IACF,MAAM,OAAO,MAAM,UACjB,kDACA;AAAA,MACE,cAAc,MAAM;AAAA,IACtB,CACF;AAAA,IACA,MAAM,YAAY,SAAS,IAAI,IAAI,SAAS,KAAK,eAAe,IAAI;AAAA,IACpE,MAAM,aAAa,SAAS,IAAI,IAAI,SAAS,KAAK,eAAe,IAAI;AAAA,IACrE,IAAI,cAAc,QAAQ,eAAe,MAAM;AAAA,MAC7C,MAAM,IAAI,MAAM,qBAAqB;AAAA,IACvC;AAAA,IACA,MAAM,YAAY,SAAS,IAAI,IAC3B,SAAS,KAAK,+BAA+B,IAC7C;AAAA,IACJ,MAAM,OACJ,SAAS,IAAI,KAAK,OAAO,KAAK,SAAS,WAAW,KAAK,OAAO;AAAA,IAChE,MAAM,YAAY,KAAK,IAAI,GAAG,aAAa,SAAS;AAAA,IACpD,MAAM,SAA0B;AAAA,SAC3B,KAAK,cAAc,YAAY;AAAA,MAClC,QAAQ,GAAG,QAAQ,SAAS,OAAO,QAAQ,UAAU;AAAA,MACrD,MAAM;AAAA,MACN,OAAO;AAAA,MACP;AAAA,MACA,WAAW,YACP,IAAI,KAAK,YAAY,aAAa,EAAE,YAAY,IAChD;AAAA,MACJ,QAAQ;AAAA,MACR;AAAA,MACA,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IAEA,OAAO;AAAA,IACP,OAAO,OAAO;AAAA,IACd,OAAO,QAAQ,cAAc,cAAc,OAAO,KAAK,CAAC;AAAA;AAAA;AAK5D,IAAM,sBAAsB,CAAC,SAAkB;AAAA,EAC7C,IAAI,WAAW;AAAA,EACf,IAAI,QAAQ;AAAA,EACZ,IAAI,CAAC,SAAS,IAAI;AAAA,IAAG,OAAO,EAAE,UAAU,MAAM;AAAA,EAC9C,WAAW,SAAS,OAAO,OAAO,IAAI,GAAG;AAAA,IACvC,MAAM,MAAM,SAAS,KAAK,KAAK,SAAS,MAAM,GAAG,IAAI,MAAM,MAAM;AAAA,IACjE,IAAI,CAAC;AAAA,MAAK;AAAA,IACV,MAAM,WAAW,SAAS,IAAI,KAAK,KAAK;AAAA,IACxC,IAAI,YAAY;AAAA,MAAO;AAAA,IACvB,QAAQ;AAAA,IACR,WAAW,SAAS,IAAI,QAAQ,KAAK;AAAA,EACvC;AAAA,EAEA,OAAO,EAAE,UAAU,MAAM;AAAA;AAG3B,IAAM,eAAe,CAAC,UAAkB,UAAkB;AAAA,EACxD,IAAI,UAAU,GAAG;AAAA,IACf,MAAM,UAA2B;AAAA,SAC5B,KAAK,UAAU,QAAQ;AAAA,MAC1B,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,QAAQ;AAAA,IACV;AAAA,IAEA,OAAO;AAAA,EACT;AAAA,EACA,MAAM,SAA0B;AAAA,OAC3B,KAAK,UAAU,QAAQ;AAAA,IAC1B,QAAQ,GAAG,KAAK,IAAI,GAAG,QAAQ,QAAQ,OAAO;AAAA,IAC9C,MAAM;AAAA,IACN;AAAA,IACA,WAAW,KAAK,IAAI,GAAG,QAAQ,QAAQ;AAAA,IACvC,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,MAAM;AAAA,EACR;AAAA,EAEA,OAAO;AAAA;AAGT,IAAM,gBAAgB,OAAO,UAA8B;AAAA,EACzD,IAAI,CAAC,MAAM;AAAA,IAAQ,OAAO,aAAa,UAAU,UAAU,eAAe;AAAA,EAC1E,IAAI;AAAA,IAEF,MAAM,OAAO,MAAM,UACjB,4DACA,EAAE,gBAAgB,oBAAoB,aAAa,MAAM,OAAO,GAChE,EAAE,QAAQ,OAAO,CACnB;AAAA,IACA,QAAQ,UAAU,UAAU,oBAAoB,IAAI;AAAA,IAEpD,OAAO,aAAa,UAAU,KAAK;AAAA,IACnC,OAAO,OAAO;AAAA,IACd,OAAO,QACL,UACA,UACA,GAAG,qDACL;AAAA;AAAA;AAKJ,IAAM,gBAAgB,CAAC,WAAmB;AAAA,EACxC,MAAM,WAAU;AAAA,EAChB,MAAM,YAAW;AAAA,EACjB,IAAI,UAAU;AAAA,IAAS,OAAO,IAAI,SAAS,UAAS,QAAQ,CAAC;AAAA,EAE7D,OAAO,GAAG,KAAK,MAAM,SAAS,SAAQ;AAAA;AAGxC,IAAM,kBAAkB,CAAC,SAAoD;AAAA,EAC3E,IAAI,CAAC,MAAM;AAAA,IACT,OAAO,aACL,YACA,uBACA,sFACF;AAAA,EACF;AAAA,EACA,MAAM,YAAY,KAAK,IAAI,GAAG,KAAK,oBAAoB,KAAK,UAAU;AAAA,EACtE,MAAM,QAAyB;AAAA,OAC1B,KAAK,YAAY,qBAAqB;AAAA,IACzC,WAAW,KAAK;AAAA,IAChB,QAAQ,KAAK,YACT,GAAG,cAAc,KAAK,UAAU,OAAO,cAAc,KAAK,iBAAiB,oDAC3E,GAAG,cAAc,KAAK,UAAU,OAAO,cAAc,KAAK,iBAAiB;AAAA,IAC/E,MAAM;AAAA,IACN,OAAO,KAAK;AAAA,IACZ,MAAM;AAAA,IACN;AAAA,IACA,WAAW,KAAK,aAAa;AAAA,IAC7B,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,MAAM,KAAK;AAAA,EACb;AAAA,EAEA,OAAO;AAAA;AAIT,IAAM,eAAe,CAAC,SAAgD;AAAA,EACpE,IAAI,CAAC,MAAM;AAAA,IACT,OAAO,aACL,SACA,gBACA,iEACF;AAAA,EACF;AAAA,EACA,IAAI,KAAK,gBAAgB,KAAK,eAAe,GAAG;AAAA,IAC9C,MAAM,YAAY,KAAK,oBAAoB;AAAA,IAC3C,MAAM,QAAyB;AAAA,SAC1B,KAAK,SAAS,cAAc;AAAA,MAC/B,WAAW,KAAK;AAAA,MAChB,QAAQ,GAAG,eAAe,KAAK;AAAA,MAC/B,MAAM;AAAA,MACN,OAAO,KAAK;AAAA,MACZ;AAAA,MACA,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,MAAM,KAAK,eAAe;AAAA,IAC5B;AAAA,IAEA,OAAO;AAAA,EACT;AAAA,EACA,MAAM,UAA2B;AAAA,OAC5B,KAAK,SAAS,cAAc;AAAA,IAC/B,WAAW,KAAK;AAAA,IAChB,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,MAAM;AAAA,EACR;AAAA,EAEA,OAAO;AAAA;AAGT,IAAM,kBAAkB,MAAM,KAAK,IAAI,IAAI,mBAAmB;AAG9D,IAAM,iBAAiB,CAAC,SAAkB;AAAA,EACxC,MAAM,UAAU,SAAS,IAAI,KAAK,MAAM,QAAQ,KAAK,IAAI,IAAI,KAAK,OAAO,CAAC;AAAA,EAE1E,OAAO,QAAQ,OAAe,CAAC,OAAO,WAAW;AAAA,IAC/C,MAAM,UACJ,SAAS,MAAM,KAAK,MAAM,QAAQ,OAAO,OAAO,IAAI,OAAO,UAAU,CAAC;AAAA,IACxE,MAAM,YAAY,QAAQ,OAAe,CAAC,KAAK,QAAQ;AAAA,MACrD,MAAM,SAAS,SAAS,GAAG,KAAK,SAAS,IAAI,MAAM,IAAI,IAAI,SAAS;AAAA,MACpE,MAAM,QAAQ,SAAS,OAAO,OAAO,KAAK,IAAI;AAAA,MAE9C,OAAO,OAAO,OAAO,SAAS,KAAK,IAAI,QAAQ;AAAA,OAC9C,CAAC;AAAA,IAEJ,OAAO,QAAQ;AAAA,KACd,CAAC;AAAA;AAGN,IAAM,gBAAgB,OAAO,UAAgC;AAAA,EAC3D,IAAI,CAAC,MAAM,UAAU;AAAA,IACnB,OAAO,aACL,UACA,UACA,oEACF;AAAA,EACF;AAAA,EACA,IAAI;AAAA,IACF,MAAM,YAAY,KAAK,MAAM,gBAAgB,IAAI,aAAa;AAAA,IAC9D,MAAM,OAAO,MAAM,UACjB,2DAA2D,mBAAmB,mBAAmB,KACjG,EAAE,eAAe,UAAU,MAAM,WAAW,GAC5C,EAAE,WAAW,sBAAsB,CACrC;AAAA,IACA,MAAM,SAA0B;AAAA,SAC3B,KAAK,UAAU,QAAQ;AAAA,MAC1B,QAAQ,GAAG,IAAI,eAAe,IAAI,CAAC;AAAA,MACnC,MAAM;AAAA,MACN,MAAM;AAAA,MACN,QAAQ;AAAA,IACV;AAAA,IAEA,OAAO;AAAA,IACP,OAAO,OAAO;AAAA,IACd,OAAO,QAAQ,UAAU,UAAU,OAAO,KAAK,CAAC;AAAA;AAAA;AAKpD,IAAM,oBAAoB,CAAC,SAAkB;AAAA,EAC3C,MAAM,UAAU,SAAS,IAAI,KAAK,MAAM,QAAQ,KAAK,IAAI,IAAI,KAAK,OAAO,CAAC;AAAA,EAE1E,OAAO,QAAQ,OAAe,CAAC,OAAO,WAAW;AAAA,IAC/C,MAAM,UACJ,SAAS,MAAM,KAAK,MAAM,QAAQ,OAAO,OAAO,IAAI,OAAO,UAAU,CAAC;AAAA,IACxE,MAAM,YAAY,QAAQ,OAAe,CAAC,KAAK,QAAQ;AAAA,MACrD,IAAI,CAAC,SAAS,GAAG;AAAA,QAAG,OAAO;AAAA,MAC3B,MAAM,MAAM,IAAI,UAAU,IAAI,QAAQ,IAAI;AAAA,MAC1C,MAAM,QAAQ,OAAO,SAAS,GAAG,IAAK,IAAI,SAAS,IAAI,SAAU,GAAG;AAAA,MAEpE,OAAO,OAAO,OAAO,SAAS,KAAK,IAAI,QAAQ;AAAA,OAC9C,CAAC;AAAA,IAEJ,OAAO,QAAQ;AAAA,KACd,CAAC;AAAA;AAGN,IAAM,mBAAmB,OAAO,UAAgC;AAAA,EAC9D,IAAI,CAAC,MAAM,UAAU;AAAA,IACnB,OAAO,aACL,aACA,aACA,uEACF;AAAA,EACF;AAAA,EACA,IAAI;AAAA,IACF,MAAM,YAAY,IAAI,KAAK,gBAAgB,CAAC,EAAE,YAAY;AAAA,IAC1D,MAAM,OAAO,MAAM,UACjB,sEAAsE,aACtE,EAAE,qBAAqB,cAAc,aAAa,MAAM,SAAS,GACjE,EAAE,WAAW,sBAAsB,CACrC;AAAA,IACA,MAAM,SAA0B;AAAA,SAC3B,KAAK,aAAa,WAAW;AAAA,MAChC,QAAQ,GAAG,IAAI,kBAAkB,IAAI,CAAC;AAAA,MACtC,MAAM;AAAA,MACN,MAAM;AAAA,MACN,QAAQ;AAAA,IACV;AAAA,IAEA,OAAO;AAAA,IACP,OAAO,OAAO;AAAA,IACd,OAAO,QACL,aACA,aACA,GAAG,8EACL;AAAA;AAAA;AAUG,IAAM,uBAAuB,OAClC,WAC+B;AAAA,EAC/B,MAAM,OAAwC,CAAC;AAAA,EAC/C,IAAI,OAAO;AAAA,IAAQ,KAAK,KAAK,cAAc,OAAO,MAAM,CAAC;AAAA,EACzD,IAAI,OAAO;AAAA,IAAU,KAAK,KAAK,gBAAgB,OAAO,QAAQ,CAAC;AAAA,EAC/D,IAAI,OAAO;AAAA,IAAY,KAAK,KAAK,kBAAkB,OAAO,UAAU,CAAC;AAAA,EACrE,IAAI,OAAO;AAAA,IAAQ,KAAK,KAAK,cAAc,OAAO,MAAM,CAAC;AAAA,EACzD,IAAI,WAAW;AAAA,IAAQ,KAAK,KAAK,QAAQ,QAAQ,aAAa,OAAO,KAAK,CAAC,CAAC;AAAA,EAC5E,IAAI,cAAc,QAAQ;AAAA,IACxB,KAAK,KAAK,QAAQ,QAAQ,gBAAgB,OAAO,QAAQ,CAAC,CAAC;AAAA,EAC7D;AAAA,EACA,IAAI,OAAO;AAAA,IAAW,KAAK,KAAK,iBAAiB,OAAO,SAAS,CAAC;AAAA,EAClE,IAAI,OAAO;AAAA,IAAQ,KAAK,KAAK,cAAc,OAAO,MAAM,CAAC;AAAA,EAEzD,OAAO,QAAQ,IAAI,IAAI;AAAA;;;ACzjBlB,IAAM,uBAAuB;AAG7B,IAAM,oBAAoB;AASjC,IAAM,cAAc,CAAC,OAAe,aAA+B;AAAA,EACjE,IAAI,aAAa;AAAA,IAAY,OAAO,KAAK,MAAM,KAAK;AAAA,EACpD,OAAO,KAAK,MAAM,KAAK;AAAA;AA4FlB,IAAM,aAAa,CAAC,SAAqB;AAAA,EAC9C,YAAY,KAAK,QAAQ,OAAO,QAAQ,KAAK,gBAAgB,GAAG;AAAA,IAC9D,IAAI,IAAI,UAAU,WAAW;AAAA,MAC3B,IAAI,IAAI,MAAM,WAAW,GAAG;AAAA,QAC1B,MAAM,IAAI,MAAM,uBAAuB,mBAAmB;AAAA,MAC5D;AAAA,MACA,MAAM,OAAO,IAAI,MAAM,IAAI,MAAM,SAAS;AAAA,MAC1C,IAAI,SAAS,aAAa,OAAO,SAAS,KAAK,IAAI,GAAG;AAAA,QACpD,MAAM,IAAI,MACR,uBAAuB,0CACzB;AAAA,MACF;AAAA,MACA,IAAI,OAAO;AAAA,MACX,SAAS,IAAI,EAAG,IAAI,IAAI,MAAM,QAAQ,KAAK,GAAG;AAAA,QAC5C,MAAM,OAAO,IAAI,MAAM;AAAA,QACvB,IAAI,KAAK,OAAO,MAAM;AAAA,UACpB,MAAM,IAAI,MACR,uBAAuB,cAAc,WAAW,KAAK,8BAA8B,OACrF;AAAA,QACF;AAAA,QACA,OAAO,KAAK;AAAA,MACd;AAAA,IACF;AAAA,EACF;AAAA,EACA,OAAO;AAAA;AA4ET,IAAM,mBAAmB;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,MACmD;AAAA,EACnD,MAAM,OAAO,IAAI,YAAY;AAAA,EAC7B,MAAM,UAAU,KAAK,IAAI,GAAG,WAAW,IAAI;AAAA,EAC3C,MAAM,OAAO,IAAI,QAAQ;AAAA,EACzB,MAAM,eAAe,SAAS,IAAI,UAAU,UAAU;AAAA,EAEtD,IAAI,IAAI,kBAAkB,WAAW;AAAA,IACnC,MAAM,eAAe,YACnB,eAAe,IAAI,eACnB,QACF;AAAA,IACA,OAAO,EAAE,cAAc,iBAAiB,QAAQ;AAAA,EAClD;AAAA,EAEA,IAAI,IAAI,UAAU,WAAW;AAAA,IAC3B,MAAM,eAAe,YAAY,IAAI,MAAM,OAAO,GAAG,QAAQ;AAAA,IAC7D,OAAO,EAAE,cAAc,iBAAiB,QAAQ;AAAA,EAClD;AAAA,EAGA,MAAM,gBAAwD,CAAC;AAAA,EAC/D,IAAI,YAAY;AAAA,EAChB,IAAI,YAAY;AAAA,EAChB,IAAI,cAAc;AAAA,EAClB,SAAS,IAAI,EAAG,IAAI,IAAI,MAAO,UAAU,YAAY,GAAG,KAAK,GAAG;AAAA,IAC9D,MAAM,OAAO,IAAI,MAAO;AAAA,IACxB,MAAM,YAAY,KAAK,OAAO;AAAA,IAC9B,MAAM,cAAc,KAAK,IAAI,WAAW,SAAS;AAAA,IACjD,IAAI,cAAc,GAAG;AAAA,MACnB,MAAM,aAAa,YACjB,cAAc,KAAK,eACnB,QACF;AAAA,MACA,cAAc,KAAK;AAAA,QACjB,cAAc;AAAA,QACd,eAAe,KAAK;AAAA,QACpB,WAAW;AAAA,QACX;AAAA,MACF,CAAC;AAAA,MACD,eAAe;AAAA,IACjB;AAAA,IACA,aAAa;AAAA,IACb,YAAY,KAAK;AAAA,EACnB;AAAA,EACA,OAAO;AAAA,IACL,cAAc;AAAA,IACd,iBAAiB;AAAA,IACjB;AAAA,EACF;AAAA;AAiBK,IAAM,iBAAiB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,MACkC;AAAA,EAClC,MAAM,WAAW,KAAK,YAAY;AAAA,EAClC,MAAM,YAAwB,CAAC;AAAA,EAE/B,IAAI,KAAK,oBAAoB,aAAa,KAAK,kBAAkB,GAAG;AAAA,IAClE,UAAU,KAAK;AAAA,MACb,cAAc,KAAK;AAAA,MACnB,iBAAiB;AAAA,MACjB,KAAK;AAAA,MACL,OAAO,GAAG,KAAK;AAAA,MACf,UAAU;AAAA,IACZ,CAAC;AAAA,EACH;AAAA,EAEA,YAAY,KAAK,QAAQ,OAAO,QAAQ,KAAK,gBAAgB,GAAG;AAAA,IAC9D,MAAM,WAAW,MAAM,QAAQ;AAAA,IAC/B,IAAI,CAAC,OAAO,SAAS,QAAQ,KAAK,WAAW;AAAA,MAAG;AAAA,IAChD,MAAM,SAAS,iBAAiB,EAAE,KAAK,UAAU,SAAS,CAAC;AAAA,IAC3D,IAAI,OAAO,iBAAiB,KAAK,OAAO,oBAAoB;AAAA,MAAG;AAAA,IAC/D,MAAM,OAAiB;AAAA,MACrB,cAAc,OAAO;AAAA,MACrB,iBAAiB,OAAO;AAAA,MACxB;AAAA,MACA,OAAO,IAAI,SAAS;AAAA,MACpB;AAAA,IACF;AAAA,IACA,IAAI,IAAI,aAAa;AAAA,MAAW,KAAK,WAAW,IAAI;AAAA,IACpD,IAAI,OAAO,kBAAkB,aAAa,OAAO,cAAc,SAAS,GAAG;AAAA,MACzE,KAAK,gBAAgB,OAAO;AAAA,IAC9B;AAAA,IACA,UAAU,KAAK,IAAI;AAAA,EACrB;AAAA,EAEA,IAAI,cAAc,UAAU,OAAO,CAAC,KAAK,SAAS,MAAM,KAAK,cAAc,CAAC;AAAA,EAE5E,MAAM,QAAQ,KAAK,uBAAuB;AAAA,EAC1C,IAAI,QAAQ,KAAK,cAAc,OAAO;AAAA,IACpC,MAAM,MAAM,QAAQ;AAAA,IACpB,UAAU,KAAK;AAAA,MACb,cAAc;AAAA,MACd,iBAAiB;AAAA,MACjB,KAAK;AAAA,MACL,OAAO;AAAA,MACP,UAAU;AAAA,IACZ,CAAC;AAAA,IACD,cAAc;AAAA,EAChB;AAAA,EAEA,MAAM,eAAe,KAAK,gBAAgB;AAAA,EAC1C,MAAM,UAAmB;AAAA,IACvB,UAAU,YAAY,KAAK,YAAY;AAAA,IACvC;AAAA,IACA;AAAA,IACA;AAAA,IACA,MAAM,KAAK;AAAA,IACX;AAAA,IACA;AAAA,IACA,YAAY,cAAc;AAAA,EAC5B;AAAA,EACA,IAAI,KAAK,aAAa;AAAA,IAAW,QAAQ,WAAW,KAAK;AAAA,EACzD,OAAO;AAAA;AAYF,IAAM,eAAe,CAC1B,QACA;AAAA,EAEE,eAAe;AAAA,EACf,aAAa;AAAA,IACqC,CAAC,MAC1C;AAAA,EACX,MAAM,OAAO,SAAS,IAAI,MAAM;AAAA,EAChC,MAAM,MAAM,KAAK,IAAI,MAAM;AAAA,EAC3B,MAAM,WAAW,KAAK,MAAM,KAAK,MAAM,YAAY,CAAC;AAAA,EACpD,MAAM,sBAAsB,OAAO,WAAW;AAAA,EAC9C,MAAM,aAAa,KAAK,MAAM,MAAM,mBAAmB;AAAA,EACvD,MAAM,UAAU,MAAM;AAAA,EACtB,MAAM,QAAQ,KAAK,MAAM,aAAa,OAAO;AAAA,EAC7C,MAAM,QAAQ,SAAS,YAAY;AAAA,EACnC,IAAI,eAAe;AAAA,IAAG,OAAO,GAAG,OAAO,SAAS;AAAA,EAChD,MAAM,WAAW,aAAa;AAAA,EAC9B,MAAM,cAAc,SAAS,SAAS,EAAE,SAAS,YAAY,GAAG;AAAA,EAChE,OAAO,GAAG,OAAO,SAAS,eAAe;AAAA;",
-  "debugId": "D50F9899A29C0CBA64756E2164756E21",
+  "debugId": "4B467E2C09E4F21F64756E2164756E21",
   "names": []
 }

package/dist/ledger.d.ts

@@ -54,3 +54,52 @@ export type UsageLedger = {
     overCap: (capSubUnits: number, since: Date) => Promise<boolean>;
 };
 export declare const createUsageLedger: (options: UsageLedgerOptions) => UsageLedger;
+export type CreditBalanceInput = {
+    /** Granted credits that SURVIVE a period reset (referrals, goodwill). */
+    bonusCredits: number;
+    consumed: number;
+    /** Credits the plan grants for the current period. */
+    periodAllowance: number;
+    periodEnd?: Date | null;
+};
+export type CreditBalance = {
+    /** periodAllowance + bonusCredits — the spendable ceiling this period. */
+    allowance: number;
+    bonusCredits: number;
+    consumed: number;
+    periodAllowance: number;
+    periodEnd: Date | null;
+    /** Never negative: an over-spend reads as zero left, not a debt. */
+    remaining: number;
+};
+/** Derive the spendable view of a stored balance row. */
+export declare const creditBalanceFrom: (row: CreditBalanceInput) => CreditBalance;
+/** Whether the billing window has closed and the allowance should re-snapshot.
+ *  A null end date means "no window" — an unbounded balance never lapses. */
+export declare const isPeriodLapsed: (periodEnd: Date | null | undefined, now?: Date) => boolean;
+/**
+ * How hard the gate bites. `off` skips the balance read entirely, `warn`
+ * always allows but reports `low` so the UI can say so, `block` refuses once
+ * the remaining balance cannot cover the estimate.
+ */
+export type CreditEnforcementMode = "block" | "off" | "warn";
+export type CreditGate = {
+    allowance: number;
+    allowed: boolean;
+    /** True when the balance cannot cover the estimate, in ANY mode — the
+     *  signal a product surfaces before it starts refusing work. */
+    low: boolean;
+    mode: CreditEnforcementMode;
+    remaining: number;
+};
+export type CreditGateInput = {
+    allowance: number;
+    estimatedCredits?: number;
+    mode: CreditEnforcementMode;
+    remaining: number;
+};
+/** Decide whether a metered call proceeds. Pure — the caller does the reads. */
+export declare const creditGate: (input: CreditGateInput) => CreditGate;
+/** Whether a bonus grant is worth writing — guards against NaN and negatives
+ *  quietly corrupting a balance. */
+export declare const isGrantableCredits: (credits: number) => boolean;

package/dist/ledger.js

@@ -45,10 +45,41 @@ var createUsageLedger = (options) => {
     }
   };
 };
+var creditBalanceFrom = (row) => {
+  const allowance = row.periodAllowance + row.bonusCredits;
+  return {
+    allowance,
+    bonusCredits: row.bonusCredits,
+    consumed: row.consumed,
+    periodAllowance: row.periodAllowance,
+    periodEnd: row.periodEnd ?? null,
+    remaining: Math.max(0, allowance - row.consumed)
+  };
+};
+var isPeriodLapsed = (periodEnd, now = new Date) => periodEnd !== null && periodEnd !== undefined && periodEnd.getTime() <= now.getTime();
+var creditGate = (input) => {
+  const { allowance, estimatedCredits = 1, mode, remaining } = input;
+  if (mode === "off") {
+    return { allowance: 0, allowed: true, low: false, mode, remaining: 0 };
+  }
+  const sufficient = remaining >= estimatedCredits;
+  return {
+    allowance,
+    allowed: mode === "block" ? sufficient : true,
+    low: !sufficient,
+    mode,
+    remaining
+  };
+};
+var isGrantableCredits = (credits) => Number.isFinite(credits) && credits > 0;
 export {
+  createUsageLedger,
+  creditBalanceFrom,
+  creditGate,
   creditsFor,
-  createUsageLedger
+  isGrantableCredits,
+  isPeriodLapsed
 };
 
-//# debugId=0E1FB04E107E92A964756E2164756E21
+//# debugId=CB2DC54F3ACBA03564756E2164756E21
 //# sourceMappingURL=ledger.js.map

package/dist/ledger.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/ledger.ts"],
   "sourcesContent": [
-    "// The layer between a meter and an invoice: every metered event gets priced,\n// converted to the customer's credit unit, written to an append-only ledger,\n// debited against a balance, and folded into a daily rollup that a spend cap\n// can read. Every app billing a metered API rebuilds this, and each one\n// rediscovers the same three traps:\n//\n//   - Money in floats. Summing float ledger rows drifts; one real deployment\n//     lost 2 cents across 25,740 rows before anyone noticed. Amounts here are\n//     integer sub-units (see Plan.denomination) and are only ever added.\n//   - The debit and the ledger row diverging. If the row is written but the\n//     balance is not debited, a customer gets free usage; the reverse\n//     over-charges. They must land together, so the store commits them as one\n//     unit — this module never splits them.\n//   - The rollup being treated as truth. It is a derived index, rebuildable\n//     from the ledger, so a rollup failure must never fail the charge.\n//\n// Storage stays the host's business (Postgres, ClickHouse, anything). This\n// owns the policy and the arithmetic, which is the part that is identical\n// everywhere — and the part that is worth getting wrong only once.\n\n/** One priced, metered event, ready to persist. */\nexport type LedgerEntry = {\n  /** Charge in integer sub-units of the plan's denomination (see\n   *  `Plan.denomination`) — never a float. */\n  amount: number;\n  /** What the customer is billed in the product's own unit. */\n  credits: number;\n  /** Product-level grouping (\"chat\", \"voice\"), not the vendor's. */\n  feature?: string | null;\n  model?: string;\n  /** \"llm\" | \"tts\" | \"embedding\" | whatever the product meters. */\n  operation: string;\n  provider: string;\n  /** Idempotency handle for at-least-once callers. */\n  requestId?: string;\n  /** Null for system/background work with nobody to bill. */\n  tenant?: string | null;\n};\n\nexport type LedgerCommit = {\n  /** Append the row AND debit `entry.credits` from the tenant's balance in a\n   *  single atomic unit. Called with tenant null for unattributed work, where\n   *  there is nothing to debit. */\n  commit: (entry: LedgerEntry) => Promise<void>;\n  /** Fold the entry into a derived daily aggregate. Best-effort by contract:\n   *  this module swallows its failures. */\n  rollup?: (entry: LedgerEntry) => Promise<void>;\n  /** Total sub-units charged since `since`, for the spend cap. */\n  spentSince?: (since: Date) => Promise<number>;\n};\n\nexport type UsageLedgerOptions = {\n  /** Sub-units per credit. A peg of 1_000 with micros means 1 credit =\n   *  $0.001. Required for credit conversion; omit to bill in raw amounts. */\n  creditPegSubUnits?: number;\n  /** Reported when a rollup fails. The charge already succeeded. */\n  onRollupError?: (error: unknown, entry: LedgerEntry) => void;\n  store: LedgerCommit;\n};\n\n/**\n * Credits for a charge. Ceiling, not rounding: a product that sells credits\n * must never hand out a fraction it cannot deduct, and rounding down means\n * the smallest calls are free — which is how a \"cheap\" endpoint becomes an\n * unmetered one.\n */\nexport const creditsFor = (amount: number, pegSubUnits: number) => {\n  if (pegSubUnits <= 0) return 0;\n\n  return Math.ceil(amount / pegSubUnits);\n};\n\nexport type UsageLedger = {\n  /** Price-agnostic: hand it an amount already in sub-units. Returns what was\n   *  written, including the credits it derived. */\n  record: (\n    entry: Omit<LedgerEntry, \"credits\"> & { credits?: number },\n  ) => Promise<LedgerEntry>;\n  /** True once spend since `since` reaches `capSubUnits`. Fails OPEN — a\n   *  broken cap must not take down paid features, and the per-provider\n   *  budgets are still in front. */\n  overCap: (capSubUnits: number, since: Date) => Promise<boolean>;\n};\n\nexport const createUsageLedger = (options: UsageLedgerOptions): UsageLedger => {\n  const { creditPegSubUnits, onRollupError, store } = options;\n\n  return {\n    overCap: async (capSubUnits, since) => {\n      if (!store.spentSince) return false;\n      try {\n        return (await store.spentSince(since)) >= capSubUnits;\n      } catch {\n        return false;\n      }\n    },\n    record: async (input) => {\n      const credits =\n        input.credits ??\n        (creditPegSubUnits === undefined\n          ? 0\n          : creditsFor(input.amount, creditPegSubUnits));\n      const entry: LedgerEntry = { ...input, credits };\n      // The charge is the thing that must not be lost; it is awaited and its\n      // failure propagates to the caller.\n      await store.commit(entry);\n      // The rollup is a derived index — rebuildable from the ledger — so its\n      // failure is reported, never raised.\n      if (store.rollup) {\n        await store.rollup(entry).catch((error: unknown) => {\n          onRollupError?.(error, entry);\n        });\n      }\n\n      return entry;\n    },\n  };\n};\n"
+    "// The layer between a meter and an invoice: every metered event gets priced,\n// converted to the customer's credit unit, written to an append-only ledger,\n// debited against a balance, and folded into a daily rollup that a spend cap\n// can read. Every app billing a metered API rebuilds this, and each one\n// rediscovers the same three traps:\n//\n//   - Money in floats. Summing float ledger rows drifts; one real deployment\n//     lost 2 cents across 25,740 rows before anyone noticed. Amounts here are\n//     integer sub-units (see Plan.denomination) and are only ever added.\n//   - The debit and the ledger row diverging. If the row is written but the\n//     balance is not debited, a customer gets free usage; the reverse\n//     over-charges. They must land together, so the store commits them as one\n//     unit — this module never splits them.\n//   - The rollup being treated as truth. It is a derived index, rebuildable\n//     from the ledger, so a rollup failure must never fail the charge.\n//\n// Storage stays the host's business (Postgres, ClickHouse, anything). This\n// owns the policy and the arithmetic, which is the part that is identical\n// everywhere — and the part that is worth getting wrong only once.\n\n/** One priced, metered event, ready to persist. */\nexport type LedgerEntry = {\n  /** Charge in integer sub-units of the plan's denomination (see\n   *  `Plan.denomination`) — never a float. */\n  amount: number;\n  /** What the customer is billed in the product's own unit. */\n  credits: number;\n  /** Product-level grouping (\"chat\", \"voice\"), not the vendor's. */\n  feature?: string | null;\n  model?: string;\n  /** \"llm\" | \"tts\" | \"embedding\" | whatever the product meters. */\n  operation: string;\n  provider: string;\n  /** Idempotency handle for at-least-once callers. */\n  requestId?: string;\n  /** Null for system/background work with nobody to bill. */\n  tenant?: string | null;\n};\n\nexport type LedgerCommit = {\n  /** Append the row AND debit `entry.credits` from the tenant's balance in a\n   *  single atomic unit. Called with tenant null for unattributed work, where\n   *  there is nothing to debit. */\n  commit: (entry: LedgerEntry) => Promise<void>;\n  /** Fold the entry into a derived daily aggregate. Best-effort by contract:\n   *  this module swallows its failures. */\n  rollup?: (entry: LedgerEntry) => Promise<void>;\n  /** Total sub-units charged since `since`, for the spend cap. */\n  spentSince?: (since: Date) => Promise<number>;\n};\n\nexport type UsageLedgerOptions = {\n  /** Sub-units per credit. A peg of 1_000 with micros means 1 credit =\n   *  $0.001. Required for credit conversion; omit to bill in raw amounts. */\n  creditPegSubUnits?: number;\n  /** Reported when a rollup fails. The charge already succeeded. */\n  onRollupError?: (error: unknown, entry: LedgerEntry) => void;\n  store: LedgerCommit;\n};\n\n/**\n * Credits for a charge. Ceiling, not rounding: a product that sells credits\n * must never hand out a fraction it cannot deduct, and rounding down means\n * the smallest calls are free — which is how a \"cheap\" endpoint becomes an\n * unmetered one.\n */\nexport const creditsFor = (amount: number, pegSubUnits: number) => {\n  if (pegSubUnits <= 0) return 0;\n\n  return Math.ceil(amount / pegSubUnits);\n};\n\nexport type UsageLedger = {\n  /** Price-agnostic: hand it an amount already in sub-units. Returns what was\n   *  written, including the credits it derived. */\n  record: (\n    entry: Omit<LedgerEntry, \"credits\"> & { credits?: number },\n  ) => Promise<LedgerEntry>;\n  /** True once spend since `since` reaches `capSubUnits`. Fails OPEN — a\n   *  broken cap must not take down paid features, and the per-provider\n   *  budgets are still in front. */\n  overCap: (capSubUnits: number, since: Date) => Promise<boolean>;\n};\n\nexport const createUsageLedger = (options: UsageLedgerOptions): UsageLedger => {\n  const { creditPegSubUnits, onRollupError, store } = options;\n\n  return {\n    overCap: async (capSubUnits, since) => {\n      if (!store.spentSince) return false;\n      try {\n        return (await store.spentSince(since)) >= capSubUnits;\n      } catch {\n        return false;\n      }\n    },\n    record: async (input) => {\n      const credits =\n        input.credits ??\n        (creditPegSubUnits === undefined\n          ? 0\n          : creditsFor(input.amount, creditPegSubUnits));\n      const entry: LedgerEntry = { ...input, credits };\n      // The charge is the thing that must not be lost; it is awaited and its\n      // failure propagates to the caller.\n      await store.commit(entry);\n      // The rollup is a derived index — rebuildable from the ledger — so its\n      // failure is reported, never raised.\n      if (store.rollup) {\n        await store.rollup(entry).catch((error: unknown) => {\n          onRollupError?.(error, entry);\n        });\n      }\n\n      return entry;\n    },\n  };\n};\n\n// -----------------------------------------------------------------------------\n// Credit balances\n// -----------------------------------------------------------------------------\n\n// A credit-based product needs the same four decisions no matter what it\n// sells: what the customer may spend, whether the period has rolled, whether\n// this call is allowed, and whether a grant is real. The lookups behind them\n// (subscriptions, comps, plan tables) are the host's; the arithmetic is not,\n// and it is the part where an off-by-one hands out free usage.\n\nexport type CreditBalanceInput = {\n  /** Granted credits that SURVIVE a period reset (referrals, goodwill). */\n  bonusCredits: number;\n  consumed: number;\n  /** Credits the plan grants for the current period. */\n  periodAllowance: number;\n  periodEnd?: Date | null;\n};\n\nexport type CreditBalance = {\n  /** periodAllowance + bonusCredits — the spendable ceiling this period. */\n  allowance: number;\n  bonusCredits: number;\n  consumed: number;\n  periodAllowance: number;\n  periodEnd: Date | null;\n  /** Never negative: an over-spend reads as zero left, not a debt. */\n  remaining: number;\n};\n\n/** Derive the spendable view of a stored balance row. */\nexport const creditBalanceFrom = (row: CreditBalanceInput): CreditBalance => {\n  const allowance = row.periodAllowance + row.bonusCredits;\n\n  return {\n    allowance,\n    bonusCredits: row.bonusCredits,\n    consumed: row.consumed,\n    periodAllowance: row.periodAllowance,\n    periodEnd: row.periodEnd ?? null,\n    remaining: Math.max(0, allowance - row.consumed),\n  };\n};\n\n/** Whether the billing window has closed and the allowance should re-snapshot.\n *  A null end date means \"no window\" — an unbounded balance never lapses. */\nexport const isPeriodLapsed = (\n  periodEnd: Date | null | undefined,\n  now = new Date(),\n) =>\n  periodEnd !== null &&\n  periodEnd !== undefined &&\n  periodEnd.getTime() <= now.getTime();\n\n/**\n * How hard the gate bites. `off` skips the balance read entirely, `warn`\n * always allows but reports `low` so the UI can say so, `block` refuses once\n * the remaining balance cannot cover the estimate.\n */\nexport type CreditEnforcementMode = \"block\" | \"off\" | \"warn\";\n\nexport type CreditGate = {\n  allowance: number;\n  allowed: boolean;\n  /** True when the balance cannot cover the estimate, in ANY mode — the\n   *  signal a product surfaces before it starts refusing work. */\n  low: boolean;\n  mode: CreditEnforcementMode;\n  remaining: number;\n};\n\nexport type CreditGateInput = {\n  allowance: number;\n  estimatedCredits?: number;\n  mode: CreditEnforcementMode;\n  remaining: number;\n};\n\n/** Decide whether a metered call proceeds. Pure — the caller does the reads. */\nexport const creditGate = (input: CreditGateInput): CreditGate => {\n  const { allowance, estimatedCredits = 1, mode, remaining } = input;\n  if (mode === \"off\") {\n    return { allowance: 0, allowed: true, low: false, mode, remaining: 0 };\n  }\n  const sufficient = remaining >= estimatedCredits;\n\n  return {\n    allowance,\n    allowed: mode === \"block\" ? sufficient : true,\n    low: !sufficient,\n    mode,\n    remaining,\n  };\n};\n\n/** Whether a bonus grant is worth writing — guards against NaN and negatives\n *  quietly corrupting a balance. */\nexport const isGrantableCredits = (credits: number) =>\n  Number.isFinite(credits) && credits > 0;\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;AAkEO,IAAM,aAAa,CAAC,QAAgB,gBAAwB;AAAA,EACjE,IAAI,eAAe;AAAA,IAAG,OAAO;AAAA,EAE7B,OAAO,KAAK,KAAK,SAAS,WAAW;AAAA;AAehC,IAAM,oBAAoB,CAAC,YAA6C;AAAA,EAC7E,QAAQ,mBAAmB,eAAe,UAAU;AAAA,EAEpD,OAAO;AAAA,IACL,SAAS,OAAO,aAAa,UAAU;AAAA,MACrC,IAAI,CAAC,MAAM;AAAA,QAAY,OAAO;AAAA,MAC9B,IAAI;AAAA,QACF,OAAQ,MAAM,MAAM,WAAW,KAAK,KAAM;AAAA,QAC1C,MAAM;AAAA,QACN,OAAO;AAAA;AAAA;AAAA,IAGX,QAAQ,OAAO,UAAU;AAAA,MACvB,MAAM,UACJ,MAAM,YACL,sBAAsB,YACnB,IACA,WAAW,MAAM,QAAQ,iBAAiB;AAAA,MAChD,MAAM,QAAqB,KAAK,OAAO,QAAQ;AAAA,MAG/C,MAAM,MAAM,OAAO,KAAK;AAAA,MAGxB,IAAI,MAAM,QAAQ;AAAA,QAChB,MAAM,MAAM,OAAO,KAAK,EAAE,MAAM,CAAC,UAAmB;AAAA,UAClD,gBAAgB,OAAO,KAAK;AAAA,SAC7B;AAAA,MACH;AAAA,MAEA,OAAO;AAAA;AAAA,EAEX;AAAA;",
-  "debugId": "0E1FB04E107E92A964756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;AAkEO,IAAM,aAAa,CAAC,QAAgB,gBAAwB;AAAA,EACjE,IAAI,eAAe;AAAA,IAAG,OAAO;AAAA,EAE7B,OAAO,KAAK,KAAK,SAAS,WAAW;AAAA;AAehC,IAAM,oBAAoB,CAAC,YAA6C;AAAA,EAC7E,QAAQ,mBAAmB,eAAe,UAAU;AAAA,EAEpD,OAAO;AAAA,IACL,SAAS,OAAO,aAAa,UAAU;AAAA,MACrC,IAAI,CAAC,MAAM;AAAA,QAAY,OAAO;AAAA,MAC9B,IAAI;AAAA,QACF,OAAQ,MAAM,MAAM,WAAW,KAAK,KAAM;AAAA,QAC1C,MAAM;AAAA,QACN,OAAO;AAAA;AAAA;AAAA,IAGX,QAAQ,OAAO,UAAU;AAAA,MACvB,MAAM,UACJ,MAAM,YACL,sBAAsB,YACnB,IACA,WAAW,MAAM,QAAQ,iBAAiB;AAAA,MAChD,MAAM,QAAqB,KAAK,OAAO,QAAQ;AAAA,MAG/C,MAAM,MAAM,OAAO,KAAK;AAAA,MAGxB,IAAI,MAAM,QAAQ;AAAA,QAChB,MAAM,MAAM,OAAO,KAAK,EAAE,MAAM,CAAC,UAAmB;AAAA,UAClD,gBAAgB,OAAO,KAAK;AAAA,SAC7B;AAAA,MACH;AAAA,MAEA,OAAO;AAAA;AAAA,EAEX;AAAA;AAkCK,IAAM,oBAAoB,CAAC,QAA2C;AAAA,EAC3E,MAAM,YAAY,IAAI,kBAAkB,IAAI;AAAA,EAE5C,OAAO;AAAA,IACL;AAAA,IACA,cAAc,IAAI;AAAA,IAClB,UAAU,IAAI;AAAA,IACd,iBAAiB,IAAI;AAAA,IACrB,WAAW,IAAI,aAAa;AAAA,IAC5B,WAAW,KAAK,IAAI,GAAG,YAAY,IAAI,QAAQ;AAAA,EACjD;AAAA;AAKK,IAAM,iBAAiB,CAC5B,WACA,MAAM,IAAI,SAEV,cAAc,QACd,cAAc,aACd,UAAU,QAAQ,KAAK,IAAI,QAAQ;AA2B9B,IAAM,aAAa,CAAC,UAAuC;AAAA,EAChE,QAAQ,WAAW,mBAAmB,GAAG,MAAM,cAAc;AAAA,EAC7D,IAAI,SAAS,OAAO;AAAA,IAClB,OAAO,EAAE,WAAW,GAAG,SAAS,MAAM,KAAK,OAAO,MAAM,WAAW,EAAE;AAAA,EACvE;AAAA,EACA,MAAM,aAAa,aAAa;AAAA,EAEhC,OAAO;AAAA,IACL;AAAA,IACA,SAAS,SAAS,UAAU,aAAa;AAAA,IACzC,KAAK,CAAC;AAAA,IACN;AAAA,IACA;AAAA,EACF;AAAA;AAKK,IAAM,qBAAqB,CAAC,YACjC,OAAO,SAAS,OAAO,KAAK,UAAU;",
+  "debugId": "CB2DC54F3ACBA03564756E2164756E21",
   "names": []
 }