@justscale/testing 0.1.0

package/dist/conformance/cluster-primitives.js

@@ -0,0 +1,50 @@
+/**
+ * Adapter conformance suite - cluster primitives.
+ *
+ * Every cluster-capable adapter (Postgres, Redis, future) must pass this
+ * suite to claim conformance. Shape follows the well-trod JDBC/ODBC
+ * pattern: one abstract spec, multiple concrete runners.
+ *
+ * ## How to use
+ *
+ * ```typescript
+ * import { describeClusterConformance } from '@justscale/testing/conformance';
+ * import { PostgresFeature, PostgresChannelFeature, PostgresLockFeature,
+ *          PostgresProcessFeature } from '@justscale/postgres';
+ *
+ * describeClusterConformance('postgres (real docker pg)', {
+ *   makeInstance: () => JustScale()
+ *     .add(env)
+ *     .add(PostgresFeature)
+ *     .add(PostgresChannelFeature)
+ *     .add(PostgresLockFeature)
+ *     .add(PostgresProcessFeature),
+ *   skipIfUnavailable: async () => !(await hasDockerPg()),
+ * });
+ * ```
+ *
+ * ## What it asserts
+ *
+ * 1. Channel pub/sub cross-instance - publish on A, subscribe on B, B receives within 500ms.
+ * 2. Channel isolation - channels keyed differently don't cross-talk.
+ * 3. Lock mutex - two instances racing for the same advisory lock, only one wins; release lets the other acquire.
+ * 4. Lock hand-off - kill lock-holder, another instance picks it up.
+ * 5. Process signal resume - process suspended at race(), signal fires, process wakes and advances pc.
+ * 6. Process cross-instance signal - process running on A, emit from B, A resumes.
+ * 7. Process advisory lock - spawn same process path on two instances, only one runs.
+ *
+ * Each scenario is scoped tight enough to pinpoint the failing primitive.
+ */
+/**
+ * Run the cluster conformance suite against an adapter.
+ *
+ * @param adapterName - Shows up in test output: "cluster-conformance/postgres"
+ * @param opts - How to spin up instances + setup/teardown hooks
+ */
+export function describeClusterConformance(adapterName, opts) {
+    void adapterName;
+    void opts;
+    throw new Error(`describeClusterConformance('${adapterName}', ...) is not yet implemented. ` +
+        'Scenarios are listed in the header comment.');
+}
+//# sourceMappingURL=cluster-primitives.js.map

package/dist/conformance/cluster-primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-primitives.js","sourceRoot":"","sources":["../../src/conformance/cluster-primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAqCH;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,WAAmB,EACnB,IAA+B;IAE/B,KAAK,WAAW,CAAC;IACjB,KAAK,IAAI,CAAC;IACV,MAAM,IAAI,KAAK,CACb,+BAA+B,WAAW,kCAAkC;QAC5E,6CAA6C,CAC9C,CAAC;AACJ,CAAC"}

package/dist/container.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Test Container
+ *
+ * Extended container with support for mocking and overriding services.
+ */
+import { Container, type ServiceToken, type InstanceOf } from '@justscale/core';
+/**
+ * A container designed for testing with mock support.
+ *
+ * @example
+ * ```typescript
+ * const container = new TestContainer();
+ *
+ * // Register real services
+ * container.register(UserRepository);
+ * container.register(UserService);
+ *
+ * // Override with a mock
+ * container.mock(UserRepository, {
+ *   findById: mockFn().returns(Promise.resolve({ id: '1', name: 'Test' })),
+ * });
+ *
+ * // Resolve - will use the mock for UserRepository
+ * const userService = container.resolve(UserService);
+ * ```
+ */
+export declare class TestContainer extends Container {
+    private mocks;
+    /**
+     * Override a service with a mock implementation.
+     * The mock will be used instead of the real service when resolving.
+     */
+    mock<T>(token: ServiceToken<T>, mockInstance: Partial<T>): this;
+    /**
+     * Override a service with a complete replacement instance.
+     */
+    override<T>(token: ServiceToken<T>, instance: T): this;
+    /**
+     * Clear all mocks, restoring original service resolution.
+     */
+    clearMocks(): this;
+    /**
+     * Clear a specific mock.
+     */
+    clearMock<T>(token: ServiceToken<T>): this;
+    /**
+     * Get the mock for a service if one exists.
+     */
+    getMock<T>(token: ServiceToken<T>): T | undefined;
+    /**
+     * Check if a service has been mocked.
+     */
+    isMocked<T>(token: ServiceToken<T>): boolean;
+    /**
+     * Resolve a service - returns mock if available, otherwise resolves normally.
+     */
+    resolve<T>(token: ServiceToken<T>): Promise<T>;
+    /**
+     * Get typed access to a resolved service.
+     * Useful for accessing services in tests.
+     *
+     * @example
+     * ```typescript
+     * const userService = await container.get(UserService);
+     * // userService is typed as InstanceOf<typeof UserService>
+     * ```
+     */
+    get<T extends ServiceToken>(token: T): Promise<InstanceOf<T>>;
+}
+//# sourceMappingURL=container.d.ts.map

