@antelopejs/interface-dms 0.3.4 → 0.3.6

package/dist/base/table-view/internal/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../../../src/base/table-view/internal/realtime.ts"],"names":[],"mappings":"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"}

package/dist/base/table-view/internal/request-filter.d.ts

@@ -0,0 +1,75 @@
+import type { ComponentFilterContext } from "../../../component";
+import type { PermissionGate } from "../../../permission-gate";
+import type { CustomButton, CustomButtonSerialized } from "../../types/custom-button";
+import type { CustomRowActionSerialized, RowActionConfigSerialized, RowActionRule } from "../../types/row-action";
+import type { TableViewRowActionOptions, TableViewRowActionOptionsSerialized } from "../options";
+/** The table view actions whose permission shapes what a request is served. */
+declare const GRANTED_ACTIONS: readonly ["add", "edit", "delete", "view", "archive", "restore", "viewArchived", "export"];
+/**
+ * Whether the caller holds each table view action.
+ *
+ * @internal
+ */
+export type TableViewGrants = Record<(typeof GRANTED_ACTIONS)[number], boolean>;
+/**
+ * The table view actions the caller holds, checked one after the other.
+ *
+ * @internal
+ */
+export declare function resolveTableViewGrants(permissions: Set<string>, permissionId: string): Promise<TableViewGrants>;
+/**
+ * A built-in row action as served to a caller: refused (`false`) without
+ * the permission, on (`true`) when the table view left it unset.
+ *
+ * @internal
+ */
+export declare function applyPermissionToAction(hasPermission: boolean, actionConfig: boolean | RowActionConfigSerialized | undefined): boolean | RowActionConfigSerialized | undefined;
+/**
+ * A built-in row action with the controller's rule, where the table view did
+ * not declare its own: rules are registered once per controller (the writing
+ * table view's) and enforced on every write, so the UI matches what the
+ * server accepts.
+ *
+ * @internal
+ */
+export declare function mergeControllerRule(actionConfig: boolean | RowActionConfigSerialized | undefined, rule: RowActionRule | undefined): boolean | RowActionConfigSerialized | undefined;
+/**
+ * What the row actions of a table view are served from.
+ *
+ * @internal
+ */
+export interface RowActionsAdaptation {
+    /** The row actions as the table view serialized them. */
+    rowActions: TableViewRowActionOptionsSerialized | undefined;
+    archiveMode: boolean | undefined;
+    grants: TableViewGrants;
+    /** The custom row actions already filtered for the request. */
+    custom: CustomRowActionSerialized[] | undefined;
+    /** The rules the data routes enforce (see `controllerRowActionRules`). */
+    controllerRules: TableViewRowActionOptions | undefined;
+}
+/**
+ * The row actions served to one request: each disabled when the caller lacks
+ * its permission, the archive ones only in archive mode, and controller-wide
+ * rules exposed where the table declared none. Details are dropped when edit
+ * is offered unconditionally, since edit already shows the row.
+ *
+ * @internal
+ */
+export declare function adaptRowActions({ rowActions, archiveMode, grants, custom, controllerRules, }: RowActionsAdaptation): TableViewRowActionOptionsSerialized;
+/**
+ * The custom buttons served to one request: those whose permission the caller
+ * lacks are stripped, and those whose `availability` refuses the request are
+ * disabled with its reason.
+ *
+ * @internal
+ */
+export declare function resolveCustomButtons(permissions: Set<string>, declaredButtons: CustomButton[] | undefined, serializedButtons: CustomButtonSerialized[] | undefined, componentPermissionId: string, context: ComponentFilterContext): Promise<CustomButtonSerialized[] | undefined>;
+/**
+ * The custom row actions served to one request: those whose `permission` the
+ * caller lacks are stripped, like custom buttons.
+ *
+ * @internal
+ */
+export declare function resolveCustomRowActions(permissions: Set<string>, declaredActions: PermissionGate[] | undefined, serializedActions: CustomRowActionSerialized[] | undefined, componentPermissionId: string): Promise<CustomRowActionSerialized[] | undefined>;
+export {};

