@monetizationos/proxy 1.0.0

package/dist/adapters/HtmlRewriterAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlRewriterAdapter.js","sourceRoot":"","sources":["../../src/adapters/HtmlRewriterAdapter.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Platform-agnostic contract over lol-html-style streaming HTML rewriters\n * (Cloudflare's `HTMLRewriter`, Fastly's `HTMLRewritingStream`, Akamai's `HtmlRewritingStream`).\n *\n * An adapter creates a new rewriter session per call to `create()`; the session is a builder\n * that accepts selectors + handlers via `.on(...)` and produces a transformed `Response` via\n * `.transform(response)`.\n *\n * `capabilities` advertises which lol-html features the underlying implementation supports.\n * Consumers dispatch on these flags to enable or fall back paths (e.g., range-replacement\n * via `element.onEndTag` vs. a sentinel post-process).\n */\nexport interface HtmlRewriterAdapter {\n    readonly capabilities: HtmlRewriterCapabilities\n    create(): HtmlRewriterSession\n}\n\nexport interface HtmlRewriterCapabilities {\n    /** Element handlers can register an end-tag callback via `element.onEndTag(cb)`. */\n    onEndTag: boolean\n    /** `:nth-child()` CSS pseudo-class is supported in selectors. */\n    nthChild: boolean\n}\n\nexport interface HtmlRewriterSession {\n    on(selector: string, handlers: ElementHandlers): HtmlRewriterSession\n    transform(response: Response): Response\n}\n\nexport interface ElementHandlers {\n    element?(element: RewriterElement): void | Promise<void>\n    text?(text: RewriterText): void | Promise<void>\n}\n\nexport interface ContentOptions {\n    html?: boolean\n}\n\n/**\n * Mirrors the Cloudflare `Element` API (a lol-html `HTMLRewriterElement`).\n *\n * Adapters may throw from `onEndTag` on runtimes that don't support it; callers should\n * check `capabilities.onEndTag` before relying on it, or catch the error.\n */\nexport interface RewriterElement {\n    readonly removed: boolean\n    readonly tagName: string\n    getAttribute(name: string): string | null\n    hasAttribute(name: string): boolean\n    setAttribute(name: string, value: string): void\n    removeAttribute(name: string): void\n    before(content: string, options?: ContentOptions): void\n    after(content: string, options?: ContentOptions): void\n    prepend(content: string, options?: ContentOptions): void\n    append(content: string, options?: ContentOptions): void\n    replace(content: string, options?: ContentOptions): void\n    remove(): void\n    onEndTag?(callback: () => void | Promise<void>): void\n}\n\nexport interface RewriterText {\n    readonly text: string\n    readonly lastInTextNode: boolean\n    readonly removed: boolean\n    remove(): void\n}\n"]}

package/dist/adapters/index.d.ts

@@ -0,0 +1,3 @@
+export type { ClientMetadataProvider } from './ClientMetadataProvider';
+export type { Fetcher } from './Fetcher';
+export type { ContentOptions, ElementHandlers, HtmlRewriterAdapter, HtmlRewriterCapabilities, HtmlRewriterSession, RewriterElement, RewriterText, } from './HtmlRewriterAdapter';

package/dist/adapters/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"","sourcesContent":["export type { ClientMetadataProvider } from './ClientMetadataProvider'\nexport type { Fetcher } from './Fetcher'\nexport type {\n    ContentOptions,\n    ElementHandlers,\n    HtmlRewriterAdapter,\n    HtmlRewriterCapabilities,\n    HtmlRewriterSession,\n    RewriterElement,\n    RewriterText,\n} from './HtmlRewriterAdapter'\n"]}

package/dist/apiRequestHeaders.d.ts

@@ -0,0 +1,4 @@
+export declare const MOS_PROXY_VERSION_HEADER = "X-MOS-Proxy-Version";
+export declare const MOS_PROXY_PACKAGE_VERSION = "1.0.0";
+export declare const setMosProxyVersionHeader: (headers: Headers) => void;
+export declare const withMosProxyVersionHeader: (headers?: HeadersInit) => Headers;

package/dist/apiRequestHeaders.js

@@ -0,0 +1,11 @@
+export const MOS_PROXY_VERSION_HEADER = 'X-MOS-Proxy-Version';
+export const MOS_PROXY_PACKAGE_VERSION = '1.0.0';
+export const setMosProxyVersionHeader = (headers) => {
+    headers.set(MOS_PROXY_VERSION_HEADER, MOS_PROXY_PACKAGE_VERSION);
+};
+export const withMosProxyVersionHeader = (headers) => {
+    const next = new Headers(headers);
+    setMosProxyVersionHeader(next);
+    return next;
+};
+//# sourceMappingURL=apiRequestHeaders.js.map

package/dist/apiRequestHeaders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiRequestHeaders.js","sourceRoot":"","sources":["../src/apiRequestHeaders.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,CAAA;AAC7D,MAAM,CAAC,MAAM,yBAAyB,GAAG,OAAO,CAAA;AAEhD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,OAAgB,EAAQ,EAAE;IAC/D,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,yBAAyB,CAAC,CAAA;AACpE,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,OAAqB,EAAW,EAAE;IACxE,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IACjC,wBAAwB,CAAC,IAAI,CAAC,CAAA;IAC9B,OAAO,IAAI,CAAA;AACf,CAAC,CAAA","sourcesContent":["export const MOS_PROXY_VERSION_HEADER = 'X-MOS-Proxy-Version'\nexport const MOS_PROXY_PACKAGE_VERSION = '1.0.0'\n\nexport const setMosProxyVersionHeader = (headers: Headers): void => {\n    headers.set(MOS_PROXY_VERSION_HEADER, MOS_PROXY_PACKAGE_VERSION)\n}\n\nexport const withMosProxyVersionHeader = (headers?: HeadersInit): Headers => {\n    const next = new Headers(headers)\n    setMosProxyVersionHeader(next)\n    return next\n}\n"]}

