@adcp/sdk 14.0.0-rc.38 → 14.0.0-rc.39

package/dist/lib/reporting/source/index.d.mts

@@ -3,4 +3,5 @@ export * from './source.mjs';
 export * from './conformance.mjs';
 export * from './fixtures.mjs';
 export * from './builder.mjs';
-export * from './inline.mjs';
+export { INLINE_REPORTING_AVAILABILITY_EVIDENCE_VERSION_V1, InlineReportingSourceError, ReportingSourceNotReadyError, createInlineReportingSourceExecutor, } from './inline.mjs';
+export type { CreateInlineReportingSourceExecutorOptionsV1, InlineAdmissionReclaimerV1, InlineReportingAvailabilityEvidenceV1, InlineReportingDeliveryFetchV1, InlineReportingDeliveryRequestV1, InlineReportingDeliveryResponseV1, InlineReportingDeliveryResultV1, InlineReportingMetricEvidenceV1, InlineReportingReplayRetentionV1, InlineReportingSourceExecutorV1, } from './inline.mjs';

package/dist/lib/reporting/source/index.d.ts

@@ -3,4 +3,5 @@ export * from './source';
 export * from './conformance';
 export * from './fixtures';
 export * from './builder';
-export * from './inline';
+export { INLINE_REPORTING_AVAILABILITY_EVIDENCE_VERSION_V1, InlineReportingSourceError, ReportingSourceNotReadyError, createInlineReportingSourceExecutor, } from './inline';
+export type { CreateInlineReportingSourceExecutorOptionsV1, InlineAdmissionReclaimerV1, InlineReportingAvailabilityEvidenceV1, InlineReportingDeliveryFetchV1, InlineReportingDeliveryRequestV1, InlineReportingDeliveryResponseV1, InlineReportingDeliveryResultV1, InlineReportingMetricEvidenceV1, InlineReportingReplayRetentionV1, InlineReportingSourceExecutorV1, } from './inline';

package/dist/lib/reporting/source/index.js

@@ -3,6 +3,10 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -14,19 +18,28 @@ var __copyProps = (to, from, except, desc) => {
 var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var source_exports = {};
+__export(source_exports, {
+  INLINE_REPORTING_AVAILABILITY_EVIDENCE_VERSION_V1: () => import_inline.INLINE_REPORTING_AVAILABILITY_EVIDENCE_VERSION_V1,
+  InlineReportingSourceError: () => import_inline.InlineReportingSourceError,
+  ReportingSourceNotReadyError: () => import_inline.ReportingSourceNotReadyError,
+  createInlineReportingSourceExecutor: () => import_inline.createInlineReportingSourceExecutor
+});
 module.exports = __toCommonJS(source_exports);
 __reExport(source_exports, require('./manifest.js'), module.exports);
 __reExport(source_exports, require('./source.js'), module.exports);
 __reExport(source_exports, require('./conformance.js'), module.exports);
 __reExport(source_exports, require('./fixtures.js'), module.exports);
 __reExport(source_exports, require('./builder.js'), module.exports);
-__reExport(source_exports, require('./inline.js'), module.exports);
+var import_inline = require('./inline.js');
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  INLINE_REPORTING_AVAILABILITY_EVIDENCE_VERSION_V1,
+  InlineReportingSourceError,
+  ReportingSourceNotReadyError,
+  createInlineReportingSourceExecutor,
   ...require('./manifest.js'),
   ...require('./source.js'),
   ...require('./conformance.js'),
   ...require('./fixtures.js'),
-  ...require('./builder.js'),
-  ...require('./inline.js')
+  ...require('./builder.js')
 });

package/dist/lib/reporting/source/index.mjs

@@ -3,4 +3,15 @@ export * from "./source.mjs";
 export * from "./conformance.mjs";
 export * from "./fixtures.mjs";
 export * from "./builder.mjs";
