@abraca/nuxt 2.3.0 → 2.5.0

package/dist/runtime/composables/useInvites.d.ts

@@ -14,6 +14,9 @@ export interface Invite {
     max_uses: number | null;
     expires_at: number | null;
     created_at: number;
+    created_by: string | null;
+    /** True once the code has been revoked — it can no longer be redeemed. */
+    revoked: boolean;
 }
 declare function refresh(): Promise<void>;
 declare function create(opts?: {
@@ -32,6 +35,8 @@ export declare function useInvites(): {
         max_uses: number | null;
         expires_at: number | null;
         created_at: number;
+        created_by: string | null;
+        revoked: boolean;
     }[], Invite[] | {
         code: string;
         role: string;
@@ -39,6 +44,8 @@ export declare function useInvites(): {
         max_uses: number | null;
         expires_at: number | null;
         created_at: number;
+        created_by: string | null;
+        revoked: boolean;
     }[]>;
     /** Whether invite list is loading. */
     loading: import("vue").Ref<boolean, boolean>;

package/dist/runtime/plugin-abracadabra.client.js

@@ -768,13 +768,25 @@ export default defineNuxtPlugin({
         }
       }
     }
+    function _normalizeInvite(r) {
+      return {
+        code: r.code,
+        role: r.role,
+        max_uses: r.maxUses ?? 0,
+        uses: r.useCount ?? 0,
+        created_at: r.createdAt ?? 0,
+        expires_at: r.expiresAt ?? null,
+        created_by: r.createdBy ?? null,
+        revoked: !!r.revoked
+      };
+    }
     async function createInvite(opts) {
       if (!client.value) throw new Error("Not connected");
-      return client.value.createInvite(opts);
+      return _normalizeInvite(await client.value.createInvite(opts));
     }
     async function listInvites() {
       if (!client.value) throw new Error("Not connected");
-      return client.value.listInvites();
+      return (await client.value.listInvites()).map(_normalizeInvite);
     }
     async function revokeInvite(code) {
       if (!client.value) throw new Error("Not connected");
@@ -1062,6 +1074,12 @@ export default defineNuxtPlugin({
           document: _doc,
           websocketProvider: wsp,
           client: _client,
+          // The provider lives for the whole app lifetime on one socket
+          // that rarely drops, so it never re-issues sync-step-1 on its
+          // own — doc-tree entries written by an MCP / sibling client
+          // stay invisible until a full page reload. Periodically re-diff
+          // against the server to surface them.
+          forceSyncInterval: 3e4,
           // Route every WS auth handshake (initial + reconnects) through
           // the TokenManager so an expired JWT is silently refreshed via
           // the device session before being sent. Without this, a tab
@@ -1352,6 +1370,13 @@ export default defineNuxtPlugin({
           _wsp.connect();
         } catch {
         }
+        return;
+      }
+      if (status.value === "connected") {
+        try {
+          provider.value?.forceSync();
+        } catch {
+        }
       }
     }
     window.addEventListener("focus", _kickConnection);
@@ -1360,10 +1385,26 @@ export default defineNuxtPlugin({
       if (document.visibilityState === "visible") _kickConnection();
     });
     loadServers();
+    let deepLinkServer = "";
+    try {
+      const qp = new URLSearchParams(window.location.search);
+      const hp = new URLSearchParams(window.location.hash.replace(/^#/, ""));
+      const raw = (qp.get("server") || hp.get("server") || "").trim();
+      if (raw) {
+        let u = raw;
+        if (!u.startsWith("http://") && !u.startsWith("https://")) u = "https://" + u;
+        deepLinkServer = u.replace(/\/$/, "");
+      }
+    } catch {
+    }
     const storedServer = localStorage.getItem(CURRENT_SERVER_KEY);
-    const initialUrl = storedServer && savedServers.value.some((s) => s.url === storedServer) ? storedServer : currentServerUrl.value || savedServers.value[0]?.url || defaultUrl;
+    const initialUrl = deepLinkServer || (storedServer && savedServers.value.some((s) => s.url === storedServer) ? storedServer : currentServerUrl.value || savedServers.value[0]?.url || defaultUrl);
     if (initialUrl !== currentServerUrl.value) currentServerUrl.value = initialUrl;
     _initPromise = init(initialUrl);
+    if (deepLinkServer && !savedServers.value.some((s) => s.url === deepLinkServer)) {
+      void addServer(deepLinkServer).catch(() => {
+      });
+    }
     _initPromise.then(async () => {
       if (!provider.value) return;
       const ctx = { abracadabra: abra };

package/dist/runtime/server/api/_abracadabra/spaces.get.d.ts

@@ -1,2 +1,2 @@
-declare const _default: import("h3").EventHandler<Omit<import("h3").EventHandlerRequest, "body">, Promise<unknown[] | never[]>>;
+declare const _default: import("h3").EventHandler<Omit<import("h3").EventHandlerRequest, "body">, Promise<never[] | unknown[]>>;
 export default _default;

package/dist/runtime/types.d.ts

@@ -341,6 +341,8 @@ export interface InviteInfo {
     created_at: number;
     expires_at: number | null;
     created_by: string | null;
+    /** True once the code has been revoked — it can no longer be redeemed. */
+    revoked: boolean;
 }
 export interface SavedServer {
     url: string;

package/dist/runtime/utils/loadThree.d.ts

@@ -0,0 +1,18 @@
+/**
+ * loadThree — try-import the `three` peer dependency (+ GLTF/DRACO loaders).
+ *
+ * Returns the pieces <AFileGlbViewer> needs if the consumer installed
+ * `three`, or `null` otherwise. Cached after the first call; the first
+ * failed lookup logs once in dev. Mirrors loadKatex / loadCodeMirror so
+ * `three` stays a truly optional peer and never enters the build graph —
+ * a consumer that doesn't render 3D model blocks never needs `three`.
+ *
+ * Apps that want GLB previews install: `pnpm add three`.
+ */
+export interface ThreeBundle {
+    Raycaster: any;
+    Vector2: any;
+    GLTFLoader: any;
+    DRACOLoader: any;
+}
+export declare function loadThree(): Promise<ThreeBundle | null>;

package/dist/runtime/utils/loadThree.js

@@ -0,0 +1,46 @@
+let cache = null;
+let loading = null;
+let warnedMissing = false;
+export async function loadThree() {
+  if (cache) return cache;
+  if (loading) return loading;
+  loading = (async () => {
+    try {
+      const threePkg = "three";
+      const gltfPkg = "three/examples/jsm/loaders/GLTFLoader.js";
+      const dracoPkg = "three/examples/jsm/loaders/DRACOLoader.js";
+      const [three, gltf, draco] = await Promise.all([
+        import(
+          /* @vite-ignore */
+          threePkg
+        ),
+        import(
+          /* @vite-ignore */
+          gltfPkg
+        ),
+        import(
+          /* @vite-ignore */
+          dracoPkg
+        )
+      ]);
+      cache = {
+        Raycaster: three.Raycaster,
+        Vector2: three.Vector2,
+        GLTFLoader: gltf.GLTFLoader,
+        DRACOLoader: draco.DRACOLoader
+      };
+      return cache;
+    } catch {
+      if (import.meta.dev && !warnedMissing) {
+        warnedMissing = true;
+        console.warn(
+          "[abracadabra] GLB viewer: `three` peer dependency not installed. 3D model blocks render a fallback. Install with `pnpm add three`."
+        );
+      }
+      return null;
+    } finally {
+      loading = null;
+    }
+  })();
+  return loading;
+}

package/dist/types.d.mts

@@ -1,4 +1,4 @@
-export { type AbracadabraPlugin, type AbracadabraState, type CachedTreeNode, type DocCacheAPI, type DocPageMeta, type RunnerCleanup, type ServerRunnerContext, type ServerRunnerDefinition, type TreeEntry, type UserMetaField } from '../dist/runtime/types.js'
+export { type AbracadabraPlugin, type AbracadabraState, type CachedTreeNode, type DocCacheAPI, type DocPageMeta, type InviteInfo, type RunnerCleanup, type ServerRunnerContext, type ServerRunnerDefinition, type SpaceMeta, type TreeEntry, type UserMetaField } from '../dist/runtime/types.js'
 
 export { type AbracadabraLocale } from '../dist/runtime/locale.js'
 
@@ -12,10 +12,14 @@ export { type ParsedMessage, type TextSegment, type parseMessageContent, type pr
 
 export { type DupEntry, type duplicateDocContent, type duplicateDocTree } from '../dist/runtime/utils/duplicateDocContent.js'
 
-export { type AuditLogEntry, type AuditQueryOpts, type AuditVerifyResult, type DocSearchHit, type ReadyzStatus } from '@abraca/dabra'
+export { type AdminConfigField, type AuditLogEntry, type AuditQueryOpts, type AuditVerifyResult, type DocSearchHit, type EnvSnapshotResponse, type ReadyzStatus } from '@abraca/dabra'
 
 export { type ServerTrashEntry } from '../dist/runtime/composables/useServerTrash.js'
 
+export { type Invite } from '../dist/runtime/composables/useInvites.js'
+
+export { type AdminStorageStats, type AdminUploadList, type AdminUploadRow, type AdminUserDocRow, type AdminUserRow } from '../dist/runtime/composables/useAbraAdmin.js'
+
 export { type SlugMap, type SlugMapEntry, type buildSlugMap, type isUUID, type slugify } from '../dist/runtime/utils/slugify.js'
 
 export { type avatarBorderStyle, type avatarGradient, type avatarStyleFromName } from '../dist/runtime/utils/avatarStyle.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abraca/nuxt",
-  "version": "2.3.0",
+  "version": "2.5.0",
   "description": "First-class Nuxt module for the Abracadabra CRDT collaboration platform",
   "repository": "abracadabra/abracadabra-nuxt",
   "license": "MIT",
@@ -26,12 +26,16 @@
     "access": "public"
   },
   "dependencies": {
-    "@nuxt/kit": "^4.4.4",
+    "@nuxt/kit": "^4.4.6",
     "@vueuse/core": "^14.3.0",
     "defu": "^6.1.7",
     "nanoevents": "^9.1.0"
   },
   "peerDependencies": {
+    "@abraca/convert": "^2.5.0",
+    "@abraca/dabra": "^2.5.0",
+    "@abraca/plugin": "^2.5.0",
+    "@abraca/schema": "^2.5.0",
     "@codemirror/autocomplete": "^6.18.0",
     "@codemirror/commands": "^6.7.0",
     "@codemirror/lang-css": "^6.3.1",
@@ -42,7 +46,6 @@
     "@codemirror/search": "^6.5.0",
     "@codemirror/state": "^6.6.0",
     "@codemirror/view": "^6.42.0",
-    "y-codemirror.next": "^0.3.5",
     "@noble/ed25519": "^3.1.0",
     "@noble/hashes": "^2.2.0",
     "@nuxt/ui": "^3.0.0",
@@ -72,17 +75,18 @@
     "lowlight": "^3.0.0",
     "mapbox-gl": "^3.0.0",
     "nuxt": "^4.0.0",
+    "three": "^0.184.0",
     "vue": "^3.4.0",
-    "yjs": "^13.0.0",
-    "@abraca/dabra": "2.3.0",
-    "@abraca/plugin": "2.3.0",
-    "@abraca/convert": "2.3.0",
-    "@abraca/schema": "2.3.0"
+    "y-codemirror.next": "^0.3.5",
+    "yjs": "^13.0.0"
   },
   "peerDependenciesMeta": {
     "@abraca/schema": {
       "optional": true
     },
+    "three": {
+      "optional": true
+    },
     "@codemirror/autocomplete": {
       "optional": true
     },
@@ -133,6 +137,9 @@
     }
   },
   "devDependencies": {
+    "@abraca/convert": "^2.5.0",
+    "@abraca/dabra": "^2.5.0",
+    "@abraca/plugin": "^2.5.0",
     "@codemirror/autocomplete": "^6.18.0",
     "@codemirror/commands": "^6.7.0",
     "@codemirror/lang-css": "^6.3.1",
@@ -143,39 +150,36 @@
     "@codemirror/search": "^6.5.0",
     "@codemirror/state": "^6.6.0",
     "@codemirror/view": "^6.42.0",
-    "y-codemirror.next": "^0.3.5",
-    "@iconify-json/lucide": "^1.2.105",
+    "@iconify-json/lucide": "^1.2.108",
     "@noble/ed25519": "^3.1.0",
     "@noble/hashes": "^2.2.0",
     "@nuxt/eslint-config": "^1.15.2",
     "@nuxt/module-builder": "^1.0.2",
-    "@nuxt/schema": "^4.4.4",
+    "@nuxt/schema": "^4.4.6",
     "@nuxt/test-utils": "^4.0.3",
     "@nuxt/ui": "^4.7.1",
     "@playwright/test": "^1.59.1",
-    "@tiptap/core": "^3.22.5",
-    "@tiptap/extension-collaboration": "^3.22.5",
-    "@tiptap/extension-collaboration-caret": "^3.22.5",
-    "@tiptap/vue-3": "^3.22.5",
+    "@tiptap/core": "^3.23.5",
+    "@tiptap/extension-collaboration": "^3.23.5",
+    "@tiptap/extension-collaboration-caret": "^3.23.5",
+    "@tiptap/vue-3": "^3.23.5",
     "@types/d3-force": "^3.0.10",
     "@types/node": "latest",
     "@types/ws": "^8.18.1",
     "@vue/test-utils": "^2.4.10",
     "changelogen": "^0.6.2",
     "d3-force": "^3.0.0",
-    "eslint": "^10.3.0",
+    "eslint": "^10.4.0",
     "happy-dom": "^20.9.0",
-    "nuxt": "^4.4.4",
+    "nuxt": "^4.4.6",
     "tslib": "^2.8.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.5",
     "vue": "^3.5.34",
-    "vue-tsc": "^3.2.8",
+    "vue-tsc": "^3.3.1",
     "ws": "^8.20.0",
-    "yjs": "^13.6.30",
-    "@abraca/dabra": "2.3.0",
-    "@abraca/plugin": "2.3.0",
-    "@abraca/convert": "2.3.0"
+    "y-codemirror.next": "^0.3.5",
+    "yjs": "^13.6.30"
   },
   "scripts": {
     "dev": "npm run dev:prepare && nuxt dev playground",