@encatch/event-publisher 0.0.2-beta.0

package/README.md

@@ -0,0 +1,62 @@
+# @encatch/event-publisher
+
+Internal package for publishing and subscribing to form events across the Encatch ecosystem.
+
+## Installation
+
+This is an internal package. Add it to your package dependencies:
+
+```json
+{
+  "dependencies": {
+    "@encatch/event-publisher": "workspace:*"
+  }
+}
+```
+
+## Usage
+
+```typescript
+import { formEventPublisher } from '@encatch/event-publisher';
+
+// Subscribe to form submit events
+const unsubscribe = formEventPublisher.subscribe('form:submit', (payload) => {
+  console.log('Form submitted:', payload);
+});
+
+// Subscribe with form ID filter
+formEventPublisher.subscribe(
+  'form:submit',
+  (payload) => {
+    console.log('Specific form submitted:', payload);
+  },
+  { formId: 'specific-form-id' }
+);
+
+// Publish an event
+formEventPublisher.publish('form:submit', {
+  feedbackConfigurationId: 'form-id',
+  response: { /* form data */ },
+  timestamp: Date.now()
+});
+
+// Unsubscribe when done
+unsubscribe();
+```
+
+## API
+
+### Types
+
+- `FormEventType`: Event types ('form:view', 'form:submit', 'form:close', etc.)
+- `FormEventPayload`: Payload types for each event
+- `FormIdFilter`: Filter for specific form IDs
+- `SubscriptionOptions`: Options for subscriptions
+
+### Methods
+
+- `publish<T>(eventType: T, payload: FormEventPayload[T], options?)`: Publish an event
+- `subscribe<T>(eventType: T, handler: Function, options?)`: Subscribe to events
+- `subscribeAll(handler: Function, options?)`: Subscribe to all event types
+- `getSubscriptionCount(eventType?)`: Get active subscription count
+- `clearSubscriptions(eventType?)`: Clear subscriptions

package/dist/event-publisher.js

@@ -0,0 +1,111 @@
+class d extends EventTarget {
+  subscriptions = /* @__PURE__ */ new Map();
+  targetOrigin = "*";
+  /**
+   * Check if a form ID matches the filter
+   */
+  matchesFilter(s, i) {
+    return !i || i === "*" || i === null || i === void 0 ? !0 : typeof i == "string" ? s === i : Array.isArray(i) ? i.includes(s || "") : typeof i == "function" ? i(s || "") : !1;
+  }
+  /**
+   * Get form ID from payload
+   */
+  getFormIdFromPayload(s) {
+    return s?.feedbackConfigurationId;
+  }
+  /**
+   * Publish an event to all matching subscribers
+   */
+  publish(s, i, e) {
+    typeof window < "u" && window.dispatchEvent(
+      new CustomEvent(s, {
+        detail: i,
+        bubbles: !0
+      })
+    ), e?.usePostMessage !== !1 && this.sendPostMessage(s, i);
+  }
+  /**
+   * Subscribe to form events with optional form ID filtering
+   */
+  subscribe(s, i, e) {
+    const n = Symbol("subscription"), t = {
+      eventType: s,
+      handler: i,
+      filter: e?.formId,
+      id: n,
+      once: e?.once
+    };
+    this.subscriptions.has(s) || this.subscriptions.set(s, []), this.subscriptions.get(s).push(t);
+    const r = (o) => {
+      const c = o, u = this.getFormIdFromPayload(c.detail);
+      this.matchesFilter(u, e?.formId) && (i(c.detail), e?.once && typeof window < "u" && window.removeEventListener(s, r));
+    };
+    return typeof window < "u" && window.addEventListener(s, r), () => {
+      this.unsubscribe(n), typeof window < "u" && window.removeEventListener(s, r);
+    };
+  }
+  /**
+   * Unsubscribe by subscription ID
+   */
+  unsubscribe(s) {
+    for (const [i, e] of this.subscriptions.entries()) {
+      const n = e.findIndex((t) => t.id === s);
+      if (n !== -1) {
+        e.splice(n, 1), e.length === 0 && this.subscriptions.delete(i);
+        break;
+      }
+    }
+  }
+  /**
+   * Subscribe to all form events with optional filtering
+   */
+  subscribeAll(s, i) {
+    const e = [
+      "form:view",
+      "form:submit",
+      "form:close",
+      "form:section:change",
+      "form:question:answered",
+      "form:error"
+    ], n = [];
+    return e.forEach((t) => {
+      const r = this.subscribe(
+        t,
+        (o) => s(t, o),
+        i
+      );
+      n.push(r);
+    }), () => {
+      n.forEach((t) => t());
+    };
+  }
+  /**
+   * Get active subscriptions count (for debugging)
+   */
+  getSubscriptionCount(s) {
+    return s ? this.subscriptions.get(s)?.length || 0 : Array.from(this.subscriptions.values()).reduce((i, e) => i + e.length, 0);
+  }
+  /**
+   * Clear all subscriptions for an event type (or all events)
+   */
+  clearSubscriptions(s) {
+    s ? this.subscriptions.delete(s) : this.subscriptions.clear();
+  }
+  sendPostMessage(s, i) {
+    const e = {
+      type: `encatch:${s}`,
+      payload: i,
+      source: "encatch-form-engine"
+    };
+    window.parent && window.parent !== window && window.parent.postMessage(e, this.targetOrigin), document.querySelectorAll("iframe").forEach((t) => {
+      t.contentWindow && t.contentWindow.postMessage(e, this.targetOrigin);
+    }), typeof window.ReactNativeWebView < "u" && window.ReactNativeWebView.postMessage(JSON.stringify({
+      action: s.replace("form:", ""),
+      data: JSON.stringify(i)
+    }));
+  }
+}
+const f = new d();
+export {
+  f as formEventPublisher
+};

