@evelan/jexity-widget 0.11.8 → 0.12.1

package/dist/types/lib/history-patch.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Singleton history patch — wraps pushState/replaceState once and notifies
+ * all registered listeners on programmatic SPA navigation. Also forwards
+ * popstate so listeners don't need to wire it themselves.
+ */
+/** Register a navigation listener. Returns a cleanup function. */
+export declare function addHistoryListener(fn: () => void): () => void;
+//# sourceMappingURL=history-patch.d.ts.map

package/dist/types/lib/history-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-patch.d.ts","sourceRoot":"","sources":["../../../src/lib/history-patch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAQ7D"}

package/dist/types/lib/widgetBootstrap.d.ts

@@ -7,6 +7,7 @@ type BootstrapOk = {
     ok: true;
     token: string;
     excludePaths: string[];
+    allowedUrls: string[];
 };
 type BootstrapErr = {
     ok: false;
@@ -16,5 +17,6 @@ type BootstrapErr = {
 type BootstrapResult = BootstrapOk | BootstrapErr;
 export declare function bootstrapWidget(orgSlug: string, convexSiteUrl: string, projSlug?: string): Promise<BootstrapResult>;
 export declare function isPathExcluded(pathname: string, excludePaths: string[]): boolean;
+export declare function isUrlMatched(currentUrl: string, allowedUrl: string): boolean;
 export {};
 //# sourceMappingURL=widgetBootstrap.d.ts.map

package/dist/types/lib/widgetBootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widgetBootstrap.d.ts","sourceRoot":"","sources":["../../../src/lib/widgetBootstrap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,KAAK,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AACtE,KAAK,YAAY,GAAG;IAClB,EAAE,EAAE,KAAK,CAAA;IACT,KAAK,EAAE,cAAc,GAAG,WAAW,GAAG,SAAS,GAAG,cAAc,CAAA;IAChE,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AACD,KAAK,eAAe,GAAG,WAAW,GAAG,YAAY,CAAA;AAEjD,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CA8B1B;AAGD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAKhF"}
+{"version":3,"file":"widgetBootstrap.d.ts","sourceRoot":"","sources":["../../../src/lib/widgetBootstrap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,KAAK,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAC7F,KAAK,YAAY,GAAG;IAClB,EAAE,EAAE,KAAK,CAAA;IACT,KAAK,EAAE,cAAc,GAAG,WAAW,GAAG,SAAS,GAAG,cAAc,CAAA;IAChE,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AACD,KAAK,eAAe,GAAG,WAAW,GAAG,YAAY,CAAA;AAEjD,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CA+B1B;AAGD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAKhF;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAY5E"}

package/dist/types/module/shell/WidgetShell.d.ts

@@ -2,7 +2,11 @@ import type { JexityChatOptions } from '../../types';
 interface WidgetShellProps {
     options: JexityChatOptions;
 }
-/** Inner Preact component tree — rendered inside the shadow root container. */
-export declare function WidgetShell({ options }: WidgetShellProps): import("preact").JSX.Element;
+/**
+ * Outer shell: always runs bootstrap + path guard.
+ * Only mounts WidgetContent (and its Convex subscriptions) when the path is allowed,
+ * keeping hook counts stable in each component regardless of navigation.
+ */
+export declare function WidgetShell({ options }: WidgetShellProps): import("preact").JSX.Element | null;
 export {};
 //# sourceMappingURL=WidgetShell.d.ts.map

package/dist/types/module/shell/WidgetShell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WidgetShell.d.ts","sourceRoot":"","sources":["../../../../src/module/shell/WidgetShell.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD,UAAU,gBAAgB;IACxB,OAAO,EAAE,iBAAiB,CAAA;CAC3B;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,EAAE,gBAAgB,gCAiKxD"}
+{"version":3,"file":"WidgetShell.d.ts","sourceRoot":"","sources":["../../../../src/module/shell/WidgetShell.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD,UAAU,gBAAgB;IACxB,OAAO,EAAE,iBAAiB,CAAA;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,EAAE,gBAAgB,uCAaxD"}

package/dist/types/module/shell/hooks/useBootstrap.d.ts

@@ -1,3 +1,11 @@
+interface UseBootstrapOptions {
+    orgSlug: string;
+    projSlug?: string;
+    preToken?: string;
+    convexUrl?: string;
+    preAllowedUrls?: string[];
+    preExcludedPaths?: string[];
+}
 /**
  * If no pre-existing bootstrap token was passed via mount options (i.e. the
  * ESM/React path — JexityChatProvider), call POST /widget/bootstrap here and
@@ -8,5 +16,6 @@
  * the initial fetch but still records the inputs so refreshBootstrapToken()
  * can re-POST when the 1-hour token TTL elapses mid-session.
  */
-export declare function useBootstrap(orgSlug: string, projSlug: string | undefined, preToken: string | undefined, runtimeConvexUrl: string | undefined): void;
+export declare function useBootstrap({ orgSlug, projSlug, preToken, convexUrl, preAllowedUrls, preExcludedPaths, }: UseBootstrapOptions): void;
+export {};
 //# sourceMappingURL=useBootstrap.d.ts.map

package/dist/types/module/shell/hooks/useBootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBootstrap.d.ts","sourceRoot":"","sources":["../../../../../src/module/shell/hooks/useBootstrap.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC,IAAI,CAsCN"}
+{"version":3,"file":"useBootstrap.d.ts","sourceRoot":"","sources":["../../../../../src/module/shell/hooks/useBootstrap.ts"],"names":[],"mappings":"AAKA,UAAU,mBAAmB;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,cAAc,EACd,gBAAgB,GACjB,EAAE,mBAAmB,GAAG,IAAI,CA+C5B"}

package/dist/types/module/shell/hooks/usePathGuard.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Returns true when the widget is allowed to display on the current page.
+ * If no path-scoped allowedUrls are set, always returns true.
+ * Reacts to SPA navigation (popstate + history.pushState/replaceState).
+ */
+export declare function usePathGuard(): boolean;
+//# sourceMappingURL=usePathGuard.d.ts.map

package/dist/types/module/shell/hooks/usePathGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePathGuard.d.ts","sourceRoot":"","sources":["../../../../../src/module/shell/hooks/usePathGuard.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAgCtC"}

package/dist/types/module/shell/shell.state.d.ts

@@ -16,6 +16,18 @@ export declare const isOpen: import("@preact/signals").Signal<boolean>;
 export declare const widgetSource: import("@preact/signals").Signal<string | undefined>;
 /** Bootstrap token issued by POST /widget/bootstrap. Read by useConvexSession. */
 export declare const bootstrapToken: import("@preact/signals").Signal<Id<"widgetBootstrapTokens"> | undefined>;
+/**
+ * Path-scoped allow URLs from the bootstrap response (e.g. ["https://example.com/en", "https://example.com/ru"]).
+ * Multiple entries arise when a project has several path rules for the same origin.
+ * Set once after bootstrap; consumed by usePathGuard. Empty = no path restriction.
+ */
+export declare const allowedUrls: import("@preact/signals").Signal<string[]>;
+/**
+ * Per-domain exclude paths from the bootstrap response.
+ * Paths listed here hide the widget even when the domain/origin is allowed.
+ * Set once after bootstrap; consumed by usePathGuard.
+ */
+export declare const excludedPaths: import("@preact/signals").Signal<string[]>;
 /**
  * Inputs needed to re-POST /widget/bootstrap when the current token expires
  * mid-session. Populated by useBootstrap on mount (both IIFE preToken path

package/dist/types/module/shell/shell.state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell.state.d.ts","sourceRoot":"","sources":["../../../../src/module/shell/shell.state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAEnE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,MAAM,2CAAgB,CAAA;AAEnC,wEAAwE;AACxE,eAAO,MAAM,YAAY,sDAAwC,CAAA;AAEjE,kFAAkF;AAClF,eAAO,MAAM,cAAc,2EAA6D,CAAA;AAExF;;;;GAIG;AACH,eAAO,MAAM,eAAe;aACjB,MAAM;cACL,MAAM,GAAG,SAAS;aACnB,MAAM;SACF,CAAA"}
+{"version":3,"file":"shell.state.d.ts","sourceRoot":"","sources":["../../../../src/module/shell/shell.state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAEnE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,MAAM,2CAAgB,CAAA;AAEnC,wEAAwE;AACxE,eAAO,MAAM,YAAY,sDAAwC,CAAA;AAEjE,kFAAkF;AAClF,eAAO,MAAM,cAAc,2EAA6D,CAAA;AAExF;;;;GAIG;AACH,eAAO,MAAM,WAAW,4CAAuB,CAAA;AAE/C;;;;GAIG;AACH,eAAO,MAAM,aAAa,4CAAuB,CAAA;AAEjD;;;;GAIG;AACH,eAAO,MAAM,eAAe;aACjB,MAAM;cACL,MAAM,GAAG,SAAS;aACnB,MAAM;SACF,CAAA"}

package/dist/types/types.d.ts

@@ -87,6 +87,19 @@ export interface JexityChatOptions {
     source?: string;
     /** Bootstrap token from /widget/bootstrap — required for origin-gated sessions. */
     bootstrapToken?: string;
+    /**
+     * Path-scoped allow URLs returned by /widget/bootstrap alongside the token.
+     * Multiple entries arise when a project has several path rules for the same origin
+     * (e.g. /en and /ru). Pass alongside a pre-fetched `bootstrapToken` so the widget
+     * enforces path-scoped rules without re-fetching bootstrap.
+     */
+    allowedUrls?: string[];
+    /**
+     * Excluded paths from /widget/bootstrap — paths where the widget should not
+     * appear even though the domain is otherwise allowed. Pass alongside a
+     * pre-fetched `bootstrapToken` so the widget enforces exclusions without a refetch.
+     */
+    excludePaths?: string[];
 }
 export interface JexityChatInstance {
     open: () => void;

package/dist/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE;QACH,wCAAwC;QACxC,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,iCAAiC;QACjC,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,qCAAqC;QACrC,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,oCAAoC;QACpC,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,6BAA6B;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,6BAA6B;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,IAAI,CAAC,EAAE;QACL,iCAAiC;QACjC,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,8BAA8B;QAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,6BAA6B;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,8BAA8B;QAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,iCAAiC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,MAAM,CAAC,EAAE;QACP,+BAA+B;QAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,+BAA+B;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,WAAW,GAAG,MAAM,CAAA;IAChC,QAAQ,CAAC,EAAE,cAAc,GAAG,aAAa,CAAA;IACzC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;IACvC;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAGrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,UAAU,CAAA;IACzC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAA;IACpD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;qEAEiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,CAAA;IAC9B,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;CACzD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}