@antelopejs/interface-dms 0.3.4 → 0.3.6

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

@@ -0,0 +1,112 @@
+"use strict";
+// The footer band and the empty states of a table view: the figures the
+// `summary` route computes over the listed rows, the legend, and what an
+// empty body says.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ruleFields = ruleFields;
+exports.serializeFooter = serializeFooter;
+exports.serializeEmptyStates = serializeEmptyStates;
+exports.warnIfSummaryLacksRoute = warnIfSummaryLacksRoute;
+const logging_1 = require("@antelopejs/interface-core/logging");
+const data_types_1 = require("../../data-types");
+const row_action_operators_1 = require("../../types/row-action-operators");
+const tabs_1 = require("./tabs");
+const LEGEND_TYPE_ID = "select";
+/**
+ * The columns a row rule reads, nested rules included.
+ *
+ * @internal
+ */
+function ruleFields(rule) {
+    const record = rule;
+    if (row_action_operators_1.FIELD_KEY in record)
+        return [String(record[row_action_operators_1.FIELD_KEY])];
+    return row_action_operators_1.LOGICAL_OPERATOR_KEYS.flatMap((key) => {
+        const nested = record[key];
+        if (!nested)
+            return [];
+        const rules = Array.isArray(nested) ? nested : [nested];
+        return rules.flatMap((entry) => ruleFields(entry));
+    });
+}
+function assertSummary(controllerName, meta, summary) {
+    const where = `TableView footer summary "${summary.label}" on ${controllerName}`;
+    if (summary.op === "sum" && !summary.field) {
+        throw new Error(`${where} sums no field: give it a field`);
+    }
+    const fields = [
+        ...(summary.field ? [summary.field] : []),
+        ...(summary.where ? ruleFields(summary.where) : []),
+    ];
+    for (const field of fields) {
+        if (!meta.columns[field]) {
+            throw new Error(`${where} references unknown column "${field}"`);
+        }
+    }
+}
+/**
+ * The footer as it reaches the client: its summaries checked, recorded on
+ * the controller and named by the id the `summary` route knows them by,
+ * their `where` rule kept server-side. The legend must be a select column.
+ *
+ * @internal
+ */
+function serializeFooter(controllerName, meta, footer) {
+    if (!footer)
+        return undefined;
+    const { summary, ...texts } = footer;
+    const legendColumn = footer.legend ? meta.columns[footer.legend] : undefined;
+    if (footer.legend &&
+        (!legendColumn || (0, data_types_1.getDataTypeId)(legendColumn.type) !== LEGEND_TYPE_ID)) {
+        throw new Error(`TableView footer legend on ${controllerName} must name a SelectType column (got "${footer.legend}")`);
+    }
+    if (!summary)
+        return texts;
+    for (const entry of summary)
+        assertSummary(controllerName, meta, entry);
+    const ids = meta.registerFooterSummaries(summary);
+    return {
+        ...texts,
+        summary: summary.map(({ where: _where, ...entry }, index) => ({
+            ...entry,
+            id: ids[index],
+        })),
+    };
+}
+/**
+ * The empty states as they reach the client, components serialized.
+ *
+ * @internal
+ */
+function serializeEmptyStates(emptyStates) {
+    if (!emptyStates)
+        return undefined;
+    return Object.fromEntries(Object.entries(emptyStates).map(([kind, state]) => [
+        kind,
+        state && {
+            ...state,
+            component: state.component?.serializeSync(),
+        },
+    ]));
+}
+const SUMMARY_PATH = "summary";
+const SUMMARY_METHOD = "get";
+const controllersWarnedForSummaries = new WeakSet();
+/**
+ * Warn, once per controller, when a table view declares footer summaries but
+ * its controller mounts no `GET summary` route: the footer could not read
+ * them. The fix belongs in the controller (`summary: TableViewRoutes.Summary`).
+ *
+ * @internal
+ */
+function warnIfSummaryLacksRoute(controller, location, footer, endpoints) {
+    if (!footer?.summary?.length)
+        return;
+    if (controllersWarnedForSummaries.has(controller))
+        return;
+    if ((0, tabs_1.servesRoute)(endpoints, SUMMARY_PATH, SUMMARY_METHOD))
+        return;
+    controllersWarnedForSummaries.add(controller);
+    logging_1.Logging.Warn(`[DMS] TableView on "${controller.name}" (${location}) declares footer summaries but its controller mounts no GET ${location}/${SUMMARY_PATH} route: they will not show. Mount \`summary: TableViewRoutes.Summary\` on the controller.`);
+}
+//# sourceMappingURL=footer.js.map

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

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

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

