@enquio/popup-core 1.0.2 → 1.2.0

package/README.md

@@ -0,0 +1,55 @@
+# @enquio/popup-core
+
+See the [installation prerequisites](../../docs/installation.md), [support matrix](../../docs/support-matrix.md) and [troubleshooting](../../docs/troubleshooting.md). Registry commands assume a matching published release; local verification uses tarballs and does not establish npm/CDN availability.
+
+Shared browser loader used by the React, Vue and Angular popup wrappers.
+
+```sh
+npm install @enquio/popup-core
+```
+
+The package provides native ESM (`dist/index.mjs`) and CommonJS (`dist/index.js`) entrypoints with matching TypeScript declarations selected through conditional exports. Import from `@enquio/popup-core`; both formats share the same per-window loader state.
+
+<!-- example:core -->
+
+```ts
+import { loadEnquioScript } from '@enquio/popup-core';
+
+try {
+	await loadEnquioScript();
+	// Renderer initialization has completed and enquio-popup is registered.
+} catch {
+	// Enquio already emitted a console diagnostic. Leave the host website usable.
+}
+```
+
+## Readiness
+
+The returned `Promise<void>` represents renderer readiness, not just the `popup.js` load event. It does not wait for a project's rules, form data or display trigger. The core does not create the popup element itself; framework wrappers own their element and the HTML snippet supports its existing `data-enquio-popup` auto-mount behavior.
+
+Concurrent calls share an attempt across package copies in the same window. No browser APIs are accessed on SSR: the resolved server-side result is a no-op, not a browser readiness guarantee.
+
+## Quiet failures and explicit retry
+
+Each caller waits up to 30 seconds. The core emits at most one `Enquio:` console warning per shared attempt and rejects the promise. Supplied wrappers catch it without error UI. Custom consumers must also catch rejection. Native browser network/script diagnostics are not suppressed.
+
+A timeout does not cancel the underlying script or Angular startup. Late completion is allowed; another call joins the pending operation and gets a fresh observation window without downloading another copy. The bootstrap dispatches `enquio:ready` once on eventual success.
+
+After a confirmed network failure, a subsequent explicit `loadEnquioScript()` call retries the failed resource. There is no automatic retry loop. Successful/pending modules are reused. Execution or Angular initialization errors are terminal until reload; the loader does not start another Angular runtime.
+
+An existing script with no observed load/error event and no initialized controller cannot safely be classified as failed. It times out rather than being removed speculatively. If it is known to have failed before the core attached, explicitly replace it or reload the page.
+
+## CSP and consent
+
+`loadEnquioScript({ nonce: responseNonce })` supplies the host's CSP nonce before the first load. Without options, the loader discovers the first `script[nonce]`. No-argument calls remain supported. Nonce is propagated to the popup script, renderer modules and Angular styles, including a replacement script after a transport failure.
+
+Importing the package alone makes no requests. Call the loader or mount a wrapper only after the host's consent decision. The first connected popup host owns the session; later hosts stay inactive and conflicting projects are reported. Removing the owner does not automatically activate an ignored host. See [the GC-007 contract](../../../EnquioClient/docs/integrations/embed-compatibility.md) for the tested CSP example, revocation limits, mixed integrations and safe layout placement.
+
+## Tests and coordinated release
+
+- `npm run test:loader` from the workspace root checks SSR core loading and the Angular wrapper lifecycle with decorator stubs. It is not a full Angular SSR/hydration test.
+- `npm run build` builds the workspace packages.
+- `npm run test:react-package` verifies packed core and React artifacts in isolated ESM/CommonJS and TypeScript consumers, plus three-engine lifecycle tests across React 17–19.
+- The companion EnquioClient checkout owns the cross-repository browser suite: `npm run test:bootstrap`. It builds the production renderer and tests Chromium, Firefox and WebKit using intercepted API responses. Set `ENQUIO_WRAPPERS_PATH` there if this checkout is not its sibling.
+
+The private bootstrap window contract is mirrored between this loader and `EnquioClient/common/runtime/bootstrap.ts`; it is not public API. Release the public popup and renderer files together, then the coordinated wrappers. No version detection or legacy fallback is implemented. See GC-001 and EnquioClient's popup-embed documentation for detailed behavior and deployment boundaries.

package/dist/index.d.mts

