@adcp/sdk 5.25.0 → 6.0.0

package/dist/lib/server/decisioning/errors-typed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-typed.js","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/errors-typed.ts"],"names":[],"mappings":"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"}

package/dist/lib/server/decisioning/helpers.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Adopter utility helpers for DecisioningPlatform implementations.
+ *
+ * All exports are opt-in convenience — nothing in the framework calls
+ * these internally. They lift boilerplate that every adopter with the
+ * corresponding pattern would otherwise rewrite from scratch.
+ *
+ * @public
+ */
+import { AdcpError, type ErrorCode } from './async-outcome';
+/**
+ * Project a per-id Result-returning lookup into the `pollAudienceStatuses`
+ * `Map<id, status>` shape.
+ *
+ * Runs all lookups in parallel. Drops entries where `result.isOk()` is
+ * false OR `result.value` is `undefined` — per the SDK contract, not-found
+ * entries are omitted from the map (callers handle missing keys via
+ * `Map.prototype.get`).
+ *
+ * Typical use in `AudiencePlatform.pollAudienceStatuses`:
+ *
+ * ```ts
+ * import { batchPoll } from '@adcp/sdk/server/decisioning';
+ *
+ * async pollAudienceStatuses(audienceIds, ctx) {
+ *   return batchPoll(audienceIds, async (id) =>
+ *     this.myPlatform.getAudienceStatus(id, ctx.account.ctx_metadata.token)
+ *   );
+ * }
+ * ```
+ *
+ * The `lookup` return type is structural — any object with `isOk(): boolean`
+ * and `value?: TValue` matches (`neverthrow`, `fp-ts`, or custom Result types
+ * all work without wrapping).
+ *
+ * @public
+ */
+export declare function batchPoll<TKey extends string, TValue>(ids: readonly TKey[], lookup: (id: TKey) => Promise<{
+    isOk(): boolean;
+    value?: TValue;
+}>): Promise<Map<TKey, TValue>>;
+/**
+ * Construct an `AdcpError` for a buyer-correctable validation failure.
+ * Shorthand for `new AdcpError('VALIDATION_ERROR', { recovery: 'correctable', ... })`.
+ *
+ * ```ts
+ * import { validationError } from '@adcp/sdk/server/decisioning';
+ *
+ * if (!req.targeting?.geos?.length) {
+ *   throw validationError('At least one geo is required', {
+ *     field: 'targeting.geos',
+ *   });
+ * }
+ * ```
+ *
+ * @param message - Human-readable explanation of the validation failure.
+ * @param opts.field - Wire `field` path (e.g. `'targeting.geos'`).
+ * @param opts.code - Override the error code (default `'VALIDATION_ERROR'`).
+ * @public
+ */
+export declare function validationError(message: string, opts?: {
+    field?: string;
+    code?: ErrorCode | (string & {});
+}): AdcpError;
+/**
+ * Construct an `AdcpError` for an upstream-platform failure (5xx /
+ * rate-limited). `extraDetails` is run through {@link pickSafeDetails}
+ * internally — depth-capped and size-capped — so credentials or stack
+ * traces the caller accidentally included don't cross the wire boundary.
+ *
+ * HTTP 429 maps to `RATE_LIMITED` (with `retry_after: 60`). All other
+ * upstream failures map to `SERVICE_UNAVAILABLE`. Both use
+ * `recovery: 'transient'`.
+ *
+ * ```ts
+ * import { upstreamError } from '@adcp/sdk/server/decisioning';
+ *
+ * try {
+ *   return await this.gam.createOrder(req);
+ * } catch (e) {
+ *   throw upstreamError('GAM order creation failed', e, {
+ *     gam_error_code: e.errorCode,
+ *     request_id: e.requestId,
+ *   });
+ * }
+ * ```
+ *
+ * @param prefix - Short description of the operation that failed
+ *   (e.g. `'GAM order creation failed'`). Prepended to the upstream message.
+ * @param e - Upstream error. Only `message`, `code`, and `status` are read;
+ *   all other fields are ignored.
+ * @param extraDetails - Optional pre-selected safe fields to surface to the
+ *   buyer. Run through `pickSafeDetails` with depth/size caps before attaching
+ *   to the wire envelope.
+ * @public
+ */
+export declare function upstreamError(prefix: string, e: {
+    message?: string;
+    code?: number | string;
+    status?: number;
+}, extraDetails?: Record<string, unknown>): AdcpError;
+/**
+ * Strip index signatures from a wire request type for back-compat with
+ * v5-era task functions whose parameter types don't carry the spec's
+ * `additionalProperties: true` index signature (`[x: string]: unknown`).
+ *
+ * Without this, passing a v6 wire type directly to a v5 task fn produces:
+ *
+ * ```
+ * Type 'CreateMediaBuyRequest' is not assignable to type
+ *   'Parameters<typeof createMediaBuyTask>[1]'
+ * ```
+ *
+ * because generated v6 types include `[x: string]: unknown` for
+ * forward-compat but v5 fn signatures were authored without it.
+ *
+ * ```ts
+ * import type { RequestShape } from '@adcp/sdk/server/decisioning';
+ *
+ * const result = await createMediaBuyTask(
+ *   snapCtx(account),
+ *   req as RequestShape<typeof req>, // drops index sig for v5 adapter compat
+ * );
+ * ```
+ *
+ * @public
+ */
+export type RequestShape<T> = {
+    [K in keyof T]: T[K];
+};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/lib/server/decisioning/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAO5D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,SAAS,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,EACzD,GAAG,EAAE,SAAS,IAAI,EAAE,EACpB,MAAM,EAAE,CAAC,EAAE,EAAE,IAAI,KAAK,OAAO,CAAC;IAAE,IAAI,IAAI,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACjE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAc5B;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;CAAE,GAC1D,SAAS,CAMX;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAChE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,SAAS,CAaX;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC"}

