@palbase/backend 25.0.4 → 25.1.0

package/dist/engine/index.js

@@ -16,7 +16,7 @@ import {
   quoteIdent,
   scrubSecrets,
   withTables
-} from "../chunk-AILPKEK5.js";
+} from "../chunk-VDF2T4AS.js";
 import "../chunk-CRQKCRGF.js";
 import "../chunk-XABBC7JP.js";
 import "../chunk-CJSKYY76.js";

package/docs/README.md

@@ -133,8 +133,9 @@ export class TodoService {
 
 /** The wired instance. Controllers import THIS, never the class. It is also the
  * ONLY supported way to hold a dependency: a controller, job, hook or webhook is
- * constructed with no arguments, and one that declares a constructor parameter
- * is refused at build with the class named. */
+ * constructed with no arguments, and one that declares a constructor parameter is
+ * refused with the class named — at decoration time for jobs/hooks/webhooks, and
+ * when the route table is built at boot for a controller. */
 export const todoService = new TodoService(Database.tables.todos);
 ```
 
@@ -150,7 +151,7 @@ import { CreateTodoBody } from "../models/todos/create.js";
 export default class TodosController {
   // The service arrives as an IMPORTED SINGLETON, not a constructor parameter:
   // the runtime constructs this class with no arguments, and one that declares a
-  // parameter is refused at build with the class named.
+  // parameter is refused when the route table is built at boot, with the class named.
 
   @Get("")                                             // GET /todos → operationId todos.list
   async list(@User() user: UserT): Promise<TodoSchema[]> {  // return type → 200 response schema

package/docs/llms-full.txt

@@ -141,8 +141,9 @@ export class TodoService {
 
 /** The wired instance. Controllers import THIS, never the class. It is also the
  * ONLY supported way to hold a dependency: a controller, job, hook or webhook is
- * constructed with no arguments, and one that declares a constructor parameter
- * is refused at build with the class named. */
+ * constructed with no arguments, and one that declares a constructor parameter is
+ * refused with the class named — at decoration time for jobs/hooks/webhooks, and
+ * when the route table is built at boot for a controller. */
 export const todoService = new TodoService(Database.tables.todos);
 ```
 
@@ -158,7 +159,7 @@ import { CreateTodoBody } from "../models/todos/create.js";
 export default class TodosController {
   // The service arrives as an IMPORTED SINGLETON, not a constructor parameter:
   // the runtime constructs this class with no arguments, and one that declares a
-  // parameter is refused at build with the class named.
+  // parameter is refused when the route table is built at boot, with the class named.
 
   @Get("")                                             // GET /todos → operationId todos.list
   async list(@User() user: UserT): Promise<TodoSchema[]> {  // return type → 200 response schema

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@palbase/backend",
-  "version": "25.0.4",
+  "version": "25.1.0",
   "description": "Palbase Backend SDK — class controllers (@Controller/@Get/@Post + @Body/@QueryParams/@Param), error classes, schema DSL",
   "license": "MIT",
   "repository": {

package/template/AGENTS.md

@@ -58,7 +58,9 @@ wrong in this runtime:
 - **A DI container, or injection via decorators** — the only supported way to hold
   a dependency is a module-level singleton. A controller, job, hook or webhook is
   constructed with **no arguments**; one that declares a constructor parameter is
-  refused at build with the class named.
+  refused with the class named — at decoration time for `jobs/`, `hooks/` and
+  `webhooks/`, and when the route table is built at boot for a controller. The
+  release never serves either way.
 - **`middleware/`** — nothing mounts it and the engine has no middleware pipeline.
   Code written against it deploys, never runs, and nothing reports it. Put
   cross-cutting work in a service; use route options for auth and rate limits.

package/template/controllers/notes.controller.ts

@@ -18,8 +18,8 @@ import { noteService } from "../services/note.service";
 //
 // The dependency is a MODULE-LEVEL SINGLETON, imported. It is not a constructor
 // parameter: the runtime constructs this class with no arguments, and a
-// controller that declares one is refused at build with the class named rather
-// than handed `undefined` in production.
+// controller that declares one is refused when the route table is built at boot,
+// with the class named — rather than handed `undefined` in production.
 
 // The schemas are in `models/notes/create.ts`. A controller with one endpoint
 // can keep them beside the routes; the moment there are two, they go to

package/template/services/note.service.ts

@@ -16,9 +16,11 @@ import type { Tables } from "@palbase/backend/env";
 // is what a controller imports. That module-level singleton is also the
 // supported way to hold a dependency ANYWHERE in this runtime: a controller,
 // hook, job or webhook is constructed with no arguments, and one that declares
-// a constructor parameter is refused at build with the class named — there is
-// no injector to fill it, so the field would simply be `undefined` in
-// production.
+// a constructor parameter is REFUSED, with the class named — there is no
+// injector to fill it, so the field would otherwise be `undefined` in
+// production. The refusal fires at decoration time for a job, hook or webhook,
+// and when the route table is built at boot for a controller; either way the
+// release never serves.
 //
 // `Database.tables.notes` is typed from `db/public.ts` through the generated
 // `palbase-env.d.ts`, which `palbase build` writes. Before the first build that