@abraca/dabra 1.1.0 → 1.1.1

package/dist/index.d.ts

@@ -434,22 +434,57 @@ 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. */
+  /** List root documents (replaces listSpaces for new code). */
+  listRootDocuments(): Promise<DocumentMeta[]>;
+  /** Get the hub document, or null if none is configured. */
+  getHubDocument(): Promise<DocumentMeta | null>;
+  /** Set the public_access level for a document. Pass null to inherit from parent. */
+  setDocumentAccess(docId: string, publicAccess: string | null): Promise<void>;
+  /** Get the public_access info for a document. */
+  getDocumentAccess(docId: string): Promise<{
+    public_access: string | null;
+    effective_public_access: string | null;
+  }>;
+  /** Update document metadata (label, description, is_hub). Requires manage permission. */
+  updateDocumentMeta(docId: string, opts: {
+    label?: string;
+    description?: string | null;
+    is_hub?: boolean;
+  }): Promise<void>;
+  /**
+   * List spaces visible to the caller. No auth required for public spaces.
+   * @deprecated Use {@link listRootDocuments} instead.
+   */
   listSpaces(): Promise<SpaceMeta[]>;
-  /** Get a single space by ID. */
+  /**
+   * Get a single space by ID.
+   * @deprecated Use {@link getDoc} instead.
+   */
   getSpace(spaceId: string): Promise<SpaceMeta>;
-  /** Get the hub space, or null if none is configured. */
+  /**
+   * Get the hub space, or null if none is configured.
+   * @deprecated Use {@link getHubDocument} instead.
+   */
   getHubSpace(): Promise<SpaceMeta | null>;
-  /** Create a new space (auth required). */
+  /**
+   * Create a new space (auth required).
+   * @deprecated Use {@link createDoc} + {@link updateDocumentMeta} instead.
+   */
   createSpace(opts: {
     name: string;
     description?: string;
     visibility?: SpaceMeta["visibility"];
     id?: string;
   }): Promise<SpaceMeta>;
-  /** Update an existing space (Owner or admin required). */
+  /**
+   * Update an existing space (Owner or admin required).
+   * @deprecated Use {@link updateDocumentMeta} + {@link setDocumentAccess} instead.
+   */
   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). */
