@hot-updater/test-utils 1.0.0-rc.15

package/dist/node.d.cts

@@ -0,0 +1,107 @@
+import { ChildProcessByStdio } from "node:child_process";
+import { Readable } from "node:stream";
+import { ArtifactInfo } from "@hot-updater/core";
+import { BundleRow, StoragePlugin } from "@hot-updater/plugin-core";
+import { execa } from "execa";
+//#region src/mockReactNativeProjectRoot.d.ts
+interface MockedReactNativeProjectRoot {
+  rootDir: string;
+}
+type Example = "rn-77";
+declare const mockReactNativeProjectRoot: ({ example }: {
+  example: Example;
+}) => Promise<MockedReactNativeProjectRoot>;
+//#endregion
+//#region src/runtimeProcess.d.ts
+type RuntimeChild = ChildProcessByStdio<null, Readable, Readable>;
+interface RuntimeLogs {
+  stdout: string[];
+  stderr: string[];
+}
+interface SpawnRuntimeOptions {
+  command: string;
+  args: string[];
+  cwd: string;
+  env?: Record<string, string | undefined>;
+}
+declare const runCheckedCommand: ({ command, args, cwd, env }: SpawnRuntimeOptions) => void;
+declare const hasCommand: (command: string, args: string[]) => boolean;
+declare const hasDockerDaemon: () => boolean;
+declare const hasDockerCompose: () => boolean;
+declare const assertCommandAvailable: (command: string, args: string[], message?: string) => void;
+declare const assertDockerDaemonAvailable: (message?: string) => void;
+declare const assertDockerComposeAvailable: (message?: string) => void;
+declare const assertEnvFlagEnabled: (name: string, message?: string) => void;
+declare const findOpenPort: () => Promise<number>;
+declare const spawnRuntime: ({ command, args, cwd, env }: SpawnRuntimeOptions) => {
+  child: RuntimeChild;
+  logs: RuntimeLogs;
+};
+declare const waitForHttpOk: ({ url, child, logs, timeoutMs }: {
+  url: string;
+  child: RuntimeChild;
+  logs: RuntimeLogs;
+  timeoutMs?: number;
+}) => Promise<void>;
+declare const stopRuntime: (child: RuntimeChild) => Promise<void>;
+declare const formatRuntimeLogs: (logs: RuntimeLogs) => string;
+//#endregion
+//#region src/httpTestClient.d.ts
+type HttpTestRequestInit = NonNullable<ConstructorParameters<typeof Request>[1]>;
+type HttpTestRequest = (path: string, init?: HttpTestRequestInit) => Promise<Response>;
+interface HttpTestClient {
+  readonly client: HttpTestRequest;
+  readonly admin: HttpTestRequest;
+}
+interface HttpTestServer extends HttpTestClient {
+  readonly close: () => Promise<void>;
+}
+type HttpTestHandlers = Record<"client" | "admin", (request: Request) => Promise<Response>>;
+//#endregion
+//#region src/httpTestServer.d.ts
+/** Serve Web handlers over loopback TCP; contract tests use real fetch requests. */
+declare function startHttpTestServer(handlers: HttpTestHandlers): Promise<HttpTestServer>;
+//#endregion
+//#region src/releaseCatalogHttpFixtures.d.ts
+declare const releaseCatalogDownloadUrl: (uri: string) => string;
+declare const RELEASE_CATALOG_MANIFEST_URIS: {
+  small: string;
+  large: string;
+};
+declare const RELEASE_CATALOG_DOWNLOAD_HASH: string;
+declare const releaseCatalogArtifact: (bundle: BundleRow) => ArtifactInfo;
+/** Install these storage objects in the test server, independently of its DB. */
+declare const RELEASE_CATALOG_STORAGE_FIXTURES: Readonly<Record<string, string>>;
+/** Storage boundary shared by provider and separately spawned server tests. */
+declare const createReleaseCatalogTestStorage: () => StoragePlugin;
+//#endregion
+//#region src/setupHandlerIntegrationTestSuite.d.ts
+declare const TEST_ADMIN_AUTH_TOKEN = "hot-updater-test-token";
+/**
+ * Kills any process using the specified port
+ */
+declare function killPort(port: number): Promise<void>;
+/**
+ * Helper to wait for server to be ready
+ */
+declare function waitForServer(url: string, maxAttempts?: number): Promise<void>;
+/**
+ * Creates test database path with timestamp isolation
+ */
+declare function createTestDbPath(projectRoot: string): string;
+/**
+ * Spawns a server process for testing
+ */
+declare function spawnServerProcess(options: {
+  serverCommand: string[];
+  port: number;
+  testDbPath: string;
+  projectRoot: string;
+  env?: Record<string, string>;
+}): ReturnType<typeof execa>;
+/**
+ * Cleans up server process and test database
+ */
+declare function cleanupServer(baseUrl: string, serverProcess: ReturnType<typeof execa> | null, testDbPath: string): Promise<void>;
+//#endregion
+export { MockedReactNativeProjectRoot, RELEASE_CATALOG_DOWNLOAD_HASH, RELEASE_CATALOG_MANIFEST_URIS, RELEASE_CATALOG_STORAGE_FIXTURES, RuntimeChild, RuntimeLogs, SpawnRuntimeOptions, TEST_ADMIN_AUTH_TOKEN, assertCommandAvailable, assertDockerComposeAvailable, assertDockerDaemonAvailable, assertEnvFlagEnabled, cleanupServer, createReleaseCatalogTestStorage, createTestDbPath, findOpenPort, formatRuntimeLogs, hasCommand, hasDockerCompose, hasDockerDaemon, killPort, mockReactNativeProjectRoot, releaseCatalogArtifact, releaseCatalogDownloadUrl, runCheckedCommand, spawnRuntime, spawnServerProcess, startHttpTestServer, stopRuntime, waitForHttpOk, waitForServer };

