@powerlines/schema 0.11.22 → 0.11.24

package/dist/helpers.cjs

@@ -0,0 +1,54 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_type_checks = require('./type-checks.cjs');
+let defu = require("defu");
+let _stryke_type_checks = require("@stryke/type-checks");
+
+//#region src/helpers.ts
+/**
+* A helper function to extract the properties from a JTD object schema. This function takes an {@link ObjectSchema} as input and returns a record of its properties, where each key is the property name and the value is the corresponding JTD schema type along with an `optional` flag indicating whether the property is optional (i.e., defined in `optionalProperties`) or required (i.e., defined in `properties`). The function checks both `properties` and `optionalProperties` of the JTD schema to construct the resulting record.
+*
+* @param obj - The {@link ObjectSchema} from which to extract the properties.
+* @returns A record of the properties defined in the JTD object schema, where each key is the property name and the value is an object containing the JTD schema type and an `optional` flag.
+*/
+function getProperties(obj) {
+	const properties = {};
+	const schema = require_type_checks.isObjectSchema(obj) ? obj.schema : obj;
+	if ("optionalProperties" in schema && (0, _stryke_type_checks.isSetObject)(schema.optionalProperties)) for (const [key, value] of Object.entries(schema.optionalProperties)) properties[key] = {
+		...value,
+		name: key,
+		optional: true
+	};
+	if ("properties" in schema && (0, _stryke_type_checks.isSetObject)(schema.properties)) for (const [key, value] of Object.entries(schema.properties)) properties[key] = {
+		...value,
+		name: key,
+		optional: false
+	};
+	return properties;
+}
+/**
+* Merges multiple JTD object schemas into a single schema. This function takes an array of JTD object schemas (either {@link JTDSchemaObjectType} or {@link ObjectSchema}) and combines their properties into a single JTD object schema. The resulting schema will contain all properties from the input schemas, with optional properties marked accordingly. If there are overlapping properties between the input schemas, the function will merge them using a deep merge strategy (via `defu`) if they are both JTD object schemas; otherwise, the property from the first schema in the input array will take precedence.
+*
+* @remarks
+* This function attempts to mimic {@link defu}'s behavior for merging objects, but with special handling for JTD schemas. When merging properties, if a property exists in multiple input schemas and is defined as a JTD object schema in all of them, the function will perform a deep merge of those schemas. If the property is not a JTD object schema in any of the input schemas, the function will simply take the first definition it encounters.
+*
+* @param schemas - An array of JTD object schemas to merge.
+* @returns A single JTD object schema that combines the properties of all input schemas.
+*/
+function mergeSchemas(...schemas) {
+	const mergedSchema = {
+		properties: {},
+		optionalProperties: {},
+		additionalProperties: false
+	};
+	for (const schema of schemas.reverse()) {
+		const properties = getProperties(schema);
+		for (const [key, value] of Object.entries(properties)) if (value.optional) mergedSchema.optionalProperties[key] = mergedSchema.optionalProperties[key] && require_type_checks.isJTDSchemaObject(mergedSchema.optionalProperties[key]) && require_type_checks.isJTDSchemaObject(value) ? (0, defu.defu)(mergedSchema.optionalProperties[key], value) : value;
+		else mergedSchema.properties[key] = mergedSchema.properties[key] && require_type_checks.isJTDSchemaObject(mergedSchema.properties[key]) && require_type_checks.isJTDSchemaObject(value) ? (0, defu.defu)(mergedSchema.properties[key], value) : value;
+	}
+	return mergedSchema;
+}
+
+//#endregion
+exports.getProperties = getProperties;
+exports.mergeSchemas = mergeSchemas;

package/dist/helpers.d.cts

@@ -0,0 +1,26 @@
+import { JTDSchemaObjectType, JTDSchemaType, ObjectSchema, SchemaMetadata } from "./types.cjs";
+
+//#region src/helpers.d.ts
+/**
+ * A helper function to extract the properties from a JTD object schema. This function takes an {@link ObjectSchema} as input and returns a record of its properties, where each key is the property name and the value is the corresponding JTD schema type along with an `optional` flag indicating whether the property is optional (i.e., defined in `optionalProperties`) or required (i.e., defined in `properties`). The function checks both `properties` and `optionalProperties` of the JTD schema to construct the resulting record.
+ *
+ * @param obj - The {@link ObjectSchema} from which to extract the properties.
+ * @returns A record of the properties defined in the JTD object schema, where each key is the property name and the value is an object containing the JTD schema type and an `optional` flag.
+ */
+declare function getProperties<TMetadata extends SchemaMetadata>(obj: ObjectSchema<TMetadata> | JTDSchemaObjectType<TMetadata>): Record<string, JTDSchemaType<TMetadata> & {
+  name: string;
+  optional: boolean;
+}>;
+/**
+ * Merges multiple JTD object schemas into a single schema. This function takes an array of JTD object schemas (either {@link JTDSchemaObjectType} or {@link ObjectSchema}) and combines their properties into a single JTD object schema. The resulting schema will contain all properties from the input schemas, with optional properties marked accordingly. If there are overlapping properties between the input schemas, the function will merge them using a deep merge strategy (via `defu`) if they are both JTD object schemas; otherwise, the property from the first schema in the input array will take precedence.
+ *
+ * @remarks
+ * This function attempts to mimic {@link defu}'s behavior for merging objects, but with special handling for JTD schemas. When merging properties, if a property exists in multiple input schemas and is defined as a JTD object schema in all of them, the function will perform a deep merge of those schemas. If the property is not a JTD object schema in any of the input schemas, the function will simply take the first definition it encounters.
+ *
+ * @param schemas - An array of JTD object schemas to merge.
+ * @returns A single JTD object schema that combines the properties of all input schemas.
+ */
+declare function mergeSchemas<TMetadata extends SchemaMetadata>(...schemas: (JTDSchemaObjectType<TMetadata> | ObjectSchema<TMetadata>)[]): JTDSchemaObjectType<TMetadata>;
+//#endregion
+export { getProperties, mergeSchemas };
+//# sourceMappingURL=helpers.d.cts.map

package/dist/helpers.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.cts","names":[],"sources":["../src/helpers.ts"],"mappings":";;;;;AAkCA;;;;iBAAgB,aAAA,mBAAgC,cAAA,CAAA,CAC9C,GAAA,EAAK,YAAA,CAAa,SAAA,IAAa,mBAAA,CAAoB,SAAA,IAClD,MAAA,SAED,aAAA,CAAc,SAAA;EAAe,IAAA;EAAc,QAAA;AAAA;;;;;;;;;;iBAmC7B,YAAA,mBAA+B,cAAA,CAAA,CAAA,GAC1C,OAAA,GAAU,mBAAA,CAAoB,SAAA,IAAa,YAAA,CAAa,SAAA,OAC1D,mBAAA,CAAoB,SAAA"}

package/dist/helpers.d.mts

@@ -0,0 +1,26 @@
+import { JTDSchemaObjectType, JTDSchemaType, ObjectSchema, SchemaMetadata } from "./types.mjs";
+
+//#region src/helpers.d.ts
+/**
+ * A helper function to extract the properties from a JTD object schema. This function takes an {@link ObjectSchema} as input and returns a record of its properties, where each key is the property name and the value is the corresponding JTD schema type along with an `optional` flag indicating whether the property is optional (i.e., defined in `optionalProperties`) or required (i.e., defined in `properties`). The function checks both `properties` and `optionalProperties` of the JTD schema to construct the resulting record.
+ *
+ * @param obj - The {@link ObjectSchema} from which to extract the properties.
+ * @returns A record of the properties defined in the JTD object schema, where each key is the property name and the value is an object containing the JTD schema type and an `optional` flag.
+ */
+declare function getProperties<TMetadata extends SchemaMetadata>(obj: ObjectSchema<TMetadata> | JTDSchemaObjectType<TMetadata>): Record<string, JTDSchemaType<TMetadata> & {
+  name: string;
+  optional: boolean;
+}>;
+/**
+ * Merges multiple JTD object schemas into a single schema. This function takes an array of JTD object schemas (either {@link JTDSchemaObjectType} or {@link ObjectSchema}) and combines their properties into a single JTD object schema. The resulting schema will contain all properties from the input schemas, with optional properties marked accordingly. If there are overlapping properties between the input schemas, the function will merge them using a deep merge strategy (via `defu`) if they are both JTD object schemas; otherwise, the property from the first schema in the input array will take precedence.
+ *
+ * @remarks
+ * This function attempts to mimic {@link defu}'s behavior for merging objects, but with special handling for JTD schemas. When merging properties, if a property exists in multiple input schemas and is defined as a JTD object schema in all of them, the function will perform a deep merge of those schemas. If the property is not a JTD object schema in any of the input schemas, the function will simply take the first definition it encounters.
+ *
+ * @param schemas - An array of JTD object schemas to merge.
+ * @returns A single JTD object schema that combines the properties of all input schemas.
+ */
+declare function mergeSchemas<TMetadata extends SchemaMetadata>(...schemas: (JTDSchemaObjectType<TMetadata> | ObjectSchema<TMetadata>)[]): JTDSchemaObjectType<TMetadata>;
+//#endregion
+export { getProperties, mergeSchemas };
+//# sourceMappingURL=helpers.d.mts.map

package/dist/helpers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.mts","names":[],"sources":["../src/helpers.ts"],"mappings":";;;;;AAkCA;;;;iBAAgB,aAAA,mBAAgC,cAAA,CAAA,CAC9C,GAAA,EAAK,YAAA,CAAa,SAAA,IAAa,mBAAA,CAAoB,SAAA,IAClD,MAAA,SAED,aAAA,CAAc,SAAA;EAAe,IAAA;EAAc,QAAA;AAAA;;;;;;;;;;iBAmC7B,YAAA,mBAA+B,cAAA,CAAA,CAAA,GAC1C,OAAA,GAAU,mBAAA,CAAoB,SAAA,IAAa,YAAA,CAAa,SAAA,OAC1D,mBAAA,CAAoB,SAAA"}

package/dist/helpers.mjs

@@ -0,0 +1,52 @@
+import { isJTDSchemaObject, isObjectSchema } from "./type-checks.mjs";
+import { defu as defu$1 } from "defu";
+import { isSetObject } from "@stryke/type-checks";
+
+//#region src/helpers.ts
+/**
+* A helper function to extract the properties from a JTD object schema. This function takes an {@link ObjectSchema} as input and returns a record of its properties, where each key is the property name and the value is the corresponding JTD schema type along with an `optional` flag indicating whether the property is optional (i.e., defined in `optionalProperties`) or required (i.e., defined in `properties`). The function checks both `properties` and `optionalProperties` of the JTD schema to construct the resulting record.
+*
+* @param obj - The {@link ObjectSchema} from which to extract the properties.
+* @returns A record of the properties defined in the JTD object schema, where each key is the property name and the value is an object containing the JTD schema type and an `optional` flag.
+*/
+function getProperties(obj) {
+	const properties = {};
+	const schema = isObjectSchema(obj) ? obj.schema : obj;
+	if ("optionalProperties" in schema && isSetObject(schema.optionalProperties)) for (const [key, value] of Object.entries(schema.optionalProperties)) properties[key] = {
+		...value,
+		name: key,
+		optional: true
+	};
+	if ("properties" in schema && isSetObject(schema.properties)) for (const [key, value] of Object.entries(schema.properties)) properties[key] = {
+		...value,
+		name: key,
+		optional: false
+	};
+	return properties;
+}
+/**
+* Merges multiple JTD object schemas into a single schema. This function takes an array of JTD object schemas (either {@link JTDSchemaObjectType} or {@link ObjectSchema}) and combines their properties into a single JTD object schema. The resulting schema will contain all properties from the input schemas, with optional properties marked accordingly. If there are overlapping properties between the input schemas, the function will merge them using a deep merge strategy (via `defu`) if they are both JTD object schemas; otherwise, the property from the first schema in the input array will take precedence.
+*
+* @remarks
+* This function attempts to mimic {@link defu}'s behavior for merging objects, but with special handling for JTD schemas. When merging properties, if a property exists in multiple input schemas and is defined as a JTD object schema in all of them, the function will perform a deep merge of those schemas. If the property is not a JTD object schema in any of the input schemas, the function will simply take the first definition it encounters.
+*
+* @param schemas - An array of JTD object schemas to merge.
+* @returns A single JTD object schema that combines the properties of all input schemas.
+*/
+function mergeSchemas(...schemas) {
+	const mergedSchema = {
+		properties: {},
+		optionalProperties: {},
+		additionalProperties: false
+	};
+	for (const schema of schemas.reverse()) {
+		const properties = getProperties(schema);
+		for (const [key, value] of Object.entries(properties)) if (value.optional) mergedSchema.optionalProperties[key] = mergedSchema.optionalProperties[key] && isJTDSchemaObject(mergedSchema.optionalProperties[key]) && isJTDSchemaObject(value) ? defu$1(mergedSchema.optionalProperties[key], value) : value;
+		else mergedSchema.properties[key] = mergedSchema.properties[key] && isJTDSchemaObject(mergedSchema.properties[key]) && isJTDSchemaObject(value) ? defu$1(mergedSchema.properties[key], value) : value;
+	}
+	return mergedSchema;
+}
+
+//#endregion
+export { getProperties, mergeSchemas };
+//# sourceMappingURL=helpers.mjs.map

