@dudousxd/nestjs-telescope-testing 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Davi Carvalho
+
+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,58 @@
+# @dudousxd/nestjs-telescope-testing
+
+Test utilities for [`@dudousxd/nestjs-telescope`](https://github.com/DavideCarvalho/nestjs-telescope).
+
+## Install
+
+```bash
+pnpm add -D @dudousxd/nestjs-telescope-testing
+```
+
+## `FakeClock`
+
+A deterministic clock you can pass as the `now` option to `Recorder`.
+
+```ts
+import { FakeClock } from '@dudousxd/nestjs-telescope-testing';
+
+const clock = new FakeClock(0);
+clock.now();        // 0
+clock.advance(500); // move forward 500 ms
+clock.now();        // 500
+clock.set(1000);    // jump to absolute ms
+clock.now();        // 1000
+```
+
+## `collectWatcherEntries`
+
+Registers a `Watcher` against a minimal capturing `WatcherContext` and returns everything it recorded — no NestJS app required.
+
+```ts
+import { collectWatcherEntries } from '@dudousxd/nestjs-telescope-testing';
+import type { Watcher, WatcherContext } from '@dudousxd/nestjs-telescope';
+
+const myWatcher: Watcher = {
+  type: 'demo',
+  register(ctx: WatcherContext) {
+    ctx.record({ type: 'demo', content: { hello: 'world' } });
+  },
+};
+
+const { recorded, context } = await collectWatcherEntries(myWatcher);
+// recorded[0] => { type: 'demo', content: { hello: 'world' } }
+
+// You can also drive batch handles:
+const handle = context.beginBatch('manual');
+// handle.id => 'batch-0'
+handle.end();
+```
+
+## `InMemoryStorageProvider` (re-export)
+
+`@dudousxd/nestjs-telescope-testing` re-exports `InMemoryStorageProvider` from core so tests only need one import.
+
+```ts
+import { InMemoryStorageProvider } from '@dudousxd/nestjs-telescope-testing';
+
+const storage = new InMemoryStorageProvider();
+```

package/dist/collect-watcher-entries.d.ts

@@ -0,0 +1,8 @@
+import { type RecordInput, type Watcher, type WatcherContext } from '@dudousxd/nestjs-telescope';
+export interface CollectedWatcher {
+    recorded: RecordInput[];
+    context: WatcherContext;
+}
+/** Register `watcher` against a capturing context; returns recorded inputs + the context. */
+export declare function collectWatcherEntries(watcher: Watcher): Promise<CollectedWatcher>;
+//# sourceMappingURL=collect-watcher-entries.d.ts.map

package/dist/collect-watcher-entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-watcher-entries.d.ts","sourceRoot":"","sources":["../src/collect-watcher-entries.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,cAAc,EAEpB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,6FAA6F;AAC7F,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqBvF"}

package/dist/collect-watcher-entries.js

@@ -0,0 +1,23 @@
+import { resolveConfig, } from '@dudousxd/nestjs-telescope';
+/** Register `watcher` against a capturing context; returns recorded inputs + the context. */
+export async function collectWatcherEntries(watcher) {
+    const recorded = [];
+    const config = resolveConfig({});
+    let counter = 0;
+    const context = {
+        record: (input) => {
+            recorded.push(input);
+        },
+        runInBatch: (_origin, fn) => fn(),
+        beginBatch: () => ({ id: `batch-${counter++}`, end: () => { } }),
+        config,
+        moduleRef: {
+            get: () => {
+                throw new Error('moduleRef.get is not available in collectWatcherEntries');
+            },
+        },
+    };
+    await watcher.register(context);
+    return { recorded, context };
+}
+//# sourceMappingURL=collect-watcher-entries.js.map

package/dist/collect-watcher-entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-watcher-entries.js","sourceRoot":"","sources":["../src/collect-watcher-entries.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,aAAa,GACd,MAAM,4BAA4B,CAAC;AAOpC,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAgB;IAC1D,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,MAAM,OAAO,GAAmB;QAC9B,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAChB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QACD,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;QACjC,UAAU,EAAE,GAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;QAC5E,MAAM;QACN,SAAS,EAAE;YACT,GAAG,EAAE,GAAG,EAAE;gBACR,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;YAC7E,CAAC;SACwC;KAC5C,CAAC;IAEF,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/dist/fake-clock.d.ts

@@ -0,0 +1,12 @@
+/** A controllable clock for deterministic tests. */
+export declare class FakeClock {
+    private current;
+    constructor(current?: number);
+    /** Returns the current epoch-ms; pass as the Recorder's `now`. */
+    now: () => number;
+    /** Advance the clock by `ms`. */
+    advance(ms: number): void;
+    /** Set the clock to an absolute epoch-ms. */
+    set(ms: number): void;
+}
+//# sourceMappingURL=fake-clock.d.ts.map

package/dist/fake-clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-clock.d.ts","sourceRoot":"","sources":["../src/fake-clock.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,qBAAa,SAAS;IACR,OAAO,CAAC,OAAO;gBAAP,OAAO,SAAI;IAE/B,kEAAkE;IAClE,GAAG,QAAO,MAAM,CAAiB;IAEjC,iCAAiC;IACjC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIzB,6CAA6C;IAC7C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAGtB"}

package/dist/fake-clock.js

@@ -0,0 +1,18 @@
+/** A controllable clock for deterministic tests. */
+export class FakeClock {
+    current;
+    constructor(current = 0) {
+        this.current = current;
+    }
+    /** Returns the current epoch-ms; pass as the Recorder's `now`. */
+    now = () => this.current;
+    /** Advance the clock by `ms`. */
+    advance(ms) {
+        this.current += ms;
+    }
+    /** Set the clock to an absolute epoch-ms. */
+    set(ms) {
+        this.current = ms;
+    }
+}
+//# sourceMappingURL=fake-clock.js.map

package/dist/fake-clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-clock.js","sourceRoot":"","sources":["../src/fake-clock.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,MAAM,OAAO,SAAS;IACA;IAApB,YAAoB,UAAU,CAAC;QAAX,YAAO,GAAP,OAAO,CAAI;IAAG,CAAC;IAEnC,kEAAkE;IAClE,GAAG,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;IAEjC,iCAAiC;IACjC,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,6CAA6C;IAC7C,GAAG,CAAC,EAAU;QACZ,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { InMemoryStorageProvider } from '@dudousxd/nestjs-telescope';
+export * from './fake-clock.js';
+export * from './collect-watcher-entries.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,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { InMemoryStorageProvider } from '@dudousxd/nestjs-telescope';
+export * from './fake-clock.js';
+export * from './collect-watcher-entries.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,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@dudousxd/nestjs-telescope-testing",
+  "version": "1.0.0",
+  "description": "Test utilities for @dudousxd/nestjs-telescope — FakeClock, watcher harness, InMemoryStorageProvider re-export.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DavideCarvalho/nestjs-telescope.git",
+    "directory": "packages/testing"
+  },
+  "author": "Davi Carvalho <davi@goflip.ai>",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@dudousxd/nestjs-telescope": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^3.0.0",
+    "@dudousxd/nestjs-telescope": "1.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "nestjs",
+    "telescope",
+    "testing",
+    "observability"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}