@atscript/moost-db 0.1.116 → 0.1.118

package/dist/index.mjs

@@ -1,6 +1,7 @@
-import { ValidatorError, defineAnnotatedType, serializeAnnotatedType, throwFeatureDisabled } from "@atscript/typescript/utils";
+import { i as resolveDbSpace, n as clearDbSpaces, r as provideDbSpace, t as DEFAULT_DB_SPACE } from "./db-space-registry-C_wft7kl.mjs";
+import { ValidatorError, defineAnnotatedType, isAnnotatedType, serializeAnnotatedType, throwFeatureDisabled } from "@atscript/typescript/utils";
 import { Body, Delete, Get, HttpError, Patch, Post, Put, Query, Url } from "@moostjs/event-http";
-import { ApplyDecorators, Controller, Inherit, Inject, Intercept, Moost, Param, Provide, Resolve, TInterceptorPriority, defineBeforeInterceptor, defineInterceptor, getMoostMate, useControllerContext } from "moost";
+import { ApplyDecorators, Controller, Inherit, Inject, Intercept, Moost, Optional, Param, Provide, Resolve, TInterceptorPriority, defineBeforeInterceptor, defineInterceptor, getMoostMate, useControllerContext } from "moost";
 import { parseUrl } from "@uniqu/url";
 import { DbError } from "@atscript/db";
 import { buildMemoryPredicate, projectRow, sortRows } from "@atscript/db-memory";
@@ -912,57 +913,140 @@ const READABLE_DEF = "__atscript_db_readable_def";
 * Points to the same token as READABLE_DEF for backward compatibility.
 */
 const TABLE_DEF = READABLE_DEF;
+function normalizeOptions(prefixOrOptions) {
+	if (typeof prefixOrOptions === "string") return { prefix: prefixOrOptions };
+	return prefixOrOptions ?? {};
+}
+/**
+* Builds the shared binding metadata for a decorator invocation: classifies
+* the binding form, computes the static route prefix, and packages a uniform
+* `resolve()` used by both the DI provide factory and the base controller's
+* `super(undefined, app)` fallback.
+*/
+function buildBinding(binding, options, decoratorName) {
+	if (isAnnotatedType(binding)) {
+		const model = binding;
+		const space = options.space ?? model.metadata.get("db.space");
+		const prefix = options.prefix || model.metadata.get("db.http.path") || model.metadata.get("db.table") || model.metadata.get("db.view") || model.id || "";
+		if (!prefix) throw new Error(`[moost-db] @${decoratorName}: cannot derive a route prefix from the model token (no @db.http.path / @db.table / @db.view and no type id). Pass an explicit prefix.`);
+		return {
+			meta: {
+				model,
+				resolve: () => resolveDbSpace(space).get(model)
+			},
+			prefix
+		};
+	}
+	if (typeof binding === "function") {
+		if (!options.prefix) throw new Error(`[moost-db] @${decoratorName}: the lazy factory form needs an explicit route prefix (the readable is not created until app.init()). Pass a prefix, or use the model token form which derives it from @db.http.path / @db.table.`);
+		return {
+			meta: { resolve: binding },
+			prefix: options.prefix
+		};
+	}
+	const readable = binding;
+	const prefix = options.prefix || readable.type.metadata.get("db.http.path") || readable.tableName;
+	return {
+		meta: {
+			model: readable.type,
+			resolve: () => readable
+		},
+		prefix
+	};
+}
+function bindReadableController(binding, prefixOrOptions, decoratorName) {
+	const { meta, prefix } = buildBinding(binding, normalizeOptions(prefixOrOptions), decoratorName);
+	return ApplyDecorators(getAtscriptDbMate().decorate((classMeta) => {
+		classMeta.atscript_db_readable_binding = meta;
+		return classMeta;
+	}), Provide(READABLE_DEF, () => meta.resolve()), Controller(prefix), Inherit());
+}
 /**
 * Combines the boilerplate needed to turn an {@link AsDbController}
 * subclass into a fully wired HTTP controller for a given `@db.table` model.
 *
 * Internally applies three decorators:
-* 1. **Provide** — registers the table instance under {@link TABLE_DEF}.
+* 1. **Provide** — registers the readable resolver under {@link TABLE_DEF}.
 * 2. **Controller** — registers the class as a Moost HTTP controller
-*    with an optional route prefix. Defaults to `table.tableName`.
+*    with an optional route prefix (defaults to `@db.http.path`, then the
+*    table name).
 * 3. **Inherit** — copies metadata (routes, guards, etc.) from the
 *    parent class so they stay active in the derived controller.
 *
-* @param table  The {@link AtscriptDbTable} instance for this controller.
-* @param prefix Optional route prefix. Defaults to `table.tableName`.
+* All three binding forms are supported (see {@link TReadableBinding}):
 *
-* @example
 * ```ts
-* ‎@TableController(usersTable)
-* export class UsersController extends AsDbController<typeof UserModel> {}
+* ‎@TableController(User)                      // model token (preferred)
+* ‎@TableController(User, { space: "analytics" })
+* ‎@TableController(() => db.getTable(User), "users") // lazy factory
+* ‎@TableController(usersTable)                // instance (legacy)
+* export class UsersController extends AsDbController<typeof User> {}
 * ```
+*
+* Token and factory forms resolve lazily at first controller instantiation
+* (during `app.init()`), so the `DbSpace` does not have to exist when the
+* controller module is imported. For the token form, register the space with
+* `provideDbSpace(db)` before `app.init()`.
+*
+* @param binding Model token, lazy factory, or {@link AtscriptDbTable} instance.
+* @param prefixOrOptions Route prefix string, or {@link TControllerBindingOptions}.
 */
