@antelopejs/dms 0.11.0 → 0.12.0

package/frontend-vue/server/private-options.ts

@@ -1,4 +1,5 @@
 import type { DmsServerEvent } from "#dms/server";
+import { z } from "zod";
 
 /**
  * A secret of the DMS's private options, as the frontend server hands them
@@ -18,10 +19,10 @@ export function privateSecret(
   key: string,
   variable: string,
 ): string | undefined {
-  const options = event.module.privateOptions[section] as
-    | Record<string, unknown>
-    | undefined;
-  const value = options?.[key];
-  if (typeof value === "string" && value) return value;
+  const options = event.module.privateOptions[section];
+  const secret = z
+    .string()
+    .safeParse(options == null ? undefined : Object(options)[key]);
+  if (secret.success && secret.data) return secret.data;
   return process.env[variable] || undefined;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/dms",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "The AntelopeJS dashboard management system: admin dashboards declared in TypeScript, with auth and tenancy, data management, file uploads, notifications and realtime.",
   "keywords": [
     "antelopejs",
@@ -21,9 +21,13 @@
     "directory": "packages/dms"
   },
   "main": "dist/index.js",
+  "bin": {
+    "dms-control": "bin/dms-control.mjs"
+  },
   "types": "dist/index.d.ts",
   "dmsFrontend": "dist/frontend-module.js",
   "files": [
+    "bin",
     "dist",
     "!dist/.tsbuildinfo",
     "!dist/test",
@@ -58,10 +62,10 @@
     "@antelopejs/interface-api": ">=0.0.15 <1.0.0",
     "@antelopejs/interface-api-util": ">=0.1.3 <1.0.0",
     "@antelopejs/interface-core": ">=0.2.4 <1.0.0",
-    "@antelopejs/interface-data-api": ">=0.4.0 <1.0.0",
+    "@antelopejs/interface-data-api": ">=0.5.0 <1.0.0",
     "@antelopejs/interface-database": ">=0.1.11 <1.0.0",
     "@antelopejs/interface-database-decorators": ">=0.1.10 <1.0.0",
-    "@antelopejs/interface-dms": ">=0.9.0 <0.10.0",
+    "@antelopejs/interface-dms": ">=0.10.0 <0.11.0",
     "@antelopejs/interface-email": ">=0.0.6 <1.0.0",
     "@antelopejs/interface-file-storage": ">=0.1.4 <1.0.0",
     "archiver": "^7.0.1",
@@ -78,7 +82,7 @@
   },
   "devDependencies": {
     "@antelopejs/core": ">=1.17.0 <2",
-    "@antelopejs/tooling-configs": ">=0.0.9 <1.0.0",
+    "@antelopejs/tooling-configs": "0.2.0",
     "@types/archiver": "^6.0.4",
     "@types/chai": "^4.3.20",
     "@types/jsonwebtoken": "^9.0.10",
@@ -129,15 +133,12 @@
   },
   "scripts": {
     "build": "pnpm --filter @antelopejs/interface-dms build && rimraf dist && tsc && tsc-alias",
-    "format": "oxfmt . && pnpm --dir frontend-vue format",
     "dev": "ajs project run --inspect -w -p playground",
     "frontend:dev": "pnpm --dir playground frontend:dev",
-    "lint:fix": "oxlint --fix --max-warnings=1000000 && oxfmt . && pnpm --dir frontend-vue lint:fix",
-    "lint": "oxlint && oxfmt --check . && pnpm --dir frontend-vue lint && antelopejs-check-interface-ranges",
     "typecheck": "node scripts/unless-prebuilt.mjs pnpm --filter @antelopejs/interface-dms build && tsc --noEmit",
-    "test": "node scripts/unless-prebuilt.mjs pnpm run build && ajs module test .",
-    "test:unit": "node scripts/unless-prebuilt.mjs pnpm run build && DMS_TEST_DIR=dist/test/unit ajs module test .",
-    "test:integration": "node scripts/unless-prebuilt.mjs pnpm run build && DMS_TEST_DIR=dist/test/integration ajs module test .",
+    "test": "node scripts/unless-prebuilt.mjs pnpm run build && NODE_OPTIONS=\"${NODE_OPTIONS:+$NODE_OPTIONS }--require=\\\"$PWD/scripts/backend-runtime-boundaries.cjs\\\"\" ajs module test .",
+    "test:unit": "node scripts/unless-prebuilt.mjs pnpm run build && node scripts/backend-checks.cjs && DMS_TEST_DIR=dist/test/unit NODE_OPTIONS=\"${NODE_OPTIONS:+$NODE_OPTIONS }--require=\\\"$PWD/scripts/backend-runtime-boundaries.cjs\\\"\" ajs module test .",
+    "test:integration": "node scripts/unless-prebuilt.mjs pnpm run build && DMS_TEST_DIR=dist/test/integration NODE_OPTIONS=\"${NODE_OPTIONS:+$NODE_OPTIONS }--require=\\\"$PWD/scripts/backend-runtime-boundaries.cjs\\\"\" ajs module test .",
     "test:watch": "tsc -w & tsc-alias -w",
     "release": "pnpm --filter @antelopejs/interface-dms build && pnpm --dir frontend-vue install --frozen-lockfile && release-it",
     "country-database": "node scripts/fetch-country-database.mjs",

package/skills/dms/cases.json

@@ -0,0 +1,52 @@
+{
+  "version": 1,
+  "cases": [
+    {
+      "id": "dms-overview-page-to-screen",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Give me the big picture of the AntelopeJS DMS: how does a page described in backend TypeScript end up as a screen in the dashboard?",
+      "expect": {
+        "skills": ["dms"],
+        "acceptable": ["dms-pages", "dms-best-practices", "antelopejs"],
+        "mustMention": ["PageController", "RegisterPage"]
+      }
+    },
+    {
+      "id": "dms-whats-the-dms-casual",
+      "area": "dms",
+      "style": "casual",
+      "prompt": "whats the dms in antelopejs, do i have to write vue for every admin screen?",
+      "expect": {
+        "skills": ["dms"],
+        "acceptable": ["dms-pages", "dms-best-practices", "antelopejs"]
+      }
+    },
+    {
+      "id": "dms-route-url-for-page-route",
+      "area": "dms",
+      "style": "casual",
+      "prompt": "dms: i declared a @Get on my page class, what do i put in the block fetchUrl so it hits it",
+      "expect": {
+        "skills": ["dms", "dms-pages"],
+        "acceptable": ["dms-best-practices"],
+        "mustMention": ["pageRoutePath"]
+      }
+    },
+    {
+      "id": "dms-not-core-interfaces",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "In a plain AntelopeJS module with no DMS involved, how does the core choose which implementation serves an interface that several modules provide?",
+      "expect": {
+        "skills": ["antelopejs"],
+        "acceptable": [
+          "ajs-consume-interface",
+          "ajs-author-interface",
+          "core-interface"
+        ],
+        "avoid": ["dms"]
+      }
+    }
+  ]
+}

package/skills/dms-auth/cases.json

@@ -0,0 +1,70 @@
+{
+  "version": 1,
+  "cases": [
+    {
+      "id": "admins-only-page",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Only administrators should be able to open the billing page.",
+      "expect": {
+        "skills": ["dms-auth"],
+        "acceptable": ["dms-pages", "dms-best-practices", "dms-saas", "dms"]
+      }
+    },
+    {
+      "id": "route-permission",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Protect this API route so only users with the orders.write permission can call it.",
+      "expect": {
+        "skills": ["dms-auth"],
+        "acceptable": ["api-interface", "auth-interface", "dms"],
+        "mustMention": ["AuthUserWithPermission"]
+      }
+    },
+    {
+      "id": "dms-auth-check-permission-in-code",
+      "area": "dms",
+      "style": "casual",
+      "prompt": "how do i check in my handler if the logged in user actually has the orders.write perm, not just slap a decorator on it",
+      "expect": {
+        "skills": ["dms-auth"],
+        "acceptable": ["dms", "auth-interface"],
+        "mustMention": ["HasPermission"]
+      }
+    },
+    {
+      "id": "dms-auth-register-standalone-permission",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Register a standalone permission cookbook.edit that depends on cookbook.view and is not granted to anyone by default.",
+      "expect": {
+        "skills": ["dms-auth"],
+        "acceptable": ["dms"],
+        "mustMention": ["RegisterPermission", "defaultGranted"]
+      }
+    },
+    {
+      "id": "dms-auth-expired-session-returns-200",
+      "area": "dms",
+      "style": "casual",
+      "prompt": "my page still loads with a 200 as anonymous when the session expired so the token refresh never fires, why",
+      "expect": {
+        "skills": ["dms-auth"],
+        "acceptable": ["dms", "auth-interface"],
+        "mustMention": ["IfAuthUser"]
+      }
+    },
+    {
+      "id": "dms-auth-not-saas-billing",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Set up Stripe billing with plans and public sign-up so customers can subscribe to my DMS app.",
+      "expect": {
+        "skills": ["dms-saas"],
+        "acceptable": ["dms", "dms-project"],
+        "avoid": ["dms-auth"]
+      }
+    }
+  ]
+}

package/skills/dms-best-practices/cases.json

@@ -0,0 +1,82 @@
+{
+  "version": 1,
+  "cases": [
+    {
+      "id": "reproduce-mockup",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Here is a mockup of our analytics dashboard (screenshot attached). Reproduce it in the DMS.",
+      "expect": {
+        "skills": ["dms-best-practices"],
+        "acceptable": [
+          "dms",
+          "dms-pages",
+          "dms-builder-safe",
+          "dms-builder-page"
+        ],
+        "behaviour": "asks-first"
+      }
+    },
+    {
+      "id": "reproduce-figma-casual",
+      "area": "dms",
+      "style": "casual",
+      "prompt": "can u make the customers screen look exactly like this figma frame",
+      "expect": {
+        "skills": ["dms-best-practices"],
+        "acceptable": [
+          "dms",
+          "dms-pages",
+          "dms-builder-safe",
+          "dms-builder-page"
+        ],
+        "behaviour": "asks-first"
+      }
+    },
+    {
+      "id": "kanban-board",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Add a drag-and-drop kanban board for the support tickets, one column per status.",
+      "expect": {
+        "skills": ["dms-best-practices", "dms-pages"],
+        "acceptable": ["dms", "dms-module", "dms-frontend"],
+        "mustMention": ["CustomComponent"],
+        "behaviour": "asks-first"
+      }
+    },
+    {
+      "id": "gantt-chart-casual",
+      "area": "dms",
+      "style": "casual",
+      "prompt": "put a gantt chart of the project milestones on the projects page",
+      "expect": {
+        "skills": ["dms-best-practices", "dms-pages"],
+        "acceptable": ["dms", "dms-frontend"],
+        "behaviour": "asks-first"
+      }
+    },
+    {
+      "id": "custom-block-role-editor",
+      "area": "dms",
+      "style": "casual",
+      "prompt": "my custom block doesnt show up in the role editor, why",
+      "expect": {
+        "skills": ["dms-best-practices"],
+        "acceptable": ["dms-auth", "dms-pages", "dms"],
+        "mustMention": ["CustomComponent"]
+      }
+    },
+    {
+      "id": "dms-best-practices-not-data-controller",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Which permission guards the audit-log export route, and how do I register it?",
+      "expect": {
+        "skills": ["dms-auth"],
+        "acceptable": ["dms", "dms-pages"],
+        "avoid": ["dms-best-practices"]
+      }
+    }
+  ]
+}

package/skills/dms-module/cases.json

@@ -0,0 +1,62 @@
+{
+  "version": 1,
+  "cases": [
+    {
+      "id": "package-module",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Package our invoicing pages as a reusable DMS module that other projects can install.",
+      "expect": {
+        "skills": ["dms-module"],
+        "acceptable": [
+          "dms",
+          "dms-pages",
+          "ajs-author-interface",
+          "dms-frontend"
+        ]
+      }
+    },
+    {
+      "id": "ai-ship-module-skills",
+      "area": "dms-ai",
+      "style": "clean",
+      "prompt": "Make our module ship its own skill so dms-ai loads it.",
+      "expect": {
+        "skills": ["dms-module"],
+        "acceptable": ["dms-ai", "antelopejs"]
+      }
+    },
+    {
+      "id": "dms-module-installable-casual",
+      "area": "dms",
+      "style": "casual",
+      "prompt": "how do i make my dms stuff installable by other people, like dms-lang is",
+      "expect": {
+        "skills": ["dms-module"],
+        "acceptable": ["dms", "dms-pages"]
+      }
+    },
+    {
+      "id": "dms-module-lifecycle-entry",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Write the src/index.ts of a distributable DMS module with id invoicing that registers its pages and attaches its own Vue frontend.",
+      "expect": {
+        "skills": ["dms-module"],
+        "acceptable": ["dms", "dms-pages", "dms-frontend"],
+        "mustMention": ["RegisterModule", "AddFrontendModule"]
+      }
+    },
+    {
+      "id": "dms-module-not-app-pages",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Register my app's own orders page under a category and wire the lifecycle in the src/index.ts of my DMS project. It is not meant to be shared.",
+      "expect": {
+        "skills": ["dms-project"],
+        "acceptable": ["dms", "dms-pages"],
+        "avoid": ["dms-module"]
+      }
+    }
+  ]
+}

package/skills/dms-pages/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: dms-pages
-description: Declares admin pages and composes backend-driven UI on the AntelopeJS DMS. Use when adding a dashboard screen, writing a @RegisterPage / PageController class, composing Form / TableView / Chart / Grid / KpiCard blocks imported from @antelopejs/interface-dms/base, or choosing DataTypes and wiring the routes and DataControllers that feed them.
+description: Declares admin pages and composes backend-driven UI on the AntelopeJS DMS. Use when adding a dashboard screen, writing a @RegisterPage / PageController class, composing Form / TableView / Chart / Grid / KpiCard blocks imported from @antelopejs/interface-dms/base, or choosing DataTypes and wiring the routes and DataControllers that feed them. Not for editing existing pages through the AI builder in safe mode (use dms-builder-safe).
 icon: i-ph-layout
 category: dashboard
 tags: [pages, components, forms, tables, data-types, navigation]
@@ -91,7 +91,7 @@ served under `/dms/pages`, not at the page's own path (which is the page): name
 
 A **`TableView` is normally backed by a `DataController`**: a class
 `extends DataController(TableClass, TableViewRoutes.All, Controller("/path"))` registered
-with `@RegisterDataController()` (both from `@antelopejs/interface-data-api`).
+with `@RegisterDataController()` (both from `@antelopejs/interface-data-api`). `TableClass` is a `Table` declared with `@RegisterTable(name, schema)` from `@antelopejs/interface-database-decorators` (`RegisterTable` is not exported by interface-data-api).
 `TableViewRoutes` (from `@antelopejs/interface-dms/base/table-view`) provides the presets — `Get`, `List`,
 `Select`, `Count`, `New`, `Edit`, `Delete`, `Archive`, `Restore`, or `All`. Field decorators:
 `@Column` / `@Select` / `@Exported` / `@ArchiveField` / `@Searchable` from `@antelopejs/interface-dms/base` (plus

package/skills/dms-pages/cases.json

@@ -0,0 +1,96 @@
+{
+  "version": 1,
+  "cases": [
+    {
+      "id": "orders-table",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Add an orders page to the dashboard with a table of the orders: customer, total and status.",
+      "expect": {
+        "skills": ["dms-pages", "dms-best-practices"],
+        "acceptable": [
+          "dms",
+          "dms-builder-safe",
+          "dms-builder-page",
+          "data-api-interface",
+          "database-decorators-interface"
+        ],
+        "mustMention": ["TableView", "RegisterPage"],
+        "mustNotMention": ["CustomComponent"]
+      }
+    },
+    {
+      "id": "orders-table-casual",
+      "area": "dms",
+      "style": "casual",
+      "prompt": "need a table of all the orders in the admin asap",
+      "expect": {
+        "skills": ["dms-pages", "dms-best-practices"],
+        "acceptable": [
+          "dms",
+          "dms-builder-safe",
+          "dms-builder-page",
+          "data-api-interface",
+          "database-decorators-interface"
+        ],
+        "mustMention": ["TableView"]
+      }
+    },
+    {
+      "id": "kpi-row-revenue",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Add a row of KPI cards at the top of the dashboard: revenue, number of orders and average basket.",
+      "expect": {
+        "skills": ["dms-pages", "dms-best-practices"],
+        "acceptable": [
+          "dms",
+          "dms-builder-safe",
+          "dms-builder-page",
+          "data-api-interface",
+          "database-decorators-interface"
+        ],
+        "mustMention": ["KpiCard"],
+        "mustNotMention": ["CustomComponent"]
+      }
+    },
+    {
+      "id": "settings-form",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Add a settings page with a form to edit the company name, address and VAT number.",
+      "expect": {
+        "skills": ["dms-pages"],
+        "acceptable": [
+          "dms-best-practices",
+          "dms",
+          "dms-builder-safe",
+          "dms-builder-page"
+        ],
+        "mustMention": ["Form"]
+      }
+    },
+    {
+      "id": "dms-pages-fetch-url-404-casual",
+      "area": "dms",
+      "style": "casual",
+      "prompt": "my table fetch url 404s, the route is declared on the page class itself",
+      "expect": {
+        "skills": ["dms-pages"],
+        "acceptable": ["dms", "dms-best-practices"],
+        "mustMention": ["pageRoutePath"]
+      }
+    },
+    {
+      "id": "dms-pages-not-safe-mode-builder",
+      "area": "dms",
+      "style": "casual",
+      "prompt": "we run the assistant in safe mode, just move the revenue kpi block above the orders table",
+      "expect": {
+        "skills": ["dms-builder-safe"],
+        "acceptable": ["dms", "dms-ai"],
+        "avoid": ["dms-pages"]
+      }
+    }
+  ]
+}

package/skills/dms-project/cases.json

@@ -0,0 +1,88 @@
+{
+  "version": 1,
+  "cases": [
+    {
+      "id": "restart-backend",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Restart the backend.",
+      "expect": {
+        "skills": ["dms-project"],
+        "acceptable": ["dms-dev", "dms", "dms-frontend"]
+      }
+    },
+    {
+      "id": "change-not-showing-casual",
+      "area": "dms",
+      "style": "casual",
+      "prompt": "i changed the page but nothing shows up in the dashboard??",
+      "expect": {
+        "skills": ["dms-project"],
+        "acceptable": ["dms-dev", "dms-frontend", "dms", "dms-pages"]
+      }
+    },
+    {
+      "id": "backend-logs",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Where can I read the logs of the DMS dev servers?",
+      "expect": {
+        "skills": ["dms-project"],
+        "acceptable": ["dms-dev", "dms-frontend", "dms"]
+      }
+    },
+    {
+      "id": "new-dms-project",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Create a new project that uses the DMS, starting from the template.",
+      "expect": {
+        "skills": ["dms-project"],
+        "acceptable": ["dms", "antelopejs", "ajs-cli"]
+      }
+    },
+    {
+      "id": "add-dms-module-adonis",
+      "area": "dms",
+      "style": "casual",
+      "prompt": "add dms-lang to my AdonisJS app",
+      "expect": {
+        "skills": ["dms-project"],
+        "acceptable": ["dms", "ajs-cli", "antelopejs"]
+      }
+    },
+    {
+      "id": "dms-project-antelope-config",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Show me the antelope.config.ts of a DMS app that loads the DMS, MongoDB, the API server and auth-jwt, with my own src as the local module.",
+      "expect": {
+        "skills": ["dms-project"],
+        "acceptable": ["dms", "antelopejs", "ajs-cli"],
+        "mustMention": ["defineConfig"]
+      }
+    },
+    {
+      "id": "dms-project-adonis-call-interface",
+      "area": "dms",
+      "style": "casual",
+      "prompt": "my adonis app embeds the dms, how do i call a dms interface from a controller",
+      "expect": {
+        "skills": ["dms-project"],
+        "acceptable": ["dms", "ajs-cli", "antelopejs"],
+        "mustMention": ["runtime.use"]
+      }
+    },
+    {
+      "id": "dms-project-not-frontend-server-routes",
+      "area": "dms",
+      "style": "clean",
+      "prompt": "Write a dms.server.ts for my frontend module that adds a server route and a proxy to the backend.",
+      "expect": {
+        "skills": ["dms-frontend"],
+        "acceptable": ["dms", "dms-module"],
+        "avoid": ["dms-project"]
+      }
+    }
+  ]
+}

package/skills/dms-project/scripts/dms-dev-usage.sh

@@ -0,0 +1,29 @@
+cat <<EOF
+Usage: $(basename "$0") <command>
+
+Commands:
+  restart       Stop this project's servers, start backend, wait, start frontend, wait.
+                Only when hot reload cannot apply a change, and never from an agent
+                running inside the DMS: it would stop its own host.
+  restart-back  Stop this project's backend if it runs, start it again, wait: the frontend
+                keeps running. Same rules as restart.
+  restart-front The same for the frontend alone, e.g. once it crashed while the backend ran.
+  start         Same as restart but does not stop first (errors if already running).
+  stop          Stop this project's servers: SIGTERM, then SIGKILL after the grace period
+                (on Windows: taskkill /T /F at once).
+  status        Show this project's dev processes.
+  back-log [N]  Tail the last N (default 60) lines of the backend log.
+  front-log [N] Tail the last N (default 60) lines of the frontend log.
+
+Environment:
+  DMS_BACK_DIR       REQUIRED for start/restart/stop/status. Absolute path to the DMS backend
+                     package directory of the AntelopeJS DMS project to run.
+  DMS_BACK_CMD       Command to start the backend, run in DMS_BACK_DIR (default: "pnpm dev",
+                     the playground convention for "ajs project dev -w" / legacy "run -w").
+  DMS_FRONT_CMD      Command to start the frontend, run in DMS_BACK_DIR (default:
+                     "pnpm frontend:dev", the playground convention for "ajs dms dev").
+  DMS_BACK_LOG       (default: /tmp/dms-back.log)
+  DMS_FRONT_LOG      (default: /tmp/dms-front.log)
+  DMS_DEV_TIMEOUT    (default: 180 seconds per server)
+  DMS_DEV_STOP_GRACE (default: 10 seconds between SIGTERM and SIGKILL; unused on Windows)
+EOF

package/skills/dms-project/scripts/dms-dev.sh

@@ -503,35 +503,13 @@ status() {
 }
 
 usage() {
-  cat <<EOF
-Usage: $(basename "$0") <command>
-
-Commands:
-  restart       Stop this project's servers, start backend, wait, start frontend, wait.
-                Only when hot reload cannot apply a change, and never from an agent
-                running inside the DMS: it would stop its own host.
-  restart-back  Stop this project's backend if it runs, start it again, wait: the frontend
-                keeps running. Same rules as restart.
-  restart-front The same for the frontend alone, e.g. once it crashed while the backend ran.
-  start         Same as restart but does not stop first (errors if already running).
-  stop          Stop this project's servers: SIGTERM, then SIGKILL after the grace period
-                (on Windows: taskkill /T /F at once).
-  status        Show this project's dev processes.
-  back-log [N]  Tail the last N (default 60) lines of the backend log.
-  front-log [N] Tail the last N (default 60) lines of the frontend log.
-
-Environment:
-  DMS_BACK_DIR       REQUIRED for start/restart/stop/status. Absolute path to the DMS backend
-                     package directory of the AntelopeJS DMS project to run.
-  DMS_BACK_CMD       Command to start the backend, run in DMS_BACK_DIR (default: "pnpm dev",
-                     the playground convention for "ajs project dev -w" / legacy "run -w").
-  DMS_FRONT_CMD      Command to start the frontend, run in DMS_BACK_DIR (default:
-                     "pnpm frontend:dev", the playground convention for "ajs dms dev").
-  DMS_BACK_LOG       (default: /tmp/dms-back.log)
-  DMS_FRONT_LOG      (default: /tmp/dms-front.log)
-  DMS_DEV_TIMEOUT    (default: 180 seconds per server)
-  DMS_DEV_STOP_GRACE (default: 10 seconds between SIGTERM and SIGKILL; unused on Windows)
-EOF
+  local src="${BASH_SOURCE[0]}" dir
+  while [[ -L "$src" ]]; do
+    dir="$(cd "$(dirname "$src")" && pwd)"
+    src="$(readlink "$src")"
+    [[ "$src" = /* ]] || src="$dir/$src"
+  done
+  source "$(dirname "$src")/dms-dev-usage.sh"
 }
 
 cmd="${1:-}"

package/dist/client-origin-cors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-origin-cors.js","sourceRoot":"","sources":["../src/client-origin-cors.ts"],"names":[],"mappings":";;AAiBA,8CAOC;AAxBD,6DAImC;AACnC,qCAAqC;AAErC,SAAS,WAAW,CAClB,cAAyC;IAEzC,OAAO,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC;AACrE,CAAC;AAMM,KAAK,UAAU,iBAAiB;IACrC,MAAM,MAAM,GAAG,IAAA,kBAAS,GAAE,CAAC,aAAa,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,IAAI,GAAG,MAAM,IAAA,6BAAa,GAAE,CAAC;IACnC,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACjD,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO;IACrC,MAAM,IAAA,6BAAa,EAAC,EAAE,GAAG,IAAI,EAAE,cAAc,EAAE,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AACzE,CAAC"}

package/dist/config.js.map

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

package/dist/implementations/dms/dev-reload.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dev-reload.js","sourceRoot":"","sources":["../../../src/implementations/dms/dev-reload.ts"],"names":[],"mappings":"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"}

package/dist/implementations/dms/frontend-backend-proxies.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"frontend-backend-proxies.js","sourceRoot":"","sources":["../../../src/implementations/dms/frontend-backend-proxies.ts"],"names":[],"mappings":";;AA+CA,sDAkBC;AAGD,gDAIC;AA9DD,MAAM,OAAO,GAAG,qCAAqC,CAAC;AACtD,MAAM,UAAU,GAAG,IAAI,MAAM,CAC3B,oCAAoC,OAAO,iBAAiB,CAC7D,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;AAC1E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAClE,MAAM,YAAY,GAAqB,SAAS,CAAC;AAEjD,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,iBAAiB,CAAC,IAAI,CAC3B,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAC7D,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,KAA2B;IACtD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAC3B,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC;QAC3B,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CACzD,CAAC;AACJ,CAAC;AAaD,SAAgB,qBAAqB,CACnC,MAAgC;IAEhC,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;IAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,oBAAoB,MAAM,CAAC,IAAI,qCAAqC;YAClE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAC/D,+DAA+D;YAC/D,qEAAqE;YACrE,uBAAuB,CAC1B,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,YAAY;KACjC,CAAC,CAAC,CAAC;AACN,CAAC;AAGD,SAAgB,kBAAkB,CAChC,OAAyC;IAEzC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1E,CAAC"}