@antelopejs/dms 0.5.0 → 0.5.2

package/dist/test/unit/skills/dms-dev-script.test.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_util_1 = require("node:util");
+const chai_1 = require("chai");
+const PACKAGE_ROOT = (0, node_path_1.resolve)(__dirname, "..", "..", "..", "..");
+const SCRIPT = (0, node_path_1.join)(PACKAGE_ROOT, "skills", "dms-dev", "scripts", "dms-dev.sh");
+const SCRIPT_TIMEOUT_MS = 30_000;
+const SUITE_TIMEOUT_MS = 90_000;
+const STOP_GRACE_SECONDS = "1";
+const READY_TIMEOUT_SECONDS = "15";
+const PROJECT_PORTS = { first: 6110, second: 6120 };
+const FAKE_BACKEND = `#!/usr/bin/env bash
+mkdir -p .antelope
+printf '{"pid": %s, "servers": {"api": {"endpoints": [{"protocol": "http", "host": "0.0.0.0", "port": %s}]}}}' "$$" "$FAKE_PORT" > .antelope/dev.json
+sleep 300 &
+echo "Server started, listening on http://localhost:$FAKE_PORT"
+wait
+`;
+const FAKE_FRONTEND = `#!/usr/bin/env bash
+trap '' TERM
+sleep 300 &
+echo "Server ready on http://localhost:$((FAKE_PORT + 1))"
+wait
+`;
+const runProcess = (0, node_util_1.promisify)(node_child_process_1.execFile);
+function createProject(root, name, port) {
+    const dir = (0, node_path_1.join)(root, name);
+    (0, node_fs_1.mkdirSync)((0, node_path_1.join)(dir, "bin"), { recursive: true });
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(dir, "package.json"), "{}");
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(dir, "bin", "antelope-runner"), FAKE_BACKEND);
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(dir, "bin", "ajs-dms"), FAKE_FRONTEND);
+    (0, node_fs_1.chmodSync)((0, node_path_1.join)(dir, "bin", "antelope-runner"), 0o755);
+    (0, node_fs_1.chmodSync)((0, node_path_1.join)(dir, "bin", "ajs-dms"), 0o755);
+    return { dir, port };
+}
+async function runScript(project, command) {
+    const env = {
+        ...process.env,
+        FAKE_PORT: String(project.port),
+        DMS_BACK_DIR: project.dir,
+        DMS_BACK_CMD: (0, node_path_1.join)(project.dir, "bin", "antelope-runner"),
+        DMS_FRONT_CMD: `${(0, node_path_1.join)(project.dir, "bin", "ajs-dms")} dev`,
+        DMS_BACK_LOG: (0, node_path_1.join)(project.dir, "back.log"),
+        DMS_FRONT_LOG: (0, node_path_1.join)(project.dir, "front.log"),
+        DMS_DEV_STOP_GRACE: STOP_GRACE_SECONDS,
+        DMS_DEV_TIMEOUT: READY_TIMEOUT_SECONDS,
+    };
+    try {
+        const { stdout, stderr } = await runProcess("bash", [SCRIPT, command], {
+            env,
+            timeout: SCRIPT_TIMEOUT_MS,
+        });
+        return { code: 0, output: stdout + stderr };
+    }
+    catch (error) {
+        const failure = error;
+        return {
+            code: failure.code ?? 1,
+            output: `${failure.stdout ?? ""}${failure.stderr ?? ""}`,
+        };
+    }
+}
+function pidFile(project) {
+    return (0, node_path_1.join)(project.dir, ".antelope", "dms-dev.pid");
+}
+function recordedPids(project) {
+    return (0, node_fs_1.readFileSync)(pidFile(project), "utf8")
+        .trim()
+        .split("\n")
+        .map((line) => Number(line.split(" ")[1]));
+}
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+describe("[unit] skills/dms-dev script", function () {
+    this.timeout(SUITE_TIMEOUT_MS);
+    let root;
+    let first;
+    let second;
+    beforeEach(() => {
+        root = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), "dms-dev-script-"));
+        first = createProject(root, "first", PROJECT_PORTS.first);
+        second = createProject(root, "second", PROJECT_PORTS.second);
+    });
+    afterEach(async () => {
+        await runScript(first, "stop");
+        await runScript(second, "stop");
+        (0, node_fs_1.rmSync)(root, { recursive: true, force: true });
+    });
+    it("reports the ports the servers announce", async () => {
+        const started = await runScript(first, "start");
+        (0, chai_1.expect)(started.code, started.output).to.equal(0);
+        (0, chai_1.expect)(started.output).to.contain(`backend ready on http://localhost:${PROJECT_PORTS.first}.`);
+        (0, chai_1.expect)(started.output).to.contain(`frontend ready on http://localhost:${PROJECT_PORTS.first + 1}.`);
+    });
+    it("stops only the processes of its own project", async () => {
+        await runScript(first, "start");
+        await runScript(second, "start");
+        const firstPids = recordedPids(first);
+        const secondPids = recordedPids(second);
+        const stopped = await runScript(first, "stop");
+        (0, chai_1.expect)(stopped.code, stopped.output).to.equal(0);
+        (0, chai_1.expect)(firstPids.filter(isAlive)).to.deep.equal([]);
+        (0, chai_1.expect)(secondPids.filter(isAlive)).to.deep.equal(secondPids);
+        (0, chai_1.expect)((0, node_fs_1.existsSync)(pidFile(first))).to.equal(false);
+    });
+    it("falls back to the project's directory when the pid file is gone", async () => {
+        await runScript(first, "start");
+        await runScript(second, "start");
+        const firstPids = recordedPids(first);
+        const secondPids = recordedPids(second);
+        (0, node_fs_1.rmSync)(pidFile(first));
+        const stopped = await runScript(first, "stop");
+        (0, chai_1.expect)(stopped.code, stopped.output).to.equal(0);
+        (0, chai_1.expect)(firstPids.filter(isAlive)).to.deep.equal([]);
+        (0, chai_1.expect)(secondPids.filter(isAlive)).to.deep.equal(secondPids);
+    });
+    it("fails fast when the server command dies right away", async () => {
+        (0, node_fs_1.rmSync)((0, node_path_1.join)(first.dir, "bin", "antelope-runner"));
+        const startedAt = Date.now();
+        const started = await runScript(first, "start");
+        (0, chai_1.expect)(started.code).to.equal(1);
+        (0, chai_1.expect)(started.output).to.contain("exited before becoming ready");
+        (0, chai_1.expect)(Date.now() - startedAt).to.be.below(SCRIPT_TIMEOUT_MS / 2);
+    });
+});
+//# sourceMappingURL=dms-dev-script.test.js.map

