@amritk/mjst 0.12.2 → 0.13.0

package/dist/load-config.js

@@ -1,46 +1,45 @@
-import { readFile } from 'node:fs/promises';
-import { resolve } from 'node:path';
-const SOURCE_FORMATS = ['json', 'typebox', 'zod', 'valibot', 'effect'];
-const isSourceFormat = (value) => typeof value === 'string' && SOURCE_FORMATS.includes(value);
-const isHelpersMode = (value) => value === 'package' || value === 'embedded';
-const isImportExt = (value) => value === 'js' || value === 'ts';
-const isStringArray = (value) => Array.isArray(value) && value.every((entry) => typeof entry === 'string');
-/**
- * Loads a JSON config file and returns the relevant CLI config properties.
- * The config file should have the same keys as the CLI flags (schema, outDir).
- */
-export const loadConfig = async (configPath) => {
-    const absolutePath = resolve(configPath);
-    const raw = await readFile(absolutePath, 'utf-8');
-    const parsed = JSON.parse(raw);
-    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
-        throw new Error(`Config file must be a JSON object: ${configPath}`);
-    }
-    const obj = parsed;
-    return {
-        ...(typeof obj['schema'] === 'string' && { schema: obj['schema'] }),
-        ...(typeof obj['schemaDir'] === 'string' && { schemaDir: obj['schemaDir'] }),
-        ...(typeof obj['outDir'] === 'string' && { outDir: obj['outDir'] }),
-        ...(typeof obj['outFile'] === 'string' && { outFile: obj['outFile'] }),
-        ...(isSourceFormat(obj['input']) && { input: obj['input'] }),
-        ...(typeof obj['export'] === 'string' && { export: obj['export'] }),
-        ...(typeof obj['validators'] === 'boolean' && { validators: obj['validators'] }),
-        ...(typeof obj['typesOnly'] === 'boolean' && { typesOnly: obj['typesOnly'] }),
-        ...(typeof obj['examples'] === 'boolean' && { examples: obj['examples'] }),
-        ...(typeof obj['build'] === 'boolean' && { build: obj['build'] }),
-        ...(typeof obj['logWarnings'] === 'boolean' && { logWarnings: obj['logWarnings'] }),
-        ...(typeof obj['strict'] === 'boolean' && { strict: obj['strict'] }),
-        ...(typeof obj['stripUnknown'] === 'boolean' && { stripUnknown: obj['stripUnknown'] }),
-        ...(typeof obj['caseInsensitive'] === 'boolean' && { caseInsensitive: obj['caseInsensitive'] }),
-        ...(typeof obj['readonly'] === 'boolean' && { readonly: obj['readonly'] }),
-        ...(isHelpersMode(obj['helpers']) && { helpers: obj['helpers'] }),
-        ...(isImportExt(obj['importExt']) && { importExt: obj['importExt'] }),
-        ...(typeof obj['rootType'] === 'string' && { rootType: obj['rootType'] }),
-        ...(typeof obj['typeSuffix'] === 'string' && { typeSuffix: obj['typeSuffix'] }),
-        // `banner` is a boolean toggle or a custom header string, mirroring the CLI flag.
-        ...((typeof obj['banner'] === 'boolean' || typeof obj['banner'] === 'string') && { banner: obj['banner'] }),
-        ...(typeof obj['resolveRemote'] === 'boolean' && { resolveRemote: obj['resolveRemote'] }),
-        ...(isStringArray(obj['allowedHosts']) && { allowedHosts: obj['allowedHosts'] }),
-        ...(typeof obj['allowPrivateHosts'] === 'boolean' && { allowPrivateHosts: obj['allowPrivateHosts'] }),
-    };
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+const SOURCE_FORMATS = ["json", "typebox", "zod", "valibot", "effect"];
+const isSourceFormat = (value) => typeof value === "string" && SOURCE_FORMATS.includes(value);
+const isHelpersMode = (value) => value === "package" || value === "embedded";
+const isImportExt = (value) => value === "js" || value === "ts";
+const isStringArray = (value) => Array.isArray(value) && value.every((entry) => typeof entry === "string");
+const loadConfig = async (configPath) => {
+  const absolutePath = resolve(configPath);
+  const raw = await readFile(absolutePath, "utf-8");
+  const parsed = JSON.parse(raw);
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new Error(`Config file must be a JSON object: ${configPath}`);
+  }
+  const obj = parsed;
+  return {
+    ...typeof obj["schema"] === "string" && { schema: obj["schema"] },
+    ...typeof obj["schemaDir"] === "string" && { schemaDir: obj["schemaDir"] },
+    ...typeof obj["outDir"] === "string" && { outDir: obj["outDir"] },
+    ...typeof obj["outFile"] === "string" && { outFile: obj["outFile"] },
+    ...isSourceFormat(obj["input"]) && { input: obj["input"] },
+    ...typeof obj["export"] === "string" && { export: obj["export"] },
+    ...typeof obj["validators"] === "boolean" && { validators: obj["validators"] },
+    ...typeof obj["typesOnly"] === "boolean" && { typesOnly: obj["typesOnly"] },
+    ...typeof obj["examples"] === "boolean" && { examples: obj["examples"] },
+    ...typeof obj["build"] === "boolean" && { build: obj["build"] },
+    ...typeof obj["logWarnings"] === "boolean" && { logWarnings: obj["logWarnings"] },
+    ...typeof obj["strict"] === "boolean" && { strict: obj["strict"] },
+    ...typeof obj["stripUnknown"] === "boolean" && { stripUnknown: obj["stripUnknown"] },
+    ...typeof obj["caseInsensitive"] === "boolean" && { caseInsensitive: obj["caseInsensitive"] },
+    ...typeof obj["readonly"] === "boolean" && { readonly: obj["readonly"] },
+    ...isHelpersMode(obj["helpers"]) && { helpers: obj["helpers"] },
+    ...isImportExt(obj["importExt"]) && { importExt: obj["importExt"] },
+    ...typeof obj["rootType"] === "string" && { rootType: obj["rootType"] },
+    ...typeof obj["typeSuffix"] === "string" && { typeSuffix: obj["typeSuffix"] },
+    // `banner` is a boolean toggle or a custom header string, mirroring the CLI flag.
+    ...(typeof obj["banner"] === "boolean" || typeof obj["banner"] === "string") && { banner: obj["banner"] },
+    ...typeof obj["resolveRemote"] === "boolean" && { resolveRemote: obj["resolveRemote"] },
+    ...isStringArray(obj["allowedHosts"]) && { allowedHosts: obj["allowedHosts"] },
+    ...typeof obj["allowPrivateHosts"] === "boolean" && { allowPrivateHosts: obj["allowPrivateHosts"] }
+  };
+};
+export {
+  loadConfig
 };

