@lssm/lib.schema 1.42.9 → 1.43.0

package/dist/ScalarTypeEnum.js.map

@@ -1 +1 @@
-{"version":3,"file":"ScalarTypeEnum.js","names":[],"sources":["../src/ScalarTypeEnum.ts"],"sourcesContent":["import * as z from 'zod';\nimport { Kind, type ValueNode } from 'graphql';\nimport { FieldType } from './FieldType';\n\n// Helpers to build standard scalars\nconst localeRegex = /^[A-Za-z]{2}(?:-[A-Za-z0-9]{2,8})*$/;\nconst timezoneRegex = /^(?:UTC|[A-Za-z_]+\\/[A-Za-z_]+)$/;\nconst phoneRegex = /^[+]?\\d[\\d\\s().-]{3,}$/;\nconst currencyRegex = /^[A-Z]{3}$/;\nconst countryRegex = /^[A-Z]{2}$/;\nconst latMin = -90;\nconst latMax = 90;\nconst lonMin = -180;\nconst lonMax = 180;\n\n/**\n * Factory functions for common scalar FieldTypes with zod/GraphQL/JSON Schema.\n */\nexport const ScalarTypeEnum = {\n  // primitives (_unsecure)\n  String_unsecure: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'String_unsecure',\n      description: 'Unvalidated string scalar',\n      zod: z.string(),\n      parseValue: (v) => z.string().parse(v),\n      serialize: (v) => String(v),\n      parseLiteral: (ast: ValueNode) => {\n        if (ast.kind !== Kind.STRING) throw new TypeError('Invalid literal');\n        return ast.value;\n      },\n      jsonSchema: { type: 'string' },\n    }),\n  Int_unsecure: (): FieldType<number> =>\n    new FieldType<number>({\n      name: 'Int_unsecure',\n      description: 'Unvalidated integer scalar',\n      zod: z.number().int(),\n      parseValue: (v) => {\n        const num = typeof v === 'number' ? v : Number(v as unknown);\n        return z.number().int().parse(num);\n      },\n      serialize: (v) => Math.trunc(typeof v === 'number' ? v : Number(v)),\n      parseLiteral: (ast: ValueNode) => {\n        if (ast.kind !== Kind.INT) throw new TypeError('Invalid literal');\n        return Number(ast.value);\n      },\n      jsonSchema: { type: 'integer' },\n    }),\n  Float_unsecure: (): FieldType<number> =>\n    new FieldType<number>({\n      name: 'Float_unsecure',\n      description: 'Unvalidated float scalar',\n      zod: z.number(),\n      parseValue: (v) => {\n        const num = typeof v === 'number' ? v : Number(v as unknown);\n        return z.number().parse(num);\n      },\n      serialize: (v) => Number(v),\n      parseLiteral: (ast: ValueNode) => {\n        if (ast.kind !== Kind.FLOAT && ast.kind !== Kind.INT)\n          throw new TypeError('Invalid literal');\n        return Number(ast.value);\n      },\n      jsonSchema: { type: 'number' },\n    }),\n  Boolean: (): FieldType<boolean> =>\n    new FieldType<boolean>({\n      name: 'Boolean',\n      description: 'Unvalidated boolean scalar',\n      zod: z.boolean(),\n      parseValue: (v) => z.coerce.boolean().parse(v),\n      serialize: (v) => Boolean(v),\n      parseLiteral: (ast: ValueNode) => {\n        if (ast.kind !== Kind.BOOLEAN) throw new TypeError('Invalid literal');\n        return ast.value;\n      },\n      jsonSchema: { type: 'boolean' },\n    }),\n  ID: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'ID',\n      description: 'Unvalidated id scalar',\n      zod: z.string(),\n      parseValue: (v) => z.string().parse(v),\n      serialize: (v) => String(v),\n      parseLiteral: (ast: ValueNode) => {\n        if (ast.kind !== Kind.STRING) throw new TypeError('Invalid literal');\n        return ast.value;\n      },\n      jsonSchema: { type: 'string' },\n    }),\n\n  // Validated custom scalars\n  JSON: (): FieldType<unknown> =>\n    new FieldType<unknown>({\n      name: 'JSON',\n      zod: z.any(),\n      parseValue: (v) => v,\n      serialize: (v) => v,\n      jsonSchema: {},\n    }),\n  JSONObject: (): FieldType<Record<string, unknown>> =>\n    new FieldType<Record<string, unknown>>({\n      name: 'JSONObject',\n      zod: z.record(z.string(), z.any()),\n      parseValue: (v) => z.record(z.string(), z.any()).parse(v),\n      serialize: (v) => (v ?? {}) as Record<string, unknown>,\n      jsonSchema: { type: 'object' },\n    }),\n  Date: (): FieldType<Date, string> =>\n    new FieldType<Date, string>({\n      name: 'Date',\n      zod: z.date(),\n      parseValue: (v) => (v instanceof Date ? v : new Date(String(v))),\n      serialize: (v) =>\n        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n        v instanceof Date ? v.toISOString().split('T')[0]! : String(v),\n      jsonSchema: { type: 'string', format: 'date' },\n    }),\n  DateTime: (): FieldType<Date, string> =>\n    new FieldType<Date, string>({\n      name: 'DateTime',\n      zod: z.date(),\n      parseValue: (v) => (v instanceof Date ? v : new Date(String(v))),\n      serialize: (v) => {\n        return v instanceof Date ? v.toISOString() : String(v);\n      },\n      jsonSchema: { type: 'string', format: 'date-time' },\n    }),\n  Time: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'Time',\n      zod: z.string().regex(/^\\d{2}:\\d{2}(:\\d{2})?$/),\n      parseValue: (v) =>\n        z\n          .string()\n          .regex(/^\\d{2}:\\d{2}(:\\d{2})?$/)\n          .parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', pattern: '^\\\\d{2}:\\\\d{2}(:\\\\d{2})?$' },\n    }),\n  EmailAddress: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'EmailAddress',\n      zod: z.string().email(),\n      parseValue: (v) => z.string().email().parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', format: 'email' },\n    }),\n  URL: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'URL',\n      zod: z.string().url(),\n      parseValue: (v) => z.string().url().parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', format: 'uri' },\n    }),\n  PhoneNumber: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'PhoneNumber',\n      zod: z.string().regex(phoneRegex),\n      parseValue: (v) => z.string().regex(phoneRegex).parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', pattern: phoneRegex.source },\n    }),\n  NonEmptyString: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'NonEmptyString',\n      zod: z.string().min(1),\n      parseValue: (v) => z.string().min(1).parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', minLength: 1 },\n    }),\n  Locale: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'Locale',\n      zod: z.string().regex(localeRegex),\n      parseValue: (v) => z.string().regex(localeRegex).parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', pattern: localeRegex.source },\n    }),\n  TimeZone: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'TimeZone',\n      zod: z.string().regex(timezoneRegex),\n      parseValue: (v) => z.string().regex(timezoneRegex).parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', pattern: timezoneRegex.source },\n    }),\n  Latitude: (): FieldType<number> =>\n    new FieldType<number>({\n      name: 'Latitude',\n      zod: z.number().min(latMin).max(latMax),\n      parseValue: (v) => z.coerce.number().min(latMin).max(latMax).parse(v),\n      serialize: (v) => Number(v),\n      jsonSchema: { type: 'number', minimum: latMin, maximum: latMax },\n    }),\n  Longitude: (): FieldType<number> =>\n    new FieldType<number>({\n      name: 'Longitude',\n      zod: z.number().min(lonMin).max(lonMax),\n      parseValue: (v) => z.coerce.number().min(lonMin).max(lonMax).parse(v),\n      serialize: (v) => Number(v),\n      jsonSchema: { type: 'number', minimum: lonMin, maximum: lonMax },\n    }),\n  Currency: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'Currency',\n      zod: z.string().regex(currencyRegex),\n      parseValue: (v) => z.string().regex(currencyRegex).parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', pattern: currencyRegex.source },\n    }),\n  CountryCode: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'CountryCode',\n      zod: z.string().regex(countryRegex),\n      parseValue: (v) => z.string().regex(countryRegex).parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', pattern: countryRegex.source },\n    }),\n  //   GeoJSON: (): FieldType<Record<string, unknown>, Record<string, unknown>> =>\n  //     new FieldType<Record<string, unknown>, Record<string, unknown>>({\n  //       name: 'GeoJSON',\n  //       zod: z.object({ type: z.string(), coordinates: z.any() }).passthrough(),\n  //       parseValue: (v) =>\n  //         z\n  //           .object({ type: z.string(), coordinates: z.any() })\n  //           .passthrough()\n  //           .parse(v),\n  //       serialize: (v) => v,\n  //       jsonSchema: { type: 'object' },\n  //     }),\n} as const;\nexport type ScalarTypeEnum = [keyof typeof ScalarTypeEnum];\n"],"mappings":"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"}
+{"version":3,"file":"ScalarTypeEnum.js","names":["z"],"sources":["../src/ScalarTypeEnum.ts"],"sourcesContent":["import * as z from 'zod';\nimport { Kind, type ValueNode } from 'graphql';\nimport { FieldType } from './FieldType';\n\n// Helpers to build standard scalars\nconst localeRegex = /^[A-Za-z]{2}(?:-[A-Za-z0-9]{2,8})*$/;\nconst timezoneRegex = /^(?:UTC|[A-Za-z_]+\\/[A-Za-z_]+)$/;\nconst phoneRegex = /^[+]?\\d[\\d\\s().-]{3,}$/;\nconst currencyRegex = /^[A-Z]{3}$/;\nconst countryRegex = /^[A-Z]{2}$/;\nconst latMin = -90;\nconst latMax = 90;\nconst lonMin = -180;\nconst lonMax = 180;\n\n/**\n * Factory functions for common scalar FieldTypes with zod/GraphQL/JSON Schema.\n */\nexport const ScalarTypeEnum = {\n  // primitives (_unsecure)\n  String_unsecure: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'String_unsecure',\n      description: 'Unvalidated string scalar',\n      zod: z.string(),\n      parseValue: (v) => z.string().parse(v),\n      serialize: (v) => String(v),\n      parseLiteral: (ast: ValueNode) => {\n        if (ast.kind !== Kind.STRING) throw new TypeError('Invalid literal');\n        return ast.value;\n      },\n      jsonSchema: { type: 'string' },\n    }),\n  Int_unsecure: (): FieldType<number> =>\n    new FieldType<number>({\n      name: 'Int_unsecure',\n      description: 'Unvalidated integer scalar',\n      zod: z.number().int(),\n      parseValue: (v) => {\n        const num = typeof v === 'number' ? v : Number(v as unknown);\n        return z.number().int().parse(num);\n      },\n      serialize: (v) => Math.trunc(typeof v === 'number' ? v : Number(v)),\n      parseLiteral: (ast: ValueNode) => {\n        if (ast.kind !== Kind.INT) throw new TypeError('Invalid literal');\n        return Number(ast.value);\n      },\n      jsonSchema: { type: 'integer' },\n    }),\n  Float_unsecure: (): FieldType<number> =>\n    new FieldType<number>({\n      name: 'Float_unsecure',\n      description: 'Unvalidated float scalar',\n      zod: z.number(),\n      parseValue: (v) => {\n        const num = typeof v === 'number' ? v : Number(v as unknown);\n        return z.number().parse(num);\n      },\n      serialize: (v) => Number(v),\n      parseLiteral: (ast: ValueNode) => {\n        if (ast.kind !== Kind.FLOAT && ast.kind !== Kind.INT)\n          throw new TypeError('Invalid literal');\n        return Number(ast.value);\n      },\n      jsonSchema: { type: 'number' },\n    }),\n  Boolean: (): FieldType<boolean> =>\n    new FieldType<boolean>({\n      name: 'Boolean',\n      description: 'Unvalidated boolean scalar',\n      zod: z.boolean(),\n      parseValue: (v) => z.coerce.boolean().parse(v),\n      serialize: (v) => Boolean(v),\n      parseLiteral: (ast: ValueNode) => {\n        if (ast.kind !== Kind.BOOLEAN) throw new TypeError('Invalid literal');\n        return ast.value;\n      },\n      jsonSchema: { type: 'boolean' },\n    }),\n  ID: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'ID',\n      description: 'Unvalidated id scalar',\n      zod: z.string(),\n      parseValue: (v) => z.string().parse(v),\n      serialize: (v) => String(v),\n      parseLiteral: (ast: ValueNode) => {\n        if (ast.kind !== Kind.STRING) throw new TypeError('Invalid literal');\n        return ast.value;\n      },\n      jsonSchema: { type: 'string' },\n    }),\n\n  // Validated custom scalars\n  JSON: (): FieldType<unknown> =>\n    new FieldType<unknown>({\n      name: 'JSON',\n      zod: z.any(),\n      parseValue: (v) => v,\n      serialize: (v) => v,\n      jsonSchema: {},\n    }),\n  JSONObject: (): FieldType<Record<string, unknown>> =>\n    new FieldType<Record<string, unknown>>({\n      name: 'JSONObject',\n      zod: z.record(z.string(), z.any()),\n      parseValue: (v) => z.record(z.string(), z.any()).parse(v),\n      serialize: (v) => (v ?? {}) as Record<string, unknown>,\n      jsonSchema: { type: 'object' },\n    }),\n  Date: (): FieldType<Date, string> =>\n    new FieldType<Date, string>({\n      name: 'Date',\n      zod: z.date(),\n      parseValue: (v) => (v instanceof Date ? v : new Date(String(v))),\n      serialize: (v) =>\n        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n        v instanceof Date ? v.toISOString().split('T')[0]! : String(v),\n      jsonSchema: { type: 'string', format: 'date' },\n    }),\n  DateTime: (): FieldType<Date, string> =>\n    new FieldType<Date, string>({\n      name: 'DateTime',\n      zod: z.date(),\n      parseValue: (v) => (v instanceof Date ? v : new Date(String(v))),\n      serialize: (v) => {\n        return v instanceof Date ? v.toISOString() : String(v);\n      },\n      jsonSchema: { type: 'string', format: 'date-time' },\n    }),\n  Time: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'Time',\n      zod: z.string().regex(/^\\d{2}:\\d{2}(:\\d{2})?$/),\n      parseValue: (v) =>\n        z\n          .string()\n          .regex(/^\\d{2}:\\d{2}(:\\d{2})?$/)\n          .parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', pattern: '^\\\\d{2}:\\\\d{2}(:\\\\d{2})?$' },\n    }),\n  EmailAddress: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'EmailAddress',\n      zod: z.string().email(),\n      parseValue: (v) => z.string().email().parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', format: 'email' },\n    }),\n  URL: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'URL',\n      zod: z.string().url(),\n      parseValue: (v) => z.string().url().parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', format: 'uri' },\n    }),\n  PhoneNumber: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'PhoneNumber',\n      zod: z.string().regex(phoneRegex),\n      parseValue: (v) => z.string().regex(phoneRegex).parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', pattern: phoneRegex.source },\n    }),\n  NonEmptyString: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'NonEmptyString',\n      zod: z.string().min(1),\n      parseValue: (v) => z.string().min(1).parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', minLength: 1 },\n    }),\n  Locale: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'Locale',\n      zod: z.string().regex(localeRegex),\n      parseValue: (v) => z.string().regex(localeRegex).parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', pattern: localeRegex.source },\n    }),\n  TimeZone: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'TimeZone',\n      zod: z.string().regex(timezoneRegex),\n      parseValue: (v) => z.string().regex(timezoneRegex).parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', pattern: timezoneRegex.source },\n    }),\n  Latitude: (): FieldType<number> =>\n    new FieldType<number>({\n      name: 'Latitude',\n      zod: z.number().min(latMin).max(latMax),\n      parseValue: (v) => z.coerce.number().min(latMin).max(latMax).parse(v),\n      serialize: (v) => Number(v),\n      jsonSchema: { type: 'number', minimum: latMin, maximum: latMax },\n    }),\n  Longitude: (): FieldType<number> =>\n    new FieldType<number>({\n      name: 'Longitude',\n      zod: z.number().min(lonMin).max(lonMax),\n      parseValue: (v) => z.coerce.number().min(lonMin).max(lonMax).parse(v),\n      serialize: (v) => Number(v),\n      jsonSchema: { type: 'number', minimum: lonMin, maximum: lonMax },\n    }),\n  Currency: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'Currency',\n      zod: z.string().regex(currencyRegex),\n      parseValue: (v) => z.string().regex(currencyRegex).parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', pattern: currencyRegex.source },\n    }),\n  CountryCode: (): FieldType<string> =>\n    new FieldType<string>({\n      name: 'CountryCode',\n      zod: z.string().regex(countryRegex),\n      parseValue: (v) => z.string().regex(countryRegex).parse(v),\n      serialize: (v) => String(v),\n      jsonSchema: { type: 'string', pattern: countryRegex.source },\n    }),\n  //   GeoJSON: (): FieldType<Record<string, unknown>, Record<string, unknown>> =>\n  //     new FieldType<Record<string, unknown>, Record<string, unknown>>({\n  //       name: 'GeoJSON',\n  //       zod: z.object({ type: z.string(), coordinates: z.any() }).passthrough(),\n  //       parseValue: (v) =>\n  //         z\n  //           .object({ type: z.string(), coordinates: z.any() })\n  //           .passthrough()\n  //           .parse(v),\n  //       serialize: (v) => v,\n  //       jsonSchema: { type: 'object' },\n  //     }),\n} as const;\nexport type ScalarTypeEnum = [keyof typeof ScalarTypeEnum];\n"],"mappings":"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"}

