@youssoufcherif/signals-testing 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-testing
+
+> ⚠️ **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).
+
+Assertion helpers for testing code instrumented with
+[Signals](https://github.com/yhcherif/signals), built on the in-memory
+provider — no mocking library, ever. Re-exports `createMemorySignals` so a
+test file needs a single import.
+
+```bash
+pnpm add -D @youssoufcherif/signals-testing
+```
+
+```ts
+import {
+  createMemorySignals,
+  expectLogMessage,
+  expectMetric,
+  expectSpan,
+  expectSpanEnded,
+} from '@youssoufcherif/signals-testing';
+
+const signals = createMemorySignals();
+await processCheckout(signals, order); // your code, Signals injected
+
+const span = expectSpan(signals, 'checkout.process');
+expectSpanEnded(signals, 'checkout.process');
+expectLogMessage(signals, 'processing checkout');
+expectMetric(signals, 'payment.attempts');
+```
+
+MIT © Youssouf Cherif Hamed

package/dist/assertions.d.ts

@@ -0,0 +1,11 @@
+import type { MemorySignals, RecordedSpan } from '@youssoufcherif/signals-memory';
+/**
+ * Finds a recorded span by name, or throws with a helpful message listing
+ * what was actually recorded. Plain function, not a custom Vitest matcher
+ * — keeps this package usable from any test runner, not just Vitest.
+ */
+export declare function expectSpan(signals: MemorySignals, name: string): RecordedSpan;
+export declare function expectSpanEnded(signals: MemorySignals, name: string): void;
+export declare function expectLogMessage(signals: MemorySignals, message: string): void;
+export declare function expectMetric(signals: MemorySignals, name: string): void;
+//# sourceMappingURL=assertions.d.ts.map

package/dist/assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../src/assertions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAElF;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAS7E;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAK1E;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQ9E;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQvE"}

package/dist/assertions.js

@@ -0,0 +1,34 @@
+/**
+ * Finds a recorded span by name, or throws with a helpful message listing
+ * what was actually recorded. Plain function, not a custom Vitest matcher
+ * — keeps this package usable from any test runner, not just Vitest.
+ */
+export function expectSpan(signals, name) {
+    const span = signals.getSpans().find((s) => s.name === name);
+    if (!span) {
+        const recordedNames = signals.getSpans().map((s) => s.name);
+        throw new Error(`Expected a span named "${name}" but none was recorded. Recorded spans: [${recordedNames.join(', ')}]`);
+    }
+    return span;
+}
+export function expectSpanEnded(signals, name) {
+    const span = expectSpan(signals, name);
+    if (!span.ended) {
+        throw new Error(`Expected span "${name}" to have ended, but it is still open.`);
+    }
+}
+export function expectLogMessage(signals, message) {
+    const found = signals.getLogs().some((log) => log.message === message);
+    if (!found) {
+        const recordedMessages = signals.getLogs().map((log) => log.message);
+        throw new Error(`Expected a log with message "${message}" but none was recorded. Recorded messages: [${recordedMessages.join(', ')}]`);
+    }
+}
+export function expectMetric(signals, name) {
+    const found = signals.getMetrics().some((metric) => metric.name === name);
+    if (!found) {
+        const recordedNames = signals.getMetrics().map((metric) => metric.name);
+        throw new Error(`Expected a metric named "${name}" but none was recorded. Recorded metrics: [${recordedNames.join(', ')}]`);
+    }
+}
+//# sourceMappingURL=assertions.js.map

package/dist/assertions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.js","sourceRoot":"","sources":["../src/assertions.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,OAAsB,EAAE,IAAY;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC7D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,6CAA6C,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACvG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAsB,EAAE,IAAY;IAClE,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,wCAAwC,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAsB,EAAE,OAAe;IACtE,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IACvE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrE,MAAM,IAAI,KAAK,CACb,gCAAgC,OAAO,gDAAgD,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACtH,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAsB,EAAE,IAAY;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC1E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxE,MAAM,IAAI,KAAK,CACb,4BAA4B,IAAI,+CAA+C,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC3G,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { expectLogMessage, expectMetric, expectSpan, expectSpanEnded } from './assertions.js';
+export { createMemorySignals } from '@youssoufcherif/signals-memory';
+export type { MemorySignals, RecordedLog, RecordedMetric, RecordedSpan, } from '@youssoufcherif/signals-memory';
+//# 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,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,YAAY,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,YAAY,GACb,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { expectLogMessage, expectMetric, expectSpan, expectSpanEnded } from './assertions.js';
+export { createMemorySignals } from '@youssoufcherif/signals-memory';
+//# 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,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@youssoufcherif/signals-testing",
+  "version": "0.0.1",
+  "description": "Assertion helpers for testing code instrumented with Signals.",
+  "license": "MIT",
+  "author": "Youssouf Cherif Hamed <youssouf.cherif.hamed@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yhcherif/signals.git",
+    "directory": "packages/testing"
+  },
+  "homepage": "https://github.com/yhcherif/signals/tree/main/packages/testing#readme",
+  "bugs": "https://github.com/yhcherif/signals/issues",
+  "keywords": [
+    "telemetry",
+    "observability",
+    "signals",
+    "testing",
+    "assertions",
+    "vitest"
+  ],
+  "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",
+    "@youssoufcherif/signals-memory": "0.0.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  }
+}