@kargo-pulse/core 0.1.0

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=100,d="[REDACTED]",l=/cookie|token|authorization|password|passwd|secret|credential|session/i;function c(){const e=Math.random().toString(36).slice(2,10);return`evt_${Date.now().toString(36)}_${e}`}function i(e){return e instanceof Error?{name:e.name,message:e.message,stack:e.stack}:typeof e=="string"?{name:"NonError",message:e}:{name:"NonError",message:h(e)}}function g(e,t){const r=i(e);return u({eventId:c(),type:"error",level:"error",appId:t.appId,env:t.env,release:t.release,timestamp:new Date().toISOString(),url:t.url,route:t.route,userAgent:t.userAgent,payload:{...r,source:t.source,component:t.component,handled:t.handled??!0},context:t.context,tags:t.tags,user:t.user})}function E(e=1){return e>=1?!0:e<=0?!1:Math.random()<e}function u(e){return o(e)}function m(e={}){const t=e.maxSize??f,r=[];return{push(n){r.push(n),r.length>t&&r.splice(0,r.length-t)},drain(){return r.splice(0,r.length)},size(){return r.length},async flush(n){if(r.length===0)return!0;const s=r.splice(0,r.length),a=await n(s);return a||r.unshift(...s),a}}}function o(e){if(Array.isArray(e))return e.map(t=>o(t));if(e&&typeof e=="object"){const t={};for(const[r,n]of Object.entries(e))t[r]=l.test(r)?d:o(n);return t}return e}function h(e){try{return JSON.stringify(e)}catch{return String(e)}}exports.createErrorEvent=g;exports.createEventId=c;exports.createMemoryQueue=m;exports.redactSensitiveData=u;exports.serializeError=i;exports.shouldSample=E;
+//# sourceMappingURL=index.cjs.map

package/dist/index.d.ts

@@ -0,0 +1,88 @@
+export type PulseEventType = 'error' | 'click' | 'api' | 'performance';
+export type PulseLevel = 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+export interface PulseUser {
+    id?: string;
+    name?: string;
+    email?: string;
+    [key: string]: unknown;
+}
+export interface ErrorPayload {
+    message: string;
+    name?: string;
+    stack?: string;
+    source?: string;
+    component?: string;
+    handled?: boolean;
+    resolvedStack?: ResolvedStackFrame[];
+}
+export interface ResolvedStackFrame {
+    generatedFile: string;
+    generatedLine: number;
+    generatedColumn: number;
+    source?: string;
+    line?: number;
+    column?: number;
+    name?: string;
+}
+export interface PulseEvent<TPayload = unknown> {
+    eventId: string;
+    type: PulseEventType;
+    level: PulseLevel;
+    appId: string;
+    env: string;
+    release: string;
+    timestamp: string;
+    url?: string;
+    route?: string;
+    userAgent?: string;
+    payload: TPayload;
+    context?: Record<string, unknown>;
+    tags?: Record<string, string>;
+    user?: PulseUser;
+}
+export interface ErrorEventInput {
+    appId: string;
+    env: string;
+    release: string;
+    url?: string;
+    route?: string;
+    userAgent?: string;
+    source?: string;
+    component?: string;
+    handled?: boolean;
+    context?: Record<string, unknown>;
+    tags?: Record<string, string>;
+    user?: PulseUser;
+}
+export interface Transport {
+    send(events: PulseEvent[], options?: TransportSendOptions): Promise<boolean>;
+}
+export interface TransportSendOptions {
+    useBeacon?: boolean;
+}
+export interface LogSink {
+    write(events: PulseEvent[]): Promise<void>;
+}
+export interface ClsSinkConfig {
+    region: string;
+    topicId: string;
+    secretId?: string;
+    secretKey?: string;
+}
+export interface MemoryQueueOptions {
+    maxSize?: number;
+    maxRetries?: number;
+}
+export interface MemoryQueue<T> {
+    push(item: T): void;
+    drain(): T[];
+    size(): number;
+    flush(sender: (items: T[]) => Promise<boolean>): Promise<boolean>;
+}
+export declare function createEventId(): string;
+export declare function serializeError(error: unknown): ErrorPayload;
+export declare function createErrorEvent(error: unknown, input: ErrorEventInput): PulseEvent<ErrorPayload>;
+export declare function shouldSample(sampleRate?: number): boolean;
+export declare function redactSensitiveData<T>(value: T): T;
+export declare function createMemoryQueue<T>(options?: MemoryQueueOptions): MemoryQueue<T>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,94 @@
+const c = "[REDACTED]", i = /cookie|token|authorization|password|passwd|secret|credential|session/i;
+function u() {
+  const e = Math.random().toString(36).slice(2, 10);
+  return `evt_${Date.now().toString(36)}_${e}`;
+}
+function f(e) {
+  return e instanceof Error ? {
+    name: e.name,
+    message: e.message,
+    stack: e.stack
+  } : typeof e == "string" ? {
+    name: "NonError",
+    message: e
+  } : {
+    name: "NonError",
+    message: d(e)
+  };
+}
+function g(e, t) {
+  const r = f(e);
+  return E({
+    eventId: u(),
+    type: "error",
+    level: "error",
+    appId: t.appId,
+    env: t.env,
+    release: t.release,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    url: t.url,
+    route: t.route,
+    userAgent: t.userAgent,
+    payload: {
+      ...r,
+      source: t.source,
+      component: t.component,
+      handled: t.handled ?? !0
+    },
+    context: t.context,
+    tags: t.tags,
+    user: t.user
+  });
+}
+function l(e = 1) {
+  return e >= 1 ? !0 : e <= 0 ? !1 : Math.random() < e;
+}
+function E(e) {
+  return s(e);
+}
+function m(e = {}) {
+  const t = e.maxSize ?? 100, r = [];
+  return {
+    push(n) {
+      r.push(n), r.length > t && r.splice(0, r.length - t);
+    },
+    drain() {
+      return r.splice(0, r.length);
+    },
+    size() {
+      return r.length;
+    },
+    async flush(n) {
+      if (r.length === 0) return !0;
+      const o = r.splice(0, r.length), a = await n(o);
+      return a || r.unshift(...o), a;
+    }
+  };
+}
+function s(e) {
+  if (Array.isArray(e))
+    return e.map((t) => s(t));
+  if (e && typeof e == "object") {
+    const t = {};
+    for (const [r, n] of Object.entries(e))
+      t[r] = i.test(r) ? c : s(n);
+    return t;
+  }
+  return e;
+}
+function d(e) {
+  try {
+    return JSON.stringify(e);
+  } catch {
+    return String(e);
+  }
+}
+export {
+  g as createErrorEvent,
+  u as createEventId,
+  m as createMemoryQueue,
+  E as redactSensitiveData,
+  f as serializeError,
+  l as shouldSample
+};
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@kargo-pulse/core",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.cjs",
+    "dist/**/*.d.ts",
+    "package.json"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "devDependencies": {
+    "vite": "^6.2.2"
+  },
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.json --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit"
+  }
+}