@pionne/node 0.1.2 → 0.3.0

package/dist/index.cjs

@@ -35,7 +35,78 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 var os = __toESM(require("os"));
-var process = __toESM(require("process"));
+var process2 = __toESM(require("process"));
+
+// src/sessions.ts
+var crypto = __toESM(require("crypto"));
+var current = null;
+function sessionsUrl(ingestEndpoint) {
+  if (ingestEndpoint.endsWith("/ingest")) {
+    return ingestEndpoint.slice(0, -"/ingest".length) + "/sessions";
+  }
+  return ingestEndpoint.replace(/\/+$/, "") + "/sessions";
+}
+function postSession(state, status, durationMs) {
+  const url = sessionsUrl(state.ctx.endpoint);
+  const body = {
+    session_id: state.id,
+    status,
+    release: state.ctx.release,
+    environment: state.ctx.environment,
+    app_version: state.ctx.appVersion,
+    os_name: state.ctx.osName,
+    user_id_anon: state.ctx.userIdAnon,
+    duration_ms: durationMs
+  };
+  for (const k of Object.keys(body)) {
+    if (body[k] === void 0) delete body[k];
+  }
+  fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "X-Pionne-Token": state.ctx.token
+    },
+    body: JSON.stringify(body)
+  }).catch(() => void 0);
+}
+function startSession(ctx) {
+  current = {
+    id: crypto.randomUUID(),
+    startedAt: Date.now(),
+    status: "ok",
+    ctx
+  };
+  postSession(current, "ok");
+  const onShutdown = () => {
+    if (!current || current.status !== "ok") return;
+    flipSession("exited");
+  };
+  process.once("beforeExit", onShutdown);
+  return current.id;
+}
+function flipSession(status) {
+  if (!current) return;
+  const rank = { ok: 0, exited: 1, errored: 2, abnormal: 3, crashed: 4 };
+  if (rank[status] <= rank[current.status]) return;
+  current.status = status;
+  postSession(current, status, Date.now() - current.startedAt);
+}
+function endSession(status = "exited") {
+  if (!current) return;
+  flipSession(status);
+  current = null;
+}
+function getCurrentSessionId() {
+  return current?.id ?? null;
+}
+function flipFromEvent(level, mechanismType) {
+  if (mechanismType === "manual") return;
+  if (level === "fatal") flipSession("crashed");
+  else if (level === "error") flipSession("errored");
+}
+
+// src/index.ts
 var DEFAULT_ENDPOINT = "https://pionne.agkgcreations.fr/api/ingest";
 var DEFAULT_MAX_STACK = 50;
 var SDK_NAME = "pionne.node";
@@ -58,22 +129,22 @@ function gatherStaticContext() {
       sdk: { name: SDK_NAME, version: SDK_VERSION },
       runtime: {
         name: "node",
-        version: process.versions.node,
-        v8: process.versions.v8
+        version: process2.versions.node,
+        v8: process2.versions.v8
       },
       os: {
         name: os.type(),
         version: os.release(),
-        platform: process.platform,
-        arch: process.arch,
+        platform: process2.platform,
+        arch: process2.arch,
         cpu_count: os.cpus().length,
         total_memory: os.totalmem(),
         free_memory: os.freemem()
       },
       app: {
         hostname: os.hostname(),
-        pid: process.pid,
-        cwd: process.cwd()
+        pid: process2.pid,
+        cwd: process2.cwd()
       }
     }
   };
@@ -125,22 +196,26 @@ function installUncaughtHandler() {
     const event = buildEvent(err, "fatal", "uncaughtException", false);
     if (event) {
       void send(event);
+      flipFromEvent(event.level, event.mechanism?.type ?? "uncaughtException");
     }
   };
