@arkyc/widget 1.0.0

package/dist/realtime.mjs

@@ -0,0 +1,107 @@
+//#region src/realtime.ts
+/** CDN that serves any npm package as ESM (`…/pkg@ver/+esm`). */
+const CDN = "https://cdn.jsdelivr.net/npm/";
+/**
+* Import an optional transport SDK. Tries the bare package specifier first (a
+* bundler, import map, or Node resolves it), then falls back to the jsdelivr CDN
+* so a plain browser embed still loads it — a bare specifier like `pusher-js`
+* isn't resolvable at runtime in the browser, which would otherwise leave the
+* widget silently polling. Non-literal specifiers also keep the bundler from
+* trying to resolve these (they aren't hard dependencies) and avoid needing their
+* type declarations.
+*/
+async function loadOptional(pkg, cdnPath) {
+	try {
+		return await import(
+			/* @vite-ignore */
+			/* webpackIgnore: true */
+			pkg
+);
+	} catch {
+		return await import(
+			/* @vite-ignore */
+			/* webpackIgnore: true */
+			`${CDN}${cdnPath}`
+);
+	}
+}
+/**
+* Connect to whichever push transport the API reported for this session. Returns
+* null for `polling`/`off`/`memory` (no push — the widget polls instead) and also
+* when the transport SDK can't be loaded (e.g. a plain `<script>` standalone embed
+* with no bundler), so realtime degrades gracefully to polling. The SDK is
+* dynamically imported so only the active transport is ever pulled in.
+*/
+async function createWidgetRealtimeClient(config, options) {
+	try {
+		if (config.transport === "pusher") return await createPusherClient(config, options);
+		if (config.transport === "firebase") return await createFirebaseClient(config);
+	} catch {
+		return null;
+	}
+	return null;
+}
+async function createPusherClient(config, options) {
+	const Pusher = (await loadOptional("pusher-js", "pusher-js@8/+esm")).default;
+	const pusher = new Pusher(String(config.key ?? ""), {
+		cluster: String(config.cluster ?? "mt1"),
+		forceTLS: Boolean(config.forceTLS ?? false),
+		...config.wsHost ? {
+			wsHost: String(config.wsHost),
+			wsPort: Number(config.wsPort),
+			wssPort: Number(config.wssPort ?? config.wsPort),
+			enabledTransports: config.enabledTransports ?? ["ws", "wss"]
+		} : {},
+		channelAuthorization: {
+			transport: "ajax",
+			endpoint: options.authEndpoint,
+			headers: { "X-Client-Token": options.token }
+		}
+	});
+	return {
+		subscribe(channel, handler) {
+			const ch = pusher.subscribe(channel);
+			const cb = (event, data) => handler(event, data);
+			ch.bind_global(cb);
+			return () => {
+				ch.unbind_global(cb);
+				pusher.unsubscribe(channel);
+			};
+		},
+		disconnect() {
+			pusher.disconnect();
+		}
+	};
+}
+async function createFirebaseClient(config) {
+	const [app, auth, database] = await Promise.all([
+		loadOptional("firebase/app", "firebase@11/app/+esm"),
+		loadOptional("firebase/auth", "firebase@11/auth/+esm"),
+		loadOptional("firebase/database", "firebase@11/database/+esm")
+	]);
+	const name = "arkyc-widget-realtime";
+	const fbApp = app.getApps().some((a) => a.name === name) ? app.getApp(name) : app.initializeApp({
+		apiKey: String(config.apiKey ?? ""),
+		authDomain: String(config.authDomain ?? ""),
+		projectId: String(config.projectId ?? ""),
+		databaseURL: String(config.databaseURL ?? "")
+	}, name);
+	if (config.token) await auth.signInWithCustomToken(auth.getAuth(fbApp), config.token);
+	const db = database.getDatabase(fbApp);
+	const since = Date.now();
+	return {
+		subscribe(channel, handler) {
+			const q = database.query(database.ref(db, `realtime/${channel}`), database.orderByChild("at"), database.startAt(since));
+			const unsubscribe = database.onChildAdded(q, (snap) => {
+				const value = snap.val();
+				if (value) handler(value.event, value.payload);
+			});
+			return () => unsubscribe();
+		},
+		disconnect() {}
+	};
+}
+//#endregion
+export { createWidgetRealtimeClient };
+
+//# sourceMappingURL=realtime.mjs.map