package/dist/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,aAAc,SAAQ,SAAS;IAC1C,OAAO,CAAC,KAAK,CAAoC;IAEjD;;;OAGG;IACH,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAK/D;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI;IAKtD;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAK1C;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS;IAIjD;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO;IAI5C;;OAEG;IACY,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAU7D;;;;;;;;;OASG;IACG,GAAG,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;CAGpE"}

package/dist/container.js

@@ -0,0 +1,95 @@
+/**
+ * Test Container
+ *
+ * Extended container with support for mocking and overriding services.
+ */
+import { Container, } from '@justscale/core';
+/**
+ * A container designed for testing with mock support.
+ *
+ * @example
+ * ```typescript
+ * const container = new TestContainer();
+ *
+ * // Register real services
+ * container.register(UserRepository);
+ * container.register(UserService);
+ *
+ * // Override with a mock
+ * container.mock(UserRepository, {
+ *   findById: mockFn().returns(Promise.resolve({ id: '1', name: 'Test' })),
+ * });
+ *
+ * // Resolve - will use the mock for UserRepository
+ * const userService = container.resolve(UserService);
+ * ```
+ */
+export class TestContainer extends Container {
+    mocks = new Map();
+    /**
+     * Override a service with a mock implementation.
+     * The mock will be used instead of the real service when resolving.
+     */
+    mock(token, mockInstance) {
+        this.mocks.set(token, mockInstance);
+        return this;
+    }
+    /**
+     * Override a service with a complete replacement instance.
+     */
+    override(token, instance) {
+        this.mocks.set(token, instance);
+        return this;
+    }
+    /**
+     * Clear all mocks, restoring original service resolution.
+     */
+    clearMocks() {
+        this.mocks.clear();
+        return this;
+    }
+    /**
+     * Clear a specific mock.
+     */
+    clearMock(token) {
+        this.mocks.delete(token);
+        return this;
+    }
+    /**
+     * Get the mock for a service if one exists.
+     */
+    getMock(token) {
+        return this.mocks.get(token);
+    }
+    /**
+     * Check if a service has been mocked.
+     */
+    isMocked(token) {
+        return this.mocks.has(token);
+    }
+    /**
+     * Resolve a service - returns mock if available, otherwise resolves normally.
+     */
+    async resolve(token) {
+        // Check for mock first
+        if (this.mocks.has(token)) {
+            return this.mocks.get(token);
+        }
+        // Fall back to normal resolution
+        return super.resolve(token);
+    }
+    /**
+     * Get typed access to a resolved service.
+     * Useful for accessing services in tests.
+     *
+     * @example
+     * ```typescript
+     * const userService = await container.get(UserService);
+     * // userService is typed as InstanceOf<typeof UserService>
+     * ```
+     */
+    async get(token) {
+        return this.resolve(token);
+    }
+}
+//# sourceMappingURL=container.js.map

