@pionne/node 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) AGKG Creations
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# @pionne/node
+
+Error monitoring SDK for Node.js — by [Pionne](https://pionne.agkgcreations.fr).
+
+Auto-captures `uncaughtException` and `unhandledRejection`, ships rich runtime context (Node version, OS, hostname, pid, memory). Zero external dependencies — uses Node 18+ global `fetch`.
+
+Works with **plain Node, Express, Fastify, NestJS, Koa, Hono, Bun, Deno (with compat shim)**.
+
+## Install
+
+```bash
+npm install @pionne/node
+```
+
+## Usage
+
+```ts
+// At the top of your entrypoint (server.ts / index.ts)
+import { Pionne } from '@pionne/node';
+
+Pionne.init({
+  token: 'pio_live_xxx',
+  release: process.env.GIT_SHA, // optional
+  environment: process.env.NODE_ENV ?? 'production',
+});
+```
+
+That's it. Crashes and unhandled rejections are reported automatically.
+
+### Express / NestJS / Connect
+
+```ts
+import express from 'express';
+import { Pionne, expressErrorHandler } from '@pionne/node';
+
+Pionne.init({ token: 'pio_live_xxx' });
+
+const app = express();
+app.get('/boom', () => { throw new Error('boom'); });
+
+// Mount AFTER your routes:
+app.use(expressErrorHandler);
+```
+
+### Manual capture
+
+```ts
+try {
+  await processOrder(orderId);
+} catch (err) {
+  Pionne.captureException(err, {
+    tags: { feature: 'checkout' },
+    user_id_anon: req.user?.id,
+  });
+  throw err;
+}
+```
+
+### User identity, tags, opt-out
+
+```ts
+Pionne.setUser('u_42');
+Pionne.setTags({ tier: 'pro' });
+Pionne.setEnabled(false);
+```
+
+## Options
+
+Same shape as `@pionne/web` and `@pionne/react-native`. See the type
+definitions for the full list.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,223 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Pionne: () => Pionne,
+  expressErrorHandler: () => expressErrorHandler
+});
+module.exports = __toCommonJS(index_exports);
+var os = __toESM(require("os"));
+var process = __toESM(require("process"));
+var DEFAULT_ENDPOINT = "https://pionne.agkgcreations.fr/api/ingest";
+var DEFAULT_MAX_STACK = 50;
+var SDK_NAME = "pionne.node";
+var SDK_VERSION = "0.1.0";
+var config = null;
+var staticContext = {};
+var onUncaught = null;
+var onRejection = null;
+function gatherStaticContext() {
+  let timezone;
+  try {
+    timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+  } catch {
+  }
+  return {
+    os_name: os.type(),
+    os_version: os.release(),
+    timezone,
+    contexts: {
+      sdk: { name: SDK_NAME, version: SDK_VERSION },
+      runtime: {
+        name: "node",
+        version: process.versions.node,
+        v8: process.versions.v8
+      },
+      os: {
+        name: os.type(),
+        version: os.release(),
+        platform: process.platform,
+        arch: process.arch,
+        cpu_count: os.cpus().length,
+        total_memory: os.totalmem(),
+        free_memory: os.freemem()
+      },
+      app: {
+        hostname: os.hostname(),
+        pid: process.pid,
+        cwd: process.cwd()
+      }
+    }
+  };
+}
+function parseStack(error, max) {
+  if (!error.stack) return [];
+  return error.stack.split("\n").slice(0, max).map((s) => s.trim()).filter(Boolean);
+}
+function buildEvent(err, level, mechanism, handled, extra) {
+  if (!config || !config.enabled) return null;
+  const e = err instanceof Error ? err : new Error(String(err));
+  const event = {
+    ...staticContext,
+    exception_type: e.name || "Error",
+    message: e.message || null,
+    stack: parseStack(e, config.maxStackFrames),
+    level,
+    release: config.release,
+    environment: config.environment,
+    user_id_anon: config.userIdAnon,
+    tags: config.tags,
+    mechanism: { type: mechanism, handled },
+    ...extra
+  };
+  if (config.beforeSend) {
+    const result = config.beforeSend(event);
+    if (!result) return null;
+    return result;
+  }
+  return event;
+}
+async function send(event) {
+  if (!config) return;
+  try {
+    if (typeof fetch !== "function") return;
+    await fetch(config.endpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Pionne-Token": config.token
+      },
+      body: JSON.stringify(event)
+    });
+  } catch {
+  }
+}
+function installUncaughtHandler() {
+  onUncaught = (err) => {
+    const event = buildEvent(err, "fatal", "uncaughtException", false);
+    if (event) {
+      void send(event);
+    }
+  };
+  process.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);
+  };
+  process.on("unhandledRejection", onRejection);
+}
+var Pionne = {
+  init(options) {
+    if (!options?.token || !options.token.startsWith("pio_live_")) {
+      if (process.env.NODE_ENV !== "production") {
+        console.warn(
+          "[Pionne] Missing or invalid token (must start with pio_live_)."
+        );
+      }
+      return;
+    }
+    const autoContext = options.autoContext ?? true;
+    staticContext = autoContext ? gatherStaticContext() : {};
+    config = {
+      token: options.token,
+      endpoint: options.endpoint ?? DEFAULT_ENDPOINT,
+      release: options.release,
+      environment: options.environment ?? process.env.NODE_ENV ?? "production",
+      enabled: options.enabled ?? true,
+      captureUncaughtExceptions: options.captureUncaughtExceptions ?? true,
+      captureUnhandledRejections: options.captureUnhandledRejections ?? true,
+      autoContext,
+      beforeSend: options.beforeSend,
+      userIdAnon: options.userIdAnon,
+      tags: options.tags,
+      maxStackFrames: options.maxStackFrames ?? DEFAULT_MAX_STACK
+    };
+    if (config.captureUncaughtExceptions) installUncaughtHandler();
+    if (config.captureUnhandledRejections) installRejectionHandler();
+  },
+  captureException(err, extra) {
+    const event = buildEvent(
+      err,
+      extra?.level ?? "error",
+      "manual",
+      true,
+      extra
+    );
+    if (event) void send(event);
+  },
+  captureMessage(message, extra) {
+    const event = buildEvent(
+      new Error(message),
+      extra?.level ?? "info",
+      "manual",
+      true,
+      { exception_type: "Message", ...extra }
+    );
+    if (event) void send(event);
+  },
+  setUser(userIdAnon) {
+    if (!config) return;
+    config.userIdAnon = userIdAnon ?? void 0;
+  },
+  setTags(tags) {
+    if (!config) return;
+    config.tags = tags ?? void 0;
+  },
+  setEnabled(enabled) {
+    if (!config) return;
+    config.enabled = enabled;
+  },
+  /**
+   * Detach all auto handlers. Useful in tests / CLI scripts that need a
+   * clean shutdown. Re-init by calling `init()` again.
+   */
+  uninstall() {
+    if (onUncaught) process.removeListener("uncaughtException", onUncaught);
+    if (onRejection) process.removeListener("unhandledRejection", onRejection);
+    onUncaught = null;
+    onRejection = null;
+    config = null;
+    staticContext = {};
+  }
+};
+function expressErrorHandler(err, _req, _res, next) {
+  Pionne.captureException(err);
+  next(err);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Pionne,
+  expressErrorHandler
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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":[]}

package/dist/index.d.mts

@@ -0,0 +1,62 @@
+type Level = 'fatal' | 'error' | 'warning' | 'info';
+type MechanismType = 'uncaughtException' | 'unhandledRejection' | 'manual';
+interface Mechanism {
+    type: MechanismType;
+    handled: boolean;
+}
+interface PionneEvent {
+    exception_type: string;
+    message?: string | null;
+    stack?: string[];
+    level?: Level;
+    release?: string;
+    environment?: string;
+    app_version?: string;
+    os_name?: string;
+    os_version?: string;
+    user_id_anon?: string;
+    locale?: string;
+    timezone?: string;
+    contexts?: Record<string, Record<string, unknown> | undefined>;
+    mechanism?: Mechanism;
+    tags?: Record<string, string>;
+}
+interface PionneOptions {
+    /** Project token (starts with `pio_live_`). Required. */
+    token: string;
+    endpoint?: string;
+    release?: string;
+    environment?: string;
+    enabled?: boolean;
+    captureUncaughtExceptions?: boolean;
+    captureUnhandledRejections?: boolean;
+    autoContext?: boolean;
+    beforeSend?: (event: PionneEvent) => PionneEvent | null;
+    userIdAnon?: string;
+    tags?: Record<string, string>;
+    maxStackFrames?: number;
+}
+declare const Pionne: {
+    init(options: PionneOptions): void;
+    captureException(err: unknown, extra?: Partial<PionneEvent>): void;
+    captureMessage(message: string, extra?: Partial<PionneEvent>): void;
+    setUser(userIdAnon: string | null): void;
+    setTags(tags: Record<string, string> | null): void;
+    setEnabled(enabled: boolean): void;
+    /**
+     * Detach all auto handlers. Useful in tests / CLI scripts that need a
+     * clean shutdown. Re-init by calling `init()` again.
+     */
+    uninstall(): void;
+};
+/**
+ * Express / Connect / NestJS error middleware. Reports the error then passes
+ * it down the chain. Mount it AFTER your routes:
+ *
+ *   import { Pionne, expressErrorHandler } from '@pionne/node';
+ *   app.use(expressErrorHandler);
+ *   // your fallback error handler here
+ */
+declare function expressErrorHandler(err: unknown, _req: unknown, _res: unknown, next: (err?: unknown) => void): void;
+
+export { type Level, type Mechanism, type MechanismType, Pionne, type PionneEvent, type PionneOptions, expressErrorHandler };

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+type Level = 'fatal' | 'error' | 'warning' | 'info';
+type MechanismType = 'uncaughtException' | 'unhandledRejection' | 'manual';
+interface Mechanism {
+    type: MechanismType;
+    handled: boolean;
+}
+interface PionneEvent {
+    exception_type: string;
+    message?: string | null;
+    stack?: string[];
+    level?: Level;
+    release?: string;
+    environment?: string;
+    app_version?: string;
+    os_name?: string;
+    os_version?: string;
+    user_id_anon?: string;
+    locale?: string;
+    timezone?: string;
+    contexts?: Record<string, Record<string, unknown> | undefined>;
+    mechanism?: Mechanism;
+    tags?: Record<string, string>;
+}
+interface PionneOptions {
+    /** Project token (starts with `pio_live_`). Required. */
+    token: string;
+    endpoint?: string;
+    release?: string;
+    environment?: string;
+    enabled?: boolean;
+    captureUncaughtExceptions?: boolean;
+    captureUnhandledRejections?: boolean;
+    autoContext?: boolean;
+    beforeSend?: (event: PionneEvent) => PionneEvent | null;
+    userIdAnon?: string;
+    tags?: Record<string, string>;
+    maxStackFrames?: number;
+}
+declare const Pionne: {
+    init(options: PionneOptions): void;
+    captureException(err: unknown, extra?: Partial<PionneEvent>): void;
+    captureMessage(message: string, extra?: Partial<PionneEvent>): void;
+    setUser(userIdAnon: string | null): void;
+    setTags(tags: Record<string, string> | null): void;
+    setEnabled(enabled: boolean): void;
+    /**
+     * Detach all auto handlers. Useful in tests / CLI scripts that need a
+     * clean shutdown. Re-init by calling `init()` again.
+     */
+    uninstall(): void;
+};
+/**
+ * Express / Connect / NestJS error middleware. Reports the error then passes
+ * it down the chain. Mount it AFTER your routes:
+ *
+ *   import { Pionne, expressErrorHandler } from '@pionne/node';
+ *   app.use(expressErrorHandler);
+ *   // your fallback error handler here
+ */
+declare function expressErrorHandler(err: unknown, _req: unknown, _res: unknown, next: (err?: unknown) => void): void;
+
+export { type Level, type Mechanism, type MechanismType, Pionne, type PionneEvent, type PionneOptions, expressErrorHandler };

package/dist/index.mjs

@@ -0,0 +1,187 @@
+// src/index.ts
+import * as os from "os";
+import * as process from "process";
+var DEFAULT_ENDPOINT = "https://pionne.agkgcreations.fr/api/ingest";
+var DEFAULT_MAX_STACK = 50;
+var SDK_NAME = "pionne.node";
+var SDK_VERSION = "0.1.0";
+var config = null;
+var staticContext = {};
+var onUncaught = null;
+var onRejection = null;
+function gatherStaticContext() {
+  let timezone;
+  try {
+    timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+  } catch {
+  }
+  return {
+    os_name: os.type(),
+    os_version: os.release(),
+    timezone,
+    contexts: {
+      sdk: { name: SDK_NAME, version: SDK_VERSION },
+      runtime: {
+        name: "node",
+        version: process.versions.node,
+        v8: process.versions.v8
+      },
+      os: {
+        name: os.type(),
+        version: os.release(),
+        platform: process.platform,
+        arch: process.arch,
+        cpu_count: os.cpus().length,
+        total_memory: os.totalmem(),
+        free_memory: os.freemem()
+      },
+      app: {
+        hostname: os.hostname(),
+        pid: process.pid,
+        cwd: process.cwd()
+      }
+    }
+  };
+}
+function parseStack(error, max) {
+  if (!error.stack) return [];
+  return error.stack.split("\n").slice(0, max).map((s) => s.trim()).filter(Boolean);
+}
+function buildEvent(err, level, mechanism, handled, extra) {
+  if (!config || !config.enabled) return null;
+  const e = err instanceof Error ? err : new Error(String(err));
+  const event = {
+    ...staticContext,
+    exception_type: e.name || "Error",
+    message: e.message || null,
+    stack: parseStack(e, config.maxStackFrames),
+    level,
+    release: config.release,
+    environment: config.environment,
+    user_id_anon: config.userIdAnon,
+    tags: config.tags,
+    mechanism: { type: mechanism, handled },
+    ...extra
+  };
+  if (config.beforeSend) {
+    const result = config.beforeSend(event);
+    if (!result) return null;
+    return result;
+  }
+  return event;
+}
+async function send(event) {
+  if (!config) return;
+  try {
+    if (typeof fetch !== "function") return;
+    await fetch(config.endpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Pionne-Token": config.token
+      },
+      body: JSON.stringify(event)
+    });
+  } catch {
+  }
+}
+function installUncaughtHandler() {
+  onUncaught = (err) => {
+    const event = buildEvent(err, "fatal", "uncaughtException", false);
+    if (event) {
+      void send(event);
+    }
+  };
+  process.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);
+  };
+  process.on("unhandledRejection", onRejection);
+}
+var Pionne = {
+  init(options) {
+    if (!options?.token || !options.token.startsWith("pio_live_")) {
+      if (process.env.NODE_ENV !== "production") {
+        console.warn(
+          "[Pionne] Missing or invalid token (must start with pio_live_)."
+        );
+      }
+      return;
+    }
+    const autoContext = options.autoContext ?? true;
+    staticContext = autoContext ? gatherStaticContext() : {};
+    config = {
+      token: options.token,
+      endpoint: options.endpoint ?? DEFAULT_ENDPOINT,
+      release: options.release,
+      environment: options.environment ?? process.env.NODE_ENV ?? "production",
+      enabled: options.enabled ?? true,
+      captureUncaughtExceptions: options.captureUncaughtExceptions ?? true,
+      captureUnhandledRejections: options.captureUnhandledRejections ?? true,
+      autoContext,
+      beforeSend: options.beforeSend,
+      userIdAnon: options.userIdAnon,
+      tags: options.tags,
+      maxStackFrames: options.maxStackFrames ?? DEFAULT_MAX_STACK
+    };
+    if (config.captureUncaughtExceptions) installUncaughtHandler();
+    if (config.captureUnhandledRejections) installRejectionHandler();
+  },
+  captureException(err, extra) {
+    const event = buildEvent(
+      err,
+      extra?.level ?? "error",
+      "manual",
+      true,
+      extra
+    );
+    if (event) void send(event);
+  },
+  captureMessage(message, extra) {
+    const event = buildEvent(
+      new Error(message),
+      extra?.level ?? "info",
+      "manual",
+      true,
+      { exception_type: "Message", ...extra }
+    );
+    if (event) void send(event);
+  },
+  setUser(userIdAnon) {
+    if (!config) return;
+    config.userIdAnon = userIdAnon ?? void 0;
+  },
+  setTags(tags) {
+    if (!config) return;
+    config.tags = tags ?? void 0;
+  },
+  setEnabled(enabled) {
+    if (!config) return;
+    config.enabled = enabled;
+  },
+  /**
+   * Detach all auto handlers. Useful in tests / CLI scripts that need a
+   * clean shutdown. Re-init by calling `init()` again.
+   */
+  uninstall() {
+    if (onUncaught) process.removeListener("uncaughtException", onUncaught);
+    if (onRejection) process.removeListener("unhandledRejection", onRejection);
+    onUncaught = null;
+    onRejection = null;
+    config = null;
+    staticContext = {};
+  }
+};
+function expressErrorHandler(err, _req, _res, next) {
+  Pionne.captureException(err);
+  next(err);
+}
+export {
+  Pionne,
+  expressErrorHandler
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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":[]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@pionne/node",
+  "version": "0.1.0",
+  "description": "Error monitoring SDK for Node.js — Pionne. Auto-captures uncaught exceptions and unhandled rejections, ships rich runtime context (Node version, OS, hostname, pid).",
+  "license": "MIT",
+  "author": "AGKG Creations",
+  "homepage": "https://pionne.agkgcreations.fr",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agkgcreations/pionne.git"
+  },
+  "keywords": [
+    "pionne",
+    "node",
+    "nodejs",
+    "express",
+    "fastify",
+    "nestjs",
+    "error-monitoring",
+    "crash-reporting",
+    "sentry-alternative",
+    "observability"
+  ],
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "source": "src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.5.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/index.ts

