@atscript/moost-db 0.1.65 → 0.1.67

package/dist/index.cjs

@@ -182,6 +182,30 @@ function findSortOffender(sort, isAllowed) {
 	}
 }
 //#endregion
+//#region src/mate.ts
+/**
+* Returns the shared moost-mate instance, typed against every key that
+* `@atscript/moost-db` writes (see {@link AtscriptDbMeta} +
+* {@link AtscriptDbParamsMeta}).
+*
+* Prefer this over `getMoostMate()` from `moost` whenever you need to
+* read moost-db metadata — callers no longer have to retype the
+* `atscript_db_*` magic strings or hand-cast the result.
+*
+* @example
+* ```ts
+* import { getAtscriptDbMate } from "@atscript/moost-db";
+*
+* const mate = getAtscriptDbMate();
+* const meta = mate.read(controllerCtor.prototype, methodName);
+* const dbAction = meta?.atscript_db_action;       // TDbActionMeta | undefined
+* const inputForm = meta?.params?.[0]?.atscript_db_action_input_form;
+* ```
+*/
+function getAtscriptDbMate() {
+	return (0, moost.getMoostMate)();
+}
+//#endregion
 //#region src/actions/controller-registry.ts
 let asDbReadableCtor = null;
 let asValueHelpCtor = null;