package/dist/base/table-view/internal/request-filter.js

@@ -0,0 +1,154 @@
+"use strict";
+// What one request is served of a table view's options: the actions, row
+// actions and custom buttons the caller's permissions admit, with the rules
+// the server enforces on them.
+//
+// Split out of factory-helpers.ts.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTableViewGrants = resolveTableViewGrants;
+exports.applyPermissionToAction = applyPermissionToAction;
+exports.mergeControllerRule = mergeControllerRule;
+exports.adaptRowActions = adaptRowActions;
+exports.resolveCustomButtons = resolveCustomButtons;
+exports.resolveCustomRowActions = resolveCustomRowActions;
+const button_availability_1 = require("../../internal/button-availability");
+const permission_gate_1 = require("../../../internal/permission-gate");
+const permissions_1 = require("../../../permissions");
+const row_rules_1 = require("./row-rules");
+/** The table view actions whose permission shapes what a request is served. */
+const GRANTED_ACTIONS = [
+    "add",
+    "edit",
+    "delete",
+    "view",
+    "archive",
+    "restore",
+    "viewArchived",
+    "export",
+];
+/**
+ * The table view actions the caller holds, checked one after the other.
+ *
+ * @internal
+ */
+async function resolveTableViewGrants(permissions, permissionId) {
+    const grants = {};
+    for (const action of GRANTED_ACTIONS) {
+        grants[action] = await (0, permissions_1.HasPermission)(permissions, `${permissionId}.${action}`);
+    }
+    return grants;
+}
+/**
+ * A built-in row action as served to a caller: refused (`false`) without
+ * the permission, on (`true`) when the table view left it unset.
+ *
+ * @internal
+ */
+function applyPermissionToAction(hasPermission, actionConfig) {
+    if (!hasPermission) {
+        return false;
+    }
+    return typeof actionConfig === "undefined" ? true : actionConfig;
+}
+/**
+ * A built-in row action with the controller's rule, where the table view did
+ * not declare its own: rules are registered once per controller (the writing
+ * table view's) and enforced on every write, so the UI matches what the
+ * server accepts.
+ *
+ * @internal
+ */
+function mergeControllerRule(actionConfig, rule) {
+    if (!rule || !actionConfig) {
+        return actionConfig;
+    }
+    if (actionConfig === true) {
+        return { isEnabled: true, rule };
+    }
+    if (!actionConfig.rule) {
+        return { ...actionConfig, rule };
+    }
+    return actionConfig;
+}
+const CONTROLLER_RULED_ACTIONS = [
+    "edit",
+    "delete",
+    "archive",
+    "restore",
+];
+/**
+ * The row actions served to one request: each disabled when the caller lacks
+ * its permission, the archive ones only in archive mode, and controller-wide
+ * rules exposed where the table declared none. Details are dropped when edit
+ * is offered unconditionally, since edit already shows the row.
+ *
+ * @internal
+ */
+function adaptRowActions({ rowActions, archiveMode, grants, custom, controllerRules, }) {
+    const inArchiveMode = (granted, config) => (archiveMode ? applyPermissionToAction(granted, config) : undefined);
+    const adapted = {
+        add: applyPermissionToAction(grants.add, rowActions?.add),
+        edit: applyPermissionToAction(grants.edit, rowActions?.edit),
+        duplicate: applyPermissionToAction(grants.add, rowActions?.duplicate),
+        delete: applyPermissionToAction(grants.delete, rowActions?.delete),
+        archive: inArchiveMode(grants.archive, rowActions?.archive),
+        restore: inArchiveMode(grants.restore, rowActions?.restore),
+        showArchived: archiveMode ? grants.viewArchived : undefined,
+        details: applyPermissionToAction(grants.view, rowActions?.details),
+        copyLink: applyPermissionToAction(grants.view, rowActions?.copyLink),
+        hasSelection: rowActions?.hasSelection,
+        custom,
+    };
+    // The table's own rules are already in its options; the controller's rule
+    // applies where it declared none, as the routes enforce it.
+    if (controllerRules) {
+        for (const actionName of CONTROLLER_RULED_ACTIONS) {
+            adapted[actionName] = mergeControllerRule(adapted[actionName], (0, row_rules_1.extractRuleFromConfig)(controllerRules, actionName));
+        }
+    }
+    const editHasNoRules = adapted.edit === true ||
+        (typeof adapted.edit === "object" && !adapted.edit.rule);
+    if (editHasNoRules) {
+        adapted.details = false;
+    }
+    return adapted;
+}
+/**
+ * The custom buttons served to one request: those whose permission the caller
+ * lacks are stripped, and those whose `availability` refuses the request are
+ * disabled with its reason.
+ *
+ * @internal
+ */
+async function resolveCustomButtons(permissions, declaredButtons, serializedButtons, componentPermissionId, context) {
+    if (!declaredButtons || !serializedButtons) {
+        return serializedButtons;
+    }
+    const kept = [];
+    for (const [index, serialized] of serializedButtons.entries()) {
+        const declared = declaredButtons[index];
+        if (!(await (0, permission_gate_1.holdsPermissionGate)(permissions, declared, componentPermissionId))) {
+            continue;
+        }
+        kept.push(await (0, button_availability_1.applyButtonAvailability)(declared?.availability, serialized, context));
+    }
+    return kept;
+}
+/**
+ * The custom row actions served to one request: those whose `permission` the
+ * caller lacks are stripped, like custom buttons.
+ *
+ * @internal
+ */
+async function resolveCustomRowActions(permissions, declaredActions, serializedActions, componentPermissionId) {
+    if (!declaredActions || !serializedActions)
+        return serializedActions;
+    const kept = [];
+    for (const [index, serialized] of serializedActions.entries()) {
+        if (await (0, permission_gate_1.holdsPermissionGate)(permissions, declaredActions[index], componentPermissionId)) {
+            kept.push(serialized);
+        }
+    }
+    return kept;
+}
+//# sourceMappingURL=request-filter.js.map