package/dist/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,SAAS,GAGV,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAS;IAClC,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEjD;;;OAGG;IACH,IAAI,CAAI,KAAsB,EAAE,YAAwB;QACtD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,QAAQ,CAAI,KAAsB,EAAE,QAAW;QAC7C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,SAAS,CAAI,KAAsB;QACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAI,KAAsB;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAkB,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,QAAQ,CAAI,KAAsB;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACM,KAAK,CAAC,OAAO,CAAI,KAAsB;QAC9C,uBAAuB;QACvB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAM,CAAC;QACpC,CAAC;QAED,iCAAiC;QACjC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,GAAG,CAAyB,KAAQ;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAA2B,CAAC;IACvD,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * JustScale Testing Utilities
+ *
+ * Provides helpers for testing JustScale applications:
+ * - TestContainer: Container with mock support
+ * - createTestApp: Create an app instance for testing
+ * - Test client with pluggable transports
+ */
+export { TestContainer } from './container.js';
+export { createTestApp, type TestApp } from './app.js';
+export { createTestClient, teardownApp, type TestClient, type TestClientWithTransports, type TestClientOptions, type TestTransport, type TransportState, type TransportClient, type TransportOptions, type TestResponse, type BuildControllerAPI, } from './client.js';
+export { createTestKit, type TestKit, type CreateTestKitOptions, type KitBuilderFn, type SpawnHttpOptions, type SpawnHttpResult, } from './kit.js';
+export { mock, mockFn, mockService, spyOn, spyService, mockResolves, mockRejects, mockThrows, assertCalledWith, assertCallCount, assertNotCalled, enableDebuggerFormatters, type MockedService, type SpyWrapper, } from './mock.js';
+export { InMemoryLockProvider } from '@justscale/core/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;;;;;;;GAOG;AASH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,KAAK,UAAU,EACf,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,KAAK,OAAO,EACZ,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAEL,IAAI,EAEJ,MAAM,EACN,WAAW,EACX,KAAK,EACL,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EAEV,gBAAgB,EAChB,eAAe,EACf,eAAe,EAEf,wBAAwB,EAExB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+/**
+ * JustScale Testing Utilities
+ *
+ * Provides helpers for testing JustScale applications:
+ * - TestContainer: Container with mock support
+ * - createTestApp: Create an app instance for testing
+ * - Test client with pluggable transports
+ */
+if (process.env.NODE_ENV === 'production') {
+    throw new Error('@justscale/core/testing must not be imported in production code. ' +
+        'This package contains test-only utilities (mocks, spies, TestContainer).');
+}
+export { TestContainer } from './container.js';
+export { createTestApp } from './app.js';
+export { createTestClient, teardownApp, } from './client.js';
+export { createTestKit, } from './kit.js';
+export { 
+// Re-exported from node:test
+mock, 
+// Mock helpers
+mockFn, mockService, spyOn, spyService, mockResolves, mockRejects, mockThrows, 
+// Assertions
+assertCalledWith, assertCallCount, assertNotCalled, 
+// Debugger support
+enableDebuggerFormatters, } from './mock.js';
+// Lock testing utilities
+export { InMemoryLockProvider } from '@justscale/core/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;;;;;;;GAOG;AAEH,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;IAC1C,MAAM,IAAI,KAAK,CACb,mEAAmE;QACnE,0EAA0E,CAC3E,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAgB,MAAM,UAAU,CAAC;AACvD,OAAO,EACL,gBAAgB,EAChB,WAAW,GAUZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,GAMd,MAAM,UAAU,CAAC;AAClB,OAAO;AACL,6BAA6B;AAC7B,IAAI;AACJ,eAAe;AACf,MAAM,EACN,WAAW,EACX,KAAK,EACL,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU;AACV,aAAa;AACb,gBAAgB,EAChB,eAAe,EACf,eAAe;AACf,mBAAmB;AACnB,wBAAwB,GAIzB,MAAM,WAAW,CAAC;AAEnB,yBAAyB;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/kit.d.ts