-const TableController = (table, prefix) => {
-	const resolvedPath = prefix || table.type.metadata.get("db.http.path");
-	return ApplyDecorators(Provide(TABLE_DEF, () => table), Controller(resolvedPath || table.tableName), Inherit());
-};
+const TableController = (binding, prefixOrOptions) => bindReadableController(binding, prefixOrOptions, "TableController");
 /**
 * Combines the boilerplate needed to turn an {@link AsDbReadableController}
 * subclass into a fully wired HTTP controller for a given `@db.view` or `@db.table` model.
 *
-* @param readable  The {@link AtscriptDbReadable} instance (table or view).
-* @param prefix    Optional route prefix. Defaults to `readable.tableName`.
+* Accepts the same three binding forms as {@link TableController}.
+*
+* @param binding Model token, lazy factory, or {@link AtscriptDbReadable} instance.
+* @param prefixOrOptions Route prefix string, or {@link TControllerBindingOptions}.
 *
 * @example
 * ```ts
-* ‎@ReadableController(activeTasksView)
+* ‎@ReadableController(ActiveTasks)
 * export class ActiveTasksController extends AsDbReadableController<typeof ActiveTasks> {}
 * ```
 */
-const ReadableController = (readable, prefix) => {
-	const resolvedPath = prefix || readable.type.metadata.get("db.http.path");
-	return ApplyDecorators(Provide(READABLE_DEF, () => readable), Controller(resolvedPath || readable.tableName), Inherit());
-};
+const ReadableController = (binding, prefixOrOptions) => bindReadableController(binding, prefixOrOptions, "ReadableController");
 /**
 * Alias for {@link ReadableController} — use with view-backed controllers.
 *
 * @example
 * ```ts
-* ‎@ViewController(activeTasksView)
+* ‎@ViewController(ActiveTasks)
 * export class ActiveTasksController extends AsDbReadableController<typeof ActiveTasks> {}
 * ```
 */
 const ViewController = ReadableController;