+  /**
+   * Delete a space and its root document (Owner or admin required).
+   * @deprecated Use {@link deleteDoc} instead.
+   */
   deleteSpace(spaceId: string): Promise<void>;
   /** List all users (requires elevated role: admin or service). */
   adminListUsers(): Promise<{
@@ -1025,6 +1060,11 @@ interface DocumentMeta {
   parent_id: string | null;
   doc_type?: string | null;
   label?: string | null;
+  description?: string | null;
+  public_access?: string | null;
+  owner_id?: string | null;
+  is_hub?: boolean;
+  updated_at?: number | null;
 }
 interface UploadMeta {
   id: string;
@@ -1107,6 +1147,7 @@ interface SpaceMeta {
   owner_id: string | null;
   created_at: number;
   updated_at: number;
+  public_access?: string | null;
 }
 interface InviteRow {
   code: string;

package/package.json

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

package/src/AbracadabraClient.ts

@@ -543,25 +543,70 @@ export class AbracadabraClient {
 		await this.request("POST", "/invites/redeem", { body: { code } });
 	}
 
-	// ── Spaces ───────────────────────────────────────────────────────────────
+	// ── Document Access & Discovery ──────────────────────────────────────────
 
-	/** List spaces visible to the caller. No auth required for public spaces. */
+	/** List root documents (replaces listSpaces for new code). */
+	async listRootDocuments(): Promise<DocumentMeta[]> {
+		const res = await this.request<{ documents: DocumentMeta[] }>("GET", "/docs?root=true");
+		return res.documents;
+	}
+
+	/** Get the hub document, or null if none is configured. */
+	async getHubDocument(): Promise<DocumentMeta | null> {
+		return this.requestOrNull<DocumentMeta>("GET", "/docs/hub");
+	}
+
+	/** Set the public_access level for a document. Pass null to inherit from parent. */
+	async setDocumentAccess(docId: string, publicAccess: string | null): Promise<void> {
+		await this.request("PATCH", `/docs/${encodeURIComponent(docId)}/access`, {
+			body: { public_access: publicAccess },
+		});
+	}
+
+	/** Get the public_access info for a document. */
+	async getDocumentAccess(docId: string): Promise<{ public_access: string | null; effective_public_access: string | null }> {
+		return this.request("GET", `/docs/${encodeURIComponent(docId)}/access`);
+	}
+
+	/** Update document metadata (label, description, is_hub). Requires manage permission. */
+	async updateDocumentMeta(
+		docId: string,
+		opts: { label?: string; description?: string | null; is_hub?: boolean },
+	): Promise<void> {
+		await this.request("PATCH", `/docs/${encodeURIComponent(docId)}`, { body: opts });
+	}
+
+	// ── Spaces (deprecated — use document-based methods) ─────────────────────
+
+	/**
+	 * List spaces visible to the caller. No auth required for public spaces.
+	 * @deprecated Use {@link listRootDocuments} instead.
+	 */
 	async listSpaces(): Promise<SpaceMeta[]> {
 		const res = await this.request<{ spaces: SpaceMeta[] }>("GET", "/spaces", { auth: false });
 		return res.spaces;
 	}
 
-	/** Get a single space by ID. */
+	/**
+	 * Get a single space by ID.
+	 * @deprecated Use {@link getDoc} instead.
+	 */
 	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. */
+	/**
+	 * Get the hub space, or null if none is configured.
+	 * @deprecated Use {@link getHubDocument} instead.
+	 */
 	async getHubSpace(): Promise<SpaceMeta | null> {
 		return this.requestOrNull<SpaceMeta>("GET", "/spaces/hub", { auth: false });
 	}
 
-	/** Create a new space (auth required). */
+	/**
+	 * Create a new space (auth required).
+	 * @deprecated Use {@link createDoc} + {@link updateDocumentMeta} instead.
+	 */
 	async createSpace(opts: {
 		name: string;
 		description?: string;
@@ -571,7 +616,10 @@ export class AbracadabraClient {
 		return this.request<SpaceMeta>("POST", "/spaces", { body: opts });
 	}
 
-	/** Update an existing space (Owner or admin required). */
+	/**
+	 * Update an existing space (Owner or admin required).
+	 * @deprecated Use {@link updateDocumentMeta} + {@link setDocumentAccess} instead.
+	 */
 	async updateSpace(
 		spaceId: string,
 		opts: Partial<Pick<SpaceMeta, "name" | "description" | "visibility" | "is_hub">>,
@@ -579,7 +627,10 @@ export class AbracadabraClient {
 		return this.request<SpaceMeta>("PATCH", `/spaces/${encodeURIComponent(spaceId)}`, { body: opts });
 	}
 
-	/** Delete a space and its root document (Owner or admin required). */
+	/**
+	 * Delete a space and its root document (Owner or admin required).
+	 * @deprecated Use {@link deleteDoc} instead.
+	 */
 	async deleteSpace(spaceId: string): Promise<void> {
 		await this.request("DELETE", `/spaces/${encodeURIComponent(spaceId)}`);
 	}

package/src/types.ts

@@ -175,6 +175,11 @@ export interface DocumentMeta {
   parent_id: string | null;
   doc_type?: string | null;
   label?: string | null;
+  description?: string | null;
+  public_access?: string | null;
+  owner_id?: string | null;
+  is_hub?: boolean;
+  updated_at?: number | null;
 }
 
 export interface UploadMeta {
@@ -268,6 +273,7 @@ export interface SpaceMeta {
   owner_id: string | null;
   created_at: number;
   updated_at: number;
+  public_access?: string | null;
 }
 
 // ── Invites ──────────────────────────────────────────────────────────────────