apify-schema-tools 2.0.1

package/dist/apify-schema-tools.js

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { ArgumentDefaultsHelpFormatter, ArgumentParser } from "argparse";
+import { ACTOR_CONFIG_PATH, DATASET_SCHEMA_FIELD, filterValidInputSchemaProperties, generateInputDefaultsTSFileContent, } from "./apify.js";
+import { addCommonCLIArgs, parseConfigurationFromFileOrDefault, writeConfigurationToPackageJson, } from "./configuration.js";
+import { readFile, writeFile } from "./filesystem.js";
+import { compareSchemas, mergeObjectSchemas, readJsonSchema, readJsonSchemaField, writeJsonSchema, writeSchemaToField, } from "./json-schemas.js";
+import { compareTypescriptInterfaces, jsonSchemaToTypeScriptInterface, parseTypeScriptInterface, removeTypeScriptHeader, serializeTypeScriptInterface, writeTypeScriptFile, } from "./typescript.js";
+const configuration = parseConfigurationFromFileOrDefault();
+const rootParser = new ArgumentParser({
+    description: "Apify Schema Tools - Generate JSON schemas and TypeScript files for Actor input and output dataset.",
+    formatter_class: ArgumentDefaultsHelpFormatter,
+});
+// Create subparsers for commands, and define arguments shared by multiple commands
+const subparsers = rootParser.add_subparsers();
+const DEEP_MERGE_PARAM = "--deep-merge";
+const DEEP_MERGE_OPTIONS = {
+    help: "whether to deep merge additional schemas into the main schema",
+    action: "store_true",
+    default: false,
+};
+const initParser = subparsers.add_parser("init", {
+    help: "Initialize the Apify Schema Tools project with default settings.",
+    formatter_class: ArgumentDefaultsHelpFormatter,
+});
+addCommonCLIArgs(initParser, configuration);
+initParser.add_argument("--no-config-file", {
+    help: "do not create a configuration file in package.json",
+    action: "store_true",
+    default: false,
+});
+initParser.add_argument("--only-config-file", {
+    help: "create only the configuration file in package.json, without initializing schemas",
+    action: "store_true",
+    default: false,
+});
+function init(args) {
+    if (args.only_config_file && args.no_config_file) {
+        throw new Error("The options --only-config-file and --no-config-file were defined together: doing nothing.");
+    }
+    console.log("Initializing Apify Schema Tools in the current project...");
+    if (!args.no_config_file) {
+        writeConfigurationToPackageJson(args);
+        console.log("Configuration written to package.json");
+    }
+    if (args.only_config_file) {
+        console.log("Only configuration file created, skipping schema initialization.");
+        return;
+    }
+    if (args.input.includes("input")) {
+        if (!existsSync(args.input_schema)) {
+            throw new Error("The current Actor does not have an input schema.");
+        }
+        const inputSchema = readJsonSchema(args.input_schema);
+        writeJsonSchema(args.src_input, inputSchema);
+        console.log(`Input schema initialized at ${args.src_input}`);
+        if (args.add_input) {
+            writeJsonSchema(args.add_input, { type: "object", properties: {} });
+            console.log(`Additional input schema initialized at ${args.add_input}`);
+        }
+    }
+    if (args.input.includes("dataset")) {
+        if (!existsSync(ACTOR_CONFIG_PATH)) {
+            throw new Error(`The current Actor does not have an ${ACTOR_CONFIG_PATH} configuration file.`);
+        }
+        const actorConfig = JSON.parse(readFile(ACTOR_CONFIG_PATH));
+        if (actorConfig.storages?.dataset !== args.dataset_schema) {
+            writeFile(ACTOR_CONFIG_PATH, JSON.stringify({ ...actorConfig, storages: { ...actorConfig.storages, dataset: args.dataset_schema } }, null, 4));
+            console.log(`Updated ${ACTOR_CONFIG_PATH} to use the dataset schema at ${args.dataset_schema}`);
+        }
+        if (!existsSync(args.dataset_schema)) {
+            writeFile(args.dataset_schema, JSON.stringify({
+                actorSpecification: 1,
+                [DATASET_SCHEMA_FIELD]: { type: "object", properties: {} },
+            }, null, 4));
+            console.log(`Dataset schema initialized at ${args.dataset_schema}`);
+        }
+        const datasetItemSchema = readJsonSchemaField(args.dataset_schema, DATASET_SCHEMA_FIELD);
+        writeJsonSchema(args.src_dataset, datasetItemSchema);
+    }
+}
+initParser.set_defaults({ func: init });
+const syncParser = subparsers.add_parser("sync", {
+    help: "Generate JSON schemas and TypeScript files from the source schemas.",
+    formatter_class: ArgumentDefaultsHelpFormatter,
+});
+addCommonCLIArgs(syncParser, configuration);
+syncParser.add_argument(DEEP_MERGE_PARAM, DEEP_MERGE_OPTIONS);
+syncParser.add_argument("--include-input-utils", {
+    help: "include input utilities in the generated TypeScript files:" + " 'input' input and 'ts-types' output are required",
+    choices: ["true", "false"],
+    default: "true",
+});
+function sync(args) {
+    console.log("Syncing schemas...");
+    if (args.input.includes("input")) {
+        let inputSchema = readJsonSchema(args.src_input);
+        if (args.add_input) {
+            inputSchema = mergeObjectSchemas(inputSchema, readJsonSchema(args.add_input), args.deep_merge);
+        }
+        if (args.output.includes("json-schemas")) {
+            writeJsonSchema(args.input_schema, filterValidInputSchemaProperties(inputSchema));
+        }
+        if (args.output.includes("ts-types")) {
+            writeTypeScriptFile(join(args.output_ts_dir, "input.ts"), serializeTypeScriptInterface("Input", jsonSchemaToTypeScriptInterface(inputSchema)));
+            if (args.include_input_utils === "true") {
+                writeTypeScriptFile(join(args.output_ts_dir, "input-utils.ts"), generateInputDefaultsTSFileContent(inputSchema));
+            }
+        }
+    }
+    if (args.input.includes("dataset")) {
+        let datasetSchema = readJsonSchema(args.src_dataset);
+        if (args.add_dataset) {
+            datasetSchema = mergeObjectSchemas(datasetSchema, readJsonSchema(args.add_dataset), args.deep_merge);
+        }
+        if (args.output.includes("json-schemas")) {
+            writeSchemaToField(args.dataset_schema, datasetSchema, DATASET_SCHEMA_FIELD);
+        }
+        if (args.output.includes("ts-types")) {
+            writeTypeScriptFile(join(args.output_ts_dir, "dataset.ts"), serializeTypeScriptInterface("DatasetItem", jsonSchemaToTypeScriptInterface(datasetSchema)));
+        }
+    }
+}
+syncParser.set_defaults({ func: sync });
+const checkParser = subparsers.add_parser("check", {
+    help: "Check the schemas for consistency and correctness. (WARNING: input utils will not be checked!)",
+    formatter_class: ArgumentDefaultsHelpFormatter,
+});
+addCommonCLIArgs(checkParser, configuration);
+checkParser.add_argument(DEEP_MERGE_PARAM, DEEP_MERGE_OPTIONS);
+checkParser.add_argument("--ignore-descriptions", {
+    help: "ignore the 'title' and 'description' fields during the comparison",
+    action: "store_true",
+    default: false,
+});
+function check(args) {
+    if (args.input.includes("input")) {
+        let sourceInputSchema = readJsonSchema(args.src_input);
+        if (args.add_input) {
+            sourceInputSchema = mergeObjectSchemas(sourceInputSchema, readJsonSchema(args.add_input), args.deep_merge);
+        }
+        const generatedInputSchema = filterValidInputSchemaProperties(sourceInputSchema);
+        if (args.output.includes("json-schemas")) {
+            const outputInputSchema = readJsonSchema(args.input_schema);
+            const isInputSchemaCoherent = compareSchemas(generatedInputSchema, outputInputSchema, args.ignore_descriptions);
+            if (!isInputSchemaCoherent) {
+                console.error("Input schema validation failed: the input schema does not match the source schema.");
+                process.exit(1);
+            }
+        }
+        if (args.output.includes("ts-types")) {
+            const inputTSContent = readFile(join(args.output_ts_dir, "input.ts"));
+            const inputTSInterface = parseTypeScriptInterface(removeTypeScriptHeader(inputTSContent));
+            const sourceInputTSInterface = jsonSchemaToTypeScriptInterface(sourceInputSchema);
+            const isTSInputCoherent = compareTypescriptInterfaces(sourceInputTSInterface, inputTSInterface, args.ignore_descriptions);
+            if (!isTSInputCoherent) {
+                console.error("Input TypeScript interface validation failed: the TypeScript interface does not match the source schema.");
+                process.exit(1);
+            }
+        }
+    }
+    if (args.input.includes("dataset")) {
+        let sourceDatasetSchema = readJsonSchema(args.src_dataset);
+        if (args.add_dataset) {
+            sourceDatasetSchema = mergeObjectSchemas(sourceDatasetSchema, readJsonSchema(args.add_dataset), args.deep_merge);
+        }
+        if (args.output.includes("json-schemas")) {
+            const outputDatasetSchema = readJsonSchemaField(args.dataset_schema, DATASET_SCHEMA_FIELD);
+            if (!outputDatasetSchema) {
+                console.error(`Dataset schema field "${DATASET_SCHEMA_FIELD}" not found in ${args.dataset_schema}.`);
+                process.exit(1);
+            }
+            const isDatasetSchemaCoherent = compareSchemas(sourceDatasetSchema, outputDatasetSchema, args.ignore_descriptions);
+            if (!isDatasetSchemaCoherent) {
+                console.error("Dataset schema validation failed: the dataset schema does not match the source schema.");
+                process.exit(1);
+            }
+        }
+        if (args.output.includes("ts-types")) {
+            const datasetTSContent = readFile(join(args.output_ts_dir, "dataset.ts"));
+            const datasetTSInterface = parseTypeScriptInterface(removeTypeScriptHeader(datasetTSContent));
+            const sourceDatasetTSInterface = jsonSchemaToTypeScriptInterface(sourceDatasetSchema);
+            const isTSDatasetCoherent = compareTypescriptInterfaces(sourceDatasetTSInterface, datasetTSInterface, args.ignore_descriptions);
+            if (!isTSDatasetCoherent) {
+                console.error("Dataset TypeScript interface validation failed: the TypeScript interface does not match the source schema.");
+                process.exit(1);
+            }
+        }
+    }
+    console.log("Check passed.");
+}
+checkParser.set_defaults({ func: check });
+// Parse and execute
+const parsedArgs = rootParser.parse_args();
+parsedArgs.func(parsedArgs);
+//# sourceMappingURL=apify-schema-tools.js.map