package/dist/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.mjs","names":["defu"],"sources":["../src/helpers.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isSetObject } from \"@stryke/type-checks\";\nimport { defu } from \"defu\";\nimport { isJTDSchemaObject, isObjectSchema } from \"./type-checks\";\nimport {\n  JTDSchemaObjectType,\n  JTDSchemaType,\n  ObjectSchema,\n  SchemaMetadata\n} from \"./types\";\n\n/**\n * A helper function to extract the properties from a JTD object schema. This function takes an {@link ObjectSchema} as input and returns a record of its properties, where each key is the property name and the value is the corresponding JTD schema type along with an `optional` flag indicating whether the property is optional (i.e., defined in `optionalProperties`) or required (i.e., defined in `properties`). The function checks both `properties` and `optionalProperties` of the JTD schema to construct the resulting record.\n *\n * @param obj - The {@link ObjectSchema} from which to extract the properties.\n * @returns A record of the properties defined in the JTD object schema, where each key is the property name and the value is an object containing the JTD schema type and an `optional` flag.\n */\nexport function getProperties<TMetadata extends SchemaMetadata>(\n  obj: ObjectSchema<TMetadata> | JTDSchemaObjectType<TMetadata>\n): Record<\n  string,\n  JTDSchemaType<TMetadata> & { name: string; optional: boolean }\n> {\n  const properties: Record<\n    string,\n    JTDSchemaType<TMetadata> & { name: string; optional: boolean }\n  > = {};\n\n  const schema = isObjectSchema(obj) ? obj.schema : obj;\n  if (\n    \"optionalProperties\" in schema &&\n    isSetObject(schema.optionalProperties)\n  ) {\n    for (const [key, value] of Object.entries(schema.optionalProperties)) {\n      properties[key] = { ...value, name: key, optional: true };\n    }\n  }\n\n  if (\"properties\" in schema && isSetObject(schema.properties)) {\n    for (const [key, value] of Object.entries(schema.properties)) {\n      properties[key] = { ...value, name: key, optional: false };\n    }\n  }\n\n  return properties;\n}\n\n/**\n * Merges multiple JTD object schemas into a single schema. This function takes an array of JTD object schemas (either {@link JTDSchemaObjectType} or {@link ObjectSchema}) and combines their properties into a single JTD object schema. The resulting schema will contain all properties from the input schemas, with optional properties marked accordingly. If there are overlapping properties between the input schemas, the function will merge them using a deep merge strategy (via `defu`) if they are both JTD object schemas; otherwise, the property from the first schema in the input array will take precedence.\n *\n * @remarks\n * This function attempts to mimic {@link defu}'s behavior for merging objects, but with special handling for JTD schemas. When merging properties, if a property exists in multiple input schemas and is defined as a JTD object schema in all of them, the function will perform a deep merge of those schemas. If the property is not a JTD object schema in any of the input schemas, the function will simply take the first definition it encounters.\n *\n * @param schemas - An array of JTD object schemas to merge.\n * @returns A single JTD object schema that combines the properties of all input schemas.\n */\nexport function mergeSchemas<TMetadata extends SchemaMetadata>(\n  ...schemas: (JTDSchemaObjectType<TMetadata> | ObjectSchema<TMetadata>)[]\n): JTDSchemaObjectType<TMetadata> {\n  const mergedSchema = {\n    properties: {},\n    optionalProperties: {},\n    additionalProperties: false\n  } as JTDSchemaObjectType<TMetadata>;\n  for (const schema of schemas.reverse()) {\n    const properties = getProperties(schema);\n    for (const [key, value] of Object.entries(properties)) {\n      if (value.optional) {\n        mergedSchema.optionalProperties![key] = (\n          mergedSchema.optionalProperties![key] &&\n          isJTDSchemaObject(mergedSchema.optionalProperties![key]) &&\n          isJTDSchemaObject(value)\n            ? defu(mergedSchema.optionalProperties![key], value)\n            : value\n        ) as JTDSchemaType<TMetadata>;\n      } else {\n        mergedSchema.properties![key] = (\n          mergedSchema.properties![key] &&\n          isJTDSchemaObject(mergedSchema.properties![key]) &&\n          isJTDSchemaObject(value)\n            ? defu(mergedSchema.properties![key], value)\n            : value\n        ) as JTDSchemaType<TMetadata>;\n      }\n    }\n  }\n\n  return mergedSchema;\n}\n"],"mappings":";;;;;;;;;;;AAkCA,SAAgB,cACd,KAIA;CACA,MAAM,aAGF,CAAC;CAEL,MAAM,SAAS,eAAe,GAAG,IAAI,IAAI,SAAS;CAClD,IACE,wBAAwB,UACxB,YAAY,OAAO,kBAAkB,GAErC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,kBAAkB,GACjE,WAAW,OAAO;EAAE,GAAG;EAAO,MAAM;EAAK,UAAU;CAAK;CAI5D,IAAI,gBAAgB,UAAU,YAAY,OAAO,UAAU,GACzD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,UAAU,GACzD,WAAW,OAAO;EAAE,GAAG;EAAO,MAAM;EAAK,UAAU;CAAM;CAI7D,OAAO;AACT;;;;;;;;;;AAWA,SAAgB,aACd,GAAG,SAC6B;CAChC,MAAM,eAAe;EACnB,YAAY,CAAC;EACb,oBAAoB,CAAC;EACrB,sBAAsB;CACxB;CACA,KAAK,MAAM,UAAU,QAAQ,QAAQ,GAAG;EACtC,MAAM,aAAa,cAAc,MAAM;EACvC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,UAAU,GAClD,IAAI,MAAM,UACR,aAAa,mBAAoB,OAC/B,aAAa,mBAAoB,QACjC,kBAAkB,aAAa,mBAAoB,IAAI,KACvD,kBAAkB,KAAK,IACnBA,OAAK,aAAa,mBAAoB,MAAM,KAAK,IACjD;OAGN,aAAa,WAAY,OACvB,aAAa,WAAY,QACzB,kBAAkB,aAAa,WAAY,IAAI,KAC/C,kBAAkB,KAAK,IACnBA,OAAK,aAAa,WAAY,MAAM,KAAK,IACzC;CAIZ;CAEA,OAAO;AACT"}

package/dist/index.cjs

@@ -1,12 +1,16 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_bundle = require('./bundle.cjs');
+const require_type_checks = require('./type-checks.cjs');
+const require_helpers = require('./helpers.cjs');
 const require_codegen = require('./codegen.cjs');
+const require_constants = require('./constants.cjs');
 const require_jtd = require('./jtd.cjs');
+const require_persistence = require('./persistence.cjs');
 const require_reflection = require('./reflection.cjs');
 const require_resolve = require('./resolve.cjs');
-const require_type_checks = require('./type-checks.cjs');
 const require_extract = require('./extract.cjs');
 
+exports.JTDTypes = require_constants.JTDTypes;
 exports.bundle = require_bundle.bundle;
 exports.extract = require_extract.extract;
 exports.extractHash = require_extract.extractHash;
@@ -18,13 +22,24 @@ exports.extractSchemaSchema = require_extract.extractSchemaSchema;
 exports.extractSource = require_extract.extractSource;
 exports.extractVariant = require_extract.extractVariant;
 exports.generateCode = require_codegen.generateCode;
+exports.getCacheDirectory = require_persistence.getCacheDirectory;
+exports.getCacheFilePath = require_persistence.getCacheFilePath;
+exports.getProperties = require_helpers.getProperties;
 exports.isExtractedSchema = require_type_checks.isExtractedSchema;
 exports.isJTDSchema = require_type_checks.isJTDSchema;
+exports.isJTDSchemaObject = require_type_checks.isJTDSchemaObject;
+exports.isObjectSchema = require_type_checks.isObjectSchema;
 exports.isSchema = require_type_checks.isSchema;
 exports.isUntypedInput = require_type_checks.isUntypedInput;
 exports.isUntypedSchema = require_type_checks.isUntypedSchema;
 exports.jsonSchemaToJtd = require_jtd.jsonSchemaToJtd;
+exports.mergeSchemas = require_helpers.mergeSchemas;
+exports.readSchema = require_persistence.readSchema;
+exports.readSchemaSafe = require_persistence.readSchemaSafe;
 exports.reflectionToJsonSchema = require_reflection.reflectionToJsonSchema;
 exports.resolve = require_resolve.resolve;
 exports.resolveModule = require_resolve.resolveModule;
-exports.resolveReflection = require_resolve.resolveReflection;
+exports.resolveReflection = require_resolve.resolveReflection;
+exports.stringifyType = require_codegen.stringifyType;
+exports.stringifyValue = require_codegen.stringifyValue;
+exports.writeSchema = require_persistence.writeSchema;

package/dist/index.d.cts

@@ -1,9 +1,12 @@
 import { BundleOptions, bundle } from "./bundle.cjs";
-import { generateCode } from "./codegen.cjs";
-import { BaseSchemaSource, ExtractedSchema, JTDNumberType, JTDSchemaSchemaSource, JTDSchemaType, JTDStringType, JTDType, JsonSchemaLike, JsonSchemaSchemaSource, ReflectionSchemaSource, Schema, SchemaInput, SchemaInputVariant, SchemaMetadata, SchemaSource, SchemaSourceInput, SchemaSourceVariant, StandardSchemaSchemaSource, TypeDefinitionReference, UntypedInputObject, UntypedSchema, UntypedSchemaSource, Zod3SchemaSource } from "./types.cjs";
+import { BaseSchemaSource, ExtractedSchema, JTDNumberType, JTDSchemaObjectForm, JTDSchemaObjectType, JTDSchemaSchemaSource, JTDSchemaType, JTDStringType, JTDType, JsonSchemaLike, JsonSchemaSchemaSource, ObjectSchema, ReflectionSchemaSource, Schema, SchemaInput, SchemaInputVariant, SchemaMetadata, SchemaSource, SchemaSourceInput, SchemaSourceVariant, StandardSchemaSchemaSource, TypeDefinitionReference, UntypedInputObject, UntypedSchema, UntypedSchemaSource, Zod3SchemaSource } from "./types.cjs";
+import { generateCode, stringifyType, stringifyValue } from "./codegen.cjs";
+import { JTDTypes } from "./constants.cjs";
 import { extract, extractHash, extractJsonSchema, extractReflection, extractResolvedVariant, extractSchema, extractSchemaSchema, extractSource, extractVariant } from "./extract.cjs";
