@noodleseed/one 0.43.0 → 0.44.0

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

@@ -129,6 +129,72 @@ export async function ensureBillingSchema(pool) {
     await pool.query(`
     CREATE INDEX IF NOT EXISTS org_billing_links_billing_account_org_idx
       ON org_billing_links (billing_account_id, org_slug)
+  `);
+    await pool.query(`
+    CREATE TABLE IF NOT EXISTS billing_usage_observation_state (
+      singleton  boolean PRIMARY KEY DEFAULT true CHECK (singleton),
+      started_at timestamptz NOT NULL
+    )
+  `);
+    await pool.query(`
+    CREATE TABLE IF NOT EXISTS billing_usage_events (
+      event_id                    text PRIMARY KEY,
+      mode                        text NOT NULL CHECK (mode = 'shadow'),
+      high_confidence_key_hash    bytea,
+      fallback_fingerprint        bytea NOT NULL,
+      semantic_fingerprint        bytea NOT NULL,
+      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,
+      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),
+      FOREIGN KEY (billing_account_id, snapshot_id)
+        REFERENCES billing_entitlement_snapshots(billing_account_id, id) ON DELETE RESTRICT
+    )
+  `);
+    await pool.query(`
+    CREATE UNIQUE INDEX IF NOT EXISTS billing_usage_events_high_confidence_key_idx
+      ON billing_usage_events (high_confidence_key_hash)
+      WHERE high_confidence_key_hash IS NOT NULL
+  `);
+    await pool.query(`
+    CREATE INDEX IF NOT EXISTS billing_usage_events_fallback_retry_idx
+      ON billing_usage_events (fallback_fingerprint, semantic_fingerprint, recorded_at DESC)
+  `);
+    await pool.query(`
+    CREATE TABLE IF NOT EXISTS billing_usage_account_windows (
+      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),
+      observed_calls     bigint NOT NULL CHECK (observed_calls >= 0),
+      first_admitted_at  timestamptz NOT NULL,
+      last_admitted_at   timestamptz NOT NULL,
+      updated_at         timestamptz NOT NULL,
+      PRIMARY KEY (billing_account_id, window_start)
+    )
+  `);
+    await pool.query(`
+    CREATE TABLE IF NOT EXISTS billing_usage_org_windows (
+      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),
+      observed_calls     bigint NOT NULL CHECK (observed_calls >= 0),
+      first_admitted_at  timestamptz NOT NULL,
+      last_admitted_at   timestamptz NOT NULL,
+      updated_at         timestamptz NOT NULL,
+      PRIMARY KEY (billing_account_id, org_slug, window_start)
+    )
   `);
     await pool.query(`
     CREATE TABLE IF NOT EXISTS billing_legacy_migration_preparations (

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

@@ -1 +1 @@
-{"version":3,"file":"postgres-schema.js","sourceRoot":"","sources":["../../src/billing/postgres-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAuB,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAU;IAClD,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;GAWhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;GAOhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;GAOhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;GAUhB,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;;;;;;;;;;;;;;;;;;;;;GAqBhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;GAkBhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;GAOhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;GAWhB,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;;;;;;;;;;;;;;;;;GAiBhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;;GAYhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;GAGhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;GAWhB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;GAShB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;;;;;GAShB,CAAC,CAAC;IAEH,MAAM,IAAI,CAAC,KAAK,CACd;;;iCAG6B,EAC7B;QACE,iBAAiB,CAAC,EAAE;QACpB,iBAAiB,CAAC,QAAQ;QAC1B,iBAAiB,CAAC,OAAO;QACzB,iBAAiB,CAAC,aAAa;QAC/B,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,YAAY,CAAC;QAC9C,iBAAiB,CAAC,eAAe;QACjC,iBAAiB,CAAC,SAAS;KAC5B,CACF,CAAC;IACF,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAC/B,mDAAmD,EACnD,CAAC,iBAAiB,CAAC,EAAE,CAAC,CACvB,CAAC;IACF,MAAM,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,IACE,aAAa,KAAK,SAAS;QAC3B,aAAa,CAAC,eAAe,KAAK,iBAAiB,CAAC,eAAe,EACnE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;AACH,CAAC"}
+{"version":3,"file":"postgres-schema.js","sourceRoot":"","sources":["../../src/billing/postgres-schema.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,12 @@
+import type { Pool } from 'pg';
+import type { BillingUsageRead, BillingUsageReceipt, GetBillingAccountUsageInput, GetOrganizationBillingUsageInput, RecordBillingUsageInput } from './usage-store.js';
+export declare function recordBillingUsageRow(pool: Pool, input: RecordBillingUsageInput, options: {
+    readonly now: () => Date;
+    readonly retryWindowMs: number;
+}): Promise<BillingUsageReceipt>;
+export declare function startBillingUsageObservationRow(pool: Pool, input: {
+    readonly startedAt: string;
+}): Promise<string>;
+export declare function getBillingAccountUsageRow(pool: Pool, input: GetBillingAccountUsageInput): Promise<BillingUsageRead>;
+export declare function getOrganizationBillingUsageRow(pool: Pool, input: GetOrganizationBillingUsageInput): Promise<BillingUsageRead>;
+//# sourceMappingURL=postgres-usage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-usage.d.ts","sourceRoot":"","sources":["../../src/billing/postgres-usage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,IAAI,CAAC;AAG3C,OAAO,KAAK,EAEV,gBAAgB,EAChB,mBAAmB,EACnB,2BAA2B,EAC3B,gCAAgC,EAEhC,uBAAuB,EACxB,MAAM,kBAAkB,CAAC;AAyC1B,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,IAAI,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACpE,OAAO,CAAC,mBAAmB,CAAC,CAU9B;AAED,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,IAAI,EACV,KAAK,EAAE;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACpC,OAAO,CAAC,MAAM,CAAC,CAQjB;AAoHD,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,gBAAgB,CAAC,CAkC3B;AAED,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,gBAAgB,CAAC,CAwC3B"}

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

@@ -0,0 +1,284 @@
+import { randomUUID } from 'node:crypto';
+import { validateSlug } from '../store/validate.js';
+import { validateBillingAccountId } from './model.js';
+import { BillingUsageIdempotencyConflictError, billingAccountUsageScope, buildBillingUsageRead, normalizeBillingUsageReadInput, normalizeRecordBillingUsageInput, organizationUsageScope, validateBillingUsageRetryWindowMs, } from './usage-store.js';
+import { normalizeBillingUsageInstant, resolveUtcMonthlyUsageWindow } from './usage-window.js';
+const SHADOW_LOCK_TIMEOUT_MS = 150;
+const SHADOW_STATEMENT_TIMEOUT_MS = 200;
+export function recordBillingUsageRow(pool, input, options) {
+    const usage = normalizeRecordBillingUsageInput(input);
+    const retryWindowMs = validateBillingUsageRetryWindowMs(options.retryWindowMs);
+    const recordedAt = normalizeBillingUsageInstant('billing usage recorded at', options.now().toISOString());
+    return withUsageTransaction(pool, (client) => recordBillingUsageTx(client, { usage, retryWindowMs, recordedAt }));
+}
+export function startBillingUsageObservationRow(pool, input) {
+    const startedAt = normalizeBillingUsageInstant('billing usage observation start', input.startedAt);
+    return withUsageTransaction(pool, (client) => getOrStartBillingUsageObservation(client, startedAt));
+}
+async function recordBillingUsageTx(client, input) {
+    if (input.usage.highConfidenceKeyHash !== undefined) {
+        await lockUsageDedupeKey(client, `exact:${input.usage.highConfidenceKeyHash}`);
+    }
+    else {
+        await lockUsageDedupeKey(client, `fallback:${input.usage.fallbackFingerprint}`);
+    }
+    if (input.usage.highConfidenceKeyHash !== undefined) {
+        const exact = await client.query(`SELECT * FROM billing_usage_events
+       WHERE high_confidence_key_hash = decode($1, 'hex')`, [input.usage.highConfidenceKeyHash]);
+        if (exact.rows[0] !== undefined) {
+            if (!exact.rows[0].semantic_fingerprint.equals(Buffer.from(input.usage.semanticFingerprint, 'hex'))) {
+                throw new BillingUsageIdempotencyConflictError();
+            }
+            return eventReceipt(exact.rows[0], 'duplicate', 'high_confidence_key');
+        }
+    }
+    if (input.usage.highConfidenceKeyHash === undefined) {
+        const retryCutoff = new Date(Date.parse(input.recordedAt) - input.retryWindowMs).toISOString();
+        const retryCeiling = new Date(Date.parse(input.recordedAt) + input.retryWindowMs).toISOString();
+        const fallback = await client.query(`SELECT *
+       FROM billing_usage_events
+       WHERE fallback_fingerprint = decode($1, 'hex')
+         AND semantic_fingerprint = decode($2, 'hex')
+         AND recorded_at >= $3
+         AND recorded_at <= $4
+       ORDER BY recorded_at DESC, event_id
+       LIMIT 1`, [input.usage.fallbackFingerprint, input.usage.semanticFingerprint, retryCutoff, retryCeiling]);
+        if (fallback.rows[0] !== undefined) {
+            return eventReceipt(fallback.rows[0], 'duplicate', 'bounded_fallback');
+        }
+    }
+    const resolution = await client.query(`SELECT links.billing_account_id,
+            links.version AS link_version,
+            snapshot.id AS snapshot_id,
+            snapshot.version AS snapshot_version,
+            snapshot.monthly_usage_anchor
+     FROM org_billing_links AS links
+     JOIN billing_account_active_snapshots AS active
+       ON active.billing_account_id = links.billing_account_id
+     JOIN billing_entitlement_snapshots AS snapshot
+       ON snapshot.billing_account_id = active.billing_account_id
+      AND snapshot.id = active.snapshot_id
+     WHERE links.org_slug = $1
+       AND links.active
+       AND snapshot.verification_status = 'verified'
+     FOR UPDATE OF links, active, snapshot`, [input.usage.org]);
+    const resolved = resolution.rows[0];
+    if (resolved === undefined)
+        throw new Error('billing setup is incomplete for organization');
+    const window = resolveUtcMonthlyUsageWindow(toIsoString(resolved.monthly_usage_anchor), input.usage.admittedAt);
+    const eventId = `bue_${randomUUID()}`;
+    const inserted = await client.query(`INSERT INTO billing_usage_events
+       (event_id, mode, high_confidence_key_hash, fallback_fingerprint, semantic_fingerprint,
+        billing_account_id, org_slug, app_slug, environment, deployment_id, link_version,
+        snapshot_id, snapshot_version, admitted_at, window_start, window_end, recorded_at)
+     VALUES ($1, 'shadow', decode($2, 'hex'), decode($3, 'hex'), decode($4, 'hex'),
+             $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16)
+     RETURNING *`, [
+        eventId,
+        input.usage.highConfidenceKeyHash ?? null,
+        input.usage.fallbackFingerprint,
+        input.usage.semanticFingerprint,
+        resolved.billing_account_id,
+        input.usage.org,
+        input.usage.app,
+        input.usage.environment,
+        input.usage.deploymentId,
+        resolved.link_version,
+        resolved.snapshot_id,
+        resolved.snapshot_version,
+        input.usage.admittedAt,
+        window.start,
+        window.end,
+        input.recordedAt,
+    ]);
+    const attribution = eventRowAttribution(inserted.rows[0]);
+    await incrementAccountAggregate(client, attribution, input.recordedAt);
+    await incrementOrganizationAggregate(client, attribution, input.recordedAt);
+    return {
+        eventId,
+        outcome: 'recorded',
+        deduplicatedBy: null,
+        attribution,
+    };
+}
+export async function getBillingAccountUsageRow(pool, input) {
+    const scope = billingAccountUsageScope(input.billingAccountId);
+    const read = normalizeBillingUsageReadInput({
+        at: input.at,
+        observedSince: await getBillingUsageObservationStart(pool),
+    });
+    const snapshot = await pool.query(`SELECT snapshot.monthly_usage_anchor
+     FROM billing_account_active_snapshots AS active
+     JOIN billing_entitlement_snapshots AS snapshot
+       ON snapshot.billing_account_id = active.billing_account_id
+      AND snapshot.id = active.snapshot_id
+     WHERE active.billing_account_id = $1
+       AND snapshot.verification_status = 'verified'`, [scope.billingAccountId]);
+    const anchor = snapshot.rows[0]?.monthly_usage_anchor;
+    if (anchor === undefined) {
+        return buildBillingUsageRead({ scope, monthlyUsageAnchor: undefined, ...read });
+    }
+    const monthlyUsageAnchor = toIsoString(anchor);
+    const window = resolveUtcMonthlyUsageWindow(monthlyUsageAnchor, read.at);
+    const aggregate = await pool.query(`SELECT observed_calls::text
+     FROM billing_usage_account_windows
+     WHERE billing_account_id = $1 AND window_start = $2`, [scope.billingAccountId, window.start]);
+    return buildBillingUsageRead({
+        scope,
+        monthlyUsageAnchor,
+        ...read,
+        observedCalls: parseObservedCalls(aggregate.rows[0]?.observed_calls),
+    });
+}
+export async function getOrganizationBillingUsageRow(pool, input) {
+    const scope = organizationUsageScope(input.org);
+    const read = normalizeBillingUsageReadInput({
+        at: input.at,
+        observedSince: await getBillingUsageObservationStart(pool),
+    });
+    const resolution = await pool.query(`SELECT links.billing_account_id, snapshot.monthly_usage_anchor
+     FROM org_billing_links AS links
+     JOIN billing_account_active_snapshots AS active
+       ON active.billing_account_id = links.billing_account_id
+     JOIN billing_entitlement_snapshots AS snapshot
+       ON snapshot.billing_account_id = active.billing_account_id
+      AND snapshot.id = active.snapshot_id
+     WHERE links.org_slug = $1
+       AND links.active
+       AND snapshot.verification_status = 'verified'`, [scope.org]);
+    const resolved = resolution.rows[0];
+    if (resolved === undefined) {
+        return buildBillingUsageRead({ scope, monthlyUsageAnchor: undefined, ...read });
+    }
+    const monthlyUsageAnchor = toIsoString(resolved.monthly_usage_anchor);
+    const window = resolveUtcMonthlyUsageWindow(monthlyUsageAnchor, read.at);
+    const aggregate = await pool.query(`SELECT observed_calls::text
+     FROM billing_usage_org_windows
+     WHERE billing_account_id = $1 AND org_slug = $2 AND window_start = $3`, [resolved.billing_account_id, scope.org, window.start]);
+    return buildBillingUsageRead({
+        scope,
+        monthlyUsageAnchor,
+        ...read,
+        observedCalls: parseObservedCalls(aggregate.rows[0]?.observed_calls),
+    });
+}
+async function incrementAccountAggregate(client, attribution, updatedAt) {
+    const result = await client.query(`INSERT INTO billing_usage_account_windows
+       (billing_account_id, window_start, window_end, observed_calls,
+        first_admitted_at, last_admitted_at, updated_at)
+     VALUES ($1, $2, $3, 1, $4, $4, $5)
+     ON CONFLICT (billing_account_id, window_start) DO UPDATE SET
+       observed_calls = billing_usage_account_windows.observed_calls + 1,
+       first_admitted_at = LEAST(billing_usage_account_windows.first_admitted_at, EXCLUDED.first_admitted_at),
+       last_admitted_at = GREATEST(billing_usage_account_windows.last_admitted_at, EXCLUDED.last_admitted_at),
+       updated_at = EXCLUDED.updated_at
+     WHERE billing_usage_account_windows.window_end = EXCLUDED.window_end`, [
+        attribution.billingAccountId,
+        attribution.windowStart,
+        attribution.windowEnd,
+        attribution.admittedAt,
+        updatedAt,
+    ]);
+    if (result.rowCount !== 1)
+        throw new Error('billing usage window anchor changed unexpectedly');
+}
+async function incrementOrganizationAggregate(client, attribution, updatedAt) {
+    const result = await client.query(`INSERT INTO billing_usage_org_windows
+       (billing_account_id, org_slug, window_start, window_end, observed_calls,
+        first_admitted_at, last_admitted_at, updated_at)
+     VALUES ($1, $2, $3, $4, 1, $5, $5, $6)
+     ON CONFLICT (billing_account_id, org_slug, window_start) DO UPDATE SET
+       observed_calls = billing_usage_org_windows.observed_calls + 1,
+       first_admitted_at = LEAST(billing_usage_org_windows.first_admitted_at, EXCLUDED.first_admitted_at),
+       last_admitted_at = GREATEST(billing_usage_org_windows.last_admitted_at, EXCLUDED.last_admitted_at),
+       updated_at = EXCLUDED.updated_at
+     WHERE billing_usage_org_windows.window_end = EXCLUDED.window_end`, [
+        attribution.billingAccountId,
+        attribution.org,
+        attribution.windowStart,
+        attribution.windowEnd,
+        attribution.admittedAt,
+        updatedAt,
+    ]);
+    if (result.rowCount !== 1)
+        throw new Error('billing usage window anchor changed unexpectedly');
+}
+async function lockUsageDedupeKey(client, key) {
+    await client.query('SELECT pg_advisory_xact_lock(hashtextextended($1, 0))', [
+        `billing-usage:${key}`,
+    ]);
+}
+function eventReceipt(row, outcome, deduplicatedBy) {
+    return {
+        eventId: row.event_id,
+        outcome,
+        deduplicatedBy,
+        attribution: eventRowAttribution(row),
+    };
+}
+function eventRowAttribution(row) {
+    return {
+        billingAccountId: validateBillingAccountId(row.billing_account_id),
+        org: validateSlug('org', row.org_slug),
+        app: validateSlug('app', row.app_slug),
+        environment: validateSlug('env', row.environment),
+        deploymentId: row.deployment_id,
+        linkVersion: row.link_version,
+        snapshotId: row.snapshot_id,
+        snapshotVersion: row.snapshot_version,
+        admittedAt: toIsoString(row.admitted_at),
+        windowStart: toIsoString(row.window_start),
+        windowEnd: toIsoString(row.window_end),
+    };
+}
+function parseObservedCalls(value) {
+    if (value === undefined)
+        return 0;
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < 0) {
+        throw new Error('persisted billing usage exceeds the supported reporting range');
+    }
+    return parsed;
+}
+async function getOrStartBillingUsageObservation(query, startedAt) {
+    await query.query(`INSERT INTO billing_usage_observation_state (singleton, started_at)
+     VALUES (true, $1)
+     ON CONFLICT (singleton) DO NOTHING`, [startedAt]);
+    const result = await query.query('SELECT started_at FROM billing_usage_observation_state WHERE singleton = true');
+    const persistedStartedAt = result.rows[0]?.started_at;
+    if (persistedStartedAt === undefined) {
+        throw new Error('billing usage observation failed to initialize');
+    }
+    return toIsoString(persistedStartedAt);
+}
+async function getBillingUsageObservationStart(query) {
+    const result = await query.query('SELECT started_at FROM billing_usage_observation_state WHERE singleton = true');
+    const startedAt = result.rows[0]?.started_at;
+    if (startedAt === undefined)
+        throw new Error('billing usage observation has not started');
+    return toIsoString(startedAt);
+}
+function toIsoString(value) {
+    return normalizeBillingUsageInstant('persisted billing usage timestamp', value instanceof Date ? value.toISOString() : value);
+}
+async function withUsageTransaction(pool, operation) {
+    const client = await pool.connect();
+    try {
+        await client.query('BEGIN');
+        try {
+            await client.query(`SELECT set_config('lock_timeout', $1, true),
+                set_config('statement_timeout', $2, true)`, [`${SHADOW_LOCK_TIMEOUT_MS}ms`, `${SHADOW_STATEMENT_TIMEOUT_MS}ms`]);
+            const result = await operation(client);
+            await client.query('COMMIT');
+            return result;
+        }
+        catch (error) {
+            await client.query('ROLLBACK');
+            throw error;
+        }
+    }
+    finally {
+        client.release();
+    }
+}
+//# sourceMappingURL=postgres-usage.js.map

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

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

package/node_modules/@noodle-borg/service/dist/billing/production-footprint.d.ts

@@ -0,0 +1,20 @@
+import type { ServerRegistry } from '../registry.js';
+export interface ActiveHostedAppFootprint {
+    /** Distinct active logical apps across every organization in this projection. */
+    readonly active: number;
+    /** Organization-attributed counts; never an account identity or cross-org app inventory. */
+    readonly byOrganization: Readonly<Record<string, number>>;
+}
+type HostedAppInventory = Pick<ServerRegistry, 'listApps'>;
+/**
+ * Derive the current production footprint from canonical hosted deployment state.
+ *
+ * Every registry app is served by the Noodle cloud data plane. An app consumes one slot when any
+ * deployment is active; environments, versions, revisions, routes, and replicas stay folded into
+ * that one {@link AppSummary}-shaped registry row. This is deliberately a read projection rather
+ * than another mutable counter, so archive, restore, activation, and organization relinks cannot
+ * drift from the deployment system of record.
+ */
+export declare function readActiveHostedAppFootprint(registry: HostedAppInventory, organizations: readonly string[]): Promise<ActiveHostedAppFootprint>;
+export {};
+//# sourceMappingURL=production-footprint.d.ts.map

package/node_modules/@noodle-borg/service/dist/billing/production-footprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"production-footprint.d.ts","sourceRoot":"","sources":["../../src/billing/production-footprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4FAA4F;IAC5F,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3D;AAED,KAAK,kBAAkB,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;AAE3D;;;;;;;;GAQG;AACH,wBAAsB,4BAA4B,CAChD,QAAQ,EAAE,kBAAkB,EAC5B,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,OAAO,CAAC,wBAAwB,CAAC,CAiBnC"}

package/node_modules/@noodle-borg/service/dist/billing/production-footprint.js

@@ -0,0 +1,24 @@
+/**
+ * Derive the current production footprint from canonical hosted deployment state.
+ *
+ * Every registry app is served by the Noodle cloud data plane. An app consumes one slot when any
+ * deployment is active; environments, versions, revisions, routes, and replicas stay folded into
+ * that one {@link AppSummary}-shaped registry row. This is deliberately a read projection rather
+ * than another mutable counter, so archive, restore, activation, and organization relinks cannot
+ * drift from the deployment system of record.
+ */
+export async function readActiveHostedAppFootprint(registry, organizations) {
+    const byOrganization = {};
+    let active = 0;
+    for (const org of new Set(organizations)) {
+        const inventory = await registry.listApps(org, { limit: Number.MAX_SAFE_INTEGER });
+        if (inventory.truncated) {
+            throw new Error(`active hosted app inventory was truncated for organization "${org}"`);
+        }
+        const orgActive = inventory.apps.filter((app) => app.active && app.archivedAt === undefined).length;
+        byOrganization[org] = orgActive;
+        active += orgActive;
+    }
+    return { active, byOrganization };
+}
+//# sourceMappingURL=production-footprint.js.map

package/node_modules/@noodle-borg/service/dist/billing/production-footprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"production-footprint.js","sourceRoot":"","sources":["../../src/billing/production-footprint.ts"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,QAA4B,EAC5B,aAAgC;IAEhC,MAAM,cAAc,GAA2B,EAAE,CAAC;IAClD,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,MAAM,GAAG,IAAI,IAAI,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACnF,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,+DAA+D,GAAG,GAAG,CAAC,CAAC;QACzF,CAAC;QACD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CACrC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,CACpD,CAAC,MAAM,CAAC;QACT,cAAc,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;QAChC,MAAM,IAAI,SAAS,CAAC;IACtB,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;AACpC,CAAC"}