@terreno/admin-backend 57.2.0 → 57.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/.ai/guidelines/core.md +12 -4
  2. package/.claude/CLAUDE.local.md +17 -2
  3. package/.cursor/rules/00-root.mdc +17 -2
  4. package/.github/copilot-instructions.md +17 -2
  5. package/AGENTS.md +17 -2
  6. package/README.md +3 -1
  7. package/bunfig.toml +9 -1
  8. package/dist/adminApp.d.ts +20 -2
  9. package/dist/adminApp.js +480 -474
  10. package/dist/adminConfigIdentity.d.ts +1 -0
  11. package/dist/adminConfigIdentity.js +1 -0
  12. package/dist/adminMigrations.d.ts +10 -0
  13. package/dist/adminMigrations.js +205 -0
  14. package/dist/adminScriptJob.d.ts +32 -0
  15. package/dist/adminScriptJob.js +360 -0
  16. package/dist/adminTextSearch.d.ts +1 -0
  17. package/dist/adminTextSearch.js +1 -0
  18. package/dist/adminUiV2.d.ts +2 -0
  19. package/dist/aggregateAdmin.js +6 -1
  20. package/dist/documentStorageApp.js +1 -4
  21. package/dist/enrichAdminListFilters.d.ts +7 -0
  22. package/dist/enrichAdminListFilters.js +37 -0
  23. package/dist/filterParser.js +139 -12
  24. package/dist/index.d.ts +2 -0
  25. package/dist/index.js +4 -1
  26. package/dist/legacy.js +4 -2
  27. package/dist/resolvedAdminModel.js +2 -1
  28. package/package.json +8 -8
  29. package/src/adminApp.migrations.test.ts +232 -0
  30. package/src/adminApp.models.test.ts +647 -5
  31. package/src/adminApp.syncMeta.test.ts +237 -0
  32. package/src/adminApp.test.ts +92 -0
  33. package/src/adminApp.ts +354 -240
  34. package/src/adminConfigIdentity.ts +1 -0
  35. package/src/adminHttpGoldens.test.ts +337 -0
  36. package/src/adminMigrations.ts +157 -0
  37. package/src/adminScriptJob.test.ts +297 -0
  38. package/src/adminScriptJob.ts +271 -0
  39. package/src/adminSyncMutationAuthMismatch.test.ts +650 -0
  40. package/src/adminTextSearch.test.ts +28 -0
  41. package/src/adminTextSearch.ts +1 -0
  42. package/src/adminUiV2.test.ts +71 -1
  43. package/src/adminUiV2.ts +2 -0
  44. package/src/aggregateAdmin.test.ts +125 -0
  45. package/src/aggregateAdmin.ts +7 -4
  46. package/src/documentStorageApp.ts +1 -3
  47. package/src/enrichAdminListFilters.test.ts +44 -0
  48. package/src/enrichAdminListFilters.ts +29 -0
  49. package/src/filterParser.test.ts +95 -0
  50. package/src/filterParser.ts +156 -10
  51. package/src/index.ts +2 -0
  52. package/src/legacy.ts +5 -1
  53. package/src/resolvedAdminModel.ts +2 -1
@@ -4,6 +4,7 @@ export interface AdminConfigNameInput {
4
4
  routePath: string;
5
5
  source?: AdminModelSource;
6
6
  }
7
+ /** @internal */
7
8
  export declare const slugFromAdminRoutePath: (routePath: string) => string;