@@ -1,7 +1,10 @@
 import { type DataControllerCallback } from "@antelopejs/interface-data-api";
 import type { Parameters } from "@antelopejs/interface-data-api/components";
 type GuardedActionName = "edit" | "delete" | "archive" | "restore" | "new";
+/** @internal */
 export declare const parseGuardBody: (raw: unknown) => Record<string, unknown>;
+/** @internal */
 export declare const guardedGetRoute: DataControllerCallback<Parameters.GetParameters>;
+/** @internal */
 export declare const createGuardedRoute: (baseRoute: DataControllerCallback, actionName: GuardedActionName) => DataControllerCallback;
 export {};

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

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGuardedRoute = exports.guardedGetRoute = exports.parseGuardBody = void 0;
+const interface_api_1 = require("@antelopejs/interface-api");
+const interface_api_util_1 = require("@antelopejs/interface-api-util");
+const interface_core_1 = require("@antelopejs/interface-core");
+const interface_data_api_1 = require("@antelopejs/interface-data-api");
+const logging_1 = require("@antelopejs/interface-core/logging");
+const data_functions_1 = require("../data-functions");
+const meta_1 = require("../meta");
+const options_1 = require("../options");
+const row_rules_1 = require("./row-rules");
+/**
+ * The values of a confirmation's fields, sent as the body of a delete,
+ * archive or restore; unset when the request carried none.
+ */
+const parseConfirmValues = (raw) => {
+    const isEmpty = raw === undefined ||
+        raw === null ||
+        ((Buffer.isBuffer(raw) || typeof raw === "string") && raw.length === 0);
+    return isEmpty ? undefined : (0, exports.parseGuardBody)(raw);
+};
+/** @internal */
+const parseGuardBody = (raw) => {
+    if (Buffer.isBuffer(raw))
+        return JSON.parse(raw.toString());
+    if (typeof raw === "string" && raw.length > 0)
+        return JSON.parse(raw);
+    if (raw && typeof raw === "object")
+        return raw;
+    return {};
+};
+exports.parseGuardBody = parseGuardBody;
+const ACTION_GUARD_CONFIGS = {
+    edit: {
+        // A published contract: the runtime calls this positionally and every
+        // implementing module declares the same shape, so an options object
+        // cannot be introduced from this side.
+        // oxlint-disable-next-line eslint/max-params
+        invokeGuard: async (controller, ctx, params, args, guard, idField) => {
+            const id = String(params.id);
+            const body = (0, exports.parseGuardBody)(args[0]);
+            const current = await (0, data_functions_1.fetchRowForGuard)(controller, id, idField);
+            (0, interface_api_util_1.assert)(current, 404, "Not Found");
+            return guard.call(controller, ctx, { id, body, current });
+        },
+    },
+    delete: {
+        invokeGuard: async (controller, ctx, params, args, guard) => {
+            const ids = (0, row_rules_1.normalizeToArray)(params.id);
+            return guard.call(controller, ctx, {
+                ids,
+                values: parseConfirmValues(args.at(-1)),
+            });
+        },
+    },
+    archive: {
+        invokeGuard: async (controller, ctx, params, args, guard) => {
+            const ids = (0, row_rules_1.normalizeToArray)(params);
+            return guard.call(controller, ctx, {
+                ids,
+                values: parseConfirmValues(args.at(-1)),
+            });
+        },
+    },
+    restore: {
+        invokeGuard: async (controller, ctx, params, args, guard) => {
+            const ids = (0, row_rules_1.normalizeToArray)(params);
+            return guard.call(controller, ctx, {
+                ids,
+                values: parseConfirmValues(args.at(-1)),
+            });
+        },
+    },
+    new: {
+        invokeGuard: async (controller, ctx, _params, args, guard) => {
+            const body = (0, exports.parseGuardBody)(args[0]);
+            return guard.call(controller, ctx, { body });
+        },
+    },
+};
+const getGuardForAction = (controller, actionName) => {
+    const meta = (0, interface_core_1.GetMetadata)(controller.constructor, meta_1.TableViewMeta);
+    return meta.controllerGuards?.[actionName];
+};
+/** @internal */
+exports.guardedGetRoute = interface_data_api_1.DefaultRoutes.WithGetGuard(async function (ctx, current, params) {
+    await getGuardForAction(this, "get")?.call(this, ctx, {
+        id: params.id,
+        current,
+    });
+});
+const getIdField = (controller) => {
+    const meta = (0, interface_core_1.GetMetadata)(controller.constructor, meta_1.TableViewMeta);
+    return meta.options.rowIdKey || options_1.DEFAULT_ROW_ID_FIELD;
+};
+async function runAfterWrite(afterWrite, actionName) {
+    try {
+        await afterWrite();
+    }
+    catch (error) {
+        logging_1.Logging.Error(`[dms] the ${actionName} guard's after-write work failed: ${String(error)}`);
+    }
+}
+// Their routes read no body of their own: the guard is handed the one the
+// confirmation sends, read here and kept from the route.
+const CONFIRM_BODY_ACTIONS = new Set([
+    "delete",
+    "archive",
+    "restore",
+]);
+/** @internal */
+const createGuardedRoute = (baseRoute, actionName) => {
+    const config = ACTION_GUARD_CONFIGS[actionName];
+    const readsConfirmBody = CONFIRM_BODY_ACTIONS.has(actionName);
+    return {
+        func: async function (ctx, params, ...routeArgs) {
+            const confirmBody = readsConfirmBody ? routeArgs.pop() : undefined;
+            const args = readsConfirmBody ? [confirmBody] : routeArgs;
+            const guard = getGuardForAction(this, actionName);
+            const afterWrite = guard
+                ? await config.invokeGuard(this, ctx, params, args, guard, getIdField(this))
+                : undefined;
+            const result = await baseRoute.func.call(this, ctx, params, ...routeArgs);
+            if (afterWrite)
+                await runAfterWrite(afterWrite, actionName);
+            return result;
+        },
+        args: readsConfirmBody ? [...baseRoute.args, (0, interface_api_1.RawBody)()] : baseRoute.args,
+        method: baseRoute.method,
+    };
+};
+exports.createGuardedRoute = createGuardedRoute;
+//# sourceMappingURL=guards.js.map

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

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

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

