@noodleseed/one 0.46.0 → 0.48.0

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-reconciliation.js

@@ -0,0 +1,304 @@
+import { randomUUID } from 'node:crypto';
+import { readBillingMeterTransactionTime } from './postgres-meter-clock.js';
+import { BILLING_METER_CLEAN_WINDOW_RECONCILIATION_INTERVAL_MS, BILLING_METER_FAILED_WINDOW_RECONCILIATION_DELAY_MS, BILLING_METER_INTEGRITY_MODULUS, billingMeterWindowLockKey, } from './postgres-meter-window-lock.js';
+import { validateScalarId } from './postgres-records.js';
+import { normalizeBillingUsageInstant } from './usage-window.js';
+/** The session cannot be returned to a pool because advisory-lock ownership is uncertain. */
+export class BillingMeterConnectionUnsafeError extends Error {
+    constructor(cause) {
+        super('billing meter database session cannot be reused', { cause });
+        this.name = 'BillingMeterConnectionUnsafeError';
+    }
+}
+export async function reconcileBillingMeterWindow(pool, input) {
+    const client = await pool.connect();
+    let reusable = true;
+    try {
+        return await reconcileBillingMeterWindowOnClient(client, input);
+    }
+    catch (error) {
+        if (error instanceof BillingMeterConnectionUnsafeError)
+            reusable = false;
+        throw error;
+    }
+    finally {
+        client.release(reusable ? undefined : true);
+    }
+}
+/** Open checks remain lock-free for writers; only a due final seal owns the exclusive window lock. */
+export async function reconcileBillingMeterWindowOnClient(client, input) {
+    const identity = normalizeIdentity(input);
+    const runId = `bmrr_${randomUUID()}`;
+    const windowLockKey = billingMeterWindowLockKey(identity);
+    const preflight = await readPreflight(client, identity);
+    const finalLockRequired = isFinalDue(preflight, identity.windowEnd, preflight.checkedAt);
+    let windowLockHeld = false;
+    let reconciliationResult;
+    let reconciliationError;
+    try {
+        if (finalLockRequired) {
+            await client.query('SELECT pg_advisory_lock(hashtextextended($1, 0))', [windowLockKey]);
+            windowLockHeld = true;
+        }
+        await client.query('BEGIN ISOLATION LEVEL REPEATABLE READ');
+        const checkedAt = await readBillingMeterTransactionTime(client);
+        const meterWindow = await readWindowCheckpoint(client, identity);
+        if (meterWindow.sealed_at !== null) {
+            throw new Error('billing meter reconciliation window is sealed');
+        }
+        if (meterWindow.first_observed_at === null) {
+            throw new Error('billing meter reconciliation requires a validation window');
+        }
+        const receipts = [
+            safeCount(meterWindow.receipt_included_calls),
+            safeCount(meterWindow.receipt_overage_calls),
+            safeCount(meterWindow.receipt_denied_calls),
+        ];
+        const accounts = await readCounterCheckpoint(client, 'account', identity);
+        const organizations = await readCounterCheckpoint(client, 'organization', identity);
+        const accountMismatchDetected = !checkpointMatches(receipts, meterWindow.account_integrity_a, meterWindow.account_integrity_b, accounts);
+        const orgMismatchDetected = !checkpointMatches(receipts, meterWindow.org_integrity_a, meterWindow.org_integrity_b, organizations);
+        const status = !accountMismatchDetected && !orgMismatchDetected ? 'succeeded' : 'failed';
+        const epochRetiredAt = normalizeRetirement(meterWindow);
+        const sealBasis = deriveSealBasis({
+            status,
+            checkedAt,
+            windowEnd: identity.windowEnd,
+            epochRetiredAt,
+            windowLockHeld,
+        });
+        const sealed = sealBasis !== null;
+        const nextReconcileAt = sealed
+            ? null
+            : addMilliseconds(checkedAt, status === 'succeeded'
+                ? BILLING_METER_CLEAN_WINDOW_RECONCILIATION_INTERVAL_MS
+                : BILLING_METER_FAILED_WINDOW_RECONCILIATION_DELAY_MS);
+        await client.query(`INSERT INTO billing_meter_reconciliation_runs
+         (run_id, epoch_id, window_start, window_end, status, sealed, seal_basis,
+          epoch_retired_at,
+          receipt_included_calls, receipt_overage_calls, receipt_denied_calls,
+          account_included_calls, account_overage_calls, account_denied_calls,
+          org_included_calls, org_overage_calls, org_denied_calls,
+          account_integrity_mismatch, org_integrity_mismatch, checked_at, next_reconcile_at)
+       VALUES
+         ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15,
+          $16, $17, $18, $19, $20, $21)`, [
+            runId,
+            identity.epochId,
+            identity.windowStart,
+            identity.windowEnd,
+            status,
+            sealed,
+            sealBasis,
+            sealBasis === 'epoch_retired' ? epochRetiredAt : null,
+            ...receipts,
+            ...accounts.counts,
+            ...organizations.counts,
+            accountMismatchDetected,
+            orgMismatchDetected,
+            checkedAt,
+            nextReconcileAt,
+        ]);
+        if (status === 'failed') {
+            const markedEpoch = await client.query(`UPDATE billing_meter_epochs
+         SET reconciliation_failed_at = least(
+           coalesce(reconciliation_failed_at, $2::timestamptz),
+           $2::timestamptz
+         )
+         WHERE id = $1`, [identity.epochId, checkedAt]);
+            if (markedEpoch.rowCount !== 1) {
+                throw new Error('billing meter reconciliation failure marker was not persisted');
+            }
+        }
+        if (sealed) {
+            const sealedWindow = await client.query(`UPDATE billing_meter_windows
+         SET sealed_at = $4
+         WHERE epoch_id = $1 AND window_start = $2 AND window_end = $3
+           AND sealed_at IS NULL`, [identity.epochId, identity.windowStart, identity.windowEnd, checkedAt]);
+            if (sealedWindow.rowCount !== 1) {
+                throw new Error('billing meter reconciliation window seal was not persisted');
+            }
+        }
+        await client.query('COMMIT');
+        reconciliationResult = {
+            runId,
+            status,
+            sealed,
+            sealBasis,
+            includedCalls: receipts[0],
+            overageCalls: receipts[1],
+            deniedCalls: receipts[2],
+            accountMismatchDetected,
+            orgMismatchDetected,
+            checkedAt,
+        };
+    }
+    catch (error) {
+        await rollbackQuietly(client);
+        reconciliationError = error;
+    }
+    if (windowLockHeld)
+        await releaseWindowLock(client, windowLockKey);
+    if (reconciliationError !== undefined)
+        throw reconciliationError;
+    if (reconciliationResult === undefined) {
+        throw new Error('billing meter reconciliation produced no result');
+    }
+    return reconciliationResult;
+}
+async function readPreflight(client, identity) {
+    const result = await client.query(`SELECT epoch.state, epoch.retired_at,
+            billing_meter_transaction_time() AS checked_at, meter_window.sealed_at
+     FROM billing_meter_epochs AS epoch
+     JOIN billing_meter_windows AS meter_window ON meter_window.epoch_id = epoch.id
+     WHERE epoch.id = $1 AND meter_window.window_start = $2 AND meter_window.window_end = $3`, [identity.epochId, identity.windowStart, identity.windowEnd]);
+    const row = result.rows[0];
+    if (row === undefined)
+        throw new Error('billing meter reconciliation requires a validation window');
+    if (row.state !== 'prepared' && row.state !== 'retired') {
+        throw new Error('billing meter reconciliation requires a prepared or retired epoch');
+    }
+    if (row.sealed_at !== null)
+        throw new Error('billing meter reconciliation window is sealed');
+    return {
+        state: row.state,
+        retiredAt: row.retired_at === null
+            ? null
+            : normalizeBillingUsageInstant('billing meter epoch retirement', row.retired_at instanceof Date ? row.retired_at.toISOString() : row.retired_at),
+        checkedAt: normalizeBillingUsageInstant('billing meter reconciliation preflight', row.checked_at instanceof Date ? row.checked_at.toISOString() : row.checked_at),
+    };
+}
+async function readWindowCheckpoint(client, identity) {
+    const result = await client.query(`SELECT epoch.state, epoch.retired_at, meter_window.sealed_at,
+            meter_window.first_observed_at,
+            meter_window.receipt_included_calls::text,
+            meter_window.receipt_overage_calls::text,
+            meter_window.receipt_denied_calls::text,
+            meter_window.account_integrity_a::text,
+            meter_window.account_integrity_b::text,
+            meter_window.org_integrity_a::text,
+            meter_window.org_integrity_b::text
+     FROM billing_meter_epochs AS epoch
+     JOIN billing_meter_windows AS meter_window ON meter_window.epoch_id = epoch.id
+     WHERE epoch.id = $1 AND meter_window.window_start = $2 AND meter_window.window_end = $3`, [identity.epochId, identity.windowStart, identity.windowEnd]);
+    const row = result.rows[0];
+    if (row === undefined)
+        throw new Error('billing meter reconciliation requires a validation window');
+    if (row.state !== 'prepared' && row.state !== 'retired') {
+        throw new Error('billing meter reconciliation requires a prepared or retired epoch');
+    }
+    return row;
+}
+async function readCounterCheckpoint(client, scope, identity) {
+    const organization = scope === 'organization';
+    const table = organization ? 'billing_meter_org_windows' : 'billing_meter_account_windows';
+    const orgExpression = organization ? 'counter.org_slug' : "''";
+    const result = await client.query(`SELECT coalesce(sum(counter.included_calls), 0)::text AS included,
+            coalesce(sum(counter.overage_calls), 0)::text AS overage,
+            coalesce(sum(counter.denied_calls), 0)::text AS denied,
+            mod(coalesce(sum(
+              counter.included_calls::numeric * billing_meter_integrity_lane(
+                $4, counter.billing_account_id, ${orgExpression}, 'included', 1
+              ) +
+              counter.overage_calls::numeric * billing_meter_integrity_lane(
+                $4, counter.billing_account_id, ${orgExpression}, 'overage', 1
+              ) +
+              counter.denied_calls::numeric * billing_meter_integrity_lane(
+                $4, counter.billing_account_id, ${orgExpression}, 'denied', 1
+              )
+            ), 0), ${BILLING_METER_INTEGRITY_MODULUS})::numeric(19, 0)::text AS integrity_a,
+            mod(coalesce(sum(
+              counter.included_calls::numeric * billing_meter_integrity_lane(
+                $4, counter.billing_account_id, ${orgExpression}, 'included', 2
+              ) +
+              counter.overage_calls::numeric * billing_meter_integrity_lane(
+                $4, counter.billing_account_id, ${orgExpression}, 'overage', 2
+              ) +
+              counter.denied_calls::numeric * billing_meter_integrity_lane(
+                $4, counter.billing_account_id, ${orgExpression}, 'denied', 2
+              )
+            ), 0), ${BILLING_METER_INTEGRITY_MODULUS})::numeric(19, 0)::text AS integrity_b
+     FROM ${table} AS counter
+     WHERE counter.epoch_id = $1 AND counter.window_start = $2 AND counter.window_end = $3`, [identity.epochId, identity.windowStart, identity.windowEnd, scope]);
+    const row = result.rows[0];
+    if (row === undefined)
+        throw new Error('billing meter counter checkpoint returned no result');
+    return {
+        counts: [safeCount(row.included), safeCount(row.overage), safeCount(row.denied)],
+        integrityA: normalizeIntegrity(row.integrity_a),
+        integrityB: normalizeIntegrity(row.integrity_b),
+    };
+}
+function checkpointMatches(receiptCounts, receiptIntegrityA, receiptIntegrityB, counter) {
+    return (receiptCounts.every((value, index) => value === counter.counts[index]) &&
+        normalizeIntegrity(receiptIntegrityA) === counter.integrityA &&
+        normalizeIntegrity(receiptIntegrityB) === counter.integrityB);
+}
+function deriveSealBasis(input) {
+    if (input.status !== 'succeeded' || !input.windowLockHeld)
+        return null;
+    if (input.epochRetiredAt !== null &&
+        Date.parse(input.checkedAt) >= Date.parse(input.epochRetiredAt)) {
+        return 'epoch_retired';
+    }
+    return Date.parse(input.checkedAt) >= Date.parse(input.windowEnd) ? 'window_end' : null;
+}
+function normalizeRetirement(row) {
+    if (row.state !== 'retired' || row.retired_at === null)
+        return null;
+    return normalizeBillingUsageInstant('billing meter epoch retirement', row.retired_at instanceof Date ? row.retired_at.toISOString() : row.retired_at);
+}
+function isFinalDue(epoch, windowEnd, checkedAt) {
+    return (Date.parse(checkedAt) >= Date.parse(windowEnd) ||
+        (epoch.state === 'retired' &&
+            epoch.retiredAt !== null &&
+            Date.parse(checkedAt) >= Date.parse(epoch.retiredAt)));
+}
+function normalizeIdentity(input) {
+    const identity = {
+        epochId: validateScalarId('billing meter epoch id', input.epochId),
+        windowStart: normalizeBillingUsageInstant('billing meter window start', input.windowStart),
+        windowEnd: normalizeBillingUsageInstant('billing meter window end', input.windowEnd),
+    };
+    if (Date.parse(identity.windowEnd) <= Date.parse(identity.windowStart)) {
+        throw new Error('billing meter reconciliation window is invalid');
+    }
+    return identity;
+}
+function addMilliseconds(value, milliseconds) {
+    return new Date(Date.parse(value) + milliseconds).toISOString();
+}
+function normalizeIntegrity(value) {
+    const normalized = BigInt(value);
+    if (normalized < 0n || normalized >= BigInt(BILLING_METER_INTEGRITY_MODULUS)) {
+        throw new Error('billing meter integrity checkpoint is invalid');
+    }
+    return normalized.toString();
+}
+function safeCount(value) {
+    const count = Number(value);
+    if (!Number.isSafeInteger(count) || count < 0) {
+        throw new Error('billing meter count exceeds the supported safe integer range');
+    }
+    return count;
+}
+async function releaseWindowLock(client, windowLockKey) {
+    try {
+        const unlocked = await client.query('SELECT pg_advisory_unlock(hashtextextended($1, 0)) AS unlocked', [windowLockKey]);
+        if (unlocked.rows[0]?.unlocked !== true) {
+            throw new Error('billing meter window lock ownership was not confirmed');
+        }
+    }
+    catch (error) {
+        throw new BillingMeterConnectionUnsafeError(error);
+    }
+}
+async function rollbackQuietly(client) {
+    try {
+        await client.query('ROLLBACK');
+    }
+    catch {
+        // Preserve the original reconciliation failure.
+    }
+}
+//# sourceMappingURL=postgres-meter-reconciliation.js.map

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-reconciliation.js.map

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

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-retention.d.ts