-export * from "./inline.mjs";
+import {
+  INLINE_REPORTING_AVAILABILITY_EVIDENCE_VERSION_V1,
+  InlineReportingSourceError,
+  ReportingSourceNotReadyError,
+  createInlineReportingSourceExecutor
+} from "./inline.mjs";
+export {
+  INLINE_REPORTING_AVAILABILITY_EVIDENCE_VERSION_V1,
+  InlineReportingSourceError,
+  ReportingSourceNotReadyError,
+  createInlineReportingSourceExecutor
+};

package/dist/lib/reporting/source/inline.d.mts

@@ -4,6 +4,11 @@ export interface InlineReportingDeliveryRequestV1 {
         account_id: string;
     };
     media_buy_ids: string[];
+    /** Frozen manifest constituents. Use constituent_id when returning availability evidence. */
+    constituents: Array<Readonly<{
+        constituent_id: string;
+        media_buy_id: string;
+    }>>;
     start_date: string;
     end_date: string;
     /** Exact source observation ceiling for snapshot reads within the requested period. */
@@ -11,6 +16,31 @@ export interface InlineReportingDeliveryRequestV1 {
     requested_metrics: string[];
     reporting_dimensions: Record<string, Record<string, never>>;
 }
+export declare const INLINE_REPORTING_AVAILABILITY_EVIDENCE_VERSION_V1: "1.0";
+type InlineReportingAvailableMetricEvidenceV1 = Readonly<{
+    constituent_id: string;
+    metric: string;
+    status: 'present' | 'explicit_zero';
+    data_through: string;
+    reason?: never;
+}>;
+type InlineReportingUnavailableMetricEvidenceV1 = Readonly<{
+    constituent_id: string;
+    metric: string;
+    status: 'unsupported' | 'delayed' | 'partial' | 'stale' | 'missing';
+    reason: string;
+    data_through?: string;
+}>;
+/** One bounded availability claim for an exact requested constituent-metric cell. */
+export type InlineReportingMetricEvidenceV1 = InlineReportingAvailableMetricEvidenceV1 | InlineReportingUnavailableMetricEvidenceV1;
+/**
+ * Versioned inline evidence envelope. When supplied, cells must cover the exact
+ * requested constituent-metric matrix once each.
+ */
+export interface InlineReportingAvailabilityEvidenceV1 {
+    version: typeof INLINE_REPORTING_AVAILABILITY_EVIDENCE_VERSION_V1;
+    cells: readonly InlineReportingMetricEvidenceV1[];
+}
 export interface InlineReportingDeliveryResponseV1 {
     reporting_period?: Readonly<{
         start: string;
@@ -31,6 +61,7 @@ export interface InlineReportingDeliveryResponseV1 {
     status?: string;
     is_final?: boolean;
     notification_type?: 'scheduled' | 'final' | 'delayed' | 'adjusted' | 'window_update';
+    availability_evidence?: InlineReportingAvailabilityEvidenceV1;
 }
 export type InlineReportingDeliveryResultV1 = readonly unknown[] | InlineReportingDeliveryResponseV1 | null;
 export type InlineReportingDeliveryFetchV1 = (request: InlineReportingDeliveryRequestV1, context: Readonly<{
@@ -52,4 +83,60 @@ export type InlineReportingSourceExecutorV1 = ReportingSourceExecutorV1 & Report
  * Adapt a synchronous delivery handler to the reporting-source contract.
  * The returned object is both the executor and its generation-pinned reader.
  */
-export declare function createInlineReportingSourceExecutor(deliveryFetch: InlineReportingDeliveryFetchV1, offeringInput: ReportingSourceOfferingV1): InlineReportingSourceExecutorV1;
+/**
+ * Explicit replay-retention policy for the inline executor.
+ *
+ * By default every admitted execution is retained, which is what makes an
+ * admitted key replayable for the executor's lifetime — and what caps a scope
+ * at `INLINE_MAX_EXECUTIONS_PER_SCOPE_V1` slices. A scheduled feed that outlives
+ * that ceiling must either install a durable executor or opt in here, which
+ * trades the lifetime replay guarantee for a bounded window: a replay of an
+ * evicted key re-executes instead of returning its recorded result. Opting in
+ * is safe against the ledger, which binds each obligation to an immutable
+ * revision and refuses to rewrite one, but it is never applied silently.
+ */
+export interface InlineReportingReplayRetentionV1 {
+    /** Reclaim the oldest settled execution to admit new work. */
+    readonly evictSettled: true;
+}
+export interface CreateInlineReportingSourceExecutorOptionsV1 {
+    readonly replayRetention?: InlineReportingReplayRetentionV1;
+}
+export declare function createInlineReportingSourceExecutor(deliveryFetch: InlineReportingDeliveryFetchV1, offeringInput: ReportingSourceOfferingV1, executorOptions?: CreateInlineReportingSourceExecutorOptionsV1): InlineReportingSourceExecutorV1;
+/**
+ * One plan-only capacity transaction for a single admission.
+ *
+ * Both the execution-count ceilings and byte pressure reclaim through here, so
+ * the admission either commits every victim at staging or releases them
+ * untouched. Claims carry the identity of the transaction holding them, and a
+ * commit that cannot make itself whole deletes nothing at all.
+ */
+export interface InlineAdmissionReclaimerV1 {
+    /**
+     * Plan one victim. `scopeOnly` keeps it inside the requesting scope. Pass
+     * `credit` when the caller will spend the returned bytes as capacity: only
+     * credit actually granted is ever owed back if the claim is later revoked.
+     */
+    plan(scopeKey: string, scopeOnly: boolean, credit?: boolean): {
+        bytes: number;
+        sameScope: boolean;
+    } | undefined;
+    /** Claims still owned by this transaction that belong to `scopeKey`. */
+    plannedInScope(scopeKey: string): number;
+    /**
+     * Grant, and return, the bytes the count ceilings already reserved. Claims
+     * revoked before this call grant nothing, so they are never owed back.
+     */
+    grantReservedBytes(scopeKey: string): {
+        global: number;
+        scope: number;
+    };
+    /**
+     * Delete every still-owned claim, having first proven that any claim revoked
+     * while the slice was fetching can be replaced with equivalent count and
+     * bytes. Returns false — deleting nothing — when it cannot.
+     */
+    commit(scopeKey: string): boolean;
+    release(): void;
+}
+export {};

package/dist/lib/reporting/source/inline.d.ts

@@ -4,6 +4,11 @@ export interface InlineReportingDeliveryRequestV1 {
         account_id: string;
     };
     media_buy_ids: string[];
+    /** Frozen manifest constituents. Use constituent_id when returning availability evidence. */
+    constituents: Array<Readonly<{
+        constituent_id: string;
+        media_buy_id: string;
+    }>>;
     start_date: string;
     end_date: string;
     /** Exact source observation ceiling for snapshot reads within the requested period. */
@@ -11,6 +16,31 @@ export interface InlineReportingDeliveryRequestV1 {
     requested_metrics: string[];
     reporting_dimensions: Record<string, Record<string, never>>;
 }
+export declare const INLINE_REPORTING_AVAILABILITY_EVIDENCE_VERSION_V1: "1.0";
+type InlineReportingAvailableMetricEvidenceV1 = Readonly<{
+    constituent_id: string;
+    metric: string;
+    status: 'present' | 'explicit_zero';
+    data_through: string;
+    reason?: never;
+}>;
+type InlineReportingUnavailableMetricEvidenceV1 = Readonly<{
+    constituent_id: string;
+    metric: string;
+    status: 'unsupported' | 'delayed' | 'partial' | 'stale' | 'missing';
+    reason: string;
+    data_through?: string;
+}>;
+/** One bounded availability claim for an exact requested constituent-metric cell. */
+export type InlineReportingMetricEvidenceV1 = InlineReportingAvailableMetricEvidenceV1 | InlineReportingUnavailableMetricEvidenceV1;
+/**
+ * Versioned inline evidence envelope. When supplied, cells must cover the exact
+ * requested constituent-metric matrix once each.
+ */
+export interface InlineReportingAvailabilityEvidenceV1 {
+    version: typeof INLINE_REPORTING_AVAILABILITY_EVIDENCE_VERSION_V1;
+    cells: readonly InlineReportingMetricEvidenceV1[];
+}
 export interface InlineReportingDeliveryResponseV1 {
     reporting_period?: Readonly<{
         start: string;
@@ -31,6 +61,7 @@ export interface InlineReportingDeliveryResponseV1 {
     status?: string;
     is_final?: boolean;
     notification_type?: 'scheduled' | 'final' | 'delayed' | 'adjusted' | 'window_update';
+    availability_evidence?: InlineReportingAvailabilityEvidenceV1;
 }
 export type InlineReportingDeliveryResultV1 = readonly unknown[] | InlineReportingDeliveryResponseV1 | null;
 export type InlineReportingDeliveryFetchV1 = (request: InlineReportingDeliveryRequestV1, context: Readonly<{
@@ -52,4 +83,60 @@ export type InlineReportingSourceExecutorV1 = ReportingSourceExecutorV1 & Report
  * Adapt a synchronous delivery handler to the reporting-source contract.
  * The returned object is both the executor and its generation-pinned reader.
  */
-export declare function createInlineReportingSourceExecutor(deliveryFetch: InlineReportingDeliveryFetchV1, offeringInput: ReportingSourceOfferingV1): InlineReportingSourceExecutorV1;
+/**
+ * Explicit replay-retention policy for the inline executor.
+ *
+ * By default every admitted execution is retained, which is what makes an
+ * admitted key replayable for the executor's lifetime — and what caps a scope
+ * at `INLINE_MAX_EXECUTIONS_PER_SCOPE_V1` slices. A scheduled feed that outlives
+ * that ceiling must either install a durable executor or opt in here, which
+ * trades the lifetime replay guarantee for a bounded window: a replay of an
+ * evicted key re-executes instead of returning its recorded result. Opting in
+ * is safe against the ledger, which binds each obligation to an immutable
+ * revision and refuses to rewrite one, but it is never applied silently.
+ */
+export interface InlineReportingReplayRetentionV1 {
+    /** Reclaim the oldest settled execution to admit new work. */
+    readonly evictSettled: true;
+}
+export interface CreateInlineReportingSourceExecutorOptionsV1 {
+    readonly replayRetention?: InlineReportingReplayRetentionV1;
+}
+export declare function createInlineReportingSourceExecutor(deliveryFetch: InlineReportingDeliveryFetchV1, offeringInput: ReportingSourceOfferingV1, executorOptions?: CreateInlineReportingSourceExecutorOptionsV1): InlineReportingSourceExecutorV1;
+/**
+ * One plan-only capacity transaction for a single admission.
+ *
+ * Both the execution-count ceilings and byte pressure reclaim through here, so
+ * the admission either commits every victim at staging or releases them
+ * untouched. Claims carry the identity of the transaction holding them, and a
+ * commit that cannot make itself whole deletes nothing at all.
+ */
+export interface InlineAdmissionReclaimerV1 {
+    /**
+     * Plan one victim. `scopeOnly` keeps it inside the requesting scope. Pass
+     * `credit` when the caller will spend the returned bytes as capacity: only
+     * credit actually granted is ever owed back if the claim is later revoked.
+     */
+    plan(scopeKey: string, scopeOnly: boolean, credit?: boolean): {
+        bytes: number;
+        sameScope: boolean;
+    } | undefined;
+    /** Claims still owned by this transaction that belong to `scopeKey`. */
+    plannedInScope(scopeKey: string): number;
+    /**
+     * Grant, and return, the bytes the count ceilings already reserved. Claims
+     * revoked before this call grant nothing, so they are never owed back.
+     */
+    grantReservedBytes(scopeKey: string): {
+        global: number;
+        scope: number;
+    };
+    /**
+     * Delete every still-owned claim, having first proven that any claim revoked
+     * while the slice was fetching can be replaced with equivalent count and
+     * bytes. Returns false — deleting nothing — when it cannot.
+     */
+    commit(scopeKey: string): boolean;
+    release(): void;
+}
+export {};