package/dist/base/table-view/internal/request-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-filter.js","sourceRoot":"","sources":["../../../../src/base/table-view/internal/request-filter.ts"],"names":[],"mappings":"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"}

package/dist/base/table-view/internal/resource-form.d.ts

@@ -0,0 +1,25 @@
+import type { ControllerClass } from "@antelopejs/interface-api";
+import type { FormBuilder } from "../../form-types";
+import { type ResourceFormMode, type ResourceFormOptions } from "../../resource-form-schema";
+import { TableViewMeta } from "../meta";
+/**
+ * Point every file and image column at the attachment it stores into. The
+ * upload a form field hands out is claimed against that address, so a form
+ * built before it is set cannot upload anything. Idempotent: whichever form or
+ * table over the controller comes first sets the same value.
+ *
+ * @internal
+ */
+export declare function stampAttachmentFields(meta: TableViewMeta, location: string): void;
+/**
+ * The form over `controller` in `mode`: the fields its columns declare for
+ * that mode, loaded from and submitted to the routes the mode uses. `rowId`
+ * defaults to {@link ROUTE_PARAM_ROW_ID}, the segment a TableView's own form
+ * pages carry.
+ *
+ * `undefined` when no column has an input in that mode — a resource whose
+ * every field is read-only has no edit form to offer.
+ *
+ * @internal
+ */
+export declare function resourceForm<T extends ControllerClass>(controller: T, mode: ResourceFormMode, options?: ResourceFormOptions): FormBuilder | undefined;

package/dist/base/table-view/internal/resource-form.js