@@ -0,0 +1,22 @@
+import type { PoolClient } from 'pg';
+export interface BillingMeterReceiptRetirementResult {
+    readonly partitionsDropped: number;
+    readonly receiptsDeleted: number;
+}
+export interface BillingMeterExpiredRowRetirementResult {
+    readonly tombstonesDeleted: number;
+    readonly accountWindowsDeleted: number;
+    readonly orgWindowsDeleted: number;
+    readonly meterWindowsDeleted: number;
+}
+export interface BillingMeterRetentionBatchLimits {
+    readonly batchSize: number;
+    readonly maxBatchesPerTarget: number;
+}
+export declare const DEFAULT_BILLING_METER_RETENTION_BATCH_LIMITS: Readonly<{
+    batchSize: 25000;
+    maxBatchesPerTarget: 40;
+}>;
+export declare function retireExpiredBillingMeterReceipts(client: PoolClient, decisionAt: string, limits?: BillingMeterRetentionBatchLimits): Promise<BillingMeterReceiptRetirementResult>;
+export declare function retireExpiredBillingMeterRows(client: PoolClient, decisionAt: string, limits?: BillingMeterRetentionBatchLimits): Promise<BillingMeterExpiredRowRetirementResult>;
+//# sourceMappingURL=postgres-meter-retention.d.ts.map

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-meter-retention.d.ts","sourceRoot":"","sources":["../../src/billing/postgres-meter-retention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAIrC,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,eAAO,MAAM,4CAA4C;;;EAGZ,CAAC;AAgB9C,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,gCAA+E,GACtF,OAAO,CAAC,mCAAmC,CAAC,CAuF9C;AAED,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,gCAA+E,GACtF,OAAO,CAAC,sCAAsC,CAAC,CA+BjD"}

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-retention.js

