@arke-institute/sdk 0.1.0

package/dist/collections/index.mjs

@@ -0,0 +1,204 @@
+// src/collections/errors.ts
+var CollectionsError = class extends Error {
+  constructor(message, code = "UNKNOWN_ERROR", details) {
+    super(message);
+    this.code = code;
+    this.details = details;
+    this.name = "CollectionsError";
+  }
+};
+
+// src/collections/client.ts
+var CollectionsClient = class {
+  constructor(config) {
+    this.baseUrl = config.gatewayUrl.replace(/\/$/, "");
+    this.authToken = config.authToken;
+    this.fetchImpl = config.fetchImpl ?? fetch;
+  }
+  setAuthToken(token) {
+    this.authToken = token;
+  }
+  // ---------------------------------------------------------------------------
+  // Request helpers
+  // ---------------------------------------------------------------------------
+  buildUrl(path, query) {
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (query) {
+      Object.entries(query).forEach(([key, value]) => {
+        if (value !== void 0 && value !== null) {
+          url.searchParams.set(key, String(value));
+        }
+      });
+    }
+    return url.toString();
+  }
+  getHeaders(authRequired) {
+    const headers = { "Content-Type": "application/json" };
+    if (authRequired || this.authToken) {
+      if (!this.authToken && authRequired) {
+        throw new CollectionsError("Authentication required for this operation", "AUTH_REQUIRED");
+      }
+      if (this.authToken) {
+        headers["Authorization"] = `Bearer ${this.authToken}`;
+      }
+    }
+    return headers;
+  }
+  async request(path, options = {}) {
+    const authRequired = options.authRequired ?? false;
+    const url = this.buildUrl(path, options.query);
+    const headers = new Headers(this.getHeaders(authRequired));
+    if (options.headers) {
+      Object.entries(options.headers).forEach(([k, v]) => {
+        if (v !== void 0) headers.set(k, v);
+      });
+    }
+    const response = await this.fetchImpl(url, { ...options, headers });
+    if (response.ok) {
+      if (response.status === 204) {
+        return void 0;
+      }
+      const contentType = response.headers.get("content-type") || "";
+      if (contentType.includes("application/json")) {
+        return await response.json();
+      }
+      return await response.text();
+    }
+    let body;
+    try {
+      body = await response.json();
+    } catch {
+      body = await response.text();
+    }
+    const message = body?.error && typeof body.error === "string" ? body.error : `Request failed with status ${response.status}`;
+    throw new CollectionsError(message, "HTTP_ERROR", {
+      status: response.status,
+      body
+    });
+  }
+  // ---------------------------------------------------------------------------
+  // Collections
+  // ---------------------------------------------------------------------------
+  async listCollections(params) {
+    return this.request("/collections", {
+      method: "GET",
+      query: { limit: params?.limit, offset: params?.offset }
+    });
+  }
+  async getCollection(id) {
+    return this.request(`/collections/${id}`, { method: "GET" });
+  }
+  async getCollectionRoot(id) {
+    return this.request(`/collections/${id}/root`, { method: "GET" });
+  }
+  async getMyAccess(id) {
+    return this.request(`/collections/${id}/my-access`, { method: "GET", authRequired: true });
+  }
+  async createCollection(payload) {
+    return this.request("/collections", {
+      method: "POST",
+      authRequired: true,
+      body: JSON.stringify(payload)
+    });
+  }
+  async registerRoot(payload) {
+    return this.request("/collections/register-root", {
+      method: "POST",
+      authRequired: true,
+      body: JSON.stringify(payload)
+    });
+  }
+  async updateCollection(id, payload) {
+    return this.request(`/collections/${id}`, {
+      method: "PATCH",
+      authRequired: true,
+      body: JSON.stringify(payload)
+    });
+  }
+  async changeRoot(id, payload) {
+    return this.request(`/collections/${id}/change-root`, {
+      method: "PATCH",
+      authRequired: true,
+      body: JSON.stringify(payload)
+    });
+  }
+  async deleteCollection(id) {
+    return this.request(`/collections/${id}`, {
+      method: "DELETE",
+      authRequired: true
+    });
+  }
+  // ---------------------------------------------------------------------------
+  // Members
+  // ---------------------------------------------------------------------------
+  async listMembers(collectionId) {
+    return this.request(`/collections/${collectionId}/members`, { method: "GET" });
+  }
+  async updateMemberRole(collectionId, userId, role) {
+    return this.request(`/collections/${collectionId}/members/${userId}`, {
+      method: "PATCH",
+      authRequired: true,
+      body: JSON.stringify({ role })
+    });
+  }
+  async removeMember(collectionId, userId) {
+    return this.request(`/collections/${collectionId}/members/${userId}`, {
+      method: "DELETE",
+      authRequired: true
+    });
+  }
+  // ---------------------------------------------------------------------------
+  // Invitations
+  // ---------------------------------------------------------------------------
+  async createInvitation(collectionId, email, role) {
+    return this.request(`/collections/${collectionId}/invitations`, {
+      method: "POST",
+      authRequired: true,
+      body: JSON.stringify({ email, role })
+    });
+  }
+  async listInvitations(collectionId) {
+    return this.request(`/collections/${collectionId}/invitations`, {
+      method: "GET",
+      authRequired: true
+    });
+  }
+  async acceptInvitation(invitationId) {
+    return this.request(`/invitations/${invitationId}/accept`, {
+      method: "POST",
+      authRequired: true
+    });
+  }
+  async declineInvitation(invitationId) {
+    return this.request(`/invitations/${invitationId}/decline`, {
+      method: "POST",
+      authRequired: true
+    });
+  }
+  async revokeInvitation(invitationId) {
+    return this.request(`/invitations/${invitationId}`, {
+      method: "DELETE",
+      authRequired: true
+    });
+  }
+  // ---------------------------------------------------------------------------
+  // Current user
+  // ---------------------------------------------------------------------------
+  async getMyCollections() {
+    return this.request("/me/collections", { method: "GET", authRequired: true });
+  }
+  async getMyInvitations() {
+    return this.request("/me/invitations", { method: "GET", authRequired: true });
+  }
+  // ---------------------------------------------------------------------------
+  // PI permissions
+  // ---------------------------------------------------------------------------
+  async getPiPermissions(pi) {
+    return this.request(`/pi/${pi}/permissions`, { method: "GET" });
+  }
+};
+export {
+  CollectionsClient,
+  CollectionsError
+};
+//# sourceMappingURL=index.mjs.map

