@modainteract/moda-interact-shared 0.7.0 → 0.7.2

package/dist/testing/node.d.ts

@@ -0,0 +1,127 @@
+declare const DEFAULT_POSTGRES_IMAGE = "postgres:17.6-alpine";
+declare const DEFAULT_REDIS_IMAGE = "redis:7.4.2-alpine";
+declare const DEFAULT_HOST = "127.0.0.1";
+declare const DEFAULT_POSTGRES_STARTUP_TIMEOUT_MS = 30000;
+declare const DEFAULT_REDIS_STARTUP_TIMEOUT_MS = 15000;
+declare const DEFAULT_POLL_INTERVAL_MS = 200;
+declare const DEFAULT_COMMAND_TIMEOUT_MS = 120000;
+declare const DEFAULT_DOCKER_COMMAND_TIMEOUT_MS = 30000;
+type CommandResult = {
+    stdout: string;
+    stderr: string;
+};
+type CommandOptions = {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    timeout?: number;
+    killSignal?: NodeJS.Signals;
+};
+type CommandRunner = (command: string, args: readonly string[], options?: CommandOptions) => Promise<CommandResult>;
+type DockerRunner = (args: readonly string[], options?: CommandOptions) => Promise<CommandResult>;
+type DisposableEnvironment = {
+    DATABASE_URL: string;
+    TEST_DATABASE_URL: string;
+    REDIS_URL: string;
+    TEST_REDIS_URL: string;
+};
+type PostgresConnectionDetails = {
+    host: string;
+    port: number;
+    database: string;
+    user: string;
+    password: string;
+    databaseUrl: string;
+    containerName: string;
+};
+type RedisConnectionDetails = {
+    host: string;
+    port: number;
+    url: string;
+    containerName: string;
+};
+type EphemeralPostgresOptions = {
+    image?: string;
+    host?: string;
+    database?: string;
+    user?: string;
+    password?: string;
+    containerName?: string;
+    startupTimeoutMs?: number;
+    pollIntervalMs?: number;
+    dockerBinary?: string;
+    runDocker?: DockerRunner;
+};
+type EphemeralRedisOptions = {
+    image?: string;
+    host?: string;
+    containerName?: string;
+    startupTimeoutMs?: number;
+    pollIntervalMs?: number;
+    dockerBinary?: string;
+    runDocker?: DockerRunner;
+};
+type MigrationDeployOptions = {
+    databaseUrl: string;
+    prismaSchemaPath: string;
+    cwd?: string;
+    prismaBinary?: string;
+    runCommand?: CommandRunner;
+};
+type DisposableIntegrationInfrastructureOptions = {
+    prismaSchemaPath: string;
+    cwd?: string;
+    prismaBinary?: string;
+    postgres?: EphemeralPostgresOptions;
+    redis?: EphemeralRedisOptions;
+    runCommand?: CommandRunner;
+    deployMigrations?: (options: MigrationDeployOptions) => Promise<void>;
+};
+type DisposableIntegrationInfrastructure = {
+    postgres: PostgresConnectionDetails;
+    redis: RedisConnectionDetails;
+    databaseUrl: string;
+    redisUrl: string;
+    environment: DisposableEnvironment;
+};
+type DisposableIntegrationCallback<T> = (infrastructure: DisposableIntegrationInfrastructure) => Promise<T> | T;
+declare function createCommandRunner(binary?: string): CommandRunner;
+declare function createDockerRunner(dockerBinary?: string): DockerRunner;
+declare class EphemeralPostgres {
+    private readonly image;
+    private readonly host;
+    private readonly database;
+    private readonly user;
+    private readonly password;
+    private readonly containerName;
+    private readonly startupTimeoutMs;
+    private readonly pollIntervalMs;
+    private readonly runDocker;
+    private port;
+    private started;
+    constructor(options?: EphemeralPostgresOptions);
+    get databaseUrl(): string;
+    get connectionDetails(): PostgresConnectionDetails;
+    start(): Promise<PostgresConnectionDetails>;
+    waitForReady(): Promise<void>;
+    cleanup(): Promise<void>;
+}
+declare class EphemeralRedis {
+    private readonly image;
+    private readonly host;
+    private readonly containerName;
+    private readonly startupTimeoutMs;
+    private readonly pollIntervalMs;
+    private readonly runDocker;
+    private port;
+    private started;
+    constructor(options?: EphemeralRedisOptions);
+    get url(): string;
+    get connectionDetails(): RedisConnectionDetails;
+    start(): Promise<RedisConnectionDetails>;
+    waitForReady(): Promise<void>;
+    cleanup(): Promise<void>;
+}
+declare function deployPrismaMigrations(options: MigrationDeployOptions): Promise<void>;
+declare function withDisposableIntegrationInfrastructure<T>(options: DisposableIntegrationInfrastructureOptions, callback: DisposableIntegrationCallback<T>): Promise<T>;
+
+export { type CommandOptions, type CommandResult, type CommandRunner, DEFAULT_COMMAND_TIMEOUT_MS, DEFAULT_DOCKER_COMMAND_TIMEOUT_MS, DEFAULT_HOST, DEFAULT_POLL_INTERVAL_MS, DEFAULT_POSTGRES_IMAGE, DEFAULT_POSTGRES_STARTUP_TIMEOUT_MS, DEFAULT_REDIS_IMAGE, DEFAULT_REDIS_STARTUP_TIMEOUT_MS, type DisposableEnvironment, type DisposableIntegrationCallback, type DisposableIntegrationInfrastructure, type DisposableIntegrationInfrastructureOptions, type DockerRunner, EphemeralPostgres, type EphemeralPostgresOptions, EphemeralRedis, type EphemeralRedisOptions, type MigrationDeployOptions, type PostgresConnectionDetails, type RedisConnectionDetails, createCommandRunner, createDockerRunner, deployPrismaMigrations, withDisposableIntegrationInfrastructure };