@@ -0,0 +1,5 @@
+import { TableViewMeta } from "../meta";
+/** @internal */
+export declare const getTableViewMetaFor: (target: unknown) => TableViewMeta;
+/** @internal */
+export declare const getControllerLocation: (target: unknown) => string;

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

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getControllerLocation = exports.getTableViewMetaFor = void 0;
+const interface_api_1 = require("@antelopejs/interface-api");
+const interface_core_1 = require("@antelopejs/interface-core");
+const meta_1 = require("../meta");
+/** @internal */
+const getTableViewMetaFor = (target) => (0, interface_core_1.GetMetadata)(target.constructor, meta_1.TableViewMeta);
+exports.getTableViewMetaFor = getTableViewMetaFor;
+/** @internal */
+const getControllerLocation = (target) => (0, interface_core_1.GetMetadata)(target.constructor, interface_api_1.ControllerMeta).location;
+exports.getControllerLocation = getControllerLocation;
+//# sourceMappingURL=meta.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../../../src/base/table-view/internal/meta.ts"],"names":[],"mappings":";;;AAAA,6DAGmC;AACnC,+DAAyD;AACzD,kCAAwC;AAExC,gBAAgB;AACT,MAAM,mBAAmB,GAAG,CAAC,MAAe,EAAiB,EAAE,CACpE,IAAA,4BAAW,EACR,MAA2C,CAAC,WAAW,EACxD,oBAAa,CACd,CAAC;AAJS,QAAA,mBAAmB,uBAI5B;AAEJ,gBAAgB;AACT,MAAM,qBAAqB,GAAG,CAAC,MAAe,EAAU,EAAE,CAC/D,IAAA,4BAAW,EACR,MAA2C,CAAC,WAAW,EACxD,8BAAc,CACf,CAAC,QAAQ,CAAC;AAJA,QAAA,qBAAqB,yBAIrB"}

