@flare-ts/lib 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lumex Solutions
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./schema/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export * from "./schema/index.js";

package/dist/schema/index.d.ts

@@ -0,0 +1,10 @@
+export { array, bool, date, defaultTo, enums, float, int, optional, str, text, uuid } from "./primitives/index.js";
+export type { ArrayTypedPrimitive, Primitive, PrimitiveJsonSchema, TypedPrimitive } from "./primitives/index.js";
+export { model } from "./model.js";
+export { schema } from "./schema.js";
+export type { ModelTokenBuilder } from "./model.js";
+export type { BranchShape, DescriptorValue, DiscriminantValues, OpaqueSchemaToken, SchemaToken } from "./schema.js";
+export type { FieldError, JsonObject, JsonValue, SafeParseResult, ValidationError } from "./schema.js";
+export { compileSerializer, toJsonSchema } from "./json/serializer.js";
+export type { Serializer } from "./json/serializer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAEnH,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEjH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEpH,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEvG,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/schema/index.js

@@ -0,0 +1,21 @@
+import { array, bool, date, defaultTo, enums, float, int, optional, str, text, uuid } from "./primitives/index.js";
+import { model } from "./model.js";
+import { schema } from "./schema.js";
+import { compileSerializer, toJsonSchema } from "./json/serializer.js";
+export {
+  array,
+  bool,
+  compileSerializer,
+  date,
+  defaultTo,
+  enums,
+  float,
+  int,
+  model,
+  optional,
+  schema,
+  str,
+  text,
+  toJsonSchema,
+  uuid
+};

package/dist/schema/internal/index.d.ts

@@ -0,0 +1,4 @@
+export { isSchemaRequired } from "./token/optionality.js";
+export { SCHEMA_BRAND, SCHEMA_DESCRIPTOR, SCHEMA_REQUIRED } from "./token/symbols.js";
+export type { AnyDescriptorValue, InferSchemaShape } from "./types/inference.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/internal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schema/internal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEtF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/schema/internal/index.js

@@ -0,0 +1,8 @@
+import { isSchemaRequired } from "./token/optionality.js";
+import { SCHEMA_BRAND, SCHEMA_DESCRIPTOR, SCHEMA_REQUIRED } from "./token/symbols.js";
+export {
+  SCHEMA_BRAND,
+  SCHEMA_DESCRIPTOR,
+  SCHEMA_REQUIRED,
+  isSchemaRequired
+};

package/dist/schema/internal/parser/array.d.ts

@@ -0,0 +1,7 @@
+import type { JsonValue, SafeParseResult, SchemaToken } from "../../schema.js";
+/**
+ * @internal
+ * Core implementation for top-level array schemas.
+ */
+export declare function arraySafeParse<T>(raw: ArrayBuffer | string | JsonValue, itemSchema: SchemaToken<T>): SafeParseResult<T[]>;
+//# sourceMappingURL=array.d.ts.map

package/dist/schema/internal/parser/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../../src/schema/internal/parser/array.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI3F;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,EACrC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,GACzB,eAAe,CAAC,CAAC,EAAE,CAAC,CA8BtB"}

package/dist/schema/internal/parser/array.js

@@ -0,0 +1,33 @@
+import { resolveArrayInput } from "./input.js";
+import { prefixRootArrayItemPath } from "./path.js";
+function arraySafeParse(raw, itemSchema) {
+  try {
+    const parsed = resolveArrayInput(raw);
+    const result = new Array(parsed.length);
+    const errors = [];
+    for (let i = 0; i < parsed.length; i++) {
+      const nested = itemSchema.safeParse(parsed[i]);
+      if (!nested.success) {
+        nested.error.fields.forEach((e) => errors.push({ ...e, path: prefixRootArrayItemPath(i, e.path) }));
+        continue;
+      }
+      result[i] = nested.data;
+    }
+    if (errors.length > 0) return { success: false, error: { fields: errors } };
+    return { success: true, data: result };
+  } catch (e) {
+    return {
+      success: false,
+      error: {
+        fields: [{
+          path: "",
+          message: `Failed to parse JSON: ${e instanceof Error ? e.message : String(e)}`,
+          received: ""
+        }]
+      }
+    };
+  }
+}
+export {
+  arraySafeParse
+};