package/dist/node.d.mts

@@ -0,0 +1,107 @@
+import { ChildProcessByStdio } from "node:child_process";
+import { execa } from "execa";
+import { Readable } from "node:stream";
+import { ArtifactInfo } from "@hot-updater/core";
+import { BundleRow, StoragePlugin } from "@hot-updater/plugin-core";
+//#region src/mockReactNativeProjectRoot.d.ts
+interface MockedReactNativeProjectRoot {
+  rootDir: string;
+}
+type Example = "rn-77";
+declare const mockReactNativeProjectRoot: ({ example }: {
+  example: Example;
+}) => Promise<MockedReactNativeProjectRoot>;
+//#endregion
+//#region src/runtimeProcess.d.ts
+type RuntimeChild = ChildProcessByStdio<null, Readable, Readable>;
+interface RuntimeLogs {
+  stdout: string[];
+  stderr: string[];
+}
+interface SpawnRuntimeOptions {
+  command: string;
+  args: string[];
+  cwd: string;
+  env?: Record<string, string | undefined>;
+}
+declare const runCheckedCommand: ({ command, args, cwd, env }: SpawnRuntimeOptions) => void;
+declare const hasCommand: (command: string, args: string[]) => boolean;
+declare const hasDockerDaemon: () => boolean;
+declare const hasDockerCompose: () => boolean;
+declare const assertCommandAvailable: (command: string, args: string[], message?: string) => void;
+declare const assertDockerDaemonAvailable: (message?: string) => void;
+declare const assertDockerComposeAvailable: (message?: string) => void;
+declare const assertEnvFlagEnabled: (name: string, message?: string) => void;
+declare const findOpenPort: () => Promise<number>;
+declare const spawnRuntime: ({ command, args, cwd, env }: SpawnRuntimeOptions) => {
+  child: RuntimeChild;
+  logs: RuntimeLogs;
+};
+declare const waitForHttpOk: ({ url, child, logs, timeoutMs }: {
+  url: string;
+  child: RuntimeChild;
+  logs: RuntimeLogs;
+  timeoutMs?: number;
+}) => Promise<void>;
+declare const stopRuntime: (child: RuntimeChild) => Promise<void>;
+declare const formatRuntimeLogs: (logs: RuntimeLogs) => string;
+//#endregion
+//#region src/httpTestClient.d.ts
+type HttpTestRequestInit = NonNullable<ConstructorParameters<typeof Request>[1]>;
+type HttpTestRequest = (path: string, init?: HttpTestRequestInit) => Promise<Response>;
+interface HttpTestClient {
+  readonly client: HttpTestRequest;
+  readonly admin: HttpTestRequest;
+}
+interface HttpTestServer extends HttpTestClient {
+  readonly close: () => Promise<void>;
+}
+type HttpTestHandlers = Record<"client" | "admin", (request: Request) => Promise<Response>>;
+//#endregion
+//#region src/httpTestServer.d.ts
+/** Serve Web handlers over loopback TCP; contract tests use real fetch requests. */
+declare function startHttpTestServer(handlers: HttpTestHandlers): Promise<HttpTestServer>;
+//#endregion
+//#region src/releaseCatalogHttpFixtures.d.ts
+declare const releaseCatalogDownloadUrl: (uri: string) => string;
+declare const RELEASE_CATALOG_MANIFEST_URIS: {
+  small: string;
+  large: string;
+};
+declare const RELEASE_CATALOG_DOWNLOAD_HASH: string;
+declare const releaseCatalogArtifact: (bundle: BundleRow) => ArtifactInfo;
+/** Install these storage objects in the test server, independently of its DB. */
+declare const RELEASE_CATALOG_STORAGE_FIXTURES: Readonly<Record<string, string>>;
+/** Storage boundary shared by provider and separately spawned server tests. */
+declare const createReleaseCatalogTestStorage: () => StoragePlugin;
+//#endregion
+//#region src/setupHandlerIntegrationTestSuite.d.ts
+declare const TEST_ADMIN_AUTH_TOKEN = "hot-updater-test-token";
+/**
+ * Kills any process using the specified port
+ */
+declare function killPort(port: number): Promise<void>;
+/**
+ * Helper to wait for server to be ready
+ */
+declare function waitForServer(url: string, maxAttempts?: number): Promise<void>;
+/**
+ * Creates test database path with timestamp isolation
+ */
+declare function createTestDbPath(projectRoot: string): string;
+/**
+ * Spawns a server process for testing
+ */
+declare function spawnServerProcess(options: {
+  serverCommand: string[];
+  port: number;
+  testDbPath: string;
+  projectRoot: string;
+  env?: Record<string, string>;
+}): ReturnType<typeof execa>;
+/**
+ * Cleans up server process and test database
+ */
+declare function cleanupServer(baseUrl: string, serverProcess: ReturnType<typeof execa> | null, testDbPath: string): Promise<void>;
+//#endregion
+export { MockedReactNativeProjectRoot, RELEASE_CATALOG_DOWNLOAD_HASH, RELEASE_CATALOG_MANIFEST_URIS, RELEASE_CATALOG_STORAGE_FIXTURES, RuntimeChild, RuntimeLogs, SpawnRuntimeOptions, TEST_ADMIN_AUTH_TOKEN, assertCommandAvailable, assertDockerComposeAvailable, assertDockerDaemonAvailable, assertEnvFlagEnabled, cleanupServer, createReleaseCatalogTestStorage, createTestDbPath, findOpenPort, formatRuntimeLogs, hasCommand, hasDockerCompose, hasDockerDaemon, killPort, mockReactNativeProjectRoot, releaseCatalogArtifact, releaseCatalogDownloadUrl, runCheckedCommand, spawnRuntime, spawnServerProcess, startHttpTestServer, stopRuntime, waitForHttpOk, waitForServer };