package/dist/base/table-view/internal/nav-badges.d.ts

@@ -0,0 +1,9 @@
+import { type ControllerClass } from "@antelopejs/interface-api";
+import type { ComponentBuilder } from "../../../component";
+import type { TableViewTab } from "../options";
+/**
+ * Declares on `builder` the navigation badges of the tabs that publish one.
+ *
+ * @internal
+ */
+export declare function declareTabNavBadges<T>(builder: ComponentBuilder<T>, tabs: TableViewTab[] | undefined, controller: ControllerClass): void;

package/dist/base/table-view/internal/nav-badges.js

@@ -0,0 +1,79 @@
+"use strict";
+// The navigation badges a table view publishes: the counter of a tab declared
+// with `navBadge`, counted on the server when the menu loads.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.declareTabNavBadges = declareTabNavBadges;
+const interface_api_1 = require("@antelopejs/interface-api");
+const logging_1 = require("@antelopejs/interface-core/logging");
+const interface_data_api_1 = require("@antelopejs/interface-data-api");
+const components_1 = require("@antelopejs/interface-data-api/components");
+const request_tenant_1 = require("../../../request-tenant");
+const auth_1 = require("./auth");
+const data_functions_1 = require("../data-functions");
+const FILTER_QUERY_PREFIX = "filter_";
+/** The list query a tab's hidden filter reads as (`filter_<key>=<mode>:<value>`). */
+function tabFilterQuery(filter) {
+    if (!filter)
+        return {};
+    return {
+        [`${FILTER_QUERY_PREFIX}${filter.accessorKey}`]: `${filter.mode}:${filter.value ?? ""}`,
+    };
+}
+function withQuery(ctx, query) {
+    const url = new URL(ctx.url);
+    url.search = "";
+    for (const [key, value] of Object.entries(query)) {
+        url.searchParams.set(key, value);
+    }
+    return { ...ctx, url };
+}
+/**
+ * The rows of `controller` the caller lists through `filter`, read with the
+ * caller's own `list` permission, as the table's tab counter is: it throws
+ * for a caller without it.
+ */
+async function countRows(controller, ctx, user, filter) {
+    const instance = await (0, interface_api_1.GetControllerInstance)(controller, ctx);
+    const permissions = await (0, auth_1.authorizeAction)(instance, auth_1.LIST_ACTION, user, (0, request_tenant_1.getRequestTenantId)(ctx));
+    const queryContext = withQuery(ctx, tabFilterQuery(filter));
+    const filters = components_1.Parameters.ExtractFilters(queryContext, (0, interface_data_api_1.GetDataControllerMeta)(instance));
+    const { total } = await (0, data_functions_1.countWithSearch)(instance, queryContext, { filters }, user, permissions);
+    return total;
+}
+/**
+ * The badge a `navBadge` tab publishes: a filter tab counts its table for its
+ * own page, a link tab counts its `countFrom` controller for the page it links
+ * to. A link tab given as a path, or counting from a location, cannot say
+ * which page or controller it means: it is warned about and publishes nothing.
+ */
+function navBadgeSourceOf(tab, controller) {
+    if (!tab.to) {
+        return {
+            count: (ctx, user) => countRows(controller, ctx, user, tab.filter),
+        };
+    }
+    const { to, countFrom } = tab;
+    if (typeof to === "string" || !countFrom || typeof countFrom === "string") {
+        logging_1.Logging.Warn(`[DMS] TableView on "${controller.name}": tab "${tab.id}" sets navBadge but links to a path or counts from a location; a navigation badge needs a page controller \`to\` and a data controller \`countFrom\`. It publishes nothing.`);
+        return undefined;
+    }
+    return {
+        page: to,
+        count: (ctx, user) => countRows(countFrom, ctx, user, undefined),
+    };
+}
+/**
+ * Declares on `builder` the navigation badges of the tabs that publish one.
+ *
+ * @internal
+ */
+function declareTabNavBadges(builder, tabs, controller) {
+    for (const tab of tabs ?? []) {
+        if (!tab.navBadge)
+            continue;
+        const source = navBadgeSourceOf(tab, controller);
+        if (source)
+            builder.navBadge(source);
+    }
+}
+//# sourceMappingURL=nav-badges.js.map

