@nicnocquee/dataqueue 1.19.0 → 1.19.1

package/cli.cjs

@@ -1,70 +1,3 @@
 #!/usr/bin/env node
 
-const { spawnSync } = require('child_process');
-const path = require('path');
-
-function printUsage() {
-  console.log(
-    'Usage: dataqueue-cli migrate [--envPath <path>] [-s <schema> | --schema <schema>]',
-  );
-  console.log('');
-  console.log('Options:');
-  console.log(
-    '  --envPath <path>   Path to a .env file to load environment variables (passed to node-pg-migrate)',
-  );
-  console.log(
-    '  -s, --schema <schema>  Set the schema to use (passed to node-pg-migrate)',
-  );
-  console.log('');
-  console.log('Notes:');
-  console.log(
-    '  - The PG_DATAQUEUE_DATABASE environment variable must be set to your Postgres connection string.',
-  );
-  process.exit(1);
-}
-
-const [, , command, ...restArgs] = process.argv;
-
-if (command === 'migrate') {
-  const migrationsDir = path.join(__dirname, 'migrations');
-
-  // Support for -s or --schema argument
-  let schemaArg = [];
-  const sIndex = restArgs.indexOf('-s');
-  const schemaIndex = restArgs.indexOf('--schema');
-  if (sIndex !== -1 && restArgs[sIndex + 1]) {
-    schemaArg = ['-s', restArgs[sIndex + 1], '--create-schema'];
-    restArgs.splice(sIndex, 2);
-  } else if (schemaIndex !== -1 && restArgs[schemaIndex + 1]) {
-    schemaArg = ['-s', restArgs[schemaIndex + 1], '--create-schema'];
-    restArgs.splice(schemaIndex, 2);
-  }
-
-  // Support for --envPath argument
-  let envPathArg = [];
-  const envPathIndex = restArgs.indexOf('--envPath');
-  if (envPathIndex !== -1 && restArgs[envPathIndex + 1]) {
-    envPathArg = ['--envPath', restArgs[envPathIndex + 1]];
-  }
-
-  const result = spawnSync(
-    'npx',
-    [
-      'node-pg-migrate',
-      'up',
-      '-t',
-      'dataqueuedev_migrations',
-      '-d',
-      'PG_DATAQUEUE_DATABASE',
-      '-m',
-      migrationsDir,
-      ...schemaArg,
-      ...envPathArg,
-      ...restArgs,
-    ],
-    { stdio: 'inherit' },
-  );
-  process.exit(result.status);
-} else {
-  printUsage();
-}
+require('./dist/src/cli.js').runCli(process.argv);

package/dist/cli.cjs