@@ -0,0 +1,82 @@
+import JustScale from '@justscale/core';
+import type { App, ControllerDef } from '@justscale/core';
+type JustScaleBuilder = ReturnType<typeof JustScale>;
+import { type TestClientOptions, type TestClientWithTransports, type TestTransport, type BuildControllerAPI } from './client.js';
+/**
+ * Builder factory: receives a fresh JustScale() builder (with the usual
+ * built-ins already provided — Logger, Lifecycle), returns it decorated
+ * with whatever the test wants. The returned Builder must have its
+ * requires satisfied; we call `.build().compile()` on it.
+ */
+export type KitBuilderFn = (b: JustScaleBuilder) => {
+    build: () => {
+        compile: () => App;
+    };
+};
+export interface SpawnHttpOptions<TTransports extends Record<string, TestTransport<unknown, unknown>>, TControllers extends Record<string, ControllerDef<any, any, any>>> extends TestClientOptions<TTransports> {
+    /** Map of controller defs to surface as a typed `controllers` API. */
+    controllers?: TControllers;
+}
+export interface SpawnHttpResult<TTransports extends Record<string, TestTransport<unknown, unknown>>, TControllers extends Record<string, ControllerDef<any, any, any>>> {
+    app: App;
+    client: TestClientWithTransports<App, TTransports>;
+    controllers: BuildControllerAPI<TControllers>;
+}
+/**
+ * Multi-instance test harness. Owns N apps, drains them on dispose.
+ *
+ * Auto-registers `afterEach` from node:test when available so tests
+ * never have to remember cleanup; `using` / explicit `dispose()` are
+ * supported as fallbacks (or for tests outside node:test).
+ *
+ * The framework's story is many-instance coordination — this kit
+ * makes 1 the trivial case of N. `spawnCluster(N, builder)` is the
+ * primitive for distributed-invariant tests (cross-instance lock,
+ * cross-instance channel) that previously required ad-hoc worker
+ * spawning.
+ */
+export interface TestKit {
+    /** Build + compile one app. Adds it to the kit's owned set. */
+    spawn(builderFn: KitBuilderFn): Promise<App>;
+    /**
+     * Build + compile one app AND attach test transport(s) for HTTP-style
+     * testing. Returns a flat result: `{ app, client, controllers }`.
+     * `controllers` is the typed surface for the controller defs you pass.
+     */
+    spawnHttp<TTransports extends Record<string, TestTransport<unknown, unknown>> = Record<string, never>, TControllers extends Record<string, ControllerDef<any, any, any>> = Record<string, never>>(builderFn: KitBuilderFn, options?: SpawnHttpOptions<TTransports, TControllers>): Promise<SpawnHttpResult<TTransports, TControllers>>;
+    /**
+     * N identical instances. Use for distributed-invariant tests:
+     * the apps share infrastructure (same Postgres, same Redis) so
+     * coordination primitives (locks, channels) operate cross-instance.
+     */
+    spawnCluster(n: number, builderFn: KitBuilderFn): Promise<App[]>;
+    /** Drain everything. Idempotent. */
+    dispose(): Promise<void>;
+    /** Apps owned by this kit (live + already-disposed are pruned). */
+    readonly apps: readonly App[];
+    readonly [Symbol.asyncDispose]: () => Promise<void>;
+}
+export interface CreateTestKitOptions {
+    /**
+     * Whether to auto-register `afterEach` from node:test. Defaults to
+     * true. Set to false for tests that manage their own lifecycle.
+     */
+    autoCleanup?: boolean;
+}
+/**
+ * Create a multi-instance test harness. Call at module level (top of
+ * a test file) so its `afterEach` runs after every test in the file.
+ *
+ * @example
+ * ```ts
+ * const kit = createTestKit()
+ *
+ * test('lock cross-instance', async () => {
+ *   const [a, b] = await kit.spawnCluster(2, builder)
+ *   // ... a holds lock, b times out, etc.
+ * })
+ * ```
+ */
+export declare function createTestKit(options?: CreateTestKitOptions): TestKit;
+export {};
+//# sourceMappingURL=kit.d.ts.map

package/dist/kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,EAAE,GAAG,EAAW,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEnE,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AACrD,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,CAAC,EAAE,gBAAgB,KAChB;IAAE,KAAK,EAAE,MAAM;QAAE,OAAO,EAAE,MAAM,GAAG,CAAA;KAAE,CAAA;CAAE,CAAC;AAE7C,MAAM,WAAW,gBAAgB,CAC/B,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,EACnE,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CACjE,SAAQ,iBAAiB,CAAC,WAAW,CAAC;IACtC,sEAAsE;IACtE,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe,CAC9B,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,EACnE,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAEjE,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,wBAAwB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACnD,WAAW,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;CAC/C;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,OAAO;IACtB,+DAA+D;IAC/D,KAAK,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE7C;;;;OAIG;IACH,SAAS,CACP,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC3F,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAEzF,SAAS,EAAE,YAAY,EACvB,OAAO,CAAC,EAAE,gBAAgB,CAAC,WAAW,EAAE,YAAY,CAAC,GACpD,OAAO,CAAC,eAAe,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;IAEvD;;;;OAIG;IACH,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEjE,oCAAoC;IACpC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,CAAC;IAE9B,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CA2GrE"}

package/dist/kit.js