+import { getProperties, mergeSchemas } from "./helpers.cjs";
 import { jsonSchemaToJtd } from "./jtd.cjs";
+import { getCacheDirectory, getCacheFilePath, readSchema, readSchemaSafe, writeSchema } from "./persistence.cjs";
 import { reflectionToJsonSchema } from "./reflection.cjs";
 import { resolve, resolveModule, resolveReflection } from "./resolve.cjs";
-import { isExtractedSchema, isJTDSchema, isSchema, isUntypedInput, isUntypedSchema } from "./type-checks.cjs";
-export { BaseSchemaSource, BundleOptions, ExtractedSchema, JTDNumberType, JTDSchemaSchemaSource, JTDSchemaType, JTDStringType, JTDType, JsonSchemaLike, JsonSchemaSchemaSource, ReflectionSchemaSource, Schema, SchemaInput, SchemaInputVariant, SchemaMetadata, SchemaSource, SchemaSourceInput, SchemaSourceVariant, StandardSchemaSchemaSource, TypeDefinitionReference, UntypedInputObject, UntypedSchema, UntypedSchemaSource, Zod3SchemaSource, bundle, extract, extractHash, extractJsonSchema, extractReflection, extractResolvedVariant, extractSchema, extractSchemaSchema, extractSource, extractVariant, generateCode, isExtractedSchema, isJTDSchema, isSchema, isUntypedInput, isUntypedSchema, jsonSchemaToJtd, reflectionToJsonSchema, resolve, resolveModule, resolveReflection };
+import { isExtractedSchema, isJTDSchema, isJTDSchemaObject, isObjectSchema, isSchema, isUntypedInput, isUntypedSchema } from "./type-checks.cjs";
+export { BaseSchemaSource, BundleOptions, ExtractedSchema, JTDNumberType, JTDSchemaObjectForm, JTDSchemaObjectType, JTDSchemaSchemaSource, JTDSchemaType, JTDStringType, JTDType, JTDTypes, JsonSchemaLike, JsonSchemaSchemaSource, ObjectSchema, ReflectionSchemaSource, Schema, SchemaInput, SchemaInputVariant, SchemaMetadata, SchemaSource, SchemaSourceInput, SchemaSourceVariant, StandardSchemaSchemaSource, TypeDefinitionReference, UntypedInputObject, UntypedSchema, UntypedSchemaSource, Zod3SchemaSource, bundle, extract, extractHash, extractJsonSchema, extractReflection, extractResolvedVariant, extractSchema, extractSchemaSchema, extractSource, extractVariant, generateCode, getCacheDirectory, getCacheFilePath, getProperties, isExtractedSchema, isJTDSchema, isJTDSchemaObject, isObjectSchema, isSchema, isUntypedInput, isUntypedSchema, jsonSchemaToJtd, mergeSchemas, readSchema, readSchemaSafe, reflectionToJsonSchema, resolve, resolveModule, resolveReflection, stringifyType, stringifyValue, writeSchema };

package/dist/index.d.mts

@@ -1,9 +1,12 @@
 import { BundleOptions, bundle } from "./bundle.mjs";
-import { generateCode } from "./codegen.mjs";
-import { BaseSchemaSource, ExtractedSchema, JTDNumberType, JTDSchemaSchemaSource, JTDSchemaType, JTDStringType, JTDType, JsonSchemaLike, JsonSchemaSchemaSource, ReflectionSchemaSource, Schema, SchemaInput, SchemaInputVariant, SchemaMetadata, SchemaSource, SchemaSourceInput, SchemaSourceVariant, StandardSchemaSchemaSource, TypeDefinitionReference, UntypedInputObject, UntypedSchema, UntypedSchemaSource, Zod3SchemaSource } from "./types.mjs";
+import { BaseSchemaSource, ExtractedSchema, JTDNumberType, JTDSchemaObjectForm, JTDSchemaObjectType, JTDSchemaSchemaSource, JTDSchemaType, JTDStringType, JTDType, JsonSchemaLike, JsonSchemaSchemaSource, ObjectSchema, ReflectionSchemaSource, Schema, SchemaInput, SchemaInputVariant, SchemaMetadata, SchemaSource, SchemaSourceInput, SchemaSourceVariant, StandardSchemaSchemaSource, TypeDefinitionReference, UntypedInputObject, UntypedSchema, UntypedSchemaSource, Zod3SchemaSource } from "./types.mjs";
+import { generateCode, stringifyType, stringifyValue } from "./codegen.mjs";
+import { JTDTypes } from "./constants.mjs";
 import { extract, extractHash, extractJsonSchema, extractReflection, extractResolvedVariant, extractSchema, extractSchemaSchema, extractSource, extractVariant } from "./extract.mjs";
+import { getProperties, mergeSchemas } from "./helpers.mjs";
 import { jsonSchemaToJtd } from "./jtd.mjs";
+import { getCacheDirectory, getCacheFilePath, readSchema, readSchemaSafe, writeSchema } from "./persistence.mjs";
 import { reflectionToJsonSchema } from "./reflection.mjs";
 import { resolve, resolveModule, resolveReflection } from "./resolve.mjs";
-import { isExtractedSchema, isJTDSchema, isSchema, isUntypedInput, isUntypedSchema } from "./type-checks.mjs";
-export { BaseSchemaSource, BundleOptions, ExtractedSchema, JTDNumberType, JTDSchemaSchemaSource, JTDSchemaType, JTDStringType, JTDType, JsonSchemaLike, JsonSchemaSchemaSource, ReflectionSchemaSource, Schema, SchemaInput, SchemaInputVariant, SchemaMetadata, SchemaSource, SchemaSourceInput, SchemaSourceVariant, StandardSchemaSchemaSource, TypeDefinitionReference, UntypedInputObject, UntypedSchema, UntypedSchemaSource, Zod3SchemaSource, bundle, extract, extractHash, extractJsonSchema, extractReflection, extractResolvedVariant, extractSchema, extractSchemaSchema, extractSource, extractVariant, generateCode, isExtractedSchema, isJTDSchema, isSchema, isUntypedInput, isUntypedSchema, jsonSchemaToJtd, reflectionToJsonSchema, resolve, resolveModule, resolveReflection };
+import { isExtractedSchema, isJTDSchema, isJTDSchemaObject, isObjectSchema, isSchema, isUntypedInput, isUntypedSchema } from "./type-checks.mjs";
+export { BaseSchemaSource, BundleOptions, ExtractedSchema, JTDNumberType, JTDSchemaObjectForm, JTDSchemaObjectType, JTDSchemaSchemaSource, JTDSchemaType, JTDStringType, JTDType, JTDTypes, JsonSchemaLike, JsonSchemaSchemaSource, ObjectSchema, ReflectionSchemaSource, Schema, SchemaInput, SchemaInputVariant, SchemaMetadata, SchemaSource, SchemaSourceInput, SchemaSourceVariant, StandardSchemaSchemaSource, TypeDefinitionReference, UntypedInputObject, UntypedSchema, UntypedSchemaSource, Zod3SchemaSource, bundle, extract, extractHash, extractJsonSchema, extractReflection, extractResolvedVariant, extractSchema, extractSchemaSchema, extractSource, extractVariant, generateCode, getCacheDirectory, getCacheFilePath, getProperties, isExtractedSchema, isJTDSchema, isJTDSchemaObject, isObjectSchema, isSchema, isUntypedInput, isUntypedSchema, jsonSchemaToJtd, mergeSchemas, readSchema, readSchemaSafe, reflectionToJsonSchema, resolve, resolveModule, resolveReflection, stringifyType, stringifyValue, writeSchema };

package/dist/index.mjs

@@ -1,9 +1,12 @@
 import { bundle } from "./bundle.mjs";
-import { generateCode } from "./codegen.mjs";
+import { isExtractedSchema, isJTDSchema, isJTDSchemaObject, isObjectSchema, isSchema, isUntypedInput, isUntypedSchema } from "./type-checks.mjs";
+import { getProperties, mergeSchemas } from "./helpers.mjs";
+import { generateCode, stringifyType, stringifyValue } from "./codegen.mjs";
+import { JTDTypes } from "./constants.mjs";
 import { jsonSchemaToJtd } from "./jtd.mjs";
+import { getCacheDirectory, getCacheFilePath, readSchema, readSchemaSafe, writeSchema } from "./persistence.mjs";
 import { reflectionToJsonSchema } from "./reflection.mjs";
 import { resolve, resolveModule, resolveReflection } from "./resolve.mjs";
-import { isExtractedSchema, isJTDSchema, isSchema, isUntypedInput, isUntypedSchema } from "./type-checks.mjs";
 import { extract, extractHash, extractJsonSchema, extractReflection, extractResolvedVariant, extractSchema, extractSchemaSchema, extractSource, extractVariant } from "./extract.mjs";
 
-export { bundle, extract, extractHash, extractJsonSchema, extractReflection, extractResolvedVariant, extractSchema, extractSchemaSchema, extractSource, extractVariant, generateCode, isExtractedSchema, isJTDSchema, isSchema, isUntypedInput, isUntypedSchema, jsonSchemaToJtd, reflectionToJsonSchema, resolve, resolveModule, resolveReflection };
+export { JTDTypes, bundle, extract, extractHash, extractJsonSchema, extractReflection, extractResolvedVariant, extractSchema, extractSchemaSchema, extractSource, extractVariant, generateCode, getCacheDirectory, getCacheFilePath, getProperties, isExtractedSchema, isJTDSchema, isJTDSchemaObject, isObjectSchema, isSchema, isUntypedInput, isUntypedSchema, jsonSchemaToJtd, mergeSchemas, readSchema, readSchemaSafe, reflectionToJsonSchema, resolve, resolveModule, resolveReflection, stringifyType, stringifyValue, writeSchema };