package/dist/testing/node.js

@@ -0,0 +1,296 @@
+// src/testing/node.ts
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { randomUUID } from "crypto";
+var execFileAsync = promisify(execFile);
+var DEFAULT_POSTGRES_IMAGE = "postgres:17.6-alpine";
+var DEFAULT_REDIS_IMAGE = "redis:7.4.2-alpine";
+var DEFAULT_HOST = "127.0.0.1";
+var DEFAULT_POSTGRES_STARTUP_TIMEOUT_MS = 3e4;
+var DEFAULT_REDIS_STARTUP_TIMEOUT_MS = 15e3;
+var DEFAULT_POLL_INTERVAL_MS = 200;
+var DEFAULT_COMMAND_TIMEOUT_MS = 12e4;
+var DEFAULT_DOCKER_COMMAND_TIMEOUT_MS = 3e4;
+function createCommandRunner(binary = "") {
+  return async (command, args, options = {}) => {
+    const executable = binary || command;
+    const commandArgs = binary ? [command, ...args] : args;
+    const result = await execFileAsync(executable, commandArgs, {
+      encoding: "utf8",
+      maxBuffer: 1024 * 1024,
+      timeout: DEFAULT_COMMAND_TIMEOUT_MS,
+      ...options
+    });
+    return {
+      stdout: result.stdout.trim(),
+      stderr: result.stderr.trim()
+    };
+  };
+}
+function createDockerRunner(dockerBinary = "docker") {
+  const runCommand = createCommandRunner();
+  return (args, options = {}) => runCommand(dockerBinary, args, {
+    ...options,
+    timeout: options.timeout ?? DEFAULT_DOCKER_COMMAND_TIMEOUT_MS
+  });
+}
+function parseMappedPort(output, serviceName) {
+  const match = output.match(/:(\d+)\s*$/m);
+  if (!match) {
+    throw new Error(`Docker did not return a mapped ${serviceName} port: ${output}`);
+  }
+  return Number(match[1]);
+}
+function sleep(milliseconds) {
+  return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+function createSuffix() {
+  return randomUUID().replaceAll("-", "");
+}
+function requireStarted(value, serviceName) {
+  if (value === null) {
+    throw new Error(`Ephemeral ${serviceName} has not been started`);
+  }
+  return value;
+}
+var EphemeralPostgres = class {
+  image;
+  host;
+  database;
+  user;
+  password;
+  containerName;
+  startupTimeoutMs;
+  pollIntervalMs;
+  runDocker;
+  port = null;
+  started = false;
+  constructor(options = {}) {
+    const suffix = createSuffix();
+    this.image = options.image ?? DEFAULT_POSTGRES_IMAGE;
+    this.host = options.host ?? DEFAULT_HOST;
+    this.database = options.database ?? `moda_test_${suffix.slice(0, 12)}`;
+    this.user = options.user ?? `moda_test_${suffix.slice(0, 12)}`;
+    this.password = options.password ?? `test_${suffix}`;
+    this.containerName = options.containerName ?? `moda-test-postgres-${suffix}`;
+    this.startupTimeoutMs = options.startupTimeoutMs ?? DEFAULT_POSTGRES_STARTUP_TIMEOUT_MS;
+    this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    this.runDocker = options.runDocker ?? createDockerRunner(options.dockerBinary);
+  }
+  get databaseUrl() {
+    const port = requireStarted(this.port, "PostgreSQL");
+    return `postgresql://${this.user}:${this.password}@${this.host}:${port}/${this.database}`;
+  }
+  get connectionDetails() {
+    return {
+      host: this.host,
+      port: requireStarted(this.port, "PostgreSQL"),
+      database: this.database,
+      user: this.user,
+      password: this.password,
+      databaseUrl: this.databaseUrl,
+      containerName: this.containerName
+    };
+  }
+  async start() {
+    if (this.started) return this.connectionDetails;
+    try {
+      await this.runDocker([
+        "run",
+        "--detach",
+        "--name",
+        this.containerName,
+        "--env",
+        `POSTGRES_DB=${this.database}`,
+        "--env",
+        `POSTGRES_USER=${this.user}`,
+        "--env",
+        `POSTGRES_PASSWORD=${this.password}`,
+        "--publish",
+        "0:5432",
+        this.image
+      ]);
+      const portResult = await this.runDocker(["port", this.containerName, "5432/tcp"]);
+      this.port = parseMappedPort(portResult.stdout, "PostgreSQL");
+      await this.waitForReady();
+      this.started = true;
+      return this.connectionDetails;
+    } catch (error) {
+      await this.cleanup();
+      throw new Error(
+        `Unable to start ephemeral PostgreSQL (${this.image}): ${errorMessage(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async waitForReady() {
+    const deadline = Date.now() + this.startupTimeoutMs;
+    let lastError;
+    while (Date.now() < deadline) {
+      try {
+        const result = await this.runDocker([
+          "exec",
+          this.containerName,
+          "pg_isready",
+          "--username",
+          this.user,
+          "--dbname",
+          this.database
+        ]);
+        if (/accepting connections/i.test(result.stdout)) return;
+        lastError = new Error(`Unexpected PostgreSQL readiness response: ${result.stdout}`);
+      } catch (error) {
+        lastError = error;
+      }
+      await sleep(Math.min(this.pollIntervalMs, Math.max(0, deadline - Date.now())));
+    }
+    throw new Error(
+      `PostgreSQL readiness timed out after ${this.startupTimeoutMs}ms${lastError ? `: ${errorMessage(lastError)}` : ""}`
+    );
+  }
+  async cleanup() {
+    this.port = null;
+    this.started = false;
+    await this.runDocker(["rm", "--force", "--volumes", this.containerName]).catch(() => void 0);
+  }
+};
+var EphemeralRedis = class {
+  image;
+  host;
+  containerName;
+  startupTimeoutMs;
+  pollIntervalMs;
+  runDocker;
+  port = null;
+  started = false;
+  constructor(options = {}) {
+    const suffix = createSuffix();
+    this.image = options.image ?? DEFAULT_REDIS_IMAGE;
+    this.host = options.host ?? DEFAULT_HOST;
+    this.containerName = options.containerName ?? `moda-test-redis-${suffix}`;
+    this.startupTimeoutMs = options.startupTimeoutMs ?? DEFAULT_REDIS_STARTUP_TIMEOUT_MS;
+    this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    this.runDocker = options.runDocker ?? createDockerRunner(options.dockerBinary);
+  }
+  get url() {
+    const port = requireStarted(this.port, "Redis");
+    return `redis://${this.host}:${port}`;
+  }
+  get connectionDetails() {
+    return {
+      host: this.host,
+      port: requireStarted(this.port, "Redis"),
+      url: this.url,
+      containerName: this.containerName
+    };
+  }
+  async start() {
+    if (this.started) return this.connectionDetails;
+    try {
+      await this.runDocker([
+        "run",
+        "--detach",
+        "--name",
+        this.containerName,
+        "--publish",
+        "0:6379",
+        this.image
+      ]);
+      const portResult = await this.runDocker(["port", this.containerName, "6379/tcp"]);
+      this.port = parseMappedPort(portResult.stdout, "Redis");
+      await this.waitForReady();
+      this.started = true;
+      return this.connectionDetails;
+    } catch (error) {
+      await this.cleanup();
+      throw new Error(
+        `Unable to start ephemeral Redis (${this.image}): ${errorMessage(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async waitForReady() {
+    const deadline = Date.now() + this.startupTimeoutMs;
+    let lastError;
+    while (Date.now() < deadline) {
+      try {
+        const result = await this.runDocker(["exec", this.containerName, "redis-cli", "ping"]);
+        if (result.stdout === "PONG") return;
+        lastError = new Error(`Unexpected Redis readiness response: ${result.stdout}`);
+      } catch (error) {
+        lastError = error;
+      }
+      await sleep(Math.min(this.pollIntervalMs, Math.max(0, deadline - Date.now())));
+    }
+    throw new Error(
+      `Redis readiness timed out after ${this.startupTimeoutMs}ms${lastError ? `: ${errorMessage(lastError)}` : ""}`
+    );
+  }
+  async cleanup() {
+    this.port = null;
+    this.started = false;
+    await this.runDocker(["rm", "--force", "--volumes", this.containerName]).catch(() => void 0);
+  }
+};
+async function deployPrismaMigrations(options) {
+  const runCommand = options.runCommand ?? createCommandRunner();
+  await runCommand(
+    options.prismaBinary ?? "prisma",
+    ["migrate", "deploy", "--schema", options.prismaSchemaPath],
+    {
+      cwd: options.cwd,
+      env: { ...process.env, DATABASE_URL: options.databaseUrl }
+    }
+  );
+}
+async function withDisposableIntegrationInfrastructure(options, callback) {
+  const postgres = new EphemeralPostgres(options.postgres);
+  const redis = new EphemeralRedis(options.redis);
+  try {
+    const postgresDetails = await postgres.start();
+    const redisDetails = await redis.start();
+    const environment = {
+      DATABASE_URL: postgresDetails.databaseUrl,
+      TEST_DATABASE_URL: postgresDetails.databaseUrl,
+      REDIS_URL: redisDetails.url,
+      TEST_REDIS_URL: redisDetails.url
+    };
+    const deployMigrations = options.deployMigrations ?? deployPrismaMigrations;
+    await deployMigrations({
+      databaseUrl: postgresDetails.databaseUrl,
+      prismaSchemaPath: options.prismaSchemaPath,
+      cwd: options.cwd,
+      prismaBinary: options.prismaBinary,
+      runCommand: options.runCommand
+    });
+    return await callback({
+      postgres: postgresDetails,
+      redis: redisDetails,
+      databaseUrl: postgresDetails.databaseUrl,
+      redisUrl: redisDetails.url,
+      environment
+    });
+  } finally {
+    await Promise.all([postgres.cleanup(), redis.cleanup()]);
+  }
+}
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+export {
+  DEFAULT_COMMAND_TIMEOUT_MS,
+  DEFAULT_DOCKER_COMMAND_TIMEOUT_MS,
+  DEFAULT_HOST,
+  DEFAULT_POLL_INTERVAL_MS,
+  DEFAULT_POSTGRES_IMAGE,
+  DEFAULT_POSTGRES_STARTUP_TIMEOUT_MS,
+  DEFAULT_REDIS_IMAGE,
+  DEFAULT_REDIS_STARTUP_TIMEOUT_MS,
+  EphemeralPostgres,
+  EphemeralRedis,
+  createCommandRunner,
+  createDockerRunner,
+  deployPrismaMigrations,
+  withDisposableIntegrationInfrastructure
+};
+//# sourceMappingURL=node.js.map

package/dist/testing/node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/node.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport { randomUUID } from \"node:crypto\";\n\nconst execFileAsync = promisify(execFile);\n\nexport const DEFAULT_POSTGRES_IMAGE = \"postgres:17.6-alpine\";\nexport const DEFAULT_REDIS_IMAGE = \"redis:7.4.2-alpine\";\nexport const DEFAULT_HOST = \"127.0.0.1\";\nexport const DEFAULT_POSTGRES_STARTUP_TIMEOUT_MS = 30_000;\nexport const DEFAULT_REDIS_STARTUP_TIMEOUT_MS = 15_000;\nexport const DEFAULT_POLL_INTERVAL_MS = 200;\nexport const DEFAULT_COMMAND_TIMEOUT_MS = 120_000;\nexport const DEFAULT_DOCKER_COMMAND_TIMEOUT_MS = 30_000;\n\nexport type CommandResult = {\n  stdout: string;\n  stderr: string;\n};\n\nexport type CommandOptions = {\n  cwd?: string;\n  env?: NodeJS.ProcessEnv;\n  timeout?: number;\n  killSignal?: NodeJS.Signals;\n};\n\nexport type CommandRunner = (\n  command: string,\n  args: readonly string[],\n  options?: CommandOptions,\n) => Promise<CommandResult>;\n\nexport type DockerRunner = (\n  args: readonly string[],\n  options?: CommandOptions,\n) => Promise<CommandResult>;\n\nexport type DisposableEnvironment = {\n  DATABASE_URL: string;\n  TEST_DATABASE_URL: string;\n  REDIS_URL: string;\n  TEST_REDIS_URL: string;\n};\n\nexport type PostgresConnectionDetails = {\n  host: string;\n  port: number;\n  database: string;\n  user: string;\n  password: string;\n  databaseUrl: string;\n  containerName: string;\n};\n\nexport type RedisConnectionDetails = {\n  host: string;\n  port: number;\n  url: string;\n  containerName: string;\n};\n\nexport type EphemeralPostgresOptions = {\n  image?: string;\n  host?: string;\n  database?: string;\n  user?: string;\n  password?: string;\n  containerName?: string;\n  startupTimeoutMs?: number;\n  pollIntervalMs?: number;\n  dockerBinary?: string;\n  runDocker?: DockerRunner;\n};\n\nexport type EphemeralRedisOptions = {\n  image?: string;\n  host?: string;\n  containerName?: string;\n  startupTimeoutMs?: number;\n  pollIntervalMs?: number;\n  dockerBinary?: string;\n  runDocker?: DockerRunner;\n};\n\nexport type MigrationDeployOptions = {\n  databaseUrl: string;\n  prismaSchemaPath: string;\n  cwd?: string;\n  prismaBinary?: string;\n  runCommand?: CommandRunner;\n};\n\nexport type DisposableIntegrationInfrastructureOptions = {\n  prismaSchemaPath: string;\n  cwd?: string;\n  prismaBinary?: string;\n  postgres?: EphemeralPostgresOptions;\n  redis?: EphemeralRedisOptions;\n  runCommand?: CommandRunner;\n  deployMigrations?: (options: MigrationDeployOptions) => Promise<void>;\n};\n\nexport type DisposableIntegrationInfrastructure = {\n  postgres: PostgresConnectionDetails;\n  redis: RedisConnectionDetails;\n  databaseUrl: string;\n  redisUrl: string;\n  environment: DisposableEnvironment;\n};\n\nexport type DisposableIntegrationCallback<T> = (\n  infrastructure: DisposableIntegrationInfrastructure,\n) => Promise<T> | T;\n\nexport function createCommandRunner(binary = \"\"): CommandRunner {\n  return async (command, args, options = {}) => {\n    const executable = binary || command;\n    const commandArgs = binary ? [command, ...args] : args;\n    const result = await execFileAsync(executable, commandArgs, {\n      encoding: \"utf8\",\n      maxBuffer: 1024 * 1024,\n      timeout: DEFAULT_COMMAND_TIMEOUT_MS,\n      ...options,\n    });\n    return {\n      stdout: result.stdout.trim(),\n      stderr: result.stderr.trim(),\n    };\n  };\n}\n\nexport function createDockerRunner(dockerBinary = \"docker\"): DockerRunner {\n  const runCommand = createCommandRunner();\n  return (args, options = {}) =>\n    runCommand(dockerBinary, args, {\n      ...options,\n      timeout: options.timeout ?? DEFAULT_DOCKER_COMMAND_TIMEOUT_MS,\n    });\n}\n\nfunction parseMappedPort(output: string, serviceName: string): number {\n  const match = output.match(/:(\\d+)\\s*$/m);\n  if (!match) {\n    throw new Error(`Docker did not return a mapped ${serviceName} port: ${output}`);\n  }\n  return Number(match[1]);\n}\n\nfunction sleep(milliseconds: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, milliseconds));\n}\n\nfunction createSuffix(): string {\n  return randomUUID().replaceAll(\"-\", \"\");\n}\n\nfunction requireStarted<T>(value: T | null, serviceName: string): T {\n  if (value === null) {\n    throw new Error(`Ephemeral ${serviceName} has not been started`);\n  }\n  return value;\n}\n\nexport class EphemeralPostgres {\n  private readonly image: string;\n  private readonly host: string;\n  private readonly database: string;\n  private readonly user: string;\n  private readonly password: string;\n  private readonly containerName: string;\n  private readonly startupTimeoutMs: number;\n  private readonly pollIntervalMs: number;\n  private readonly runDocker: DockerRunner;\n  private port: number | null = null;\n  private started = false;\n\n  constructor(options: EphemeralPostgresOptions = {}) {\n    const suffix = createSuffix();\n    this.image = options.image ?? DEFAULT_POSTGRES_IMAGE;\n    this.host = options.host ?? DEFAULT_HOST;\n    this.database = options.database ?? `moda_test_${suffix.slice(0, 12)}`;\n    this.user = options.user ?? `moda_test_${suffix.slice(0, 12)}`;\n    this.password = options.password ?? `test_${suffix}`;\n    this.containerName = options.containerName ?? `moda-test-postgres-${suffix}`;\n    this.startupTimeoutMs = options.startupTimeoutMs ?? DEFAULT_POSTGRES_STARTUP_TIMEOUT_MS;\n    this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;\n    this.runDocker = options.runDocker ?? createDockerRunner(options.dockerBinary);\n  }\n\n  get databaseUrl(): string {\n    const port = requireStarted(this.port, \"PostgreSQL\");\n    return `postgresql://${this.user}:${this.password}@${this.host}:${port}/${this.database}`;\n  }\n\n  get connectionDetails(): PostgresConnectionDetails {\n    return {\n      host: this.host,\n      port: requireStarted(this.port, \"PostgreSQL\"),\n      database: this.database,\n      user: this.user,\n      password: this.password,\n      databaseUrl: this.databaseUrl,\n      containerName: this.containerName,\n    };\n  }\n\n  async start(): Promise<PostgresConnectionDetails> {\n    if (this.started) return this.connectionDetails;\n\n    try {\n      await this.runDocker([\n        \"run\",\n        \"--detach\",\n        \"--name\",\n        this.containerName,\n        \"--env\",\n        `POSTGRES_DB=${this.database}`,\n        \"--env\",\n        `POSTGRES_USER=${this.user}`,\n        \"--env\",\n        `POSTGRES_PASSWORD=${this.password}`,\n        \"--publish\",\n        \"0:5432\",\n        this.image,\n      ]);\n      const portResult = await this.runDocker([\"port\", this.containerName, \"5432/tcp\"]);\n      this.port = parseMappedPort(portResult.stdout, \"PostgreSQL\");\n      await this.waitForReady();\n      this.started = true;\n      return this.connectionDetails;\n    } catch (error) {\n      await this.cleanup();\n      throw new Error(\n        `Unable to start ephemeral PostgreSQL (${this.image}): ${errorMessage(error)}`,\n        { cause: error },\n      );\n    }\n  }\n\n  async waitForReady(): Promise<void> {\n    const deadline = Date.now() + this.startupTimeoutMs;\n    let lastError: unknown;\n\n    while (Date.now() < deadline) {\n      try {\n        const result = await this.runDocker([\n          \"exec\",\n          this.containerName,\n          \"pg_isready\",\n          \"--username\",\n          this.user,\n          \"--dbname\",\n          this.database,\n        ]);\n        if (/accepting connections/i.test(result.stdout)) return;\n        lastError = new Error(`Unexpected PostgreSQL readiness response: ${result.stdout}`);\n      } catch (error) {\n        lastError = error;\n      }\n      await sleep(Math.min(this.pollIntervalMs, Math.max(0, deadline - Date.now())));\n    }\n\n    throw new Error(\n      `PostgreSQL readiness timed out after ${this.startupTimeoutMs}ms${lastError ? `: ${errorMessage(lastError)}` : \"\"}`,\n    );\n  }\n\n  async cleanup(): Promise<void> {\n    this.port = null;\n    this.started = false;\n    await this.runDocker([\"rm\", \"--force\", \"--volumes\", this.containerName]).catch(() => undefined);\n  }\n}\n\nexport class EphemeralRedis {\n  private readonly image: string;\n  private readonly host: string;\n  private readonly containerName: string;\n  private readonly startupTimeoutMs: number;\n  private readonly pollIntervalMs: number;\n  private readonly runDocker: DockerRunner;\n  private port: number | null = null;\n  private started = false;\n\n  constructor(options: EphemeralRedisOptions = {}) {\n    const suffix = createSuffix();\n    this.image = options.image ?? DEFAULT_REDIS_IMAGE;\n    this.host = options.host ?? DEFAULT_HOST;\n    this.containerName = options.containerName ?? `moda-test-redis-${suffix}`;\n    this.startupTimeoutMs = options.startupTimeoutMs ?? DEFAULT_REDIS_STARTUP_TIMEOUT_MS;\n    this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;\n    this.runDocker = options.runDocker ?? createDockerRunner(options.dockerBinary);\n  }\n\n  get url(): string {\n    const port = requireStarted(this.port, \"Redis\");\n    return `redis://${this.host}:${port}`;\n  }\n\n  get connectionDetails(): RedisConnectionDetails {\n    return {\n      host: this.host,\n      port: requireStarted(this.port, \"Redis\"),\n      url: this.url,\n      containerName: this.containerName,\n    };\n  }\n\n  async start(): Promise<RedisConnectionDetails> {\n    if (this.started) return this.connectionDetails;\n\n    try {\n      await this.runDocker([\n        \"run\",\n        \"--detach\",\n        \"--name\",\n        this.containerName,\n        \"--publish\",\n        \"0:6379\",\n        this.image,\n      ]);\n      const portResult = await this.runDocker([\"port\", this.containerName, \"6379/tcp\"]);\n      this.port = parseMappedPort(portResult.stdout, \"Redis\");\n      await this.waitForReady();\n      this.started = true;\n      return this.connectionDetails;\n    } catch (error) {\n      await this.cleanup();\n      throw new Error(\n        `Unable to start ephemeral Redis (${this.image}): ${errorMessage(error)}`,\n        { cause: error },\n      );\n    }\n  }\n\n  async waitForReady(): Promise<void> {\n    const deadline = Date.now() + this.startupTimeoutMs;\n    let lastError: unknown;\n\n    while (Date.now() < deadline) {\n      try {\n        const result = await this.runDocker([\"exec\", this.containerName, \"redis-cli\", \"ping\"]);\n        if (result.stdout === \"PONG\") return;\n        lastError = new Error(`Unexpected Redis readiness response: ${result.stdout}`);\n      } catch (error) {\n        lastError = error;\n      }\n      await sleep(Math.min(this.pollIntervalMs, Math.max(0, deadline - Date.now())));\n    }\n\n    throw new Error(\n      `Redis readiness timed out after ${this.startupTimeoutMs}ms${lastError ? `: ${errorMessage(lastError)}` : \"\"}`,\n    );\n  }\n\n  async cleanup(): Promise<void> {\n    this.port = null;\n    this.started = false;\n    await this.runDocker([\"rm\", \"--force\", \"--volumes\", this.containerName]).catch(() => undefined);\n  }\n}\n\nexport async function deployPrismaMigrations(options: MigrationDeployOptions): Promise<void> {\n  const runCommand = options.runCommand ?? createCommandRunner();\n  await runCommand(\n    options.prismaBinary ?? \"prisma\",\n    [\"migrate\", \"deploy\", \"--schema\", options.prismaSchemaPath],\n    {\n      cwd: options.cwd,\n      env: { ...process.env, DATABASE_URL: options.databaseUrl },\n    },\n  );\n}\n\nexport async function withDisposableIntegrationInfrastructure<T>(\n  options: DisposableIntegrationInfrastructureOptions,\n  callback: DisposableIntegrationCallback<T>,\n): Promise<T> {\n  const postgres = new EphemeralPostgres(options.postgres);\n  const redis = new EphemeralRedis(options.redis);\n\n  try {\n    const postgresDetails = await postgres.start();\n    const redisDetails = await redis.start();\n    const environment: DisposableEnvironment = {\n      DATABASE_URL: postgresDetails.databaseUrl,\n      TEST_DATABASE_URL: postgresDetails.databaseUrl,\n      REDIS_URL: redisDetails.url,\n      TEST_REDIS_URL: redisDetails.url,\n    };\n    const deployMigrations = options.deployMigrations ?? deployPrismaMigrations;\n    await deployMigrations({\n      databaseUrl: postgresDetails.databaseUrl,\n      prismaSchemaPath: options.prismaSchemaPath,\n      cwd: options.cwd,\n      prismaBinary: options.prismaBinary,\n      runCommand: options.runCommand,\n    });\n    return await callback({\n      postgres: postgresDetails,\n      redis: redisDetails,\n      databaseUrl: postgresDetails.databaseUrl,\n      redisUrl: redisDetails.url,\n      environment,\n    });\n  } finally {\n    await Promise.all([postgres.cleanup(), redis.cleanup()]);\n  }\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modainteract/moda-interact-shared",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -21,8 +21,12 @@
       "import": "./dist/merchant-communications.js"
     },
     "./merchant-communications/node": {
-      "types": "./dist/merchant-communications.node.d.ts",
-      "import": "./dist/merchant-communications.node.js"
+      "types": "./dist/merchant-communications/node.d.ts",
+      "import": "./dist/merchant-communications/node.js"
+    },
+    "./testing/node": {
+      "types": "./dist/testing/node.d.ts",
+      "import": "./dist/testing/node.js"
     },
     "./shopify": {
       "types": "./dist/shopify/index.d.ts",
@@ -65,6 +69,9 @@
     "typecheck": "tsc --noEmit",
     "test": "tsx --test \"src/**/*.test.ts\"",
     "validate:internationalization-entrypoint": "npm run build && node scripts/validate-internationalization-entrypoint.mjs",
+    "validate:merchant-communications-node": "npm run build && node scripts/validate-merchant-communications-node.mjs",
+    "validate:testing-node": "npm run build && node scripts/validate-testing-node.mjs",
+    "validate:testing-node-live": "npm run build && node scripts/validate-testing-node-live.mjs",
     "prepack": "npm run build"
   },
   "dependencies": {