package/dist/event-publisher.umd.cjs

@@ -0,0 +1 @@
+(function(o,r){typeof exports=="object"&&typeof module<"u"?r(exports):typeof define=="function"&&define.amd?define(["exports"],r):(o=typeof globalThis<"u"?globalThis:o||self,r(o.EventPublisher={}))})(this,(function(o){"use strict";class r extends EventTarget{subscriptions=new Map;targetOrigin="*";matchesFilter(e,s){return!s||s==="*"||s===null||s===void 0?!0:typeof s=="string"?e===s:Array.isArray(s)?s.includes(e||""):typeof s=="function"?s(e||""):!1}getFormIdFromPayload(e){return e?.feedbackConfigurationId}publish(e,s,i){typeof window<"u"&&window.dispatchEvent(new CustomEvent(e,{detail:s,bubbles:!0})),i?.usePostMessage!==!1&&this.sendPostMessage(e,s)}subscribe(e,s,i){const n=Symbol("subscription"),t={eventType:e,handler:s,filter:i?.formId,id:n,once:i?.once};this.subscriptions.has(e)||this.subscriptions.set(e,[]),this.subscriptions.get(e).push(t);const u=c=>{const d=c,a=this.getFormIdFromPayload(d.detail);this.matchesFilter(a,i?.formId)&&(s(d.detail),i?.once&&typeof window<"u"&&window.removeEventListener(e,u))};return typeof window<"u"&&window.addEventListener(e,u),()=>{this.unsubscribe(n),typeof window<"u"&&window.removeEventListener(e,u)}}unsubscribe(e){for(const[s,i]of this.subscriptions.entries()){const n=i.findIndex(t=>t.id===e);if(n!==-1){i.splice(n,1),i.length===0&&this.subscriptions.delete(s);break}}}subscribeAll(e,s){const i=["form:view","form:submit","form:close","form:section:change","form:question:answered","form:error"],n=[];return i.forEach(t=>{const u=this.subscribe(t,c=>e(t,c),s);n.push(u)}),()=>{n.forEach(t=>t())}}getSubscriptionCount(e){return e?this.subscriptions.get(e)?.length||0:Array.from(this.subscriptions.values()).reduce((s,i)=>s+i.length,0)}clearSubscriptions(e){e?this.subscriptions.delete(e):this.subscriptions.clear()}sendPostMessage(e,s){const i={type:`encatch:${e}`,payload:s,source:"encatch-form-engine"};window.parent&&window.parent!==window&&window.parent.postMessage(i,this.targetOrigin),document.querySelectorAll("iframe").forEach(t=>{t.contentWindow&&t.contentWindow.postMessage(i,this.targetOrigin)}),typeof window.ReactNativeWebView<"u"&&window.ReactNativeWebView.postMessage(JSON.stringify({action:e.replace("form:",""),data:JSON.stringify(s)}))}}const f=new r;o.formEventPublisher=f,Object.defineProperty(o,Symbol.toStringTag,{value:"Module"})}));

