@rool-dev/svelte 0.2.0 → 0.3.0-dev.381ac43

package/dist/channel.svelte.js

@@ -0,0 +1,354 @@
+/**
+ * A reactive watch of objects that auto-updates when matching objects change.
+ */
+class ReactiveWatchImpl {
+    #channel;
+    #options;
+    #unsubscribers = [];
+    #currentIds = new Set();
+    // Reactive state
+    objects = $state([]);
+    loading = $state(true);
+    constructor(channel, options) {
+        this.#channel = channel;
+        this.#options = options;
+        this.#setup();
+    }
+    #setup() {
+        // Initial fetch
+        this.refresh();
+        // Subscribe to object events
+        const onObjectCreated = ({ object }) => {
+            if (this.#matches(object)) {
+                this.refresh();
+            }
+        };
+        this.#channel.on('objectCreated', onObjectCreated);
+        this.#unsubscribers.push(() => this.#channel.off('objectCreated', onObjectCreated));
+        const onObjectUpdated = ({ objectId, object }) => {
+            const wasInCollection = this.#currentIds.has(objectId);
+            const nowMatches = this.#matches(object);
+            if (wasInCollection && nowMatches) {
+                // Update in place
+                const index = this.objects.findIndex((o) => o.id === objectId);
+                if (index !== -1) {
+                    this.objects[index] = object;
+                }
+            }
+            else if (wasInCollection && !nowMatches) {
+                // Remove from collection
+                this.objects = this.objects.filter((o) => o.id !== objectId);
+                this.#currentIds.delete(objectId);
+            }
+            else if (!wasInCollection && nowMatches) {
+                // Add to collection (re-fetch to respect limit/order)
+                this.refresh();
+            }
+        };
+        this.#channel.on('objectUpdated', onObjectUpdated);
+        this.#unsubscribers.push(() => this.#channel.off('objectUpdated', onObjectUpdated));
+        const onObjectDeleted = ({ objectId }) => {
+            if (this.#currentIds.has(objectId)) {
+                this.objects = this.objects.filter((o) => o.id !== objectId);
+                this.#currentIds.delete(objectId);
+            }
+        };
+        this.#channel.on('objectDeleted', onObjectDeleted);
+        this.#unsubscribers.push(() => this.#channel.off('objectDeleted', onObjectDeleted));
+        // Handle full resets
+        const onReset = () => this.refresh();
+        this.#channel.on('reset', onReset);
+        this.#unsubscribers.push(() => this.#channel.off('reset', onReset));
+    }
+    /**
+     * Check if an object matches the `where` filter.
+     */
+    #matches(object) {
+        const where = this.#options.where;
+        if (!where)
+            return true;
+        for (const [key, value] of Object.entries(where)) {
+            if (object[key] !== value)
+                return false;
+        }
+        return true;
+    }
+    /**
+     * Re-fetch the watched objects from the channel.
+     */
+    async refresh() {
+        this.loading = true;
+        try {
+            const findOptions = {
+                where: this.#options.where,
+                limit: this.#options.limit,
+                order: this.#options.order,
+                ephemeral: true, // Don't pollute interaction history
+            };
+            const { objects } = await this.#channel.findObjects(findOptions);
+            this.objects = objects;
+            this.#currentIds = new Set(objects.map((o) => o.id));
+        }
+        finally {
+            this.loading = false;
+        }
+    }
+    /**
+     * Stop listening for updates and clean up.
+     */
+    close() {
+        for (const unsub of this.#unsubscribers)
+            unsub();
+        this.#unsubscribers.length = 0;
+    }
+}
+/**
+ * A reactive single object that auto-updates when the object changes.
+ */
+class ReactiveObjectImpl {
+    #channel;
+    #objectId;
+    #unsubscribers = [];
+    // Reactive state
+    data = $state(undefined);
+    loading = $state(true);
+    constructor(channel, objectId) {
+        this.#channel = channel;
+        this.#objectId = objectId;
+        this.#setup();
+    }
+    #setup() {
+        // Initial fetch
+        this.refresh();
+        // Listen for updates to this specific object
+        const onObjectUpdated = ({ objectId, object }) => {
+            if (objectId === this.#objectId) {
+                this.data = object;
+            }
+        };
+        this.#channel.on('objectUpdated', onObjectUpdated);
+        this.#unsubscribers.push(() => this.#channel.off('objectUpdated', onObjectUpdated));
+        // Listen for creation (in case object didn't exist initially)
+        const onObjectCreated = ({ object }) => {
+            if (object.id === this.#objectId) {
+                this.data = object;
+            }
+        };
+        this.#channel.on('objectCreated', onObjectCreated);
+        this.#unsubscribers.push(() => this.#channel.off('objectCreated', onObjectCreated));
+        // Listen for deletion
+        const onObjectDeleted = ({ objectId }) => {
+            if (objectId === this.#objectId) {
+                this.data = undefined;
+            }
+        };
+        this.#channel.on('objectDeleted', onObjectDeleted);
+        this.#unsubscribers.push(() => this.#channel.off('objectDeleted', onObjectDeleted));
+        // Handle full resets
+        const onReset = () => this.refresh();
+        this.#channel.on('reset', onReset);
+        this.#unsubscribers.push(() => this.#channel.off('reset', onReset));
+    }
+    /**
+     * Re-fetch the object from the channel.
+     */
+    async refresh() {
+        this.loading = true;
+        try {
+            this.data = await this.#channel.getObject(this.#objectId);
+        }
+        finally {
+            this.loading = false;
+        }
+    }
+    /**
+     * Stop listening for updates and clean up.
+     */
+    close() {
+        for (const unsub of this.#unsubscribers)
+            unsub();
+        this.#unsubscribers.length = 0;
+    }
+}
+/**
+ * Minimal wrapper that adds reactive `interactions` to RoolChannel.
+ * All other properties and methods are proxied to the underlying channel.
+ */
+class ReactiveChannelImpl {
+    #channel;
+    #unsubscribers = [];
+    #closed = false;
+    // Reactive state
+    interactions = $state([]);
+    objectIds = $state([]);
+    constructor(channel) {
+        this.#channel = channel;
+        this.interactions = channel.getInteractions();
+        this.objectIds = channel.getObjectIds();
+        // Subscribe to channel updates
+        const onChannelUpdated = () => {
+            this.interactions = channel.getInteractions();
+        };
+        channel.on('channelUpdated', onChannelUpdated);
+        this.#unsubscribers.push(() => channel.off('channelUpdated', onChannelUpdated));
+        // Subscribe to object events for objectIds
+        const refreshObjectIds = () => {
+            this.objectIds = channel.getObjectIds();
+        };
+        channel.on('objectCreated', refreshObjectIds);
+        this.#unsubscribers.push(() => channel.off('objectCreated', refreshObjectIds));
+        channel.on('objectDeleted', refreshObjectIds);
+        this.#unsubscribers.push(() => channel.off('objectDeleted', refreshObjectIds));
+        const onReset = () => {
+            this.interactions = channel.getInteractions();
+            this.objectIds = channel.getObjectIds();
+        };
+        channel.on('reset', onReset);
+        this.#unsubscribers.push(() => channel.off('reset', onReset));
+    }
+    // Proxy read-only properties
+    get id() { return this.#channel.id; }
+    get name() { return this.#channel.name; }
+    get role() { return this.#channel.role; }
+    get userId() { return this.#channel.userId; }
+    get channelId() { return this.#channel.channelId; }
+    get isReadOnly() { return this.#channel.isReadOnly; }
+    get linkAccess() { return this.#channel.linkAccess; }
+    // Proxy all methods
+    close() {
+        this.#closed = true;
+        for (const unsub of this.#unsubscribers)
+            unsub();
+        this.#unsubscribers.length = 0;
+        this.#channel.close();
+    }
+    // Object operations
+    getObject(...args) { return this.#channel.getObject(...args); }
+    stat(...args) { return this.#channel.stat(...args); }
+    findObjects(...args) { return this.#channel.findObjects(...args); }
+    getObjectIds(...args) { return this.#channel.getObjectIds(...args); }
+    createObject(...args) { return this.#channel.createObject(...args); }
+    updateObject(...args) { return this.#channel.updateObject(...args); }
+    deleteObjects(...args) { return this.#channel.deleteObjects(...args); }
+    // AI
+    prompt(...args) { return this.#channel.prompt(...args); }
+    // Undo/redo
+    checkpoint(...args) { return this.#channel.checkpoint(...args); }
+    canUndo() { return this.#channel.canUndo(); }
+    canRedo() { return this.#channel.canRedo(); }
+    undo() { return this.#channel.undo(); }
+    redo() { return this.#channel.redo(); }
+    clearHistory() { return this.#channel.clearHistory(); }
+    // Metadata
+    setMetadata(...args) { return this.#channel.setMetadata(...args); }
+    getMetadata(...args) { return this.#channel.getMetadata(...args); }
+    getAllMetadata() { return this.#channel.getAllMetadata(); }
+    // Channel history
+    getInteractions() { return this.#channel.getInteractions(); }
+    getSystemInstruction() { return this.#channel.getSystemInstruction(); }
+    setSystemInstruction(...args) { return this.#channel.setSystemInstruction(...args); }
+    // Schema
+    getSchema() { return this.#channel.getSchema(); }
+    createCollection(...args) { return this.#channel.createCollection(...args); }
+    alterCollection(...args) { return this.#channel.alterCollection(...args); }
+    dropCollection(...args) { return this.#channel.dropCollection(...args); }
+    // Media
+    uploadMedia(...args) { return this.#channel.uploadMedia(...args); }
+    fetchMedia(...args) { return this.#channel.fetchMedia(...args); }
+    deleteMedia(...args) { return this.#channel.deleteMedia(...args); }
+    listMedia() { return this.#channel.listMedia(); }
+    // Channel admin
+    rename(...args) { return this.#channel.rename(...args); }
+    // Events
+    on(...args) { return this.#channel.on(...args); }
+    off(...args) { return this.#channel.off(...args); }
+    // Reactive primitives
+    /**
+     * Create a reactive object that auto-updates when the object changes.
+     * Throws if the channel has been closed.
+     */
+    object(objectId) {
+        if (this.#closed)
+            throw new Error('Cannot create reactive object: channel is closed');
+        return new ReactiveObjectImpl(this.#channel, objectId);
+    }
+    /**
+     * Create a reactive watch that auto-updates when matching objects change.
+     * Throws if the channel has been closed.
+     */
+    watch(options) {
+        if (this.#closed)
+            throw new Error('Cannot create reactive watch: channel is closed');
+        return new ReactiveWatchImpl(this.#channel, options);
+    }
+}
+export function wrapChannel(channel) {
+    return new ReactiveChannelImpl(channel);
+}
+/**
+ * A reactive list of channels for a space that auto-updates via SSE events.
+ */
+class ReactiveChannelListImpl {
+    #client;
+    #spaceId;
+    #unsubscribers = [];
+    // Reactive state
+    list = $state([]);
+    loading = $state(true);
+    constructor(client, spaceId) {
+        this.#client = client;
+        this.#spaceId = spaceId;
+        this.#setup();
+    }
+    #setup() {
+        // Initial fetch
+        this.refresh();
+        // Listen for channel lifecycle events
+        const onChannelCreated = (spaceId, channel) => {
+            if (spaceId !== this.#spaceId)
+                return;
+            this.list = [...this.list, channel];
+        };
+        this.#client.on('channelCreated', onChannelCreated);
+        this.#unsubscribers.push(() => this.#client.off('channelCreated', onChannelCreated));
+        const onChannelRenamed = (spaceId, channelId, newName) => {
+            if (spaceId !== this.#spaceId)
+                return;
+            this.list = this.list.map(ch => ch.id === channelId ? { ...ch, name: newName } : ch);
+        };
+        this.#client.on('channelRenamed', onChannelRenamed);
+        this.#unsubscribers.push(() => this.#client.off('channelRenamed', onChannelRenamed));
+        const onChannelDeleted = (spaceId, channelId) => {
+            if (spaceId !== this.#spaceId)
+                return;
+            this.list = this.list.filter(ch => ch.id !== channelId);
+        };
+        this.#client.on('channelDeleted', onChannelDeleted);
+        this.#unsubscribers.push(() => this.#client.off('channelDeleted', onChannelDeleted));
+    }
+    /**
+     * Re-fetch the channel list from the server.
+     * Opens a lightweight space handle to get the channel list.
+     */
+    async refresh() {
+        this.loading = true;
+        try {
+            const space = await this.#client.openSpace(this.#spaceId);
+            this.list = space.getChannels();
+        }
+        finally {
+            this.loading = false;
+        }
+    }
+    /**
+     * Stop listening for updates and clean up.
+     */
+    close() {
+        for (const unsub of this.#unsubscribers)
+            unsub();
+        this.#unsubscribers.length = 0;
+    }
+}
+export function createChannelList(client, spaceId) {
+    return new ReactiveChannelListImpl(client, spaceId);
+}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { createRool, generateId } from './rool.svelte.js';
-export { wrapSpace } from './space.svelte.js';
+export { wrapChannel } from './channel.svelte.js';
 export type { Rool } from './rool.svelte.js';
-export type { ReactiveSpace, ReactiveObject, ReactiveCollection, CollectionOptions } from './space.svelte.js';
-export type { RoolClientConfig, RoolSpace, RoolSpaceInfo, RoolObject, RoolUserRole, ConnectionState, ConversationInfo, CurrentUser, Interaction, FindObjectsOptions, PromptOptions, CreateObjectOptions, UpdateObjectOptions, } from '@rool-dev/sdk';
+export type { ReactiveChannel, ReactiveObject, ReactiveWatch, ReactiveChannelList, WatchOptions } from './channel.svelte.js';
+export type { RoolClientConfig, RoolChannel, RoolSpace, RoolSpaceInfo, RoolObject, RoolObjectStat, RoolUserRole, ConnectionState, ChannelInfo, CurrentUser, Interaction, FindObjectsOptions, PromptOptions, CreateObjectOptions, UpdateObjectOptions, FieldType, FieldDef, CollectionDef, SpaceSchema, SpaceMember, UserResult, RoolClient, } from '@rool-dev/sdk';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG9G,YAAY,EACV,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,UAAU,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAG7H,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,aAAa,EACb,UAAU,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,WAAW,EACX,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,EACT,QAAQ,EACR,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,UAAU,GACX,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,4 +1,4 @@
 // Main export
 export { createRool, generateId } from './rool.svelte.js';
-// Reactive space wrapper
-export { wrapSpace } from './space.svelte.js';
+// Reactive channel wrapper
+export { wrapChannel } from './channel.svelte.js';

package/dist/rool.svelte.d.ts

@@ -1,5 +1,5 @@
-import { type RoolSpaceInfo, type ConnectionState, type RoolClientConfig, type CurrentUser } from '@rool-dev/sdk';
-import { type ReactiveSpace } from './space.svelte.js';
+import { RoolClient, type RoolSpace, type RoolSpaceInfo, type ConnectionState, type RoolClientConfig, type CurrentUser } from '@rool-dev/sdk';
+import { type ReactiveChannel, type ReactiveChannelList } from './channel.svelte.js';
 /**
  * Rool client with reactive state for Svelte 5.
  *
@@ -7,7 +7,7 @@ import { type ReactiveSpace } from './space.svelte.js';
  * - Reactive auth state (`authenticated`)
  * - Reactive spaces list (`spaces`)
  * - Reactive user storage (`userStorage`)
- * - Direct access to SDK spaces (no wrapper abstraction)
+ * - Channel-based access to spaces
  */
 declare class RoolImpl {
     #private;
@@ -19,6 +19,11 @@ declare class RoolImpl {
     userStorage: Record<string, unknown>;
     currentUser: CurrentUser | null;
     constructor(config?: RoolClientConfig);
+    /**
+     * Access the underlying RoolClient for low-level API calls
+     * (e.g., graphql(), fetch()) not covered by the reactive wrapper.
+     */
+    get client(): RoolClient;
     /**
      * Initialize the client. Call on app startup.
      * Returns true if authenticated, false otherwise.
@@ -29,21 +34,24 @@ declare class RoolImpl {
      */
     login(appName: string): void;
     /**
-     * Log out and close all open spaces.
+     * Log out and close all open channels.
      */
     logout(): void;
     /**
-     * Open an existing space. Returns a ReactiveSpace with reactive `interactions`.
+     * Open a channel (space + channelId pair).
+     * Returns a ReactiveChannel with reactive `interactions`.
      */
-    openSpace(id: string, options?: {
-        conversationId?: string;
-    }): Promise<ReactiveSpace>;
+    openChannel(spaceId: string, channelId: string): Promise<ReactiveChannel>;
     /**
-     * Create a new space. Returns a ReactiveSpace with reactive `interactions`.
+     * Open a space for admin operations.
+     * Returns a lightweight RoolSpace handle (not reactive).
      */
-    createSpace(name?: string, options?: {
-        conversationId?: string;
-    }): Promise<ReactiveSpace>;
+    openSpace(spaceId: string): Promise<RoolSpace>;
+    /**
+     * Create a new space.
+     * Returns a lightweight RoolSpace handle (not reactive).
+     */
+    createSpace(name: string): Promise<RoolSpace>;
     /**
      * Manually refresh the spaces list.
      */
@@ -63,11 +71,9 @@ declare class RoolImpl {
     searchUser(email: string): Promise<import("@rool-dev/sdk").UserResult | null>;
     /**
      * Import a space from a zip archive.
-     * Returns a ReactiveSpace with reactive `interactions`.
+     * Returns a lightweight RoolSpace handle (not reactive).
      */
-    importArchive(name: string, archive: Blob, options?: {
-        conversationId?: string;
-    }): Promise<ReactiveSpace>;
+    importArchive(name: string, archive: Blob): Promise<RoolSpace>;
     /**
      * Get auth user info from JWT token.
      */
@@ -76,6 +82,20 @@ declare class RoolImpl {
      * Get current user profile from server.
      */
     getCurrentUser(): Promise<CurrentUser>;
+    /**
+     * Rename a channel in a space.
+     */
+    renameChannel(spaceId: string, channelId: string, name: string): Promise<void>;
+    /**
+     * Delete a channel from a space.
+     */
+    deleteChannel(spaceId: string, channelId: string): Promise<void>;
+    /**
+     * Create a reactive channel list for a space.
+     * Auto-updates when channels are created, renamed, or deleted.
+     * Call close() when done to stop listening.
+     */
+    channels(spaceId: string): ReactiveChannelList;
     /**
      * Clean up resources.
      */

package/dist/rool.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rool.svelte.d.ts","sourceRoot":"","sources":["../src/rool.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9H,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElE;;;;;;;;GAQG;AACH,cAAM,QAAQ;;IAMZ,aAAa,iBAAgC;IAC7C,MAAM,8BAAkD;IACxD,aAAa,UAAiB;IAC9B,WAAW,eAA8B;IACzC,eAAe,kBAA2C;IAC1D,WAAW,0BAAuC;IAClD,WAAW,qBAAoC;gBAEnC,MAAM,CAAC,EAAE,gBAAgB;IA2DrC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAW9B;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;OAEG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAO1F;;OAEG;IACG,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAO/F;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C;;;OAGG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAKjD;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM;IAIxB;;;OAGG;IACG,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,IAAI,EACb,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GACpC,OAAO,CAAC,aAAa,CAAC;IAOzB;;OAEG;IACH,IAAI,QAAQ,qCAEX;IAED;;OAEG;IACH,cAAc;IAId;;OAEG;IACH,OAAO,IAAI,IAAI;CAahB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,MAAM,MAAM,IAAI,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"rool.svelte.d.ts","sourceRoot":"","sources":["../src/rool.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9I,OAAO,EAAkC,KAAK,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAErH;;;;;;;;GAQG;AACH,cAAM,QAAQ;;IAMZ,aAAa,iBAAgC;IAC7C,MAAM,8BAAkD;IACxD,aAAa,UAAiB;IAC9B,WAAW,eAA8B;IACzC,eAAe,kBAA2C;IAC1D,WAAW,0BAAuC;IAClD,WAAW,qBAAoC;gBAEnC,MAAM,CAAC,EAAE,gBAAgB;IAKrC;;;OAGG;IACH,IAAI,MAAM,IAAI,UAAU,CAEvB;IAwDD;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAW9B;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAO/E;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAI9C;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAI7C;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C;;;OAGG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAKjD;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM;IAIxB;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC;IAI9D;;OAEG;IACH,IAAI,QAAQ,qCAEX;IAED;;OAEG;IACH,cAAc;IAId;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9E;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB;IAI9C;;OAEG;IACH,OAAO,IAAI,IAAI;CAahB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,MAAM,MAAM,IAAI,GAAG,QAAQ,CAAC"}

package/dist/rool.svelte.js

@@ -1,5 +1,5 @@
 import { RoolClient } from '@rool-dev/sdk';
-import { wrapSpace } from './space.svelte.js';
+import { wrapChannel, createChannelList } from './channel.svelte.js';
 /**
  * Rool client with reactive state for Svelte 5.
  *
@@ -7,12 +7,12 @@ import { wrapSpace } from './space.svelte.js';
  * - Reactive auth state (`authenticated`)
  * - Reactive spaces list (`spaces`)
  * - Reactive user storage (`userStorage`)
- * - Direct access to SDK spaces (no wrapper abstraction)
+ * - Channel-based access to spaces
  */
 class RoolImpl {
     #client;
     #unsubscribers = [];
-    #openSpaces = new Set();
+    #openChannels = new Set();
     // Reactive state
     authenticated = $state(null); // null = checking, false = not auth, true = auth
     spaces = $state(undefined);
@@ -25,6 +25,13 @@ class RoolImpl {
         this.#client = new RoolClient(config);
         this.#setupEventListeners();
     }
+    /**
+     * Access the underlying RoolClient for low-level API calls
+     * (e.g., graphql(), fetch()) not covered by the reactive wrapper.
+     */
+    get client() {
+        return this.#client;
+    }
     #setupEventListeners() {
         const onAuthStateChanged = (auth) => {
             this.authenticated = auth;
@@ -97,32 +104,38 @@ class RoolImpl {
         this.#client.login(appName);
     }
     /**
-     * Log out and close all open spaces.
+     * Log out and close all open channels.
      */
     logout() {
-        for (const space of this.#openSpaces) {
-            space.close();
+        for (const channel of this.#openChannels) {
+            channel.close();
         }
-        this.#openSpaces.clear();
+        this.#openChannels.clear();
         this.#client.logout();
     }
     /**
-     * Open an existing space. Returns a ReactiveSpace with reactive `interactions`.
+     * Open a channel (space + channelId pair).
+     * Returns a ReactiveChannel with reactive `interactions`.
+     */
+    async openChannel(spaceId, channelId) {
+        const channel = await this.#client.openChannel(spaceId, channelId);
+        const reactiveChannel = wrapChannel(channel);
+        this.#openChannels.add(reactiveChannel);
+        return reactiveChannel;
+    }
+    /**
+     * Open a space for admin operations.
+     * Returns a lightweight RoolSpace handle (not reactive).
      */
-    async openSpace(id, options) {
-        const space = await this.#client.openSpace(id, options);
-        const reactiveSpace = wrapSpace(space);
-        this.#openSpaces.add(reactiveSpace);
-        return reactiveSpace;
+    openSpace(spaceId) {
+        return this.#client.openSpace(spaceId);
     }
     /**
-     * Create a new space. Returns a ReactiveSpace with reactive `interactions`.
+     * Create a new space.
+     * Returns a lightweight RoolSpace handle (not reactive).
      */
-    async createSpace(name, options) {
-        const space = await this.#client.createSpace(name, options);
-        const reactiveSpace = wrapSpace(space);
-        this.#openSpaces.add(reactiveSpace);
-        return reactiveSpace;
+    createSpace(name) {
+        return this.#client.createSpace(name);
     }
     /**
      * Manually refresh the spaces list.
@@ -152,13 +165,10 @@ class RoolImpl {
     }
     /**
      * Import a space from a zip archive.
-     * Returns a ReactiveSpace with reactive `interactions`.
+     * Returns a lightweight RoolSpace handle (not reactive).
      */
-    async importArchive(name, archive, options) {
-        const space = await this.#client.importArchive(name, archive, options);
-        const reactiveSpace = wrapSpace(space);
-        this.#openSpaces.add(reactiveSpace);
-        return reactiveSpace;
+    importArchive(name, archive) {
+        return this.#client.importArchive(name, archive);
     }
     /**
      * Get auth user info from JWT token.
@@ -172,14 +182,34 @@ class RoolImpl {
     getCurrentUser() {
         return this.#client.getCurrentUser();
     }
+    /**
+     * Rename a channel in a space.
+     */
+    renameChannel(spaceId, channelId, name) {
+        return this.#client.renameChannel(spaceId, channelId, name);
+    }
+    /**
+     * Delete a channel from a space.
+     */
+    deleteChannel(spaceId, channelId) {
+        return this.#client.deleteChannel(spaceId, channelId);
+    }
+    /**
+     * Create a reactive channel list for a space.
+     * Auto-updates when channels are created, renamed, or deleted.
+     * Call close() when done to stop listening.
+     */
+    channels(spaceId) {
+        return createChannelList(this.#client, spaceId);
+    }
     /**
      * Clean up resources.
      */
     destroy() {
-        for (const space of this.#openSpaces) {
-            space.close();
+        for (const channel of this.#openChannels) {
+            channel.close();
         }
-        this.#openSpaces.clear();
+        this.#openChannels.clear();
         for (const unsub of this.#unsubscribers) {
             unsub();
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rool-dev/svelte",
-  "version": "0.2.0",
+  "version": "0.3.0-dev.381ac43",
   "description": "Svelte 5 runes for Rool Spaces",
   "type": "module",
   "svelte": "./dist/index.js",
@@ -41,7 +41,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@rool-dev/sdk": "0.2.0"
+    "@rool-dev/sdk": "0.3.0-dev.381ac43"
   },
   "peerDependencies": {
     "svelte": "^5.0.0"