@atscript/moost-db 0.1.34 → 0.1.35

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Atscript
+Copyright (c) 2025-present Artem Maltsev
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/index.cjs

@@ -28,8 +28,11 @@ const moost = __toESM(require("moost"));
 const __uniqu_url = __toESM(require("@uniqu/url"));
 
 //#region packages/moost-db/src/decorators.ts
-const TABLE_DEF = "__atscript_db_table_def";
+const READABLE_DEF = "__atscript_db_readable_def";
+const TABLE_DEF = READABLE_DEF;
 const TableController = (table, prefix) => (0, moost.ApplyDecorators)((0, moost.Provide)(TABLE_DEF, () => table), (0, moost.Controller)(prefix || table.tableName), (0, moost.Inherit)());
+const ReadableController = (readable, prefix) => (0, moost.ApplyDecorators)((0, moost.Provide)(READABLE_DEF, () => readable), (0, moost.Controller)(prefix || readable.tableName), (0, moost.Inherit)());
+const ViewController = ReadableController;
 
 //#endregion
 //#region packages/moost-db/src/validation-interceptor.ts
@@ -145,7 +148,7 @@ _define_property$1(SelectControlDto, "id", "SelectControlDto");
 (0, __atscript_typescript_utils.defineAnnotatedType)("object", SelectControlDto).propPattern(/./, (0, __atscript_typescript_utils.defineAnnotatedType)("union").item((0, __atscript_typescript_utils.defineAnnotatedType)().designType("number").value(1).$type).item((0, __atscript_typescript_utils.defineAnnotatedType)().designType("number").value(0).$type).$type);
 
 //#endregion
