@suluk/credits - v0.1.0
    Preparing search index...

    Function record

    @suluk/credits — a metered credit ledger (C046, extracted verbatim). The package OWNS the schema (credit_transaction

    • the credit_amount/credit_key sidecars); the app injects a Drizzle handle (D1 in prod, bun:sqlite in tests). The money-correctness core: the ATOMIC debitIfCovers (a conditional INSERT that can't drive the ledger negative under concurrency) + the idempotent debitOnceIfCovers (the partial-refund double-spend guard) + per-key spend + the activity-log query. App-specific payment-alert kinds + the user-table count stay in the app.
    • Append one ledger row (the single writer); returns the new row id. delta is + on grant/top-up, − on debit.

      Parameters

      • db: CreditsDB
      • userId: string
      • delta: number
      • reason: string

      Returns Promise<string>