package/dist/jtd.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"jtd.mjs","names":["isSetObject"],"sources":["../src/jtd.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport {\n  isBoolean,\n  isSetArray,\n  isSetString,\n  isUndefined\n} from \"@stryke/type-checks\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport {\n  JsonSchemaLike,\n  JTDNumberType,\n  JTDSchemaType,\n  SchemaMetadata\n} from \"./types\";\n\n/**\n * Maps a JSON Schema `format` annotation for integers to the closest JTD numeric type.\n *\n * @param format - The JSON Schema format hint to map.\n * @returns The matching JTD numeric type, or `undefined` if no exact match exists.\n */\nfunction jsonSchemaIntegerFormatToJtd(\n  format: string | undefined\n): JTDNumberType | undefined {\n  switch (format) {\n    case \"int8\":\n      return \"int8\";\n    case \"uint8\":\n      return \"uint8\";\n    case \"int16\":\n      return \"int16\";\n    case \"uint16\":\n      return \"uint16\";\n    case \"int32\":\n      return \"int32\";\n    case \"uint32\":\n      return \"uint32\";\n    case undefined:\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Maps a JSON Schema `format` annotation for floating point numbers to the closest JTD numeric type.\n *\n * @param format - The JSON Schema format hint to map.\n * @returns The matching JTD numeric type, or `undefined` if no exact match exists.\n */\nfunction jsonSchemaNumberFormatToJtd(\n  format: string | undefined\n): JTDNumberType | undefined {\n  switch (format) {\n    case \"float\":\n    case \"float32\":\n      return \"float32\";\n    case \"double\":\n    case \"float64\":\n      return \"float64\";\n    case undefined:\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Picks the smallest unsigned JTD integer type that can hold the provided bounds.\n *\n * @param minimum - The inclusive lower bound, when known.\n * @param maximum - The inclusive upper bound, when known.\n * @returns The narrowest unsigned JTD integer type that can represent the range, or `undefined` if the range cannot be expressed as an unsigned integer.\n */\nfunction pickUnsignedIntegerType(\n  minimum: number | undefined,\n  maximum: number | undefined\n): JTDNumberType | undefined {\n  if (minimum === undefined || minimum < 0) {\n    return undefined;\n  }\n  if (maximum === undefined) {\n    return undefined;\n  }\n  if (maximum <= 0xff) {\n    return \"uint8\";\n  }\n  if (maximum <= 0xffff) {\n    return \"uint16\";\n  }\n  if (maximum <= 0xffffffff) {\n    return \"uint32\";\n  }\n  return undefined;\n}\n\n/**\n * Picks the smallest signed JTD integer type that can hold the provided bounds.\n *\n * @param minimum - The inclusive lower bound, when known.\n * @param maximum - The inclusive upper bound, when known.\n * @returns The narrowest signed JTD integer type that can represent the range, or `undefined` if the range cannot be expressed as a signed integer.\n */\nfunction pickSignedIntegerType(\n  minimum: number | undefined,\n  maximum: number | undefined\n): JTDNumberType | undefined {\n  if (\n    minimum !== undefined &&\n    maximum !== undefined &&\n    minimum >= -0x80 &&\n    maximum <= 0x7f\n  ) {\n    return \"int8\";\n  }\n  if (\n    minimum !== undefined &&\n    maximum !== undefined &&\n    minimum >= -0x8000 &&\n    maximum <= 0x7fff\n  ) {\n    return \"int16\";\n  }\n  return \"int32\";\n}\n\n/**\n * Tests whether the provided value is a non-null object that can be inspected as a JSON Schema fragment.\n *\n * @param value - The value to test.\n * @returns `true` if the value is a plain object suitable for JSON-Schema conversion.\n */\nfunction isJsonSchemaLike(value: unknown): value is JsonSchemaLike {\n  return isSetObject(value);\n}\n\n/**\n * Reads the JSON Schema `type` field as an array, normalising the single-string form.\n *\n * @param schema - The JSON Schema fragment to inspect.\n * @returns The list of JSON Schema type names declared on the fragment.\n */\nfunction readTypes(schema: JsonSchemaLike): string[] {\n  if (Array.isArray(schema.type)) {\n    return schema.type;\n  }\n  if (typeof schema.type === \"string\") {\n    return [schema.type];\n  }\n  return [];\n}\n\n/**\n * Builds a JTD `metadata` object from the JSON Schema annotation keywords found on a fragment.\n *\n * @param schema - The source JSON Schema fragment.\n * @returns A metadata bag suitable for attaching to a JTD form, or `undefined` if no annotations are present.\n */\nfunction collectMetadata<\n  TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>\n>(schema: JsonSchemaLike): TMetadata | undefined {\n  const metadata: TMetadata = {} as TMetadata;\n  if (isSetString(schema.description)) {\n    metadata.description = schema.description;\n  }\n\n  if (isSetArray(schema.examples)) {\n    metadata.examples = schema.examples;\n  }\n\n  if (\n    isSetArray(schema.alias) &&\n    (schema.alias as unknown[]).every(isSetString)\n  ) {\n    metadata.alias = schema.alias as string[];\n  }\n\n  if (isSetString(schema.table)) {\n    metadata.default = schema.table;\n  }\n\n  if (isSetString(schema.title)) {\n    metadata.title = schema.title;\n  }\n\n  if (!isUndefined(schema.default)) {\n    metadata.default = schema.default;\n  }\n\n  if (isBoolean(schema.isHidden)) {\n    metadata.isHidden = schema.isHidden;\n  } else if (isBoolean(schema.hidden)) {\n    metadata.isHidden = schema.hidden;\n  }\n\n  if (isBoolean(schema.isIgnored)) {\n    metadata.isIgnored = schema.isIgnored;\n  } else if (isBoolean(schema.ignored)) {\n    metadata.isIgnored = schema.ignored;\n  }\n\n  if (isBoolean(schema.isReadonly)) {\n    metadata.isReadonly = schema.isReadonly;\n  } else if (isBoolean(schema.readonly)) {\n    metadata.isReadonly = schema.readonly;\n  }\n\n  if (isBoolean(schema.isPrimaryKey)) {\n    metadata.isPrimaryKey = schema.isPrimaryKey;\n  } else if (isBoolean(schema.primaryKey)) {\n    metadata.isPrimaryKey = schema.primaryKey;\n  }\n\n  if (isBoolean(schema.isInternal)) {\n    metadata.isInternal = schema.isInternal;\n  } else if (isBoolean(schema.internal)) {\n    metadata.isInternal = schema.internal;\n  }\n\n  if (isBoolean(schema.isRuntime)) {\n    metadata.isRuntime = schema.isRuntime;\n  } else if (isBoolean(schema.runtime)) {\n    metadata.isRuntime = schema.runtime;\n  }\n\n  if (isSetArray(schema.union)) {\n    metadata.union = schema.union as JsonSchemaLike[];\n  }\n\n  return Object.keys(metadata).length > 0 ? metadata : undefined;\n}\n\n/**\n * Attaches metadata and nullability flags to a JTD form, mutating and returning the form.\n *\n * @param form - The base JTD form to decorate.\n * @param schema - The source JSON Schema fragment from which annotations are read.\n * @param nullable - Whether the schema is nullable in JTD semantics.\n * @returns The decorated JTD form.\n */\nfunction decorate<\n  TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>\n>(\n  form: JTDSchemaType<TMetadata>,\n  schema: JsonSchemaLike,\n  nullable: boolean\n): JTDSchemaType<TMetadata> {\n  if (nullable) {\n    (form as { nullable?: boolean }).nullable = true;\n  }\n  const metadata = collectMetadata<TMetadata>(schema);\n  if (metadata) {\n    (form as { metadata?: TMetadata }).metadata = metadata;\n  }\n  return form;\n}\n\n/**\n * Determines whether the supplied list of JSON Schema types collapses to `null` only.\n *\n * @param types - The normalized list of JSON Schema type names.\n * @returns `true` if the only declared type is `null`.\n */\nfunction isNullOnly(types: string[]): boolean {\n  return types.length > 0 && types.every(t => t === \"null\");\n}\n\n/**\n * Splits a `null` declaration away from a list of JSON Schema types.\n *\n * @param types - The normalized list of JSON Schema type names.\n * @returns A tuple of `[nonNullTypes, nullable]` describing the remaining types and whether `null` was present.\n */\nfunction stripNull(types: string[]): { types: string[]; nullable: boolean } {\n  const nullable = types.includes(\"null\");\n\n  return { types: types.filter(t => t !== \"null\"), nullable };\n}\n\n/**\n * Converts a JSON Schema `enum` keyword to a JTD enum form, stringifying values when required.\n *\n * @param values - The raw enum values from the JSON Schema fragment.\n * @returns A JTD enum form, or `undefined` if the enum cannot be represented (e.g. empty list).\n */\nfunction enumToJtd<\n  TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>\n>(values: readonly unknown[]): JTDSchemaType<TMetadata> | undefined {\n  const strings = values\n    .filter(v => v !== null && v !== undefined)\n    .map(v => String(v));\n  if (strings.length === 0) {\n    return undefined;\n  }\n  return { enum: Array.from(new Set(strings)) };\n}\n\n/**\n * Selects the most appropriate JTD numeric `type` value for a JSON Schema integer fragment.\n *\n * @param schema - The integer JSON Schema fragment.\n * @returns The chosen JTD integer type.\n */\nfunction pickIntegerJtdType(schema: JsonSchemaLike): JTDNumberType {\n  const mapped = jsonSchemaIntegerFormatToJtd(schema.format);\n  if (mapped) {\n    return mapped;\n  }\n  const unsigned = pickUnsignedIntegerType(schema.minimum, schema.maximum);\n  if (unsigned) {\n    return unsigned;\n  }\n  return pickSignedIntegerType(schema.minimum, schema.maximum) ?? \"int32\";\n}\n\n/**\n * Selects the most appropriate JTD numeric `type` value for a JSON Schema number fragment.\n *\n * @param schema - The number JSON Schema fragment.\n * @returns The chosen JTD floating point type.\n */\nfunction pickNumberJtdType(schema: JsonSchemaLike): JTDNumberType {\n  return jsonSchemaNumberFormatToJtd(schema.format) ?? \"float64\";\n}\n\n/**\n * Selects the JTD string `type` value for a JSON Schema string fragment, mapping `format: \"date-time\"` to `timestamp`.\n *\n * @param schema - The string JSON Schema fragment.\n * @returns The chosen JTD string type.\n */\nfunction pickStringJtdType(schema: JsonSchemaLike): \"string\" | \"timestamp\" {\n  if (schema.format === \"date-time\") {\n    return \"timestamp\";\n  }\n  return \"string\";\n}\n\n/**\n * Converts a JSON Schema object fragment into a JTD properties form.\n *\n * @param schema - The object JSON Schema fragment.\n * @param nullable - Whether the resulting JTD form should be nullable.\n * @returns The JTD properties form representing the object.\n */\nfunction objectToJtd<\n  TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>\n>(schema: JsonSchemaLike, nullable: boolean): JTDSchemaType<TMetadata> {\n  const required = new Set(schema.required ?? []);\n  const properties: Record<string, JTDSchemaType<TMetadata>> = {};\n  const optionalProperties: Record<string, JTDSchemaType<TMetadata>> = {};\n\n  const metadata = {\n    default: schema.default ?? {}\n  } as TMetadata & { default: Record<string, unknown> };\n\n  if (schema.properties) {\n    for (const [key, value] of Object.entries(schema.properties)) {\n      if (!isUndefined(value.default)) {\n        metadata.default[key] = value.default;\n      }\n\n      const converted = jsonSchemaToJtd<TMetadata>(value);\n      if (!converted) {\n        continue;\n      }\n\n      if (required.has(key)) {\n        properties[key] = converted;\n      } else {\n        optionalProperties[key] = converted;\n      }\n    }\n  }\n\n  const hasProperties = Object.keys(properties).length > 0;\n  const hasOptional = Object.keys(optionalProperties).length > 0;\n\n  // JTD requires `values` form for open maps with a single value schema.\n  // patternProperties / additionalProperties: object collapses to `values`\n  // when there are no declared properties.\n  if (\n    !hasProperties &&\n    !hasOptional &&\n    isJsonSchemaLike(schema.additionalProperties)\n  ) {\n    const values = jsonSchemaToJtd<TMetadata>(schema.additionalProperties);\n    if (values) {\n      return decorate<TMetadata>({ metadata, values }, schema, nullable);\n    }\n  }\n  if (!hasProperties && !hasOptional && schema.patternProperties) {\n    const first = Object.values(schema.patternProperties)[0];\n    if (first) {\n      const values = jsonSchemaToJtd<TMetadata>(first);\n      if (values) {\n        return decorate<TMetadata>({ metadata, values }, schema, nullable);\n      }\n    }\n  }\n\n  const form: {\n    metadata: TMetadata;\n    properties?: Record<string, JTDSchemaType<TMetadata>>;\n    optionalProperties?: Record<string, JTDSchemaType<TMetadata>>;\n    additionalProperties?: boolean;\n  } = { metadata };\n\n  if (hasProperties) {\n    form.properties = properties;\n  } else if (!hasOptional) {\n    // JTD object form must have at least one of properties / optionalProperties.\n    form.properties = {};\n  }\n  if (hasOptional) {\n    form.optionalProperties = optionalProperties;\n  }\n  if (\n    schema.additionalProperties === true ||\n    isJsonSchemaLike(schema.additionalProperties) ||\n    schema.patternProperties !== undefined\n  ) {\n    form.additionalProperties = true;\n  }\n\n  return decorate<TMetadata>(form, schema, nullable);\n}\n\n/**\n * Converts a JSON Schema array fragment into a JTD elements form.\n *\n * @param schema - The array JSON Schema fragment.\n * @param nullable - Whether the resulting JTD form should be nullable.\n * @returns The JTD elements form representing the array.\n */\nfunction arrayToJtd<\n  TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>\n>(schema: JsonSchemaLike, nullable: boolean): JTDSchemaType<TMetadata> {\n  let elementSchema: JsonSchemaLike | undefined;\n  if (Array.isArray(schema.items)) {\n    // Tuple form — JTD has no native tuple support. Best effort: collapse to\n    // the union (anyOf) of the tuple member schemas; if there is only one\n    // distinct shape, fall back to using it directly.\n    elementSchema = schema.items[0];\n  } else if (schema.items) {\n    elementSchema = schema.items;\n  }\n\n  const elements = elementSchema\n    ? jsonSchemaToJtd<TMetadata>(elementSchema)\n    : {};\n\n  return decorate<TMetadata>({ elements: elements ?? {} }, schema, nullable);\n}\n\n/**\n * Attempts to detect and emit a JTD discriminator form from a JSON Schema `oneOf` or `anyOf` fragment.\n *\n * @param schemas - The list of candidate JSON Schema fragments.\n * @param nullable - Whether the resulting JTD form should be nullable.\n * @returns A discriminator form when every branch shares a single tag property, otherwise `undefined`.\n */\nfunction tryDiscriminator<\n  TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>\n>(\n  schemas: readonly JsonSchemaLike[],\n  nullable: boolean\n): JTDSchemaType<TMetadata> | undefined {\n  if (schemas.length < 2) {\n    return undefined;\n  }\n\n  let candidateKey: string | undefined;\n  const mapping: Record<string, JTDSchemaType<TMetadata>> = {};\n\n  for (const branch of schemas) {\n    if (!isJsonSchemaLike(branch) || !branch.properties) {\n      return undefined;\n    }\n\n    const constantTags = Object.entries(branch.properties).filter(\n      ([, value]) =>\n        isJsonSchemaLike(value) &&\n        (typeof value.const === \"string\" ||\n          (Array.isArray(value.enum) &&\n            value.enum.length === 1 &&\n            typeof value.enum[0] === \"string\"))\n    );\n    if (constantTags.length === 0) {\n      return undefined;\n    }\n\n    const [tagKey, tagSchema] = constantTags[0]!;\n    if (!candidateKey) {\n      candidateKey = tagKey;\n    } else if (candidateKey !== tagKey) {\n      return undefined;\n    }\n\n    const tag =\n      typeof tagSchema.const === \"string\"\n        ? tagSchema.const\n        : (tagSchema.enum?.[0] as string);\n\n    // Remove the discriminator property from the branch before converting,\n    // as JTD's mapping schemas describe the remainder of the object.\n    const { [tagKey]: _omit, ...restProperties } = branch.properties;\n    const restRequired = (branch.required ?? []).filter(k => k !== tagKey);\n    const branchSchema: JsonSchemaLike = {\n      ...branch,\n      properties: restProperties,\n      required: restRequired\n    };\n\n    const branchForm = jsonSchemaToJtd<TMetadata>(branchSchema);\n    if (!branchForm || !isSetObject(branchForm) || \"ref\" in branchForm) {\n      return undefined;\n    }\n\n    mapping[tag] = branchForm;\n  }\n\n  if (!candidateKey) {\n    return undefined;\n  }\n\n  const form: JTDSchemaType<TMetadata> = {\n    discriminator: candidateKey,\n    mapping\n  };\n  if (nullable) {\n    (form as { nullable?: boolean }).nullable = true;\n  }\n\n  return form;\n}\n\n/**\n * Converts a JSON Schema fragment (draft-07 style, as produced by `zod-to-json-schema`, Standard Schema, etc.) into a valid JSON Type Definition (RFC 8927) schema.\n *\n * Unsupported JSON Schema keywords (`pattern`, `const`, `minItems`, `maxItems`, `uniqueItems`, etc.) are dropped — JTD intentionally omits these. Annotation keywords (`description`, `title`, `default`, `examples`) are preserved under the JTD `metadata` field.\n *\n * @param schema - The JSON Schema fragment to convert.\n * @returns A valid JTD form, or `undefined` if the input cannot be represented.\n */\nexport function jsonSchemaToJtd<\n  TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>\n>(\n  schema: JsonSchemaLike | undefined | null\n): JTDSchemaType<TMetadata> | undefined {\n  if (!isJsonSchemaLike(schema)) {\n    return undefined;\n  }\n\n  // $ref → JTD ref form. The pointer must reference `#/definitions/<name>`.\n  if (isSetString(schema.$ref)) {\n    const match = /^#\\/(?:definitions|\\$defs)\\/(.+)$/.exec(schema.$ref);\n    if (match) {\n      return { ref: match[1]! };\n    }\n  }\n\n  // allOf — fold member schemas together via shallow merge before converting.\n  if (Array.isArray(schema.allOf) && schema.allOf.length > 0) {\n    const merged = schema.allOf.reduce<JsonSchemaLike>(\n      (acc, current) => mergeJsonSchema(acc, current),\n      {}\n    );\n    const { allOf: _allOf, ...rest } = schema;\n\n    return jsonSchemaToJtd<TMetadata>(mergeJsonSchema(merged, rest));\n  }\n\n  const rawTypes = readTypes(schema);\n  const { types: nonNullTypes, nullable: typeIsNullable } = stripNull(rawTypes);\n  const nullable = Boolean(schema.nullable) || typeIsNullable;\n\n  // Pure null type → JTD has no first-class null form, emit empty + nullable.\n  if (isNullOnly(rawTypes)) {\n    return decorate<TMetadata>({}, schema, true);\n  }\n\n  // Enum form.\n  if (Array.isArray(schema.enum)) {\n    const enumForm = enumToJtd<TMetadata>(schema.enum);\n    if (enumForm) {\n      return decorate<TMetadata>(enumForm, schema, nullable);\n    }\n  }\n\n  // const → enum of one (only valid when value is a string in JTD).\n  if (isSetString(schema.const)) {\n    return decorate<TMetadata>({ enum: [schema.const] }, schema, nullable);\n  }\n\n  // anyOf / oneOf — try to detect a discriminated union, otherwise collapse.\n  const union = schema.oneOf ?? schema.anyOf;\n  if (Array.isArray(union) && union.length > 0) {\n    const branches = union.filter(isJsonSchemaLike);\n    const onlyNullBranches = branches.filter(b =>\n      readTypes(b).includes(\"null\")\n    );\n    const nonNullBranches = branches.filter(\n      b => !isNullOnly(readTypes(b)) && readTypes(b).join() !== \"null\"\n    );\n    const unionNullable = nullable || onlyNullBranches.length > 0;\n\n    if (nonNullBranches.length === 1) {\n      const collapsed = jsonSchemaToJtd<TMetadata>(nonNullBranches[0]);\n      if (collapsed) {\n        return decorate<TMetadata>(collapsed, schema, unionNullable);\n      }\n    }\n\n    const discriminated = tryDiscriminator<TMetadata>(\n      nonNullBranches,\n      unionNullable\n    );\n    if (discriminated) {\n      const metadata = collectMetadata<TMetadata>(schema);\n      if (metadata) {\n        (discriminated as { metadata?: TMetadata }).metadata = metadata;\n      }\n      return discriminated;\n    }\n\n    // No safe JTD equivalent: emit empty schema (matches any value) with\n    // metadata to preserve provenance.\n    const fallback = decorate<TMetadata>({}, schema, unionNullable);\n    const metadata =\n      (fallback as { metadata?: TMetadata }).metadata ?? ({} as TMetadata);\n    metadata.union = union;\n    (fallback as { metadata?: TMetadata }).metadata = metadata;\n    return fallback;\n  }\n\n  // Object form — `type: \"object\"` or implicit via `properties`.\n  if (\n    nonNullTypes.includes(\"object\") ||\n    schema.properties ||\n    schema.patternProperties ||\n    isJsonSchemaLike(schema.additionalProperties)\n  ) {\n    const result = objectToJtd<TMetadata>(schema, nullable);\n    const definitions = schema.definitions ?? schema.$defs;\n    if (definitions && Object.keys(definitions).length > 0) {\n      const converted: Record<string, JTDSchemaType<TMetadata>> = {};\n      for (const [key, value] of Object.entries(definitions)) {\n        const def = jsonSchemaToJtd<TMetadata>(value);\n        if (def) {\n          converted[key] = def;\n        }\n      }\n      if (Object.keys(converted).length > 0) {\n        (\n          result as { definitions?: Record<string, JTDSchemaType<TMetadata>> }\n        ).definitions = converted;\n      }\n    }\n    return result;\n  }\n\n  if (nonNullTypes.includes(\"array\")) {\n    return arrayToJtd<TMetadata>(schema, nullable);\n  }\n\n  // Scalar types.\n  if (nonNullTypes.length === 1) {\n    const t = nonNullTypes[0]!;\n    if (t === \"string\") {\n      return decorate<TMetadata>(\n        { type: pickStringJtdType(schema) },\n        schema,\n        nullable\n      );\n    }\n    if (t === \"boolean\") {\n      return decorate<TMetadata>({ type: \"boolean\" }, schema, nullable);\n    }\n    if (t === \"integer\") {\n      return decorate<TMetadata>(\n        { type: pickIntegerJtdType(schema) },\n        schema,\n        nullable\n      );\n    }\n    if (t === \"number\") {\n      return decorate<TMetadata>(\n        { type: pickNumberJtdType(schema) },\n        schema,\n        nullable\n      );\n    }\n  }\n\n  // Mixed scalar types (e.g. [\"string\", \"number\"]) — emit empty schema since\n  // JTD has no native union of primitives.\n  if (nonNullTypes.length > 1) {\n    return decorate<TMetadata>({}, schema, nullable);\n  }\n\n  // No type info — empty (any) schema, possibly nullable.\n  return decorate<TMetadata>({}, schema, nullable);\n}\n\n/**\n * Shallow-merges two JSON Schema fragments, combining `required` arrays and `properties` maps.\n *\n * @param left - The base schema fragment.\n * @param right - The schema fragment to merge into the base.\n * @returns A merged schema fragment. Neither input is mutated.\n */\nfunction mergeJsonSchema(\n  left: JsonSchemaLike,\n  right: JsonSchemaLike\n): JsonSchemaLike {\n  const merged: JsonSchemaLike = { ...left, ...right };\n  if (left.properties || right.properties) {\n    merged.properties = {\n      ...(left.properties ?? {}),\n      ...(right.properties ?? {})\n    };\n  }\n  if (left.required || right.required) {\n    merged.required = Array.from(\n      new Set([...(left.required ?? []), ...(right.required ?? [])])\n    );\n  }\n  return merged;\n}\n"],"mappings":"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"}
+{"version":3,"file":"jtd.mjs","names":["isSetObject"],"sources":["../src/jtd.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport {\n  isBoolean,\n  isSetArray,\n  isSetString,\n  isUndefined\n} from \"@stryke/type-checks\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport {\n  JsonSchemaLike,\n  JTDNumberType,\n  JTDSchemaType,\n  SchemaMetadata\n} from \"./types\";\n\n/**\n * Maps a JSON Schema `format` annotation for integers to the closest JTD numeric type.\n *\n * @param format - The JSON Schema format hint to map.\n * @returns The matching JTD numeric type, or `undefined` if no exact match exists.\n */\nfunction jsonSchemaIntegerFormatToJtd(\n  format: string | undefined\n): JTDNumberType | undefined {\n  switch (format) {\n    case \"int8\":\n      return \"int8\";\n    case \"uint8\":\n      return \"uint8\";\n    case \"int16\":\n      return \"int16\";\n    case \"uint16\":\n      return \"uint16\";\n    case \"int32\":\n      return \"int32\";\n    case \"uint32\":\n      return \"uint32\";\n    case undefined:\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Maps a JSON Schema `format` annotation for floating point numbers to the closest JTD numeric type.\n *\n * @param format - The JSON Schema format hint to map.\n * @returns The matching JTD numeric type, or `undefined` if no exact match exists.\n */\nfunction jsonSchemaNumberFormatToJtd(\n  format: string | undefined\n): JTDNumberType | undefined {\n  switch (format) {\n    case \"float\":\n    case \"float32\":\n      return \"float32\";\n    case \"double\":\n    case \"float64\":\n      return \"float64\";\n    case undefined:\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Picks the smallest unsigned JTD integer type that can hold the provided bounds.\n *\n * @param minimum - The inclusive lower bound, when known.\n * @param maximum - The inclusive upper bound, when known.\n * @returns The narrowest unsigned JTD integer type that can represent the range, or `undefined` if the range cannot be expressed as an unsigned integer.\n */\nfunction pickUnsignedIntegerType(\n  minimum: number | undefined,\n  maximum: number | undefined\n): JTDNumberType | undefined {\n  if (minimum === undefined || minimum < 0) {\n    return undefined;\n  }\n  if (maximum === undefined) {\n    return undefined;\n  }\n  if (maximum <= 0xff) {\n    return \"uint8\";\n  }\n  if (maximum <= 0xffff) {\n    return \"uint16\";\n  }\n  if (maximum <= 0xffffffff) {\n    return \"uint32\";\n  }\n  return undefined;\n}\n\n/**\n * Picks the smallest signed JTD integer type that can hold the provided bounds.\n *\n * @param minimum - The inclusive lower bound, when known.\n * @param maximum - The inclusive upper bound, when known.\n * @returns The narrowest signed JTD integer type that can represent the range, or `undefined` if the range cannot be expressed as a signed integer.\n */\nfunction pickSignedIntegerType(\n  minimum: number | undefined,\n  maximum: number | undefined\n): JTDNumberType | undefined {\n  if (\n    minimum !== undefined &&\n    maximum !== undefined &&\n    minimum >= -0x80 &&\n    maximum <= 0x7f\n  ) {\n    return \"int8\";\n  }\n  if (\n    minimum !== undefined &&\n    maximum !== undefined &&\n    minimum >= -0x8000 &&\n    maximum <= 0x7fff\n  ) {\n    return \"int16\";\n  }\n  return \"int32\";\n}\n\n/**\n * Tests whether the provided value is a non-null object that can be inspected as a JSON Schema fragment.\n *\n * @param value - The value to test.\n * @returns `true` if the value is a plain object suitable for JSON-Schema conversion.\n */\nfunction isJsonSchemaLike(value: unknown): value is JsonSchemaLike {\n  return isSetObject(value);\n}\n\n/**\n * Reads the JSON Schema `type` field as an array, normalising the single-string form.\n *\n * @param schema - The JSON Schema fragment to inspect.\n * @returns The list of JSON Schema type names declared on the fragment.\n */\nfunction readTypes(schema: JsonSchemaLike): string[] {\n  if (Array.isArray(schema.type)) {\n    return schema.type;\n  }\n  if (typeof schema.type === \"string\") {\n    return [schema.type];\n  }\n  return [];\n}\n\n/**\n * Builds a JTD `metadata` object from the JSON Schema annotation keywords found on a fragment.\n *\n * @param schema - The source JSON Schema fragment.\n * @returns A metadata bag suitable for attaching to a JTD form, or `undefined` if no annotations are present.\n */\nfunction collectMetadata<\n  TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>\n>(schema: JsonSchemaLike): TMetadata | undefined {\n  const metadata: TMetadata = {} as TMetadata;\n  if (isSetString(schema.description)) {\n    metadata.description = schema.description;\n  }\n\n  if (isSetArray(schema.examples)) {\n    metadata.examples = schema.examples;\n  }\n\n  if (\n    isSetArray(schema.alias) &&\n    (schema.alias as unknown[]).every(isSetString)\n  ) {\n    metadata.alias = schema.alias as string[];\n  }\n\n  if (isSetString(schema.table)) {\n    metadata.default = schema.table;\n  }\n\n  if (isSetString(schema.title)) {\n    metadata.title = schema.title;\n  }\n\n  if (!isUndefined(schema.default)) {\n    metadata.default = schema.default;\n  }\n\n  if (isBoolean(schema.isHidden)) {\n    metadata.isHidden = schema.isHidden;\n  } else if (isBoolean(schema.hidden)) {\n    metadata.isHidden = schema.hidden;\n  }\n\n  if (isBoolean(schema.isIgnored)) {\n    metadata.isIgnored = schema.isIgnored;\n  } else if (isBoolean(schema.ignored)) {\n    metadata.isIgnored = schema.ignored;\n  }\n\n  if (isBoolean(schema.isReadonly)) {\n    metadata.isReadonly = schema.isReadonly;\n  } else if (isBoolean(schema.readonly)) {\n    metadata.isReadonly = schema.readonly;\n  }\n\n  if (isBoolean(schema.isPrimaryKey)) {\n    metadata.isPrimaryKey = schema.isPrimaryKey;\n  } else if (isBoolean(schema.primaryKey)) {\n    metadata.isPrimaryKey = schema.primaryKey;\n  }\n\n  if (isBoolean(schema.isInternal)) {\n    metadata.isInternal = schema.isInternal;\n  } else if (isBoolean(schema.internal)) {\n    metadata.isInternal = schema.internal;\n  }\n\n  if (isBoolean(schema.isRuntime)) {\n    metadata.isRuntime = schema.isRuntime;\n  } else if (isBoolean(schema.runtime)) {\n    metadata.isRuntime = schema.runtime;\n  }\n\n  if (isSetArray(schema.union)) {\n    metadata.union = schema.union as JsonSchemaLike[];\n  }\n\n  return Object.keys(metadata).length > 0 ? metadata : undefined;\n}\n\n/**\n * Attaches metadata and nullability flags to a JTD form, mutating and returning the form.\n *\n * @param form - The base JTD form to decorate.\n * @param schema - The source JSON Schema fragment from which annotations are read.\n * @param nullable - Whether the schema is nullable in JTD semantics.\n * @returns The decorated JTD form.\n */\nfunction decorate<\n  TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>\n>(\n  form: JTDSchemaType<TMetadata>,\n  schema: JsonSchemaLike,\n  nullable: boolean\n): JTDSchemaType<TMetadata> {\n  if (nullable) {\n    (form as { nullable?: boolean }).nullable = true;\n  }\n  const metadata = collectMetadata<TMetadata>(schema);\n  if (metadata) {\n    (form as { metadata?: TMetadata }).metadata = metadata;\n  }\n  return form;\n}\n\n/**\n * Determines whether the supplied list of JSON Schema types collapses to `null` only.\n *\n * @param types - The normalized list of JSON Schema type names.\n * @returns `true` if the only declared type is `null`.\n */\nfunction isNullOnly(types: string[]): boolean {\n  return types.length > 0 && types.every(t => t === \"null\");\n}\n\n/**\n * Splits a `null` declaration away from a list of JSON Schema types.\n *\n * @param types - The normalized list of JSON Schema type names.\n * @returns A tuple of `[nonNullTypes, nullable]` describing the remaining types and whether `null` was present.\n */\nfunction stripNull(types: string[]): { types: string[]; nullable: boolean } {\n  const nullable = types.includes(\"null\");\n\n  return { types: types.filter(t => t !== \"null\"), nullable };\n}\n\n/**\n * Converts a JSON Schema `enum` keyword to a JTD enum form, stringifying values when required.\n *\n * @param values - The raw enum values from the JSON Schema fragment.\n * @returns A JTD enum form, or `undefined` if the enum cannot be represented (e.g. empty list).\n */\nfunction enumToJtd<\n  TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>\n>(values: readonly unknown[]): JTDSchemaType<TMetadata> | undefined {\n  const strings = values\n    .filter(v => v !== null && v !== undefined)\n    .map(v => String(v));\n  if (strings.length === 0) {\n    return undefined;\n  }\n  return { enum: Array.from(new Set(strings)) };\n}\n\n/**\n * Selects the most appropriate JTD numeric `type` value for a JSON Schema integer fragment.\n *\n * @param schema - The integer JSON Schema fragment.\n * @returns The chosen JTD integer type.\n */\nfunction pickIntegerJtdType(schema: JsonSchemaLike): JTDNumberType {\n  const mapped = jsonSchemaIntegerFormatToJtd(schema.format);\n  if (mapped) {\n    return mapped;\n  }\n  const unsigned = pickUnsignedIntegerType(schema.minimum, schema.maximum);\n  if (unsigned) {\n    return unsigned;\n  }\n  return pickSignedIntegerType(schema.minimum, schema.maximum) ?? \"int32\";\n}\n\n/**\n * Selects the most appropriate JTD numeric `type` value for a JSON Schema number fragment.\n *\n * @param schema - The number JSON Schema fragment.\n * @returns The chosen JTD floating point type.\n */\nfunction pickNumberJtdType(schema: JsonSchemaLike): JTDNumberType {\n  return jsonSchemaNumberFormatToJtd(schema.format) ?? \"float64\";\n}\n\n/**\n * Selects the JTD string `type` value for a JSON Schema string fragment, mapping `format: \"date-time\"` to `timestamp`.\n *\n * @param schema - The string JSON Schema fragment.\n * @returns The chosen JTD string type.\n */\nfunction pickStringJtdType(schema: JsonSchemaLike): \"string\" | \"timestamp\" {\n  if (schema.format === \"date-time\") {\n    return \"timestamp\";\n  }\n  return \"string\";\n}\n\n/**\n * Converts a JSON Schema object fragment into a JTD properties form.\n *\n * @param schema - The object JSON Schema fragment.\n * @param nullable - Whether the resulting JTD form should be nullable.\n * @returns The JTD properties form representing the object.\n */\nfunction objectToJtd<\n  TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>\n>(schema: JsonSchemaLike, nullable: boolean): JTDSchemaType<TMetadata> {\n  const required = new Set(schema.required ?? []);\n  const properties: Record<string, JTDSchemaType<TMetadata>> = {};\n  const optionalProperties: Record<string, JTDSchemaType<TMetadata>> = {};\n\n  const metadata = {\n    default: schema.default ?? {}\n  } as TMetadata & { default: Record<string, unknown> };\n\n  if (schema.properties) {\n    for (const [key, value] of Object.entries(schema.properties)) {\n      if (!isUndefined(value.default)) {\n        metadata.default[key] = value.default;\n      }\n\n      const converted = jsonSchemaToJtd<TMetadata>(value);\n      if (!converted) {\n        continue;\n      }\n\n      if (required.has(key)) {\n        properties[key] = converted;\n      } else {\n        optionalProperties[key] = converted;\n      }\n    }\n  }\n\n  const hasProperties = Object.keys(properties).length > 0;\n  const hasOptional = Object.keys(optionalProperties).length > 0;\n\n  // JTD requires `values` form for open maps with a single value schema.\n  // patternProperties / additionalProperties: object collapses to `values`\n  // when there are no declared properties.\n  if (\n    !hasProperties &&\n    !hasOptional &&\n    isJsonSchemaLike(schema.additionalProperties)\n  ) {\n    const values = jsonSchemaToJtd<TMetadata>(schema.additionalProperties);\n    if (values) {\n      return decorate<TMetadata>({ metadata, values }, schema, nullable);\n    }\n  }\n  if (!hasProperties && !hasOptional && schema.patternProperties) {\n    const first = Object.values(schema.patternProperties)[0];\n    if (first) {\n      const values = jsonSchemaToJtd<TMetadata>(first);\n      if (values) {\n        return decorate<TMetadata>({ metadata, values }, schema, nullable);\n      }\n    }\n  }\n\n  const form: {\n    metadata: TMetadata;\n    properties?: Record<string, JTDSchemaType<TMetadata>>;\n    optionalProperties?: Record<string, JTDSchemaType<TMetadata>>;\n    additionalProperties?: boolean;\n  } = { metadata };\n\n  if (hasProperties) {\n    form.properties = properties;\n  } else if (!hasOptional) {\n    // JTD object form must have at least one of properties / optionalProperties.\n    form.properties = {};\n  }\n  if (hasOptional) {\n    form.optionalProperties = optionalProperties;\n  }\n  if (\n    schema.additionalProperties === true ||\n    isJsonSchemaLike(schema.additionalProperties) ||\n    schema.patternProperties !== undefined\n  ) {\n    form.additionalProperties = true;\n  }\n\n  return decorate<TMetadata>(form, schema, nullable);\n}\n\n/**\n * Converts a JSON Schema array fragment into a JTD elements form.\n *\n * @param schema - The array JSON Schema fragment.\n * @param nullable - Whether the resulting JTD form should be nullable.\n * @returns The JTD elements form representing the array.\n */\nfunction arrayToJtd<\n  TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>\n>(schema: JsonSchemaLike, nullable: boolean): JTDSchemaType<TMetadata> {\n  let elementSchema: JsonSchemaLike | undefined;\n  if (Array.isArray(schema.items)) {\n    // Tuple form — JTD has no native tuple support. Best effort: collapse to\n    // the union (anyOf) of the tuple member schemas; if there is only one\n    // distinct shape, fall back to using it directly.\n    elementSchema = schema.items[0];\n  } else if (schema.items) {\n    elementSchema = schema.items;\n  }\n\n  const elements = elementSchema\n    ? jsonSchemaToJtd<TMetadata>(elementSchema)\n    : {};\n\n  return decorate<TMetadata>({ elements: elements ?? {} }, schema, nullable);\n}\n\n/**\n * Attempts to detect and emit a JTD discriminator form from a JSON Schema `oneOf` or `anyOf` fragment.\n *\n * @param schemas - The list of candidate JSON Schema fragments.\n * @param nullable - Whether the resulting JTD form should be nullable.\n * @returns A discriminator form when every branch shares a single tag property, otherwise `undefined`.\n */\nfunction tryDiscriminator<\n  TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>\n>(\n  schemas: readonly JsonSchemaLike[],\n  nullable: boolean\n): JTDSchemaType<TMetadata> | undefined {\n  if (schemas.length < 2) {\n    return undefined;\n  }\n\n  let candidateKey: string | undefined;\n  const mapping: Record<string, JTDSchemaType<TMetadata>> = {};\n\n  for (const branch of schemas) {\n    if (!isJsonSchemaLike(branch) || !branch.properties) {\n      return undefined;\n    }\n\n    const constantTags = Object.entries(branch.properties).filter(\n      ([, value]) =>\n        isJsonSchemaLike(value) &&\n        (typeof value.const === \"string\" ||\n          (Array.isArray(value.enum) &&\n            value.enum.length === 1 &&\n            typeof value.enum[0] === \"string\"))\n    );\n    if (constantTags.length === 0) {\n      return undefined;\n    }\n\n    const [tagKey, tagSchema] = constantTags[0]!;\n    if (!candidateKey) {\n      candidateKey = tagKey;\n    } else if (candidateKey !== tagKey) {\n      return undefined;\n    }\n\n    const tag =\n      typeof tagSchema.const === \"string\"\n        ? tagSchema.const\n        : (tagSchema.enum?.[0] as string);\n\n    // Remove the discriminator property from the branch before converting,\n    // as JTD's mapping schemas describe the remainder of the object.\n    const { [tagKey]: _omit, ...restProperties } = branch.properties;\n    const restRequired = (branch.required ?? []).filter(k => k !== tagKey);\n    const branchSchema: JsonSchemaLike = {\n      ...branch,\n      properties: restProperties,\n      required: restRequired\n    };\n\n    const branchForm = jsonSchemaToJtd<TMetadata>(branchSchema);\n    if (!branchForm || !isSetObject(branchForm) || \"ref\" in branchForm) {\n      return undefined;\n    }\n\n    mapping[tag] = branchForm;\n  }\n\n  if (!candidateKey) {\n    return undefined;\n  }\n\n  const form: JTDSchemaType<TMetadata> = {\n    discriminator: candidateKey,\n    mapping\n  };\n  if (nullable) {\n    (form as { nullable?: boolean }).nullable = true;\n  }\n\n  return form;\n}\n\n/**\n * Converts a JSON Schema fragment (draft-07 style, as produced by `zod-to-json-schema`, Standard Schema, etc.) into a valid JSON Type Definition (RFC 8927) schema.\n *\n * Unsupported JSON Schema keywords (`pattern`, `const`, `minItems`, `maxItems`, `uniqueItems`, etc.) are dropped — JTD intentionally omits these. Annotation keywords (`description`, `title`, `default`, `examples`) are preserved under the JTD `metadata` field.\n *\n * @param schema - The JSON Schema fragment to convert.\n * @returns A valid JTD form, or `undefined` if the input cannot be represented.\n */\nexport function jsonSchemaToJtd<\n  TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>\n>(\n  schema: JsonSchemaLike | undefined | null\n): JTDSchemaType<TMetadata> | undefined {\n  if (!isJsonSchemaLike(schema)) {\n    return undefined;\n  }\n\n  // $ref → JTD ref form. The pointer must reference `#/definitions/<name>`.\n  if (isSetString(schema.$ref)) {\n    const match = /^#\\/(?:definitions|\\$defs)\\/(.+)$/.exec(schema.$ref);\n    if (match) {\n      return { ref: match[1]! };\n    }\n  }\n\n  // allOf — fold member schemas together via shallow merge before converting.\n  if (Array.isArray(schema.allOf) && schema.allOf.length > 0) {\n    const merged = schema.allOf.reduce<JsonSchemaLike>(\n      (acc, current) => mergeJsonSchema(acc, current),\n      {}\n    );\n    const { allOf: _allOf, ...rest } = schema;\n\n    return jsonSchemaToJtd<TMetadata>(mergeJsonSchema(merged, rest));\n  }\n\n  const rawTypes = readTypes(schema);\n  const { types: nonNullTypes, nullable: typeIsNullable } = stripNull(rawTypes);\n  const nullable = Boolean(schema.nullable) || typeIsNullable;\n\n  // Pure null type → JTD has no first-class null form, emit empty + nullable.\n  if (isNullOnly(rawTypes)) {\n    return decorate<TMetadata>({}, schema, true);\n  }\n\n  // Enum form.\n  if (Array.isArray(schema.enum)) {\n    const enumForm = enumToJtd<TMetadata>(schema.enum);\n    if (enumForm) {\n      return decorate<TMetadata>(enumForm, schema, nullable);\n    }\n  }\n\n  // const → enum of one (only valid when value is a string in JTD).\n  if (isSetString(schema.const)) {\n    return decorate<TMetadata>({ enum: [schema.const] }, schema, nullable);\n  }\n\n  // anyOf / oneOf — try to detect a discriminated union, otherwise collapse.\n  const union = schema.oneOf ?? schema.anyOf;\n  if (Array.isArray(union) && union.length > 0) {\n    const branches = union.filter(isJsonSchemaLike);\n    const onlyNullBranches = branches.filter(b =>\n      readTypes(b).includes(\"null\")\n    );\n    const nonNullBranches = branches.filter(\n      b => !isNullOnly(readTypes(b)) && readTypes(b).join() !== \"null\"\n    );\n    const unionNullable = nullable || onlyNullBranches.length > 0;\n\n    if (nonNullBranches.length === 1) {\n      const collapsed = jsonSchemaToJtd<TMetadata>(nonNullBranches[0]);\n      if (collapsed) {\n        return decorate<TMetadata>(collapsed, schema, unionNullable);\n      }\n    }\n\n    const discriminated = tryDiscriminator<TMetadata>(\n      nonNullBranches,\n      unionNullable\n    );\n    if (discriminated) {\n      const metadata = collectMetadata<TMetadata>(schema);\n      if (metadata) {\n        (discriminated as { metadata?: TMetadata }).metadata = metadata;\n      }\n      return discriminated;\n    }\n\n    // No safe JTD equivalent: emit empty schema (matches any value) with\n    // metadata to preserve provenance.\n    const fallback = decorate<TMetadata>({}, schema, unionNullable);\n    const metadata =\n      (fallback as { metadata?: TMetadata }).metadata ?? ({} as TMetadata);\n    metadata.union = union;\n    (fallback as { metadata?: TMetadata }).metadata = metadata;\n    return fallback;\n  }\n\n  // Object form — `type: \"object\"` or implicit via `properties`.\n  if (\n    nonNullTypes.includes(\"object\") ||\n    schema.properties ||\n    schema.patternProperties ||\n    isJsonSchemaLike(schema.additionalProperties)\n  ) {\n    const result = objectToJtd<TMetadata>(schema, nullable);\n    const definitions = schema.definitions ?? schema.$defs;\n    if (definitions && Object.keys(definitions).length > 0) {\n      const converted: Record<string, JTDSchemaType<TMetadata>> = {};\n      for (const [key, value] of Object.entries(definitions)) {\n        const def = jsonSchemaToJtd<TMetadata>(value);\n        if (def) {\n          converted[key] = def;\n        }\n      }\n      if (Object.keys(converted).length > 0) {\n        (\n          result as { definitions?: Record<string, JTDSchemaType<TMetadata>> }\n        ).definitions = converted;\n      }\n    }\n    return result;\n  }\n\n  if (nonNullTypes.includes(\"array\")) {\n    return arrayToJtd<TMetadata>(schema, nullable);\n  }\n\n  // Scalar types.\n  if (nonNullTypes.length === 1) {\n    const t = nonNullTypes[0]!;\n    if (t === \"string\") {\n      return decorate<TMetadata>(\n        { type: pickStringJtdType(schema) },\n        schema,\n        nullable\n      );\n    }\n    if (t === \"boolean\") {\n      return decorate<TMetadata>({ type: \"boolean\" }, schema, nullable);\n    }\n    if (t === \"integer\") {\n      return decorate<TMetadata>(\n        { type: pickIntegerJtdType(schema) },\n        schema,\n        nullable\n      );\n    }\n    if (t === \"number\") {\n      return decorate<TMetadata>(\n        { type: pickNumberJtdType(schema) },\n        schema,\n        nullable\n      );\n    }\n  }\n\n  // Mixed scalar types (e.g. [\"string\", \"number\"]) — emit empty schema since\n  // JTD has no native union of primitives.\n  if (nonNullTypes.length > 1) {\n    return decorate<TMetadata>({}, schema, nullable);\n  }\n\n  // No type info — empty (any) schema, possibly nullable.\n  return decorate<TMetadata>({}, schema, nullable);\n}\n\n/**\n * Shallow-merges two JSON Schema fragments, combining `required` arrays and `properties` maps.\n *\n * @param left - The base schema fragment.\n * @param right - The schema fragment to merge into the base.\n * @returns A merged schema fragment. Neither input is mutated.\n */\nfunction mergeJsonSchema(\n  left: JsonSchemaLike,\n  right: JsonSchemaLike\n): JsonSchemaLike {\n  const merged: JsonSchemaLike = { ...left, ...right };\n  if (left.properties || right.properties) {\n    merged.properties = {\n      ...(left.properties ?? {}),\n      ...(right.properties ?? {})\n    };\n  }\n  if (left.required || right.required) {\n    merged.required = Array.from(\n      new Set([...(left.required ?? []), ...(right.required ?? [])])\n    );\n  }\n  return merged;\n}\n"],"mappings":"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"}