@@ -0,0 +1,91 @@
+"use strict";
+// The form over a resource: its fields and the routes it loads and submits
+// through, derived from the DataController for a mode. The forms a TableView
+// opens and the ones a ResourceForm block renders are built here and nowhere
+// else, so the shape of a route changes in one place for both.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stampAttachmentFields = stampAttachmentFields;
+exports.resourceForm = resourceForm;
+const interface_core_1 = require("@antelopejs/interface-core");
+const core_1 = require("../../data-types/core");
+const form_schema_1 = require("../../form-schema");
+const resource_form_schema_1 = require("../../resource-form-schema");
+const types_1 = require("../../types");
+const meta_1 = require("../meta");
+const realtime_1 = require("./realtime");
+function formRoutes(location, mode, rowId) {
+    switch (mode) {
+        case "new":
+            return {
+                // A row being duplicated seeds the new one; without the query the
+                // token stays unresolved and nothing is fetched.
+                fetchUrl: `${location}/get?id={{query.duplicate}}`,
+                fetchUrlMethod: types_1.HttpMethod.get,
+                submitUrl: `${location}/new`,
+                submitUrlMethod: types_1.HttpMethod.post,
+            };
+        case "edit":
+            return {
+                fetchUrl: `${location}/get?id=${rowId}&${realtime_1.REALTIME_PRESENCE_QUERY}=${realtime_1.REALTIME_PRESENCE_ACQUIRE_VALUE}`,
+                fetchUrlMethod: types_1.HttpMethod.get,
+                submitUrl: `${location}/edit?id=${rowId}`,
+                submitUrlMethod: types_1.HttpMethod.put,
+            };
+        case "view":
+            return {
+                fetchUrl: `${location}/get?id=${rowId}`,
+                fetchUrlMethod: types_1.HttpMethod.get,
+            };
+    }
+}
+/**
+ * Point every file and image column at the attachment it stores into. The
+ * upload a form field hands out is claimed against that address, so a form
+ * built before it is set cannot upload anything. Idempotent: whichever form or
+ * table over the controller comes first sets the same value.
+ *
+ * @internal
+ */
+function stampAttachmentFields(meta, location) {
+    for (const [columnKey, column] of Object.entries(meta.columns)) {
+        const typeId = (0, core_1.getDataTypeId)(column.type);
+        if (typeId === "file" || typeId === "image") {
+            const typeOptions = column.type.options;
+            typeOptions.attachmentField = `${location}#${columnKey}`;
+        }
+    }
+}
+/**
+ * The form over `controller` in `mode`: the fields its columns declare for
+ * that mode, loaded from and submitted to the routes the mode uses. `rowId`
+ * defaults to {@link ROUTE_PARAM_ROW_ID}, the segment a TableView's own form
+ * pages carry.
+ *
+ * `undefined` when no column has an input in that mode — a resource whose
+ * every field is read-only has no edit form to offer.
+ *
+ * @internal
+ */
+function resourceForm(controller, mode, options = {}) {
+    const meta = (0, interface_core_1.GetMetadata)(controller, meta_1.TableViewMeta);
+    const { location } = meta.config;
+    stampAttachmentFields(meta, location);
+    const fields = meta.getFormFields(mode);
+    if (fields.length === 0) {
+        return undefined;
+    }
+    const { rowId = resource_form_schema_1.ROUTE_PARAM_ROW_ID, ...formOptions } = options;
+    const form = (0, form_schema_1.Form)({
+        ...formOptions,
+        fields,
+        ...formRoutes(location, mode, rowId),
+    });
+    // A form that submits to the controller's write routes is a provenance the
+    // routes accept files from, as each of its TableViews is. That covers a
+    // TableView's own form too: a page-mode TableView mounts it as the component
+    // of its form sub-page, whose upload tokens are claimed under that form.
+    if (mode !== "view")
+        meta.addResourceFormBuilder(form);
+    return form;
+}
+//# sourceMappingURL=resource-form.js.map

