@abraca/dabra 1.0.0 → 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;
@@ -1329,6 +1357,12 @@ declare class FileBlobStore extends EventEmitter {
    * URL.createObjectURL is unavailable (e.g. Node.js / SSR).
    */
   getBlobUrl(docId: string, uploadId: string): Promise<string | null>;
+  /**
+   * Store a blob directly into the cache under the given (docId, uploadId) key
+   * and return its object URL.  Use this to pre-populate the cache for files
+   * that haven't been uploaded to the server yet (e.g. offline upload queue).
+   */
+  putBlob(docId: string, uploadId: string, blob: Blob, filename: string): Promise<string>;
   /** Revoke the object URL and remove the blob from cache. */
   evictBlob(docId: string, uploadId: string): Promise<void>;
   /**
@@ -1557,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.0",
+  "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/FileBlobStore.ts

@@ -160,6 +160,42 @@ export class FileBlobStore extends EventEmitter {
 		return url;
 	}
 
+	/**
+	 * Store a blob directly into the cache under the given (docId, uploadId) key
+	 * and return its object URL.  Use this to pre-populate the cache for files
+	 * that haven't been uploaded to the server yet (e.g. offline upload queue).
+	 */
+	async putBlob(
+		docId: string,
+		uploadId: string,
+		blob: Blob,
+		filename: string,
+	): Promise<string> {
+		if (typeof window === "undefined") return URL.createObjectURL(blob);
+
+		const key = this.blobKey(docId, uploadId);
+
+		// Return existing URL if already cached in-memory
+		const existing = this.objectUrls.get(key);
+		if (existing) return existing;
+
+		const db = await this.getDb();
+		if (db) {
+			const entry: BlobCacheEntry = {
+				blob,
+				mime_type: blob.type || "application/octet-stream",
+				filename,
+				cachedAt: Date.now(),
+			};
+			const tx = db.transaction("blobs", "readwrite");
+			tx.objectStore("blobs").put(entry, key);
+		}
+
+		const url = URL.createObjectURL(blob);
+		this.objectUrls.set(key, url);
+		return url;
+	}
+
 	/** Revoke the object URL and remove the blob from cache. */
 	async evictBlob(docId: string, uploadId: string): Promise<void> {
 		const key = this.blobKey(docId, uploadId);

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 {