@youssoufcherif/signals-memory 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,34 @@
+# @youssoufcherif/signals-memory
+
+> ⚠️ **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).
+
+In-memory provider for [Signals](https://github.com/yhcherif/signals). A real,
+working implementation that records every span, log, and metric in process
+memory — the test double for code instrumented with Signals, with no mocking
+library involved.
+
+```bash
+pnpm add -D @youssoufcherif/signals-memory
+```
+
+```ts
+import { createMemorySignals } from '@youssoufcherif/signals-memory';
+
+const signals = createMemorySignals();
+
+await signals.trace.run('checkout.process', async (ctx) => {
+  ctx.metric.counter('payment.attempts');
+});
+
+signals.getSpans();   // RecordedSpan[]
+signals.getLogs();    // RecordedLog[]
+signals.getMetrics(); // RecordedMetric[]
+signals.reset();
+```
+
+For readable assertions on top of this, see
+[`@youssoufcherif/signals-testing`](https://www.npmjs.com/package/@youssoufcherif/signals-testing).
+
+MIT © Youssouf Cherif Hamed

package/dist/create-memory-signals.d.ts

@@ -0,0 +1,20 @@
+import type { Signals } from '@youssoufcherif/signals-core';
+import type { RecordedLog, RecordedMetric, RecordedSpan } from './make-memory-port.js';
+export type MemorySignals = Signals & {
+    getSpans: () => RecordedSpan[];
+    getLogs: () => RecordedLog[];
+    getMetrics: () => RecordedMetric[];
+    reset: () => void;
+};
+/**
+ * The one-line convenience matching the "fake strategy is enough" goal:
+ *
+ *   const signals = createMemorySignals();
+ *   await signals.trace.run('checkout', ...);
+ *   expect(signals.getSpans()).toHaveLength(1);
+ *
+ * This is a real, working implementation exercising the exact same
+ * `createSignals` composition every other adapter uses — not a mock.
+ */
+export declare function createMemorySignals(): MemorySignals;
+//# sourceMappingURL=create-memory-signals.d.ts.map

package/dist/create-memory-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-memory-signals.d.ts","sourceRoot":"","sources":["../src/create-memory-signals.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEvF,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG;IACpC,QAAQ,EAAE,MAAM,YAAY,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,WAAW,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,cAAc,EAAE,CAAC;IACnC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAUnD"}

package/dist/create-memory-signals.js

@@ -0,0 +1,24 @@
+import { createSignals } from '@youssoufcherif/signals-core';
+import { makeMemoryPort } from './make-memory-port.js';
+/**
+ * The one-line convenience matching the "fake strategy is enough" goal:
+ *
+ *   const signals = createMemorySignals();
+ *   await signals.trace.run('checkout', ...);
+ *   expect(signals.getSpans()).toHaveLength(1);
+ *
+ * This is a real, working implementation exercising the exact same
+ * `createSignals` composition every other adapter uses — not a mock.
+ */
+export function createMemorySignals() {
+    const memoryPort = makeMemoryPort();
+    const signals = createSignals(memoryPort);
+    return {
+        ...signals,
+        getSpans: memoryPort.getSpans,
+        getLogs: memoryPort.getLogs,
+        getMetrics: memoryPort.getMetrics,
+        reset: memoryPort.reset,
+    };
+}
+//# sourceMappingURL=create-memory-signals.js.map

package/dist/create-memory-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-memory-signals.js","sourceRoot":"","sources":["../src/create-memory-signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAUvD;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1C,OAAO;QACL,GAAG,OAAO;QACV,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,KAAK,EAAE,UAAU,CAAC,KAAK;KACxB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { makeMemoryPort } from './make-memory-port.js';
+export type { MemoryPort, RecordedLog, RecordedMetric, RecordedSpan } from './make-memory-port.js';
+export { createMemorySignals } from './create-memory-signals.js';
+export type { MemorySignals } from './create-memory-signals.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,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { makeMemoryPort } from './make-memory-port.js';
+export { createMemorySignals } from './create-memory-signals.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,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

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

@@ -0,0 +1,43 @@
+import type { AttrRecord, LogLevel, MetricKind, SpanHandle } from '@youssoufcherif/signals-core';
+export type RecordedSpan = {
+    id: string;
+    name: string;
+    parentId?: string | undefined;
+    attributes: AttrRecord;
+    events: {
+        name: string;
+        attrs?: AttrRecord | undefined;
+    }[];
+    exceptions: unknown[];
+    ended: boolean;
+};
+export type RecordedLog = {
+    level: LogLevel;
+    message: string;
+    attrs?: AttrRecord | undefined;
+};
+export type RecordedMetric = {
+    kind: MetricKind;
+    name: string;
+    value: number;
+    attrs?: AttrRecord | undefined;
+};
+/**
+ * The memory strategy: `SignalsPort` implemented with plain closures over
+ * arrays, plus three inspection getters that are NOT part of `SignalsPort`
+ * — they're extra surface this package adds on top so tests can assert on
+ * what happened. Returning "port fields + extra fields" still satisfies
+ * `SignalsPort` structurally; nothing here needs a class or a cast.
+ */
+export declare function makeMemoryPort(): {
+    startSpan: (name: string, parent: SpanHandle | undefined, attrs?: AttrRecord) => SpanHandle;
+    log: (level: LogLevel, message: string, attrs?: AttrRecord) => void;
+    recordMetric: (kind: MetricKind, name: string, value: number, attrs?: AttrRecord) => void;
+    flush: () => Promise<void>;
+    getSpans: () => RecordedSpan[];
+    getLogs: () => RecordedLog[];
+    getMetrics: () => RecordedMetric[];
+    reset: () => void;
+};
+export type MemoryPort = ReturnType<typeof makeMemoryPort>;
+//# sourceMappingURL=make-memory-port.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"make-memory-port.d.ts","sourceRoot":"","sources":["../src/make-memory-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EAEV,UAAU,EACX,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;KAAE,EAAE,CAAC;IAC3D,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,cAAc;;;;;oBAqDZ,YAAY,EAAE;mBACf,WAAW,EAAE;sBACV,cAAc,EAAE;iBACrB,IAAI;EAMlB;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/make-memory-port.js

@@ -0,0 +1,65 @@
+/**
+ * The memory strategy: `SignalsPort` implemented with plain closures over
+ * arrays, plus three inspection getters that are NOT part of `SignalsPort`
+ * — they're extra surface this package adds on top so tests can assert on
+ * what happened. Returning "port fields + extra fields" still satisfies
+ * `SignalsPort` structurally; nothing here needs a class or a cast.
+ */
+export function makeMemoryPort() {
+    const spans = [];
+    const logs = [];
+    const metrics = [];
+    let spanCounter = 0;
+    const startSpan = (name, parent, attrs) => {
+        const id = `span-${++spanCounter}`;
+        const parentSpanId = parent?.getCorrelation()['spanId'];
+        const record = {
+            id,
+            name,
+            parentId: typeof parentSpanId === 'string' ? parentSpanId : undefined,
+            attributes: { ...attrs },
+            events: [],
+            exceptions: [],
+            ended: false,
+        };
+        spans.push(record);
+        const handle = {
+            setAttribute: (key, value) => {
+                record.attributes[key] = value;
+            },
+            addEvent: (eventName, eventAttrs) => {
+                record.events.push({ name: eventName, attrs: eventAttrs });
+            },
+            recordException: (error) => {
+                record.exceptions.push(error);
+            },
+            end: () => {
+                record.ended = true;
+            },
+            getCorrelation: () => ({ traceId: 'memory-trace', spanId: id }),
+        };
+        return handle;
+    };
+    const log = (level, message, attrs) => {
+        logs.push({ level, message, attrs });
+    };
+    const recordMetric = (kind, name, value, attrs) => {
+        metrics.push({ kind, name, value, attrs });
+    };
+    const flush = async () => { };
+    return {
+        startSpan,
+        log,
+        recordMetric,
+        flush,
+        getSpans: () => [...spans],
+        getLogs: () => [...logs],
+        getMetrics: () => [...metrics],
+        reset: () => {
+            spans.length = 0;
+            logs.length = 0;
+            metrics.length = 0;
+        },
+    };
+}
+//# sourceMappingURL=make-memory-port.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"make-memory-port.js","sourceRoot":"","sources":["../src/make-memory-port.ts"],"names":[],"mappings":"AA+BA;;;;;;GAMG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAkB,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,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,MAAM,GAAiB;YAC3B,EAAE;YACF,IAAI;YACJ,QAAQ,EAAE,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;YACrE,UAAU,EAAE,EAAE,GAAG,KAAK,EAAE;YACxB,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,EAAE;YACd,KAAK,EAAE,KAAK;SACb,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEnB,MAAM,MAAM,GAAe;YACzB,YAAY,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;gBAC3B,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACjC,CAAC;YACD,QAAQ,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE;gBAClC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;YAC7D,CAAC;YACD,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE;gBACzB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;YACD,GAAG,EAAE,GAAG,EAAE;gBACR,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;YACtB,CAAC;YACD,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;SAChE,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,GAAG,GAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACxD,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC;IAEF,MAAM,YAAY,GAAgC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC7E,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEF,MAAM,KAAK,GAAyB,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;IAEnD,OAAO;QACL,SAAS;QACT,GAAG;QACH,YAAY;QACZ,KAAK;QACL,QAAQ,EAAE,GAAmB,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;QAC1C,OAAO,EAAE,GAAkB,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;QACvC,UAAU,EAAE,GAAqB,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC;QAChD,KAAK,EAAE,GAAS,EAAE;YAChB,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YAChB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@youssoufcherif/signals-memory",
+  "version": "0.0.1",
+  "description": "In-memory Signals provider for tests - a real, working strategy, not a mock.",
+  "license": "MIT",
+  "author": "Youssouf Cherif Hamed <youssouf.cherif.hamed@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yhcherif/signals.git",
+    "directory": "packages/memory"
+  },
+  "homepage": "https://github.com/yhcherif/signals/tree/main/packages/memory#readme",
+  "bugs": "https://github.com/yhcherif/signals/issues",
+  "keywords": [
+    "telemetry",
+    "observability",
+    "signals",
+    "testing",
+    "in-memory"
+  ],
+  "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"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  }
+}