package/dist/persistence.cjs

@@ -0,0 +1,76 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_type_checks = require('./type-checks.cjs');
+const require_extract = require('./extract.cjs');
+let _stryke_path_join = require("@stryke/path/join");
+
+//#region src/persistence.ts
+/**
+* A helper function to get the cache directory path for storing schemas. This function takes a context object as input and returns the path to the cache directory where schemas are stored. The cache directory is constructed by joining the `cachePath` property from the context with a subdirectory named "schemas". This function is useful for centralizing the logic for determining where schema files should be cached, ensuring that all schema-related file operations use a consistent location for storing and retrieving cached schemas.
+*
+* @param context - The context object providing access to the cache path.
+* @returns The path to the cache directory for storing schemas, constructed by joining the context's `cachePath` with the "schemas" subdirectory.
+*/
+function getCacheDirectory(context) {
+	return (0, _stryke_path_join.joinPaths)(context.cachePath, "schemas");
+}
+/**
+* A helper function to get the file path for a cached schema based on the provided context and schema input. This function first extracts the variant and hash from the input schema using the `extractVariant` and `extractHash` functions, respectively. It then constructs the file path to the cached schema JSON file by joining the cache directory path (obtained from the `getCacheDirectory` function) with a filename derived from the extracted hash. The resulting file path points to where the cached schema should be stored or retrieved from in the file system. This function is essential for ensuring that all operations related to caching schemas use a consistent method for determining the correct file path based on the schema's unique identifier (hash).
+*
+* @param context - The context object providing access to the cache path.
+* @param input - The input schema from which to extract the variant and hash for constructing the cache file path.
+* @returns The file path to the cached schema JSON file, constructed by joining the cache directory path with a filename derived from the extracted hash of the schema input.
+*/
+function getCacheFilePath(context, input) {
+	const hash = require_extract.extractHash(require_extract.extractVariant(input), input);
+	return (0, _stryke_path_join.joinPaths)(getCacheDirectory(context), `${hash}.json`);
+}
+/**
+* Writes a given schema to the file system using the provided context. This function first checks if the input is a valid schema using the `isSchema` type guard. If the input is not a valid schema, it throws an error indicating that the provided input is invalid. If the input is valid, it proceeds to write the schema to a JSON file in the cache directory specified by the context. The file is named using the hash of the schema to ensure uniqueness and easy retrieval in future operations. The schema is serialized to JSON format before being written to the file system. This function is asynchronous and returns a promise that resolves once the writing operation is complete.
+*
+* @param context - The context object providing access to the file system and cache path.
+* @param schema - The schema to be written to the file system, which must be a valid schema object containing a `variant`, `schema`, and `hash` property.
+* @throws Will throw an error if the provided input is not a valid schema.
+*/
+async function writeSchema(context, schema) {
+	if (!require_type_checks.isSchema(schema)) throw new Error(`The provided input is not a valid schema. A valid schema must have a "variant" property indicating the type of the input and a "schema" property containing the parsed JTD schema object.`);
+	await context.fs.write(getCacheFilePath(context, schema), JSON.stringify(schema.schema));
+}
+/**
+* A helper function to read a schema from the file system using the provided context. This function first extracts the variant and hash from the input schema using the `extractVariant` and `extractHash` functions, respectively. It then constructs the file path to the cached schema JSON file based on the cache path provided in the context and the extracted hash. The function checks if the file exists in the cache; if it does not exist, it returns `undefined`. If the file exists, it reads the contents of the file, parses it as JSON, and returns the resulting object. This function is asynchronous and returns a promise that resolves to either the parsed schema object or `undefined` if the schema is not found in the cache.
+*
+* @param context - The context object providing access to the file system and cache path.
+* @param input - The input schema from which to extract the variant and hash for locating the cached schema file.
+* @returns A promise that resolves to the parsed schema object if found in the cache, or `undefined` if the schema does not exist in the cache.
+*/
+async function readSchemaSafe(context, input) {
+	const cacheFilePath = getCacheFilePath(context, input);
+	if (!await context.fs.exists(cacheFilePath)) return;
+	const data = await context.fs.read(cacheFilePath);
+	if (!data) return;
+	return JSON.parse(data);
+}
+/**
+* Reads a schema from the file system using the provided context and input. This function first attempts to read the schema using the `readSchemaSafe` helper function, which returns `undefined` if the schema is not found in the cache. If the schema is not found, this function throws an error indicating that the schema with the specified variant and hash does not exist in the cache. The error message suggests that this may be due to a missing or corrupted cache file, or because the schema has not been written to the cache yet. It advises ensuring that the schema is properly written to the cache before attempting to read it. If the schema is successfully read from the cache, it is returned as a parsed object. This function is asynchronous and returns a promise that resolves to the parsed schema object if found, or throws an error if the schema is not found in the cache.
+*
+* @param context - The context object providing access to the file system and cache path.
+* @param input - The input schema from which to extract the variant and hash for locating the cached schema file.
+* @returns A promise that resolves to the parsed schema object if found in the cache, or throws an error if the schema does not exist in the cache.
+* @throws Will throw an error if the schema with the specified variant and hash does not exist in the cache.
+*/
+async function readSchema(context, input) {
+	const schema = await readSchemaSafe(context, input);
+	if (!schema) {
+		const variant = require_extract.extractVariant(input);
+		const hash = require_extract.extractHash(variant, input);
+		throw new Error(`The ${variant} schema with hash "${hash}" does not exist in the cache. This may be due to a missing or corrupted cache file, or because the schema has not been written to the cache yet. Please ensure that the schema is properly written to the cache before attempting to read it.`);
+	}
+	return schema;
+}
+
+//#endregion
+exports.getCacheDirectory = getCacheDirectory;
+exports.getCacheFilePath = getCacheFilePath;
+exports.readSchema = readSchema;
+exports.readSchemaSafe = readSchemaSafe;
+exports.writeSchema = writeSchema;