package/dist/realtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.mjs","names":[],"sources":["../src/realtime.ts"],"sourcesContent":["import type { ClientRealtime } from './client'\n\n/** Fires for every event received on a subscribed channel. */\nexport type WidgetRealtimeHandler = (event: string, data: unknown) => void\n\n/** A connected push transport. `subscribe` returns an unsubscribe function. */\nexport interface WidgetRealtimeClient {\n  subscribe(channel: string, handler: WidgetRealtimeHandler): () => void\n  disconnect(): void\n}\n\n/** A factory that builds a push client from the session's realtime config. */\nexport type WidgetRealtimeFactory = (\n  config: ClientRealtime,\n  options: WidgetRealtimeOptions,\n) => Promise<WidgetRealtimeClient | null>\n\nexport interface WidgetRealtimeOptions {\n  /** The client-token channel-auth endpoint (pusher). */\n  authEndpoint: string\n  /** The session's client token (sent as `X-Client-Token` to the authorizer). */\n  token: string\n}\n\n/** CDN that serves any npm package as ESM (`…/pkg@ver/+esm`). */\nconst CDN = 'https://cdn.jsdelivr.net/npm/'\n\n/**\n * Import an optional transport SDK. Tries the bare package specifier first (a\n * bundler, import map, or Node resolves it), then falls back to the jsdelivr CDN\n * so a plain browser embed still loads it — a bare specifier like `pusher-js`\n * isn't resolvable at runtime in the browser, which would otherwise leave the\n * widget silently polling. Non-literal specifiers also keep the bundler from\n * trying to resolve these (they aren't hard dependencies) and avoid needing their\n * type declarations.\n */\nasync function loadOptional(pkg: string, cdnPath: string): Promise<unknown> {\n  try {\n    return await import(/* @vite-ignore */ /* webpackIgnore: true */ pkg)\n  } catch {\n    return await import(/* @vite-ignore */ /* webpackIgnore: true */ `${CDN}${cdnPath}`)\n  }\n}\n\n/**\n * Connect to whichever push transport the API reported for this session. Returns\n * null for `polling`/`off`/`memory` (no push — the widget polls instead) and also\n * when the transport SDK can't be loaded (e.g. a plain `<script>` standalone embed\n * with no bundler), so realtime degrades gracefully to polling. The SDK is\n * dynamically imported so only the active transport is ever pulled in.\n */\nexport async function createWidgetRealtimeClient(\n  config: ClientRealtime,\n  options: WidgetRealtimeOptions,\n): Promise<WidgetRealtimeClient | null> {\n  try {\n    if (config.transport === 'pusher') return await createPusherClient(config, options)\n    if (config.transport === 'firebase') return await createFirebaseClient(config)\n  } catch {\n    // Transport SDK unavailable / failed to connect — fall back to polling.\n    return null\n  }\n\n  return null\n}\n\n// --- pusher-js (minimal surface we depend on) ---\n\ninterface PusherChannel {\n  bind_global(cb: (event: string, data: unknown) => void): void\n  unbind_global(cb: (event: string, data: unknown) => void): void\n}\ninterface PusherInstance {\n  subscribe(channel: string): PusherChannel\n  unsubscribe(channel: string): void\n  disconnect(): void\n}\ntype PusherCtor = new (key: string, options: Record<string, unknown>) => PusherInstance\n\nasync function createPusherClient(\n  config: ClientRealtime,\n  options: WidgetRealtimeOptions,\n): Promise<WidgetRealtimeClient> {\n  const mod = (await loadOptional('pusher-js', 'pusher-js@8/+esm')) as { default: PusherCtor }\n  const Pusher = mod.default\n  const pusher = new Pusher(String(config.key ?? ''), {\n    cluster: String(config.cluster ?? 'mt1'),\n    forceTLS: Boolean(config.forceTLS ?? false),\n    ...(config.wsHost\n      ? {\n          wsHost: String(config.wsHost),\n          wsPort: Number(config.wsPort),\n          wssPort: Number(config.wssPort ?? config.wsPort),\n          enabledTransports: (config.enabledTransports as string[]) ?? ['ws', 'wss'],\n        }\n      : {}),\n    // The widget authorizes private channels with its short-lived client token,\n    // which the API scopes to this session's own channel only.\n    channelAuthorization: {\n      transport: 'ajax',\n      endpoint: options.authEndpoint,\n      headers: { 'X-Client-Token': options.token },\n    },\n  })\n\n  return {\n    subscribe(channel, handler) {\n      const ch = pusher.subscribe(channel)\n      const cb = (event: string, data: unknown) => handler(event, data)\n      ch.bind_global(cb)\n\n      return () => {\n        ch.unbind_global(cb)\n        pusher.unsubscribe(channel)\n      }\n    },\n    disconnect() {\n      pusher.disconnect()\n    },\n  }\n}\n\n// --- firebase (minimal surface we depend on) ---\n\ninterface FirebaseApp {\n  name: string\n}\ninterface FirebaseAppModule {\n  initializeApp(options: Record<string, unknown>, name: string): FirebaseApp\n  getApps(): FirebaseApp[]\n  getApp(name: string): FirebaseApp\n}\ninterface FirebaseAuthModule {\n  getAuth(app: FirebaseApp): unknown\n  signInWithCustomToken(auth: unknown, token: string): Promise<unknown>\n}\ninterface FirebaseSnapshot {\n  val(): { event: string; payload: unknown } | null\n}\ninterface FirebaseDatabaseModule {\n  getDatabase(app: FirebaseApp): unknown\n  ref(db: unknown, path: string): unknown\n  query(ref: unknown, ...constraints: unknown[]): unknown\n  orderByChild(path: string): unknown\n  startAt(value: number): unknown\n  onChildAdded(query: unknown, cb: (snap: FirebaseSnapshot) => void): () => void\n}\n\nasync function createFirebaseClient(config: ClientRealtime): Promise<WidgetRealtimeClient> {\n  const [app, auth, database] = (await Promise.all([\n    loadOptional('firebase/app', 'firebase@11/app/+esm'),\n    loadOptional('firebase/auth', 'firebase@11/auth/+esm'),\n    loadOptional('firebase/database', 'firebase@11/database/+esm'),\n  ])) as [FirebaseAppModule, FirebaseAuthModule, FirebaseDatabaseModule]\n\n  const name = 'arkyc-widget-realtime'\n  const fbApp = app.getApps().some((a) => a.name === name)\n    ? app.getApp(name)\n    : app.initializeApp(\n        {\n          apiKey: String(config.apiKey ?? ''),\n          authDomain: String(config.authDomain ?? ''),\n          projectId: String(config.projectId ?? ''),\n          databaseURL: String(config.databaseURL ?? ''),\n        },\n        name,\n      )\n\n  // The per-session custom token authorizes reads of this session's channel only.\n  if (config.token) await auth.signInWithCustomToken(auth.getAuth(fbApp), config.token)\n\n  const db = database.getDatabase(fbApp)\n  const since = Date.now()\n\n  return {\n    subscribe(channel, handler) {\n      const q = database.query(\n        database.ref(db, `realtime/${channel}`),\n        database.orderByChild('at'),\n        database.startAt(since),\n      )\n      const unsubscribe = database.onChildAdded(q, (snap) => {\n        const value = snap.val()\n        if (value) handler(value.event, value.payload)\n      })\n\n      return () => unsubscribe()\n    },\n    disconnect() {\n      // Firebase listeners are torn down per-subscription via the returned unsub.\n    },\n  }\n}\n"],"mappings":";;AAyBA,MAAM,MAAM;;;;;;;;;;AAWZ,eAAe,aAAa,KAAa,SAAmC;CAC1E,IAAI;EACF,OAAO,MAAM;;;GAAoD;;CACnE,QAAQ;EACN,OAAO,MAAM;;;GAAoD,GAAG,MAAM;;CAC5E;AACF;;;;;;;;AASA,eAAsB,2BACpB,QACA,SACsC;CACtC,IAAI;EACF,IAAI,OAAO,cAAc,UAAU,OAAO,MAAM,mBAAmB,QAAQ,OAAO;EAClF,IAAI,OAAO,cAAc,YAAY,OAAO,MAAM,qBAAqB,MAAM;CAC/E,QAAQ;EAEN,OAAO;CACT;CAEA,OAAO;AACT;AAeA,eAAe,mBACb,QACA,SAC+B;CAE/B,MAAM,UAAS,MADI,aAAa,aAAa,kBAAkB,EAAA,CAC5C;CACnB,MAAM,SAAS,IAAI,OAAO,OAAO,OAAO,OAAO,EAAE,GAAG;EAClD,SAAS,OAAO,OAAO,WAAW,KAAK;EACvC,UAAU,QAAQ,OAAO,YAAY,KAAK;EAC1C,GAAI,OAAO,SACP;GACE,QAAQ,OAAO,OAAO,MAAM;GAC5B,QAAQ,OAAO,OAAO,MAAM;GAC5B,SAAS,OAAO,OAAO,WAAW,OAAO,MAAM;GAC/C,mBAAoB,OAAO,qBAAkC,CAAC,MAAM,KAAK;EAC3E,IACA,CAAC;EAGL,sBAAsB;GACpB,WAAW;GACX,UAAU,QAAQ;GAClB,SAAS,EAAE,kBAAkB,QAAQ,MAAM;EAC7C;CACF,CAAC;CAED,OAAO;EACL,UAAU,SAAS,SAAS;GAC1B,MAAM,KAAK,OAAO,UAAU,OAAO;GACnC,MAAM,MAAM,OAAe,SAAkB,QAAQ,OAAO,IAAI;GAChE,GAAG,YAAY,EAAE;GAEjB,aAAa;IACX,GAAG,cAAc,EAAE;IACnB,OAAO,YAAY,OAAO;GAC5B;EACF;EACA,aAAa;GACX,OAAO,WAAW;EACpB;CACF;AACF;AA4BA,eAAe,qBAAqB,QAAuD;CACzF,MAAM,CAAC,KAAK,MAAM,YAAa,MAAM,QAAQ,IAAI;EAC/C,aAAa,gBAAgB,sBAAsB;EACnD,aAAa,iBAAiB,uBAAuB;EACrD,aAAa,qBAAqB,2BAA2B;CAC/D,CAAC;CAED,MAAM,OAAO;CACb,MAAM,QAAQ,IAAI,QAAQ,CAAC,CAAC,MAAM,MAAM,EAAE,SAAS,IAAI,IACnD,IAAI,OAAO,IAAI,IACf,IAAI,cACF;EACE,QAAQ,OAAO,OAAO,UAAU,EAAE;EAClC,YAAY,OAAO,OAAO,cAAc,EAAE;EAC1C,WAAW,OAAO,OAAO,aAAa,EAAE;EACxC,aAAa,OAAO,OAAO,eAAe,EAAE;CAC9C,GACA,IACF;CAGJ,IAAI,OAAO,OAAO,MAAM,KAAK,sBAAsB,KAAK,QAAQ,KAAK,GAAG,OAAO,KAAK;CAEpF,MAAM,KAAK,SAAS,YAAY,KAAK;CACrC,MAAM,QAAQ,KAAK,IAAI;CAEvB,OAAO;EACL,UAAU,SAAS,SAAS;GAC1B,MAAM,IAAI,SAAS,MACjB,SAAS,IAAI,IAAI,YAAY,SAAS,GACtC,SAAS,aAAa,IAAI,GAC1B,SAAS,QAAQ,KAAK,CACxB;GACA,MAAM,cAAc,SAAS,aAAa,IAAI,SAAS;IACrD,MAAM,QAAQ,KAAK,IAAI;IACvB,IAAI,OAAO,QAAQ,MAAM,OAAO,MAAM,OAAO;GAC/C,CAAC;GAED,aAAa,YAAY;EAC3B;EACA,aAAa,CAEb;CACF;AACF"}

package/dist/theme.d.mts

@@ -0,0 +1,42 @@
+import { ProjectBranding } from "@arkyc/types";
+
+//#region src/theme.d.ts
+/**
+ * Resolves project branding into a concrete theme and renders its CSS. One class
+ * owns the whole "theme" concern: defaulted colour/logo/radius values plus the
+ * CSS-variable block and stylesheet derived from them.
+ */
+declare class Theme {
+  readonly primaryColor: string;
+  readonly borderRadius: number;
+  readonly mode: 'light' | 'dark';
+  readonly logoUrl: string | null;
+  /** Project/company display name shown in the header (when branding is shown). */
+  readonly name: string | null;
+  /** Whether to show the project name/logo in the header (white-label off → false). */
+  readonly showBranding: boolean;
+  /** Surface (card) background. */
+  readonly background: string;
+  /** Primary text colour. */
+  readonly foreground: string;
+  /** Muted text colour. */
+  readonly muted: string;
+  /** Subtle border colour. */
+  readonly border: string;
+  constructor(branding?: ProjectBranding | null);
+  /**
+   * The CSS-variable declaration block for this theme.
+   *
+   * @returns
+   */
+  variables(): string;
+  /**
+   * The widget stylesheet, parameterised by this theme's variables.
+   *
+   * @returns
+   */
+  stylesheet(): string;
+}
+//#endregion
+export { Theme };
+//# sourceMappingURL=theme.d.mts.map

package/dist/theme.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.mts","names":[],"sources":["../src/theme.ts"],"mappings":";;;;;AAsBA;;;cAAa,KAAA;EAAA,SACF,YAAA;EAAA,SACA,YAAA;EAAA,SACA,IAAA;EAAA,SACA,OAAA;EAEA;EAAA,SAAA,IAAA;EAIA;EAAA,SAFA,YAAA;EAMA;EAAA,SAJA,UAAA;;WAEA,UAAA;EAMG;EAAA,SAJH,KAAA;EAuCT;EAAA,SArCS,MAAA;cAEG,QAAA,GAAW,eAAe;;;;;;EAmBtC,SAAA;;;;;;EAgBA,UAAA;AAAA"}

package/dist/theme.mjs

@@ -0,0 +1,77 @@
+import _virtual_arkyc_theme_css_default from "./_virtual/_virtual_arkyc-theme-css.mjs";
+//#region src/theme.ts
+const LIGHT = {
+	background: "#ffffff",
+	foreground: "#0f172a",
+	muted: "#64748b",
+	border: "#e2e8f0"
+};
+const DARK = {
+	background: "#0f172a",
+	foreground: "#f8fafc",
+	muted: "#94a3b8",
+	border: "#1e293b"
+};
+/**
+* Resolves project branding into a concrete theme and renders its CSS. One class
+* owns the whole "theme" concern: defaulted colour/logo/radius values plus the
+* CSS-variable block and stylesheet derived from them.
+*/
+var Theme = class {
+	primaryColor;
+	borderRadius;
+	mode;
+	logoUrl;
+	/** Project/company display name shown in the header (when branding is shown). */
+	name;
+	/** Whether to show the project name/logo in the header (white-label off → false). */
+	showBranding;
+	/** Surface (card) background. */
+	background;
+	/** Primary text colour. */
+	foreground;
+	/** Muted text colour. */
+	muted;
+	/** Subtle border colour. */
+	border;
+	constructor(branding) {
+		this.mode = branding?.theme === "dark" ? "dark" : "light";
+		const palette = this.mode === "dark" ? DARK : LIGHT;
+		this.primaryColor = branding?.primary_color ?? "#b8860b";
+		this.borderRadius = branding?.border_radius ?? 12;
+		this.logoUrl = branding?.logo_url ?? null;
+		this.name = branding?.name ?? null;
+		this.showBranding = branding?.show_branding !== false;
+		this.background = palette.background;
+		this.foreground = palette.foreground;
+		this.muted = palette.muted;
+		this.border = palette.border;
+	}
+	/**
+	* The CSS-variable declaration block for this theme.
+	*
+	* @returns
+	*/
+	variables() {
+		return [
+			`--arkyc-primary:${this.primaryColor}`,
+			`--arkyc-radius:${this.borderRadius}px`,
+			`--arkyc-bg:${this.background}`,
+			`--arkyc-fg:${this.foreground}`,
+			`--arkyc-muted:${this.muted}`,
+			`--arkyc-border:${this.border}`
+		].join(";");
+	}
+	/**
+	* The widget stylesheet, parameterised by this theme's variables.
+	*
+	* @returns
+	*/
+	stylesheet() {
+		return _virtual_arkyc_theme_css_default.replace("/* {variables} */", `${this.variables()};`).trim();
+	}
+};
+//#endregion
+export { Theme };
+
+//# sourceMappingURL=theme.mjs.map

package/dist/theme.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.mjs","names":["themeCss"],"sources":["../src/theme.ts"],"sourcesContent":["import type { ProjectBranding } from '@arkyc/types'\nimport themeCss from 'virtual:arkyc-theme-css'\n\nconst LIGHT = {\n  background: '#ffffff',\n  foreground: '#0f172a',\n  muted: '#64748b',\n  border: '#e2e8f0',\n}\n\nconst DARK = {\n  background: '#0f172a',\n  foreground: '#f8fafc',\n  muted: '#94a3b8',\n  border: '#1e293b',\n}\n\n/**\n * Resolves project branding into a concrete theme and renders its CSS. One class\n * owns the whole \"theme\" concern: defaulted colour/logo/radius values plus the\n * CSS-variable block and stylesheet derived from them.\n */\nexport class Theme {\n  readonly primaryColor: string\n  readonly borderRadius: number\n  readonly mode: 'light' | 'dark'\n  readonly logoUrl: string | null\n  /** Project/company display name shown in the header (when branding is shown). */\n  readonly name: string | null\n  /** Whether to show the project name/logo in the header (white-label off → false). */\n  readonly showBranding: boolean\n  /** Surface (card) background. */\n  readonly background: string\n  /** Primary text colour. */\n  readonly foreground: string\n  /** Muted text colour. */\n  readonly muted: string\n  /** Subtle border colour. */\n  readonly border: string\n\n  constructor(branding?: ProjectBranding | null) {\n    this.mode = branding?.theme === 'dark' ? 'dark' : 'light'\n    const palette = this.mode === 'dark' ? DARK : LIGHT\n    this.primaryColor = branding?.primary_color ?? '#b8860b'\n    this.borderRadius = branding?.border_radius ?? 12\n    this.logoUrl = branding?.logo_url ?? null\n    this.name = branding?.name ?? null\n    this.showBranding = branding?.show_branding !== false\n    this.background = palette.background\n    this.foreground = palette.foreground\n    this.muted = palette.muted\n    this.border = palette.border\n  }\n\n  /**\n   * The CSS-variable declaration block for this theme.\n   *\n   * @returns\n   */\n  variables(): string {\n    return [\n      `--arkyc-primary:${this.primaryColor}`,\n      `--arkyc-radius:${this.borderRadius}px`,\n      `--arkyc-bg:${this.background}`,\n      `--arkyc-fg:${this.foreground}`,\n      `--arkyc-muted:${this.muted}`,\n      `--arkyc-border:${this.border}`,\n    ].join(';')\n  }\n\n  /**\n   * The widget stylesheet, parameterised by this theme's variables.\n   *\n   * @returns\n   */\n  stylesheet(): string {\n    return themeCss.replace('/* {variables} */', `${this.variables()};`).trim()\n  }\n}\n"],"mappings":";;AAGA,MAAM,QAAQ;CACZ,YAAY;CACZ,YAAY;CACZ,OAAO;CACP,QAAQ;AACV;AAEA,MAAM,OAAO;CACX,YAAY;CACZ,YAAY;CACZ,OAAO;CACP,QAAQ;AACV;;;;;;AAOA,IAAa,QAAb,MAAmB;CACjB;CACA;CACA;CACA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;CAEA,YAAY,UAAmC;EAC7C,KAAK,OAAO,UAAU,UAAU,SAAS,SAAS;EAClD,MAAM,UAAU,KAAK,SAAS,SAAS,OAAO;EAC9C,KAAK,eAAe,UAAU,iBAAiB;EAC/C,KAAK,eAAe,UAAU,iBAAiB;EAC/C,KAAK,UAAU,UAAU,YAAY;EACrC,KAAK,OAAO,UAAU,QAAQ;EAC9B,KAAK,eAAe,UAAU,kBAAkB;EAChD,KAAK,aAAa,QAAQ;EAC1B,KAAK,aAAa,QAAQ;EAC1B,KAAK,QAAQ,QAAQ;EACrB,KAAK,SAAS,QAAQ;CACxB;;;;;;CAOA,YAAoB;EAClB,OAAO;GACL,mBAAmB,KAAK;GACxB,kBAAkB,KAAK,aAAa;GACpC,cAAc,KAAK;GACnB,cAAc,KAAK;GACnB,iBAAiB,KAAK;GACtB,kBAAkB,KAAK;EACzB,CAAC,CAAC,KAAK,GAAG;CACZ;;;;;;CAOA,aAAqB;EACnB,OAAOA,iCAAS,QAAQ,qBAAqB,GAAG,KAAK,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK;CAC5E;AACF"}

package/dist/types.d.mts

@@ -0,0 +1,153 @@
+import { DocumentAnalyzer, DocumentTuning } from "./document.mjs";
+import { FaceAnalyzer, FaceTuning } from "./face.mjs";
+import { ProviderSignalHints } from "./client.mjs";
+import { WidgetRealtimeFactory } from "./realtime.mjs";
+import { ProjectBranding, WidgetResult } from "@arkyc/types";
+
+//#region src/types.d.ts
+/**
+ * An event surfaced to consumers through `onEvent` / `handle.on(name, cb)`. The
+ * stream is a firehose: `session.transition` (live status changes, from the
+ * configured transport) plus the lifecycle events `complete` / `error` / `close`.
+ */
+interface WidgetEvent {
+  /** Event name, e.g. `session.transition`, `complete`, `error`, `close`. */
+  name: string;
+  /** Event payload (shape depends on `name`). */
+  data?: unknown;
+}
+/** Subscribe to a named widget event; returns an unsubscribe function. */
+type WidgetEventListener = (data: unknown) => void;
+/** Configuration for a {@link WidgetController}. */
+interface WidgetControllerConfig {
+  /** Short-lived client token for this session. */
+  token: string;
+  /** API origin (defaults to the widget's own origin). */
+  baseUrl?: string;
+  /** Disable cross-device handoff entirely (set on the hosted page to avoid recursion). */
+  handoff?: boolean;
+  /** Override the server-provided handoff page URL. */
+  handoffUrl?: string;
+  branding?: ProjectBranding | null;
+  /**
+   * Mock-driver signal hints. When present, capture screens also offer a
+   * "Skip" affordance (the `mock` drivers can decide without a real image).
+   */
+  signals?: ProviderSignalHints;
+  onComplete?: (result: WidgetResult) => void;
+  onError?: (error: Error) => void;
+  onClose?: () => void;
+  /**
+   * Firehose for every widget event (`session.transition`, `complete`, `error`,
+   * `close`). Nothing is emitted unless this or a `handle.on(...)` listener is
+   * active. The same stream is filterable per-name via {@link WidgetHandle.on}.
+   */
+  onEvent?: (event: WidgetEvent) => void;
+  /** Fired once the flow settles (complete/error/close); used to remove the host. */
+  onSettle?: () => void;
+  /** Force (or disable) posting `arkyc:*` messages to `window.parent`. */
+  postToParent?: boolean;
+  fetch?: typeof fetch;
+  doc?: Document;
+  win?: Window;
+  nav?: Navigator;
+  /**
+   * Face analyzer powering selfie auto-capture + active-liveness detection.
+   * Defaults to the real MediaPipe-backed analyzer (loaded lazily from a CDN);
+   * pass `null` to disable detection and use the manual capture flow.
+   */
+  faceAnalyzer?: FaceAnalyzer | null;
+  /** Override face-detection thresholds (tune against a real camera). */
+  faceTuning?: FaceTuning;
+  /**
+   * Document analyzer powering document auto-capture (real edge-projection
+   * detection). Defaults to the built-in canvas detector; pass `null` to disable
+   * it and fall back to the brightness/glare heuristic.
+   */
+  documentAnalyzer?: DocumentAnalyzer | null;
+  /** Override document-detection thresholds (tune against a real camera). */
+  documentTuning?: DocumentTuning;
+  /**
+   * Builds the realtime push client from the session's realtime config. Defaults
+   * to the bundled pusher/firebase factory; injectable for tests.
+   */
+  realtimeFactory?: WidgetRealtimeFactory;
+  /** Schedules a callback after `ms` (defaults to `setTimeout`). */
+  scheduler?: (fn: () => void, ms: number) => void;
+  /** Cosmetic OCR-processing screen duration (ms). */
+  transientMs?: number;
+  /** Delay between session polls while finalising (ms). */
+  pollMs?: number;
+  /** Maximum number of polls before giving up and showing the last status. */
+  maxPolls?: number;
+  /** Maximum number of polls while waiting on a handed-off device (bounded by session TTL). */
+  maxHandoffPolls?: number;
+}
+/** Common options shared by every launch mode. */
+interface BaseWidgetOptions {
+  /** Short-lived client token minted by the integrator's backend. */
+  token: string;
+  /** API origin (defaults to the page's own origin). */
+  baseUrl?: string;
+  /**
+   * Cross-device handoff (desktop → phone via QR) is on by default and uses a
+   * first-party hosted page the API points to — integrators host nothing. Set
+   * `false` to disable it (the hosted page itself does, to avoid recursion).
+   */
+  handoff?: boolean;
+  /**
+   * Override the hosted handoff page URL. By default the widget uses the URL the
+   * API returns (the dashboard's `/verify` page); only set this for custom hosting.
+   */
+  handoffUrl?: string;
+  /** Branding (colors, logo, radius, theme, name). Usually sourced from project config. */
+  branding?: ProjectBranding | null;
+  /**
+   * Open the widget edge-to-edge (no surrounding padding/backdrop gap, no card
+   * max-size or border radius). Applies to {@link ArkycWidget.open} only.
+   */
+  fullscreen?: boolean;
+  /** Mock-driver signal hints; enables a "Skip" affordance on capture screens. */
+  signals?: ProviderSignalHints;
+  onComplete?: (result: WidgetResult) => void;
+  onError?: (error: Error) => void;
+  onClose?: () => void;
+  /**
+   * Firehose for live session events (`session.transition`) and lifecycle events
+   * (`complete` / `error` / `close`). Whether updates arrive via pusher, firebase
+   * or polling is decided by the platform's configured transport — the widget
+   * handles it. Nothing is emitted unless this (or a `handle.on(...)`) is active.
+   */
+  onEvent?: (event: WidgetEvent) => void;
+  fetch?: typeof fetch;
+  doc?: Document;
+  win?: Window;
+  nav?: Navigator;
+  /** Pass `null` to disable face detection (selfie auto-capture + active liveness). */
+  faceAnalyzer?: FaceAnalyzer | null;
+  /** Override face-detection thresholds (tune against a real camera). */
+  faceTuning?: FaceTuning;
+  /** Pass `null` to disable document detection (falls back to the brightness heuristic). */
+  documentAnalyzer?: DocumentAnalyzer | null;
+  /** Override document-detection thresholds (tune against a real camera). */
+  documentTuning?: DocumentTuning;
+}
+/** Options for {@link ArkycWidget.mount} (inline mode). */
+interface MountWidgetOptions extends BaseWidgetOptions {
+  /** Element (or selector) to mount the widget into. */
+  container: string | HTMLElement;
+}
+/** A handle to an open/mounted widget. */
+interface WidgetHandle {
+  /** Close the widget and release the camera (fires `onClose`). */
+  close: () => void;
+  /**
+   * Subscribe to a named widget event (e.g. `session.transition`, `complete`).
+   * Returns an unsubscribe function. Registering a listener activates the event
+   * stream (events are only delivered while at least one listener is active).
+   */
+  on: (event: string, listener: WidgetEventListener) => () => void;
+}
+//#endregion
+export { BaseWidgetOptions, MountWidgetOptions, WidgetControllerConfig, WidgetEvent, WidgetEventListener, WidgetHandle };
+//# sourceMappingURL=types.d.mts.map

package/dist/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;;;;AAYA;;;UAAiB,WAAA;EAIX;EAFJ,IAAA;EAM6B;EAJ7B,IAAI;AAAA;AAI0C;AAAA,KAApC,mBAAA,IAAuB,IAAa;;UAG/B,sBAAA;EASJ;EAPX,KAAA;EAasB;EAXtB,OAAA;EAmBkB;EAjBlB,OAAA;EAyBM;EAvBN,UAAA;EACA,QAAA,GAAW,eAAA;EA8BI;;;;EAzBf,OAAA,GAAU,mBAAA;EACV,UAAA,IAAc,MAAA,EAAQ,YAAA;EACtB,OAAA,IAAW,KAAA,EAAO,KAAA;EAClB,OAAA;EAbA;;;;;EAmBA,OAAA,IAAW,KAAA,EAAO,WAAA;EATR;EAWV,QAAA;EAVsB;EAYtB,YAAA;EAGA,KAAA,UAAe,KAAA;EACf,GAAA,GAAM,QAAA;EACN,GAAA,GAAM,MAAA;EACN,GAAA,GAAM,SAAA;EAVN;;;;;EAgBA,YAAA,GAAe,YAAA;EATA;EAWf,UAAA,GAAa,UAAA;EAVP;;;;;EAgBN,gBAAA,GAAmB,gBAAA;EARJ;EAUf,cAAA,GAAiB,cAAA;EARJ;;;;EAab,eAAA,GAAkB,qBAAA;EAAlB;EAEA,SAAA,IAAa,EAAA,cAAgB,EAAA;EAA7B;EAEA,WAAA;EAF6B;EAI7B,MAAA;EAAA;EAEA,QAAA;EAEA;EAAA,eAAA;AAAA;AAIF;AAAA,UAAiB,iBAAA;;EAEf,KAAA;EAsBU;EApBV,OAAA;EAsBkB;;;;;EAhBlB,OAAA;EAgCe;;;;EA3Bf,UAAA;EAiC+B;EA/B/B,QAAA,GAAW,eAAA;EAbX;;;;EAkBA,UAAA;EAAA;EAEA,OAAA,GAAU,mBAAA;EACV,UAAA,IAAc,MAAA,EAAQ,YAAA;EACtB,OAAA,IAAW,KAAA,EAAO,KAAA;EAClB,OAAA;EAFc;;;;;;EASd,OAAA,IAAW,KAAA,EAAO,WAAA;EAGlB,KAAA,UAAe,KAAA;EACf,GAAA,GAAM,QAAA;EACN,GAAA,GAAM,MAAA;EACN,GAAA,GAAM,SAAA;EAFA;EAIN,YAAA,GAAe,YAAA;EAHT;EAKN,UAAA,GAAa,UAAA;EAJP;EAMN,gBAAA,GAAmB,gBAAA;EAJJ;EAMf,cAAA,GAAiB,cAAA;AAAA;;UAIF,kBAAA,SAA2B,iBAAiB;EAJ3D;EAMA,SAAA,WAAoB,WAAA;AAAA;AANW;AAAA,UAUhB,YAAA;EANmB;EAQlC,KAAA;EAR2D;;;;;EAc3D,EAAA,GAAK,KAAA,UAAe,QAAA,EAAU,mBAAmB;AAAA"}