package/dist/schema/internal/parser/discriminated.d.ts

@@ -0,0 +1,11 @@
+import type { DescriptorValue, JsonValue, SafeParseResult } from "../../schema.js";
+/**
+ * @internal
+ * Core implementation for discriminated union schemas.
+ */
+export declare function discriminatedSafeParse<T, K extends keyof T>(raw: ArrayBuffer | string | JsonValue, discriminant: K, branches: {
+    [key: string]: {
+        [field: string]: DescriptorValue<T[keyof T]>;
+    };
+}): SafeParseResult<T>;
+//# sourceMappingURL=discriminated.d.ts.map

package/dist/schema/internal/parser/discriminated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discriminated.d.ts","sourceRoot":"","sources":["../../../../src/schema/internal/parser/discriminated.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAc,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAI/F;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACzD,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,EACrC,YAAY,EAAE,CAAC,EACf,QAAQ,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;CAAE,GAC9E,eAAe,CAAC,CAAC,CAAC,CAoCpB"}

package/dist/schema/internal/parser/discriminated.js

@@ -0,0 +1,40 @@
+import { resolveInput, tryGetValue } from "./input.js";
+import { processField } from "./object.js";
+function discriminatedSafeParse(raw, discriminant, branches) {
+  try {
+    const parsed = resolveInput(raw);
+    const discriminantValue = tryGetValue(parsed, discriminant);
+    if (discriminantValue === void 0) {
+      return invalidSchemaError(String(discriminant), "Missing or invalid discriminant field", "");
+    }
+    const branch = branches[discriminantValue];
+    if (!branch) {
+      return invalidSchemaError(String(discriminant), "Invalid discriminant value", String(discriminantValue));
+    }
+    const result = {};
+    const errors = [];
+    result[String(discriminant)] = discriminantValue;
+    for (const key in branch) {
+      processField(key, branch[key], parsed[key], result, errors);
+    }
+    if (errors.length > 0) return { success: false, error: { fields: errors } };
+    return { success: true, data: result };
+  } catch (e) {
+    return {
+      success: false,
+      error: {
+        fields: [{
+          path: "",
+          message: `Failed to parse JSON: ${e instanceof Error ? e.message : String(e)}`,
+          received: ""
+        }]
+      }
+    };
+  }
+}
+function invalidSchemaError(path, message, received) {
+  return { success: false, error: { fields: [{ path, message, received }] } };
+}
+export {
+  discriminatedSafeParse
+};

package/dist/schema/internal/parser/input.d.ts

@@ -0,0 +1,26 @@
+import type { JsonValue } from "../../schema.js";
+/**
+ * @internal
+ * Reads a string or number value from a parsed object by key.
+ * Returns `undefined` if the key is absent or its value is not a string or number.
+ */
+export declare function tryGetValue(obj: {
+    [key: string]: JsonValue;
+}, key: string | number | symbol): string | number | undefined;
+/**
+ * @internal
+ * Resolves all accepted raw input forms into a plain JSON object.
+ * JSON strings and ArrayBuffers are parsed; plain objects are passed through.
+ * Throws for any other JsonValue (arrays, primitives).
+ */
+export declare function resolveInput(raw: ArrayBuffer | string | JsonValue): {
+    [key: string]: JsonValue;
+};
+/**
+ * @internal
+ * Resolves all accepted raw input forms into a JSON array.
+ * JSON strings and ArrayBuffers are parsed; plain arrays are passed through.
+ * Throws for any other JsonValue (objects, primitives).
+ */
+export declare function resolveArrayInput(raw: ArrayBuffer | string | JsonValue): JsonValue[];
+//# sourceMappingURL=input.d.ts.map

