d1-kyt 0.9.4 → 0.9.5

package/README.md

@@ -3,7 +3,7 @@
 Type-safe [Cloudflare D1](https://developers.cloudflare.com/d1/) toolkit built on [Kysely](https://kysely.dev/) and [Valibot](https://valibot.dev/). Define your schema once in Valibot — get SQL migrations and fully-typed queries with no code generation.
 
 ```typescript
-import { defineTable, InferDB, createQueryBuilder, queryAll, queryFirst, queryRun } from 'd1-kyt';
+import { defineTable, defineIndex, InferDB, createQueryBuilder, queryAll, queryFirst } from 'd1-kyt';
 import * as v from 'valibot';
 
 export const users = defineTable('users', {
@@ -18,9 +18,10 @@ export const posts = defineTable('posts', {
   authorId: v.pipe(v.number(), v.integer()),
 }, {
   foreignKeys: [{ columns: ['authorId'], references: users }],
-  indexes:     [{ columns: ['title'], unique: true }],
 });
 
+export const postsTitleIdx = defineIndex(posts, ['title'], { unique: true });
+
 export type DB = InferDB<{ users: typeof users; posts: typeof posts }>;
 export const db = createQueryBuilder<DB>();
 
@@ -127,7 +128,13 @@ export const posts = defineTable('posts', {
   title:      v.string(),
   categoryId: v.pipe(v.number(), v.integer()),
 }, {
-  foreignKeys: [{ columns: ['categoryId'], references: categories, onDelete: 'CASCADE' }],
+  foreignKeys: [{
+    columns:    ['categoryId'],
+    references: categories,
+    refColumns: ['id'],           // optional — defaults to the referenced table's PK
+    onDelete:   'CASCADE',        // CASCADE | SET NULL | RESTRICT | NO ACTION
+    onUpdate:   'NO ACTION',
+  }],
 });
 ```
 
@@ -141,6 +148,30 @@ deptId: v.optional(v.pipe(v.number(), v.integer()))  // ✓ nullable allows inli
 
 ---
 
+## Indexes
+
+```typescript
+// Basic unique index
+export const postsSlugIdx = defineIndex(posts, ['slug'], { unique: true });
+
+// Composite index
+export const postsAuthorViewsIdx = defineIndex(posts, ['authorId', 'views']);
+
+// Partial index — only indexes rows matching the WHERE clause
+export const postsPublishedIdx = defineIndex(posts, ['createdAt'], {
+  where: 'published = 1',
+});
+
+// Custom index name
+export const postsSearchIdx = defineIndex(posts, ['title'], {
+  name: 'posts_title_fts_idx',
+});
+```
+
+Columns are type-checked against the table definition at compile time.
+
+---
+
 ## CLI
 
 ```bash
@@ -197,7 +228,7 @@ await queryAll(env.DB, query, undefined, []);  // disable all checks
 | Export | Description |
 |--------|-------------|
 | `defineTable(name, columns, opts?)` | Define a table; returns `SchemaTable` with `$inferSelect` / `$inferInsert` |
-| `defineIndex(table, columns, opts?)` | Define an index (columns are type-checked) |
+| `defineIndex(table, columns, opts?)` | Define an index; columns are type-checked. `opts`: `unique`, `name`, `where` (partial index) |
 | `defineTrigger(name, opts)` | Define a custom trigger |
 | `InferDB<Tables>` | Infer a Kysely-compatible `DB` type |
 

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
-const VERSION = '0.9.4';
+const VERSION = '0.9.5';
 const HELP = `
 d1-kyt v${VERSION} - Opinionated Cloudflare D1 + Kysely toolkit
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "d1-kyt",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "Opinionated Cloudflare D1 + Kysely toolkit",
   "type": "module",
   "main": "dist/index.js",

package/skills/use-d1-kyt/SKILL.md

@@ -16,7 +16,7 @@ schema.ts  →  schema:diff  →  .sql migration  →  wrangler apply  →  type
 ## 1. Define Schema
 
 ```typescript
-import { defineTable } from 'd1-kyt';
+import { defineTable, defineIndex } from 'd1-kyt';
 import * as v from 'valibot';
 
 export const posts = defineTable(
@@ -33,10 +33,20 @@ export const posts = defineTable(
     categoryId: v.pipe(v.number(), v.integer()),
   },
   {
-    foreignKeys: [{ columns: ['categoryId'], references: categories, onDelete: 'CASCADE' }],
-    indexes: [{ columns: ['slug'], unique: true }],
+    foreignKeys: [{
+      columns:    ['categoryId'],
+      references: categories,
+      refColumns: ['id'],       // optional, defaults to referenced table's PK
+      onDelete:   'CASCADE',    // CASCADE | SET NULL | RESTRICT | NO ACTION
+      onUpdate:   'NO ACTION',  // same options
+    }],
   }
 );
+
+// Indexes are defined separately with defineIndex (NOT inside defineTable options)
+export const postsSlugIdx = defineIndex(posts, ['slug'], { unique: true });
+export const postsPublishedIdx = defineIndex(posts, ['views'], { where: 'published = 1' }); // partial index
+export const postsCustomIdx = defineIndex(posts, ['title'], { name: 'posts_title_search_idx' });
 ```
 
 **Column type mapping:**