@fixprompt/browser 0.0.1

package/dist/react.js

@@ -0,0 +1,147 @@
+// src/react.tsx
+import * as React from "react";
+
+// src/version.ts
+var SDK_NAME = "@fixprompt/browser";
+var SDK_VERSION = "0.0.1";
+
+// src/session.ts
+var STORAGE_KEY = "fixprompt_sid";
+function uuid() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function getSessionId() {
+  try {
+    if (typeof sessionStorage !== "undefined") {
+      const existing = sessionStorage.getItem(STORAGE_KEY);
+      if (existing) return existing;
+      const sid = uuid();
+      sessionStorage.setItem(STORAGE_KEY, sid);
+      return sid;
+    }
+  } catch {
+  }
+  return uuid();
+}
+
+// src/transport.ts
+function sendEvent(config, payload) {
+  try {
+    const body = {
+      service: payload.service ?? config.service,
+      app: payload.app ?? config.app,
+      env: payload.env ?? config.env,
+      level: payload.level,
+      message: payload.message,
+      stack: payload.stack,
+      attrs: {
+        ...payload.attrs,
+        sdk: SDK_NAME,
+        sdk_version: SDK_VERSION,
+        session_id: getSessionId(),
+        release: config.release,
+        page_url: typeof location !== "undefined" ? location.href : void 0,
+        user_agent: typeof navigator !== "undefined" ? navigator.userAgent : void 0
+      },
+      synthetic: payload.synthetic
+    };
+    const url = `${config.endpoint.replace(/\/$/, "")}/ingest/log`;
+    const json = JSON.stringify(body);
+    const headers = {
+      "Content-Type": "application/json",
+      "x-loghub-source": config.source,
+      "x-loghub-key": config.projectKey
+    };
+    if (typeof navigator !== "undefined" && typeof navigator.sendBeacon === "function" && // sendBeacon does not allow custom headers, so we use it only as
+    // a last-resort fallback once we add a URL-token path. Until then,
+    // prefer fetch+keepalive so auth headers are honored.
+    false) {
+      const blob = new Blob([json], { type: "application/json" });
+      navigator.sendBeacon(url, blob);
+      return;
+    }
+    if (typeof fetch === "function") {
+      void fetch(url, {
+        method: "POST",
+        headers,
+        body: json,
+        keepalive: true,
+        mode: "cors",
+        credentials: "omit"
+      }).catch(() => void 0);
+    }
+  } catch (err) {
+    if (config.debug) {
+      console.warn("[fixprompt] transport error", err);
+    }
+  }
+}
+
+// src/state.ts
+var STATE_KEY = "__fixprompt_browser_state__";
+function globalScope() {
+  if (typeof globalThis !== "undefined") return globalThis;
+  if (typeof window !== "undefined") return window;
+  return {};
+}
+function getState() {
+  const g = globalScope();
+  if (!g[STATE_KEY]) {
+    g[STATE_KEY] = {
+      initialized: false,
+      config: null,
+      sessionId: null,
+      cleanup: {}
+    };
+  }
+  return g[STATE_KEY];
+}
+
+// src/react.tsx
+var FixPromptErrorBoundary = class extends React.Component {
+  constructor() {
+    super(...arguments);
+    this.state = { error: null };
+  }
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  componentDidCatch(error, info) {
+    const sdk = getState();
+    if (sdk.initialized && sdk.config) {
+      sendEvent(sdk.config, {
+        level: "error",
+        message: error.message,
+        stack: typeof error.stack === "string" ? error.stack : void 0,
+        attrs: {
+          kind: "react.errorBoundary",
+          severity: "error",
+          error_name: error.name,
+          component_stack: info.componentStack
+        }
+      });
+    }
+    this.props.onError?.(error, info);
+  }
+  render() {
+    if (this.state.error) {
+      const { fallback } = this.props;
+      if (typeof fallback === "function") {
+        return fallback(this.state.error);
+      }
+      return fallback ?? null;
+    }
+    return this.props.children ?? null;
+  }
+};
+export {
+  FixPromptErrorBoundary
+};
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.tsx","../src/version.ts","../src/session.ts","../src/transport.ts","../src/state.ts"],"sourcesContent":["import * as React from 'react';\nimport { sendEvent } from './transport';\nimport { getState } from './state';\n\nexport interface FixPromptErrorBoundaryProps {\n  fallback?: React.ReactNode | ((error: Error) => React.ReactNode);\n  onError?: (error: Error, info: React.ErrorInfo) => void;\n  children?: React.ReactNode;\n}\n\ninterface State {\n  error: Error | null;\n}\n\nexport class FixPromptErrorBoundary extends React.Component<\n  FixPromptErrorBoundaryProps,\n  State\n> {\n  state: State = { error: null };\n\n  static getDerivedStateFromError(error: Error): State {\n    return { error };\n  }\n\n  componentDidCatch(error: Error, info: React.ErrorInfo): void {\n    const sdk = getState();\n    if (sdk.initialized && sdk.config) {\n      sendEvent(sdk.config, {\n        level: 'error',\n        message: error.message,\n        stack: typeof error.stack === 'string' ? error.stack : undefined,\n        attrs: {\n          kind: 'react.errorBoundary',\n          severity: 'error',\n          error_name: error.name,\n          component_stack: info.componentStack,\n        },\n      });\n    }\n    this.props.onError?.(error, info);\n  }\n\n  render(): React.ReactNode {\n    if (this.state.error) {\n      const { fallback } = this.props;\n      if (typeof fallback === 'function') {\n        return fallback(this.state.error);\n      }\n      return fallback ?? null;\n    }\n    return this.props.children ?? null;\n  }\n}\n","export const SDK_NAME = '@fixprompt/browser';\nexport const SDK_VERSION = '0.0.1';\n","const STORAGE_KEY = 'fixprompt_sid';\n\nfunction uuid(): string {\n  if (\n    typeof crypto !== 'undefined' &&\n    typeof crypto.randomUUID === 'function'\n  ) {\n    return crypto.randomUUID();\n  }\n  // RFC 4122 v4-ish fallback for older browsers\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\nexport function getSessionId(): string {\n  try {\n    if (typeof sessionStorage !== 'undefined') {\n      const existing = sessionStorage.getItem(STORAGE_KEY);\n      if (existing) return existing;\n      const sid = uuid();\n      sessionStorage.setItem(STORAGE_KEY, sid);\n      return sid;\n    }\n  } catch {\n    // sessionStorage may throw under quota / privacy modes\n  }\n  return uuid();\n}\n","import { SDK_NAME, SDK_VERSION } from './version';\nimport { getSessionId } from './session';\nimport type { EventPayload, ResolvedConfig } from './types';\n\n/**\n * Sends one event to the broker. Fire-and-forget — never throws.\n *\n * Uses navigator.sendBeacon when available for pagehide reliability;\n * falls back to fetch with keepalive.\n */\nexport function sendEvent(\n  config: ResolvedConfig,\n  payload: Omit<EventPayload, 'service' | 'app' | 'env'> & {\n    service?: string;\n    app?: string;\n    env?: string;\n  },\n): void {\n  try {\n    const body: EventPayload = {\n      service: payload.service ?? config.service,\n      app: payload.app ?? config.app,\n      env: payload.env ?? config.env,\n      level: payload.level,\n      message: payload.message,\n      stack: payload.stack,\n      attrs: {\n        ...payload.attrs,\n        sdk: SDK_NAME,\n        sdk_version: SDK_VERSION,\n        session_id: getSessionId(),\n        release: config.release,\n        page_url: typeof location !== 'undefined' ? location.href : undefined,\n        user_agent:\n          typeof navigator !== 'undefined' ? navigator.userAgent : undefined,\n      },\n      synthetic: payload.synthetic,\n    };\n\n    const url = `${config.endpoint.replace(/\\/$/, '')}/ingest/log`;\n    const json = JSON.stringify(body);\n\n    const headers = {\n      'Content-Type': 'application/json',\n      'x-loghub-source': config.source,\n      'x-loghub-key': config.projectKey,\n    } as Record<string, string>;\n\n    if (\n      typeof navigator !== 'undefined' &&\n      typeof navigator.sendBeacon === 'function' &&\n      // sendBeacon does not allow custom headers, so we use it only as\n      // a last-resort fallback once we add a URL-token path. Until then,\n      // prefer fetch+keepalive so auth headers are honored.\n      false\n    ) {\n      const blob = new Blob([json], { type: 'application/json' });\n      navigator.sendBeacon(url, blob);\n      return;\n    }\n\n    if (typeof fetch === 'function') {\n      void fetch(url, {\n        method: 'POST',\n        headers,\n        body: json,\n        keepalive: true,\n        mode: 'cors',\n        credentials: 'omit',\n      }).catch(() => undefined);\n    }\n  } catch (err) {\n    if (config.debug) {\n      // eslint-disable-next-line no-console\n      console.warn('[fixprompt] transport error', err);\n    }\n  }\n}\n","import type { ResolvedConfig } from './types';\n\nexport interface CleanupHooks {\n  removeErrorListener?: () => void;\n  removeRejectionListener?: () => void;\n  restoreConsoleError?: () => void;\n  restoreFetch?: () => void;\n}\n\ninterface SdkState {\n  initialized: boolean;\n  config: ResolvedConfig | null;\n  sessionId: string | null;\n  cleanup: CleanupHooks;\n}\n\nconst STATE_KEY = '__fixprompt_browser_state__';\n\nfunction globalScope(): any {\n  if (typeof globalThis !== 'undefined') return globalThis;\n  if (typeof window !== 'undefined') return window;\n  return {};\n}\n\nexport function getState(): SdkState {\n  const g = globalScope();\n  if (!g[STATE_KEY]) {\n    g[STATE_KEY] = {\n      initialized: false,\n      config: null,\n      sessionId: null,\n      cleanup: {},\n    } satisfies SdkState;\n  }\n  return g[STATE_KEY] as SdkState;\n}\n\nexport function resetStateForTests(): void {\n  const g = globalScope();\n  delete g[STATE_KEY];\n}\n"],"mappings":";AAAA,YAAY,WAAW;;;ACAhB,IAAM,WAAW;AACjB,IAAM,cAAc;;;ACD3B,IAAM,cAAc;AAEpB,SAAS,OAAe;AACtB,MACE,OAAO,WAAW,eAClB,OAAO,OAAO,eAAe,YAC7B;AACA,WAAO,OAAO,WAAW;AAAA,EAC3B;AAEA,SAAO,uCAAuC,QAAQ,SAAS,CAAC,MAAM;AACpE,UAAM,IAAK,KAAK,OAAO,IAAI,KAAM;AACjC,UAAM,IAAI,MAAM,MAAM,IAAK,IAAI,IAAO;AACtC,WAAO,EAAE,SAAS,EAAE;AAAA,EACtB,CAAC;AACH;AAEO,SAAS,eAAuB;AACrC,MAAI;AACF,QAAI,OAAO,mBAAmB,aAAa;AACzC,YAAM,WAAW,eAAe,QAAQ,WAAW;AACnD,UAAI,SAAU,QAAO;AACrB,YAAM,MAAM,KAAK;AACjB,qBAAe,QAAQ,aAAa,GAAG;AACvC,aAAO;AAAA,IACT;AAAA,EACF,QAAQ;AAAA,EAER;AACA,SAAO,KAAK;AACd;;;ACpBO,SAAS,UACd,QACA,SAKM;AACN,MAAI;AACF,UAAM,OAAqB;AAAA,MACzB,SAAS,QAAQ,WAAW,OAAO;AAAA,MACnC,KAAK,QAAQ,OAAO,OAAO;AAAA,MAC3B,KAAK,QAAQ,OAAO,OAAO;AAAA,MAC3B,OAAO,QAAQ;AAAA,MACf,SAAS,QAAQ;AAAA,MACjB,OAAO,QAAQ;AAAA,MACf,OAAO;AAAA,QACL,GAAG,QAAQ;AAAA,QACX,KAAK;AAAA,QACL,aAAa;AAAA,QACb,YAAY,aAAa;AAAA,QACzB,SAAS,OAAO;AAAA,QAChB,UAAU,OAAO,aAAa,cAAc,SAAS,OAAO;AAAA,QAC5D,YACE,OAAO,cAAc,cAAc,UAAU,YAAY;AAAA,MAC7D;AAAA,MACA,WAAW,QAAQ;AAAA,IACrB;AAEA,UAAM,MAAM,GAAG,OAAO,SAAS,QAAQ,OAAO,EAAE,CAAC;AACjD,UAAM,OAAO,KAAK,UAAU,IAAI;AAEhC,UAAM,UAAU;AAAA,MACd,gBAAgB;AAAA,MAChB,mBAAmB,OAAO;AAAA,MAC1B,gBAAgB,OAAO;AAAA,IACzB;AAEA,QACE,OAAO,cAAc,eACrB,OAAO,UAAU,eAAe;AAAA;AAAA;AAAA,IAIhC,OACA;AACA,YAAM,OAAO,IAAI,KAAK,CAAC,IAAI,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC1D,gBAAU,WAAW,KAAK,IAAI;AAC9B;AAAA,IACF;AAEA,QAAI,OAAO,UAAU,YAAY;AAC/B,WAAK,MAAM,KAAK;AAAA,QACd,QAAQ;AAAA,QACR;AAAA,QACA,MAAM;AAAA,QACN,WAAW;AAAA,QACX,MAAM;AAAA,QACN,aAAa;AAAA,MACf,CAAC,EAAE,MAAM,MAAM,MAAS;AAAA,IAC1B;AAAA,EACF,SAAS,KAAK;AACZ,QAAI,OAAO,OAAO;AAEhB,cAAQ,KAAK,+BAA+B,GAAG;AAAA,IACjD;AAAA,EACF;AACF;;;AC7DA,IAAM,YAAY;AAElB,SAAS,cAAmB;AAC1B,MAAI,OAAO,eAAe,YAAa,QAAO;AAC9C,MAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,SAAO,CAAC;AACV;AAEO,SAAS,WAAqB;AACnC,QAAM,IAAI,YAAY;AACtB,MAAI,CAAC,EAAE,SAAS,GAAG;AACjB,MAAE,SAAS,IAAI;AAAA,MACb,aAAa;AAAA,MACb,QAAQ;AAAA,MACR,WAAW;AAAA,MACX,SAAS,CAAC;AAAA,IACZ;AAAA,EACF;AACA,SAAO,EAAE,SAAS;AACpB;;;AJrBO,IAAM,yBAAN,cAA2C,gBAGhD;AAAA,EAHK;AAAA;AAIL,iBAAe,EAAE,OAAO,KAAK;AAAA;AAAA,EAE7B,OAAO,yBAAyB,OAAqB;AACnD,WAAO,EAAE,MAAM;AAAA,EACjB;AAAA,EAEA,kBAAkB,OAAc,MAA6B;AAC3D,UAAM,MAAM,SAAS;AACrB,QAAI,IAAI,eAAe,IAAI,QAAQ;AACjC,gBAAU,IAAI,QAAQ;AAAA,QACpB,OAAO;AAAA,QACP,SAAS,MAAM;AAAA,QACf,OAAO,OAAO,MAAM,UAAU,WAAW,MAAM,QAAQ;AAAA,QACvD,OAAO;AAAA,UACL,MAAM;AAAA,UACN,UAAU;AAAA,UACV,YAAY,MAAM;AAAA,UAClB,iBAAiB,KAAK;AAAA,QACxB;AAAA,MACF,CAAC;AAAA,IACH;AACA,SAAK,MAAM,UAAU,OAAO,IAAI;AAAA,EAClC;AAAA,EAEA,SAA0B;AACxB,QAAI,KAAK,MAAM,OAAO;AACpB,YAAM,EAAE,SAAS,IAAI,KAAK;AAC1B,UAAI,OAAO,aAAa,YAAY;AAClC,eAAO,SAAS,KAAK,MAAM,KAAK;AAAA,MAClC;AACA,aAAO,YAAY;AAAA,IACrB;AACA,WAAO,KAAK,MAAM,YAAY;AAAA,EAChC;AACF;","names":[]}

package/dist/release.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Release auto-detect cascade — see WEEK1_TICKETS.md W1-12.
+ *
+ * Priority:
+ *   1. opts.release (handled in init.ts)
+ *   2. import.meta.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA
+ *   3. import.meta.env.VERCEL_GIT_COMMIT_SHA
+ *   4. import.meta.env.NEXT_PUBLIC_COMMIT_SHA
+ *   5. process.env.GITHUB_SHA
+ *   6. process.env.RELEASE / globalThis.__FIXPROMPT_RELEASE__
+ *   7. <meta name="fixprompt-release" content="...">
+ *   8. null
+ */
+export declare function detectRelease(explicit?: string): string | null;

package/dist/session.d.ts

@@ -0,0 +1 @@
+export declare function getSessionId(): string;

package/dist/state.d.ts

@@ -0,0 +1,16 @@
+import type { ResolvedConfig } from './types';
+export interface CleanupHooks {
+    removeErrorListener?: () => void;
+    removeRejectionListener?: () => void;
+    restoreConsoleError?: () => void;
+    restoreFetch?: () => void;
+}
+interface SdkState {
+    initialized: boolean;
+    config: ResolvedConfig | null;
+    sessionId: string | null;
+    cleanup: CleanupHooks;
+}
+export declare function getState(): SdkState;
+export declare function resetStateForTests(): void;
+export {};

package/dist/transport.d.ts

@@ -0,0 +1,12 @@
+import type { EventPayload, ResolvedConfig } from './types';
+/**
+ * Sends one event to the broker. Fire-and-forget — never throws.
+ *
+ * Uses navigator.sendBeacon when available for pagehide reliability;
+ * falls back to fetch with keepalive.
+ */
+export declare function sendEvent(config: ResolvedConfig, payload: Omit<EventPayload, 'service' | 'app' | 'env'> & {
+    service?: string;
+    app?: string;
+    env?: string;
+}): void;

package/dist/types.d.ts

@@ -0,0 +1,43 @@
+export type Severity = 'critical' | 'error' | 'warning' | 'info';
+export interface InitOptions {
+    /** Project key issued by FixPrompt (kept opaque; never log). */
+    projectKey: string;
+    /** Broker base URL. Defaults to https://geosloghub-production.up.railway.app */
+    endpoint?: string;
+    /** Source identifier the broker uses to look up the project. Defaults to `${slug}-prod`-style values supplied by the dashboard. */
+    source?: string;
+    /** Override release auto-detect (see release.ts). */
+    release?: string;
+    /** App/service labels surfaced in Loki. */
+    service?: string;
+    app?: string;
+    env?: string;
+    /** Enable fetch() wrapper (default: false). */
+    wrapFetch?: boolean;
+    /** Enable console.error patch (default: true). */
+    patchConsoleError?: boolean;
+    /** Verbose logging on console — debug only. */
+    debug?: boolean;
+}
+export interface EventPayload {
+    service: string;
+    app: string;
+    env: string;
+    level: 'debug' | 'info' | 'warn' | 'error';
+    message: string;
+    stack?: string;
+    attrs: Record<string, any>;
+    synthetic?: boolean;
+}
+export interface ResolvedConfig {
+    projectKey: string;
+    endpoint: string;
+    source: string;
+    release: string | null;
+    service: string;
+    app: string;
+    env: string;
+    wrapFetch: boolean;
+    patchConsoleError: boolean;
+    debug: boolean;
+}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const SDK_NAME = "@fixprompt/browser";
+export declare const SDK_VERSION = "0.0.1";

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@fixprompt/browser",
+  "version": "0.0.1",
+  "description": "FixPrompt browser SDK — captures errors, unhandled rejections, console.error, and (optionally) failed fetches; forwards to the FixPrompt broker.",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Geos-LLC/FixPrompt.git",
+    "directory": "browser-sdk"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "unpkg": "./dist/index.global.js",
+  "jsdelivr": "./dist/index.global.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs",
+      "default": "./dist/react.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": ["dist", "README.md"],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup --no-dts && tsc --emitDeclarationOnly --declaration --outDir dist",
+    "dev": "tsup --watch --no-dts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+  },
+  "peerDependencies": {
+    "react": ">=16.8"
+  },
+  "peerDependenciesMeta": {
+    "react": { "optional": true }
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.0.0",
+    "happy-dom": "^15.0.0",
+    "react": "^18.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.4.0",
+    "vitest": "^2.1.0"
+  }
+}