@adcp/sdk 14.0.0-rc.47 → 14.0.0-rc.48

package/dist/lib/registry/types.generated.d.mts

@@ -4549,6 +4549,8 @@ export interface components {
             is_authoritative?: boolean;
             requested_compliance_target?: string | null;
             adcp_version?: string | null;
+            /** @description Runner capability version recorded at execution time, separate from the AdCP version under test. Null when not recorded, including historical runs. */
+            runner_capability_version?: string | null;
             overall_status: string;
             headline: string | null;
             tracks_passed: number;
@@ -10317,6 +10319,11 @@ export interface operations {
                         /** @enum {string} */
                         alternative_action: "monitoring_requeue";
                         alternative_description: string;
+                        /**
+                         * Format: uri
+                         * @description Issue tracking the restoration of human-initiated refresh
+                         */
+                        tracking_issue: string;
                     };
                 };
             };

package/dist/lib/registry/types.generated.d.ts

@@ -4549,6 +4549,8 @@ export interface components {
             is_authoritative?: boolean;
             requested_compliance_target?: string | null;
             adcp_version?: string | null;
+            /** @description Runner capability version recorded at execution time, separate from the AdCP version under test. Null when not recorded, including historical runs. */
+            runner_capability_version?: string | null;
             overall_status: string;
             headline: string | null;
             tracks_passed: number;
@@ -10317,6 +10319,11 @@ export interface operations {
                         /** @enum {string} */
                         alternative_action: "monitoring_requeue";
                         alternative_description: string;
+                        /**
+                         * Format: uri
+                         * @description Issue tracking the restoration of human-initiated refresh
+                         */
+                        tracking_issue: string;
                     };
                 };
             };

package/dist/lib/reporting/consumer-postgres.d.mts

@@ -0,0 +1,81 @@
+import type { ReportingCheckpointStore, ReportingPendingConsumerStatusStore, ReportingPersistenceLeaseFenceV1 } from './reconciliation.mjs';
+export interface ReportingConsumerPostgresQueryable {
+    query<Row extends Record<string, unknown> = Record<string, unknown>>(text: string, values?: unknown[]): Promise<{
+        rows: Row[];
+        rowCount: number | null;
+    }>;
+}
+export interface ReportingChangesCheckpointKeyV1 {
+    /** Stable, non-secret seller and authenticated-principal identity. Stored as a SHA-256 digest. */
+    consumerScope: string;
+    /** Protocol account identifier. Stored verbatim to support indexed operational lookup. */
+    accountId: string;
+}
+export interface ReportingChangesCheckpointV1 {
+    checkpoint: string;
+    generation: number;
+}
+export interface ReportingConsumerWorkLeaseV1 extends ReportingPersistenceLeaseFenceV1 {
+}
+export interface ReportingChangesCheckpointStoreV1 {
+    get(key: ReportingChangesCheckpointKeyV1): Promise<ReportingChangesCheckpointV1 | undefined>;
+    compareAndSet(key: ReportingChangesCheckpointKeyV1, expected: string | null, checkpoint: string, 
+    /** When supplied, PostgreSQL applies the cursor write only while this exact fenced lease is current. */
+    lease?: ReportingConsumerWorkLeaseV1): Promise<'applied' | 'unchanged' | 'conflict'>;
+    /** Retire an opaque cursor the seller no longer recognizes or returns. */
+    clear?(key: ReportingChangesCheckpointKeyV1, expected?: string, lease?: ReportingConsumerWorkLeaseV1): Promise<boolean>;
+}
+export interface ReportingConsumerWorkLeaseStoreV1 {
+    claim(input: {
+        key: ReportingChangesCheckpointKeyV1;
+        ownerToken: string;
+        leaseMilliseconds: number;
+    }): Promise<ReportingConsumerWorkLeaseV1 | null>;
+    renew(lease: ReportingConsumerWorkLeaseV1, leaseMilliseconds: number): Promise<ReportingConsumerWorkLeaseV1 | null>;
+    release(lease: ReportingConsumerWorkLeaseV1): Promise<boolean>;
+}
+export interface ReportingConsumerNotificationStoreV1 {
+    isProcessed(input: {
+        consumerScope: string;
+        accountId: string;
+        idempotencyKey: string;
+        payloadSha256: string;
+    }): Promise<boolean>;
+    markProcessed(input: {
+        consumerScope: string;
+        accountId: string;
+        idempotencyKey: string;
+        payloadSha256: string;
+    }): Promise<void>;
+    pruneProcessed(options?: {
+        retentionDays?: number;
+        limit?: number;
+    }): Promise<number>;
+}
+export interface CreatePostgresReportingConsumerRuntimeOptionsV1 {
+    db: ReportingConsumerPostgresQueryable;
+    /** Stable deployment namespace. Never use a credential, bearer, or connection string. */
+    namespace: string;
+    /** Lowercase PostgreSQL identifier prefix, at most 32 bytes. */
+    tablePrefix?: string;
+}
+export interface PostgresReportingConsumerRuntimeV1 {
+    readonly checkpointStore: ReportingCheckpointStore;
+    readonly pendingConsumerStatusStore: ReportingPendingConsumerStatusStore;
+    readonly changesCheckpointStore: ReportingChangesCheckpointStoreV1;
+    readonly workLeases: ReportingConsumerWorkLeaseStoreV1;
+    readonly notifications: ReportingConsumerNotificationStoreV1;
+    readonly migrations: {
+        persistence: string;
+        all: readonly [string];
+    };
+    probe(): Promise<void>;
+}
+export declare class ReportingConsumerPersistenceConflictError extends Error {
+    readonly name = "ReportingConsumerPersistenceConflictError";
+}
+export declare function getReportingConsumerPostgresMigration(options?: {
+    tablePrefix?: string;
+}): string;
+export declare const REPORTING_CONSUMER_POSTGRES_MIGRATION: string;
+export declare function createPostgresReportingConsumerRuntimeV1(options: CreatePostgresReportingConsumerRuntimeOptionsV1): PostgresReportingConsumerRuntimeV1;

