@abraca/dabra 1.0.1 → 1.0.2

package/dist/index.d.ts

@@ -391,6 +391,23 @@ declare class AbracadabraClient {
   revokeInvite(code: string): Promise<void>;
   /** Redeem an invite code for the currently authenticated user. */
   redeemInvite(code: string): Promise<void>;
+  /** List spaces visible to the caller. No auth required for public spaces. */
+  listSpaces(): Promise<SpaceMeta[]>;
+  /** Get a single space by ID. */
+  getSpace(spaceId: string): Promise<SpaceMeta>;
+  /** Get the hub space, or null if none is configured. */
+  getHubSpace(): Promise<SpaceMeta | null>;
+  /** Create a new space (auth required). */
+  createSpace(opts: {
+    name: string;
+    description?: string;
+    visibility?: SpaceMeta["visibility"];
+    id?: string;
+  }): Promise<SpaceMeta>;
+  /** Update an existing space (Owner or admin required). */
+  updateSpace(spaceId: string, opts: Partial<Pick<SpaceMeta, "name" | "description" | "visibility" | "is_hub">>): Promise<SpaceMeta>;
+  /** Delete a space and its root document (Owner or admin required). */
+  deleteSpace(spaceId: string): Promise<void>;
   /** Health check — no auth required. */
   health(): Promise<HealthStatus>;
   /**
@@ -964,6 +981,17 @@ interface SearchResult {
   /** Number of matching trigrams — higher is better. */
   score: number;
 }
