@defender-dev/sdk 0.1.0

package/dist/src/__tests__/breadcrumbs.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/__tests__/browser-contract.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/__tests__/build.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/__tests__/config.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/__tests__/console.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/__tests__/contract.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/__tests__/core.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/__tests__/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/__tests__/network.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/__tests__/replay.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/__tests__/screenshots.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/__tests__/transport.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/__tests__/user.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/__tests__/vite-plugin.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/__tests__/vue.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/breadcrumbs.d.ts

@@ -0,0 +1,4 @@
+import { Breadcrumb } from '@defender/shared';
+export declare function addBreadcrumb(crumb: Breadcrumb): void;
+export declare function getBreadcrumbs(): Breadcrumb[];
+export declare function clearBreadcrumbs(): void;

package/dist/src/config.d.ts

@@ -0,0 +1,39 @@
+export interface SdkConfig {
+    endpoint: string;
+    apiKey: string;
+    release: string;
+    maxBreadcrumbs: number;
+    breadcrumbMaxAge: number;
+    flushInterval: number;
+    maxBatchSize: number;
+    debug: boolean;
+    replayEnabled: boolean;
+    replayMaxEvents: number;
+    replayScreenshotEnabled: boolean;
+    replayScreenshotMaxCount: number;
+    replayScreenshotMaxBytes: number;
+}
+export interface ReplayScreenshotOptions {
+    enabled?: boolean;
+    maxCount?: number;
+    maxBytes?: number;
+}
+export interface ReplayInitOptions {
+    enabled?: boolean;
+    maxEvents?: number;
+    screenshots?: ReplayScreenshotOptions;
+}
+export interface SdkInitOptions {
+    apiKey: string;
+    endpoint?: string;
+    release?: string;
+    maxBreadcrumbs?: number;
+    breadcrumbMaxAge?: number;
+    flushInterval?: number;
+    maxBatchSize?: number;
+    debug?: boolean;
+    replay?: ReplayInitOptions;
+}
+export declare function loadConfig(options: SdkInitOptions): void;
+export declare function getConfig(): SdkConfig;
+export declare function resetConfig(): void;

package/dist/src/console.d.ts

@@ -0,0 +1,2 @@
+export declare function patchConsole(): void;
+export declare function unpatchConsole(): void;

package/dist/src/core.d.ts

@@ -0,0 +1,16 @@
+import { ErrorEventPayload, Breadcrumb } from '@defender/shared';
+interface UserIdentity {
+    id: string;
+    email?: string;
+    account?: {
+        id: string;
+        name?: string;
+    };
+}
+export declare function setUser(user: UserIdentity): void;
+export declare function clearUser(): void;
+export declare function buildPayload(errorType: string, errorMessage: string, stack: string, breadcrumb: Breadcrumb): ErrorEventPayload;
+export declare function captureException(input: unknown): void;
+export declare function installGlobalHandlers(): void;
+export declare function uninstallGlobalHandlers(): void;
+export {};

package/dist/src/index.d.ts

@@ -0,0 +1,15 @@
+import { SdkInitOptions } from './config';
+import { captureException, setUser, clearUser } from './core';
+export { defenderVuePlugin } from './vue';
+export type { SdkInitOptions } from './config';
+export { captureException, setUser, clearUser };
+export declare function init(options: SdkInitOptions): void;
+export declare function destroy(): void;
+export declare const DefenderSDK: {
+    init: typeof init;
+    destroy: typeof destroy;
+    captureException: typeof captureException;
+    setUser: typeof setUser;
+    clearUser: typeof clearUser;
+};
+export { DefenderSDK as Defender };

package/dist/src/network.d.ts

@@ -0,0 +1,4 @@
+export declare function patchFetch(): void;
+export declare function unpatchFetch(): void;
+export declare function patchXHR(): void;
+export declare function unpatchXHR(): void;

package/dist/src/replay.d.ts