package/dist/collections/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/collections/errors.ts","../../src/collections/client.ts"],"sourcesContent":["export class CollectionsError extends Error {\n  constructor(\n    message: string,\n    public code: string = 'UNKNOWN_ERROR',\n    public details?: unknown\n  ) {\n    super(message);\n    this.name = 'CollectionsError';\n  }\n}\n","import { CollectionsError } from './errors';\nimport type {\n  ChangeRootPayload,\n  ChangeRootResponse,\n  Collection,\n  CollectionDetails,\n  CollectionRole,\n  CreateCollectionPayload,\n  Invitation,\n  InvitationsResponse,\n  Member,\n  MembersResponse,\n  MyAccessResponse,\n  MyCollectionsResponse,\n  PaginatedCollections,\n  PiPermissions,\n  RegisterRootPayload,\n  RootResponse,\n  SuccessResponse,\n  UpdateCollectionPayload,\n} from './types';\n\nexport interface CollectionsClientConfig {\n  /**\n   * Gateway base URL (e.g., https://api.arke.institute).\n   * Must already point at the Arke gateway that proxies /collections/*.\n   */\n  gatewayUrl: string;\n  /**\n   * Optional bearer token for authenticated routes.\n   * Public routes will still include it if provided.\n   */\n  authToken?: string;\n  /**\n   * Optional custom fetch (useful for testing).\n   */\n  fetchImpl?: typeof fetch;\n}\n\ntype JsonBody = Record<string, unknown>;\n\nexport class CollectionsClient {\n  private baseUrl: string;\n  private authToken?: string;\n  private fetchImpl: typeof fetch;\n\n  constructor(config: CollectionsClientConfig) {\n    this.baseUrl = config.gatewayUrl.replace(/\\/$/, '');\n    this.authToken = config.authToken;\n    this.fetchImpl = config.fetchImpl ?? fetch;\n  }\n\n  setAuthToken(token?: string) {\n    this.authToken = token;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Request helpers\n  // ---------------------------------------------------------------------------\n\n  private buildUrl(path: string, query?: Record<string, string | number | undefined>) {\n    const url = new URL(`${this.baseUrl}${path}`);\n    if (query) {\n      Object.entries(query).forEach(([key, value]) => {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      });\n    }\n    return url.toString();\n  }\n\n  private getHeaders(authRequired: boolean): HeadersInit {\n    const headers: HeadersInit = { 'Content-Type': 'application/json' };\n    if (authRequired || this.authToken) {\n      if (!this.authToken && authRequired) {\n        throw new CollectionsError('Authentication required for this operation', 'AUTH_REQUIRED');\n      }\n      if (this.authToken) {\n        headers['Authorization'] = `Bearer ${this.authToken}`;\n      }\n    }\n    return headers;\n  }\n\n  private async request<T>(\n    path: string,\n    options: RequestInit & {\n      authRequired?: boolean;\n      query?: Record<string, string | number | undefined>;\n    } = {}\n  ): Promise<T> {\n    const authRequired = options.authRequired ?? false;\n    const url = this.buildUrl(path, options.query);\n    const headers = new Headers(this.getHeaders(authRequired));\n    if (options.headers) {\n      Object.entries(options.headers).forEach(([k, v]) => {\n        if (v !== undefined) headers.set(k, v as string);\n      });\n    }\n\n    const response = await this.fetchImpl(url, { ...options, headers });\n\n    if (response.ok) {\n      if (response.status === 204) {\n        return undefined as T;\n      }\n      const contentType = response.headers.get('content-type') || '';\n      if (contentType.includes('application/json')) {\n        return (await response.json()) as T;\n      }\n      return (await response.text()) as unknown as T;\n    }\n\n    let body: unknown;\n    try {\n      body = await response.json();\n    } catch {\n      body = await response.text();\n    }\n\n    const message =\n      (body as JsonBody)?.error && typeof (body as JsonBody).error === 'string'\n        ? ((body as JsonBody).error as string)\n        : `Request failed with status ${response.status}`;\n\n    throw new CollectionsError(message, 'HTTP_ERROR', {\n      status: response.status,\n      body,\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Collections\n  // ---------------------------------------------------------------------------\n\n  async listCollections(params?: { limit?: number; offset?: number }): Promise<PaginatedCollections> {\n    return this.request('/collections', {\n      method: 'GET',\n      query: { limit: params?.limit, offset: params?.offset },\n    });\n  }\n\n  async getCollection(id: string): Promise<CollectionDetails> {\n    return this.request(`/collections/${id}`, { method: 'GET' });\n  }\n\n  async getCollectionRoot(id: string): Promise<RootResponse> {\n    return this.request(`/collections/${id}/root`, { method: 'GET' });\n  }\n\n  async getMyAccess(id: string): Promise<MyAccessResponse> {\n    return this.request(`/collections/${id}/my-access`, { method: 'GET', authRequired: true });\n  }\n\n  async createCollection(payload: CreateCollectionPayload): Promise<Collection> {\n    return this.request('/collections', {\n      method: 'POST',\n      authRequired: true,\n      body: JSON.stringify(payload),\n    });\n  }\n\n  async registerRoot(payload: RegisterRootPayload): Promise<Collection & { rootPi: string }> {\n    return this.request('/collections/register-root', {\n      method: 'POST',\n      authRequired: true,\n      body: JSON.stringify(payload),\n    });\n  }\n\n  async updateCollection(id: string, payload: UpdateCollectionPayload): Promise<Collection> {\n    return this.request(`/collections/${id}`, {\n      method: 'PATCH',\n      authRequired: true,\n      body: JSON.stringify(payload),\n    });\n  }\n\n  async changeRoot(id: string, payload: ChangeRootPayload): Promise<ChangeRootResponse> {\n    return this.request(`/collections/${id}/change-root`, {\n      method: 'PATCH',\n      authRequired: true,\n      body: JSON.stringify(payload),\n    });\n  }\n\n  async deleteCollection(id: string): Promise<SuccessResponse> {\n    return this.request(`/collections/${id}`, {\n      method: 'DELETE',\n      authRequired: true,\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Members\n  // ---------------------------------------------------------------------------\n\n  async listMembers(collectionId: string): Promise<MembersResponse> {\n    return this.request(`/collections/${collectionId}/members`, { method: 'GET' });\n  }\n\n  async updateMemberRole(\n    collectionId: string,\n    userId: string,\n    role: CollectionRole\n  ): Promise<{ success: true; role: CollectionRole }> {\n    return this.request(`/collections/${collectionId}/members/${userId}`, {\n      method: 'PATCH',\n      authRequired: true,\n      body: JSON.stringify({ role }),\n    });\n  }\n\n  async removeMember(collectionId: string, userId: string): Promise<SuccessResponse> {\n    return this.request(`/collections/${collectionId}/members/${userId}`, {\n      method: 'DELETE',\n      authRequired: true,\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Invitations\n  // ---------------------------------------------------------------------------\n\n  async createInvitation(collectionId: string, email: string, role: CollectionRole): Promise<Invitation> {\n    return this.request(`/collections/${collectionId}/invitations`, {\n      method: 'POST',\n      authRequired: true,\n      body: JSON.stringify({ email, role }),\n    });\n  }\n\n  async listInvitations(collectionId: string): Promise<InvitationsResponse> {\n    return this.request(`/collections/${collectionId}/invitations`, {\n      method: 'GET',\n      authRequired: true,\n    });\n  }\n\n  async acceptInvitation(invitationId: string): Promise<{ success: true; role: CollectionRole }> {\n    return this.request(`/invitations/${invitationId}/accept`, {\n      method: 'POST',\n      authRequired: true,\n    });\n  }\n\n  async declineInvitation(invitationId: string): Promise<SuccessResponse> {\n    return this.request(`/invitations/${invitationId}/decline`, {\n      method: 'POST',\n      authRequired: true,\n    });\n  }\n\n  async revokeInvitation(invitationId: string): Promise<SuccessResponse> {\n    return this.request(`/invitations/${invitationId}`, {\n      method: 'DELETE',\n      authRequired: true,\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Current user\n  // ---------------------------------------------------------------------------\n\n  async getMyCollections(): Promise<MyCollectionsResponse> {\n    return this.request('/me/collections', { method: 'GET', authRequired: true });\n  }\n\n  async getMyInvitations(): Promise<InvitationsResponse> {\n    return this.request('/me/invitations', { method: 'GET', authRequired: true });\n  }\n\n  // ---------------------------------------------------------------------------\n  // PI permissions\n  // ---------------------------------------------------------------------------\n\n  async getPiPermissions(pi: string): Promise<PiPermissions> {\n    return this.request(`/pi/${pi}/permissions`, { method: 'GET' });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.mts

@@ -0,0 +1,189 @@
+type CollectionVisibility = 'public' | 'private';
+type CollectionRole = 'owner' | 'editor';
+interface Collection {
+    id: string;
+    title: string;
+    slug: string;
+    description?: string | null;
+    visibility: CollectionVisibility;
+    creator_user_id?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+interface CollectionDetails extends Collection {
+    member_count: number;
+    root_pi: string | null;
+    users?: {
+        email?: string;
+        name?: string | null;
+    };
+}
+interface PaginatedCollections {
+    collections: CollectionDetails[];
+    pagination: {
+        total: number | null;
+        limit: number;
+        offset: number;
+    };
+}
+interface MemberUser {
+    id: string;
+    email: string;
+    name?: string | null;
+}
+interface Member {
+    role: CollectionRole;
+    created_at?: string;
+    user: MemberUser;
+}
+interface MembersResponse {
+    members: Member[];
+}
+interface InvitationUser {
+    email: string;
+    name?: string | null;
+}
+interface Invitation {
+    id: string;
+    role: CollectionRole;
+    status: 'pending' | 'accepted' | 'declined' | 'expired';
+    expires_at: string;
+    created_at: string;
+    responded_at?: string | null;
+    invitee?: InvitationUser;
+    inviter?: InvitationUser;
+    collection?: {
+        id: string;
+        title: string;
+        slug: string;
+    };
+}
+interface InvitationsResponse {
+    invitations: Invitation[];
+}
+interface CreateCollectionPayload {
+    title: string;
+    slug: string;
+    description?: string;
+    visibility?: CollectionVisibility;
+}
+interface RegisterRootPayload extends CreateCollectionPayload {
+    rootPi: string;
+}
+interface UpdateCollectionPayload {
+    title?: string;
+    description?: string;
+    visibility?: CollectionVisibility;
+}
+interface ChangeRootPayload {
+    newRootPi: string;
+}
+interface MyCollectionsResponse {
+    owned: Array<Collection & {
+        role: CollectionRole;
+    }>;
+    editing: Array<Collection & {
+        role: CollectionRole;
+    }>;
+    total: number;
+}
+interface MyAccessResponse {
+    isMember: boolean;
+    role: CollectionRole | null;
+    canView: boolean;
+    canEdit: boolean;
+    canInvite: boolean;
+    canManageMembers: boolean;
+    canDelete: boolean;
+}
+interface RootResponse {
+    rootPi: string;
+}
+interface ChangeRootResponse {
+    previousRoot: string | null;
+    newRoot: string;
+}
+interface SuccessResponse {
+    success: boolean;
+}
+interface PiPermissions {
+    pi: string;
+    canView: boolean;
+    canEdit: boolean;
+    canAdminister: boolean;
+    collection: {
+        id: string;
+        title: string;
+        slug: string;
+        visibility: CollectionVisibility;
+        role: CollectionRole | null;
+        rootPi: string;
+        hops: number;
+    } | null;
+}
+
+interface CollectionsClientConfig {
+    /**
+     * Gateway base URL (e.g., https://api.arke.institute).
+     * Must already point at the Arke gateway that proxies /collections/*.
+     */
+    gatewayUrl: string;
+    /**
+     * Optional bearer token for authenticated routes.
+     * Public routes will still include it if provided.
+     */
+    authToken?: string;
+    /**
+     * Optional custom fetch (useful for testing).
+     */
+    fetchImpl?: typeof fetch;
+}
+declare class CollectionsClient {
+    private baseUrl;
+    private authToken?;
+    private fetchImpl;
+    constructor(config: CollectionsClientConfig);
+    setAuthToken(token?: string): void;
+    private buildUrl;
+    private getHeaders;
+    private request;
+    listCollections(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<PaginatedCollections>;
+    getCollection(id: string): Promise<CollectionDetails>;
+    getCollectionRoot(id: string): Promise<RootResponse>;
+    getMyAccess(id: string): Promise<MyAccessResponse>;
+    createCollection(payload: CreateCollectionPayload): Promise<Collection>;
+    registerRoot(payload: RegisterRootPayload): Promise<Collection & {
+        rootPi: string;
+    }>;
+    updateCollection(id: string, payload: UpdateCollectionPayload): Promise<Collection>;
+    changeRoot(id: string, payload: ChangeRootPayload): Promise<ChangeRootResponse>;
+    deleteCollection(id: string): Promise<SuccessResponse>;
+    listMembers(collectionId: string): Promise<MembersResponse>;
+    updateMemberRole(collectionId: string, userId: string, role: CollectionRole): Promise<{
+        success: true;
+        role: CollectionRole;
+    }>;
+    removeMember(collectionId: string, userId: string): Promise<SuccessResponse>;
+    createInvitation(collectionId: string, email: string, role: CollectionRole): Promise<Invitation>;
+    listInvitations(collectionId: string): Promise<InvitationsResponse>;
+    acceptInvitation(invitationId: string): Promise<{
+        success: true;
+        role: CollectionRole;
+    }>;
+    declineInvitation(invitationId: string): Promise<SuccessResponse>;
+    revokeInvitation(invitationId: string): Promise<SuccessResponse>;
+    getMyCollections(): Promise<MyCollectionsResponse>;
+    getMyInvitations(): Promise<InvitationsResponse>;
+    getPiPermissions(pi: string): Promise<PiPermissions>;
+}
+
+declare class CollectionsError extends Error {
+    code: string;
+    details?: unknown | undefined;
+    constructor(message: string, code?: string, details?: unknown | undefined);
+}
+
+export { type ChangeRootPayload, type ChangeRootResponse, type Collection, type CollectionDetails, type CollectionRole, type CollectionVisibility, CollectionsClient, type CollectionsClientConfig, CollectionsError, type CreateCollectionPayload, type Invitation, type InvitationUser, type InvitationsResponse, type Member, type MemberUser, type MembersResponse, type MyAccessResponse, type MyCollectionsResponse, type PaginatedCollections, type PiPermissions, type RegisterRootPayload, type RootResponse, type SuccessResponse, type UpdateCollectionPayload };

package/dist/index.d.ts

@@ -0,0 +1,189 @@
+type CollectionVisibility = 'public' | 'private';
+type CollectionRole = 'owner' | 'editor';
+interface Collection {
+    id: string;
+    title: string;
+    slug: string;
+    description?: string | null;
+    visibility: CollectionVisibility;
+    creator_user_id?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+interface CollectionDetails extends Collection {
+    member_count: number;
+    root_pi: string | null;
+    users?: {
+        email?: string;
+        name?: string | null;
+    };
+}
+interface PaginatedCollections {
+    collections: CollectionDetails[];
+    pagination: {
+        total: number | null;
+        limit: number;
+        offset: number;
+    };
+}
+interface MemberUser {
+    id: string;
+    email: string;
+    name?: string | null;
+}
+interface Member {
+    role: CollectionRole;
+    created_at?: string;
+    user: MemberUser;
+}
+interface MembersResponse {
+    members: Member[];
+}
+interface InvitationUser {
+    email: string;
+    name?: string | null;
+}
+interface Invitation {
+    id: string;
+    role: CollectionRole;
+    status: 'pending' | 'accepted' | 'declined' | 'expired';
+    expires_at: string;
+    created_at: string;
+    responded_at?: string | null;
+    invitee?: InvitationUser;
+    inviter?: InvitationUser;
+    collection?: {
+        id: string;
+        title: string;
+        slug: string;
+    };
+}
+interface InvitationsResponse {
+    invitations: Invitation[];
+}
+interface CreateCollectionPayload {
+    title: string;
+    slug: string;
+    description?: string;
+    visibility?: CollectionVisibility;
+}
+interface RegisterRootPayload extends CreateCollectionPayload {
+    rootPi: string;
+}
+interface UpdateCollectionPayload {
+    title?: string;
+    description?: string;
+    visibility?: CollectionVisibility;
+}
+interface ChangeRootPayload {
+    newRootPi: string;
+}
+interface MyCollectionsResponse {
+    owned: Array<Collection & {
+        role: CollectionRole;
+    }>;
+    editing: Array<Collection & {
+        role: CollectionRole;
+    }>;
+    total: number;
+}
+interface MyAccessResponse {
+    isMember: boolean;
+    role: CollectionRole | null;
+    canView: boolean;
+    canEdit: boolean;
+    canInvite: boolean;
+    canManageMembers: boolean;
+    canDelete: boolean;
+}
+interface RootResponse {
+    rootPi: string;
+}
+interface ChangeRootResponse {
+    previousRoot: string | null;
+    newRoot: string;
+}
+interface SuccessResponse {
+    success: boolean;
+}
+interface PiPermissions {
+    pi: string;
+    canView: boolean;
+    canEdit: boolean;
+    canAdminister: boolean;
+    collection: {
+        id: string;
+        title: string;
+        slug: string;
+        visibility: CollectionVisibility;
+        role: CollectionRole | null;
+        rootPi: string;
+        hops: number;
+    } | null;
+}
+
+interface CollectionsClientConfig {
+    /**
+     * Gateway base URL (e.g., https://api.arke.institute).
+     * Must already point at the Arke gateway that proxies /collections/*.
+     */
+    gatewayUrl: string;
+    /**
+     * Optional bearer token for authenticated routes.
+     * Public routes will still include it if provided.
+     */
+    authToken?: string;
+    /**
+     * Optional custom fetch (useful for testing).
+     */
+    fetchImpl?: typeof fetch;
+}
+declare class CollectionsClient {
+    private baseUrl;
+    private authToken?;
+    private fetchImpl;
+    constructor(config: CollectionsClientConfig);
+    setAuthToken(token?: string): void;
+    private buildUrl;
+    private getHeaders;
+    private request;
+    listCollections(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<PaginatedCollections>;
+    getCollection(id: string): Promise<CollectionDetails>;
+    getCollectionRoot(id: string): Promise<RootResponse>;
+    getMyAccess(id: string): Promise<MyAccessResponse>;
+    createCollection(payload: CreateCollectionPayload): Promise<Collection>;
+    registerRoot(payload: RegisterRootPayload): Promise<Collection & {
+        rootPi: string;
+    }>;
+    updateCollection(id: string, payload: UpdateCollectionPayload): Promise<Collection>;
+    changeRoot(id: string, payload: ChangeRootPayload): Promise<ChangeRootResponse>;
+    deleteCollection(id: string): Promise<SuccessResponse>;
+    listMembers(collectionId: string): Promise<MembersResponse>;
+    updateMemberRole(collectionId: string, userId: string, role: CollectionRole): Promise<{
+        success: true;
+        role: CollectionRole;
+    }>;
+    removeMember(collectionId: string, userId: string): Promise<SuccessResponse>;
+    createInvitation(collectionId: string, email: string, role: CollectionRole): Promise<Invitation>;
+    listInvitations(collectionId: string): Promise<InvitationsResponse>;
+    acceptInvitation(invitationId: string): Promise<{
+        success: true;
+        role: CollectionRole;
+    }>;
+    declineInvitation(invitationId: string): Promise<SuccessResponse>;
+    revokeInvitation(invitationId: string): Promise<SuccessResponse>;
+    getMyCollections(): Promise<MyCollectionsResponse>;
+    getMyInvitations(): Promise<InvitationsResponse>;
+    getPiPermissions(pi: string): Promise<PiPermissions>;
+}
+
+declare class CollectionsError extends Error {
+    code: string;
+    details?: unknown | undefined;
+    constructor(message: string, code?: string, details?: unknown | undefined);
+}
+
+export { type ChangeRootPayload, type ChangeRootResponse, type Collection, type CollectionDetails, type CollectionRole, type CollectionVisibility, CollectionsClient, type CollectionsClientConfig, CollectionsError, type CreateCollectionPayload, type Invitation, type InvitationUser, type InvitationsResponse, type Member, type MemberUser, type MembersResponse, type MyAccessResponse, type MyCollectionsResponse, type PaginatedCollections, type PiPermissions, type RegisterRootPayload, type RootResponse, type SuccessResponse, type UpdateCollectionPayload };