@atscript/moost-db 0.1.38 → 0.1.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/moost-db",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "description": "Generic database controller for Moost with Atscript.",
   "keywords": [
     "annotations",
@@ -9,15 +9,15 @@
     "moost",
     "typescript"
   ],
-  "homepage": "https://github.com/moostjs/atscript/tree/main/packages/moost-db#readme",
+  "homepage": "https://github.com/moostjs/atscript-db/tree/main/packages/moost-db#readme",
   "bugs": {
-    "url": "https://github.com/moostjs/atscript/issues"
+    "url": "https://github.com/moostjs/atscript-db/issues"
   },
   "license": "MIT",
   "author": "Artem Maltsev",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/moostjs/atscript.git",
+    "url": "git+https://github.com/moostjs/atscript-db.git",
     "directory": "packages/moost-db"
   },
   "files": [
@@ -25,34 +25,41 @@
   ],
   "type": "module",
   "main": "dist/index.mjs",
-  "types": "dist/index.d.ts",
+  "types": "dist/index.d.mts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
+      "types": "./dist/index.d.mts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
     },
     "./package.json": "./package.json"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "@uniqu/url": "^0.1.2"
   },
   "devDependencies": {
+    "@atscript/core": "^0.1.39",
+    "@atscript/typescript": "^0.1.39",
     "@moostjs/event-http": "^0.6.2",
+    "@uniqu/core": "^0.1.2",
     "moost": "^0.6.2",
-    "vitest": "3.2.4",
-    "@atscript/core": "^0.1.38"
+    "unplugin-atscript": "^0.1.39"
   },
   "peerDependencies": {
+    "@atscript/typescript": "^0.1.39",
     "@moostjs/event-http": "^0.6.2",
-    "moost": "^0.6.2",
     "@uniqu/core": "^0.1.2",
-    "@atscript/db": "^0.1.38",
-    "@atscript/typescript": "^0.1.38"
+    "moost": "^0.6.2",
+    "@atscript/db": "^0.1.40"
   },
   "scripts": {
-    "pub": "pnpm publish --access public",
-    "before-build": "node ../typescript/cli.cjs -f js",
-    "test": "vitest"
+    "postinstall": "asc -f dts",
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check"
   }
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-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
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/index.d.ts

@@ -1,200 +0,0 @@
-import * as _atscript_typescript_utils from '@atscript/typescript/utils';
-import { TAtscriptAnnotatedType, TAtscriptDataType, Validator } from '@atscript/typescript/utils';
-import * as _atscript_db from '@atscript/db';
-import { AtscriptDbReadable, Uniquery, FilterExpr, UniqueryControls, AtscriptDbTable } from '@atscript/db';
-import * as _uniqu_url from '@uniqu/url';
-import { HttpError } from '@moostjs/event-http';
-import * as moost from 'moost';
-import { TConsoleBase, Moost } from 'moost';
-
-/**
- * Read-only database controller for Moost that works with any `AtscriptDbReadable`
- * (tables or views). Provides query, pages, getOne, and meta endpoints.
- *
- * For write operations (insert, replace, update, delete), use {@link AsDbController}.
- * For views, use {@link AsDbViewController}.
- */
-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(readable: AtscriptDbReadable<T>, app: Moost);
-    /**
-     * One-time initialization hook. Override to seed data, register watchers, etc.
-     */
-    protected init(): void | Promise<void>;
-    private _queryControlsValidator?;
-    private _pagesControlsValidator?;
-    private _getOneControlsValidator?;
-    protected get queryControlsValidator(): Validator<any, unknown>;
-    protected get pagesControlsValidator(): Validator<any, unknown>;
-    protected get getOneControlsValidator(): Validator<any, unknown>;
-    protected validateControls(controls: Record<string, unknown>, type: 'query' | 'pages' | 'getOne'): string | undefined;
-    protected validateInsights(insights: Map<string, unknown>): string | undefined;
-    protected validateParsed(parsed: Uniquery, type: 'query' | 'pages' | 'getOne'): HttpError | undefined;
-    /**
-     * Compute an embedding vector from a search term.
-     * Override in subclass to integrate with your embedding provider (OpenAI, etc.).
-     * Called when `$vector` is present in query controls.
-     */
-    protected computeEmbedding(_search: string, _fieldName?: string): Promise<number[]>;
-    /**
-     * Transform filter before querying. Override to add tenant filtering, etc.
-     */
-    protected transformFilter(filter: FilterExpr): FilterExpr;
-    /**
-     * Transform projection before querying.
-     */
-    protected transformProjection(projection?: UniqueryControls['$select']): UniqueryControls['$select'] | undefined;
-    protected parseQueryString(url: string): _uniqu_url.UrlQuery;
-    protected returnOne(result: Promise<DataType | null>): Promise<DataType | HttpError>;
-    /**
-     * Extracts a composite identifier object from query params.
-     * Tries composite primary key first, then compound unique indexes.
-     */
-    protected extractCompositeId(query: Record<string, string>): Record<string, unknown> | HttpError;
-    /**
-     * **GET /query** — returns an array of records or a count.
-     */
-    query(url: string): Promise<DataType[] | number | HttpError>;
-    /**
-     * **GET /pages** — returns paginated records with metadata.
-     */
-    pages(url: string): Promise<{
-        data: DataType[];
-        page: number;
-        itemsPerPage: number;
-        pages: number;
-        count: number;
-    } | HttpError>;
-    /**
-     * **GET /one/:id** — retrieves a single record by ID or unique property.
-     */
-    getOne(id: string, url: string): Promise<DataType | HttpError>;
-    /**
-     * **GET /one?field1=val1&field2=val2** — retrieves a single record by composite key
-     * (composite primary key or compound unique index).
-     */
-    getOneComposite(query: Record<string, string>, url: string): Promise<DataType | HttpError>;
-    /**
-     * **GET /meta** — returns table/view metadata for UI.
-     */
-    meta(): {
-        searchable: boolean;
-        vectorSearchable: boolean;
-        searchIndexes: _atscript_db.TSearchIndexInfo[];
-        type: _atscript_typescript_utils.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' | 'replaceMany' | 'update' | 'updateMany', 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.
-     */
-    insert(payload: unknown): Promise<HttpError | unknown>;
-    /**
-     * **PUT /** — fully replaces one or many records matched by primary key.
-     */
-    replace(payload: unknown): Promise<HttpError | unknown>;
-    /**
-     * **PATCH /** — partially updates one or many records matched by primary key.
-     */
-    update(payload: unknown): Promise<HttpError | unknown>;
-    /**
-     * **DELETE /:id** — removes a single record by primary key.
-     */
-    remove(id: string): Promise<HttpError | unknown>;
-    /**
-     * **DELETE /?field1=val1&field2=val2** — removes a record by composite key
-     * (composite primary key or compound unique index).
-     */
-    removeComposite(query: Record<string, string>): Promise<HttpError | unknown>;
-}
-
-/**
- * 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_readable_def";
-/**
- * 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}.
- * 2. **Controller** — registers the class as a Moost HTTP controller
- *    with an optional route prefix. Defaults to `table.tableName`.
- * 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`.
- *
- * @example
- * ```ts
- * ‎@TableController(usersTable)
- * export class UsersController extends AsDbController<typeof UserModel> {}
- * ```
- */
-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, AsDbReadableController, READABLE_DEF, ReadableController, TABLE_DEF, TableController, UseValidationErrorTransform, ViewController, validationErrorTransform };