@@ -0,0 +1,29 @@
+interface LoadEnquioOptions {
+    nonce?: string;
+}
+interface LoadContext {
+    reported: boolean;
+}
+interface PopupBootstrap {
+    context: LoadContext;
+    current?: Promise<void>;
+    load(context?: LoadContext): Promise<void>;
+}
+interface ScriptLoad {
+    context: LoadContext;
+    task?: Promise<void>;
+    wait?: Promise<void>;
+    failedScript?: HTMLScriptElement;
+}
+declare global {
+    interface Window {
+        __ENQUIO_NONCE__?: string;
+        __ENQUIO_POPUP_BOOTSTRAP__?: PopupBootstrap;
+        __ENQUIO_LOAD_CONTEXT__?: LoadContext;
+        __ENQUIO_SCRIPT_LOAD__?: ScriptLoad;
+        __ENQUIO_RENDERER_BOOTSTRAP__?: Promise<void>;
+    }
+}
+declare function loadEnquioScript(options?: LoadEnquioOptions): Promise<void>;
+
+export { type LoadEnquioOptions, loadEnquioScript };

package/dist/index.d.ts

@@ -1 +1,29 @@
-export * from './loader';
+interface LoadEnquioOptions {
+    nonce?: string;
+}
+interface LoadContext {
+    reported: boolean;
+}
+interface PopupBootstrap {
+    context: LoadContext;
+    current?: Promise<void>;
+    load(context?: LoadContext): Promise<void>;
+}
+interface ScriptLoad {
+    context: LoadContext;
+    task?: Promise<void>;
+    wait?: Promise<void>;
+    failedScript?: HTMLScriptElement;
+}
+declare global {
+    interface Window {
+        __ENQUIO_NONCE__?: string;
+        __ENQUIO_POPUP_BOOTSTRAP__?: PopupBootstrap;
+        __ENQUIO_LOAD_CONTEXT__?: LoadContext;
+        __ENQUIO_SCRIPT_LOAD__?: ScriptLoad;
+        __ENQUIO_RENDERER_BOOTSTRAP__?: Promise<void>;
+    }
+}
+declare function loadEnquioScript(options?: LoadEnquioOptions): Promise<void>;
+
+export { type LoadEnquioOptions, loadEnquioScript };

package/dist/index.js

@@ -1 +1,144 @@
-export * from './loader';
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  loadEnquioScript: () => loadEnquioScript
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/loader.ts
+var SCRIPT_URL = "https://public.newapp.enquio.eu/popup.js";
+var SCRIPT_ID = "enquio-popup-script";
+var LOAD_TIMEOUT = 3e4;
+var ScriptLoadError = class extends Error {
+  constructor(message, retryable = false) {
+    super(message);
+    this.retryable = retryable;
+  }
+};
+function report(state, error) {
+  if (state.context.reported) return;
+  state.context.reported = true;
+  console.warn("Enquio:", error instanceof Error ? error.message : String(error));
+}
+function loadPopupScript(state) {
+  if (window.__ENQUIO_POPUP_BOOTSTRAP__) return Promise.resolve();
+  return new Promise((resolve, reject) => {
+    var _a;
+    const existing = document.getElementById(SCRIPT_ID);
+    let script;
+    let insert = false;
+    if (existing && !(existing instanceof HTMLScriptElement)) {
+      reject(new Error("[script] enquio-popup-script is not a script element."));
+      return;
+    }
+    if (existing && existing !== state.failedScript) {
+      script = existing;
+    } else {
+      script = document.createElement("script");
+      if (existing) {
+        for (const attribute of Array.from(existing.attributes)) script.setAttribute(attribute.name, attribute.value);
+      }
+      script.nonce = (existing == null ? void 0 : existing.nonce) || window.__ENQUIO_NONCE__ || "";
+      script.src = SCRIPT_URL;
+      script.id = SCRIPT_ID;
+      script.async = true;
+      existing == null ? void 0 : existing.remove();
+      state.failedScript = void 0;
+      insert = true;
+    }
+    const cleanup = () => {
+      script.removeEventListener("load", loaded);
+      script.removeEventListener("error", failed);
+      window.removeEventListener("enquio:ready", ready);
+    };
+    const loaded = () => {
+      cleanup();
+      resolve();
+    };
+    const failed = () => {
+      cleanup();
+      state.failedScript = script;
+      reject(new ScriptLoadError("[script] Could not load popup.js.", true));
+    };
+    const ready = () => {
+      if (window.__ENQUIO_POPUP_BOOTSTRAP__) loaded();
+    };
+    script.addEventListener("load", loaded);
+    script.addEventListener("error", failed);
+    window.addEventListener("enquio:ready", ready);
+    window.__ENQUIO_LOAD_CONTEXT__ = state.context;
+    if (insert) ((_a = document.head) != null ? _a : document.documentElement).appendChild(script);
+  });
+}
+function loadEnquioScript(options = {}) {
+  var _a, _b, _c, _d;
+  if (typeof window === "undefined") return Promise.resolve();
+  (_c = window.__ENQUIO_NONCE__) != null ? _c : window.__ENQUIO_NONCE__ = (_b = options.nonce) != null ? _b : (_a = document.querySelector("script[nonce]")) == null ? void 0 : _a.nonce;
+  const state = (_d = window.__ENQUIO_SCRIPT_LOAD__) != null ? _d : window.__ENQUIO_SCRIPT_LOAD__ = { context: { reported: false } };
+  if (!state.task) {
+    state.context = { reported: false };
+    state.task = Promise.resolve().then(async () => {
+      const existingController = window.__ENQUIO_POPUP_BOOTSTRAP__;
+      if (!existingController && customElements.get("enquio-popup")) {
+        await window.__ENQUIO_RENDERER_BOOTSTRAP__;
+        return;
+      }
+      await loadPopupScript(state);
+      const controller = window.__ENQUIO_POPUP_BOOTSTRAP__;
+      if (!controller) throw new Error("[script] popup.js did not initialize its bootstrap controller.");
+      const task = existingController ? controller.load(state.context) : controller.current;
+      state.context = controller.context;
+      if (!task) throw new Error("[script] popup.js did not start its bootstrap.");
+      await task;
+    }).catch((error) => {
+      if (error instanceof Error && "retryable" in error && error.retryable === true) state.task = void 0;
+      throw error;
+    });
+  }
+  if (!state.wait) {
+    state.wait = new Promise((resolve, reject) => {
+      const timer = window.setTimeout(() => {
+        const error = new Error("[timeout] Renderer was not ready within 30 seconds. Loading may still complete.");
+        report(state, error);
+        reject(error);
+      }, LOAD_TIMEOUT);
+      state.task.then(
+        () => {
+          window.clearTimeout(timer);
+          resolve();
+        },
+        (error) => {
+          window.clearTimeout(timer);
+          report(state, error);
+          reject(error);
+        }
+      );
+    }).finally(() => {
+      state.wait = void 0;
+    });
+  }
+  return state.wait;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  loadEnquioScript
+});