@@ -0,0 +1,19 @@
+export type ReplayTriggerType = 'uncaught_error' | 'capture_exception';
+interface ReplayEvent {
+    timestamp: string;
+    type: string;
+    data: Record<string, unknown>;
+}
+interface ReplayUploadInput {
+    triggerType: ReplayTriggerType;
+    errorType: string;
+    errorMessage: string;
+    eventId?: string;
+    errorGroupId?: string;
+}
+export declare function startReplayCapture(): void;
+export declare function stopReplayCapture(): void;
+export declare function uploadReplayForTrigger(input: ReplayUploadInput): Promise<void>;
+export declare function _resetReplayState(): void;
+export declare function _getReplayBuffer(): ReplayEvent[];
+export {};

package/dist/src/screenshots.d.ts

@@ -0,0 +1,18 @@
+export interface FocusRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface ReplayScreenshotArtifact {
+    kind: 'crash_viewport' | 'last_interaction_focus';
+    captured_at: string;
+    width: number;
+    height: number;
+    content_type: 'image/webp';
+    data_base64: string;
+}
+export interface CaptureReplayScreenshotOptions {
+    focusRect?: FocusRect;
+}
+export declare function captureReplayScreenshots(options?: CaptureReplayScreenshotOptions): Promise<ReplayScreenshotArtifact[]>;

package/dist/src/session.d.ts

@@ -0,0 +1,3 @@
+export declare function ensureSessionID(): string;
+export declare function getSessionId(): string;
+export declare function resetSessionId(): void;

package/dist/src/transport.d.ts

@@ -0,0 +1,8 @@
+import { ErrorEventPayload } from '@defender/shared';
+import { ReplayTriggerType } from './replay';
+export declare function enqueueEvent(event: ErrorEventPayload, replayTrigger?: ReplayTriggerType): void;
+export declare function flushEvents(): Promise<void>;
+export declare function startTransport(): void;
+export declare function stopTransport(): void;
+export declare function getQueueLength(): number;
+export declare function _resetQueue(): void;

package/dist/src/vue.d.ts

@@ -0,0 +1,9 @@
+interface VueApp {
+    config: {
+        errorHandler: ((err: unknown, instance: unknown, info: string) => void) | null;
+    };
+}
+export declare const defenderVuePlugin: {
+    install(app: VueApp): void;
+};
+export {};

package/dist/vite-plugin/index.d.ts

@@ -0,0 +1,23 @@
+export interface SourceMapPluginOptions {
+    endpoint: string;
+    apiKey: string;
+    release?: string;
+}
+interface BundleAsset {
+    type: string;
+    source?: string;
+    fileName: string;
+}
+export declare function defenderSourceMapPlugin(options: SourceMapPluginOptions): {
+    name: string;
+    apply: "build";
+    enforce: "post";
+    config(): {
+        build: {
+            sourcemap: "hidden";
+        };
+    };
+    generateBundle(_outputOptions: unknown, bundle: Record<string, BundleAsset>): void;
+    closeBundle(): Promise<void>;
+};
+export {};

package/dist/vite-plugin.js

@@ -0,0 +1,69 @@
+function f(o) {
+  const n = [];
+  return {
+    name: "defender-source-map",
+    apply: "build",
+    enforce: "post",
+    config() {
+      return {
+        build: {
+          sourcemap: "hidden"
+        }
+      };
+    },
+    generateBundle(a, e) {
+      const t = Object.keys(e).filter(
+        (r) => r.endsWith(".map")
+      );
+      for (const r of t) {
+        const s = e[r], c = typeof s.source == "string" ? s.source : String(s.source || "");
+        n.push({
+          file_path: i(s.fileName),
+          source_map: c
+        }), delete e[r];
+      }
+    },
+    async closeBundle() {
+      if (n.length === 0) return;
+      const a = o.release || p(n);
+      for (const e of n)
+        try {
+          const t = new FormData();
+          t.append("release", a), t.append("file", new Blob([e.source_map], { type: "application/json" }), e.file_path + ".map");
+          const r = await fetch(
+            `${o.endpoint}/api/v1/sourcemaps`,
+            {
+              method: "POST",
+              headers: {
+                "X-API-Key": o.apiKey
+              },
+              body: t
+            }
+          );
+          r.ok || console.warn(
+            `[defender] Source map upload failed for ${e.file_path}: ${r.status} ${r.statusText}`
+          );
+        } catch (t) {
+          console.warn(
+            `[defender] Source map upload failed for ${e.file_path}: ${t instanceof Error ? t.message : String(t)}`
+          );
+        }
+    }
+  };
+}
+function p(o) {
+  const n = o.map((e) => e.file_path).sort().join("|");
+  let a = 0;
+  for (let e = 0; e < n.length; e++) {
+    const t = n.charCodeAt(e);
+    a = (a << 5) - a + t | 0;
+  }
+  return Math.abs(a).toString(36);
+}
+function i(o) {
+  return o.endsWith(".map") ? o.slice(0, -4) : o;
+}
+export {
+  f as defenderSourceMapPlugin
+};
+//# sourceMappingURL=vite-plugin.js.map