package/dist/test/unit/skills/dms-dev-script.test.js.map

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

package/dist/validation/auth.schema.d.ts

@@ -42,14 +42,14 @@ export declare const authSchema: {
         code: string;
         state: string;
         state_cookie: string;
-        language?: string | undefined;
         invite?: string | undefined;
+        language?: string | undefined;
     }, {
         code: string;
         state: string;
         state_cookie: string;
-        language?: string | undefined;
         invite?: string | undefined;
+        language?: string | undefined;
     }>;
     refresh: z.ZodObject<{
         token: z.ZodString;

package/frontend-vue/dms.frontend.ts

@@ -2,6 +2,7 @@ import { defineAsyncComponent, type Component } from "vue";
 import {
   type DmsFrontendModule,
   useDmsAppConfig,
+  useDmsRuntimeConfig,
 } from "#dms/frontend-module";
 import { defu } from "defu";
 import appConfig from "./layers/dms-layout/app/app.config";
@@ -171,9 +172,9 @@ function registerMiddleware(
 
 const frontendModule: DmsFrontendModule = {
   setup(sdk) {
-    const publicOptions = sdk.options.public as DmsPublicOptions;
-    if (publicOptions.dms && typeof window !== "undefined")
-      publicOptions.dms.baseURL = window.location.origin;
+    const runtimeDms = (useDmsRuntimeConfig().public as DmsPublicOptions).dms;
+    if (runtimeDms && typeof window !== "undefined")
+      runtimeDms.baseURL = window.location.origin;
     const runtimeAppConfig = useDmsAppConfig();
     Object.assign(runtimeAppConfig, defu(runtimeAppConfig, appConfig));
     registerPlugins(sdk);

package/frontend-vue/layers/dms-core/app/composables/realtime/useUserRealtime.ts

@@ -1,4 +1,8 @@
-import { isUnauthorizedStreamError, openSseStream } from "./useSseStream";
+import {
+  isUnauthorizedStreamError,
+  openSseStream,
+  type SseStreamHandle,
+} from "./useSseStream";
 
 const REALTIME_USER_PATH = "/api/realtime/user";
 const REALTIME_SUBSCRIBE_PATH_PREFIX = "/api/realtime/subscribe/";
@@ -117,57 +121,109 @@ const handleEvent =
     }
   };
 
+interface ConnectionCallbacks {
+  onConnected: () => void;
+  onDisconnected: () => void;
+  refreshSession: () => Promise<boolean>;
+  redirectToAuth: () => Promise<void>;
+}
+
+interface Reconnector {
+  isCancelled(): boolean;
+  schedule(open: () => void): void;
+  resetDelay(): void;
+  cancel(): void;
+}
+
+const createReconnector = (): Reconnector => {
+  let isCancelled = false;
+  let delay = RECONNECT_INITIAL_DELAY_MS;
+  let timer: ReturnType<typeof setTimeout> | undefined;
+  return {
+    isCancelled: () => isCancelled,
+    schedule: (open) => {
+      // A pending reconnect absorbs concurrent triggers: one stream per tab.
+      if (isCancelled || timer) return;
+      timer = setTimeout(() => {
+        timer = undefined;
+        open();
+      }, delay);
+      delay = Math.min(delay * RECONNECT_MULTIPLIER, RECONNECT_MAX_DELAY_MS);
+    },
+    resetDelay: () => {
+      delay = RECONNECT_INITIAL_DELAY_MS;
+    },
+    cancel: () => {
+      isCancelled = true;
+      if (timer) clearTimeout(timer);
+      timer = undefined;
+    },
+  };
+};
+
+const recoverFromError = (
+  error: unknown,
+  reconnect: () => void,
+  callbacks: ConnectionCallbacks,
+): void => {
+  if (!isUnauthorizedStreamError(error)) {
+    reconnect();
+    return;
+  }
+  void callbacks.refreshSession().then((isRefreshed) => {
+    if (isRefreshed) {
+      reconnect();
+    } else {
+      void callbacks.redirectToAuth();
+    }
+  }, reconnect);
+};
+
+/**
+ * Keeps one user stream open until cancelled. The server ends the stream when
+ * it stops (a dev reload included), so a clean EOF reconnects just like an
+ * error does: the user stream has no business completion.
+ */
 const connectWithBackoff = (
   url: string,
   state: UserRealtimeState,
-  onConnected: () => void,
-  refreshSession: () => Promise<boolean>,
-  redirectToAuth: () => Promise<void>,
+  callbacks: ConnectionCallbacks,
 ): (() => void) => {
-  let cancelled = false;
-  let delay = RECONNECT_INITIAL_DELAY_MS;
-  let timer: ReturnType<typeof setTimeout> | undefined;
-  let activeHandle: { close(): void } | undefined;
+  const reconnector = createReconnector();
   const dispatch = handleEvent(state);
+  let activeHandle: SseStreamHandle | undefined;
   const open = () => {
-    if (cancelled) return;
-    activeHandle = openSseStream({
+    if (reconnector.isCancelled()) return;
+    activeHandle?.close();
+    const handle: SseStreamHandle = openSseStream({
       url,
       onEvent: (eventName, data) => {
-        if (cancelled) return;
-        delay = RECONNECT_INITIAL_DELAY_MS;
+        if (handle !== activeHandle) return;
+        reconnector.resetDelay();
         dispatch(eventName, data);
-        if (eventName === HELLO_EVENT) onConnected();
+        if (eventName === HELLO_EVENT) callbacks.onConnected();
       },
       onError: (error) => {
-        if (cancelled) return;
-        state.appliedPageId.value = null;
-        const scheduleReconnect = () => {
-          if (cancelled) return;
-          timer = setTimeout(open, delay);
-          delay = Math.min(
-            delay * RECONNECT_MULTIPLIER,
-            RECONNECT_MAX_DELAY_MS,
-          );
-        };
-        if (isUnauthorizedStreamError(error)) {
-          void refreshSession().then((refreshed) => {
-            if (refreshed) {
-              scheduleReconnect();
-            } else {
-              void redirectToAuth();
-            }
-          }, scheduleReconnect);
-          return;
-        }
-        scheduleReconnect();
+        if (!retire(handle)) return;
+        recoverFromError(error, reconnect, callbacks);
+      },
+      onClose: (reason) => {
+        if (reason !== "eof" || !retire(handle)) return;
+        reconnect();
       },
     });
+    activeHandle = handle;
+  };
+  const reconnect = () => reconnector.schedule(open);
+  const retire = (handle: SseStreamHandle): boolean => {
+    if (handle !== activeHandle || reconnector.isCancelled()) return false;
+    activeHandle = undefined;
+    callbacks.onDisconnected();
+    return true;
   };
   open();
   return () => {
-    cancelled = true;
-    if (timer) clearTimeout(timer);
+    reconnector.cancel();
     activeHandle?.close();
     activeHandle = undefined;
   };
@@ -196,14 +252,29 @@ const reconcilePage = async (
   baseUrl: string,
 ): Promise<void> => {
   const desired = state.pageId.value ?? null;
+  const sessionId = state.sessionId.value;
   if (state.appliedPageId.value === desired) return;
-  if (!state.sessionId.value) return;
+  if (!sessionId) return;
   await callPageEndpoint(state, desired, baseUrl);
+  // A reconnect during the call replaced the session: the page is applied to
+  // the dead one, and the new one still needs it.
+  if (state.sessionId.value !== sessionId) return;
   if ((state.pageId.value ?? null) === desired) {
     state.appliedPageId.value = desired;
   }
 };
 
+/**
+ * Forgets what the server held for the closed session. The next greeting
+ * brings a new session id, which re-applies the page topics here and lets the
+ * components holding presence re-acquire it.
+ */
+const resetSession = (state: UserRealtimeState): void => {
+  state.sessionId.value = undefined;
+  state.appliedPageId.value = null;
+  state.snapshots.clear();
+};
+
 const buildApi = (): UserRealtimeApi => {
   const sessionId = useDmsState<string | undefined>(
     SESSION_STATE_KEY,
@@ -232,19 +303,20 @@ const buildApi = (): UserRealtimeApi => {
       (isLoggedIn) => {
         state.cancelConnect?.();
         state.cancelConnect = undefined;
-        state.sessionId.value = undefined;
+        resetSession(state);
         state.menuTopics.value = [];
-        state.appliedPageId.value = null;
-        state.snapshots.clear();
         if (!isLoggedIn) return;
         state.cancelConnect = connectWithBackoff(
           `${baseUrl}${REALTIME_USER_PATH}`,
           state,
-          () => {
-            void reconcilePage(state, baseUrl);
+          {
+            onConnected: () => {
+              void reconcilePage(state, baseUrl);
+            },
+            onDisconnected: () => resetSession(state),
+            refreshSession,
+            redirectToAuth,
           },
-          refreshSession,
-          redirectToAuth,
         );
       },
       { immediate: true },

package/frontend-vue/layers/dms-layout/app/pages/[...slug].vue

@@ -1,6 +1,8 @@
 <script setup lang="ts">
 import { withoutTrailingSlash } from "ufo";
 
+defineOptions({ inheritAttrs: false });
+
 // Dev-only: created behind the flag so the key never reaches a production
 // SSR payload.
 const devReloading = import.meta.env.DEV ? useDevReloading() : ref(false);

package/frontend-vue/layers/dms-ui/app/build/components/table/Actions.vue

@@ -244,15 +244,25 @@ const uiTableActions = computed(() => uiTableActionsVariant());
       @click="tableSharedData!.emits('add')"
     />
 
-    <UButton
+    <!-- A disabled button fires no pointer event: the tooltip hangs on a
+      wrapper, focusable so the reason also reaches keyboard users. -->
+    <UTooltip
       v-for="(button, index) in customButtons"
       :key="`custom-btn-${index}`"
-      :label="processI18n(button.label)"
-      :icon="button.icon"
-      :variant="button.variant"
-      :color="button.color"
-      size="sm"
-      @click="props.onCustomButton?.(button)"
-    />
+      :text="button.disabledReason && processI18n(button.disabledReason)"
+      :disabled="!button.disabled || !button.disabledReason"
+    >
+      <span :tabindex="button.disabled ? 0 : undefined" class="inline-flex">
+        <UButton
+          :label="processI18n(button.label)"
+          :icon="button.icon"
+          :variant="button.variant"
+          :color="button.color"
+          :disabled="button.disabled"
+          size="sm"
+          @click="props.onCustomButton?.(button)"
+        />
+      </span>
+    </UTooltip>
   </div>
 </template>

package/frontend-vue/layers/dms-ui/app/build/composables/table-view/useTableViewRowActions.ts

@@ -795,7 +795,19 @@ export const useTableRowActions = <T extends Data>(
     }
   };
 
+  // Reached for a disabled button only through a quick action, which presses
+  // it by id: the reason is told instead of the target being opened.
   const handleCustomButton = (button: CustomButton) => {
+    if (button.disabled) {
+      toast.add({
+        color: Color.warning,
+        title: processI18n(button.label),
+        description: button.disabledReason
+          ? processI18n(button.disabledReason)
+          : undefined,
+      });
+      return;
+    }
     handleActionTarget(button.target, button.label);
   };
 

package/frontend-vue/layers/dms-ui/app/composables/table-view/types/custom-button.ts

@@ -10,4 +10,8 @@ export interface CustomButton {
   variant?: CustomButtonVariant;
   color?: ColorValue;
   target: ActionTarget;
+  /** Set by the server when the button cannot be pressed for this request. */
+  disabled?: boolean;
+  /** Why the button is disabled, shown in its tooltip. May be an i18n key. */
+  disabledReason?: string;
 }

package/frontend-vue/layers/dms-ui/app/plugins/shortcuts.ts

@@ -1,4 +1,4 @@
-import aggregatedShortcuts from "../config/shortcuts-registry";
+import aggregatedShortcuts from "#shortcuts-aggregated";
 export default defineDmsPlugin(() => {
   const { registerShortcut } = useShortcutRegistry();
 

package/frontend-vue/layers/dms-ui/app/types/shortcuts-aggregated.d.ts

@@ -0,0 +1,8 @@
+// Generated by the renderer in the workspace: every module's
+// `app/config/shortcuts-registry.ts`, spread in priority order.
+declare module "#shortcuts-aggregated" {
+  import type { ComponentShortcuts } from "#dms-ui/app/types/shortcuts";
+
+  const aggregatedShortcuts: ComponentShortcuts[];
+  export default aggregatedShortcuts;
+}