@youssoufcherif/signals-node 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Youssouf Cherif Hamed
+
+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,27 @@
+# @youssoufcherif/signals-node
+
+> ⚠️ **Pre-alpha (`0.0.x`)** — built in the open, APIs change without notice.
+> Not yet supported for use outside the author's projects. See the
+> [repo README](https://github.com/yhcherif/signals#readme).
+
+Lightweight console provider for
+[Signals](https://github.com/yhcherif/signals): spans, logs, and metrics as
+structured JSON lines on stdout. No OpenTelemetry dependency — ideal for local
+development or simple services that ship logs from stdout.
+
+```bash
+pnpm add @youssoufcherif/signals-node
+```
+
+```ts
+import { createNodeSignals } from '@youssoufcherif/signals-node';
+
+const signals = createNodeSignals({ pretty: true }); // options optional
+
+await signals.trace.run('checkout.process', async (ctx) => {
+  ctx.log.info('processing checkout'); // JSON line, correlated to the span
+});
+await signals.shutdown();
+```
+
+MIT © Youssouf Cherif Hamed

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createNodeSignals, makeNodePort } from './make-node-port.js';
+export type { NodePortOptions } from './make-node-port.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createNodeSignals, makeNodePort } from './make-node-port.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/internal/error-to-attrs.d.ts

@@ -0,0 +1,10 @@
+import type { AttrRecord } from '@youssoufcherif/signals-core';
+/**
+ * `instanceof Error` here is normal JS error normalization, not a vendor
+ * telemetry type crossing a port boundary — the ADR-0001 restriction is
+ * about vendor SDK objects (Span, Resource, ...) never requiring a
+ * business-code `instanceof` check to use. Kept in `internal/` anyway to
+ * stay on the conservative side of that line.
+ */
+export declare function errorToAttrs(err: unknown): AttrRecord;
+//# sourceMappingURL=error-to-attrs.d.ts.map

package/dist/internal/error-to-attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-to-attrs.d.ts","sourceRoot":"","sources":["../../src/internal/error-to-attrs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAKrD"}

package/dist/internal/error-to-attrs.js

@@ -0,0 +1,14 @@
+/**
+ * `instanceof Error` here is normal JS error normalization, not a vendor
+ * telemetry type crossing a port boundary — the ADR-0001 restriction is
+ * about vendor SDK objects (Span, Resource, ...) never requiring a
+ * business-code `instanceof` check to use. Kept in `internal/` anyway to
+ * stay on the conservative side of that line.
+ */
+export function errorToAttrs(err) {
+    if (err instanceof Error) {
+        return { errorName: err.name, errorMessage: err.message, errorStack: err.stack ?? '' };
+    }
+    return { errorMessage: String(err) };
+}
+//# sourceMappingURL=error-to-attrs.js.map

package/dist/internal/error-to-attrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-to-attrs.js","sourceRoot":"","sources":["../../src/internal/error-to-attrs.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;IACzF,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;AACvC,CAAC"}

package/dist/make-node-port.d.ts

@@ -0,0 +1,17 @@
+import type { Signals, SignalsPort } from '@youssoufcherif/signals-core';
+export type NodePortOptions = {
+    /** Pretty-print JSON output. Defaults to false (one line per event). */
+    pretty?: boolean;
+    /** Injectable for testing; defaults to the real console. */
+    write?: (line: string) => void;
+};
+/**
+ * The node strategy: a real, working provider backed by `console` and
+ * `performance.now()` — nothing from `@opentelemetry/*`. Useful for CLIs,
+ * scripts, and any context where pulling in the OTel SDK isn't worth the
+ * dependency weight or cold-start cost, but structured output is still
+ * wanted over silence.
+ */
+export declare function makeNodePort(options?: NodePortOptions): SignalsPort;
+export declare function createNodeSignals(options?: NodePortOptions): Signals;
+//# sourceMappingURL=make-node-port.d.ts.map

package/dist/make-node-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-node-port.d.ts","sourceRoot":"","sources":["../src/make-node-port.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,OAAO,EAAE,WAAW,EAAc,MAAM,8BAA8B,CAAC;AAGjG,MAAM,MAAM,eAAe,GAAG;IAC5B,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,CAAC;AAMF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,eAAoB,GAAG,WAAW,CAsEvE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAEpE"}

package/dist/make-node-port.js

@@ -0,0 +1,61 @@
+import { createSignals } from '@youssoufcherif/signals-core';
+import { errorToAttrs } from './internal/error-to-attrs.js';
+function serialize(payload, pretty) {
+    return pretty ? JSON.stringify(payload, null, 2) : JSON.stringify(payload);
+}
+/**
+ * The node strategy: a real, working provider backed by `console` and
+ * `performance.now()` — nothing from `@opentelemetry/*`. Useful for CLIs,
+ * scripts, and any context where pulling in the OTel SDK isn't worth the
+ * dependency weight or cold-start cost, but structured output is still
+ * wanted over silence.
+ */
+export function makeNodePort(options = {}) {
+    const write = options.write ?? ((line) => console.log(line));
+    let spanCounter = 0;
+    const startSpan = (name, parent, attrs) => {
+        const id = `span-${++spanCounter}`;
+        const parentSpanId = parent?.getCorrelation()['spanId'];
+        const startedAt = performance.now();
+        const attributes = { ...attrs };
+        write(serialize({ evt: 'span.start', span: name, id, parentId: parentSpanId, attributes }, options.pretty));
+        const handle = {
+            setAttribute: (key, value) => {
+                attributes[key] = value;
+            },
+            addEvent: (eventName, eventAttrs) => {
+                write(serialize({ evt: 'span.event', span: name, id, name: eventName, attrs: eventAttrs }, options.pretty));
+            },
+            recordException: (err) => {
+                write(serialize({ evt: 'span.exception', span: name, id, error: errorToAttrs(err) }, options.pretty));
+            },
+            end: () => {
+                write(serialize({
+                    evt: 'span.end',
+                    span: name,
+                    id,
+                    durationMs: performance.now() - startedAt,
+                    attributes,
+                }, options.pretty));
+            },
+            getCorrelation: () => ({ traceId: 'node-trace', spanId: id }),
+        };
+        return handle;
+    };
+    const log = (level, message, attrs) => {
+        write(serialize({ evt: 'log', level, message, ...attrs }, options.pretty));
+    };
+    const recordMetric = (kind, name, value, attrs) => {
+        write(serialize({ evt: 'metric', kind, name, value, ...attrs }, options.pretty));
+    };
+    return {
+        startSpan,
+        log,
+        recordMetric,
+        flush: async () => { },
+    };
+}
+export function createNodeSignals(options) {
+    return createSignals(makeNodePort(options));
+}
+//# sourceMappingURL=make-node-port.js.map

package/dist/make-node-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-node-port.js","sourceRoot":"","sources":["../src/make-node-port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAS5D,SAAS,SAAS,CAAC,OAAgC,EAAE,MAA2B;IAC9E,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,UAA2B,EAAE;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,MAAM,SAAS,GAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;QAClE,MAAM,EAAE,GAAG,QAAQ,EAAE,WAAW,EAAE,CAAC;QACnC,MAAM,YAAY,GAAG,MAAM,EAAE,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACpC,MAAM,UAAU,GAAe,EAAE,GAAG,KAAK,EAAE,CAAC;QAE5C,KAAK,CACH,SAAS,CACP,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,EACzE,OAAO,CAAC,MAAM,CACf,CACF,CAAC;QAEF,MAAM,MAAM,GAAe;YACzB,YAAY,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;gBAC3B,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC1B,CAAC;YACD,QAAQ,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE;gBAClC,KAAK,CACH,SAAS,CACP,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,EACzE,OAAO,CAAC,MAAM,CACf,CACF,CAAC;YACJ,CAAC;YACD,eAAe,EAAE,CAAC,GAAG,EAAE,EAAE;gBACvB,KAAK,CACH,SAAS,CACP,EAAE,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,EACnE,OAAO,CAAC,MAAM,CACf,CACF,CAAC;YACJ,CAAC;YACD,GAAG,EAAE,GAAG,EAAE;gBACR,KAAK,CACH,SAAS,CACP;oBACE,GAAG,EAAE,UAAU;oBACf,IAAI,EAAE,IAAI;oBACV,EAAE;oBACF,UAAU,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS;oBACzC,UAAU;iBACX,EACD,OAAO,CAAC,MAAM,CACf,CACF,CAAC;YACJ,CAAC;YACD,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;SAC9D,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,GAAG,GAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACxD,KAAK,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC;IAEF,MAAM,YAAY,GAAgC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC7E,KAAK,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACnF,CAAC,CAAC;IAEF,OAAO;QACL,SAAS;QACT,GAAG;QACH,YAAY;QACZ,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAyB;IACzD,OAAO,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@youssoufcherif/signals-node",
+  "version": "0.0.1",
+  "description": "Lightweight console-based Signals provider - no OpenTelemetry dependency.",
+  "license": "MIT",
+  "author": "Youssouf Cherif Hamed <youssouf.cherif.hamed@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yhcherif/signals.git",
+    "directory": "packages/node"
+  },
+  "homepage": "https://github.com/yhcherif/signals/tree/main/packages/node#readme",
+  "bugs": "https://github.com/yhcherif/signals/issues",
+  "keywords": [
+    "telemetry",
+    "observability",
+    "signals",
+    "console",
+    "structured-logging"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@youssoufcherif/signals-core": "0.0.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0",
+    "@types/node": "^22.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  }
+}