package/dist/index.d.ts

@@ -0,0 +1,90 @@
+export declare type FormEventPayload = {
+    'form:view': {
+        feedbackConfigurationId: string;
+        feedbackIdentifier?: string;
+        timestamp: number;
+    };
+    'form:submit': {
+        feedbackConfigurationId: string;
+        feedbackIdentifier?: string;
+        response: any;
+        timestamp: number;
+    };
+    'form:close': {
+        feedbackConfigurationId?: string;
+        feedbackIdentifier?: string;
+        timestamp: number;
+    };
+    'form:section:change': {
+        feedbackConfigurationId: string;
+        sectionIndex: number;
+        sectionId: string;
+        timestamp: number;
+    };
+    'form:question:answered': {
+        feedbackConfigurationId: string;
+        questionId: string;
+        questionType: string;
+        answer: any;
+        timestamp: number;
+    };
+    'form:error': {
+        feedbackConfigurationId: string;
+        questionId?: string;
+        error: string;
+        timestamp: number;
+    };
+};
+
+declare class FormEventPublisher extends EventTarget {
+    private subscriptions;
+    private targetOrigin;
+    /**
+     * Check if a form ID matches the filter
+     */
+    private matchesFilter;
+    /**
+     * Get form ID from payload
+     */
+    private getFormIdFromPayload;
+    /**
+     * Publish an event to all matching subscribers
+     */
+    publish<T extends FormEventType>(eventType: T, payload: FormEventPayload[T], options?: {
+        usePostMessage?: boolean;
+    }): void;
+    /**
+     * Subscribe to form events with optional form ID filtering
+     */
+    subscribe<T extends FormEventType>(eventType: T, handler: (payload: FormEventPayload[T]) => void, options?: SubscriptionOptions): () => void;
+    /**
+     * Unsubscribe by subscription ID
+     */
+    private unsubscribe;
+    /**
+     * Subscribe to all form events with optional filtering
+     */
+    subscribeAll(handler: (eventType: FormEventType, payload: any) => void, options?: SubscriptionOptions): () => void;
+    /**
+     * Get active subscriptions count (for debugging)
+     */
+    getSubscriptionCount(eventType?: FormEventType): number;
+    /**
+     * Clear all subscriptions for an event type (or all events)
+     */
+    clearSubscriptions(eventType?: FormEventType): void;
+    private sendPostMessage;
+}
+
+export declare const formEventPublisher: FormEventPublisher;
+
+export declare type FormEventType = 'form:view' | 'form:submit' | 'form:close' | 'form:section:change' | 'form:question:answered' | 'form:error';
+
+export declare type FormIdFilter = string | string[] | ((formId: string) => boolean) | '*' | null | undefined;
+
+export declare interface SubscriptionOptions {
+    formId?: FormIdFilter;
+    once?: boolean;
+}
+
+export { }

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@encatch/event-publisher",
+  "version": "0.0.2-beta.0",
+  "type": "module",
+  "main": "./dist/event-publisher.umd.cjs",
+  "module": "./dist/event-publisher.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/event-publisher.js",
+      "require": "./dist/event-publisher.umd.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "typescript": "~5.9.3",
+    "vite": "^7.1.7",
+    "vite-plugin-dts": "^4.3.0"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build && tsc --emitDeclarationOnly --declaration",
+    "clean": "rm -rf dist"
+  }
+}