@pie-players/pie-players-shared 0.3.30 → 0.3.31

package/dist/loaders/esm-adapter.js

@@ -0,0 +1,274 @@
+/**
+ * ESM backend adapter for the ElementLoader primitive.
+ *
+ * Loads PIE elements via dynamic `import()` from an ESM CDN (esm.sh,
+ * jsDelivr, etc.), optionally resolving bare specifiers through an
+ * `<script type="importmap">` injected into the host document. On any
+ * per-tag failure (module load, non-constructor element class, define
+ * failure), throws `AdapterFailure` with a structured `reasons` map.
+ *
+ * Like the IIFE adapter, this module does not gate its own promise on
+ * `customElements.whenDefined`; the primitive performs that verification
+ * uniformly. Here the adapter's job is narrowly to fetch, extract, and
+ * call `customElements.define`.
+ */
+import { defineCustomElementSafely } from "../pie/custom-element-define.js";
+import { pieRegistry } from "../pie/registry.js";
+import { validateCustomElementTag } from "../pie/tag-names.js";
+import { isCustomElementConstructor, Status } from "../pie/types.js";
+import { AdapterFailure, } from "./element-loader-types.js";
+export const BUILT_IN_VIEWS = {
+    delivery: { subpath: "", tagSuffix: "" },
+    author: { subpath: "/author", tagSuffix: "-config", fallback: "delivery" },
+    print: { subpath: "/print", tagSuffix: "-print", fallback: "delivery" },
+};
+export function createEsmBackend(config) {
+    const cdnBaseUrl = config.cdnBaseUrl.replace(/\/+$/, "");
+    const moduleResolution = config.moduleResolution ?? "url";
+    const view = config.view ?? "delivery";
+    const loadControllers = config.loadControllers ?? true;
+    const viewConfig = config.viewConfig ??
+        BUILT_IN_VIEWS[view] ??
+        BUILT_IN_VIEWS.delivery;
+    const injectedPackages = new Set();
+    let importer = defaultImporter;
+    let importMapObserver;
+    const __seams = {
+        replaceImporter(fn) {
+            importer = fn;
+        },
+        observeImportMapInjection(cb) {
+            importMapObserver = cb;
+        },
+        restore() {
+            importer = defaultImporter;
+            importMapObserver = undefined;
+            injectedPackages.clear();
+        },
+    };
+    async function load(elements, context) {
+        if (!elements || Object.keys(elements).length === 0)
+            return;
+        if (moduleResolution === "import-map") {
+            assertImportMapSupported();
+            const newEntries = {};
+            for (const [tag, pkg] of Object.entries(elements)) {
+                const packageName = extractPackageName(pkg);
+                if (!injectedPackages.has(packageName)) {
+                    newEntries[tag] = pkg;
+                    injectedPackages.add(packageName);
+                }
+            }
+            if (Object.keys(newEntries).length > 0) {
+                const json = buildImportMapJson(newEntries, viewConfig, cdnBaseUrl, loadControllers);
+                injectImportMap(json, context.doc);
+                importMapObserver?.(json, context.doc);
+            }
+        }
+        const reasons = new Map();
+        const registry = pieRegistry();
+        await Promise.all(Object.entries(elements).map(async ([tag, packageVersion]) => {
+            const packageName = extractPackageName(packageVersion);
+            let actualTag;
+            try {
+                actualTag = validateCustomElementTag(`${tag}${viewConfig.tagSuffix}`, `element tag for ${packageName}`);
+            }
+            catch (err) {
+                reasons.set(tag, {
+                    kind: "define-failed",
+                    tag,
+                    cause: err instanceof Error ? err.message : String(err),
+                });
+                return;
+            }
+            const specifier = resolveElementSpecifier(packageName, packageVersion, viewConfig, moduleResolution, cdnBaseUrl);
+            let module;
+            try {
+                module = await importer(specifier);
+            }
+            catch (err) {
+                if (viewConfig.fallback) {
+                    const fallbackConfig = BUILT_IN_VIEWS[viewConfig.fallback] ?? BUILT_IN_VIEWS.delivery;
+                    const fallbackSpecifier = resolveElementSpecifier(packageName, packageVersion, fallbackConfig, moduleResolution, cdnBaseUrl);
+                    try {
+                        module = await importer(fallbackSpecifier);
+                    }
+                    catch (fallbackErr) {
+                        reasons.set(tag, {
+                            kind: "module-load-failed",
+                            tag,
+                            specifier: fallbackSpecifier,
+                            cause: fallbackErr instanceof Error
+                                ? fallbackErr.message
+                                : String(fallbackErr),
+                        });
+                        return;
+                    }
+                }
+                else {
+                    reasons.set(tag, {
+                        kind: "module-load-failed",
+                        tag,
+                        specifier,
+                        cause: err instanceof Error ? err.message : String(err),
+                    });
+                    return;
+                }
+            }
+            const ElementClass = pickElementClass(module, view);
+            if (!ElementClass) {
+                reasons.set(tag, {
+                    kind: "no-element-class",
+                    tag,
+                    packageName,
+                });
+                return;
+            }
+            if (!isCustomElementConstructor(ElementClass)) {
+                reasons.set(tag, {
+                    kind: "not-a-constructor",
+                    tag,
+                    packageName,
+                });
+                return;
+            }
+            try {
+                defineCustomElementSafely(actualTag, class extends ElementClass {
+                }, `element tag for ${packageName}`);
+            }
+            catch (err) {
+                reasons.set(tag, {
+                    kind: "define-failed",
+                    tag,
+                    cause: err instanceof Error ? err.message : String(err),
+                });
+                return;
+            }
+            let controller = null;
+            if (loadControllers) {
+                const controllerSpecifier = resolveControllerSpecifier(packageName, packageVersion, moduleResolution, cdnBaseUrl);
+                try {
+                    const controllerModule = await importer(controllerSpecifier);
+                    controller = controllerModule?.default ?? controllerModule;
+                }
+                catch {
+                    // Controllers are best-effort; element registration is what the
+                    // primitive verifies.
+                }
+            }
+            registry[actualTag] = {
+                package: packageVersion,
+                status: Status.loaded,
+                tagName: actualTag,
+                element: ElementClass,
+                controller,
+                config: null,
+                bundleType: "esm",
+            };
+        }));
+        if (reasons.size > 0) {
+            throw new AdapterFailure(reasons);
+        }
+    }
+    return {
+        load,
+        get __seams() {
+            return __seams;
+        },
+    };
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function defaultImporter(specifier) {
+    // @vite-ignore — dynamic import resolved at runtime.
+    return import(/* @vite-ignore */ specifier);
+}
+function extractPackageName(packageVersion) {
+    const parts = packageVersion.split("@");
+    return parts.length >= 3 ? `@${parts[1]}` : parts[0];
+}
+function isJsDelivrNpm(cdnBaseUrl) {
+    return cdnBaseUrl.includes("cdn.jsdelivr.net/npm");
+}
+function resolvePackageUrl(packageVersion, cdnBaseUrl) {
+    if (isJsDelivrNpm(cdnBaseUrl)) {
+        return `${cdnBaseUrl}/${packageVersion}/+esm`;
+    }
+    return `${cdnBaseUrl}/${packageVersion}`;
+}
+function resolveSubpathUrl(packageVersion, subpath, cdnBaseUrl) {
+    const cleanSubpath = subpath.startsWith("/") ? subpath.slice(1) : subpath;
+    if (isJsDelivrNpm(cdnBaseUrl)) {
+        return `${cdnBaseUrl}/${packageVersion}/${cleanSubpath}/+esm`;
+    }
+    return `${cdnBaseUrl}/${packageVersion}/${cleanSubpath}`;
+}
+function resolveControllerUrl(packageVersion, cdnBaseUrl) {
+    if (isJsDelivrNpm(cdnBaseUrl)) {
+        return `${cdnBaseUrl}/${packageVersion}/controller/+esm`;
+    }
+    return `${cdnBaseUrl}/${packageVersion}/controller`;
+}
+function resolveElementSpecifier(packageName, packageVersion, viewConfig, moduleResolution, cdnBaseUrl) {
+    if (moduleResolution === "import-map") {
+        return viewConfig.subpath
+            ? `${packageName}${viewConfig.subpath}`
+            : packageName;
+    }
+    return viewConfig.subpath
+        ? resolveSubpathUrl(packageVersion, viewConfig.subpath, cdnBaseUrl)
+        : resolvePackageUrl(packageVersion, cdnBaseUrl);
+}
+function resolveControllerSpecifier(packageName, packageVersion, moduleResolution, cdnBaseUrl) {
+    if (moduleResolution === "import-map") {
+        return `${packageName}/controller`;
+    }
+    return resolveControllerUrl(packageVersion, cdnBaseUrl);
+}
+function pickElementClass(module, view) {
+    if (!module || typeof module !== "object")
+        return undefined;
+    if (view === "author") {
+        return module.default ?? module.Configure ?? module.Element;
+    }
+    if (view === "print") {
+        return module.default ?? module.Print ?? module.Element;
+    }
+    return module.default ?? module.Element;
+}
+function buildImportMapJson(elements, viewConfig, cdnBaseUrl, loadControllers) {
+    const imports = {};
+    for (const [, pkg] of Object.entries(elements)) {
+        const packageName = extractPackageName(pkg);
+        imports[packageName] = resolvePackageUrl(pkg, cdnBaseUrl);
+        if (viewConfig.subpath) {
+            imports[`${packageName}${viewConfig.subpath}`] = resolveSubpathUrl(pkg, viewConfig.subpath, cdnBaseUrl);
+        }
+        if (loadControllers) {
+            imports[`${packageName}/controller`] = resolveControllerUrl(pkg, cdnBaseUrl);
+        }
+        if (viewConfig.fallback) {
+            const fallbackConfig = BUILT_IN_VIEWS[viewConfig.fallback];
+            if (fallbackConfig?.subpath) {
+                imports[`${packageName}${fallbackConfig.subpath}`] = resolveSubpathUrl(pkg, fallbackConfig.subpath, cdnBaseUrl);
+            }
+        }
+    }
+    return JSON.stringify({ imports }, null, 2);
+}
+function injectImportMap(json, doc) {
+    const script = doc.createElement("script");
+    script.type = "importmap";
+    script.textContent = json;
+    doc.head.appendChild(script);
+}
+function assertImportMapSupported() {
+    const htmlScriptElement = (typeof HTMLScriptElement !== "undefined"
+        ? HTMLScriptElement
+        : undefined);
+    const supports = typeof htmlScriptElement?.supports === "function" &&
+        htmlScriptElement.supports("importmap");
+    if (!supports) {
+        throw new Error('This browser does not support import maps. Use moduleResolution="url" or switch to iife/preloaded strategy.');
+    }
+}
+//# sourceMappingURL=esm-adapter.js.map

package/dist/loaders/esm-adapter.js.map

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

package/dist/loaders/iife-adapter.d.ts

@@ -0,0 +1,86 @@
+/**
+ * IIFE backend adapter for the ElementLoader primitive.
+ *
+ * Loads PIE elements from IIFE bundles served by the PIE build service,
+ * then registers them with `customElements`. On any per-tag failure
+ * (missing package, non-constructor element class, define failure),
+ * throws `AdapterFailure` with a structured `reasons` map that the
+ * primitive unpacks into `ElementLoaderError.reasons`.
+ *
+ * This adapter deliberately does *not* gate its own promise on
+ * `customElements.whenDefined` — the primitive performs that verification
+ * uniformly for every backend, so the adapter's job is narrowly:
+ *
+ *   1. Fetch the bundle.
+ *   2. Extract per-tag element classes from `window.pie.default`.
+ *   3. Validate each class is a custom-element constructor.
+ *   4. Call `customElements.define` via `defineCustomElementSafely`.
+ *   5. Collect structured per-tag reasons for anything that failed.
+ *   6. Resolve (everything OK) or throw `AdapterFailure` (anything failed).
+ */
+import type { InstrumentationProvider } from "../instrumentation/types.js";
+import { type IifeBundleRetryConfig } from "../loader-config.js";
+import { BundleType } from "../pie/types.js";
+import { type ElementLoaderBackend } from "./element-loader-types.js";
+/**
+ * Default PIE bundle service base URL. Exported so widgets can use it as
+ * the fallback when the host does not supply `loaderOptions.bundleHost`.
+ */
+export declare const DEFAULT_BUNDLE_HOST = "https://proxy.pie-api.com/bundles/";
+/**
+ * Bundle-build retry status emitted while a bundle is being built or after
+ * it completes. Hosts that display a "bundle is building…" UI subscribe via
+ * `onBundleRetryStatus` and read each transition.
+ */
+export type IifeBundleRetryStatus = {
+    state: "retrying" | "completed" | "timeout" | "cancelled";
+    url: string;
+    attempt: number;
+    elapsedMs: number;
+    timeoutMs: number;
+    retryDelayMs?: number;
+    reason?: string;
+};
+export type IifeBackendConfig = {
+    kind: "iife";
+    /** Base URL for the PIE bundle service. */
+    bundleHost: string;
+    /** Bundle variant to request (player / client-player / editor). */
+    bundleType?: BundleType;
+    /** Whether the registered entries should carry their controller exports. */
+    needsControllers?: boolean;
+    /** Explicit bundle override (hash + optional URL) supplied by the host. */
+    bundleInfo?: {
+        hash?: string;
+        url?: string;
+    };
+    /** Debug flag hook. */
+    debugEnabled?: () => boolean;
+    /**
+     * Retry policy for transient bundle load failures.
+     *
+     * When the bundle service is building a bundle on demand, the first
+     * few `<script src>` requests can fail. This policy polls until the
+     * bundle is available or `timeoutMs` elapses. Default matches
+     * `DEFAULT_IIFE_BUNDLE_RETRY_CONFIG`.
+     */
+    bundleRetry?: IifeBundleRetryConfig;
+    /**
+     * Callback invoked with retry status transitions. Lets hosts render
+     * "bundle still building, retrying in Ns" messaging without touching
+     * internal adapter state.
+     */
+    onBundleRetryStatus?: (status: IifeBundleRetryStatus) => void;
+    /**
+     * If true and `instrumentationProvider` is set and ready, retry
+     * lifecycle events (`pie-iife-bundle-retry*`) are emitted.
+     */
+    trackPageActions?: boolean;
+    /**
+     * Instrumentation provider used to emit retry lifecycle telemetry.
+     */
+    instrumentationProvider?: InstrumentationProvider;
+};
+export type IifeBackend = ElementLoaderBackend & {};
+export declare function createIifeBackend(config: IifeBackendConfig): IifeBackend;
+//# sourceMappingURL=iife-adapter.d.ts.map

package/dist/loaders/iife-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iife-adapter.d.ts","sourceRoot":"","sources":["../../src/loaders/iife-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAE3E,OAAO,EAEN,KAAK,qBAAqB,EAC1B,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACN,UAAU,EAGV,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAGN,KAAK,oBAAoB,EAGzB,MAAM,2BAA2B,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,uCAAuC,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IACnC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,CAAC;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2EAA2E;IAC3E,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,uBAAuB;IACvB,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;IAC7B;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC9D;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;CAClD,CAAC;AA2BF,MAAM,MAAM,WAAW,GAAG,oBAAoB,GAAG,EAGhD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAmSxE"}