@powerlines/schema 0.11.45 → 0.11.46

package/dist/metadata.mjs

@@ -10,43 +10,17 @@ import { isSetObject as isSetObject$1 } from "@stryke/type-checks/is-set-object"
 * @param metadata - The Powerlines schema metadata to apply.
 * @returns A new JSON Schema fragment with the metadata applied.
 */
-function applySchemaMetadata(schema, metadata) {
-	if (!metadata) return schema;
+function applyJsonSchemaMetadata(schema, metadata) {
+	if (!metadata || !isSetObject$1(schema)) return schema;
 	const result = { ...schema };
+	const mutableResult = result;
 	for (const key of JSON_SCHEMA_METADATA_KEYS) {
 		const value = metadata[key];
-		if (value !== void 0 && value !== null) result[key] = value;
+		if (value !== void 0 && value !== null) mutableResult[key] = value;
 	}
 	return result;
 }
 /**
-* Returns whether a JSON Schema fragment accepts `null`.
-*
-* @remarks
-* This is true if the schema has `nullable: true` or if its `type` includes `"null"`.
-*
-* @param schema - The JSON Schema fragment to check.
-* @returns `true` if the schema accepts `null`, otherwise `false`.
-*/
-function isSchemaNullable(schema) {
-	if (!isSetObject$1(schema)) return false;
-	if (schema.nullable === true) return true;
-	return readSchemaTypes(schema).includes("null");
-}
-/**
-* Returns whether an object property is optional (not listed in `required`).
-*
-* @remarks
-* In JSON Schema, object properties are optional by default unless they are listed in the `required` array of the parent schema. This function checks whether a given property name is not included in the `required` array of its parent schema, indicating that it is optional.
-*
-* @param parent - The parent JSON Schema object containing the property.
-* @param propertyName - The name of the property to check for optionality.
-* @returns `true` if the property is optional, otherwise `false`.
-*/
-function isPropertyOptional(parent, propertyName) {
-	return !(parent.required ?? []).includes(propertyName) && !isSchemaNullable(parent.properties[propertyName]);
-}
-/**
 * Normalizes the JSON Schema `type` keyword to a string array.
 *
 * @remarks
@@ -56,8 +30,10 @@ function isPropertyOptional(parent, propertyName) {
 * @returns An array of JSON Schema primitive type names defined in the `type` keyword, or an empty array if no valid types are found.
 */
 function readSchemaTypes(schema) {
-	if (Array.isArray(schema?.type)) return schema.type.filter(isSetString);
-	if (isSetString(schema?.type)) return [schema.type];
+	if (!isSetObject$1(schema)) return [];
+	const objectSchema = schema;
+	if (Array.isArray(objectSchema.type)) return objectSchema.type.filter((type) => isSetString(type));
+	if (isSetString(objectSchema.type) && objectSchema.type !== "object" && objectSchema.type !== "array") return [objectSchema.type];
 	return [];
 }
 /**
@@ -72,5 +48,5 @@ function getPrimarySchemaType(schema) {
 }
 
 //#endregion
-export { applySchemaMetadata, getPrimarySchemaType, isPropertyOptional, isSchemaNullable, readSchemaTypes };
+export { applyJsonSchemaMetadata, getPrimarySchemaType, readSchemaTypes };
 //# sourceMappingURL=metadata.mjs.map

package/dist/metadata.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.mjs","names":["isSetObject"],"sources":["../src/metadata.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 { isSetString } from \"@stryke/type-checks\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { JSON_SCHEMA_METADATA_KEYS } from \"./constants\";\nimport {\n  JsonSchema,\n  JsonSchemaNullable,\n  JsonSchemaObject,\n  JsonSchemaPrimitiveType,\n  SchemaMetadata\n} from \"./types\";\n\n/**\n * Applies Powerlines schema metadata onto a JSON Schema fragment.\n *\n * @param schema - The JSON Schema fragment to apply metadata to.\n * @param metadata - The Powerlines schema metadata to apply.\n * @returns A new JSON Schema fragment with the metadata applied.\n */\nexport function applySchemaMetadata<\n  T = unknown,\n  TMetadata extends SchemaMetadata = SchemaMetadata\n>(schema: JsonSchema<T>, metadata: TMetadata | undefined): JsonSchema<T> {\n  if (!metadata) {\n    return schema;\n  }\n\n  const result: JsonSchema<T> = { ...schema };\n  for (const key of JSON_SCHEMA_METADATA_KEYS) {\n    const value = metadata[key];\n    if (value !== undefined && value !== null) {\n      result[key as keyof JsonSchema<T>] = value;\n    }\n  }\n\n  return result;\n}\n\n/**\n * Returns whether a JSON Schema fragment accepts `null`.\n *\n * @remarks\n * This is true if the schema has `nullable: true` or if its `type` includes `\"null\"`.\n *\n * @param schema - The JSON Schema fragment to check.\n * @returns `true` if the schema accepts `null`, otherwise `false`.\n */\nexport function isSchemaNullable<T = unknown>(schema?: JsonSchema<T>): boolean {\n  if (!isSetObject(schema)) {\n    return false;\n  }\n\n  if ((schema as JsonSchemaNullable<T>).nullable === true) {\n    return true;\n  }\n\n  const types = readSchemaTypes(schema);\n\n  return types.includes(\"null\");\n}\n\n/**\n * Returns whether an object property is optional (not listed in `required`).\n *\n * @remarks\n * In JSON Schema, object properties are optional by default unless they are listed in the `required` array of the parent schema. This function checks whether a given property name is not included in the `required` array of its parent schema, indicating that it is optional.\n *\n * @param parent - The parent JSON Schema object containing the property.\n * @param propertyName - The name of the property to check for optionality.\n * @returns `true` if the property is optional, otherwise `false`.\n */\nexport function isPropertyOptional<\n  T extends Record<string, any> = Record<string, any>\n>(parent: JsonSchemaObject<T>, propertyName: string): boolean {\n  const required = parent.required ?? [];\n\n  return (\n    !required.includes(propertyName) &&\n    !isSchemaNullable<T>(parent.properties[propertyName] as JsonSchema<T>)\n  );\n}\n\n/**\n * Normalizes the JSON Schema `type` keyword to a string array.\n *\n * @remarks\n * This function ensures that the `type` keyword of a JSON Schema fragment is always represented as an array of strings, even if it was originally defined as a single string. This normalization simplifies type checking and processing of JSON Schemas by providing a consistent format for the `type` information.\n *\n * @param schema - The JSON Schema fragment to read types from.\n * @returns An array of JSON Schema primitive type names defined in the `type` keyword, or an empty array if no valid types are found.\n */\nexport function readSchemaTypes<T = unknown>(\n  schema?: JsonSchema<T>\n): JsonSchemaPrimitiveType[] {\n  if (Array.isArray(schema?.type)) {\n    return schema.type.filter(isSetString) as JsonSchemaPrimitiveType[];\n  }\n  if (isSetString(schema?.type)) {\n    return [schema.type as JsonSchemaPrimitiveType];\n  }\n  return [];\n}\n\n/**\n * Returns the primary non-null JSON Schema type name for a fragment.\n *\n * @param schema - The JSON Schema fragment to check.\n * @returns The primary non-null JSON Schema type name, or `undefined` if none is found.\n */\nexport function getPrimarySchemaType<T = unknown>(\n  schema?: JsonSchema<T>\n): JsonSchemaPrimitiveType | undefined {\n  if (!isSetObject(schema)) {\n    return undefined;\n  }\n\n  return readSchemaTypes(schema).find(type => type !== \"null\");\n}\n"],"mappings":";;;;;;;;;;;;AAoCA,SAAgB,oBAGd,QAAuB,UAAgD;CACvE,IAAI,CAAC,UACH,OAAO;CAGT,MAAM,SAAwB,EAAE,GAAG,OAAO;CAC1C,KAAK,MAAM,OAAO,2BAA2B;EAC3C,MAAM,QAAQ,SAAS;EACvB,IAAI,UAAU,UAAa,UAAU,MACnC,OAAO,OAA8B;CAEzC;CAEA,OAAO;AACT;;;;;;;;;;AAWA,SAAgB,iBAA8B,QAAiC;CAC7E,IAAI,CAACA,cAAY,MAAM,GACrB,OAAO;CAGT,IAAK,OAAiC,aAAa,MACjD,OAAO;CAKT,OAFc,gBAAgB,MAEnB,EAAE,SAAS,MAAM;AAC9B;;;;;;;;;;;AAYA,SAAgB,mBAEd,QAA6B,cAA+B;CAG5D,OACE,EAHe,OAAO,YAAY,CAAC,GAGzB,SAAS,YAAY,KAC/B,CAAC,iBAAoB,OAAO,WAAW,aAA8B;AAEzE;;;;;;;;;;AAWA,SAAgB,gBACd,QAC2B;CAC3B,IAAI,MAAM,QAAQ,QAAQ,IAAI,GAC5B,OAAO,OAAO,KAAK,OAAO,WAAW;CAEvC,IAAI,YAAY,QAAQ,IAAI,GAC1B,OAAO,CAAC,OAAO,IAA+B;CAEhD,OAAO,CAAC;AACV;;;;;;;AAQA,SAAgB,qBACd,QACqC;CACrC,IAAI,CAACA,cAAY,MAAM,GACrB;CAGF,OAAO,gBAAgB,MAAM,EAAE,MAAK,SAAQ,SAAS,MAAM;AAC7D"}
+{"version":3,"file":"metadata.mjs","names":["isSetObject"],"sources":["../src/metadata.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 { isSetString } from \"@stryke/type-checks\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { JSON_SCHEMA_METADATA_KEYS } from \"./constants\";\nimport {\n  JsonSchema,\n  JsonSchemaMetadataKeywords,\n  JsonSchemaPrimitiveType,\n  JsonSchemaType\n} from \"./types\";\n\ninterface JsonSchemaTypeView {\n  type?: JsonSchemaType | readonly JsonSchemaType[];\n}\n\n/**\n * Applies Powerlines schema metadata onto a JSON Schema fragment.\n *\n * @param schema - The JSON Schema fragment to apply metadata to.\n * @param metadata - The Powerlines schema metadata to apply.\n * @returns A new JSON Schema fragment with the metadata applied.\n */\nexport function applyJsonSchemaMetadata(\n  schema: JsonSchema,\n  metadata: JsonSchemaMetadataKeywords | undefined\n): JsonSchema {\n  if (!metadata || !isSetObject(schema)) {\n    return schema;\n  }\n\n  const result: JsonSchema = { ...schema };\n  const mutableResult = result as Record<string, unknown>;\n  for (const key of JSON_SCHEMA_METADATA_KEYS) {\n    const value = metadata[key];\n    if (value !== undefined && value !== null) {\n      mutableResult[key] = value;\n    }\n  }\n\n  return result;\n}\n\n/**\n * Normalizes the JSON Schema `type` keyword to a string array.\n *\n * @remarks\n * This function ensures that the `type` keyword of a JSON Schema fragment is always represented as an array of strings, even if it was originally defined as a single string. This normalization simplifies type checking and processing of JSON Schemas by providing a consistent format for the `type` information.\n *\n * @param schema - The JSON Schema fragment to read types from.\n * @returns An array of JSON Schema primitive type names defined in the `type` keyword, or an empty array if no valid types are found.\n */\nexport function readSchemaTypes(\n  schema?: JsonSchema\n): JsonSchemaPrimitiveType[] {\n  if (!isSetObject(schema)) {\n    return [];\n  }\n\n  const objectSchema = schema as JsonSchemaTypeView;\n\n  if (Array.isArray(objectSchema.type)) {\n    return objectSchema.type.filter(\n      (type: JsonSchemaPrimitiveType): type is JsonSchemaPrimitiveType =>\n        isSetString(type)\n    );\n  }\n  if (\n    isSetString(objectSchema.type) &&\n    objectSchema.type !== \"object\" &&\n    objectSchema.type !== \"array\"\n  ) {\n    return [objectSchema.type];\n  }\n  return [];\n}\n\n/**\n * Returns the primary non-null JSON Schema type name for a fragment.\n *\n * @param schema - The JSON Schema fragment to check.\n * @returns The primary non-null JSON Schema type name, or `undefined` if none is found.\n */\nexport function getPrimarySchemaType(\n  schema?: JsonSchema\n): JsonSchemaPrimitiveType | undefined {\n  if (!isSetObject(schema)) {\n    return undefined;\n  }\n\n  return readSchemaTypes(schema).find(type => type !== \"null\");\n}\n"],"mappings":";;;;;;;;;;;;AAuCA,SAAgB,wBACd,QACA,UACY;CACZ,IAAI,CAAC,YAAY,CAACA,cAAY,MAAM,GAClC,OAAO;CAGT,MAAM,SAAqB,EAAE,GAAG,OAAO;CACvC,MAAM,gBAAgB;CACtB,KAAK,MAAM,OAAO,2BAA2B;EAC3C,MAAM,QAAQ,SAAS;EACvB,IAAI,UAAU,UAAa,UAAU,MACnC,cAAc,OAAO;CAEzB;CAEA,OAAO;AACT;;;;;;;;;;AAWA,SAAgB,gBACd,QAC2B;CAC3B,IAAI,CAACA,cAAY,MAAM,GACrB,OAAO,CAAC;CAGV,MAAM,eAAe;CAErB,IAAI,MAAM,QAAQ,aAAa,IAAI,GACjC,OAAO,aAAa,KAAK,QACtB,SACC,YAAY,IAAI,CACpB;CAEF,IACE,YAAY,aAAa,IAAI,KAC7B,aAAa,SAAS,YACtB,aAAa,SAAS,SAEtB,OAAO,CAAC,aAAa,IAAI;CAE3B,OAAO,CAAC;AACV;;;;;;;AAQA,SAAgB,qBACd,QACqC;CACrC,IAAI,CAACA,cAAY,MAAM,GACrB;CAGF,OAAO,gBAAgB,MAAM,EAAE,MAAK,SAAQ,SAAS,MAAM;AAC7D"}

package/dist/persistence.d.cts

@@ -16,7 +16,7 @@ declare function getCacheDirectory(context: Context): string;
  * @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<T = unknown>(context: Context, input: SchemaInput<T>): string;
+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.
  *
@@ -24,7 +24,7 @@ declare function getCacheFilePath<T = unknown>(context: Context, input: SchemaIn
  * @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<T = unknown>(context: Context, schema: Schema<T>): Promise<void>;
+declare function writeSchema(context: Context, schema: Schema): 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.
  *
@@ -32,7 +32,7 @@ declare function writeSchema<T = unknown>(context: Context, schema: Schema<T>):
  * @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<T = unknown>(context: Context, input: SchemaInput<T>): Promise<Schema<T> | undefined>;
+declare function readSchemaSafe(context: Context, input: SchemaInput): Promise<Schema | 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.
  *
@@ -41,7 +41,7 @@ declare function readSchemaSafe<T = unknown>(context: Context, input: SchemaInpu
  * @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<T = unknown>(context: Context, input: SchemaInput<T>): Promise<Schema<T>>;
+declare function readSchema(context: Context, input: SchemaInput): Promise<Schema>;
 //#endregion
 export { getCacheDirectory, getCacheFilePath, readSchema, readSchemaSafe, writeSchema };
 //# sourceMappingURL=persistence.d.cts.map

package/dist/persistence.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.d.cts","names":[],"sources":["../src/persistence.ts"],"mappings":";;;;;;AA8BA;;;;iBAAgB,iBAAA,CAAkB,OAAgB,EAAP,OAAO;AAWlD;;;;;;;AAAA,iBAAgB,gBAAA,aAAA,CACd,OAAA,EAAS,OAAA,EACT,KAAA,EAAO,WAAA,CAAY,CAAA;;;;;;;;iBAeC,WAAA,aAAA,CACpB,OAAA,EAAS,OAAA,EACT,MAAA,EAAQ,MAAA,CAAO,CAAA,IAAE,OAAA;AAFnB;;;;;;;AAAA,iBAuBsB,cAAA,aAAA,CACpB,OAAA,EAAS,OAAA,EACT,KAAA,EAAO,WAAA,CAAY,CAAA,IAClB,OAAA,CAAQ,MAAA,CAAO,CAAA;;;;;;;;;iBAsBI,UAAA,aAAA,CACpB,OAAA,EAAS,OAAA,EACT,KAAA,EAAO,WAAA,CAAY,CAAA,IAClB,OAAA,CAAQ,MAAA,CAAO,CAAA"}
+{"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,CAAY,OAAA,EAAS,OAAA,EAAS,MAAA,EAAQ,MAAA,GAAM,OAAA;;;;;;;;iBAoB5C,cAAA,CACpB,OAAA,EAAS,OAAA,EACT,KAAA,EAAO,WAAA,GACN,OAAA,CAAQ,MAAA;AAvBuD;AAoBlE;;;;;;;AApBkE,iBA6C5C,UAAA,CACpB,OAAA,EAAS,OAAA,EACT,KAAA,EAAO,WAAA,GACN,OAAA,CAAQ,MAAA"}

package/dist/persistence.d.mts

@@ -16,7 +16,7 @@ declare function getCacheDirectory(context: Context): string;
  * @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<T = unknown>(context: Context, input: SchemaInput<T>): string;
+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.
  *
@@ -24,7 +24,7 @@ declare function getCacheFilePath<T = unknown>(context: Context, input: SchemaIn
  * @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<T = unknown>(context: Context, schema: Schema<T>): Promise<void>;
+declare function writeSchema(context: Context, schema: Schema): 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.
  *
@@ -32,7 +32,7 @@ declare function writeSchema<T = unknown>(context: Context, schema: Schema<T>):
  * @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<T = unknown>(context: Context, input: SchemaInput<T>): Promise<Schema<T> | undefined>;
+declare function readSchemaSafe(context: Context, input: SchemaInput): Promise<Schema | 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.
  *
@@ -41,7 +41,7 @@ declare function readSchemaSafe<T = unknown>(context: Context, input: SchemaInpu
  * @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<T = unknown>(context: Context, input: SchemaInput<T>): Promise<Schema<T>>;
+declare function readSchema(context: Context, input: SchemaInput): Promise<Schema>;
 //#endregion
 export { getCacheDirectory, getCacheFilePath, readSchema, readSchemaSafe, writeSchema };
 //# sourceMappingURL=persistence.d.mts.map

package/dist/persistence.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.d.mts","names":[],"sources":["../src/persistence.ts"],"mappings":";;;;;;AA8BA;;;;iBAAgB,iBAAA,CAAkB,OAAgB,EAAP,OAAO;AAWlD;;;;;;;AAAA,iBAAgB,gBAAA,aAAA,CACd,OAAA,EAAS,OAAA,EACT,KAAA,EAAO,WAAA,CAAY,CAAA;;;;;;;;iBAeC,WAAA,aAAA,CACpB,OAAA,EAAS,OAAA,EACT,MAAA,EAAQ,MAAA,CAAO,CAAA,IAAE,OAAA;AAFnB;;;;;;;AAAA,iBAuBsB,cAAA,aAAA,CACpB,OAAA,EAAS,OAAA,EACT,KAAA,EAAO,WAAA,CAAY,CAAA,IAClB,OAAA,CAAQ,MAAA,CAAO,CAAA;;;;;;;;;iBAsBI,UAAA,aAAA,CACpB,OAAA,EAAS,OAAA,EACT,KAAA,EAAO,WAAA,CAAY,CAAA,IAClB,OAAA,CAAQ,MAAA,CAAO,CAAA"}
+{"version":3,"file":"persistence.d.mts","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,CAAY,OAAA,EAAS,OAAA,EAAS,MAAA,EAAQ,MAAA,GAAM,OAAA;;;;;;;;iBAoB5C,cAAA,CACpB,OAAA,EAAS,OAAA,EACT,KAAA,EAAO,WAAA,GACN,OAAA,CAAQ,MAAA;AAvBuD;AAoBlE;;;;;;;AApBkE,iBA6C5C,UAAA,CACpB,OAAA,EAAS,OAAA,EACT,KAAA,EAAO,WAAA,GACN,OAAA,CAAQ,MAAA"}

package/dist/persistence.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.mjs","names":[],"sources":["../src/persistence.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 type { Context } from \"@powerlines/core\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { extractHash, extractVariant } from \"./extract\";\nimport { isSchema } from \"./type-checks\";\nimport { Schema, SchemaInput } from \"./types\";\n\n/**\n * 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.\n *\n * @param context - The context object providing access to the cache path.\n * @returns The path to the cache directory for storing schemas, constructed by joining the context's `cachePath` with the \"schemas\" subdirectory.\n */\nexport function getCacheDirectory(context: Context): string {\n  return joinPaths(context.cachePath, \"schemas\");\n}\n\n/**\n * 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).\n *\n * @param context - The context object providing access to the cache path.\n * @param input - The input schema from which to extract the variant and hash for constructing the cache file path.\n * @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.\n */\nexport function getCacheFilePath<T = unknown>(\n  context: Context,\n  input: SchemaInput<T>\n): string {\n  const variant = extractVariant(input);\n  const hash = extractHash(variant, input);\n\n  return joinPaths(getCacheDirectory(context), `${hash}.json`);\n}\n\n/**\n * 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.\n *\n * @param context - The context object providing access to the file system and cache path.\n * @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.\n * @throws Will throw an error if the provided input is not a valid schema.\n */\nexport async function writeSchema<T = unknown>(\n  context: Context,\n  schema: Schema<T>\n) {\n  if (!isSchema<T>(schema)) {\n    throw new Error(\n      `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 JSON Schema object.`\n    );\n  }\n\n  await context.fs.write(\n    getCacheFilePath(context, schema),\n    JSON.stringify(schema.schema)\n  );\n}\n\n/**\n * 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.\n *\n * @param context - The context object providing access to the file system and cache path.\n * @param input - The input schema from which to extract the variant and hash for locating the cached schema file.\n * @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.\n */\nexport async function readSchemaSafe<T = unknown>(\n  context: Context,\n  input: SchemaInput<T>\n): Promise<Schema<T> | undefined> {\n  const cacheFilePath = getCacheFilePath(context, input);\n  if (!(await context.fs.exists(cacheFilePath))) {\n    return undefined;\n  }\n\n  const data = await context.fs.read(cacheFilePath);\n  if (!data) {\n    return undefined;\n  }\n\n  return JSON.parse(data);\n}\n\n/**\n * 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.\n *\n * @param context - The context object providing access to the file system and cache path.\n * @param input - The input schema from which to extract the variant and hash for locating the cached schema file.\n * @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.\n * @throws Will throw an error if the schema with the specified variant and hash does not exist in the cache.\n */\nexport async function readSchema<T = unknown>(\n  context: Context,\n  input: SchemaInput<T>\n): Promise<Schema<T>> {\n  const schema = await readSchemaSafe<T>(context, input);\n  if (!schema) {\n    const variant = extractVariant(input);\n    const hash = extractHash(variant, input);\n\n    throw new Error(\n      `The ${variant} schema with hash \"${\n        hash\n      }\" 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.`\n    );\n  }\n\n  return schema;\n}\n"],"mappings":";;;;;;;;;;;AA8BA,SAAgB,kBAAkB,SAA0B;CAC1D,OAAO,UAAU,QAAQ,WAAW,SAAS;AAC/C;;;;;;;;AASA,SAAgB,iBACd,SACA,OACQ;CAER,MAAM,OAAO,YADG,eAAe,KACA,GAAG,KAAK;CAEvC,OAAO,UAAU,kBAAkB,OAAO,GAAG,GAAG,KAAK,MAAM;AAC7D;;;;;;;;AASA,eAAsB,YACpB,SACA,QACA;CACA,IAAI,CAAC,SAAY,MAAM,GACrB,MAAM,IAAI,MACR,4LACF;CAGF,MAAM,QAAQ,GAAG,MACf,iBAAiB,SAAS,MAAM,GAChC,KAAK,UAAU,OAAO,MAAM,CAC9B;AACF;;;;;;;;AASA,eAAsB,eACpB,SACA,OACgC;CAChC,MAAM,gBAAgB,iBAAiB,SAAS,KAAK;CACrD,IAAI,CAAE,MAAM,QAAQ,GAAG,OAAO,aAAa,GACzC;CAGF,MAAM,OAAO,MAAM,QAAQ,GAAG,KAAK,aAAa;CAChD,IAAI,CAAC,MACH;CAGF,OAAO,KAAK,MAAM,IAAI;AACxB;;;;;;;;;AAUA,eAAsB,WACpB,SACA,OACoB;CACpB,MAAM,SAAS,MAAM,eAAkB,SAAS,KAAK;CACrD,IAAI,CAAC,QAAQ;EACX,MAAM,UAAU,eAAe,KAAK;EACpC,MAAM,OAAO,YAAY,SAAS,KAAK;EAEvC,MAAM,IAAI,MACR,OAAO,QAAQ,qBACb,KACD,+OACH;CACF;CAEA,OAAO;AACT"}
+{"version":3,"file":"persistence.mjs","names":[],"sources":["../src/persistence.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 type { Context } from \"@powerlines/core\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { extractHash, extractVariant } from \"./extract\";\nimport { isSchema } from \"./type-checks\";\nimport { Schema, SchemaInput } from \"./types\";\n\n/**\n * 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.\n *\n * @param context - The context object providing access to the cache path.\n * @returns The path to the cache directory for storing schemas, constructed by joining the context's `cachePath` with the \"schemas\" subdirectory.\n */\nexport function getCacheDirectory(context: Context): string {\n  return joinPaths(context.cachePath, \"schemas\");\n}\n\n/**\n * 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).\n *\n * @param context - The context object providing access to the cache path.\n * @param input - The input schema from which to extract the variant and hash for constructing the cache file path.\n * @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.\n */\nexport function getCacheFilePath(context: Context, input: SchemaInput): string {\n  const variant = extractVariant(input);\n  const hash = extractHash(variant, input);\n\n  return joinPaths(getCacheDirectory(context), `${hash}.json`);\n}\n\n/**\n * 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.\n *\n * @param context - The context object providing access to the file system and cache path.\n * @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.\n * @throws Will throw an error if the provided input is not a valid schema.\n */\nexport async function writeSchema(context: Context, schema: Schema) {\n  if (!isSchema(schema)) {\n    throw new Error(\n      `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 JSON Schema object.`\n    );\n  }\n\n  await context.fs.write(\n    getCacheFilePath(context, schema),\n    JSON.stringify(schema.schema)\n  );\n}\n\n/**\n * 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.\n *\n * @param context - The context object providing access to the file system and cache path.\n * @param input - The input schema from which to extract the variant and hash for locating the cached schema file.\n * @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.\n */\nexport async function readSchemaSafe(\n  context: Context,\n  input: SchemaInput\n): Promise<Schema | undefined> {\n  const cacheFilePath = getCacheFilePath(context, input);\n  if (!(await context.fs.exists(cacheFilePath))) {\n    return undefined;\n  }\n\n  const data = await context.fs.read(cacheFilePath);\n  if (!data) {\n    return undefined;\n  }\n\n  return JSON.parse(data);\n}\n\n/**\n * 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.\n *\n * @param context - The context object providing access to the file system and cache path.\n * @param input - The input schema from which to extract the variant and hash for locating the cached schema file.\n * @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.\n * @throws Will throw an error if the schema with the specified variant and hash does not exist in the cache.\n */\nexport async function readSchema(\n  context: Context,\n  input: SchemaInput\n): Promise<Schema> {\n  const schema = await readSchemaSafe(context, input);\n  if (!schema) {\n    const variant = extractVariant(input);\n    const hash = extractHash(variant, input);\n\n    throw new Error(\n      `The ${variant} schema with hash \"${\n        hash\n      }\" 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.`\n    );\n  }\n\n  return schema;\n}\n"],"mappings":";;;;;;;;;;;AA8BA,SAAgB,kBAAkB,SAA0B;CAC1D,OAAO,UAAU,QAAQ,WAAW,SAAS;AAC/C;;;;;;;;AASA,SAAgB,iBAAiB,SAAkB,OAA4B;CAE7E,MAAM,OAAO,YADG,eAAe,KACA,GAAG,KAAK;CAEvC,OAAO,UAAU,kBAAkB,OAAO,GAAG,GAAG,KAAK,MAAM;AAC7D;;;;;;;;AASA,eAAsB,YAAY,SAAkB,QAAgB;CAClE,IAAI,CAAC,SAAS,MAAM,GAClB,MAAM,IAAI,MACR,4LACF;CAGF,MAAM,QAAQ,GAAG,MACf,iBAAiB,SAAS,MAAM,GAChC,KAAK,UAAU,OAAO,MAAM,CAC9B;AACF;;;;;;;;AASA,eAAsB,eACpB,SACA,OAC6B;CAC7B,MAAM,gBAAgB,iBAAiB,SAAS,KAAK;CACrD,IAAI,CAAE,MAAM,QAAQ,GAAG,OAAO,aAAa,GACzC;CAGF,MAAM,OAAO,MAAM,QAAQ,GAAG,KAAK,aAAa;CAChD,IAAI,CAAC,MACH;CAGF,OAAO,KAAK,MAAM,IAAI;AACxB;;;;;;;;;AAUA,eAAsB,WACpB,SACA,OACiB;CACjB,MAAM,SAAS,MAAM,eAAe,SAAS,KAAK;CAClD,IAAI,CAAC,QAAQ;EACX,MAAM,UAAU,eAAe,KAAK;EACpC,MAAM,OAAO,YAAY,SAAS,KAAK;EAEvC,MAAM,IAAI,MACR,OAAO,QAAQ,qBACb,KACD,+OACH;CACF;CAEA,OAAO;AACT"}

package/dist/reflection.cjs

@@ -1,5 +1,6 @@
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 const require_type_checks = require('./type-checks.cjs');
+const require_codegen = require('./codegen.cjs');
 let defu = require("defu");
 defu = require_runtime.__toESM(defu, 1);
 let _stryke_type_checks = require("@stryke/type-checks");
@@ -66,20 +67,25 @@ function numberBrandToJsonSchema(brand) {
 	}
 }
 function withReflectionTags(reflection, schema) {
-	if (!(0, _stryke_type_checks.isSetObject)(reflection?.tags)) return schema;
+	if (!(0, _stryke_type_checks.isSetObject)(schema) || !(0, _stryke_type_checks.isSetObject)(reflection?.tags)) return schema;
+	const updatedSchema = { ...schema };
 	const tags = reflection.tags;
-	if ((0, _stryke_type_checks.isSetString)(tags.title)) schema.title = tags.title;
-	if ((0, _stryke_type_checks.isSetArray)(tags.alias)) schema.alias = tags.alias;
-	if (!(0, _stryke_type_checks.isUndefined)(tags.hidden)) schema.hidden = tags.hidden;
-	if (!(0, _stryke_type_checks.isUndefined)(tags.ignore)) schema.ignore = tags.ignore;
-	if (!(0, _stryke_type_checks.isUndefined)(tags.internal)) schema.internal = tags.internal;
-	if (!(0, _stryke_type_checks.isUndefined)(tags.runtime)) schema.runtime = tags.runtime;
-	if (!(0, _stryke_type_checks.isUndefined)(tags.readonly)) schema.readOnly = tags.readonly;
-	return schema;
+	if ((0, _stryke_type_checks.isSetString)(tags.title)) updatedSchema.title = tags.title;
+	if ((0, _stryke_type_checks.isSetArray)(tags.alias)) updatedSchema.alias = tags.alias;
+	if (!(0, _stryke_type_checks.isUndefined)(tags.hidden)) updatedSchema.hidden = tags.hidden;
+	if (!(0, _stryke_type_checks.isUndefined)(tags.ignore)) updatedSchema.ignore = tags.ignore;
+	if (!(0, _stryke_type_checks.isUndefined)(tags.internal)) updatedSchema.internal = tags.internal;
+	if (!(0, _stryke_type_checks.isUndefined)(tags.runtime)) updatedSchema.runtime = tags.runtime;
+	if (!(0, _stryke_type_checks.isUndefined)(tags.readonly)) updatedSchema.readOnly = tags.readonly;
+	return updatedSchema;
 }
-function withNullable(schema, nullable) {
-	if (!nullable) return schema;
-	const types = Array.isArray(schema.type) ? [...schema.type] : schema.type ? [schema.type] : [];
+function withNullable(schema) {
+	if (!(0, _stryke_type_checks.isSetObject)(schema)) return { anyOf: [schema, {
+		type: "null",
+		default: null
+	}] };
+	const rawType = schema.type;
+	const types = Array.isArray(rawType) ? [...rawType] : rawType ? [rawType] : [];
 	if (!types.includes("null")) types.push("null");
 	return {
 		...schema,
@@ -103,7 +109,7 @@ function reflectionToJsonSchemaInner(reflection) {
 		case _powerlines_deepkit_vendor_type.ReflectionKind.null: return withReflectionTags(reflection, {
 			type: "null",
 			name: reflection.typeName,
-			nullable: true
+			default: null
 		});
 		case _powerlines_deepkit_vendor_type.ReflectionKind.string: return withReflectionTags(reflection, {
 			type: "string",
@@ -117,8 +123,7 @@ function reflectionToJsonSchemaInner(reflection) {
 		case _powerlines_deepkit_vendor_type.ReflectionKind.bigint: return withReflectionTags(reflection, {
 			type: "integer",
 			name: reflection.typeName,
-			format: "int64",
-			multipleOf: 1
+			format: "int64"
 		});
 		case _powerlines_deepkit_vendor_type.ReflectionKind.regexp: return withReflectionTags(reflection, {
 			type: "string",
@@ -128,37 +133,42 @@ function reflectionToJsonSchemaInner(reflection) {
 		});
 		case _powerlines_deepkit_vendor_type.ReflectionKind.literal: {
 			const { literal } = reflection;
-			if (typeof literal === "string" || typeof literal === "number" || typeof literal === "boolean") return withReflectionTags(reflection, {
-				type: typeof literal,
-				name: reflection.typeName,
-				const: literal
-			});
-			if (typeof literal === "bigint") return withReflectionTags(reflection, {
+			if ((0, _stryke_type_checks.isBigInt)(literal)) return withReflectionTags(reflection, {
 				type: "integer",
 				name: reflection.typeName,
 				format: "int64",
-				multipleOf: 1,
-				const: String(literal)
+				const: literal
 			});
-			if (literal instanceof RegExp) return withReflectionTags(reflection, {
+			if ((0, _stryke_type_checks.isRegExp)(literal)) return withReflectionTags(reflection, {
 				type: "string",
 				name: reflection.typeName,
 				format: "regex",
 				const: literal.source
 			});
-			return withReflectionTags(reflection, { name: reflection.typeName });
+			return withReflectionTags(reflection, {
+				type: require_codegen.getJsonSchemaType(literal),
+				name: reflection.typeName,
+				const: literal
+			});
 		}
 		case _powerlines_deepkit_vendor_type.ReflectionKind.templateLiteral: return withReflectionTags(reflection, { type: "string" });
 		case _powerlines_deepkit_vendor_type.ReflectionKind.enum: {
-			const values = reflection.values.filter((value) => typeof value === "string" || typeof value === "number" || typeof value === "boolean");
+			const values = reflection.values.filter((value) => (0, _stryke_type_checks.isString)(value) || (0, _stryke_type_checks.isInteger)(value) || (0, _stryke_type_checks.isBigInt)(value) || (0, _stryke_type_checks.isNumber)(value) || (0, _stryke_type_checks.isBoolean)(value) || (0, _stryke_type_checks.isNull)(value));
 			if (values.length === 0) return withReflectionTags(reflection, {
 				name: reflection.typeName,
-				description: reflection.description
+				description: reflection.description,
+				enum: []
 			});
 			return withReflectionTags(reflection, {
+				type: values.every((value) => (0, _stryke_type_checks.isString)(value)) ? "string" : values.every((value) => (0, _stryke_type_checks.isInteger)(value) || (0, _stryke_type_checks.isBigInt)(value)) ? "integer" : values.every((value) => (0, _stryke_type_checks.isNumber)(value)) ? "number" : values.every((value) => (0, _stryke_type_checks.isBoolean)(value)) ? "boolean" : values.every((value) => (0, _stryke_type_checks.isNull)(value)) ? "null" : values.reduce((ret, value) => {
+					const type = require_codegen.getJsonSchemaType(value);
+					if (require_type_checks.isJsonSchemaPrimitiveType(type) && !ret.includes(type)) ret.push(type);
+					return ret;
+				}, []),
 				name: reflection.typeName,
 				description: reflection.description,
-				enum: values
+				enum: values,
+				default: values.length === 1 ? values[0] : void 0
 			});
 		}
 		case _powerlines_deepkit_vendor_type.ReflectionKind.array: {
@@ -174,50 +184,63 @@ function reflectionToJsonSchemaInner(reflection) {
 			if (items.length <= 1) return withReflectionTags(reflection, {
 				type: "array",
 				name: reflection.typeName,
-				items: items[0] ?? {}
+				items: items.length === 1 ? items[0] : {}
 			});
 			return withReflectionTags(reflection, {
 				type: "array",
 				name: reflection.typeName,
-				items,
+				prefixItems: items,
 				minItems: items.length,
 				maxItems: items.length
 			});
 		}
 		case _powerlines_deepkit_vendor_type.ReflectionKind.union: {
-			const branches = reflection.types.map((inner) => reflectionToJsonSchemaInner(inner)).filter(require_type_checks.isJsonSchema);
-			const nullable = reflection.types.some((inner) => inner.kind === _powerlines_deepkit_vendor_type.ReflectionKind.null || inner.kind === _powerlines_deepkit_vendor_type.ReflectionKind.undefined);
-			const nonNull = branches.filter((branch) => branch.type !== "null" && !require_type_checks.isNullOnlyJsonSchema(branch));
+			const branches = reflection.types.map((inner) => reflectionToJsonSchemaInner(inner)).filter((branch) => branch !== void 0);
+			if (!reflection.types.some((inner) => inner.kind === _powerlines_deepkit_vendor_type.ReflectionKind.null || inner.kind === _powerlines_deepkit_vendor_type.ReflectionKind.undefined)) return withReflectionTags(reflection, {
+				name: reflection.typeName,
+				anyOf: branches
+			});
+			const nonNull = branches.filter((branch) => !require_type_checks.isNullOnlyJsonSchema(branch));
 			if (nonNull.length === 0) return withReflectionTags(reflection, {
 				type: "null",
-				nullable: true
+				default: null
 			});
-			if (nonNull.length === 1) return withNullable(withReflectionTags(reflection, {
-				name: reflection.typeName,
-				...nonNull[0]
-			}), nullable);
-			const enumValues = nonNull.map((branch) => branch.const).filter((value) => value !== void 0);
+			if (nonNull.length === 1) {
+				const first = nonNull[0];
+				if (!(0, _stryke_type_checks.isSetObject)(first)) return withNullable(withReflectionTags(reflection, {
+					name: reflection.typeName,
+					anyOf: [first]
+				}));
+				return withNullable(withReflectionTags(reflection, {
+					name: reflection.typeName,
+					...first
+				}));
+			}
+			const enumValues = nonNull.map((branch) => (0, _stryke_type_checks.isSetObject)(branch) ? branch.const : void 0).filter((value) => value === null || typeof value === "string" || typeof value === "number" || typeof value === "bigint" || typeof value === "boolean");
 			if (enumValues.length === nonNull.length) return withNullable(withReflectionTags(reflection, {
 				name: reflection.typeName,
 				enum: enumValues
-			}), nullable);
+			}));
 			const discriminator = tryReflectionDiscriminator(reflection.types);
-			if (discriminator) return withNullable(withReflectionTags(reflection, {
+			if (discriminator && (0, _stryke_type_checks.isSetObject)(discriminator)) return withNullable(withReflectionTags(reflection, {
 				name: reflection.typeName,
 				...discriminator
-			}), nullable);
+			}));
 			return withNullable(withReflectionTags(reflection, {
 				name: reflection.typeName,
 				anyOf: nonNull
-			}), nullable);
+			}));
 		}
 		case _powerlines_deepkit_vendor_type.ReflectionKind.intersection: {
 			const members = reflection.types.map((inner) => reflectionToJsonSchemaInner(inner)).filter((item) => item !== void 0);
 			if (members.length === 0) return;
-			if (members.length === 1) return withReflectionTags(reflection, {
-				name: reflection.typeName,
-				...members[0]
-			});
+			if (members.length === 1) {
+				if (!(0, _stryke_type_checks.isSetObject)(members[0])) return members[0];
+				return withReflectionTags(reflection, {
+					name: reflection.typeName,
+					...members[0]
+				});
+			}
 			if (members.every(require_type_checks.isJsonSchemaObject)) return withReflectionTags(reflection, {
 				name: reflection.typeName,
 				...mergeObjectSchemas(members)
@@ -375,7 +398,7 @@ function objectReflectionToJsonSchema(type) {
 		let property = reflectionToJsonSchemaInner(propertyReflection.type);
 		if (!property) continue;
 		property = {
-			...property,
+			...(0, _stryke_type_checks.isSetObject)(property) ? property : {},
 			name: propertyReflection.getNameAsString(),
 			description: propertyReflection.getDescription(),
 			readOnly: propertyReflection.isReadonly(),
@@ -383,13 +406,12 @@ function objectReflectionToJsonSchema(type) {
 			internal: propertyReflection.isInternal(),
 			runtime: propertyReflection.isRuntime(),
 			hidden: propertyReflection.isHidden(),
-			visibility: propertyReflection.isPublic() ? "public" : propertyReflection.isProtected() ? "protected" : propertyReflection.isPrivate() ? "private" : void 0,
 			...propertyReflection.hasDefault() ? { default: propertyReflection.getDefaultValue() } : {},
 			...(0, _stryke_type_checks.isSetArray)(propertyReflection.getGroups()) ? { tags: propertyReflection.getGroups() } : {},
 			...(0, _stryke_type_checks.isSetArray)(propertyReflection.getAlias()) ? { alias: propertyReflection.getAlias() } : {},
 			...(0, _stryke_type_checks.isSetString)(propertyReflection.getTitle()) ? { title: propertyReflection.getTitle() } : {}
 		};
-		if (propertyReflection.isNullable()) property = withNullable(property, true);
+		if (propertyReflection.isNullable()) property = withNullable(property);
 		schema.properties ??= {};
 		schema.properties[propertyReflection.name] = property;
 		if (!propertyReflection.isOptional()) {

package/dist/reflection.d.cts

@@ -5,7 +5,7 @@ import { Type } from "@powerlines/deepkit/vendor/type";
 /**
  * Converts a Deepkit type reflection into a JSON Schema (draft-07) fragment.
  */
-declare function reflectionToJsonSchema<T = unknown>(reflection: Type): JsonSchema<T> | undefined;
+declare function reflectionToJsonSchema(reflection: Type): JsonSchema | undefined;
 //#endregion
 export { reflectionToJsonSchema };
 //# sourceMappingURL=reflection.d.cts.map

package/dist/reflection.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"reflection.d.cts","names":[],"sources":["../src/reflection.ts"],"mappings":";;;;;;AAsJA;iBAAgB,sBAAA,aAAA,CACd,UAAA,EAAY,IAAA,GACX,UAAA,CAAW,CAAA"}
+{"version":3,"file":"reflection.d.cts","names":[],"sources":["../src/reflection.ts"],"mappings":";;;;;;AAgKA;iBAAgB,sBAAA,CACd,UAAA,EAAY,IAAA,GACX,UAAU"}

package/dist/reflection.d.mts

@@ -5,7 +5,7 @@ import { Type } from "@powerlines/deepkit/vendor/type";
 /**
  * Converts a Deepkit type reflection into a JSON Schema (draft-07) fragment.
  */
-declare function reflectionToJsonSchema<T = unknown>(reflection: Type): JsonSchema<T> | undefined;
+declare function reflectionToJsonSchema(reflection: Type): JsonSchema | undefined;
 //#endregion
 export { reflectionToJsonSchema };
 //# sourceMappingURL=reflection.d.mts.map

package/dist/reflection.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"reflection.d.mts","names":[],"sources":["../src/reflection.ts"],"mappings":";;;;;;AAsJA;iBAAgB,sBAAA,aAAA,CACd,UAAA,EAAY,IAAA,GACX,UAAA,CAAW,CAAA"}
+{"version":3,"file":"reflection.d.mts","names":[],"sources":["../src/reflection.ts"],"mappings":";;;;;;AAgKA;iBAAgB,sBAAA,CACd,UAAA,EAAY,IAAA,GACX,UAAU"}