package/dist/persistence.d.cts

@@ -0,0 +1,47 @@
+import { Schema, SchemaInput, SchemaMetadata } from "./types.cjs";
+import { Context } from "@powerlines/core";
+
+//#region src/persistence.d.ts
+/**
+ * A helper function to get the cache directory path for storing schemas. This function takes a context object as input and returns the path to the cache directory where schemas are stored. The cache directory is constructed by joining the `cachePath` property from the context with a subdirectory named "schemas". This function is useful for centralizing the logic for determining where schema files should be cached, ensuring that all schema-related file operations use a consistent location for storing and retrieving cached schemas.
+ *
+ * @param context - The context object providing access to the cache path.
+ * @returns The path to the cache directory for storing schemas, constructed by joining the context's `cachePath` with the "schemas" subdirectory.
+ */
+declare function getCacheDirectory(context: Context): string;
+/**
+ * A helper function to get the file path for a cached schema based on the provided context and schema input. This function first extracts the variant and hash from the input schema using the `extractVariant` and `extractHash` functions, respectively. It then constructs the file path to the cached schema JSON file by joining the cache directory path (obtained from the `getCacheDirectory` function) with a filename derived from the extracted hash. The resulting file path points to where the cached schema should be stored or retrieved from in the file system. This function is essential for ensuring that all operations related to caching schemas use a consistent method for determining the correct file path based on the schema's unique identifier (hash).
+ *
+ * @param context - The context object providing access to the cache path.
+ * @param input - The input schema from which to extract the variant and hash for constructing the cache file path.
+ * @returns The file path to the cached schema JSON file, constructed by joining the cache directory path with a filename derived from the extracted hash of the schema input.
+ */
+declare function getCacheFilePath(context: Context, input: SchemaInput): string;
+/**
+ * Writes a given schema to the file system using the provided context. This function first checks if the input is a valid schema using the `isSchema` type guard. If the input is not a valid schema, it throws an error indicating that the provided input is invalid. If the input is valid, it proceeds to write the schema to a JSON file in the cache directory specified by the context. The file is named using the hash of the schema to ensure uniqueness and easy retrieval in future operations. The schema is serialized to JSON format before being written to the file system. This function is asynchronous and returns a promise that resolves once the writing operation is complete.
+ *
+ * @param context - The context object providing access to the file system and cache path.
+ * @param schema - The schema to be written to the file system, which must be a valid schema object containing a `variant`, `schema`, and `hash` property.
+ * @throws Will throw an error if the provided input is not a valid schema.
+ */
+declare function writeSchema<TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>, TContext extends Context = Context>(context: TContext, schema: Schema<TMetadata>): Promise<void>;
+/**
+ * A helper function to read a schema from the file system using the provided context. This function first extracts the variant and hash from the input schema using the `extractVariant` and `extractHash` functions, respectively. It then constructs the file path to the cached schema JSON file based on the cache path provided in the context and the extracted hash. The function checks if the file exists in the cache; if it does not exist, it returns `undefined`. If the file exists, it reads the contents of the file, parses it as JSON, and returns the resulting object. This function is asynchronous and returns a promise that resolves to either the parsed schema object or `undefined` if the schema is not found in the cache.
+ *
+ * @param context - The context object providing access to the file system and cache path.
+ * @param input - The input schema from which to extract the variant and hash for locating the cached schema file.
+ * @returns A promise that resolves to the parsed schema object if found in the cache, or `undefined` if the schema does not exist in the cache.
+ */
+declare function readSchemaSafe<TContext extends Context = Context, TMetadata extends SchemaMetadata = SchemaMetadata>(context: TContext, input: SchemaInput): Promise<Schema<TMetadata> | undefined>;
+/**
+ * Reads a schema from the file system using the provided context and input. This function first attempts to read the schema using the `readSchemaSafe` helper function, which returns `undefined` if the schema is not found in the cache. If the schema is not found, this function throws an error indicating that the schema with the specified variant and hash does not exist in the cache. The error message suggests that this may be due to a missing or corrupted cache file, or because the schema has not been written to the cache yet. It advises ensuring that the schema is properly written to the cache before attempting to read it. If the schema is successfully read from the cache, it is returned as a parsed object. This function is asynchronous and returns a promise that resolves to the parsed schema object if found, or throws an error if the schema is not found in the cache.
+ *
+ * @param context - The context object providing access to the file system and cache path.
+ * @param input - The input schema from which to extract the variant and hash for locating the cached schema file.
+ * @returns A promise that resolves to the parsed schema object if found in the cache, or throws an error if the schema does not exist in the cache.
+ * @throws Will throw an error if the schema with the specified variant and hash does not exist in the cache.
+ */
+declare function readSchema<TContext extends Context = Context, TMetadata extends SchemaMetadata = SchemaMetadata>(context: TContext, input: SchemaInput): Promise<Schema<TMetadata>>;
+//#endregion
+export { getCacheDirectory, getCacheFilePath, readSchema, readSchemaSafe, writeSchema };
+//# sourceMappingURL=persistence.d.cts.map