package/dist/schema/internal/parser/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../../src/schema/internal/parser/input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAAE,EAClC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAC5B,MAAM,GAAG,MAAM,GAAG,SAAS,CAI7B;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAAE,CAQjG;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,EAAE,CAQpF"}

package/dist/schema/internal/parser/input.js

@@ -0,0 +1,56 @@
+function tryGetValue(obj, key) {
+  const value = obj[String(key)];
+  if (typeof value !== "string" && typeof value !== "number") return void 0;
+  return value;
+}
+function resolveInput(raw) {
+  if (raw instanceof ArrayBuffer || typeof raw === "string") {
+    return tryParseJSON(raw);
+  }
+  if (typeof raw === "object" && raw !== null && !Array.isArray(raw)) {
+    return raw;
+  }
+  throw new Error("Expected object");
+}
+function resolveArrayInput(raw) {
+  if (raw instanceof ArrayBuffer || typeof raw === "string") {
+    return tryParseJSONArray(raw);
+  }
+  if (Array.isArray(raw)) {
+    return raw;
+  }
+  throw new Error("Expected array");
+}
+function parseJSON(raw) {
+  try {
+    return JSON.parse(typeof raw === "string" ? raw : new TextDecoder().decode(raw));
+  } catch (e) {
+    throw new Error(e instanceof Error ? e.message : String(e));
+  }
+}
+function tryParseJSON(raw) {
+  try {
+    const parsed = parseJSON(raw);
+    if (typeof parsed !== "object" || parsed === null) {
+      throw new Error("Expected object");
+    }
+    if (Array.isArray(parsed)) {
+      throw new Error("Expected object, received array");
+    }
+    return parsed;
+  } catch (e) {
+    throw new Error(e instanceof Error ? e.message : String(e));
+  }
+}
+function tryParseJSONArray(raw) {
+  const parsed = parseJSON(raw);
+  if (!Array.isArray(parsed)) {
+    throw new Error("Expected array");
+  }
+  return parsed;
+}
+export {
+  resolveArrayInput,
+  resolveInput,
+  tryGetValue
+};

package/dist/schema/internal/parser/object.d.ts

@@ -0,0 +1,16 @@
+import type { DescriptorValue, FieldError, JsonValue, SafeParseResult } from "../../schema.js";
+/**
+ * @internal
+ * Validates a single field value against its descriptor entry (either a
+ * primitive or a nested schema) and writes the result into `result`, or appends
+ * to `errors` on failure.
+ */
+export declare function processField<T>(key: string, primitiveOrSchema: DescriptorValue<T[keyof T]>, value: JsonValue | undefined, result: Record<string, T[keyof T]>, errors: FieldError[]): void;
+/**
+ * @internal
+ * Core implementation for flat object schemas.
+ */
+export declare function flatSafeParse<T>(raw: ArrayBuffer | string | JsonValue, descriptor: {
+    [K in keyof T]: DescriptorValue<T[K]>;
+}): SafeParseResult<T>;
+//# sourceMappingURL=object.d.ts.map

package/dist/schema/internal/parser/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../../../src/schema/internal/parser/object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAe,MAAM,iBAAiB,CAAC;AAM5G;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,GAAG,EAAE,MAAM,EACX,iBAAiB,EAAE,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAC9C,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAClC,MAAM,EAAE,UAAU,EAAE,GACnB,IAAI,CAgDN;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,EACrC,UAAU,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAG,GACrD,eAAe,CAAC,CAAC,CAAC,CAyBpB"}

package/dist/schema/internal/parser/object.js