@@ -0,0 +1,114 @@
+import JustScale from '@justscale/core';
+import { createTestClient, teardownApp, } from './client.js';
+/**
+ * Create a multi-instance test harness. Call at module level (top of
+ * a test file) so its `afterEach` runs after every test in the file.
+ *
+ * @example
+ * ```ts
+ * const kit = createTestKit()
+ *
+ * test('lock cross-instance', async () => {
+ *   const [a, b] = await kit.spawnCluster(2, builder)
+ *   // ... a holds lock, b times out, etc.
+ * })
+ * ```
+ */
+export function createTestKit(options) {
+    const owned = [];
+    let disposed = false;
+    async function disposeAll() {
+        if (disposed)
+            return;
+        disposed = true;
+        const errors = [];
+        while (owned.length) {
+            const entry = owned.pop();
+            try {
+                await entry.close();
+            }
+            catch (err) {
+                errors.push(err);
+            }
+        }
+        disposed = false; // allow re-spawn after manual dispose mid-test
+        if (errors.length) {
+            const first = errors[0];
+            throw first instanceof Error ? first : new Error(String(first));
+        }
+    }
+    if (options?.autoCleanup ?? true) {
+        // node:test exposes `afterEach` as a top-level export; if we're
+        // running outside node:test (e.g. a script), this import fails
+        // silently and callers must dispose manually.
+        void (async () => {
+            try {
+                const { afterEach } = await import('node:test');
+                afterEach(async () => {
+                    await disposeAll();
+                });
+            }
+            catch {
+                // not in node:test context
+            }
+        })();
+    }
+    async function buildAndCompile(builderFn) {
+        const builder = builderFn(JustScale());
+        const app = builder.build().compile();
+        await app.ready;
+        return app;
+    }
+    const kit = {
+        async spawn(builderFn) {
+            const app = await buildAndCompile(builderFn);
+            owned.push({ app, close: () => teardownApp(app) });
+            return app;
+        },
+        async spawnHttp(builderFn, opts) {
+            const app = await buildAndCompile(builderFn);
+            const transports = opts?.transports ?? {};
+            const transportOptions = opts?.transportOptions;
+            const client = await createTestClient(app, {
+                transports,
+                transportOptions,
+            });
+            // client.close() already calls teardownApp
+            owned.push({ app, close: () => client.close() });
+            const controllerDefs = (opts?.controllers ?? {});
+            // useControllers lives on the http transport client; only available if the
+            // caller wired the http transport.
+            const httpClient = client['http'];
+            const controllers = httpClient && typeof httpClient.useControllers === 'function' && Object.keys(controllerDefs).length
+                ? httpClient.useControllers(controllerDefs)
+                : {};
+            return {
+                app,
+                client: client,
+                controllers: controllers,
+            };
+        },
+        async spawnCluster(n, builderFn) {
+            if (n < 1)
+                return [];
+            const results = [];
+            // Sequential: deterministic ordering for distributed tests, and the
+            // build phase is fast (DI graph, not network). Parallel build was
+            // an option but it makes timing-sensitive tests harder to reason
+            // about for trivial speedup.
+            for (let i = 0; i < n; i++) {
+                const app = await buildAndCompile(builderFn);
+                owned.push({ app, close: () => teardownApp(app) });
+                results.push(app);
+            }
+            return results;
+        },
+        dispose: disposeAll,
+        get apps() {
+            return owned.map((e) => e.app);
+        },
+        [Symbol.asyncDispose]: () => disposeAll(),
+    };
+    return kit;
+}
+//# sourceMappingURL=kit.js.map

package/dist/kit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit.js","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"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"}

