@youssoufcherif/signals-noop 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,22 @@
+# @youssoufcherif/signals-noop
+
+> ⚠️ **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).
+
+Zero-overhead provider for [Signals](https://github.com/yhcherif/signals):
+every operation is a no-op. Use it to disable telemetry entirely (e.g. on
+cold-start-sensitive paths) without touching instrumented code.
+
+```bash
+pnpm add @youssoufcherif/signals-noop
+```
+
+```ts
+import { createNoopSignals } from '@youssoufcherif/signals-noop';
+
+const signals = createNoopSignals();
+// identical Signals API — trace.run still runs your callback, records nothing
+```
+
+MIT © Youssouf Cherif Hamed

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { createNoopSignals, makeNoopPort } from './make-noop-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"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createNoopSignals, makeNoopPort } from './make-noop-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/make-noop-port.d.ts

@@ -0,0 +1,12 @@
+import type { Signals, SignalsPort } from '@youssoufcherif/signals-core';
+/**
+ * The noop strategy: every method is a stable no-op. Useful as the
+ * "telemetry is off" switch — e.g. in a CLI's default mode, or a
+ * cold-start-sensitive Lambda path that opts out of tracing entirely.
+ * Because it satisfies the exact same `SignalsPort` shape as every other
+ * adapter, no code anywhere needs to special-case "telemetry might be
+ * disabled" — it's just another strategy.
+ */
+export declare function makeNoopPort(): SignalsPort;
+export declare function createNoopSignals(): Signals;
+//# sourceMappingURL=make-noop-port.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"make-noop-port.d.ts","sourceRoot":"","sources":["../src/make-noop-port.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAc,MAAM,8BAA8B,CAAC;AAUrF;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,WAAW,CAO1C;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}

package/dist/make-noop-port.js

@@ -0,0 +1,28 @@
+import { createSignals } from '@youssoufcherif/signals-core';
+const inertSpan = {
+    setAttribute: () => { },
+    addEvent: () => { },
+    recordException: () => { },
+    end: () => { },
+    getCorrelation: () => ({}),
+};
+/**
+ * The noop strategy: every method is a stable no-op. Useful as the
+ * "telemetry is off" switch — e.g. in a CLI's default mode, or a
+ * cold-start-sensitive Lambda path that opts out of tracing entirely.
+ * Because it satisfies the exact same `SignalsPort` shape as every other
+ * adapter, no code anywhere needs to special-case "telemetry might be
+ * disabled" — it's just another strategy.
+ */
+export function makeNoopPort() {
+    return {
+        startSpan: () => inertSpan,
+        log: () => { },
+        recordMetric: () => { },
+        flush: async () => { },
+    };
+}
+export function createNoopSignals() {
+    return createSignals(makeNoopPort());
+}
+//# sourceMappingURL=make-noop-port.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"make-noop-port.js","sourceRoot":"","sources":["../src/make-noop-port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,MAAM,SAAS,GAAe;IAC5B,YAAY,EAAE,GAAG,EAAE,GAAE,CAAC;IACtB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;IAClB,eAAe,EAAE,GAAG,EAAE,GAAE,CAAC;IACzB,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;IACb,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;CAC3B,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS;QAC1B,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;QACb,YAAY,EAAE,GAAG,EAAE,GAAE,CAAC;QACtB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,aAAa,CAAC,YAAY,EAAE,CAAC,CAAC;AACvC,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@youssoufcherif/signals-noop",
+  "version": "0.0.1",
+  "description": "Zero-overhead Signals provider - every operation is a no-op.",
+  "license": "MIT",
+  "author": "Youssouf Cherif Hamed <youssouf.cherif.hamed@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yhcherif/signals.git",
+    "directory": "packages/noop"
+  },
+  "homepage": "https://github.com/yhcherif/signals/tree/main/packages/noop#readme",
+  "bugs": "https://github.com/yhcherif/signals/issues",
+  "keywords": [
+    "telemetry",
+    "observability",
+    "signals",
+    "noop",
+    "zero-overhead"
+  ],
+  "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"
+  }
+}