@adcp/sdk 15.5.0 → 15.6.0

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

@@ -0,0 +1,317 @@
+import { randomUUID } from "node:crypto";
+import {
+  DeleteObjectCommand,
+  GetBucketLifecycleConfigurationCommand,
+  GetBucketPolicyStatusCommand,
+  GetBucketVersioningCommand,
+  GetObjectCommand,
+  HeadBucketCommand,
+  HeadObjectCommand,
+  PutObjectCommand
+} from "@aws-sdk/client-s3";
+import { ReportingRowStoreError } from "../ledger/row-storage-errors.mjs";
+import {
+  assertReportingRowLocationKeys,
+  assertReportingRowReadBounds,
+  readReportingRowStream,
+  reportingRowClientMap,
+  reportingRowPrefixFilterOverlaps,
+  runReportingRowProviderOperation,
+  selectReportingRowClient
+} from "../ledger/row-storage-provider-io.mjs";
+const BUCKET = /^[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$/;
+const REGION = /^[a-z0-9][a-z0-9-]{0,30}[a-z0-9]$/;
+const VERSION_ID = /^[\x21\x23-\x7e]{1,1024}$/;
+function statusOf(error) {
+  const status = Number(error?.$metadata?.httpStatusCode);
+  return Number.isInteger(status) ? status : void 0;
+}
+function nameOf(error) {
+  const value = error?.name ?? error?.Code;
+  return typeof value === "string" ? value : "";
+}
+const isPreconditionFailed = (error) => statusOf(error) === 412 || nameOf(error) === "PreconditionFailed";
+const isConditionalConflict = (error) => statusOf(error) === 409 || nameOf(error) === "ConditionalRequestConflict";
+const isNotFound = (error) => statusOf(error) === 404 || ["NoSuchKey", "NotFound", "NoSuchVersion", "NoSuchBucket"].includes(nameOf(error));
+const isNotImplemented = (error) => statusOf(error) === 501 || nameOf(error) === "NotImplemented";
+const isForbidden = (error) => statusOf(error) === 401 || statusOf(error) === 403;
+const isRangeError = (error) => statusOf(error) === 416 || nameOf(error) === "InvalidRange";
+function versionOf(output) {
+  const id = output.VersionId;
+  if (typeof id !== "string" || id === "null" || !VERSION_ID.test(id)) {
+    throw new ReportingRowStoreError(
+      "UNSAFE_BINDING",
+      "store returned no object VersionId; S3 bucket versioning must be enabled so deletes are fenced to one write"
+    );
+  }
+  return id;
+}
+function selectorOf(nativeVersion) {
+  if (typeof nativeVersion !== "string" || nativeVersion === "null") return null;
+  return VERSION_ID.test(nativeVersion) ? { VersionId: nativeVersion } : null;
+}
+function servedVersion(output, selector) {
+  return output.VersionId === selector.VersionId;
+}
+function liveExpirationCovers(rule, prefix) {
+  if (rule.Status !== "Enabled") return false;
+  if (rule.Expiration?.Days === void 0 && rule.Expiration?.Date === void 0) return false;
+  if (rule.Filter?.Tag !== void 0 || (rule.Filter?.And?.Tags?.length ?? 0) > 0) return false;
+  const filter = rule.Filter?.Prefix ?? rule.Filter?.And?.Prefix ?? rule.Prefix;
+  return reportingRowPrefixFilterOverlaps(filter, prefix);
+}
+function createS3ReportingRowObjectProviderV1(options) {
+  if (!options || typeof options !== "object") {
+    throw new ReportingRowStoreError("INVALID_INPUT", "S3 row provider options are required");
+  }
+  const clients = reportingRowClientMap(options.clients);
+  const isClient = (value) => !!value && typeof value === "object" && typeof value.send === "function";
+  if (options.client !== void 0 && !isClient(options.client) || [...clients.values()].some((client) => !isClient(client)) || options.client === void 0 && clients.size === 0) {
+    throw new ReportingRowStoreError("INVALID_INPUT", "inject an official S3Client as client or clients");
+  }
+  const validateLocation = (location) => {
+    assertReportingRowLocationKeys(location, ["bucket"], ["region"]);
+    const bucket = location.bucket;
+    if (!BUCKET.test(bucket) || bucket.includes("..") || /^\d+\.\d+\.\d+\.\d+$/.test(bucket)) {
+      throw new ReportingRowStoreError("INVALID_INPUT", "S3 bucket name is invalid");
+    }
+    if (location.region !== void 0 && !REGION.test(location.region)) {
+      throw new ReportingRowStoreError("INVALID_INPUT", "S3 region is invalid");
+    }
+  };
+  const target = (input) => {
+    validateLocation(input.location);
+    return {
+      client: selectReportingRowClient(options.client, clients, input.credentialRef),
+      Bucket: input.location.bucket
+    };
+  };
+  const assertKey = (key) => {
+    if (typeof key !== "string" || key.length === 0 || Buffer.byteLength(key) > 1024) {
+      throw new ReportingRowStoreError("INVALID_INPUT", "object key is invalid");
+    }
+  };
+  async function putCreateOnly(client, params, signal) {
+    for (let attempt = 0; ; attempt++) {
+      try {
+        return await client.send(new PutObjectCommand({ ...params, IfNoneMatch: "*" }), { abortSignal: signal });
+      } catch (error) {
+        if (attempt === 0 && isConditionalConflict(error) && !signal.aborted) continue;
+        throw error;
+      }
+    }
+  }
+  async function assertVersioningEnabled(client, Bucket, signal) {
+    let status;
+    try {
+      status = (await client.send(new GetBucketVersioningCommand({ Bucket }), { abortSignal: signal })).Status;
+    } catch (error) {
+      if (isForbidden(error) || isNotImplemented(error)) {
+        throw new ReportingRowStoreError("UNSAFE_BINDING", "bucket versioning status cannot be verified");
+      }
+      throw error;
+    }
+    if (status !== "Enabled") {
+      throw new ReportingRowStoreError(
+        "UNSAFE_BINDING",
+        "S3 bucket versioning must be enabled so row object deletes are fenced to one write"
+      );
+    }
+  }
+  async function assertCreateOnlyEnforced(client, Bucket, prefix, signal) {
+    const Key = `${prefix}/.adcp-probe/${randomUUID()}`;
+    const written = [];
+    const put = async (body) => {
+      const output = await putCreateOnly(
+        client,
+        { Bucket, Key, Body: Buffer.from(body), ContentType: "application/x-ndjson", CacheControl: "no-store" },
+        signal
+      );
+      written.push(output);
+      versionOf(output);
+    };
+    try {
+      try {
+        await put('{"probe":1}\n');
+      } catch (error) {
+        if (isNotImplemented(error) || isPreconditionFailed(error)) {
+          throw new ReportingRowStoreError("UNSAFE_BINDING", "store does not support create-only writes");
+        }
+        throw error;
+      }
+      try {
+        await put('{"probe":2}\n');
+      } catch (error) {
+        if (isPreconditionFailed(error)) return;
+        if (isNotImplemented(error)) {
+          throw new ReportingRowStoreError("UNSAFE_BINDING", "store does not support create-only writes");
+        }
+        throw error;
+      }
+      throw new ReportingRowStoreError("UNSAFE_BINDING", "store ignores If-None-Match and replaces objects");
+    } finally {
+      const versionIds = written.map((output) => output.VersionId).filter((id) => !!id);
+      const deletes = versionIds.length > 0 ? versionIds.map((VersionId) => ({ VersionId })) : written.length ? [{}] : [];
+      for (const selector of deletes) {
+        if (signal.aborted) break;
+        await client.send(new DeleteObjectCommand({ Bucket, Key, ...selector }), { abortSignal: signal }).catch(() => void 0);
+      }
+    }
+  }
+  return {
+    name: "s3",
+    rangedReads: true,
+    validateLocation,
+    probe(input, context) {
+      return runReportingRowProviderOperation(context.signal, async () => {
+        const { client, Bucket } = target(input);
+        const signal = context.signal;
+        try {
+          await client.send(new HeadBucketCommand({ Bucket }), { abortSignal: signal });
+        } catch (error) {
+          if (isNotFound(error)) throw new ReportingRowStoreError("UNSAFE_BINDING", "bucket does not exist");
+          if (isForbidden(error)) throw new ReportingRowStoreError("UNSAFE_BINDING", "bucket is not accessible");
+          if (statusOf(error) === 301) {
+            throw new ReportingRowStoreError("UNSAFE_BINDING", "bucket is in a different region");
+          }
+          throw error;
+        }
+        if (input.location.region !== void 0) {
+          const configured = client.config?.region;
+          const region = typeof configured === "function" ? await configured() : configured;
+          if (region !== input.location.region) {
+            throw new ReportingRowStoreError("UNSAFE_BINDING", "client region does not match the binding");
+          }
+        }
+        const policy = await client.send(new GetBucketPolicyStatusCommand({ Bucket }), { abortSignal: signal }).catch(() => void 0);
+        if (policy?.PolicyStatus?.IsPublic === true) {
+          throw new ReportingRowStoreError("UNSAFE_BINDING", "bucket policy makes objects public");
+        }
+        let rules = [];
+        try {
+          const lifecycle = await client.send(new GetBucketLifecycleConfigurationCommand({ Bucket }), {
+            abortSignal: signal
+          });
+          rules = lifecycle.Rules ?? [];
+        } catch (error) {
+          if (isForbidden(error)) {
+            throw new ReportingRowStoreError("UNSAFE_BINDING", "bucket lifecycle cannot be read with this client");
+          }
+          if (!isNotFound(error) && !isNotImplemented(error) && nameOf(error) !== "NoSuchLifecycleConfiguration") {
+            throw error;
+          }
+        }
+        if (rules.some((rule) => liveExpirationCovers(rule, input.prefix))) {
+          throw new ReportingRowStoreError("UNSAFE_BINDING", "a bucket lifecycle rule can expire live row objects");
+        }
+        await assertVersioningEnabled(client, Bucket, signal);
+        await assertCreateOnlyEnforced(client, Bucket, input.prefix, signal);
+      });
+    },
+    putIfAbsent(input, context) {
+      return runReportingRowProviderOperation(context.signal, async () => {
+        const { client, Bucket } = target(input);
+        assertKey(input.key);
+        const bytes = Buffer.from(input.bytes);
+        try {
+          const output = await putCreateOnly(
+            client,
+            {
+              Bucket,
+              Key: input.key,
+              Body: bytes,
+              ContentLength: bytes.byteLength,
+              ContentType: input.contentType,
+              CacheControl: "no-store",
+              Metadata: { ...input.metadata }
+            },
+            context.signal
+          );
+          return { created: true, nativeVersion: versionOf(output) };
+        } catch (error) {
+          if (!isPreconditionFailed(error)) throw error;
+        }
+        const head = await client.send(new HeadObjectCommand({ Bucket, Key: input.key }), {
+          abortSignal: context.signal
+        });
+        return { created: false, nativeVersion: versionOf(head) };
+      });
+    },
+    get(input, context) {
+      return runReportingRowProviderOperation(context.signal, async () => {
+        const { client, Bucket } = target(input);
+        assertKey(input.key);
+        assertReportingRowReadBounds(input);
+        const selector = selectorOf(input.nativeVersion);
+        if (selector === null) return null;
+        const Key = input.key;
+        try {
+          if (input.range?.length === 0) {
+            const head = await client.send(new HeadObjectCommand({ Bucket, Key, ...selector }), {
+              abortSignal: context.signal
+            });
+            if (!servedVersion(head, selector)) return null;
+            if (input.range.offset > Number(head.ContentLength ?? 0)) {
+              throw new ReportingRowStoreError("ROWS_INTEGRITY_FAILED", "requested range exceeds the stored object");
+            }
+            return Buffer.alloc(0);
+          }
+          const output = await client.send(
+            new GetObjectCommand({
+              Bucket,
+              Key,
+              ...selector,
+              ...input.range ? { Range: `bytes=${input.range.offset}-${input.range.offset + input.range.length - 1}` } : {}
+            }),
+            { abortSignal: context.signal }
+          );
+          const body = output.Body;
+          if (!body || typeof body[Symbol.asyncIterator] !== "function") {
+            throw new ReportingRowStoreError("PROVIDER_UNAVAILABLE", "object body is not a stream");
+          }
+          if (!servedVersion(output, selector)) {
+            body.destroy?.();
+            return null;
+          }
+          if (typeof output.ContentLength === "number" && output.ContentLength > input.maxBytes) {
+            body.destroy?.();
+            throw new ReportingRowStoreError("ROWS_INTEGRITY_FAILED", "stored object exceeds its recorded size");
+          }
+          return await readReportingRowStream(body, input.maxBytes, context.signal);
+        } catch (error) {
+          if (isNotFound(error) || isPreconditionFailed(error)) return null;
+          if (statusOf(error) === 400 && nameOf(error) !== "InvalidRange") return null;
+          if (isRangeError(error)) {
+            throw new ReportingRowStoreError("ROWS_INTEGRITY_FAILED", "requested range exceeds the stored object");
+          }
+          throw error;
+        }
+      });
+    },
+    delete(input, context) {
+      return runReportingRowProviderOperation(context.signal, async () => {
+        const { client, Bucket } = target(input);
+        assertKey(input.key);
+        const selector = selectorOf(input.nativeVersion);
+        if (selector === null) return "absent";
+        const Key = input.key;
+        const signal = context.signal;
+        try {
+          const head = await client.send(new HeadObjectCommand({ Bucket, Key, ...selector }), { abortSignal: signal });
+          if (!servedVersion(head, selector)) return "absent";
+        } catch (error) {
+          if (isNotFound(error) || isPreconditionFailed(error)) return "absent";
+          if (statusOf(error) === 400 || statusOf(error) === 405) return "absent";
+          throw error;
+        }
+        await client.send(new DeleteObjectCommand({ Bucket, Key, VersionId: selector.VersionId }), {
+          abortSignal: signal
+        });
+        return "deleted";
+      });
+    }
+  };
+}
+export {
+  createS3ReportingRowObjectProviderV1
+};

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

@@ -207,7 +207,9 @@ export type CreatePostgresReliableReportingProductionServiceOptionsV1<TCtxMeta =
      * periods once `max(statusRetentionDays, recordRetentionDays)` has elapsed
      * since both the period end and its latest publication, deleting their
      * rows and ledger records and leaving a tombstone. Abandoned row uploads
-     * and expired cursor snapshots are always swept.
+     * and expired cursor snapshots are always swept. With `changeFeed`, a
+     * period is also held until every live registered feed consumer (updated
+     * within `changeFeed.maxFeedHoldDays`, default 7) has read its changes.
      */
     retention?: {
         enabled: true;

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

@@ -207,7 +207,9 @@ export type CreatePostgresReliableReportingProductionServiceOptionsV1<TCtxMeta =
      * periods once `max(statusRetentionDays, recordRetentionDays)` has elapsed
      * since both the period end and its latest publication, deleting their
      * rows and ledger records and leaving a tombstone. Abandoned row uploads
-     * and expired cursor snapshots are always swept.
+     * and expired cursor snapshots are always swept. With `changeFeed`, a
+     * period is also held until every live registered feed consumer (updated
+     * within `changeFeed.maxFeedHoldDays`, default 7) has read its changes.
      */
     retention?: {
         enabled: true;

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

@@ -526,6 +526,7 @@ async function createPostgresReliableReportingProductionService(options) {
           coreStore.retireExpiredPeriods({
             statusRetentionDays: options.statusRetentionDays,
             ...options.retention.recordRetentionDays !== void 0 ? { recordRetentionDays: options.retention.recordRetentionDays } : {},
+            ...typeof options.changeFeed === "object" && options.changeFeed.maxFeedHoldDays !== void 0 ? { maxFeedHoldDays: options.changeFeed.maxFeedHoldDays } : {},
             limit: options.retention.limit ?? 100,
             signal
           })

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

@@ -535,6 +535,7 @@ async function createPostgresReliableReportingProductionService(options) {
           coreStore.retireExpiredPeriods({
             statusRetentionDays: options.statusRetentionDays,
             ...options.retention.recordRetentionDays !== void 0 ? { recordRetentionDays: options.retention.recordRetentionDays } : {},
+            ...typeof options.changeFeed === "object" && options.changeFeed.maxFeedHoldDays !== void 0 ? { maxFeedHoldDays: options.changeFeed.maxFeedHoldDays } : {},
             limit: options.retention.limit ?? 100,
             signal
           })

package/dist/lib/schemas/browser.d.mts

@@ -0,0 +1,14 @@
+/**
+ * Browser-safe Zod schemas for validating AdCP objects in widgets and UIs.
+ *
+ * Import from `@adcp/sdk/schemas/browser`. This entry exposes the generated
+ * schemas and portable cross-field validators without loading the Node-only
+ * JSON Schema loader or bundled schema store.
+ */
+export * from '../types/schemas.generated.mjs';
+export { GetProductsRequestSchema, LegacyGetProductsRequestSchema } from '../validation/get-products-request.mjs';
+export type { LooseObjectSchemaFor } from '../validation/get-products-request.mjs';
+export { BiddingPolicySchema } from '../validation/bidding-policy.mjs';
+export { CanonicalBudgetAllocationSchema } from '../validation/budget-allocation.mjs';
+export { SyncCreativesItemSchema, SyncCreativesSuccessStrictSchema, SyncCreativesResponseStrictSchema, SyncCreativesActionSchema, } from '../validation/sync-creatives.mjs';
+export type { SyncCreativesItem, SyncCreativesSuccessStrict } from '../validation/sync-creatives.mjs';

package/dist/lib/schemas/browser.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Browser-safe Zod schemas for validating AdCP objects in widgets and UIs.
+ *
+ * Import from `@adcp/sdk/schemas/browser`. This entry exposes the generated
+ * schemas and portable cross-field validators without loading the Node-only
+ * JSON Schema loader or bundled schema store.
+ */
+export * from '../types/schemas.generated';
+export { GetProductsRequestSchema, LegacyGetProductsRequestSchema } from '../validation/get-products-request';
+export type { LooseObjectSchemaFor } from '../validation/get-products-request';
+export { BiddingPolicySchema } from '../validation/bidding-policy';
+export { CanonicalBudgetAllocationSchema } from '../validation/budget-allocation';
+export { SyncCreativesItemSchema, SyncCreativesSuccessStrictSchema, SyncCreativesResponseStrictSchema, SyncCreativesActionSchema, } from '../validation/sync-creatives';
+export type { SyncCreativesItem, SyncCreativesSuccessStrict } from '../validation/sync-creatives';

package/dist/lib/schemas/browser.js

@@ -0,0 +1,48 @@
+"use strict";
+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))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var browser_exports = {};
+__export(browser_exports, {
+  BiddingPolicySchema: () => import_bidding_policy.BiddingPolicySchema,
+  CanonicalBudgetAllocationSchema: () => import_budget_allocation.CanonicalBudgetAllocationSchema,
+  GetProductsRequestSchema: () => import_get_products_request.GetProductsRequestSchema,
+  LegacyGetProductsRequestSchema: () => import_get_products_request.LegacyGetProductsRequestSchema,
+  SyncCreativesActionSchema: () => import_sync_creatives.SyncCreativesActionSchema,
+  SyncCreativesItemSchema: () => import_sync_creatives.SyncCreativesItemSchema,
+  SyncCreativesResponseStrictSchema: () => import_sync_creatives.SyncCreativesResponseStrictSchema,
+  SyncCreativesSuccessStrictSchema: () => import_sync_creatives.SyncCreativesSuccessStrictSchema
+});
+module.exports = __toCommonJS(browser_exports);
+__reExport(browser_exports, require('../types/schemas.generated.js'), module.exports);
+var import_get_products_request = require('../validation/get-products-request.js');
+var import_bidding_policy = require('../validation/bidding-policy.js');
+var import_budget_allocation = require('../validation/budget-allocation.js');
+var import_sync_creatives = require('../validation/sync-creatives.js');
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BiddingPolicySchema,
+  CanonicalBudgetAllocationSchema,
+  GetProductsRequestSchema,
+  LegacyGetProductsRequestSchema,
+  SyncCreativesActionSchema,
+  SyncCreativesItemSchema,
+  SyncCreativesResponseStrictSchema,
+  SyncCreativesSuccessStrictSchema,
+  ...require('../types/schemas.generated.js')
+});

package/dist/lib/schemas/browser.mjs

@@ -0,0 +1,20 @@
+export * from "../types/schemas.generated.mjs";
+import { GetProductsRequestSchema, LegacyGetProductsRequestSchema } from "../validation/get-products-request.mjs";
+import { BiddingPolicySchema } from "../validation/bidding-policy.mjs";
+import { CanonicalBudgetAllocationSchema } from "../validation/budget-allocation.mjs";
+import {
+  SyncCreativesItemSchema,
+  SyncCreativesSuccessStrictSchema,
+  SyncCreativesResponseStrictSchema,
+  SyncCreativesActionSchema
+} from "../validation/sync-creatives.mjs";
+export {
+  BiddingPolicySchema,
+  CanonicalBudgetAllocationSchema,
+  GetProductsRequestSchema,
+  LegacyGetProductsRequestSchema,
+  SyncCreativesActionSchema,
+  SyncCreativesItemSchema,
+  SyncCreativesResponseStrictSchema,
+  SyncCreativesSuccessStrictSchema
+};

package/dist/lib/schemas/index.d.mts

@@ -41,7 +41,6 @@
  */
 import { z } from 'zod';
 import * as schemas from '../types/schemas.generated.mjs';
-import type { CanonicalGetProductsRequest } from '../v2/projection/creative-delivery.mjs';
 import type { KnownToolRequestSchemas } from '../utils/tool-request-schemas.mjs';
 import { getSchemaDocumentByRef, type Direction, type ResolvedToolSchemaDocument, type ResponseVariant } from '../validation/schema-loader.mjs';
 import type { ValidateFunction } from 'ajv';
@@ -49,125 +48,8 @@ export * from '../types/schemas.generated.mjs';
 export { AgentOAuthClientCredentialsSchema } from '../auth/oauth/client-credentials-schema.mjs';
 export type { AgentOAuthClientCredentials } from '../types/adcp.mjs';
 export type { PlacementPresentationDocument, PlacementPresentationReference } from '../types/core.generated.mjs';
-type LooseObjectShapeFor<T extends object> = {
-    [K in keyof T]-?: undefined extends T[K] ? z.ZodOptional<z.ZodType<Exclude<T[K], undefined>, Exclude<T[K], undefined>>> : z.ZodType<T[K], T[K]>;
-};
-type ZodShapeOutput<U extends z.core.$ZodShape> = {
-    [K in keyof U as undefined extends z.output<U[K]> ? never : K]: z.output<U[K]>;
-} & {
-    [K in keyof U as undefined extends z.output<U[K]> ? K : never]?: z.output<U[K]>;
-};
-/** Portable loose-object facade retained across adopter declaration emit. */
-export type LooseObjectSchemaFor<T extends object> = {
-    extend<U extends z.core.$ZodShape>(shape: U): LooseObjectSchemaFor<Omit<T, keyof U> & ZodShapeOutput<U>>;
-} & z.ZodObject<LooseObjectShapeFor<T>, z.core.$loose> & z.ZodType<T & Record<string, unknown>, T & Record<string, unknown>>;
-/** Wire-compatible request schema, including the legacy `format_ids` selector. */
-export declare const LegacyGetProductsRequestSchema: z.ZodObject<{
-    adcp_version: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-    adcp_major_version: z.ZodOptional<z.ZodType<number, number, z.core.$ZodTypeInternals<number, number>>>;
-    idempotency_key: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-    buying_mode: z.ZodType<"brief" | "wholesale" | "refine", "brief" | "wholesale" | "refine", z.core.$ZodTypeInternals<"brief" | "wholesale" | "refine", "brief" | "wholesale" | "refine">>;
-    brief: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-    refine: z.ZodOptional<z.ZodType<({
-        scope: "request";
-        ask: string;
-    } | {
-        scope: "product";
-        product_id: string;
-        action?: "include" | "omit" | "more_like_this";
-        ask?: string;
-    } | {
-        scope: "proposal";
-        proposal_id: string;
-        action?: "include" | "omit" | "finalize";
-        ask?: string;
-    })[], ({
-        scope: "request";
-        ask: string;
-    } | {
-        scope: "product";
-        product_id: string;
-        action?: "include" | "omit" | "more_like_this";
-        ask?: string;
-    } | {
-        scope: "proposal";
-        proposal_id: string;
-        action?: "include" | "omit" | "finalize";
-        ask?: string;
-    })[], z.core.$ZodTypeInternals<({
-        scope: "request";
-        ask: string;
-    } | {
-        scope: "product";
-        product_id: string;
-        action?: "include" | "omit" | "more_like_this";
-        ask?: string;
-    } | {
-        scope: "proposal";
-        proposal_id: string;
-        action?: "include" | "omit" | "finalize";
-        ask?: string;
-    })[], ({
-        scope: "request";
-        ask: string;
-    } | {
-        scope: "product";
-        product_id: string;
-        action?: "include" | "omit" | "more_like_this";
-        ask?: string;
-    } | {
-        scope: "proposal";
-        proposal_id: string;
-        action?: "include" | "omit" | "finalize";
-        ask?: string;
-    })[]>>>;
-    brand: z.ZodOptional<z.ZodType<import("../types/core.generated.mjs").BrandReference, import("../types/core.generated.mjs").BrandReference, z.core.$ZodTypeInternals<import("../types/core.generated.mjs").BrandReference, import("../types/core.generated.mjs").BrandReference>>>;
-    acceptance_context: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").AcceptanceContext, import("../types/tools.generated.mjs").AcceptanceContext, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").AcceptanceContext, import("../types/tools.generated.mjs").AcceptanceContext>>>;
-    catalog: z.ZodOptional<z.ZodType<import("../index.mjs").Catalog, import("../index.mjs").Catalog, z.core.$ZodTypeInternals<import("../index.mjs").Catalog, import("../index.mjs").Catalog>>>;
-    account: z.ZodOptional<z.ZodType<import("../types/core.generated.mjs").AccountReference, import("../types/core.generated.mjs").AccountReference, z.core.$ZodTypeInternals<import("../types/core.generated.mjs").AccountReference, import("../types/core.generated.mjs").AccountReference>>>;
-    preferred_delivery_types: z.ZodOptional<z.ZodType<import("../types/core.generated.mjs").DeliveryType[], import("../types/core.generated.mjs").DeliveryType[], z.core.$ZodTypeInternals<import("../types/core.generated.mjs").DeliveryType[], import("../types/core.generated.mjs").DeliveryType[]>>>;
-    filters: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").ProductFilters, import("../types/tools.generated.mjs").ProductFilters, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").ProductFilters, import("../types/tools.generated.mjs").ProductFilters>>>;
-    targeting_overlay: z.ZodOptional<z.ZodType<import("../index.mjs").TargetingOverlay, import("../index.mjs").TargetingOverlay, z.core.$ZodTypeInternals<import("../index.mjs").TargetingOverlay, import("../index.mjs").TargetingOverlay>>>;
-    media_buy_frequency_cap: z.ZodOptional<z.ZodType<{
-        suppress?: import("../index.mjs").Duration;
-        suppress_minutes?: number;
-        max_impressions?: number;
-        per?: import("../types/core.generated.mjs").ReachUnit;
-        window?: import("../index.mjs").Duration;
-    }, {
-        suppress?: import("../index.mjs").Duration;
-        suppress_minutes?: number;
-        max_impressions?: number;
-        per?: import("../types/core.generated.mjs").ReachUnit;
-        window?: import("../index.mjs").Duration;
-    }, z.core.$ZodTypeInternals<{
-        suppress?: import("../index.mjs").Duration;
-        suppress_minutes?: number;
-        max_impressions?: number;
-        per?: import("../types/core.generated.mjs").ReachUnit;
-        window?: import("../index.mjs").Duration;
-    }, {
-        suppress?: import("../index.mjs").Duration;
-        suppress_minutes?: number;
-        max_impressions?: number;
-        per?: import("../types/core.generated.mjs").ReachUnit;
-        window?: import("../index.mjs").Duration;
-    }>>>;
-    required_overlay_support: z.ZodOptional<z.ZodType<import("../types/core.generated.mjs").TargetingOverlayRequirements, import("../types/core.generated.mjs").TargetingOverlayRequirements, z.core.$ZodTypeInternals<import("../types/core.generated.mjs").TargetingOverlayRequirements, import("../types/core.generated.mjs").TargetingOverlayRequirements>>>;
-    required_media_buy_support: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").ProductMediaBuySupportRequirements, import("../types/tools.generated.mjs").ProductMediaBuySupportRequirements, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").ProductMediaBuySupportRequirements, import("../types/tools.generated.mjs").ProductMediaBuySupportRequirements>>>;
-    property_list: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").PropertyListReference, import("../types/tools.generated.mjs").PropertyListReference, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").PropertyListReference, import("../types/tools.generated.mjs").PropertyListReference>>>;
-    fields: z.ZodOptional<z.ZodType<("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], ("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], z.core.$ZodTypeInternals<("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], ("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[]>>>;
-    time_budget: z.ZodOptional<z.ZodType<import("../index.mjs").Duration, import("../index.mjs").Duration, z.core.$ZodTypeInternals<import("../index.mjs").Duration, import("../index.mjs").Duration>>>;
-    push_notification_config: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").PushNotificationConfig, import("../types/tools.generated.mjs").PushNotificationConfig, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").PushNotificationConfig, import("../types/tools.generated.mjs").PushNotificationConfig>>>;
-    pagination: z.ZodOptional<z.ZodType<import("../index.mjs").PaginationRequest, import("../index.mjs").PaginationRequest, z.core.$ZodTypeInternals<import("../index.mjs").PaginationRequest, import("../index.mjs").PaginationRequest>>>;
-    if_wholesale_feed_version: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-    if_pricing_version: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-    context: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").ContextObject, import("../types/tools.generated.mjs").ContextObject, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").ContextObject, import("../types/tools.generated.mjs").ContextObject>>>;
-    required_policies: z.ZodOptional<z.ZodType<string[], string[], z.core.$ZodTypeInternals<string[], string[]>>>;
-    ext: z.ZodOptional<z.ZodType<import("../types/core.generated.mjs").ExtensionObject, import("../types/core.generated.mjs").ExtensionObject, z.core.$ZodTypeInternals<import("../types/core.generated.mjs").ExtensionObject, import("../types/core.generated.mjs").ExtensionObject>>>;
-}, z.core.$loose> & z.ZodType<import("../index.mjs").LegacyGetProductsRequest & Record<string, unknown>, import("../index.mjs").LegacyGetProductsRequest & Record<string, unknown>, z.core.$ZodTypeInternals<import("../index.mjs").LegacyGetProductsRequest & Record<string, unknown>, import("../index.mjs").LegacyGetProductsRequest & Record<string, unknown>>>;
-/** Primary request schema; legacy `format_ids` selection is rejected. */
-export declare const GetProductsRequestSchema: LooseObjectSchemaFor<CanonicalGetProductsRequest>;
+export { GetProductsRequestSchema, LegacyGetProductsRequestSchema } from '../validation/get-products-request.mjs';
+export type { LooseObjectSchemaFor } from '../validation/get-products-request.mjs';
 export { BiddingPolicySchema } from '../validation/bidding-policy.mjs';
 export { CanonicalBudgetAllocationSchema } from '../validation/budget-allocation.mjs';
 export { TOOL_REQUEST_SCHEMAS } from '../utils/tool-request-schemas.mjs';