@prismakit/cli 3.2.0 → 3.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prismakit/cli",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "description": "CLI for PrismaKit — generate modules, validate compose, install agent skills",
   "license": "Apache-2.0",
   "engines": {
@@ -28,8 +28,15 @@
     "LICENSE",
     "README.md"
   ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist"
+  },
   "dependencies": {
-    "@prismakit/core": "3.2.0"
+    "@prismakit/core": "workspace:*"
   },
   "peerDependencies": {
     "@prismakit/core": ">=3.2.0 <4"
@@ -56,12 +63,5 @@
     "prismakit",
     "cursor",
     "skills"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "test": "vitest run",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "lint": "tsc -p tsconfig.json --noEmit",
-    "clean": "rm -rf dist"
-  }
-}
+  ]
+}

package/skills/prismakit/SKILL.md

@@ -64,7 +64,7 @@ Helpers may inject repositories — never the Prisma client.
 ## Create a repository (core)
 
 ```typescript
-import { Prisma, PrismaClient } from '@prisma/client';
+import { PrismaClient } from '@prisma/client';
 import { createRepository } from '@prismakit/core';
 import { RedisCacheAdapter } from '@prismakit/redis';
 
@@ -72,9 +72,8 @@ const DAY = 86_400;
 
 const UserRepoClass = createRepository({
   model: 'user',
-  scalarFields: Prisma.UserScalarFieldEnum,
   cache: { ttl: DAY, nullTtl: 60, sensitiveFields: ['password'] },
-  lock: true, // table + columns from Prisma meta
+  lock: true, // table + columns resolved from Prisma schema meta
 });
 
 const prisma = new PrismaClient();
@@ -84,14 +83,16 @@ export const users = new UserRepoClass({ prisma, cache });
 
 `defineRepository` and `createPrismaRepository` are aliases of `createRepository`.
 
+**NestJS apps:** use `createDefineRepo` / `defineAppRepo` with app-wide cache defaults instead — see skill `prismakit-nestjs`.
+
 | Option | Description |
 |--------|-------------|
 | `model` | Prisma client key (`prisma.user` → `'user'`). Needed for cache + compose. |
-| `scalarFields` | Usually `Prisma.XScalarFieldEnum`. Enables select-split + compose. Optional if DMMF/schema meta is loaded. |
-| `cache` | `CacheOptions` or `true` → `{ ttl: 86400, sensitiveFields: ['password'] }`. |
+| `scalarFields` | Usually `Prisma.XScalarFieldEnum`. **Optional** when `schemaPath` / DMMF meta is loaded (default since 3.1). |
+| `cache` | `CacheOptions` or `true` (uses app defaults when bound via `createDefineRepo`). |
 | `lock` | `true` / client key / `@@map` table / `{ tableName, columns }`. |
 | `primaryKey` | Override only. Defaults to schema `@id` / `@@id` (composite `string[]`) or `id`. |
-| `schemaPath` | Path to `schema.prisma` when meta is not loaded globally. |
+| `schemaPath` | Path to `schema.prisma` when meta is not loaded globally. Default: `prisma/schema.prisma`. |
 | `getDelegate` | Optional. Defaults to `(c) => c[model]`. |
 
 Put files under `**/repositories/**`. Keep Prisma client construction under `**/infrastructure/prisma/**`.

package/skills/prismakit-nestjs/SKILL.md

@@ -45,37 +45,65 @@ export class AppModule {}
 
 ## Factory (one default)
 
-Bind `Prisma.TypeMap` once, then define repos with runtime options only.
+Bind `Prisma.TypeMap` once with app-wide cache defaults, then define repos with per-model overrides only.
 
 ```typescript
-// src/infrastructure/prisma/define-repo.ts
+// src/infrastructure/prisma/define-app-repo.ts
 import { createDefineRepo } from '@prismakit/nestjs';
-import type { Prisma } from '@prisma/client';
+import type { Prisma } from '@prisma/client'; // or generated client path
 
-export const defineRepo = createDefineRepo<Prisma.TypeMap>();
+const DAY = 86_400;
+
+export const defineAppRepo = createDefineRepo<Prisma.TypeMap>({
+  cache: {
+    ttl: DAY,
+    nullTtl: 60,
+    defaultSetCache: true,
+  },
+});
 ```
 
 ```typescript
 // src/modules/users/repositories/user.repository.ts
-import { Prisma } from '@prisma/client';
-import { defineRepo } from '../../../infrastructure/prisma/define-repo';
+import { defineAppRepo } from 'src/infrastructure/prisma/define-app-repo';
 
-const DAY = 86_400;
-
-export class UserRepository extends defineRepo({
+export class UserRepository extends defineAppRepo({
   model: 'user',
-  scalarFields: Prisma.UserScalarFieldEnum,
-  cache: { ttl: DAY, nullTtl: 60, sensitiveFields: ['password'] },
-  lock: true,
+  cache: {
+    defaultSetCache: false,       // auth lookups pass setCache explicitly
+    sensitiveFields: ['password'],
+    methods: { getFirst: { enabled: false } },
+  },
+}) {}
+```
+
+```typescript
+// src/modules/category/repositories/category.repository.ts
+import { defineAppRepo } from 'src/infrastructure/prisma/define-app-repo';
+
+export class CategoryRepository extends defineAppRepo({
+  model: 'category',
+  cache: true, // inherits app-wide defaults (ttl, nullTtl, defaultSetCache)
 }) {}
 ```
 
+```typescript
+// Uncached repo — TypeScript omits setCache / invalidateCache
+import { defineAppRepo } from 'src/infrastructure/prisma/define-app-repo';
+
+export class AuditLogRepository extends defineAppRepo({
+  model: 'auditLog',
+}) {}
+```
+
+`scalarFields` is **optional** when `schemaPath` or DMMF meta is loaded (default since 3.1). Omit it in new repos.
+
 Escape hatches (do not use as the app default):
 
 - `defineInjectableRepository` from `@prismakit/nestjs` (package alias `defineRepository`) — phantoms + payload HKT when TypeMap is unavailable.
 - `createInjectableRepository` without a types bag — thin, results are `unknown`. Alias: `createPrismaRepository`.
 
-Do not import `defineRepo` from `@prismakit/nestjs` in apps that already bind `createDefineRepo` as `defineRepo`.
+Do not import `defineRepo` from `@prismakit/nestjs` in apps that already bind `createDefineRepo` as `defineAppRepo`.
 
 ## Register and inject