@@ -0,0 +1,78 @@
+'use strict';
+
+var child_process = require('child_process');
+var path = require('path');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var path__default = /*#__PURE__*/_interopDefault(path);
+
+// src/cli.ts
+function runCli(argv, {
+  log = console.log,
+  exit = (code) => process.exit(code),
+  spawnSyncImpl = child_process.spawnSync,
+  migrationsDir = path__default.default.join(__dirname, "../migrations")
+} = {}) {
+  const [, , command, ...restArgs] = argv;
+  function printUsage() {
+    log(
+      "Usage: dataqueue-cli migrate [--envPath <path>] [-s <schema> | --schema <schema>]"
+    );
+    log("");
+    log("Options:");
+    log(
+      "  --envPath <path>   Path to a .env file to load environment variables (passed to node-pg-migrate)"
+    );
+    log(
+      "  -s, --schema <schema>  Set the schema to use (passed to node-pg-migrate)"
+    );
+    log("");
+    log("Notes:");
+    log(
+      "  - The PG_DATAQUEUE_DATABASE environment variable must be set to your Postgres connection string."
+    );
+    exit(1);
+  }
+  if (command === "migrate") {
+    let schemaArg = [];
+    const sIndex = restArgs.indexOf("-s");
+    const schemaIndex = restArgs.indexOf("--schema");
+    if (sIndex !== -1 && restArgs[sIndex + 1]) {
+      schemaArg = ["-s", restArgs[sIndex + 1], "--create-schema"];
+      restArgs.splice(sIndex, 2);
+    } else if (schemaIndex !== -1 && restArgs[schemaIndex + 1]) {
+      schemaArg = ["-s", restArgs[schemaIndex + 1], "--create-schema"];
+      restArgs.splice(schemaIndex, 2);
+    }
+    let envPathArg = [];
+    const envPathIndex = restArgs.indexOf("--envPath");
+    if (envPathIndex !== -1 && restArgs[envPathIndex + 1]) {
+      envPathArg = ["--envPath", restArgs[envPathIndex + 1]];
+    }
+    const result = spawnSyncImpl(
+      "npx",
+      [
+        "node-pg-migrate",
+        "up",
+        "-t",
+        "dataqueuedev_migrations",
+        "-d",
+        "PG_DATAQUEUE_DATABASE",
+        "-m",
+        migrationsDir,
+        ...schemaArg,
+        ...envPathArg,
+        ...restArgs
+      ],
+      { stdio: "inherit" }
+    );
+    exit(result.status ?? 1);
+  } else {
+    printUsage();
+  }
+}
+
+exports.runCli = runCli;
+//# sourceMappingURL=cli.cjs.map
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"names":["spawnSync","path"],"mappings":";;;;;;;;;;AAYO,SAAS,OACd,IAAA,EACA;AAAA,EACE,MAAM,OAAA,CAAQ,GAAA;AAAA,EACd,IAAA,GAAO,CAAC,IAAA,KAAiB,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA,EAC1C,aAAA,GAAgBA,uBAAA;AAAA,EAChB,aAAA,GAAgBC,qBAAA,CAAK,IAAA,CAAK,SAAA,EAAW,eAAe;AACtD,CAAA,GAAa,EAAC,EACR;AACN,EAAA,MAAM,KAAK,OAAA,EAAS,GAAG,QAAQ,CAAA,GAAI,IAAA;AAEnC,EAAA,SAAS,UAAA,GAAa;AACpB,IAAA,GAAA;AAAA,MACE;AAAA,KACF;AACA,IAAA,GAAA,CAAI,EAAE,CAAA;AACN,IAAA,GAAA,CAAI,UAAU,CAAA;AACd,IAAA,GAAA;AAAA,MACE;AAAA,KACF;AACA,IAAA,GAAA;AAAA,MACE;AAAA,KACF;AACA,IAAA,GAAA,CAAI,EAAE,CAAA;AACN,IAAA,GAAA,CAAI,QAAQ,CAAA;AACZ,IAAA,GAAA;AAAA,MACE;AAAA,KACF;AACA,IAAA,IAAA,CAAK,CAAC,CAAA;AAAA;AAGR,EAAA,IAAI,YAAY,SAAA,EAAW;AAEzB,IAAA,IAAI,YAAsB,EAAC;AAC3B,IAAA,MAAM,MAAA,GAAS,QAAA,CAAS,OAAA,CAAQ,IAAI,CAAA;AACpC,IAAA,MAAM,WAAA,GAAc,QAAA,CAAS,OAAA,CAAQ,UAAU,CAAA;AAC/C,IAAA,IAAI,MAAA,KAAW,EAAA,IAAM,QAAA,CAAS,MAAA,GAAS,CAAC,CAAA,EAAG;AACzC,MAAA,SAAA,GAAY,CAAC,IAAA,EAAM,QAAA,CAAS,MAAA,GAAS,CAAC,GAAG,iBAAiB,CAAA;AAC1D,MAAA,QAAA,CAAS,MAAA,CAAO,QAAQ,CAAC,CAAA;AAAA,eAChB,WAAA,KAAgB,EAAA,IAAM,QAAA,CAAS,WAAA,GAAc,CAAC,CAAA,EAAG;AAC1D,MAAA,SAAA,GAAY,CAAC,IAAA,EAAM,QAAA,CAAS,WAAA,GAAc,CAAC,GAAG,iBAAiB,CAAA;AAC/D,MAAA,QAAA,CAAS,MAAA,CAAO,aAAa,CAAC,CAAA;AAAA;AAIhC,IAAA,IAAI,aAAuB,EAAC;AAC5B,IAAA,MAAM,YAAA,GAAe,QAAA,CAAS,OAAA,CAAQ,WAAW,CAAA;AACjD,IAAA,IAAI,YAAA,KAAiB,EAAA,IAAM,QAAA,CAAS,YAAA,GAAe,CAAC,CAAA,EAAG;AACrD,MAAA,UAAA,GAAa,CAAC,WAAA,EAAa,QAAA,CAAS,YAAA,GAAe,CAAC,CAAC,CAAA;AAAA;AAGvD,IAAA,MAAM,MAAA,GAAgC,aAAA;AAAA,MACpC,KAAA;AAAA,MACA;AAAA,QACE,iBAAA;AAAA,QACA,IAAA;AAAA,QACA,IAAA;AAAA,QACA,yBAAA;AAAA,QACA,IAAA;AAAA,QACA,uBAAA;AAAA,QACA,IAAA;AAAA,QACA,aAAA;AAAA,QACA,GAAG,SAAA;AAAA,QACH,GAAG,UAAA;AAAA,QACH,GAAG;AAAA,OACL;AAAA,MACA,EAAE,OAAO,SAAA;AAAU,KACrB;AACA,IAAA,IAAA,CAAK,MAAA,CAAO,UAAU,CAAC,CAAA;AAAA,GACzB,MAAO;AACL,IAAA,UAAA,EAAW;AAAA;AAEf","file":"cli.cjs","sourcesContent":["// Testable CLI logic for dataqueue\nimport { spawnSync, SpawnSyncReturns } from 'child_process';\nimport path from 'path';\n\nexport interface CliDeps {\n  log?: (...args: any[]) => void;\n  error?: (...args: any[]) => void;\n  exit?: (code: number) => void;\n  spawnSyncImpl?: (...args: any[]) => SpawnSyncReturns<any>;\n  migrationsDir?: string;\n}\n\nexport function runCli(\n  argv: string[],\n  {\n    log = console.log,\n    exit = (code: number) => process.exit(code),\n    spawnSyncImpl = spawnSync,\n    migrationsDir = path.join(__dirname, '../migrations'),\n  }: CliDeps = {},\n): void {\n  const [, , command, ...restArgs] = argv;\n\n  function printUsage() {\n    log(\n      'Usage: dataqueue-cli migrate [--envPath <path>] [-s <schema> | --schema <schema>]',\n    );\n    log('');\n    log('Options:');\n    log(\n      '  --envPath <path>   Path to a .env file to load environment variables (passed to node-pg-migrate)',\n    );\n    log(\n      '  -s, --schema <schema>  Set the schema to use (passed to node-pg-migrate)',\n    );\n    log('');\n    log('Notes:');\n    log(\n      '  - The PG_DATAQUEUE_DATABASE environment variable must be set to your Postgres connection string.',\n    );\n    exit(1);\n  }\n\n  if (command === 'migrate') {\n    // Support for -s or --schema argument\n    let schemaArg: string[] = [];\n    const sIndex = restArgs.indexOf('-s');\n    const schemaIndex = restArgs.indexOf('--schema');\n    if (sIndex !== -1 && restArgs[sIndex + 1]) {\n      schemaArg = ['-s', restArgs[sIndex + 1], '--create-schema'];\n      restArgs.splice(sIndex, 2);\n    } else if (schemaIndex !== -1 && restArgs[schemaIndex + 1]) {\n      schemaArg = ['-s', restArgs[schemaIndex + 1], '--create-schema'];\n      restArgs.splice(schemaIndex, 2);\n    }\n\n    // Support for --envPath argument\n    let envPathArg: string[] = [];\n    const envPathIndex = restArgs.indexOf('--envPath');\n    if (envPathIndex !== -1 && restArgs[envPathIndex + 1]) {\n      envPathArg = ['--envPath', restArgs[envPathIndex + 1]];\n    }\n\n    const result: SpawnSyncReturns<any> = spawnSyncImpl(\n      'npx',\n      [\n        'node-pg-migrate',\n        'up',\n        '-t',\n        'dataqueuedev_migrations',\n        '-d',\n        'PG_DATAQUEUE_DATABASE',\n        '-m',\n        migrationsDir,\n        ...schemaArg,\n        ...envPathArg,\n        ...restArgs,\n      ],\n      { stdio: 'inherit' },\n    );\n    exit(result.status ?? 1);\n  } else {\n    printUsage();\n  }\n}\n"]}

