@super-line/server 0.5.0 → 0.7.0

package/dist/index.cjs

@@ -16761,6 +16761,26 @@ function createSuperLineServer(contract, opts) {
       const remote = await presenceOrThrow().get(id);
       if (!remote) throw new import_core2.SuperLineError("NOT_FOUND", `Unknown connection: ${id}`);
       return { descriptor: remote, ctxAvailable: false };
+    },
+    listStores: async () => Object.entries(storeMap).map(([name, store]) => ({ name, model: store.model })),
+    listResources: async (input) => {
+      const store = storeMap[input.store];
+      if (!store) throw new import_core2.SuperLineError("NOT_FOUND", `Unknown store: ${input.store}`);
+      return store.list();
+    },
+    readResource: async (input) => {
+      const { store: name, id } = input;
+      const store = storeMap[name];
+      if (!store) throw new import_core2.SuperLineError("NOT_FOUND", `Unknown store: ${name}`);
+      const resource = await store.read(id);
+      if (!resource) throw new import_core2.SuperLineError("NOT_FOUND", `No resource: ${name}/${id}`);
+      let data = resource.data;
+      if (store.open) {
+        const replica = store.open(id);
+        data = replica.getSnapshot();
+        replica.close();
+      }
+      return { data: safeSnapshot(data), accessRules: resource.accessRules };
     }
   };
   const authHook = async (handshake) => {
@@ -17136,6 +17156,7 @@ function createSuperLineServer(contract, opts) {
     storeApi[name] = {
       async create(id, data, accessRules) {
         await store.create(id, data, accessRules);
+        if (inspectorEnabled) emitInspectorEvent({ type: "store.create", store: name, id });
       },
       read(id) {
         return Promise.resolve(store.read(id));
@@ -17159,9 +17180,33 @@ function createSuperLineServer(contract, opts) {
       },
       async delete(id) {
         await store.delete(id);
+        if (inspectorEnabled) emitInspectorEvent({ type: "store.delete", store: name, id });
       },
       list() {
         return Promise.resolve(store.list());
+      },
+      open(id, openOpts) {
+        if (!store.open)
+          throw new import_core2.SuperLineError("UNSUPPORTED", `Store ${name} does not support reactive open()`);
+        const replica = store.open(id, openOpts);
+        if (!inspectorEnabled) return replica;
+        const origin = openOpts?.origin ?? SERVER_ORIGIN;
+        const emit = (data) => emitInspectorEvent({ type: "store.write", store: name, id, origin, data: safeSnapshot(data) });
+        return {
+          ...replica,
+          set: (d) => {
+            replica.set(d);
+            emit(d);
+          },
+          update: (p) => {
+            replica.update(p);
+            emit(p);
+          },
+          delete: (path) => {
+            replica.delete(path);
+            emit({ delete: path });
+          }
+        };
       }
     };
   }

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { ServerMessageDef, RawConn, Serializer, ServerFrame, EmitData, ConnDescriptor, Adapter, PresenceStore, Contract, RoleOf, NodeStat, SharedEvents, SharedServerRequests, ClientInput, Output, SharedRequests, ServerInput, AnyData, RoleRequests, Events, DataOf, RoleTopics, AccessRules, Resource, Perms, SharedTopics, EventData, ServerTransport, Handshake, ServerStore } from '@super-line/core';
+import { ServerMessageDef, RawConn, Serializer, ServerFrame, EmitData, ConnDescriptor, Adapter, PresenceStore, Contract, RoleOf, NodeStat, SharedEvents, SharedServerRequests, ClientInput, Output, SharedRequests, ServerInput, AnyData, RoleRequests, Events, DataOf, RoleTopics, AccessRules, Resource, Perms, ServerReplica, SharedTopics, EventData, ServerTransport, Handshake, ServerStore } from '@super-line/core';
 
 /**
  * A single client connection, passed to handlers as the third argument.
@@ -238,6 +238,15 @@ interface ServerStoreHandle {
     delete(id: string): Promise<void>;
     /** All Resource ids in this store. */
     list(): Promise<string[]>;
+    /**
+     * Open a reactive in-process co-writer over a Resource's canonical state — the server half's mirror of
+     * `client.store(name).open(id)`. Reactive reads, merging `update`, and surgical `delete(path)` (the only
+     * way to remove a key server-side), all server-authoritative and fanned out to subscribers. `origin`
+     * (default `"server"`) tags its Changes for inspector attribution. Throws if the store has no `open`.
+     */
+    open(id: string, opts?: {
+        origin?: string;
+    }): ServerReplica;
 }
 /** Options for {@link createSuperLineServer}. */
 interface SuperLineServerOptions<C extends Contract, A extends AuthResult<C>> {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ServerMessageDef, RawConn, Serializer, ServerFrame, EmitData, ConnDescriptor, Adapter, PresenceStore, Contract, RoleOf, NodeStat, SharedEvents, SharedServerRequests, ClientInput, Output, SharedRequests, ServerInput, AnyData, RoleRequests, Events, DataOf, RoleTopics, AccessRules, Resource, Perms, SharedTopics, EventData, ServerTransport, Handshake, ServerStore } from '@super-line/core';
+import { ServerMessageDef, RawConn, Serializer, ServerFrame, EmitData, ConnDescriptor, Adapter, PresenceStore, Contract, RoleOf, NodeStat, SharedEvents, SharedServerRequests, ClientInput, Output, SharedRequests, ServerInput, AnyData, RoleRequests, Events, DataOf, RoleTopics, AccessRules, Resource, Perms, ServerReplica, SharedTopics, EventData, ServerTransport, Handshake, ServerStore } from '@super-line/core';
 
 /**
  * A single client connection, passed to handlers as the third argument.
@@ -238,6 +238,15 @@ interface ServerStoreHandle {
     delete(id: string): Promise<void>;
     /** All Resource ids in this store. */
     list(): Promise<string[]>;
+    /**
+     * Open a reactive in-process co-writer over a Resource's canonical state — the server half's mirror of
+     * `client.store(name).open(id)`. Reactive reads, merging `update`, and surgical `delete(path)` (the only
+     * way to remove a key server-side), all server-authoritative and fanned out to subscribers. `origin`
+     * (default `"server"`) tags its Changes for inspector attribution. Throws if the store has no `open`.
+     */
+    open(id: string, opts?: {
+        origin?: string;
+    }): ServerReplica;
 }
 /** Options for {@link createSuperLineServer}. */
 interface SuperLineServerOptions<C extends Contract, A extends AuthResult<C>> {

package/dist/index.js

@@ -492,6 +492,26 @@ function createSuperLineServer(contract, opts) {
       const remote = await presenceOrThrow().get(id);
       if (!remote) throw new SuperLineError("NOT_FOUND", `Unknown connection: ${id}`);
       return { descriptor: remote, ctxAvailable: false };
+    },
+    listStores: async () => Object.entries(storeMap).map(([name, store]) => ({ name, model: store.model })),
+    listResources: async (input) => {
+      const store = storeMap[input.store];
+      if (!store) throw new SuperLineError("NOT_FOUND", `Unknown store: ${input.store}`);
+      return store.list();
+    },
+    readResource: async (input) => {
+      const { store: name, id } = input;
+      const store = storeMap[name];
+      if (!store) throw new SuperLineError("NOT_FOUND", `Unknown store: ${name}`);
+      const resource = await store.read(id);
+      if (!resource) throw new SuperLineError("NOT_FOUND", `No resource: ${name}/${id}`);
+      let data = resource.data;
+      if (store.open) {
+        const replica = store.open(id);
+        data = replica.getSnapshot();
+        replica.close();
+      }
+      return { data: safeSnapshot(data), accessRules: resource.accessRules };
     }
   };
   const authHook = async (handshake) => {
@@ -867,6 +887,7 @@ function createSuperLineServer(contract, opts) {
     storeApi[name] = {
       async create(id, data, accessRules) {
         await store.create(id, data, accessRules);
+        if (inspectorEnabled) emitInspectorEvent({ type: "store.create", store: name, id });
       },
       read(id) {
         return Promise.resolve(store.read(id));
@@ -890,9 +911,33 @@ function createSuperLineServer(contract, opts) {
       },
       async delete(id) {
         await store.delete(id);
+        if (inspectorEnabled) emitInspectorEvent({ type: "store.delete", store: name, id });
       },
       list() {
         return Promise.resolve(store.list());
+      },
+      open(id, openOpts) {
+        if (!store.open)
+          throw new SuperLineError("UNSUPPORTED", `Store ${name} does not support reactive open()`);
+        const replica = store.open(id, openOpts);
+        if (!inspectorEnabled) return replica;
+        const origin = openOpts?.origin ?? SERVER_ORIGIN;
+        const emit = (data) => emitInspectorEvent({ type: "store.write", store: name, id, origin, data: safeSnapshot(data) });
+        return {
+          ...replica,
+          set: (d) => {
+            replica.set(d);
+            emit(d);
+          },
+          update: (p) => {
+            replica.update(p);
+            emit(p);
+          },
+          delete: (path) => {
+            replica.delete(path);
+            emit({ delete: path });
+          }
+        };
       }
     };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@super-line/server",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "type": "module",
   "description": "Typesafe WebSocket server for super-line — rooms, topics, middleware, pluggable adapters.",
   "license": "MIT",
@@ -47,7 +47,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@super-line/core": "^0.5.0"
+    "@super-line/core": "^0.7.0"
   },
   "devDependencies": {
     "@chainsafe/libp2p-noise": "^17.0.0",
@@ -68,13 +68,13 @@
     "zeromq": "^6.0.0",
     "zod": "^3.24.1",
     "zod-to-json-schema": "^3.25.2",
-    "@super-line/adapter-libp2p": "0.5.0",
-    "@super-line/adapter-zeromq": "0.5.0",
+    "@super-line/client": "0.6.0",
     "@super-line/adapter-rabbitmq": "0.5.0",
+    "@super-line/adapter-redis": "0.5.0",
+    "@super-line/adapter-libp2p": "0.5.0",
     "@super-line/transport-http": "0.5.0",
+    "@super-line/adapter-zeromq": "0.5.0",
     "@super-line/transport-loopback": "0.5.0",
-    "@super-line/adapter-redis": "0.5.0",
-    "@super-line/client": "0.5.0",
     "@super-line/transport-websocket": "0.5.0"
   },
   "optionalDependencies": {