package/dist/index.mjs

@@ -0,0 +1,117 @@
+// src/loader.ts
+var SCRIPT_URL = "https://public.newapp.enquio.eu/popup.js";
+var SCRIPT_ID = "enquio-popup-script";
+var LOAD_TIMEOUT = 3e4;
+var ScriptLoadError = class extends Error {
+  constructor(message, retryable = false) {
+    super(message);
+    this.retryable = retryable;
+  }
+};
+function report(state, error) {
+  if (state.context.reported) return;
+  state.context.reported = true;
+  console.warn("Enquio:", error instanceof Error ? error.message : String(error));
+}
+function loadPopupScript(state) {
+  if (window.__ENQUIO_POPUP_BOOTSTRAP__) return Promise.resolve();
+  return new Promise((resolve, reject) => {
+    var _a;
+    const existing = document.getElementById(SCRIPT_ID);
+    let script;
+    let insert = false;
+    if (existing && !(existing instanceof HTMLScriptElement)) {
+      reject(new Error("[script] enquio-popup-script is not a script element."));
+      return;
+    }
+    if (existing && existing !== state.failedScript) {
+      script = existing;
+    } else {
+      script = document.createElement("script");
+      if (existing) {
+        for (const attribute of Array.from(existing.attributes)) script.setAttribute(attribute.name, attribute.value);
+      }
+      script.nonce = (existing == null ? void 0 : existing.nonce) || window.__ENQUIO_NONCE__ || "";
+      script.src = SCRIPT_URL;
+      script.id = SCRIPT_ID;
+      script.async = true;
+      existing == null ? void 0 : existing.remove();
+      state.failedScript = void 0;
+      insert = true;
+    }
+    const cleanup = () => {
+      script.removeEventListener("load", loaded);
+      script.removeEventListener("error", failed);
+      window.removeEventListener("enquio:ready", ready);
+    };
+    const loaded = () => {
+      cleanup();
+      resolve();
+    };
+    const failed = () => {
+      cleanup();
+      state.failedScript = script;
+      reject(new ScriptLoadError("[script] Could not load popup.js.", true));
+    };
+    const ready = () => {
+      if (window.__ENQUIO_POPUP_BOOTSTRAP__) loaded();
+    };
+    script.addEventListener("load", loaded);
+    script.addEventListener("error", failed);
+    window.addEventListener("enquio:ready", ready);
+    window.__ENQUIO_LOAD_CONTEXT__ = state.context;
+    if (insert) ((_a = document.head) != null ? _a : document.documentElement).appendChild(script);
+  });
+}
+function loadEnquioScript(options = {}) {
+  var _a, _b, _c, _d;
+  if (typeof window === "undefined") return Promise.resolve();
+  (_c = window.__ENQUIO_NONCE__) != null ? _c : window.__ENQUIO_NONCE__ = (_b = options.nonce) != null ? _b : (_a = document.querySelector("script[nonce]")) == null ? void 0 : _a.nonce;
+  const state = (_d = window.__ENQUIO_SCRIPT_LOAD__) != null ? _d : window.__ENQUIO_SCRIPT_LOAD__ = { context: { reported: false } };
+  if (!state.task) {
+    state.context = { reported: false };
+    state.task = Promise.resolve().then(async () => {
+      const existingController = window.__ENQUIO_POPUP_BOOTSTRAP__;
+      if (!existingController && customElements.get("enquio-popup")) {
+        await window.__ENQUIO_RENDERER_BOOTSTRAP__;
+        return;
+      }
+      await loadPopupScript(state);
+      const controller = window.__ENQUIO_POPUP_BOOTSTRAP__;
+      if (!controller) throw new Error("[script] popup.js did not initialize its bootstrap controller.");
+      const task = existingController ? controller.load(state.context) : controller.current;
+      state.context = controller.context;
+      if (!task) throw new Error("[script] popup.js did not start its bootstrap.");
+      await task;
+    }).catch((error) => {
+      if (error instanceof Error && "retryable" in error && error.retryable === true) state.task = void 0;
+      throw error;
+    });
+  }
+  if (!state.wait) {
+    state.wait = new Promise((resolve, reject) => {
+      const timer = window.setTimeout(() => {
+        const error = new Error("[timeout] Renderer was not ready within 30 seconds. Loading may still complete.");
+        report(state, error);
+        reject(error);
+      }, LOAD_TIMEOUT);
+      state.task.then(
+        () => {
+          window.clearTimeout(timer);
+          resolve();
+        },
+        (error) => {
+          window.clearTimeout(timer);
+          report(state, error);
+          reject(error);
+        }
+      );
+    }).finally(() => {
+      state.wait = void 0;
+    });
+  }
+  return state.wait;
+}
+export {
+  loadEnquioScript
+};