package/dist/cli.d.cts

@@ -0,0 +1,12 @@
+import { SpawnSyncReturns } from 'child_process';
+
+interface CliDeps {
+    log?: (...args: any[]) => void;
+    error?: (...args: any[]) => void;
+    exit?: (code: number) => void;
+    spawnSyncImpl?: (...args: any[]) => SpawnSyncReturns<any>;
+    migrationsDir?: string;
+}
+declare function runCli(argv: string[], { log, exit, spawnSyncImpl, migrationsDir, }?: CliDeps): void;
+
+export { type CliDeps, runCli };

package/dist/cli.d.ts

@@ -0,0 +1,12 @@
+import { SpawnSyncReturns } from 'child_process';
+
+interface CliDeps {
+    log?: (...args: any[]) => void;
+    error?: (...args: any[]) => void;
+    exit?: (code: number) => void;
+    spawnSyncImpl?: (...args: any[]) => SpawnSyncReturns<any>;
+    migrationsDir?: string;
+}
+declare function runCli(argv: string[], { log, exit, spawnSyncImpl, migrationsDir, }?: CliDeps): void;
+
+export { type CliDeps, runCli };

package/dist/cli.js

@@ -0,0 +1,72 @@
+import { spawnSync } from 'child_process';
+import path from 'path';
+
+// src/cli.ts
+function runCli(argv, {
+  log = console.log,
+  exit = (code) => process.exit(code),
+  spawnSyncImpl = spawnSync,
+  migrationsDir = path.join(__dirname, "../migrations")
+} = {}) {
+  const [, , command, ...restArgs] = argv;
+  function printUsage() {
+    log(
+      "Usage: dataqueue-cli migrate [--envPath <path>] [-s <schema> | --schema <schema>]"
+    );
+    log("");
+    log("Options:");
+    log(
+      "  --envPath <path>   Path to a .env file to load environment variables (passed to node-pg-migrate)"
+    );
+    log(
+      "  -s, --schema <schema>  Set the schema to use (passed to node-pg-migrate)"
+    );
+    log("");
+    log("Notes:");
+    log(
+      "  - The PG_DATAQUEUE_DATABASE environment variable must be set to your Postgres connection string."
+    );
+    exit(1);
+  }
+  if (command === "migrate") {
+    let schemaArg = [];
+    const sIndex = restArgs.indexOf("-s");
+    const schemaIndex = restArgs.indexOf("--schema");
+    if (sIndex !== -1 && restArgs[sIndex + 1]) {
+      schemaArg = ["-s", restArgs[sIndex + 1], "--create-schema"];
+      restArgs.splice(sIndex, 2);
+    } else if (schemaIndex !== -1 && restArgs[schemaIndex + 1]) {
+      schemaArg = ["-s", restArgs[schemaIndex + 1], "--create-schema"];
+      restArgs.splice(schemaIndex, 2);
+    }
+    let envPathArg = [];
+    const envPathIndex = restArgs.indexOf("--envPath");
+    if (envPathIndex !== -1 && restArgs[envPathIndex + 1]) {
+      envPathArg = ["--envPath", restArgs[envPathIndex + 1]];
+    }
+    const result = spawnSyncImpl(
+      "npx",
+      [
+        "node-pg-migrate",
+        "up",
+        "-t",
+        "dataqueuedev_migrations",
+        "-d",
+        "PG_DATAQUEUE_DATABASE",
+        "-m",
+        migrationsDir,
+        ...schemaArg,
+        ...envPathArg,
+        ...restArgs
+      ],
+      { stdio: "inherit" }
+    );
+    exit(result.status ?? 1);
+  } else {
+    printUsage();
+  }
+}
+
+export { runCli };
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"names":[],"mappings":";;;;AAYO,SAAS,OACd,IAAA,EACA;AAAA,EACE,MAAM,OAAA,CAAQ,GAAA;AAAA,EACd,IAAA,GAAO,CAAC,IAAA,KAAiB,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA,EAC1C,aAAA,GAAgB,SAAA;AAAA,EAChB,aAAA,GAAgB,IAAA,CAAK,IAAA,CAAK,SAAA,EAAW,eAAe;AACtD,CAAA,GAAa,EAAC,EACR;AACN,EAAA,MAAM,KAAK,OAAA,EAAS,GAAG,QAAQ,CAAA,GAAI,IAAA;AAEnC,EAAA,SAAS,UAAA,GAAa;AACpB,IAAA,GAAA;AAAA,MACE;AAAA,KACF;AACA,IAAA,GAAA,CAAI,EAAE,CAAA;AACN,IAAA,GAAA,CAAI,UAAU,CAAA;AACd,IAAA,GAAA;AAAA,MACE;AAAA,KACF;AACA,IAAA,GAAA;AAAA,MACE;AAAA,KACF;AACA,IAAA,GAAA,CAAI,EAAE,CAAA;AACN,IAAA,GAAA,CAAI,QAAQ,CAAA;AACZ,IAAA,GAAA;AAAA,MACE;AAAA,KACF;AACA,IAAA,IAAA,CAAK,CAAC,CAAA;AAAA;AAGR,EAAA,IAAI,YAAY,SAAA,EAAW;AAEzB,IAAA,IAAI,YAAsB,EAAC;AAC3B,IAAA,MAAM,MAAA,GAAS,QAAA,CAAS,OAAA,CAAQ,IAAI,CAAA;AACpC,IAAA,MAAM,WAAA,GAAc,QAAA,CAAS,OAAA,CAAQ,UAAU,CAAA;AAC/C,IAAA,IAAI,MAAA,KAAW,EAAA,IAAM,QAAA,CAAS,MAAA,GAAS,CAAC,CAAA,EAAG;AACzC,MAAA,SAAA,GAAY,CAAC,IAAA,EAAM,QAAA,CAAS,MAAA,GAAS,CAAC,GAAG,iBAAiB,CAAA;AAC1D,MAAA,QAAA,CAAS,MAAA,CAAO,QAAQ,CAAC,CAAA;AAAA,eAChB,WAAA,KAAgB,EAAA,IAAM,QAAA,CAAS,WAAA,GAAc,CAAC,CAAA,EAAG;AAC1D,MAAA,SAAA,GAAY,CAAC,IAAA,EAAM,QAAA,CAAS,WAAA,GAAc,CAAC,GAAG,iBAAiB,CAAA;AAC/D,MAAA,QAAA,CAAS,MAAA,CAAO,aAAa,CAAC,CAAA;AAAA;AAIhC,IAAA,IAAI,aAAuB,EAAC;AAC5B,IAAA,MAAM,YAAA,GAAe,QAAA,CAAS,OAAA,CAAQ,WAAW,CAAA;AACjD,IAAA,IAAI,YAAA,KAAiB,EAAA,IAAM,QAAA,CAAS,YAAA,GAAe,CAAC,CAAA,EAAG;AACrD,MAAA,UAAA,GAAa,CAAC,WAAA,EAAa,QAAA,CAAS,YAAA,GAAe,CAAC,CAAC,CAAA;AAAA;AAGvD,IAAA,MAAM,MAAA,GAAgC,aAAA;AAAA,MACpC,KAAA;AAAA,MACA;AAAA,QACE,iBAAA;AAAA,QACA,IAAA;AAAA,QACA,IAAA;AAAA,QACA,yBAAA;AAAA,QACA,IAAA;AAAA,QACA,uBAAA;AAAA,QACA,IAAA;AAAA,QACA,aAAA;AAAA,QACA,GAAG,SAAA;AAAA,QACH,GAAG,UAAA;AAAA,QACH,GAAG;AAAA,OACL;AAAA,MACA,EAAE,OAAO,SAAA;AAAU,KACrB;AACA,IAAA,IAAA,CAAK,MAAA,CAAO,UAAU,CAAC,CAAA;AAAA,GACzB,MAAO;AACL,IAAA,UAAA,EAAW;AAAA;AAEf","file":"cli.js","sourcesContent":["// Testable CLI logic for dataqueue\nimport { spawnSync, SpawnSyncReturns } from 'child_process';\nimport path from 'path';\n\nexport interface CliDeps {\n  log?: (...args: any[]) => void;\n  error?: (...args: any[]) => void;\n  exit?: (code: number) => void;\n  spawnSyncImpl?: (...args: any[]) => SpawnSyncReturns<any>;\n  migrationsDir?: string;\n}\n\nexport function runCli(\n  argv: string[],\n  {\n    log = console.log,\n    exit = (code: number) => process.exit(code),\n    spawnSyncImpl = spawnSync,\n    migrationsDir = path.join(__dirname, '../migrations'),\n  }: CliDeps = {},\n): void {\n  const [, , command, ...restArgs] = argv;\n\n  function printUsage() {\n    log(\n      'Usage: dataqueue-cli migrate [--envPath <path>] [-s <schema> | --schema <schema>]',\n    );\n    log('');\n    log('Options:');\n    log(\n      '  --envPath <path>   Path to a .env file to load environment variables (passed to node-pg-migrate)',\n    );\n    log(\n      '  -s, --schema <schema>  Set the schema to use (passed to node-pg-migrate)',\n    );\n    log('');\n    log('Notes:');\n    log(\n      '  - The PG_DATAQUEUE_DATABASE environment variable must be set to your Postgres connection string.',\n    );\n    exit(1);\n  }\n\n  if (command === 'migrate') {\n    // Support for -s or --schema argument\n    let schemaArg: string[] = [];\n    const sIndex = restArgs.indexOf('-s');\n    const schemaIndex = restArgs.indexOf('--schema');\n    if (sIndex !== -1 && restArgs[sIndex + 1]) {\n      schemaArg = ['-s', restArgs[sIndex + 1], '--create-schema'];\n      restArgs.splice(sIndex, 2);\n    } else if (schemaIndex !== -1 && restArgs[schemaIndex + 1]) {\n      schemaArg = ['-s', restArgs[schemaIndex + 1], '--create-schema'];\n      restArgs.splice(schemaIndex, 2);\n    }\n\n    // Support for --envPath argument\n    let envPathArg: string[] = [];\n    const envPathIndex = restArgs.indexOf('--envPath');\n    if (envPathIndex !== -1 && restArgs[envPathIndex + 1]) {\n      envPathArg = ['--envPath', restArgs[envPathIndex + 1]];\n    }\n\n    const result: SpawnSyncReturns<any> = spawnSyncImpl(\n      'npx',\n      [\n        'node-pg-migrate',\n        'up',\n        '-t',\n        'dataqueuedev_migrations',\n        '-d',\n        'PG_DATAQUEUE_DATABASE',\n        '-m',\n        migrationsDir,\n        ...schemaArg,\n        ...envPathArg,\n        ...restArgs,\n      ],\n      { stdio: 'inherit' },\n    );\n    exit(result.status ?? 1);\n  } else {\n    printUsage();\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nicnocquee/dataqueue",
-  "version": "1.19.0",
+  "version": "1.19.1",
   "description": "PostgreSQL-based job queue for Node.js applications with support for serverless environments",
   "type": "module",
   "main": "dist/index.js",

package/src/cli.test.ts

@@ -0,0 +1,130 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { runCli, CliDeps } from './cli.js';
+import type { SpawnSyncReturns } from 'child_process';
+
+function makeSpawnSyncReturns(status: number): SpawnSyncReturns<string> {
+  // Provide all required properties for the mock
+  return {
+    pid: 123,
+    output: [],
+    stdout: '',
+    stderr: '',
+    status,
+    signal: null,
+    error: undefined,
+  };
+}
+
+function makeDeps() {
+  return {
+    log: vi.fn(),
+    error: vi.fn(),
+    exit: vi.fn(),
+    spawnSyncImpl: vi.fn(() => makeSpawnSyncReturns(0)),
+    migrationsDir: '/migrations',
+  } satisfies CliDeps;
+}
+
+describe('runCli', () => {
+  let deps: ReturnType<typeof makeDeps>;
+
+  beforeEach(() => {
+    deps = makeDeps();
+  });
+
+  it('prints usage and exits with code 1 for no command', () => {
+    runCli(['node', 'cli.js'], deps);
+    expect(deps.log).toHaveBeenCalledWith(
+      'Usage: dataqueue-cli migrate [--envPath <path>] [-s <schema> | --schema <schema>]',
+    );
+    expect(deps.exit).toHaveBeenCalledWith(1);
+  });
+
+  it('prints usage and exits with code 1 for unknown command', () => {
+    runCli(['node', 'cli.js', 'unknown'], deps);
+    expect(deps.log).toHaveBeenCalledWith(
+      'Usage: dataqueue-cli migrate [--envPath <path>] [-s <schema> | --schema <schema>]',
+    );
+    expect(deps.exit).toHaveBeenCalledWith(1);
+  });
+
+  it('calls spawnSyncImpl with correct args for migrate', () => {
+    runCli(['node', 'cli.js', 'migrate'], deps);
+    expect(deps.spawnSyncImpl).toHaveBeenCalledWith(
+      'npx',
+      [
+        'node-pg-migrate',
+        'up',
+        '-t',
+        'dataqueuedev_migrations',
+        '-d',
+        'PG_DATAQUEUE_DATABASE',
+        '-m',
+        '/migrations',
+      ],
+      { stdio: 'inherit' },
+    );
+    expect(deps.exit).toHaveBeenCalledWith(0);
+  });
+
+  it('parses -s schema argument and passes to spawnSyncImpl', () => {
+    runCli(['node', 'cli.js', 'migrate', '-s', 'myschema'], deps);
+    expect(deps.spawnSyncImpl).toHaveBeenCalledWith(
+      'npx',
+      expect.arrayContaining(['-s', 'myschema', '--create-schema']),
+      expect.anything(),
+    );
+    expect(deps.exit).toHaveBeenCalledWith(0);
+  });
+
+  it('parses --schema argument and passes to spawnSyncImpl', () => {
+    runCli(['node', 'cli.js', 'migrate', '--schema', 'myschema'], deps);
+    expect(deps.spawnSyncImpl).toHaveBeenCalledWith(
+      'npx',
+      expect.arrayContaining(['-s', 'myschema', '--create-schema']),
+      expect.anything(),
+    );
+    expect(deps.exit).toHaveBeenCalledWith(0);
+  });
+
+  it('parses --envPath argument and passes to spawnSyncImpl', () => {
+    runCli(['node', 'cli.js', 'migrate', '--envPath', '.env.local'], deps);
+    expect(deps.spawnSyncImpl).toHaveBeenCalledWith(
+      'npx',
+      expect.arrayContaining(['--envPath', '.env.local']),
+      expect.anything(),
+    );
+    expect(deps.exit).toHaveBeenCalledWith(0);
+  });
+
+  it('passes extra args to spawnSyncImpl', () => {
+    runCli(['node', 'cli.js', 'migrate', '--foo', 'bar'], deps);
+    expect(deps.spawnSyncImpl).toHaveBeenCalledWith(
+      'npx',
+      expect.arrayContaining(['--foo', 'bar']),
+      expect.anything(),
+    );
+    expect(deps.exit).toHaveBeenCalledWith(0);
+  });
+
+  it('exits with nonzero code if spawnSyncImpl returns nonzero status', () => {
+    deps.spawnSyncImpl.mockReturnValueOnce(makeSpawnSyncReturns(2));
+    runCli(['node', 'cli.js', 'migrate'], deps);
+    expect(deps.exit).toHaveBeenCalledWith(2);
+  });
+
+  it('exits with code 1 if spawnSyncImpl returns undefined status', () => {
+    // Return an object with all required properties but status undefined
+    deps.spawnSyncImpl.mockReturnValueOnce({
+      pid: 123,
+      output: [],
+      stdout: '',
+      stderr: '',
+      status: null,
+      signal: null,
+      error: undefined,
+    });
+    runCli(['node', 'cli.js', 'migrate'], deps);
+    expect(deps.exit).toHaveBeenCalledWith(1);
+  });
+});

package/src/cli.ts

@@ -0,0 +1,85 @@
+// Testable CLI logic for dataqueue
+import { spawnSync, SpawnSyncReturns } from 'child_process';
+import path from 'path';
+
+export interface CliDeps {
+  log?: (...args: any[]) => void;
+  error?: (...args: any[]) => void;
+  exit?: (code: number) => void;
+  spawnSyncImpl?: (...args: any[]) => SpawnSyncReturns<any>;
+  migrationsDir?: string;
+}
+
+export function runCli(
+  argv: string[],
+  {
+    log = console.log,
+    exit = (code: number) => process.exit(code),
+    spawnSyncImpl = spawnSync,
+    migrationsDir = path.join(__dirname, '../migrations'),
+  }: CliDeps = {},
+): void {
+  const [, , command, ...restArgs] = argv;
+
+  function printUsage() {
+    log(
+      'Usage: dataqueue-cli migrate [--envPath <path>] [-s <schema> | --schema <schema>]',
+    );
+    log('');
+    log('Options:');
+    log(
+      '  --envPath <path>   Path to a .env file to load environment variables (passed to node-pg-migrate)',
+    );
+    log(
+      '  -s, --schema <schema>  Set the schema to use (passed to node-pg-migrate)',
+    );
+    log('');
+    log('Notes:');
+    log(
+      '  - The PG_DATAQUEUE_DATABASE environment variable must be set to your Postgres connection string.',
+    );
+    exit(1);
+  }
+
+  if (command === 'migrate') {
+    // Support for -s or --schema argument
+    let schemaArg: string[] = [];
+    const sIndex = restArgs.indexOf('-s');
+    const schemaIndex = restArgs.indexOf('--schema');
+    if (sIndex !== -1 && restArgs[sIndex + 1]) {
+      schemaArg = ['-s', restArgs[sIndex + 1], '--create-schema'];
+      restArgs.splice(sIndex, 2);
+    } else if (schemaIndex !== -1 && restArgs[schemaIndex + 1]) {
+      schemaArg = ['-s', restArgs[schemaIndex + 1], '--create-schema'];
+      restArgs.splice(schemaIndex, 2);
+    }
+
+    // Support for --envPath argument
+    let envPathArg: string[] = [];
+    const envPathIndex = restArgs.indexOf('--envPath');
+    if (envPathIndex !== -1 && restArgs[envPathIndex + 1]) {
+      envPathArg = ['--envPath', restArgs[envPathIndex + 1]];
+    }
+
+    const result: SpawnSyncReturns<any> = spawnSyncImpl(
+      'npx',
+      [
+        'node-pg-migrate',
+        'up',
+        '-t',
+        'dataqueuedev_migrations',
+        '-d',
+        'PG_DATAQUEUE_DATABASE',
+        '-m',
+        migrationsDir,
+        ...schemaArg,
+        ...envPathArg,
+        ...restArgs,
+      ],
+      { stdio: 'inherit' },
+    );
+    exit(result.status ?? 1);
+  } else {
+    printUsage();
+  }
+}