@@ -0,0 +1,81 @@
+import { isSchemaRequired } from "../token/optionality.js";
+import { SCHEMA_BRAND } from "../token/symbols.js";
+import { resolveInput } from "./input.js";
+import { prefixNestedPath } from "./path.js";
+function processField(key, primitiveOrSchema, value, result, errors) {
+  if (primitiveOrSchema[SCHEMA_BRAND] === true) {
+    const schema = primitiveOrSchema;
+    const isOptional = !isSchemaRequired(schema);
+    if (value === void 0 || value === null) {
+      if (!isOptional) {
+        errors.push({ path: key, message: "Missing required field", received: value === null ? "null" : "" });
+      }
+      return;
+    }
+    const nested = schema.safeParse(value);
+    if (!nested.success) {
+      nested.error.fields.forEach((e) => errors.push({ ...e, path: prefixNestedPath(key, e.path) }));
+    } else {
+      result[key] = nested.data;
+    }
+  } else {
+    const primitive = primitiveOrSchema;
+    if (value === void 0 || value === null) {
+      if (primitive._required) {
+        errors.push({ path: key, message: "Missing required field", received: value === null ? "null" : "" });
+      } else {
+        const fallback = primitive("");
+        if (fallback !== void 0) result[key] = fallback;
+      }
+      return;
+    }
+    try {
+      let parsed;
+      if (typeof value === "object") {
+        if (!Array.isArray(value)) {
+          throw new Error(`Expected primitive value, got object`);
+        }
+        parsed = primitive(value.map(String));
+      } else {
+        parsed = primitive(String(value));
+      }
+      if (parsed !== void 0) {
+        result[key] = parsed;
+      }
+    } catch (e) {
+      errors.push({
+        path: key,
+        message: e instanceof Error ? e.message : "Invalid value",
+        received: JSON.stringify(value)
+      });
+    }
+  }
+}
+function flatSafeParse(raw, descriptor) {
+  try {
+    const parsed = resolveInput(raw);
+    const result = {};
+    const errors = [];
+    for (const key in descriptor) {
+      const value = Object.hasOwn(parsed, key) ? parsed[key] : void 0;
+      processField(key, descriptor[key], value, result, errors);
+    }
+    if (errors.length > 0) return { success: false, error: { fields: errors } };
+    return { success: true, data: result };
+  } catch (e) {
+    return {
+      success: false,
+      error: {
+        fields: [{
+          path: "",
+          message: `Failed to parse JSON: ${e instanceof Error ? e.message : String(e)}`,
+          received: ""
+        }]
+      }
+    };
+  }
+}
+export {
+  flatSafeParse,
+  processField
+};

package/dist/schema/internal/parser/path.d.ts

@@ -0,0 +1,5 @@
+/** @internal Prefixes a nested field path with its parent object key. */
+export declare function prefixNestedPath(key: string, path: string): string;
+/** @internal Prefixes a nested field path with a top-level array index. */
+export declare function prefixRootArrayItemPath(idx: number, path: string): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/schema/internal/parser/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../../src/schema/internal/parser/path.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED,2EAA2E;AAC3E,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzE"}

package/dist/schema/internal/parser/path.js

@@ -0,0 +1,11 @@
+function prefixNestedPath(key, path) {
+  if (!path) return key;
+  return path.startsWith("[") ? `${key}${path}` : `${key}.${path}`;
+}
+function prefixRootArrayItemPath(idx, path) {
+  return path ? `[${idx}].${path}` : `[${idx}]`;
+}
+export {
+  prefixNestedPath,
+  prefixRootArrayItemPath
+};

package/dist/schema/internal/parser/record.d.ts

@@ -0,0 +1,8 @@
+import type { JsonValue, SafeParseResult, SchemaToken } from "../../schema.js";
+/**
+ * @internal
+ * Core implementation for record schemas. Parses a JSON object whose values
+ * are all validated by a single `valueSchema`.
+ */
+export declare function recordSafeParse<V>(raw: ArrayBuffer | string | JsonValue, valueSchema: SchemaToken<V>): SafeParseResult<Record<string, V>>;
+//# sourceMappingURL=record.d.ts.map

package/dist/schema/internal/parser/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../../src/schema/internal/parser/record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAM3F;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,EACrC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,GAC1B,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAyCpC"}

package/dist/schema/internal/parser/record.js

