@noodleseed/one 0.46.0 → 0.47.0

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

@@ -0,0 +1,414 @@
+import { BILLING_METER_AGGREGATE_RETENTION_MONTHS, BILLING_METER_EXACT_KEY_TOMBSTONE_RETENTION_DAYS, BILLING_METER_PARTITION_HORIZON_MONTHS, BILLING_METER_READINESS_SCHEMA_VERSION, BILLING_METER_RECEIPT_RETENTION_DAYS, } from './meter-readiness.js';
+import { readBillingMeterTransactionTime } from './postgres-meter-clock.js';
+import { ensureBillingMeterReceiptIntegritySchema, ensureBillingMeterWindowRegistrySchema, } from './postgres-meter-window-schema.js';
+/** Additive, inactive storage for validation and readiness evidence. Never activates a meter epoch. */
+export async function ensureAuthoritativeMeterSchema(pool) {
+    await pool.query(`
+    CREATE OR REPLACE FUNCTION billing_meter_transaction_time() RETURNS timestamptz AS $$
+      SELECT pg_catalog.transaction_timestamp()
+    $$ LANGUAGE sql STABLE PARALLEL SAFE
+  `);
+    await pool.query(`
+    CREATE TABLE IF NOT EXISTS billing_meter_retention_policy (
+      singleton                  boolean PRIMARY KEY DEFAULT true CHECK (singleton),
+      schema_version             integer NOT NULL CHECK (schema_version = 1),
+      receipt_retention_days     integer NOT NULL CHECK (receipt_retention_days > 0),
+      tombstone_retention_days   integer NOT NULL CHECK (tombstone_retention_days > 0),
+      aggregate_retention_months integer NOT NULL CHECK (aggregate_retention_months > 0)
+    )
+  `);
+    await pool.query(`INSERT INTO billing_meter_retention_policy
+       (singleton, schema_version, receipt_retention_days, tombstone_retention_days,
+        aggregate_retention_months)
+     VALUES (true, $1, $2, $3, $4)
+     ON CONFLICT (singleton) DO NOTHING`, [
+        BILLING_METER_READINESS_SCHEMA_VERSION,
+        BILLING_METER_RECEIPT_RETENTION_DAYS,
+        BILLING_METER_EXACT_KEY_TOMBSTONE_RETENTION_DAYS,
+        BILLING_METER_AGGREGATE_RETENTION_MONTHS,
+    ]);
+    await pool.query(`
+    CREATE TABLE IF NOT EXISTS billing_meter_epochs (
+      id                     text PRIMARY KEY,
+      schema_version         integer NOT NULL CHECK (schema_version = 1),
+      state                  text NOT NULL CHECK (state IN ('prepared', 'active', 'retired')),
+      key_generation         text NOT NULL,
+      release_sha            text NOT NULL CHECK (release_sha ~ '^[0-9a-f]{40}$'),
+      retry_identity_version integer NOT NULL CHECK (retry_identity_version > 0),
+      writer_contract_version integer NOT NULL DEFAULT 1 CHECK (writer_contract_version > 0),
+      prepared_at            timestamptz NOT NULL,
+      reconciliation_failed_at timestamptz,
+      activated_at           timestamptz,
+      retired_at             timestamptz,
+      CHECK (
+        (state = 'prepared' AND activated_at IS NULL AND retired_at IS NULL) OR
+        (state = 'active' AND activated_at IS NOT NULL AND retired_at IS NULL) OR
+        (state = 'retired' AND retired_at IS NOT NULL)
+      )
+    )
+  `);
+    await pool.query(`
+    ALTER TABLE billing_meter_epochs
+      ADD COLUMN IF NOT EXISTS writer_contract_version integer NOT NULL DEFAULT 1,
+      ADD COLUMN IF NOT EXISTS reconciliation_failed_at timestamptz
+  `);
+    await pool.query(`
+    CREATE UNIQUE INDEX IF NOT EXISTS billing_meter_epochs_one_active_idx
+      ON billing_meter_epochs ((state))
+      WHERE state = 'active'
+  `);
+    await pool.query(`
+    CREATE UNIQUE INDEX IF NOT EXISTS billing_meter_epochs_one_prepared_idx
+      ON billing_meter_epochs ((state))
+      WHERE state = 'prepared'
+  `);
+    await ensureBillingMeterWindowRegistrySchema(pool);
+    await pool.query(`
+    CREATE TABLE IF NOT EXISTS billing_meter_epoch_operations (
+      operation_id         text PRIMARY KEY,
+      action               text NOT NULL
+        CHECK (action IN ('validation_prepare', 'validation_retire')),
+      idempotency_key_hash text NOT NULL UNIQUE
+        CHECK (idempotency_key_hash ~ '^[0-9a-f]{64}$'),
+      request_fingerprint  text NOT NULL
+        CHECK (request_fingerprint ~ '^[0-9a-f]{64}$'),
+      epoch_id             text NOT NULL REFERENCES billing_meter_epochs(id) ON DELETE RESTRICT,
+      result               jsonb NOT NULL,
+      actor_subject        text NOT NULL,
+      actor_email          text NOT NULL,
+      service_origin       text NOT NULL,
+      reason               text NOT NULL,
+      created_at           timestamptz NOT NULL,
+      UNIQUE (action, epoch_id)
+    )
+  `);
+    await pool.query(`
+    CREATE TABLE IF NOT EXISTS billing_meter_usage_events (
+      event_id                  text NOT NULL,
+      epoch_id                  text NOT NULL REFERENCES billing_meter_epochs(id) ON DELETE RESTRICT,
+      mode                      text NOT NULL CHECK (mode = 'validation'),
+      high_confidence_key_hash  bytea,
+      fallback_fingerprint      bytea NOT NULL,
+      semantic_fingerprint      bytea NOT NULL,
+      classification            text NOT NULL CHECK (classification IN ('included', 'overage', 'denied')),
+      billing_account_id        text NOT NULL REFERENCES billing_accounts(id) ON DELETE RESTRICT,
+      org_slug                  text NOT NULL,
+      app_slug                  text NOT NULL,
+      environment               text NOT NULL,
+      deployment_id             text NOT NULL,
+      link_version              integer NOT NULL CHECK (link_version > 0),
+      snapshot_id               text NOT NULL,
+      snapshot_version          integer NOT NULL CHECK (snapshot_version > 0),
+      admitted_at               timestamptz NOT NULL,
+      window_start              timestamptz NOT NULL,
+      window_end                timestamptz NOT NULL CHECK (window_end > window_start),
+      recorded_at               timestamptz NOT NULL,
+      retention_until           timestamptz NOT NULL,
+      PRIMARY KEY (recorded_at, event_id),
+      CHECK (high_confidence_key_hash IS NULL OR octet_length(high_confidence_key_hash) = 32),
+      CHECK (octet_length(fallback_fingerprint) = 32),
+      CHECK (octet_length(semantic_fingerprint) = 32),
+      CHECK (retention_until = window_end + interval '${BILLING_METER_RECEIPT_RETENTION_DAYS} days'),
+      CONSTRAINT billing_meter_usage_events_window_fkey
+      FOREIGN KEY (epoch_id, window_start, window_end)
+        REFERENCES billing_meter_windows(epoch_id, window_start, window_end) ON DELETE RESTRICT,
+      FOREIGN KEY (billing_account_id, snapshot_id)
+        REFERENCES billing_entitlement_snapshots(billing_account_id, id) ON DELETE RESTRICT
+    ) PARTITION BY RANGE (recorded_at)
+  `);
+    await ensureBillingMeterReceiptIntegritySchema(pool);
+    await pool.query(`
+    CREATE INDEX IF NOT EXISTS billing_meter_usage_events_fallback_idx
+      ON billing_meter_usage_events
+        (epoch_id, fallback_fingerprint, semantic_fingerprint, recorded_at DESC)
+  `);
+    await pool.query(`
+    DROP INDEX IF EXISTS billing_meter_usage_events_reconcile_idx
+  `);
+    await pool.query(`
+    CREATE INDEX IF NOT EXISTS billing_meter_usage_events_window_fkey_idx
+      ON billing_meter_usage_events (epoch_id, window_start, window_end)
+  `);
+    await pool.query(`
+    CREATE INDEX IF NOT EXISTS billing_meter_usage_events_retention_idx
+      ON billing_meter_usage_events (retention_until)
+  `);
+    await pool.query(`
+    CREATE TABLE IF NOT EXISTS billing_meter_exact_key_tombstones (
+      epoch_id             text NOT NULL REFERENCES billing_meter_epochs(id) ON DELETE RESTRICT,
+      key_hash             bytea NOT NULL CHECK (octet_length(key_hash) = 32),
+      semantic_fingerprint bytea NOT NULL CHECK (octet_length(semantic_fingerprint) = 32),
+      event_id             text NOT NULL,
+      classification       text NOT NULL CHECK (classification IN ('included', 'overage', 'denied')),
+      window_end           timestamptz NOT NULL,
+      created_at           timestamptz NOT NULL,
+      retention_until      timestamptz NOT NULL,
+      PRIMARY KEY (epoch_id, key_hash),
+      CHECK (
+        retention_until =
+          window_end + interval '${BILLING_METER_EXACT_KEY_TOMBSTONE_RETENTION_DAYS} days'
+      )
+    )
+  `);
+    await pool.query(`
+    CREATE INDEX IF NOT EXISTS billing_meter_exact_key_tombstones_retention_idx
+      ON billing_meter_exact_key_tombstones (retention_until)
+  `);
+    await pool.query(`
+    CREATE TABLE IF NOT EXISTS billing_meter_account_windows (
+      epoch_id           text NOT NULL REFERENCES billing_meter_epochs(id) ON DELETE RESTRICT,
+      billing_account_id text NOT NULL REFERENCES billing_accounts(id) ON DELETE RESTRICT,
+      window_start       timestamptz NOT NULL,
+      window_end         timestamptz NOT NULL CHECK (window_end > window_start),
+      included_calls     bigint NOT NULL CHECK (included_calls >= 0),
+      overage_calls      bigint NOT NULL CHECK (overage_calls >= 0),
+      denied_calls       bigint NOT NULL CHECK (denied_calls >= 0),
+      first_admitted_at  timestamptz NOT NULL,
+      last_admitted_at   timestamptz NOT NULL,
+      updated_at         timestamptz NOT NULL,
+      retention_until    timestamptz NOT NULL,
+      PRIMARY KEY (epoch_id, billing_account_id, window_start),
+      FOREIGN KEY (epoch_id, window_start, window_end)
+        REFERENCES billing_meter_windows(epoch_id, window_start, window_end) ON DELETE RESTRICT,
+      CHECK (
+        retention_until =
+          window_end + interval '${BILLING_METER_AGGREGATE_RETENTION_MONTHS} months'
+      )
+    )
+  `);
+    await pool.query(`
+    CREATE INDEX IF NOT EXISTS billing_meter_account_windows_retention_idx
+      ON billing_meter_account_windows (retention_until)
+  `);
+    await pool.query(`
+    CREATE INDEX IF NOT EXISTS billing_meter_account_windows_reconcile_idx
+      ON billing_meter_account_windows (epoch_id, window_start, window_end)
+      INCLUDE (billing_account_id, included_calls, overage_calls, denied_calls)
+  `);
+    await pool.query(`
+    CREATE TABLE IF NOT EXISTS billing_meter_org_windows (
+      epoch_id           text NOT NULL REFERENCES billing_meter_epochs(id) ON DELETE RESTRICT,
+      billing_account_id text NOT NULL REFERENCES billing_accounts(id) ON DELETE RESTRICT,
+      org_slug           text NOT NULL,
+      window_start       timestamptz NOT NULL,
+      window_end         timestamptz NOT NULL CHECK (window_end > window_start),
+      included_calls     bigint NOT NULL CHECK (included_calls >= 0),
+      overage_calls      bigint NOT NULL CHECK (overage_calls >= 0),
+      denied_calls       bigint NOT NULL CHECK (denied_calls >= 0),
+      first_admitted_at  timestamptz NOT NULL,
+      last_admitted_at   timestamptz NOT NULL,
+      updated_at         timestamptz NOT NULL,
+      retention_until    timestamptz NOT NULL,
+      PRIMARY KEY (epoch_id, billing_account_id, org_slug, window_start),
+      FOREIGN KEY (epoch_id, window_start, window_end)
+        REFERENCES billing_meter_windows(epoch_id, window_start, window_end) ON DELETE RESTRICT,
+      CHECK (
+        retention_until =
+          window_end + interval '${BILLING_METER_AGGREGATE_RETENTION_MONTHS} months'
+      )
+    )
+  `);
+    await pool.query(`
+    CREATE INDEX IF NOT EXISTS billing_meter_org_windows_retention_idx
+      ON billing_meter_org_windows (retention_until)
+  `);
+    await pool.query(`
+    CREATE INDEX IF NOT EXISTS billing_meter_org_windows_reconcile_idx
+      ON billing_meter_org_windows (epoch_id, window_start, window_end)
+      INCLUDE (billing_account_id, org_slug, included_calls, overage_calls, denied_calls)
+  `);
+    await pool.query(`
+    CREATE TABLE IF NOT EXISTS billing_meter_maintenance_runs (
+      run_id                  text PRIMARY KEY,
+      status                  text NOT NULL CHECK (status IN ('running', 'succeeded', 'failed')),
+      started_at              timestamptz NOT NULL,
+      completed_at            timestamptz,
+      partition_horizon       timestamptz,
+      receipt_partitions_dropped bigint NOT NULL DEFAULT 0
+        CHECK (receipt_partitions_dropped >= 0),
+      receipts_deleted        bigint NOT NULL DEFAULT 0 CHECK (receipts_deleted >= 0),
+      tombstones_deleted      bigint NOT NULL DEFAULT 0 CHECK (tombstones_deleted >= 0),
+      account_windows_deleted bigint NOT NULL DEFAULT 0 CHECK (account_windows_deleted >= 0),
+      org_windows_deleted     bigint NOT NULL DEFAULT 0 CHECK (org_windows_deleted >= 0),
+      meter_windows_deleted   bigint NOT NULL DEFAULT 0 CHECK (meter_windows_deleted >= 0),
+      reconciliation_runs_deleted bigint NOT NULL DEFAULT 0
+        CHECK (reconciliation_runs_deleted >= 0),
+      scheduler_runs_deleted  bigint NOT NULL DEFAULT 0 CHECK (scheduler_runs_deleted >= 0),
+      maintenance_runs_deleted bigint NOT NULL DEFAULT 0
+        CHECK (maintenance_runs_deleted >= 0),
+      writer_sessions_compacted bigint NOT NULL DEFAULT 0 CHECK (writer_sessions_compacted >= 0),
+      writer_baselines_folded bigint NOT NULL DEFAULT 0 CHECK (writer_baselines_folded >= 0),
+      writer_clean_sessions_compacted bigint NOT NULL DEFAULT 0
+        CHECK (writer_clean_sessions_compacted >= 0),
+      writer_unclean_sessions_compacted bigint NOT NULL DEFAULT 0
+        CHECK (writer_unclean_sessions_compacted >= 0),
+      CHECK (
+        (status = 'running' AND completed_at IS NULL) OR
+        (status IN ('succeeded', 'failed') AND completed_at IS NOT NULL)
+      )
+    )
+  `);
+    await pool.query(`
+    ALTER TABLE billing_meter_maintenance_runs
+      ADD COLUMN IF NOT EXISTS reconciliation_runs_deleted bigint NOT NULL DEFAULT 0
+        CHECK (reconciliation_runs_deleted >= 0),
+      ADD COLUMN IF NOT EXISTS meter_windows_deleted bigint NOT NULL DEFAULT 0
+        CHECK (meter_windows_deleted >= 0),
+      ADD COLUMN IF NOT EXISTS scheduler_runs_deleted bigint NOT NULL DEFAULT 0
+        CHECK (scheduler_runs_deleted >= 0),
+      ADD COLUMN IF NOT EXISTS maintenance_runs_deleted bigint NOT NULL DEFAULT 0
+        CHECK (maintenance_runs_deleted >= 0),
+      ADD COLUMN IF NOT EXISTS writer_sessions_compacted bigint NOT NULL DEFAULT 0
+        CHECK (writer_sessions_compacted >= 0),
+      ADD COLUMN IF NOT EXISTS writer_baselines_folded bigint NOT NULL DEFAULT 0
+        CHECK (writer_baselines_folded >= 0),
+      ADD COLUMN IF NOT EXISTS writer_clean_sessions_compacted bigint NOT NULL DEFAULT 0
+        CHECK (writer_clean_sessions_compacted >= 0),
+      ADD COLUMN IF NOT EXISTS writer_unclean_sessions_compacted bigint NOT NULL DEFAULT 0
+        CHECK (writer_unclean_sessions_compacted >= 0)
+  `);
+    await pool.query(`
+    CREATE INDEX IF NOT EXISTS billing_meter_maintenance_runs_completed_idx
+      ON billing_meter_maintenance_runs (completed_at DESC)
+      WHERE status = 'succeeded'
+  `);
+    await pool.query(`
+    CREATE TABLE IF NOT EXISTS billing_meter_reconciliation_runs (
+      run_id                 text PRIMARY KEY,
+      epoch_id               text NOT NULL REFERENCES billing_meter_epochs(id) ON DELETE RESTRICT,
+      window_start           timestamptz NOT NULL,
+      window_end             timestamptz NOT NULL CHECK (window_end > window_start),
+      status                 text NOT NULL CHECK (status IN ('succeeded', 'failed')),
+      sealed                 boolean NOT NULL,
+      seal_basis             text CHECK (seal_basis IN ('window_end', 'epoch_retired')),
+      epoch_retired_at       timestamptz,
+      receipt_included_calls bigint NOT NULL CHECK (receipt_included_calls >= 0),
+      receipt_overage_calls  bigint NOT NULL CHECK (receipt_overage_calls >= 0),
+      receipt_denied_calls   bigint NOT NULL CHECK (receipt_denied_calls >= 0),
+      account_included_calls bigint NOT NULL CHECK (account_included_calls >= 0),
+      account_overage_calls  bigint NOT NULL CHECK (account_overage_calls >= 0),
+      account_denied_calls   bigint NOT NULL CHECK (account_denied_calls >= 0),
+      org_included_calls     bigint NOT NULL CHECK (org_included_calls >= 0),
+      org_overage_calls      bigint NOT NULL CHECK (org_overage_calls >= 0),
+      org_denied_calls       bigint NOT NULL CHECK (org_denied_calls >= 0),
+      account_integrity_mismatch boolean NOT NULL,
+      org_integrity_mismatch     boolean NOT NULL,
+      checked_at             timestamptz NOT NULL,
+      next_reconcile_at      timestamptz,
+      CHECK (
+        (
+          NOT sealed AND seal_basis IS NULL AND epoch_retired_at IS NULL
+        ) OR (
+          sealed AND status = 'succeeded' AND (
+            (
+              seal_basis = 'window_end' AND epoch_retired_at IS NULL AND
+              checked_at >= window_end
+            ) OR (
+              seal_basis = 'epoch_retired' AND epoch_retired_at IS NOT NULL AND
+              checked_at >= epoch_retired_at
+            )
+          )
+        )
+      ),
+      CHECK (
+        status = 'failed' OR
+        (
+          receipt_included_calls = account_included_calls AND
+          receipt_included_calls = org_included_calls AND
+          receipt_overage_calls = account_overage_calls AND
+          receipt_overage_calls = org_overage_calls AND
+          receipt_denied_calls = account_denied_calls AND
+          receipt_denied_calls = org_denied_calls AND
+          NOT account_integrity_mismatch AND
+          NOT org_integrity_mismatch
+        )
+      )
+    )
+  `);
+    await pool.query(`
+    ALTER TABLE billing_meter_reconciliation_runs
+      ADD COLUMN IF NOT EXISTS next_reconcile_at timestamptz
+  `);
+    await pool.query(`
+    CREATE INDEX IF NOT EXISTS billing_meter_reconciliation_runs_latest_idx
+      ON billing_meter_reconciliation_runs (epoch_id, checked_at DESC)
+  `);
+    await pool.query(`
+    CREATE INDEX IF NOT EXISTS billing_meter_reconciliation_runs_due_idx
+      ON billing_meter_reconciliation_runs
+        (epoch_id, window_start, window_end, checked_at DESC, run_id DESC)
+      INCLUDE (status, sealed, next_reconcile_at)
+  `);
+    await pool.query(`
+    CREATE INDEX IF NOT EXISTS billing_meter_reconciliation_runs_compaction_idx
+      ON billing_meter_reconciliation_runs
+        (epoch_id, window_start, window_end, sealed DESC, checked_at DESC, run_id DESC)
+  `);
+    await pool.query(`
+    CREATE INDEX IF NOT EXISTS billing_meter_reconciliation_runs_failed_compaction_idx
+      ON billing_meter_reconciliation_runs
+        (epoch_id, window_start, window_end, checked_at DESC, run_id DESC)
+      WHERE status = 'failed'
+  `);
+    await pool.query(`
+    CREATE UNIQUE INDEX IF NOT EXISTS billing_meter_reconciliation_runs_one_sealed_idx
+      ON billing_meter_reconciliation_runs (epoch_id, window_start, window_end)
+      WHERE sealed
+  `);
+    await pool.query(`
+    CREATE OR REPLACE FUNCTION billing_meter_mark_reconciliation_failure()
+    RETURNS trigger AS $$
+    BEGIN
+      UPDATE billing_meter_epochs
+      SET reconciliation_failed_at = least(
+        coalesce(reconciliation_failed_at, NEW.checked_at),
+        NEW.checked_at
+      )
+      WHERE id = NEW.epoch_id;
+      RETURN NEW;
+    END
+    $$ LANGUAGE plpgsql
+  `);
+    await pool.query(`
+    CREATE OR REPLACE TRIGGER billing_meter_mark_reconciliation_failure
+    AFTER INSERT ON billing_meter_reconciliation_runs
+    FOR EACH ROW
+    WHEN (NEW.status = 'failed')
+    EXECUTE FUNCTION billing_meter_mark_reconciliation_failure()
+  `);
+    await pool.query(`
+    UPDATE billing_meter_epochs AS epoch
+    SET reconciliation_failed_at = historical.failed_at
+    FROM (
+      SELECT epoch_id, min(checked_at) AS failed_at
+      FROM billing_meter_reconciliation_runs
+      WHERE status = 'failed'
+      GROUP BY epoch_id
+    ) AS historical
+    WHERE epoch.id = historical.epoch_id
+      AND (
+        epoch.reconciliation_failed_at IS NULL OR
+        epoch.reconciliation_failed_at > historical.failed_at
+      )
+  `);
+    await ensureAuthoritativeMeterPartitions(pool);
+}
+export async function ensureAuthoritativeMeterPartitions(pool) {
+    const at = new Date(await readBillingMeterTransactionTime(pool));
+    for (let offset = 0; offset <= BILLING_METER_PARTITION_HORIZON_MONTHS; offset += 1) {
+        const start = new Date(Date.UTC(at.getUTCFullYear(), at.getUTCMonth() + offset, 1));
+        const end = new Date(Date.UTC(at.getUTCFullYear(), at.getUTCMonth() + offset + 1, 1));
+        const partition = billingMeterPartitionName(start);
+        await pool.query(`CREATE TABLE IF NOT EXISTS ${partition}
+         PARTITION OF billing_meter_usage_events
+         FOR VALUES FROM ('${start.toISOString()}') TO ('${end.toISOString()}')`);
+    }
+}
+export function billingMeterPartitionName(month) {
+    if (!Number.isFinite(month.getTime()))
+        throw new Error('billing meter partition date is invalid');
+    const year = month.getUTCFullYear().toString().padStart(4, '0');
+    const ordinal = (month.getUTCMonth() + 1).toString().padStart(2, '0');
+    return `billing_meter_usage_events_y${year}m${ordinal}`;
+}
+//# sourceMappingURL=postgres-meter-schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-meter-schema.js","sourceRoot":"","sources":["../../src/billing/postgres-meter-schema.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wCAAwC,EACxC,gDAAgD,EAChD,sCAAsC,EACtC,sCAAsC,EACtC,oCAAoC,GACrC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EACL,wCAAwC,EACxC,sCAAsC,GACvC,MAAM,mCAAmC,CAAC;AAE3C,uGAAuG;AACvG,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,IAAU;IAC7D,MAAM,IAAI,CAAC,KAAK,CAAC;;;;GAIhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;GAQhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CACd;;;;wCAIoC,EACpC;QACE,sCAAsC;QACtC,oCAAoC;QACpC,gDAAgD;QAChD,wCAAwC;KACzC,CACF,CAAC;IACF,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;GAmBhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;GAIhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;GAIhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;GAIhB,CAAC,CAAC;IACH,MAAM,sCAAsC,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;GAkBhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;wDA0BqC,oCAAoC;;;;;;;GAOzF,CAAC,CAAC;IACH,MAAM,wCAAwC,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,IAAI,CAAC,KAAK,CAAC;;;;GAIhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;GAEhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;GAGhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;GAGhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;;;mCAagB,gDAAgD;;;GAGhF,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;GAGhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;mCAkBgB,wCAAwC;;;GAGxE,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;GAGhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;GAIhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;mCAmBgB,wCAAwC;;;GAGxE,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;GAGhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;GAIhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;GAkBhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;GAIhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;GAGhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;GAGhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;GAKhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;GAIhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;GAKhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;GAIhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;;;GAahB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;GAMhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;;;;GAchB,CAAC,CAAC;IACH,MAAM,kCAAkC,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kCAAkC,CAAC,IAAuB;IAC9E,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,MAAM,+BAA+B,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,IAAI,sCAAsC,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QACnF,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,cAAc,EAAE,EAAE,EAAE,CAAC,WAAW,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;QACpF,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,cAAc,EAAE,EAAE,EAAE,CAAC,WAAW,EAAE,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACtF,MAAM,SAAS,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,IAAI,CAAC,KAAK,CACd,8BAA8B,SAAS;;6BAEhB,KAAK,CAAC,WAAW,EAAE,WAAW,GAAG,CAAC,WAAW,EAAE,IAAI,CAC3E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAW;IACnD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAClG,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtE,OAAO,+BAA+B,IAAI,IAAI,OAAO,EAAE,CAAC;AAC1D,CAAC"}

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