@@ -0,0 +1,286 @@
+import * as os from 'node:os';
+import * as process from 'node:process';
+
+export type Level = 'fatal' | 'error' | 'warning' | 'info';
+export type MechanismType =
+  | 'uncaughtException'
+  | 'unhandledRejection'
+  | 'manual';
+
+export interface Mechanism {
+  type: MechanismType;
+  handled: boolean;
+}
+
+export interface PionneEvent {
+  exception_type: string;
+  message?: string | null;
+  stack?: string[];
+  level?: Level;
+
+  release?: string;
+  environment?: string;
+  app_version?: string;
+  os_name?: string;
+  os_version?: string;
+  user_id_anon?: string;
+  locale?: string;
+  timezone?: string;
+
+  contexts?: Record<string, Record<string, unknown> | undefined>;
+  mechanism?: Mechanism;
+  tags?: Record<string, string>;
+}
+
+export interface PionneOptions {
+  /** Project token (starts with `pio_live_`). Required. */
+  token: string;
+  endpoint?: string;
+  release?: string;
+  environment?: string;
+  enabled?: boolean;
+  captureUncaughtExceptions?: boolean;
+  captureUnhandledRejections?: boolean;
+  autoContext?: boolean;
+  beforeSend?: (event: PionneEvent) => PionneEvent | null;
+  userIdAnon?: string;
+  tags?: Record<string, string>;
+  maxStackFrames?: number;
+}
+
+const DEFAULT_ENDPOINT = 'https://pionne.agkgcreations.fr/api/ingest';
+const DEFAULT_MAX_STACK = 50;
+const SDK_NAME = 'pionne.node';
+const SDK_VERSION = '0.1.0';
+
+type ResolvedConfig = Required<
+  Omit<PionneOptions, 'beforeSend' | 'userIdAnon' | 'tags' | 'release'>
+> & {
+  beforeSend?: PionneOptions['beforeSend'];
+  userIdAnon?: string;
+  tags?: Record<string, string>;
+  release?: string;
+};
+
+let config: ResolvedConfig | null = null;
+let staticContext: Partial<PionneEvent> = {};
+let onUncaught: ((err: Error) => void) | null = null;
+let onRejection: ((reason: unknown) => void) | null = null;
+
+function gatherStaticContext(): Partial<PionneEvent> {
+  let timezone: string | undefined;
+  try {
+    timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+  } catch {
+    // ignore
+  }
+  return {
+    os_name: os.type(),
+    os_version: os.release(),
+    timezone,
+    contexts: {
+      sdk: { name: SDK_NAME, version: SDK_VERSION },
+      runtime: {
+        name: 'node',
+        version: process.versions.node,
+        v8: process.versions.v8,
+      },
+      os: {
+        name: os.type(),
+        version: os.release(),
+        platform: process.platform,
+        arch: process.arch,
+        cpu_count: os.cpus().length,
+        total_memory: os.totalmem(),
+        free_memory: os.freemem(),
+      },
+      app: {
+        hostname: os.hostname(),
+        pid: process.pid,
+        cwd: process.cwd(),
+      },
+    },
+  };
+}
+
+function parseStack(error: Error, max: number): string[] {
+  if (!error.stack) return [];
+  return error.stack
+    .split('\n')
+    .slice(0, max)
+    .map((s) => s.trim())
+    .filter(Boolean);
+}
+
+function buildEvent(
+  err: unknown,
+  level: Level,
+  mechanism: MechanismType,
+  handled: boolean,
+  extra?: Partial<PionneEvent>,
+): PionneEvent | null {
+  if (!config || !config.enabled) return null;
+  const e = err instanceof Error ? err : new Error(String(err));
+  const event: PionneEvent = {
+    ...staticContext,
+    exception_type: e.name || 'Error',
+    message: e.message || null,
+    stack: parseStack(e, config.maxStackFrames),
+    level,
+    release: config.release,
+    environment: config.environment,
+    user_id_anon: config.userIdAnon,
+    tags: config.tags,
+    mechanism: { type: mechanism, handled },
+    ...extra,
+  };
+  if (config.beforeSend) {
+    const result = config.beforeSend(event);
+    if (!result) return null;
+    return result;
+  }
+  return event;
+}
+
+async function send(event: PionneEvent): Promise<void> {
+  if (!config) return;
+  try {
+    // Node >=18 has global `fetch`. We rely on it instead of pulling in
+    // node-fetch / undici as a dependency.
+    if (typeof fetch !== 'function') return;
+    await fetch(config.endpoint, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'X-Pionne-Token': config.token,
+      },
+      body: JSON.stringify(event),
+    });
+  } catch {
+    // Best-effort: a monitoring SDK must never crash the host process.
+  }
+}
+
+function installUncaughtHandler(): void {
+  onUncaught = (err: Error) => {
+    const event = buildEvent(err, 'fatal', 'uncaughtException', false);
+    if (event) {
+      // 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);
+    }
+  };
+  process.on('uncaughtException', onUncaught);
+}
+
+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);
+  };
+  process.on('unhandledRejection', onRejection);
+}
+
+export const Pionne = {
+  init(options: PionneOptions): void {
+    if (!options?.token || !options.token.startsWith('pio_live_')) {
+      if (process.env.NODE_ENV !== 'production') {
+        console.warn(
+          '[Pionne] Missing or invalid token (must start with pio_live_).',
+        );
+      }
+      return;
+    }
+
+    const autoContext = options.autoContext ?? true;
+    staticContext = autoContext ? gatherStaticContext() : {};
+
+    config = {
+      token: options.token,
+      endpoint: options.endpoint ?? DEFAULT_ENDPOINT,
+      release: options.release,
+      environment:
+        options.environment ?? process.env.NODE_ENV ?? 'production',
+      enabled: options.enabled ?? true,
+      captureUncaughtExceptions: options.captureUncaughtExceptions ?? true,
+      captureUnhandledRejections: options.captureUnhandledRejections ?? true,
+      autoContext,
+      beforeSend: options.beforeSend,
+      userIdAnon: options.userIdAnon,
+      tags: options.tags,
+      maxStackFrames: options.maxStackFrames ?? DEFAULT_MAX_STACK,
+    };
+
+    if (config.captureUncaughtExceptions) installUncaughtHandler();
+    if (config.captureUnhandledRejections) installRejectionHandler();
+  },
+
+  captureException(err: unknown, extra?: Partial<PionneEvent>): void {
+    const event = buildEvent(
+      err,
+      extra?.level ?? 'error',
+      'manual',
+      true,
+      extra,
+    );
+    if (event) void send(event);
+  },
+
+  captureMessage(message: string, extra?: Partial<PionneEvent>): void {
+    const event = buildEvent(
+      new Error(message),
+      extra?.level ?? 'info',
+      'manual',
+      true,
+      { exception_type: 'Message', ...extra },
+    );
+    if (event) void send(event);
+  },
+
+  setUser(userIdAnon: string | null): void {
+    if (!config) return;
+    config.userIdAnon = userIdAnon ?? undefined;
+  },
+
+  setTags(tags: Record<string, string> | null): void {
+    if (!config) return;
+    config.tags = tags ?? undefined;
+  },
+
+  setEnabled(enabled: boolean): void {
+    if (!config) return;
+    config.enabled = enabled;
+  },
+
+  /**
+   * Detach all auto handlers. Useful in tests / CLI scripts that need a
+   * clean shutdown. Re-init by calling `init()` again.
+   */
+  uninstall(): void {
+    if (onUncaught) process.removeListener('uncaughtException', onUncaught);
+    if (onRejection) process.removeListener('unhandledRejection', onRejection);
+    onUncaught = null;
+    onRejection = null;
+    config = null;
+    staticContext = {};
+  },
+};
+
+/**
+ * Express / Connect / NestJS error middleware. Reports the error then passes
+ * it down the chain. Mount it AFTER your routes:
+ *
+ *   import { Pionne, expressErrorHandler } from '@pionne/node';
+ *   app.use(expressErrorHandler);
+ *   // your fallback error handler here
+ */
+export function expressErrorHandler(
+  err: unknown,
+  _req: unknown,
+  _res: unknown,
+  next: (err?: unknown) => void,
+): void {
+  Pionne.captureException(err);
+  next(err);
+}