8
9
  /**
9
10
  * UI route keys must be unique even when the same Mongoose model is mounted at
@@ -17,6 +17,7 @@ var SOURCE_RANK = {
17
17
  plugin: 1,
18
18
  registered: 2,
19
19
  };
20
+ /** @internal */
20
21
  var slugFromAdminRoutePath = function (routePath) {
21
22
  var trimmed = routePath.replace(/^\/+|\/+$/g, "").replace(/\//g, "-");
22
23
  if (!trimmed) {
@@ -0,0 +1,10 @@
1
+ import { type OpenApiMiddleware, type PermissionMethod } from "@terreno/api";
2
+ import type express from "express";
3
+ export declare const mountAdminMigrationRoutes: ({ app, basePath, dir, openApi, runPermissions, statusPermissions, }: {
4
+ app: express.Application;
5
+ basePath: string;
6
+ dir: string | undefined;
7
+ openApi?: OpenApiMiddleware;
8
+ runPermissions: PermissionMethod<unknown>[];
9
+ statusPermissions: PermissionMethod<unknown>[];
10
+ }) => void;
@@ -0,0 +1,205 @@
1
+ "use strict";
2
+ var __assign = (this && this.__assign) || function () {
3
+ __assign = Object.assign || function(t) {
4
+ for (var s, i = 1, n = arguments.length; i < n; i++) {
5
+ s = arguments[i];
6
+ for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
7
+ t[p] = s[p];
8
+ }
9
+ return t;
10
+ };
11
+ return __assign.apply(this, arguments);
12
+ };
13
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
14
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
15
+ return new (P || (P = Promise))(function (resolve, reject) {
16
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
17
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
18
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
19
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
20
+ });
21
+ };
22
+ var __generator = (this && this.__generator) || function (thisArg, body) {
23
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
24
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
+ function verb(n) { return function (v) { return step([n, v]); }; }
26
+ function step(op) {
27
+ if (f) throw new TypeError("Generator is already executing.");
28
+ while (g && (g = 0, op[0] && (_ = 0)), _) try {
29
+ if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
30
+ if (y = 0, t) op = [op[0] & 2, t.value];
31
+ switch (op[0]) {
32
+ case 0: case 1: t = op; break;
33
+ case 4: _.label++; return { value: op[1], done: false };
34
+ case 5: _.label++; y = op[1]; op = [0]; continue;
35
+ case 7: op = _.ops.pop(); _.trys.pop(); continue;
36
+ default:
37
+ if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
38
+ if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
39
+ if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
40
+ if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
41
+ if (t[2]) _.ops.pop();
42
+ _.trys.pop(); continue;
43
+ }
44
+ op = body.call(thisArg, _);
45
+ } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
46
+ if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
47
+ }
48
+ };
49
+ var __importDefault = (this && this.__importDefault) || function (mod) {
50
+ return (mod && mod.__esModule) ? mod : { "default": mod };
51
+ };
52
+ Object.defineProperty(exports, "__esModule", { value: true });
53
+ exports.mountAdminMigrationRoutes = void 0;
54
+ var api_1 = require("@terreno/api");
55
+ var luxon_1 = require("luxon");
56
+ var mongoose_1 = __importDefault(require("mongoose"));
57
+ var DISABLED_CRUD = {
58
+ create: [],
59
+ delete: [],
60
+ list: [],
61
+ read: [],
62
+ update: [],
63
+ };
64
+ var runQuerySchema = api_1.z.object({
65
+ wetRun: api_1.z.enum(["true", "false"]).optional(),
66
+ });
67
+ var mountAdminMigrationRoutes = function (_a) {
68
+ var app = _a.app, basePath = _a.basePath, dir = _a.dir, openApi = _a.openApi, runPermissions = _a.runPermissions, statusPermissions = _a.statusPermissions;
69
+ var requireDir = function () {
70
+ if (!dir) {
71
+ throw new api_1.APIError({ status: 404, title: "Migrations are not configured" });
72
+ }
73
+ return dir;
74
+ };
75
+ app.use("".concat(basePath, "/migrations"), (0, api_1.modelRouter)(api_1.BackgroundTask, __assign(__assign({}, (openApi ? { openApi: openApi } : {})), { collectionActions: {
76
+ run: {
77
+ handler: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
78
+ var actor, migrationsDir, isWetRun, now, task;
79
+ var _c;
80
+ var query = _b.query, user = _b.user;
81
+ return __generator(this, function (_d) {
82
+ switch (_d.label) {
83
+ case 0:
84
+ actor = user;
85
+ if (!actor) {
86
+ throw new api_1.APIError({ status: 403, title: "Admin access required" });
87
+ }
88
+ migrationsDir = requireDir();
89
+ isWetRun = query.wetRun === "true";
90
+ (0, api_1.assertMigrationsAllowed)({
91
+ allowEnv: process.env.ALLOW_MIGRATIONS === "true",
92
+ dryRun: !isWetRun,
93
+ force: true,
94
+ isProduction: process.env.NODE_ENV === "production",
95
+ });
96
+ now = luxon_1.DateTime.now().toJSDate();
97
+ return [4 /*yield*/, api_1.BackgroundTask.create({
98
+ createdBy: actor._id,
99
+ isDryRun: !isWetRun,
100
+ logs: [
101
+ {
102
+ level: "info",
103
+ message: "Migrations ".concat(isWetRun ? "apply" : "dry-run", " started by ").concat((_c = actor.name) !== null && _c !== void 0 ? _c : "admin"),
104
+ timestamp: now,
105
+ },
106
+ ],
107
+ progress: { message: "Starting...", percentage: 0, stage: "Queued" },
108
+ startedAt: now,
109
+ status: "running",
110
+ taskType: "migrations:up",
111
+ })];
112
+ case 1:
113
+ task = (_d.sent());
114
+ void (function () { return __awaiter(void 0, void 0, void 0, function () {
115
+ var migrations, result, error_1, detail;
116
+ return __generator(this, function (_a) {
117
+ switch (_a.label) {
118
+ case 0:
119
+ _a.trys.push([0, 4, , 6]);
120
+ return [4 /*yield*/, (0, api_1.checkMigrationFiles)({ dir: migrationsDir })];
121
+ case 1:
122
+ migrations = _a.sent();
123
+ return [4 /*yield*/, (0, api_1.runMigrations)({
124
+ checkCancellation: function () { return __awaiter(void 0, void 0, void 0, function () {
125
+ return __generator(this, function (_a) {
126
+ switch (_a.label) {
127
+ case 0: return [4 /*yield*/, api_1.BackgroundTask.checkCancellation(task._id.toString())];
128
+ case 1:
129
+ _a.sent();
130
+ return [2 /*return*/];
131
+ }
132
+ });
133
+ }); },
134
+ connection: mongoose_1.default.connection,
135
+ dryRun: !isWetRun,
136
+ migrations: migrations,
137
+ mongoose: mongoose_1.default,
138
+ })];
139
+ case 2:
140
+ result = _a.sent();
141
+ return [4 /*yield*/, api_1.BackgroundTask.findOneAndUpdate({ _id: task._id, status: "running" }, {
142
+ $set: {
143
+ completedAt: luxon_1.DateTime.now().toJSDate(),
144
+ progress: { message: "Done", percentage: 100, stage: "Complete" },
145
+ result: result.applied,
146
+ status: "completed",
147
+ },
148
+ })];
149
+ case 3:
150
+ _a.sent();
151
+ return [3 /*break*/, 6];
152
+ case 4:
153
+ error_1 = _a.sent();
154
+ detail = error_1 instanceof Error ? error_1.message : String(error_1);
155
+ api_1.logger.error("Admin migrations run failed: ".concat(detail));
156
+ return [4 /*yield*/, api_1.BackgroundTask.findOneAndUpdate({ _id: task._id, status: "running" }, {
157
+ $set: {
158
+ completedAt: luxon_1.DateTime.now().toJSDate(),
159
+ error: detail,
160
+ status: "failed",
161
+ },
162
+ })];
163
+ case 5:
164
+ _a.sent();
165
+ return [3 /*break*/, 6];
166
+ case 6: return [2 /*return*/];
167
+ }
168
+ });
169
+ }); })();
170
+ return [2 /*return*/, { taskId: task._id.toString() }];
171
+ }
172
+ });
173
+ }); },
174
+ method: "POST",
175
+ permissions: runPermissions,
176
+ query: runQuerySchema,
177
+ status: 201,
178
+ summary: "Dry-run or apply pending MongoDB migrations",
179
+ tag: "adminMigrations",
180
+ },
181
+ status: {
182
+ handler: function () { return __awaiter(void 0, void 0, void 0, function () {
183
+ var migrationsDir, migrations;
184
+ return __generator(this, function (_a) {
185
+ switch (_a.label) {
186
+ case 0:
187
+ migrationsDir = requireDir();
188
+ return [4 /*yield*/, (0, api_1.checkMigrationFiles)({ dir: migrationsDir })];
189
+ case 1:
190
+ migrations = _a.sent();
191
+ return [2 /*return*/, (0, api_1.getMigrationStatus)({
192
+ connection: mongoose_1.default.connection,
193
+ migrations: migrations,
194
+ })];
195
+ }
196
+ });
197
+ }); },
198
+ method: "GET",
199
+ permissions: statusPermissions,
200
+ summary: "List applied and pending MongoDB migrations",
201
+ tag: "adminMigrations",
202
+ },
203
+ }, permissions: DISABLED_CRUD })));
204
+ };
205
+ exports.mountAdminMigrationRoutes = mountAdminMigrationRoutes;
@@ -0,0 +1,32 @@
1
+ import { type ScriptArgDef, type ScriptArgs, type ScriptArgValue, type ScriptRunner } from "@terreno/api";
2
+ import { type JobDefinition } from "@terreno/jobs";
3
+ export interface AdminScriptJobTarget {
4
+ args?: ScriptArgDef[];
5
+ name: string;
6
+ runner: ScriptRunner;
7
+ }
8
+ /** Durable job name for admin panel script runs. */
9
+ export declare const ADMIN_SCRIPT_JOB_NAME = "admin/script";
10
+ export interface AdminScriptJobPayload {
11
+ args: Record<string, ScriptArgValue>;
12
+ createdByName?: string;
13
+ scriptName: string;
14
+ taskId: string;
15
+ wetRun: boolean;
16
+ }
17
+ export interface JobsDefineHost {
18
+ define: (name: string, definition: JobDefinition) => unknown;
19
+ }
20
+ export declare const runRegisteredScriptTask: ({ args, script, signal, taskId, wetRun, }: {
21
+ args: ScriptArgs;
22
+ script: AdminScriptJobTarget;
23
+ signal?: AbortSignal;
24
+ taskId: string;
25
+ wetRun: boolean;
26
+ }) => Promise<void>;
27
+ /** Register the shared `admin/script` handler (maxAttempts 1 — scripts are not assumed idempotent). */
28
+ export declare const defineAdminScriptJob: (jobs: JobsDefineHost, getScript: (name: string) => AdminScriptJobTarget | undefined) => void;
29
+ export declare const tryEnqueueAdminScriptJob: (payload: AdminScriptJobPayload) => Promise<{
30
+ id: string;
31
+ } | undefined>;
32
+ export declare const tryCancelAdminScriptJob: (taskId: string) => Promise<void>;
@@ -0,0 +1,360 @@
1
+ "use strict";
2
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
+ return new (P || (P = Promise))(function (resolve, reject) {
5
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
9
+ });
10
+ };
11
+ var __generator = (this && this.__generator) || function (thisArg, body) {
12
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
+ function verb(n) { return function (v) { return step([n, v]); }; }
15
+ function step(op) {
16
+ if (f) throw new TypeError("Generator is already executing.");
17
+ while (g && (g = 0, op[0] && (_ = 0)), _) try {
18
+ if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
19
+ if (y = 0, t) op = [op[0] & 2, t.value];
20
+ switch (op[0]) {
21
+ case 0: case 1: t = op; break;
22
+ case 4: _.label++; return { value: op[1], done: false };
23
+ case 5: _.label++; y = op[1]; op = [0]; continue;
24
+ case 7: op = _.ops.pop(); _.trys.pop(); continue;
25
+ default:
26
+ if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
27
+ if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
28
+ if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
29
+ if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
30
+ if (t[2]) _.ops.pop();
31
+ _.trys.pop(); continue;
32
+ }
33
+ op = body.call(thisArg, _);
34
+ } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
35
+ if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
+ }
37
+ };
38
+ var __values = (this && this.__values) || function(o) {
39
+ var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
40
+ if (m) return m.call(o);
41
+ if (o && typeof o.length === "number") return {
42
+ next: function () {
43
+ if (o && i >= o.length) o = void 0;
44
+ return { value: o && o[i++], done: !o };
45
+ }
46
+ };
47
+ throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
48
+ };
49
+ var __read = (this && this.__read) || function (o, n) {
50
+ var m = typeof Symbol === "function" && o[Symbol.iterator];
51
+ if (!m) return o;
52
+ var i = m.call(o), r, ar = [], e;
53
+ try {
54
+ while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
55
+ }
56
+ catch (error) { e = { error: error }; }
57
+ finally {
58
+ try {
59
+ if (r && !r.done && (m = i["return"])) m.call(i);
60
+ }
61
+ finally { if (e) throw e.error; }
62
+ }
63
+ return ar;
64
+ };
65
+ Object.defineProperty(exports, "__esModule", { value: true });
66
+ exports.tryCancelAdminScriptJob = exports.tryEnqueueAdminScriptJob = exports.defineAdminScriptJob = exports.runRegisteredScriptTask = exports.ADMIN_SCRIPT_JOB_NAME = void 0;
67
+ var api_1 = require("@terreno/api");
68
+ var jobs_1 = require("@terreno/jobs");
69
+ var luxon_1 = require("luxon");
70
+ /** Durable job name for admin panel script runs. */
71
+ exports.ADMIN_SCRIPT_JOB_NAME = "admin/script";
72
+ var isScriptArgValue = function (value) {
73
+ if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
74
+ return true;
75
+ }
76
+ if (!Array.isArray(value)) {
77
+ return false;
78
+ }
79
+ return value.every(function (entry) { return typeof entry === "string"; });
80
+ };
81
+ var parseAdminScriptJobPayload = function (payload) {
82
+ var e_1, _a;
83
+ if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
84
+ return undefined;
85
+ }
86
+ var record = payload;
87
+ if (typeof record.scriptName !== "string" || record.scriptName.length === 0) {
88
+ return undefined;
89
+ }
90
+ if (typeof record.taskId !== "string" || record.taskId.length === 0) {
91
+ return undefined;
92
+ }
93
+ if (typeof record.wetRun !== "boolean") {
94
+ return undefined;
95
+ }
96
+ var args = {};
97
+ if (record.args !== undefined) {
98
+ if (!record.args || typeof record.args !== "object" || Array.isArray(record.args)) {
99
+ return undefined;
100
+ }
101
+ try {
102
+ for (var _b = __values(Object.entries(record.args)), _c = _b.next(); !_c.done; _c = _b.next()) {
103
+ var _d = __read(_c.value, 2), key = _d[0], value = _d[1];
104
+ if (!isScriptArgValue(value)) {
105
+ return undefined;
106
+ }
107
+ args[key] = value;
108
+ }
109
+ }
110
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
111
+ finally {
112
+ try {
113
+ if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
114
+ }
115
+ finally { if (e_1) throw e_1.error; }
116
+ }
117
+ }
118
+ var createdByName = typeof record.createdByName === "string" ? record.createdByName : undefined;
119
+ return {
120
+ args: args,
121
+ createdByName: createdByName,
122
+ scriptName: record.scriptName,
123
+ taskId: record.taskId,
124
+ wetRun: record.wetRun,
125
+ };
126
+ };
127
+ var isAbortLike = function (error) {
128
+ if (error instanceof api_1.TaskCancelledError) {
129
+ return true;
130
+ }
131
+ if (!(error instanceof Error)) {
132
+ return false;
133
+ }
134
+ return error.name === "AbortError" || error.name === "TaskCancelledError";
135
+ };
136
+ var runRegisteredScriptTask = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
137
+ var now, ctx, result, err_1, message;
138
+ var args = _b.args, script = _b.script, signal = _b.signal, taskId = _b.taskId, wetRun = _b.wetRun;
139
+ return __generator(this, function (_c) {
140
+ switch (_c.label) {
141
+ case 0:
142
+ now = luxon_1.DateTime.now().toJSDate();
143
+ return [4 /*yield*/, api_1.BackgroundTask.findOneAndUpdate({ _id: taskId, status: { $in: ["pending", "running"] } }, {
144
+ $set: {
145
+ progress: { message: "Starting...", percentage: 0, stage: "Running" },
146
+ startedAt: now,
147
+ status: "running",
148
+ },
149
+ })];
150
+ case 1:
151
+ _c.sent();
152
+ ctx = {
153
+ addLog: function (level, message) { return __awaiter(void 0, void 0, void 0, function () {
154
+ var current;
155
+ return __generator(this, function (_a) {
156
+ switch (_a.label) {
157
+ case 0: return [4 /*yield*/, api_1.BackgroundTask.findById(taskId)];
158
+ case 1:
159
+ current = _a.sent();
160
+ if (!current) return [3 /*break*/, 3];
161
+ return [4 /*yield*/, current.addLog(level, message)];
162
+ case 2:
163
+ _a.sent();
164
+ _a.label = 3;
165
+ case 3: return [2 /*return*/];
166
+ }
167
+ });
168
+ }); },
169
+ args: args,
170
+ checkCancellation: function () { return __awaiter(void 0, void 0, void 0, function () {
171
+ return __generator(this, function (_a) {
172
+ switch (_a.label) {
173
+ case 0:
174
+ if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
175
+ throw new api_1.TaskCancelledError(taskId);
176
+ }
177
+ return [4 /*yield*/, api_1.BackgroundTask.checkCancellation(taskId)];
178
+ case 1:
179
+ _a.sent();
180
+ return [2 /*return*/];
181
+ }
182
+ });
183
+ }); },
184
+ updateProgress: function (percentage, stage, message) { return __awaiter(void 0, void 0, void 0, function () {
185
+ var current;
186
+ return __generator(this, function (_a) {
187
+ switch (_a.label) {
188
+ case 0: return [4 /*yield*/, api_1.BackgroundTask.findById(taskId)];
189
+ case 1:
190
+ current = _a.sent();
191
+ if (!current) return [3 /*break*/, 3];
192
+ return [4 /*yield*/, current.updateProgress(percentage, stage, message)];
193
+ case 2:
194
+ _a.sent();
195
+ _a.label = 3;
196
+ case 3: return [2 /*return*/];
197
+ }
198
+ });
199
+ }); },
200
+ };
201
+ _c.label = 2;
202
+ case 2:
203
+ _c.trys.push([2, 6, , 10]);
204
+ return [4 /*yield*/, ctx.checkCancellation()];
205
+ case 3:
206
+ _c.sent();
207
+ return [4 /*yield*/, script.runner(wetRun, ctx)];
208
+ case 4:
209
+ result = _c.sent();
210
+ return [4 /*yield*/, api_1.BackgroundTask.findOneAndUpdate({ _id: taskId, status: "running" }, {
211
+ $set: {
212
+ completedAt: luxon_1.DateTime.now().toJSDate(),
213
+ progress: { message: "Done", percentage: 100, stage: "Complete" },
214
+ result: result.results,
215
+ status: result.success ? "completed" : "failed",
216
+ },
217
+ })];
218
+ case 5:
219
+ _c.sent();
220
+ return [3 /*break*/, 10];
221
+ case 6:
222
+ err_1 = _c.sent();
223
+ if (!isAbortLike(err_1)) return [3 /*break*/, 8];
224
+ return [4 /*yield*/, api_1.BackgroundTask.findOneAndUpdate({ _id: taskId, status: { $in: ["pending", "running"] } }, {
225
+ $set: {
226
+ completedAt: luxon_1.DateTime.now().toJSDate(),
227
+ status: "cancelled",
228
+ },
229
+ })];
230
+ case 7:
231
+ _c.sent();
232
+ return [2 /*return*/];
233
+ case 8:
234
+ message = err_1 instanceof Error ? err_1.message : String(err_1);
235
+ api_1.logger.error("Script ".concat(script.name, " failed: ").concat(message));
236
+ return [4 /*yield*/, api_1.BackgroundTask.findOneAndUpdate({ _id: taskId, status: "running" }, {
237
+ $set: {
238
+ completedAt: luxon_1.DateTime.now().toJSDate(),
239
+ error: message,
240
+ result: [message],
241
+ status: "failed",
242
+ },
243
+ })];
244
+ case 9:
245
+ _c.sent();
246
+ return [3 /*break*/, 10];
247
+ case 10: return [2 /*return*/];
248
+ }
249
+ });
250
+ }); };
251
+ exports.runRegisteredScriptTask = runRegisteredScriptTask;
252
+ var createAdminScriptHandler = function (getScript) {
253
+ return function (payload, ctx) { return __awaiter(void 0, void 0, void 0, function () {
254
+ var parsed, script, message, _a, args, errors;
255
+ var _b;
256
+ return __generator(this, function (_c) {
257
+ switch (_c.label) {
258
+ case 0:
259
+ parsed = parseAdminScriptJobPayload(payload);
260
+ if (!parsed) {
261
+ throw new api_1.APIError({ status: 400, title: "Invalid admin/script job payload" });
262
+ }
263
+ script = getScript(parsed.scriptName);
264
+ if (!!script) return [3 /*break*/, 2];
265
+ message = "Script not found: ".concat(parsed.scriptName);
266
+ return [4 /*yield*/, api_1.BackgroundTask.findOneAndUpdate({ _id: parsed.taskId, status: { $in: ["pending", "running"] } }, {
267
+ $set: {
268
+ completedAt: luxon_1.DateTime.now().toJSDate(),
269
+ error: message,
270
+ result: [message],
271
+ status: "failed",
272
+ },
273
+ })];
274
+ case 1:
275
+ _c.sent();
276
+ throw new api_1.APIError({ status: 404, title: message });
277
+ case 2:
278
+ _a = (0, api_1.createScriptArgs)({
279
+ defs: (_b = script.args) !== null && _b !== void 0 ? _b : [],
280
+ values: parsed.args,
281
+ }), args = _a.args, errors = _a.errors;
282
+ if (errors.length > 0) {
283
+ throw new api_1.APIError({ status: 400, title: errors.join("; ") });
284
+ }
285
+ return [4 /*yield*/, (0, exports.runRegisteredScriptTask)({
286
+ args: args,
287
+ script: script,
288
+ signal: ctx.signal,
289
+ taskId: parsed.taskId,
290
+ wetRun: parsed.wetRun,
291
+ })];
292
+ case 3:
293
+ _c.sent();
294
+ return [2 /*return*/];
295
+ }
296
+ });
297
+ }); };
298
+ };
299
+ /** Register the shared `admin/script` handler (maxAttempts 1 — scripts are not assumed idempotent). */
300
+ var defineAdminScriptJob = function (jobs, getScript) {
301
+ jobs.define(exports.ADMIN_SCRIPT_JOB_NAME, {
302
+ handler: createAdminScriptHandler(getScript),
303
+ retry: { maxAttempts: 1 },
304
+ });
305
+ };
306
+ exports.defineAdminScriptJob = defineAdminScriptJob;
307
+ var tryEnqueueAdminScriptJob = function (payload) { return __awaiter(void 0, void 0, void 0, function () {
308
+ var jobs, job;
309
+ return __generator(this, function (_a) {
310
+ switch (_a.label) {
311
+ case 0:
312
+ jobs = (0, jobs_1.tryGetJobsService)();
313
+ if (!(jobs === null || jobs === void 0 ? void 0 : jobs.getDefinition(exports.ADMIN_SCRIPT_JOB_NAME))) {
314
+ return [2 /*return*/, undefined];
315
+ }
316
+ return [4 /*yield*/, jobs.enqueue({
317
+ idempotencyKey: "admin-script:".concat(payload.taskId),
318
+ name: exports.ADMIN_SCRIPT_JOB_NAME,
319
+ payload: payload,
320
+ })];
321
+ case 1:
322
+ job = _a.sent();
323
+ return [2 /*return*/, { id: String(job._id) }];
324
+ }
325
+ });
326
+ }); };
327
+ exports.tryEnqueueAdminScriptJob = tryEnqueueAdminScriptJob;
328
+ var tryCancelAdminScriptJob = function (taskId) { return __awaiter(void 0, void 0, void 0, function () {
329
+ var jobs, job, _a;
330
+ return __generator(this, function (_b) {
331
+ switch (_b.label) {
332
+ case 0:
333
+ jobs = (0, jobs_1.tryGetJobsService)();
334
+ if (!jobs) {
335
+ return [2 /*return*/];
336
+ }
337
+ return [4 /*yield*/, jobs_1.Job.findOneOrNone({
338
+ name: exports.ADMIN_SCRIPT_JOB_NAME,
339
+ "payload.taskId": taskId,
340
+ })];
341
+ case 1:
342
+ job = _b.sent();
343
+ if (!job) {
344
+ return [2 /*return*/];
345
+ }
346
+ _b.label = 2;
347
+ case 2:
348
+ _b.trys.push([2, 4, , 5]);
349
+ return [4 /*yield*/, jobs.adminCancelJob(String(job._id))];
350
+ case 3:
351
+ _b.sent();
352
+ return [3 /*break*/, 5];
353
+ case 4:
354
+ _a = _b.sent();
355
+ return [3 /*break*/, 5];
356
+ case 5: return [2 /*return*/];
357
+ }
358
+ });
359
+ }); };
360
+ exports.tryCancelAdminScriptJob = tryCancelAdminScriptJob;
@@ -1,6 +1,7 @@
1
1
  import mongoose from "mongoose";
2
2
  /** List-query param for the admin table search box. */
3
3
  export declare const ADMIN_LIST_SEARCH_PARAM = "q";
4
+ /** @internal */
4
5
  export declare const escapeRegexLiteral: (value: string) => string;
5
6
  /**
6
7
  * Case-insensitive partial match across string `searchFields`, plus ObjectId equality
@@ -43,6 +43,7 @@ exports.andMongoFilters = exports.buildAdminPartialSearchFilter = exports.escape
43
43
  var mongoose_1 = __importDefault(require("mongoose"));
44
44
  /** List-query param for the admin table search box. */
45
45
  exports.ADMIN_LIST_SEARCH_PARAM = "q";
46
+ /** @internal */
46
47
  var escapeRegexLiteral = function (value) {
47
48
  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
48
49
  };
@@ -38,6 +38,8 @@ export interface AdminListFilterChoice {
38
38
  label: string;
39
39
  value: string;
40
40
  }[];
41
+ /** When true, filter UI offers Empty and parser accepts `__empty__` sentinel. */
42
+ allowEmpty?: boolean;
41
43
  field: string;
42
44
  kind: "choice";
43
45
  label?: string;