package/dist/persistence.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.cts","names":[],"sources":["../src/persistence.ts"],"mappings":";;;;;;AA8BA;;;;iBAAgB,iBAAA,CAAkB,OAAgB,EAAP,OAAO;AAWlD;;;;;;;AAAA,iBAAgB,gBAAA,CAAiB,OAAA,EAAS,OAAA,EAAS,KAAA,EAAO,WAAW;;AAAA;AAcrE;;;;;iBAAsB,WAAA,mBACF,OAAA,CAAQ,cAAA,IAAkB,OAAA,CAAQ,cAAA,oBACnC,OAAA,GAAU,OAAA,CAAA,CAC3B,OAAA,EAAS,QAAA,EAAU,MAAA,EAAQ,MAAA,CAAO,SAAA,IAAU,OAAA;;;;;;;;iBAoBxB,cAAA,kBACH,OAAA,GAAU,OAAA,oBACT,cAAA,GAAiB,cAAA,CAAA,CAEnC,OAAA,EAAS,QAAA,EACT,KAAA,EAAO,WAAA,GACN,OAAA,CAAQ,MAAA,CAAO,SAAA;;;;;;;;;iBAsBI,UAAA,kBACH,OAAA,GAAU,OAAA,oBACT,cAAA,GAAiB,cAAA,CAAA,CACnC,OAAA,EAAS,QAAA,EAAU,KAAA,EAAO,WAAA,GAAc,OAAA,CAAQ,MAAA,CAAO,SAAA"}