package/dist/base/table-view/internal/resource-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-form.js","sourceRoot":"","sources":["../../../../src/base/table-view/internal/resource-form.ts"],"names":[],"mappings":";AAAA,2EAA2E;AAC3E,6EAA6E;AAC7E,6EAA6E;AAC7E,+DAA+D;;AA8D/D,sDAWC;AAaD,oCAwBC;AA3GD,+DAAyD;AACzD,gDAAsD;AACtD,mDAAyC;AAEzC,qEAIoC;AACpC,uCAAyC;AACzC,kCAAwC;AACxC,yCAGoB;AAOpB,SAAS,UAAU,CACjB,QAAgB,EAChB,IAAsB,EACtB,KAAa;IAEb,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,KAAK;YACR,OAAO;gBACL,kEAAkE;gBAClE,iDAAiD;gBACjD,QAAQ,EAAE,GAAG,QAAQ,6BAA6B;gBAClD,cAAc,EAAE,kBAAU,CAAC,GAAG;gBAC9B,SAAS,EAAE,GAAG,QAAQ,MAAM;gBAC5B,eAAe,EAAE,kBAAU,CAAC,IAAI;aACjC,CAAC;QACJ,KAAK,MAAM;YACT,OAAO;gBACL,QAAQ,EAAE,GAAG,QAAQ,WAAW,KAAK,IAAI,kCAAuB,IAAI,0CAA+B,EAAE;gBACrG,cAAc,EAAE,kBAAU,CAAC,GAAG;gBAC9B,SAAS,EAAE,GAAG,QAAQ,YAAY,KAAK,EAAE;gBACzC,eAAe,EAAE,kBAAU,CAAC,GAAG;aAChC,CAAC;QACJ,KAAK,MAAM;YACT,OAAO;gBACL,QAAQ,EAAE,GAAG,QAAQ,WAAW,KAAK,EAAE;gBACvC,cAAc,EAAE,kBAAU,CAAC,GAAG;aAC/B,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,qBAAqB,CACnC,IAAmB,EACnB,QAAgB;IAEhB,KAAK,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/D,MAAM,MAAM,GAAG,IAAA,oBAAa,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,OAAkC,CAAC;YACnE,WAAW,CAAC,eAAe,GAAG,GAAG,QAAQ,IAAI,SAAS,EAAE,CAAC;QAC3D,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,YAAY,CAC1B,UAAa,EACb,IAAsB,EACtB,UAA+B,EAAE;IAEjC,MAAM,IAAI,GAAG,IAAA,4BAAW,EAAC,UAAU,EAAE,oBAAa,CAAC,CAAC;IACpD,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,qBAAqB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,EAAE,KAAK,GAAG,yCAAkB,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;IAC/D,MAAM,IAAI,GAAG,IAAA,kBAAI,EAAC;QAChB,GAAG,WAAW;QACd,MAAM;QACN,GAAG,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC;KACrC,CAAC,CAAC;IACH,2EAA2E;IAC3E,wEAAwE;IACxE,6EAA6E;IAC7E,yEAAyE;IACzE,IAAI,IAAI,KAAK,MAAM;QAAE,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/base/table-view/{row-rules.d.ts → internal/row-rules.d.ts}

@@ -1,8 +1,11 @@
 import type { DataControllerCallback } from "@antelopejs/interface-data-api";
-import type { RowActionRule } from "../types/row-action";
-import type { TableViewRowActionOptions } from "./options";
+import type { RowActionRule } from "../../types/row-action";
+import type { TableViewRowActionOptions } from "../options";
 type ValidatedActionName = "delete" | "edit" | "archive" | "restore";
+/** @internal */
 export declare const normalizeToArray: (value: string | string[]) => string[];
+/** @internal */
 export declare const extractRuleFromConfig: (controllerRules: TableViewRowActionOptions | undefined, actionName: ValidatedActionName) => RowActionRule | undefined;
+/** @internal */
 export declare const createValidatedRoute: (baseRoute: DataControllerCallback, actionName: ValidatedActionName) => DataControllerCallback;
 export {};

package/dist/base/table-view/{row-rules.js → internal/row-rules.js}

@@ -3,14 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createValidatedRoute = exports.extractRuleFromConfig = exports.normalizeToArray = void 0;
 const interface_api_util_1 = require("@antelopejs/interface-api-util");
 const interface_core_1 = require("@antelopejs/interface-core");