@@ -0,0 +1,44 @@
+import { resolveInput } from "./input.js";
+import { prefixNestedPath } from "./path.js";
+const UNSAFE_RECORD_KEYS = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
+function recordSafeParse(raw, valueSchema) {
+  try {
+    const parsed = resolveInput(raw);
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+      return {
+        success: false,
+        error: { fields: [{ path: "", message: "Expected an object", received: JSON.stringify(parsed) }] }
+      };
+    }
+    const result = /* @__PURE__ */ Object.create(null);
+    const errors = [];
+    for (const [key, value] of Object.entries(parsed)) {
+      if (UNSAFE_RECORD_KEYS.has(key)) {
+        errors.push({ path: key, message: "Unsafe record key", received: key });
+        continue;
+      }
+      const nested = valueSchema.safeParse(value);
+      if (!nested.success) {
+        nested.error.fields.forEach((e) => errors.push({ ...e, path: prefixNestedPath(key, e.path) }));
+      } else {
+        result[key] = nested.data;
+      }
+    }
+    if (errors.length > 0) return { success: false, error: { fields: errors } };
+    return { success: true, data: result };
+  } catch (e) {
+    return {
+      success: false,
+      error: {
+        fields: [{
+          path: "",
+          message: `Failed to parse JSON: ${e instanceof Error ? e.message : String(e)}`,
+          received: ""
+        }]
+      }
+    };
+  }
+}
+export {
+  recordSafeParse
+};

package/dist/schema/internal/token/optionality.d.ts

@@ -0,0 +1,6 @@
+import type { SchemaToken } from "../../schema.js";
+/** @internal Creates an optional copy of a schema token without mutating the original. */
+export declare function makeOptionalSchemaToken<T>(token: SchemaToken<T>): SchemaToken<T>;
+/** @internal Returns whether a schema token requires a value. False means the field is optional. */
+export declare function isSchemaRequired<T>(token: SchemaToken<T>): boolean;
+//# sourceMappingURL=optionality.d.ts.map

package/dist/schema/internal/token/optionality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optionality.d.ts","sourceRoot":"","sources":["../../../../src/schema/internal/token/optionality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,0FAA0F;AAC1F,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAEhF;AAED,oGAAoG;AACpG,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAElE"}

package/dist/schema/internal/token/optionality.js

@@ -0,0 +1,11 @@
+import { SCHEMA_REQUIRED } from "./symbols.js";
+function makeOptionalSchemaToken(token) {
+  return { ...token, [SCHEMA_REQUIRED]: false };
+}
+function isSchemaRequired(token) {
+  return token[SCHEMA_REQUIRED] !== false;
+}
+export {
+  isSchemaRequired,
+  makeOptionalSchemaToken
+};

package/dist/schema/internal/token/symbols.d.ts

@@ -0,0 +1,7 @@
+/** @internal Unique symbol used as a static brand on all schema tokens. */
+export declare const SCHEMA_BRAND: unique symbol;
+/** @internal Symbol used to track optionality on schema tokens. */
+export declare const SCHEMA_REQUIRED: unique symbol;
+/** @internal Symbol used to store the descriptor on schema tokens for compile-time introspection. */
+export declare const SCHEMA_DESCRIPTOR: unique symbol;
+//# sourceMappingURL=symbols.d.ts.map

package/dist/schema/internal/token/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../../src/schema/internal/token/symbols.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,eAAO,MAAM,YAAY,EAAE,OAAO,MAAsD,CAAC;AAEzF,mEAAmE;AACnE,eAAO,MAAM,eAAe,EAAE,OAAO,MAAyD,CAAC;AAE/F,qGAAqG;AACrG,eAAO,MAAM,iBAAiB,EAAE,OAAO,MAA2D,CAAC"}

package/dist/schema/internal/token/symbols.js

@@ -0,0 +1,8 @@
+const SCHEMA_BRAND = /* @__PURE__ */ Symbol.for("@flare-ts/schema/brand");
+const SCHEMA_REQUIRED = /* @__PURE__ */ Symbol.for("@flare-ts/schema/required");
+const SCHEMA_DESCRIPTOR = /* @__PURE__ */ Symbol.for("@flare-ts/schema/descriptor");
+export {
+  SCHEMA_BRAND,
+  SCHEMA_DESCRIPTOR,
+  SCHEMA_REQUIRED
+};

