monsqlize 2.0.6 → 3.1.0

package/dist/cjs/cli/data-task.cjs

@@ -0,0 +1,380 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/cli/data-task.ts
+var import_promises = require("node:fs/promises");
+var import_node_path = __toESM(require("node:path"));
+var import_node_url = require("node:url");
+
+// package.json
+var package_default = {
+  name: "monsqlize",
+  version: "3.1.0",
+  description: "TypeScript production data runtime layer for MongoDB today, with cache, transactions, pools, models, sync, and observability",
+  type: "commonjs",
+  main: "./dist/cjs/index.cjs",
+  module: "./dist/esm/index.mjs",
+  types: "./dist/types/index.d.ts",
+  bin: {
+    monsqlize: "dist/cjs/cli/data-task.cjs"
+  },
+  exports: {
+    ".": {
+      types: {
+        import: "./dist/types/index.d.mts",
+        require: "./dist/types/index.d.ts"
+      },
+      require: "./dist/cjs/index.cjs",
+      import: "./dist/esm/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  files: [
+    "dist/**/*.cjs",
+    "dist/**/*.mjs",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.mts",
+    "changelogs/v3.1.0.md",
+    "changelogs/v3.1.0-rc.0.md",
+    "changelogs/v3.0.0.md",
+    "changelogs/v2.0.7.md",
+    "changelogs/v2.0.6.md",
+    "changelogs/v2.0.5.md",
+    "changelogs/v2.0.4.md",
+    "changelogs/v2.0.3.md",
+    "changelogs/v2.0.2.md",
+    "changelogs/v2.0.1.md",
+    "changelogs/v2.0.0.md",
+    "README.md",
+    "MIGRATION.md",
+    "SECURITY.md",
+    "LICENSE",
+    "licenses/production-dependencies.json",
+    "CHANGELOG.md"
+  ],
+  keywords: [
+    "mongodb",
+    "database",
+    "data-runtime",
+    "database-runtime",
+    "cache",
+    "transaction",
+    "distributed",
+    "cache-invalidation",
+    "pagination",
+    "performance",
+    "mongodb-driver",
+    "nosql",
+    "typescript",
+    "query-builder",
+    "api"
+  ],
+  author: "vext.js Team",
+  license: "Apache-2.0",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/vextjs/monSQLize.git"
+  },
+  bugs: {
+    url: "https://github.com/vextjs/monSQLize/issues"
+  },
+  homepage: "https://vextjs.github.io/monSQLize/",
+  publishConfig: {
+    access: "public",
+    registry: "https://registry.npmjs.org/"
+  },
+  config: {
+    mongodbMemoryServer: {
+      downloadDir: ".cache/mongodb-memory-server/binaries",
+      preferGlobalPath: "false",
+      version: "7.0.37"
+    }
+  },
+  engines: {
+    node: ">=18.0.0"
+  },
+  scripts: {
+    "check:lint-contract": "node scripts/validation/check-lint-contract.cjs",
+    "check:coverage-policy": "node scripts/validation/check-coverage-policy.cjs",
+    "check:package-budgets": "node scripts/validation/check-package-budgets.cjs",
+    "check:production-licenses": "node scripts/validation/check-production-licenses.cjs",
+    "check:contributor-contract": "node scripts/validation/check-contributor-contract.cjs",
+    "check:dependency-policy": "node scripts/validation/check-dependency-policy.cjs",
+    "check:release-metadata": "node scripts/validation/check-release-metadata.cjs",
+    "check:doc-claims": "node scripts/validation/check-doc-claims.cjs",
+    "check:error-contract": "node scripts/validation/check-error-contract.cjs",
+    "check:current-version": "node scripts/validation/check-current-version-terminology.cjs",
+    "cleanup:derived": "node scripts/cleanup-derived-artifacts.cjs",
+    "cleanup:derived:apply": "node scripts/cleanup-derived-artifacts.cjs --apply --confirm=derived-artifacts",
+    "check:sizes": "node scripts/check-file-sizes.cjs",
+    "check:sizes:strict": "node scripts/check-file-sizes.cjs --strict",
+    build: "node scripts/build-p1.cjs",
+    "build:tests": "node scripts/compile-tests.cjs",
+    lint: "eslint . --ignore-pattern .generated/** --ignore-pattern dist/** --ignore-pattern .devcodex/**",
+    "lint:fix": "eslint . --fix --ignore-pattern .generated/** --ignore-pattern dist/** --ignore-pattern .devcodex/**",
+    "test:runtime": "npm run build && npm run build:tests && node --test .generated/test-dist/test/smoke/root-cjs.test.js .generated/test-dist/test/smoke/root-esm.test.js .generated/test-dist/test/smoke/pack-artifacts.test.js",
+    "test:compatibility": "npm run build && npm run build:tests && node --test .generated/test-dist/test/compatibility/exports/exports.test.js .generated/test-dist/test/compatibility/matrix.test.js",
+    "probe:server-matrix": "node scripts/validation/probe-memory-server-matrix.cjs",
+    "test:server-matrix": "node scripts/validation/run-memory-server-matrix.cjs",
+    "test:real-env:private": "node scripts/validation/run-private-real-env-checks.cjs",
+    "test:examples": "npm run build && tsc -p tsconfig.examples.json && node scripts/run-examples.cjs",
+    "test:performance": "npm run build && npm run build:tests && node .generated/test-dist/test/performance/baselines/function-cache.benchmark.js",
+    "test:unit": "npm run build && npm run build:tests && node test/run-tests.cjs unit",
+    "test:integration": "npm run build && npm run build:tests && node --test --test-concurrency=1 .generated/test-dist/test/integration/cache/cache.test.js .generated/test-dist/test/integration/cache/cache-behavior.test.js .generated/test-dist/test/integration/mongodb/connect.test.js .generated/test-dist/test/integration/mongodb/queries.test.js .generated/test-dist/test/integration/mongodb/management.test.js .generated/test-dist/test/integration/mongodb/writes-batch.test.js .generated/test-dist/test/integration/mongodb/find.test.js .generated/test-dist/test/integration/mongodb/find-one.test.js .generated/test-dist/test/integration/mongodb/find-page.test.js .generated/test-dist/test/integration/mongodb/aggregate.test.js .generated/test-dist/test/integration/mongodb/chaining.test.js .generated/test-dist/test/integration/mongodb/insert.test.js .generated/test-dist/test/integration/mongodb/update.test.js .generated/test-dist/test/integration/mongodb/delete.test.js .generated/test-dist/test/integration/mongodb/update-pipeline.test.js .generated/test-dist/test/integration/model/model-features.test.js .generated/test-dist/test/integration/transaction/transaction.test.js .generated/test-dist/test/integration/pool/pool.test.js .generated/test-dist/test/integration/pool/pool-behavior.test.js .generated/test-dist/test/integration/watch/watch-native.test.js .generated/test-dist/test/integration/runtime/runtime-core-regression.test.js .generated/test-dist/test/integration/sync/sync.test.js .generated/test-dist/test/integration/slow-query-log/slow-query-log.test.js .generated/test-dist/test/integration/model/model-crud-extended.test.js .generated/test-dist/test/integration/mongodb/management-complete.test.js .generated/test-dist/test/integration/runtime/runtime-methods-extended.test.js .generated/test-dist/test/integration/mongodb/find-page-advanced.test.js",
+    "test:data-tasks:integration": "npm run build && npm run build:tests && node test/run-tests.cjs data-tasks-integration",
+    "test:data-task-cli": "npm run build && npm run build:tests && node test/run-tests.cjs data-task-cli",
+    "test:pack-install": "npm run build && node scripts/pack-install-smoke.cjs",
+    "test:refactor-guard": "npm run build && npm run build:tests && node --test --test-concurrency=1 .generated/test-dist/test/compatibility/exports/exports.test.js .generated/test-dist/test/integration/model/model-features.test.js .generated/test-dist/test/integration/runtime/runtime-core-regression.test.js .generated/test-dist/test/integration/sync/sync.test.js",
+    "test:refactor-guard:cache": "npm run build && npm run build:tests && node --test .generated/test-dist/test/unit/cache/cache-refactor-guard.test.js",
+    "test:coverage": "node scripts/run-coverage.cjs",
+    "test:audit": "npm audit --omit=dev --registry=https://registry.npmjs.org/",
+    test: "npm run build && npm run build:tests && node test/run-tests.cjs",
+    "type-check": "npm run build && tsc -p tsconfig.json --noEmit && tsd --files test/types/root-import.test-d.ts --files test/types/cache-usage.test-d.ts --files test/types/model-usage.test-d.ts --files test/types/pool-usage.test-d.ts --files test/types/sync-usage.test-d.ts --files test/types/slow-query-log-usage.test-d.ts --files test/types/saga-usage.test-d.ts --files test/types/data-tasks-usage.test-d.ts",
+    "check:test-language": "node scripts/check-test-language.cjs",
+    "check:docs-examples": "node scripts/validation/check-doc-example-matrix.cjs",
+    "check:release-candidate": "node scripts/check-release-candidate.cjs",
+    "verify:fast": "npm run check:lint-contract && npm run lint && npm run check:contributor-contract && npm run check:dependency-policy && npm run check:release-metadata && npm run check:doc-claims && npm run check:error-contract && npm run check:current-version && npm run check:docs-examples && npm run type-check && npm run check:sizes:strict && npm run test:runtime && npm run check:package-budgets && npm run check:production-licenses && npm run test:compatibility && npm run test:refactor-guard && npm run test:refactor-guard:cache",
+    "verify:full": "npm run check:lint-contract && npm run lint && npm run check:doc-claims && npm run check:error-contract && npm run check:current-version && npm run check:docs-examples && npm run type-check && npm run check:sizes:strict && npm run test:examples && npm run test:server-matrix",
+    "verify:release": "npm run verify:full && npm run test:real-env:private",
+    verify: "npm run verify:full",
+    "release:preflight": "node scripts/release-preflight.cjs",
+    prepublishOnly: "npm run release:preflight",
+    "release:publish": "npm run release:preflight && npm publish --ignore-scripts"
+  },
+  devDependencies: {
+    "@eslint/js": "9.39.4",
+    "@types/node": "25.6.2",
+    "@types/semver": "7.7.1",
+    c8: "11.0.0",
+    chai: "6.2.2",
+    esbuild: "0.28.1",
+    eslint: "9.39.4",
+    "mongodb-memory-server": "10.4.3",
+    sinon: "22.0.0",
+    tsd: "0.33.0",
+    typescript: "5.9.3",
+    "typescript-eslint": "8.64.0"
+  },
+  dependencies: {
+    "async-lock": "1.4.1",
+    "cache-hub": "2.2.4",
+    ioredis: "5.11.1",
+    mongodb: "6.21.0",
+    "schema-dsl": "3.0.0",
+    ssh2: "1.17.0"
+  }
+};
+
+// src/cli/data-task.ts
+function usage() {
+  return [
+    "Usage:",
+    "  monsqlize data-task preview --task <job.mjs> [--out <preview.json>] [--json]",
+    "  monsqlize data-task apply --task <job.mjs> --approval <preview.json> [--out <result.json>] [--json]",
+    "  monsqlize data-task preview-restore --task <job.mjs> --backup <manifest.json> [--out <preview.json>] [--json]",
+    "  monsqlize data-task restore --task <job.mjs> --backup <manifest.json> --approval <preview.json> [--out <result.json>] [--json]",
+    "  monsqlize --help | --version"
+  ].join("\n");
+}
+function parseArgs(argv) {
+  const args = [...argv];
+  if (args[0] === "data-task") {
+    args.shift();
+  }
+  const parsed = {
+    json: false,
+    help: false,
+    version: false
+  };
+  if (args[0] === "--help" || args[0] === "-h") {
+    parsed.help = true;
+    args.shift();
+  } else if (args[0] === "--version" || args[0] === "-v") {
+    parsed.version = true;
+    args.shift();
+  } else {
+    parsed.action = args.shift();
+  }
+  while (args.length > 0) {
+    const arg = args.shift();
+    if (arg === "--task") {
+      parsed.taskFile = args.shift();
+    } else if (arg === "--json") {
+      parsed.json = true;
+    } else if (arg === "--approval") {
+      parsed.approvalFile = args.shift();
+    } else if (arg === "--backup") {
+      parsed.backupFile = args.shift();
+    } else if (arg === "--out") {
+      parsed.outFile = args.shift();
+    } else if (arg === "--help" || arg === "-h") {
+      parsed.help = true;
+    } else if (arg === "--version" || arg === "-v") {
+      parsed.version = true;
+    } else if (arg) {
+      throw new Error(`Unknown argument: ${arg}`);
+    }
+  }
+  return parsed;
+}
+function collectFailures(value, location = "result") {
+  if (!value || typeof value !== "object") return [];
+  const record = value;
+  const failures = [];
+  if (record.passed === false || record.status === "failed" || record.status === "partial") {
+    failures.push(`${location} reported failure.`);
+  }
+  if (Array.isArray(record.errors)) {
+    for (const error of record.errors) failures.push(`${location}: ${String(error)}`);
+  }
+  if (Array.isArray(record.results)) {
+    record.results.forEach((result, index) => failures.push(...collectFailures(result, `${location}.results[${index}]`)));
+  }
+  return [...new Set(failures)];
+}
+function unwrapDefault(value) {
+  return value && typeof value === "object" && "default" in value ? value.default : value;
+}
+function isDataTaskJob(value) {
+  return Boolean(value && typeof value === "object" && typeof value.name === "string" && typeof value.targetEnvironment === "string" && Array.isArray(value.collections));
+}
+function normalizeJobConfig(value) {
+  const exportedValue = unwrapDefault(value);
+  if (!isDataTaskJob(exportedValue)) throw new Error("Task file must directly export a DataTaskJob.");
+  return exportedValue;
+}
+async function loadTaskFile(file) {
+  const resolved = import_node_path.default.resolve(process.cwd(), file);
+  if (resolved.endsWith(".json")) {
+    return JSON.parse(await (0, import_promises.readFile)(resolved, "utf8"));
+  }
+  if (resolved.endsWith(".mjs")) {
+    return import((0, import_node_url.pathToFileURL)(resolved).href);
+  }
+  return require(resolved);
+}
+async function loadApproval(file) {
+  const parsed = JSON.parse(await (0, import_promises.readFile)(import_node_path.default.resolve(process.cwd(), file), "utf8"));
+  const approval = parsed && typeof parsed === "object" && "approval" in parsed ? parsed.approval : parsed;
+  if (!approval || approval.kind !== "apply" && approval.kind !== "restore") throw new Error("--approval must reference a preview result or approval object.");
+  return approval;
+}
+async function loadBackupRef(file) {
+  const resolved = import_node_path.default.resolve(process.cwd(), file);
+  const parsed = JSON.parse(await (0, import_promises.readFile)(resolved, "utf8"));
+  if (parsed.manifestPath && parsed.runId && parsed.checksum) return { runId: parsed.runId, checksum: parsed.checksum, manifestPath: import_node_path.default.resolve(import_node_path.default.dirname(resolved), parsed.manifestPath) };
+  if (typeof parsed.runId !== "string" || typeof parsed.checksum !== "string") throw new Error("--backup must reference a dataTasks manifest or backup ref.");
+  return { runId: parsed.runId, checksum: parsed.checksum, manifestPath: resolved };
+}
+function printHumanResult(action, result) {
+  if (!result || typeof result !== "object") {
+    console.log(String(result));
+    return;
+  }
+  const record = result;
+  console.log(`monSQLize data-task ${action}: ${record.jobName ?? record.taskName ?? "task"}`);
+  if (record.passed !== void 0) {
+    console.log(`passed: ${String(record.passed)}`);
+  }
+  if (Array.isArray(record.errors) && record.errors.length > 0) {
+    console.log(`errors: ${record.errors.length}`);
+    for (const error of record.errors) {
+      console.log(`- ${String(error)}`);
+    }
+  }
+  if (Array.isArray(record.warnings) && record.warnings.length > 0) {
+    console.log(`warnings: ${record.warnings.length}`);
+    for (const warning of record.warnings) {
+      console.log(`- ${String(warning)}`);
+    }
+  }
+  if (Array.isArray(record.results)) {
+    console.log(`results: ${record.results.length}`);
+  }
+  if (Array.isArray(record.collections)) console.log(`collections: ${record.collections.length}`);
+  const failures = collectFailures(result).filter((failure) => !failure.startsWith("result:"));
+  if (failures.length > 0) {
+    console.log(`nested failures: ${failures.length}`);
+    for (const failure of failures) console.log(`- ${failure}`);
+  }
+  if (record.backup && typeof record.backup === "object") {
+    const backup = record.backup;
+    if (backup.manifestPath) console.log(`backup: ${String(backup.manifestPath)}`);
+  }
+}
+async function outputResult(args, action, result) {
+  const serialized = `${JSON.stringify(result, null, 2)}
+`;
+  if (args.outFile) await (0, import_promises.writeFile)(import_node_path.default.resolve(process.cwd(), args.outFile), serialized, "utf8");
+  if (args.json) console.log(serialized.trimEnd());
+  else printHumanResult(action, result);
+  if (collectFailures(result).length > 0) process.exitCode = 1;
+}
+async function runCli(argv, service) {
+  const args = parseArgs(argv);
+  if (args.version) {
+    console.log(package_default.version);
+    return;
+  }
+  if (args.help || !args.action) {
+    console.log(usage());
+    return;
+  }
+  if (!["preview", "apply", "preview-restore", "restore"].includes(args.action)) {
+    throw new Error(`Unknown data-task action: ${String(args.action)}`);
+  }
+  if (!args.taskFile) {
+    throw new Error("--task <file> is required.");
+  }
+  const loaded = await loadTaskFile(args.taskFile);
+  const job = normalizeJobConfig(loaded);
+  if (typeof job.source.collection === "function" || typeof job.target.collection === "function") {
+    throw new Error("CLI DataTaskJob source and target must be MonSQLizeOptions, not runtime instances.");
+  }
+  let result;
+  if (args.action === "preview") {
+    result = await service.preview(job);
+  } else if (args.action === "apply") {
+    if (!args.approvalFile) throw new Error("apply requires --approval <preview.json>.");
+    result = await service.apply(job, { approval: await loadApproval(args.approvalFile) });
+  } else {
+    if (!args.backupFile) throw new Error(`${args.action} requires --backup <manifest.json>.`);
+    const backup = await loadBackupRef(args.backupFile);
+    if (args.action === "preview-restore") {
+      result = await service.previewRestore(backup, { target: job.target });
+    } else {
+      if (!args.approvalFile) throw new Error("restore requires --approval <preview.json>.");
+      result = await service.restore(backup, { target: job.target, approval: await loadApproval(args.approvalFile) });
+    }
+  }
+  await outputResult(args, args.action, result);
+}
+
+// src/cli/data-task-bin.ts
+var MonSQLize = require("../index.cjs");
+runCli(process.argv.slice(2), MonSQLize.dataTasks).catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+});