package/dist/lib/reporting/consumer-postgres.d.ts

@@ -0,0 +1,81 @@
+import type { ReportingCheckpointStore, ReportingPendingConsumerStatusStore, ReportingPersistenceLeaseFenceV1 } from './reconciliation';
+export interface ReportingConsumerPostgresQueryable {
+    query<Row extends Record<string, unknown> = Record<string, unknown>>(text: string, values?: unknown[]): Promise<{
+        rows: Row[];
+        rowCount: number | null;
+    }>;
+}
+export interface ReportingChangesCheckpointKeyV1 {
+    /** Stable, non-secret seller and authenticated-principal identity. Stored as a SHA-256 digest. */
+    consumerScope: string;
+    /** Protocol account identifier. Stored verbatim to support indexed operational lookup. */
+    accountId: string;
+}
+export interface ReportingChangesCheckpointV1 {
+    checkpoint: string;
+    generation: number;
+}
+export interface ReportingConsumerWorkLeaseV1 extends ReportingPersistenceLeaseFenceV1 {
+}
+export interface ReportingChangesCheckpointStoreV1 {
+    get(key: ReportingChangesCheckpointKeyV1): Promise<ReportingChangesCheckpointV1 | undefined>;
+    compareAndSet(key: ReportingChangesCheckpointKeyV1, expected: string | null, checkpoint: string, 
+    /** When supplied, PostgreSQL applies the cursor write only while this exact fenced lease is current. */
+    lease?: ReportingConsumerWorkLeaseV1): Promise<'applied' | 'unchanged' | 'conflict'>;
+    /** Retire an opaque cursor the seller no longer recognizes or returns. */
+    clear?(key: ReportingChangesCheckpointKeyV1, expected?: string, lease?: ReportingConsumerWorkLeaseV1): Promise<boolean>;
+}
+export interface ReportingConsumerWorkLeaseStoreV1 {
+    claim(input: {
+        key: ReportingChangesCheckpointKeyV1;
+        ownerToken: string;
+        leaseMilliseconds: number;
+    }): Promise<ReportingConsumerWorkLeaseV1 | null>;
+    renew(lease: ReportingConsumerWorkLeaseV1, leaseMilliseconds: number): Promise<ReportingConsumerWorkLeaseV1 | null>;
+    release(lease: ReportingConsumerWorkLeaseV1): Promise<boolean>;
+}
+export interface ReportingConsumerNotificationStoreV1 {
+    isProcessed(input: {
+        consumerScope: string;
+        accountId: string;
+        idempotencyKey: string;
+        payloadSha256: string;
+    }): Promise<boolean>;
+    markProcessed(input: {
+        consumerScope: string;
+        accountId: string;
+        idempotencyKey: string;
+        payloadSha256: string;
+    }): Promise<void>;
+    pruneProcessed(options?: {
+        retentionDays?: number;
+        limit?: number;
+    }): Promise<number>;
+}
+export interface CreatePostgresReportingConsumerRuntimeOptionsV1 {
+    db: ReportingConsumerPostgresQueryable;
+    /** Stable deployment namespace. Never use a credential, bearer, or connection string. */
+    namespace: string;
+    /** Lowercase PostgreSQL identifier prefix, at most 32 bytes. */
+    tablePrefix?: string;
+}
+export interface PostgresReportingConsumerRuntimeV1 {
+    readonly checkpointStore: ReportingCheckpointStore;
+    readonly pendingConsumerStatusStore: ReportingPendingConsumerStatusStore;
+    readonly changesCheckpointStore: ReportingChangesCheckpointStoreV1;
+    readonly workLeases: ReportingConsumerWorkLeaseStoreV1;
+    readonly notifications: ReportingConsumerNotificationStoreV1;
+    readonly migrations: {
+        persistence: string;
+        all: readonly [string];
+    };
+    probe(): Promise<void>;
+}
+export declare class ReportingConsumerPersistenceConflictError extends Error {
+    readonly name = "ReportingConsumerPersistenceConflictError";
+}
+export declare function getReportingConsumerPostgresMigration(options?: {
+    tablePrefix?: string;
+}): string;
+export declare const REPORTING_CONSUMER_POSTGRES_MIGRATION: string;
+export declare function createPostgresReportingConsumerRuntimeV1(options: CreatePostgresReportingConsumerRuntimeOptionsV1): PostgresReportingConsumerRuntimeV1;