-const data_functions_1 = require("./data-functions");
-const meta_1 = require("./meta");
-const options_1 = require("./options");
+const data_functions_1 = require("../data-functions");
+const meta_1 = require("../meta");
+const options_1 = require("../options");
 var EmptyResultBehavior;
 (function (EmptyResultBehavior) {
     EmptyResultBehavior[EmptyResultBehavior["Graceful"] = 0] = "Graceful";
     EmptyResultBehavior[EmptyResultBehavior["Strict"] = 1] = "Strict";
 })(EmptyResultBehavior || (EmptyResultBehavior = {}));
+/** @internal */
 const normalizeToArray = (value) => Array.isArray(value) ? value : [value];
 exports.normalizeToArray = normalizeToArray;
 const ACTION_VALIDATION_CONFIGS = {
@@ -27,27 +28,32 @@ const ACTION_VALIDATION_CONFIGS = {
         extractIds: (params) => [params.id],
         emptyResultBehavior: EmptyResultBehavior.Strict,
     },
+    // A bulk route's first argument after the context is the id list itself:
+    // the rows a rule rejects are dropped from it before the operation runs.
     archive: {
-        extractIds: (_params, ids) => (0, exports.normalizeToArray)(ids),
+        extractIds: (ids) => (0, exports.normalizeToArray)(ids),
         emptyResultBehavior: EmptyResultBehavior.Graceful,
         emptyResult: { success: true, archivedCount: 0 },
-        transformArgs: (_args, eligibleIds) => [eligibleIds],
+        transformParams: (_ids, eligibleIds) => eligibleIds,
     },
     restore: {
-        extractIds: (_params, ids) => (0, exports.normalizeToArray)(ids),
+        extractIds: (ids) => (0, exports.normalizeToArray)(ids),
         emptyResultBehavior: EmptyResultBehavior.Graceful,
         emptyResult: { success: true, restoredCount: 0 },
-        transformArgs: (_args, eligibleIds) => [eligibleIds],
+        transformParams: (_ids, eligibleIds) => eligibleIds,
     },
 };
