peta-orm 0.2.1 → 0.2.3

package/README.md

@@ -23,6 +23,7 @@ bun add -d kysely-bun-sqlite
 // db.ts
 import { Database } from "bun:sqlite"
 import { BunSqliteDialect } from "kysely-bun-sqlite"
+import type { ColumnShape } from "peta-orm"
 import { Peta, $t, ArkTypeSchemaConfig, Model, HasMany } from "peta-orm"
 
 const t = $t({ schema: new ArkTypeSchemaConfig() })
@@ -32,8 +33,8 @@ class User extends Model {
   static override columns = {
     id: t.integer().primaryKey(),
     name: t.string(255).min(2),
-    email: t.text().email(),
-  }
+    email: t.text().email().unique(),
+  } satisfies ColumnShape
   static override relations = {
     posts: new HasMany(() => Post),
   }
@@ -43,9 +44,9 @@ class Post extends Model {
   static override table = "posts"
   static override columns = {
     id: t.integer().primaryKey(),
-    userId: t.integer(),
+    userId: t.integer().references(() => User, ["id"]),
     title: t.string(255),
-  }
+  } satisfies ColumnShape
 }
 
 const database = new Database("my-app.db")
@@ -88,18 +89,30 @@ export { peta, User, Post }
 ### Column Types & Validation
 
 ```ts
+import type { ColumnShape } from "peta-orm"
+
 const t = $t({ schema: new ArkTypeSchemaConfig() })
 
 class User extends Model {
   static override columns = {
     id: t.integer().primaryKey(),
     name: t.string(255).min(2),          // min length
-    email: t.text().email(),             // email format
+    email: t.text().email().unique(),    // email format + unique constraint
     age: t.integer().nullable().min(0).max(150).default(0),
     role: t.enum("admin", "user").default("user"),
     score: t.double().nullable(),
     ...t.timestamps(),                   // createdAt, updatedAt
-  }
+  } satisfies ColumnShape
+}
+
+class Post extends Model {
+  static override columns = {
+    id: t.integer().primaryKey(),
+    userId: t.integer().references(() => User, ["id"]),  // foreign key
+    title: t.string(255),
+    slug: t.string().unique(),
+    published: t.boolean().default(false),
+  } satisfies ColumnShape
 }
 ```
 
@@ -132,6 +145,36 @@ const authors = await User.query().has("posts").execute()
 const active = await User.query().whereHas("posts", (q) => q.where("published", true)).execute()
 ```
 
+### ManyToMany
+
+```ts
+class Post extends Model {
+  static override columns = { id: t.integer().primaryKey(), title: t.string(255) } satisfies ColumnShape
+  static override relations = {
+    tags: new ManyToMany(() => Tag, {
+      through: "post_tags",
+      foreignPivotKey: "postId",
+      relatedPivotKey: "tagId",
+    }),
+  }
+}
+
+class Tag extends Model {
+  static override columns = { id: t.integer().primaryKey(), name: t.string(255) } satisfies ColumnShape
+}
+
+// Pivot tables are regular Models — register them so the migration
+// generator includes the pivot table automatically.
+class PostTag extends Model {
+  static override table = "post_tags"
+  static override columns = {
+    id: t.integer().primaryKey(),
+    postId: t.integer().references(() => Post, ["id"]),
+    tagId: t.integer().references(() => Tag, ["id"]),
+  } satisfies ColumnShape
+}
+```
+
 ### CRUD & Pagination
 
 ```ts

package/dist/{index-m8r7jkr4.js → index-zth6eamb.js}

@@ -2159,6 +2159,15 @@ ${downTables.join(`
     if (col.isUnique && !col.isPrimaryKey) {
       calls.push("unique()");
     }
+    const refConstraint = col.constraints.find((c) => c.type === "references");
+    if (refConstraint?.args[0]) {
+      const targetClass = typeof refConstraint.args[0] === "function" ? refConstraint.args[0]() : refConstraint.args[0];
+      const targetTable = targetClass?.table;
+      const targetColumns = refConstraint.args[1];
+      if (typeof targetTable === "string" && targetTable && targetColumns?.length) {
+        calls.push(`references("${targetTable}.${targetColumns[0]}")`);
+      }
+    }
     if (calls.length === 0)
       return "";
     const str = calls.join(".");

package/dist/migrations/cli.js

@@ -4,7 +4,7 @@ import {
   MigrationRunner,
   loadConfig,
   loadMigrationFiles
-} from "../index-m8r7jkr4.js";
+} from "../index-zth6eamb.js";
 import"../index-qwps5bne.js";
 import {
   __export

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

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/migrations/generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,kBAAkB;;IAC7B,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM;CA0HlG"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/migrations/generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,kBAAkB;;IAC7B,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM;CAqIlG"}

package/dist/migrations/index.js

@@ -5,7 +5,7 @@ import {
   defineConfig,
   loadConfig,
   loadMigrationFiles
-} from "../index-m8r7jkr4.js";
+} from "../index-zth6eamb.js";
 import"../index-qwps5bne.js";
 import"../index-k18nf2r7.js";
 export {

package/package.json

@@ -2,7 +2,7 @@
   "name": "peta-orm",
   "type": "module",
   "private": false,
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "ORM for Bun, built on Kysely",
   "license": "MIT",
   "module": "src/index.ts",