@@ -203,38 +227,14 @@ function isAsValueHelpControllerSubclass(ctor) {
 //#region src/actions/keys.ts
 /** Log-message prefix for warnings emitted from the actions subsystem. */
 const WARN_PREFIX = "[moost-db actions]";
-/** Method-level metadata key — written by `@DbAction(name, opts)`. */
-const MOOST_DB_ACTION = "atscript_db_action";
-/** Class-level metadata key — written by `@DbActions` and the level-pinned shortcuts. Stored as an array; decorators accumulate. */
-const MOOST_DB_ACTIONS = "atscript_db_actions";
-/** Param-level metadata key — written by `@DbActionID()` / `@DbActionIDs()`. Drives level inference. */
-const MOOST_DB_ACTION_PARAM = "atscript_db_action_param";
-/** Param-level marker keys — written by `@DbActionRow()` / `@DbActionRows()`. */
-const MOOST_DB_ACTION_ROW = "atscript_db_action_row";
-const MOOST_DB_ACTION_ROWS = "atscript_db_action_rows";
-/**
-* Param-level metadata key — written by `@InputForm(FormType)`. Carries the
-* compiled `.as` class plus its `.name` so {@link discoverActions} can both
-* emit `inputForm` on `/meta` and register the type in the controller's form
-* registry for `GET /meta/form/:name`.
-*/
-const MOOST_DB_ACTION_INPUT_FORM = "atscript_db_action_input_form";
-/**
-* Generic param-level metadata key — written by `@InputForm(FormType)`
-* alongside {@link MOOST_DB_ACTION_INPUT_FORM}. Holds just the type ref so a
-* generic atscript-aware Moost pipe (installed globally via
-* `app.applyGlobalPipes(...)` or scoped via `@Pipe(...)`) can validate the
-* resolved value without knowing about the moost-db-specific key.
-*/
-const MOOST_ATSCRIPT_TYPE = "atscript_type";
 /**
 * Shared method-decorator update used by `@DbAction` and `@DbActionDefault`:
-* read the existing `MOOST_DB_ACTION` slot, merge the patch (later-applied
+* read the existing `atscript_db_action` slot, merge the patch (later-applied
 * fields win), and write it back. `name` is empty until `@DbAction` provides
 * one — `discoverActions` warns and drops actions with no name.
 */
 function mergeActionMeta(current, patch) {
-	const existing = current[MOOST_DB_ACTION];
+	const existing = current.atscript_db_action;
 	return {
 		name: patch.name ?? existing?.name ?? "",
 		opts: {
@@ -253,21 +253,19 @@ function scanParamLevel(params) {
 	let inputForm;
 	let hasDuplicateInputForm = false;
 	for (const p of params) {
-		const kind = p[MOOST_DB_ACTION_PARAM];
-		if (kind === "id") single = true;
-		else if (kind === "ids") multi = true;
-		if (p["atscript_db_action_row"]) {
+		if (p.atscript_db_action_param === "id") single = true;
+		else if (p.atscript_db_action_param === "ids") multi = true;
+		if (p.atscript_db_action_row) {
 			single = true;
 			hasRowParam = true;
 		}
-		if (p["atscript_db_action_rows"]) {
+		if (p.atscript_db_action_rows) {
 			multi = true;
 			hasRowParam = true;
 		}
 		if (p.paramSource === "BODY") hasBody = true;
-		const form = p[MOOST_DB_ACTION_INPUT_FORM];
-		if (form) if (inputForm) hasDuplicateInputForm = true;
-		else inputForm = form;
+		if (p.atscript_db_action_input_form) if (inputForm) hasDuplicateInputForm = true;
+		else inputForm = p.atscript_db_action_input_form;
 	}
 	return {
 		level: single && multi ? "table" : single ? "row" : multi ? "rows" : "table",
@@ -296,7 +294,7 @@ const rowLevelActionsCache = /* @__PURE__ */ new WeakMap();
 /**
 * Per-controller registry of form names → compiled `.as` classes, populated
 * during {@link discoverActions} when a method param carries
-* {@link MOOST_DB_ACTION_INPUT_FORM}. Backs `GET /meta/form/:name`.
+* `atscript_db_action_input_form`. Backs `GET /meta/form/:name`.
 *
 * Same name + same type ref across multiple actions is fine (forms can be
 * reused). Same name + *different* type refs is an ambiguity — discovery
@@ -352,7 +350,7 @@ function collectMethodActions(ctor, overview, logger, out, seen) {
 	}
 	for (const [methodName, handlers] of byMethod) {
 		const methodMeta = handlers[0].meta;
-		const action = methodMeta[MOOST_DB_ACTION];
+		const action = methodMeta.atscript_db_action;
 		if (!action) continue;
 		if (!action.name) {
 			logger.warn(`${WARN_PREFIX} method "${methodName}" has @DbActionDefault() but no @DbAction(name) — dropping`);
@@ -433,7 +431,7 @@ function inferMethodLevel(params, actionName, logger) {
 	};
 }
 function collectClassActions(ctor, logger, out, seen) {
-	const list = (0, moost.getMoostMate)().read(ctor)?.[MOOST_DB_ACTIONS];
+	const list = getAtscriptDbMate().read(ctor)?.atscript_db_actions;
 	if (!list) return;
 	for (const { name, entry } of list) {
 		if (seen.has(name)) {
@@ -2021,7 +2019,7 @@ function readCurrentActionMeta(ctx) {
 		return;
 	}
 	if (!ctrl || !methodName) return void 0;
-	return (0, moost.getMoostMate)().read(ctrl.constructor, methodName)?.[MOOST_DB_ACTION];
+	return getAtscriptDbMate().read(ctrl.constructor, methodName)?.atscript_db_action;
 }
 //#endregion
 //#region src/actions/input-form-cache.ts
@@ -2323,7 +2321,7 @@ function buildThinInterceptor(opts) {
 //#region src/actions/db-action.decorator.ts
 /**
 * Mark a controller method as a database action surfaced via `/meta`. Writes
-* `MOOST_DB_ACTION` metadata and registers a Moost interceptor when needed
+* `atscript_db_action` metadata and registers a Moost interceptor when needed
 * (gate when `disabled` is set, thin bound-table injector when only
 * `@DbActionRow*` is present). Stacking two `@DbAction` on the same method
 * is undefined and emits a warning.
@@ -2334,20 +2332,17 @@ function buildThinInterceptor(opts) {
 * `Pick<FlatOf<TRow>, R[number]>[]`.
 */
 function DbAction(name, opts = {}) {
-	const mate = (0, moost.getMoostMate)();
+	const mate = getAtscriptDbMate();
 	return ((target, propertyKey, descriptor) => {
-		const priorName = mate.read(target, propertyKey)?.[MOOST_DB_ACTION]?.name;
+		const priorName = mate.read(target, propertyKey)?.atscript_db_action?.name;
 		if (priorName) console.warn(`${WARN_PREFIX} stacking @DbAction on the same method is undefined; declare one per method. Detected: "${priorName}" and "${name}".`);
-		mate.decorate((current) => {
-			const meta = current;
-			return {
-				...current,
-				[MOOST_DB_ACTION]: mergeActionMeta(meta, {
-					name,
-					opts
-				})
-			};
-		})(target, propertyKey, descriptor);
+		mate.decorate((current) => ({
+			...current,
+			atscript_db_action: mergeActionMeta(current, {
+				name,
+				opts
+			})
+		}))(target, propertyKey, descriptor);
 		if (isAsValueHelpControllerSubclass(typeof target === "function" ? target : target.constructor)) return descriptor;
 		const scan = scanParamLevel(mate.read(target, propertyKey)?.params ?? []);
 		const rawOpts = opts;
@@ -2369,13 +2364,10 @@ function DbAction(name, opts = {}) {
 * Equivalent to passing `opts.default = true`. Decorator order does not matter.
 */
 function DbActionDefault() {
-	return (0, moost.getMoostMate)().decorate((current) => {
-		const meta = current;
-		return {
-			...current,
-			[MOOST_DB_ACTION]: mergeActionMeta(meta, { opts: { default: true } })
-		};
-	});
+	return getAtscriptDbMate().decorate((current) => ({
+		...current,
+		atscript_db_action: mergeActionMeta(current, { opts: { default: true } })
+	}));
 }
 //#endregion
 //#region src/actions/id-source.ts
@@ -2388,10 +2380,9 @@ function DbActionDefault() {
 * Marks the param so {@link discoverActions} can infer the action's `level`.
 */
 function createIdParamDecorator(kind) {
-	const mate = (0, moost.getMoostMate)();
 	const resolverName = kind === "id" ? "dbActionId" : "dbActionIds";
 	const resolver = kind === "id" ? async () => (0, _wooksjs_event_core.current)().get(dbActionIdSlot) : async () => (0, _wooksjs_event_core.current)().get(dbActionIdsSlot);
-	return (0, moost.ApplyDecorators)(mate.decorate(MOOST_DB_ACTION_PARAM, kind), (0, moost.Resolve)(resolver, resolverName));
+	return (0, moost.ApplyDecorators)(getAtscriptDbMate().decorate("atscript_db_action_param", kind), (0, moost.Resolve)(resolver, resolverName));
 }
 //#endregion
 //#region src/actions/db-action-id.decorator.ts
@@ -2446,7 +2437,7 @@ function DbActionIDs() {
 //#endregion
 //#region src/actions/db-action-row.decorator.ts
 function createRowParamDecorator(metaKey, slot, resolverName) {
-	return (0, moost.ApplyDecorators)((0, moost.getMoostMate)().decorate(metaKey, true), (0, moost.Resolve)(async () => (0, _wooksjs_event_core.current)().get(slot), resolverName));
+	return (0, moost.ApplyDecorators)(getAtscriptDbMate().decorate(metaKey, true), (0, moost.Resolve)(async () => (0, _wooksjs_event_core.current)().get(slot), resolverName));
 }
 /**
 * Parameter decorator that injects the row whose identifier was supplied in
@@ -2460,7 +2451,7 @@ function createRowParamDecorator(metaKey, slot, resolverName) {
 * request-body row is not retrievable.
 */
 function DbActionRow() {
-	return createRowParamDecorator(MOOST_DB_ACTION_ROW, dbActionRowSlot, "dbActionRow");
+	return createRowParamDecorator("atscript_db_action_row", dbActionRowSlot, "dbActionRow");
 }
 /**
 * Parameter decorator that injects the rows fetched by the identifiers
@@ -2471,7 +2462,7 @@ function DbActionRow() {
 * gate's surviving rows.
 */
 function DbActionRows() {
-	return createRowParamDecorator(MOOST_DB_ACTION_ROWS, dbActionRowsSlot, "dbActionRows");
+	return createRowParamDecorator("atscript_db_action_rows", dbActionRowsSlot, "dbActionRows");
 }
 //#endregion
 //#region src/actions/db-actions.decorator.ts
@@ -2516,13 +2507,10 @@ function classLevelActions(dict, forcedLevel) {
 			entry: merged
 		});
 	}
-	return (0, moost.getMoostMate)().decorate((current) => {
-		const existing = current["atscript_db_actions"] ?? [];
-		return {
-			...current,
-			[MOOST_DB_ACTIONS]: [...existing, ...entries]
-		};
-	});
+	return getAtscriptDbMate().decorate((current) => ({
+		...current,
+		atscript_db_actions: [...current.atscript_db_actions ?? [], ...entries]
+	}));
 }
 //#endregion
 //#region src/actions/db-action-input-form.decorator.ts
@@ -2532,19 +2520,19 @@ function classLevelActions(dict, forcedLevel) {
 *
 * Pairs the resolved value with two pieces of param-level metadata:
 *
-* 1. {@link MOOST_DB_ACTION_INPUT_FORM} — the compiled `.as` class plus its
-*    name, consumed by {@link discoverActions} to:
+* 1. `atscript_db_action_input_form` — the compiled `.as` class plus its
+*    name, consumed by `discoverActions` to:
 *    - emit `inputForm: FormType.name` on the action's `/meta` entry, and
 *    - register the type in the controller's form registry so
 *      `GET /meta/form/:name` can serve the serialized schema.
-* 2. {@link MOOST_ATSCRIPT_TYPE} — just the type ref, providing a generic
-*    hook any atscript-aware Moost pipe can read without knowing about the
+* 2. `atscript_type` — just the type ref, providing a generic hook any
+*    atscript-aware Moost pipe can read without knowing about the
 *    moost-db-specific key.
 *
 * Validation is intentionally *not* performed here. To validate `input`
 * against `FormType`, install an atscript validator pipe globally
 * (`app.applyGlobalPipes(...)`) or scope it via `@Pipe(...)`. The pipe reads
-* `MOOST_ATSCRIPT_TYPE` off the param and runs `FormType.validator()`.
+* `atscript_type` off the param and runs `FormType.validator()`.
 *
 * Only one `@InputForm()` per action is supported. To collect multiple
 * structured inputs, compose them into a single `.as` interface and pass an
@@ -2559,7 +2547,7 @@ function InputForm(formType) {
 		type: formType,
 		name: formType.name
 	};
-	return (0, moost.ApplyDecorators)(mate.decorate(MOOST_DB_ACTION_INPUT_FORM, meta), mate.decorate(MOOST_ATSCRIPT_TYPE, formType), (0, moost.Resolve)(async () => (0, _wooksjs_event_core.current)().get(dbActionInputSlot), "dbActionInputForm"));
+	return (0, moost.ApplyDecorators)(mate.decorate("atscript_db_action_input_form", meta), mate.decorate("atscript_type", formType), (0, moost.Resolve)(async () => (0, _wooksjs_event_core.current)().get(dbActionInputSlot), "dbActionInputForm"));
 }
 //#endregion
 //#region src/actions/per-row.ts
@@ -2619,8 +2607,6 @@ exports.DbRowActions = DbRowActions;
 exports.DbRowsActions = DbRowsActions;
 exports.DbTableActions = DbTableActions;
 exports.InputForm = InputForm;
-exports.MOOST_ATSCRIPT_TYPE = MOOST_ATSCRIPT_TYPE;
-exports.MOOST_DB_ACTION_INPUT_FORM = MOOST_DB_ACTION_INPUT_FORM;
 exports.ONE_CONTROLS = ONE_CONTROLS;
 exports.PAGES_CONTROLS = PAGES_CONTROLS;
 exports.QUERY_CONTROLS = QUERY_CONTROLS;
@@ -2633,6 +2619,7 @@ exports.ViewController = ViewController;
 exports.dbActionBodySlot = dbActionBodySlot;
 exports.dbActionInputSlot = dbActionInputSlot;
 exports.discoverActions = discoverActions;
+exports.getAtscriptDbMate = getAtscriptDbMate;
 exports.getControllerFormType = getControllerFormType;
 exports.perRow = perRow;
 exports.useDbActionId = useDbActionId;

package/dist/index.d.cts

@@ -4,7 +4,7 @@ import { TAtscriptAnnotatedType, TAtscriptDataType, TSerializeOptions, TSerializ
 import { AtscriptDbReadable, AtscriptDbTable, FilterExpr, FlatOf, TCrudOp, TCrudPermissions, TCrudPermissions as TCrudPermissions$1, TDbActionInfo, TDbActionInfo as TDbActionInfo$1, TDbActionIntent, TDbActionIntent as TDbActionIntent$1, TDbActionLevel, TDbActionLevel as TDbActionLevel$1, TDbActionProcessor, TDbFieldMeta, TIdentification, TMetaResponse, Uniquery, UniqueryControls } from "@atscript/db";
 import { HttpError } from "@moostjs/event-http";
 import * as moost from "moost";
-import { Moost, TConsoleBase } from "moost";
+import { Mate, Moost, TConsoleBase, TMateParamMeta, TMoostMetadata } from "moost";
 import * as _wooksjs_event_core0 from "@wooksjs/event-core";
 
 //#region src/as-readable.controller.d.ts
@@ -640,7 +640,7 @@ type ValidatedUnpinnedDict<TRow, D extends DbActionsDictBase> = { [K in keyof D]
 //#region src/actions/db-action.decorator.d.ts
 /**
  * Mark a controller method as a database action surfaced via `/meta`. Writes
- * `MOOST_DB_ACTION` metadata and registers a Moost interceptor when needed
+ * `atscript_db_action` metadata and registers a Moost interceptor when needed
  * (gate when `disabled` is set, thin bound-table injector when only
  * `@DbActionRow*` is present). Stacking two `@DbAction` on the same method
  * is undefined and emits a warning.
@@ -758,19 +758,19 @@ declare function DbRowsActions<TRow = unknown, const D extends Record<string, un
  *
  * Pairs the resolved value with two pieces of param-level metadata:
  *
- * 1. {@link MOOST_DB_ACTION_INPUT_FORM} — the compiled `.as` class plus its
- *    name, consumed by {@link discoverActions} to:
+ * 1. `atscript_db_action_input_form` — the compiled `.as` class plus its
+ *    name, consumed by `discoverActions` to:
  *    - emit `inputForm: FormType.name` on the action's `/meta` entry, and
  *    - register the type in the controller's form registry so
  *      `GET /meta/form/:name` can serve the serialized schema.
- * 2. {@link MOOST_ATSCRIPT_TYPE} — just the type ref, providing a generic
- *    hook any atscript-aware Moost pipe can read without knowing about the
+ * 2. `atscript_type` — just the type ref, providing a generic hook any
+ *    atscript-aware Moost pipe can read without knowing about the
  *    moost-db-specific key.
  *
  * Validation is intentionally *not* performed here. To validate `input`
  * against `FormType`, install an atscript validator pipe globally
  * (`app.applyGlobalPipes(...)`) or scope it via `@Pipe(...)`. The pipe reads
- * `MOOST_ATSCRIPT_TYPE` off the param and runs `FormType.validator()`.
+ * `atscript_type` off the param and runs `FormType.validator()`.
  *
  * Only one `@InputForm()` per action is supported. To collect multiple
  * structured inputs, compose them into a single `.as` interface and pass an
@@ -850,30 +850,6 @@ declare const useDbActionInput: _wooksjs_event_core0.WookComposable<{
 }>;
 //#endregion
 //#region src/actions/keys.d.ts
-/** Method-level metadata key — written by `@DbAction(name, opts)`. */
-declare const MOOST_DB_ACTION = "atscript_db_action";
-/** Class-level metadata key — written by `@DbActions` and the level-pinned shortcuts. Stored as an array; decorators accumulate. */
-declare const MOOST_DB_ACTIONS = "atscript_db_actions";
-/** Param-level metadata key — written by `@DbActionID()` / `@DbActionIDs()`. Drives level inference. */
-declare const MOOST_DB_ACTION_PARAM = "atscript_db_action_param";
-/** Param-level marker keys — written by `@DbActionRow()` / `@DbActionRows()`. */
-declare const MOOST_DB_ACTION_ROW = "atscript_db_action_row";
-declare const MOOST_DB_ACTION_ROWS = "atscript_db_action_rows";
-/**
- * Param-level metadata key — written by `@InputForm(FormType)`. Carries the
- * compiled `.as` class plus its `.name` so {@link discoverActions} can both
- * emit `inputForm` on `/meta` and register the type in the controller's form
- * registry for `GET /meta/form/:name`.
- */
-declare const MOOST_DB_ACTION_INPUT_FORM = "atscript_db_action_input_form";
-/**
- * Generic param-level metadata key — written by `@InputForm(FormType)`
- * alongside {@link MOOST_DB_ACTION_INPUT_FORM}. Holds just the type ref so a
- * generic atscript-aware Moost pipe (installed globally via
- * `app.applyGlobalPipes(...)` or scoped via `@Pipe(...)`) can validate the
- * resolved value without knowing about the moost-db-specific key.
- */
-declare const MOOST_ATSCRIPT_TYPE = "atscript_type";
 type TDbActionRowMarker = true;
 /** Stamped by `@InputForm(FormType)` — the compiled `.as` class + the wire name (`FormType.name`). */
 interface TDbActionInputFormMeta {
@@ -894,18 +870,18 @@ interface TDbClassActionMeta {
 type TDbActionParamKind = "id" | "ids";
 declare module "moost" {
   interface TMoostMetadata {
-    [MOOST_DB_ACTION]?: TDbActionMeta;
-    [MOOST_DB_ACTIONS]?: TDbClassActionMeta[];
-    [MOOST_DB_ACTION_PARAM]?: TDbActionParamKind;
-    [MOOST_DB_ACTION_ROW]?: TDbActionRowMarker;
-    [MOOST_DB_ACTION_ROWS]?: TDbActionRowMarker;
+    atscript_db_action?: TDbActionMeta;
+    atscript_db_actions?: TDbClassActionMeta[];
+    atscript_db_action_param?: TDbActionParamKind;
+    atscript_db_action_row?: TDbActionRowMarker;
+    atscript_db_action_rows?: TDbActionRowMarker;
   }
   interface TMoostParamsMetadata {
-    [MOOST_DB_ACTION_PARAM]?: TDbActionParamKind;
-    [MOOST_DB_ACTION_ROW]?: TDbActionRowMarker;
-    [MOOST_DB_ACTION_ROWS]?: TDbActionRowMarker;
-    [MOOST_DB_ACTION_INPUT_FORM]?: TDbActionInputFormMeta;
-    [MOOST_ATSCRIPT_TYPE]?: TAtscriptAnnotatedType;
+    atscript_db_action_param?: TDbActionParamKind;
+    atscript_db_action_row?: TDbActionRowMarker;
+    atscript_db_action_rows?: TDbActionRowMarker;
+    atscript_db_action_input_form?: TDbActionInputFormMeta;
+    atscript_type?: TAtscriptAnnotatedType;
   }
 }
 //#endregion
@@ -964,9 +940,95 @@ declare class ActionDisabledError extends HttpError<ActionDisabledErrorBody> {
  */
 declare const perRow: <TRow>(fn: (row: TRow) => boolean) => (rows: TRow[]) => boolean[];
 //#endregion
+//#region src/mate.d.ts
+/**
+ * Class- and method-level metadata written by `@atscript/moost-db`'s
+ * decorators (`@DbAction`, `@DbActionDefault`, `@DbActions`,
+ * `@DbTableActions`, `@DbRowActions`, `@DbRowsActions`).
+ *
+ * The keys are intentionally kept identical to the underlying
+ * mate-storage keys (`atscript_db_*`) so the same shape applies whether
+ * the consumer reads via {@link getAtscriptDbMate} or pokes the raw
+ * `getMoostMate()` instance directly. End-users never need to type the
+ * magic strings — `mate.read(...)?.atscript_db_action` is fully typed.
+ */
+interface AtscriptDbMeta {
+  /** Method-level — written by `@DbAction(name, opts)` / `@DbActionDefault()`. */
+  atscript_db_action?: TDbActionMeta;
+  /** Class-level — written by `@DbActions` and the level-pinned shortcuts. Decorators accumulate into the array. */
+  atscript_db_actions?: TDbClassActionMeta[];
+  /** Param-level marker — written by `@DbActionID()` / `@DbActionIDs()`. Drives action-level inference. */
+  atscript_db_action_param?: TDbActionParamKind;
+  /** Param-level marker — written by `@DbActionRow()`. */
+  atscript_db_action_row?: true;
+  /** Param-level marker — written by `@DbActionRows()`. */
+  atscript_db_action_rows?: true;
+}
+/**
+ * Param-level metadata written by `@atscript/moost-db`'s param
+ * decorators. A superset of {@link AtscriptDbMeta}'s param-level keys
+ * plus the `@InputForm()`-specific entries.
+ */
+interface AtscriptDbParamsMeta {
+  /** Param-level — written by `@DbActionID()` / `@DbActionIDs()`. */
+  atscript_db_action_param?: TDbActionParamKind;
+  /** Param-level marker — written by `@DbActionRow()`. */
+  atscript_db_action_row?: true;
+  /** Param-level marker — written by `@DbActionRows()`. */
+  atscript_db_action_rows?: true;
+  /**
+   * Param-level — written by `@InputForm(FormType)`. Carries the
+   * compiled `.as` class plus its `.name` so `discoverActions` can both
+   * emit `inputForm` on `/meta` and register the type in the controller's
+   * form registry for `GET /meta/form/:name`.
+   */
+  atscript_db_action_input_form?: TDbActionInputFormMeta;
+  /**
+   * Param-level — written by `@InputForm(FormType)` alongside
+   * `atscript_db_action_input_form`. Holds just the type ref so a generic
+   * atscript-aware Moost pipe (installed globally via
+   * `app.applyGlobalPipes(...)` or scoped via `@Pipe(...)`) can validate
+   * the resolved value without knowing about the moost-db-specific key.
+   */
+  atscript_type?: TAtscriptAnnotatedType;
+}
+/**
+ * The fully-typed {@link Mate} instance shared across the moost
+ * metadata workspace, narrowed to the keys that
+ * `@atscript/moost-db` writes.
+ *
+ * Class- and prop-meta storage mirror the same shape; param-meta
+ * storage uses {@link AtscriptDbParamsMeta}.
+ */
+type AtscriptDbMate = Mate<TMoostMetadata & AtscriptDbMeta & {
+  params: (TMateParamMeta & AtscriptDbParamsMeta)[];
+}, TMoostMetadata & AtscriptDbMeta & {
+  params: (TMateParamMeta & AtscriptDbParamsMeta)[];
+}>;
+/**
+ * Returns the shared moost-mate instance, typed against every key that
+ * `@atscript/moost-db` writes (see {@link AtscriptDbMeta} +
+ * {@link AtscriptDbParamsMeta}).
+ *
+ * Prefer this over `getMoostMate()` from `moost` whenever you need to
+ * read moost-db metadata — callers no longer have to retype the
+ * `atscript_db_*` magic strings or hand-cast the result.
+ *
+ * @example
+ * ```ts
+ * import { getAtscriptDbMate } from "@atscript/moost-db";
+ *
+ * const mate = getAtscriptDbMate();
+ * const meta = mate.read(controllerCtor.prototype, methodName);
+ * const dbAction = meta?.atscript_db_action;       // TDbActionMeta | undefined
+ * const inputForm = meta?.params?.[0]?.atscript_db_action_input_form;
+ * ```
+ */
+declare function getAtscriptDbMate(): AtscriptDbMate;
+//#endregion
 //#region src/permissions/crud-controls.d.ts
 declare const QUERY_CONTROLS: readonly string[];
 declare const PAGES_CONTROLS: readonly string[];
 declare const ONE_CONTROLS: readonly string[];
 //#endregion
-export { ActionDisabledError, type ActionDisabledErrorBody, AsDbController, AsDbReadableController, AsJsonValueHelpController, AsReadableController, AsValueHelpController, DbAction, DbActionDefault, type DbActionEnvelope, DbActionID, DbActionIDs, type DbActionOpts, DbActionRow, DbActionRows, DbActions, DbRowActions, DbRowsActions, DbTableActions, type IdValidationSource, InputForm, MOOST_ATSCRIPT_TYPE, MOOST_DB_ACTION_INPUT_FORM, ONE_CONTROLS, PAGES_CONTROLS, QUERY_CONTROLS, READABLE_DEF, ReadableController, ReadableGates, TABLE_DEF, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionInputFormMeta, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbActionsEntry, type TDbActionsEntryUnpinned, TableController, UseValidationErrorTransform, ValueHelpQuery, ViewController, dbActionBodySlot, dbActionInputSlot, discoverActions, getControllerFormType, perRow, useDbActionId, useDbActionIds, useDbActionInput, useDbActionRow, useDbActionRows, validationErrorTransform };
+export { ActionDisabledError, type ActionDisabledErrorBody, AsDbController, AsDbReadableController, AsJsonValueHelpController, AsReadableController, AsValueHelpController, type AtscriptDbMate, type AtscriptDbMeta, type AtscriptDbParamsMeta, DbAction, DbActionDefault, type DbActionEnvelope, DbActionID, DbActionIDs, type DbActionOpts, DbActionRow, DbActionRows, DbActions, DbRowActions, DbRowsActions, DbTableActions, type IdValidationSource, InputForm, ONE_CONTROLS, PAGES_CONTROLS, QUERY_CONTROLS, READABLE_DEF, ReadableController, ReadableGates, TABLE_DEF, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionInputFormMeta, type TDbActionIntent, type TDbActionLevel, type TDbActionMeta, type TDbActionParamKind, type TDbActionProcessor, type TDbActionsEntry, type TDbActionsEntryUnpinned, type TDbClassActionMeta, TableController, UseValidationErrorTransform, ValueHelpQuery, ViewController, dbActionBodySlot, dbActionInputSlot, discoverActions, getAtscriptDbMate, getControllerFormType, perRow, useDbActionId, useDbActionIds, useDbActionInput, useDbActionRow, useDbActionRows, validationErrorTransform };

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { TAtscriptAnnotatedType, TAtscriptDataType, TSerializeOptions, TSerializedAnnotatedType, Validator } from "@atscript/typescript/utils";
 import { HttpError } from "@moostjs/event-http";
 import * as moost from "moost";
-import { Moost, TConsoleBase } from "moost";
+import { Mate, Moost, TConsoleBase, TMateParamMeta, TMoostMetadata } from "moost";
 import * as _uniqu_url0 from "@uniqu/url";
 import { parseUrl } from "@uniqu/url";
 import { AtscriptDbReadable, AtscriptDbTable, FilterExpr, FlatOf, TCrudOp, TCrudPermissions, TCrudPermissions as TCrudPermissions$1, TDbActionInfo, TDbActionInfo as TDbActionInfo$1, TDbActionIntent, TDbActionIntent as TDbActionIntent$1, TDbActionLevel, TDbActionLevel as TDbActionLevel$1, TDbActionProcessor, TDbFieldMeta, TIdentification, TMetaResponse, Uniquery, UniqueryControls } from "@atscript/db";
@@ -640,7 +640,7 @@ type ValidatedUnpinnedDict<TRow, D extends DbActionsDictBase> = { [K in keyof D]
 //#region src/actions/db-action.decorator.d.ts
 /**
  * Mark a controller method as a database action surfaced via `/meta`. Writes
- * `MOOST_DB_ACTION` metadata and registers a Moost interceptor when needed
+ * `atscript_db_action` metadata and registers a Moost interceptor when needed
  * (gate when `disabled` is set, thin bound-table injector when only
  * `@DbActionRow*` is present). Stacking two `@DbAction` on the same method
  * is undefined and emits a warning.
@@ -758,19 +758,19 @@ declare function DbRowsActions<TRow = unknown, const D extends Record<string, un
  *
  * Pairs the resolved value with two pieces of param-level metadata:
  *
- * 1. {@link MOOST_DB_ACTION_INPUT_FORM} — the compiled `.as` class plus its
- *    name, consumed by {@link discoverActions} to:
+ * 1. `atscript_db_action_input_form` — the compiled `.as` class plus its
+ *    name, consumed by `discoverActions` to:
  *    - emit `inputForm: FormType.name` on the action's `/meta` entry, and
  *    - register the type in the controller's form registry so
  *      `GET /meta/form/:name` can serve the serialized schema.
- * 2. {@link MOOST_ATSCRIPT_TYPE} — just the type ref, providing a generic
- *    hook any atscript-aware Moost pipe can read without knowing about the
+ * 2. `atscript_type` — just the type ref, providing a generic hook any
+ *    atscript-aware Moost pipe can read without knowing about the
  *    moost-db-specific key.
  *
  * Validation is intentionally *not* performed here. To validate `input`
  * against `FormType`, install an atscript validator pipe globally
  * (`app.applyGlobalPipes(...)`) or scope it via `@Pipe(...)`. The pipe reads
- * `MOOST_ATSCRIPT_TYPE` off the param and runs `FormType.validator()`.
+ * `atscript_type` off the param and runs `FormType.validator()`.
  *
  * Only one `@InputForm()` per action is supported. To collect multiple
  * structured inputs, compose them into a single `.as` interface and pass an
@@ -850,30 +850,6 @@ declare const useDbActionInput: _wooksjs_event_core0.WookComposable<{
 }>;
 //#endregion
 //#region src/actions/keys.d.ts
-/** Method-level metadata key — written by `@DbAction(name, opts)`. */
-declare const MOOST_DB_ACTION = "atscript_db_action";
-/** Class-level metadata key — written by `@DbActions` and the level-pinned shortcuts. Stored as an array; decorators accumulate. */
-declare const MOOST_DB_ACTIONS = "atscript_db_actions";
-/** Param-level metadata key — written by `@DbActionID()` / `@DbActionIDs()`. Drives level inference. */
-declare const MOOST_DB_ACTION_PARAM = "atscript_db_action_param";
-/** Param-level marker keys — written by `@DbActionRow()` / `@DbActionRows()`. */
-declare const MOOST_DB_ACTION_ROW = "atscript_db_action_row";
-declare const MOOST_DB_ACTION_ROWS = "atscript_db_action_rows";
-/**
- * Param-level metadata key — written by `@InputForm(FormType)`. Carries the
- * compiled `.as` class plus its `.name` so {@link discoverActions} can both
- * emit `inputForm` on `/meta` and register the type in the controller's form
- * registry for `GET /meta/form/:name`.
- */
-declare const MOOST_DB_ACTION_INPUT_FORM = "atscript_db_action_input_form";
-/**
- * Generic param-level metadata key — written by `@InputForm(FormType)`
- * alongside {@link MOOST_DB_ACTION_INPUT_FORM}. Holds just the type ref so a
- * generic atscript-aware Moost pipe (installed globally via
- * `app.applyGlobalPipes(...)` or scoped via `@Pipe(...)`) can validate the
- * resolved value without knowing about the moost-db-specific key.
- */
-declare const MOOST_ATSCRIPT_TYPE = "atscript_type";
 type TDbActionRowMarker = true;
 /** Stamped by `@InputForm(FormType)` — the compiled `.as` class + the wire name (`FormType.name`). */
 interface TDbActionInputFormMeta {
@@ -894,18 +870,18 @@ interface TDbClassActionMeta {
 type TDbActionParamKind = "id" | "ids";
 declare module "moost" {
   interface TMoostMetadata {
-    [MOOST_DB_ACTION]?: TDbActionMeta;
-    [MOOST_DB_ACTIONS]?: TDbClassActionMeta[];
-    [MOOST_DB_ACTION_PARAM]?: TDbActionParamKind;
-    [MOOST_DB_ACTION_ROW]?: TDbActionRowMarker;
-    [MOOST_DB_ACTION_ROWS]?: TDbActionRowMarker;
+    atscript_db_action?: TDbActionMeta;
+    atscript_db_actions?: TDbClassActionMeta[];
+    atscript_db_action_param?: TDbActionParamKind;
+    atscript_db_action_row?: TDbActionRowMarker;
+    atscript_db_action_rows?: TDbActionRowMarker;
   }
   interface TMoostParamsMetadata {
-    [MOOST_DB_ACTION_PARAM]?: TDbActionParamKind;
-    [MOOST_DB_ACTION_ROW]?: TDbActionRowMarker;
-    [MOOST_DB_ACTION_ROWS]?: TDbActionRowMarker;
-    [MOOST_DB_ACTION_INPUT_FORM]?: TDbActionInputFormMeta;
-    [MOOST_ATSCRIPT_TYPE]?: TAtscriptAnnotatedType;
+    atscript_db_action_param?: TDbActionParamKind;
+    atscript_db_action_row?: TDbActionRowMarker;
+    atscript_db_action_rows?: TDbActionRowMarker;
+    atscript_db_action_input_form?: TDbActionInputFormMeta;
+    atscript_type?: TAtscriptAnnotatedType;
   }
 }
 //#endregion
@@ -964,9 +940,95 @@ declare class ActionDisabledError extends HttpError<ActionDisabledErrorBody> {
  */
 declare const perRow: <TRow>(fn: (row: TRow) => boolean) => (rows: TRow[]) => boolean[];
 //#endregion
+//#region src/mate.d.ts
+/**
+ * Class- and method-level metadata written by `@atscript/moost-db`'s
+ * decorators (`@DbAction`, `@DbActionDefault`, `@DbActions`,
+ * `@DbTableActions`, `@DbRowActions`, `@DbRowsActions`).
+ *
+ * The keys are intentionally kept identical to the underlying
+ * mate-storage keys (`atscript_db_*`) so the same shape applies whether
+ * the consumer reads via {@link getAtscriptDbMate} or pokes the raw
+ * `getMoostMate()` instance directly. End-users never need to type the
+ * magic strings — `mate.read(...)?.atscript_db_action` is fully typed.
+ */
+interface AtscriptDbMeta {
+  /** Method-level — written by `@DbAction(name, opts)` / `@DbActionDefault()`. */
+  atscript_db_action?: TDbActionMeta;
+  /** Class-level — written by `@DbActions` and the level-pinned shortcuts. Decorators accumulate into the array. */
+  atscript_db_actions?: TDbClassActionMeta[];
+  /** Param-level marker — written by `@DbActionID()` / `@DbActionIDs()`. Drives action-level inference. */
+  atscript_db_action_param?: TDbActionParamKind;
+  /** Param-level marker — written by `@DbActionRow()`. */
+  atscript_db_action_row?: true;
+  /** Param-level marker — written by `@DbActionRows()`. */
+  atscript_db_action_rows?: true;
+}
+/**
+ * Param-level metadata written by `@atscript/moost-db`'s param
+ * decorators. A superset of {@link AtscriptDbMeta}'s param-level keys
+ * plus the `@InputForm()`-specific entries.
+ */
+interface AtscriptDbParamsMeta {
+  /** Param-level — written by `@DbActionID()` / `@DbActionIDs()`. */
+  atscript_db_action_param?: TDbActionParamKind;
+  /** Param-level marker — written by `@DbActionRow()`. */
+  atscript_db_action_row?: true;
+  /** Param-level marker — written by `@DbActionRows()`. */
+  atscript_db_action_rows?: true;
+  /**
+   * Param-level — written by `@InputForm(FormType)`. Carries the
+   * compiled `.as` class plus its `.name` so `discoverActions` can both
+   * emit `inputForm` on `/meta` and register the type in the controller's
+   * form registry for `GET /meta/form/:name`.
+   */
+  atscript_db_action_input_form?: TDbActionInputFormMeta;
+  /**
+   * Param-level — written by `@InputForm(FormType)` alongside
+   * `atscript_db_action_input_form`. Holds just the type ref so a generic
+   * atscript-aware Moost pipe (installed globally via
+   * `app.applyGlobalPipes(...)` or scoped via `@Pipe(...)`) can validate
+   * the resolved value without knowing about the moost-db-specific key.
+   */
+  atscript_type?: TAtscriptAnnotatedType;
+}
+/**
+ * The fully-typed {@link Mate} instance shared across the moost
+ * metadata workspace, narrowed to the keys that
+ * `@atscript/moost-db` writes.
+ *
+ * Class- and prop-meta storage mirror the same shape; param-meta
+ * storage uses {@link AtscriptDbParamsMeta}.
+ */
+type AtscriptDbMate = Mate<TMoostMetadata & AtscriptDbMeta & {
+  params: (TMateParamMeta & AtscriptDbParamsMeta)[];
+}, TMoostMetadata & AtscriptDbMeta & {
+  params: (TMateParamMeta & AtscriptDbParamsMeta)[];
+}>;
+/**
+ * Returns the shared moost-mate instance, typed against every key that
+ * `@atscript/moost-db` writes (see {@link AtscriptDbMeta} +
+ * {@link AtscriptDbParamsMeta}).
+ *
+ * Prefer this over `getMoostMate()` from `moost` whenever you need to
+ * read moost-db metadata — callers no longer have to retype the
+ * `atscript_db_*` magic strings or hand-cast the result.
+ *
+ * @example
+ * ```ts
+ * import { getAtscriptDbMate } from "@atscript/moost-db";
+ *
+ * const mate = getAtscriptDbMate();
+ * const meta = mate.read(controllerCtor.prototype, methodName);
+ * const dbAction = meta?.atscript_db_action;       // TDbActionMeta | undefined
+ * const inputForm = meta?.params?.[0]?.atscript_db_action_input_form;
+ * ```
+ */
+declare function getAtscriptDbMate(): AtscriptDbMate;
+//#endregion
 //#region src/permissions/crud-controls.d.ts
 declare const QUERY_CONTROLS: readonly string[];
 declare const PAGES_CONTROLS: readonly string[];
 declare const ONE_CONTROLS: readonly string[];
 //#endregion
-export { ActionDisabledError, type ActionDisabledErrorBody, AsDbController, AsDbReadableController, AsJsonValueHelpController, AsReadableController, AsValueHelpController, DbAction, DbActionDefault, type DbActionEnvelope, DbActionID, DbActionIDs, type DbActionOpts, DbActionRow, DbActionRows, DbActions, DbRowActions, DbRowsActions, DbTableActions, type IdValidationSource, InputForm, MOOST_ATSCRIPT_TYPE, MOOST_DB_ACTION_INPUT_FORM, ONE_CONTROLS, PAGES_CONTROLS, QUERY_CONTROLS, READABLE_DEF, ReadableController, ReadableGates, TABLE_DEF, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionInputFormMeta, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbActionsEntry, type TDbActionsEntryUnpinned, TableController, UseValidationErrorTransform, ValueHelpQuery, ViewController, dbActionBodySlot, dbActionInputSlot, discoverActions, getControllerFormType, perRow, useDbActionId, useDbActionIds, useDbActionInput, useDbActionRow, useDbActionRows, validationErrorTransform };
+export { ActionDisabledError, type ActionDisabledErrorBody, AsDbController, AsDbReadableController, AsJsonValueHelpController, AsReadableController, AsValueHelpController, type AtscriptDbMate, type AtscriptDbMeta, type AtscriptDbParamsMeta, DbAction, DbActionDefault, type DbActionEnvelope, DbActionID, DbActionIDs, type DbActionOpts, DbActionRow, DbActionRows, DbActions, DbRowActions, DbRowsActions, DbTableActions, type IdValidationSource, InputForm, ONE_CONTROLS, PAGES_CONTROLS, QUERY_CONTROLS, READABLE_DEF, ReadableController, ReadableGates, TABLE_DEF, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionInputFormMeta, type TDbActionIntent, type TDbActionLevel, type TDbActionMeta, type TDbActionParamKind, type TDbActionProcessor, type TDbActionsEntry, type TDbActionsEntryUnpinned, type TDbClassActionMeta, TableController, UseValidationErrorTransform, ValueHelpQuery, ViewController, dbActionBodySlot, dbActionInputSlot, discoverActions, getAtscriptDbMate, getControllerFormType, perRow, useDbActionId, useDbActionIds, useDbActionInput, useDbActionRow, useDbActionRows, validationErrorTransform };

package/dist/index.mjs

@@ -181,6 +181,30 @@ function findSortOffender(sort, isAllowed) {
 	}
 }
 //#endregion
+//#region src/mate.ts
+/**
+* Returns the shared moost-mate instance, typed against every key that
+* `@atscript/moost-db` writes (see {@link AtscriptDbMeta} +
+* {@link AtscriptDbParamsMeta}).
+*
+* Prefer this over `getMoostMate()` from `moost` whenever you need to
+* read moost-db metadata — callers no longer have to retype the
+* `atscript_db_*` magic strings or hand-cast the result.
+*
+* @example
+* ```ts
+* import { getAtscriptDbMate } from "@atscript/moost-db";
+*
+* const mate = getAtscriptDbMate();
+* const meta = mate.read(controllerCtor.prototype, methodName);
+* const dbAction = meta?.atscript_db_action;       // TDbActionMeta | undefined
+* const inputForm = meta?.params?.[0]?.atscript_db_action_input_form;
+* ```
+*/
+function getAtscriptDbMate() {
+	return getMoostMate();
+}
+//#endregion
 //#region src/actions/controller-registry.ts
 let asDbReadableCtor = null;
 let asValueHelpCtor = null;
@@ -202,38 +226,14 @@ function isAsValueHelpControllerSubclass(ctor) {
 //#region src/actions/keys.ts
 /** Log-message prefix for warnings emitted from the actions subsystem. */
 const WARN_PREFIX = "[moost-db actions]";
-/** Method-level metadata key — written by `@DbAction(name, opts)`. */
-const MOOST_DB_ACTION = "atscript_db_action";
-/** Class-level metadata key — written by `@DbActions` and the level-pinned shortcuts. Stored as an array; decorators accumulate. */
-const MOOST_DB_ACTIONS = "atscript_db_actions";
-/** Param-level metadata key — written by `@DbActionID()` / `@DbActionIDs()`. Drives level inference. */
-const MOOST_DB_ACTION_PARAM = "atscript_db_action_param";
-/** Param-level marker keys — written by `@DbActionRow()` / `@DbActionRows()`. */
-const MOOST_DB_ACTION_ROW = "atscript_db_action_row";
-const MOOST_DB_ACTION_ROWS = "atscript_db_action_rows";
-/**
-* Param-level metadata key — written by `@InputForm(FormType)`. Carries the
-* compiled `.as` class plus its `.name` so {@link discoverActions} can both
-* emit `inputForm` on `/meta` and register the type in the controller's form
-* registry for `GET /meta/form/:name`.
-*/
-const MOOST_DB_ACTION_INPUT_FORM = "atscript_db_action_input_form";
-/**
-* Generic param-level metadata key — written by `@InputForm(FormType)`
-* alongside {@link MOOST_DB_ACTION_INPUT_FORM}. Holds just the type ref so a
-* generic atscript-aware Moost pipe (installed globally via
-* `app.applyGlobalPipes(...)` or scoped via `@Pipe(...)`) can validate the
-* resolved value without knowing about the moost-db-specific key.
-*/
-const MOOST_ATSCRIPT_TYPE = "atscript_type";
 /**
 * Shared method-decorator update used by `@DbAction` and `@DbActionDefault`:
-* read the existing `MOOST_DB_ACTION` slot, merge the patch (later-applied
+* read the existing `atscript_db_action` slot, merge the patch (later-applied
 * fields win), and write it back. `name` is empty until `@DbAction` provides
 * one — `discoverActions` warns and drops actions with no name.
 */
 function mergeActionMeta(current, patch) {
-	const existing = current[MOOST_DB_ACTION];
+	const existing = current.atscript_db_action;
 	return {
 		name: patch.name ?? existing?.name ?? "",
 		opts: {
@@ -252,21 +252,19 @@ function scanParamLevel(params) {
 	let inputForm;
 	let hasDuplicateInputForm = false;
 	for (const p of params) {
-		const kind = p[MOOST_DB_ACTION_PARAM];
-		if (kind === "id") single = true;
-		else if (kind === "ids") multi = true;
-		if (p["atscript_db_action_row"]) {
+		if (p.atscript_db_action_param === "id") single = true;
+		else if (p.atscript_db_action_param === "ids") multi = true;
+		if (p.atscript_db_action_row) {
 			single = true;
 			hasRowParam = true;
 		}
-		if (p["atscript_db_action_rows"]) {
+		if (p.atscript_db_action_rows) {
 			multi = true;
 			hasRowParam = true;
 		}
 		if (p.paramSource === "BODY") hasBody = true;
-		const form = p[MOOST_DB_ACTION_INPUT_FORM];
-		if (form) if (inputForm) hasDuplicateInputForm = true;
-		else inputForm = form;
+		if (p.atscript_db_action_input_form) if (inputForm) hasDuplicateInputForm = true;
+		else inputForm = p.atscript_db_action_input_form;
 	}
 	return {
 		level: single && multi ? "table" : single ? "row" : multi ? "rows" : "table",
@@ -295,7 +293,7 @@ const rowLevelActionsCache = /* @__PURE__ */ new WeakMap();
 /**
 * Per-controller registry of form names → compiled `.as` classes, populated
 * during {@link discoverActions} when a method param carries
-* {@link MOOST_DB_ACTION_INPUT_FORM}. Backs `GET /meta/form/:name`.
+* `atscript_db_action_input_form`. Backs `GET /meta/form/:name`.
 *
 * Same name + same type ref across multiple actions is fine (forms can be
 * reused). Same name + *different* type refs is an ambiguity — discovery
@@ -351,7 +349,7 @@ function collectMethodActions(ctor, overview, logger, out, seen) {
 	}
 	for (const [methodName, handlers] of byMethod) {
 		const methodMeta = handlers[0].meta;
-		const action = methodMeta[MOOST_DB_ACTION];
+		const action = methodMeta.atscript_db_action;
 		if (!action) continue;
 		if (!action.name) {
 			logger.warn(`${WARN_PREFIX} method "${methodName}" has @DbActionDefault() but no @DbAction(name) — dropping`);
@@ -432,7 +430,7 @@ function inferMethodLevel(params, actionName, logger) {
 	};
 }
 function collectClassActions(ctor, logger, out, seen) {
-	const list = getMoostMate().read(ctor)?.[MOOST_DB_ACTIONS];
+	const list = getAtscriptDbMate().read(ctor)?.atscript_db_actions;
 	if (!list) return;
 	for (const { name, entry } of list) {
 		if (seen.has(name)) {
@@ -2020,7 +2018,7 @@ function readCurrentActionMeta(ctx) {
 		return;
 	}
 	if (!ctrl || !methodName) return void 0;
-	return getMoostMate().read(ctrl.constructor, methodName)?.[MOOST_DB_ACTION];
+	return getAtscriptDbMate().read(ctrl.constructor, methodName)?.atscript_db_action;
 }
 //#endregion
 //#region src/actions/input-form-cache.ts
@@ -2322,7 +2320,7 @@ function buildThinInterceptor(opts) {
 //#region src/actions/db-action.decorator.ts
 /**
 * Mark a controller method as a database action surfaced via `/meta`. Writes
-* `MOOST_DB_ACTION` metadata and registers a Moost interceptor when needed
+* `atscript_db_action` metadata and registers a Moost interceptor when needed
 * (gate when `disabled` is set, thin bound-table injector when only
 * `@DbActionRow*` is present). Stacking two `@DbAction` on the same method
 * is undefined and emits a warning.
@@ -2333,20 +2331,17 @@ function buildThinInterceptor(opts) {
 * `Pick<FlatOf<TRow>, R[number]>[]`.
 */
 function DbAction(name, opts = {}) {
-	const mate = getMoostMate();
+	const mate = getAtscriptDbMate();
 	return ((target, propertyKey, descriptor) => {
-		const priorName = mate.read(target, propertyKey)?.[MOOST_DB_ACTION]?.name;
+		const priorName = mate.read(target, propertyKey)?.atscript_db_action?.name;
 		if (priorName) console.warn(`${WARN_PREFIX} stacking @DbAction on the same method is undefined; declare one per method. Detected: "${priorName}" and "${name}".`);
-		mate.decorate((current) => {
-			const meta = current;
-			return {
-				...current,
-				[MOOST_DB_ACTION]: mergeActionMeta(meta, {
-					name,
-					opts
-				})
-			};
-		})(target, propertyKey, descriptor);
+		mate.decorate((current) => ({
+			...current,
+			atscript_db_action: mergeActionMeta(current, {
+				name,
+				opts
+			})
+		}))(target, propertyKey, descriptor);
 		if (isAsValueHelpControllerSubclass(typeof target === "function" ? target : target.constructor)) return descriptor;
 		const scan = scanParamLevel(mate.read(target, propertyKey)?.params ?? []);
 		const rawOpts = opts;
@@ -2368,13 +2363,10 @@ function DbAction(name, opts = {}) {
 * Equivalent to passing `opts.default = true`. Decorator order does not matter.
 */
 function DbActionDefault() {
-	return getMoostMate().decorate((current) => {
-		const meta = current;
-		return {
-			...current,
-			[MOOST_DB_ACTION]: mergeActionMeta(meta, { opts: { default: true } })
-		};
-	});
+	return getAtscriptDbMate().decorate((current) => ({
+		...current,
+		atscript_db_action: mergeActionMeta(current, { opts: { default: true } })
+	}));
 }
 //#endregion
 //#region src/actions/id-source.ts
@@ -2387,10 +2379,9 @@ function DbActionDefault() {
 * Marks the param so {@link discoverActions} can infer the action's `level`.
 */
 function createIdParamDecorator(kind) {
-	const mate = getMoostMate();
 	const resolverName = kind === "id" ? "dbActionId" : "dbActionIds";
 	const resolver = kind === "id" ? async () => current().get(dbActionIdSlot) : async () => current().get(dbActionIdsSlot);
-	return ApplyDecorators(mate.decorate(MOOST_DB_ACTION_PARAM, kind), Resolve(resolver, resolverName));
+	return ApplyDecorators(getAtscriptDbMate().decorate("atscript_db_action_param", kind), Resolve(resolver, resolverName));
 }
 //#endregion
 //#region src/actions/db-action-id.decorator.ts
@@ -2445,7 +2436,7 @@ function DbActionIDs() {
 //#endregion
 //#region src/actions/db-action-row.decorator.ts
 function createRowParamDecorator(metaKey, slot, resolverName) {
-	return ApplyDecorators(getMoostMate().decorate(metaKey, true), Resolve(async () => current().get(slot), resolverName));
+	return ApplyDecorators(getAtscriptDbMate().decorate(metaKey, true), Resolve(async () => current().get(slot), resolverName));
 }
 /**
 * Parameter decorator that injects the row whose identifier was supplied in
@@ -2459,7 +2450,7 @@ function createRowParamDecorator(metaKey, slot, resolverName) {
 * request-body row is not retrievable.
 */
 function DbActionRow() {
-	return createRowParamDecorator(MOOST_DB_ACTION_ROW, dbActionRowSlot, "dbActionRow");
+	return createRowParamDecorator("atscript_db_action_row", dbActionRowSlot, "dbActionRow");
 }
 /**
 * Parameter decorator that injects the rows fetched by the identifiers
@@ -2470,7 +2461,7 @@ function DbActionRow() {
 * gate's surviving rows.
 */
 function DbActionRows() {
-	return createRowParamDecorator(MOOST_DB_ACTION_ROWS, dbActionRowsSlot, "dbActionRows");
+	return createRowParamDecorator("atscript_db_action_rows", dbActionRowsSlot, "dbActionRows");
 }
 //#endregion
 //#region src/actions/db-actions.decorator.ts
@@ -2515,13 +2506,10 @@ function classLevelActions(dict, forcedLevel) {
 			entry: merged
 		});
 	}
-	return getMoostMate().decorate((current) => {
-		const existing = current["atscript_db_actions"] ?? [];
-		return {
-			...current,
-			[MOOST_DB_ACTIONS]: [...existing, ...entries]
-		};
-	});
+	return getAtscriptDbMate().decorate((current) => ({
+		...current,
+		atscript_db_actions: [...current.atscript_db_actions ?? [], ...entries]
+	}));
 }
 //#endregion
 //#region src/actions/db-action-input-form.decorator.ts
@@ -2531,19 +2519,19 @@ function classLevelActions(dict, forcedLevel) {
 *
 * Pairs the resolved value with two pieces of param-level metadata:
 *
-* 1. {@link MOOST_DB_ACTION_INPUT_FORM} — the compiled `.as` class plus its
-*    name, consumed by {@link discoverActions} to:
+* 1. `atscript_db_action_input_form` — the compiled `.as` class plus its
+*    name, consumed by `discoverActions` to:
 *    - emit `inputForm: FormType.name` on the action's `/meta` entry, and
 *    - register the type in the controller's form registry so
 *      `GET /meta/form/:name` can serve the serialized schema.
-* 2. {@link MOOST_ATSCRIPT_TYPE} — just the type ref, providing a generic
-*    hook any atscript-aware Moost pipe can read without knowing about the
+* 2. `atscript_type` — just the type ref, providing a generic hook any
+*    atscript-aware Moost pipe can read without knowing about the
 *    moost-db-specific key.
 *
 * Validation is intentionally *not* performed here. To validate `input`
 * against `FormType`, install an atscript validator pipe globally
 * (`app.applyGlobalPipes(...)`) or scope it via `@Pipe(...)`. The pipe reads
-* `MOOST_ATSCRIPT_TYPE` off the param and runs `FormType.validator()`.
+* `atscript_type` off the param and runs `FormType.validator()`.
 *
 * Only one `@InputForm()` per action is supported. To collect multiple
 * structured inputs, compose them into a single `.as` interface and pass an
@@ -2558,7 +2546,7 @@ function InputForm(formType) {
 		type: formType,
 		name: formType.name
 	};
-	return ApplyDecorators(mate.decorate(MOOST_DB_ACTION_INPUT_FORM, meta), mate.decorate(MOOST_ATSCRIPT_TYPE, formType), Resolve(async () => current().get(dbActionInputSlot), "dbActionInputForm"));
+	return ApplyDecorators(mate.decorate("atscript_db_action_input_form", meta), mate.decorate("atscript_type", formType), Resolve(async () => current().get(dbActionInputSlot), "dbActionInputForm"));
 }
 //#endregion
 //#region src/actions/per-row.ts
@@ -2576,4 +2564,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, MOOST_ATSCRIPT_TYPE, MOOST_DB_ACTION_INPUT_FORM, ONE_CONTROLS, PAGES_CONTROLS, QUERY_CONTROLS, READABLE_DEF, ReadableController, TABLE_DEF, TableController, UseValidationErrorTransform, ViewController, dbActionBodySlot, dbActionInputSlot, discoverActions, getControllerFormType, perRow, useDbActionId, useDbActionIds, useDbActionInput, useDbActionRow, useDbActionRows, validationErrorTransform };
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/moost-db",
-  "version": "0.1.65",
+  "version": "0.1.67",
   "description": "Generic database controller for Moost with Atscript.",
   "keywords": [
     "annotations",
@@ -58,7 +58,7 @@
     "@wooksjs/event-core": "^0.7.10",
     "@wooksjs/http-body": "^0.7.10",
     "moost": "^0.6.8",
-    "@atscript/db": "^0.1.65"
+    "@atscript/db": "^0.1.67"
   },
   "scripts": {
     "postinstall": "asc -f dts",