package/package.json

@@ -1,12 +1,35 @@
 {
 	"name": "@enquio/popup-core",
-	"version": "1.0.2",
+	"version": "1.2.0",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/skutam/EnquioWrappers.git",
+		"directory": "packages/core"
+	},
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
 	"files": [
 		"dist"
 	],
 	"scripts": {
-		"build": "tsc"
+		"build": "tsup",
+		"prepublishOnly": "npm run build"
+	},
+	"module": "dist/index.mjs",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/index.d.mts",
+				"default": "./dist/index.mjs"
+			},
+			"require": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.js"
+			}
+		}
+	},
+	"devDependencies": {
+		"tsup": "^8.5.1",
+		"typescript": "^5.3.0"
 	}
 }

package/dist/loader.d.ts

@@ -1,6 +0,0 @@
-declare global {
-    interface Window {
-        __ENQUIO_SCRIPT_PROMISE__?: Promise<void>;
-    }
-}
-export declare function loadEnquioScript(): Promise<void>;

package/dist/loader.js

@@ -1,23 +0,0 @@
-const SCRIPT_URL = 'https://public.newapp.enquio.eu/popup.js';
-export function loadEnquioScript() {
-    if (typeof window === 'undefined') {
-        return Promise.resolve();
-    }
-    if (!window.__ENQUIO_SCRIPT_PROMISE__) {
-        window.__ENQUIO_SCRIPT_PROMISE__ = new Promise((resolve, reject) => {
-            const existing = document.getElementById('enquio-popup-script');
-            if (existing) {
-                resolve();
-                return;
-            }
-            const script = document.createElement('script');
-            script.src = SCRIPT_URL;
-            script.async = true;
-            script.id = 'enquio-popup-script';
-            script.onload = () => resolve();
-            script.onerror = () => reject(new Error('Failed to load Enquio popup'));
-            document.body.appendChild(script);
-        });
-    }
-    return window.__ENQUIO_SCRIPT_PROMISE__;
-}