package/dist/apify-schema-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apify-schema-tools.js","sourceRoot":"","sources":["../src/apify-schema-tools.ts"],"names":[],"mappings":"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"}

package/dist/apify.d.ts

@@ -0,0 +1,11 @@
+import { type ObjectSchema } from "./json-schemas.js";
+export declare const ACTOR_CONFIG_PATH = ".actor/actor.json";
+export declare function filterValidInputSchemaProperties(schema: ObjectSchema): ObjectSchema;
+/**
+ * Generates the content of a TypeScript file that exports a function to fill
+ * the default values for the input schema, and the interface for the input
+ * with the default values filled in.
+ */
+export declare function generateInputDefaultsTSFileContent(inputSchema: ObjectSchema): string;
+export declare const DATASET_SCHEMA_FIELD = "fields";
+//# sourceMappingURL=apify.d.ts.map

package/dist/apify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apify.d.ts","sourceRoot":"","sources":["../src/apify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAA+B,MAAM,mBAAmB,CAAC;AAGnF,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AA+CrD,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAQnF;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,WAAW,EAAE,YAAY,UAwD3E;AAED,eAAO,MAAM,oBAAoB,WAAW,CAAC"}

package/dist/apify.js

@@ -0,0 +1,107 @@
+import { filterValidSchemaProperties } from "./json-schemas.js";
+import { jsonSchemaToTypeScriptInterface, serializeTypeScriptSchema } from "./typescript.js";
+export const ACTOR_CONFIG_PATH = ".actor/actor.json";
+const VALID_INPUT_ROOT_KEYS = ["title", "description", "type", "schemaVersion", "properties", "required"];
+const VALID_INPUT_PROPERTY_KEYS = [
+    "type",
+    "title",
+    "description",
+    "default",
+    "prefill",
+    "example",
+    "sectionCaption",
+    "sectionDescription",
+];
+const VALID_INPUT_PROPERTY_TYPES = ["string", "boolean", "integer", "object", "array"];
+const VALID_INPUT_PROPERTY_KEYS_BY_TYPE = {
+    string: [
+        "editor",
+        "pattern",
+        "minLength",
+        "maxLength",
+        "enum",
+        "enumTitles",
+        "nullable",
+        "isSecret",
+        "dateType",
+        "resourceType",
+    ],
+    boolean: ["editor", "groupCaption", "groupDescription", "nullable"],
+    integer: ["editor", "maximum", "minimum", "unit", "nullable"],
+    object: ["editor", "patternKey", "patternValue", "maxProperties", "minProperties", "nullable"],
+    array: [
+        "editor",
+        "placeholderKey",
+        "placeholderValue",
+        "patternKey",
+        "patternValue",
+        "maxItems",
+        "minItems",
+        "uniqueItems",
+        "nullable",
+        "resourceType",
+    ],
+};
+export function filterValidInputSchemaProperties(schema) {
+    return filterValidSchemaProperties(schema, VALID_INPUT_ROOT_KEYS, VALID_INPUT_PROPERTY_KEYS, VALID_INPUT_PROPERTY_TYPES, VALID_INPUT_PROPERTY_KEYS_BY_TYPE);
+}
+/**
+ * Generates the content of a TypeScript file that exports a function to fill
+ * the default values for the input schema, and the interface for the input
+ * with the default values filled in.
+ */
+export function generateInputDefaultsTSFileContent(inputSchema) {
+    const defaultValues = {};
+    for (const [property, definition] of Object.entries(inputSchema.properties ?? {})) {
+        if ("default" in definition) {
+            defaultValues[property] = definition.default;
+        }
+    }
+    const tsInterfaceSchema = jsonSchemaToTypeScriptInterface(inputSchema);
+    const optionalParamsWithDefaults = {
+        isArray: false,
+        isRequired: true,
+        properties: {},
+    };
+    const requiredParamsWithoutDefaults = [];
+    for (const [key, schema] of Object.entries(tsInterfaceSchema.properties)) {
+        if (!schema.isRequired && key in defaultValues) {
+            optionalParamsWithDefaults.properties[key] = {
+                ...schema,
+                isRequired: true,
+            };
+        }
+        else if (schema.isRequired && !(key in defaultValues)) {
+            requiredParamsWithoutDefaults.push(key);
+        }
+    }
+    return `\
+import { Actor } from "apify";
+import type { Input } from "./input.js";
+
+export const DEFAULT_INPUT_VALUES = ${JSON.stringify(defaultValues, null, "\t")};
+
+export const REQUIRED_INPUT_FIELDS_WITHOUT_DEFAULT = ${JSON.stringify(requiredParamsWithoutDefaults, null, "\t")};
+
+export type InputWithDefaults = Input & ${serializeTypeScriptSchema(optionalParamsWithDefaults)}
+
+export function getInputWithDefaultValues(input?: Input | null): InputWithDefaults {
+	if (Actor.isAtHome()) {
+		// The platform is supposed to fill in the default values
+		return input as InputWithDefaults;
+	}
+${requiredParamsWithoutDefaults.length > 0
+        ? `\
+	if (!input) {
+		throw new Error(\`Input is required, because the following fields are required: $\{REQUIRED_INPUT_FIELDS_WITHOUT_DEFAULT.join(", ")\}\`);
+	}`
+        : ""}
+	return {
+		...DEFAULT_INPUT_VALUES,
+		...(input ?? {} as Input),
+	};
+}
+`;
+}
+export const DATASET_SCHEMA_FIELD = "fields";
+//# sourceMappingURL=apify.js.map

package/dist/apify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apify.js","sourceRoot":"","sources":["../src/apify.ts"],"names":[],"mappings":"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"}

package/dist/configuration.d.ts

@@ -0,0 +1,43 @@
+import type { ArgumentParser } from "argparse";
+import * as zod from "zod/v4";
+declare const INPUTS: readonly ["input", "dataset"];
+declare const OUTPUTS: readonly ["json-schemas", "ts-types"];
+type Input = (typeof INPUTS)[number];
+type Output = (typeof OUTPUTS)[number];
+export interface CommonCLIArgs {
+    input: Input[];
+    output: Output[];
+    src_input: string;
+    src_dataset: string;
+    add_input?: string;
+    add_dataset?: string;
+    input_schema: string;
+    dataset_schema: string;
+    output_ts_dir: string;
+}
+export declare const Configuration: zod.ZodObject<{
+    input: zod.ZodDefault<zod.ZodArray<zod.ZodEnum<{
+        input: "input";
+        dataset: "dataset";
+    }>>>;
+    output: zod.ZodDefault<zod.ZodArray<zod.ZodEnum<{
+        "json-schemas": "json-schemas";
+        "ts-types": "ts-types";
+    }>>>;
+    srcInput: zod.ZodDefault<zod.ZodString>;
+    srcDataset: zod.ZodDefault<zod.ZodString>;
+    addInput: zod.ZodOptional<zod.ZodString>;
+    addDataset: zod.ZodOptional<zod.ZodString>;
+    inputSchema: zod.ZodDefault<zod.ZodString>;
+    datasetSchema: zod.ZodDefault<zod.ZodString>;
+    outputTSDir: zod.ZodDefault<zod.ZodString>;
+}, zod.z.core.$strip>;
+export declare function parseConfigurationFromFileOrDefault(): zod.infer<typeof Configuration>;
+export declare function writeConfigurationToPackageJson(args: CommonCLIArgs): void;
+/**
+ * This function will set as default values the configuration from package.json, or the default one.
+ * In this way, the CLI arguments can override the configuration.
+ */
+export declare function addCommonCLIArgs(parser: ArgumentParser, configuration: zod.infer<typeof Configuration>): void;
+export {};
+//# sourceMappingURL=configuration.d.ts.map

package/dist/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../src/configuration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,GAAG,MAAM,QAAQ,CAAC;AAG9B,QAAA,MAAM,MAAM,+BAAgC,CAAC;AAC7C,QAAA,MAAM,OAAO,uCAAwC,CAAC;AAEtD,KAAK,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AACrC,KAAK,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvC,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;qBAUxB,CAAC;AAEH,wBAAgB,mCAAmC,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAIrF;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAkBzE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,GAAG,IAAI,CA4C7G"}

package/dist/configuration.js

@@ -0,0 +1,87 @@
+import { existsSync } from "node:fs";
+import * as zod from "zod/v4";
+import { readFile, writeFile } from "./filesystem.js";
+const INPUTS = ["input", "dataset"];
+const OUTPUTS = ["json-schemas", "ts-types"];
+export const Configuration = zod.object({
+    input: zod.array(zod.enum(INPUTS)).default([...INPUTS]),
+    output: zod.array(zod.enum(OUTPUTS)).default([...OUTPUTS]),
+    srcInput: zod.string().default("src-schemas/input.json"),
+    srcDataset: zod.string().default("src-schemas/dataset-item.json"),
+    addInput: zod.string().optional(),
+    addDataset: zod.string().optional(),
+    inputSchema: zod.string().default(".actor/input_schema.json"),
+    datasetSchema: zod.string().default(".actor/dataset_schema.json"),
+    outputTSDir: zod.string().default("src/generated"),
+});
+export function parseConfigurationFromFileOrDefault() {
+    const packageJsonContent = existsSync("package.json") ? readFile("package.json") : undefined;
+    const rawConfig = packageJsonContent ? (JSON.parse(packageJsonContent)["apify-schema-tools"] ?? {}) : {};
+    return Configuration.parse(rawConfig);
+}
+export function writeConfigurationToPackageJson(args) {
+    if (!existsSync("package.json")) {
+        throw new Error("package.json does not exist. Please run this command in the root of your project.");
+    }
+    const packageJsonContent = readFile("package.json");
+    const packageJson = JSON.parse(packageJsonContent);
+    packageJson["apify-schema-tools"] = {
+        input: args.input,
+        output: args.output,
+        srcInput: args.src_input,
+        srcDataset: args.src_dataset,
+        addInput: args.add_input,
+        addDataset: args.add_dataset,
+        inputSchema: args.input_schema,
+        datasetSchema: args.dataset_schema,
+        outputTSDir: args.output_ts_dir,
+    };
+    writeFile("package.json", JSON.stringify(packageJson, null, 2));
+}
+/**
+ * This function will set as default values the configuration from package.json, or the default one.
+ * In this way, the CLI arguments can override the configuration.
+ */
+export function addCommonCLIArgs(parser, configuration) {
+    parser.add_argument("-i", "--input", {
+        help: "specify which sources to use for generation",
+        choices: [...INPUTS],
+        default: configuration.input,
+        nargs: "*",
+    });
+    parser.add_argument("-o", "--output", {
+        help: "specify what to generate",
+        choices: [...OUTPUTS],
+        default: configuration.output,
+        nargs: "*",
+    });
+    parser.add_argument("--src-input", {
+        help: "path to the input schema source file",
+        default: configuration.srcInput,
+    });
+    parser.add_argument("--src-dataset", {
+        help: "path to the dataset schema source file",
+        default: configuration.srcDataset,
+    });
+    parser.add_argument("--add-input", {
+        help: "path to an additional schema to merge into the input schema",
+        default: configuration.addInput,
+    });
+    parser.add_argument("--add-dataset", {
+        help: "path to an additional schema to merge into the dataset schema",
+        default: configuration.addDataset,
+    });
+    parser.add_argument("--input-schema", {
+        help: "the path of the destination input schema file",
+        default: configuration.inputSchema,
+    });
+    parser.add_argument("--dataset-schema", {
+        help: "the path of the destination dataset schema file",
+        default: configuration.datasetSchema,
+    });
+    parser.add_argument("--output-ts-dir", {
+        help: "path where to save generated TypeScript files",
+        default: configuration.outputTSDir,
+    });
+}
+//# sourceMappingURL=configuration.js.map

package/dist/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../src/configuration.ts"],"names":[],"mappings":"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"}

package/dist/filesystem.d.ts

@@ -0,0 +1,8 @@
+export declare function readFile(filePath: string): string;
+/**
+ * Writes content to a file, creating the directory structure if it doesn't exist.
+ * @param filePath - The path to the file to write.
+ * @param content - The content to write to the file.
+ */
+export declare function writeFile(filePath: string, content: string): void;
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../src/filesystem.ts"],"names":[],"mappings":"AAKA,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGjE"}

package/dist/filesystem.js

@@ -0,0 +1,16 @@
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+const DEFAULT_ENCODING = "utf-8";
+export function readFile(filePath) {
+    return readFileSync(filePath, DEFAULT_ENCODING);
+}
+/**
+ * Writes content to a file, creating the directory structure if it doesn't exist.
+ * @param filePath - The path to the file to write.
+ * @param content - The content to write to the file.
+ */
+export function writeFile(filePath, content) {
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, content, DEFAULT_ENCODING);
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../src/filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,gBAAgB,GAAmB,OAAO,CAAC;AAEjD,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACxC,OAAO,YAAY,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IAC1D,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;AACpD,CAAC"}

package/dist/json-schemas.d.ts

@@ -0,0 +1,34 @@
+import type { JSONSchema4 } from "json-schema";
+type SchemaProperty = JSONSchema4 & {
+    position?: number;
+};
+export interface ArraySchema extends JSONSchema4 {
+    type: "array";
+}
+export declare function isArraySchema(schema: JSONSchema4): schema is ArraySchema;
+export interface ObjectSchema extends JSONSchema4 {
+    type: "object";
+    properties?: Record<string, SchemaProperty>;
+    required?: string[];
+}
+export declare function isObjectSchema(schema: JSONSchema4): schema is ObjectSchema;
+/**
+ * Schemas are expected to be of type object at the root level.
+ */
+export declare function readJsonSchema(filePath: string): ObjectSchema;
+/**
+ * Schemas are expected to be of type object at the root level.
+ */
+export declare function writeJsonSchema(filePath: string, schema: ObjectSchema): void;
+export declare function readJsonSchemaField(filePath: string, fieldName: string): ObjectSchema;
+export declare function writeSchemaToField(filePath: string, schema: ObjectSchema, fieldName: string): void;
+export declare function filterValidSchemaProperties(schema: ObjectSchema, validRootKeys: string[], validPropertyKeys: string[], validPropertyTypes: string[], validPropertyKeysByType: Record<string, string[]>): ObjectSchema;
+export declare function mergeObjectSchemas(baseSchema: ObjectSchema, additionalSchema: ObjectSchema, deep?: boolean): ObjectSchema;
+export declare function compareSchemas(a: ObjectSchema, b: ObjectSchema, ignoreDescriptions?: boolean): boolean;
+/**
+ * Compare descriptions of source and output schemas.
+ * Ignore properties that were removed from the source schema, or that were added to the source schema.
+ */
+export declare function compareDescriptions(sourceSchema: JSONSchema4, outputSchema: JSONSchema4): boolean;
+export {};
+//# sourceMappingURL=json-schemas.d.ts.map

package/dist/json-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schemas.d.ts","sourceRoot":"","sources":["../src/json-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,KAAK,cAAc,GAAG,WAAW,GAAG;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAQF,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,OAAO,CAAC;CACd;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,IAAI,WAAW,CAExE;AAED,MAAM,WAAW,YAAa,SAAQ,WAAW;IAChD,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,IAAI,YAAY,CAE1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAE7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAE5E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CASrF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAIlG;AAID,wBAAgB,2BAA2B,CAC1C,MAAM,EAAE,YAAY,EACpB,aAAa,EAAE,MAAM,EAAE,EACvB,iBAAiB,EAAE,MAAM,EAAE,EAC3B,kBAAkB,EAAE,MAAM,EAAE,EAC5B,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAC/C,YAAY,CAyBd;AAyCD,wBAAgB,kBAAkB,CACjC,UAAU,EAAE,YAAY,EACxB,gBAAgB,EAAE,YAAY,EAC9B,IAAI,UAAO,GACT,YAAY,CAmDd;AAwBD,wBAAgB,cAAc,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,EAAE,kBAAkB,CAAC,EAAE,OAAO,GAAG,OAAO,CAKtG;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,GAAG,OAAO,CAwBjG"}