@danceroutine/tango-testing 0.1.0 → 1.0.0

package/dist/integration/runtime/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Domain boundary barrel: centralizes runtime-oriented integration fixtures.
+ */
+export { aTangoConfig } from './aTangoConfig';
+export type { TestTangoConfigOptions } from './aTangoConfig';
+export { setupTestTangoRuntime } from './setupTestTangoRuntime';

package/dist/integration/runtime/setupTestTangoRuntime.d.ts

@@ -0,0 +1,6 @@
+import { type TangoRuntime } from '@danceroutine/tango-orm';
+import { type TestTangoConfigOptions } from './aTangoConfig';
+/**
+ * Reset and initialize the process-default Tango runtime for tests.
+ */
+export declare function setupTestTangoRuntime(options?: TestTangoConfigOptions): Promise<TangoRuntime>;

package/dist/integration/smoke/AppProcessHarness.d.ts

@@ -0,0 +1,83 @@
+import { spawn } from 'node:child_process';
+export interface AppProcessHarnessOptions {
+    command: string;
+    args?: string[];
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+    baseUrl: string;
+    readyPath?: string;
+    readyTimeoutMs?: number;
+    readyIntervalMs?: number;
+    stopTimeoutMs?: number;
+}
+type FetchLike = typeof fetch;
+type ProcessHarnessOutputStream = {
+    on(eventName: 'data', listener: (chunk: unknown) => void): unknown;
+};
+type ProcessHarnessChild = {
+    exitCode: number | null;
+    killed: boolean;
+    kill(signal?: NodeJS.Signals): boolean;
+    off(eventName: 'exit', listener: () => void): unknown;
+    once(eventName: 'exit', listener: () => void): unknown;
+    stdout?: ProcessHarnessOutputStream | null;
+    stderr?: ProcessHarnessOutputStream | null;
+};
+interface AppProcessHarnessDeps {
+    spawnProcess: (command: string, args?: readonly string[], options?: Parameters<typeof spawn>[2]) => ProcessHarnessChild;
+    fetchImpl: FetchLike;
+    sleep: (ms: number) => Promise<void>;
+}
+/**
+ * Lightweight process harness for end-to-end smoke tests that need a real app process.
+ */
+export declare class AppProcessHarness {
+    static readonly BRAND: "tango.testing.app_process_harness";
+    readonly __tangoBrand: typeof AppProcessHarness.BRAND;
+    private readonly child;
+    private readonly baseUrl;
+    private readonly readyUrl;
+    private readonly readyTimeoutMs;
+    private readonly readyIntervalMs;
+    private readonly stopTimeoutMs;
+    private readonly deps;
+    private stopped;
+    private stdoutBuffer;
+    private stderrBuffer;
+    private constructor();
+    /**
+     * Narrow an unknown value to the smoke-test harness that owns a child process.
+     */
+    static isAppProcessHarness(value: unknown): value is AppProcessHarness;
+    /**
+     * Spawn the target process and wait until its readiness endpoint responds successfully.
+     */
+    static start(options: AppProcessHarnessOptions, deps?: Partial<AppProcessHarnessDeps>): Promise<AppProcessHarness>;
+    /**
+     * Return the buffered stdout log for recent process output.
+     */
+    getStdoutLog(): string;
+    /**
+     * Return the buffered stderr log for recent process output.
+     */
+    getStderrLog(): string;
+    /**
+     * Return stdout and stderr in a single formatted string for debugging failures.
+     */
+    getCombinedLog(): string;
+    /**
+     * Issue an HTTP request against the managed application process.
+     */
+    request(path: string, init?: RequestInit): Promise<Response>;
+    /**
+     * Assert an HTTP response status and include process logs when it mismatches.
+     */
+    assertResponseStatus(response: Response, expectedStatus: number, label: string): Promise<void>;
+    /**
+     * Stop the managed process, escalating from SIGTERM to SIGKILL when necessary.
+     */
+    stop(): Promise<void>;
+    private waitForReady;
+    private waitForExit;
+}
+export {};

package/dist/integration/smoke/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Domain boundary barrel: centralizes this subdomain's public contract.
+ */
+export * from './AppProcessHarness';

package/dist/integration/strategies/PostgresHarnessStrategy.d.ts

@@ -1,10 +1,19 @@
 import { Dialect, type DialectTestCapabilities, type HarnessOptions, type HarnessStrategy, type IntegrationHarness } from '../domain';
+/**
+ * Harness strategy for PostgreSQL-backed integration tests.
+ */
 export declare class PostgresHarnessStrategy implements HarnessStrategy {
     static readonly BRAND: "tango.testing.postgres_harness_strategy";
     readonly __tangoBrand: typeof PostgresHarnessStrategy.BRAND;
     readonly dialect: Dialect;
     readonly capabilities: DialectTestCapabilities;
+    /**
+     * Narrow an unknown value to the PostgreSQL integration harness strategy.
+     */
     static isPostgresHarnessStrategy(value: unknown): value is PostgresHarnessStrategy;
     private static buildSchemaName;
+    /**
+     * Create a configured Postgres integration harness instance.
+     */
     create(options?: HarnessOptions): Promise<IntegrationHarness>;
 }

package/dist/integration/strategies/SqliteHarnessStrategy.d.ts

@@ -1,10 +1,19 @@
 import { Dialect, type DialectTestCapabilities, type HarnessOptions, type HarnessStrategy, type IntegrationHarness } from '../domain';
+/**
+ * Harness strategy for SQLite-backed integration tests.
+ */
 export declare class SqliteHarnessStrategy implements HarnessStrategy {
     static readonly BRAND: "tango.testing.sqlite_harness_strategy";
     readonly __tangoBrand: typeof SqliteHarnessStrategy.BRAND;
     readonly dialect: Dialect;
     readonly capabilities: DialectTestCapabilities;
+    /**
+     * Narrow an unknown value to the SQLite integration harness strategy.
+     */
     static isSqliteHarnessStrategy(value: unknown): value is SqliteHarnessStrategy;
     private static dropAllTables;
+    /**
+     * Create a configured SQLite integration harness instance.
+     */
     create(options?: HarnessOptions): Promise<IntegrationHarness>;
 }