@masaori/zod-to-entity-definitions 1.1.7

package/README.md

@@ -0,0 +1,413 @@
+# zod-to-entity-definitions
+
+A TypeScript library that allows you to define data models using Zod with extended metadata (Primary Key, Foreign Key, Unique) and convert them into framework-agnostic Entity Definitions (ER models).
+
+## Features
+
+- 🔧 **Zod Extensions**: Add `.pk()`, `.unique()`, and `.ref()` methods to Zod schemas
+- 🏗️ **Entity & Struct Factories**: Define entities and reusable struct types
+- 🔄 **Automatic Generation**: Convert Zod schemas to entity definitions and relations
+- 🔒 **Type-Safe**: Full TypeScript support with strict typing
+- 📦 **Framework Agnostic**: Generate generic entity definitions usable by any framework
+- ✅ **Validation**: Built-in validation for entity nesting and reference integrity
+
+## Installation
+
+### Installation
+
+Install the package from npm:
+
+```bash
+npm install @masaori/zod-to-entity-definitions zod
+```
+
+## Quick Start
+
+```typescript
+import { z } from 'zod';
+import {
+  entity,
+  struct,
+  generateEntities,
+  generateRelations,
+} from '@masaori/zod-to-entity-definitions';
+
+// 1. Define a Struct (reusable component)
+const Address = struct({
+  name: 'AddressStruct',
+  description: 'Common address',
+  columns: {
+    city: z.string(),
+    street: z.string(),
+  },
+});
+
+// 2. Define Entities
+const Company = entity({
+  name: 'Company',
+  columns: {
+    id: z.string().pk(),
+    name: z.string(),
+    address: Address, // Using struct is OK
+  },
+});
+
+const User = entity({
+  name: 'User',
+  columns: {
+    id: z.string().pk(),
+    email: z.string().email().unique(),
+    companyId: z.string().ref(Company), // Reference to Company entity
+  },
+});
+
+// 3. Generate Entity Definitions
+const definitions = generateEntities([Company, User]);
+
+// 4. Generate Relations
+const relations = generateRelations(definitions);
+
+console.log(JSON.stringify(definitions, null, 2));
+console.log(JSON.stringify(relations, null, 2));
+```
+
+> 📝 **See the [examples](./examples) directory for complete working examples with generated JSON output.**
+
+## API Reference
+
+### Zod Extensions
+
+The library extends Zod schemas with the following methods:
+
+#### `.pk()`
+
+Marks a field as the Primary Key.
+
+```typescript
+id: z.string().pk();
+```
+
+#### `.unique()`
+
+Marks a field as Unique.
+
+```typescript
+email: z.string().email().unique();
+```
+
+#### `.ref(targetEntity, targetColumn?)`
+
+Marks a field as a Foreign Key reference to another entity.
+
+- `targetEntity`: Must be a schema created with `entity()`
+- `targetColumn`: Optional, defaults to "id"
+
+```typescript
+companyId: z.string().ref(Company);
+managerId: z.string().ref(User, 'userId');
+```
+
+### Factory Functions
+
+#### `entity(config)`
+
+Creates an entity schema with metadata.
+
+```typescript
+type EntityConfig<T extends z.ZodRawShape> = {
+  name: string;
+  description?: string;
+  columns: T;
+};
+```
+
+#### `struct(config)`
+
+Creates a struct schema for reusable components.
+
+```typescript
+type StructConfig<T extends z.ZodRawShape> = {
+  name: string;
+  description?: string;
+  columns: T;
+};
+```
+
+### Generator Functions
+
+#### `generateEntities(schemas)`
+
+Parses Zod schemas and returns an array of `EntityDefinition`.
+
+**Validation Rules:**
+
+1. Entities cannot directly embed other entities (must use `.ref()`)
+2. `.ref()` must point to valid entity schemas
+
+```typescript
+const definitions = generateEntities([Company, User]);
+```
+
+#### `generateRelations(definitions)`
+
+Analyzes entity definitions to construct relation maps.
+
+```typescript
+const relations = generateRelations(definitions);
+```
+
+## Type Definitions
+
+### EntityDefinition
+
+```typescript
+type EntityDefinition = {
+  name: string;
+  description?: string;
+  properties: EntityPropertyDefinition[];
+};
+```
+
+### EntityPropertyDefinition
+
+Union type representing different property types:
+
+- `EntityPropertyDefinitionPrimaryKey`: Primary key field
+- `EntityPropertyDefinitionPrimitive`: boolean, number, string, Date
+- `EntityPropertyDefinitionTypedStruct`: Reference to a struct type
+- `EntityPropertyDefinitionReferencedObject`: Foreign key reference
+
+### EntityRelation
+
+```typescript
+type EntityRelation = {
+  entityName: string;
+  referTos: EntityRelationReferTo[];
+  referredBys: EntityRelationReferredBy[];
+};
+```
+
+## Advanced Usage
+
+### Nullable and Optional Fields
+
+```typescript
+const User = entity({
+  name: 'User',
+  columns: {
+    id: z.string().pk(),
+    nickname: z.string().optional(), // Optional field
+    bio: z.string().nullable(), // Nullable field
+  },
+});
+```
+
+### Array Fields
+
+```typescript
+const User = entity({
+  name: 'User',
+  columns: {
+    id: z.string().pk(),
+    tags: z.array(z.string()),
+    scores: z.array(z.number()).optional(),
+  },
+});
+```
+
+### Enum Fields
+
+```typescript
+const User = entity({
+  name: 'User',
+  columns: {
+    id: z.string().pk(),
+    role: z.enum(['admin', 'user', 'guest']),
+  },
+});
+```
+
+### Complex Relations
+
+```typescript
+const Department = entity({
+  name: 'Department',
+  columns: {
+    id: z.string().pk(),
+    name: z.string(),
+  },
+});
+
+const Employee = entity({
+  name: 'Employee',
+  columns: {
+    id: z.string().pk(),
+    name: z.string(),
+    departmentId: z.string().ref(Department),
+  },
+});
+
+const Project = entity({
+  name: 'Project',
+  columns: {
+    id: z.string().pk(),
+    name: z.string(),
+    leadId: z.string().ref(Employee),
+    departmentId: z.string().ref(Department),
+  },
+});
+```
+
+## Validation Rules
+
+### ❌ Entity Nesting (Not Allowed)
+
+```typescript
+const User = entity({
+  name: 'User',
+  columns: {
+    id: z.string().pk(),
+    company: Company, // ❌ Error: Direct entity embedding not allowed
+  },
+});
+```
+
+### ✅ Use References Instead
+
+```typescript
+const User = entity({
+  name: 'User',
+  columns: {
+    id: z.string().pk(),
+    companyId: z.string().ref(Company), // ✅ Correct: Use .ref()
+  },
+});
+```
+
+### ❌ Invalid References
+
+```typescript
+const Address = struct({
+  name: 'Address',
+  columns: { city: z.string() },
+});
+
+const User = entity({
+  name: 'User',
+  columns: {
+    id: z.string().pk(),
+    addressId: z.string().ref(Address), // ❌ Error: Can't reference struct
+  },
+});
+```
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Run tests
+pnpm test
+
+# Run tests in watch mode
+pnpm test:watch
+
+# Type checking
+pnpm check-types
+
+# Linting
+pnpm lint
+
+# Auto-fix lint issues
+pnpm lint:fix
+
+# Format code
+pnpm format
+
+# Build
+pnpm build
+```
+
+## CI/CD
+
+This project uses GitHub Actions for continuous integration and deployment.
+
+### Workflows
+
+1. **Commit Message Validation** (`.github/workflows/commit-check.yml`)
+   - Runs on all PRs
+   - Validates commit messages using [Conventional Commits](https://www.conventionalcommits.org/)
+   - Ensures all commits are linear (no merge commits)
+
+2. **Lint and Test** (`.github/workflows/lint-test.yml`)
+   - Runs on all PRs and pushes to main
+   - Executes linting, type checking, and tests
+   - Must pass before merging
+
+3. **Publish to GitHub Packages** (`.github/workflows/publish.yml`)
+   - Manual workflow trigger only (workflow_dispatch)
+   - Automatically determines version bump using semantic versioning
+   - Publishes to GitHub Packages with automatic changelog generation
+   - Version bumps follow Conventional Commits:
+     - `feat:` → minor version bump
+     - `fix:`, `docs:`, `style:`, `refactor:`, `test:`, `build:`, `ci:`, `chore:` → patch version bump
+     - `BREAKING CHANGE:` → major version bump
+
+### Publishing to GitHub Packages
+
+Publishing is automated via GitHub Actions. To publish a new version:
+
+1. **Required tokens**: No additional tokens needed!
+   - The workflow uses the built-in `GITHUB_TOKEN` which is automatically provided by GitHub Actions
+   - The `GITHUB_TOKEN` has the necessary permissions to:
+     - Write to the repository (create tags, update files)
+     - Publish to GitHub Packages
+     - Create GitHub releases
+   - **No manual token configuration required** - it works out of the box
+
+2. **Trigger the publish workflow**:
+   - Go to the Actions tab in GitHub
+   - Select "Publish to GitHub Packages" workflow
+   - Click "Run workflow" on the main branch
+
+3. **Automated process**:
+   - The workflow will analyze commit messages since the last release
+   - Automatically determine the version bump (major/minor/patch)
+   - Update `package.json` and `CHANGELOG.md`
+   - Create a git tag and GitHub release
+   - Publish to GitHub Packages
+
+### Commit Message Format
+
+All commits must follow the [Conventional Commits](https://www.conventionalcommits.org/) specification:
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+Examples:
+
+- `feat: add new entity validation`
+- `fix: correct reference resolution`
+- `docs: update README with examples`
+- `feat!: remove deprecated API` (breaking change)
+
+### Pre-publish Checklist
+
+The package includes a `prepublishOnly` script that automatically runs before publishing:
+
+- Type checking (`pnpm check-types`)
+- Linting (`pnpm lint`)
+- Tests (`pnpm test`)
+- Build (`pnpm build`)
+
+All these checks must pass before the package can be published.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+
+declare const PK_SYMBOL: unique symbol;
+declare const UNIQUE_SYMBOL: unique symbol;
+declare const REF_SYMBOL: unique symbol;
+type RefMetadata = {
+    targetEntity: z.ZodTypeAny;
+    targetColumn: string;
+};
+declare module 'zod' {
+    interface ZodType {
+        [PK_SYMBOL]?: boolean;
+        [UNIQUE_SYMBOL]?: boolean;
+        [REF_SYMBOL]?: RefMetadata;
+        pk(): this;
+        unique(): this;
+        ref(targetEntity: z.ZodTypeAny, targetColumn?: string): this;
+    }
+}
+
+type EntityConfig<T extends z.ZodRawShape> = {
+    name: string;
+    description?: string;
+    columns: T;
+};
+type StructConfig<T extends z.ZodRawShape> = {
+    name: string;
+    description?: string;
+    columns: T;
+};
+declare const ENTITY_NAME_BRAND: unique symbol;
+type EntitySchema<TName extends string, TShape extends z.ZodRawShape> = z.ZodObject<TShape> & {
+    readonly [ENTITY_NAME_BRAND]: TName;
+};
+declare function entity<const TConfig extends EntityConfig<z.ZodRawShape>>(config: TConfig): EntitySchema<TConfig['name'], TConfig['columns']>;
+declare function struct<T extends z.ZodRawShape>(config: StructConfig<T>): z.ZodObject<T>;
+
+type EntityDefinition<TEntityNames = string> = {
+    name: TEntityNames;
+    description?: string;
+    properties: EntityPropertyDefinition[];
+};
+type EntityPropertyDefinition = EntityPropertyDefinitionPrimaryKey | EntityPropertyDefinitionPrimitive | EntityPropertyDefinitionTypedStruct | EntityPropertyDefinitionReferencedObject;
+type EntityPropertyDefinitionPrimaryKey = {
+    isReference: false;
+    propertyType: 'PrimaryKey';
+    name: string;
+    description?: string;
+};
+type EntityPropertyDefinitionPrimitive = {
+    isReference: false;
+    propertyType: 'boolean' | 'number' | 'string' | 'Date' | 'struct';
+    name: string;
+    isUnique: boolean;
+    isNullable: boolean;
+    isArray: boolean;
+    acceptableValues: string[] | null;
+    description?: string;
+};
+type EntityPropertyDefinitionTypedStruct = {
+    isReference: false;
+    propertyType: 'typedStruct';
+    name: string;
+    structTypeName: string;
+    isUnique: boolean;
+    isNullable: boolean;
+    isArray: boolean;
+    description?: string;
+};
+type EntityPropertyDefinitionReferencedObject = {
+    isReference: true;
+    name: string;
+    targetEntityDefinitionName: string;
+    isUnique: boolean;
+    isNullable: boolean;
+    description?: string;
+};
+type EntityRelationReferTo<T = string> = {
+    entityName: T;
+    propertyName: string;
+    isUnique: boolean;
+};
+type EntityRelationReferredBy<T = string> = {
+    entityName: T;
+    propertyName: string;
+    isUnique: boolean;
+};
+type EntityRelation<T = string> = {
+    entityName: T;
+    referTos: EntityRelationReferTo<T>[];
+    referredBys: EntityRelationReferredBy<T>[];
+};
+
+type ExtractEntityName<T> = T extends EntitySchema<infer TName, z.ZodRawShape> ? TName : never;
+type ExtractEntityNames<T extends readonly z.ZodTypeAny[]> = {
+    [K in keyof T]: ExtractEntityName<T[K]>;
+}[number];
+declare function generateEntities<const T extends readonly z.ZodTypeAny[]>(schemas: T): EntityDefinition<ExtractEntityNames<T>>[];
+declare function generateRelations(definitions: EntityDefinition[]): EntityRelation[];
+
+export { type EntityConfig, type EntityDefinition, type EntityPropertyDefinition, type EntityPropertyDefinitionPrimaryKey, type EntityPropertyDefinitionPrimitive, type EntityPropertyDefinitionReferencedObject, type EntityPropertyDefinitionTypedStruct, type EntityRelation, type EntityRelationReferTo, type EntityRelationReferredBy, type EntitySchema, type StructConfig, entity, generateEntities, generateRelations, struct };

package/dist/index.d.ts

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+
+declare const PK_SYMBOL: unique symbol;
+declare const UNIQUE_SYMBOL: unique symbol;
+declare const REF_SYMBOL: unique symbol;
+type RefMetadata = {
+    targetEntity: z.ZodTypeAny;
+    targetColumn: string;
+};
+declare module 'zod' {
+    interface ZodType {
+        [PK_SYMBOL]?: boolean;
+        [UNIQUE_SYMBOL]?: boolean;
+        [REF_SYMBOL]?: RefMetadata;
+        pk(): this;
+        unique(): this;
+        ref(targetEntity: z.ZodTypeAny, targetColumn?: string): this;
+    }
+}
+
+type EntityConfig<T extends z.ZodRawShape> = {
+    name: string;
+    description?: string;
+    columns: T;
+};
+type StructConfig<T extends z.ZodRawShape> = {
+    name: string;
+    description?: string;
+    columns: T;
+};
+declare const ENTITY_NAME_BRAND: unique symbol;
+type EntitySchema<TName extends string, TShape extends z.ZodRawShape> = z.ZodObject<TShape> & {
+    readonly [ENTITY_NAME_BRAND]: TName;
+};
+declare function entity<const TConfig extends EntityConfig<z.ZodRawShape>>(config: TConfig): EntitySchema<TConfig['name'], TConfig['columns']>;
+declare function struct<T extends z.ZodRawShape>(config: StructConfig<T>): z.ZodObject<T>;
+
+type EntityDefinition<TEntityNames = string> = {
+    name: TEntityNames;
+    description?: string;
+    properties: EntityPropertyDefinition[];
+};
+type EntityPropertyDefinition = EntityPropertyDefinitionPrimaryKey | EntityPropertyDefinitionPrimitive | EntityPropertyDefinitionTypedStruct | EntityPropertyDefinitionReferencedObject;
+type EntityPropertyDefinitionPrimaryKey = {
+    isReference: false;
+    propertyType: 'PrimaryKey';
+    name: string;
+    description?: string;
+};
+type EntityPropertyDefinitionPrimitive = {
+    isReference: false;
+    propertyType: 'boolean' | 'number' | 'string' | 'Date' | 'struct';
+    name: string;
+    isUnique: boolean;
+    isNullable: boolean;
+    isArray: boolean;
+    acceptableValues: string[] | null;
+    description?: string;
+};
+type EntityPropertyDefinitionTypedStruct = {
+    isReference: false;
+    propertyType: 'typedStruct';
+    name: string;
+    structTypeName: string;
+    isUnique: boolean;
+    isNullable: boolean;
+    isArray: boolean;
+    description?: string;
+};
+type EntityPropertyDefinitionReferencedObject = {
+    isReference: true;
+    name: string;
+    targetEntityDefinitionName: string;
+    isUnique: boolean;
+    isNullable: boolean;
+    description?: string;
+};
+type EntityRelationReferTo<T = string> = {
+    entityName: T;
+    propertyName: string;
+    isUnique: boolean;
+};
+type EntityRelationReferredBy<T = string> = {
+    entityName: T;
+    propertyName: string;
+    isUnique: boolean;
+};
+type EntityRelation<T = string> = {
+    entityName: T;
+    referTos: EntityRelationReferTo<T>[];
+    referredBys: EntityRelationReferredBy<T>[];
+};
+
+type ExtractEntityName<T> = T extends EntitySchema<infer TName, z.ZodRawShape> ? TName : never;
+type ExtractEntityNames<T extends readonly z.ZodTypeAny[]> = {
+    [K in keyof T]: ExtractEntityName<T[K]>;
+}[number];
+declare function generateEntities<const T extends readonly z.ZodTypeAny[]>(schemas: T): EntityDefinition<ExtractEntityNames<T>>[];
+declare function generateRelations(definitions: EntityDefinition[]): EntityRelation[];
+
+export { type EntityConfig, type EntityDefinition, type EntityPropertyDefinition, type EntityPropertyDefinitionPrimaryKey, type EntityPropertyDefinitionPrimitive, type EntityPropertyDefinitionReferencedObject, type EntityPropertyDefinitionTypedStruct, type EntityRelation, type EntityRelationReferTo, type EntityRelationReferredBy, type EntitySchema, type StructConfig, entity, generateEntities, generateRelations, struct };

package/dist/index.js

@@ -0,0 +1,267 @@
+'use strict';
+
+var zod = require('zod');
+
+// src/setupZod.ts
+var PK_SYMBOL = Symbol("zod-entity-pk");
+var UNIQUE_SYMBOL = Symbol("zod-entity-unique");
+var REF_SYMBOL = Symbol("zod-entity-ref");
+zod.z.ZodType.prototype.pk = function() {
+  this[PK_SYMBOL] = true;
+  return this;
+};
+zod.z.ZodType.prototype.unique = function() {
+  this[UNIQUE_SYMBOL] = true;
+  return this;
+};
+zod.z.ZodType.prototype.ref = function(targetEntity, targetColumn = "id") {
+  this[REF_SYMBOL] = { targetEntity, targetColumn };
+  return this;
+};
+function isPrimaryKey(schema) {
+  return schema[PK_SYMBOL] === true;
+}
+function isUnique(schema) {
+  return schema[UNIQUE_SYMBOL] === true;
+}
+function getRefMetadata(schema) {
+  return schema[REF_SYMBOL];
+}
+var SCHEMA_TYPE_SYMBOL = Symbol("zod-schema-type");
+var SCHEMA_NAME_SYMBOL = Symbol("zod-schema-name");
+var SCHEMA_DESCRIPTION_SYMBOL = Symbol("zod-schema-description");
+function entity(config) {
+  const schema = zod.z.object(config.columns);
+  schema[SCHEMA_TYPE_SYMBOL] = "entity";
+  schema[SCHEMA_NAME_SYMBOL] = config.name;
+  if (config.description !== void 0) {
+    schema[SCHEMA_DESCRIPTION_SYMBOL] = config.description;
+  }
+  return schema;
+}
+function struct(config) {
+  const schema = zod.z.object(config.columns);
+  schema[SCHEMA_TYPE_SYMBOL] = "struct";
+  schema[SCHEMA_NAME_SYMBOL] = config.name;
+  if (config.description !== void 0) {
+    schema[SCHEMA_DESCRIPTION_SYMBOL] = config.description;
+  }
+  return schema;
+}
+function getSchemaType(schema) {
+  if (schema instanceof zod.z.ZodObject) {
+    return schema[SCHEMA_TYPE_SYMBOL];
+  }
+  return void 0;
+}
+function getSchemaName(schema) {
+  if (schema instanceof zod.z.ZodObject) {
+    return schema[SCHEMA_NAME_SYMBOL];
+  }
+  return void 0;
+}
+function getSchemaDescription(schema) {
+  if (schema instanceof zod.z.ZodObject) {
+    return schema[SCHEMA_DESCRIPTION_SYMBOL];
+  }
+  return void 0;
+}
+function unwrapSchema(schema) {
+  let current = schema;
+  let isNullable = false;
+  let isArray = false;
+  while (true) {
+    if (current instanceof zod.z.ZodOptional) {
+      isNullable = true;
+      current = current.unwrap();
+    } else if (current instanceof zod.z.ZodNullable) {
+      isNullable = true;
+      current = current.unwrap();
+    } else if (current instanceof zod.z.ZodArray) {
+      isArray = true;
+      current = current.element;
+    } else {
+      break;
+    }
+  }
+  return { innerSchema: current, isNullable, isArray };
+}
+function generateEntities(schemas) {
+  const definitions = [];
+  for (const schema of schemas) {
+    const schemaType = getSchemaType(schema);
+    if (schemaType !== "entity") {
+      continue;
+    }
+    const name = getSchemaName(schema);
+    if (name === void 0) {
+      throw new Error("Entity schema must have a name");
+    }
+    const description = getSchemaDescription(schema);
+    if (!(schema instanceof zod.z.ZodObject)) {
+      throw new Error(`Entity "${name}" must be a ZodObject`);
+    }
+    const properties = [];
+    const shape = schema.shape;
+    for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+      if (!(fieldSchema instanceof zod.z.ZodType)) {
+        continue;
+      }
+      const property = parseProperty(fieldName, fieldSchema);
+      properties.push(property);
+    }
+    const entityDefinition = {
+      name,
+      properties
+    };
+    if (description !== void 0) {
+      entityDefinition.description = description;
+    }
+    definitions.push(entityDefinition);
+  }
+  return definitions;
+}
+function parseProperty(fieldName, fieldSchema) {
+  const isPk = isPrimaryKey(fieldSchema);
+  const isUniqueField = isUnique(fieldSchema);
+  const refMetadata = getRefMetadata(fieldSchema);
+  if (isPk) {
+    const property = {
+      isReference: false,
+      propertyType: "PrimaryKey",
+      name: fieldName
+    };
+    return property;
+  }
+  if (refMetadata !== void 0) {
+    const { targetEntity } = refMetadata;
+    const targetSchemaType = getSchemaType(targetEntity);
+    if (targetSchemaType !== "entity") {
+      throw new Error(
+        `Field "${fieldName}" has .ref() pointing to a non-entity schema. Only entity schemas created with entity() can be referenced.`
+      );
+    }
+    const targetEntityName = getSchemaName(targetEntity);
+    if (targetEntityName === void 0) {
+      throw new Error(`Referenced entity for field "${fieldName}" must have a name`);
+    }
+    const { isNullable: isNullable2 } = unwrapSchema(fieldSchema);
+    const property = {
+      isReference: true,
+      name: fieldName,
+      targetEntityDefinitionName: targetEntityName,
+      isUnique: isUniqueField,
+      isNullable: isNullable2
+    };
+    return property;
+  }
+  const { innerSchema, isNullable, isArray } = unwrapSchema(fieldSchema);
+  const innerSchemaType = getSchemaType(innerSchema);
+  if (innerSchemaType === "entity") {
+    throw new Error(
+      `Field "${fieldName}" contains a direct entity embedding. Entities cannot be directly nested. Use .ref() instead.`
+    );
+  }
+  if (innerSchemaType === "struct") {
+    const structName = getSchemaName(innerSchema);
+    if (structName === void 0) {
+      throw new Error(`Struct schema for field "${fieldName}" must have a name`);
+    }
+    const property = {
+      isReference: false,
+      propertyType: "typedStruct",
+      name: fieldName,
+      structTypeName: structName,
+      isUnique: isUniqueField,
+      isNullable,
+      isArray
+    };
+    return property;
+  }
+  const primitiveType = getPrimitiveType(innerSchema);
+  if (primitiveType !== null) {
+    const acceptableValues = getAcceptableValues(innerSchema);
+    const property = {
+      isReference: false,
+      propertyType: primitiveType,
+      name: fieldName,
+      isUnique: isUniqueField,
+      isNullable,
+      isArray,
+      acceptableValues
+    };
+    return property;
+  }
+  throw new Error(`Unsupported schema type for field "${fieldName}"`);
+}
+function getPrimitiveType(schema) {
+  if (schema instanceof zod.z.ZodString) {
+    return "string";
+  }
+  if (schema instanceof zod.z.ZodNumber) {
+    return "number";
+  }
+  if (schema instanceof zod.z.ZodBoolean) {
+    return "boolean";
+  }
+  if (schema instanceof zod.z.ZodDate) {
+    return "Date";
+  }
+  if (schema instanceof zod.z.ZodEnum) {
+    return "string";
+  }
+  return null;
+}
+function getAcceptableValues(schema) {
+  if (schema instanceof zod.z.ZodEnum) {
+    return [...schema.options];
+  }
+  return null;
+}
+function generateRelations(definitions) {
+  const relations = [];
+  const entityMap = /* @__PURE__ */ new Map();
+  for (const def of definitions) {
+    entityMap.set(def.name, def);
+  }
+  for (const def of definitions) {
+    const referTos = [];
+    const referredBys = [];
+    for (const prop of def.properties) {
+      if (prop.isReference) {
+        referTos.push({
+          entityName: prop.targetEntityDefinitionName,
+          propertyName: prop.name,
+          isUnique: prop.isUnique
+        });
+      }
+    }
+    for (const otherDef of definitions) {
+      if (otherDef.name === def.name) {
+        continue;
+      }
+      for (const prop of otherDef.properties) {
+        if (prop.isReference && prop.targetEntityDefinitionName === def.name) {
+          referredBys.push({
+            entityName: otherDef.name,
+            propertyName: prop.name,
+            isUnique: prop.isUnique
+          });
+        }
+      }
+    }
+    relations.push({
+      entityName: def.name,
+      referTos,
+      referredBys
+    });
+  }
+  return relations;
+}
+
+exports.entity = entity;
+exports.generateEntities = generateEntities;
+exports.generateRelations = generateRelations;
+exports.struct = struct;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setupZod.ts","../src/factories.ts","../src/generator.ts"],"names":["z","isNullable"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Extends Zod schemas with metadata methods using declaration merging\n */\nimport { z } from 'zod';\n\n// Symbols for metadata storage to avoid property name conflicts\nconst PK_SYMBOL = Symbol('zod-entity-pk');\nconst UNIQUE_SYMBOL = Symbol('zod-entity-unique');\nconst REF_SYMBOL = Symbol('zod-entity-ref');\n\nexport const METADATA_SYMBOLS = {\n  PK: PK_SYMBOL,\n  UNIQUE: UNIQUE_SYMBOL,\n  REF: REF_SYMBOL,\n} as const;\n\nexport type RefMetadata = {\n  targetEntity: z.ZodTypeAny;\n  targetColumn: string;\n};\n\n// Declare module augmentation for Zod types\ndeclare module 'zod' {\n  interface ZodType {\n    [PK_SYMBOL]?: boolean;\n    [UNIQUE_SYMBOL]?: boolean;\n    [REF_SYMBOL]?: RefMetadata;\n\n    pk(): this;\n    unique(): this;\n    ref(targetEntity: z.ZodTypeAny, targetColumn?: string): this;\n  }\n}\n\n// Implement the methods on ZodType prototype\nz.ZodType.prototype.pk = function () {\n  this[PK_SYMBOL] = true;\n  return this;\n};\n\nz.ZodType.prototype.unique = function () {\n  this[UNIQUE_SYMBOL] = true;\n  return this;\n};\n\nz.ZodType.prototype.ref = function (targetEntity: z.ZodTypeAny, targetColumn = 'id') {\n  this[REF_SYMBOL] = { targetEntity, targetColumn };\n  return this;\n};\n\n/**\n * Helper functions to check metadata\n */\nexport function isPrimaryKey(schema: z.ZodTypeAny): boolean {\n  return schema[PK_SYMBOL] === true;\n}\n\nexport function isUnique(schema: z.ZodTypeAny): boolean {\n  return schema[UNIQUE_SYMBOL] === true;\n}\n\nexport function getRefMetadata(schema: z.ZodTypeAny): RefMetadata | undefined {\n  return schema[REF_SYMBOL];\n}\n","/**\n * Factory functions for creating entity and struct schemas\n */\nimport { z } from 'zod';\n\n// Symbols for schema metadata\nconst SCHEMA_TYPE_SYMBOL = Symbol('zod-schema-type');\nconst SCHEMA_NAME_SYMBOL = Symbol('zod-schema-name');\nconst SCHEMA_DESCRIPTION_SYMBOL = Symbol('zod-schema-description');\n\nexport const SCHEMA_METADATA_SYMBOLS = {\n  TYPE: SCHEMA_TYPE_SYMBOL,\n  NAME: SCHEMA_NAME_SYMBOL,\n  DESCRIPTION: SCHEMA_DESCRIPTION_SYMBOL,\n} as const;\n\nexport type EntityConfig<T extends z.ZodRawShape> = {\n  name: string;\n  description?: string;\n  columns: T;\n};\n\nexport type StructConfig<T extends z.ZodRawShape> = {\n  name: string;\n  description?: string;\n  columns: T;\n};\n\n// Augment ZodObject to store metadata\n// Note: Using bracket notation to add properties at runtime, avoiding type parameter conflicts\ntype ZodObjectWithMetadata = z.ZodObject<z.ZodRawShape> & {\n  [SCHEMA_TYPE_SYMBOL]?: 'entity' | 'struct';\n  [SCHEMA_NAME_SYMBOL]?: string;\n  [SCHEMA_DESCRIPTION_SYMBOL]?: string;\n};\n\n// Branded type to carry entity name at type level\ndeclare const ENTITY_NAME_BRAND: unique symbol;\nexport type EntitySchema<\n  TName extends string,\n  TShape extends z.ZodRawShape,\n> = z.ZodObject<TShape> & {\n  readonly [ENTITY_NAME_BRAND]: TName;\n};\n\n/**\n * Creates an entity schema with metadata\n */\nexport function entity<const TConfig extends EntityConfig<z.ZodRawShape>>(\n  config: TConfig\n): EntitySchema<TConfig['name'], TConfig['columns']> {\n  const schema = z.object(config.columns) as ZodObjectWithMetadata;\n  schema[SCHEMA_TYPE_SYMBOL] = 'entity';\n  schema[SCHEMA_NAME_SYMBOL] = config.name;\n  if (config.description !== undefined) {\n    schema[SCHEMA_DESCRIPTION_SYMBOL] = config.description;\n  }\n  return schema as EntitySchema<TConfig['name'], TConfig['columns']>;\n}\n\n/**\n * Creates a struct schema with metadata\n */\nexport function struct<T extends z.ZodRawShape>(config: StructConfig<T>): z.ZodObject<T> {\n  const schema = z.object(config.columns) as ZodObjectWithMetadata;\n  schema[SCHEMA_TYPE_SYMBOL] = 'struct';\n  schema[SCHEMA_NAME_SYMBOL] = config.name;\n  if (config.description !== undefined) {\n    schema[SCHEMA_DESCRIPTION_SYMBOL] = config.description;\n  }\n  return schema as z.ZodObject<T>;\n}\n\n/**\n * Helper functions to check schema metadata\n */\nexport function getSchemaType(schema: z.ZodTypeAny): 'entity' | 'struct' | undefined {\n  if (schema instanceof z.ZodObject) {\n    return (schema as ZodObjectWithMetadata)[SCHEMA_TYPE_SYMBOL];\n  }\n  return undefined;\n}\n\nexport function getSchemaName(schema: z.ZodTypeAny): string | undefined {\n  if (schema instanceof z.ZodObject) {\n    return (schema as ZodObjectWithMetadata)[SCHEMA_NAME_SYMBOL];\n  }\n  return undefined;\n}\n\nexport function getSchemaDescription(schema: z.ZodTypeAny): string | undefined {\n  if (schema instanceof z.ZodObject) {\n    return (schema as ZodObjectWithMetadata)[SCHEMA_DESCRIPTION_SYMBOL];\n  }\n  return undefined;\n}\n","/**\n * Core generation logic for entity definitions and relations\n */\nimport { z } from 'zod';\nimport type { EntitySchema } from './factories';\nimport { getSchemaDescription, getSchemaName, getSchemaType } from './factories';\nimport { getRefMetadata, isPrimaryKey, isUnique } from './setupZod';\nimport type {\n  EntityDefinition,\n  EntityPropertyDefinition,\n  EntityPropertyDefinitionPrimaryKey,\n  EntityPropertyDefinitionPrimitive,\n  EntityPropertyDefinitionReferencedObject,\n  EntityPropertyDefinitionTypedStruct,\n  EntityRelation,\n  EntityRelationReferTo,\n  EntityRelationReferredBy,\n} from './types';\n\n/**\n * Helper type to extract entity name from a single EntitySchema\n *\n * For example: EntitySchema<'User', {...}> => 'User'\n * For non-EntitySchema types, returns never\n */\ntype ExtractEntityName<T> = T extends EntitySchema<infer TName, z.ZodRawShape> ? TName : never;\n\n/**\n * Helper type to extract entity names from an array of schemas\n *\n * This transforms an array of EntitySchema types into a union of their names.\n * For example: [EntitySchema<'User', ...>, EntitySchema<'Company', ...>] => 'User' | 'Company'\n *\n * The pattern works by:\n * 1. Mapping over the array type to extract each entity name\n * 2. Using [number] to create a union of all extracted names\n */\ntype ExtractEntityNames<T extends readonly z.ZodTypeAny[]> = {\n  [K in keyof T]: ExtractEntityName<T[K]>;\n}[number];\n\n/**\n * Unwraps a Zod schema to get the innermost type\n * Handles z.optional, z.nullable, z.array\n */\ntype UnwrapResult = {\n  innerSchema: z.ZodTypeAny;\n  isNullable: boolean;\n  isArray: boolean;\n};\n\nfunction unwrapSchema(schema: z.ZodTypeAny): UnwrapResult {\n  let current = schema;\n  let isNullable = false;\n  let isArray = false;\n\n  // Unwrap layers\n  while (true) {\n    if (current instanceof z.ZodOptional) {\n      isNullable = true;\n      current = current.unwrap() as z.ZodTypeAny;\n    } else if (current instanceof z.ZodNullable) {\n      isNullable = true;\n      current = current.unwrap() as z.ZodTypeAny;\n    } else if (current instanceof z.ZodArray) {\n      isArray = true;\n      current = current.element as z.ZodTypeAny;\n    } else {\n      break;\n    }\n  }\n\n  return { innerSchema: current, isNullable, isArray };\n}\n\n/**\n * Generates entity definitions from Zod schemas\n */\nexport function generateEntities<const T extends readonly z.ZodTypeAny[]>(\n  schemas: T\n): EntityDefinition<ExtractEntityNames<T>>[] {\n  const definitions: EntityDefinition[] = [];\n\n  for (const schema of schemas) {\n    const schemaType = getSchemaType(schema);\n\n    // Only process entity schemas\n    if (schemaType !== 'entity') {\n      continue;\n    }\n\n    const name = getSchemaName(schema);\n    if (name === undefined) {\n      throw new Error('Entity schema must have a name');\n    }\n\n    const description = getSchemaDescription(schema);\n\n    if (!(schema instanceof z.ZodObject)) {\n      throw new Error(`Entity \"${name}\" must be a ZodObject`);\n    }\n\n    const properties: EntityPropertyDefinition[] = [];\n    const shape = schema.shape;\n\n    for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n      if (!(fieldSchema instanceof z.ZodType)) {\n        continue;\n      }\n\n      const property = parseProperty(fieldName, fieldSchema);\n      properties.push(property);\n    }\n\n    const entityDefinition: EntityDefinition = {\n      name,\n      properties,\n    };\n    if (description !== undefined) {\n      entityDefinition.description = description;\n    }\n    definitions.push(entityDefinition);\n  }\n\n  return definitions as EntityDefinition<ExtractEntityNames<T>>[];\n}\n\n/**\n * Parses a single property from a Zod schema\n */\nfunction parseProperty(fieldName: string, fieldSchema: z.ZodTypeAny): EntityPropertyDefinition {\n  const isPk = isPrimaryKey(fieldSchema);\n  const isUniqueField = isUnique(fieldSchema);\n  const refMetadata = getRefMetadata(fieldSchema);\n\n  // Handle Primary Key\n  if (isPk) {\n    const property: EntityPropertyDefinitionPrimaryKey = {\n      isReference: false,\n      propertyType: 'PrimaryKey',\n      name: fieldName,\n    };\n    return property;\n  }\n\n  // Handle Foreign Key Reference\n  if (refMetadata !== undefined) {\n    const { targetEntity } = refMetadata;\n\n    // Validate that targetEntity is an entity\n    const targetSchemaType = getSchemaType(targetEntity);\n    if (targetSchemaType !== 'entity') {\n      throw new Error(\n        `Field \"${fieldName}\" has .ref() pointing to a non-entity schema. Only entity schemas created with entity() can be referenced.`\n      );\n    }\n\n    const targetEntityName = getSchemaName(targetEntity);\n    if (targetEntityName === undefined) {\n      throw new Error(`Referenced entity for field \"${fieldName}\" must have a name`);\n    }\n\n    const { isNullable } = unwrapSchema(fieldSchema);\n\n    const property: EntityPropertyDefinitionReferencedObject = {\n      isReference: true,\n      name: fieldName,\n      targetEntityDefinitionName: targetEntityName,\n      isUnique: isUniqueField,\n      isNullable,\n    };\n    return property;\n  }\n\n  // Unwrap the schema\n  const { innerSchema, isNullable, isArray } = unwrapSchema(fieldSchema);\n\n  // Check if inner schema is an entity (not allowed)\n  const innerSchemaType = getSchemaType(innerSchema);\n  if (innerSchemaType === 'entity') {\n    throw new Error(\n      `Field \"${fieldName}\" contains a direct entity embedding. Entities cannot be directly nested. Use .ref() instead.`\n    );\n  }\n\n  // Handle struct\n  if (innerSchemaType === 'struct') {\n    const structName = getSchemaName(innerSchema);\n    if (structName === undefined) {\n      throw new Error(`Struct schema for field \"${fieldName}\" must have a name`);\n    }\n\n    const property: EntityPropertyDefinitionTypedStruct = {\n      isReference: false,\n      propertyType: 'typedStruct',\n      name: fieldName,\n      structTypeName: structName,\n      isUnique: isUniqueField,\n      isNullable,\n      isArray,\n    };\n    return property;\n  }\n\n  // Handle primitives\n  const primitiveType = getPrimitiveType(innerSchema);\n  if (primitiveType !== null) {\n    const acceptableValues = getAcceptableValues(innerSchema);\n\n    const property: EntityPropertyDefinitionPrimitive = {\n      isReference: false,\n      propertyType: primitiveType,\n      name: fieldName,\n      isUnique: isUniqueField,\n      isNullable,\n      isArray,\n      acceptableValues,\n    };\n    return property;\n  }\n\n  throw new Error(`Unsupported schema type for field \"${fieldName}\"`);\n}\n\n/**\n * Determines the primitive type from a Zod schema\n */\nfunction getPrimitiveType(schema: z.ZodTypeAny): 'boolean' | 'number' | 'string' | 'Date' | null {\n  if (schema instanceof z.ZodString) {\n    return 'string';\n  }\n  if (schema instanceof z.ZodNumber) {\n    return 'number';\n  }\n  if (schema instanceof z.ZodBoolean) {\n    return 'boolean';\n  }\n  if (schema instanceof z.ZodDate) {\n    return 'Date';\n  }\n  if (schema instanceof z.ZodEnum) {\n    return 'string';\n  }\n  return null;\n}\n\n/**\n * Extracts acceptable values from z.enum\n */\nfunction getAcceptableValues(schema: z.ZodTypeAny): string[] | null {\n  if (schema instanceof z.ZodEnum) {\n    return [...schema.options] as string[];\n  }\n  return null;\n}\n\n/**\n * Generates relations from entity definitions\n */\nexport function generateRelations(definitions: EntityDefinition[]): EntityRelation[] {\n  const relations: EntityRelation[] = [];\n\n  // Build a map for quick lookup\n  const entityMap = new Map<string, EntityDefinition>();\n  for (const def of definitions) {\n    entityMap.set(def.name, def);\n  }\n\n  // Initialize relations for each entity\n  for (const def of definitions) {\n    const referTos: EntityRelationReferTo[] = [];\n    const referredBys: EntityRelationReferredBy[] = [];\n\n    // Find referTos (outgoing references)\n    for (const prop of def.properties) {\n      if (prop.isReference) {\n        referTos.push({\n          entityName: prop.targetEntityDefinitionName,\n          propertyName: prop.name,\n          isUnique: prop.isUnique,\n        });\n      }\n    }\n\n    // Find referredBys (incoming references)\n    for (const otherDef of definitions) {\n      if (otherDef.name === def.name) {\n        continue;\n      }\n\n      for (const prop of otherDef.properties) {\n        if (prop.isReference && prop.targetEntityDefinitionName === def.name) {\n          referredBys.push({\n            entityName: otherDef.name,\n            propertyName: prop.name,\n            isUnique: prop.isUnique,\n          });\n        }\n      }\n    }\n\n    relations.push({\n      entityName: def.name,\n      referTos,\n      referredBys,\n    });\n  }\n\n  return relations;\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,262 @@
+import { z } from 'zod';
+
+// src/setupZod.ts
+var PK_SYMBOL = Symbol("zod-entity-pk");
+var UNIQUE_SYMBOL = Symbol("zod-entity-unique");
+var REF_SYMBOL = Symbol("zod-entity-ref");
+z.ZodType.prototype.pk = function() {
+  this[PK_SYMBOL] = true;
+  return this;
+};
+z.ZodType.prototype.unique = function() {
+  this[UNIQUE_SYMBOL] = true;
+  return this;
+};
+z.ZodType.prototype.ref = function(targetEntity, targetColumn = "id") {
+  this[REF_SYMBOL] = { targetEntity, targetColumn };
+  return this;
+};
+function isPrimaryKey(schema) {
+  return schema[PK_SYMBOL] === true;
+}
+function isUnique(schema) {
+  return schema[UNIQUE_SYMBOL] === true;
+}
+function getRefMetadata(schema) {
+  return schema[REF_SYMBOL];
+}
+var SCHEMA_TYPE_SYMBOL = Symbol("zod-schema-type");
+var SCHEMA_NAME_SYMBOL = Symbol("zod-schema-name");
+var SCHEMA_DESCRIPTION_SYMBOL = Symbol("zod-schema-description");
+function entity(config) {
+  const schema = z.object(config.columns);
+  schema[SCHEMA_TYPE_SYMBOL] = "entity";
+  schema[SCHEMA_NAME_SYMBOL] = config.name;
+  if (config.description !== void 0) {
+    schema[SCHEMA_DESCRIPTION_SYMBOL] = config.description;
+  }
+  return schema;
+}
+function struct(config) {
+  const schema = z.object(config.columns);
+  schema[SCHEMA_TYPE_SYMBOL] = "struct";
+  schema[SCHEMA_NAME_SYMBOL] = config.name;
+  if (config.description !== void 0) {
+    schema[SCHEMA_DESCRIPTION_SYMBOL] = config.description;
+  }
+  return schema;
+}
+function getSchemaType(schema) {
+  if (schema instanceof z.ZodObject) {
+    return schema[SCHEMA_TYPE_SYMBOL];
+  }
+  return void 0;
+}
+function getSchemaName(schema) {
+  if (schema instanceof z.ZodObject) {
+    return schema[SCHEMA_NAME_SYMBOL];
+  }
+  return void 0;
+}
+function getSchemaDescription(schema) {
+  if (schema instanceof z.ZodObject) {
+    return schema[SCHEMA_DESCRIPTION_SYMBOL];
+  }
+  return void 0;
+}
+function unwrapSchema(schema) {
+  let current = schema;
+  let isNullable = false;
+  let isArray = false;
+  while (true) {
+    if (current instanceof z.ZodOptional) {
+      isNullable = true;
+      current = current.unwrap();
+    } else if (current instanceof z.ZodNullable) {
+      isNullable = true;
+      current = current.unwrap();
+    } else if (current instanceof z.ZodArray) {
+      isArray = true;
+      current = current.element;
+    } else {
+      break;
+    }
+  }
+  return { innerSchema: current, isNullable, isArray };
+}
+function generateEntities(schemas) {
+  const definitions = [];
+  for (const schema of schemas) {
+    const schemaType = getSchemaType(schema);
+    if (schemaType !== "entity") {
+      continue;
+    }
+    const name = getSchemaName(schema);
+    if (name === void 0) {
+      throw new Error("Entity schema must have a name");
+    }
+    const description = getSchemaDescription(schema);
+    if (!(schema instanceof z.ZodObject)) {
+      throw new Error(`Entity "${name}" must be a ZodObject`);
+    }
+    const properties = [];
+    const shape = schema.shape;
+    for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+      if (!(fieldSchema instanceof z.ZodType)) {
+        continue;
+      }
+      const property = parseProperty(fieldName, fieldSchema);
+      properties.push(property);
+    }
+    const entityDefinition = {
+      name,
+      properties
+    };
+    if (description !== void 0) {
+      entityDefinition.description = description;
+    }
+    definitions.push(entityDefinition);
+  }
+  return definitions;
+}
+function parseProperty(fieldName, fieldSchema) {
+  const isPk = isPrimaryKey(fieldSchema);
+  const isUniqueField = isUnique(fieldSchema);
+  const refMetadata = getRefMetadata(fieldSchema);
+  if (isPk) {
+    const property = {
+      isReference: false,
+      propertyType: "PrimaryKey",
+      name: fieldName
+    };
+    return property;
+  }
+  if (refMetadata !== void 0) {
+    const { targetEntity } = refMetadata;
+    const targetSchemaType = getSchemaType(targetEntity);
+    if (targetSchemaType !== "entity") {
+      throw new Error(
+        `Field "${fieldName}" has .ref() pointing to a non-entity schema. Only entity schemas created with entity() can be referenced.`
+      );
+    }
+    const targetEntityName = getSchemaName(targetEntity);
+    if (targetEntityName === void 0) {
+      throw new Error(`Referenced entity for field "${fieldName}" must have a name`);
+    }
+    const { isNullable: isNullable2 } = unwrapSchema(fieldSchema);
+    const property = {
+      isReference: true,
+      name: fieldName,
+      targetEntityDefinitionName: targetEntityName,
+      isUnique: isUniqueField,
+      isNullable: isNullable2
+    };
+    return property;
+  }
+  const { innerSchema, isNullable, isArray } = unwrapSchema(fieldSchema);
+  const innerSchemaType = getSchemaType(innerSchema);
+  if (innerSchemaType === "entity") {
+    throw new Error(
+      `Field "${fieldName}" contains a direct entity embedding. Entities cannot be directly nested. Use .ref() instead.`
+    );
+  }
+  if (innerSchemaType === "struct") {
+    const structName = getSchemaName(innerSchema);
+    if (structName === void 0) {
+      throw new Error(`Struct schema for field "${fieldName}" must have a name`);
+    }
+    const property = {
+      isReference: false,
+      propertyType: "typedStruct",
+      name: fieldName,
+      structTypeName: structName,
+      isUnique: isUniqueField,
+      isNullable,
+      isArray
+    };
+    return property;
+  }
+  const primitiveType = getPrimitiveType(innerSchema);
+  if (primitiveType !== null) {
+    const acceptableValues = getAcceptableValues(innerSchema);
+    const property = {
+      isReference: false,
+      propertyType: primitiveType,
+      name: fieldName,
+      isUnique: isUniqueField,
+      isNullable,
+      isArray,
+      acceptableValues
+    };
+    return property;
+  }
+  throw new Error(`Unsupported schema type for field "${fieldName}"`);
+}
+function getPrimitiveType(schema) {
+  if (schema instanceof z.ZodString) {
+    return "string";
+  }
+  if (schema instanceof z.ZodNumber) {
+    return "number";
+  }
+  if (schema instanceof z.ZodBoolean) {
+    return "boolean";
+  }
+  if (schema instanceof z.ZodDate) {
+    return "Date";
+  }
+  if (schema instanceof z.ZodEnum) {
+    return "string";
+  }
+  return null;
+}
+function getAcceptableValues(schema) {
+  if (schema instanceof z.ZodEnum) {
+    return [...schema.options];
+  }
+  return null;
+}
+function generateRelations(definitions) {
+  const relations = [];
+  const entityMap = /* @__PURE__ */ new Map();
+  for (const def of definitions) {
+    entityMap.set(def.name, def);
+  }
+  for (const def of definitions) {
+    const referTos = [];
+    const referredBys = [];
+    for (const prop of def.properties) {
+      if (prop.isReference) {
+        referTos.push({
+          entityName: prop.targetEntityDefinitionName,
+          propertyName: prop.name,
+          isUnique: prop.isUnique
+        });
+      }
+    }
+    for (const otherDef of definitions) {
+      if (otherDef.name === def.name) {
+        continue;
+      }
+      for (const prop of otherDef.properties) {
+        if (prop.isReference && prop.targetEntityDefinitionName === def.name) {
+          referredBys.push({
+            entityName: otherDef.name,
+            propertyName: prop.name,
+            isUnique: prop.isUnique
+          });
+        }
+      }
+    }
+    relations.push({
+      entityName: def.name,
+      referTos,
+      referredBys
+    });
+  }
+  return relations;
+}
+
+export { entity, generateEntities, generateRelations, struct };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setupZod.ts","../src/factories.ts","../src/generator.ts"],"names":["z","isNullable"],"mappings":";;;AAMA,IAAM,SAAA,GAAY,OAAO,eAAe,CAAA;AACxC,IAAM,aAAA,GAAgB,OAAO,mBAAmB,CAAA;AAChD,IAAM,UAAA,GAAa,OAAO,gBAAgB,CAAA;AA2B1C,CAAA,CAAE,OAAA,CAAQ,SAAA,CAAU,EAAA,GAAK,WAAY;AACnC,EAAA,IAAA,CAAK,SAAS,CAAA,GAAI,IAAA;AAClB,EAAA,OAAO,IAAA;AACT,CAAA;AAEA,CAAA,CAAE,OAAA,CAAQ,SAAA,CAAU,MAAA,GAAS,WAAY;AACvC,EAAA,IAAA,CAAK,aAAa,CAAA,GAAI,IAAA;AACtB,EAAA,OAAO,IAAA;AACT,CAAA;AAEA,CAAA,CAAE,QAAQ,SAAA,CAAU,GAAA,GAAM,SAAU,YAAA,EAA4B,eAAe,IAAA,EAAM;AACnF,EAAA,IAAA,CAAK,UAAU,CAAA,GAAI,EAAE,YAAA,EAAc,YAAA,EAAa;AAChD,EAAA,OAAO,IAAA;AACT,CAAA;AAKO,SAAS,aAAa,MAAA,EAA+B;AAC1D,EAAA,OAAO,MAAA,CAAO,SAAS,CAAA,KAAM,IAAA;AAC/B;AAEO,SAAS,SAAS,MAAA,EAA+B;AACtD,EAAA,OAAO,MAAA,CAAO,aAAa,CAAA,KAAM,IAAA;AACnC;AAEO,SAAS,eAAe,MAAA,EAA+C;AAC5E,EAAA,OAAO,OAAO,UAAU,CAAA;AAC1B;ACzDA,IAAM,kBAAA,GAAqB,OAAO,iBAAiB,CAAA;AACnD,IAAM,kBAAA,GAAqB,OAAO,iBAAiB,CAAA;AACnD,IAAM,yBAAA,GAA4B,OAAO,wBAAwB,CAAA;AAwC1D,SAAS,OACd,MAAA,EACmD;AACnD,EAAA,MAAM,MAAA,GAASA,CAAAA,CAAE,MAAA,CAAO,MAAA,CAAO,OAAO,CAAA;AACtC,EAAA,MAAA,CAAO,kBAAkB,CAAA,GAAI,QAAA;AAC7B,EAAA,MAAA,CAAO,kBAAkB,IAAI,MAAA,CAAO,IAAA;AACpC,EAAA,IAAI,MAAA,CAAO,gBAAgB,MAAA,EAAW;AACpC,IAAA,MAAA,CAAO,yBAAyB,IAAI,MAAA,CAAO,WAAA;AAAA,EAC7C;AACA,EAAA,OAAO,MAAA;AACT;AAKO,SAAS,OAAgC,MAAA,EAAyC;AACvF,EAAA,MAAM,MAAA,GAASA,CAAAA,CAAE,MAAA,CAAO,MAAA,CAAO,OAAO,CAAA;AACtC,EAAA,MAAA,CAAO,kBAAkB,CAAA,GAAI,QAAA;AAC7B,EAAA,MAAA,CAAO,kBAAkB,IAAI,MAAA,CAAO,IAAA;AACpC,EAAA,IAAI,MAAA,CAAO,gBAAgB,MAAA,EAAW;AACpC,IAAA,MAAA,CAAO,yBAAyB,IAAI,MAAA,CAAO,WAAA;AAAA,EAC7C;AACA,EAAA,OAAO,MAAA;AACT;AAKO,SAAS,cAAc,MAAA,EAAuD;AACnF,EAAA,IAAI,MAAA,YAAkBA,EAAE,SAAA,EAAW;AACjC,IAAA,OAAQ,OAAiC,kBAAkB,CAAA;AAAA,EAC7D;AACA,EAAA,OAAO,MAAA;AACT;AAEO,SAAS,cAAc,MAAA,EAA0C;AACtE,EAAA,IAAI,MAAA,YAAkBA,EAAE,SAAA,EAAW;AACjC,IAAA,OAAQ,OAAiC,kBAAkB,CAAA;AAAA,EAC7D;AACA,EAAA,OAAO,MAAA;AACT;AAEO,SAAS,qBAAqB,MAAA,EAA0C;AAC7E,EAAA,IAAI,MAAA,YAAkBA,EAAE,SAAA,EAAW;AACjC,IAAA,OAAQ,OAAiC,yBAAyB,CAAA;AAAA,EACpE;AACA,EAAA,OAAO,MAAA;AACT;AC5CA,SAAS,aAAa,MAAA,EAAoC;AACxD,EAAA,IAAI,OAAA,GAAU,MAAA;AACd,EAAA,IAAI,UAAA,GAAa,KAAA;AACjB,EAAA,IAAI,OAAA,GAAU,KAAA;AAGd,EAAA,OAAO,IAAA,EAAM;AACX,IAAA,IAAI,OAAA,YAAmBA,EAAE,WAAA,EAAa;AACpC,MAAA,UAAA,GAAa,IAAA;AACb,MAAA,OAAA,GAAU,QAAQ,MAAA,EAAO;AAAA,IAC3B,CAAA,MAAA,IAAW,OAAA,YAAmBA,CAAAA,CAAE,WAAA,EAAa;AAC3C,MAAA,UAAA,GAAa,IAAA;AACb,MAAA,OAAA,GAAU,QAAQ,MAAA,EAAO;AAAA,IAC3B,CAAA,MAAA,IAAW,OAAA,YAAmBA,CAAAA,CAAE,QAAA,EAAU;AACxC,MAAA,OAAA,GAAU,IAAA;AACV,MAAA,OAAA,GAAU,OAAA,CAAQ,OAAA;AAAA,IACpB,CAAA,MAAO;AACL,MAAA;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,EAAE,WAAA,EAAa,OAAA,EAAS,UAAA,EAAY,OAAA,EAAQ;AACrD;AAKO,SAAS,iBACd,OAAA,EAC2C;AAC3C,EAAA,MAAM,cAAkC,EAAC;AAEzC,EAAA,KAAA,MAAW,UAAU,OAAA,EAAS;AAC5B,IAAA,MAAM,UAAA,GAAa,cAAc,MAAM,CAAA;AAGvC,IAAA,IAAI,eAAe,QAAA,EAAU;AAC3B,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,IAAA,GAAO,cAAc,MAAM,CAAA;AACjC,IAAA,IAAI,SAAS,MAAA,EAAW;AACtB,MAAA,MAAM,IAAI,MAAM,gCAAgC,CAAA;AAAA,IAClD;AAEA,IAAA,MAAM,WAAA,GAAc,qBAAqB,MAAM,CAAA;AAE/C,IAAA,IAAI,EAAE,MAAA,YAAkBA,CAAAA,CAAE,SAAA,CAAA,EAAY;AACpC,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,QAAA,EAAW,IAAI,CAAA,qBAAA,CAAuB,CAAA;AAAA,IACxD;AAEA,IAAA,MAAM,aAAyC,EAAC;AAChD,IAAA,MAAM,QAAQ,MAAA,CAAO,KAAA;AAErB,IAAA,KAAA,MAAW,CAAC,SAAA,EAAW,WAAW,KAAK,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,EAAG;AAC5D,MAAA,IAAI,EAAE,WAAA,YAAuBA,CAAAA,CAAE,OAAA,CAAA,EAAU;AACvC,QAAA;AAAA,MACF;AAEA,MAAA,MAAM,QAAA,GAAW,aAAA,CAAc,SAAA,EAAW,WAAW,CAAA;AACrD,MAAA,UAAA,CAAW,KAAK,QAAQ,CAAA;AAAA,IAC1B;AAEA,IAAA,MAAM,gBAAA,GAAqC;AAAA,MACzC,IAAA;AAAA,MACA;AAAA,KACF;AACA,IAAA,IAAI,gBAAgB,MAAA,EAAW;AAC7B,MAAA,gBAAA,CAAiB,WAAA,GAAc,WAAA;AAAA,IACjC;AACA,IAAA,WAAA,CAAY,KAAK,gBAAgB,CAAA;AAAA,EACnC;AAEA,EAAA,OAAO,WAAA;AACT;AAKA,SAAS,aAAA,CAAc,WAAmB,WAAA,EAAqD;AAC7F,EAAA,MAAM,IAAA,GAAO,aAAa,WAAW,CAAA;AACrC,EAAA,MAAM,aAAA,GAAgB,SAAS,WAAW,CAAA;AAC1C,EAAA,MAAM,WAAA,GAAc,eAAe,WAAW,CAAA;AAG9C,EAAA,IAAI,IAAA,EAAM;AACR,IAAA,MAAM,QAAA,GAA+C;AAAA,MACnD,WAAA,EAAa,KAAA;AAAA,MACb,YAAA,EAAc,YAAA;AAAA,MACd,IAAA,EAAM;AAAA,KACR;AACA,IAAA,OAAO,QAAA;AAAA,EACT;AAGA,EAAA,IAAI,gBAAgB,MAAA,EAAW;AAC7B,IAAA,MAAM,EAAE,cAAa,GAAI,WAAA;AAGzB,IAAA,MAAM,gBAAA,GAAmB,cAAc,YAAY,CAAA;AACnD,IAAA,IAAI,qBAAqB,QAAA,EAAU;AACjC,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,UAAU,SAAS,CAAA,0GAAA;AAAA,OACrB;AAAA,IACF;AAEA,IAAA,MAAM,gBAAA,GAAmB,cAAc,YAAY,CAAA;AACnD,IAAA,IAAI,qBAAqB,MAAA,EAAW;AAClC,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,6BAAA,EAAgC,SAAS,CAAA,kBAAA,CAAoB,CAAA;AAAA,IAC/E;AAEA,IAAA,MAAM,EAAE,UAAA,EAAAC,WAAAA,EAAW,GAAI,aAAa,WAAW,CAAA;AAE/C,IAAA,MAAM,QAAA,GAAqD;AAAA,MACzD,WAAA,EAAa,IAAA;AAAA,MACb,IAAA,EAAM,SAAA;AAAA,MACN,0BAAA,EAA4B,gBAAA;AAAA,MAC5B,QAAA,EAAU,aAAA;AAAA,MACV,UAAA,EAAAA;AAAA,KACF;AACA,IAAA,OAAO,QAAA;AAAA,EACT;AAGA,EAAA,MAAM,EAAE,WAAA,EAAa,UAAA,EAAY,OAAA,EAAQ,GAAI,aAAa,WAAW,CAAA;AAGrE,EAAA,MAAM,eAAA,GAAkB,cAAc,WAAW,CAAA;AACjD,EAAA,IAAI,oBAAoB,QAAA,EAAU;AAChC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,UAAU,SAAS,CAAA,6FAAA;AAAA,KACrB;AAAA,EACF;AAGA,EAAA,IAAI,oBAAoB,QAAA,EAAU;AAChC,IAAA,MAAM,UAAA,GAAa,cAAc,WAAW,CAAA;AAC5C,IAAA,IAAI,eAAe,MAAA,EAAW;AAC5B,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,yBAAA,EAA4B,SAAS,CAAA,kBAAA,CAAoB,CAAA;AAAA,IAC3E;AAEA,IAAA,MAAM,QAAA,GAAgD;AAAA,MACpD,WAAA,EAAa,KAAA;AAAA,MACb,YAAA,EAAc,aAAA;AAAA,MACd,IAAA,EAAM,SAAA;AAAA,MACN,cAAA,EAAgB,UAAA;AAAA,MAChB,QAAA,EAAU,aAAA;AAAA,MACV,UAAA;AAAA,MACA;AAAA,KACF;AACA,IAAA,OAAO,QAAA;AAAA,EACT;AAGA,EAAA,MAAM,aAAA,GAAgB,iBAAiB,WAAW,CAAA;AAClD,EAAA,IAAI,kBAAkB,IAAA,EAAM;AAC1B,IAAA,MAAM,gBAAA,GAAmB,oBAAoB,WAAW,CAAA;AAExD,IAAA,MAAM,QAAA,GAA8C;AAAA,MAClD,WAAA,EAAa,KAAA;AAAA,MACb,YAAA,EAAc,aAAA;AAAA,MACd,IAAA,EAAM,SAAA;AAAA,MACN,QAAA,EAAU,aAAA;AAAA,MACV,UAAA;AAAA,MACA,OAAA;AAAA,MACA;AAAA,KACF;AACA,IAAA,OAAO,QAAA;AAAA,EACT;AAEA,EAAA,MAAM,IAAI,KAAA,CAAM,CAAA,mCAAA,EAAsC,SAAS,CAAA,CAAA,CAAG,CAAA;AACpE;AAKA,SAAS,iBAAiB,MAAA,EAAuE;AAC/F,EAAA,IAAI,MAAA,YAAkBD,EAAE,SAAA,EAAW;AACjC,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,IAAI,MAAA,YAAkBA,EAAE,SAAA,EAAW;AACjC,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,IAAI,MAAA,YAAkBA,EAAE,UAAA,EAAY;AAClC,IAAA,OAAO,SAAA;AAAA,EACT;AACA,EAAA,IAAI,MAAA,YAAkBA,EAAE,OAAA,EAAS;AAC/B,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,IAAI,MAAA,YAAkBA,EAAE,OAAA,EAAS;AAC/B,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,OAAO,IAAA;AACT;AAKA,SAAS,oBAAoB,MAAA,EAAuC;AAClE,EAAA,IAAI,MAAA,YAAkBA,EAAE,OAAA,EAAS;AAC/B,IAAA,OAAO,CAAC,GAAG,MAAA,CAAO,OAAO,CAAA;AAAA,EAC3B;AACA,EAAA,OAAO,IAAA;AACT;AAKO,SAAS,kBAAkB,WAAA,EAAmD;AACnF,EAAA,MAAM,YAA8B,EAAC;AAGrC,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAA8B;AACpD,EAAA,KAAA,MAAW,OAAO,WAAA,EAAa;AAC7B,IAAA,SAAA,CAAU,GAAA,CAAI,GAAA,CAAI,IAAA,EAAM,GAAG,CAAA;AAAA,EAC7B;AAGA,EAAA,KAAA,MAAW,OAAO,WAAA,EAAa;AAC7B,IAAA,MAAM,WAAoC,EAAC;AAC3C,IAAA,MAAM,cAA0C,EAAC;AAGjD,IAAA,KAAA,MAAW,IAAA,IAAQ,IAAI,UAAA,EAAY;AACjC,MAAA,IAAI,KAAK,WAAA,EAAa;AACpB,QAAA,QAAA,CAAS,IAAA,CAAK;AAAA,UACZ,YAAY,IAAA,CAAK,0BAAA;AAAA,UACjB,cAAc,IAAA,CAAK,IAAA;AAAA,UACnB,UAAU,IAAA,CAAK;AAAA,SAChB,CAAA;AAAA,MACH;AAAA,IACF;AAGA,IAAA,KAAA,MAAW,YAAY,WAAA,EAAa;AAClC,MAAA,IAAI,QAAA,CAAS,IAAA,KAAS,GAAA,CAAI,IAAA,EAAM;AAC9B,QAAA;AAAA,MACF;AAEA,MAAA,KAAA,MAAW,IAAA,IAAQ,SAAS,UAAA,EAAY;AACtC,QAAA,IAAI,IAAA,CAAK,WAAA,IAAe,IAAA,CAAK,0BAAA,KAA+B,IAAI,IAAA,EAAM;AACpE,UAAA,WAAA,CAAY,IAAA,CAAK;AAAA,YACf,YAAY,QAAA,CAAS,IAAA;AAAA,YACrB,cAAc,IAAA,CAAK,IAAA;AAAA,YACnB,UAAU,IAAA,CAAK;AAAA,WAChB,CAAA;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAEA,IAAA,SAAA,CAAU,IAAA,CAAK;AAAA,MACb,YAAY,GAAA,CAAI,IAAA;AAAA,MAChB,QAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAEA,EAAA,OAAO,SAAA;AACT","file":"index.mjs","sourcesContent":["/**\n * Extends Zod schemas with metadata methods using declaration merging\n */\nimport { z } from 'zod';\n\n// Symbols for metadata storage to avoid property name conflicts\nconst PK_SYMBOL = Symbol('zod-entity-pk');\nconst UNIQUE_SYMBOL = Symbol('zod-entity-unique');\nconst REF_SYMBOL = Symbol('zod-entity-ref');\n\nexport const METADATA_SYMBOLS = {\n  PK: PK_SYMBOL,\n  UNIQUE: UNIQUE_SYMBOL,\n  REF: REF_SYMBOL,\n} as const;\n\nexport type RefMetadata = {\n  targetEntity: z.ZodTypeAny;\n  targetColumn: string;\n};\n\n// Declare module augmentation for Zod types\ndeclare module 'zod' {\n  interface ZodType {\n    [PK_SYMBOL]?: boolean;\n    [UNIQUE_SYMBOL]?: boolean;\n    [REF_SYMBOL]?: RefMetadata;\n\n    pk(): this;\n    unique(): this;\n    ref(targetEntity: z.ZodTypeAny, targetColumn?: string): this;\n  }\n}\n\n// Implement the methods on ZodType prototype\nz.ZodType.prototype.pk = function () {\n  this[PK_SYMBOL] = true;\n  return this;\n};\n\nz.ZodType.prototype.unique = function () {\n  this[UNIQUE_SYMBOL] = true;\n  return this;\n};\n\nz.ZodType.prototype.ref = function (targetEntity: z.ZodTypeAny, targetColumn = 'id') {\n  this[REF_SYMBOL] = { targetEntity, targetColumn };\n  return this;\n};\n\n/**\n * Helper functions to check metadata\n */\nexport function isPrimaryKey(schema: z.ZodTypeAny): boolean {\n  return schema[PK_SYMBOL] === true;\n}\n\nexport function isUnique(schema: z.ZodTypeAny): boolean {\n  return schema[UNIQUE_SYMBOL] === true;\n}\n\nexport function getRefMetadata(schema: z.ZodTypeAny): RefMetadata | undefined {\n  return schema[REF_SYMBOL];\n}\n","/**\n * Factory functions for creating entity and struct schemas\n */\nimport { z } from 'zod';\n\n// Symbols for schema metadata\nconst SCHEMA_TYPE_SYMBOL = Symbol('zod-schema-type');\nconst SCHEMA_NAME_SYMBOL = Symbol('zod-schema-name');\nconst SCHEMA_DESCRIPTION_SYMBOL = Symbol('zod-schema-description');\n\nexport const SCHEMA_METADATA_SYMBOLS = {\n  TYPE: SCHEMA_TYPE_SYMBOL,\n  NAME: SCHEMA_NAME_SYMBOL,\n  DESCRIPTION: SCHEMA_DESCRIPTION_SYMBOL,\n} as const;\n\nexport type EntityConfig<T extends z.ZodRawShape> = {\n  name: string;\n  description?: string;\n  columns: T;\n};\n\nexport type StructConfig<T extends z.ZodRawShape> = {\n  name: string;\n  description?: string;\n  columns: T;\n};\n\n// Augment ZodObject to store metadata\n// Note: Using bracket notation to add properties at runtime, avoiding type parameter conflicts\ntype ZodObjectWithMetadata = z.ZodObject<z.ZodRawShape> & {\n  [SCHEMA_TYPE_SYMBOL]?: 'entity' | 'struct';\n  [SCHEMA_NAME_SYMBOL]?: string;\n  [SCHEMA_DESCRIPTION_SYMBOL]?: string;\n};\n\n// Branded type to carry entity name at type level\ndeclare const ENTITY_NAME_BRAND: unique symbol;\nexport type EntitySchema<\n  TName extends string,\n  TShape extends z.ZodRawShape,\n> = z.ZodObject<TShape> & {\n  readonly [ENTITY_NAME_BRAND]: TName;\n};\n\n/**\n * Creates an entity schema with metadata\n */\nexport function entity<const TConfig extends EntityConfig<z.ZodRawShape>>(\n  config: TConfig\n): EntitySchema<TConfig['name'], TConfig['columns']> {\n  const schema = z.object(config.columns) as ZodObjectWithMetadata;\n  schema[SCHEMA_TYPE_SYMBOL] = 'entity';\n  schema[SCHEMA_NAME_SYMBOL] = config.name;\n  if (config.description !== undefined) {\n    schema[SCHEMA_DESCRIPTION_SYMBOL] = config.description;\n  }\n  return schema as EntitySchema<TConfig['name'], TConfig['columns']>;\n}\n\n/**\n * Creates a struct schema with metadata\n */\nexport function struct<T extends z.ZodRawShape>(config: StructConfig<T>): z.ZodObject<T> {\n  const schema = z.object(config.columns) as ZodObjectWithMetadata;\n  schema[SCHEMA_TYPE_SYMBOL] = 'struct';\n  schema[SCHEMA_NAME_SYMBOL] = config.name;\n  if (config.description !== undefined) {\n    schema[SCHEMA_DESCRIPTION_SYMBOL] = config.description;\n  }\n  return schema as z.ZodObject<T>;\n}\n\n/**\n * Helper functions to check schema metadata\n */\nexport function getSchemaType(schema: z.ZodTypeAny): 'entity' | 'struct' | undefined {\n  if (schema instanceof z.ZodObject) {\n    return (schema as ZodObjectWithMetadata)[SCHEMA_TYPE_SYMBOL];\n  }\n  return undefined;\n}\n\nexport function getSchemaName(schema: z.ZodTypeAny): string | undefined {\n  if (schema instanceof z.ZodObject) {\n    return (schema as ZodObjectWithMetadata)[SCHEMA_NAME_SYMBOL];\n  }\n  return undefined;\n}\n\nexport function getSchemaDescription(schema: z.ZodTypeAny): string | undefined {\n  if (schema instanceof z.ZodObject) {\n    return (schema as ZodObjectWithMetadata)[SCHEMA_DESCRIPTION_SYMBOL];\n  }\n  return undefined;\n}\n","/**\n * Core generation logic for entity definitions and relations\n */\nimport { z } from 'zod';\nimport type { EntitySchema } from './factories';\nimport { getSchemaDescription, getSchemaName, getSchemaType } from './factories';\nimport { getRefMetadata, isPrimaryKey, isUnique } from './setupZod';\nimport type {\n  EntityDefinition,\n  EntityPropertyDefinition,\n  EntityPropertyDefinitionPrimaryKey,\n  EntityPropertyDefinitionPrimitive,\n  EntityPropertyDefinitionReferencedObject,\n  EntityPropertyDefinitionTypedStruct,\n  EntityRelation,\n  EntityRelationReferTo,\n  EntityRelationReferredBy,\n} from './types';\n\n/**\n * Helper type to extract entity name from a single EntitySchema\n *\n * For example: EntitySchema<'User', {...}> => 'User'\n * For non-EntitySchema types, returns never\n */\ntype ExtractEntityName<T> = T extends EntitySchema<infer TName, z.ZodRawShape> ? TName : never;\n\n/**\n * Helper type to extract entity names from an array of schemas\n *\n * This transforms an array of EntitySchema types into a union of their names.\n * For example: [EntitySchema<'User', ...>, EntitySchema<'Company', ...>] => 'User' | 'Company'\n *\n * The pattern works by:\n * 1. Mapping over the array type to extract each entity name\n * 2. Using [number] to create a union of all extracted names\n */\ntype ExtractEntityNames<T extends readonly z.ZodTypeAny[]> = {\n  [K in keyof T]: ExtractEntityName<T[K]>;\n}[number];\n\n/**\n * Unwraps a Zod schema to get the innermost type\n * Handles z.optional, z.nullable, z.array\n */\ntype UnwrapResult = {\n  innerSchema: z.ZodTypeAny;\n  isNullable: boolean;\n  isArray: boolean;\n};\n\nfunction unwrapSchema(schema: z.ZodTypeAny): UnwrapResult {\n  let current = schema;\n  let isNullable = false;\n  let isArray = false;\n\n  // Unwrap layers\n  while (true) {\n    if (current instanceof z.ZodOptional) {\n      isNullable = true;\n      current = current.unwrap() as z.ZodTypeAny;\n    } else if (current instanceof z.ZodNullable) {\n      isNullable = true;\n      current = current.unwrap() as z.ZodTypeAny;\n    } else if (current instanceof z.ZodArray) {\n      isArray = true;\n      current = current.element as z.ZodTypeAny;\n    } else {\n      break;\n    }\n  }\n\n  return { innerSchema: current, isNullable, isArray };\n}\n\n/**\n * Generates entity definitions from Zod schemas\n */\nexport function generateEntities<const T extends readonly z.ZodTypeAny[]>(\n  schemas: T\n): EntityDefinition<ExtractEntityNames<T>>[] {\n  const definitions: EntityDefinition[] = [];\n\n  for (const schema of schemas) {\n    const schemaType = getSchemaType(schema);\n\n    // Only process entity schemas\n    if (schemaType !== 'entity') {\n      continue;\n    }\n\n    const name = getSchemaName(schema);\n    if (name === undefined) {\n      throw new Error('Entity schema must have a name');\n    }\n\n    const description = getSchemaDescription(schema);\n\n    if (!(schema instanceof z.ZodObject)) {\n      throw new Error(`Entity \"${name}\" must be a ZodObject`);\n    }\n\n    const properties: EntityPropertyDefinition[] = [];\n    const shape = schema.shape;\n\n    for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n      if (!(fieldSchema instanceof z.ZodType)) {\n        continue;\n      }\n\n      const property = parseProperty(fieldName, fieldSchema);\n      properties.push(property);\n    }\n\n    const entityDefinition: EntityDefinition = {\n      name,\n      properties,\n    };\n    if (description !== undefined) {\n      entityDefinition.description = description;\n    }\n    definitions.push(entityDefinition);\n  }\n\n  return definitions as EntityDefinition<ExtractEntityNames<T>>[];\n}\n\n/**\n * Parses a single property from a Zod schema\n */\nfunction parseProperty(fieldName: string, fieldSchema: z.ZodTypeAny): EntityPropertyDefinition {\n  const isPk = isPrimaryKey(fieldSchema);\n  const isUniqueField = isUnique(fieldSchema);\n  const refMetadata = getRefMetadata(fieldSchema);\n\n  // Handle Primary Key\n  if (isPk) {\n    const property: EntityPropertyDefinitionPrimaryKey = {\n      isReference: false,\n      propertyType: 'PrimaryKey',\n      name: fieldName,\n    };\n    return property;\n  }\n\n  // Handle Foreign Key Reference\n  if (refMetadata !== undefined) {\n    const { targetEntity } = refMetadata;\n\n    // Validate that targetEntity is an entity\n    const targetSchemaType = getSchemaType(targetEntity);\n    if (targetSchemaType !== 'entity') {\n      throw new Error(\n        `Field \"${fieldName}\" has .ref() pointing to a non-entity schema. Only entity schemas created with entity() can be referenced.`\n      );\n    }\n\n    const targetEntityName = getSchemaName(targetEntity);\n    if (targetEntityName === undefined) {\n      throw new Error(`Referenced entity for field \"${fieldName}\" must have a name`);\n    }\n\n    const { isNullable } = unwrapSchema(fieldSchema);\n\n    const property: EntityPropertyDefinitionReferencedObject = {\n      isReference: true,\n      name: fieldName,\n      targetEntityDefinitionName: targetEntityName,\n      isUnique: isUniqueField,\n      isNullable,\n    };\n    return property;\n  }\n\n  // Unwrap the schema\n  const { innerSchema, isNullable, isArray } = unwrapSchema(fieldSchema);\n\n  // Check if inner schema is an entity (not allowed)\n  const innerSchemaType = getSchemaType(innerSchema);\n  if (innerSchemaType === 'entity') {\n    throw new Error(\n      `Field \"${fieldName}\" contains a direct entity embedding. Entities cannot be directly nested. Use .ref() instead.`\n    );\n  }\n\n  // Handle struct\n  if (innerSchemaType === 'struct') {\n    const structName = getSchemaName(innerSchema);\n    if (structName === undefined) {\n      throw new Error(`Struct schema for field \"${fieldName}\" must have a name`);\n    }\n\n    const property: EntityPropertyDefinitionTypedStruct = {\n      isReference: false,\n      propertyType: 'typedStruct',\n      name: fieldName,\n      structTypeName: structName,\n      isUnique: isUniqueField,\n      isNullable,\n      isArray,\n    };\n    return property;\n  }\n\n  // Handle primitives\n  const primitiveType = getPrimitiveType(innerSchema);\n  if (primitiveType !== null) {\n    const acceptableValues = getAcceptableValues(innerSchema);\n\n    const property: EntityPropertyDefinitionPrimitive = {\n      isReference: false,\n      propertyType: primitiveType,\n      name: fieldName,\n      isUnique: isUniqueField,\n      isNullable,\n      isArray,\n      acceptableValues,\n    };\n    return property;\n  }\n\n  throw new Error(`Unsupported schema type for field \"${fieldName}\"`);\n}\n\n/**\n * Determines the primitive type from a Zod schema\n */\nfunction getPrimitiveType(schema: z.ZodTypeAny): 'boolean' | 'number' | 'string' | 'Date' | null {\n  if (schema instanceof z.ZodString) {\n    return 'string';\n  }\n  if (schema instanceof z.ZodNumber) {\n    return 'number';\n  }\n  if (schema instanceof z.ZodBoolean) {\n    return 'boolean';\n  }\n  if (schema instanceof z.ZodDate) {\n    return 'Date';\n  }\n  if (schema instanceof z.ZodEnum) {\n    return 'string';\n  }\n  return null;\n}\n\n/**\n * Extracts acceptable values from z.enum\n */\nfunction getAcceptableValues(schema: z.ZodTypeAny): string[] | null {\n  if (schema instanceof z.ZodEnum) {\n    return [...schema.options] as string[];\n  }\n  return null;\n}\n\n/**\n * Generates relations from entity definitions\n */\nexport function generateRelations(definitions: EntityDefinition[]): EntityRelation[] {\n  const relations: EntityRelation[] = [];\n\n  // Build a map for quick lookup\n  const entityMap = new Map<string, EntityDefinition>();\n  for (const def of definitions) {\n    entityMap.set(def.name, def);\n  }\n\n  // Initialize relations for each entity\n  for (const def of definitions) {\n    const referTos: EntityRelationReferTo[] = [];\n    const referredBys: EntityRelationReferredBy[] = [];\n\n    // Find referTos (outgoing references)\n    for (const prop of def.properties) {\n      if (prop.isReference) {\n        referTos.push({\n          entityName: prop.targetEntityDefinitionName,\n          propertyName: prop.name,\n          isUnique: prop.isUnique,\n        });\n      }\n    }\n\n    // Find referredBys (incoming references)\n    for (const otherDef of definitions) {\n      if (otherDef.name === def.name) {\n        continue;\n      }\n\n      for (const prop of otherDef.properties) {\n        if (prop.isReference && prop.targetEntityDefinitionName === def.name) {\n          referredBys.push({\n            entityName: otherDef.name,\n            propertyName: prop.name,\n            isUnique: prop.isUnique,\n          });\n        }\n      }\n    }\n\n    relations.push({\n      entityName: def.name,\n      referTos,\n      referredBys,\n    });\n  }\n\n  return relations;\n}\n"]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@masaori/zod-to-entity-definitions",
+  "version": "1.1.7",
+  "description": "A library to define data models using Zod with extended metadata and convert them into framework-agnostic Entity Definitions",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check .",
+    "fix": "biome check --write .",
+    "format": "biome format --write .",
+    "check-types": "tsc --noEmit",
+    "prepublishOnly": "npm run check-types && npm run lint && npm run test && npm run build"
+  },
+  "keywords": [
+    "zod",
+    "entity",
+    "orm",
+    "schema",
+    "typescript",
+    "entity-definition",
+    "er-model"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/masaori/zod-to-entity-definitions.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "peerDependencies": {
+    "zod": "4.1.13"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@commitlint/cli": "^19.0.0",
+    "@commitlint/config-conventional": "^19.0.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/npm": "^12.0.0",
+    "@types/node": "^22.10.1",
+    "conventional-changelog-conventionalcommits": "^8.0.0",
+    "semantic-release": "^24.0.0",
+    "tsup": "^8.3.5",
+    "tsx": "^4.20.6",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8",
+    "zod": "4.1.13"
+  }
+}