package/dist/base/table-view/internal/nav-badges.js.map

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

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

@@ -0,0 +1,6 @@
+/**
+ * The frontend component `TableView` emits.
+ *
+ * @internal
+ */
+export declare const TABLE_VIEW_COMPONENT_NAME = "dms-table-view";

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TABLE_VIEW_COMPONENT_NAME = void 0;
+/**
+ * The frontend component `TableView` emits.
+ *
+ * @internal
+ */
+exports.TABLE_VIEW_COMPONENT_NAME = "dms-table-view";
+//# sourceMappingURL=options.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../src/base/table-view/internal/options.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACU,QAAA,yBAAyB,GAAG,gBAAgB,CAAC"}

package/dist/base/table-view/internal/realtime-listeners.d.ts

@@ -0,0 +1,4 @@
+import { OwnedRegistry } from "../../../utils/internal/owned-registry";
+import type { RealtimeMutationListener } from "../realtime";
+/** @internal */
+export declare const realtimeMutationListeners: OwnedRegistry<RealtimeMutationListener>;

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.realtimeMutationListeners = void 0;
+const owned_registry_1 = require("../../../utils/internal/owned-registry");
+/** @internal */
+exports.realtimeMutationListeners = new owned_registry_1.OwnedRegistry();
+//# sourceMappingURL=realtime-listeners.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-listeners.js","sourceRoot":"","sources":["../../../../src/base/table-view/internal/realtime-listeners.ts"],"names":[],"mappings":";;;AAAA,2EAAuE;AAGvE,gBAAgB;AACH,QAAA,yBAAyB,GACpC,IAAI,8BAAa,EAA4B,CAAC"}

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

