@aftership/ads-core 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,30 @@
+import type { Decision, DecisionRequest } from "./types.js";
+/**
+ * Transport is injected by the host. The decisions endpoint is an intranet
+ * API (07-13 §1) — browsers never call it directly; a BTP/BFF proxy, an SSR
+ * data loader, or (for now) a mock supplies the payload. The fetcher may
+ * return either the bare decision object or the meta/data envelope.
+ */
+export type DecisionFetcher = (request: DecisionRequest, options: {
+    signal: AbortSignal;
+}) => Promise<unknown>;
+export interface AdsClientOptions {
+    fetcher: DecisionFetcher;
+    /**
+     * Overall budget for one decision, ms. Contract end-to-end budget is ~2s
+     * (07-13 §9); hosts sit above it, so default leaves headroom.
+     */
+    timeoutMs?: number;
+    /** Observability hook; errors never propagate to the host (fail-safe). */
+    onError?: (error: unknown) => void;
+}
+export interface AdsClient {
+    /**
+     * Fetch + normalize one decision. Never throws and never rejects:
+     * timeout, transport failure, and malformed payloads all resolve to an
+     * empty decision so ad failures cannot break the host surface.
+     */
+    getDecision(request: DecisionRequest): Promise<Decision>;
+}
+export declare function createAdsClient(options: AdsClientOptions): AdsClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG5D;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,KAC7B,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,eAAe,CAAC;IACzB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC1D;AAID,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAyBpE"}

package/dist/client.js