package/dist/mock.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Mocking utilities for JustScale testing
+ *
+ * Integrates with Node.js test runner's mock API while providing
+ * type-safe helpers for mocking services and controllers.
+ *
+ * Supports `using` keyword for automatic cleanup:
+ * ```typescript
+ * using spied = spyOn(service);
+ * // ... test code ...
+ * // automatically restored when block exits
+ * ```
+ */
+import { mock, type Mock as NodeMock } from 'node:test';
+import type { ServiceDef, ServiceToken } from '@justscale/core';
+export { mock };
+/**
+ * Manually enable custom formatters after debugger connects.
+ * This is opt-in — it is not called automatically on import.
+ * Call it early in your test setup if you want CDP-based formatting in the debugger.
+ *
+ * @example
+ * ```typescript
+ * import { enableDebuggerFormatters } from '@justscale/testing';
+ * enableDebuggerFormatters(); // Call early in your test
+ * ```
+ */
+export declare function enableDebuggerFormatters(): void;
+/**
+ * Extract the instance type from a ServiceDef or ServiceToken
+ */
+type ServiceInstance<T> = T extends ServiceDef<infer S, any> ? S : T extends ServiceToken<infer S> ? S : never;
+/**
+ * A mocked version of a service where all methods are mock functions
+ */
+export type MockedService<T> = {
+    [K in keyof T]: T[K] extends (...args: infer A) => infer R ? NodeMock<(...args: A) => R> : T[K];
+};
+/**
+ * A spy wrapper that can be disposed to restore original methods
+ */
+export interface SpyWrapper<T> extends Disposable {
+    /** The spied object with mock functions */
+    readonly spied: MockedService<T>;
+    /** The original object */
+    readonly original: T;
+    /** Reset all mock call tracking */
+    reset(): void;
+    /** Restore original methods (also called on dispose) */
+    restore(): void;
+}
+/**
+ * Create a mock implementation of a service.
+ * Uses node:test mock functions for tracking calls and assertions.
+ *
+ * @example
+ * ```typescript
+ * const mockRepo = mockService<typeof PlayerRepository>({
+ *   get: mock.fn(() => Promise.resolve({ id: '1', name: 'Mock' })),
+ *   find: mock.fn(() => Promise.resolve([])),
+ * });
+ * ```
+ */
+export declare function mockService<T extends ServiceToken>(impl: Partial<MockedService<ServiceInstance<T>>>, name?: string): MockedService<ServiceInstance<T>>;
+/**
+ * Create a spy wrapper around an existing service instance.
+ * All method calls are tracked while still calling the real implementation.
+ *
+ * Supports `using` for automatic cleanup:
+ * ```typescript
+ * using spy = spyOn(playerRepo);
+ * await spy.spied.get(Player.ref('123'));
+ * assertCallCount(spy.spied.get, 1);
+ * // Original methods restored when block exits
+ * ```
+ *
+ * @example Manual cleanup
+ * ```typescript
+ * const spy = spyOn(playerRepo);
+ * try {
+ *   await spy.spied.get(Player.ref('123'));
+ *   assertCallCount(spy.spied.get, 1);
+ * } finally {
+ *   spy.restore();
+ * }
+ * ```
+ */
+export declare function spyOn<T extends object>(instance: T): SpyWrapper<T>;
+/**
+ * Create a spy that wraps an existing service instance.
+ * Returns just the spied object (simpler API, no auto-cleanup).
+ *
+ * @example
+ * ```typescript
+ * const spiedRepo = spyService(playerRepo);
+ * await spiedRepo.get(Player.ref('123'));
+ * assertCallCount(spiedRepo.get, 1);
+ * ```
+ */
+export declare function spyService<T extends object>(instance: T): MockedService<T>;
+/**
+ * Create a mock function with a specific implementation.
+ * @param implementation Optional function to call when the mock is invoked
+ * @param name Optional name for debugging (shown in console.log)
+ */
+export declare function mockFn<TArgs extends unknown[], TReturn>(implementation?: (...args: TArgs) => TReturn, name?: string): NodeMock<(...args: TArgs) => TReturn>;
+/**
+ * Create a mock function that returns a resolved promise.
+ * @param value The value to resolve with
+ * @param name Optional name for debugging (shown in console.log)
+ */
+export declare function mockResolves<T>(value: T, name?: string): NodeMock<(...args: unknown[]) => Promise<T>>;
+/**
+ * Create a mock function that returns a rejected promise.
+ * @param error The error to reject with
+ * @param name Optional name for debugging (shown in console.log)
+ */
+export declare function mockRejects(error: Error, name?: string): NodeMock<(...args: unknown[]) => Promise<never>>;
+/**
+ * Create a mock function that throws an error.
+ * @param error The error to throw
+ * @param name Optional name for debugging (shown in console.log)
+ */
+export declare function mockThrows(error: Error, name?: string): NodeMock<(...args: unknown[]) => never>;
+/**
+ * Assert that a mock was called with specific arguments.
+ */
+export declare function assertCalledWith<TArgs extends unknown[], TReturn>(mockFn: NodeMock<(...args: TArgs) => TReturn>, ...expectedArgs: TArgs): void;
+/**
+ * Assert that a mock was called exactly n times.
+ */
+export declare function assertCallCount<TArgs extends unknown[], TReturn>(mockFn: NodeMock<(...args: TArgs) => TReturn>, expected: number): void;
+/**
+ * Assert that a mock was never called.
+ */
+export declare function assertNotCalled<TArgs extends unknown[], TReturn>(mockFn: NodeMock<(...args: TArgs) => TReturn>): void;
+//# sourceMappingURL=mock.d.ts.map

package/dist/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"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"}