@@ -0,0 +1,224 @@
+import { BILLING_METER_RECEIPT_RETENTION_DAYS } from './meter-readiness.js';
+import { parseBillingMeterPartitionRange } from './postgres-meter-partition.js';
+export const DEFAULT_BILLING_METER_RETENTION_BATCH_LIMITS = Object.freeze({
+    batchSize: 25_000,
+    maxBatchesPerTarget: 40,
+});
+const PARTITION_DROP_LOCK_TIMEOUT = '100ms';
+const PARTITION_DROP_STATEMENT_TIMEOUT = '5s';
+export async function retireExpiredBillingMeterReceipts(client, decisionAt, limits = DEFAULT_BILLING_METER_RETENTION_BATCH_LIMITS) {
+    const bounded = validateBatchLimits(limits);
+    await client.query(`SELECT set_config('noodle.billing_meter_receipt_maintenance', 'on', true)`);
+    const decisionTime = Date.parse(decisionAt);
+    if (!Number.isFinite(decisionTime)) {
+        throw new Error('billing meter receipt retirement decision is invalid');
+    }
+    const partitions = await client.query(`
+    SELECT child.relname AS name,
+           format('%I.%I', namespace.nspname, child.relname) AS relation,
+           pg_get_expr(child.relpartbound, child.oid) AS bound
+    FROM pg_inherits
+    JOIN pg_class AS parent ON parent.oid = pg_inherits.inhparent
+    JOIN pg_class AS child ON child.oid = pg_inherits.inhrelid
+    JOIN pg_namespace AS namespace ON namespace.oid = child.relnamespace
+    WHERE parent.oid = 'billing_meter_usage_events'::regclass
+    ORDER BY namespace.nspname, child.relname
+  `);
+    for (const partition of partitions.rows) {
+        validatePartition(partition);
+    }
+    let receiptsDeleted = 0;
+    let receiptBatches = 0;
+    const dropCandidates = [];
+    for (const partition of partitions.rows) {
+        const range = parseBillingMeterPartitionRange(partition.bound);
+        if (range === undefined)
+            throw new Error('billing meter receipt partition bound is invalid');
+        if (Date.parse(range.start) > decisionTime)
+            continue;
+        const oldPartition = Date.parse(range.end) <= decisionTime;
+        if (oldPartition && (await partitionIsFullyRetirable(client, range, decisionAt))) {
+            dropCandidates.push(partition);
+            continue;
+        }
+        while (receiptBatches < bounded.maxBatchesPerTarget) {
+            const deleted = await client.query(`WITH candidates AS MATERIALIZED (
+           SELECT receipt.ctid
+         FROM ${partition.relation} AS receipt
+         WHERE receipt.retention_until <= $1
+           AND EXISTS (
+             SELECT 1
+             FROM billing_meter_reconciliation_runs AS reconciliation
+             WHERE reconciliation.epoch_id = receipt.epoch_id
+               AND reconciliation.window_start = receipt.window_start
+               AND reconciliation.window_end = receipt.window_end
+               AND reconciliation.sealed
+               AND reconciliation.status = 'succeeded'
+               AND NOT reconciliation.account_integrity_mismatch
+               AND NOT reconciliation.org_integrity_mismatch
+               AND (
+                 (
+                   reconciliation.seal_basis = 'window_end' AND
+                   reconciliation.checked_at >= receipt.window_end
+                 ) OR (
+                   reconciliation.seal_basis = 'epoch_retired' AND
+                   reconciliation.epoch_retired_at IS NOT NULL AND
+                   reconciliation.checked_at >= reconciliation.epoch_retired_at
+                 )
+               )
+           )
+         ORDER BY receipt.retention_until, receipt.ctid
+         LIMIT $2
+         FOR UPDATE OF receipt SKIP LOCKED
+       )
+       DELETE FROM ${partition.relation} AS receipt
+       USING candidates
+       WHERE receipt.ctid = candidates.ctid`, [decisionAt, bounded.batchSize]);
+            const rowCount = safeRowCount(deleted.rowCount);
+            receiptsDeleted += rowCount;
+            receiptBatches += 1;
+            if (rowCount < bounded.batchSize)
+                break;
+        }
+        if (oldPartition && (await partitionIsFullyRetirable(client, range, decisionAt))) {
+            dropCandidates.push(partition);
+        }
+    }
+    let partitionsDropped = 0;
+    for (const partition of dropCandidates) {
+        if (await dropEmptyOldPartition(client, partition, decisionAt)) {
+            partitionsDropped += 1;
+        }
+    }
+    return { partitionsDropped, receiptsDeleted };
+}
+export async function retireExpiredBillingMeterRows(client, decisionAt, limits = DEFAULT_BILLING_METER_RETENTION_BATCH_LIMITS) {
+    const bounded = validateBatchLimits(limits);
+    const tombstonesDeleted = await deleteExpiredRowsInBatches(client, 'billing_meter_exact_key_tombstones', decisionAt, bounded);
+    const accountWindowsDeleted = await deleteExpiredRowsInBatches(client, 'billing_meter_account_windows', decisionAt, bounded);
+    const orgWindowsDeleted = await deleteExpiredRowsInBatches(client, 'billing_meter_org_windows', decisionAt, bounded);
+    return {
+        tombstonesDeleted,
+        accountWindowsDeleted,
+        orgWindowsDeleted,
+        meterWindowsDeleted: await deleteExpiredRowsInBatches(client, 'billing_meter_windows', decisionAt, bounded),
+    };
+}
+async function deleteExpiredRowsInBatches(client, table, decisionAt, limits) {
+    let deleted = 0;
+    for (let batch = 0; batch < limits.maxBatchesPerTarget; batch += 1) {
+        const result = await client.query(`WITH candidates AS MATERIALIZED (
+         SELECT target.ctid
+         FROM ${table} AS target
+         WHERE target.retention_until <= $1
+           ${table === 'billing_meter_windows'
+            ? `AND target.sealed_at IS NOT NULL
+                  AND NOT EXISTS (
+                    SELECT 1 FROM billing_meter_usage_events AS receipt
+                    WHERE receipt.epoch_id = target.epoch_id
+                      AND receipt.window_start = target.window_start
+                      AND receipt.window_end = target.window_end
+                  )`
+            : ''}
+         ORDER BY target.retention_until, target.ctid
+         LIMIT $2
+         FOR UPDATE OF target SKIP LOCKED
+       )
+       DELETE FROM ${table} AS target
+       USING candidates
+       WHERE target.ctid = candidates.ctid`, [decisionAt, limits.batchSize]);
+        const rowCount = safeRowCount(result.rowCount);
+        deleted += rowCount;
+        if (rowCount < limits.batchSize)
+            break;
+    }
+    return deleted;
+}
+async function dropEmptyOldPartition(client, partition, decisionAt) {
+    const prior = await client.query(`SELECT current_setting('lock_timeout') AS lock_timeout,
+            current_setting('statement_timeout') AS statement_timeout`);
+    const timeouts = prior.rows[0];
+    if (timeouts === undefined)
+        throw new Error('billing meter timeout settings are unavailable');
+    await client.query('SAVEPOINT billing_meter_partition_drop');
+    try {
+        await client.query(`SELECT set_config('lock_timeout', $1, true),
+              set_config('statement_timeout', $2, true)`, [PARTITION_DROP_LOCK_TIMEOUT, PARTITION_DROP_STATEMENT_TIMEOUT]);
+        await client.query(`LOCK TABLE ${partition.relation} IN ACCESS EXCLUSIVE MODE NOWAIT`);
+        const attached = await client.query(`SELECT pg_get_expr(child.relpartbound, child.oid) AS bound
+       FROM pg_inherits
+       JOIN pg_class AS parent ON parent.oid = pg_inherits.inhparent
+       JOIN pg_class AS child ON child.oid = pg_inherits.inhrelid
+       WHERE parent.oid = 'billing_meter_usage_events'::regclass
+         AND child.oid = $1::regclass`, [partition.relation]);
+        const range = parseBillingMeterPartitionRange(attached.rows[0]?.bound ?? '');
+        if (range === undefined ||
+            Date.parse(range.end) > Date.parse(decisionAt) ||
+            !(await partitionIsFullyRetirable(client, range, decisionAt))) {
+            await client.query('ROLLBACK TO SAVEPOINT billing_meter_partition_drop');
+            await client.query('RELEASE SAVEPOINT billing_meter_partition_drop');
+            return false;
+        }
+        await client.query(`DROP TABLE ${partition.relation}`);
+        await client.query('RELEASE SAVEPOINT billing_meter_partition_drop');
+    }
+    catch (error) {
+        await client.query('ROLLBACK TO SAVEPOINT billing_meter_partition_drop');
+        await client.query('RELEASE SAVEPOINT billing_meter_partition_drop');
+        if (isBoundedLockFailure(error))
+            return false;
+        throw error;
+    }
+    await client.query(`SELECT set_config('lock_timeout', $1, true),
+            set_config('statement_timeout', $2, true)`, [timeouts.lock_timeout, timeouts.statement_timeout]);
+    return true;
+}
+async function partitionIsFullyRetirable(client, range, decisionAt) {
+    const registryTable = await client.query(`SELECT to_regclass('billing_meter_windows') IS NOT NULL AS present`);
+    if (registryTable.rows[0]?.present !== true)
+        return false;
+    const registry = await client.query(`SELECT NOT EXISTS (
+       SELECT 1
+       FROM billing_meter_windows
+       WHERE first_observed_at < $2
+         AND last_observed_at >= $1
+         AND (
+           sealed_at IS NULL OR
+           window_end + interval '${BILLING_METER_RECEIPT_RETENTION_DAYS} days' > $3
+         )
+     ) AS all_receipts_sealed`, [range.start, range.end, decisionAt]);
+    return registry.rows[0]?.all_receipts_sealed === true;
+}
+function validatePartition(partition) {
+    if (!/^billing_meter_usage_events_y\d{4}m\d{2}$/.test(partition.name)) {
+        throw new Error('billing meter receipt partition has an invalid name');
+    }
+    if (parseBillingMeterPartitionRange(partition.bound) === undefined) {
+        throw new Error('billing meter receipt partition bound is invalid');
+    }
+}
+function safeRowCount(value) {
+    if (value === null || !Number.isSafeInteger(value) || value < 0) {
+        throw new Error('billing meter maintenance returned an invalid row count');
+    }
+    return value;
+}
+function isBoundedLockFailure(error) {
+    if (typeof error !== 'object' || error === null || !('code' in error))
+        return false;
+    return error.code === '55P03' || error.code === '57014';
+}
+function validateBatchLimits(limits) {
+    if (!Number.isSafeInteger(limits.batchSize) ||
+        limits.batchSize < 1 ||
+        limits.batchSize > 100_000) {
+        throw new Error('billing meter retention batch size is invalid');
+    }
+    if (!Number.isSafeInteger(limits.maxBatchesPerTarget) ||
+        limits.maxBatchesPerTarget < 1 ||
+        limits.maxBatchesPerTarget > 100) {
+        throw new Error('billing meter retention batch count is invalid');
+    }
+    return limits;
+}
+//# sourceMappingURL=postgres-meter-retention.js.map

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-retention.js.map

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

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-runtime.d.ts

