pipework 0.251.0 → 0.252.1

package/src/infra/credit-line/index.ts

@@ -0,0 +1,6 @@
+export { createCreditLine } from './handle.js'
+export type {
+  CreditLine, CreditLineConfig, CreditLineCap, CapWindow, LineCrossing, LimitRef, LineReserveResult,
+  LineReservation, LineState, LineCapState, LineEntry, Payment, PaymentApplication, PaymentWithEntries,
+  Authorization, AuthorizationStatus, Statement, OpenLineOptions, AuthorizeOptions,
+} from './handle.js'

package/src/infra/credit-line/namespace.ts

@@ -0,0 +1,7 @@
+import { createCreditLine } from './handle.js'
+
+/** Credit line namespace — a postpaid line per tenant: reserve and settle against a ceiling, caps by window, authorizations, payments, statements. */
+export const creditLine = {
+  /** Creates a credit line handle. */
+  create: createCreditLine,
+} as const

package/src/infra/credit-line/schema.ts

@@ -0,0 +1,96 @@
+// The six tables behind the postpaid credit line, all tenant-scoped (forced
+// row-level security in generated migrations). Amounts are whole cents in bigint columns.
+
+import { define } from '../../data/domain/index.js'
+import { field } from '../../data/domain/field.js'
+import { schema } from '../../data/schema/namespace.js'
+import { index, uniqueIndex } from '../../data/db/idx/index.js'
+
+export const CREDIT_LINE_RESERVATION_STATUSES = ['held', 'settled', 'released'] as const
+
+export const creditLine = define('credit_line', {
+  id: field.uuid().defaultRandom().primaryKey(),
+  tenantId: field.uuid().tenant(),
+  ceilingCents: field.bigint(),
+  warnShare: field.decimal().nullable(),
+  caps: field.jsonb(schema.check.json()),
+  openedAt: field.timestamp().default('now'),
+  closedAt: field.timestamp().nullable(),
+}, {
+  indexes: (t) => ({
+    byTenant: uniqueIndex('uq_credit_line_tenant').on(t['tenantId']),
+  }),
+})
+
+export const creditLineReservation = define('credit_line_reservation', {
+  id: field.uuid().defaultRandom().primaryKey(),
+  tenantId: field.uuid().tenant(),
+  jobId: field.text(),
+  amount: field.bigint(),
+  status: field.enum(CREDIT_LINE_RESERVATION_STATUSES),
+  settledAmount: field.bigint().nullable(),
+  authorizationId: field.uuid().nullable(),
+  createdAt: field.timestamp().default('now'),
+  settledAt: field.timestamp().nullable(),
+}, {
+  indexes: (t) => ({
+    byJob: uniqueIndex('uq_credit_line_reservation_job').on(t['tenantId'], t['jobId']),
+  }),
+})
+
+export const creditLineEntry = define('credit_line_entry', {
+  id: field.uuid().defaultRandom().primaryKey(),
+  tenantId: field.uuid().tenant(),
+  jobId: field.text(),
+  reservationId: field.uuid(),
+  amountCents: field.bigint(),
+  paidCents: field.bigint().default(0n),
+  authorizationId: field.uuid().nullable(),
+  at: field.timestamp().default('now'),
+}, {
+  indexes: (t) => ({
+    byTenantTime: index('idx_credit_line_entry_tenant_at').on(t['tenantId'], t['at'], t['id']),
+  }),
+})
+
+export const creditLinePayment = define('credit_line_payment', {
+  id: field.uuid().defaultRandom().primaryKey(),
+  tenantId: field.uuid().tenant(),
+  reference: field.text(),
+  amountCents: field.bigint(),
+  unappliedCents: field.bigint(),
+  at: field.timestamp().default('now'),
+}, {
+  indexes: (t) => ({
+    byReference: uniqueIndex('uq_credit_line_payment_reference').on(t['tenantId'], t['reference']),
+  }),
+})
+
+export const creditLinePaymentApplication = define('credit_line_payment_application', {
+  id: field.uuid().defaultRandom().primaryKey(),
+  tenantId: field.uuid().tenant(),
+  paymentId: field.uuid(),
+  entryId: field.uuid(),
+  cents: field.bigint(),
+}, {
+  indexes: (t) => ({
+    byPayment: index('idx_credit_line_application_payment').on(t['tenantId'], t['paymentId']),
+    byEntry: index('idx_credit_line_application_entry').on(t['tenantId'], t['entryId']),
+  }),
+})
+
+export const creditLineAuthorization = define('credit_line_authorization', {
+  id: field.uuid().defaultRandom().primaryKey(),
+  tenantId: field.uuid().tenant(),
+  reference: field.text(),
+  amountCents: field.bigint(),
+  startsAt: field.timestamp(),
+  endsAt: field.timestamp(),
+  replacesCaps: field.jsonb(schema.check.json()),
+  revokedAt: field.timestamp().nullable(),
+  createdAt: field.timestamp().default('now'),
+}, {
+  indexes: (t) => ({
+    byReference: uniqueIndex('uq_credit_line_authorization_reference').on(t['tenantId'], t['reference']),
+  }),
+})