package/dist/SchemaModel.d.ts

@@ -1,10 +1,16 @@
 import { AnyEnumType } from "./EnumType.js";
 import { AnyFieldType } from "./FieldType.js";
-import * as z from "zod";
+import { SchemaModelType } from "./SchemaModelType.js";
+import * as z$1 from "zod";
 import { Maybe } from "graphql/jsutils/Maybe";
 
 //#region src/SchemaModel.d.ts
-type FieldLike = AnyFieldType | AnyEnumType | AnySchemaModel;
+
+/**
+ * All types that can be used as field types in a SchemaModel.
+ * Supports FieldType, EnumType, nested SchemaModel, or any SchemaType implementation.
+ */
+type FieldLike = AnyFieldType | AnyEnumType | AnySchemaModel | SchemaModelType;
 /** Field configuration for a SchemaModel property. */
 interface SchemaFieldConfig<Type extends FieldLike = FieldLike> {
   type: Type;
@@ -23,7 +29,7 @@ interface SchemaModelConfig<Fields extends SchemaModelFieldsAnyConfig> {
  * Named object model built from FieldType/EnumType/SchemaModel fields.
  * Provides zod and GraphQL input helpers, and supports arrays/optional fields.
  */
-declare class SchemaModel<Fields extends SchemaModelFieldsAnyConfig> {
+declare class SchemaModel<Fields extends SchemaModelFieldsAnyConfig> implements SchemaModelType {
   readonly config: SchemaModelConfig<Fields>;
   constructor(config: SchemaModelConfig<Fields>);
   /**
@@ -34,11 +40,35 @@ declare class SchemaModel<Fields extends SchemaModelFieldsAnyConfig> {
   /** Input object name for GraphQL builder adapters. */
   getPothosInput(): string;
 }
-type AnySchemaModel = SchemaModel<SchemaModelFieldsAnyConfig>;
-type ZodSchemaModel<Field extends AnySchemaModel> = z.infer<ReturnType<Field['getZod']>>;
-type InferZodFromType<T> = T extends SchemaModel<SchemaModelFieldsAnyConfig> ? z.ZodObject<z.ZodRawShape> : T extends AnyFieldType ? ReturnType<T['getZod']> : T extends AnyEnumType ? ReturnType<T['getZod']> : never;
-type MaybeArray<Z extends z.ZodType, A> = A extends true ? z.ZodArray<Z> : Z;
-type MaybeOptional<Z extends z.ZodType, O> = O extends true ? z.ZodOptional<Z> : Z;
+/**
+ * Union of all types that can serve as a schema model.
+ * This is the main type expected by OperationSpec, EventSpec, FormSpec, etc.
+ *
+ * Supports:
+ * - SchemaModel instances (native ContractSpec types)
+ * - Any SchemaType implementation (ZodSchemaType, JsonSchemaType, etc.)
+ */
+type AnySchemaModel = SchemaModel<SchemaModelFieldsAnyConfig> | SchemaModelType;
+/**
+ * Type guard to check if a value is a SchemaModel (not just any SchemaType).
+ * Use this when you need to access SchemaModel-specific properties like `config`.
+ *
+ * @param model - The model to check
+ * @returns True if the model is a SchemaModel instance
+ *
+ * @example
+ * ```typescript
+ * if (isSchemaModel(model)) {
+ *   // TypeScript knows model.config is available
+ *   console.log(model.config.name);
+ * }
+ * ```
+ */
+declare function isSchemaModel(model: AnySchemaModel | null | undefined): model is SchemaModel<SchemaModelFieldsAnyConfig>;
+type ZodSchemaModel<Field extends AnySchemaModel> = z$1.infer<ReturnType<Field['getZod']>>;
+type InferZodFromType<T> = T extends SchemaModel<SchemaModelFieldsAnyConfig> ? z$1.ZodObject<z$1.ZodRawShape> : T extends AnyFieldType ? ReturnType<T['getZod']> : T extends AnyEnumType ? ReturnType<T['getZod']> : T extends SchemaModelType ? ReturnType<T['getZod']> : z$1.ZodUnknown;
+type MaybeArray<Z extends z$1.ZodType, A> = A extends true ? z$1.ZodArray<Z> : Z;
+type MaybeOptional<Z extends z$1.ZodType, O> = O extends true ? z$1.ZodOptional<Z> : Z;
 /**
  * Helper type: derive the Zod shape from the field config.
  * Supports nested SchemaModel and arrays, preserving optionality and list-ness.
@@ -51,12 +81,12 @@ type ZodShapeFromFields<F extends SchemaModelFieldsAnyConfig> = { [K in keyof F]
  * The top-level Zod schema returned by getZod():
  * either ZodObject<...> or ZodArray<ZodObject<...>> when config.isArray.
  */
-type TopLevelZodFromModel<F extends SchemaModelFieldsAnyConfig> = z.ZodObject<ZodShapeFromFields<F>>;
+type TopLevelZodFromModel<F extends SchemaModelFieldsAnyConfig> = z$1.ZodObject<ZodShapeFromFields<F>>;
 /**
  * Helper to define a SchemaModel with type inference.
  * Equivalent to `new SchemaModel(config)` but with better ergonomics.
  */
 declare const defineSchemaModel: <Fields extends SchemaModelFieldsAnyConfig>(config: SchemaModelConfig<Fields>) => SchemaModel<Fields>;
 //#endregion
-export { AnySchemaModel, SchemaFieldConfig, SchemaModel, SchemaModelConfig, SchemaModelFieldsAnyConfig, TopLevelZodFromModel, ZodSchemaModel, ZodShapeFromFields, defineSchemaModel };
+export { AnySchemaModel, SchemaFieldConfig, SchemaModel, SchemaModelConfig, SchemaModelFieldsAnyConfig, TopLevelZodFromModel, ZodSchemaModel, ZodShapeFromFields, defineSchemaModel, isSchemaModel };
 //# sourceMappingURL=SchemaModel.d.ts.map

package/dist/SchemaModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaModel.d.ts","names":[],"sources":["../src/SchemaModel.ts"],"sourcesContent":[],"mappings":";;;;;;KAKK,SAAA,GAAY,eAAe,cAAc;;AAAzC,UAGY,iBAHH,CAAA,aAGkC,SAHlC,GAG8C,SAH9C,CAAA,CAAA;EAAG,IAAA,EAIT,IAJS;EAAe,UAAA,EAAA,OAAA;EAAc;EAAc,OAAA,CAAA,EAAA,IAAA;AAG5D;AAAgD,KAOpC,0BAPoC,CAAA,aAOI,SAPJ,GAOgB,SAPhB,CAAA,GAQ9C,MAR8C,CAAA,MAAA,EAQ/B,iBAR+B,CAQb,IARa,CAAA,CAAA;;AACxC,UAUS,iBAVT,CAAA,eAU0C,0BAV1C,CAAA,CAAA;EAAI,IAAA,EAAA,MAAA;EAMA,WAAA,CAAA,EAMI,KANJ,CAAA,MAAA,CAAA;EAAwC,MAAA,EAO1C,MAP0C;;;;;;AAInC,cAUJ,WAVqB,CAAA,eAUM,0BAVN,CAAA,CAAA;EAAgB,SAAA,MAAA,EAWZ,iBAXY,CAWM,MAXN,CAAA;EAElC,WAAA,CAAA,MAAA,EASsB,iBATtB,CASwC,MATxC,CAAA;EACN;;AAOV;;EACwD,MAAA,CAAA,CAAA,EAM5C,oBAN4C,CAMvB,MANuB,CAAA;EAAlB;EAAkB,cAAA,CAAA,CAAA,EAAA,MAAA;;AAMvB,KAwBrB,cAAA,GAAiB,WAxBI,CAwBQ,0BAxBR,CAAA;AAArB,KA0BA,cA1BA,CAAA,cA0B6B,cA1B7B,CAAA,GA0B+C,CAAA,CAAE,KA1BjD,CA2BV,UA3BU,CA2BC,KA3BD,CAAA,QAAA,CAAA,CAAA,CAAA;KA8BP,gBA9B2B,CAAA,CAAA,CAAA,GA+B9B,CA/B8B,SA+BpB,WA/BoB,CA+BR,0BA/BQ,CAAA,GAgC1B,CAAA,CAAE,SAhCwB,CAgCd,CAAA,CAAE,WAhCY,CAAA,GAiC1B,CAjC0B,SAiChB,YAjCgB,GAkCxB,UAlCwB,CAkCb,CAlCa,CAAA,QAAA,CAAA,CAAA,GAmCxB,CAnCwB,SAmCd,WAnCc,GAoCtB,UApCsB,CAoCX,CApCW,CAAA,QAAA,CAAA,CAAA,GAAA,KAAA;AAwBhC,KAeK,UAfO,CAAA,UAec,CAAA,CAAE,OAfa,EAAA,CAAA,CAAA,GAeC,CAfD,SAAA,IAAA,GAekB,CAAA,CAAE,QAfhC,CAeyC,CAfzC,CAAA,GAe8C,CAfnC;AAExC,KAcK,aAdO,CAAA,UAciB,CAAA,CAAE,OAdL,EAAA,CAAA,CAAA,GAcmB,CAdnB,SAAA,IAAA,GAetB,CAAA,CAAE,WAfoB,CAeR,CAfQ,CAAA,GAgBtB,CAhBsB;;;;;KAsBrB,YAtB6D,CAAA,EAAA,CAAA,GAsB1C,EAtB0C,SAAA;EAI7D,OAAA,EAAA,IAAA;CACH,GAAA,IAAA,GAAA,KAAA;AAAsB,KAmBZ,kBAnBY,CAAA,UAmBiB,0BAnBjB,CAAA,GAAA,QAAZ,MAoBE,CApBF,GAoBM,aApBN,CAqBR,UArBQ,CAqBG,gBArBH,CAqBoB,CArBpB,CAqBsB,CArBtB,CAAA,CAAA,MAAA,CAAA,CAAA,EAqBmC,YArBnC,CAqBgD,CArBhD,CAqBkD,CArBlD,CAAA,CAAA,CAAA,EAsBR,CAtBQ,CAsBN,CAtBM,CAAA,CAAA,YAAA,CAAA,CAAA,EACM;;;;;AAEV,KA2BI,oBA3BJ,CAAA,UA2BmC,0BA3BnC,CAAA,GA4BN,CAAA,CAAE,SA5BI,CA4BM,kBA5BN,CA4ByB,CA5BzB,CAAA,CAAA;;;;;AAEY,cAgCP,iBAhCO,EAAA,CAAA,eAgC6B,0BAhC7B,CAAA,CAAA,MAAA,EAiCV,iBAjCU,CAiCQ,MAjCR,CAAA,EAAA,GAkCjB,WAlCiB,CAkCL,MAlCK,CAAA"}
+{"version":3,"file":"SchemaModel.d.ts","names":[],"sources":["../src/SchemaModel.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/SchemaModel.js

@@ -1,6 +1,6 @@
 import "./EnumType.js";
 import "./FieldType.js";
-import * as z from "zod";
+import * as z$1 from "zod";
 
 //#region src/SchemaModel.ts
 /**
@@ -18,11 +18,11 @@ var SchemaModel = class {
 	getZod() {
 		const shape = Object.entries(this.config.fields).reduce((acc, [key, def]) => {
 			const base = def.type.getZod();
-			const withArray = def.isArray ? z.array(base) : base;
+			const withArray = def.isArray ? z$1.array(base) : base;
 			acc[key] = def.isOptional ? withArray.optional() : withArray;
 			return acc;
 		}, {});
-		return z.object(shape);
+		return z$1.object(shape);
 	}
 	/** Input object name for GraphQL builder adapters. */
 	getPothosInput() {
@@ -30,11 +30,29 @@ var SchemaModel = class {
 	}
 };
 /**
+* Type guard to check if a value is a SchemaModel (not just any SchemaType).
+* Use this when you need to access SchemaModel-specific properties like `config`.
+*
+* @param model - The model to check
+* @returns True if the model is a SchemaModel instance
+*
+* @example
+* ```typescript
+* if (isSchemaModel(model)) {
+*   // TypeScript knows model.config is available
+*   console.log(model.config.name);
+* }
+* ```
+*/
+function isSchemaModel(model) {
+	return model !== null && model !== void 0 && "config" in model && typeof model.config === "object" && "name" in model.config;
+}
+/**
 * Helper to define a SchemaModel with type inference.
 * Equivalent to `new SchemaModel(config)` but with better ergonomics.
 */
 const defineSchemaModel = (config) => new SchemaModel(config);
 
 //#endregion
-export { SchemaModel, defineSchemaModel };
+export { SchemaModel, defineSchemaModel, isSchemaModel };
 //# sourceMappingURL=SchemaModel.js.map

package/dist/SchemaModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaModel.js","names":["config: SchemaModelConfig<Fields>","base: z.ZodType"],"sources":["../src/SchemaModel.ts"],"sourcesContent":["import { type AnyFieldType } from './FieldType';\nimport { type AnyEnumType } from './EnumType';\nimport * as z from 'zod';\nimport type { Maybe } from 'graphql/jsutils/Maybe';\n\ntype FieldLike = AnyFieldType | AnyEnumType | AnySchemaModel;\n\n/** Field configuration for a SchemaModel property. */\nexport interface SchemaFieldConfig<Type extends FieldLike = FieldLike> {\n  type: Type;\n  isOptional: boolean;\n  /** When present and true, the field is an array */\n  isArray?: true;\n}\n\nexport type SchemaModelFieldsAnyConfig<Type extends FieldLike = FieldLike> =\n  Record<string, SchemaFieldConfig<Type>>;\n\n/** Model definition: name and fields. */\nexport interface SchemaModelConfig<Fields extends SchemaModelFieldsAnyConfig> {\n  name: string;\n  description?: Maybe<string>;\n  fields: Fields;\n}\n\n/**\n * Named object model built from FieldType/EnumType/SchemaModel fields.\n * Provides zod and GraphQL input helpers, and supports arrays/optional fields.\n */\nexport class SchemaModel<Fields extends SchemaModelFieldsAnyConfig> {\n  constructor(public readonly config: SchemaModelConfig<Fields>) {}\n\n  /**\n   * Build a typed ZodObject from the model fields, preserving each field's\n   * Zod schema and optionality at the type level when possible.\n   */\n  getZod(): TopLevelZodFromModel<Fields> {\n    const shape = Object.entries(this.config.fields).reduce(\n      (acc, [key, def]) => {\n        const base: z.ZodType = (\n          def.type as unknown as { getZod: () => z.ZodType }\n        ).getZod();\n        const withArray = def.isArray ? z.array(base) : base;\n        (acc as Record<string, z.ZodType>)[key] = def.isOptional\n          ? withArray.optional()\n          : withArray;\n        return acc;\n      },\n      {} as Record<string, z.ZodType>\n    ) as unknown as ZodShapeFromFields<Fields>;\n\n    return z.object(shape) as z.ZodObject<ZodShapeFromFields<Fields>>;\n  }\n\n  /** Input object name for GraphQL builder adapters. */\n  getPothosInput() {\n    return this.config.name;\n  }\n}\n\nexport type AnySchemaModel = SchemaModel<SchemaModelFieldsAnyConfig>;\n\nexport type ZodSchemaModel<Field extends AnySchemaModel> = z.infer<\n  ReturnType<Field['getZod']>\n>;\n\ntype InferZodFromType<T> =\n  T extends SchemaModel<SchemaModelFieldsAnyConfig>\n    ? z.ZodObject<z.ZodRawShape>\n    : T extends AnyFieldType\n      ? ReturnType<T['getZod']>\n      : T extends AnyEnumType\n        ? ReturnType<T['getZod']>\n        : never;\n\ntype MaybeArray<Z extends z.ZodType, A> = A extends true ? z.ZodArray<Z> : Z;\ntype MaybeOptional<Z extends z.ZodType, O> = O extends true\n  ? z.ZodOptional<Z>\n  : Z;\n\n/**\n * Helper type: derive the Zod shape from the field config.\n * Supports nested SchemaModel and arrays, preserving optionality and list-ness.\n */\ntype FieldIsArray<FC> = FC extends { isArray: true } ? true : false;\n\nexport type ZodShapeFromFields<F extends SchemaModelFieldsAnyConfig> = {\n  [K in keyof F]: MaybeOptional<\n    MaybeArray<InferZodFromType<F[K]['type']>, FieldIsArray<F[K]>>,\n    F[K]['isOptional']\n  >;\n};\n\n/**\n * The top-level Zod schema returned by getZod():\n * either ZodObject<...> or ZodArray<ZodObject<...>> when config.isArray.\n */\nexport type TopLevelZodFromModel<F extends SchemaModelFieldsAnyConfig> =\n  z.ZodObject<ZodShapeFromFields<F>>;\n\n/**\n * Helper to define a SchemaModel with type inference.\n * Equivalent to `new SchemaModel(config)` but with better ergonomics.\n */\nexport const defineSchemaModel = <Fields extends SchemaModelFieldsAnyConfig>(\n  config: SchemaModelConfig<Fields>\n): SchemaModel<Fields> => new SchemaModel(config);\n"],"mappings":";;;;;;;;;AA6BA,IAAa,cAAb,MAAoE;CAClE,YAAY,AAAgBA,QAAmC;EAAnC;;;;;;CAM5B,SAAuC;EACrC,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,OAAO,CAAC,QAC9C,KAAK,CAAC,KAAK,SAAS;GACnB,MAAMC,OACJ,IAAI,KACJ,QAAQ;GACV,MAAM,YAAY,IAAI,UAAU,EAAE,MAAM,KAAK,GAAG;AAChD,GAAC,IAAkC,OAAO,IAAI,aAC1C,UAAU,UAAU,GACpB;AACJ,UAAO;KAET,EAAE,CACH;AAED,SAAO,EAAE,OAAO,MAAM;;;CAIxB,iBAAiB;AACf,SAAO,KAAK,OAAO;;;;;;;AAgDvB,MAAa,qBACX,WACwB,IAAI,YAAY,OAAO"}
+{"version":3,"file":"SchemaModel.js","names":["config: SchemaModelConfig<Fields>","base: z.ZodType","z"],"sources":["../src/SchemaModel.ts"],"sourcesContent":["import { type AnyFieldType } from './FieldType';\nimport { type AnyEnumType } from './EnumType';\nimport { type SchemaModelType } from './SchemaModelType';\nimport * as z from 'zod';\nimport type { Maybe } from 'graphql/jsutils/Maybe';\n\n/**\n * All types that can be used as field types in a SchemaModel.\n * Supports FieldType, EnumType, nested SchemaModel, or any SchemaType implementation.\n */\ntype FieldLike = AnyFieldType | AnyEnumType | AnySchemaModel | SchemaModelType;\n\n/** Field configuration for a SchemaModel property. */\nexport interface SchemaFieldConfig<Type extends FieldLike = FieldLike> {\n  type: Type;\n  isOptional: boolean;\n  /** When present and true, the field is an array */\n  isArray?: true;\n}\n\nexport type SchemaModelFieldsAnyConfig<Type extends FieldLike = FieldLike> =\n  Record<string, SchemaFieldConfig<Type>>;\n\n/** Model definition: name and fields. */\nexport interface SchemaModelConfig<Fields extends SchemaModelFieldsAnyConfig> {\n  name: string;\n  description?: Maybe<string>;\n  fields: Fields;\n}\n\n/**\n * Named object model built from FieldType/EnumType/SchemaModel fields.\n * Provides zod and GraphQL input helpers, and supports arrays/optional fields.\n */\nexport class SchemaModel<\n  Fields extends SchemaModelFieldsAnyConfig,\n> implements SchemaModelType {\n  constructor(public readonly config: SchemaModelConfig<Fields>) {}\n\n  /**\n   * Build a typed ZodObject from the model fields, preserving each field's\n   * Zod schema and optionality at the type level when possible.\n   */\n  getZod(): TopLevelZodFromModel<Fields> {\n    const shape = Object.entries(this.config.fields).reduce(\n      (acc, [key, def]) => {\n        const base: z.ZodType = (\n          def.type as unknown as { getZod: () => z.ZodType }\n        ).getZod();\n        const withArray = def.isArray ? z.array(base) : base;\n        (acc as Record<string, z.ZodType>)[key] = def.isOptional\n          ? withArray.optional()\n          : withArray;\n        return acc;\n      },\n      {} as Record<string, z.ZodType>\n    ) as unknown as ZodShapeFromFields<Fields>;\n\n    return z.object(shape) as z.ZodObject<ZodShapeFromFields<Fields>>;\n  }\n\n  /** Input object name for GraphQL builder adapters. */\n  getPothosInput() {\n    return this.config.name;\n  }\n}\n\n/**\n * Union of all types that can serve as a schema model.\n * This is the main type expected by OperationSpec, EventSpec, FormSpec, etc.\n *\n * Supports:\n * - SchemaModel instances (native ContractSpec types)\n * - Any SchemaType implementation (ZodSchemaType, JsonSchemaType, etc.)\n */\nexport type AnySchemaModel =\n  | SchemaModel<SchemaModelFieldsAnyConfig>\n  | SchemaModelType;\n\n/**\n * Type guard to check if a value is a SchemaModel (not just any SchemaType).\n * Use this when you need to access SchemaModel-specific properties like `config`.\n *\n * @param model - The model to check\n * @returns True if the model is a SchemaModel instance\n *\n * @example\n * ```typescript\n * if (isSchemaModel(model)) {\n *   // TypeScript knows model.config is available\n *   console.log(model.config.name);\n * }\n * ```\n */\nexport function isSchemaModel(\n  model: AnySchemaModel | null | undefined\n): model is SchemaModel<SchemaModelFieldsAnyConfig> {\n  return (\n    model !== null &&\n    model !== undefined &&\n    'config' in model &&\n    typeof (model as SchemaModel<SchemaModelFieldsAnyConfig>).config ===\n      'object' &&\n    'name' in (model as SchemaModel<SchemaModelFieldsAnyConfig>).config\n  );\n}\n\nexport type ZodSchemaModel<Field extends AnySchemaModel> = z.infer<\n  ReturnType<Field['getZod']>\n>;\n\ntype InferZodFromType<T> =\n  T extends SchemaModel<SchemaModelFieldsAnyConfig>\n    ? z.ZodObject<z.ZodRawShape>\n    : T extends AnyFieldType\n      ? ReturnType<T['getZod']>\n      : T extends AnyEnumType\n        ? ReturnType<T['getZod']>\n        : T extends SchemaModelType\n          ? ReturnType<T['getZod']>\n          : z.ZodUnknown;\n\ntype MaybeArray<Z extends z.ZodType, A> = A extends true ? z.ZodArray<Z> : Z;\ntype MaybeOptional<Z extends z.ZodType, O> = O extends true\n  ? z.ZodOptional<Z>\n  : Z;\n\n/**\n * Helper type: derive the Zod shape from the field config.\n * Supports nested SchemaModel and arrays, preserving optionality and list-ness.\n */\ntype FieldIsArray<FC> = FC extends { isArray: true } ? true : false;\n\nexport type ZodShapeFromFields<F extends SchemaModelFieldsAnyConfig> = {\n  [K in keyof F]: MaybeOptional<\n    MaybeArray<InferZodFromType<F[K]['type']>, FieldIsArray<F[K]>>,\n    F[K]['isOptional']\n  >;\n};\n\n/**\n * The top-level Zod schema returned by getZod():\n * either ZodObject<...> or ZodArray<ZodObject<...>> when config.isArray.\n */\nexport type TopLevelZodFromModel<F extends SchemaModelFieldsAnyConfig> =\n  z.ZodObject<ZodShapeFromFields<F>>;\n\n/**\n * Helper to define a SchemaModel with type inference.\n * Equivalent to `new SchemaModel(config)` but with better ergonomics.\n */\nexport const defineSchemaModel = <Fields extends SchemaModelFieldsAnyConfig>(\n  config: SchemaModelConfig<Fields>\n): SchemaModel<Fields> => new SchemaModel(config);\n"],"mappings":";;;;;;;;;AAkCA,IAAa,cAAb,MAE6B;CAC3B,YAAY,AAAgBA,QAAmC;EAAnC;;;;;;CAM5B,SAAuC;EACrC,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,OAAO,CAAC,QAC9C,KAAK,CAAC,KAAK,SAAS;GACnB,MAAMC,OACJ,IAAI,KACJ,QAAQ;GACV,MAAM,YAAY,IAAI,UAAUC,IAAE,MAAM,KAAK,GAAG;AAChD,GAAC,IAAkC,OAAO,IAAI,aAC1C,UAAU,UAAU,GACpB;AACJ,UAAO;KAET,EAAE,CACH;AAED,SAAOA,IAAE,OAAO,MAAM;;;CAIxB,iBAAiB;AACf,SAAO,KAAK,OAAO;;;;;;;;;;;;;;;;;;AA+BvB,SAAgB,cACd,OACkD;AAClD,QACE,UAAU,QACV,UAAU,UACV,YAAY,SACZ,OAAQ,MAAkD,WACxD,YACF,UAAW,MAAkD;;;;;;AAgDjE,MAAa,qBACX,WACwB,IAAI,YAAY,OAAO"}

package/dist/SchemaModelType.d.ts

@@ -0,0 +1,60 @@
+import * as z$1 from "zod";
+
+//#region src/SchemaModelType.d.ts
+
+/**
+ * Supported schema output formats for code generation.
+ */
+type SchemaFormat = 'contractspec' | 'zod' | 'json-schema' | 'graphql';
+/**
+ * Unified interface for all schema-compatible types.
+ * Any type used in ContractSpec schemas must implement this interface.
+ *
+ * @template T - The TypeScript type this schema represents
+ *
+ * @example
+ * ```typescript
+ * // All of these implement SchemaType:
+ * const fieldType = ScalarTypeEnum.String_unsecure();
+ * const schemaModel = new SchemaModel({ name: 'User', fields: {...} });
+ * const zodWrapper = fromZod(z.object({ name: z.string() }));
+ * ```
+ */
+interface SchemaModelType<T = unknown> {
+  /**
+   * Return the Zod schema for runtime validation.
+   * This is the primary method - all schema types must provide Zod conversion.
+   */
+  getZod(): z$1.ZodType<T>;
+  /**
+   * Return GraphQL type info for Pothos/GraphQL integration.
+   * Optional - types without GraphQL representation return undefined.
+   */
+  getPothos?(): unknown;
+  /**
+   * Return JSON Schema representation.
+   * Optional - types without JSON Schema representation return undefined.
+   */
+  getJsonSchema?(): unknown;
+}
+/**
+ * Type guard to check if a value implements the SchemaType interface.
+ *
+ * @param value - Value to check
+ * @returns True if value has a getZod method
+ *
+ * @example
+ * ```typescript
+ * if (isSchemaType(field.type)) {
+ *   const zodSchema = field.type.getZod();
+ * }
+ * ```
+ */
+declare function isSchemaType(value: unknown): value is SchemaModelType;
+/**
+ * Type alias for any SchemaType implementation.
+ */
+type AnySchemaType = SchemaModelType<unknown>;
+//#endregion
+export { AnySchemaType, SchemaFormat, SchemaModelType, isSchemaType };
+//# sourceMappingURL=SchemaModelType.d.ts.map

package/dist/SchemaModelType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaModelType.d.ts","names":[],"sources":["../src/SchemaModelType.ts"],"sourcesContent":[],"mappings":";;;;;;;KAcY,YAAA;;;;;;;;;;;;;;;UAgBK;;;;;YAKL,GAAA,CAAE,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;iBA4BN,YAAA,2BAAuC;;;;KAY3C,aAAA,GAAgB"}

package/dist/SchemaModelType.js

@@ -0,0 +1,21 @@
+//#region src/SchemaModelType.ts
+/**
+* Type guard to check if a value implements the SchemaType interface.
+*
+* @param value - Value to check
+* @returns True if value has a getZod method
+*
+* @example
+* ```typescript
+* if (isSchemaType(field.type)) {
+*   const zodSchema = field.type.getZod();
+* }
+* ```
+*/
+function isSchemaType(value) {
+	return value !== null && typeof value === "object" && "getZod" in value && typeof value.getZod === "function";
+}
+
+//#endregion
+export { isSchemaType };
+//# sourceMappingURL=SchemaModelType.js.map

package/dist/SchemaModelType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaModelType.js","names":[],"sources":["../src/SchemaModelType.ts"],"sourcesContent":["/**\n * Unified schema type interface for ContractSpec.\n *\n * This module provides a vendor-agnostic abstraction over different schema\n * definition approaches (SchemaModel, Zod, JSON Schema, GraphQL scalars).\n *\n * @module SchemaType\n */\n\nimport type * as z from 'zod';\n\n/**\n * Supported schema output formats for code generation.\n */\nexport type SchemaFormat = 'contractspec' | 'zod' | 'json-schema' | 'graphql';\n\n/**\n * Unified interface for all schema-compatible types.\n * Any type used in ContractSpec schemas must implement this interface.\n *\n * @template T - The TypeScript type this schema represents\n *\n * @example\n * ```typescript\n * // All of these implement SchemaType:\n * const fieldType = ScalarTypeEnum.String_unsecure();\n * const schemaModel = new SchemaModel({ name: 'User', fields: {...} });\n * const zodWrapper = fromZod(z.object({ name: z.string() }));\n * ```\n */\nexport interface SchemaModelType<T = unknown> {\n  /**\n   * Return the Zod schema for runtime validation.\n   * This is the primary method - all schema types must provide Zod conversion.\n   */\n  getZod(): z.ZodType<T>;\n\n  /**\n   * Return GraphQL type info for Pothos/GraphQL integration.\n   * Optional - types without GraphQL representation return undefined.\n   */\n  getPothos?(): unknown;\n\n  /**\n   * Return JSON Schema representation.\n   * Optional - types without JSON Schema representation return undefined.\n   */\n  getJsonSchema?(): unknown;\n}\n\n/**\n * Type guard to check if a value implements the SchemaType interface.\n *\n * @param value - Value to check\n * @returns True if value has a getZod method\n *\n * @example\n * ```typescript\n * if (isSchemaType(field.type)) {\n *   const zodSchema = field.type.getZod();\n * }\n * ```\n */\nexport function isSchemaType(value: unknown): value is SchemaModelType {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    'getZod' in value &&\n    typeof (value as SchemaModelType).getZod === 'function'\n  );\n}\n\n/**\n * Type alias for any SchemaType implementation.\n */\nexport type AnySchemaType = SchemaModelType<unknown>;\n"],"mappings":";;;;;;;;;;;;;;AA+DA,SAAgB,aAAa,OAA0C;AACrE,QACE,UAAU,QACV,OAAO,UAAU,YACjB,YAAY,SACZ,OAAQ,MAA0B,WAAW"}

package/dist/ZodSchemaType.d.ts

@@ -0,0 +1,92 @@
+import { SchemaModelType } from "./SchemaModelType.js";
+import * as z$1 from "zod";
+
+//#region src/ZodSchemaType.d.ts
+
+/**
+ * Options for ZodSchemaType wrapper.
+ */
+interface ZodSchemaTypeOptions {
+  /** Name for GraphQL/JSON Schema representation */
+  name?: string;
+  /** Description for documentation */
+  description?: string;
+}
+/**
+ * Wrapper to use a raw Zod schema as a SchemaType.
+ * Enables schema definition directly with Zod for maximum flexibility.
+ *
+ * @template T - The Zod schema type being wrapped
+ *
+ * @example
+ * ```typescript
+ * const UserSchema = fromZod(
+ *   z.object({
+ *     id: z.string().uuid(),
+ *     name: z.string().min(1),
+ *     email: z.string().email(),
+ *   }),
+ *   { name: 'User' }
+ * );
+ *
+ * // Use in SchemaModel
+ * const CreateUserInput = new SchemaModel({
+ *   name: 'CreateUserInput',
+ *   fields: {
+ *     user: { type: UserSchema, isOptional: false },
+ *   },
+ * });
+ * ```
+ */
+declare class ZodSchemaType<T extends z$1.ZodType> implements SchemaModelType<z$1.infer<T>> {
+  private readonly schema;
+  private readonly options;
+  constructor(schema: T, options?: ZodSchemaTypeOptions);
+  /**
+   * Return the wrapped Zod schema.
+   */
+  getZod(): z$1.ZodType<z$1.infer<T>>;
+  /**
+   * Return JSON Schema representation using Zod's toJSONSchema.
+   */
+  getJsonSchema(): unknown;
+  /**
+   * Return GraphQL type info.
+   * For complex Zod types, defaults to JSON scalar.
+   */
+  getPothos(): {
+    type: string;
+    name?: string;
+  };
+  /**
+   * Get the configured name for this schema.
+   */
+  getName(): string | undefined;
+  /**
+   * Get the configured description for this schema.
+   */
+  getDescription(): string | undefined;
+}
+/**
+ * Helper to wrap a raw Zod schema as a SchemaType.
+ *
+ * @param schema - The Zod schema to wrap
+ * @param options - Optional configuration
+ * @returns A SchemaType-compatible wrapper
+ *
+ * @example
+ * ```typescript
+ * const AddressSchema = fromZod(
+ *   z.object({
+ *     street: z.string(),
+ *     city: z.string(),
+ *     country: z.string(),
+ *   }),
+ *   { name: 'Address', description: 'Physical address' }
+ * );
+ * ```
+ */
+declare const fromZod: <T extends z$1.ZodType>(schema: T, options?: ZodSchemaTypeOptions) => ZodSchemaType<T>;
+//#endregion
+export { ZodSchemaType, ZodSchemaTypeOptions, fromZod };
+//# sourceMappingURL=ZodSchemaType.d.ts.map

package/dist/ZodSchemaType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZodSchemaType.d.ts","names":[],"sources":["../src/ZodSchemaType.ts"],"sourcesContent":[],"mappings":";;;;;;;;AA8Dc,UA/CG,oBAAA,CA+CH;EAd6C;EAAe,IAAA,CAAA,EAAA,MAAA;EAmE7D;EAAqB,WAAE,CAAA,EAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAnEvB,wBAAwB,GAAA,CAAE,oBAAoB,gBACzD,GAAA,CAAE,MAAM;;;sBAKY,aAAY;;;;YAQtB,GAAA,CAAE,QAAQ,GAAA,CAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAqDjB,oBAAqB,GAAA,CAAE,iBAC1B,aACE,yBACT,cAAc"}

package/dist/ZodSchemaType.js

@@ -0,0 +1,103 @@
+import * as z$1 from "zod";
+
+//#region src/ZodSchemaType.ts
+/**
+* Zod schema wrapper for ContractSpec compatibility.
+*
+* Wraps raw Zod schemas to implement the SchemaType interface,
+* enabling direct Zod usage in ContractSpec definitions.
+*
+* @module ZodSchemaType
+*/
+/**
+* Wrapper to use a raw Zod schema as a SchemaType.
+* Enables schema definition directly with Zod for maximum flexibility.
+*
+* @template T - The Zod schema type being wrapped
+*
+* @example
+* ```typescript
+* const UserSchema = fromZod(
+*   z.object({
+*     id: z.string().uuid(),
+*     name: z.string().min(1),
+*     email: z.string().email(),
+*   }),
+*   { name: 'User' }
+* );
+*
+* // Use in SchemaModel
+* const CreateUserInput = new SchemaModel({
+*   name: 'CreateUserInput',
+*   fields: {
+*     user: { type: UserSchema, isOptional: false },
+*   },
+* });
+* ```
+*/
+var ZodSchemaType = class {
+	schema;
+	options;
+	constructor(schema, options = {}) {
+		this.schema = schema;
+		this.options = options;
+	}
+	/**
+	* Return the wrapped Zod schema.
+	*/
+	getZod() {
+		return this.schema;
+	}
+	/**
+	* Return JSON Schema representation using Zod's toJSONSchema.
+	*/
+	getJsonSchema() {
+		return z$1.toJSONSchema(this.schema);
+	}
+	/**
+	* Return GraphQL type info.
+	* For complex Zod types, defaults to JSON scalar.
+	*/
+	getPothos() {
+		return {
+			type: "JSON",
+			name: this.options.name
+		};
+	}
+	/**
+	* Get the configured name for this schema.
+	*/
+	getName() {
+		return this.options.name;
+	}
+	/**
+	* Get the configured description for this schema.
+	*/
+	getDescription() {
+		return this.options.description;
+	}
+};
+/**
+* Helper to wrap a raw Zod schema as a SchemaType.
+*
+* @param schema - The Zod schema to wrap
+* @param options - Optional configuration
+* @returns A SchemaType-compatible wrapper
+*
+* @example
+* ```typescript
+* const AddressSchema = fromZod(
+*   z.object({
+*     street: z.string(),
+*     city: z.string(),
+*     country: z.string(),
+*   }),
+*   { name: 'Address', description: 'Physical address' }
+* );
+* ```
+*/
+const fromZod = (schema, options) => new ZodSchemaType(schema, options);
+
+//#endregion
+export { ZodSchemaType, fromZod };
+//# sourceMappingURL=ZodSchemaType.js.map

package/dist/ZodSchemaType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZodSchemaType.js","names":["z"],"sources":["../src/ZodSchemaType.ts"],"sourcesContent":["/**\n * Zod schema wrapper for ContractSpec compatibility.\n *\n * Wraps raw Zod schemas to implement the SchemaType interface,\n * enabling direct Zod usage in ContractSpec definitions.\n *\n * @module ZodSchemaType\n */\n\nimport * as z from 'zod';\nimport type { SchemaModelType } from './SchemaModelType';\n\n/**\n * Options for ZodSchemaType wrapper.\n */\nexport interface ZodSchemaTypeOptions {\n  /** Name for GraphQL/JSON Schema representation */\n  name?: string;\n  /** Description for documentation */\n  description?: string;\n}\n\n/**\n * Wrapper to use a raw Zod schema as a SchemaType.\n * Enables schema definition directly with Zod for maximum flexibility.\n *\n * @template T - The Zod schema type being wrapped\n *\n * @example\n * ```typescript\n * const UserSchema = fromZod(\n *   z.object({\n *     id: z.string().uuid(),\n *     name: z.string().min(1),\n *     email: z.string().email(),\n *   }),\n *   { name: 'User' }\n * );\n *\n * // Use in SchemaModel\n * const CreateUserInput = new SchemaModel({\n *   name: 'CreateUserInput',\n *   fields: {\n *     user: { type: UserSchema, isOptional: false },\n *   },\n * });\n * ```\n */\nexport class ZodSchemaType<T extends z.ZodType> implements SchemaModelType<\n  z.infer<T>\n> {\n  private readonly schema: T;\n  private readonly options: ZodSchemaTypeOptions;\n\n  constructor(schema: T, options: ZodSchemaTypeOptions = {}) {\n    this.schema = schema;\n    this.options = options;\n  }\n\n  /**\n   * Return the wrapped Zod schema.\n   */\n  getZod(): z.ZodType<z.infer<T>> {\n    return this.schema as z.ZodType<z.infer<T>>;\n  }\n\n  /**\n   * Return JSON Schema representation using Zod's toJSONSchema.\n   */\n  getJsonSchema(): unknown {\n    return z.toJSONSchema(this.schema);\n  }\n\n  /**\n   * Return GraphQL type info.\n   * For complex Zod types, defaults to JSON scalar.\n   */\n  getPothos(): { type: string; name?: string } {\n    return { type: 'JSON', name: this.options.name };\n  }\n\n  /**\n   * Get the configured name for this schema.\n   */\n  getName(): string | undefined {\n    return this.options.name;\n  }\n\n  /**\n   * Get the configured description for this schema.\n   */\n  getDescription(): string | undefined {\n    return this.options.description;\n  }\n}\n\n/**\n * Helper to wrap a raw Zod schema as a SchemaType.\n *\n * @param schema - The Zod schema to wrap\n * @param options - Optional configuration\n * @returns A SchemaType-compatible wrapper\n *\n * @example\n * ```typescript\n * const AddressSchema = fromZod(\n *   z.object({\n *     street: z.string(),\n *     city: z.string(),\n *     country: z.string(),\n *   }),\n *   { name: 'Address', description: 'Physical address' }\n * );\n * ```\n */\nexport const fromZod = <T extends z.ZodType>(\n  schema: T,\n  options?: ZodSchemaTypeOptions\n): ZodSchemaType<T> => new ZodSchemaType(schema, options);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,IAAa,gBAAb,MAEE;CACA,AAAiB;CACjB,AAAiB;CAEjB,YAAY,QAAW,UAAgC,EAAE,EAAE;AACzD,OAAK,SAAS;AACd,OAAK,UAAU;;;;;CAMjB,SAAgC;AAC9B,SAAO,KAAK;;;;;CAMd,gBAAyB;AACvB,SAAOA,IAAE,aAAa,KAAK,OAAO;;;;;;CAOpC,YAA6C;AAC3C,SAAO;GAAE,MAAM;GAAQ,MAAM,KAAK,QAAQ;GAAM;;;;;CAMlD,UAA8B;AAC5B,SAAO,KAAK,QAAQ;;;;;CAMtB,iBAAqC;AACnC,SAAO,KAAK,QAAQ;;;;;;;;;;;;;;;;;;;;;;AAuBxB,MAAa,WACX,QACA,YACqB,IAAI,cAAc,QAAQ,QAAQ"}

package/dist/entity/defineEntity.js

@@ -1,4 +1,4 @@
-import * as z from "zod";
+import * as z$1 from "zod";
 
 //#region src/entity/defineEntity.ts
 /**
@@ -145,7 +145,7 @@ const field = {
 		return {
 			kind: "scalar",
 			type: "String",
-			zod: z.email(),
+			zod: z$1.email(),
 			...opts
 		};
 	},
@@ -153,7 +153,7 @@ const field = {
 		return {
 			kind: "scalar",
 			type: "String",
-			zod: z.url(),
+			zod: z$1.url(),
 			...opts
 		};
 	},

package/dist/entity/defineEntity.js.map

@@ -1 +1 @@
-{"version":3,"file":"defineEntity.js","names":[],"sources":["../../src/entity/defineEntity.ts"],"sourcesContent":["import * as z from 'zod';\nimport type {\n  EntityEnumDef,\n  EntityEnumField,\n  EntityField,\n  EntityIndex,\n  EntityRelationField,\n  EntityScalarField,\n  EntitySpec,\n} from './types';\n\n/**\n * Helper to define a database entity with full type safety.\n *\n * @example\n * ```typescript\n * const UserEntity = defineEntity({\n *   name: 'User',\n *   schema: 'lssm_sigil',\n *   description: 'A user of the platform.',\n *   fields: {\n *     id: field.id(),\n *     email: field.string({ isUnique: true, zod: z.string().email() }),\n *     name: field.string({ isOptional: true }),\n *     createdAt: field.createdAt(),\n *     updatedAt: field.updatedAt(),\n *     memberships: field.hasMany('Member'),\n *   },\n *   indexes: [{ fields: ['email'], unique: true }],\n * });\n * ```\n */\nexport function defineEntity<TFields extends Record<string, EntityField>>(\n  spec: EntitySpec<TFields>\n): EntitySpec<TFields> {\n  return spec;\n}\n\n/**\n * Helper to define an enum that can be shared across entities.\n */\nexport function defineEntityEnum(def: EntityEnumDef): EntityEnumDef {\n  return def;\n}\n\n/**\n * Field builder helpers for common field patterns.\n */\nexport const field = {\n  // ============ Scalar fields ============\n\n  /** String field */\n  string(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'String', ...opts };\n  },\n\n  /** Integer field */\n  int(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Int', ...opts };\n  },\n\n  /** Float field */\n  float(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Float', ...opts };\n  },\n\n  /** Boolean field */\n  boolean(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Boolean', ...opts };\n  },\n\n  /** DateTime field */\n  dateTime(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'DateTime', ...opts };\n  },\n\n  /** JSON field */\n  json(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Json', ...opts };\n  },\n\n  /** BigInt field */\n  bigInt(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'BigInt', ...opts };\n  },\n\n  /** Decimal field */\n  decimal(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Decimal', ...opts };\n  },\n\n  /** Bytes field */\n  bytes(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Bytes', ...opts };\n  },\n\n  // ============ Common patterns ============\n\n  /** Primary key field with cuid() default */\n  id(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type' | 'isId'>>\n  ): EntityScalarField {\n    return {\n      kind: 'scalar',\n      type: 'String',\n      isId: true,\n      default: 'cuid()',\n      ...opts,\n    };\n  },\n\n  /** Primary key field with uuid() default */\n  uuid(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type' | 'isId'>>\n  ): EntityScalarField {\n    return {\n      kind: 'scalar',\n      type: 'String',\n      isId: true,\n      default: 'uuid()',\n      ...opts,\n    };\n  },\n\n  /** Auto-increment integer primary key */\n  autoIncrement(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type' | 'isId'>>\n  ): EntityScalarField {\n    return {\n      kind: 'scalar',\n      type: 'Int',\n      isId: true,\n      default: 'autoincrement()',\n      ...opts,\n    };\n  },\n\n  /** createdAt timestamp with now() default */\n  createdAt(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type' | 'default'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'DateTime', default: 'now()', ...opts };\n  },\n\n  /** updatedAt timestamp with @updatedAt */\n  updatedAt(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type' | 'updatedAt'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'DateTime', updatedAt: true, ...opts };\n  },\n\n  /** Email field with validation */\n  email(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return {\n      kind: 'scalar',\n      type: 'String',\n      zod: z.email(),\n      ...opts,\n    };\n  },\n\n  /** URL field with validation */\n  url(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return {\n      kind: 'scalar',\n      type: 'String',\n      zod: z.url(),\n      ...opts,\n    };\n  },\n\n  // ============ Enum fields ============\n\n  /** Enum field */\n  enum(\n    enumName: string,\n    opts?: Partial<Omit<EntityEnumField, 'kind' | 'enumName'>>\n  ): EntityEnumField {\n    return { kind: 'enum', enumName, ...opts };\n  },\n\n  /** Inline enum field with values */\n  inlineEnum(\n    enumName: string,\n    values: readonly string[],\n    opts?: Partial<Omit<EntityEnumField, 'kind' | 'enumName' | 'values'>>\n  ): EntityEnumField {\n    return { kind: 'enum', enumName, values, ...opts };\n  },\n\n  // ============ Relation fields ============\n\n  /** Has one relation (1:1 inverse side) */\n  hasOne(\n    target: string,\n    opts?: Partial<Omit<EntityRelationField, 'kind' | 'type' | 'target'>>\n  ): EntityRelationField {\n    return { kind: 'relation', type: 'hasOne', target, ...opts };\n  },\n\n  /** Has many relation (1:N inverse side) */\n  hasMany(\n    target: string,\n    opts?: Partial<Omit<EntityRelationField, 'kind' | 'type' | 'target'>>\n  ): EntityRelationField {\n    return { kind: 'relation', type: 'hasMany', target, ...opts };\n  },\n\n  /** Belongs to relation (N:1 owning side with foreign key) */\n  belongsTo(\n    target: string,\n    fields: string[],\n    references: string[],\n    opts?: Partial<\n      Omit<\n        EntityRelationField,\n        'kind' | 'type' | 'target' | 'fields' | 'references'\n      >\n    >\n  ): EntityRelationField {\n    return {\n      kind: 'relation',\n      type: 'belongsTo',\n      target,\n      fields,\n      references,\n      ...opts,\n    };\n  },\n\n  /** Foreign key field (string) - use with belongsTo */\n  foreignKey(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'String', ...opts };\n  },\n};\n\n/**\n * Index builder helpers.\n */\nexport const index = {\n  /** Create a regular index */\n  on(\n    fields: string[],\n    opts?: Partial<Omit<EntityIndex, 'fields'>>\n  ): EntityIndex {\n    return { fields, ...opts };\n  },\n\n  /** Create a unique constraint index */\n  unique(\n    fields: string[],\n    opts?: Partial<Omit<EntityIndex, 'fields' | 'unique'>>\n  ): EntityIndex {\n    return { fields, unique: true, ...opts };\n  },\n\n  /** Create a compound index with sort orders */\n  compound(\n    fields: string[],\n    sort: Record<string, 'Asc' | 'Desc'>,\n    opts?: Partial<Omit<EntityIndex, 'fields' | 'sort'>>\n  ): EntityIndex {\n    return { fields, sort, ...opts };\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,aACd,MACqB;AACrB,QAAO;;;;;AAMT,SAAgB,iBAAiB,KAAmC;AAClE,QAAO;;;;;AAMT,MAAa,QAAQ;CAInB,OACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAU,GAAG;GAAM;;CAIpD,IACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAO,GAAG;GAAM;;CAIjD,MACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAS,GAAG;GAAM;;CAInD,QACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAW,GAAG;GAAM;;CAIrD,SACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAY,GAAG;GAAM;;CAItD,KACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAQ,GAAG;GAAM;;CAIlD,OACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAU,GAAG;GAAM;;CAIpD,QACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAW,GAAG;GAAM;;CAIrD,MACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAS,GAAG;GAAM;;CAMnD,GACE,MACmB;AACnB,SAAO;GACL,MAAM;GACN,MAAM;GACN,MAAM;GACN,SAAS;GACT,GAAG;GACJ;;CAIH,KACE,MACmB;AACnB,SAAO;GACL,MAAM;GACN,MAAM;GACN,MAAM;GACN,SAAS;GACT,GAAG;GACJ;;CAIH,cACE,MACmB;AACnB,SAAO;GACL,MAAM;GACN,MAAM;GACN,MAAM;GACN,SAAS;GACT,GAAG;GACJ;;CAIH,UACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAY,SAAS;GAAS,GAAG;GAAM;;CAIxE,UACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAY,WAAW;GAAM,GAAG;GAAM;;CAIvE,MACE,MACmB;AACnB,SAAO;GACL,MAAM;GACN,MAAM;GACN,KAAK,EAAE,OAAO;GACd,GAAG;GACJ;;CAIH,IACE,MACmB;AACnB,SAAO;GACL,MAAM;GACN,MAAM;GACN,KAAK,EAAE,KAAK;GACZ,GAAG;GACJ;;CAMH,KACE,UACA,MACiB;AACjB,SAAO;GAAE,MAAM;GAAQ;GAAU,GAAG;GAAM;;CAI5C,WACE,UACA,QACA,MACiB;AACjB,SAAO;GAAE,MAAM;GAAQ;GAAU;GAAQ,GAAG;GAAM;;CAMpD,OACE,QACA,MACqB;AACrB,SAAO;GAAE,MAAM;GAAY,MAAM;GAAU;GAAQ,GAAG;GAAM;;CAI9D,QACE,QACA,MACqB;AACrB,SAAO;GAAE,MAAM;GAAY,MAAM;GAAW;GAAQ,GAAG;GAAM;;CAI/D,UACE,QACA,QACA,YACA,MAMqB;AACrB,SAAO;GACL,MAAM;GACN,MAAM;GACN;GACA;GACA;GACA,GAAG;GACJ;;CAIH,WACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAU,GAAG;GAAM;;CAErD;;;;AAKD,MAAa,QAAQ;CAEnB,GACE,QACA,MACa;AACb,SAAO;GAAE;GAAQ,GAAG;GAAM;;CAI5B,OACE,QACA,MACa;AACb,SAAO;GAAE;GAAQ,QAAQ;GAAM,GAAG;GAAM;;CAI1C,SACE,QACA,MACA,MACa;AACb,SAAO;GAAE;GAAQ;GAAM,GAAG;GAAM;;CAEnC"}
+{"version":3,"file":"defineEntity.js","names":["z"],"sources":["../../src/entity/defineEntity.ts"],"sourcesContent":["import * as z from 'zod';\nimport type {\n  EntityEnumDef,\n  EntityEnumField,\n  EntityField,\n  EntityIndex,\n  EntityRelationField,\n  EntityScalarField,\n  EntitySpec,\n} from './types';\n\n/**\n * Helper to define a database entity with full type safety.\n *\n * @example\n * ```typescript\n * const UserEntity = defineEntity({\n *   name: 'User',\n *   schema: 'lssm_sigil',\n *   description: 'A user of the platform.',\n *   fields: {\n *     id: field.id(),\n *     email: field.string({ isUnique: true, zod: z.string().email() }),\n *     name: field.string({ isOptional: true }),\n *     createdAt: field.createdAt(),\n *     updatedAt: field.updatedAt(),\n *     memberships: field.hasMany('Member'),\n *   },\n *   indexes: [{ fields: ['email'], unique: true }],\n * });\n * ```\n */\nexport function defineEntity<TFields extends Record<string, EntityField>>(\n  spec: EntitySpec<TFields>\n): EntitySpec<TFields> {\n  return spec;\n}\n\n/**\n * Helper to define an enum that can be shared across entities.\n */\nexport function defineEntityEnum(def: EntityEnumDef): EntityEnumDef {\n  return def;\n}\n\n/**\n * Field builder helpers for common field patterns.\n */\nexport const field = {\n  // ============ Scalar fields ============\n\n  /** String field */\n  string(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'String', ...opts };\n  },\n\n  /** Integer field */\n  int(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Int', ...opts };\n  },\n\n  /** Float field */\n  float(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Float', ...opts };\n  },\n\n  /** Boolean field */\n  boolean(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Boolean', ...opts };\n  },\n\n  /** DateTime field */\n  dateTime(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'DateTime', ...opts };\n  },\n\n  /** JSON field */\n  json(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Json', ...opts };\n  },\n\n  /** BigInt field */\n  bigInt(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'BigInt', ...opts };\n  },\n\n  /** Decimal field */\n  decimal(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Decimal', ...opts };\n  },\n\n  /** Bytes field */\n  bytes(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'Bytes', ...opts };\n  },\n\n  // ============ Common patterns ============\n\n  /** Primary key field with cuid() default */\n  id(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type' | 'isId'>>\n  ): EntityScalarField {\n    return {\n      kind: 'scalar',\n      type: 'String',\n      isId: true,\n      default: 'cuid()',\n      ...opts,\n    };\n  },\n\n  /** Primary key field with uuid() default */\n  uuid(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type' | 'isId'>>\n  ): EntityScalarField {\n    return {\n      kind: 'scalar',\n      type: 'String',\n      isId: true,\n      default: 'uuid()',\n      ...opts,\n    };\n  },\n\n  /** Auto-increment integer primary key */\n  autoIncrement(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type' | 'isId'>>\n  ): EntityScalarField {\n    return {\n      kind: 'scalar',\n      type: 'Int',\n      isId: true,\n      default: 'autoincrement()',\n      ...opts,\n    };\n  },\n\n  /** createdAt timestamp with now() default */\n  createdAt(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type' | 'default'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'DateTime', default: 'now()', ...opts };\n  },\n\n  /** updatedAt timestamp with @updatedAt */\n  updatedAt(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type' | 'updatedAt'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'DateTime', updatedAt: true, ...opts };\n  },\n\n  /** Email field with validation */\n  email(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return {\n      kind: 'scalar',\n      type: 'String',\n      zod: z.email(),\n      ...opts,\n    };\n  },\n\n  /** URL field with validation */\n  url(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return {\n      kind: 'scalar',\n      type: 'String',\n      zod: z.url(),\n      ...opts,\n    };\n  },\n\n  // ============ Enum fields ============\n\n  /** Enum field */\n  enum(\n    enumName: string,\n    opts?: Partial<Omit<EntityEnumField, 'kind' | 'enumName'>>\n  ): EntityEnumField {\n    return { kind: 'enum', enumName, ...opts };\n  },\n\n  /** Inline enum field with values */\n  inlineEnum(\n    enumName: string,\n    values: readonly string[],\n    opts?: Partial<Omit<EntityEnumField, 'kind' | 'enumName' | 'values'>>\n  ): EntityEnumField {\n    return { kind: 'enum', enumName, values, ...opts };\n  },\n\n  // ============ Relation fields ============\n\n  /** Has one relation (1:1 inverse side) */\n  hasOne(\n    target: string,\n    opts?: Partial<Omit<EntityRelationField, 'kind' | 'type' | 'target'>>\n  ): EntityRelationField {\n    return { kind: 'relation', type: 'hasOne', target, ...opts };\n  },\n\n  /** Has many relation (1:N inverse side) */\n  hasMany(\n    target: string,\n    opts?: Partial<Omit<EntityRelationField, 'kind' | 'type' | 'target'>>\n  ): EntityRelationField {\n    return { kind: 'relation', type: 'hasMany', target, ...opts };\n  },\n\n  /** Belongs to relation (N:1 owning side with foreign key) */\n  belongsTo(\n    target: string,\n    fields: string[],\n    references: string[],\n    opts?: Partial<\n      Omit<\n        EntityRelationField,\n        'kind' | 'type' | 'target' | 'fields' | 'references'\n      >\n    >\n  ): EntityRelationField {\n    return {\n      kind: 'relation',\n      type: 'belongsTo',\n      target,\n      fields,\n      references,\n      ...opts,\n    };\n  },\n\n  /** Foreign key field (string) - use with belongsTo */\n  foreignKey(\n    opts?: Partial<Omit<EntityScalarField, 'kind' | 'type'>>\n  ): EntityScalarField {\n    return { kind: 'scalar', type: 'String', ...opts };\n  },\n};\n\n/**\n * Index builder helpers.\n */\nexport const index = {\n  /** Create a regular index */\n  on(\n    fields: string[],\n    opts?: Partial<Omit<EntityIndex, 'fields'>>\n  ): EntityIndex {\n    return { fields, ...opts };\n  },\n\n  /** Create a unique constraint index */\n  unique(\n    fields: string[],\n    opts?: Partial<Omit<EntityIndex, 'fields' | 'unique'>>\n  ): EntityIndex {\n    return { fields, unique: true, ...opts };\n  },\n\n  /** Create a compound index with sort orders */\n  compound(\n    fields: string[],\n    sort: Record<string, 'Asc' | 'Desc'>,\n    opts?: Partial<Omit<EntityIndex, 'fields' | 'sort'>>\n  ): EntityIndex {\n    return { fields, sort, ...opts };\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,aACd,MACqB;AACrB,QAAO;;;;;AAMT,SAAgB,iBAAiB,KAAmC;AAClE,QAAO;;;;;AAMT,MAAa,QAAQ;CAInB,OACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAU,GAAG;GAAM;;CAIpD,IACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAO,GAAG;GAAM;;CAIjD,MACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAS,GAAG;GAAM;;CAInD,QACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAW,GAAG;GAAM;;CAIrD,SACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAY,GAAG;GAAM;;CAItD,KACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAQ,GAAG;GAAM;;CAIlD,OACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAU,GAAG;GAAM;;CAIpD,QACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAW,GAAG;GAAM;;CAIrD,MACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAS,GAAG;GAAM;;CAMnD,GACE,MACmB;AACnB,SAAO;GACL,MAAM;GACN,MAAM;GACN,MAAM;GACN,SAAS;GACT,GAAG;GACJ;;CAIH,KACE,MACmB;AACnB,SAAO;GACL,MAAM;GACN,MAAM;GACN,MAAM;GACN,SAAS;GACT,GAAG;GACJ;;CAIH,cACE,MACmB;AACnB,SAAO;GACL,MAAM;GACN,MAAM;GACN,MAAM;GACN,SAAS;GACT,GAAG;GACJ;;CAIH,UACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAY,SAAS;GAAS,GAAG;GAAM;;CAIxE,UACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAY,WAAW;GAAM,GAAG;GAAM;;CAIvE,MACE,MACmB;AACnB,SAAO;GACL,MAAM;GACN,MAAM;GACN,KAAKA,IAAE,OAAO;GACd,GAAG;GACJ;;CAIH,IACE,MACmB;AACnB,SAAO;GACL,MAAM;GACN,MAAM;GACN,KAAKA,IAAE,KAAK;GACZ,GAAG;GACJ;;CAMH,KACE,UACA,MACiB;AACjB,SAAO;GAAE,MAAM;GAAQ;GAAU,GAAG;GAAM;;CAI5C,WACE,UACA,QACA,MACiB;AACjB,SAAO;GAAE,MAAM;GAAQ;GAAU;GAAQ,GAAG;GAAM;;CAMpD,OACE,QACA,MACqB;AACrB,SAAO;GAAE,MAAM;GAAY,MAAM;GAAU;GAAQ,GAAG;GAAM;;CAI9D,QACE,QACA,MACqB;AACrB,SAAO;GAAE,MAAM;GAAY,MAAM;GAAW;GAAQ,GAAG;GAAM;;CAI/D,UACE,QACA,QACA,YACA,MAMqB;AACrB,SAAO;GACL,MAAM;GACN,MAAM;GACN;GACA;GACA;GACA,GAAG;GACJ;;CAIH,WACE,MACmB;AACnB,SAAO;GAAE,MAAM;GAAU,MAAM;GAAU,GAAG;GAAM;;CAErD;;;;AAKD,MAAa,QAAQ;CAEnB,GACE,QACA,MACa;AACb,SAAO;GAAE;GAAQ,GAAG;GAAM;;CAI5B,OACE,QACA,MACa;AACb,SAAO;GAAE;GAAQ,QAAQ;GAAM,GAAG;GAAM;;CAI1C,SACE,QACA,MACA,MACa;AACb,SAAO;GAAE;GAAQ;GAAM,GAAG;GAAM;;CAEnC"}