package/dist/config.d.ts

@@ -0,0 +1,16 @@
+import { type MOSProxyLogger } from './logger';
+import type { MOSConfigInput } from './types';
+export interface MOSConfig {
+    originUrl: URL;
+    surfaceSlug: string;
+    mosHost: URL;
+    mosSecretKey: string;
+    mosEnvironment: string;
+    mosEndpointsPrefix: string;
+    anonymousSessionCookieName: string;
+    authenticatedUserJwtCookieName: string;
+    injectScriptUrl: string | undefined;
+    surfaceDecisionsIgnorePathPatterns: RegExp[];
+    originRequestHeaders: Record<string, string>;
+}
+export declare function normalizeMOSConfig(config: MOSConfigInput, logger?: MOSProxyLogger): MOSConfig;

package/dist/config.js

@@ -0,0 +1,39 @@
+import { consoleLogger } from './logger';
+const DEFAULT_ENDPOINTS_PREFIX = '/mos-endpoints/';
+export function normalizeMOSConfig(config, logger = consoleLogger) {
+    const ignorePathPatterns = [];
+    if (config.surfaceDecisionsIgnorePaths) {
+        for (const raw of config.surfaceDecisionsIgnorePaths.split(',')) {
+            const pattern = raw.trim();
+            if (!pattern)
+                continue;
+            try {
+                ignorePathPatterns.push(new RegExp(pattern));
+            }
+            catch (error) {
+                logger.log({
+                    level: 'warn',
+                    code: 'invalid-ignore-path-pattern',
+                    message: `Invalid surfaceDecisionsIgnorePaths regex pattern: ${pattern}`,
+                    context: { pattern },
+                    error,
+                });
+            }
+        }
+    }
+    const secretKeyParts = config.mosSecretKey.split('_');
+    return {
+        originUrl: new URL(config.originUrl),
+        surfaceSlug: config.surfaceSlug,
+        mosHost: new URL(config.mosHost),
+        mosSecretKey: config.mosSecretKey,
+        mosEnvironment: `${secretKeyParts[1] ?? ''}_${secretKeyParts[2] ?? ''}`,
+        mosEndpointsPrefix: config.mosEndpointsPrefix || DEFAULT_ENDPOINTS_PREFIX,
+        anonymousSessionCookieName: config.anonymousSessionCookieName,
+        authenticatedUserJwtCookieName: config.authenticatedUserJwtCookieName,
+        injectScriptUrl: config.injectScriptUrl,
+        surfaceDecisionsIgnorePathPatterns: ignorePathPatterns,
+        originRequestHeaders: { ...(config.originRequestHeaders ?? {}) },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAuB,MAAM,UAAU,CAAA;AAG7D,MAAM,wBAAwB,GAAG,iBAAiB,CAAA;AAgBlD,MAAM,UAAU,kBAAkB,CAAC,MAAsB,EAAE,SAAyB,aAAa;IAC7F,MAAM,kBAAkB,GAAa,EAAE,CAAA;IACvC,IAAI,MAAM,CAAC,2BAA2B,EAAE,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,2BAA2B,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9D,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;YAC1B,IAAI,CAAC,OAAO;gBAAE,SAAQ;YACtB,IAAI,CAAC;gBACD,kBAAkB,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;YAChD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,CAAC;oBACP,KAAK,EAAE,MAAM;oBACb,IAAI,EAAE,6BAA6B;oBACnC,OAAO,EAAE,sDAAsD,OAAO,EAAE;oBACxE,OAAO,EAAE,EAAE,OAAO,EAAE;oBACpB,KAAK;iBACR,CAAC,CAAA;YACN,CAAC;QACL,CAAC;IACL,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAErD,OAAO;QACH,SAAS,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;QACpC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;QAChC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,cAAc,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE;QACvE,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI,wBAAwB;QACzE,0BAA0B,EAAE,MAAM,CAAC,0BAA0B;QAC7D,8BAA8B,EAAE,MAAM,CAAC,8BAA8B;QACrE,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,kCAAkC,EAAE,kBAAkB;QACtD,oBAAoB,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,oBAAoB,IAAI,EAAE,CAAC,EAAE;KACnE,CAAA;AACL,CAAC","sourcesContent":["import { consoleLogger, type MOSProxyLogger } from './logger'\nimport type { MOSConfigInput } from './types'\n\nconst DEFAULT_ENDPOINTS_PREFIX = '/mos-endpoints/'\n\nexport interface MOSConfig {\n    originUrl: URL\n    surfaceSlug: string\n    mosHost: URL\n    mosSecretKey: string\n    mosEnvironment: string\n    mosEndpointsPrefix: string\n    anonymousSessionCookieName: string\n    authenticatedUserJwtCookieName: string\n    injectScriptUrl: string | undefined\n    surfaceDecisionsIgnorePathPatterns: RegExp[]\n    originRequestHeaders: Record<string, string>\n}\n\nexport function normalizeMOSConfig(config: MOSConfigInput, logger: MOSProxyLogger = consoleLogger): MOSConfig {\n    const ignorePathPatterns: RegExp[] = []\n    if (config.surfaceDecisionsIgnorePaths) {\n        for (const raw of config.surfaceDecisionsIgnorePaths.split(',')) {\n            const pattern = raw.trim()\n            if (!pattern) continue\n            try {\n                ignorePathPatterns.push(new RegExp(pattern))\n            } catch (error) {\n                logger.log({\n                    level: 'warn',\n                    code: 'invalid-ignore-path-pattern',\n                    message: `Invalid surfaceDecisionsIgnorePaths regex pattern: ${pattern}`,\n                    context: { pattern },\n                    error,\n                })\n            }\n        }\n    }\n\n    const secretKeyParts = config.mosSecretKey.split('_')\n\n    return {\n        originUrl: new URL(config.originUrl),\n        surfaceSlug: config.surfaceSlug,\n        mosHost: new URL(config.mosHost),\n        mosSecretKey: config.mosSecretKey,\n        mosEnvironment: `${secretKeyParts[1] ?? ''}_${secretKeyParts[2] ?? ''}`,\n        mosEndpointsPrefix: config.mosEndpointsPrefix || DEFAULT_ENDPOINTS_PREFIX,\n        anonymousSessionCookieName: config.anonymousSessionCookieName,\n        authenticatedUserJwtCookieName: config.authenticatedUserJwtCookieName,\n        injectScriptUrl: config.injectScriptUrl,\n        surfaceDecisionsIgnorePathPatterns: ignorePathPatterns,\n        originRequestHeaders: { ...(config.originRequestHeaders ?? {}) },\n    }\n}\n"]}

package/dist/context.d.ts

@@ -0,0 +1,12 @@
+import type { MOSConfig } from './config';
+import type { MOSProxyLogger } from './logger';
+/**
+ * Shared environment threaded into every pipeline stage that needs cross-cutting infrastructure
+ * (normalized config, logger, and — when added — metrics/tracer/clock). Built once per request in
+ * `MOSProxy.handle`. Stages that only operate on a response and decision payload (e.g.
+ * `handleSurfaceBehavior`, `isRedirectResponse`) deliberately do not take a context.
+ */
+export interface PipelineContext {
+    config: MOSConfig;
+    logger: MOSProxyLogger;
+}

package/dist/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"","sourcesContent":["import type { MOSConfig } from './config'\nimport type { MOSProxyLogger } from './logger'\n\n/**\n * Shared environment threaded into every pipeline stage that needs cross-cutting infrastructure\n * (normalized config, logger, and — when added — metrics/tracer/clock). Built once per request in\n * `MOSProxy.handle`. Stages that only operate on a response and decision payload (e.g.\n * `handleSurfaceBehavior`, `isRedirectResponse`) deliberately do not take a context.\n */\nexport interface PipelineContext {\n    config: MOSConfig\n    logger: MOSProxyLogger\n}\n"]}

package/dist/http.d.ts

@@ -0,0 +1 @@
+export declare const statusAllowsBody: (status: number) => boolean;

package/dist/http.js

@@ -0,0 +1,3 @@
+const NO_BODY_STATUSES = new Set([204, 205, 304]);
+export const statusAllowsBody = (status) => status >= 200 && !NO_BODY_STATUSES.has(status);
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;AAEjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA","sourcesContent":["const NO_BODY_STATUSES = new Set([204, 205, 304])\n\nexport const statusAllowsBody = (status: number) => status >= 200 && !NO_BODY_STATUSES.has(status)\n"]}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { ClientMetadataProvider, ContentOptions, ElementHandlers, Fetcher, HtmlRewriterAdapter, HtmlRewriterCapabilities, HtmlRewriterSession, RewriterElement, RewriterText, } from './adapters';
+export type { MOSProxyLogCode, MOSProxyLogEvent, MOSProxyLogger, MOSProxyLogLevel } from './logger';
+export { MOSProxy, type MOSProxyHtmlPipelineErrorContext, type MOSProxyHtmlPipelineErrorHandler, type MOSProxyHtmlPipelineStage, type MOSProxyOptions, } from './MOSProxy';
+export { MOSProxyBuilder } from './MOSProxyBuilder';
+export type { Feature, FeatureMeterableProperty, FeatureNumberProperty, MOSConfigInput, ModifyHttpResponse, PageMetadata, SetHttpResponse, SubSurfaceBehaviorApi, SubSurfaceMetadataApi, SurfaceBehaviorApi, SurfaceDecisionError, SurfaceDecisionResponse, WebComponentElement, WebComponentRangeReplacement, WebContentSurfaceBehavior, WebElement, } from './types';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { MOSProxy, } from './MOSProxy';
+export { MOSProxyBuilder } from './MOSProxyBuilder';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,EACH,QAAQ,GAKX,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA","sourcesContent":["export type {\n    ClientMetadataProvider,\n    ContentOptions,\n    ElementHandlers,\n    Fetcher,\n    HtmlRewriterAdapter,\n    HtmlRewriterCapabilities,\n    HtmlRewriterSession,\n    RewriterElement,\n    RewriterText,\n} from './adapters'\nexport type { MOSProxyLogCode, MOSProxyLogEvent, MOSProxyLogger, MOSProxyLogLevel } from './logger'\nexport {\n    MOSProxy,\n    type MOSProxyHtmlPipelineErrorContext,\n    type MOSProxyHtmlPipelineErrorHandler,\n    type MOSProxyHtmlPipelineStage,\n    type MOSProxyOptions,\n} from './MOSProxy'\nexport { MOSProxyBuilder } from './MOSProxyBuilder'\nexport type {\n    Feature,\n    FeatureMeterableProperty,\n    FeatureNumberProperty,\n    MOSConfigInput,\n    ModifyHttpResponse,\n    PageMetadata,\n    SetHttpResponse,\n    SubSurfaceBehaviorApi,\n    SubSurfaceMetadataApi,\n    SurfaceBehaviorApi,\n    SurfaceDecisionError,\n    SurfaceDecisionResponse,\n    WebComponentElement,\n    WebComponentRangeReplacement,\n    WebContentSurfaceBehavior,\n    WebElement,\n} from './types'\n"]}

package/dist/logger.d.ts

@@ -0,0 +1,13 @@
+export type MOSProxyLogLevel = 'warn' | 'error';
+export type MOSProxyLogCode = 'html-pipeline-failed' | 'html-pipeline-error-handler-invalid' | 'html-pipeline-error-handler-threw' | 'invalid-ignore-path-pattern' | 'response-clone-failed' | 'surface-decisions-api-failed' | 'link-rewriting-header-failed' | 'link-rewriting-body-failed' | 'marker-pass-invalid-state' | 'marker-pass-selector-failed' | 'replacement-markers-identical' | 'replacement-state-missing' | 'element-render-failed' | 'element-type-unsupported' | 'page-metadata-parse-failed' | 'component-selector-unsupported' | 'component-range-replacement-skipped' | 'component-transform-failed';
+export interface MOSProxyLogEvent {
+    level: MOSProxyLogLevel;
+    code: MOSProxyLogCode;
+    message: string;
+    context?: Record<string, unknown>;
+    error?: unknown;
+}
+export interface MOSProxyLogger {
+    log(event: MOSProxyLogEvent): void;
+}
+export declare const consoleLogger: MOSProxyLogger;

package/dist/logger.js

@@ -0,0 +1,14 @@
+export const consoleLogger = {
+    log(event) {
+        const details = [event.message, { code: event.code, ...event.context }];
+        if (event.error) {
+            details.push(event.error);
+        }
+        if (event.level === 'error') {
+            console.error(...details);
+            return;
+        }
+        console.warn(...details);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAkCA,MAAM,CAAC,MAAM,aAAa,GAAmB;IACzC,GAAG,CAAC,KAAK;QACL,MAAM,OAAO,GAAc,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QAClF,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAC7B,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAA;YACzB,OAAM;QACV,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAA;IAC5B,CAAC;CACJ,CAAA","sourcesContent":["export type MOSProxyLogLevel = 'warn' | 'error'\n\nexport type MOSProxyLogCode =\n    | 'html-pipeline-failed'\n    | 'html-pipeline-error-handler-invalid'\n    | 'html-pipeline-error-handler-threw'\n    | 'invalid-ignore-path-pattern'\n    | 'response-clone-failed'\n    | 'surface-decisions-api-failed'\n    | 'link-rewriting-header-failed'\n    | 'link-rewriting-body-failed'\n    | 'marker-pass-invalid-state'\n    | 'marker-pass-selector-failed'\n    | 'replacement-markers-identical'\n    | 'replacement-state-missing'\n    | 'element-render-failed'\n    | 'element-type-unsupported'\n    | 'page-metadata-parse-failed'\n    | 'component-selector-unsupported'\n    | 'component-range-replacement-skipped'\n    | 'component-transform-failed'\n\nexport interface MOSProxyLogEvent {\n    level: MOSProxyLogLevel\n    code: MOSProxyLogCode\n    message: string\n    context?: Record<string, unknown>\n    error?: unknown\n}\n\nexport interface MOSProxyLogger {\n    log(event: MOSProxyLogEvent): void\n}\n\nexport const consoleLogger: MOSProxyLogger = {\n    log(event) {\n        const details: unknown[] = [event.message, { code: event.code, ...event.context }]\n        if (event.error) {\n            details.push(event.error)\n        }\n\n        if (event.level === 'error') {\n            console.error(...details)\n            return\n        }\n\n        console.warn(...details)\n    },\n}\n"]}

package/dist/stages/ContentElementHandler.d.ts

@@ -0,0 +1,9 @@
+import type { ElementHandlers, RewriterElement } from '../adapters/HtmlRewriterAdapter';
+import type { PipelineContext } from '../context';
+import type { WebContentSurfaceBehavior } from '../types';
+export declare class ContentElementHandler implements ElementHandlers {
+    content: WebContentSurfaceBehavior;
+    private readonly ctx;
+    constructor(ctx: PipelineContext, content: WebContentSurfaceBehavior);
+    element(element: RewriterElement): void;
+}

package/dist/stages/ContentElementHandler.js

@@ -0,0 +1,37 @@
+import { renderElement } from './elements';
+const transformPositions = ['before', 'prepend', 'append', 'after'];
+const reverseTransformPositions = ['after', 'prepend'];
+export class ContentElementHandler {
+    content;
+    ctx;
+    constructor(ctx, content) {
+        this.ctx = ctx;
+        this.content = content;
+    }
+    element(element) {
+        if (element.removed) {
+            return;
+        }
+        let retainElement = false;
+        for (const key of transformPositions) {
+            const list = this.content[key];
+            if (list?.length) {
+                const ordered = reverseTransformPositions.includes(key) ? [...list].reverse() : list;
+                for (const transformation of ordered) {
+                    const [content, options] = renderElement(this.ctx, transformation);
+                    element[key](content, options);
+                }
+                retainElement = true;
+            }
+        }
+        if (this.content.remove) {
+            if (retainElement) {
+                element.replace('', { html: true });
+            }
+            else {
+                element.remove();
+            }
+        }
+    }
+}
+//# sourceMappingURL=ContentElementHandler.js.map

package/dist/stages/ContentElementHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentElementHandler.js","sourceRoot":"","sources":["../../src/stages/ContentElementHandler.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,MAAM,kBAAkB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAA;AAC5E,MAAM,yBAAyB,GAAuD,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;AAE1G,MAAM,OAAO,qBAAqB;IAC9B,OAAO,CAA2B;IACjB,GAAG,CAAiB;IAErC,YAAY,GAAoB,EAAE,OAAkC;QAChE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;QACd,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IAC1B,CAAC;IAED,OAAO,CAAC,OAAwB;QAC5B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,OAAM;QACV,CAAC;QAED,IAAI,aAAa,GAAG,KAAK,CAAA;QACzB,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;YAC9B,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,yBAAyB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;gBACpF,KAAK,MAAM,cAAc,IAAI,OAAO,EAAE,CAAC;oBACnC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAA;oBAClE,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;gBAClC,CAAC;gBACD,aAAa,GAAG,IAAI,CAAA;YACxB,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACtB,IAAI,aAAa,EAAE,CAAC;gBAChB,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YACvC,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,MAAM,EAAE,CAAA;YACpB,CAAC;QACL,CAAC;IACL,CAAC;CACJ","sourcesContent":["import type { ElementHandlers, RewriterElement } from '../adapters/HtmlRewriterAdapter'\nimport type { PipelineContext } from '../context'\nimport type { WebContentSurfaceBehavior } from '../types'\nimport { renderElement } from './elements'\n\nconst transformPositions = ['before', 'prepend', 'append', 'after'] as const\nconst reverseTransformPositions: ReadonlyArray<(typeof transformPositions)[number]> = ['after', 'prepend']\n\nexport class ContentElementHandler implements ElementHandlers {\n    content: WebContentSurfaceBehavior\n    private readonly ctx: PipelineContext\n\n    constructor(ctx: PipelineContext, content: WebContentSurfaceBehavior) {\n        this.ctx = ctx\n        this.content = content\n    }\n\n    element(element: RewriterElement) {\n        if (element.removed) {\n            return\n        }\n\n        let retainElement = false\n        for (const key of transformPositions) {\n            const list = this.content[key]\n            if (list?.length) {\n                const ordered = reverseTransformPositions.includes(key) ? [...list].reverse() : list\n                for (const transformation of ordered) {\n                    const [content, options] = renderElement(this.ctx, transformation)\n                    element[key](content, options)\n                }\n                retainElement = true\n            }\n        }\n\n        if (this.content.remove) {\n            if (retainElement) {\n                element.replace('', { html: true })\n            } else {\n                element.remove()\n            }\n        }\n    }\n}\n"]}

package/dist/stages/buildReplacementHandlers.d.ts

@@ -0,0 +1,14 @@
+import type { ElementHandlers } from '../adapters/HtmlRewriterAdapter';
+import type { PipelineContext } from '../context';
+import type { SubSurfaceBehaviorApi } from '../types';
+import type { ComponentRange } from './findMarkerPositions';
+export type ReplacementHandler = {
+    selector: string;
+    handler: ElementHandlers;
+};
+/**
+ * Requires a prior pass by `findMarkerPositions` to populate `ranges`. Depends on
+ * `element.onEndTag` to detect element boundaries — on adapters without `capabilities.onEndTag`,
+ * the caller should skip this step.
+ */
+export declare const buildReplacementHandlers: (ctx: PipelineContext, subSurface: SubSurfaceBehaviorApi, ranges: ComponentRange[] | undefined) => ReplacementHandler[];

package/dist/stages/buildReplacementHandlers.js

@@ -0,0 +1,116 @@
+import { renderElement } from './elements';
+/**
+ * Requires a prior pass by `findMarkerPositions` to populate `ranges`. Depends on
+ * `element.onEndTag` to detect element boundaries — on adapters without `capabilities.onEndTag`,
+ * the caller should skip this step.
+ */
+export const buildReplacementHandlers = (ctx, subSurface, ranges) => {
+    const { logger } = ctx;
+    const modification = subSurface.content?.replaceRange;
+    if (!modification || !ranges) {
+        return [];
+    }
+    if (modification.fromMarker && modification.toMarker && modification.fromMarker === modification.toMarker) {
+        logger.log({
+            level: 'warn',
+            code: 'replacement-markers-identical',
+            message: 'Range replacement skipped: fromMarker and toMarker are identical.',
+            context: { marker: modification.fromMarker, selector: subSurface.metadata.cssSelector },
+        });
+        return [];
+    }
+    let elementCounter = 0;
+    let rangeIndex = -1;
+    const states = [];
+    const getCurrentState = () => {
+        const state = states[states.length - 1];
+        if (!state) {
+            logger.log({
+                level: 'warn',
+                code: 'replacement-state-missing',
+                message: 'Range replacement handler invoked with no active replacement state; skipping.',
+                context: { selector: subSurface.metadata.cssSelector },
+            });
+            return;
+        }
+        return state;
+    };
+    const onChildElement = (element) => {
+        elementCounter++;
+        if (element.removed) {
+            return;
+        }
+        const state = getCurrentState();
+        const range = ranges[rangeIndex];
+        const marker = range?.markers[elementCounter];
+        if (state?.operation === 'SCANNING') {
+            if (marker?.startMarker) {
+                for (const after of (modification.replaceWith ?? []).slice().reverse()) {
+                    const [content, options] = renderElement(ctx, after);
+                    element.after(content, options);
+                }
+                if (element.onEndTag) {
+                    try {
+                        element.onEndTag(() => {
+                            state.operation = 'REMOVING';
+                        });
+                    }
+                    catch {
+                        state.operation = 'REMOVING';
+                    }
+                }
+                else {
+                    state.operation = 'REMOVING';
+                }
+            }
+            return;
+        }
+        if (state?.operation === 'REMOVING') {
+            if (marker?.endMarker) {
+                state.operation = 'REPLACED';
+                return;
+            }
+            if (marker?.endTag !== elementCounter && marker?.nextEndMarker && marker?.endTag && marker.endTag >= marker.nextEndMarker) {
+                return;
+            }
+            element.remove();
+            return;
+        }
+    };
+    const parentHandler = {
+        element(element) {
+            rangeIndex++;
+            if (element.removed) {
+                return;
+            }
+            const state = { operation: modification.fromMarker ? 'SCANNING' : 'REMOVING' };
+            states.push(state);
+            if (state.operation === 'REMOVING') {
+                for (const prepend of (modification.replaceWith ?? []).slice().reverse()) {
+                    const [content, options] = renderElement(ctx, prepend);
+                    element.prepend(content, options);
+                }
+            }
+            if (element.onEndTag) {
+                element.onEndTag(() => {
+                    states.pop();
+                });
+            }
+        },
+        text: (text) => {
+            const state = getCurrentState();
+            if (state?.operation === 'REMOVING') {
+                text.remove();
+            }
+        },
+    };
+    const selector = subSurface.metadata.cssSelector;
+    if (!selector) {
+        return [];
+    }
+    return [
+        { selector, handler: parentHandler },
+        { selector: `${selector} *`, handler: { element: onChildElement } },
+    ];
+};
+//# sourceMappingURL=buildReplacementHandlers.js.map

package/dist/stages/buildReplacementHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildReplacementHandlers.js","sourceRoot":"","sources":["../../src/stages/buildReplacementHandlers.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ElementHandlers, RewriterElement, RewriterText } from '../adapters/HtmlRewriterAdapter'\nimport type { PipelineContext } from '../context'\nimport type { SubSurfaceBehaviorApi } from '../types'\nimport { renderElement } from './elements'\nimport type { ComponentRange } from './findMarkerPositions'\n\ntype ReplacementState = {\n    operation: 'SCANNING' | 'REMOVING' | 'REPLACED'\n}\n\nexport type ReplacementHandler = { selector: string; handler: ElementHandlers }\n\n/**\n * Requires a prior pass by `findMarkerPositions` to populate `ranges`. Depends on\n * `element.onEndTag` to detect element boundaries — on adapters without `capabilities.onEndTag`,\n * the caller should skip this step.\n */\nexport const buildReplacementHandlers = (\n    ctx: PipelineContext,\n    subSurface: SubSurfaceBehaviorApi,\n    ranges: ComponentRange[] | undefined,\n): ReplacementHandler[] => {\n    const { logger } = ctx\n    const modification = subSurface.content?.replaceRange\n    if (!modification || !ranges) {\n        return []\n    }\n\n    if (modification.fromMarker && modification.toMarker && modification.fromMarker === modification.toMarker) {\n        logger.log({\n            level: 'warn',\n            code: 'replacement-markers-identical',\n            message: 'Range replacement skipped: fromMarker and toMarker are identical.',\n            context: { marker: modification.fromMarker, selector: subSurface.metadata.cssSelector },\n        })\n        return []\n    }\n\n    let elementCounter = 0\n    let rangeIndex = -1\n    const states: ReplacementState[] = []\n    const getCurrentState = () => {\n        const state = states[states.length - 1]\n        if (!state) {\n            logger.log({\n                level: 'warn',\n                code: 'replacement-state-missing',\n                message: 'Range replacement handler invoked with no active replacement state; skipping.',\n                context: { selector: subSurface.metadata.cssSelector },\n            })\n            return\n        }\n        return state\n    }\n\n    const onChildElement = (element: RewriterElement) => {\n        elementCounter++\n        if (element.removed) {\n            return\n        }\n\n        const state = getCurrentState()\n        const range = ranges[rangeIndex]\n        const marker = range?.markers[elementCounter]\n\n        if (state?.operation === 'SCANNING') {\n            if (marker?.startMarker) {\n                for (const after of (modification.replaceWith ?? []).slice().reverse()) {\n                    const [content, options] = renderElement(ctx, after)\n                    element.after(content, options)\n                }\n                if (element.onEndTag) {\n                    try {\n                        element.onEndTag(() => {\n                            state.operation = 'REMOVING'\n                        })\n                    } catch {\n                        state.operation = 'REMOVING'\n                    }\n                } else {\n                    state.operation = 'REMOVING'\n                }\n            }\n            return\n        }\n\n        if (state?.operation === 'REMOVING') {\n            if (marker?.endMarker) {\n                state.operation = 'REPLACED'\n                return\n            }\n\n            if (marker?.endTag !== elementCounter && marker?.nextEndMarker && marker?.endTag && marker.endTag >= marker.nextEndMarker) {\n                return\n            }\n\n            element.remove()\n            return\n        }\n    }\n\n    const parentHandler: ElementHandlers = {\n        element(element: RewriterElement) {\n            rangeIndex++\n            if (element.removed) {\n                return\n            }\n\n            const state: ReplacementState = { operation: modification.fromMarker ? 'SCANNING' : 'REMOVING' }\n            states.push(state)\n\n            if (state.operation === 'REMOVING') {\n                for (const prepend of (modification.replaceWith ?? []).slice().reverse()) {\n                    const [content, options] = renderElement(ctx, prepend)\n                    element.prepend(content, options)\n                }\n            }\n\n            if (element.onEndTag) {\n                element.onEndTag(() => {\n                    states.pop()\n                })\n            }\n        },\n\n        text: (text: RewriterText) => {\n            const state = getCurrentState()\n            if (state?.operation === 'REMOVING') {\n                text.remove()\n            }\n        },\n    }\n\n    const selector = subSurface.metadata.cssSelector\n    if (!selector) {\n        return []\n    }\n    return [\n        { selector, handler: parentHandler },\n        { selector: `${selector} *`, handler: { element: onChildElement } },\n    ]\n}\n"]}

package/dist/stages/customEndpoint.d.ts

@@ -0,0 +1,3 @@
+import type { Fetcher } from '../adapters/Fetcher';
+import type { PipelineContext } from '../context';
+export default function customEndpointRequest(ctx: PipelineContext, request: Request, apiFetcher: Fetcher): Promise<Response | null>;

package/dist/stages/customEndpoint.js

@@ -0,0 +1,18 @@
+import { setMosProxyVersionHeader } from '../apiRequestHeaders';
+export default async function customEndpointRequest(ctx, request, apiFetcher) {
+    const { config } = ctx;
+    const requestUrl = new URL(request.url);
+    const prefix = config.mosEndpointsPrefix;
+    if (!requestUrl.pathname.startsWith(prefix)) {
+        return null;
+    }
+    const target = new URL(request.url);
+    target.protocol = config.mosHost.protocol;
+    target.host = config.mosHost.host;
+    target.port = config.mosHost.port;
+    target.pathname = `/api/v1/envs/${config.mosEnvironment}/endpoints/${requestUrl.pathname.slice(prefix.length).replace(/^\//, '')}`;
+    const apiRequest = new Request(target, request);
+    setMosProxyVersionHeader(apiRequest.headers);
+    return apiFetcher(apiRequest);
+}
+//# sourceMappingURL=customEndpoint.js.map

package/dist/stages/customEndpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customEndpoint.js","sourceRoot":"","sources":["../../src/stages/customEndpoint.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAG/D,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAoB,EAAE,OAAgB,EAAE,UAAmB;IAC3G,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAA;IACtB,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,kBAAkB,CAAA;IAExC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAA;IACf,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACnC,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAA;IACzC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAA;IACjC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAA;IACjC,MAAM,CAAC,QAAQ,GAAG,gBAAgB,MAAM,CAAC,cAAc,cAAc,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAA;IAElI,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/C,wBAAwB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;IAC5C,OAAO,UAAU,CAAC,UAAU,CAAC,CAAA;AACjC,CAAC","sourcesContent":["import type { Fetcher } from '../adapters/Fetcher'\nimport { setMosProxyVersionHeader } from '../apiRequestHeaders'\nimport type { PipelineContext } from '../context'\n\nexport default async function customEndpointRequest(ctx: PipelineContext, request: Request, apiFetcher: Fetcher): Promise<Response | null> {\n    const { config } = ctx\n    const requestUrl = new URL(request.url)\n    const prefix = config.mosEndpointsPrefix\n\n    if (!requestUrl.pathname.startsWith(prefix)) {\n        return null\n    }\n\n    const target = new URL(request.url)\n    target.protocol = config.mosHost.protocol\n    target.host = config.mosHost.host\n    target.port = config.mosHost.port\n    target.pathname = `/api/v1/envs/${config.mosEnvironment}/endpoints/${requestUrl.pathname.slice(prefix.length).replace(/^\\//, '')}`\n\n    const apiRequest = new Request(target, request)\n    setMosProxyVersionHeader(apiRequest.headers)\n    return apiFetcher(apiRequest)\n}\n"]}

package/dist/stages/elements.d.ts

@@ -0,0 +1,5 @@
+import type { ContentOptions } from '../adapters/HtmlRewriterAdapter';
+import type { PipelineContext } from '../context';
+import type { WebComponentElement, WebElement } from '../types';
+export declare const renderElement: (ctx: PipelineContext, element: WebElement) => [string, ContentOptions];
+export declare const renderComponentElement: (component: WebComponentElement) => string;

package/dist/stages/elements.js

@@ -0,0 +1,42 @@
+export const renderElement = (ctx, element) => {
+    try {
+        const mapped = {
+            ...element,
+            type: element.type?.toLowerCase(),
+        };
+        if (mapped.type === 'html') {
+            return [mapped.content, { html: true }];
+        }
+        if (mapped.type === 'text') {
+            return [mapped.content, { html: false }];
+        }
+        if (mapped.type === 'element') {
+            return [renderComponentElement(mapped), { html: true }];
+        }
+    }
+    catch (error) {
+        ctx.logger.log({
+            level: 'error',
+            code: 'element-render-failed',
+            message: 'Failed to render element; substituting empty content.',
+            context: { type: element.type },
+            error,
+        });
+        return ['', { html: false }];
+    }
+    ctx.logger.log({
+        level: 'warn',
+        code: 'element-type-unsupported',
+        message: 'Unsupported element type; substituting empty content.',
+        context: { type: element.type },
+    });
+    return ['', { html: false }];
+};
+export const renderComponentElement = (component) => {
+    const [schemaSource, versionedSchemaId] = component.schema.split(':');
+    const [schemaId, schemaVersion] = versionedSchemaId?.split('@') ?? [];
+    const webComponentTag = `${schemaSource}-${schemaId}`;
+    const escapedPropsAttribute = JSON.stringify(component.props).replace(/"/g, '"');
+    return `<${webComponentTag} version="${schemaVersion ?? ''}" props="${escapedPropsAttribute}"></${webComponentTag}>`;
+};
+//# sourceMappingURL=elements.js.map

package/dist/stages/elements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elements.js","sourceRoot":"","sources":["../../src/stages/elements.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAoB,EAAE,OAAmB,EAA4B,EAAE;IACjG,IAAI,CAAC;QACD,MAAM,MAAM,GAAG;YACX,GAAG,OAAO;YACV,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE;SACtB,CAAA;QAEf,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAC3C,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAC5C,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAC3D,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;YACX,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,uDAAuD;YAChE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;YAC/B,KAAK;SACR,CAAC,CAAA;QACF,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAChC,CAAC;IAED,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;QACX,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,uDAAuD;QAChE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;KAClC,CAAC,CAAA;IACF,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;AAChC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,SAA8B,EAAU,EAAE;IAC7E,MAAM,CAAC,YAAY,EAAE,iBAAiB,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACrE,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,iBAAiB,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;IACrE,MAAM,eAAe,GAAG,GAAG,YAAY,IAAI,QAAQ,EAAE,CAAA;IACrD,MAAM,qBAAqB,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAErF,OAAO,IAAI,eAAe,aAAa,aAAa,IAAI,EAAE,YAAY,qBAAqB,OAAO,eAAe,GAAG,CAAA;AACxH,CAAC,CAAA","sourcesContent":["import type { ContentOptions } from '../adapters/HtmlRewriterAdapter'\nimport type { PipelineContext } from '../context'\nimport type { WebComponentElement, WebElement } from '../types'\n\nexport const renderElement = (ctx: PipelineContext, element: WebElement): [string, ContentOptions] => {\n    try {\n        const mapped = {\n            ...element,\n            type: element.type?.toLowerCase(),\n        } as WebElement\n\n        if (mapped.type === 'html') {\n            return [mapped.content, { html: true }]\n        }\n\n        if (mapped.type === 'text') {\n            return [mapped.content, { html: false }]\n        }\n\n        if (mapped.type === 'element') {\n            return [renderComponentElement(mapped), { html: true }]\n        }\n    } catch (error) {\n        ctx.logger.log({\n            level: 'error',\n            code: 'element-render-failed',\n            message: 'Failed to render element; substituting empty content.',\n            context: { type: element.type },\n            error,\n        })\n        return ['', { html: false }]\n    }\n\n    ctx.logger.log({\n        level: 'warn',\n        code: 'element-type-unsupported',\n        message: 'Unsupported element type; substituting empty content.',\n        context: { type: element.type },\n    })\n    return ['', { html: false }]\n}\n\nexport const renderComponentElement = (component: WebComponentElement): string => {\n    const [schemaSource, versionedSchemaId] = component.schema.split(':')\n    const [schemaId, schemaVersion] = versionedSchemaId?.split('@') ?? []\n    const webComponentTag = `${schemaSource}-${schemaId}`\n    const escapedPropsAttribute = JSON.stringify(component.props).replace(/\"/g, '&quot;')\n\n    return `<${webComponentTag} version=\"${schemaVersion ?? ''}\" props=\"${escapedPropsAttribute}\"></${webComponentTag}>`\n}\n"]}

package/dist/stages/fetchSurfaceDecisions.d.ts

@@ -0,0 +1,25 @@
+import type { Fetcher } from '../adapters/Fetcher';
+import type { PipelineContext } from '../context';
+import type { PageMetadata, SurfaceDecisionResponse } from '../types';
+export type FetchSurfaceDecisionsArgs = {
+    anonymousIdentifier?: string | undefined;
+    userJwt?: string | undefined;
+    path: string;
+    url: string;
+    clientMetadata: Record<string, unknown>;
+    pageMetadata?: PageMetadata;
+    userAgent?: string | undefined;
+    originStatus: number;
+};
+export type FetchSurfaceDecisionsFailureReason = 'request-failed' | 'invalid-json' | 'api-error' | 'http-error' | 'invalid-response';
+export type FetchSurfaceDecisionsResult = {
+    ok: true;
+    data: SurfaceDecisionResponse;
+} | {
+    ok: false;
+    reason: FetchSurfaceDecisionsFailureReason;
+    error: unknown;
+    status?: number;
+    statusCode?: number;
+};
+export default function fetchSurfaceDecisions(ctx: PipelineContext, { anonymousIdentifier, userJwt, path, url, clientMetadata, pageMetadata, userAgent, originStatus }: FetchSurfaceDecisionsArgs, apiFetcher: Fetcher): Promise<FetchSurfaceDecisionsResult>;

package/dist/stages/fetchSurfaceDecisions.js

@@ -0,0 +1,86 @@
+import { withMosProxyVersionHeader } from '../apiRequestHeaders';
+export default async function fetchSurfaceDecisions(ctx, { anonymousIdentifier, userJwt, path, url, clientMetadata, pageMetadata, userAgent, originStatus }, apiFetcher) {
+    const { config } = ctx;
+    const body = JSON.stringify({
+        surfaceSlug: config.surfaceSlug,
+        identity: buildIdentity({ anonymousIdentifier, userJwt }),
+        resource: {
+            id: path,
+            meta: pageMetadata,
+        },
+        http: {
+            url,
+            userAgent,
+            proxyOrigin: {
+                status: originStatus,
+            },
+        },
+        // Legacy field name kept to avoid breaking the API schema; opaque to the proxy core.
+        cloudflare: clientMetadata,
+    });
+    const request = new Request(new URL('/api/v1/surface-decisions', config.mosHost), {
+        method: 'POST',
+        body,
+        headers: withMosProxyVersionHeader({
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${config.mosSecretKey}`,
+        }),
+    });
+    let response;
+    try {
+        response = await apiFetcher(request);
+    }
+    catch (error) {
+        return { ok: false, reason: 'request-failed', error };
+    }
+    let data;
+    try {
+        data = await response.json();
+    }
+    catch (error) {
+        return { ok: false, reason: 'invalid-json', error, status: response.status };
+    }
+    if (isSurfaceDecisionError(data)) {
+        return {
+            ok: false,
+            reason: 'api-error',
+            error: new Error(data.message),
+            status: response.status,
+            statusCode: data.statusCode,
+        };
+    }
+    if (!response.ok) {
+        return {
+            ok: false,
+            reason: 'http-error',
+            error: new Error(`Surface decisions API returned HTTP ${response.status}`),
+            status: response.status,
+        };
+    }
+    if (!isSurfaceDecisionResponse(data)) {
+        return {
+            ok: false,
+            reason: 'invalid-response',
+            error: new Error('Surface decisions API returned an invalid response shape'),
+            status: response.status,
+        };
+    }
+    return { ok: true, data };
+}
+const isRecord = (value) => typeof value === 'object' && value !== null;
+const buildIdentity = ({ anonymousIdentifier, userJwt }) => {
+    if (!anonymousIdentifier && !userJwt) {
+        return { createAnonymousIdentifier: true };
+    }
+    return userJwt ? { userJwt } : { anonymousIdentifier };
+};
+const isSurfaceDecisionError = (value) => isRecord(value) && value.status === 'error' && typeof value.message === 'string' && typeof value.statusCode === 'number';
+const isSurfaceDecisionResponse = (value) => isRecord(value) &&
+    value.status === 'success' &&
+    isRecord(value.identity) &&
+    isRecord(value.features) &&
+    isRecord(value.customer) &&
+    isRecord(value.surfaceBehavior) &&
+    typeof value.componentsSkipped === 'boolean' &&
+    isRecord(value.componentBehaviors);
+//# sourceMappingURL=fetchSurfaceDecisions.js.map