@arke-institute/sdk 0.1.3 → 2.0.0

package/dist/collections/index.js.map

@@ -1 +0,0 @@
-{"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    const text = await response.text();\n    try {\n      body = JSON.parse(text);\n    } catch {\n      body = 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/content/index.cjs

@@ -1,591 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/content/index.ts
-var content_exports = {};
-__export(content_exports, {
-  ComponentNotFoundError: () => ComponentNotFoundError,
-  ContentClient: () => ContentClient,
-  ContentError: () => ContentError,
-  ContentNotFoundError: () => ContentNotFoundError,
-  EntityNotFoundError: () => EntityNotFoundError,
-  NetworkError: () => NetworkError,
-  VersionNotFoundError: () => VersionNotFoundError
-});
-module.exports = __toCommonJS(content_exports);
-
-// src/content/errors.ts
-var ContentError = class extends Error {
-  constructor(message, code = "CONTENT_ERROR", details) {
-    super(message);
-    this.code = code;
-    this.details = details;
-    this.name = "ContentError";
-  }
-};
-var EntityNotFoundError = class extends ContentError {
-  constructor(id) {
-    super(`Entity not found: ${id}`, "ENTITY_NOT_FOUND", { id });
-    this.name = "EntityNotFoundError";
-  }
-};
-var ContentNotFoundError = class extends ContentError {
-  constructor(cid) {
-    super(`Content not found: ${cid}`, "CONTENT_NOT_FOUND", { cid });
-    this.name = "ContentNotFoundError";
-  }
-};
-var ComponentNotFoundError = class extends ContentError {
-  constructor(id, componentName) {
-    super(
-      `Component '${componentName}' not found on entity ${id}`,
-      "COMPONENT_NOT_FOUND",
-      { id, componentName }
-    );
-    this.name = "ComponentNotFoundError";
-  }
-};
-var VersionNotFoundError = class extends ContentError {
-  constructor(id, selector) {
-    super(
-      `Version not found: ${selector} for entity ${id}`,
-      "VERSION_NOT_FOUND",
-      { id, selector }
-    );
-    this.name = "VersionNotFoundError";
-  }
-};
-var NetworkError = class extends ContentError {
-  constructor(message, statusCode) {
-    super(message, "NETWORK_ERROR", { statusCode });
-    this.statusCode = statusCode;
-    this.name = "NetworkError";
-  }
-};
-
-// src/content/client.ts
-var ContentClient = class {
-  constructor(config) {
-    this.baseUrl = config.gatewayUrl.replace(/\/$/, "");
-    this.fetchImpl = config.fetchImpl ?? fetch;
-  }
-  // ---------------------------------------------------------------------------
-  // 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();
-  }
-  async request(path, options = {}) {
-    const url = this.buildUrl(path, options.query);
-    const headers = new Headers({ "Content-Type": "application/json" });
-    if (options.headers) {
-      Object.entries(options.headers).forEach(([k, v]) => {
-        if (v !== void 0) headers.set(k, v);
-      });
-    }
-    let response;
-    try {
-      response = await this.fetchImpl(url, { ...options, headers });
-    } catch (err) {
-      throw new NetworkError(
-        err instanceof Error ? err.message : "Network request failed"
-      );
-    }
-    if (response.ok) {
-      const contentType = response.headers.get("content-type") || "";
-      if (contentType.includes("application/json")) {
-        return await response.json();
-      }
-      return await response.text();
-    }
-    let body;
-    const text = await response.text();
-    try {
-      body = JSON.parse(text);
-    } catch {
-      body = text;
-    }
-    if (response.status === 404) {
-      const errorCode = body?.error;
-      if (errorCode === "NOT_FOUND" || errorCode === "ENTITY_NOT_FOUND") {
-        throw new ContentError(
-          body?.message || "Not found",
-          "NOT_FOUND",
-          body
-        );
-      }
-    }
-    const message = body?.error && typeof body.error === "string" ? body.error : body?.message && typeof body.message === "string" ? body.message : `Request failed with status ${response.status}`;
-    throw new ContentError(message, "HTTP_ERROR", {
-      status: response.status,
-      body
-    });
-  }
-  // ---------------------------------------------------------------------------
-  // Entity Operations
-  // ---------------------------------------------------------------------------
-  /**
-   * Get an entity by its Persistent Identifier (PI).
-   *
-   * @param pi - Persistent Identifier (ULID or test PI with II prefix)
-   * @returns Full entity manifest
-   * @throws EntityNotFoundError if the entity doesn't exist
-   *
-   * @example
-   * ```typescript
-   * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');
-   * console.log('Version:', entity.ver);
-   * console.log('Components:', Object.keys(entity.components));
-   * ```
-   */
-  async get(pi) {
-    try {
-      return await this.request(`/api/entities/${encodeURIComponent(pi)}`);
-    } catch (err) {
-      if (err instanceof ContentError && err.code === "NOT_FOUND") {
-        throw new EntityNotFoundError(pi);
-      }
-      throw err;
-    }
-  }
-  /**
-   * List entities with pagination.
-   *
-   * @param options - Pagination and metadata options
-   * @returns Paginated list of entity summaries
-   *
-   * @example
-   * ```typescript
-   * // Get first page
-   * const page1 = await content.list({ limit: 20, include_metadata: true });
-   *
-   * // Get next page
-   * if (page1.next_cursor) {
-   *   const page2 = await content.list({ cursor: page1.next_cursor });
-   * }
-   * ```
-   */
-  async list(options = {}) {
-    return this.request("/api/entities", {
-      query: {
-        limit: options.limit,
-        cursor: options.cursor,
-        include_metadata: options.include_metadata
-      }
-    });
-  }
-  /**
-   * Get version history for an entity.
-   *
-   * @param pi - Persistent Identifier
-   * @param options - Pagination options
-   * @returns Version history (newest first)
-   *
-   * @example
-   * ```typescript
-   * const history = await content.versions('01K75HQQXNTDG7BBP7PS9AWYAN');
-   * console.log('Total versions:', history.items.length);
-   * history.items.forEach(v => {
-   *   console.log(`v${v.ver}: ${v.ts} - ${v.note || 'no note'}`);
-   * });
-   * ```
-   */
-  async versions(pi, options = {}) {
-    try {
-      return await this.request(
-        `/api/entities/${encodeURIComponent(pi)}/versions`,
-        {
-          query: {
-            limit: options.limit,
-            cursor: options.cursor
-          }
-        }
-      );
-    } catch (err) {
-      if (err instanceof ContentError && err.code === "NOT_FOUND") {
-        throw new EntityNotFoundError(pi);
-      }
-      throw err;
-    }
-  }
-  /**
-   * Get a specific version of an entity.
-   *
-   * @param pi - Persistent Identifier
-   * @param selector - Version selector: 'ver:N' for version number or 'cid:...' for CID
-   * @returns Entity manifest for the specified version
-   *
-   * @example
-   * ```typescript
-   * // Get version 2
-   * const v2 = await content.getVersion('01K75HQQXNTDG7BBP7PS9AWYAN', 'ver:2');
-   *
-   * // Get by CID
-   * const vByCid = await content.getVersion('01K75HQQXNTDG7BBP7PS9AWYAN', 'cid:bafybeih...');
-   * ```
-   */
-  async getVersion(pi, selector) {
-    try {
-      return await this.request(
-        `/api/entities/${encodeURIComponent(pi)}/versions/${encodeURIComponent(selector)}`
-      );
-    } catch (err) {
-      if (err instanceof ContentError && err.code === "NOT_FOUND") {
-        throw new EntityNotFoundError(pi);
-      }
-      throw err;
-    }
-  }
-  /**
-   * Resolve a PI to its tip CID (fast lookup without fetching manifest).
-   *
-   * @param pi - Persistent Identifier
-   * @returns PI and tip CID
-   *
-   * @example
-   * ```typescript
-   * const { tip } = await content.resolve('01K75HQQXNTDG7BBP7PS9AWYAN');
-   * console.log('Latest manifest CID:', tip);
-   * ```
-   */
-  async resolve(pi) {
-    try {
-      return await this.request(`/api/resolve/${encodeURIComponent(pi)}`);
-    } catch (err) {
-      if (err instanceof ContentError && err.code === "NOT_FOUND") {
-        throw new EntityNotFoundError(pi);
-      }
-      throw err;
-    }
-  }
-  /**
-   * Get the list of child PIs for an entity (fast, returns only PIs).
-   *
-   * @param pi - Persistent Identifier of parent entity
-   * @returns Array of child PIs
-   *
-   * @example
-   * ```typescript
-   * const childPis = await content.children('01K75HQQXNTDG7BBP7PS9AWYAN');
-   * console.log('Children:', childPis);
-   * ```
-   */
-  async children(pi) {
-    const entity = await this.get(pi);
-    return entity.children_pi || [];
-  }
-  /**
-   * Get all child entities for a parent (fetches full entity for each child).
-   *
-   * @param pi - Persistent Identifier of parent entity
-   * @returns Array of child entities
-   *
-   * @example
-   * ```typescript
-   * const childEntities = await content.childrenEntities('01K75HQQXNTDG7BBP7PS9AWYAN');
-   * childEntities.forEach(child => {
-   *   console.log(`${child.pi}: v${child.ver}`);
-   * });
-   * ```
-   */
-  async childrenEntities(pi) {
-    const childPis = await this.children(pi);
-    if (childPis.length === 0) {
-      return [];
-    }
-    const results = await Promise.allSettled(
-      childPis.map((childPi) => this.get(childPi))
-    );
-    return results.filter((r) => r.status === "fulfilled").map((r) => r.value);
-  }
-  /**
-   * Get the Arke origin block (root of the archive tree).
-   *
-   * @returns Arke origin entity
-   *
-   * @example
-   * ```typescript
-   * const origin = await content.arke();
-   * console.log('Arke origin:', origin.pi);
-   * ```
-   */
-  async arke() {
-    return this.request("/api/arke");
-  }
-  // ---------------------------------------------------------------------------
-  // Content Download
-  // ---------------------------------------------------------------------------
-  /**
-   * Download content by CID.
-   *
-   * Returns Blob in browser environments, Buffer in Node.js.
-   *
-   * @param cid - Content Identifier
-   * @returns Content as Blob (browser) or Buffer (Node)
-   * @throws ContentNotFoundError if the content doesn't exist
-   *
-   * @example
-   * ```typescript
-   * const content = await client.download('bafybeih...');
-   *
-   * // In browser
-   * const url = URL.createObjectURL(content as Blob);
-   *
-   * // In Node.js
-   * fs.writeFileSync('output.bin', content as Buffer);
-   * ```
-   */
-  async download(cid) {
-    const url = this.buildUrl(`/api/cat/${encodeURIComponent(cid)}`);
-    let response;
-    try {
-      response = await this.fetchImpl(url);
-    } catch (err) {
-      throw new NetworkError(
-        err instanceof Error ? err.message : "Network request failed"
-      );
-    }
-    if (!response.ok) {
-      if (response.status === 404) {
-        throw new ContentNotFoundError(cid);
-      }
-      throw new ContentError(
-        `Failed to download content: ${response.status}`,
-        "DOWNLOAD_ERROR",
-        { status: response.status }
-      );
-    }
-    if (typeof window !== "undefined") {
-      return response.blob();
-    } else {
-      const arrayBuffer = await response.arrayBuffer();
-      return Buffer.from(arrayBuffer);
-    }
-  }
-  /**
-   * Get a direct URL for content by CID.
-   *
-   * This is useful for embedding in img tags or for direct downloads.
-   *
-   * @param cid - Content Identifier
-   * @returns URL string
-   *
-   * @example
-   * ```typescript
-   * const url = content.getUrl('bafybeih...');
-   * // Use in img tag: <img src={url} />
-   * ```
-   */
-  getUrl(cid) {
-    return `${this.baseUrl}/api/cat/${encodeURIComponent(cid)}`;
-  }
-  /**
-   * Stream content by CID.
-   *
-   * @param cid - Content Identifier
-   * @returns ReadableStream of the content
-   * @throws ContentNotFoundError if the content doesn't exist
-   *
-   * @example
-   * ```typescript
-   * const stream = await content.stream('bafybeih...');
-   * const reader = stream.getReader();
-   * while (true) {
-   *   const { done, value } = await reader.read();
-   *   if (done) break;
-   *   // Process chunk
-   * }
-   * ```
-   */
-  async stream(cid) {
-    const url = this.buildUrl(`/api/cat/${encodeURIComponent(cid)}`);
-    let response;
-    try {
-      response = await this.fetchImpl(url);
-    } catch (err) {
-      throw new NetworkError(
-        err instanceof Error ? err.message : "Network request failed"
-      );
-    }
-    if (!response.ok) {
-      if (response.status === 404) {
-        throw new ContentNotFoundError(cid);
-      }
-      throw new ContentError(
-        `Failed to stream content: ${response.status}`,
-        "STREAM_ERROR",
-        { status: response.status }
-      );
-    }
-    if (!response.body) {
-      throw new ContentError("Response body is not available", "STREAM_ERROR");
-    }
-    return response.body;
-  }
-  /**
-   * Download a DAG node (JSON) by CID.
-   *
-   * Use this to fetch JSON components like properties and relationships.
-   *
-   * @param cid - Content Identifier of the DAG node
-   * @returns Parsed JSON object
-   * @throws ContentNotFoundError if the content doesn't exist
-   *
-   * @example
-   * ```typescript
-   * const relationships = await content.getDag<RelationshipsComponent>(
-   *   entity.components.relationships
-   * );
-   * console.log('Relationships:', relationships.relationships);
-   * ```
-   */
-  async getDag(cid) {
-    const url = this.buildUrl(`/api/dag/${encodeURIComponent(cid)}`);
-    let response;
-    try {
-      response = await this.fetchImpl(url);
-    } catch (err) {
-      throw new NetworkError(
-        err instanceof Error ? err.message : "Network request failed"
-      );
-    }
-    if (!response.ok) {
-      if (response.status === 404) {
-        throw new ContentNotFoundError(cid);
-      }
-      throw new ContentError(
-        `Failed to fetch DAG node: ${response.status}`,
-        "DAG_ERROR",
-        { status: response.status }
-      );
-    }
-    return await response.json();
-  }
-  // ---------------------------------------------------------------------------
-  // Component Helpers
-  // ---------------------------------------------------------------------------
-  /**
-   * Download a component from an entity.
-   *
-   * @param entity - Entity containing the component
-   * @param componentName - Name of the component (e.g., 'pinax', 'description', 'source')
-   * @returns Component content as Blob (browser) or Buffer (Node)
-   * @throws ComponentNotFoundError if the component doesn't exist
-   *
-   * @example
-   * ```typescript
-   * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');
-   * const pinax = await content.getComponent(entity, 'pinax');
-   * ```
-   */
-  async getComponent(entity, componentName) {
-    const cid = entity.components[componentName];
-    if (!cid) {
-      throw new ComponentNotFoundError(entity.id, componentName);
-    }
-    return this.download(cid);
-  }
-  /**
-   * Get the URL for a component from an entity.
-   *
-   * @param entity - Entity containing the component
-   * @param componentName - Name of the component
-   * @returns URL string
-   * @throws ComponentNotFoundError if the component doesn't exist
-   *
-   * @example
-   * ```typescript
-   * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');
-   * const imageUrl = content.getComponentUrl(entity, 'source');
-   * // Use in img tag: <img src={imageUrl} />
-   * ```
-   */
-  getComponentUrl(entity, componentName) {
-    const cid = entity.components[componentName];
-    if (!cid) {
-      throw new ComponentNotFoundError(entity.id, componentName);
-    }
-    return this.getUrl(cid);
-  }
-  /**
-   * Get the properties component for an entity.
-   *
-   * @param entity - Entity containing the properties component
-   * @returns Properties object, or null if no properties component exists
-   *
-   * @example
-   * ```typescript
-   * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');
-   * const props = await content.getProperties(entity);
-   * if (props) {
-   *   console.log('Title:', props.title);
-   * }
-   * ```
-   */
-  async getProperties(entity) {
-    const cid = entity.components.properties;
-    if (!cid) {
-      return null;
-    }
-    return this.getDag(cid);
-  }
-  /**
-   * Get the relationships component for an entity.
-   *
-   * @param entity - Entity containing the relationships component
-   * @returns Relationships component, or null if no relationships exist
-   *
-   * @example
-   * ```typescript
-   * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');
-   * const rels = await content.getRelationships(entity);
-   * if (rels) {
-   *   rels.relationships.forEach(r => {
-   *     console.log(`${r.predicate} -> ${r.target_label}`);
-   *   });
-   * }
-   * ```
-   */
-  async getRelationships(entity) {
-    const cid = entity.components.relationships;
-    if (!cid) {
-      return null;
-    }
-    return this.getDag(cid);
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ComponentNotFoundError,
-  ContentClient,
-  ContentError,
-  ContentNotFoundError,
-  EntityNotFoundError,
-  NetworkError,
-  VersionNotFoundError
-});
-//# sourceMappingURL=index.cjs.map