Merge branch 'main' of github.com:mongodb-js/mongosh into gagik/testing-package

Author: gagik

THIRD_PARTY_NOTICES.md

@@ -170,9 +170,5 @@
     "packages/node-runtime-worker-thread",
     "packages/browser-repl",
     "packages/connectivity-tests"
-  ],
-  "overrides": {
-    "cookie": "^0.7.2",
-    "body-parser": "^2.2.1"
-  }
+  ]
 }

package-lock.json

@@ -10,5 +10,7 @@ ignores:
  - eslint-config-mongodb-js
 # needed as a peer dependency of @mongodb-js/devtools-connect
  - mongodb
+ # only used in arg-parser export; should be removed once switched to knip
+ - yargs-parser
 ignore-patterns:
  - .eslintrc.js

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mongosh/arg-parser",
-  "version": "3.22.2",
+  "version": "3.23.0",
   "description": "MongoDB Shell CLI Argument List Parser Package",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -46,11 +46,14 @@
     "unitTestsOnly": true
   },
   "dependencies": {
-    "@mongosh/errors": "2.4.4",
-    "@mongosh/i18n": "^2.19.0",
+    "@mongosh/errors": "2.4.5",
+    "@mongosh/i18n": "^2.20.0",
     "mongodb-connection-string-url": "^3.0.2",
     "yargs-parser": "^20.2.4"
   },
+  "peerDependencies": {
+    "zod": "^3.25.76"
+  },
   "devDependencies": {
     "@mongodb-js/devtools-connect": "^3.9.4",
     "@mongodb-js/eslint-config-mongosh": "^1.0.0",

packages/arg-parser/.depcheckrc

@@ -0,0 +1,91 @@
+import z from 'zod/v4';
+
+/**
+ * Registry for argument options metadata
+ */
+export const argMetadata = z.registry<ArgumentMetadata>();
+
+/**
+ * Metadata that can be used to define field's parsing behavior
+ */
+export type ArgumentMetadata = {
+  /** If set, sets this field as deprecated and replaces this field with the set field. */
+  deprecationReplacement?: string;
+  /** If set, gets replaced with a different field name (without deprecation) */
+  replacement?: string;
+  /** Whether this argument is unsupported. Always throws an error if set to true. */
+  unsupported?: boolean;
+  /** Aliases for this argument. */
+  alias?: string[];
+};
+
+/**
+ * Extract metadata for a field using the custom registry
+ */
+export function getArgumentMetadata(
+  schema: z.ZodObject,
+  fieldName: string
+): ArgumentMetadata | undefined {
+  const fieldSchema = schema.shape[fieldName];
+  if (!fieldSchema) {
+    return undefined;
+  }
+  return argMetadata.get(fieldSchema);
+}
+
+/**
+ * Maps deprecated arguments to their new counterparts, derived from schema metadata.
+ */
+export function getDeprecatedArgsWithReplacement(
+  schema: z.ZodObject
+): Record<string, keyof z.infer<typeof schema>> {
+  const deprecated: Record<string, keyof z.infer<typeof schema>> = {};
+  for (const fieldName of Object.keys(schema.shape)) {
+    const meta = getArgumentMetadata(schema, fieldName);
+    if (meta?.deprecationReplacement) {
+      deprecated[fieldName] = meta.deprecationReplacement;
+    }
+  }
+  return deprecated;
+}
+
+/**
+ * Get list of unsupported arguments, derived from schema metadata.
+ */
+export function getUnsupportedArgs(schema: z.ZodObject): string[] {
+  const unsupported: string[] = [];
+  for (const fieldName of Object.keys(schema.shape)) {
+    const meta = getArgumentMetadata(schema, fieldName);
+    if (meta?.unsupported) {
+      unsupported.push(fieldName);
+    }
+  }
+  return unsupported;
+}
+
+export class InvalidArgumentError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'InvalidArgumentError';
+  }
+}
+
+export class UnknownArgumentError extends Error {
+  /** The argument that was not parsed. */
+  readonly argument: string;
+  constructor(argument: string) {
+    super(`Unknown argument: ${argument}`);
+    this.name = 'UnknownArgumentError';
+    this.argument = argument;
+  }
+}
+
+export class UnsupportedArgumentError extends Error {
+  /** The argument that was not supported. */
+  readonly argument: string;
+  constructor(argument: string) {
+    super(`Unsupported argument: ${argument}`);
+    this.name = 'UnsupportedArgumentError';
+    this.argument = argument;
+  }
+}