-const getValidationContext = (controller) => {
+// The writing TableView's rules and options are the controller's: it is the
+// only one the write routes serve.
+const getValidationContext = (controller, actionName) => {
     const meta = (0, interface_core_1.GetMetadata)(controller.constructor, meta_1.TableViewMeta);
     return {
-        rules: meta.controllerRowActionRules,
+        rule: (0, exports.extractRuleFromConfig)(meta.controllerRowActionRules, actionName),
         strictMode: meta.options.strictRuleValidation ?? false,
         idField: meta.options.rowIdKey || options_1.DEFAULT_ROW_ID_FIELD,
     };
 };
+/** @internal */
 const extractRuleFromConfig = (controllerRules, actionName) => {
     const actionConfig = controllerRules?.[actionName];
     if (typeof actionConfig === "object" && actionConfig !== null) {
@@ -62,19 +68,17 @@ const handleNoEligibleIds = (config, actionName) => {
     }
     return config.emptyResult;
 };
+/** @internal */
 const createValidatedRoute = (baseRoute, actionName) => {
     const config = ACTION_VALIDATION_CONFIGS[actionName];
     return {
         func: async function (ctx, params, ...args) {
-            const validationCtx = getValidationContext(this);
-            if (!validationCtx.rules) {
-                return baseRoute.func.call(this, ctx, params, ...args);
-            }
-            const rule = (0, exports.extractRuleFromConfig)(validationCtx.rules, actionName);
+            const validationCtx = getValidationContext(this, actionName);
+            const { rule } = validationCtx;
             if (!rule) {
                 return baseRoute.func.call(this, ctx, params, ...args);
             }
-            const ids = config.extractIds(params, ...args);
+            const ids = config.extractIds(params);
             const { eligibleIds } = await (0, data_functions_1.validateRowsAgainstRule)(this, ids, rule, validationCtx.strictMode, validationCtx.idField);
             if (eligibleIds.length === 0) {
                 return handleNoEligibleIds(config, actionName);
@@ -82,10 +86,7 @@ const createValidatedRoute = (baseRoute, actionName) => {
             const finalParams = config.transformParams
                 ? config.transformParams(params, eligibleIds)
                 : params;
-            const finalArgs = config.transformArgs
-                ? config.transformArgs(args, eligibleIds)
-                : args;
-            return baseRoute.func.call(this, ctx, finalParams, ...finalArgs);
+            return baseRoute.func.call(this, ctx, finalParams, ...args);
         },
         args: baseRoute.args,
         method: baseRoute.method,

package/dist/base/table-view/internal/row-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-rules.js","sourceRoot":"","sources":["../../../../src/base/table-view/internal/row-rules.ts"],"names":[],"mappings":"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"}

package/dist/base/table-view/internal/tabs.d.ts

@@ -0,0 +1,39 @@
+import { type ControllerClass } from "@antelopejs/interface-api";
+import type { DataControllerCallbackWithOptions } from "@antelopejs/interface-data-api";
+import type { TableViewOptions, TableViewTab, TableViewTabSerialized } from "../options";
+/**
+ * Tabs as the options carry them: a link tab's path target and its count
+ * location are plain strings already; a page controller target is resolved
+ * per request by {@link resolveTableViewTabs}, once pages are registered.
+ *
+ * @internal
+ */
+export declare function serializeTableViewTabs(tabs: TableViewTab[] | undefined): TableViewTabSerialized[] | undefined;
+/**
+ * The tabs served to one request: a tab is kept only for a caller its gate
+ * admits — a link tab to a page, that page's own permission; any other tab,
+ * its `permission` (relative to the table view) or `permissionId` — and a
+ * page target is resolved to its path and full id. A page that never
+ * registered drops its tab.
+ *
+ * @internal
+ */
+export declare function resolveTableViewTabs(permissions: Set<string>, declaredTabs: TableViewTab[] | undefined, serializedTabs: TableViewTabSerialized[] | undefined, componentPermissionId: string): Promise<TableViewTabSerialized[] | undefined>;
+/**
+ * Whether a table view shows counters the `count/batch` route serves: filter
+ * tabs, counted views or counted groups.
+ *
+ * @internal
+ */
+export declare function declaresCounters(options: Pick<TableViewOptions, "tabs" | "views" | "grouped">): boolean;
+/** @internal */
+export declare function servesRoute(endpoints: Record<string, DataControllerCallbackWithOptions>, path: string, method: string): boolean;
+/**
+ * Warn, once per controller, when a table view declares filter tabs, counted
+ * views or counted groups but its controller mounts no `POST count/batch`
+ * route: every counter request would fail. The fix belongs in the controller
+ * (mount `countBatch: TableViewRoutes.CountBatch`), so this only reports it.
+ *
+ * @internal
+ */
+export declare function warnIfTabsLackCountBatch(controller: ControllerClass, location: string, hasCounters: boolean, endpoints: Record<string, DataControllerCallbackWithOptions>): void;

package/dist/base/table-view/internal/tabs.js

@@ -0,0 +1,116 @@
+"use strict";
+// The filter tabs of a table view: how the options carry them, which ones a
+// request is served, and the warning when their counters have no route.
+//
+// Split out of factory-helpers.ts.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeTableViewTabs = serializeTableViewTabs;
+exports.resolveTableViewTabs = resolveTableViewTabs;
+exports.declaresCounters = declaresCounters;
+exports.servesRoute = servesRoute;
+exports.warnIfTabsLackCountBatch = warnIfTabsLackCountBatch;
+const interface_api_1 = require("@antelopejs/interface-api");
+const interface_core_1 = require("@antelopejs/interface-core");
+const logging_1 = require("@antelopejs/interface-core/logging");
+const page_1 = require("../../../page");
+const permission_gate_1 = require("../../../internal/permission-gate");
+const permissions_1 = require("../../../permissions");
+function dataApiLocation(countFrom) {
+    return typeof countFrom === "string"
+        ? countFrom
+        : (0, interface_core_1.GetMetadata)(countFrom, interface_api_1.ControllerMeta).location;
+}
+/**
+ * Tabs as the options carry them: a link tab's path target and its count
+ * location are plain strings already; a page controller target is resolved
+ * per request by {@link resolveTableViewTabs}, once pages are registered.
+ *
+ * @internal
+ */
+function serializeTableViewTabs(tabs) {
+    return tabs?.map(({ to, countFrom, permission: _permission, permissionId: _permissionId, ...tab }) => {
+        const serialized = { ...tab };
+        if (typeof to === "string")
+            serialized.to = to;
+        if (countFrom)
+            serialized.countFrom = dataApiLocation(countFrom);
+        return serialized;
+    });
+}
+const withLeadingSlash = (path) => path.startsWith("/") ? path : `/${path}`;
+/**
+ * The tabs served to one request: a tab is kept only for a caller its gate
+ * admits — a link tab to a page, that page's own permission; any other tab,
+ * its `permission` (relative to the table view) or `permissionId` — and a
+ * page target is resolved to its path and full id. A page that never
+ * registered drops its tab.
+ *
+ * @internal
+ */
+async function resolveTableViewTabs(permissions, declaredTabs, serializedTabs, componentPermissionId) {
+    if (!declaredTabs || !serializedTabs)
+        return serializedTabs;
+    const kept = [];
+    for (const [index, tab] of serializedTabs.entries()) {
+        const declared = declaredTabs[index];
+        const target = declared?.to;
+        if (target && typeof target !== "string") {
+            const page = (0, interface_core_1.GetMetadata)(target, page_1.PageMetadata).pageInfo;
+            if (!page)
+                continue;
+            const permissionId = (0, page_1.GetPermissionId)(target);
+            if (permissionId && !(await (0, permissions_1.HasPermission)(permissions, permissionId))) {
+                continue;
+            }
+            kept.push({
+                ...tab,
+                to: withLeadingSlash(page.fullSlug),
+                toPage: page.fullId,
+            });
+            continue;
+        }
+        if (await (0, permission_gate_1.holdsPermissionGate)(permissions, declared, componentPermissionId)) {
+            kept.push(tab);
+        }
+    }
+    return kept;
+}
+/**
+ * Whether a table view shows counters the `count/batch` route serves: filter
+ * tabs, counted views or counted groups.
+ *
+ * @internal
+ */
+function declaresCounters(options) {
+    return ((options.tabs?.length ?? 0) > 0 ||
+        !!options.views?.items.some((view) => view.count) ||
+        !!options.grouped?.count);
+}
+const COUNT_BATCH_PATH = "count/batch";
+const COUNT_BATCH_METHOD = "post";
+const EDGE_SLASHES = /^\/+|\/+$/g;
+const controllersWarnedForTabCounts = new WeakSet();
+// Matched on the mounted path and method rather than on the route object: a
+// module mounts its own per-context copy of `TableViewRoutes.CountBatch`.
+/** @internal */
+function servesRoute(endpoints, path, method) {
+    return Object.entries(endpoints).some(([key, entry]) => (entry.endpoint ?? key).replace(EDGE_SLASHES, "") === path &&
+        entry.callback.method.toLowerCase() === method);
+}
+/**
+ * Warn, once per controller, when a table view declares filter tabs, counted
+ * views or counted groups but its controller mounts no `POST count/batch`
+ * route: every counter request would fail. The fix belongs in the controller
+ * (mount `countBatch: TableViewRoutes.CountBatch`), so this only reports it.
+ *
+ * @internal
+ */
+function warnIfTabsLackCountBatch(controller, location, hasCounters, endpoints) {
+    if (!hasCounters || controllersWarnedForTabCounts.has(controller))
+        return;
+    if (servesRoute(endpoints, COUNT_BATCH_PATH, COUNT_BATCH_METHOD))
+        return;
+    controllersWarnedForTabCounts.add(controller);
+    logging_1.Logging.Warn(`[DMS] TableView on "${controller.name}" (${location}) declares filter tabs, counted views or counted groups but its controller mounts no POST ${location}/${COUNT_BATCH_PATH} route: their counters will fail. Mount \`countBatch: TableViewRoutes.CountBatch\` on the controller.`);
+}
+//# sourceMappingURL=tabs.js.map