package/dist/load-schema-module.js

@@ -1,45 +1,30 @@
-import { pathToFileURL } from 'node:url';
-/**
- * Loads a schema authored as a JS/TS module and returns the exported schema value.
- *
- * Export selection, in order of preference:
- * 1. The export named by `exportName`, when provided (`--export <name>`).
- * 2. The module's default export.
- * 3. The sole named export, when there is exactly one.
- *
- * Anything else is ambiguous and throws, so the user can disambiguate explicitly
- * rather than have mjst guess wrong.
- *
- * Importing a `.ts` module requires a TypeScript-capable runtime (Bun, or Node
- * with a loader such as `tsx`). We surface a friendly hint when the import fails
- * for a `.ts` path so the cause is not a cryptic module-resolution error.
- */
-export const loadSchemaModule = async (modulePath, exportName) => {
-    let mod;
-    try {
-        mod = (await import(pathToFileURL(modulePath).href));
+import { pathToFileURL } from "node:url";
+const loadSchemaModule = async (modulePath, exportName) => {
+  let mod;
+  try {
+    mod = await import(pathToFileURL(modulePath).href);
+  } catch (error) {
+    const hint = modulePath.endsWith(".ts") ? " Importing a .ts schema requires a TypeScript-capable runtime \u2014 run mjst via `bunx`, or install `tsx` and run Node with `--import tsx`." : "";
+    throw new Error(`Failed to load schema module at ${modulePath}.${hint}
+${String(error)}`);
+  }
+  if (exportName) {
+    if (!(exportName in mod)) {
+      throw new Error(`Schema module ${modulePath} has no export named '${exportName}'.`);
     }
-    catch (error) {
-        const hint = modulePath.endsWith('.ts')
-            ? ' Importing a .ts schema requires a TypeScript-capable runtime — run mjst via `bunx`, or install `tsx` and run Node with `--import tsx`.'
-            : '';
-        throw new Error(`Failed to load schema module at ${modulePath}.${hint}\n${String(error)}`);
-    }
-    if (exportName) {
-        if (!(exportName in mod)) {
-            throw new Error(`Schema module ${modulePath} has no export named '${exportName}'.`);
-        }
-        return mod[exportName];
-    }
-    if ('default' in mod && mod['default'] !== undefined) {
-        return mod['default'];
-    }
-    const namedKeys = Object.keys(mod).filter((key) => key !== 'default');
-    if (namedKeys.length === 1) {
-        const key = namedKeys[0];
-        if (key)
-            return mod[key];
-    }
-    throw new Error(`Schema module ${modulePath} exports ${namedKeys.length} values (${namedKeys.join(', ') || 'none'}). ` +
-        `Specify which one to use with --export <name>.`);
+    return mod[exportName];
+  }
+  if ("default" in mod && mod["default"] !== void 0) {
+    return mod["default"];
+  }
+  const namedKeys = Object.keys(mod).filter((key) => key !== "default");
+  if (namedKeys.length === 1) {
+    const key = namedKeys[0];
+    if (key)
+      return mod[key];
+  }
+  throw new Error(`Schema module ${modulePath} exports ${namedKeys.length} values (${namedKeys.join(", ") || "none"}). Specify which one to use with --export <name>.`);
+};
+export {
+  loadSchemaModule
 };

package/dist/load-schema.js

@@ -1,52 +1,36 @@
-import { readFile } from 'node:fs/promises';
-import { getAdapter } from '@amritk/adapters/get-adapter';
-import { resolveRefsFromFile } from '@amritk/resolve-refs';
-import { hasExternalRefs } from './has-external-refs.js';
-import { loadSchemaModule } from './load-schema-module.js';
-/**
- * Builds the `@amritk/resolve-refs` options from the CLI config, mirroring the
- * safety posture of `mjst lint`: remote (`http(s)`) `$ref`s are refused unless
- * opted into, a non-empty `allowedHosts` implies remote fetching, and private/
- * loopback hosts stay blocked as an SSRF guard unless explicitly permitted.
- */
+import { readFile } from "node:fs/promises";
+import { getAdapter } from "@amritk/adapters/get-adapter";
+import { resolveRefsFromFile } from "@amritk/resolve-refs";
+import { hasExternalRefs } from "./has-external-refs.js";
+import { loadSchemaModule } from "./load-schema-module.js";
 const buildResolveOptions = (config) => {
-    // A non-empty allow-list is itself an opt-in to remote fetching.
-    const remote = (config.resolveRemote ?? false) || (config.allowedHosts?.length ?? 0) > 0;
-    return {
-        remote,
-        ...(config.allowedHosts ? { allowedHosts: [...config.allowedHosts] } : {}),
-        ...(config.allowPrivateHosts ? { allowPrivateHosts: config.allowPrivateHosts } : {}),
-    };
+  const remote = (config.resolveRemote ?? false) || (config.allowedHosts?.length ?? 0) > 0;
+  return {
+    remote,
+    ...config.allowedHosts ? { allowedHosts: [...config.allowedHosts] } : {},
+    ...config.allowPrivateHosts ? { allowPrivateHosts: config.allowPrivateHosts } : {}
+  };
 };
-/** Renders resolver failures into a single CLI error message. */
 const formatResolveErrors = (schemaPath, errors) => {
-    const details = errors.map((error) => `  - ${error.message}`).join('\n');
-    return `Failed to resolve $refs in ${schemaPath}:\n${details}`;
+  const details = errors.map((error) => `  - ${error.message}`).join("\n");
+  return `Failed to resolve $refs in ${schemaPath}:
+${details}`;
 };
-/**
- * Reads a JSON Schema off disk, or loads a module and converts it via its adapter.
- *
- * For JSON input, a schema whose only references are same-document `#/...`
- * pointers is parsed as-is — the generator resolves those internal `$ref`s
- * itself into named type files, so inlining them here would collapse that
- * structure. When a cross-file or remote `$ref` is present (which the generator
- * cannot follow on its own), the schema is dereferenced with
- * `@amritk/resolve-refs`, inlining every external target into a single document.
- * Any resolve failures are surfaced as a CLI error rather than silently yielding
- * a half-resolved schema.
- */
-export const loadSchema = async (config, schemaPath) => {
-    const inputFormat = config.input ?? 'json';
-    if (inputFormat === 'json') {
-        const data = JSON.parse(await readFile(schemaPath, 'utf-8'));
-        if (!hasExternalRefs(data))
-            return data;
-        const { resolved, errors } = await resolveRefsFromFile(schemaPath, buildResolveOptions(config));
-        if (errors.length > 0)
-            throw new Error(formatResolveErrors(schemaPath, errors));
-        return resolved;
-    }
-    console.log(`Input format: ${inputFormat}`);
-    const source = await loadSchemaModule(schemaPath, config.export);
-    return getAdapter(inputFormat).toJSONSchema(source);
+const loadSchema = async (config, schemaPath) => {
+  const inputFormat = config.input ?? "json";
+  if (inputFormat === "json") {
+    const data = JSON.parse(await readFile(schemaPath, "utf-8"));
+    if (!hasExternalRefs(data))
+      return data;
+    const { resolved, errors } = await resolveRefsFromFile(schemaPath, buildResolveOptions(config));
+    if (errors.length > 0)
+      throw new Error(formatResolveErrors(schemaPath, errors));
+    return resolved;
+  }
+  console.log(`Input format: ${inputFormat}`);
+  const source = await loadSchemaModule(schemaPath, config.export);
+  return getAdapter(inputFormat).toJSONSchema(source);
+};
+export {
+  loadSchema
 };