-  process.on("uncaughtException", onUncaught);
+  process2.on("uncaughtException", onUncaught);
 }
 function installRejectionHandler() {
   onRejection = (reason) => {
     const err = reason instanceof Error ? reason : new Error(String(reason));
     const event = buildEvent(err, "error", "unhandledRejection", false);
-    if (event) void send(event);
+    if (event) {
+      void send(event);
+      flipFromEvent(event.level, event.mechanism?.type ?? "unhandledRejection");
+    }
   };
-  process.on("unhandledRejection", onRejection);
+  process2.on("unhandledRejection", onRejection);
 }
 var Pionne = {
   init(options) {
     if (!options?.token || !options.token.startsWith("pio_live_")) {
-      if (process.env.NODE_ENV !== "production") {
+      if (process2.env.NODE_ENV !== "production") {
         console.warn(
           "[Pionne] Missing or invalid token (must start with pio_live_)."
         );
@@ -153,7 +228,7 @@ var Pionne = {
       token: options.token,
       endpoint: options.endpoint ?? DEFAULT_ENDPOINT,
       release: options.release,
-      environment: options.environment ?? process.env.NODE_ENV ?? "production",
+      environment: options.environment ?? process2.env.NODE_ENV ?? "production",
       enabled: options.enabled ?? true,
       captureUncaughtExceptions: options.captureUncaughtExceptions ?? true,
       captureUnhandledRejections: options.captureUnhandledRejections ?? true,
@@ -165,6 +240,17 @@ var Pionne = {
     };
     if (config.captureUncaughtExceptions) installUncaughtHandler();
     if (config.captureUnhandledRejections) installRejectionHandler();
+    if (options.releaseHealth !== false) {
+      startSession({
+        endpoint: config.endpoint,
+        token: config.token,
+        release: config.release,
+        environment: config.environment,
+        appVersion: staticContext.app_version,
+        osName: staticContext.os_name,
+        userIdAnon: config.userIdAnon
+      });
+    }
   },
   captureException(err, extra) {
     const event = buildEvent(
@@ -203,12 +289,21 @@ var Pionne = {
    * clean shutdown. Re-init by calling `init()` again.
    */
   uninstall() {
-    if (onUncaught) process.removeListener("uncaughtException", onUncaught);
-    if (onRejection) process.removeListener("unhandledRejection", onRejection);
+    if (onUncaught) process2.removeListener("uncaughtException", onUncaught);
+    if (onRejection) process2.removeListener("unhandledRejection", onRejection);
     onUncaught = null;
     onRejection = null;
     config = null;
     staticContext = {};
+  },
+  // ─── Release Health ───────────────────────────────────────────────────
+  /** Manually end the current session (status='exited'). */
+  endSession() {
+    endSession();
+  },
+  /** UUID of the current open session (for diagnostics). */
+  getSessionId() {
+    return getCurrentSessionId();
   }
 };
 function expressErrorHandler(err, _req, _res, next) {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import * as os from 'node:os';\nimport * as process from 'node:process';\n\nexport type Level = 'fatal' | 'error' | 'warning' | 'info';\nexport type MechanismType =\n  | 'uncaughtException'\n  | 'unhandledRejection'\n  | 'manual';\n\nexport interface Mechanism {\n  type: MechanismType;\n  handled: boolean;\n}\n\nexport interface PionneEvent {\n  exception_type: string;\n  message?: string | null;\n  stack?: string[];\n  level?: Level;\n\n  release?: string;\n  environment?: string;\n  app_version?: string;\n  os_name?: string;\n  os_version?: string;\n  user_id_anon?: string;\n  locale?: string;\n  timezone?: string;\n\n  contexts?: Record<string, Record<string, unknown> | undefined>;\n  mechanism?: Mechanism;\n  tags?: Record<string, string>;\n}\n\nexport interface PionneOptions {\n  /** Project token (starts with `pio_live_`). Required. */\n  token: string;\n  endpoint?: string;\n  release?: string;\n  environment?: string;\n  enabled?: boolean;\n  captureUncaughtExceptions?: boolean;\n  captureUnhandledRejections?: boolean;\n  autoContext?: boolean;\n  beforeSend?: (event: PionneEvent) => PionneEvent | null;\n  userIdAnon?: string;\n  tags?: Record<string, string>;\n  maxStackFrames?: number;\n}\n\nconst DEFAULT_ENDPOINT = 'https://pionne.agkgcreations.fr/api/ingest';\nconst DEFAULT_MAX_STACK = 50;\nconst SDK_NAME = 'pionne.node';\nconst SDK_VERSION = '0.1.0';\n\ntype ResolvedConfig = Required<\n  Omit<PionneOptions, 'beforeSend' | 'userIdAnon' | 'tags' | 'release'>\n> & {\n  beforeSend?: PionneOptions['beforeSend'];\n  userIdAnon?: string;\n  tags?: Record<string, string>;\n  release?: string;\n};\n\nlet config: ResolvedConfig | null = null;\nlet staticContext: Partial<PionneEvent> = {};\nlet onUncaught: ((err: Error) => void) | null = null;\nlet onRejection: ((reason: unknown) => void) | null = null;\n\nfunction gatherStaticContext(): Partial<PionneEvent> {\n  let timezone: string | undefined;\n  try {\n    timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;\n  } catch {\n    // ignore\n  }\n  return {\n    os_name: os.type(),\n    os_version: os.release(),\n    timezone,\n    contexts: {\n      sdk: { name: SDK_NAME, version: SDK_VERSION },\n      runtime: {\n        name: 'node',\n        version: process.versions.node,\n        v8: process.versions.v8,\n      },\n      os: {\n        name: os.type(),\n        version: os.release(),\n        platform: process.platform,\n        arch: process.arch,\n        cpu_count: os.cpus().length,\n        total_memory: os.totalmem(),\n        free_memory: os.freemem(),\n      },\n      app: {\n        hostname: os.hostname(),\n        pid: process.pid,\n        cwd: process.cwd(),\n      },\n    },\n  };\n}\n\nfunction parseStack(error: Error, max: number): string[] {\n  if (!error.stack) return [];\n  return error.stack\n    .split('\\n')\n    .slice(0, max)\n    .map((s) => s.trim())\n    .filter(Boolean);\n}\n\nfunction buildEvent(\n  err: unknown,\n  level: Level,\n  mechanism: MechanismType,\n  handled: boolean,\n  extra?: Partial<PionneEvent>,\n): PionneEvent | null {\n  if (!config || !config.enabled) return null;\n  const e = err instanceof Error ? err : new Error(String(err));\n  const event: PionneEvent = {\n    ...staticContext,\n    exception_type: e.name || 'Error',\n    message: e.message || null,\n    stack: parseStack(e, config.maxStackFrames),\n    level,\n    release: config.release,\n    environment: config.environment,\n    user_id_anon: config.userIdAnon,\n    tags: config.tags,\n    mechanism: { type: mechanism, handled },\n    ...extra,\n  };\n  if (config.beforeSend) {\n    const result = config.beforeSend(event);\n    if (!result) return null;\n    return result;\n  }\n  return event;\n}\n\nasync function send(event: PionneEvent): Promise<void> {\n  if (!config) return;\n  try {\n    // Node >=18 has global `fetch`. We rely on it instead of pulling in\n    // node-fetch / undici as a dependency.\n    if (typeof fetch !== 'function') return;\n    await fetch(config.endpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'X-Pionne-Token': config.token,\n      },\n      body: JSON.stringify(event),\n    });\n  } catch {\n    // Best-effort: a monitoring SDK must never crash the host process.\n  }\n}\n\nfunction installUncaughtHandler(): void {\n  onUncaught = (err: Error) => {\n    const event = buildEvent(err, 'fatal', 'uncaughtException', false);\n    if (event) {\n      // Fire-and-forget: process is going to die anyway. Best we can do is\n      // try to flush before exit, but Node will tear down imminently.\n      void send(event);\n    }\n  };\n  process.on('uncaughtException', onUncaught);\n}\n\nfunction installRejectionHandler(): void {\n  onRejection = (reason: unknown) => {\n    const err = reason instanceof Error ? reason : new Error(String(reason));\n    const event = buildEvent(err, 'error', 'unhandledRejection', false);\n    if (event) void send(event);\n  };\n  process.on('unhandledRejection', onRejection);\n}\n\nexport const Pionne = {\n  init(options: PionneOptions): void {\n    if (!options?.token || !options.token.startsWith('pio_live_')) {\n      if (process.env.NODE_ENV !== 'production') {\n        console.warn(\n          '[Pionne] Missing or invalid token (must start with pio_live_).',\n        );\n      }\n      return;\n    }\n\n    const autoContext = options.autoContext ?? true;\n    staticContext = autoContext ? gatherStaticContext() : {};\n\n    config = {\n      token: options.token,\n      endpoint: options.endpoint ?? DEFAULT_ENDPOINT,\n      release: options.release,\n      environment:\n        options.environment ?? process.env.NODE_ENV ?? 'production',\n      enabled: options.enabled ?? true,\n      captureUncaughtExceptions: options.captureUncaughtExceptions ?? true,\n      captureUnhandledRejections: options.captureUnhandledRejections ?? true,\n      autoContext,\n      beforeSend: options.beforeSend,\n      userIdAnon: options.userIdAnon,\n      tags: options.tags,\n      maxStackFrames: options.maxStackFrames ?? DEFAULT_MAX_STACK,\n    };\n\n    if (config.captureUncaughtExceptions) installUncaughtHandler();\n    if (config.captureUnhandledRejections) installRejectionHandler();\n  },\n\n  captureException(err: unknown, extra?: Partial<PionneEvent>): void {\n    const event = buildEvent(\n      err,\n      extra?.level ?? 'error',\n      'manual',\n      true,\n      extra,\n    );\n    if (event) void send(event);\n  },\n\n  captureMessage(message: string, extra?: Partial<PionneEvent>): void {\n    const event = buildEvent(\n      new Error(message),\n      extra?.level ?? 'info',\n      'manual',\n      true,\n      { exception_type: 'Message', ...extra },\n    );\n    if (event) void send(event);\n  },\n\n  setUser(userIdAnon: string | null): void {\n    if (!config) return;\n    config.userIdAnon = userIdAnon ?? undefined;\n  },\n\n  setTags(tags: Record<string, string> | null): void {\n    if (!config) return;\n    config.tags = tags ?? undefined;\n  },\n\n  setEnabled(enabled: boolean): void {\n    if (!config) return;\n    config.enabled = enabled;\n  },\n\n  /**\n   * Detach all auto handlers. Useful in tests / CLI scripts that need a\n   * clean shutdown. Re-init by calling `init()` again.\n   */\n  uninstall(): void {\n    if (onUncaught) process.removeListener('uncaughtException', onUncaught);\n    if (onRejection) process.removeListener('unhandledRejection', onRejection);\n    onUncaught = null;\n    onRejection = null;\n    config = null;\n    staticContext = {};\n  },\n};\n\n/**\n * Express / Connect / NestJS error middleware. Reports the error then passes\n * it down the chain. Mount it AFTER your routes:\n *\n *   import { Pionne, expressErrorHandler } from '@pionne/node';\n *   app.use(expressErrorHandler);\n *   // your fallback error handler here\n */\nexport function expressErrorHandler(\n  err: unknown,\n  _req: unknown,\n  _res: unknown,\n  next: (err?: unknown) => void,\n): void {\n  Pionne.captureException(err);\n  next(err);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/sessions.ts"],"sourcesContent":["import * as os from 'node:os';\nimport * as process from 'node:process';\n\nimport {\n  endSession as _endSession,\n  flipFromEvent,\n  getCurrentSessionId,\n  startSession as _startSession,\n} from './sessions';\n\nexport type Level = 'fatal' | 'error' | 'warning' | 'info';\nexport type MechanismType =\n  | 'uncaughtException'\n  | 'unhandledRejection'\n  | 'manual';\n\nexport interface Mechanism {\n  type: MechanismType;\n  handled: boolean;\n}\n\nexport interface PionneEvent {\n  exception_type: string;\n  message?: string | null;\n  stack?: string[];\n  level?: Level;\n\n  release?: string;\n  environment?: string;\n  app_version?: string;\n  os_name?: string;\n  os_version?: string;\n  user_id_anon?: string;\n  locale?: string;\n  timezone?: string;\n\n  contexts?: Record<string, Record<string, unknown> | undefined>;\n  mechanism?: Mechanism;\n  tags?: Record<string, string>;\n}\n\nexport interface PionneOptions {\n  /** Project token (starts with `pio_live_`). Required. */\n  token: string;\n  endpoint?: string;\n  release?: string;\n  environment?: string;\n  enabled?: boolean;\n  captureUncaughtExceptions?: boolean;\n  captureUnhandledRejections?: boolean;\n  autoContext?: boolean;\n  beforeSend?: (event: PionneEvent) => PionneEvent | null;\n  userIdAnon?: string;\n  tags?: Record<string, string>;\n  maxStackFrames?: number;\n  /**\n   * Release Health — opens a session at init() with status='ok', flips to\n   * 'crashed'/'errored' if a fatal/error fires through the global handlers.\n   * The dashboard derives crash-free user rate per release. Default: true.\n   */\n  releaseHealth?: boolean;\n}\n\nconst DEFAULT_ENDPOINT = 'https://pionne.agkgcreations.fr/api/ingest';\nconst DEFAULT_MAX_STACK = 50;\nconst SDK_NAME = 'pionne.node';\nconst SDK_VERSION = '0.1.0';\n\ntype ResolvedConfig = Required<\n  Omit<PionneOptions, 'beforeSend' | 'userIdAnon' | 'tags' | 'release' | 'releaseHealth'>\n> & {\n  beforeSend?: PionneOptions['beforeSend'];\n  userIdAnon?: string;\n  tags?: Record<string, string>;\n  release?: string;\n};\n\nlet config: ResolvedConfig | null = null;\nlet staticContext: Partial<PionneEvent> = {};\nlet onUncaught: ((err: Error) => void) | null = null;\nlet onRejection: ((reason: unknown) => void) | null = null;\n\nfunction gatherStaticContext(): Partial<PionneEvent> {\n  let timezone: string | undefined;\n  try {\n    timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;\n  } catch {\n    // ignore\n  }\n  return {\n    os_name: os.type(),\n    os_version: os.release(),\n    timezone,\n    contexts: {\n      sdk: { name: SDK_NAME, version: SDK_VERSION },\n      runtime: {\n        name: 'node',\n        version: process.versions.node,\n        v8: process.versions.v8,\n      },\n      os: {\n        name: os.type(),\n        version: os.release(),\n        platform: process.platform,\n        arch: process.arch,\n        cpu_count: os.cpus().length,\n        total_memory: os.totalmem(),\n        free_memory: os.freemem(),\n      },\n      app: {\n        hostname: os.hostname(),\n        pid: process.pid,\n        cwd: process.cwd(),\n      },\n    },\n  };\n}\n\nfunction parseStack(error: Error, max: number): string[] {\n  if (!error.stack) return [];\n  return error.stack\n    .split('\\n')\n    .slice(0, max)\n    .map((s) => s.trim())\n    .filter(Boolean);\n}\n\nfunction buildEvent(\n  err: unknown,\n  level: Level,\n  mechanism: MechanismType,\n  handled: boolean,\n  extra?: Partial<PionneEvent>,\n): PionneEvent | null {\n  if (!config || !config.enabled) return null;\n  const e = err instanceof Error ? err : new Error(String(err));\n  const event: PionneEvent = {\n    ...staticContext,\n    exception_type: e.name || 'Error',\n    message: e.message || null,\n    stack: parseStack(e, config.maxStackFrames),\n    level,\n    release: config.release,\n    environment: config.environment,\n    user_id_anon: config.userIdAnon,\n    tags: config.tags,\n    mechanism: { type: mechanism, handled },\n    ...extra,\n  };\n  if (config.beforeSend) {\n    const result = config.beforeSend(event);\n    if (!result) return null;\n    return result;\n  }\n  return event;\n}\n\nasync function send(event: PionneEvent): Promise<void> {\n  if (!config) return;\n  try {\n    // Node >=18 has global `fetch`. We rely on it instead of pulling in\n    // node-fetch / undici as a dependency.\n    if (typeof fetch !== 'function') return;\n    await fetch(config.endpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'X-Pionne-Token': config.token,\n      },\n      body: JSON.stringify(event),\n    });\n  } catch {\n    // Best-effort: a monitoring SDK must never crash the host process.\n  }\n}\n\nfunction installUncaughtHandler(): void {\n  onUncaught = (err: Error) => {\n    const event = buildEvent(err, 'fatal', 'uncaughtException', false);\n    if (event) {\n      // Fire-and-forget: process is going to die anyway. Best we can do is\n      // try to flush before exit, but Node will tear down imminently.\n      void send(event);\n      flipFromEvent(event.level, event.mechanism?.type ?? 'uncaughtException');\n    }\n  };\n  process.on('uncaughtException', onUncaught);\n}\n\nfunction installRejectionHandler(): void {\n  onRejection = (reason: unknown) => {\n    const err = reason instanceof Error ? reason : new Error(String(reason));\n    const event = buildEvent(err, 'error', 'unhandledRejection', false);\n    if (event) {\n      void send(event);\n      flipFromEvent(event.level, event.mechanism?.type ?? 'unhandledRejection');\n    }\n  };\n  process.on('unhandledRejection', onRejection);\n}\n\nexport const Pionne = {\n  init(options: PionneOptions): void {\n    if (!options?.token || !options.token.startsWith('pio_live_')) {\n      if (process.env.NODE_ENV !== 'production') {\n        console.warn(\n          '[Pionne] Missing or invalid token (must start with pio_live_).',\n        );\n      }\n      return;\n    }\n\n    const autoContext = options.autoContext ?? true;\n    staticContext = autoContext ? gatherStaticContext() : {};\n\n    config = {\n      token: options.token,\n      endpoint: options.endpoint ?? DEFAULT_ENDPOINT,\n      release: options.release,\n      environment:\n        options.environment ?? process.env.NODE_ENV ?? 'production',\n      enabled: options.enabled ?? true,\n      captureUncaughtExceptions: options.captureUncaughtExceptions ?? true,\n      captureUnhandledRejections: options.captureUnhandledRejections ?? true,\n      autoContext,\n      beforeSend: options.beforeSend,\n      userIdAnon: options.userIdAnon,\n      tags: options.tags,\n      maxStackFrames: options.maxStackFrames ?? DEFAULT_MAX_STACK,\n    };\n\n    if (config.captureUncaughtExceptions) installUncaughtHandler();\n    if (config.captureUnhandledRejections) installRejectionHandler();\n\n    // Release Health — open a session unless the host opted out.\n    if (options.releaseHealth !== false) {\n      _startSession({\n        endpoint: config.endpoint,\n        token: config.token,\n        release: config.release,\n        environment: config.environment,\n        appVersion: staticContext.app_version,\n        osName: staticContext.os_name,\n        userIdAnon: config.userIdAnon,\n      });\n    }\n  },\n\n  captureException(err: unknown, extra?: Partial<PionneEvent>): void {\n    const event = buildEvent(\n      err,\n      extra?.level ?? 'error',\n      'manual',\n      true,\n      extra,\n    );\n    if (event) void send(event);\n  },\n\n  captureMessage(message: string, extra?: Partial<PionneEvent>): void {\n    const event = buildEvent(\n      new Error(message),\n      extra?.level ?? 'info',\n      'manual',\n      true,\n      { exception_type: 'Message', ...extra },\n    );\n    if (event) void send(event);\n  },\n\n  setUser(userIdAnon: string | null): void {\n    if (!config) return;\n    config.userIdAnon = userIdAnon ?? undefined;\n  },\n\n  setTags(tags: Record<string, string> | null): void {\n    if (!config) return;\n    config.tags = tags ?? undefined;\n  },\n\n  setEnabled(enabled: boolean): void {\n    if (!config) return;\n    config.enabled = enabled;\n  },\n\n  /**\n   * Detach all auto handlers. Useful in tests / CLI scripts that need a\n   * clean shutdown. Re-init by calling `init()` again.\n   */\n  uninstall(): void {\n    if (onUncaught) process.removeListener('uncaughtException', onUncaught);\n    if (onRejection) process.removeListener('unhandledRejection', onRejection);\n    onUncaught = null;\n    onRejection = null;\n    config = null;\n    staticContext = {};\n  },\n\n  // ─── Release Health ───────────────────────────────────────────────────\n\n  /** Manually end the current session (status='exited'). */\n  endSession(): void {\n    _endSession();\n  },\n\n  /** UUID of the current open session (for diagnostics). */\n  getSessionId(): string | null {\n    return getCurrentSessionId();\n  },\n};\n\n/**\n * Express / Connect / NestJS error middleware. Reports the error then passes\n * it down the chain. Mount it AFTER your routes:\n *\n *   import { Pionne, expressErrorHandler } from '@pionne/node';\n *   app.use(expressErrorHandler);\n *   // your fallback error handler here\n */\nexport function expressErrorHandler(\n  err: unknown,\n  _req: unknown,\n  _res: unknown,\n  next: (err?: unknown) => void,\n): void {\n  Pionne.captureException(err);\n  next(err);\n}\n","// Release Health for Node.js. Same protocol as the browser/RN SDKs.\n// We auto-flip on uncaughtException/unhandledRejection through the host\n// SDK's existing handlers, and best-effort-emit 'exited' on process.exit.\n\nimport * as crypto from 'node:crypto';\n\nexport type SessionStatus = 'ok' | 'crashed' | 'errored' | 'abnormal' | 'exited';\n\nexport interface SessionContext {\n  endpoint: string;\n  token: string;\n  release?: string;\n  environment?: string;\n  appVersion?: string;\n  osName?: string;\n  userIdAnon?: string;\n}\n\ninterface SessionState {\n  id: string;\n  startedAt: number;\n  status: SessionStatus;\n  ctx: SessionContext;\n}\n\nlet current: SessionState | null = null;\n\nfunction sessionsUrl(ingestEndpoint: string): string {\n  if (ingestEndpoint.endsWith('/ingest')) {\n    return ingestEndpoint.slice(0, -'/ingest'.length) + '/sessions';\n  }\n  return ingestEndpoint.replace(/\\/+$/, '') + '/sessions';\n}\n\nfunction postSession(state: SessionState, status: SessionStatus, durationMs?: number): void {\n  const url = sessionsUrl(state.ctx.endpoint);\n  const body = {\n    session_id: state.id,\n    status,\n    release: state.ctx.release,\n    environment: state.ctx.environment,\n    app_version: state.ctx.appVersion,\n    os_name: state.ctx.osName,\n    user_id_anon: state.ctx.userIdAnon,\n    duration_ms: durationMs,\n  };\n  for (const k of Object.keys(body) as (keyof typeof body)[]) {\n    if (body[k] === undefined) delete body[k];\n  }\n  // Node 18+ has global fetch.\n  fetch(url, {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/json',\n      'X-Pionne-Token': state.ctx.token,\n    },\n    body: JSON.stringify(body),\n  }).catch(() => undefined);\n}\n\nexport function startSession(ctx: SessionContext): string {\n  current = {\n    id: crypto.randomUUID(),\n    startedAt: Date.now(),\n    status: 'ok',\n    ctx,\n  };\n  postSession(current, 'ok');\n\n  // Best-effort 'exited' flip on graceful shutdown. We listen on 'exit'\n  // (sync only — no async I/O guaranteed) and 'beforeExit' (where async\n  // works). The actual session POST is fire-and-forget anyway.\n  const onShutdown = () => {\n    if (!current || current.status !== 'ok') return;\n    flipSession('exited');\n  };\n  process.once('beforeExit', onShutdown);\n\n  return current.id;\n}\n\nexport function flipSession(status: SessionStatus): void {\n  if (!current) return;\n  const rank: Record<SessionStatus, number> =\n    { ok: 0, exited: 1, errored: 2, abnormal: 3, crashed: 4 };\n  if (rank[status] <= rank[current.status]) return;\n  current.status = status;\n  postSession(current, status, Date.now() - current.startedAt);\n}\n\nexport function endSession(status: SessionStatus = 'exited'): void {\n  if (!current) return;\n  flipSession(status);\n  current = null;\n}\n\nexport function getCurrentSessionId(): string | null {\n  return current?.id ?? null;\n}\n\nexport function flipFromEvent(\n  level: 'fatal' | 'error' | 'warning' | 'info' | undefined,\n  mechanismType: string,\n): void {\n  if (mechanismType === 'manual') return;\n  if (level === 'fatal') flipSession('crashed');\n  else if (level === 'error') flipSession('errored');\n}\n"],"mappings":"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","names":["process"]}

package/dist/index.d.mts

@@ -35,6 +35,12 @@ interface PionneOptions {
     userIdAnon?: string;
     tags?: Record<string, string>;
     maxStackFrames?: number;
+    /**
+     * Release Health — opens a session at init() with status='ok', flips to
+     * 'crashed'/'errored' if a fatal/error fires through the global handlers.
+     * The dashboard derives crash-free user rate per release. Default: true.
+     */
+    releaseHealth?: boolean;
 }
 declare const Pionne: {
     init(options: PionneOptions): void;
@@ -48,6 +54,10 @@ declare const Pionne: {
      * clean shutdown. Re-init by calling `init()` again.
      */
     uninstall(): void;
+    /** Manually end the current session (status='exited'). */
+    endSession(): void;
+    /** UUID of the current open session (for diagnostics). */
+    getSessionId(): string | null;
 };
 /**
  * Express / Connect / NestJS error middleware. Reports the error then passes

package/dist/index.d.ts

@@ -35,6 +35,12 @@ interface PionneOptions {
     userIdAnon?: string;
     tags?: Record<string, string>;
     maxStackFrames?: number;
+    /**
+     * Release Health — opens a session at init() with status='ok', flips to
+     * 'crashed'/'errored' if a fatal/error fires through the global handlers.
+     * The dashboard derives crash-free user rate per release. Default: true.
+     */
+    releaseHealth?: boolean;
 }
 declare const Pionne: {
     init(options: PionneOptions): void;
@@ -48,6 +54,10 @@ declare const Pionne: {
      * clean shutdown. Re-init by calling `init()` again.
      */
     uninstall(): void;
+    /** Manually end the current session (status='exited'). */
+    endSession(): void;
+    /** UUID of the current open session (for diagnostics). */
+    getSessionId(): string | null;
 };
 /**
  * Express / Connect / NestJS error middleware. Reports the error then passes

package/dist/index.mjs

@@ -1,6 +1,77 @@
 // src/index.ts
 import * as os from "os";
-import * as process from "process";
+import * as process2 from "process";
+
+// src/sessions.ts
+import * as crypto from "crypto";
+var current = null;
+function sessionsUrl(ingestEndpoint) {
+  if (ingestEndpoint.endsWith("/ingest")) {
+    return ingestEndpoint.slice(0, -"/ingest".length) + "/sessions";
+  }
+  return ingestEndpoint.replace(/\/+$/, "") + "/sessions";
+}
+function postSession(state, status, durationMs) {
+  const url = sessionsUrl(state.ctx.endpoint);
+  const body = {
+    session_id: state.id,
+    status,
+    release: state.ctx.release,
+    environment: state.ctx.environment,
+    app_version: state.ctx.appVersion,
+    os_name: state.ctx.osName,
+    user_id_anon: state.ctx.userIdAnon,
+    duration_ms: durationMs
+  };
+  for (const k of Object.keys(body)) {
+    if (body[k] === void 0) delete body[k];
+  }
+  fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "X-Pionne-Token": state.ctx.token
+    },
+    body: JSON.stringify(body)
+  }).catch(() => void 0);
+}
+function startSession(ctx) {
+  current = {
+    id: crypto.randomUUID(),
+    startedAt: Date.now(),
+    status: "ok",
+    ctx
+  };
+  postSession(current, "ok");
+  const onShutdown = () => {
+    if (!current || current.status !== "ok") return;
+    flipSession("exited");
+  };
+  process.once("beforeExit", onShutdown);
+  return current.id;
+}
+function flipSession(status) {
+  if (!current) return;
+  const rank = { ok: 0, exited: 1, errored: 2, abnormal: 3, crashed: 4 };
+  if (rank[status] <= rank[current.status]) return;
+  current.status = status;
+  postSession(current, status, Date.now() - current.startedAt);
+}
+function endSession(status = "exited") {
+  if (!current) return;
+  flipSession(status);
+  current = null;
+}
+function getCurrentSessionId() {
+  return current?.id ?? null;
+}
+function flipFromEvent(level, mechanismType) {
+  if (mechanismType === "manual") return;
+  if (level === "fatal") flipSession("crashed");
+  else if (level === "error") flipSession("errored");
+}
+
+// src/index.ts
 var DEFAULT_ENDPOINT = "https://pionne.agkgcreations.fr/api/ingest";
 var DEFAULT_MAX_STACK = 50;
 var SDK_NAME = "pionne.node";
@@ -23,22 +94,22 @@ function gatherStaticContext() {
       sdk: { name: SDK_NAME, version: SDK_VERSION },
       runtime: {
         name: "node",
-        version: process.versions.node,
-        v8: process.versions.v8
+        version: process2.versions.node,
+        v8: process2.versions.v8
       },
       os: {
         name: os.type(),
         version: os.release(),
-        platform: process.platform,
-        arch: process.arch,
+        platform: process2.platform,
+        arch: process2.arch,
         cpu_count: os.cpus().length,
         total_memory: os.totalmem(),
         free_memory: os.freemem()
       },
       app: {
         hostname: os.hostname(),
-        pid: process.pid,
-        cwd: process.cwd()
+        pid: process2.pid,
+        cwd: process2.cwd()
       }
     }
   };
@@ -90,22 +161,26 @@ function installUncaughtHandler() {
     const event = buildEvent(err, "fatal", "uncaughtException", false);
     if (event) {
       void send(event);
+      flipFromEvent(event.level, event.mechanism?.type ?? "uncaughtException");
     }
   };
-  process.on("uncaughtException", onUncaught);
+  process2.on("uncaughtException", onUncaught);
 }
 function installRejectionHandler() {
   onRejection = (reason) => {
     const err = reason instanceof Error ? reason : new Error(String(reason));
     const event = buildEvent(err, "error", "unhandledRejection", false);
-    if (event) void send(event);
+    if (event) {
+      void send(event);
+      flipFromEvent(event.level, event.mechanism?.type ?? "unhandledRejection");
+    }
   };
-  process.on("unhandledRejection", onRejection);
+  process2.on("unhandledRejection", onRejection);
 }
 var Pionne = {
   init(options) {
     if (!options?.token || !options.token.startsWith("pio_live_")) {
-      if (process.env.NODE_ENV !== "production") {
+      if (process2.env.NODE_ENV !== "production") {
         console.warn(
           "[Pionne] Missing or invalid token (must start with pio_live_)."
         );
@@ -118,7 +193,7 @@ var Pionne = {
       token: options.token,
       endpoint: options.endpoint ?? DEFAULT_ENDPOINT,
       release: options.release,
-      environment: options.environment ?? process.env.NODE_ENV ?? "production",
+      environment: options.environment ?? process2.env.NODE_ENV ?? "production",
       enabled: options.enabled ?? true,
       captureUncaughtExceptions: options.captureUncaughtExceptions ?? true,
       captureUnhandledRejections: options.captureUnhandledRejections ?? true,
@@ -130,6 +205,17 @@ var Pionne = {
     };
     if (config.captureUncaughtExceptions) installUncaughtHandler();
     if (config.captureUnhandledRejections) installRejectionHandler();
+    if (options.releaseHealth !== false) {
+      startSession({
+        endpoint: config.endpoint,
+        token: config.token,
+        release: config.release,
+        environment: config.environment,
+        appVersion: staticContext.app_version,
+        osName: staticContext.os_name,
+        userIdAnon: config.userIdAnon
+      });
+    }
   },
   captureException(err, extra) {
     const event = buildEvent(
@@ -168,12 +254,21 @@ var Pionne = {
    * clean shutdown. Re-init by calling `init()` again.
    */
   uninstall() {
-    if (onUncaught) process.removeListener("uncaughtException", onUncaught);
-    if (onRejection) process.removeListener("unhandledRejection", onRejection);
+    if (onUncaught) process2.removeListener("uncaughtException", onUncaught);
+    if (onRejection) process2.removeListener("unhandledRejection", onRejection);
     onUncaught = null;
     onRejection = null;
     config = null;
     staticContext = {};
+  },
+  // ─── Release Health ───────────────────────────────────────────────────
+  /** Manually end the current session (status='exited'). */
+  endSession() {
+    endSession();
+  },
+  /** UUID of the current open session (for diagnostics). */
+  getSessionId() {
+    return getCurrentSessionId();
   }
 };
 function expressErrorHandler(err, _req, _res, next) {

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import * as os from 'node:os';\nimport * as process from 'node:process';\n\nexport type Level = 'fatal' | 'error' | 'warning' | 'info';\nexport type MechanismType =\n  | 'uncaughtException'\n  | 'unhandledRejection'\n  | 'manual';\n\nexport interface Mechanism {\n  type: MechanismType;\n  handled: boolean;\n}\n\nexport interface PionneEvent {\n  exception_type: string;\n  message?: string | null;\n  stack?: string[];\n  level?: Level;\n\n  release?: string;\n  environment?: string;\n  app_version?: string;\n  os_name?: string;\n  os_version?: string;\n  user_id_anon?: string;\n  locale?: string;\n  timezone?: string;\n\n  contexts?: Record<string, Record<string, unknown> | undefined>;\n  mechanism?: Mechanism;\n  tags?: Record<string, string>;\n}\n\nexport interface PionneOptions {\n  /** Project token (starts with `pio_live_`). Required. */\n  token: string;\n  endpoint?: string;\n  release?: string;\n  environment?: string;\n  enabled?: boolean;\n  captureUncaughtExceptions?: boolean;\n  captureUnhandledRejections?: boolean;\n  autoContext?: boolean;\n  beforeSend?: (event: PionneEvent) => PionneEvent | null;\n  userIdAnon?: string;\n  tags?: Record<string, string>;\n  maxStackFrames?: number;\n}\n\nconst DEFAULT_ENDPOINT = 'https://pionne.agkgcreations.fr/api/ingest';\nconst DEFAULT_MAX_STACK = 50;\nconst SDK_NAME = 'pionne.node';\nconst SDK_VERSION = '0.1.0';\n\ntype ResolvedConfig = Required<\n  Omit<PionneOptions, 'beforeSend' | 'userIdAnon' | 'tags' | 'release'>\n> & {\n  beforeSend?: PionneOptions['beforeSend'];\n  userIdAnon?: string;\n  tags?: Record<string, string>;\n  release?: string;\n};\n\nlet config: ResolvedConfig | null = null;\nlet staticContext: Partial<PionneEvent> = {};\nlet onUncaught: ((err: Error) => void) | null = null;\nlet onRejection: ((reason: unknown) => void) | null = null;\n\nfunction gatherStaticContext(): Partial<PionneEvent> {\n  let timezone: string | undefined;\n  try {\n    timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;\n  } catch {\n    // ignore\n  }\n  return {\n    os_name: os.type(),\n    os_version: os.release(),\n    timezone,\n    contexts: {\n      sdk: { name: SDK_NAME, version: SDK_VERSION },\n      runtime: {\n        name: 'node',\n        version: process.versions.node,\n        v8: process.versions.v8,\n      },\n      os: {\n        name: os.type(),\n        version: os.release(),\n        platform: process.platform,\n        arch: process.arch,\n        cpu_count: os.cpus().length,\n        total_memory: os.totalmem(),\n        free_memory: os.freemem(),\n      },\n      app: {\n        hostname: os.hostname(),\n        pid: process.pid,\n        cwd: process.cwd(),\n      },\n    },\n  };\n}\n\nfunction parseStack(error: Error, max: number): string[] {\n  if (!error.stack) return [];\n  return error.stack\n    .split('\\n')\n    .slice(0, max)\n    .map((s) => s.trim())\n    .filter(Boolean);\n}\n\nfunction buildEvent(\n  err: unknown,\n  level: Level,\n  mechanism: MechanismType,\n  handled: boolean,\n  extra?: Partial<PionneEvent>,\n): PionneEvent | null {\n  if (!config || !config.enabled) return null;\n  const e = err instanceof Error ? err : new Error(String(err));\n  const event: PionneEvent = {\n    ...staticContext,\n    exception_type: e.name || 'Error',\n    message: e.message || null,\n    stack: parseStack(e, config.maxStackFrames),\n    level,\n    release: config.release,\n    environment: config.environment,\n    user_id_anon: config.userIdAnon,\n    tags: config.tags,\n    mechanism: { type: mechanism, handled },\n    ...extra,\n  };\n  if (config.beforeSend) {\n    const result = config.beforeSend(event);\n    if (!result) return null;\n    return result;\n  }\n  return event;\n}\n\nasync function send(event: PionneEvent): Promise<void> {\n  if (!config) return;\n  try {\n    // Node >=18 has global `fetch`. We rely on it instead of pulling in\n    // node-fetch / undici as a dependency.\n    if (typeof fetch !== 'function') return;\n    await fetch(config.endpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'X-Pionne-Token': config.token,\n      },\n      body: JSON.stringify(event),\n    });\n  } catch {\n    // Best-effort: a monitoring SDK must never crash the host process.\n  }\n}\n\nfunction installUncaughtHandler(): void {\n  onUncaught = (err: Error) => {\n    const event = buildEvent(err, 'fatal', 'uncaughtException', false);\n    if (event) {\n      // Fire-and-forget: process is going to die anyway. Best we can do is\n      // try to flush before exit, but Node will tear down imminently.\n      void send(event);\n    }\n  };\n  process.on('uncaughtException', onUncaught);\n}\n\nfunction installRejectionHandler(): void {\n  onRejection = (reason: unknown) => {\n    const err = reason instanceof Error ? reason : new Error(String(reason));\n    const event = buildEvent(err, 'error', 'unhandledRejection', false);\n    if (event) void send(event);\n  };\n  process.on('unhandledRejection', onRejection);\n}\n\nexport const Pionne = {\n  init(options: PionneOptions): void {\n    if (!options?.token || !options.token.startsWith('pio_live_')) {\n      if (process.env.NODE_ENV !== 'production') {\n        console.warn(\n          '[Pionne] Missing or invalid token (must start with pio_live_).',\n        );\n      }\n      return;\n    }\n\n    const autoContext = options.autoContext ?? true;\n    staticContext = autoContext ? gatherStaticContext() : {};\n\n    config = {\n      token: options.token,\n      endpoint: options.endpoint ?? DEFAULT_ENDPOINT,\n      release: options.release,\n      environment:\n        options.environment ?? process.env.NODE_ENV ?? 'production',\n      enabled: options.enabled ?? true,\n      captureUncaughtExceptions: options.captureUncaughtExceptions ?? true,\n      captureUnhandledRejections: options.captureUnhandledRejections ?? true,\n      autoContext,\n      beforeSend: options.beforeSend,\n      userIdAnon: options.userIdAnon,\n      tags: options.tags,\n      maxStackFrames: options.maxStackFrames ?? DEFAULT_MAX_STACK,\n    };\n\n    if (config.captureUncaughtExceptions) installUncaughtHandler();\n    if (config.captureUnhandledRejections) installRejectionHandler();\n  },\n\n  captureException(err: unknown, extra?: Partial<PionneEvent>): void {\n    const event = buildEvent(\n      err,\n      extra?.level ?? 'error',\n      'manual',\n      true,\n      extra,\n    );\n    if (event) void send(event);\n  },\n\n  captureMessage(message: string, extra?: Partial<PionneEvent>): void {\n    const event = buildEvent(\n      new Error(message),\n      extra?.level ?? 'info',\n      'manual',\n      true,\n      { exception_type: 'Message', ...extra },\n    );\n    if (event) void send(event);\n  },\n\n  setUser(userIdAnon: string | null): void {\n    if (!config) return;\n    config.userIdAnon = userIdAnon ?? undefined;\n  },\n\n  setTags(tags: Record<string, string> | null): void {\n    if (!config) return;\n    config.tags = tags ?? undefined;\n  },\n\n  setEnabled(enabled: boolean): void {\n    if (!config) return;\n    config.enabled = enabled;\n  },\n\n  /**\n   * Detach all auto handlers. Useful in tests / CLI scripts that need a\n   * clean shutdown. Re-init by calling `init()` again.\n   */\n  uninstall(): void {\n    if (onUncaught) process.removeListener('uncaughtException', onUncaught);\n    if (onRejection) process.removeListener('unhandledRejection', onRejection);\n    onUncaught = null;\n    onRejection = null;\n    config = null;\n    staticContext = {};\n  },\n};\n\n/**\n * Express / Connect / NestJS error middleware. Reports the error then passes\n * it down the chain. Mount it AFTER your routes:\n *\n *   import { Pionne, expressErrorHandler } from '@pionne/node';\n *   app.use(expressErrorHandler);\n *   // your fallback error handler here\n */\nexport function expressErrorHandler(\n  err: unknown,\n  _req: unknown,\n  _res: unknown,\n  next: (err?: unknown) => void,\n): void {\n  Pionne.captureException(err);\n  next(err);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/sessions.ts"],"sourcesContent":["import * as os from 'node:os';\nimport * as process from 'node:process';\n\nimport {\n  endSession as _endSession,\n  flipFromEvent,\n  getCurrentSessionId,\n  startSession as _startSession,\n} from './sessions';\n\nexport type Level = 'fatal' | 'error' | 'warning' | 'info';\nexport type MechanismType =\n  | 'uncaughtException'\n  | 'unhandledRejection'\n  | 'manual';\n\nexport interface Mechanism {\n  type: MechanismType;\n  handled: boolean;\n}\n\nexport interface PionneEvent {\n  exception_type: string;\n  message?: string | null;\n  stack?: string[];\n  level?: Level;\n\n  release?: string;\n  environment?: string;\n  app_version?: string;\n  os_name?: string;\n  os_version?: string;\n  user_id_anon?: string;\n  locale?: string;\n  timezone?: string;\n\n  contexts?: Record<string, Record<string, unknown> | undefined>;\n  mechanism?: Mechanism;\n  tags?: Record<string, string>;\n}\n\nexport interface PionneOptions {\n  /** Project token (starts with `pio_live_`). Required. */\n  token: string;\n  endpoint?: string;\n  release?: string;\n  environment?: string;\n  enabled?: boolean;\n  captureUncaughtExceptions?: boolean;\n  captureUnhandledRejections?: boolean;\n  autoContext?: boolean;\n  beforeSend?: (event: PionneEvent) => PionneEvent | null;\n  userIdAnon?: string;\n  tags?: Record<string, string>;\n  maxStackFrames?: number;\n  /**\n   * Release Health — opens a session at init() with status='ok', flips to\n   * 'crashed'/'errored' if a fatal/error fires through the global handlers.\n   * The dashboard derives crash-free user rate per release. Default: true.\n   */\n  releaseHealth?: boolean;\n}\n\nconst DEFAULT_ENDPOINT = 'https://pionne.agkgcreations.fr/api/ingest';\nconst DEFAULT_MAX_STACK = 50;\nconst SDK_NAME = 'pionne.node';\nconst SDK_VERSION = '0.1.0';\n\ntype ResolvedConfig = Required<\n  Omit<PionneOptions, 'beforeSend' | 'userIdAnon' | 'tags' | 'release' | 'releaseHealth'>\n> & {\n  beforeSend?: PionneOptions['beforeSend'];\n  userIdAnon?: string;\n  tags?: Record<string, string>;\n  release?: string;\n};\n\nlet config: ResolvedConfig | null = null;\nlet staticContext: Partial<PionneEvent> = {};\nlet onUncaught: ((err: Error) => void) | null = null;\nlet onRejection: ((reason: unknown) => void) | null = null;\n\nfunction gatherStaticContext(): Partial<PionneEvent> {\n  let timezone: string | undefined;\n  try {\n    timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;\n  } catch {\n    // ignore\n  }\n  return {\n    os_name: os.type(),\n    os_version: os.release(),\n    timezone,\n    contexts: {\n      sdk: { name: SDK_NAME, version: SDK_VERSION },\n      runtime: {\n        name: 'node',\n        version: process.versions.node,\n        v8: process.versions.v8,\n      },\n      os: {\n        name: os.type(),\n        version: os.release(),\n        platform: process.platform,\n        arch: process.arch,\n        cpu_count: os.cpus().length,\n        total_memory: os.totalmem(),\n        free_memory: os.freemem(),\n      },\n      app: {\n        hostname: os.hostname(),\n        pid: process.pid,\n        cwd: process.cwd(),\n      },\n    },\n  };\n}\n\nfunction parseStack(error: Error, max: number): string[] {\n  if (!error.stack) return [];\n  return error.stack\n    .split('\\n')\n    .slice(0, max)\n    .map((s) => s.trim())\n    .filter(Boolean);\n}\n\nfunction buildEvent(\n  err: unknown,\n  level: Level,\n  mechanism: MechanismType,\n  handled: boolean,\n  extra?: Partial<PionneEvent>,\n): PionneEvent | null {\n  if (!config || !config.enabled) return null;\n  const e = err instanceof Error ? err : new Error(String(err));\n  const event: PionneEvent = {\n    ...staticContext,\n    exception_type: e.name || 'Error',\n    message: e.message || null,\n    stack: parseStack(e, config.maxStackFrames),\n    level,\n    release: config.release,\n    environment: config.environment,\n    user_id_anon: config.userIdAnon,\n    tags: config.tags,\n    mechanism: { type: mechanism, handled },\n    ...extra,\n  };\n  if (config.beforeSend) {\n    const result = config.beforeSend(event);\n    if (!result) return null;\n    return result;\n  }\n  return event;\n}\n\nasync function send(event: PionneEvent): Promise<void> {\n  if (!config) return;\n  try {\n    // Node >=18 has global `fetch`. We rely on it instead of pulling in\n    // node-fetch / undici as a dependency.\n    if (typeof fetch !== 'function') return;\n    await fetch(config.endpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'X-Pionne-Token': config.token,\n      },\n      body: JSON.stringify(event),\n    });\n  } catch {\n    // Best-effort: a monitoring SDK must never crash the host process.\n  }\n}\n\nfunction installUncaughtHandler(): void {\n  onUncaught = (err: Error) => {\n    const event = buildEvent(err, 'fatal', 'uncaughtException', false);\n    if (event) {\n      // Fire-and-forget: process is going to die anyway. Best we can do is\n      // try to flush before exit, but Node will tear down imminently.\n      void send(event);\n      flipFromEvent(event.level, event.mechanism?.type ?? 'uncaughtException');\n    }\n  };\n  process.on('uncaughtException', onUncaught);\n}\n\nfunction installRejectionHandler(): void {\n  onRejection = (reason: unknown) => {\n    const err = reason instanceof Error ? reason : new Error(String(reason));\n    const event = buildEvent(err, 'error', 'unhandledRejection', false);\n    if (event) {\n      void send(event);\n      flipFromEvent(event.level, event.mechanism?.type ?? 'unhandledRejection');\n    }\n  };\n  process.on('unhandledRejection', onRejection);\n}\n\nexport const Pionne = {\n  init(options: PionneOptions): void {\n    if (!options?.token || !options.token.startsWith('pio_live_')) {\n      if (process.env.NODE_ENV !== 'production') {\n        console.warn(\n          '[Pionne] Missing or invalid token (must start with pio_live_).',\n        );\n      }\n      return;\n    }\n\n    const autoContext = options.autoContext ?? true;\n    staticContext = autoContext ? gatherStaticContext() : {};\n\n    config = {\n      token: options.token,\n      endpoint: options.endpoint ?? DEFAULT_ENDPOINT,\n      release: options.release,\n      environment:\n        options.environment ?? process.env.NODE_ENV ?? 'production',\n      enabled: options.enabled ?? true,\n      captureUncaughtExceptions: options.captureUncaughtExceptions ?? true,\n      captureUnhandledRejections: options.captureUnhandledRejections ?? true,\n      autoContext,\n      beforeSend: options.beforeSend,\n      userIdAnon: options.userIdAnon,\n      tags: options.tags,\n      maxStackFrames: options.maxStackFrames ?? DEFAULT_MAX_STACK,\n    };\n\n    if (config.captureUncaughtExceptions) installUncaughtHandler();\n    if (config.captureUnhandledRejections) installRejectionHandler();\n\n    // Release Health — open a session unless the host opted out.\n    if (options.releaseHealth !== false) {\n      _startSession({\n        endpoint: config.endpoint,\n        token: config.token,\n        release: config.release,\n        environment: config.environment,\n        appVersion: staticContext.app_version,\n        osName: staticContext.os_name,\n        userIdAnon: config.userIdAnon,\n      });\n    }\n  },\n\n  captureException(err: unknown, extra?: Partial<PionneEvent>): void {\n    const event = buildEvent(\n      err,\n      extra?.level ?? 'error',\n      'manual',\n      true,\n      extra,\n    );\n    if (event) void send(event);\n  },\n\n  captureMessage(message: string, extra?: Partial<PionneEvent>): void {\n    const event = buildEvent(\n      new Error(message),\n      extra?.level ?? 'info',\n      'manual',\n      true,\n      { exception_type: 'Message', ...extra },\n    );\n    if (event) void send(event);\n  },\n\n  setUser(userIdAnon: string | null): void {\n    if (!config) return;\n    config.userIdAnon = userIdAnon ?? undefined;\n  },\n\n  setTags(tags: Record<string, string> | null): void {\n    if (!config) return;\n    config.tags = tags ?? undefined;\n  },\n\n  setEnabled(enabled: boolean): void {\n    if (!config) return;\n    config.enabled = enabled;\n  },\n\n  /**\n   * Detach all auto handlers. Useful in tests / CLI scripts that need a\n   * clean shutdown. Re-init by calling `init()` again.\n   */\n  uninstall(): void {\n    if (onUncaught) process.removeListener('uncaughtException', onUncaught);\n    if (onRejection) process.removeListener('unhandledRejection', onRejection);\n    onUncaught = null;\n    onRejection = null;\n    config = null;\n    staticContext = {};\n  },\n\n  // ─── Release Health ───────────────────────────────────────────────────\n\n  /** Manually end the current session (status='exited'). */\n  endSession(): void {\n    _endSession();\n  },\n\n  /** UUID of the current open session (for diagnostics). */\n  getSessionId(): string | null {\n    return getCurrentSessionId();\n  },\n};\n\n/**\n * Express / Connect / NestJS error middleware. Reports the error then passes\n * it down the chain. Mount it AFTER your routes:\n *\n *   import { Pionne, expressErrorHandler } from '@pionne/node';\n *   app.use(expressErrorHandler);\n *   // your fallback error handler here\n */\nexport function expressErrorHandler(\n  err: unknown,\n  _req: unknown,\n  _res: unknown,\n  next: (err?: unknown) => void,\n): void {\n  Pionne.captureException(err);\n  next(err);\n}\n","// Release Health for Node.js. Same protocol as the browser/RN SDKs.\n// We auto-flip on uncaughtException/unhandledRejection through the host\n// SDK's existing handlers, and best-effort-emit 'exited' on process.exit.\n\nimport * as crypto from 'node:crypto';\n\nexport type SessionStatus = 'ok' | 'crashed' | 'errored' | 'abnormal' | 'exited';\n\nexport interface SessionContext {\n  endpoint: string;\n  token: string;\n  release?: string;\n  environment?: string;\n  appVersion?: string;\n  osName?: string;\n  userIdAnon?: string;\n}\n\ninterface SessionState {\n  id: string;\n  startedAt: number;\n  status: SessionStatus;\n  ctx: SessionContext;\n}\n\nlet current: SessionState | null = null;\n\nfunction sessionsUrl(ingestEndpoint: string): string {\n  if (ingestEndpoint.endsWith('/ingest')) {\n    return ingestEndpoint.slice(0, -'/ingest'.length) + '/sessions';\n  }\n  return ingestEndpoint.replace(/\\/+$/, '') + '/sessions';\n}\n\nfunction postSession(state: SessionState, status: SessionStatus, durationMs?: number): void {\n  const url = sessionsUrl(state.ctx.endpoint);\n  const body = {\n    session_id: state.id,\n    status,\n    release: state.ctx.release,\n    environment: state.ctx.environment,\n    app_version: state.ctx.appVersion,\n    os_name: state.ctx.osName,\n    user_id_anon: state.ctx.userIdAnon,\n    duration_ms: durationMs,\n  };\n  for (const k of Object.keys(body) as (keyof typeof body)[]) {\n    if (body[k] === undefined) delete body[k];\n  }\n  // Node 18+ has global fetch.\n  fetch(url, {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/json',\n      'X-Pionne-Token': state.ctx.token,\n    },\n    body: JSON.stringify(body),\n  }).catch(() => undefined);\n}\n\nexport function startSession(ctx: SessionContext): string {\n  current = {\n    id: crypto.randomUUID(),\n    startedAt: Date.now(),\n    status: 'ok',\n    ctx,\n  };\n  postSession(current, 'ok');\n\n  // Best-effort 'exited' flip on graceful shutdown. We listen on 'exit'\n  // (sync only — no async I/O guaranteed) and 'beforeExit' (where async\n  // works). The actual session POST is fire-and-forget anyway.\n  const onShutdown = () => {\n    if (!current || current.status !== 'ok') return;\n    flipSession('exited');\n  };\n  process.once('beforeExit', onShutdown);\n\n  return current.id;\n}\n\nexport function flipSession(status: SessionStatus): void {\n  if (!current) return;\n  const rank: Record<SessionStatus, number> =\n    { ok: 0, exited: 1, errored: 2, abnormal: 3, crashed: 4 };\n  if (rank[status] <= rank[current.status]) return;\n  current.status = status;\n  postSession(current, status, Date.now() - current.startedAt);\n}\n\nexport function endSession(status: SessionStatus = 'exited'): void {\n  if (!current) return;\n  flipSession(status);\n  current = null;\n}\n\nexport function getCurrentSessionId(): string | null {\n  return current?.id ?? null;\n}\n\nexport function flipFromEvent(\n  level: 'fatal' | 'error' | 'warning' | 'info' | undefined,\n  mechanismType: string,\n): void {\n  if (mechanismType === 'manual') return;\n  if (level === 'fatal') flipSession('crashed');\n  else if (level === 'error') flipSession('errored');\n}\n"],"mappings":"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","names":["process"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pionne/node",
-  "version": "0.1.2",
-  "description": "Error monitoring SDK for Node.js — Pionne. Auto-captures uncaught exceptions and unhandled rejections, ships rich runtime context (Node version, OS, hostname, pid).",
+  "version": "0.3.0",
+  "description": "Error monitoring SDK for Node.js — Pionne. Auto-captures uncaught exceptions and unhandled rejections, ships runtime context (Node, OS, hostname, pid), and tracks Release Health (crash-free user rate per release).",
   "license": "MIT",
   "author": "AGKG Creations",
   "homepage": "https://pionne.agkgcreations.fr",

package/src/index.ts

@@ -1,6 +1,13 @@
 import * as os from 'node:os';
 import * as process from 'node:process';
 
+import {
+  endSession as _endSession,
+  flipFromEvent,
+  getCurrentSessionId,
+  startSession as _startSession,
+} from './sessions';
+
 export type Level = 'fatal' | 'error' | 'warning' | 'info';
 export type MechanismType =
   | 'uncaughtException'
@@ -46,6 +53,12 @@ export interface PionneOptions {
   userIdAnon?: string;
   tags?: Record<string, string>;
   maxStackFrames?: number;
+  /**
+   * Release Health — opens a session at init() with status='ok', flips to
+   * 'crashed'/'errored' if a fatal/error fires through the global handlers.
+   * The dashboard derives crash-free user rate per release. Default: true.
+   */
+  releaseHealth?: boolean;
 }
 
 const DEFAULT_ENDPOINT = 'https://pionne.agkgcreations.fr/api/ingest';
@@ -54,7 +67,7 @@ const SDK_NAME = 'pionne.node';
 const SDK_VERSION = '0.1.0';
 
 type ResolvedConfig = Required<
-  Omit<PionneOptions, 'beforeSend' | 'userIdAnon' | 'tags' | 'release'>
+  Omit<PionneOptions, 'beforeSend' | 'userIdAnon' | 'tags' | 'release' | 'releaseHealth'>
 > & {
   beforeSend?: PionneOptions['beforeSend'];
   userIdAnon?: string;
@@ -168,6 +181,7 @@ function installUncaughtHandler(): void {
       // Fire-and-forget: process is going to die anyway. Best we can do is
       // try to flush before exit, but Node will tear down imminently.
       void send(event);
+      flipFromEvent(event.level, event.mechanism?.type ?? 'uncaughtException');
     }
   };
   process.on('uncaughtException', onUncaught);
@@ -177,7 +191,10 @@ function installRejectionHandler(): void {
   onRejection = (reason: unknown) => {
     const err = reason instanceof Error ? reason : new Error(String(reason));
     const event = buildEvent(err, 'error', 'unhandledRejection', false);
-    if (event) void send(event);
+    if (event) {
+      void send(event);
+      flipFromEvent(event.level, event.mechanism?.type ?? 'unhandledRejection');
+    }
   };
   process.on('unhandledRejection', onRejection);
 }
@@ -214,6 +231,19 @@ export const Pionne = {
 
     if (config.captureUncaughtExceptions) installUncaughtHandler();
     if (config.captureUnhandledRejections) installRejectionHandler();
+
+    // Release Health — open a session unless the host opted out.
+    if (options.releaseHealth !== false) {
+      _startSession({
+        endpoint: config.endpoint,
+        token: config.token,
+        release: config.release,
+        environment: config.environment,
+        appVersion: staticContext.app_version,
+        osName: staticContext.os_name,
+        userIdAnon: config.userIdAnon,
+      });
+    }
   },
 
   captureException(err: unknown, extra?: Partial<PionneEvent>): void {
@@ -265,6 +295,18 @@ export const Pionne = {
     config = null;
     staticContext = {};
   },
+
+  // ─── Release Health ───────────────────────────────────────────────────
+
+  /** Manually end the current session (status='exited'). */
+  endSession(): void {
+    _endSession();
+  },
+
+  /** UUID of the current open session (for diagnostics). */
+  getSessionId(): string | null {
+    return getCurrentSessionId();
+  },
 };
 
 /**

package/src/sessions.ts

@@ -0,0 +1,108 @@
+// Release Health for Node.js. Same protocol as the browser/RN SDKs.
+// We auto-flip on uncaughtException/unhandledRejection through the host
+// SDK's existing handlers, and best-effort-emit 'exited' on process.exit.
+
+import * as crypto from 'node:crypto';
+
+export type SessionStatus = 'ok' | 'crashed' | 'errored' | 'abnormal' | 'exited';
+
+export interface SessionContext {
+  endpoint: string;
+  token: string;
+  release?: string;
+  environment?: string;
+  appVersion?: string;
+  osName?: string;
+  userIdAnon?: string;
+}
+
+interface SessionState {
+  id: string;
+  startedAt: number;
+  status: SessionStatus;
+  ctx: SessionContext;
+}
+
+let current: SessionState | null = null;
+
+function sessionsUrl(ingestEndpoint: string): string {
+  if (ingestEndpoint.endsWith('/ingest')) {
+    return ingestEndpoint.slice(0, -'/ingest'.length) + '/sessions';
+  }
+  return ingestEndpoint.replace(/\/+$/, '') + '/sessions';
+}
+
+function postSession(state: SessionState, status: SessionStatus, durationMs?: number): void {
+  const url = sessionsUrl(state.ctx.endpoint);
+  const body = {
+    session_id: state.id,
+    status,
+    release: state.ctx.release,
+    environment: state.ctx.environment,
+    app_version: state.ctx.appVersion,
+    os_name: state.ctx.osName,
+    user_id_anon: state.ctx.userIdAnon,
+    duration_ms: durationMs,
+  };
+  for (const k of Object.keys(body) as (keyof typeof body)[]) {
+    if (body[k] === undefined) delete body[k];
+  }
+  // Node 18+ has global fetch.
+  fetch(url, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'X-Pionne-Token': state.ctx.token,
+    },
+    body: JSON.stringify(body),
+  }).catch(() => undefined);
+}
+
+export function startSession(ctx: SessionContext): string {
+  current = {
+    id: crypto.randomUUID(),
+    startedAt: Date.now(),
+    status: 'ok',
+    ctx,
+  };
+  postSession(current, 'ok');
+
+  // Best-effort 'exited' flip on graceful shutdown. We listen on 'exit'
+  // (sync only — no async I/O guaranteed) and 'beforeExit' (where async
+  // works). The actual session POST is fire-and-forget anyway.
+  const onShutdown = () => {
+    if (!current || current.status !== 'ok') return;
+    flipSession('exited');
+  };
+  process.once('beforeExit', onShutdown);
+
+  return current.id;
+}
+
+export function flipSession(status: SessionStatus): void {
+  if (!current) return;
+  const rank: Record<SessionStatus, number> =
+    { ok: 0, exited: 1, errored: 2, abnormal: 3, crashed: 4 };
+  if (rank[status] <= rank[current.status]) return;
+  current.status = status;
+  postSession(current, status, Date.now() - current.startedAt);
+}
+
+export function endSession(status: SessionStatus = 'exited'): void {
+  if (!current) return;
+  flipSession(status);
+  current = null;
+}
+
+export function getCurrentSessionId(): string | null {
+  return current?.id ?? null;
+}
+
+export function flipFromEvent(
+  level: 'fatal' | 'error' | 'warning' | 'info' | undefined,
+  mechanismType: string,
+): void {
+  if (mechanismType === 'manual') return;
+  if (level === 'fatal') flipSession('crashed');
+  else if (level === 'error') flipSession('errored');
+}