+interface SpaceMeta {
+  id: string;
+  doc_id: string;
+  name: string;
+  description: string | null;
+  visibility: "public" | "private" | "invite";
+  is_hub: boolean;
+  owner_id: string | null;
+  created_at: number;
+  updated_at: number;
+}
 interface InviteRow {
   code: string;
   createdBy: string | null;
@@ -1563,4 +1591,4 @@ declare class BackgroundSyncManager extends EventEmitter {
   private _walkXml;
 }
 //#endregion
-export { AbracadabraBaseProvider, AbracadabraBaseProviderConfiguration, AbracadabraClient, AbracadabraClientConfig, AbracadabraOutgoingMessageArguments, AbracadabraProvider, AbracadabraProviderConfiguration, AbracadabraWS, AbracadabraWSConfiguration, AbracadabraWebSocketConn, AuthMessageType, AuthorizedScope, AwarenessError, BackgroundSyncManager, type BackgroundSyncManagerOptions, BackgroundSyncPersistence, CloseEvent, CompleteAbracadabraBaseProviderConfiguration, CompleteAbracadabraWSConfiguration, CompleteHocuspocusProviderConfiguration, CompleteHocuspocusProviderWebsocketConfiguration, ConnectionTimeout, Constructable, ConstructableOutgoingMessage, CryptoIdentity, CryptoIdentityKeystore, type DocEncryptionInfo, DocKeyManager, type DocSyncState, DocumentCache, type DocumentCacheOptions, DocumentMeta, E2EAbracadabraProvider, E2EOfflineStore, EffectiveRole, EncryptedYMap, EncryptedYText, FileBlobStore, Forbidden, HealthStatus, HocusPocusWebSocket, HocuspocusProvider, HocuspocusProviderConfiguration, HocuspocusProviderWebsocket, HocuspocusProviderWebsocketConfiguration, HocuspocusWebSocket, InviteRow, MessageTooBig, MessageType, OfflineStore, OutgoingMessageArguments, OutgoingMessageInterface, PendingSubdoc, PermissionEntry, PublicKeyInfo, ResetConnection, SearchIndex, SearchResult, ServerInfo, StatesArray, SubdocMessage, SubdocRegisteredEvent, Unauthorized, UploadInfo, UploadMeta, UploadQueueEntry, UploadQueueStatus, UserProfile, WebSocketStatus, WsReadyStates, attachUpdatedAtObserver, awarenessStatesToArray, decryptField, encryptField, makeEncryptedYMap, makeEncryptedYText, onAuthenticatedParameters, onAuthenticationFailedParameters, onAwarenessChangeParameters, onAwarenessUpdateParameters, onCloseParameters, onDisconnectParameters, onMessageParameters, onOpenParameters, onOutgoingMessageParameters, onStatelessParameters, onStatusParameters, onSubdocLoadedParameters, onSubdocRegisteredParameters, onSyncedParameters, onUnsyncedChangesParameters, readAuthMessage, writeAuthenticated, writeAuthentication, writePermissionDenied, writeTokenSyncRequest };
+export { AbracadabraBaseProvider, AbracadabraBaseProviderConfiguration, AbracadabraClient, AbracadabraClientConfig, AbracadabraOutgoingMessageArguments, AbracadabraProvider, AbracadabraProviderConfiguration, AbracadabraWS, AbracadabraWSConfiguration, AbracadabraWebSocketConn, AuthMessageType, AuthorizedScope, AwarenessError, BackgroundSyncManager, type BackgroundSyncManagerOptions, BackgroundSyncPersistence, CloseEvent, CompleteAbracadabraBaseProviderConfiguration, CompleteAbracadabraWSConfiguration, CompleteHocuspocusProviderConfiguration, CompleteHocuspocusProviderWebsocketConfiguration, ConnectionTimeout, Constructable, ConstructableOutgoingMessage, CryptoIdentity, CryptoIdentityKeystore, type DocEncryptionInfo, DocKeyManager, type DocSyncState, DocumentCache, type DocumentCacheOptions, DocumentMeta, E2EAbracadabraProvider, E2EOfflineStore, EffectiveRole, EncryptedYMap, EncryptedYText, FileBlobStore, Forbidden, HealthStatus, HocusPocusWebSocket, HocuspocusProvider, HocuspocusProviderConfiguration, HocuspocusProviderWebsocket, HocuspocusProviderWebsocketConfiguration, HocuspocusWebSocket, InviteRow, MessageTooBig, MessageType, OfflineStore, OutgoingMessageArguments, OutgoingMessageInterface, PendingSubdoc, PermissionEntry, PublicKeyInfo, ResetConnection, SearchIndex, SearchResult, ServerInfo, SpaceMeta, StatesArray, SubdocMessage, SubdocRegisteredEvent, Unauthorized, UploadInfo, UploadMeta, UploadQueueEntry, UploadQueueStatus, UserProfile, WebSocketStatus, WsReadyStates, attachUpdatedAtObserver, awarenessStatesToArray, decryptField, encryptField, makeEncryptedYMap, makeEncryptedYText, onAuthenticatedParameters, onAuthenticationFailedParameters, onAwarenessChangeParameters, onAwarenessUpdateParameters, onCloseParameters, onDisconnectParameters, onMessageParameters, onOpenParameters, onOutgoingMessageParameters, onStatelessParameters, onStatusParameters, onSubdocLoadedParameters, onSubdocRegisteredParameters, onSyncedParameters, onUnsyncedChangesParameters, readAuthMessage, writeAuthenticated, writeAuthentication, writePermissionDenied, writeTokenSyncRequest };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abraca/dabra",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "abracadabra provider",
   "keywords": [
     "abracadabra",

package/src/AbracadabraClient.ts

@@ -8,6 +8,7 @@ import type {
 	HealthStatus,
 	ServerInfo,
 	InviteRow,
+	SpaceMeta,
 } from "./types.ts";
 import type { DocEncryptionInfo } from "./types.ts";
 import type { DocumentCache } from "./DocumentCache.ts";
@@ -472,6 +473,54 @@ export class AbracadabraClient {
 		await this.request("POST", "/invites/redeem", { body: { code } });
 	}
 
+	// ── Spaces ───────────────────────────────────────────────────────────────
+
+	/** List spaces visible to the caller. No auth required for public spaces. */
+	async listSpaces(): Promise<SpaceMeta[]> {
+		const res = await this.request<{ spaces: SpaceMeta[] }>("GET", "/spaces", { auth: false });
+		return res.spaces;
+	}
+
+	/** Get a single space by ID. */
+	async getSpace(spaceId: string): Promise<SpaceMeta> {
+		return this.request<SpaceMeta>("GET", `/spaces/${encodeURIComponent(spaceId)}`, { auth: false });
+	}
+
+	/** Get the hub space, or null if none is configured. */
+	async getHubSpace(): Promise<SpaceMeta | null> {
+		try {
+			return await this.request<SpaceMeta>("GET", "/spaces/hub", { auth: false });
+		} catch (e: unknown) {
+			if (typeof e === "object" && e !== null && "status" in e && (e as { status: number }).status === 404) {
+				return null;
+			}
+			throw e;
+		}
+	}
+
+	/** Create a new space (auth required). */
+	async createSpace(opts: {
+		name: string;
+		description?: string;
+		visibility?: SpaceMeta["visibility"];
+		id?: string;
+	}): Promise<SpaceMeta> {
+		return this.request<SpaceMeta>("POST", "/spaces", { body: opts });
+	}
+
+	/** Update an existing space (Owner or admin required). */
+	async updateSpace(
+		spaceId: string,
+		opts: Partial<Pick<SpaceMeta, "name" | "description" | "visibility" | "is_hub">>,
+	): Promise<SpaceMeta> {
+		return this.request<SpaceMeta>("PATCH", `/spaces/${encodeURIComponent(spaceId)}`, { body: opts });
+	}
+
+	/** Delete a space and its root document (Owner or admin required). */
+	async deleteSpace(spaceId: string): Promise<void> {
+		await this.request("DELETE", `/spaces/${encodeURIComponent(spaceId)}`);
+	}
+
 	// ── System ───────────────────────────────────────────────────────────────
 
 	/** Health check — no auth required. */

package/src/types.ts

@@ -223,6 +223,20 @@ export interface SearchResult {
   score: number;
 }
 
+// ── Spaces ───────────────────────────────────────────────────────────────────
+
+export interface SpaceMeta {
+  id: string;
+  doc_id: string;
+  name: string;
+  description: string | null;
+  visibility: "public" | "private" | "invite";
+  is_hub: boolean;
+  owner_id: string | null;
+  created_at: number;
+  updated_at: number;
+}
+
 // ── Invites ──────────────────────────────────────────────────────────────────
 
 export interface InviteRow {