@@ -0,0 +1,28 @@
+import { EMPTY_DECISION, sanitizeDecision } from "./sanitize.js";
+const DEFAULT_TIMEOUT_MS = 2500;
+export function createAdsClient(options) {
+    const { fetcher, timeoutMs = DEFAULT_TIMEOUT_MS, onError } = options;
+    return {
+        async getDecision(request) {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(new Error(`ads decision timed out after ${timeoutMs}ms`)), timeoutMs);
+            try {
+                const raw = await fetcher(request, { signal: controller.signal });
+                return sanitizeDecision(raw);
+            }
+            catch (error) {
+                try {
+                    onError?.(error);
+                }
+                catch {
+                    // observability must never break the fail-safe path
+                }
+                return EMPTY_DECISION;
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAiCjE,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,kBAAkB,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAErE,OAAO;QACL,KAAK,CAAC,WAAW,CAAC,OAAwB;YACxC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,gCAAgC,SAAS,IAAI,CAAC,CAAC,EAChF,SAAS,CACV,CAAC;YACF,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;gBAClE,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC;oBACH,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;gBACnB,CAAC;gBAAC,MAAM,CAAC;oBACP,oDAAoD;gBACtD,CAAC;gBACD,OAAO,cAAc,CAAC;YACxB,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { AdsEvent, AdsEventSink, AdsEventType, AdsTheme, Attribution, Decision, DecisionRequest, Offer, Placement, TokenPayload, } from "./types.js";
+export { createAdsClient } from "./client.js";
+export type { AdsClient, AdsClientOptions, DecisionFetcher } from "./client.js";
+export { createMockFetcher, mockDecision } from "./mock.js";
+export type { MockFetcherOptions, MockScenario } from "./mock.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,eAAe,EACf,KAAK,EACL,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createAdsClient } from "./client.js";
+export { createMockFetcher, mockDecision } from "./mock.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/mock.d.ts

@@ -0,0 +1,16 @@
+import type { Decision } from "./types.js";
+import type { DecisionFetcher } from "./client.js";
+export type MockScenario = "default" | "single" | "multi" | "empty" | "minimal" | "no-image" | "long-text" | "cjk" | "emoji";
+/** Build a deterministic mock decision for a scenario. */
+export declare function mockDecision(scenario?: MockScenario): Decision;
+export interface MockFetcherOptions {
+    /**
+     * Force one scenario. Without it the fetcher mirrors expected production
+     * behaviour: email gets a single offer, btp/ocp get the multi-offer list.
+     */
+    scenario?: MockScenario;
+    /** Simulated network latency in ms. */
+    delayMs?: number;
+}
+export declare function createMockFetcher(options?: MockFetcherOptions): DecisionFetcher;
+//# sourceMappingURL=mock.d.ts.map

package/dist/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,QAAQ,EAAS,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAiInD,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,QAAQ,GACR,OAAO,GACP,OAAO,GACP,SAAS,GACT,UAAU,GACV,WAAW,GACX,KAAK,GACL,OAAO,CAAC;AAEZ,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,QAAQ,GAAE,YAAwB,GAAG,QAAQ,CA0BzE;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,eAAe,CAmBnF"}

package/dist/mock.js

@@ -0,0 +1,155 @@
+/**
+ * Mock decision source — stands in for `POST /v1/decisions` until the
+ * backend (and its mock adapter deployment) is available. Shapes follow the
+ * frozen contract exactly; copy mirrors the Figma design fixtures so the
+ * renderers can be verified against the mock end-to-end.
+ */
+const ATTRIBUTION_TEXT = {
+    copy: "Powered by AfterShip",
+    logo_url: null,
+    target_url: "https://www.aftership.com",
+};
+const ATTRIBUTION_WITH_LOGO = {
+    copy: "Powered by",
+    logo_url: "https://picsum.photos/seed/adslogo/96/32",
+    target_url: "https://www.aftership.com",
+};
+const BILLY_REID = {
+    id: "mock-offer-billy-reid",
+    advertiser: { name: "BILLY REID", logo_url: null },
+    heading: "Classic American style — 15% off select pieces",
+    subheading: "Refined wardrobe staples, made to last. As a thank-you for your recent order, enjoy 15% off full-priced products this week.",
+    target_url: "https://example.com/offers/billy-reid?click_id=mock-click-billy-reid",
+    cta: { accept_copy: "Claim Offer", decline_copy: "No thanks" },
+    images: [{ url: "https://picsum.photos/seed/billyreid/640/440" }],
+    disclosure: {
+        copy: "Terms & Conditions",
+        target_url: null,
+        content: "Savings compared to regular full price. Offer valid this week only.",
+    },
+};
+const GAINFUL = {
+    id: "mock-offer-gainful",
+    advertiser: { name: "GAINFUL", logo_url: null },
+    heading: "Personalized nutrition, built for you",
+    subheading: "Tailored blends based on your goals. Try your first order with 20% off, just for AfterShip shoppers.",
+    target_url: "https://example.com/offers/gainful?click_id=mock-click-gainful",
+    cta: { accept_copy: "Claim Offer", decline_copy: "No thanks" },
+    images: [{ url: "https://picsum.photos/seed/gainful/640/440" }],
+    disclosure: null,
+};
+const RAKUTEN = {
+    id: "mock-offer-rakuten",
+    advertiser: { name: "Rakuten", logo_url: "https://picsum.photos/seed/rakuten/64/64" },
+    heading: "BlendJet — you're eligible for $10 cash back",
+    subheading: "You unlocked $10 cash back on your next BlendJet order. Activate it before it expires.",
+    target_url: "https://example.com/offers/rakuten?click_id=mock-click-rakuten",
+    cta: { accept_copy: "Claim cash back", decline_copy: "No thanks" },
+    images: [{ url: "https://picsum.photos/seed/blendjet/640/440" }],
+    disclosure: {
+        copy: "Terms & Conditions",
+        target_url: "https://example.com/terms",
+        content: null,
+    },
+};
+const ATLAS_COFFEE = {
+    id: "mock-offer-atlas",
+    advertiser: { name: "ATLAS COFFEE CLUB", logo_url: null },
+    heading: "Taste coffee from around the world",
+    subheading: "First bag 50% off, roasted to order and shipped free.",
+    target_url: "https://example.com/offers/atlas?click_id=mock-click-atlas",
+    cta: { accept_copy: "Get 50% off", decline_copy: null },
+    images: [{ url: "https://picsum.photos/seed/atlascoffee/640/440" }],
+    disclosure: null,
+};
+/** Contract-guaranteed fields only — exercises the "缺失不展示" render paths. */
+const MINIMAL = {
+    id: "mock-offer-minimal",
+    advertiser: null,
+    heading: null,
+    subheading: null,
+    target_url: "https://example.com/offers/minimal?click_id=mock-click-minimal",
+    cta: null,
+    images: [],
+    disclosure: null,
+};
+const NO_IMAGE = {
+    ...BILLY_REID,
+    id: "mock-offer-no-image",
+    images: [],
+};
+const LONG_TEXT = {
+    id: "mock-offer-long-text",
+    advertiser: { name: "THE EXCEEDINGLY LONG BRAND NAME COMPANY OF AMERICA", logo_url: null },
+    heading: "An extraordinarily long headline that just keeps going to make absolutely sure multi-line truncation works the way the design intends it to work",
+    subheading: "A description that is deliberately verbose. It rambles about premium materials, thoughtful craftsmanship, generous return windows, carbon-neutral shipping, and a founder story nobody asked for, so that three-line clamping has plenty of text to clamp.",
+    target_url: "https://example.com/offers/long?click_id=mock-click-long",
+    cta: { accept_copy: "Claim this remarkably good offer", decline_copy: "No thanks" },
+    images: [{ url: "https://picsum.photos/seed/longtext/640/440" }],
+    disclosure: null,
+};
+const CJK = {
+    id: "mock-offer-cjk",
+    advertiser: { name: "山田珈琲", logo_url: null },
+    heading: "感谢您的订单——精选咖啡豆限时 8 折",
+    subheading: "来自云南高山庄园的当季豆,下单即享顺丰包邮,本周专属优惠。",
+    target_url: "https://example.com/offers/cjk?click_id=mock-click-cjk",
+    cta: { accept_copy: "立即领取", decline_copy: "暂不需要" },
+    images: [{ url: "https://picsum.photos/seed/cjkcoffee/640/440" }],
+    disclosure: null,
+};
+const EMOJI = {
+    id: "mock-offer-emoji",
+    advertiser: { name: "SUNNY CLUB", logo_url: null },
+    heading: "Save 20% 🎉 on your summer order ☀️",
+    subheading: "Members get early access 🚀 plus free returns 💯 all season long.",
+    target_url: "https://example.com/offers/emoji?click_id=mock-click-emoji",
+    cta: { accept_copy: "Claim Offer 🎁", decline_copy: "No thanks" },
+    images: [{ url: "https://picsum.photos/seed/sunny/640/440" }],
+    disclosure: null,
+};
+/** Build a deterministic mock decision for a scenario. */
+export function mockDecision(scenario = "default") {
+    const base = (offers, attribution = ATTRIBUTION_TEXT) => ({
+        decision_id: `mock-decision-${scenario}`,
+        offers,
+        attribution,
+    });
+    switch (scenario) {
+        case "single":
+            return base([BILLY_REID]);
+        case "multi":
+            return base([GAINFUL, BILLY_REID, RAKUTEN, ATLAS_COFFEE], ATTRIBUTION_WITH_LOGO);
+        case "empty":
+            return { decision_id: `mock-decision-${scenario}`, offers: [], attribution: null };
+        case "minimal":
+            return base([MINIMAL]);
+        case "no-image":
+            return base([NO_IMAGE]);
+        case "long-text":
+            return base([LONG_TEXT]);
+        case "cjk":
+            return base([CJK]);
+        case "emoji":
+            return base([EMOJI]);
+        case "default":
+            return base([GAINFUL, BILLY_REID, RAKUTEN, ATLAS_COFFEE]);
+    }
+}
+export function createMockFetcher(options = {}) {
+    const { scenario, delayMs = 0 } = options;
+    return async (request, { signal }) => {
+        if (delayMs > 0) {
+            await new Promise((resolve, reject) => {
+                const timer = setTimeout(resolve, delayMs);
+                signal.addEventListener("abort", () => {
+                    clearTimeout(timer);
+                    reject(signal.reason instanceof Error ? signal.reason : new Error("aborted"));
+                }, { once: true });
+            });
+        }
+        const effective = scenario ?? (request.placement === "email" ? "single" : "default");
+        return mockDecision(effective);
+    };
+}
+//# sourceMappingURL=mock.js.map

package/dist/mock.js.map

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

package/dist/sanitize.d.ts

@@ -0,0 +1,16 @@
+import type { Attribution, Decision, Offer } from "./types.js";
+/** Frozen empty decision used for every fail-safe path. */
+export declare const EMPTY_DECISION: Decision;
+/**
+ * Normalize a raw offer. Returns null when the contract-guaranteed fields
+ * (`id`, `target_url`) are missing — such offers are dropped defensively.
+ */
+export declare function sanitizeOffer(raw: unknown): Offer | null;
+export declare function sanitizeAttribution(raw: unknown): Attribution | null;
+/**
+ * Normalize an untrusted decision payload to the frozen contract shape.
+ * Accepts either the bare decision object or the gopkg `api.Response`
+ * meta/data envelope and unwraps the latter.
+ */
+export declare function sanitizeDecision(raw: unknown): Decision;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../src/sanitize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,WAAW,EACX,QAAQ,EACR,KAAK,EAIN,MAAM,YAAY,CAAC;AAEpB,2DAA2D;AAC3D,eAAO,MAAM,cAAc,EAAE,QAI3B,CAAC;AA+CH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI,CAexD;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAOpE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,CAoBvD"}

package/dist/sanitize.js

@@ -0,0 +1,115 @@
+/** Frozen empty decision used for every fail-safe path. */
+export const EMPTY_DECISION = Object.freeze({
+    decision_id: "",
+    offers: [],
+    attribution: null,
+});
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Non-empty string or null. Empty strings are treated as missing (ENV-03). */
+function asText(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function sanitizeAdvertiser(raw) {
+    if (!isRecord(raw))
+        return null;
+    const name = asText(raw["name"]);
+    const logoUrl = asText(raw["logo_url"]);
+    if (name === null && logoUrl === null)
+        return null;
+    return { name, logo_url: logoUrl };
+}
+function sanitizeCta(raw) {
+    if (!isRecord(raw))
+        return null;
+    const accept = asText(raw["accept_copy"]);
+    const decline = asText(raw["decline_copy"]);
+    if (accept === null && decline === null)
+        return null;
+    return { accept_copy: accept, decline_copy: decline };
+}
+function sanitizeImages(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const images = [];
+    for (const item of raw) {
+        if (!isRecord(item))
+            continue;
+        const url = asText(item["url"]);
+        if (url !== null)
+            images.push({ url });
+    }
+    return images;
+}
+function sanitizeDisclosure(raw) {
+    if (!isRecord(raw))
+        return null;
+    const copy = asText(raw["copy"]);
+    const targetUrl = asText(raw["target_url"]);
+    const content = asText(raw["content"]);
+    if (copy === null && targetUrl === null && content === null)
+        return null;
+    return { copy, target_url: targetUrl, content };
+}
+/**
+ * Normalize a raw offer. Returns null when the contract-guaranteed fields
+ * (`id`, `target_url`) are missing — such offers are dropped defensively.
+ */
+export function sanitizeOffer(raw) {
+    if (!isRecord(raw))
+        return null;
+    const id = asText(raw["id"]);
+    const targetUrl = asText(raw["target_url"]);
+    if (id === null || targetUrl === null)
+        return null;
+    return {
+        id,
+        advertiser: sanitizeAdvertiser(raw["advertiser"]),
+        heading: asText(raw["heading"]),
+        subheading: asText(raw["subheading"]),
+        target_url: targetUrl,
+        cta: sanitizeCta(raw["cta"]),
+        images: sanitizeImages(raw["images"]),
+        disclosure: sanitizeDisclosure(raw["disclosure"]),
+    };
+}
+export function sanitizeAttribution(raw) {
+    if (!isRecord(raw))
+        return null;
+    const copy = asText(raw["copy"]);
+    const logoUrl = asText(raw["logo_url"]);
+    const targetUrl = asText(raw["target_url"]);
+    if (copy === null && logoUrl === null && targetUrl === null)
+        return null;
+    return { copy, logo_url: logoUrl, target_url: targetUrl };
+}
+/**
+ * Normalize an untrusted decision payload to the frozen contract shape.
+ * Accepts either the bare decision object or the gopkg `api.Response`
+ * meta/data envelope and unwraps the latter.
+ */
+export function sanitizeDecision(raw) {
+    if (!isRecord(raw))
+        return EMPTY_DECISION;
+    let body = raw;
+    const data = raw["data"];
+    if (isRecord(data) && ("offers" in data || "decision_id" in data)) {
+        body = data;
+    }
+    const offersRaw = body["offers"];
+    const offers = [];
+    if (Array.isArray(offersRaw)) {
+        for (const item of offersRaw) {
+            const offer = sanitizeOffer(item);
+            if (offer !== null)
+                offers.push(offer);
+        }
+    }
+    return {
+        decision_id: asText(body["decision_id"]) ?? "",
+        offers,
+        attribution: sanitizeAttribution(body["attribution"]),
+    };
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/sanitize.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Frozen decision API contract types.
+ *
+ * Source of truth: docs/design/2026-07-13-ads-s2s-decision-api-design.md (§3.3).
+ * Field semantics:
+ * - Only `Offer.id` and `Offer.target_url` are guaranteed. Every other field may
+ *   be missing (`null` for objects/strings, `[]` for arrays). Renderers must
+ *   skip missing fields instead of assuming presence.
+ * - `Offer.target_url` must be used verbatim — it carries vendor attribution
+ *   parameters (click_id); rewriting it breaks click billing.
+ * - `Decision.attribution` ("Powered by …") is a compliance element that must
+ *   be displayed alongside the ad whenever provided.
+ */
+export type Placement = "btp" | "ocp" | "email";
+export interface DecisionRequest {
+    /**
+     * 32-char organization id. Required. Logical field of the request; at the
+     * wire it travels via the `am-organization-id` header, not the body — the
+     * injected fetcher lifts it out (contract 07-13 §2, backend #64).
+     */
+    organization_id: string;
+    /** Channel placement. Required. */
+    placement: Placement;
+    /** Connector (中台) order id. Optional; server enriches from it. */
+    order_id?: string;
+    /** Buyer email in plaintext (intranet only; hashed at vendor egress). */
+    email?: string;
+}
+export interface Advertiser {
+    name: string | null;
+    logo_url: string | null;
+}
+export interface OfferCta {
+    /** Accept-button copy, vendor/advertiser approved — do not invent replacements. */
+    accept_copy: string | null;
+    decline_copy: string | null;
+}
+export interface OfferImage {
+    url: string;
+}
+export interface OfferDisclosure {
+    /** Entry copy, e.g. "Terms & Conditions". */
+    copy: string | null;
+    target_url: string | null;
+    /** Long-form disclosure text (shown expanded / in a layer). */
+    content: string | null;
+}
+export interface Offer {
+    /** Unique offer id. Guaranteed. */
+    id: string;
+    advertiser: Advertiser | null;
+    heading: string | null;
+    subheading: string | null;
+    /** Click-through URL. Guaranteed. Must be used verbatim (contains click_id). */
+    target_url: string;
+    cta: OfferCta | null;
+    /** Creative images in order; take the first. Empty = text-only card. */
+    images: OfferImage[];
+    disclosure: OfferDisclosure | null;
+}
+export interface Attribution {
+    /** e.g. "Powered by". Compliance: must render alongside the ad when present. */
+    copy: string | null;
+    logo_url: string | null;
+    target_url: string | null;
+}
+export interface Decision {
+    /** Decision id — anchor for future event reporting & reconciliation. */
+    decision_id: string;
+    /** Ordered offers. Empty = fail-safe no-fill: render nothing. */
+    offers: Offer[];
+    attribution: Attribution | null;
+}
+/**
+ * Theme tokens (parent design §8). Merge order: host input > backend config
+ * defaults (config API pending review) > built-in defaults.
+ *
+ * Deliberately coarse-grained: the CTA button inherits `primaryColor`
+ * (background) and `borderRadius` instead of having its own bg/radius
+ * tokens. Shopify OCP does not consume these at all
+ * (sandbox forbids CSS — 07-10 §6).
+ */
+export interface AdsTheme {
+    /** Accent color; the CTA button background inherits this. */
+    primaryColor?: string;
+    backgroundColor?: string;
+    cardColor?: string;
+    /** Title color; description derives from it (0.72 alpha) unless overridden. */
+    textColor?: string;
+    /** Description/body color. Absent → derived from `textColor`. */
+    descriptionColor?: string;
+    /** CTA button label color. Absent → built-in white. */
+    buttonTextColor?: string;
+    /** Corner radius of the offer image and CTA button (the section is flat — 07-17 design). */
+    borderRadius?: number;
+    fontFamily?: string;
+    density?: "compact" | "comfortable";
+    lang?: string;
+}
+/**
+ * Token payload carried by the email render token (07-13 §4). Fields mirror
+ * the issue request verbatim — the token never carries `placement`; the
+ * render service fills `"email"` itself (§4.2).
+ */
+export interface TokenPayload {
+    organization_id: string;
+    order_id: string | null;
+    email: string | null;
+    store_platform: string | null;
+    store_key: string | null;
+}
+/**
+ * Renderer → host event callback. Reporting endpoints (e/imp, e/click) land
+ * additively after the data-reporting review; until then hosts typically log
+ * or no-op. `decision_id` / `offer_id` are the contract's attribution anchors.
+ */
+export type AdsEventType = "impression" | "click" | "no_fill";
+export interface AdsEvent {
+    type: AdsEventType;
+    decision_id: string;
+    offer_id?: string;
+    placement?: Placement;
+    timestamp: number;
+    meta?: Record<string, unknown>;
+}
+export type AdsEventSink = (event: AdsEvent) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,15 @@
+/**
+ * Frozen decision API contract types.
+ *
+ * Source of truth: docs/design/2026-07-13-ads-s2s-decision-api-design.md (§3.3).
+ * Field semantics:
+ * - Only `Offer.id` and `Offer.target_url` are guaranteed. Every other field may
+ *   be missing (`null` for objects/strings, `[]` for arrays). Renderers must
+ *   skip missing fields instead of assuming presence.
+ * - `Offer.target_url` must be used verbatim — it carries vendor attribution
+ *   parameters (click_id); rewriting it breaks click billing.
+ * - `Decision.attribution` ("Powered by …") is a compliance element that must
+ *   be displayed alongside the ad whenever provided.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@aftership/ads-core",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Headless isomorphic core for AfterShip Ads self-render channel: frozen decision contract types, fail-safe client with injectable fetcher, mock decision source, and event hooks. Zero dependencies, zero DOM.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}