package/dist/vite-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.js","sources":["../vite-plugin/index.ts"],"sourcesContent":["export interface SourceMapPluginOptions {\n  endpoint: string;\n  apiKey: string;\n  release?: string;\n}\n\ninterface BundleAsset {\n  type: string;\n  source?: string;\n  fileName: string;\n}\n\ninterface CollectedMap {\n  file_path: string;\n  source_map: string;\n}\n\nexport function defenderSourceMapPlugin(options: SourceMapPluginOptions) {\n  const collectedMaps: CollectedMap[] = [];\n\n  return {\n    name: 'defender-source-map',\n    apply: 'build' as const,\n    enforce: 'post' as const,\n\n    config() {\n      return {\n        build: {\n          sourcemap: 'hidden' as const,\n        },\n      };\n    },\n\n    generateBundle(\n      _outputOptions: unknown,\n      bundle: Record<string, BundleAsset>\n    ): void {\n      const mapKeys = Object.keys(bundle).filter((key) =>\n        key.endsWith('.map')\n      );\n\n      for (const key of mapKeys) {\n        const asset = bundle[key];\n        const source =\n          typeof asset.source === 'string'\n            ? asset.source\n            : String(asset.source || '');\n\n        collectedMaps.push({\n          file_path: stripMapSuffix(asset.fileName),\n          source_map: source,\n        });\n\n        // Remove .map file from output so it is not deployed\n        delete bundle[key];\n      }\n    },\n\n    async closeBundle(): Promise<void> {\n      if (collectedMaps.length === 0) return;\n\n      const release = options.release || generateVersion(collectedMaps);\n\n      for (const map of collectedMaps) {\n        try {\n          const formData = new FormData();\n          formData.append('release', release);\n          formData.append('file', new Blob([map.source_map], { type: 'application/json' }), map.file_path + '.map');\n\n          const response = await fetch(\n            `${options.endpoint}/api/v1/sourcemaps`,\n            {\n              method: 'POST',\n              headers: {\n                'X-API-Key': options.apiKey,\n              },\n              body: formData,\n            }\n          );\n\n          if (!response.ok) {\n            console.warn(\n              `[defender] Source map upload failed for ${map.file_path}: ${response.status} ${response.statusText}`\n            );\n          }\n        } catch (error) {\n          console.warn(\n            `[defender] Source map upload failed for ${map.file_path}: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      }\n    },\n  };\n}\n\nfunction generateVersion(files: CollectedMap[]): string {\n  const input = files.map((f) => f.file_path).sort().join('|');\n  let hash = 0;\n  for (let i = 0; i < input.length; i++) {\n    const char = input.charCodeAt(i);\n    hash = ((hash << 5) - hash + char) | 0;\n  }\n  return Math.abs(hash).toString(36);\n}\n\nfunction stripMapSuffix(filePath: string): string {\n  return filePath.endsWith('.map') ? filePath.slice(0, -4) : filePath;\n}\n"],"names":["defenderSourceMapPlugin","options","collectedMaps","_outputOptions","bundle","mapKeys","key","asset","source","stripMapSuffix","release","generateVersion","map","formData","response","error","files","input","f","hash","i","char","filePath"],"mappings":"AAiBO,SAASA,EAAwBC,GAAiC;AACvE,QAAMC,IAAgC,CAAA;AAEtC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SAAS;AAAA,IAET,SAAS;AACP,aAAO;AAAA,QACL,OAAO;AAAA,UACL,WAAW;AAAA,QAAA;AAAA,MACb;AAAA,IAEJ;AAAA,IAEA,eACEC,GACAC,GACM;AACN,YAAMC,IAAU,OAAO,KAAKD,CAAM,EAAE;AAAA,QAAO,CAACE,MAC1CA,EAAI,SAAS,MAAM;AAAA,MAAA;AAGrB,iBAAWA,KAAOD,GAAS;AACzB,cAAME,IAAQH,EAAOE,CAAG,GAClBE,IACJ,OAAOD,EAAM,UAAW,WACpBA,EAAM,SACN,OAAOA,EAAM,UAAU,EAAE;AAE/B,QAAAL,EAAc,KAAK;AAAA,UACjB,WAAWO,EAAeF,EAAM,QAAQ;AAAA,UACxC,YAAYC;AAAA,QAAA,CACb,GAGD,OAAOJ,EAAOE,CAAG;AAAA,MACnB;AAAA,IACF;AAAA,IAEA,MAAM,cAA6B;AACjC,UAAIJ,EAAc,WAAW,EAAG;AAEhC,YAAMQ,IAAUT,EAAQ,WAAWU,EAAgBT,CAAa;AAEhE,iBAAWU,KAAOV;AAChB,YAAI;AACF,gBAAMW,IAAW,IAAI,SAAA;AACrB,UAAAA,EAAS,OAAO,WAAWH,CAAO,GAClCG,EAAS,OAAO,QAAQ,IAAI,KAAK,CAACD,EAAI,UAAU,GAAG,EAAE,MAAM,mBAAA,CAAoB,GAAGA,EAAI,YAAY,MAAM;AAExG,gBAAME,IAAW,MAAM;AAAA,YACrB,GAAGb,EAAQ,QAAQ;AAAA,YACnB;AAAA,cACE,QAAQ;AAAA,cACR,SAAS;AAAA,gBACP,aAAaA,EAAQ;AAAA,cAAA;AAAA,cAEvB,MAAMY;AAAA,YAAA;AAAA,UACR;AAGF,UAAKC,EAAS,MACZ,QAAQ;AAAA,YACN,2CAA2CF,EAAI,SAAS,KAAKE,EAAS,MAAM,IAAIA,EAAS,UAAU;AAAA,UAAA;AAAA,QAGzG,SAASC,GAAO;AACd,kBAAQ;AAAA,YACN,2CAA2CH,EAAI,SAAS,KAAKG,aAAiB,QAAQA,EAAM,UAAU,OAAOA,CAAK,CAAC;AAAA,UAAA;AAAA,QAEvH;AAAA,IAEJ;AAAA,EAAA;AAEJ;AAEA,SAASJ,EAAgBK,GAA+B;AACtD,QAAMC,IAAQD,EAAM,IAAI,CAACE,MAAMA,EAAE,SAAS,EAAE,OAAO,KAAK,GAAG;AAC3D,MAAIC,IAAO;AACX,WAASC,IAAI,GAAGA,IAAIH,EAAM,QAAQG,KAAK;AACrC,UAAMC,IAAOJ,EAAM,WAAWG,CAAC;AAC/B,IAAAD,KAASA,KAAQ,KAAKA,IAAOE,IAAQ;AAAA,EACvC;AACA,SAAO,KAAK,IAAIF,CAAI,EAAE,SAAS,EAAE;AACnC;AAEA,SAASV,EAAea,GAA0B;AAChD,SAAOA,EAAS,SAAS,MAAM,IAAIA,EAAS,MAAM,GAAG,EAAE,IAAIA;AAC7D;"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@defender-dev/sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Browser error monitoring SDK for Defender",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/opslane/defender.git",
+    "directory": "packages/sdk"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./vite-plugin": {
+      "import": "./dist/vite-plugin.js",
+      "types": "./dist/vite-plugin.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "vite build"
+  },
+  "dependencies": {
+    "html2canvas": "^1.4.1"
+  },
+  "devDependencies": {
+    "@defender/shared": "workspace:*",
+    "@playwright/test": "^1.40.0",
+    "jsdom": "^28.0.0",
+    "typescript": "^5.4.0",
+    "vite": "^6.0.0",
+    "vite-plugin-dts": "^4.0.0",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "vite": "^6.0.0",
+    "vue": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vue": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    }
+  }
+}