@@ -0,0 +1,33 @@
+import type { Logger } from '@noodle-borg/transport-http';
+import type { Pool } from 'pg';
+import type { BillingMeterReadinessStore } from './meter-readiness.js';
+import { type BillingMeterLiveRuntimeExpectation } from './meter-readiness-health.js';
+import type { BillingMeterValidationRuntimeConfig } from './meter-runtime-config.js';
+import { type BillingMeterValidationEpochStore } from './meter-validation-epoch.js';
+import { type BillingMeterSchedulerOperations } from './postgres-meter-scheduler.js';
+import type { BillingUsageObserver } from './usage-observer.js';
+import type { BillingUsageStore } from './usage-store.js';
+export interface PostgresBillingMeterRuntime {
+    readonly readinessStore: BillingMeterReadinessStore;
+    readonly validationEpochStore: BillingMeterValidationEpochStore;
+    readonly observer?: BillingUsageObserver;
+    start(): void;
+    stop(): Promise<void>;
+}
+export declare function createPostgresBillingMeterRuntime(input: {
+    readonly pool: Pool;
+    readonly usageStore: BillingUsageStore;
+    readonly billingUsageHmacKey?: string;
+    readonly releaseSha: string;
+    readonly validation?: BillingMeterValidationRuntimeConfig;
+    /** Test-only orchestration seam; production always uses the durable scheduler operations. */
+    readonly schedulerOperations?: BillingMeterSchedulerOperations;
+    readonly clock?: () => Date;
+    readonly logger: Logger;
+}): Promise<PostgresBillingMeterRuntime>;
+export declare function resolvePostgresBillingMeterRuntimeExpectation(input: {
+    readonly billingUsageHmacKey?: string;
+    readonly releaseSha: string;
+    readonly validation?: BillingMeterValidationRuntimeConfig;
+}): BillingMeterLiveRuntimeExpectation | undefined;
+//# sourceMappingURL=postgres-meter-runtime.d.ts.map

package/node_modules/@noodle-borg/service/dist/billing/postgres-meter-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-meter-runtime.d.ts","sourceRoot":"","sources":["../../src/billing/postgres-meter-runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAM/B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAKvE,OAAO,EAEL,KAAK,kCAAkC,EACxC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAEL,KAAK,+BAA+B,EAGrC,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,cAAc,EAAE,0BAA0B,CAAC;IACpD,QAAQ,CAAC,oBAAoB,EAAE,gCAAgC,CAAC;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IACzC,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,wBAAsB,iCAAiC,CAAC,KAAK,EAAE;IAC7D,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,mCAAmC,CAAC;IAC1D,6FAA6F;IAC7F,QAAQ,CAAC,mBAAmB,CAAC,EAAE,+BAA+B,CAAC;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CA2DvC;AA0FD,wBAAgB,6CAA6C,CAAC,KAAK,EAAE;IACnE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,mCAAmC,CAAC;CAC3D,GAAG,kCAAkC,GAAG,SAAS,CAmBjD"}