@noodleseed/one 0.46.0 → 0.47.0

package/node_modules/@noodle-borg/service/dist/billing/meter-live-validation.js

@@ -0,0 +1,233 @@
+import { createBillingUsageIdentityDeriver, } from './usage-identity.js';
+const DEFAULT_MAX_WAIT_MS = 250;
+// Production's smallest pool has five connections: reserve one for scheduler work and one generally.
+const DEFAULT_MAX_CONCURRENT_WRITES = 3;
+const DEFAULT_FAILURE_COOLDOWN_MS = 5_000;
+const DEFAULT_SHUTDOWN_DRAIN_MS = 5_000;
+/**
+ * Mirror the final hosted tool-dispatch boundary into v1 shadow and the prepared v2 validation epoch.
+ * Both sinks are observational: every local, timeout, saturation, or database outcome still allows the
+ * connector exactly as before.
+ */
+export function createBillingMeterValidationMirror(options) {
+    const deriveIdentity = createBillingUsageIdentityDeriver(options.hmacKey);
+    const maxWaitMs = boundedInteger('billing validation mirror max wait', options.maxWaitMs ?? DEFAULT_MAX_WAIT_MS, 1, 5_000);
+    const maxConcurrentWrites = boundedInteger('billing validation mirror concurrency', options.maxConcurrentWrites ?? DEFAULT_MAX_CONCURRENT_WRITES, 1, 1_024);
+    const failureCooldownMs = boundedInteger('billing validation mirror failure cooldown', options.failureCooldownMs ?? DEFAULT_FAILURE_COOLDOWN_MS, 0, 60_000);
+    const shutdownDrainMs = boundedInteger('billing validation mirror shutdown drain', options.shutdownDrainMs ?? DEFAULT_SHUTDOWN_DRAIN_MS, 1, 30_000);
+    const counters = mutableCounters(options.writer.session);
+    const pendingValidations = new Set();
+    let circuitOpenUntil = 0;
+    let closing = false;
+    let validationFenced = false;
+    const snapshot = () => ({ ...counters });
+    const observe = async (context) => {
+        if (closing)
+            return;
+        if (context.signal.aborted)
+            return;
+        let identity;
+        try {
+            identity = deriveIdentity(context);
+        }
+        catch {
+            if (!validationFenced) {
+                mutate(counters, () => {
+                    counters.observedCalls += 1;
+                    counters.derivationFailures += 1;
+                });
+            }
+            warn(options.logger, context, 'identity_derivation_failed');
+            return;
+        }
+        const waits = [];
+        if (options.shadowSink !== undefined) {
+            waits.push(invokeShadow(options.shadowSink, context, identity).catch(() => {
+                warn(options.logger, context, 'shadow_sink_failed');
+            }));
+        }
+        if (validationFenced) {
+            await settleWithin(waits, maxWaitMs);
+            return;
+        }
+        mutate(counters, () => {
+            counters.observedCalls += 1;
+        });
+        let validation;
+        if (Date.now() < circuitOpenUntil) {
+            mutate(counters, () => {
+                counters.circuitOpenSkips += 1;
+            });
+        }
+        else if (counters.inFlightWrites >= maxConcurrentWrites) {
+            mutate(counters, () => {
+                counters.saturationSkips += 1;
+            });
+            warn(options.logger, context, 'bulkhead_saturated');
+        }
+        else {
+            mutate(counters, () => {
+                counters.attemptedWrites += 1;
+                counters.inFlightWrites += 1;
+            });
+            validation = startValidationWrite(options.writer, context, identity, (outcome) => {
+                mutate(counters, () => {
+                    counters.inFlightWrites -= 1;
+                    if (outcome === 'recorded')
+                        counters.recordedWrites += 1;
+                    else if (outcome === 'duplicate')
+                        counters.duplicateWrites += 1;
+                    else if (outcome === 'no_prepared_epoch')
+                        counters.noEpochSkips += 1;
+                    else if (outcome === 'identity_mismatch')
+                        counters.epochIdentityFailures += 1;
+                    else
+                        counters.finalFailures += 1;
+                });
+                if (outcome === 'failed' || outcome === 'identity_mismatch') {
+                    circuitOpenUntil = Date.now() + failureCooldownMs;
+                }
+                if (outcome === 'failed')
+                    warn(options.logger, context, 'validation_write_failed');
+            });
+            trackPendingValidation(pendingValidations, validation.settled);
+            waits.push(validation.settled);
+        }
+        const completed = await settleWithin(waits, maxWaitMs);
+        if (!completed && validation !== undefined && !validation.isSettled()) {
+            mutate(counters, () => {
+                counters.timeoutUnknownOutcomes += 1;
+            });
+            circuitOpenUntil = Date.now() + failureCooldownMs;
+            warn(options.logger, context, 'validation_write_timed_out');
+        }
+    };
+    const reportHealth = async () => {
+        const directive = await options.writer.reportHealth(snapshot());
+        if (directive === undefined) {
+            // A previous arm may have committed even when its acknowledgement was lost. A later durable
+            // report with no arm directive is the writer's confirmation that validation may resume.
+            validationFenced = false;
+            return;
+        }
+        validationFenced = true;
+        const drained = await settleWithin([...pendingValidations], shutdownDrainMs);
+        if (!drained) {
+            throw new Error('billing meter epoch arm has unresolved validation writes');
+        }
+        if (options.writer.armEpoch === undefined) {
+            throw new Error('billing meter writer cannot arm a prepared epoch');
+        }
+        await options.writer.armEpoch(directive.armEpochId, snapshot());
+        validationFenced = false;
+    };
+    return {
+        observe,
+        snapshot,
+        reportHealth,
+        close: async () => {
+            closing = true;
+            validationFenced = true;
+            const drained = await settleWithin([...pendingValidations], shutdownDrainMs);
+            if (!drained) {
+                await settleWithin([
+                    options.writer.reportHealth(snapshot()).then(() => undefined, () => undefined),
+                ], maxWaitMs);
+                throw new Error('billing meter shutdown has unresolved validation writes');
+            }
+            await options.writer.close(snapshot());
+        },
+    };
+}
+function trackPendingValidation(pending, operation) {
+    pending.add(operation);
+    void operation.finally(() => pending.delete(operation));
+}
+function startValidationWrite(writer, context, identity, onSettled) {
+    let done = false;
+    let operation;
+    try {
+        operation = writer.record({
+            classification: 'included',
+            org: context.org,
+            app: context.app,
+            environment: context.environment,
+            deploymentId: context.deploymentId,
+            identity,
+        });
+    }
+    catch {
+        operation = Promise.reject(new Error('billing validation writer failed synchronously'));
+    }
+    const settled = operation.then((result) => {
+        done = true;
+        onSettled(result.outcome);
+    }, () => {
+        done = true;
+        onSettled('failed');
+    });
+    return { settled, isSettled: () => done };
+}
+async function invokeShadow(sink, context, identity) {
+    await sink(context, identity);
+}
+async function settleWithin(waits, timeoutMs) {
+    if (waits.length === 0)
+        return true;
+    let timer;
+    try {
+        return await Promise.race([
+            Promise.allSettled(waits).then(() => true),
+            new Promise((resolve) => {
+                timer = setTimeout(() => resolve(false), timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+}
+function mutableCounters(session) {
+    return {
+        ...session,
+        reportVersion: 0,
+        observedCalls: 0,
+        attemptedWrites: 0,
+        recordedWrites: 0,
+        duplicateWrites: 0,
+        finalFailures: 0,
+        noEpochSkips: 0,
+        circuitOpenSkips: 0,
+        saturationSkips: 0,
+        derivationFailures: 0,
+        epochIdentityFailures: 0,
+        timeoutUnknownOutcomes: 0,
+        inFlightWrites: 0,
+    };
+}
+function mutate(counters, operation) {
+    operation();
+    counters.reportVersion += 1;
+}
+function warn(logger, context, failure) {
+    try {
+        logger.warn('billing.meter.validation_mirror_failed', {
+            org: context.org,
+            app: context.app,
+            env: context.environment,
+            deploymentId: context.deploymentId,
+            failure,
+        });
+    }
+    catch {
+        // Validation diagnostics must never become an admission dependency.
+    }
+}
+function boundedInteger(name, value, minimum, maximum) {
+    if (!Number.isSafeInteger(value) || value < minimum || value > maximum) {
+        throw new Error(`${name} must be between ${minimum} and ${maximum}`);
+    }
+    return value;
+}
+//# sourceMappingURL=meter-live-validation.js.map

package/node_modules/@noodle-borg/service/dist/billing/meter-live-validation.js.map

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

package/node_modules/@noodle-borg/service/dist/billing/meter-readiness-health.d.ts

@@ -0,0 +1,89 @@
+import type { BillingMeterReadinessCheckState } from './meter-readiness.js';
+export declare const BILLING_METER_WRITER_HEARTBEAT_INTERVAL_MS = 30000;
+export declare const BILLING_METER_WRITER_FRESHNESS_MS: number;
+export declare const BILLING_METER_SCHEDULER_FRESHNESS_MS: number;
+export interface BillingMeterHealthSignal {
+    readonly state: BillingMeterReadinessCheckState;
+    readonly checkedAt: string;
+}
+export interface BillingMeterPreparedEpochHealthIdentity {
+    readonly id: string;
+    readonly preparedAt: string;
+    readonly releaseSha: string;
+    readonly keyGeneration: string;
+    readonly retryIdentityVersion: number;
+    readonly writerContractVersion: number;
+}
+export interface BillingMeterLiveRuntimeExpectation {
+    readonly releaseSha: string;
+    readonly keyGeneration: string;
+    readonly retryIdentityVersion: number;
+    readonly writerContractVersion: number;
+    readonly schedulerContractVersion: number;
+    readonly writerFreshnessMs?: number;
+    readonly schedulerFreshnessMs?: number;
+}
+export interface BillingMeterHealthCounters {
+    readonly observedCalls: bigint;
+    readonly attemptedWrites: bigint;
+    readonly recordedWrites: bigint;
+    readonly duplicateWrites: bigint;
+    readonly finalFailures: bigint;
+    readonly noEpochSkips: bigint;
+    readonly circuitOpenSkips: bigint;
+    readonly saturationSkips: bigint;
+    readonly derivationFailures: bigint;
+    readonly epochIdentityFailures: bigint;
+    readonly timeoutUnknownOutcomes: bigint;
+    readonly inFlightWrites: bigint;
+}
+export interface BillingMeterWriterSessionHealthEvidence {
+    readonly sessionId: string;
+    readonly releaseSha: string;
+    readonly keyGeneration: string;
+    readonly retryIdentityVersion: number;
+    readonly writerContractVersion: number;
+    readonly lastHeartbeatAt: string;
+    readonly closedAt: string | null;
+    readonly cleanStop: boolean;
+    readonly baselineArmedAt: string | null;
+    readonly baselineReportVersion: bigint;
+    readonly reportVersion: bigint;
+    readonly baseline: BillingMeterHealthCounters;
+    readonly current: BillingMeterHealthCounters;
+}
+export interface BillingMeterSchedulerCompletedEvidence {
+    readonly status: 'succeeded' | 'failed' | 'backlogged';
+    readonly releaseSha: string;
+    readonly contractVersion: number;
+    readonly cpuAlwaysAllocated: boolean;
+    readonly startedAt: string;
+    readonly completedAt: string;
+    readonly windowsFailed: number;
+    readonly backlogDetected: boolean;
+    readonly maintenanceRunId: string | null;
+}
+export declare function emptyBillingMeterHealthCounters(): BillingMeterHealthCounters;
+export declare function evaluateBillingMeterValidationMirror(input: {
+    readonly checkedAt: string;
+    readonly epoch: BillingMeterPreparedEpochHealthIdentity;
+    readonly expectation: BillingMeterLiveRuntimeExpectation;
+    readonly latestReceiptAt: string | null;
+}): BillingMeterHealthSignal;
+export declare function evaluateBillingMeterWriterHealth(input: {
+    readonly checkedAt: string;
+    readonly epoch: BillingMeterPreparedEpochHealthIdentity;
+    readonly expectation: BillingMeterLiveRuntimeExpectation;
+    readonly unbaselinedSessionCount: number;
+    readonly rollup: BillingMeterHealthCounters;
+    readonly uncleanRollupStops: bigint;
+    readonly sessions: readonly BillingMeterWriterSessionHealthEvidence[];
+}): BillingMeterHealthSignal;
+export declare function evaluateBillingMeterSchedulerHealth(input: {
+    readonly checkedAt: string;
+    readonly epoch: BillingMeterPreparedEpochHealthIdentity;
+    readonly expectation: BillingMeterLiveRuntimeExpectation;
+    readonly staleRunningCount: number;
+    readonly latestCompleted?: BillingMeterSchedulerCompletedEvidence;
+}): BillingMeterHealthSignal;
+//# sourceMappingURL=meter-readiness-health.d.ts.map

package/node_modules/@noodle-borg/service/dist/billing/meter-readiness-health.d.ts.map

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

package/node_modules/@noodle-borg/service/dist/billing/meter-readiness-health.js

@@ -0,0 +1,191 @@
+export const BILLING_METER_WRITER_HEARTBEAT_INTERVAL_MS = 30_000;
+export const BILLING_METER_WRITER_FRESHNESS_MS = 2 * 60_000;
+export const BILLING_METER_SCHEDULER_FRESHNESS_MS = 15 * 60_000;
+export function emptyBillingMeterHealthCounters() {
+    return {
+        observedCalls: 0n,
+        attemptedWrites: 0n,
+        recordedWrites: 0n,
+        duplicateWrites: 0n,
+        finalFailures: 0n,
+        noEpochSkips: 0n,
+        circuitOpenSkips: 0n,
+        saturationSkips: 0n,
+        derivationFailures: 0n,
+        epochIdentityFailures: 0n,
+        timeoutUnknownOutcomes: 0n,
+        inFlightWrites: 0n,
+    };
+}
+export function evaluateBillingMeterValidationMirror(input) {
+    const checkedAt = validInstant(input.checkedAt);
+    if (!identityMatches(input.epoch, input.expectation)) {
+        return { state: 'fail', checkedAt };
+    }
+    if (input.latestReceiptAt === null)
+        return { state: 'unknown', checkedAt };
+    const receiptAt = validInstant(input.latestReceiptAt);
+    if (Date.parse(receiptAt) < Date.parse(validInstant(input.epoch.preparedAt)) ||
+        Date.parse(receiptAt) > Date.parse(checkedAt)) {
+        return { state: 'fail', checkedAt: receiptAt };
+    }
+    return { state: 'pass', checkedAt: receiptAt };
+}
+export function evaluateBillingMeterWriterHealth(input) {
+    const checkedAt = validInstant(input.checkedAt);
+    if (!identityMatches(input.epoch, input.expectation) ||
+        !Number.isSafeInteger(input.unbaselinedSessionCount) ||
+        input.unbaselinedSessionCount > 0 ||
+        input.uncleanRollupStops > 0n) {
+        return { state: 'fail', checkedAt };
+    }
+    const freshnessMs = positiveDuration(input.expectation.writerFreshnessMs ?? BILLING_METER_WRITER_FRESHNESS_MS);
+    let aggregate = input.rollup;
+    let oldestHeartbeat = checkedAt;
+    let awaitingWriterArm = false;
+    for (const session of input.sessions) {
+        const heartbeatAt = validInstant(session.lastHeartbeatAt);
+        if (Date.parse(heartbeatAt) < Date.parse(oldestHeartbeat))
+            oldestHeartbeat = heartbeatAt;
+        if (!identityMatches(session, input.expectation)) {
+            return { state: 'fail', checkedAt: heartbeatAt };
+        }
+        if (session.baselineArmedAt === null) {
+            if (session.closedAt !== null) {
+                return { state: 'fail', checkedAt: validInstant(session.closedAt) };
+            }
+            awaitingWriterArm = true;
+            continue;
+        }
+        validInstant(session.baselineArmedAt);
+        if (session.closedAt === null) {
+            const age = Date.parse(checkedAt) - Date.parse(heartbeatAt);
+            if (age < 0 || age > freshnessMs)
+                return { state: 'fail', checkedAt: heartbeatAt };
+        }
+        else if (!session.cleanStop || session.current.inFlightWrites !== 0n) {
+            return { state: 'fail', checkedAt: validInstant(session.closedAt) };
+        }
+        if (session.reportVersion < session.baselineReportVersion) {
+            return { state: 'fail', checkedAt: heartbeatAt };
+        }
+        const delta = subtractCounters(session.current, session.baseline);
+        if (delta === undefined)
+            return { state: 'fail', checkedAt: heartbeatAt };
+        aggregate = addCounters(aggregate, delta);
+    }
+    if (awaitingWriterArm)
+        return { state: 'unknown', checkedAt: oldestHeartbeat };
+    if (!counterEquationsHold(aggregate) || hasPoisonedWriterEvidence(aggregate)) {
+        return { state: 'fail', checkedAt: oldestHeartbeat };
+    }
+    if (aggregate.inFlightWrites !== 0n) {
+        return { state: 'unknown', checkedAt: oldestHeartbeat };
+    }
+    if (aggregate.recordedWrites + aggregate.duplicateWrites === 0n) {
+        return { state: 'unknown', checkedAt: oldestHeartbeat };
+    }
+    return { state: 'pass', checkedAt: oldestHeartbeat };
+}
+export function evaluateBillingMeterSchedulerHealth(input) {
+    const checkedAt = validInstant(input.checkedAt);
+    if (!identityMatches(input.epoch, input.expectation) ||
+        !Number.isSafeInteger(input.staleRunningCount) ||
+        input.staleRunningCount < 0 ||
+        input.staleRunningCount > 0) {
+        return { state: 'fail', checkedAt };
+    }
+    const run = input.latestCompleted;
+    if (run === undefined)
+        return { state: 'unknown', checkedAt };
+    const completedAt = validInstant(run.completedAt);
+    const age = Date.parse(checkedAt) - Date.parse(completedAt);
+    const freshnessMs = positiveDuration(input.expectation.schedulerFreshnessMs ?? BILLING_METER_SCHEDULER_FRESHNESS_MS);
+    if (age < 0 ||
+        age > freshnessMs ||
+        Date.parse(completedAt) < Date.parse(input.epoch.preparedAt)) {
+        return { state: 'unknown', checkedAt: completedAt };
+    }
+    if (run.status !== 'succeeded' ||
+        run.releaseSha !== input.expectation.releaseSha ||
+        run.contractVersion !== input.expectation.schedulerContractVersion ||
+        !run.cpuAlwaysAllocated ||
+        run.windowsFailed !== 0 ||
+        run.backlogDetected ||
+        run.maintenanceRunId === null) {
+        return { state: 'fail', checkedAt: completedAt };
+    }
+    return { state: 'pass', checkedAt: completedAt };
+}
+const COUNTER_KEYS = [
+    'observedCalls',
+    'attemptedWrites',
+    'recordedWrites',
+    'duplicateWrites',
+    'finalFailures',
+    'noEpochSkips',
+    'circuitOpenSkips',
+    'saturationSkips',
+    'derivationFailures',
+    'epochIdentityFailures',
+    'timeoutUnknownOutcomes',
+    'inFlightWrites',
+];
+function subtractCounters(current, baseline) {
+    const result = {};
+    for (const key of COUNTER_KEYS) {
+        const delta = current[key] - baseline[key];
+        if (delta < 0n)
+            return undefined;
+        result[key] = delta;
+    }
+    return result;
+}
+function addCounters(left, right) {
+    const result = {};
+    for (const key of COUNTER_KEYS)
+        result[key] = left[key] + right[key];
+    return result;
+}
+function counterEquationsHold(counters) {
+    return (counters.observedCalls ===
+        counters.attemptedWrites +
+            counters.circuitOpenSkips +
+            counters.saturationSkips +
+            counters.derivationFailures &&
+        counters.attemptedWrites ===
+            counters.recordedWrites +
+                counters.duplicateWrites +
+                counters.finalFailures +
+                counters.noEpochSkips +
+                counters.epochIdentityFailures +
+                counters.inFlightWrites);
+}
+function hasPoisonedWriterEvidence(counters) {
+    return (counters.finalFailures > 0n ||
+        counters.noEpochSkips > 0n ||
+        counters.circuitOpenSkips > 0n ||
+        counters.saturationSkips > 0n ||
+        counters.derivationFailures > 0n ||
+        counters.epochIdentityFailures > 0n ||
+        counters.timeoutUnknownOutcomes > 0n);
+}
+function identityMatches(identity, expectation) {
+    return (identity.releaseSha === expectation.releaseSha &&
+        identity.keyGeneration === expectation.keyGeneration &&
+        identity.retryIdentityVersion === expectation.retryIdentityVersion &&
+        identity.writerContractVersion === expectation.writerContractVersion);
+}
+function positiveDuration(value) {
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new Error('billing meter health freshness must be a positive integer');
+    }
+    return value;
+}
+function validInstant(value) {
+    const instant = new Date(value);
+    if (!Number.isFinite(instant.getTime()))
+        throw new Error('billing meter health timestamp is invalid');
+    return instant.toISOString();
+}
+//# sourceMappingURL=meter-readiness-health.js.map

package/node_modules/@noodle-borg/service/dist/billing/meter-readiness-health.js.map

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

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

@@ -0,0 +1,99 @@
+import { z } from 'zod';
+export declare const BILLING_METER_READINESS_SCHEMA_VERSION: 1;
+export declare const BILLING_METER_RECEIPT_RETENTION_DAYS: 7;
+export declare const BILLING_METER_EXACT_KEY_TOMBSTONE_RETENTION_DAYS: 30;
+export declare const BILLING_METER_AGGREGATE_RETENTION_MONTHS: 25;
+export declare const BILLING_METER_PARTITION_HORIZON_MONTHS: 2;
+export declare const BILLING_METER_EVIDENCE_FRESHNESS_MS: number;
+export declare const BILLING_METER_RETRY_IDENTITY_VERSION: 1;
+export declare const BILLING_METER_READINESS_CHECK_CODES: readonly ["durable_postgres", "billing_attribution_complete", "legacy_platform_quota_retired", "key_generation_consistent", "prepared_meter_epoch", "partition_horizon", "receipt_retention", "exact_key_tombstones", "aggregate_reconciliation", "validation_mirror", "writer_health", "scheduler_health"];
+export declare const BILLING_METER_LATER_CUTOVER_GATES: readonly ["traffic_fleet_convergence_proof", "plan_volume_capacity_proof", "nonproduction_fail_closed_drill", "grant_expiry_contract", "authoritative_activation", "protected_production_approval"];
+declare const BillingMeterReadinessCheckSchema: z.ZodObject<{
+    code: z.ZodEnum<{
+        durable_postgres: "durable_postgres";
+        billing_attribution_complete: "billing_attribution_complete";
+        legacy_platform_quota_retired: "legacy_platform_quota_retired";
+        key_generation_consistent: "key_generation_consistent";
+        prepared_meter_epoch: "prepared_meter_epoch";
+        partition_horizon: "partition_horizon";
+        receipt_retention: "receipt_retention";
+        exact_key_tombstones: "exact_key_tombstones";
+        aggregate_reconciliation: "aggregate_reconciliation";
+        validation_mirror: "validation_mirror";
+        writer_health: "writer_health";
+        scheduler_health: "scheduler_health";
+    }>;
+    state: z.ZodEnum<{
+        unknown: "unknown";
+        pass: "pass";
+        fail: "fail";
+    }>;
+    checkedAt: z.ZodOptional<z.ZodPipe<z.ZodISODateTime, z.ZodTransform<string, string>>>;
+}, z.core.$strict>;
+export declare const BillingMeterReadinessReportSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    checkedAt: z.ZodPipe<z.ZodISODateTime, z.ZodTransform<string, string>>;
+    technicalReadiness: z.ZodEnum<{
+        unavailable: "unavailable";
+        ready: "ready";
+        blocked: "blocked";
+    }>;
+    metering: z.ZodUnion<readonly [z.ZodObject<{
+        mode: z.ZodLiteral<"not_started">;
+        coverage: z.ZodNull;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"shadow">;
+        coverage: z.ZodLiteral<"partial">;
+    }, z.core.$strict>]>;
+    enforcement: z.ZodObject<{
+        state: z.ZodLiteral<"legacy_unchanged">;
+    }, z.core.$strict>;
+    activation: z.ZodObject<{
+        state: z.ZodLiteral<"not_available">;
+    }, z.core.$strict>;
+    checks: z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<{
+            durable_postgres: "durable_postgres";
+            billing_attribution_complete: "billing_attribution_complete";
+            legacy_platform_quota_retired: "legacy_platform_quota_retired";
+            key_generation_consistent: "key_generation_consistent";
+            prepared_meter_epoch: "prepared_meter_epoch";
+            partition_horizon: "partition_horizon";
+            receipt_retention: "receipt_retention";
+            exact_key_tombstones: "exact_key_tombstones";
+            aggregate_reconciliation: "aggregate_reconciliation";
+            validation_mirror: "validation_mirror";
+            writer_health: "writer_health";
+            scheduler_health: "scheduler_health";
+        }>;
+        state: z.ZodEnum<{
+            unknown: "unknown";
+            pass: "pass";
+            fail: "fail";
+        }>;
+        checkedAt: z.ZodOptional<z.ZodPipe<z.ZodISODateTime, z.ZodTransform<string, string>>>;
+    }, z.core.$strict>>;
+    laterCutoverGates: z.ZodTuple<[z.ZodLiteral<"traffic_fleet_convergence_proof">, z.ZodLiteral<"plan_volume_capacity_proof">, z.ZodLiteral<"nonproduction_fail_closed_drill">, z.ZodLiteral<"grant_expiry_contract">, z.ZodLiteral<"authoritative_activation">, z.ZodLiteral<"protected_production_approval">], null>;
+}, z.core.$strict>;
+export type BillingMeterReadinessCheckCode = (typeof BILLING_METER_READINESS_CHECK_CODES)[number];
+export type BillingMeterReadinessCheckState = z.infer<typeof BillingMeterReadinessCheckSchema>['state'];
+export type BillingMeterLaterCutoverGate = (typeof BILLING_METER_LATER_CUTOVER_GATES)[number];
+export type BillingMeterReadinessCheck = z.infer<typeof BillingMeterReadinessCheckSchema>;
+export type BillingMeterReadinessReport = z.infer<typeof BillingMeterReadinessReportSchema>;
+export interface BillingMeterReadinessStore {
+    getMeterReadiness(): Promise<BillingMeterReadinessReport>;
+}
+type ReadinessCheckSignals = Readonly<Record<BillingMeterReadinessCheckCode, {
+    readonly state: BillingMeterReadinessCheckState;
+    readonly checkedAt?: string;
+}>>;
+export declare function buildBillingMeterReadinessReport(input: {
+    readonly checkedAt: string;
+    readonly metering: BillingMeterReadinessReport['metering'];
+    readonly checks: ReadinessCheckSignals;
+}): BillingMeterReadinessReport;
+export declare function unavailableBillingMeterReadinessReport(checkedAt: string): BillingMeterReadinessReport;
+/** A one-way generation marker; the HMAC key itself is never persisted or returned. */
+export declare function deriveBillingMeterKeyGeneration(hmacKey: string): string;
+export {};
+//# sourceMappingURL=meter-readiness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meter-readiness.d.ts","sourceRoot":"","sources":["../../src/billing/meter-readiness.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,sCAAsC,EAAG,CAAU,CAAC;AACjE,eAAO,MAAM,oCAAoC,EAAG,CAAU,CAAC;AAC/D,eAAO,MAAM,gDAAgD,EAAG,EAAW,CAAC;AAC5E,eAAO,MAAM,wCAAwC,EAAG,EAAW,CAAC;AACpE,eAAO,MAAM,sCAAsC,EAAG,CAAU,CAAC;AACjE,eAAO,MAAM,mCAAmC,QAAuB,CAAC;AACxE,eAAO,MAAM,oCAAoC,EAAG,CAAU,CAAC;AAE/D,eAAO,MAAM,mCAAmC,6SAatC,CAAC;AAEX,eAAO,MAAM,iCAAiC,qMAOpC,CAAC;AAKX,QAAA,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;kBAIpC,CAAC;AAgBH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA8B1C,CAAC;AAEL,MAAM,MAAM,8BAA8B,GAAG,CAAC,OAAO,mCAAmC,CAAC,CAAC,MAAM,CAAC,CAAC;AAClG,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,gCAAgC,CACxC,CAAC,OAAO,CAAC,CAAC;AACX,MAAM,MAAM,4BAA4B,GAAG,CAAC,OAAO,iCAAiC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9F,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,MAAM,WAAW,0BAA0B;IACzC,iBAAiB,IAAI,OAAO,CAAC,2BAA2B,CAAC,CAAC;CAC3D;AAED,KAAK,qBAAqB,GAAG,QAAQ,CACnC,MAAM,CACJ,8BAA8B,EAC9B;IAAE,QAAQ,CAAC,KAAK,EAAE,+BAA+B,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CACjF,CACF,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;CACxC,GAAG,2BAA2B,CAiC9B;AAED,wBAAgB,sCAAsC,CACpD,SAAS,EAAE,MAAM,GAChB,2BAA2B,CAY7B;AAED,uFAAuF;AACvF,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKvE"}