+/**
+* Finds the readable binding written by `@TableController` /
+* `@ReadableController` / `@ViewController` on a controller class, walking the
+* prototype chain so intermediate undecorated classes don't hide the binding
+* (nearest decorated ancestor wins).
+*/
+function findReadableBinding(ctor) {
+	const mate = getAtscriptDbMate();
+	let current = ctor;
+	while (typeof current === "function") {
+		const binding = mate.read(current)?.atscript_db_readable_binding;
+		if (binding) return binding;
+		current = Object.getPrototypeOf(current);
+	}
+}
+/**
+* Resolves the readable bound to a controller class via
+* {@link findReadableBinding}, throwing with wiring guidance when none is
+* found.
+*
+* Used by {@link AsDbReadableController}'s constructor when `readable` is
+* `undefined` — i.e. a subclass with its own constructor called
+* `super(undefined, app)` instead of forwarding an injected instance.
+*/
+function resolveBoundReadable(ctor) {
+	const binding = findReadableBinding(ctor);
+	if (binding) return binding.resolve();
+	throw new Error(`[moost-db] ${ctor?.name || "controller"}: no readable bound. Either pass a table/view to super(...), or decorate the class with @TableController / @ReadableController (model token, lazy factory, or instance form).`);
+}
 //#endregion
 //#region src/permissions/crud-controls.ts
 /**
@@ -1012,11 +1096,12 @@ let AsDbReadableController = class AsDbReadableController extends AsReadableCont
 	/** Paths the adapter vetoes for filtering (e.g. JSON storage on SQL). Symmetric with `/meta` `filterable: false`. */
 	_adapterNonFilterable;
 	constructor(readable, app) {
-		super(readable.type, readable.tableName, app, readable.isView ? "view" : "table");
-		this.readable = readable;
+		const resolved = readable ?? resolveBoundReadable(new.target);
+		super(resolved.type, resolved.tableName, app, resolved.isView ? "view" : "table");
+		this.readable = resolved;
 		this._adapterNonFilterable = this._collectAdapterNonFilterable();
 		this._gates = this._buildGates();
-		this._preferredIdSet = new Set(readable.preferredId ?? []);
+		this._preferredIdSet = new Set(resolved.preferredId ?? []);
 		this._quantityRefByPath = this._collectQuantityRefs();
 		const defaultOverlay = AsReadableController.prototype.applyMetaOverlay;
 		this._overlayIsNoOp = this.applyMetaOverlay === defaultOverlay;
@@ -1673,6 +1758,7 @@ __decorate([
 AsDbReadableController = __decorate([
 	Inherit(),
 	__decorateParam(0, Inject(READABLE_DEF)),
+	__decorateParam(0, Optional()),
 	__decorateMetadata("design:paramtypes", [Object, typeof Moost === "undefined" ? Object : Moost])
 ], AsDbReadableController);
 registerAsDbReadableController(AsDbReadableController);
@@ -1870,6 +1956,7 @@ __decorate([
 AsDbController = __decorate([
 	Inherit(),
 	__decorateParam(0, Inject(TABLE_DEF)),
+	__decorateParam(0, Optional()),
 	__decorateMetadata("design:paramtypes", [Object, typeof Moost === "undefined" ? Object : Moost])
 ], AsDbController);
 //#endregion
@@ -2138,6 +2225,44 @@ AsJsonValueHelpController = __decorate([Inherit(), __decorateMetadata("design:pa
 	String
 ])], AsJsonValueHelpController);
 //#endregion
+//#region src/assert-exposed.ts
+/**
+* Dev-mode wiring assertion: warns for every model annotated with
+* `@db.http.path` that has no registered db controller.
+*
+* Call AFTER `await app.init()` (controller bindings are collected during
+* init). Detection reads the binding metadata written by `@TableController` /
+* `@ReadableController` / `@ViewController`, so it covers the model-token and
+* instance forms; lazy-factory bindings can't name their model until resolved
+* and are ignored.
+*
+* Returns the list of unexposed models so callers can escalate (e.g. throw in
+* CI):
+*
+* ```ts
+* await app.init()
+* const missing = assertExposed(app, atscriptModels)
+* if (missing.length && process.env.CI) throw new Error("unexposed models")
+* ```
+*/
+function assertExposed(app, models, options) {
+	const logger = options?.logger ?? console;
+	const exposed = /* @__PURE__ */ new Set();
+	for (const overview of app.getControllersOverview()) {
+		const model = findReadableBinding(overview.type)?.model;
+		if (model) exposed.add(model);
+	}
+	const missing = [];
+	for (const model of models) {
+		if (!model.metadata.has("db.http.path")) continue;
+		if (exposed.has(model)) continue;
+		missing.push(model);
+		const path = model.metadata.get("db.http.path");
+		logger.warn(`[moost-db] Model "${model.id ?? path}" declares @db.http.path "${path}" but no registered controller is bound to it. Did you forget to register its controller?`);
+	}
+	return missing;
+}
+//#endregion
 //#region src/actions/action-disabled-error.ts
 function buildMessage(action, ids) {
 	if (ids !== void 0) return `Action "${action}" is disabled for ${ids.length} of the selected rows`;
@@ -2727,4 +2852,4 @@ function InputForm(formType) {
 */
 const perRow = (fn) => (rows) => rows.map(fn);
 //#endregion
-export { ActionDisabledError, AsDbController, AsDbReadableController, AsJsonValueHelpController, AsReadableController, AsValueHelpController, DbAction, DbActionDefault, DbActionID, DbActionIDs, DbActionRow, DbActionRows, DbActions, DbRowActions, DbRowsActions, DbTableActions, InputForm, ONE_CONTROLS, PAGES_CONTROLS, QUERY_CONTROLS, READABLE_DEF, ReadableController, TABLE_DEF, TableController, UseValidationErrorTransform, ViewController, dbActionBodySlot, dbActionInputSlot, discoverActions, getAtscriptDbMate, getControllerFormType, perRow, useDbActionId, useDbActionIds, useDbActionInput, useDbActionRow, useDbActionRows, validationErrorTransform };
+export { ActionDisabledError, AsDbController, AsDbReadableController, AsJsonValueHelpController, AsReadableController, AsValueHelpController, DEFAULT_DB_SPACE, DbAction, DbActionDefault, DbActionID, DbActionIDs, DbActionRow, DbActionRows, DbActions, DbRowActions, DbRowsActions, DbTableActions, InputForm, ONE_CONTROLS, PAGES_CONTROLS, QUERY_CONTROLS, READABLE_DEF, ReadableController, TABLE_DEF, TableController, UseValidationErrorTransform, ViewController, assertExposed, clearDbSpaces, dbActionBodySlot, dbActionInputSlot, discoverActions, findReadableBinding, getAtscriptDbMate, getControllerFormType, perRow, provideDbSpace, resolveBoundReadable, resolveDbSpace, useDbActionId, useDbActionIds, useDbActionInput, useDbActionRow, useDbActionRows, validationErrorTransform };

package/dist/testing.cjs

@@ -0,0 +1,21 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_db_space_registry = require("./db-space-registry-DqKr5Zdk.cjs");
+let _atscript_db_memory = require("@atscript/db-memory");
+//#region src/testing.ts
+/**
+* Creates an in-memory {@link DbSpace} (via `@atscript/db-memory`), registers
+* it in the ambient registry for token-based controller binding, and
+* pre-creates tables/views for the given models so relations and FK lookups
+* resolve. Returns the space for direct seeding/assertions.
+*
+* No schema sync is needed — the memory adapter has no DDL.
+*/
+function provideTestDbSpace(models, options) {
+	const space = options?.space ?? (0, _atscript_db_memory.createAdapter)();
+	require_db_space_registry.provideDbSpace(space, options?.name);
+	for (const model of models ?? []) space.get(model);
+	return space;
+}
+//#endregion
+exports.provideTestDbSpace = provideTestDbSpace;
+exports.resetTestDbSpaces = require_db_space_registry.clearDbSpaces;

package/dist/testing.d.cts

@@ -0,0 +1,22 @@
+import { n as clearDbSpaces } from "./db-space-registry-CWpYwZ4R.cjs";
+import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
+import { DbSpace } from "@atscript/db";
+
+//#region src/testing.d.ts
+interface TTestDbSpaceOptions {
+  /** Registry name — defaults to the default space. */
+  name?: string;
+  /** Use an existing space instead of creating an in-memory one. */
+  space?: DbSpace;
+}
+/**
+ * Creates an in-memory {@link DbSpace} (via `@atscript/db-memory`), registers
+ * it in the ambient registry for token-based controller binding, and
+ * pre-creates tables/views for the given models so relations and FK lookups
+ * resolve. Returns the space for direct seeding/assertions.
+ *
+ * No schema sync is needed — the memory adapter has no DDL.
+ */
+declare function provideTestDbSpace(models?: readonly TAtscriptAnnotatedType[], options?: TTestDbSpaceOptions): DbSpace;
+//#endregion
+export { TTestDbSpaceOptions, provideTestDbSpace, clearDbSpaces as resetTestDbSpaces };

package/dist/testing.d.mts

@@ -0,0 +1,22 @@
+import { n as clearDbSpaces } from "./db-space-registry-CKR6G-hi.mjs";
+import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
+import { DbSpace } from "@atscript/db";
+
+//#region src/testing.d.ts
+interface TTestDbSpaceOptions {
+  /** Registry name — defaults to the default space. */
+  name?: string;
+  /** Use an existing space instead of creating an in-memory one. */
+  space?: DbSpace;
+}
+/**
+ * Creates an in-memory {@link DbSpace} (via `@atscript/db-memory`), registers
+ * it in the ambient registry for token-based controller binding, and
+ * pre-creates tables/views for the given models so relations and FK lookups
+ * resolve. Returns the space for direct seeding/assertions.
+ *
+ * No schema sync is needed — the memory adapter has no DDL.
+ */
+declare function provideTestDbSpace(models?: readonly TAtscriptAnnotatedType[], options?: TTestDbSpaceOptions): DbSpace;
+//#endregion
+export { TTestDbSpaceOptions, provideTestDbSpace, clearDbSpaces as resetTestDbSpaces };

package/dist/testing.mjs

@@ -0,0 +1,19 @@
+import { n as clearDbSpaces, r as provideDbSpace } from "./db-space-registry-C_wft7kl.mjs";
+import { createAdapter } from "@atscript/db-memory";
+//#region src/testing.ts
+/**
+* Creates an in-memory {@link DbSpace} (via `@atscript/db-memory`), registers
+* it in the ambient registry for token-based controller binding, and
+* pre-creates tables/views for the given models so relations and FK lookups
+* resolve. Returns the space for direct seeding/assertions.
+*
+* No schema sync is needed — the memory adapter has no DDL.
+*/
+function provideTestDbSpace(models, options) {
+	const space = options?.space ?? createAdapter();
+	provideDbSpace(space, options?.name);
+	for (const model of models ?? []) space.get(model);
+	return space;
+}
+//#endregion
+export { provideTestDbSpace, clearDbSpaces as resetTestDbSpaces };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/moost-db",
-  "version": "0.1.116",
+  "version": "0.1.118",
   "description": "Generic database controller for Moost with Atscript.",
   "keywords": [
     "annotations",
@@ -32,6 +32,11 @@
       "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
     },
+    "./testing": {
+      "types": "./dist/testing.d.mts",
+      "import": "./dist/testing.mjs",
+      "require": "./dist/testing.cjs"
+    },
     "./package.json": "./package.json"
   },
   "publishConfig": {
@@ -39,27 +44,27 @@
   },
   "dependencies": {
     "@uniqu/url": "^0.1.7",
-    "@atscript/db-memory": "^0.1.116"
+    "@atscript/db-memory": "^0.1.118"
   },
   "devDependencies": {
-    "@atscript/core": "^0.1.83",
-    "@atscript/typescript": "^0.1.83",
-    "@moostjs/event-http": "^0.6.31",
+    "@atscript/core": "^0.1.84",
+    "@atscript/typescript": "^0.1.84",
+    "@moostjs/event-http": "^0.6.32",
     "@uniqu/core": "^0.1.7",
     "@wooksjs/event-core": "^0.7.20",
     "@wooksjs/event-http": "^0.7.20",
     "@wooksjs/http-body": "^0.7.20",
-    "moost": "^0.6.31",
-    "unplugin-atscript": "^0.1.83"
+    "moost": "^0.6.32",
+    "unplugin-atscript": "^0.1.84"
   },
   "peerDependencies": {
-    "@atscript/typescript": "^0.1.83",
-    "@moostjs/event-http": "^0.6.31",
+    "@atscript/typescript": "^0.1.84",
+    "@moostjs/event-http": "^0.6.32",
     "@uniqu/core": "^0.1.7",
     "@wooksjs/event-core": "^0.7.20",
     "@wooksjs/http-body": "^0.7.20",
-    "moost": "^0.6.31",
-    "@atscript/db": "^0.1.116"
+    "moost": "^0.6.32",
+    "@atscript/db": "^0.1.118"
   },
   "scripts": {
     "postinstall": "asc -f dts",