@adcp/sdk 5.25.1 → 6.0.0

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

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

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

@@ -0,0 +1,56 @@
+/**
+ * Helpers for reading typed assets out of `creative_manifest.assets`.
+ *
+ * `creative_manifest.assets` is a keyed map (`{ [asset_id]: AssetInstance }`)
+ * where each value is a discriminated union by `asset_type`. Adopters
+ * narrowing per-call write the same null-check + discriminator-check
+ * boilerplate over and over. These helpers replace that boilerplate
+ * without compromising the discriminator-narrowing story.
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+import type { CreativeManifest } from '../../types/tools.generated';
+import type { AssetInstance, AssetInstanceType } from '../../types/asset-instances';
+/**
+ * Type-narrowed asset accessor by asset_id and expected asset_type.
+ *
+ * Returns the asset narrowed to the matching variant, or `undefined` if the
+ * asset is missing or the asset_type doesn't match. Use when you want a
+ * silent skip for the wrong-type case (e.g., processing a heterogeneous
+ * batch where some entries don't apply to your transform).
+ *
+ * ```ts
+ * const audio = getAsset(req.creative_manifest, 'rendered_audio', 'audio');
+ * // audio is `AudioAsset | undefined` — narrowed by the discriminator
+ * if (audio) {
+ *   const url = audio.url;             // typed access
+ *   const ms = audio.duration_ms;
+ * }
+ * ```
+ *
+ * For the require-or-throw flavor, see {@link requireAsset}.
+ */
+export declare function getAsset<T extends AssetInstanceType>(manifest: CreativeManifest | undefined, assetId: string, assetType: T): Extract<AssetInstance, {
+    asset_type: T;
+}> | undefined;
+/**
+ * Same as {@link getAsset} but throws `AdcpError('INVALID_REQUEST')` when
+ * the asset is missing or the wrong type. Use when the asset is required
+ * for the platform method to proceed (the typical creative-template case).
+ *
+ * Throws with a precomposed `field` path so the buyer sees actionable
+ * feedback. Customize the message via the `messageOverride` arg if the
+ * default doesn't fit.
+ *
+ * ```ts
+ * const script = requireAsset(req.creative_manifest, 'script', 'text');
+ * // script is `TextAsset` — never undefined past this line
+ * await audioStackClient.synthesize({ text: script.content });
+ * ```
+ */
+export declare function requireAsset<T extends AssetInstanceType>(manifest: CreativeManifest | undefined, assetId: string, assetType: T, messageOverride?: string): Extract<AssetInstance, {
+    asset_type: T;
+}>;
+//# sourceMappingURL=manifest-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-helpers.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/manifest-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGpF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,iBAAiB,EAClD,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,CAAC,GACX,OAAO,CAAC,aAAa,EAAE;IAAE,UAAU,EAAE,CAAC,CAAA;CAAE,CAAC,GAAG,SAAS,CAIvD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,iBAAiB,EACtD,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,CAAC,EACZ,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,aAAa,EAAE;IAAE,UAAU,EAAE,CAAC,CAAA;CAAE,CAAC,CAmB3C"}

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

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Helpers for reading typed assets out of `creative_manifest.assets`.
+ *
+ * `creative_manifest.assets` is a keyed map (`{ [asset_id]: AssetInstance }`)
+ * where each value is a discriminated union by `asset_type`. Adopters
+ * narrowing per-call write the same null-check + discriminator-check
+ * boilerplate over and over. These helpers replace that boilerplate
+ * without compromising the discriminator-narrowing story.
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAsset = getAsset;
+exports.requireAsset = requireAsset;
+const async_outcome_1 = require("./async-outcome");
+/**
+ * Type-narrowed asset accessor by asset_id and expected asset_type.
+ *
+ * Returns the asset narrowed to the matching variant, or `undefined` if the
+ * asset is missing or the asset_type doesn't match. Use when you want a
+ * silent skip for the wrong-type case (e.g., processing a heterogeneous
+ * batch where some entries don't apply to your transform).
+ *
+ * ```ts
+ * const audio = getAsset(req.creative_manifest, 'rendered_audio', 'audio');
+ * // audio is `AudioAsset | undefined` — narrowed by the discriminator
+ * if (audio) {
+ *   const url = audio.url;             // typed access
+ *   const ms = audio.duration_ms;
+ * }
+ * ```
+ *
+ * For the require-or-throw flavor, see {@link requireAsset}.
+ */
+function getAsset(manifest, assetId, assetType) {
+    const asset = manifest?.assets?.[assetId];
+    if (!asset || asset.asset_type !== assetType)
+        return undefined;
+    return asset;
+}
+/**
+ * Same as {@link getAsset} but throws `AdcpError('INVALID_REQUEST')` when
+ * the asset is missing or the wrong type. Use when the asset is required
+ * for the platform method to proceed (the typical creative-template case).
+ *
+ * Throws with a precomposed `field` path so the buyer sees actionable
+ * feedback. Customize the message via the `messageOverride` arg if the
+ * default doesn't fit.
+ *
+ * ```ts
+ * const script = requireAsset(req.creative_manifest, 'script', 'text');
+ * // script is `TextAsset` — never undefined past this line
+ * await audioStackClient.synthesize({ text: script.content });
+ * ```
+ */
+function requireAsset(manifest, assetId, assetType, messageOverride) {
+    const asset = manifest?.assets?.[assetId];
+    if (!asset) {
+        throw new async_outcome_1.AdcpError('INVALID_REQUEST', {
+            recovery: 'correctable',
+            message: messageOverride ?? `creative_manifest.assets.${assetId} is required`,
+            field: `creative_manifest.assets.${assetId}`,
+        });
+    }
+    if (asset.asset_type !== assetType) {
+        throw new async_outcome_1.AdcpError('INVALID_REQUEST', {
+            recovery: 'correctable',
+            message: messageOverride ??
+                `creative_manifest.assets.${assetId} must be a ${assetType} asset (got asset_type='${asset.asset_type}')`,
+            field: `creative_manifest.assets.${assetId}.asset_type`,
+        });
+    }
+    return asset;
+}
+//# sourceMappingURL=manifest-helpers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-helpers.js","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/manifest-helpers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAyBH,4BAQC;AAiBD,oCAwBC;AAtED,mDAA4C;AAE5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,QAAQ,CACtB,QAAsC,EACtC,OAAe,EACf,SAAY;IAEZ,MAAM,KAAK,GAAG,QAAQ,EAAE,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC/D,OAAO,KAAkD,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,YAAY,CAC1B,QAAsC,EACtC,OAAe,EACf,SAAY,EACZ,eAAwB;IAExB,MAAM,KAAK,GAAG,QAAQ,EAAE,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,yBAAS,CAAC,iBAAiB,EAAE;YACrC,QAAQ,EAAE,aAAa;YACvB,OAAO,EAAE,eAAe,IAAI,4BAA4B,OAAO,cAAc;YAC7E,KAAK,EAAE,4BAA4B,OAAO,EAAE;SAC7C,CAAC,CAAC;IACL,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,yBAAS,CAAC,iBAAiB,EAAE;YACrC,QAAQ,EAAE,aAAa;YACvB,OAAO,EACL,eAAe;gBACf,4BAA4B,OAAO,cAAc,SAAS,2BAA2B,KAAK,CAAC,UAAU,IAAI;YAC3G,KAAK,EAAE,4BAA4B,OAAO,aAAa;SACxD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAkD,CAAC;AAC5D,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * Cursor-based pagination primitive for all list-returning methods.
+ * Cursor is opaque to the framework (platform-defined; usually a
+ * base64-encoded internal offset).
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+export interface CursorPage<T> {
+    items: T[];
+    /** Opaque continuation token; absent on the last page. */
+    nextCursor?: string;
+}
+export interface CursorRequest {
+    /** Maximum items to return; framework caps to a sane upper bound. */
+    limit?: number;
+    /** Continuation token from a previous response's `nextCursor`. */
+    cursor?: string;
+}
+//# sourceMappingURL=pagination.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

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

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Cursor-based pagination primitive for all list-returning methods.
+ * Cursor is opaque to the framework (platform-defined; usually a
+ * base64-encoded internal offset).
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=pagination.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/pagination.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

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