@@ -0,0 +1,39 @@
+import type { DataControllerCallback } from "@antelopejs/interface-data-api";
+import { type RealtimeMutationEventType } from "../realtime";
+/** @internal */
+export declare const REALTIME_PRESENCE_QUERY = "_presence";
+/** @internal */
+export declare const REALTIME_PRESENCE_ACQUIRE_VALUE = "1";
+/**
+ * Bind the topics of the table view served at `controllerLocation` to the page
+ * it is placed on. Called from the builder's `onCreated`, so the module whose
+ * page it is owns them.
+ *
+ * @internal
+ */
+export declare function registerTableViewPageTopics(pageId: string, controllerLocation: string): void;
+type IdExtractor = (args: unknown[], result: unknown, idKey: string) => string[];
+/** @internal */
+export declare const extractFromResult: IdExtractor;
+/** @internal */
+export declare const extractSingleParamId: IdExtractor;
+/** @internal */
+export declare const extractMultiParamId: IdExtractor;
+/** @internal */
+export declare const extractBulkArgIds: IdExtractor;
+/**
+ * Whether a write reports changing no row: its row rules refused every id,
+ * or none existed. Broadcasting its ids would have every session watching
+ * the table (the caller included) drop rows that are still there.
+ */
+/** @internal */
+export declare const reportsNoChange: (result: unknown) => boolean;
+interface MutationConfig {
+    eventType: RealtimeMutationEventType;
+    extractIds: IdExtractor;
+}
+/** @internal */
+export declare function withRealtimeMutation<T extends DataControllerCallback>(config: MutationConfig, baseRoute: T): DataControllerCallback;
+/** @internal */
+export declare function withPresenceAcquire<T extends DataControllerCallback>(baseRoute: T): DataControllerCallback;
+export {};

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

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportsNoChange = exports.extractBulkArgIds = exports.extractMultiParamId = exports.extractSingleParamId = exports.extractFromResult = exports.REALTIME_PRESENCE_ACQUIRE_VALUE = exports.REALTIME_PRESENCE_QUERY = void 0;
+exports.registerTableViewPageTopics = registerTableViewPageTopics;
+exports.withRealtimeMutation = withRealtimeMutation;
+exports.withPresenceAcquire = withPresenceAcquire;
+const interface_api_1 = require("@antelopejs/interface-api");
+const logging_1 = require("@antelopejs/interface-core/logging");
+const auth_1 = require("../../../auth");
+const realtime_1 = require("../../../realtime");
+const meta_1 = require("./meta");
+const realtime_listeners_1 = require("./realtime-listeners");
+const realtime_2 = require("../realtime");
+const REALTIME_SESSION_HEADER = "x-realtime-session";
+/** @internal */
+exports.REALTIME_PRESENCE_QUERY = "_presence";
+/** @internal */
+exports.REALTIME_PRESENCE_ACQUIRE_VALUE = "1";
+const PARAMS_INDEX = 1;
+const BULK_IDS_ARG_INDEX = 1;
+/**
+ * Bind the topics of the table view served at `controllerLocation` to the page
+ * it is placed on. Called from the builder's `onCreated`, so the module whose
+ * page it is owns them.
+ *
+ * @internal
+ */
+function registerTableViewPageTopics(pageId, controllerLocation) {
+    (0, realtime_1.RegisterPageTopic)(pageId, (0, realtime_2.tableViewRowTopic)(controllerLocation));
+    (0, realtime_1.RegisterPageTopic)(pageId, (0, realtime_2.tableViewPresenceTopic)(controllerLocation));
+}
+async function dispatchRealtimeMutation(context) {
+    await realtime_2.internal.PublishMutation(context);
+    for (const listener of realtime_listeners_1.realtimeMutationListeners.values()) {
+        try {
+            await listener(context);
+        }
+        catch (error) {
+            logging_1.Logging.Error(`[DMS] Realtime mutation listener failed for '${context.controllerLocation}':`, error);
+        }
+    }
+}
+/** @internal */
+const extractFromResult = (_args, result, idKey) => {
+    if (!result || typeof result !== "object")
+        return [];
+    const value = result[idKey];
+    return typeof value === "string" ? [value] : [];
+};
+exports.extractFromResult = extractFromResult;
+/** @internal */
+const extractSingleParamId = (args) => {
+    const params = args[PARAMS_INDEX];
+    return params?.id ? [params.id] : [];
+};
+exports.extractSingleParamId = extractSingleParamId;
+/** @internal */
+const extractMultiParamId = (args) => {
+    const params = args[PARAMS_INDEX];
+    if (!params?.id)
+        return [];
+    return Array.isArray(params.id) ? params.id : [params.id];
+};
+exports.extractMultiParamId = extractMultiParamId;
+/** @internal */
+const extractBulkArgIds = (args) => {
+    const ids = args[BULK_IDS_ARG_INDEX];
+    if (!ids)
+        return [];
+    return Array.isArray(ids) ? ids : [ids];
+};
+exports.extractBulkArgIds = extractBulkArgIds;
+const isRealtimeEnabled = (target) => (0, meta_1.getTableViewMetaFor)(target).options.realtime !== false;
+// The counts the bulk routes answer with: delete sends the number of deleted
+// rows (or `{ deleted }`), archive and restore `{ archivedCount }` and
+// `{ restoredCount }`.
+const CHANGED_COUNT_KEYS = ["deleted", "archivedCount", "restoredCount"];
+/**
+ * Whether a write reports changing no row: its row rules refused every id,
+ * or none existed. Broadcasting its ids would have every session watching
+ * the table (the caller included) drop rows that are still there.
+ */
+/** @internal */
+const reportsNoChange = (result) => {
+    if (typeof result === "number")
+        return result === 0;
+    if (!result || typeof result !== "object")
+        return false;
+    const counts = CHANGED_COUNT_KEYS.map((key) => result[key]).filter((value) => typeof value === "number");
+    return counts.length > 0 && counts.every((count) => count === 0);
+};
+exports.reportsNoChange = reportsNoChange;
+/** @internal */
+function withRealtimeMutation(config, baseRoute) {
+    return {
+        method: baseRoute.method,
+        args: [
+            ...baseRoute.args,
+            (0, interface_api_1.Parameter)(REALTIME_SESSION_HEADER, "header"),
+            (0, auth_1.AuthUser)(),
+        ],
+        func: async function (...allArgs) {
+            const user = allArgs.pop();
+            const sessionId = allArgs.pop();
+            const result = await baseRoute.func.apply(this, allArgs);
+            if (!isRealtimeEnabled(this))
+                return result;
+            const meta = (0, meta_1.getTableViewMetaFor)(this);
+            const idKey = meta.options.rowIdKey || "_id";
+            const ids = config.extractIds(allArgs, result, idKey);
+            if (ids.length === 0 && config.eventType !== "created")
+                return result;
+            if (config.eventType !== "created" && (0, exports.reportsNoChange)(result)) {
+                return result;
+            }
+            await dispatchRealtimeMutation({
+                controllerLocation: (0, meta_1.getControllerLocation)(this),
+                rowIdKey: idKey,
+                eventType: config.eventType,
+                ids,
+                sessionId,
+                actor: { id: user._id, displayName: user.name || user.email },
+            });
+            return result;
+        },
+    };
+}
+/** @internal */
+function withPresenceAcquire(baseRoute) {
+    return {
+        method: baseRoute.method,
+        args: [
+            ...baseRoute.args,
+            (0, interface_api_1.Parameter)(REALTIME_SESSION_HEADER, "header"),
+            (0, interface_api_1.Parameter)(exports.REALTIME_PRESENCE_QUERY, "query"),
+            (0, auth_1.AuthUser)(),
+        ],
+        func: async function (...allArgs) {
+            const user = allArgs.pop();
+            const presenceFlag = allArgs.pop();
+            const sessionId = allArgs.pop();
+            const result = await baseRoute.func.apply(this, allArgs);
+            if (presenceFlag !== exports.REALTIME_PRESENCE_ACQUIRE_VALUE ||
+                !sessionId ||
+                !isRealtimeEnabled(this)) {
+                return result;
+            }
+            const params = allArgs[PARAMS_INDEX];
+            if (!params?.id)
+                return result;
+            const meta = (0, meta_1.getTableViewMetaFor)(this);
+            await realtime_2.internal.AcquirePresence({
+                controllerLocation: (0, meta_1.getControllerLocation)(this),
+                rowIdKey: meta.options.rowIdKey || "_id",
+                sessionId,
+                rowId: params.id,
+                actor: { id: user._id, displayName: user.name || user.email },
+            });
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=realtime.js.map