package/dist/lib/server/decisioning/helpers.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * Adopter utility helpers for DecisioningPlatform implementations.
+ *
+ * All exports are opt-in convenience — nothing in the framework calls
+ * these internally. They lift boilerplate that every adopter with the
+ * corresponding pattern would otherwise rewrite from scratch.
+ *
+ * @public
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.batchPoll = batchPoll;
+exports.validationError = validationError;
+exports.upstreamError = upstreamError;
+const async_outcome_1 = require("./async-outcome");
+const pick_safe_details_1 = require("../pick-safe-details");
+// ---------------------------------------------------------------------------
+// batchPoll
+// ---------------------------------------------------------------------------
+/**
+ * Project a per-id Result-returning lookup into the `pollAudienceStatuses`
+ * `Map<id, status>` shape.
+ *
+ * Runs all lookups in parallel. Drops entries where `result.isOk()` is
+ * false OR `result.value` is `undefined` — per the SDK contract, not-found
+ * entries are omitted from the map (callers handle missing keys via
+ * `Map.prototype.get`).
+ *
+ * Typical use in `AudiencePlatform.pollAudienceStatuses`:
+ *
+ * ```ts
+ * import { batchPoll } from '@adcp/sdk/server/decisioning';
+ *
+ * async pollAudienceStatuses(audienceIds, ctx) {
+ *   return batchPoll(audienceIds, async (id) =>
+ *     this.myPlatform.getAudienceStatus(id, ctx.account.ctx_metadata.token)
+ *   );
+ * }
+ * ```
+ *
+ * The `lookup` return type is structural — any object with `isOk(): boolean`
+ * and `value?: TValue` matches (`neverthrow`, `fp-ts`, or custom Result types
+ * all work without wrapping).
+ *
+ * @public
+ */
+async function batchPoll(ids, lookup) {
+    const pairs = await Promise.all(ids.map(async (id) => {
+        const r = await lookup(id);
+        return [id, r];
+    }));
+    const result = new Map();
+    for (const [id, r] of pairs) {
+        if (r.isOk() && r.value !== undefined) {
+            result.set(id, r.value);
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Error factory helpers
+// ---------------------------------------------------------------------------
+/**
+ * Construct an `AdcpError` for a buyer-correctable validation failure.
+ * Shorthand for `new AdcpError('VALIDATION_ERROR', { recovery: 'correctable', ... })`.
+ *
+ * ```ts
+ * import { validationError } from '@adcp/sdk/server/decisioning';
+ *
+ * if (!req.targeting?.geos?.length) {
+ *   throw validationError('At least one geo is required', {
+ *     field: 'targeting.geos',
+ *   });
+ * }
+ * ```
+ *
+ * @param message - Human-readable explanation of the validation failure.
+ * @param opts.field - Wire `field` path (e.g. `'targeting.geos'`).
+ * @param opts.code - Override the error code (default `'VALIDATION_ERROR'`).
+ * @public
+ */
+function validationError(message, opts) {
+    return new async_outcome_1.AdcpError((opts?.code ?? 'VALIDATION_ERROR'), {
+        recovery: 'correctable',
+        message,
+        ...(opts?.field !== undefined && { field: opts.field }),
+    });
+}
+/**
+ * Construct an `AdcpError` for an upstream-platform failure (5xx /
+ * rate-limited). `extraDetails` is run through {@link pickSafeDetails}
+ * internally — depth-capped and size-capped — so credentials or stack
+ * traces the caller accidentally included don't cross the wire boundary.
+ *
+ * HTTP 429 maps to `RATE_LIMITED` (with `retry_after: 60`). All other
+ * upstream failures map to `SERVICE_UNAVAILABLE`. Both use
+ * `recovery: 'transient'`.
+ *
+ * ```ts
+ * import { upstreamError } from '@adcp/sdk/server/decisioning';
+ *
+ * try {
+ *   return await this.gam.createOrder(req);
+ * } catch (e) {
+ *   throw upstreamError('GAM order creation failed', e, {
+ *     gam_error_code: e.errorCode,
+ *     request_id: e.requestId,
+ *   });
+ * }
+ * ```
+ *
+ * @param prefix - Short description of the operation that failed
+ *   (e.g. `'GAM order creation failed'`). Prepended to the upstream message.
+ * @param e - Upstream error. Only `message`, `code`, and `status` are read;
+ *   all other fields are ignored.
+ * @param extraDetails - Optional pre-selected safe fields to surface to the
+ *   buyer. Run through `pickSafeDetails` with depth/size caps before attaching
+ *   to the wire envelope.
+ * @public
+ */
+function upstreamError(prefix, e, extraDetails) {
+    const statusCode = e.status ?? (typeof e.code === 'number' ? e.code : undefined);
+    const isRateLimited = statusCode === 429;
+    const errorCode = isRateLimited ? 'RATE_LIMITED' : 'SERVICE_UNAVAILABLE';
+    const upstreamMsg = typeof e.message === 'string' && e.message.length > 0 ? e.message : 'upstream error';
+    const details = extraDetails !== undefined ? (0, pick_safe_details_1.pickSafeDetails)(extraDetails, Object.keys(extraDetails)) : undefined;
+    return new async_outcome_1.AdcpError(errorCode, {
+        recovery: 'transient',
+        message: `${prefix}: ${upstreamMsg}`,
+        ...(isRateLimited && { retry_after: 60 }),
+        ...(details !== undefined && { details }),
+    });
+}
+//# sourceMappingURL=helpers.js.map

package/dist/lib/server/decisioning/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/helpers.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAoCH,8BAiBC;AAyBD,0CASC;AAkCD,sCAiBC;AAxID,mDAA4D;AAC5D,4DAAuD;AAEvD,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACI,KAAK,UAAU,SAAS,CAC7B,GAAoB,EACpB,MAAkE;IAElE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,GAAG,CAAC,GAAG,CAAC,KAAK,EAAC,EAAE,EAAC,EAAE;QACjB,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3B,OAAO,CAAC,EAAE,EAAE,CAAC,CAAU,CAAC;IAC1B,CAAC,CAAC,CACH,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgB,CAAC;IACvC,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,eAAe,CAC7B,OAAe,EACf,IAA2D;IAE3D,OAAO,IAAI,yBAAS,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,kBAAkB,CAAc,EAAE;QACpE,QAAQ,EAAE,aAAa;QACvB,OAAO;QACP,GAAG,CAAC,IAAI,EAAE,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;KACxD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,SAAgB,aAAa,CAC3B,MAAc,EACd,CAAgE,EAChE,YAAsC;IAEtC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACjF,MAAM,aAAa,GAAG,UAAU,KAAK,GAAG,CAAC;IACzC,MAAM,SAAS,GAAc,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,qBAAqB,CAAC;IACpF,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACzG,MAAM,OAAO,GAAG,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,IAAA,mCAAe,EAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAElH,OAAO,IAAI,yBAAS,CAAC,SAAS,EAAE;QAC9B,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,GAAG,MAAM,KAAK,WAAW,EAAE;QACpC,GAAG,CAAC,aAAa,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;QACzC,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/server/decisioning/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * DecisioningPlatform v1.0 — preview surface for the v6.0 architecture.
+ *
+ * Status: PREVIEW. Types only; not yet wired into the framework. Subject
+ * to change before 6.0 ships. Don't build production adapters against this
+ * yet — the framework still routes through the v5.x handler-style API.
+ *
+ * Design proposal: `.context/proposals/specialism-platform-interfaces-v3.md`
+ *
+ * @packageDocumentation
+ */
+export { type AdcpStructuredError, type ErrorCode, AdcpError } from './async-outcome';
+export { PackageNotFoundError, MediaBuyNotFoundError, ProductNotFoundError, CreativeNotFoundError, ProductUnavailableError, CreativeRejectedError, BudgetTooLowError, BudgetExhaustedError, IdempotencyConflictError, InvalidRequestError, InvalidStateError, BackwardsTimeRangeError, AuthRequiredError, PermissionDeniedError, RateLimitedError, ServiceUnavailableError, UnsupportedFeatureError, ComplianceUnsatisfiedError, GovernanceDeniedError, PolicyViolationError, } from './errors-typed';
+export type { CursorPage, CursorRequest } from './pagination';
+export { publishStatusChange, setStatusChangeBus, getStatusChangeBus, createInMemoryStatusChangeBus, type StatusChange, type StatusChangeBus, type StatusChangeResourceType, type StatusChangeListener, type PublishStatusChangeOpts, } from './status-changes';
+export type { DecisioningCapabilities, CreativeAgentRef, TargetingCapabilities, ReportingCapabilities, } from './capabilities';
+export type { Account, AuthPrincipal, AccountStore, AccountFilter, SyncAccountsResultRow, AdcpAccountStatus, ResolveContext, ResolvedAuthInfo, } from './account';
+export { AccountNotFoundError, refAccountId } from './account';
+export type { StatusMappers, AdcpMediaBuyStatus, AdcpCreativeStatus, AdcpPlanStatus } from './status-mappers';
+export { identityStatusMappers } from './status-mappers';
+export type { RequestContext, WorkflowStateReader, ResourceResolver, WorkflowObjectType, WorkflowStep, Proposal, GovernanceContextJWS, } from './context';
+export type { DecisioningPlatform, RequiredPlatformsFor, RequiredCapabilitiesFor } from './platform';
+export type { CreativeBuilderPlatform, BuildCreativeReturn, CreativeTemplatePlatform, CreativeGenerativePlatform, RefinementMessage, SyncCreativesRow, } from './specialisms/creative';
+export type { CreativeAdServerPlatform } from './specialisms/creative-ad-server';
+export type { CampaignGovernancePlatform } from './specialisms/campaign-governance';
+export type { ContentStandardsPlatform } from './specialisms/content-standards';
+export type { PropertyListsPlatform, CollectionListsPlatform } from './specialisms/lists';
+export type { SalesPlatform } from './specialisms/sales';
+export type { AudiencePlatform, Audience, SyncAudiencesRow, AudienceStatus } from './specialisms/audiences';
+export type { SignalsPlatform } from './specialisms/signals';
+export type { BrandRightsPlatform } from './specialisms/brand-rights';
+export type { GetBrandIdentityRequest, GetBrandIdentitySuccess, GetRightsRequest, GetRightsSuccess, AcquireRightsRequest, AcquireRightsAcquired, AcquireRightsPendingApproval, AcquireRightsRejected, AcquireRightsError, RightUse, RightType, RightsConstraint, RightsTerms, RightsPricingOption, GenerationCredential, } from '../../types/core.generated';
+export { createAdcpServerFromPlatform, getAllAdcpMigrations, type CreateAdcpServerFromPlatformOptions, type DecisioningAdcpServer, type DecisioningObservabilityHooks, } from './runtime/from-platform';
+export { PlatformConfigError, validatePlatform } from './runtime/validate-platform';
+export { createInMemoryTaskRegistry, type TaskRegistry, type TaskRecord, type TaskStatus, } from './runtime/task-registry';
+export { createPostgresTaskRegistry, getDecisioningTaskRegistryMigration, type CreatePostgresTaskRegistryOptions, type PgQueryable, } from './runtime/postgres-task-registry';
+export { createTenantRegistry, createDefaultJwksValidator, type TenantRegistry, type TenantConfig, type TenantSigningKey, type TenantStatus, type TenantHealth, type TenantRegistryOptions, type JwksValidator, type JwksValidationResult, } from './tenant-registry';
+export { getAsset, requireAsset } from './manifest-helpers';
+export { buildListCreativesResponse, type BuildListCreativesResponseOpts } from './list-helpers';
+export { resolveStartTime, type ResolveStartTimeOptions } from './start-time';
+export { createTenantAdminRouter, createTenantAdminHandlers, mountTenantAdmin, type TenantAdminHandlers, type RouterLike, } from './admin-router';
+export { batchPoll, validationError, upstreamError } from './helpers';
+export type { RequestShape } from './helpers';
+export { buildProduct, buildPricingOption, buildPackage } from './assembly-helpers';
+export type { BuildProductInput, BuildPricingOptionInput, BuildPackageInput } from './assembly-helpers';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/server/decisioning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/server/decisioning/index.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * DecisioningPlatform v1.0 — preview surface for the v6.0 architecture.
+ *
+ * Status: PREVIEW. Types only; not yet wired into the framework. Subject
+ * to change before 6.0 ships. Don't build production adapters against this
+ * yet — the framework still routes through the v5.x handler-style API.
+ *
+ * Design proposal: `.context/proposals/specialism-platform-interfaces-v3.md`
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPackage = exports.buildPricingOption = exports.buildProduct = exports.upstreamError = exports.validationError = exports.batchPoll = exports.mountTenantAdmin = exports.createTenantAdminHandlers = exports.createTenantAdminRouter = exports.resolveStartTime = exports.buildListCreativesResponse = exports.requireAsset = exports.getAsset = exports.createDefaultJwksValidator = exports.createTenantRegistry = exports.getDecisioningTaskRegistryMigration = exports.createPostgresTaskRegistry = exports.createInMemoryTaskRegistry = exports.validatePlatform = exports.PlatformConfigError = exports.getAllAdcpMigrations = exports.createAdcpServerFromPlatform = exports.identityStatusMappers = exports.refAccountId = exports.AccountNotFoundError = exports.createInMemoryStatusChangeBus = exports.getStatusChangeBus = exports.setStatusChangeBus = exports.publishStatusChange = exports.PolicyViolationError = exports.GovernanceDeniedError = exports.ComplianceUnsatisfiedError = exports.UnsupportedFeatureError = exports.ServiceUnavailableError = exports.RateLimitedError = exports.PermissionDeniedError = exports.AuthRequiredError = exports.BackwardsTimeRangeError = exports.InvalidStateError = exports.InvalidRequestError = exports.IdempotencyConflictError = exports.BudgetExhaustedError = exports.BudgetTooLowError = exports.CreativeRejectedError = exports.ProductUnavailableError = exports.CreativeNotFoundError = exports.ProductNotFoundError = exports.MediaBuyNotFoundError = exports.PackageNotFoundError = exports.AdcpError = void 0;
+// Adopter-facing structured-error primitive.
+//
+// `AdcpError` is the canonical throwable for structured rejection. Specialism
+// methods return plain `T` for success or `throw new AdcpError(...)` to project
+// to the wire `adcp_error` envelope.
+//
+// HITL is expressed in the type system via the dual-method shape on each
+// spec-HITL tool (`xxx` for sync, `xxxTask` for HITL). No adopter-facing
+// task primitives — the framework owns task lifecycle and dispatches the
+// `*Task` method in the background.
+var async_outcome_1 = require("./async-outcome");
+Object.defineProperty(exports, "AdcpError", { enumerable: true, get: function () { return async_outcome_1.AdcpError; } });
+// Typed `AdcpError` subclasses — adopter convenience for the highest-traffic
+// error codes. Each class encodes the canonical code/recovery/field shape.
+// LLM-generated platforms get autocomplete on the import; humans skim the
+// list to find the right class. See `errors-typed.ts`.
+var errors_typed_1 = require("./errors-typed");
+Object.defineProperty(exports, "PackageNotFoundError", { enumerable: true, get: function () { return errors_typed_1.PackageNotFoundError; } });
+Object.defineProperty(exports, "MediaBuyNotFoundError", { enumerable: true, get: function () { return errors_typed_1.MediaBuyNotFoundError; } });
+Object.defineProperty(exports, "ProductNotFoundError", { enumerable: true, get: function () { return errors_typed_1.ProductNotFoundError; } });
+Object.defineProperty(exports, "CreativeNotFoundError", { enumerable: true, get: function () { return errors_typed_1.CreativeNotFoundError; } });
+Object.defineProperty(exports, "ProductUnavailableError", { enumerable: true, get: function () { return errors_typed_1.ProductUnavailableError; } });
+Object.defineProperty(exports, "CreativeRejectedError", { enumerable: true, get: function () { return errors_typed_1.CreativeRejectedError; } });
+Object.defineProperty(exports, "BudgetTooLowError", { enumerable: true, get: function () { return errors_typed_1.BudgetTooLowError; } });
+Object.defineProperty(exports, "BudgetExhaustedError", { enumerable: true, get: function () { return errors_typed_1.BudgetExhaustedError; } });
+Object.defineProperty(exports, "IdempotencyConflictError", { enumerable: true, get: function () { return errors_typed_1.IdempotencyConflictError; } });
+Object.defineProperty(exports, "InvalidRequestError", { enumerable: true, get: function () { return errors_typed_1.InvalidRequestError; } });
+Object.defineProperty(exports, "InvalidStateError", { enumerable: true, get: function () { return errors_typed_1.InvalidStateError; } });
+Object.defineProperty(exports, "BackwardsTimeRangeError", { enumerable: true, get: function () { return errors_typed_1.BackwardsTimeRangeError; } });
+Object.defineProperty(exports, "AuthRequiredError", { enumerable: true, get: function () { return errors_typed_1.AuthRequiredError; } });
+Object.defineProperty(exports, "PermissionDeniedError", { enumerable: true, get: function () { return errors_typed_1.PermissionDeniedError; } });
+Object.defineProperty(exports, "RateLimitedError", { enumerable: true, get: function () { return errors_typed_1.RateLimitedError; } });
+Object.defineProperty(exports, "ServiceUnavailableError", { enumerable: true, get: function () { return errors_typed_1.ServiceUnavailableError; } });
+Object.defineProperty(exports, "UnsupportedFeatureError", { enumerable: true, get: function () { return errors_typed_1.UnsupportedFeatureError; } });
+Object.defineProperty(exports, "ComplianceUnsatisfiedError", { enumerable: true, get: function () { return errors_typed_1.ComplianceUnsatisfiedError; } });
+Object.defineProperty(exports, "GovernanceDeniedError", { enumerable: true, get: function () { return errors_typed_1.GovernanceDeniedError; } });
+Object.defineProperty(exports, "PolicyViolationError", { enumerable: true, get: function () { return errors_typed_1.PolicyViolationError; } });
+// Status-change event bus — adopter-facing primitive for spec-native
+// lifecycle channels (media_buy / creative / audience / signal / proposal /
+// plan / rights_grant / delivery_report). Module-level so adopters can
+// publish from webhook handlers, crons, in-process workers without holding
+// a server reference.
+var status_changes_1 = require("./status-changes");
+Object.defineProperty(exports, "publishStatusChange", { enumerable: true, get: function () { return status_changes_1.publishStatusChange; } });
+Object.defineProperty(exports, "setStatusChangeBus", { enumerable: true, get: function () { return status_changes_1.setStatusChangeBus; } });
+Object.defineProperty(exports, "getStatusChangeBus", { enumerable: true, get: function () { return status_changes_1.getStatusChangeBus; } });
+Object.defineProperty(exports, "createInMemoryStatusChangeBus", { enumerable: true, get: function () { return status_changes_1.createInMemoryStatusChangeBus; } });
+var account_1 = require("./account");
+Object.defineProperty(exports, "AccountNotFoundError", { enumerable: true, get: function () { return account_1.AccountNotFoundError; } });
+Object.defineProperty(exports, "refAccountId", { enumerable: true, get: function () { return account_1.refAccountId; } });
+var status_mappers_1 = require("./status-mappers");
+Object.defineProperty(exports, "identityStatusMappers", { enumerable: true, get: function () { return status_mappers_1.identityStatusMappers; } });
+// Runtime (v6.0 alpha) — preview surface for adopters spiking against the
+// new shape. Subject to change before 6.0 GA.
+var from_platform_1 = require("./runtime/from-platform");
+Object.defineProperty(exports, "createAdcpServerFromPlatform", { enumerable: true, get: function () { return from_platform_1.createAdcpServerFromPlatform; } });
+Object.defineProperty(exports, "getAllAdcpMigrations", { enumerable: true, get: function () { return from_platform_1.getAllAdcpMigrations; } });
+var validate_platform_1 = require("./runtime/validate-platform");
+Object.defineProperty(exports, "PlatformConfigError", { enumerable: true, get: function () { return validate_platform_1.PlatformConfigError; } });
+Object.defineProperty(exports, "validatePlatform", { enumerable: true, get: function () { return validate_platform_1.validatePlatform; } });
+var task_registry_1 = require("./runtime/task-registry");
+Object.defineProperty(exports, "createInMemoryTaskRegistry", { enumerable: true, get: function () { return task_registry_1.createInMemoryTaskRegistry; } });
+var postgres_task_registry_1 = require("./runtime/postgres-task-registry");
+Object.defineProperty(exports, "createPostgresTaskRegistry", { enumerable: true, get: function () { return postgres_task_registry_1.createPostgresTaskRegistry; } });
+Object.defineProperty(exports, "getDecisioningTaskRegistryMigration", { enumerable: true, get: function () { return postgres_task_registry_1.getDecisioningTaskRegistryMigration; } });
+// Multi-tenant deployment helper — wraps createAdcpServerFromPlatform with
+// per-tenant config, health states (healthy/unverified/disabled), and JWKS
+// validation. Composes with the existing serve() host-routing surface.
+var tenant_registry_1 = require("./tenant-registry");
+Object.defineProperty(exports, "createTenantRegistry", { enumerable: true, get: function () { return tenant_registry_1.createTenantRegistry; } });
+Object.defineProperty(exports, "createDefaultJwksValidator", { enumerable: true, get: function () { return tenant_registry_1.createDefaultJwksValidator; } });
+// Manifest helpers — typed accessors for creative_manifest.assets values.
+// Save adopters from writing the same null-check + discriminator-check
+// boilerplate per call.
+var manifest_helpers_1 = require("./manifest-helpers");
+Object.defineProperty(exports, "getAsset", { enumerable: true, get: function () { return manifest_helpers_1.getAsset; } });
+Object.defineProperty(exports, "requireAsset", { enumerable: true, get: function () { return manifest_helpers_1.requireAsset; } });
+// List helpers — wrap row arrays + pagination into the heavier wire shapes
+// (today: list_creatives, which carries query_summary alongside the rows).
+var list_helpers_1 = require("./list-helpers");
+Object.defineProperty(exports, "buildListCreativesResponse", { enumerable: true, get: function () { return list_helpers_1.buildListCreativesResponse; } });
+// Start-time helper — normalize the wire `start_time` union into a Date,
+// with platform-aware ASAP lead-time injection.
+var start_time_1 = require("./start-time");
+Object.defineProperty(exports, "resolveStartTime", { enumerable: true, get: function () { return start_time_1.resolveStartTime; } });
+// Admin Express router for ops visibility into the TenantRegistry.
+// Mount on a separate port/path with operator auth.
+var admin_router_1 = require("./admin-router");
+Object.defineProperty(exports, "createTenantAdminRouter", { enumerable: true, get: function () { return admin_router_1.createTenantAdminRouter; } });
+Object.defineProperty(exports, "createTenantAdminHandlers", { enumerable: true, get: function () { return admin_router_1.createTenantAdminHandlers; } });
+Object.defineProperty(exports, "mountTenantAdmin", { enumerable: true, get: function () { return admin_router_1.mountTenantAdmin; } });
+// Adopter helpers — batchPoll, validationError, upstreamError, RequestShape.
+// All opt-in convenience; nothing in the framework calls these internally.
+var helpers_1 = require("./helpers");
+Object.defineProperty(exports, "batchPoll", { enumerable: true, get: function () { return helpers_1.batchPoll; } });
+Object.defineProperty(exports, "validationError", { enumerable: true, get: function () { return helpers_1.validationError; } });
+Object.defineProperty(exports, "upstreamError", { enumerable: true, get: function () { return helpers_1.upstreamError; } });
+// Wire-shape assembly helpers — emit correct Product / PricingOption /
+// package shapes from intent-shaped input. Reduces 30+ lines of wire
+// boilerplate per resource. Used in slim skill examples so LLMs scaffold
+// correct shapes from first attempt.
+var assembly_helpers_1 = require("./assembly-helpers");
+Object.defineProperty(exports, "buildProduct", { enumerable: true, get: function () { return assembly_helpers_1.buildProduct; } });
+Object.defineProperty(exports, "buildPricingOption", { enumerable: true, get: function () { return assembly_helpers_1.buildPricingOption; } });
+Object.defineProperty(exports, "buildPackage", { enumerable: true, get: function () { return assembly_helpers_1.buildPackage; } });
+//# sourceMappingURL=index.js.map

package/dist/lib/server/decisioning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,6CAA6C;AAC7C,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,qCAAqC;AACrC,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,yEAAyE;AACzE,oCAAoC;AACpC,iDAAsF;AAAnC,0GAAA,SAAS,OAAA;AAE5D,6EAA6E;AAC7E,2EAA2E;AAC3E,0EAA0E;AAC1E,uDAAuD;AACvD,+CAqBwB;AApBtB,oHAAA,oBAAoB,OAAA;AACpB,qHAAA,qBAAqB,OAAA;AACrB,oHAAA,oBAAoB,OAAA;AACpB,qHAAA,qBAAqB,OAAA;AACrB,uHAAA,uBAAuB,OAAA;AACvB,qHAAA,qBAAqB,OAAA;AACrB,iHAAA,iBAAiB,OAAA;AACjB,oHAAA,oBAAoB,OAAA;AACpB,wHAAA,wBAAwB,OAAA;AACxB,mHAAA,mBAAmB,OAAA;AACnB,iHAAA,iBAAiB,OAAA;AACjB,uHAAA,uBAAuB,OAAA;AACvB,iHAAA,iBAAiB,OAAA;AACjB,qHAAA,qBAAqB,OAAA;AACrB,gHAAA,gBAAgB,OAAA;AAChB,uHAAA,uBAAuB,OAAA;AACvB,uHAAA,uBAAuB,OAAA;AACvB,0HAAA,0BAA0B,OAAA;AAC1B,qHAAA,qBAAqB,OAAA;AACrB,oHAAA,oBAAoB,OAAA;AAMtB,qEAAqE;AACrE,4EAA4E;AAC5E,uEAAuE;AACvE,2EAA2E;AAC3E,sBAAsB;AACtB,mDAU0B;AATxB,qHAAA,mBAAmB,OAAA;AACnB,oHAAA,kBAAkB,OAAA;AAClB,oHAAA,kBAAkB,OAAA;AAClB,+HAAA,6BAA6B,OAAA;AA4B/B,qCAA+D;AAAtD,+GAAA,oBAAoB,OAAA;AAAE,uGAAA,YAAY,OAAA;AAI3C,mDAAyD;AAAhD,uHAAA,qBAAqB,OAAA;AAmE9B,0EAA0E;AAC1E,8CAA8C;AAC9C,yDAMiC;AAL/B,6HAAA,4BAA4B,OAAA;AAC5B,qHAAA,oBAAoB,OAAA;AAKtB,iEAAoF;AAA3E,wHAAA,mBAAmB,OAAA;AAAE,qHAAA,gBAAgB,OAAA;AAC9C,yDAKiC;AAJ/B,2HAAA,0BAA0B,OAAA;AAK5B,2EAK0C;AAJxC,oIAAA,0BAA0B,OAAA;AAC1B,6IAAA,mCAAmC,OAAA;AAKrC,2EAA2E;AAC3E,2EAA2E;AAC3E,uEAAuE;AACvE,qDAW2B;AAVzB,uHAAA,oBAAoB,OAAA;AACpB,6HAAA,0BAA0B,OAAA;AAW5B,0EAA0E;AAC1E,uEAAuE;AACvE,wBAAwB;AACxB,uDAA4D;AAAnD,4GAAA,QAAQ,OAAA;AAAE,gHAAA,YAAY,OAAA;AAE/B,2EAA2E;AAC3E,2EAA2E;AAC3E,+CAAiG;AAAxF,0HAAA,0BAA0B,OAAA;AAEnC,yEAAyE;AACzE,gDAAgD;AAChD,2CAA8E;AAArE,8GAAA,gBAAgB,OAAA;AAEzB,mEAAmE;AACnE,oDAAoD;AACpD,+CAMwB;AALtB,uHAAA,uBAAuB,OAAA;AACvB,yHAAA,yBAAyB,OAAA;AACzB,gHAAA,gBAAgB,OAAA;AAKlB,6EAA6E;AAC7E,2EAA2E;AAC3E,qCAAsE;AAA7D,oGAAA,SAAS,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,wGAAA,aAAa,OAAA;AAGlD,uEAAuE;AACvE,qEAAqE;AACrE,yEAAyE;AACzE,qCAAqC;AACrC,uDAAoF;AAA3E,gHAAA,YAAY,OAAA;AAAE,sHAAA,kBAAkB,OAAA;AAAE,gHAAA,YAAY,OAAA"}

package/dist/lib/server/decisioning/list-helpers.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Helpers for building paginated list responses.
+ *
+ * `list_creatives` is the heaviest of the read tools: its response wraps the
+ * row array in `query_summary` (`total_matching`, `returned`, `filters_applied`,
+ * `sort_applied`) AND `pagination` (`has_more`, `cursor`, `total_count`).
+ * Adopters writing the wrapper by hand re-derive the same fields per call;
+ * this helper threads a row array + pagination cursor + the original request
+ * into the wire shape.
+ *
+ * `list_property_lists`, `list_collection_lists`, and other governance reads
+ * use a simpler `{ lists: [...] }` wrapper that the framework's response
+ * builders already cover — those don't need a row helper.
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+import type { ListCreativesRequest, ListCreativesResponse, PaginationResponse } from '../../types/tools.generated';
+export interface BuildListCreativesResponseOpts {
+    /** Original request — used to surface `filters_applied` + `sort_applied` summaries. */
+    request: ListCreativesRequest;
+    /** The page of creative rows. Length determines `query_summary.returned`. */
+    creatives: ListCreativesResponse['creatives'];
+    /** Pagination cursor for the next page. Required — pass `{ has_more: false }` when this is the last page. */
+    pagination: PaginationResponse;
+    /**
+     * Total count across all pages. When omitted, defaults to
+     * `pagination.total_count` if present, else `creatives.length` (last-page
+     * approximation). Set explicitly when your backend can compute the true
+     * total.
+     */
+    totalMatching?: number;
+}
+/**
+ * Build a `ListCreativesResponse` from a row array + pagination + the
+ * original request. Computes `query_summary.filters_applied` from
+ * `request.filters` and threads `request.sort` into `sort_applied`.
+ *
+ * ```ts
+ * listCreatives: async (req, ctx) => {
+ *   const rows = await this.db.queryCreatives(req);
+ *   const cursor = rows.length === req.pagination?.limit ? this.nextCursor(rows) : undefined;
+ *   return buildListCreativesResponse({
+ *     request: req,
+ *     creatives: rows,
+ *     pagination: { has_more: cursor != null, cursor, total_count: rows.totalCount },
+ *   });
+ * }
+ * ```
+ */
+export declare function buildListCreativesResponse(opts: BuildListCreativesResponseOpts): ListCreativesResponse;
+//# sourceMappingURL=list-helpers.d.ts.map

package/dist/lib/server/decisioning/list-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-helpers.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/list-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEnH,MAAM,WAAW,8BAA8B;IAC7C,uFAAuF;IACvF,OAAO,EAAE,oBAAoB,CAAC;IAC9B,6EAA6E;IAC7E,SAAS,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAC9C,6GAA6G;IAC7G,UAAU,EAAE,kBAAkB,CAAC;IAC/B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,8BAA8B,GAAG,qBAAqB,CA0CtG"}

package/dist/lib/server/decisioning/list-helpers.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Helpers for building paginated list responses.
+ *
+ * `list_creatives` is the heaviest of the read tools: its response wraps the
+ * row array in `query_summary` (`total_matching`, `returned`, `filters_applied`,
+ * `sort_applied`) AND `pagination` (`has_more`, `cursor`, `total_count`).
+ * Adopters writing the wrapper by hand re-derive the same fields per call;
+ * this helper threads a row array + pagination cursor + the original request
+ * into the wire shape.
+ *
+ * `list_property_lists`, `list_collection_lists`, and other governance reads
+ * use a simpler `{ lists: [...] }` wrapper that the framework's response
+ * builders already cover — those don't need a row helper.
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildListCreativesResponse = buildListCreativesResponse;
+/**
+ * Build a `ListCreativesResponse` from a row array + pagination + the
+ * original request. Computes `query_summary.filters_applied` from
+ * `request.filters` and threads `request.sort` into `sort_applied`.
+ *
+ * ```ts
+ * listCreatives: async (req, ctx) => {
+ *   const rows = await this.db.queryCreatives(req);
+ *   const cursor = rows.length === req.pagination?.limit ? this.nextCursor(rows) : undefined;
+ *   return buildListCreativesResponse({
+ *     request: req,
+ *     creatives: rows,
+ *     pagination: { has_more: cursor != null, cursor, total_count: rows.totalCount },
+ *   });
+ * }
+ * ```
+ */
+function buildListCreativesResponse(opts) {
+    const { request, creatives, pagination, totalMatching } = opts;
+    const filters = request.filters;
+    const filtersApplied = [];
+    if (filters) {
+        if (filters.accounts?.length)
+            filtersApplied.push('accounts');
+        if (filters.statuses?.length)
+            filtersApplied.push('statuses');
+        if (filters.tags?.length)
+            filtersApplied.push('tags');
+        if (filters.tags_any?.length)
+            filtersApplied.push('tags_any');
+        if (filters.name_contains)
+            filtersApplied.push('name_contains');
+        if (filters.creative_ids?.length)
+            filtersApplied.push('creative_ids');
+        if (filters.created_after)
+            filtersApplied.push('created_after');
+        if (filters.created_before)
+            filtersApplied.push('created_before');
+        if (filters.updated_after)
+            filtersApplied.push('updated_after');
+        if (filters.updated_before)
+            filtersApplied.push('updated_before');
+        if (filters.assigned_to_packages?.length)
+            filtersApplied.push('assigned_to_packages');
+        if (filters.media_buy_ids?.length)
+            filtersApplied.push('media_buy_ids');
+        if (filters.unassigned !== undefined)
+            filtersApplied.push('unassigned');
+        if (filters.has_served !== undefined)
+            filtersApplied.push('has_served');
+        if (filters.concept_ids?.length)
+            filtersApplied.push('concept_ids');
+        if (filters.format_ids?.length)
+            filtersApplied.push('format_ids');
+        if (filters.has_variables !== undefined)
+            filtersApplied.push('has_variables');
+    }
+    const summary = {
+        total_matching: totalMatching ?? pagination.total_count ?? creatives.length,
+        returned: creatives.length,
+        ...(filtersApplied.length > 0 && { filters_applied: filtersApplied }),
+        ...(request.sort && {
+            sort_applied: {
+                ...(request.sort.field !== undefined && { field: request.sort.field }),
+                ...(request.sort.direction !== undefined && { direction: request.sort.direction }),
+            },
+        }),
+    };
+    return {
+        query_summary: summary,
+        pagination,
+        creatives,
+    };
+}
+//# sourceMappingURL=list-helpers.js.map