@@ -0,0 +1,188 @@
+/**
+ * DecisioningPlatform — the top-level interface adopters implement.
+ *
+ * Per-specialism sub-interfaces (sales, creative, audiences, etc.) are
+ * optional; framework's compile-time enforcement (RequiredPlatformsFor<S>)
+ * forces the right sub-interfaces based on `capabilities.specialisms[]`.
+ *
+ * Status: Preview / 6.0. Not yet wired into the framework.
+ *
+ * @public
+ */
+import type { DecisioningCapabilities, BrandCapabilities } from './capabilities';
+import type { Account, AccountStore } from './account';
+import type { StatusMappers } from './status-mappers';
+import type { SalesPlatform } from './specialisms/sales';
+import type { CreativeBuilderPlatform } from './specialisms/creative';
+import type { CreativeAdServerPlatform } from './specialisms/creative-ad-server';
+import type { AudiencePlatform } from './specialisms/audiences';
+import type { SignalsPlatform } from './specialisms/signals';
+import type { CampaignGovernancePlatform } from './specialisms/campaign-governance';
+import type { ContentStandardsPlatform } from './specialisms/content-standards';
+import type { BrandRightsPlatform } from './specialisms/brand-rights';
+import type { PropertyListsPlatform, CollectionListsPlatform } from './specialisms/lists';
+import type { AdCPSpecialism } from '../../types/tools.generated';
+/**
+ * Top-level platform interface. Adopters implement this; framework wires
+ * the wire protocol around it.
+ *
+ * The "framework owns X" claims below are the v6.0 wiring contract — the
+ * runtime guarantees the framework will provide once this surface is wired.
+ * They are NOT yet enforced; this module is preview-only as of the scaffold
+ * landing. Treat them as the design contract a v6.0 reviewer should hold
+ * the framework refactor to, not as a description of existing behavior.
+ *
+ * **What the framework owns** (platform implementations DON'T see these):
+ * - Wire-shape mapping (MCP tools/list, A2A skill manifest, request/response envelopes)
+ * - Authentication + auth-principal extraction; `accounts.resolve()` is the only
+ *   place the platform translates auth into its tenant model
+ * - Idempotency: dedupe + replay handled before dispatch; platforms see clean traffic
+ * - `sandbox` boundary: when `AccountReference.sandbox === true`, framework
+ *   resolves the buyer's sandbox account via `accounts.resolve()`. The platform
+ *   sees the resolved sandbox `Account` like any other and is responsible for
+ *   routing reads/writes to its sandbox backend. There is no separate
+ *   "dry-run" mode — sandbox subsumes "validate against real platform without
+ *   writing to production." Tool-specific `dry_run` flags on `sync_catalogs`
+ *   and `sync_creatives` are wire fields the platform receives and honors;
+ *   they are NOT a framework-level mode.
+ * - `context` echo: framework round-trips `context` on every response
+ * - Task envelopes: `submitted` outcomes are wrapped into A2A Task envelopes /
+ *   MCP polling responses; `taskHandle.notify` calls dedupe + retry
+ * - Schema validation: requests fail before reaching the platform; responses are
+ *   shape-validated against the wire schema after the platform returns
+ *
+ * **What the platform owns**: the business decisions in each `SalesPlatform` /
+ * `CreativeBuilderPlatform` / `AudiencePlatform` method. Nothing else.
+ *
+ * @template TConfig Platform-specific config typed at the call site.
+ *                   Example: `class GAM implements DecisioningPlatform<{ networkId: string }>`.
+ * @template TCtxMeta Shape of the platform's opaque ctx_metadata blob — typed
+ *                    once and propagated into `ctx.account.ctx_metadata`,
+ *                    `ctx.ctxMetadata.get()`, and every specialism handler.
+ */
+export interface DecisioningPlatform<TConfig = unknown, TCtxMeta = Record<string, unknown>> {
+    /** Capability declaration; single source of truth for get_adcp_capabilities. */
+    capabilities: DecisioningCapabilities<TConfig>;
+    /** Account model + tenant resolution. */
+    accounts: AccountStore<TCtxMeta>;
+    /**
+     * Native-status mappers (account, mediaBuy, creative, plan).
+     *
+     * **Optional.** Default behavior treats the platform's status strings as
+     * already-canonical AdCP status values (no translation). Provide mappers
+     * only when your platform exposes non-AdCP status strings (e.g., GAM's
+     * `DELIVERY_PAUSED` → AdCP's `paused`).
+     */
+    statusMappers?: StatusMappers;
+    /**
+     * Per-tenant capability override. Multi-tenant SaaS adopters (Prebid-style
+     * deployments where one server hosts many advertisers, each with different
+     * `manualApprovalOperations` / pricing tiers / channel mixes) implement this
+     * to scope capabilities per resolved Account. When absent, the framework
+     * uses `capabilities` for every request.
+     *
+     * The framework calls this AFTER `accounts.resolve()` and uses the returned
+     * capabilities to gate the rest of the request. The static `agent-card.json`
+     * AND `tools/list` shape is derived from `capabilities` (the union) — per-tenant
+     * differences are runtime-only.
+     */
+    getCapabilitiesFor?(account: Account<TCtxMeta>): DecisioningCapabilities<TConfig> | Promise<DecisioningCapabilities<TConfig>>;
+    sales?: SalesPlatform<TCtxMeta>;
+    creative?: CreativeBuilderPlatform<TCtxMeta> | CreativeAdServerPlatform<TCtxMeta>;
+    audiences?: AudiencePlatform<TCtxMeta>;
+    signals?: SignalsPlatform<TCtxMeta>;
+    campaignGovernance?: CampaignGovernancePlatform<TCtxMeta>;
+    contentStandards?: ContentStandardsPlatform<TCtxMeta>;
+    propertyLists?: PropertyListsPlatform<TCtxMeta>;
+    collectionLists?: CollectionListsPlatform<TCtxMeta>;
+    brandRights?: BrandRightsPlatform<TCtxMeta>;
+}
+/**
+ * Maps an AdCP specialism to the platform interface(s) it requires. The
+ * framework's `createAdcpServer<P extends DecisioningPlatform>` constrains
+ * `P` to satisfy `RequiredPlatformsFor<P['capabilities']['specialisms'][number]>`,
+ * forcing every claimed specialism's interface methods to exist.
+ *
+ * Drop a method, fail compile.
+ * Claim a specialism without an implementation, fail compile.
+ *
+ * The nested-conditional encoding (rather than a union of `S extends X ? {} : never`)
+ * is deliberate: when a specialism is claimed without its required platform
+ * interface, TypeScript surfaces "Property 'sales' is missing in type 'P'"
+ * rather than the unactionable "Type 'P' does not satisfy the constraint 'never'."
+ *
+ * v1.0 covers the 4 specialisms shipping in v1.0; extended in v1.1+.
+ * Unknown specialisms (v1.1+ when this module hasn't been updated yet)
+ * resolve to an empty requirement — the framework's runtime check is the
+ * fallback gate.
+ */
+type SalesSpecialism = 'sales-non-guaranteed' | 'sales-guaranteed' | 'sales-broadcast-tv' | 'sales-social' | 'sales-catalog-driven' | 'sales-proposal-mode';
+type SignalSpecialism = 'signal-marketplace' | 'signal-owned';
+type CampaignGovernanceSpecialism = 'governance-spend-authority' | 'governance-delivery-monitor';
+export type RequiredPlatformsFor<S extends AdCPSpecialism, TCtxMeta = any> = S extends 'creative-template' | 'creative-generative' ? {
+    creative: CreativeBuilderPlatform<TCtxMeta>;
+} : S extends 'creative-ad-server' ? {
+    creative: CreativeAdServerPlatform<TCtxMeta>;
+} : S extends SalesSpecialism ? {
+    sales: SalesPlatform<TCtxMeta>;
+} : S extends 'audience-sync' ? {
+    audiences: AudiencePlatform<TCtxMeta>;
+} : S extends SignalSpecialism ? {
+    signals: SignalsPlatform<TCtxMeta>;
+} : S extends CampaignGovernanceSpecialism ? {
+    campaignGovernance: CampaignGovernancePlatform<TCtxMeta>;
+} : S extends 'property-lists' ? {
+    propertyLists: PropertyListsPlatform<TCtxMeta>;
+} : S extends 'collection-lists' ? {
+    collectionLists: CollectionListsPlatform<TCtxMeta>;
+} : S extends 'content-standards' ? {
+    contentStandards: ContentStandardsPlatform<TCtxMeta>;
+} : S extends 'brand-rights' ? {
+    brandRights: BrandRightsPlatform<TCtxMeta>;
+} : Record<string, never>;
+/**
+ * The framework's createAdcpServer<P> signature uses this intersection to
+ * enforce capability claims at compile time. Sketch:
+ *
+ * ```ts
+ * declare function createAdcpServer<P extends DecisioningPlatform>(config: {
+ *   platform: P & RequiredPlatformsFor<P['capabilities']['specialisms'][number]>;
+ * }): AdcpServer;
+ * ```
+ *
+ * NOTE: The companion file is preview-only; the actual `createAdcpServer`
+ * doesn't yet enforce this. Wiring lands in a follow-up PR with the
+ * framework refactor.
+ */
+/**
+ * Compile-time mapping from a claimed specialism to the capability
+ * blocks the framework requires on `DecisioningCapabilities`. Sister
+ * type to `RequiredPlatformsFor<S>` — that one constrains the per-
+ * specialism platform interfaces; this one constrains capability-block
+ * declarations on `capabilities.*`.
+ *
+ * Mappings populated conservatively in v1.0:
+ *
+ *   - `'brand-rights'` → `{ brand: BrandCapabilities }`. Adopters
+ *     claiming brand-rights MUST declare `capabilities.brand`. The
+ *     framework auto-derives `rights: true` from the
+ *     `BrandRightsPlatform` impl, but adopters still need to declare
+ *     the block (even as `{}`) so `right_types`, `available_uses`,
+ *     etc. land coherently in `get_adcp_capabilities`.
+ *
+ * Other specialisms have no required capability blocks today —
+ * `audience_targeting` is recommended for `audience-sync` adopters but
+ * not enforced (some sync platforms accept anonymous IDs only and
+ * legitimately have no `supported_identifier_types` to declare).
+ *
+ * The `& Record<string, never>` fallthrough means specialisms not
+ * mapped here add no constraint — adopters can claim them without
+ * declaring extra capability blocks.
+ */
+export type RequiredCapabilitiesFor<S extends AdCPSpecialism> = S extends 'brand-rights' ? {
+    capabilities: {
+        brand: BrandCapabilities;
+    };
+} : {};
+export {};
+//# sourceMappingURL=platform.d.ts.map

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

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

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

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * DecisioningPlatform — the top-level interface adopters implement.
+ *
+ * Per-specialism sub-interfaces (sales, creative, audiences, etc.) are
+ * optional; framework's compile-time enforcement (RequiredPlatformsFor<S>)
+ * forces the right sub-interfaces based on `capabilities.specialisms[]`.
+ *
+ * Status: Preview / 6.0. Not yet wired into the framework.
+ *
+ * @public
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+// `{}` (not `Record<string, never>`) is the right "no extra requirements"
+// fallthrough: it intersects to identity (`P & {} = P`) for specialisms
+// without capability constraints. `Record<string, never>` would force the
+// platform to have NO extra properties, which would reject every real
+// platform impl.
+//# sourceMappingURL=platform.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/platform.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAmOH,0EAA0E;AAC1E,wEAAwE;AACxE,0EAA0E;AAC1E,sEAAsE;AACtE,iBAAiB"}