@cinnabun/db 0.0.6 → 0.0.8

package/README.md

@@ -1,6 +1,6 @@
 # @cinnabun/db
 
-Database module for the Cinnabun framework with adapter pattern supporting Drizzle ORM and Prisma.
+Database module for the Cinnabun framework with adapter pattern supporting Drizzle ORM and Prisma. Spring Data-style repositories with constructor injection.
 
 ## Installation
 
@@ -39,12 +39,13 @@ export const users = sqliteTable("users", {
 
 ```typescript
 // src/main.ts
+import "reflect-metadata";
 import { CinnabunApp, CinnabunFactory } from "@cinnabun/core";
 import { DatabaseModule, DatabasePlugin } from "@cinnabun/db";
 
 @CinnabunApp({
   port: 3000,
-  scanPaths: [],
+  scanPaths: ["./src"],
   imports: [
     DatabaseModule.forRoot({
       adapter: "drizzle",
@@ -52,26 +53,32 @@ import { DatabaseModule, DatabasePlugin } from "@cinnabun/db";
       autoMigrate: true,
     }),
   ],
-  plugins: [DatabaseModule.createPlugin()],
+  plugins: [new DatabasePlugin()],
 })
 class App {}
 
 CinnabunFactory.run(App);
 ```
 
-### 3. Use repositories in controllers
+### 3. Use repositories
 
 **Option A: Spring Data-style (constructor injection)**
 
+Extend `CrudRepositoryBase` and use `@RepositoryEntity`. The framework provides the implementation at runtime.
+
 ```typescript
-import { RestController, GetMapping, PostMapping, Body, Service } from "@cinnabun/core";
-import { RepositoryEntity, CrudRepository } from "@cinnabun/db";
-import { users } from "./schema";
+// src/repositories/user.repository.ts
+import { RepositoryEntity, CrudRepositoryBase } from "@cinnabun/db";
+import { users } from "../schema";
 
 type User = typeof users.$inferSelect;
 
 @RepositoryEntity(users)
-abstract class UserRepository implements CrudRepository<User, number> {}
+abstract class UserRepository extends CrudRepositoryBase<User, number> {}
+
+// src/services/user.service.ts
+import { Service } from "@cinnabun/core";
+import { UserRepository } from "../repositories/user.repository.js";
 
 @Service()
 class UserService {
@@ -81,11 +88,19 @@ class UserService {
     return this.userRepo.findAll();
   }
 
+  async findById(id: number) {
+    return this.userRepo.findById(id);
+  }
+
   async create(data: { name: string; email: string }) {
     return this.userRepo.save(data);
   }
 }
 
+// src/controllers/user.controller.ts
+import { RestController, GetMapping, PostMapping, Body } from "@cinnabun/core";
+import { UserService } from "../services/user.service.js";
+
 @RestController("/api/users")
 class UserController {
   constructor(private readonly userService: UserService) {}
@@ -102,7 +117,14 @@ class UserController {
 }
 ```
 
-Register `UserRepository` and `UserService` in your module's `providers` array.
+Register `UserRepository` and `UserService` in your module's `providers` array. With `scanPaths: ["./src"]`, scanned modules will discover them automatically.
+
+**Prisma:** Use the model name string instead of a table schema:
+
+```typescript
+@RepositoryEntity("Todo")
+abstract class TodoCrudRepository extends CrudRepositoryBase<Todo, string> {}
+```
 
 **Option B: InjectRepository (property injection)**
 
@@ -134,11 +156,17 @@ class UserController {
 
 ## Transactions
 
-Use `@Transactional()` to wrap methods in database transactions:
+Use `@Transactional()` to wrap methods in database transactions. Inject `TransactionManager` and pass it to the decorator when using constructor-injected repositories:
 
 ```typescript
 import { Service } from "@cinnabun/core";
-import { Transactional, InjectRepository, Repository, RepositoryFactory, TransactionManager } from "@cinnabun/db";
+import {
+  Transactional,
+  InjectRepository,
+  Repository,
+  RepositoryFactory,
+  TransactionManager,
+} from "@cinnabun/db";
 import { users, profiles } from "./schema";
 
 @Service()
@@ -192,23 +220,15 @@ interface DatabaseModuleOptions {
 
 ## Repository API
 
-**CrudRepository** (Spring Data-style, use with `@RepositoryEntity`):
+**CrudRepositoryBase** (Spring Data-style) — extend this with `@RepositoryEntity`. Do not implement `CrudRepository` directly; TypeScript requires all methods to be implemented.
 
 ```typescript
-interface CrudRepository<T, ID> {
-  findById(id: ID): Promise<T | null>;
-  findAll(options?: QueryOptions): Promise<T[]>;
-  findOne(where: Partial<T>): Promise<T | null>;
-  findMany(where: Partial<T>, options?: QueryOptions): Promise<T[]>;
-  save(entity: Partial<T>): Promise<T>;
-  saveAll(entities: Partial<T>[]): Promise<T[]>;
-  deleteById(id: ID): Promise<void>;
-  delete(entity: T): Promise<void>;
-  existsById(id: ID): Promise<boolean>;
-  count(where?: Partial<T>): Promise<number>;
-}
+@RepositoryEntity(users)
+abstract class UserRepository extends CrudRepositoryBase<User, number> {}
 ```
 
+Methods: `findById`, `findAll`, `findOne`, `findMany`, `save`, `saveAll`, `deleteById`, `delete`, `existsById`, `count`.
+
 **Repository** (lower-level, use with `@InjectRepository`):
 
 ```typescript

package/dist/core/crud-repository-base.d.ts

@@ -0,0 +1,32 @@
+import type { CrudRepository, QueryOptions } from "../interfaces/repository.interface.js";
+/**
+ * Abstract base for Spring Data-style repositories.
+ * Extend this with @RepositoryEntity(entity) — the framework provides the implementation at runtime.
+ * Do not implement the interface directly; TypeScript requires all methods to be implemented.
+ *
+ * @example
+ * ```ts
+ * @RepositoryEntity(users)
+ * abstract class UserRepository extends CrudRepositoryBase<User, string> {}
+ *
+ * @Service()
+ * class UserService {
+ *   constructor(private readonly userRepo: UserRepository) {}
+ *   async getById(id: string) {
+ *     return this.userRepo.findById(id);
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class CrudRepositoryBase<T, ID = string | number> implements CrudRepository<T, ID> {
+    abstract findById(id: ID): Promise<T | null>;
+    abstract findAll(options?: QueryOptions): Promise<T[]>;
+    abstract findOne(where: Partial<T>): Promise<T | null>;
+    abstract findMany(where: Partial<T>, options?: QueryOptions): Promise<T[]>;
+    abstract save(entity: Partial<T>): Promise<T>;
+    abstract saveAll(entities: Partial<T>[]): Promise<T[]>;
+    abstract deleteById(id: ID): Promise<void>;
+    abstract delete(entity: T): Promise<void>;
+    abstract existsById(id: ID): Promise<boolean>;
+    abstract count(where?: Partial<T>): Promise<number>;
+}

package/dist/core/crud-repository-base.js

@@ -0,0 +1,22 @@
+/**
+ * Abstract base for Spring Data-style repositories.
+ * Extend this with @RepositoryEntity(entity) — the framework provides the implementation at runtime.
+ * Do not implement the interface directly; TypeScript requires all methods to be implemented.
+ *
+ * @example
+ * ```ts
+ * @RepositoryEntity(users)
+ * abstract class UserRepository extends CrudRepositoryBase<User, string> {}
+ *
+ * @Service()
+ * class UserService {
+ *   constructor(private readonly userRepo: UserRepository) {}
+ *   async getById(id: string) {
+ *     return this.userRepo.findById(id);
+ *   }
+ * }
+ * ```
+ */
+export class CrudRepositoryBase {
+}
+//# sourceMappingURL=crud-repository-base.js.map

package/dist/core/crud-repository-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud-repository-base.js","sourceRoot":"","sources":["../../src/core/crud-repository-base.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAgB,kBAAkB;CAavC"}

package/dist/core/database.module.d.ts

@@ -1,10 +1,9 @@
+import { type Constructor } from "@cinnabun/core";
 import type { DatabaseModuleOptions } from "../interfaces/options.interface.js";
 import type { DatabaseAdapter } from "../interfaces/database-adapter.interface.js";
 import { DatabasePlugin } from "./database.plugin.js";
 export declare class DatabaseModule {
-    static forRoot(options: DatabaseModuleOptions): {
-        new (): {};
-    };
+    static forRoot(options: DatabaseModuleOptions): Constructor;
     static getAdapter(): DatabaseAdapter;
     static getOptions(): DatabaseModuleOptions;
     static createPlugin(): DatabasePlugin;

package/dist/core/database.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"database.module.js","sourceRoot":"","sources":["../../src/core/database.module.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,IAAI,gBAAgB,GAA2B,IAAI,CAAC;AACpD,IAAI,cAAc,GAAiC,IAAI,CAAC;AAExD,MAAM,OAAO,cAAc;IAClB,AAAP,MAAM,CAAC,OAAO,CAAC,OAA8B;QAC3C,MAAM,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACtD,gBAAgB,GAAG,OAAO,CAAC;QAC3B,cAAc,GAAG,OAAO,CAAC;QAMzB,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;SAAG,CAAA;QAAxB,qBAAqB;YAJ1B,MAAM,CAAC;gBACN,SAAS,EAAE,EAAE;gBACb,OAAO,EAAE,EAAE;aACZ,CAAC;WACI,qBAAqB,CAAG;QAE9B,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,UAAU;QACf,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;QACJ,CAAC;QACD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,UAAU;QACf,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;QACJ,CAAC;QACD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,YAAY;QACjB,OAAO,IAAI,cAAc,EAAE,CAAC;IAC9B,CAAC;IAEO,MAAM,CAAC,aAAa,CAAC,OAA8B;QACzD,QAAQ,OAAO,CAAC,OAAO,EAAE,CAAC;YACxB,KAAK,SAAS;gBACZ,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;YACrC,KAAK,QAAQ;gBACX,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;YACpC;gBACE,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"database.module.js","sourceRoot":"","sources":["../../src/core/database.module.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,MAAM,EAAoB,MAAM,gBAAgB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,IAAI,gBAAgB,GAA2B,IAAI,CAAC;AACpD,IAAI,cAAc,GAAiC,IAAI,CAAC;AAExD,MAAM,OAAO,cAAc;IAClB,AAAP,MAAM,CAAC,OAAO,CAAC,OAA8B;QAC3C,MAAM,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACtD,gBAAgB,GAAG,OAAO,CAAC;QAC3B,cAAc,GAAG,OAAO,CAAC;QAMzB,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;SAAG,CAAA;QAAxB,qBAAqB;YAJ1B,MAAM,CAAC;gBACN,SAAS,EAAE,EAAE;gBACb,OAAO,EAAE,EAAE;aACZ,CAAC;WACI,qBAAqB,CAAG;QAE9B,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,UAAU;QACf,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;QACJ,CAAC;QACD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,UAAU;QACf,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;QACJ,CAAC;QACD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,YAAY;QACjB,OAAO,IAAI,cAAc,EAAE,CAAC;IAC9B,CAAC;IAEO,MAAM,CAAC,aAAa,CAAC,OAA8B;QACzD,QAAQ,OAAO,CAAC,OAAO,EAAE,CAAC;YACxB,KAAK,SAAS;gBACZ,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;YACrC,KAAK,QAAQ;gBACX,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;YACpC;gBACE,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;CACF"}

package/dist/decorators/repository.decorator.d.ts

@@ -1,11 +1,11 @@
 /**
  * Marks a class as a Spring Data-style repository bound to the given entity.
- * Use with an abstract class extending CrudRepository<T, ID> for constructor injection.
+ * Use with an abstract class extending CrudRepositoryBase<T, ID> for constructor injection.
  *
  * @example
  * ```ts
- * @Repository(users)
- * abstract class UserRepository implements CrudRepository<User, string> {}
+ * @RepositoryEntity(users)
+ * abstract class UserRepository extends CrudRepositoryBase<User, string> {}
  *
  * @Service()
  * class UserService {

package/dist/decorators/repository.decorator.js

@@ -1,12 +1,12 @@
 import { dbMetadataStorage } from "../metadata/db-storage.js";
 /**
  * Marks a class as a Spring Data-style repository bound to the given entity.
- * Use with an abstract class extending CrudRepository<T, ID> for constructor injection.
+ * Use with an abstract class extending CrudRepositoryBase<T, ID> for constructor injection.
  *
  * @example
  * ```ts
- * @Repository(users)
- * abstract class UserRepository implements CrudRepository<User, string> {}
+ * @RepositoryEntity(users)
+ * abstract class UserRepository extends CrudRepositoryBase<User, string> {}
  *
  * @Service()
  * class UserService {

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export { DrizzleRepository } from "./adapters/drizzle/drizzle-repository.js";
 export { PrismaAdapter } from "./adapters/prisma/prisma.adapter.js";
 export { PrismaRepository } from "./adapters/prisma/prisma-repository.js";
 export { DatabaseException, ConnectionException, MigrationException, TransactionException, RepositoryException, } from "./exceptions/database.exception.js";
+export { CrudRepositoryBase } from "./core/crud-repository-base.js";
 export { registerRepositoryResolvers } from "./core/repository-resolver.js";
 export { DATABASE_ADAPTER_TOKEN, DATABASE_OPTIONS_TOKEN } from "./constants.js";
 export { dbMetadataStorage } from "./metadata/db-storage.js";

package/dist/index.js

@@ -14,6 +14,8 @@ export { PrismaAdapter } from "./adapters/prisma/prisma.adapter.js";
 export { PrismaRepository } from "./adapters/prisma/prisma-repository.js";
 // Exceptions
 export { DatabaseException, ConnectionException, MigrationException, TransactionException, RepositoryException, } from "./exceptions/database.exception.js";
+// Repository base (extend this with @RepositoryEntity, do not implement CrudRepository directly)
+export { CrudRepositoryBase } from "./core/crud-repository-base.js";
 // Repository resolver (for DI integration)
 export { registerRepositoryResolvers } from "./core/repository-resolver.js";
 // Constants

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAWnE,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAGxE,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE1E,aAAa;AACb,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oCAAoC,CAAC;AAE5C,2CAA2C;AAC3C,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E,YAAY;AACZ,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEhF,WAAW;AACX,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAWnE,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAGxE,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE1E,aAAa;AACb,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oCAAoC,CAAC;AAE5C,iGAAiG;AACjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,2CAA2C;AAC3C,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E,YAAY;AACZ,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEhF,WAAW;AACX,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cinnabun/db",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Database module for Cinnabun with Drizzle and Prisma adapters",
   "type": "module",
   "main": "dist/index.js",