@@ -0,0 +1,43 @@
+import type { Pool, PoolClient } from 'pg';
+export type BillingMeterValidationClassification = 'included' | 'overage' | 'denied';
+export interface BillingMeterValidationRecordInput {
+    readonly epochId: string;
+    readonly classification: BillingMeterValidationClassification;
+    readonly org: string;
+    readonly app: string;
+    readonly environment: string;
+    readonly deploymentId: string;
+    readonly highConfidenceKeyHash?: string;
+    readonly fallbackFingerprint: string;
+    readonly semanticFingerprint: string;
+}
+export interface BillingMeterValidationRecordResult {
+    readonly outcome: 'recorded' | 'duplicate';
+    readonly deduplicatedBy: null | 'high_confidence_key' | 'bounded_fallback';
+    readonly eventId: string;
+    readonly classification: BillingMeterValidationClassification;
+}
+export interface BillingMeterValidationRecordOptions {
+    readonly retryWindowMs: number;
+    /** One-way key-generation marker; never the raw HMAC key. */
+    readonly keyGeneration: string;
+    /** Exact release identity bound into the prepared validation epoch. */
+    readonly releaseSha: string;
+    readonly writerContractVersion?: number;
+}
+export interface BillingMeterValidationTransactionOptions extends BillingMeterValidationRecordOptions {
+    /** Internal live-writer attribution. It is never accepted from an MCP caller. */
+    readonly writerSessionId?: string;
+}
+export declare class BillingMeterValidationIdempotencyConflictError extends Error {
+    readonly code: "billing_meter_validation_idempotency_conflict";
+    constructor();
+}
+/**
+ * Validation-only transaction for load/reconciliation proof. It is deliberately absent from request
+ * dispatch and accepts only a prepared epoch; it does not make or enforce a customer admission decision.
+ */
+export declare function recordBillingMeterValidationUsage(pool: Pool, input: BillingMeterValidationRecordInput, options: BillingMeterValidationRecordOptions): Promise<BillingMeterValidationRecordResult>;
+/** Reuse the exact receipt/counter transaction from the live writer without accepting an epoch on its API. */
+export declare function recordBillingMeterValidationUsageTx(client: PoolClient, input: BillingMeterValidationRecordInput, options: BillingMeterValidationTransactionOptions): Promise<BillingMeterValidationRecordResult>;
+//# sourceMappingURL=postgres-meter-validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-meter-validation.d.ts","sourceRoot":"","sources":["../../src/billing/postgres-meter-validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAgB3C,MAAM,MAAM,oCAAoC,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErF,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,oCAAoC,CAAC;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,WAAW,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,IAAI,GAAG,qBAAqB,GAAG,kBAAkB,CAAC;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,oCAAoC,CAAC;CAC/D;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,wCACf,SAAQ,mCAAmC;IAC3C,iFAAiF;IACjF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,qBAAa,8CAA+C,SAAQ,KAAK;IACvE,QAAQ,CAAC,IAAI,EAAG,+CAA+C,CAAU;;CAM1E;AAsCD;;;GAGG;AACH,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,iCAAiC,EACxC,OAAO,EAAE,mCAAmC,GAC3C,OAAO,CAAC,kCAAkC,CAAC,CAiB7C;AAED,8GAA8G;AAC9G,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,iCAAiC,EACxC,OAAO,EAAE,wCAAwC,GAChD,OAAO,CAAC,kCAAkC,CAAC,CAwB7C"}