-//#region packages/moost-db/src/as-db.controller.ts
+//#region packages/moost-db/src/as-db-readable.controller.ts
 function _define_property(obj, key, value) {
 	if (key in obj) Object.defineProperty(obj, key, {
 		value,
@@ -156,21 +159,21 @@ function _define_property(obj, key, value) {
 else obj[key] = value;
 	return obj;
 }
-function _ts_decorate(decorators, target, key, desc) {
+function _ts_decorate$1(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
 else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
 	return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-function _ts_metadata(k, v) {
+function _ts_metadata$1(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-function _ts_param(paramIndex, decorator) {
+function _ts_param$1(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);
 	};
 }
-var AsDbController = class {
+var AsDbReadableController = class {
 	/**
 	* One-time initialization hook. Override to seed data, register watchers, etc.
 	*/ init() {}
@@ -192,7 +195,7 @@ var AsDbController = class {
 		return undefined;
 	}
 	validateInsights(insights) {
-		for (const key of insights.keys()) if (!this.table.flatMap.has(key)) return `Unknown field "${key}"`;
+		for (const key of insights.keys()) if (!this.readable.flatMap.has(key)) return `Unknown field "${key}"`;
 		return undefined;
 	}
 	validateParsed(parsed, type) {
@@ -214,16 +217,6 @@ var AsDbController = class {
 	*/ transformProjection(projection) {
 		return projection;
 	}
-	/**
-	* Intercepts write operations. Return `undefined` to abort.
-	*/ onWrite(action, data) {
-		return data;
-	}
-	/**
-	* Intercepts delete operations. Return `undefined` to abort.
-	*/ onRemove(id) {
-		return id;
-	}
 	parseQueryString(url) {
 		const idx = url.indexOf("?");
 		return (0, __uniqu_url.parseUrl)(idx >= 0 ? url.slice(idx + 1) : "");
@@ -242,7 +235,7 @@ var AsDbController = class {
 		const controls = parsed.controls;
 		const filter = this.transformFilter(parsed.filter);
 		const select = this.transformProjection(controls.$select);
-		if (controls.$count) return this.table.count({
+		if (controls.$count) return this.readable.count({
 			filter,
 			controls: {
 				...controls,
@@ -251,7 +244,7 @@ var AsDbController = class {
 		});
 		const searchTerm = controls.$search;
 		const indexName = controls.$index;
-		if (searchTerm && this.table.isSearchable()) return this.table.search(searchTerm, {
+		if (searchTerm && this.readable.isSearchable()) return this.readable.search(searchTerm, {
 			filter,
 			controls: {
 				...controls,
@@ -259,7 +252,7 @@ var AsDbController = class {
 				$limit: controls.$limit || 1e3
 			}
 		}, indexName);
-		return this.table.findMany({
+		return this.readable.findMany({
 			filter,
 			controls: {
 				...controls,
@@ -292,8 +285,8 @@ var AsDbController = class {
 			}
 		};
 		let result;
-		if (searchTerm && this.table.isSearchable()) result = await this.table.searchWithCount(searchTerm, query, indexName);
-else result = await this.table.findManyWithCount(query);
+		if (searchTerm && this.readable.isSearchable()) result = await this.readable.searchWithCount(searchTerm, query, indexName);
+else result = await this.readable.findManyWithCount(query);
 		return {
 			data: result.data,
 			page,
@@ -310,7 +303,109 @@ else result = await this.table.findManyWithCount(query);
 		const error = this.validateParsed(parsed, "getOne");
 		if (error) return error;
 		const select = this.transformProjection(parsed.controls.$select);
-		return this.returnOne(this.table.findById(id, { $select: select }));
+		const controls = {
+			...parsed.controls,
+			$select: select
+		};
+		return this.returnOne(this.readable.findById(id, { controls }));
+	}
+	/**
+	* **GET /meta** — returns table/view metadata for UI.
+	*/ meta() {
+		return {
+			searchable: this.readable.isSearchable(),
+			searchIndexes: this._searchIndexes,
+			type: this._serializedType
+		};
+	}
+	constructor(readable, app) {
+		/** Reference to the underlying readable (table or view). */ _define_property(this, "readable", void 0);
+		/** Application-scoped logger. */ _define_property(this, "logger", void 0);
+		/** Cached serialized type definition (static, computed once). */ _define_property(this, "_serializedType", void 0);
+		/** Cached search index list (static, computed once). */ _define_property(this, "_searchIndexes", void 0);
+		_define_property(this, "_queryControlsValidator", void 0);
+		_define_property(this, "_pagesControlsValidator", void 0);
+		_define_property(this, "_getOneControlsValidator", void 0);
+		this.readable = readable;
+		this._serializedType = (0, __atscript_typescript_utils.serializeAnnotatedType)(readable.type);
+		this._searchIndexes = readable.getSearchIndexes();
+		this.logger = app.getLogger(`db [${readable.tableName}]`);
+		this.logger.info(`Initializing ${readable.isView ? "view" : "table"} controller`);
+		try {
+			const p = this.init();
+			if (p instanceof Promise) p.catch((error) => {
+				this.logger.error(error);
+			});
+		} catch (error) {
+			this.logger.error(error);
+			throw error;
+		}
+	}
+};
+_ts_decorate$1([
+	(0, __moostjs_event_http.Get)("query"),
+	_ts_param$1(0, (0, __moostjs_event_http.Url)()),
+	_ts_metadata$1("design:type", Function),
+	_ts_metadata$1("design:paramtypes", [String]),
+	_ts_metadata$1("design:returntype", Promise)
+], AsDbReadableController.prototype, "query", null);
+_ts_decorate$1([
+	(0, __moostjs_event_http.Get)("pages"),
+	_ts_param$1(0, (0, __moostjs_event_http.Url)()),
+	_ts_metadata$1("design:type", Function),
+	_ts_metadata$1("design:paramtypes", [String]),
+	_ts_metadata$1("design:returntype", Promise)
+], AsDbReadableController.prototype, "pages", null);
+_ts_decorate$1([
+	(0, __moostjs_event_http.Get)("one/:id"),
+	_ts_param$1(0, (0, moost.Param)("id")),
+	_ts_param$1(1, (0, __moostjs_event_http.Url)()),
+	_ts_metadata$1("design:type", Function),
+	_ts_metadata$1("design:paramtypes", [String, String]),
+	_ts_metadata$1("design:returntype", Promise)
+], AsDbReadableController.prototype, "getOne", null);
+_ts_decorate$1([
+	(0, __moostjs_event_http.Get)("meta"),
+	_ts_metadata$1("design:type", Function),
+	_ts_metadata$1("design:paramtypes", []),
+	_ts_metadata$1("design:returntype", void 0)
+], AsDbReadableController.prototype, "meta", null);
+AsDbReadableController = _ts_decorate$1([
+	UseValidationErrorTransform(),
+	_ts_param$1(0, (0, moost.Inject)(READABLE_DEF)),
+	_ts_metadata$1("design:type", Function),
+	_ts_metadata$1("design:paramtypes", [typeof AtscriptDbReadable === "undefined" ? Object : AtscriptDbReadable, typeof moost.Moost === "undefined" ? Object : moost.Moost])
+], AsDbReadableController);
+
+//#endregion
+//#region packages/moost-db/src/as-db.controller.ts
+function _ts_decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+function _ts_metadata(k, v) {
+	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param(paramIndex, decorator) {
+	return function(target, key) {
+		decorator(target, key, paramIndex);
+	};
+}
+var AsDbController = class extends AsDbReadableController {
+	/** Reference to the underlying table (typed for write access). */ get table() {
+		return this.readable;
+	}
+	/**
+	* Intercepts write operations. Return `undefined` to abort.
+	*/ onWrite(action, data) {
+		return data;
+	}
+	/**
+	* Intercepts delete operations. Return `undefined` to abort.
+	*/ onRemove(id) {
+		return id;
 	}
 	/**
 	* **POST /** — inserts one or many records.
@@ -348,61 +443,10 @@ else result = await this.table.findManyWithCount(query);
 		if (result.deletedCount < 1) return new __moostjs_event_http.HttpError(404);
 		return result;
 	}
-	/**
-	* **GET /meta** — returns table metadata for UI.
-	*/ meta() {
-		return {
-			searchable: this.table.isSearchable(),
-			searchIndexes: this._searchIndexes,
-			type: this._serializedType
-		};
-	}
 	constructor(table, app) {
-		/** Reference to the underlying table. */ _define_property(this, "table", void 0);
-		/** Application-scoped logger. */ _define_property(this, "logger", void 0);
-		/** Cached serialized type definition (static, computed once). */ _define_property(this, "_serializedType", void 0);
-		/** Cached search index list (static, computed once). */ _define_property(this, "_searchIndexes", void 0);
-		_define_property(this, "_queryControlsValidator", void 0);
-		_define_property(this, "_pagesControlsValidator", void 0);
-		_define_property(this, "_getOneControlsValidator", void 0);
-		this.table = table;
-		this._serializedType = (0, __atscript_typescript_utils.serializeAnnotatedType)(table.type);
-		this._searchIndexes = table.getSearchIndexes();
-		this.logger = app.getLogger(`db [${table.tableName}]`);
-		this.logger.info("Initializing table controller");
-		try {
-			const p = this.init();
-			if (p instanceof Promise) p.catch((error) => {
-				this.logger.error(error);
-			});
-		} catch (error) {
-			this.logger.error(error);
-			throw error;
-		}
+		super(table, app);
 	}
 };
-_ts_decorate([
-	(0, __moostjs_event_http.Get)("query"),
-	_ts_param(0, (0, __moostjs_event_http.Url)()),
-	_ts_metadata("design:type", Function),
-	_ts_metadata("design:paramtypes", [String]),
-	_ts_metadata("design:returntype", Promise)
-], AsDbController.prototype, "query", null);
-_ts_decorate([
-	(0, __moostjs_event_http.Get)("pages"),
-	_ts_param(0, (0, __moostjs_event_http.Url)()),
-	_ts_metadata("design:type", Function),
-	_ts_metadata("design:paramtypes", [String]),
-	_ts_metadata("design:returntype", Promise)
-], AsDbController.prototype, "pages", null);
-_ts_decorate([
-	(0, __moostjs_event_http.Get)("one/:id"),
-	_ts_param(0, (0, moost.Param)("id")),
-	_ts_param(1, (0, __moostjs_event_http.Url)()),
-	_ts_metadata("design:type", Function),
-	_ts_metadata("design:paramtypes", [String, String]),
-	_ts_metadata("design:returntype", Promise)
-], AsDbController.prototype, "getOne", null);
 _ts_decorate([
 	(0, __moostjs_event_http.Post)(""),
 	_ts_param(0, (0, __moostjs_event_http.Body)()),
@@ -431,14 +475,8 @@ _ts_decorate([
 	_ts_metadata("design:paramtypes", [String]),
 	_ts_metadata("design:returntype", Promise)
 ], AsDbController.prototype, "remove", null);
-_ts_decorate([
-	(0, __moostjs_event_http.Get)("meta"),
-	_ts_metadata("design:type", Function),
-	_ts_metadata("design:paramtypes", []),
-	_ts_metadata("design:returntype", void 0)
-], AsDbController.prototype, "meta", null);
 AsDbController = _ts_decorate([
-	UseValidationErrorTransform(),
+	(0, moost.Inherit)(),
 	_ts_param(0, (0, moost.Inject)(TABLE_DEF)),
 	_ts_metadata("design:type", Function),
 	_ts_metadata("design:paramtypes", [typeof AtscriptDbTable === "undefined" ? Object : AtscriptDbTable, typeof moost.Moost === "undefined" ? Object : moost.Moost])
@@ -451,7 +489,16 @@ Object.defineProperty(exports, 'AsDbController', {
     return AsDbController;
   }
 });
+Object.defineProperty(exports, 'AsDbReadableController', {
+  enumerable: true,
+  get: function () {
+    return AsDbReadableController;
+  }
+});
+exports.READABLE_DEF = READABLE_DEF
+exports.ReadableController = ReadableController
 exports.TABLE_DEF = TABLE_DEF
 exports.TableController = TableController
 exports.UseValidationErrorTransform = UseValidationErrorTransform
+exports.ViewController = ViewController
 exports.validationErrorTransform = validationErrorTransform

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as _atscript_typescript_serialize from '@atscript/typescript/serialize';
 import * as _atscript_utils_db from '@atscript/utils-db';
-import { AtscriptDbTable, Uniquery, FilterExpr, UniqueryControls } from '@atscript/utils-db';
+import { AtscriptDbReadable, Uniquery, FilterExpr, UniqueryControls, AtscriptDbTable } from '@atscript/utils-db';
 import * as _uniqu_url from '@uniqu/url';
 import { TAtscriptAnnotatedType, TAtscriptDataType, Validator } from '@atscript/typescript/utils';
 import { HttpError } from '@moostjs/event-http';
@@ -8,27 +8,22 @@ import * as moost from 'moost';
 import { TConsoleBase, Moost } from 'moost';
 
 /**
- * Generic database controller for Moost that works with any `AtscriptDbTable` +
- * `BaseDbAdapter`. All CRUD routes through the generic table layer — no
- * adapter-specific imports.
+ * Read-only database controller for Moost that works with any `AtscriptDbReadable`
+ * (tables or views). Provides query, pages, getOne, and meta endpoints.
  *
- * Subclass and provide the table via DI:
- * ```ts
- * ‎@Provide(TABLE_DEF, () => driver.getTable(MyType))
- * ‎@TableController(MyType)
- * export class MyController extends AsDbController<typeof MyType> {}
- * ```
+ * For write operations (insert, replace, update, delete), use {@link AsDbController}.
+ * For views, use {@link AsDbViewController}.
  */
-declare class AsDbController<T extends TAtscriptAnnotatedType = TAtscriptAnnotatedType, DataType = TAtscriptDataType<T>> {
-    /** Reference to the underlying table. */
-    protected table: AtscriptDbTable<T>;
+declare class AsDbReadableController<T extends TAtscriptAnnotatedType = TAtscriptAnnotatedType, DataType = TAtscriptDataType<T>> {
+    /** Reference to the underlying readable (table or view). */
+    protected readable: AtscriptDbReadable<T>;
     /** Application-scoped logger. */
     protected logger: TConsoleBase;
     /** Cached serialized type definition (static, computed once). */
     private _serializedType;
     /** Cached search index list (static, computed once). */
     private _searchIndexes;
-    constructor(table: AtscriptDbTable<T>, app: Moost);
+    constructor(readable: AtscriptDbReadable<T>, app: Moost);
     /**
      * One-time initialization hook. Override to seed data, register watchers, etc.
      */
@@ -50,14 +45,6 @@ declare class AsDbController<T extends TAtscriptAnnotatedType = TAtscriptAnnotat
      * Transform projection before querying.
      */
     protected transformProjection(projection?: UniqueryControls['$select']): UniqueryControls['$select'] | undefined;
-    /**
-     * Intercepts write operations. Return `undefined` to abort.
-     */
-    protected onWrite(action: 'insert' | 'insertMany' | 'replace' | 'update', data: unknown): unknown | Promise<unknown | undefined>;
-    /**
-     * Intercepts delete operations. Return `undefined` to abort.
-     */
-    protected onRemove(id: unknown): unknown | Promise<unknown | undefined>;
     protected parseQueryString(url: string): _uniqu_url.UrlQuery;
     protected returnOne(result: Promise<DataType | null>): Promise<DataType | HttpError>;
     /**
@@ -78,6 +65,38 @@ declare class AsDbController<T extends TAtscriptAnnotatedType = TAtscriptAnnotat
      * **GET /one/:id** — retrieves a single record by ID or unique property.
      */
     getOne(id: string, url: string): Promise<DataType | HttpError>;
+    /**
+     * **GET /meta** — returns table/view metadata for UI.
+     */
+    meta(): {
+        searchable: boolean;
+        searchIndexes: _atscript_utils_db.TSearchIndexInfo[];
+        type: _atscript_typescript_serialize.TSerializedAnnotatedType;
+    };
+}
+
+/**
+ * Full CRUD database controller for Moost that works with any `AtscriptDbTable` +
+ * `BaseDbAdapter`. Extends {@link AsDbReadableController} with write operations.
+ *
+ * Subclass and provide the table via DI:
+ * ```ts
+ * ‎@TableController(usersTable)
+ * export class UsersController extends AsDbController<typeof UserModel> {}
+ * ```
+ */
+declare class AsDbController<T extends TAtscriptAnnotatedType = TAtscriptAnnotatedType, DataType = TAtscriptDataType<T>> extends AsDbReadableController<T, DataType> {
+    /** Reference to the underlying table (typed for write access). */
+    protected get table(): AtscriptDbTable<T>;
+    constructor(table: AtscriptDbTable<T>, app: Moost);
+    /**
+     * Intercepts write operations. Return `undefined` to abort.
+     */
+    protected onWrite(action: 'insert' | 'insertMany' | 'replace' | 'update', data: unknown): unknown | Promise<unknown | undefined>;
+    /**
+     * Intercepts delete operations. Return `undefined` to abort.
+     */
+    protected onRemove(id: unknown): unknown | Promise<unknown | undefined>;
     /**
      * **POST /** — inserts one or many records.
      */
@@ -94,21 +113,19 @@ declare class AsDbController<T extends TAtscriptAnnotatedType = TAtscriptAnnotat
      * **DELETE /:id** — removes a single record by primary key.
      */
     remove(id: string): Promise<HttpError | unknown>;
-    /**
-     * **GET /meta** — returns table metadata for UI.
-     */
-    meta(): {
-        searchable: boolean;
-        searchIndexes: _atscript_utils_db.TSearchIndexInfo[];
-        type: _atscript_typescript_serialize.TSerializedAnnotatedType;
-    };
 }
 
+/**
+ * DI token under which the {@link AtscriptDbReadable} instance
+ * is exposed to the readable controller's constructor via `@Inject`.
+ */
+declare const READABLE_DEF = "__atscript_db_readable_def";
 /**
  * DI token under which the {@link AtscriptDbTable} instance
  * is exposed to the controller's constructor via `@Inject`.
+ * Points to the same token as READABLE_DEF for backward compatibility.
  */
-declare const TABLE_DEF = "__atscript_db_table_def";
+declare const TABLE_DEF = "__atscript_db_readable_def";
 /**
  * Combines the boilerplate needed to turn an {@link AsDbController}
  * subclass into a fully wired HTTP controller for a given `@db.table` model.
@@ -130,8 +147,32 @@ declare const TABLE_DEF = "__atscript_db_table_def";
  * ```
  */
 declare const TableController: (table: AtscriptDbTable, prefix?: string) => MethodDecorator & ClassDecorator & ParameterDecorator & PropertyDecorator;
+/**
+ * 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`.
+ *
+ * @example
+ * ```ts
+ * ‎@ReadableController(activeTasksView)
+ * export class ActiveTasksController extends AsDbReadableController<typeof ActiveTasks> {}
+ * ```
+ */
+declare const ReadableController: (readable: AtscriptDbReadable, prefix?: string) => MethodDecorator & ClassDecorator & ParameterDecorator & PropertyDecorator;
+/**
+ * Alias for {@link ReadableController} — use with view-backed controllers.
+ *
+ * @example
+ * ```ts
+ * ‎@ViewController(activeTasksView)
+ * export class ActiveTasksController extends AsDbReadableController<typeof ActiveTasks> {}
+ * ```
+ */
+declare const ViewController: (readable: AtscriptDbReadable, prefix?: string) => MethodDecorator & ClassDecorator & ParameterDecorator & PropertyDecorator;
 
 declare const validationErrorTransform: () => moost.TInterceptorDef;
 declare const UseValidationErrorTransform: () => ClassDecorator & MethodDecorator;
 
-export { AsDbController, TABLE_DEF, TableController, UseValidationErrorTransform, validationErrorTransform };
+export { AsDbController, AsDbReadableController, READABLE_DEF, ReadableController, TABLE_DEF, TableController, UseValidationErrorTransform, ViewController, validationErrorTransform };

package/dist/index.mjs

@@ -4,8 +4,11 @@ import { ApplyDecorators, Controller, Inherit, Inject, Intercept, Moost, Param,
 import { parseUrl } from "@uniqu/url";
 
 //#region packages/moost-db/src/decorators.ts
-const TABLE_DEF = "__atscript_db_table_def";
+const READABLE_DEF = "__atscript_db_readable_def";
+const TABLE_DEF = READABLE_DEF;
 const TableController = (table, prefix) => ApplyDecorators(Provide(TABLE_DEF, () => table), Controller(prefix || table.tableName), Inherit());
+const ReadableController = (readable, prefix) => ApplyDecorators(Provide(READABLE_DEF, () => readable), Controller(prefix || readable.tableName), Inherit());
+const ViewController = ReadableController;
 
 //#endregion
 //#region packages/moost-db/src/validation-interceptor.ts
@@ -121,7 +124,7 @@ defineAnnotatedType("object", SortControlDto).propPattern(/./, defineAnnotatedTy
 defineAnnotatedType("object", SelectControlDto).propPattern(/./, defineAnnotatedType("union").item(defineAnnotatedType().designType("number").value(1).$type).item(defineAnnotatedType().designType("number").value(0).$type).$type);
 
 //#endregion
-//#region packages/moost-db/src/as-db.controller.ts
+//#region packages/moost-db/src/as-db-readable.controller.ts
 function _define_property(obj, key, value) {
 	if (key in obj) Object.defineProperty(obj, key, {
 		value,
@@ -132,21 +135,21 @@ function _define_property(obj, key, value) {
 else obj[key] = value;
 	return obj;
 }
-function _ts_decorate(decorators, target, key, desc) {
+function _ts_decorate$1(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
 else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
 	return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-function _ts_metadata(k, v) {
+function _ts_metadata$1(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-function _ts_param(paramIndex, decorator) {
+function _ts_param$1(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);
 	};
 }
-var AsDbController = class {
+var AsDbReadableController = class {
 	/**
 	* One-time initialization hook. Override to seed data, register watchers, etc.
 	*/ init() {}
@@ -168,7 +171,7 @@ var AsDbController = class {
 		return undefined;
 	}
 	validateInsights(insights) {
-		for (const key of insights.keys()) if (!this.table.flatMap.has(key)) return `Unknown field "${key}"`;
+		for (const key of insights.keys()) if (!this.readable.flatMap.has(key)) return `Unknown field "${key}"`;
 		return undefined;
 	}
 	validateParsed(parsed, type) {
@@ -190,16 +193,6 @@ var AsDbController = class {
 	*/ transformProjection(projection) {
 		return projection;
 	}
-	/**
-	* Intercepts write operations. Return `undefined` to abort.
-	*/ onWrite(action, data) {
-		return data;
-	}
-	/**
-	* Intercepts delete operations. Return `undefined` to abort.
-	*/ onRemove(id) {
-		return id;
-	}
 	parseQueryString(url) {
 		const idx = url.indexOf("?");
 		return parseUrl(idx >= 0 ? url.slice(idx + 1) : "");
@@ -218,7 +211,7 @@ var AsDbController = class {
 		const controls = parsed.controls;
 		const filter = this.transformFilter(parsed.filter);
 		const select = this.transformProjection(controls.$select);
-		if (controls.$count) return this.table.count({
+		if (controls.$count) return this.readable.count({
 			filter,
 			controls: {
 				...controls,
@@ -227,7 +220,7 @@ var AsDbController = class {
 		});
 		const searchTerm = controls.$search;
 		const indexName = controls.$index;
-		if (searchTerm && this.table.isSearchable()) return this.table.search(searchTerm, {
+		if (searchTerm && this.readable.isSearchable()) return this.readable.search(searchTerm, {
 			filter,
 			controls: {
 				...controls,
@@ -235,7 +228,7 @@ var AsDbController = class {
 				$limit: controls.$limit || 1e3
 			}
 		}, indexName);
-		return this.table.findMany({
+		return this.readable.findMany({
 			filter,
 			controls: {
 				...controls,
@@ -268,8 +261,8 @@ var AsDbController = class {
 			}
 		};
 		let result;
-		if (searchTerm && this.table.isSearchable()) result = await this.table.searchWithCount(searchTerm, query, indexName);
-else result = await this.table.findManyWithCount(query);
+		if (searchTerm && this.readable.isSearchable()) result = await this.readable.searchWithCount(searchTerm, query, indexName);
+else result = await this.readable.findManyWithCount(query);
 		return {
 			data: result.data,
 			page,
@@ -286,7 +279,109 @@ else result = await this.table.findManyWithCount(query);
 		const error = this.validateParsed(parsed, "getOne");
 		if (error) return error;
 		const select = this.transformProjection(parsed.controls.$select);
-		return this.returnOne(this.table.findById(id, { $select: select }));
+		const controls = {
+			...parsed.controls,
+			$select: select
+		};
+		return this.returnOne(this.readable.findById(id, { controls }));
+	}
+	/**
+	* **GET /meta** — returns table/view metadata for UI.
+	*/ meta() {
+		return {
+			searchable: this.readable.isSearchable(),
+			searchIndexes: this._searchIndexes,
+			type: this._serializedType
+		};
+	}
+	constructor(readable, app) {
+		/** Reference to the underlying readable (table or view). */ _define_property(this, "readable", void 0);
+		/** Application-scoped logger. */ _define_property(this, "logger", void 0);
+		/** Cached serialized type definition (static, computed once). */ _define_property(this, "_serializedType", void 0);
+		/** Cached search index list (static, computed once). */ _define_property(this, "_searchIndexes", void 0);
+		_define_property(this, "_queryControlsValidator", void 0);
+		_define_property(this, "_pagesControlsValidator", void 0);
+		_define_property(this, "_getOneControlsValidator", void 0);
+		this.readable = readable;
+		this._serializedType = serializeAnnotatedType(readable.type);
+		this._searchIndexes = readable.getSearchIndexes();
+		this.logger = app.getLogger(`db [${readable.tableName}]`);
+		this.logger.info(`Initializing ${readable.isView ? "view" : "table"} controller`);
+		try {
+			const p = this.init();
+			if (p instanceof Promise) p.catch((error) => {
+				this.logger.error(error);
+			});
+		} catch (error) {
+			this.logger.error(error);
+			throw error;
+		}
+	}
+};
+_ts_decorate$1([
+	Get("query"),
+	_ts_param$1(0, Url()),
+	_ts_metadata$1("design:type", Function),
+	_ts_metadata$1("design:paramtypes", [String]),
+	_ts_metadata$1("design:returntype", Promise)
+], AsDbReadableController.prototype, "query", null);
+_ts_decorate$1([
+	Get("pages"),
+	_ts_param$1(0, Url()),
+	_ts_metadata$1("design:type", Function),
+	_ts_metadata$1("design:paramtypes", [String]),
+	_ts_metadata$1("design:returntype", Promise)
+], AsDbReadableController.prototype, "pages", null);
+_ts_decorate$1([
+	Get("one/:id"),
+	_ts_param$1(0, Param("id")),
+	_ts_param$1(1, Url()),
+	_ts_metadata$1("design:type", Function),
+	_ts_metadata$1("design:paramtypes", [String, String]),
+	_ts_metadata$1("design:returntype", Promise)
+], AsDbReadableController.prototype, "getOne", null);
+_ts_decorate$1([
+	Get("meta"),
+	_ts_metadata$1("design:type", Function),
+	_ts_metadata$1("design:paramtypes", []),
+	_ts_metadata$1("design:returntype", void 0)
+], AsDbReadableController.prototype, "meta", null);
+AsDbReadableController = _ts_decorate$1([
+	UseValidationErrorTransform(),
+	_ts_param$1(0, Inject(READABLE_DEF)),
+	_ts_metadata$1("design:type", Function),
+	_ts_metadata$1("design:paramtypes", [typeof AtscriptDbReadable === "undefined" ? Object : AtscriptDbReadable, typeof Moost === "undefined" ? Object : Moost])
+], AsDbReadableController);
+
+//#endregion
+//#region packages/moost-db/src/as-db.controller.ts
+function _ts_decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+function _ts_metadata(k, v) {
+	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param(paramIndex, decorator) {
+	return function(target, key) {
+		decorator(target, key, paramIndex);
+	};
+}
+var AsDbController = class extends AsDbReadableController {
+	/** Reference to the underlying table (typed for write access). */ get table() {
+		return this.readable;
+	}
+	/**
+	* Intercepts write operations. Return `undefined` to abort.
+	*/ onWrite(action, data) {
+		return data;
+	}
+	/**
+	* Intercepts delete operations. Return `undefined` to abort.
+	*/ onRemove(id) {
+		return id;
 	}
 	/**
 	* **POST /** — inserts one or many records.
@@ -324,61 +419,10 @@ else result = await this.table.findManyWithCount(query);
 		if (result.deletedCount < 1) return new HttpError(404);
 		return result;
 	}
-	/**
-	* **GET /meta** — returns table metadata for UI.
-	*/ meta() {
-		return {
-			searchable: this.table.isSearchable(),
-			searchIndexes: this._searchIndexes,
-			type: this._serializedType
-		};
-	}
 	constructor(table, app) {
-		/** Reference to the underlying table. */ _define_property(this, "table", void 0);
-		/** Application-scoped logger. */ _define_property(this, "logger", void 0);
-		/** Cached serialized type definition (static, computed once). */ _define_property(this, "_serializedType", void 0);
-		/** Cached search index list (static, computed once). */ _define_property(this, "_searchIndexes", void 0);
-		_define_property(this, "_queryControlsValidator", void 0);
-		_define_property(this, "_pagesControlsValidator", void 0);
-		_define_property(this, "_getOneControlsValidator", void 0);
-		this.table = table;
-		this._serializedType = serializeAnnotatedType(table.type);
-		this._searchIndexes = table.getSearchIndexes();
-		this.logger = app.getLogger(`db [${table.tableName}]`);
-		this.logger.info("Initializing table controller");
-		try {
-			const p = this.init();
-			if (p instanceof Promise) p.catch((error) => {
-				this.logger.error(error);
-			});
-		} catch (error) {
-			this.logger.error(error);
-			throw error;
-		}
+		super(table, app);
 	}
 };
-_ts_decorate([
-	Get("query"),
-	_ts_param(0, Url()),
-	_ts_metadata("design:type", Function),
-	_ts_metadata("design:paramtypes", [String]),
-	_ts_metadata("design:returntype", Promise)
-], AsDbController.prototype, "query", null);
-_ts_decorate([
-	Get("pages"),
-	_ts_param(0, Url()),
-	_ts_metadata("design:type", Function),
-	_ts_metadata("design:paramtypes", [String]),
-	_ts_metadata("design:returntype", Promise)
-], AsDbController.prototype, "pages", null);
-_ts_decorate([
-	Get("one/:id"),
-	_ts_param(0, Param("id")),
-	_ts_param(1, Url()),
-	_ts_metadata("design:type", Function),
-	_ts_metadata("design:paramtypes", [String, String]),
-	_ts_metadata("design:returntype", Promise)
-], AsDbController.prototype, "getOne", null);
 _ts_decorate([
 	Post(""),
 	_ts_param(0, Body()),
@@ -407,18 +451,12 @@ _ts_decorate([
 	_ts_metadata("design:paramtypes", [String]),
 	_ts_metadata("design:returntype", Promise)
 ], AsDbController.prototype, "remove", null);
-_ts_decorate([
-	Get("meta"),
-	_ts_metadata("design:type", Function),
-	_ts_metadata("design:paramtypes", []),
-	_ts_metadata("design:returntype", void 0)
-], AsDbController.prototype, "meta", null);
 AsDbController = _ts_decorate([
-	UseValidationErrorTransform(),
+	Inherit(),
 	_ts_param(0, Inject(TABLE_DEF)),
 	_ts_metadata("design:type", Function),
 	_ts_metadata("design:paramtypes", [typeof AtscriptDbTable === "undefined" ? Object : AtscriptDbTable, typeof Moost === "undefined" ? Object : Moost])
 ], AsDbController);
 
 //#endregion
-export { AsDbController, TABLE_DEF, TableController, UseValidationErrorTransform, validationErrorTransform };
+export { AsDbController, AsDbReadableController, READABLE_DEF, ReadableController, TABLE_DEF, TableController, UseValidationErrorTransform, ViewController, validationErrorTransform };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/moost-db",
-  "version": "0.1.34",
+  "version": "0.1.35",
   "description": "Generic database controller for Moost with Atscript.",
   "keywords": [
     "annotations",
@@ -13,7 +13,7 @@
   "bugs": {
     "url": "https://github.com/moostjs/atscript/issues"
   },
-  "license": "ISC",
+  "license": "MIT",
   "author": "Artem Maltsev",
   "repository": {
     "type": "git",
@@ -35,20 +35,20 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@uniqu/url": "^0.0.4"
+    "@uniqu/url": "^0.0.5"
   },
   "devDependencies": {
     "@moostjs/event-http": "^0.6.2",
     "moost": "^0.6.2",
     "vitest": "3.2.4",
-    "@atscript/core": "^0.1.34"
+    "@atscript/core": "^0.1.35"
   },
   "peerDependencies": {
     "@moostjs/event-http": "^0.6.2",
     "moost": "^0.6.2",
-    "@uniqu/core": "^0.0.4",
-    "@atscript/utils-db": "^0.1.34",
-    "@atscript/typescript": "^0.1.34"
+    "@uniqu/core": "^0.0.5",
+    "@atscript/utils-db": "^0.1.35",
+    "@atscript/typescript": "^0.1.35"
   },
   "scripts": {
     "pub": "pnpm publish --access public",