@parsrun/entity 0.1.35

package/README.md

@@ -0,0 +1,210 @@
+# @parsrun/entity
+
+Single-source entity definitions for the Pars framework. Define once, generate ArkType validation schemas and Drizzle ORM tables.
+
+## Installation
+
+```bash
+npm install @parsrun/entity
+# or
+pnpm add @parsrun/entity
+```
+
+## Quick Start
+
+```typescript
+import { defineEntity, ref, enumField } from '@parsrun/entity'
+import { toPgTable } from '@parsrun/entity/pg'
+// or for SQLite/D1:
+// import { toSqliteTable } from '@parsrun/entity/sqlite'
+
+// Define your entity once
+const Product = defineEntity({
+  name: 'products',
+  tenant: true,        // Adds tenantId field
+  timestamps: true,    // Adds insertedAt, updatedAt
+  softDelete: true,    // Adds deletedAt
+
+  fields: {
+    name: 'string >= 1',
+    slug: 'string',
+    description: { type: 'string', optional: true },
+    price: { type: 'number', min: 0 },
+    stock: { type: 'number.integer', min: 0, default: 0 },
+    status: enumField(['draft', 'active', 'archived'], { default: 'draft' }),
+    categoryId: ref('categories', { onDelete: 'set null', optional: true }),
+  },
+
+  indexes: [
+    { fields: ['tenantId', 'slug'], unique: true },
+    { fields: ['tenantId', 'status'] },
+  ],
+})
+
+// Generated schemas available:
+Product.schema        // Full entity schema
+Product.createSchema  // For create operations (no id, timestamps)
+Product.updateSchema  // For updates (all optional)
+Product.querySchema   // For filtering (includes pagination)
+
+// Generate Drizzle table
+const productsTable = toPgTable(Product)
+```
+
+## Usage
+
+### Validation
+
+```typescript
+import { type } from 'arktype'
+
+// Validate create input
+const input = Product.createSchema(requestBody)
+if (input instanceof type.errors) {
+  return { error: 'Validation failed', details: input }
+}
+
+// input is now typed and validated
+await db.insert(productsTable).values({
+  tenantId: ctx.tenantId,
+  ...input,
+})
+```
+
+### Database Queries
+
+```typescript
+import { eq, and } from 'drizzle-orm'
+import { toPgTable } from '@parsrun/entity/pg'
+
+const productsTable = toPgTable(Product)
+
+// Select
+const products = await db
+  .select()
+  .from(productsTable)
+  .where(and(
+    eq(productsTable.tenantId, tenantId),
+    eq(productsTable.status, 'active')
+  ))
+
+// Insert
+const [product] = await db
+  .insert(productsTable)
+  .values({ tenantId, name: 'Widget', price: 9.99 })
+  .returning()
+
+// Update
+await db
+  .update(productsTable)
+  .set({ price: 14.99 })
+  .where(eq(productsTable.id, productId))
+```
+
+### Multiple Entities with References
+
+```typescript
+import { createPgSchema } from '@parsrun/entity/pg'
+
+const Category = defineEntity({
+  name: 'categories',
+  tenant: true,
+  timestamps: true,
+  fields: {
+    name: 'string >= 1',
+    slug: 'string',
+  },
+})
+
+const Product = defineEntity({
+  name: 'products',
+  tenant: true,
+  timestamps: true,
+  fields: {
+    name: 'string >= 1',
+    categoryId: ref(Category, { onDelete: 'cascade' }),
+  },
+})
+
+// Creates tables with proper foreign key references
+const schema = createPgSchema({ Category, Product })
+// schema.Category, schema.Product
+```
+
+## Field Types
+
+| Type | Description | Example |
+|------|-------------|---------|
+| `'string'` | Text field | `name: 'string'` |
+| `'string >= N'` | Min length | `name: 'string >= 1'` |
+| `'string.uuid'` | UUID field | `id: 'string.uuid'` |
+| `'string.email'` | Email field | `email: 'string.email'` |
+| `'string.url'` | URL field | `website: 'string.url'` |
+| `'number'` | Numeric field | `price: 'number'` |
+| `'number >= N'` | Min value | `price: 'number >= 0'` |
+| `'number.integer'` | Integer field | `stock: 'number.integer'` |
+| `'boolean'` | Boolean field | `isActive: 'boolean'` |
+| `'Date'` | Timestamp | `expiresAt: 'Date'` |
+| `'json'` | JSON field | `metadata: 'json'` |
+| `"'a' \| 'b'"` | Union/Enum | `status: "'draft' \| 'active'"` |
+
+## Helper Functions
+
+### `enumField(values, options?)`
+
+```typescript
+status: enumField(['draft', 'active', 'archived'], {
+  default: 'draft',
+  optional: false
+})
+```
+
+### `ref(entity, options?)`
+
+```typescript
+categoryId: ref('categories', {
+  field: 'id',           // default: 'id'
+  onDelete: 'cascade',   // 'cascade' | 'set null' | 'restrict'
+  optional: true
+})
+
+// Or with entity reference
+categoryId: ref(Category, { onDelete: 'cascade' })
+```
+
+### `decimal(precision, scale, options?)`
+
+```typescript
+price: decimal(10, 2, { min: 0 })  // DECIMAL(10,2)
+```
+
+### `jsonField(options?)`
+
+```typescript
+metadata: jsonField({ optional: true, default: {} })
+```
+
+## SQLite / Cloudflare D1
+
+```typescript
+import { toSqliteTable, createSqliteSchema } from '@parsrun/entity/sqlite'
+
+const productsTable = toSqliteTable(Product)
+
+// Or multiple tables
+const schema = createSqliteSchema({ Category, Product })
+```
+
+## TypeScript Types
+
+```typescript
+import type { InferEntity, InferCreateInput, InferUpdateInput } from '@parsrun/entity'
+
+type Product = InferEntity<typeof Product>
+type CreateProductInput = InferCreateInput<typeof Product>
+type UpdateProductInput = InferUpdateInput<typeof Product>
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,66 @@
+import { F as Field, E as EntityDefinition, a as Entity, b as FieldDefinition } from './types-CmS0cBdC.js';
+export { D as DrizzleOptions, d as EntitySchemas, c as FieldType, I as IndexDefinition, f as InferCreateInput, e as InferEntity, g as InferUpdateInput, S as SimpleFieldDefinition } from './types-CmS0cBdC.js';
+export { type } from 'arktype';
+
+/**
+ * Define an entity with single-source schema generation
+ *
+ * @example
+ * ```typescript
+ * const Product = defineEntity({
+ *   name: 'products',
+ *   tenant: true,
+ *   timestamps: true,
+ *   softDelete: true,
+ *   fields: {
+ *     name: 'string >= 1',
+ *     price: { type: 'number', min: 0 },
+ *     status: "'draft' | 'active' | 'archived'",
+ *   },
+ *   indexes: [
+ *     { fields: ['tenantId', 'status'] },
+ *   ],
+ * })
+ *
+ * // Use schemas
+ * const validated = Product.createSchema(input)
+ * const products = await db.select().from(Product.table)
+ * ```
+ */
+declare function defineEntity<TName extends string, TFields extends Record<string, Field>>(definition: EntityDefinition<TFields> & {
+    name: TName;
+}): Entity<TName, TFields, Record<string, unknown>>;
+/**
+ * Create a reference field to another entity
+ */
+declare function ref(entity: string | {
+    name: string;
+}, options?: {
+    field?: string;
+    onDelete?: 'cascade' | 'set null' | 'restrict' | 'no action';
+    optional?: boolean;
+}): FieldDefinition;
+/**
+ * Create an enum field from a list of values
+ */
+declare function enumField<T extends string>(values: readonly T[], options?: {
+    default?: T;
+    optional?: boolean;
+}): FieldDefinition;
+/**
+ * Create a JSON field
+ */
+declare function jsonField<T = Record<string, unknown>>(options?: {
+    optional?: boolean;
+    default?: T;
+}): FieldDefinition;
+/**
+ * Create a decimal field with precision
+ */
+declare function decimal(precision: number, scale: number, options?: {
+    min?: number;
+    max?: number;
+    optional?: boolean;
+}): FieldDefinition;
+
+export { Entity, EntityDefinition, Field, FieldDefinition, decimal, defineEntity, enumField, jsonField, ref };

package/dist/index.js

@@ -0,0 +1,200 @@
+import { type } from 'arktype';
+export { type } from 'arktype';
+
+// src/define.ts
+function fieldToArkType(field) {
+  const def = typeof field === "string" ? { type: field } : field;
+  let typeStr = def.type;
+  if (def.min !== void 0 || def.max !== void 0) {
+    if (typeStr === "string" || typeStr.startsWith("string")) {
+      if (def.min !== void 0 && def.max !== void 0) {
+        typeStr = `string >= ${def.min} <= ${def.max}`;
+      } else if (def.min !== void 0) {
+        typeStr = `string >= ${def.min}`;
+      } else if (def.max !== void 0) {
+        typeStr = `string <= ${def.max}`;
+      }
+    } else if (typeStr === "number" || typeStr.startsWith("number")) {
+      const base = typeStr.includes(".integer") ? "number.integer" : "number";
+      if (def.min !== void 0 && def.max !== void 0) {
+        typeStr = `${base} >= ${def.min} <= ${def.max}`;
+      } else if (def.min !== void 0) {
+        typeStr = `${base} >= ${def.min}`;
+      } else if (def.max !== void 0) {
+        typeStr = `${base} <= ${def.max}`;
+      }
+    }
+  }
+  if (def.optional) {
+    typeStr = `${typeStr} | undefined`;
+  }
+  return typeStr;
+}
+function buildSchemaObject(definition, mode) {
+  const schema = {};
+  if (mode === "full") {
+    schema["id"] = "string.uuid";
+  }
+  if (definition.tenant) {
+    if (mode === "full" || mode === "create") {
+      schema["tenantId"] = "string.uuid";
+    }
+    if (mode === "query") {
+      schema["tenantId?"] = "string.uuid";
+    }
+  }
+  for (const [name, field] of Object.entries(definition.fields)) {
+    const def = typeof field === "string" ? { } : field;
+    if (mode === "update" || mode === "query") {
+      schema[`${name}?`] = fieldToArkType(field);
+    } else if (mode === "create") {
+      if (def.default !== void 0 || def.optional) {
+        schema[`${name}?`] = fieldToArkType(field);
+      } else {
+        schema[name] = fieldToArkType(field);
+      }
+    } else {
+      if (def.optional) {
+        schema[`${name}?`] = fieldToArkType(field);
+      } else {
+        schema[name] = fieldToArkType(field);
+      }
+    }
+  }
+  if (definition.timestamps) {
+    if (mode === "full") {
+      schema["insertedAt"] = "Date";
+      schema["updatedAt"] = "Date";
+    }
+    if (mode === "query") {
+      schema["insertedAt?"] = "Date";
+      schema["updatedAt?"] = "Date";
+      schema["insertedAfter?"] = "Date";
+      schema["insertedBefore?"] = "Date";
+    }
+  }
+  if (definition.softDelete) {
+    if (mode === "full") {
+      schema["deletedAt?"] = "Date";
+    }
+    if (mode === "query") {
+      schema["includeDeleted?"] = "boolean";
+    }
+  }
+  if (mode === "query") {
+    schema["limit?"] = "number.integer > 0";
+    schema["offset?"] = "number.integer >= 0";
+    schema["cursor?"] = "string";
+    schema["orderBy?"] = "string";
+    schema["orderDirection?"] = "'asc' | 'desc'";
+    schema["search?"] = "string";
+  }
+  return schema;
+}
+function defineEntity(definition) {
+  const fullSchemaObj = buildSchemaObject(definition, "full");
+  const createSchemaObj = buildSchemaObject(definition, "create");
+  const updateSchemaObj = buildSchemaObject(definition, "update");
+  const querySchemaObj = buildSchemaObject(definition, "query");
+  const schema = type(fullSchemaObj);
+  const createSchema = type(createSchemaObj);
+  const updateSchema = type(updateSchemaObj);
+  const querySchema = type(querySchemaObj);
+  const autoFields = ["id"];
+  if (definition.timestamps) {
+    autoFields.push("insertedAt", "updatedAt");
+  }
+  if (definition.softDelete) {
+    autoFields.push("deletedAt");
+  }
+  const requiredFields = [];
+  const optionalFields = [];
+  if (definition.tenant) {
+    requiredFields.push("tenantId");
+  }
+  for (const [name, field] of Object.entries(definition.fields)) {
+    const def = typeof field === "string" ? { } : field;
+    if (def.optional || def.default !== void 0) {
+      optionalFields.push(name);
+    } else {
+      requiredFields.push(name);
+    }
+  }
+  return {
+    name: definition.name,
+    definition,
+    schema,
+    createSchema,
+    updateSchema,
+    querySchema,
+    infer: {},
+    autoFields,
+    requiredFields,
+    optionalFields
+  };
+}
+function ref(entity, options) {
+  const entityName = typeof entity === "string" ? entity : entity.name;
+  const result = {
+    type: "string.uuid",
+    db: {
+      references: {
+        entity: entityName,
+        field: options?.field ?? "id",
+        onDelete: options?.onDelete ?? "restrict"
+      }
+    }
+  };
+  if (options?.optional !== void 0) {
+    result.optional = options.optional;
+  }
+  return result;
+}
+function enumField(values, options) {
+  const typeStr = values.map((v) => `'${v}'`).join(" | ");
+  const result = {
+    type: typeStr
+  };
+  if (options?.default !== void 0) {
+    result.default = options.default;
+  }
+  if (options?.optional !== void 0) {
+    result.optional = options.optional;
+  }
+  return result;
+}
+function jsonField(options) {
+  const result = {
+    type: "json"
+  };
+  if (options?.optional !== void 0) {
+    result.optional = options.optional;
+  }
+  if (options?.default !== void 0) {
+    result.default = options.default;
+  }
+  return result;
+}
+function decimal(precision, scale, options) {
+  const result = {
+    type: "number",
+    db: {
+      precision,
+      scale
+    }
+  };
+  if (options?.min !== void 0) {
+    result.min = options.min;
+  }
+  if (options?.max !== void 0) {
+    result.max = options.max;
+  }
+  if (options?.optional !== void 0) {
+    result.optional = options.optional;
+  }
+  return result;
+}
+
+export { decimal, defineEntity, enumField, jsonField, ref };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/define.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { type, type Type } from 'arktype'\nimport type {\n  EntityDefinition,\n  Field,\n  FieldDefinition,\n  Entity,\n} from './types.js'\n\n/**\n * Convert a field definition to an ArkType type string\n */\nfunction fieldToArkType(field: Field): string {\n  const def: FieldDefinition = typeof field === 'string'\n    ? { type: field }\n    : field\n\n  let typeStr = def.type\n\n  // Handle min/max constraints\n  if (def.min !== undefined || def.max !== undefined) {\n    if (typeStr === 'string' || typeStr.startsWith('string')) {\n      if (def.min !== undefined && def.max !== undefined) {\n        typeStr = `string >= ${def.min} <= ${def.max}`\n      } else if (def.min !== undefined) {\n        typeStr = `string >= ${def.min}`\n      } else if (def.max !== undefined) {\n        typeStr = `string <= ${def.max}`\n      }\n    } else if (typeStr === 'number' || typeStr.startsWith('number')) {\n      const base = typeStr.includes('.integer') ? 'number.integer' : 'number'\n      if (def.min !== undefined && def.max !== undefined) {\n        typeStr = `${base} >= ${def.min} <= ${def.max}`\n      } else if (def.min !== undefined) {\n        typeStr = `${base} >= ${def.min}`\n      } else if (def.max !== undefined) {\n        typeStr = `${base} <= ${def.max}`\n      }\n    }\n  }\n\n  // Handle optional fields\n  if (def.optional) {\n    // For optional fields, allow undefined or the type\n    typeStr = `${typeStr} | undefined`\n  }\n\n  return typeStr\n}\n\n/**\n * Build the full schema object for ArkType\n */\nfunction buildSchemaObject(\n  definition: EntityDefinition<Record<string, Field>>,\n  mode: 'full' | 'create' | 'update' | 'query'\n): Record<string, string> {\n  const schema: Record<string, string> = {}\n\n  // Add id field for full schema\n  if (mode === 'full') {\n    schema['id'] = 'string.uuid'\n  }\n\n  // Add tenantId if tenant-scoped\n  if (definition.tenant) {\n    if (mode === 'full' || mode === 'create') {\n      schema['tenantId'] = 'string.uuid'\n    }\n    if (mode === 'query') {\n      schema['tenantId?'] = 'string.uuid'\n    }\n  }\n\n  // Add user-defined fields\n  for (const [name, field] of Object.entries(definition.fields)) {\n    const def: FieldDefinition = typeof field === 'string'\n      ? { type: field }\n      : field\n\n    if (mode === 'update' || mode === 'query') {\n      // All fields optional for update/query\n      schema[`${name}?`] = fieldToArkType(field)\n    } else if (mode === 'create') {\n      // Skip fields with defaults or optional fields\n      if (def.default !== undefined || def.optional) {\n        schema[`${name}?`] = fieldToArkType(field)\n      } else {\n        schema[name] = fieldToArkType(field)\n      }\n    } else {\n      // Full schema\n      if (def.optional) {\n        schema[`${name}?`] = fieldToArkType(field)\n      } else {\n        schema[name] = fieldToArkType(field)\n      }\n    }\n  }\n\n  // Add timestamp fields\n  if (definition.timestamps) {\n    if (mode === 'full') {\n      schema['insertedAt'] = 'Date'\n      schema['updatedAt'] = 'Date'\n    }\n    if (mode === 'query') {\n      schema['insertedAt?'] = 'Date'\n      schema['updatedAt?'] = 'Date'\n      schema['insertedAfter?'] = 'Date'\n      schema['insertedBefore?'] = 'Date'\n    }\n  }\n\n  // Add soft delete field\n  if (definition.softDelete) {\n    if (mode === 'full') {\n      schema['deletedAt?'] = 'Date'\n    }\n    if (mode === 'query') {\n      schema['includeDeleted?'] = 'boolean'\n    }\n  }\n\n  // Add pagination for query\n  if (mode === 'query') {\n    schema['limit?'] = 'number.integer > 0'\n    schema['offset?'] = 'number.integer >= 0'\n    schema['cursor?'] = 'string'\n    schema['orderBy?'] = 'string'\n    schema['orderDirection?'] = \"'asc' | 'desc'\"\n    schema['search?'] = 'string'\n  }\n\n  return schema\n}\n\n/**\n * Define an entity with single-source schema generation\n *\n * @example\n * ```typescript\n * const Product = defineEntity({\n *   name: 'products',\n *   tenant: true,\n *   timestamps: true,\n *   softDelete: true,\n *   fields: {\n *     name: 'string >= 1',\n *     price: { type: 'number', min: 0 },\n *     status: \"'draft' | 'active' | 'archived'\",\n *   },\n *   indexes: [\n *     { fields: ['tenantId', 'status'] },\n *   ],\n * })\n *\n * // Use schemas\n * const validated = Product.createSchema(input)\n * const products = await db.select().from(Product.table)\n * ```\n */\nexport function defineEntity<\n  TName extends string,\n  TFields extends Record<string, Field>,\n>(\n  definition: EntityDefinition<TFields> & { name: TName }\n): Entity<TName, TFields, Record<string, unknown>> {\n  // Build schema objects\n  const fullSchemaObj = buildSchemaObject(definition, 'full')\n  const createSchemaObj = buildSchemaObject(definition, 'create')\n  const updateSchemaObj = buildSchemaObject(definition, 'update')\n  const querySchemaObj = buildSchemaObject(definition, 'query')\n\n  // Create ArkType schemas\n  const schema = type(fullSchemaObj as Record<string, string>)\n  const createSchema = type(createSchemaObj as Record<string, string>)\n  const updateSchema = type(updateSchemaObj as Record<string, string>)\n  const querySchema = type(querySchemaObj as Record<string, string>)\n\n  // Determine auto and required fields\n  const autoFields: string[] = ['id']\n  if (definition.timestamps) {\n    autoFields.push('insertedAt', 'updatedAt')\n  }\n  if (definition.softDelete) {\n    autoFields.push('deletedAt')\n  }\n\n  const requiredFields: string[] = []\n  const optionalFields: string[] = []\n\n  if (definition.tenant) {\n    requiredFields.push('tenantId')\n  }\n\n  for (const [name, field] of Object.entries(definition.fields)) {\n    const def: FieldDefinition = typeof field === 'string'\n      ? { type: field }\n      : field\n\n    if (def.optional || def.default !== undefined) {\n      optionalFields.push(name)\n    } else {\n      requiredFields.push(name)\n    }\n  }\n\n  return {\n    name: definition.name as TName,\n    definition,\n    schema: schema as Type<Record<string, unknown>>,\n    createSchema: createSchema as Type<Record<string, unknown>>,\n    updateSchema: updateSchema as Type<Record<string, unknown>>,\n    querySchema: querySchema as Type<Record<string, unknown>>,\n    infer: {} as Record<string, unknown>,\n    autoFields,\n    requiredFields,\n    optionalFields,\n  }\n}\n\n/**\n * Create a reference field to another entity\n */\nexport function ref(\n  entity: string | { name: string },\n  options?: {\n    field?: string\n    onDelete?: 'cascade' | 'set null' | 'restrict' | 'no action'\n    optional?: boolean\n  }\n): FieldDefinition {\n  const entityName = typeof entity === 'string' ? entity : entity.name\n  const result: FieldDefinition = {\n    type: 'string.uuid',\n    db: {\n      references: {\n        entity: entityName,\n        field: options?.field ?? 'id',\n        onDelete: options?.onDelete ?? 'restrict',\n      },\n    },\n  }\n  if (options?.optional !== undefined) {\n    result.optional = options.optional\n  }\n  return result\n}\n\n/**\n * Create an enum field from a list of values\n */\nexport function enumField<T extends string>(\n  values: readonly T[],\n  options?: { default?: T; optional?: boolean }\n): FieldDefinition {\n  const typeStr = values.map(v => `'${v}'`).join(' | ')\n  const result: FieldDefinition = {\n    type: typeStr as `'${string}'`,\n  }\n  if (options?.default !== undefined) {\n    result.default = options.default\n  }\n  if (options?.optional !== undefined) {\n    result.optional = options.optional\n  }\n  return result\n}\n\n/**\n * Create a JSON field\n */\nexport function jsonField<T = Record<string, unknown>>(\n  options?: { optional?: boolean; default?: T }\n): FieldDefinition {\n  const result: FieldDefinition = {\n    type: 'json',\n  }\n  if (options?.optional !== undefined) {\n    result.optional = options.optional\n  }\n  if (options?.default !== undefined) {\n    result.default = options.default\n  }\n  return result\n}\n\n/**\n * Create a decimal field with precision\n */\nexport function decimal(\n  precision: number,\n  scale: number,\n  options?: { min?: number; max?: number; optional?: boolean }\n): FieldDefinition {\n  const result: FieldDefinition = {\n    type: 'number',\n    db: {\n      precision,\n      scale,\n    },\n  }\n  if (options?.min !== undefined) {\n    result.min = options.min\n  }\n  if (options?.max !== undefined) {\n    result.max = options.max\n  }\n  if (options?.optional !== undefined) {\n    result.optional = options.optional\n  }\n  return result\n}\n"]}

package/dist/pg.d.ts

@@ -0,0 +1,15 @@
+import { a as Entity, F as Field } from './types-CmS0cBdC.js';
+import 'arktype';
+
+/**
+ * Generate a Drizzle pgTable from an entity definition
+ */
+declare function toPgTable<E extends Entity<string, Record<string, Field>, unknown>>(entity: E, tableRefs?: Record<string, any>): any;
+/**
+ * Create multiple tables with resolved references
+ */
+declare function createPgSchema<T extends Record<string, Entity<string, Record<string, Field>, unknown>>>(entities: T): {
+    [K in keyof T]: any;
+};
+
+export { createPgSchema, toPgTable, toPgTable as toTable };

package/dist/pg.js

@@ -0,0 +1,137 @@
+import { uuid, timestamp, pgTable, uniqueIndex, index, text, json, boolean, numeric, integer } from 'drizzle-orm/pg-core';
+import { sql } from 'drizzle-orm';
+
+// src/pg.ts
+function fieldToColumn(name, field) {
+  const def = typeof field === "string" ? { type: field } : field;
+  const columnName = def.db?.column ?? toSnakeCase(name);
+  let column;
+  const fieldType = def.type.split(" ")[0] ?? "string";
+  switch (fieldType) {
+    case "string.uuid":
+      column = uuid(columnName);
+      break;
+    case "string.email":
+    case "string.url":
+    case "string":
+      column = text(columnName);
+      break;
+    case "number.integer":
+      column = integer(columnName);
+      break;
+    case "number":
+      if (def.db?.precision) {
+        column = numeric(columnName, {
+          precision: def.db.precision,
+          scale: def.db.scale ?? 2
+        });
+      } else {
+        column = numeric(columnName);
+      }
+      break;
+    case "boolean":
+      column = boolean(columnName);
+      break;
+    case "Date":
+      column = timestamp(columnName, { withTimezone: true });
+      break;
+    case "json":
+      column = json(columnName);
+      break;
+    default:
+      column = text(columnName);
+  }
+  if (!def.optional && def.default === void 0) {
+    column = column.notNull();
+  }
+  if (def.default !== void 0) {
+    column = column.default(def.default);
+  }
+  return column;
+}
+function toSnakeCase(str) {
+  return str.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
+}
+function toPgTable(entity, tableRefs) {
+  const def = entity.definition;
+  const columns = {};
+  columns["id"] = uuid("id").primaryKey().defaultRandom();
+  if (def.tenant) {
+    const tenantsTable = tableRefs?.["tenants"];
+    if (tenantsTable) {
+      columns["tenantId"] = uuid("tenant_id").notNull().references(() => tenantsTable.id, { onDelete: "cascade" });
+    } else {
+      columns["tenantId"] = uuid("tenant_id").notNull();
+    }
+  }
+  for (const [name, field] of Object.entries(def.fields)) {
+    const fieldDef = typeof field === "string" ? { } : field;
+    if (fieldDef.db?.references && tableRefs) {
+      const refTable = tableRefs[fieldDef.db.references.entity];
+      if (refTable) {
+        const refField = fieldDef.db.references.field ?? "id";
+        const onDelete = fieldDef.db.references.onDelete ?? "restrict";
+        let col = uuid(toSnakeCase(name)).references(() => refTable[refField], { onDelete });
+        if (!fieldDef.optional) {
+          col = col.notNull();
+        }
+        columns[name] = col;
+      } else {
+        columns[name] = fieldToColumn(name, field);
+      }
+    } else {
+      columns[name] = fieldToColumn(name, field);
+    }
+  }
+  if (def.timestamps) {
+    columns["insertedAt"] = timestamp("inserted_at", { withTimezone: true }).notNull().defaultNow();
+    columns["updatedAt"] = timestamp("updated_at", { withTimezone: true }).notNull().defaultNow().$onUpdate(() => /* @__PURE__ */ new Date());
+  }
+  if (def.softDelete) {
+    columns["deletedAt"] = timestamp("deleted_at", { withTimezone: true });
+  }
+  return pgTable(def.name, columns, (t) => {
+    const indexes = {};
+    if (def.indexes) {
+      for (const idx of def.indexes) {
+        const idxName = idx.name ?? `${def.name}_${idx.fields.join("_")}_idx`;
+        const idxColumns = idx.fields.map((f) => t[f]).filter(Boolean);
+        if (idxColumns.length === 0) continue;
+        if (idx.unique) {
+          if (idx.where) {
+            indexes[idxName] = uniqueIndex(idxName).on(...idxColumns).where(sql.raw(idx.where));
+          } else {
+            indexes[idxName] = uniqueIndex(idxName).on(...idxColumns);
+          }
+        } else {
+          if (idx.where) {
+            indexes[idxName] = index(idxName).on(...idxColumns).where(sql.raw(idx.where));
+          } else {
+            indexes[idxName] = index(idxName).on(...idxColumns);
+          }
+        }
+      }
+    }
+    if (def.tenant && t.tenantId) {
+      const tenantIdxName = `${def.name}_tenant_id_idx`;
+      if (!indexes[tenantIdxName]) {
+        indexes[tenantIdxName] = index(tenantIdxName).on(t.tenantId);
+      }
+    }
+    return indexes;
+  });
+}
+function createPgSchema(entities) {
+  const tables = {};
+  for (const [key, entity] of Object.entries(entities)) {
+    tables[key] = toPgTable(entity);
+  }
+  for (const [key, entity] of Object.entries(entities)) {
+    tables[key] = toPgTable(entity, tables);
+  }
+  return tables;
+}
+
+export { createPgSchema, toPgTable, toPgTable as toTable };
+//# sourceMappingURL=pg.js.map
+//# sourceMappingURL=pg.js.map