@lexmata/prisma-ent-generator 0.1.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,222 @@
+# prisma-ent-generator
+
+A [Prisma](https://www.prisma.io/) generator that produces a complete [Go Ent](https://entgo.io/) installation from your Prisma schema.
+
+Define your data model once in Prisma and generate fully working Ent schemas — including fields, edges, enums, and the `generate.go` / `entc.go` scaffolding needed to run `go generate`.
+
+## Features
+
+- **Full Ent install** — generates `generate.go`, `entc.go`, and `schema/*.go` so you can immediately run `go generate ./ent`
+- **Environment variable toggle** — controlled by `GENERATE_ENT`; skips when unset or `false`, runs when set to `true`
+- **Scalar type mapping** — `String`, `Int`, `BigInt`, `Float`, `Decimal`, `Boolean`, `DateTime`, `Json`, `Bytes`
+- **Enum support** — Prisma enums map to inline `field.Enum(...).Values(...)` with defaults
+- **Relationship edges** — O2O, O2M, and M2M relations are translated to `edge.To` / `edge.From` with correct ownership, `.Ref()`, `.Unique()`, and `.Required()`
+- **FK edge fields** — foreign key scalars are included in `Fields()` and bound to edges via `.Field()`
+- **Defaults** — `@default(now())`, `@default(uuid())`, `@default(autoincrement())`, `@default(false)`, `@default(0)`, `@default("value")`, and enum defaults
+- **@updatedAt** — maps to `.Default(time.Now).UpdateDefault(time.Now)`
+- **UUID IDs** — `@id @default(uuid())` generates `field.UUID("id", uuid.UUID{}).Default(uuid.New)`
+- **Optional / Nillable** — optional fields get `.Optional().Nillable()` (except JSON, which only gets `.Optional()`)
+
+## Installation
+
+```bash
+npm install @lexmata/prisma-ent-generator
+# or
+pnpm add @lexmata/prisma-ent-generator
+```
+
+## Usage
+
+### 1. Add the generator to your Prisma schema
+
+```prisma
+generator ent {
+  provider = "@lexmata/prisma-ent-generator"
+  output   = "./ent"
+}
+```
+
+### 2. Run Prisma generate with the environment variable
+
+```bash
+GENERATE_ENT=true npx prisma generate
+```
+
+Without `GENERATE_ENT=true`, the generator prints a skip message and produces no output:
+
+```
+prisma-ent-generator: Skipping — set GENERATE_ENT=true to enable.
+```
+
+### 3. Run Ent code generation
+
+```bash
+cd your-go-project
+go generate ./ent
+```
+
+This triggers Ent's own pipeline via the generated `generate.go`, producing the full client, queries, mutations, migrations, and predicates.
+
+## Output Structure
+
+```
+ent/
+├── generate.go          # go:generate directive for Ent codegen
+├── entc.go              # Ent codegen configuration (build-tag guarded)
+└── schema/
+    ├── user.go           # One file per Prisma model
+    ├── post.go
+    ├── profile.go
+    └── tag.go
+```
+
+`generate.go` and `entc.go` are only written if they don't already exist, so your customizations are preserved across re-runs. Schema files are always overwritten.
+
+## Example
+
+Given this Prisma schema:
+
+```prisma
+enum Role {
+  USER
+  ADMIN
+  MODERATOR
+}
+
+model User {
+  id        Int      @id @default(autoincrement())
+  email     String   @unique
+  name      String?
+  role      Role     @default(USER)
+  posts     Post[]
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+}
+
+model Post {
+  id       Int    @id @default(autoincrement())
+  title    String
+  author   User   @relation(fields: [authorId], references: [id])
+  authorId Int
+  tags     Tag[]
+}
+
+model Tag {
+  id    Int    @id @default(autoincrement())
+  name  String @unique
+  posts Post[]
+}
+```
+
+The generator produces:
+
+**`ent/schema/user.go`**
+
+```go
+package schema
+
+import (
+	"entgo.io/ent"
+	"entgo.io/ent/schema/field"
+	"entgo.io/ent/schema/edge"
+
+	"time"
+)
+
+type User struct {
+	ent.Schema
+}
+
+func (User) Fields() []ent.Field {
+	return []ent.Field{
+		field.String("email").Unique(),
+		field.String("name").Optional().Nillable(),
+		field.Enum("role").Values("USER", "ADMIN", "MODERATOR").Default("USER"),
+		field.Time("created_at").Default(time.Now),
+		field.Time("updated_at").Default(time.Now).UpdateDefault(time.Now),
+	}
+}
+
+func (User) Edges() []ent.Edge {
+	return []ent.Edge{
+		edge.To("posts", Post.Type),
+	}
+}
+```
+
+**`ent/schema/post.go`**
+
+```go
+package schema
+
+import (
+	"entgo.io/ent"
+	"entgo.io/ent/schema/field"
+	"entgo.io/ent/schema/edge"
+)
+
+type Post struct {
+	ent.Schema
+}
+
+func (Post) Fields() []ent.Field {
+	return []ent.Field{
+		field.String("title"),
+		field.Int("author_id"),
+	}
+}
+
+func (Post) Edges() []ent.Edge {
+	return []ent.Edge{
+		edge.From("author", User.Type).Ref("posts").Unique().Field("author_id").Required(),
+		edge.To("tags", Tag.Type),
+	}
+}
+```
+
+## Type Mapping
+
+| Prisma Type | Ent Field | Notes |
+|---|---|---|
+| `String` | `field.String` | |
+| `Boolean` | `field.Bool` | |
+| `Int` | `field.Int` | |
+| `BigInt` | `field.Int` | int64 in Go |
+| `Float` | `field.Float` | |
+| `Decimal` | `field.Float` | float64 in Go |
+| `DateTime` | `field.Time` | Imports `"time"` |
+| `Json` | `field.JSON` | Second arg: `map[string]interface{}{}` |
+| `Bytes` | `field.Bytes` | |
+| Enums | `field.Enum` | Inline `.Values(...)` |
+
+## Edge Mapping
+
+| Prisma Relation | Ent Edge |
+|---|---|
+| O2O (owner side) | `edge.To("name", Type.Type).Unique()` |
+| O2O (FK side) | `edge.From("name", Type.Type).Ref("...").Unique().Field("fk")` |
+| O2M (owner side) | `edge.To("name", Type.Type)` |
+| O2M (FK side) | `edge.From("name", Type.Type).Ref("...").Unique().Field("fk")` |
+| M2M (owner side) | `edge.To("name", Type.Type)` |
+| M2M (inverse side) | `edge.From("name", Type.Type).Ref("...")` |
+
+M2M ownership is determined alphabetically by model name when neither side holds a FK.
+
+## Development
+
+```bash
+pnpm install
+pnpm build
+pnpm test
+```
+
+To test generation locally:
+
+```bash
+pnpm build
+GENERATE_ENT=true npx prisma generate --schema=prisma/schema.prisma
+```
+
+## License
+
+MIT - [Lexmata LLC](mailto:jquinn@lexmata.ai)

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

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

package/dist/bin.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const generator_helper_1 = require("@prisma/generator-helper");
+const generator_1 = require("./generator");
+(0, generator_helper_1.generatorHandler)({
+    onManifest() {
+        return {
+            prettyName: 'Prisma Ent Generator',
+            defaultOutput: './ent',
+        };
+    },
+    onGenerate: generator_1.generate,
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";;;AACA,+DAA4D;AAC5D,2CAAuC;AAEvC,IAAA,mCAAgB,EAAC;IACf,UAAU;QACR,OAAO;YACL,UAAU,EAAE,sBAAsB;YAClC,aAAa,EAAE,OAAO;SACvB,CAAC;IACJ,CAAC;IACD,UAAU,EAAE,oBAAQ;CACrB,CAAC,CAAC"}

package/dist/generator.d.ts

@@ -0,0 +1,21 @@
+import type { GeneratorOptions } from '@prisma/generator-helper';
+/**
+ * Check whether the generator is enabled via the GENERATE_ENT environment variable.
+ * Defaults to disabled if the variable is absent or not set to "true".
+ */
+export declare function isEnabled(): boolean;
+/**
+ * Main generator function — receives the full Prisma DMMF and generator config,
+ * then writes a complete Go Ent installation to the output directory.
+ *
+ * Output structure:
+ *   <outputDir>/
+ *     generate.go          — go:generate directive to run ent codegen
+ *     entc.go              — ent codegen configuration (build-tag guarded)
+ *     schema/
+ *       user.go            — one schema file per Prisma model
+ *       post.go
+ *       ...
+ */
+export declare function generate(options: GeneratorOptions): Promise<void>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAQ,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAWvE;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuDvE"}

package/dist/generator.js

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEnabled = isEnabled;
+exports.generate = generate;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const schema_1 = require("./helpers/schema");
+const entfiles_1 = require("./helpers/entfiles");
+const utils_1 = require("./utils");
+/**
+ * The environment variable that controls whether the generator runs.
+ * Set to "true" to enable generation; any other value or absence disables it.
+ */
+const ENV_VAR = 'GENERATE_ENT';
+/**
+ * Check whether the generator is enabled via the GENERATE_ENT environment variable.
+ * Defaults to disabled if the variable is absent or not set to "true".
+ */
+function isEnabled() {
+    return process.env[ENV_VAR]?.toLowerCase() === 'true';
+}
+/**
+ * Main generator function — receives the full Prisma DMMF and generator config,
+ * then writes a complete Go Ent installation to the output directory.
+ *
+ * Output structure:
+ *   <outputDir>/
+ *     generate.go          — go:generate directive to run ent codegen
+ *     entc.go              — ent codegen configuration (build-tag guarded)
+ *     schema/
+ *       user.go            — one schema file per Prisma model
+ *       post.go
+ *       ...
+ */
+async function generate(options) {
+    if (!isEnabled()) {
+        console.log(`prisma-ent-generator: Skipping — set ${ENV_VAR}=true to enable.`);
+        return;
+    }
+    const outputDir = options.generator.output?.value;
+    if (!outputDir) {
+        throw new Error('No output directory specified for prisma-ent-generator');
+    }
+    // The output dir is the ent root (e.g. ./ent).
+    // Schema files go into <outputDir>/schema/
+    const schemaDir = path_1.default.join(outputDir, 'schema');
+    fs_1.default.mkdirSync(schemaDir, { recursive: true });
+    const { datamodel } = options.dmmf;
+    const models = [...datamodel.models];
+    const enums = [...datamodel.enums];
+    // Build enum lookup map
+    const enumDefs = new Map();
+    for (const e of enums) {
+        enumDefs.set(e.name, e);
+    }
+    // --- generate.go (go:generate directive) ---
+    const generateGoPath = path_1.default.join(outputDir, 'generate.go');
+    if (!fs_1.default.existsSync(generateGoPath)) {
+        fs_1.default.writeFileSync(generateGoPath, (0, entfiles_1.generateGenerateGo)(), 'utf-8');
+    }
+    // --- entc.go (ent codegen config, build-tag guarded) ---
+    const entcGoPath = path_1.default.join(outputDir, 'entc.go');
+    if (!fs_1.default.existsSync(entcGoPath)) {
+        fs_1.default.writeFileSync(entcGoPath, (0, entfiles_1.generateEntcGo)(), 'utf-8');
+    }
+    // --- schema/*.go (one per Prisma model, always overwritten) ---
+    for (const model of models) {
+        const content = (0, schema_1.generateSchema)(model, models, enumDefs);
+        const fileName = (0, utils_1.modelToFileName)(model.name);
+        const filePath = path_1.default.join(schemaDir, `${fileName}.go`);
+        fs_1.default.writeFileSync(filePath, content, 'utf-8');
+    }
+    const modelNames = models.map((m) => m.name).join(', ');
+    console.log(`prisma-ent-generator: Generated ${models.length} schema(s) → ${schemaDir} [${modelNames}]`);
+    console.log(`prisma-ent-generator: Ent root → ${outputDir} (generate.go, entc.go)`);
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

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

package/dist/helpers/edge.d.ts

@@ -0,0 +1,25 @@
+import type { DMMF } from '@prisma/generator-helper';
+import type { GoImports } from './type-map';
+/**
+ * Information about a generated Ent edge.
+ */
+export interface EdgeDef {
+    /** The full Go code for the edge definition (e.g., `edge.To("posts", Post.Type)`). */
+    code: string;
+}
+/**
+ * Generate the Ent edge definition lines for a given model.
+ *
+ * Analyses all relation (object) fields on the model, determines edge ownership
+ * (edge.To vs edge.From) based on FK presence, and generates the correct Ent
+ * edge builder calls.
+ *
+ * Ownership rules:
+ * - Model with FK fields (relationFromFields non-empty) → edge.From (back-reference)
+ * - Model without FK fields, but inverse has FK → edge.To (owns the relation)
+ * - Neither side has FK (M2M implicit join table) → alphabetical model name tiebreaker
+ *
+ * @returns An array of Go code strings, each representing one edge definition.
+ */
+export declare function generateEdges(model: DMMF.Model, allModels: readonly DMMF.Model[], imports: GoImports): string[];
+//# sourceMappingURL=edge.d.ts.map

package/dist/helpers/edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.d.ts","sourceRoot":"","sources":["../../src/helpers/edge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,IAAI,CAAC,KAAK,EACjB,SAAS,EAAE,SAAS,IAAI,CAAC,KAAK,EAAE,EAChC,OAAO,EAAE,SAAS,GACjB,MAAM,EAAE,CAcV"}

package/dist/helpers/edge.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateEdges = generateEdges;
+const utils_1 = require("../utils");
+/**
+ * Generate the Ent edge definition lines for a given model.
+ *
+ * Analyses all relation (object) fields on the model, determines edge ownership
+ * (edge.To vs edge.From) based on FK presence, and generates the correct Ent
+ * edge builder calls.
+ *
+ * Ownership rules:
+ * - Model with FK fields (relationFromFields non-empty) → edge.From (back-reference)
+ * - Model without FK fields, but inverse has FK → edge.To (owns the relation)
+ * - Neither side has FK (M2M implicit join table) → alphabetical model name tiebreaker
+ *
+ * @returns An array of Go code strings, each representing one edge definition.
+ */
+function generateEdges(model, allModels, imports) {
+    const edges = [];
+    for (const field of model.fields) {
+        if (field.kind !== 'object')
+            continue;
+        const edge = generateEdge(field, model, allModels);
+        if (edge) {
+            imports.edge = true;
+            edges.push(edge);
+        }
+    }
+    return edges;
+}
+/**
+ * Generate a single Ent edge definition from a Prisma relation field.
+ */
+function generateEdge(field, currentModel, allModels) {
+    const targetModelName = field.type;
+    const targetModel = allModels.find((m) => m.name === targetModelName);
+    if (!targetModel)
+        return null;
+    // Find the inverse relation field on the target model
+    const inverseField = targetModel.fields.find((f) => f.kind === 'object' && f.relationName === field.relationName);
+    const hasFK = field.relationFromFields !== undefined && field.relationFromFields.length > 0;
+    const inverseHasFK = inverseField?.relationFromFields !== undefined &&
+        inverseField.relationFromFields.length > 0;
+    const edgeName = (0, utils_1.toSnakeCase)(field.name);
+    if (hasFK) {
+        // This model holds the FK → edge.From (back-reference)
+        return buildEdgeFrom(field, edgeName, targetModelName, inverseField);
+    }
+    if (inverseHasFK) {
+        // Other model holds the FK → edge.To (this model owns)
+        return buildEdgeTo(field, edgeName, targetModelName);
+    }
+    // Neither side has FK — M2M implicit or O2O bidirectional
+    return buildImplicitEdge(field, edgeName, targetModelName, currentModel.name, inverseField);
+}
+/**
+ * Build an edge.From definition (this model holds the FK).
+ */
+function buildEdgeFrom(field, edgeName, targetModelName, inverseField) {
+    const refName = inverseField ? (0, utils_1.toSnakeCase)(inverseField.name) : (0, utils_1.toSnakeCase)(targetModelName);
+    const parts = [];
+    parts.push(`edge.From("${edgeName}", ${targetModelName}.Type)`);
+    parts.push(`.Ref("${refName}")`);
+    parts.push('.Unique()');
+    // Bind the FK field to this edge
+    if (field.relationFromFields && field.relationFromFields.length > 0) {
+        const fkFieldName = (0, utils_1.toSnakeCase)(field.relationFromFields[0]);
+        parts.push(`.Field("${fkFieldName}")`);
+    }
+    if (field.isRequired) {
+        parts.push('.Required()');
+    }
+    return parts.join('');
+}
+/**
+ * Build an edge.To definition (this model owns the relation).
+ */
+function buildEdgeTo(field, edgeName, targetModelName) {
+    const parts = [];
+    parts.push(`edge.To("${edgeName}", ${targetModelName}.Type)`);
+    if (!field.isList) {
+        parts.push('.Unique()');
+    }
+    return parts.join('');
+}
+/**
+ * Build an edge for an implicit M2M or bidirectional relation
+ * where neither side holds a FK.
+ *
+ * Uses alphabetical model name ordering to determine ownership:
+ * - Model with earlier name → edge.To (owner)
+ * - Model with later name → edge.From (back-reference)
+ *
+ * For self-referential relations on the same model, the field that appears
+ * first (alphabetically by field name) becomes edge.To.
+ */
+function buildImplicitEdge(field, edgeName, targetModelName, currentModelName, inverseField) {
+    const isSelfRef = currentModelName === targetModelName;
+    let isOwner;
+    if (isSelfRef) {
+        // Self-referential: use field name ordering
+        isOwner = field.name <= (inverseField?.name ?? field.name);
+    }
+    else {
+        // Cross-model: use model name ordering
+        isOwner = currentModelName <= targetModelName;
+    }
+    if (isOwner) {
+        return buildEdgeTo(field, edgeName, targetModelName);
+    }
+    // Back-reference
+    const refName = inverseField ? (0, utils_1.toSnakeCase)(inverseField.name) : (0, utils_1.toSnakeCase)(targetModelName);
+    const parts = [];
+    parts.push(`edge.From("${edgeName}", ${targetModelName}.Type)`);
+    parts.push(`.Ref("${refName}")`);
+    if (!field.isList) {
+        parts.push('.Unique()');
+    }
+    return parts.join('');
+}
+//# sourceMappingURL=edge.js.map

package/dist/helpers/edge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.js","sourceRoot":"","sources":["../../src/helpers/edge.ts"],"names":[],"mappings":"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"}

package/dist/helpers/entfiles.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Generate the contents of `generate.go` — the standard Ent entry point
+ * that enables `go generate ./ent` to trigger Ent's own code generation.
+ *
+ * This file is placed in the ent root directory (e.g. `./ent/generate.go`).
+ */
+export declare function generateGenerateGo(): string;
+/**
+ * Generate the contents of `entc.go` — the Ent codegen configuration file.
+ *
+ * This file is guarded by the `ignore` build tag so it is only executed
+ * during code generation (via `go generate`) and not during normal builds.
+ *
+ * Users can customise this file to add features, hooks, or extensions
+ * to the Ent code generation pipeline.
+ */
+export declare function generateEntcGo(): string;
+//# sourceMappingURL=entfiles.d.ts.map

package/dist/helpers/entfiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entfiles.d.ts","sourceRoot":"","sources":["../../src/helpers/entfiles.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAU3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAwBvC"}

package/dist/helpers/entfiles.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateGenerateGo = generateGenerateGo;
+exports.generateEntcGo = generateEntcGo;
+const utils_1 = require("../utils");
+/**
+ * Generate the contents of `generate.go` — the standard Ent entry point
+ * that enables `go generate ./ent` to trigger Ent's own code generation.
+ *
+ * This file is placed in the ent root directory (e.g. `./ent/generate.go`).
+ */
+function generateGenerateGo() {
+    const lines = [];
+    lines.push((0, utils_1.fileHeader)());
+    lines.push('package ent');
+    lines.push('');
+    lines.push('//go:generate go run -mod=mod entgo.io/ent/cmd/ent generate ./schema');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Generate the contents of `entc.go` — the Ent codegen configuration file.
+ *
+ * This file is guarded by the `ignore` build tag so it is only executed
+ * during code generation (via `go generate`) and not during normal builds.
+ *
+ * Users can customise this file to add features, hooks, or extensions
+ * to the Ent code generation pipeline.
+ */
+function generateEntcGo() {
+    const lines = [];
+    lines.push((0, utils_1.fileHeader)());
+    lines.push('//go:build ignore');
+    lines.push('');
+    lines.push('package main');
+    lines.push('');
+    lines.push('import (');
+    lines.push('\t"log"');
+    lines.push('');
+    lines.push('\t"entgo.io/ent/entc"');
+    lines.push('\t"entgo.io/ent/entc/gen"');
+    lines.push(')');
+    lines.push('');
+    lines.push('func main() {');
+    lines.push('\terr := entc.Generate("./schema", &gen.Config{})');
+    lines.push('\tif err != nil {');
+    lines.push('\t\tlog.Fatalf("running ent codegen: %v", err)');
+    lines.push('\t}');
+    lines.push('}');
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=entfiles.js.map

package/dist/helpers/entfiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entfiles.js","sourceRoot":"","sources":["../../src/helpers/entfiles.ts"],"names":[],"mappings":";;AAQA,gDAUC;AAWD,wCAwBC;AArDD,oCAAsC;AAEtC;;;;;GAKG;AACH,SAAgB,kBAAkB;IAChC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,IAAA,kBAAU,GAAE,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;IACnF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,cAAc;IAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,IAAA,kBAAU,GAAE,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/helpers/field.d.ts

@@ -0,0 +1,19 @@
+import type { DMMF } from '@prisma/generator-helper';
+import { type GoImports } from './type-map';
+/**
+ * Determine the set of field names that serve as foreign keys for relations.
+ * These are the scalar fields referenced in `relationFromFields` of relation fields.
+ */
+export declare function collectFKFieldNames(fields: readonly DMMF.Field[]): Set<string>;
+/**
+ * Generate the Ent field definition lines for a Prisma model.
+ *
+ * - Skips relation (object) fields — those become edges.
+ * - Includes FK scalar fields so they can be bound to edges via `.Field()`.
+ * - Handles ID fields: skips default Int autoincrement IDs (Ent default),
+ *   but generates UUID ID fields when needed.
+ *
+ * @returns An array of Go code strings, each representing one `field.X(...)` call.
+ */
+export declare function generateFields(fields: readonly DMMF.Field[], fkFieldNames: Set<string>, enumDefs: Map<string, DMMF.DatamodelEnum>, imports: GoImports): string[];
+//# sourceMappingURL=field.d.ts.map

package/dist/helpers/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/helpers/field.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAA0C,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAGpF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAU9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,IAAI,CAAC,KAAK,EAAE,EAC7B,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,EACzC,OAAO,EAAE,SAAS,GACjB,MAAM,EAAE,CAcV"}