@contractspec/lib.schema 1.44.0

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.d.ts

@@ -0,0 +1,93 @@
+import { EntityEnumDef, EntityEnumField, EntityField, EntityIndex, EntityRelationField, EntityScalarField, EntitySpec } from "./types.js";
+
+//#region src/entity/defineEntity.d.ts
+
+/**
+ * Helper to define a database entity with full type safety.
+ *
+ * @example
+ * ```typescript
+ * const UserEntity = defineEntity({
+ *   name: 'User',
+ *   schema: 'lssm_sigil',
+ *   description: 'A user of the platform.',
+ *   fields: {
+ *     id: field.id(),
+ *     email: field.string({ isUnique: true, zod: z.string().email() }),
+ *     name: field.string({ isOptional: true }),
+ *     createdAt: field.createdAt(),
+ *     updatedAt: field.updatedAt(),
+ *     memberships: field.hasMany('Member'),
+ *   },
+ *   indexes: [{ fields: ['email'], unique: true }],
+ * });
+ * ```
+ */
+declare function defineEntity<TFields extends Record<string, EntityField>>(spec: EntitySpec<TFields>): EntitySpec<TFields>;
+/**
+ * Helper to define an enum that can be shared across entities.
+ */
+declare function defineEntityEnum(def: EntityEnumDef): EntityEnumDef;
+/**
+ * Field builder helpers for common field patterns.
+ */
+declare const field: {
+  /** String field */
+  string(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** Integer field */
+  int(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** Float field */
+  float(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** Boolean field */
+  boolean(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** DateTime field */
+  dateTime(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** JSON field */
+  json(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** BigInt field */
+  bigInt(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** Decimal field */
+  decimal(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** Bytes field */
+  bytes(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** Primary key field with cuid() default */
+  id(opts?: Partial<Omit<EntityScalarField, "kind" | "type" | "isId">>): EntityScalarField;
+  /** Primary key field with uuid() default */
+  uuid(opts?: Partial<Omit<EntityScalarField, "kind" | "type" | "isId">>): EntityScalarField;
+  /** Auto-increment integer primary key */
+  autoIncrement(opts?: Partial<Omit<EntityScalarField, "kind" | "type" | "isId">>): EntityScalarField;
+  /** createdAt timestamp with now() default */
+  createdAt(opts?: Partial<Omit<EntityScalarField, "kind" | "type" | "default">>): EntityScalarField;
+  /** updatedAt timestamp with @updatedAt */
+  updatedAt(opts?: Partial<Omit<EntityScalarField, "kind" | "type" | "updatedAt">>): EntityScalarField;
+  /** Email field with validation */
+  email(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** URL field with validation */
+  url(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+  /** Enum field */
+  enum(enumName: string, opts?: Partial<Omit<EntityEnumField, "kind" | "enumName">>): EntityEnumField;
+  /** Inline enum field with values */
+  inlineEnum(enumName: string, values: readonly string[], opts?: Partial<Omit<EntityEnumField, "kind" | "enumName" | "values">>): EntityEnumField;
+  /** Has one relation (1:1 inverse side) */
+  hasOne(target: string, opts?: Partial<Omit<EntityRelationField, "kind" | "type" | "target">>): EntityRelationField;
+  /** Has many relation (1:N inverse side) */
+  hasMany(target: string, opts?: Partial<Omit<EntityRelationField, "kind" | "type" | "target">>): EntityRelationField;
+  /** Belongs to relation (N:1 owning side with foreign key) */
+  belongsTo(target: string, fields: string[], references: string[], opts?: Partial<Omit<EntityRelationField, "kind" | "type" | "target" | "fields" | "references">>): EntityRelationField;
+  /** Foreign key field (string) - use with belongsTo */
+  foreignKey(opts?: Partial<Omit<EntityScalarField, "kind" | "type">>): EntityScalarField;
+};
+/**
+ * Index builder helpers.
+ */
+declare const index: {
+  /** Create a regular index */
+  on(fields: string[], opts?: Partial<Omit<EntityIndex, "fields">>): EntityIndex;
+  /** Create a unique constraint index */
+  unique(fields: string[], opts?: Partial<Omit<EntityIndex, "fields" | "unique">>): EntityIndex;
+  /** Create a compound index with sort orders */
+  compound(fields: string[], sort: Record<string, "Asc" | "Desc">, opts?: Partial<Omit<EntityIndex, "fields" | "sort">>): EntityIndex;
+};
+//#endregion
+export { defineEntity, defineEntityEnum, field, index };
+//# sourceMappingURL=defineEntity.d.ts.map

package/dist/entity/defineEntity.d.ts.map

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

package/dist/entity/defineEntity.js

@@ -0,0 +1,237 @@
+import * as z$1 from "zod";
+
+//#region src/entity/defineEntity.ts
+/**
+* Helper to define a database entity with full type safety.
+*
+* @example
+* ```typescript
+* const UserEntity = defineEntity({
+*   name: 'User',
+*   schema: 'lssm_sigil',
+*   description: 'A user of the platform.',
+*   fields: {
+*     id: field.id(),
+*     email: field.string({ isUnique: true, zod: z.string().email() }),
+*     name: field.string({ isOptional: true }),
+*     createdAt: field.createdAt(),
+*     updatedAt: field.updatedAt(),
+*     memberships: field.hasMany('Member'),
+*   },
+*   indexes: [{ fields: ['email'], unique: true }],
+* });
+* ```
+*/
+function defineEntity(spec) {
+	return spec;
+}
+/**
+* Helper to define an enum that can be shared across entities.
+*/
+function defineEntityEnum(def) {
+	return def;
+}
+/**
+* Field builder helpers for common field patterns.
+*/
+const field = {
+	string(opts) {
+		return {
+			kind: "scalar",
+			type: "String",
+			...opts
+		};
+	},
+	int(opts) {
+		return {
+			kind: "scalar",
+			type: "Int",
+			...opts
+		};
+	},
+	float(opts) {
+		return {
+			kind: "scalar",
+			type: "Float",
+			...opts
+		};
+	},
+	boolean(opts) {
+		return {
+			kind: "scalar",
+			type: "Boolean",
+			...opts
+		};
+	},
+	dateTime(opts) {
+		return {
+			kind: "scalar",
+			type: "DateTime",
+			...opts
+		};
+	},
+	json(opts) {
+		return {
+			kind: "scalar",
+			type: "Json",
+			...opts
+		};
+	},
+	bigInt(opts) {
+		return {
+			kind: "scalar",
+			type: "BigInt",
+			...opts
+		};
+	},
+	decimal(opts) {
+		return {
+			kind: "scalar",
+			type: "Decimal",
+			...opts
+		};
+	},
+	bytes(opts) {
+		return {
+			kind: "scalar",
+			type: "Bytes",
+			...opts
+		};
+	},
+	id(opts) {
+		return {
+			kind: "scalar",
+			type: "String",
+			isId: true,
+			default: "cuid()",
+			...opts
+		};
+	},
+	uuid(opts) {
+		return {
+			kind: "scalar",
+			type: "String",
+			isId: true,
+			default: "uuid()",
+			...opts
+		};
+	},
+	autoIncrement(opts) {
+		return {
+			kind: "scalar",
+			type: "Int",
+			isId: true,
+			default: "autoincrement()",
+			...opts
+		};
+	},
+	createdAt(opts) {
+		return {
+			kind: "scalar",
+			type: "DateTime",
+			default: "now()",
+			...opts
+		};
+	},
+	updatedAt(opts) {
+		return {
+			kind: "scalar",
+			type: "DateTime",
+			updatedAt: true,
+			...opts
+		};
+	},
+	email(opts) {
+		return {
+			kind: "scalar",
+			type: "String",
+			zod: z$1.email(),
+			...opts
+		};
+	},
+	url(opts) {
+		return {
+			kind: "scalar",
+			type: "String",
+			zod: z$1.url(),
+			...opts
+		};
+	},
+	enum(enumName, opts) {
+		return {
+			kind: "enum",
+			enumName,
+			...opts
+		};
+	},
+	inlineEnum(enumName, values, opts) {
+		return {
+			kind: "enum",
+			enumName,
+			values,
+			...opts
+		};
+	},
+	hasOne(target, opts) {
+		return {
+			kind: "relation",
+			type: "hasOne",
+			target,
+			...opts
+		};
+	},
+	hasMany(target, opts) {
+		return {
+			kind: "relation",
+			type: "hasMany",
+			target,
+			...opts
+		};
+	},
+	belongsTo(target, fields, references, opts) {
+		return {
+			kind: "relation",
+			type: "belongsTo",
+			target,
+			fields,
+			references,
+			...opts
+		};
+	},
+	foreignKey(opts) {
+		return {
+			kind: "scalar",
+			type: "String",
+			...opts
+		};
+	}
+};
+/**
+* Index builder helpers.
+*/
+const index = {
+	on(fields, opts) {
+		return {
+			fields,
+			...opts
+		};
+	},
+	unique(fields, opts) {
+		return {
+			fields,
+			unique: true,
+			...opts
+		};
+	},
+	compound(fields, sort, opts) {
+		return {
+			fields,
+			sort,
+			...opts
+		};
+	}
+};
+
+//#endregion
+export { defineEntity, defineEntityEnum, field, index };
+//# sourceMappingURL=defineEntity.js.map

package/dist/entity/defineEntity.js.map

@@ -0,0 +1 @@
+{"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"}

package/dist/entity/generator.d.ts

@@ -0,0 +1,38 @@
+import { EntityEnumDef, EntitySpec, ModuleSchemaContribution } from "./types.js";
+
+//#region src/entity/generator.d.ts
+
+/**
+ * Options for Prisma schema generation.
+ */
+interface PrismaGeneratorOptions {
+  /** Output file path for the generated schema */
+  outputPath?: string;
+  /** Prisma datasource provider (default: 'postgresql') */
+  provider?: 'postgresql' | 'mysql' | 'sqlite' | 'mongodb' | 'sqlserver';
+  /** Prisma generator output path */
+  clientOutput?: string;
+  /** Include Pothos generator */
+  includePothos?: boolean;
+  /** Pothos output path */
+  pothosOutput?: string;
+}
+/**
+ * Generate Prisma schema content from entity specifications.
+ */
+declare function generatePrismaSchema(entities: EntitySpec[], options?: PrismaGeneratorOptions): string;
+/**
+ * Compose multiple module schema contributions into a single schema.
+ */
+declare function composeModuleSchemas(contributions: ModuleSchemaContribution[], options?: PrismaGeneratorOptions): string;
+/**
+ * Generate a single entity's Prisma schema fragment (for modular output).
+ */
+declare function generateEntityFragment(entity: EntitySpec): string;
+/**
+ * Generate a single enum's Prisma schema fragment (for modular output).
+ */
+declare function generateEnumFragment(enumDef: EntityEnumDef): string;
+//#endregion
+export { PrismaGeneratorOptions, composeModuleSchemas, generateEntityFragment, generateEnumFragment, generatePrismaSchema };
+//# sourceMappingURL=generator.d.ts.map

package/dist/entity/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","names":[],"sources":["../../src/entity/generator.ts"],"sourcesContent":[],"mappings":";;;;;;AAcA;AAgBgB,UAhBC,sBAAA,CAiBL;EA2WI;EAuCA,UAAA,CAAA,EAAA,MAAA;EAOA;;;;;;;;;;;;iBA1ZA,oBAAA,WACJ,wBACD;;;;iBA0WK,oBAAA,gBACC,sCACN;;;;iBAqCK,sBAAA,SAA+B;;;;iBAO/B,oBAAA,UAA8B"}