package/dist/schema/internal/types/inference.d.ts

@@ -0,0 +1,20 @@
+import type { TypedPrimitive } from "../../primitives/index.js";
+import type { SchemaToken } from "../../schema.js";
+/**
+ * @internal
+ * The union of every value type accepted in a flat schema descriptor.
+ * Used by the inferred overload of {@link schema} to constrain `D`
+ * without requiring the output type `T` to be stated up-front.
+ */
+export type AnyDescriptorValue = TypedPrimitive<unknown> | SchemaToken<unknown>;
+/**
+ * @internal
+ * Maps a concrete descriptor shape `D` to the corresponding output object type.
+ *
+ * - `SchemaToken<U>` -> `U`
+ * - `TypedPrimitive<U>` -> `U`
+ */
+export type InferSchemaShape<D extends Record<string, AnyDescriptorValue>> = {
+    [K in keyof D]: D[K] extends SchemaToken<infer U> ? U : D[K] extends TypedPrimitive<infer U> ? U : never;
+};
+//# sourceMappingURL=inference.d.ts.map

package/dist/schema/internal/types/inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference.d.ts","sourceRoot":"","sources":["../../../../src/schema/internal/types/inference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,IAAI;KAC1E,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GACjD,CAAC,CAAC,CAAC,CAAC,SAAS,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GACxC,KAAK;CACV,CAAC"}

package/dist/schema/json/serializer.d.ts

@@ -0,0 +1,51 @@
+import type { JsonValue, OpaqueSchemaToken } from "../schema.js";
+/**
+ * Serializes a matching JSON value to a string, compiled from a schema token.
+ */
+export type Serializer = (doc: JsonValue) => string;
+type JsonSchema = {
+    type: "object";
+    properties: Record<string, JsonSchema>;
+    required?: string[];
+} | {
+    type: "object";
+    additionalProperties: JsonSchema;
+} | {
+    type: "array";
+    items: JsonSchema;
+} | {
+    type: "string";
+    format?: string;
+    enum?: readonly string[];
+} | {
+    type: "integer" | "number";
+    minimum?: number;
+    maximum?: number;
+} | {
+    type: "boolean";
+} | {
+    anyOf: JsonSchema[];
+} | Record<string, never>;
+/**
+ * Compiles a fast JSON serializer from a schema token.
+ *
+ * The compiled serializer outperforms fast-json-stringify on typical API response
+ * shapes because Flare's schema carries type information (uuid, date, enum, string
+ * vs text) that allows the codegen to skip escape scans and use pre-built LUTs
+ * wherever the field domain guarantees safety.
+ *
+ * For record and discriminated-union descriptors there is no codegen branch yet,
+ * so a Serializer that delegates to JSON.stringify is returned. Callers see the
+ * same shape and behaviour as a compiled one, just without the fast-path.
+ *
+ * @param token - A schema token produced by {@link schema} or {@link model}.
+ */
+export declare function compileSerializer(token: OpaqueSchemaToken): Serializer;
+/**
+ * Converts a schema token into a JSON Schema Draft 7 object.
+ *
+ * @throws {Error} When the descriptor contains an unsupported shape.
+ */
+export declare function toJsonSchema(token: OpaqueSchemaToken): JsonSchema;
+export {};
+//# sourceMappingURL=serializer.d.ts.map

package/dist/schema/json/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../../../src/schema/json/serializer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAsBjE;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,SAAS,KAAK,MAAM,CAAC;AAoEpD,KAAK,UAAU,GACX;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CAAE,GAChF;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,oBAAoB,EAAE,UAAU,CAAC;CAAE,GACrD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC;CAAE,GACrC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAAE,GAC9D;IAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAAE,GACnE;IAAE,IAAI,EAAE,SAAS,CAAC;CAAE,GACpB;IAAE,KAAK,EAAE,UAAU,EAAE,CAAC;CAAE,GACxB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAO1B;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,UAAU,CA4BtE;AAwMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,UAAU,CAEjE"}