@wippy-fe/types-global-proxy 0.0.18 → 0.0.20

package/index.d.ts

@@ -750,6 +750,37 @@ type Events = {
 };
 declare function createEvents(): <T extends string>(topicPattern: T, callback: T extends KnownTopics ? Events[T] : Events["@message"]) => nanoevents.Unsubscribe;
 
+declare const LogLevel: {
+    readonly Emergency: 0;
+    readonly Alert: 1;
+    readonly Critical: 2;
+    readonly Error: 3;
+    readonly Warning: 4;
+    readonly Notice: 5;
+    readonly Info: 6;
+    readonly Debug: 7;
+};
+type LogLevelValue = typeof LogLevel[keyof typeof LogLevel];
+interface Breadcrumb {
+    category?: string;
+    message?: string;
+    data?: Record<string, unknown>;
+    level?: LogLevelValue;
+    type?: 'default' | 'http' | 'navigation' | 'user' | 'error';
+    timestamp?: number;
+}
+interface LoggerApi {
+    debug: (message: string, data?: Record<string, unknown>) => void;
+    info: (message: string, data?: Record<string, unknown>) => void;
+    warn: (message: string, data?: Record<string, unknown>) => void;
+    error: (message: string, data?: Record<string, unknown>) => void;
+    captureException: (error: unknown, extra?: Record<string, unknown>) => void;
+    captureMessage: (message: string, level?: LogLevelValue, extra?: Record<string, unknown>) => void;
+    addBreadcrumb: (breadcrumb: Breadcrumb) => void;
+    setContext: (name: string, data: Record<string, unknown> | null) => void;
+    setTag: (key: string, value: string | null) => void;
+}
+
 interface StateApiOptions {
     /** Override the default page-level scope. Used by web components with persist-key or nested artifacts. */
     scope?: string;
@@ -841,6 +872,7 @@ interface ProxyApiInstance {
         submit: (data: FormData | Record<string, unknown>) => Promise<FormResult>;
     };
     on: ReturnType<typeof createEvents>;
+    logger: LoggerApi;
     state: StateApi;
     ws: ProxyWsApi;
     loadWebComponent: (componentId: string, tagName?: string) => Promise<void>;
@@ -864,6 +896,7 @@ interface ProxyConfig {
         iconifyIcons: boolean;
         refreshWhenVisible: boolean;
         historyPolyfill: boolean;
+        errorCapture: boolean;
     };
 }
 
@@ -930,6 +963,7 @@ declare global {
             /** @deprecated Use `$W.host` instead */
             iframe: () => Promise<ProxyApiInstance['host']>;
             on: () => Promise<ProxyApiInstance['on']>;
+            logger: () => Promise<ProxyApiInstance['logger']>;
             state: () => Promise<ProxyApiInstance['state']>;
             ws: () => Promise<ProxyApiInstance['ws']>;
             loadWebComponent: () => Promise<ProxyApiInstance['loadWebComponent']>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wippy-fe/types-global-proxy",
-  "version": "0.0.18",
+  "version": "0.0.20",
   "description": "Global type declarations for Wippy iframe proxy (window.getWippyApi, $W, etc.)",
   "license": "UNLICENSED",
   "types": "index.d.ts"