@arke-institute/sdk 0.1.2 → 0.1.3

package/dist/content/index.cjs

@@ -40,8 +40,8 @@ var ContentError = class extends Error {
   }
 };
 var EntityNotFoundError = class extends ContentError {
-  constructor(pi) {
-    super(`Entity not found: ${pi}`, "ENTITY_NOT_FOUND", { pi });
+  constructor(id) {
+    super(`Entity not found: ${id}`, "ENTITY_NOT_FOUND", { id });
     this.name = "EntityNotFoundError";
   }
 };
@@ -52,21 +52,21 @@ var ContentNotFoundError = class extends ContentError {
   }
 };
 var ComponentNotFoundError = class extends ContentError {
-  constructor(pi, componentName) {
+  constructor(id, componentName) {
     super(
-      `Component '${componentName}' not found on entity ${pi}`,
+      `Component '${componentName}' not found on entity ${id}`,
       "COMPONENT_NOT_FOUND",
-      { pi, componentName }
+      { id, componentName }
     );
     this.name = "ComponentNotFoundError";
   }
 };
 var VersionNotFoundError = class extends ContentError {
-  constructor(pi, selector) {
+  constructor(id, selector) {
     super(
-      `Version not found: ${selector} for entity ${pi}`,
+      `Version not found: ${selector} for entity ${id}`,
       "VERSION_NOT_FOUND",
-      { pi, selector }
+      { id, selector }
     );
     this.name = "VersionNotFoundError";
   }
@@ -446,6 +446,45 @@ var ContentClient = class {
     }
     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
   // ---------------------------------------------------------------------------
@@ -466,7 +505,7 @@ var ContentClient = class {
   async getComponent(entity, componentName) {
     const cid = entity.components[componentName];
     if (!cid) {
-      throw new ComponentNotFoundError(entity.pi, componentName);
+      throw new ComponentNotFoundError(entity.id, componentName);
     }
     return this.download(cid);
   }
@@ -488,10 +527,56 @@ var ContentClient = class {
   getComponentUrl(entity, componentName) {
     const cid = entity.components[componentName];
     if (!cid) {
-      throw new ComponentNotFoundError(entity.pi, componentName);
+      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 = {

package/dist/content/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/content/index.ts","../../src/content/errors.ts","../../src/content/client.ts"],"sourcesContent":["/**\n * Content package for the Arke SDK\n *\n * Provides read-only access to entities and content from the IPFS Wrapper service.\n *\n * @example\n * ```typescript\n * import { ContentClient } from '@arke-institute/sdk/content';\n *\n * const content = new ContentClient({\n *   gatewayUrl: 'https://gateway.arke.institute',\n * });\n *\n * // Get an entity\n * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');\n *\n * // List entities\n * const { entities, next_cursor } = await content.list({ limit: 20 });\n *\n * // Download content\n * const blob = await content.download(entity.components.source);\n * ```\n */\n\nexport { ContentClient, type ContentClientConfig } from './client.js';\nexport * from './types.js';\nexport * from './errors.js';\n","/**\n * Content package error classes for the Arke SDK\n */\n\n/**\n * Base error class for content operations\n */\nexport class ContentError extends Error {\n  constructor(\n    message: string,\n    public code: string = 'CONTENT_ERROR',\n    public details?: unknown\n  ) {\n    super(message);\n    this.name = 'ContentError';\n  }\n}\n\n/**\n * Thrown when an entity is not found by PI\n */\nexport class EntityNotFoundError extends ContentError {\n  constructor(pi: string) {\n    super(`Entity not found: ${pi}`, 'ENTITY_NOT_FOUND', { pi });\n    this.name = 'EntityNotFoundError';\n  }\n}\n\n/**\n * Thrown when content is not found by CID\n */\nexport class ContentNotFoundError extends ContentError {\n  constructor(cid: string) {\n    super(`Content not found: ${cid}`, 'CONTENT_NOT_FOUND', { cid });\n    this.name = 'ContentNotFoundError';\n  }\n}\n\n/**\n * Thrown when a component is not found on an entity\n */\nexport class ComponentNotFoundError extends ContentError {\n  constructor(pi: string, componentName: string) {\n    super(\n      `Component '${componentName}' not found on entity ${pi}`,\n      'COMPONENT_NOT_FOUND',\n      { pi, componentName }\n    );\n    this.name = 'ComponentNotFoundError';\n  }\n}\n\n/**\n * Thrown when a version is not found\n */\nexport class VersionNotFoundError extends ContentError {\n  constructor(pi: string, selector: string) {\n    super(\n      `Version not found: ${selector} for entity ${pi}`,\n      'VERSION_NOT_FOUND',\n      { pi, selector }\n    );\n    this.name = 'VersionNotFoundError';\n  }\n}\n\n/**\n * Thrown when a network error occurs\n */\nexport class NetworkError extends ContentError {\n  constructor(message: string, public statusCode?: number) {\n    super(message, 'NETWORK_ERROR', { statusCode });\n    this.name = 'NetworkError';\n  }\n}\n","import {\n  ContentError,\n  EntityNotFoundError,\n  ContentNotFoundError,\n  ComponentNotFoundError,\n  NetworkError,\n} from './errors.js';\nimport type {\n  Entity,\n  EntityVersion,\n  ListOptions,\n  ListResponse,\n  VersionsOptions,\n  VersionsResponse,\n  ResolveResponse,\n} from './types.js';\n\n/**\n * Configuration for ContentClient\n */\nexport interface ContentClientConfig {\n  /**\n   * Gateway base URL (e.g., https://gateway.arke.institute).\n   * The client will call /api/* endpoints for IPFS Wrapper.\n   */\n  gatewayUrl: string;\n  /**\n   * Optional custom fetch implementation (useful for testing).\n   */\n  fetchImpl?: typeof fetch;\n}\n\ntype JsonBody = Record<string, unknown>;\n\n/**\n * Client for accessing entities and content from the Arke archive.\n *\n * All endpoints are public and do not require authentication.\n *\n * @example\n * ```typescript\n * const content = new ContentClient({\n *   gatewayUrl: 'https://gateway.arke.institute',\n * });\n *\n * // Get an entity\n * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');\n *\n * // Download content by CID\n * const blob = await content.download('bafybeihkoviema7g3gxyt6la7vd5ho32jywf7b4c4z3qtwcabpjqxwsumu');\n *\n * // Get component content\n * const pinax = await content.getComponent(entity, 'pinax');\n * ```\n */\nexport class ContentClient {\n  private baseUrl: string;\n  private fetchImpl: typeof fetch;\n\n  constructor(config: ContentClientConfig) {\n    this.baseUrl = config.gatewayUrl.replace(/\\/$/, '');\n    this.fetchImpl = config.fetchImpl ?? fetch;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Request helpers\n  // ---------------------------------------------------------------------------\n\n  private buildUrl(path: string, query?: Record<string, string | number | boolean | 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 async request<T>(\n    path: string,\n    options: RequestInit & {\n      query?: Record<string, string | number | boolean | undefined>;\n    } = {}\n  ): Promise<T> {\n    const url = this.buildUrl(path, options.query);\n    const headers = new Headers({ 'Content-Type': 'application/json' });\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    let response: Response;\n    try {\n      response = await this.fetchImpl(url, { ...options, headers });\n    } catch (err) {\n      throw new NetworkError(\n        err instanceof Error ? err.message : 'Network request failed'\n      );\n    }\n\n    if (response.ok) {\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    // Handle 404 specifically\n    if (response.status === 404) {\n      const errorCode = (body as JsonBody)?.error;\n      if (errorCode === 'NOT_FOUND' || errorCode === 'ENTITY_NOT_FOUND') {\n        throw new ContentError(\n          (body as JsonBody)?.message as string || 'Not found',\n          'NOT_FOUND',\n          body\n        );\n      }\n    }\n\n    const message =\n      (body as JsonBody)?.error && typeof (body as JsonBody).error === 'string'\n        ? ((body as JsonBody).error as string)\n        : (body as JsonBody)?.message && typeof (body as JsonBody).message === 'string'\n          ? ((body as JsonBody).message as string)\n          : `Request failed with status ${response.status}`;\n\n    throw new ContentError(message, 'HTTP_ERROR', {\n      status: response.status,\n      body,\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Entity Operations\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Get an entity by its Persistent Identifier (PI).\n   *\n   * @param pi - Persistent Identifier (ULID or test PI with II prefix)\n   * @returns Full entity manifest\n   * @throws EntityNotFoundError if the entity doesn't exist\n   *\n   * @example\n   * ```typescript\n   * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');\n   * console.log('Version:', entity.ver);\n   * console.log('Components:', Object.keys(entity.components));\n   * ```\n   */\n  async get(pi: string): Promise<Entity> {\n    try {\n      return await this.request<Entity>(`/api/entities/${encodeURIComponent(pi)}`);\n    } catch (err) {\n      if (err instanceof ContentError && err.code === 'NOT_FOUND') {\n        throw new EntityNotFoundError(pi);\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * List entities with pagination.\n   *\n   * @param options - Pagination and metadata options\n   * @returns Paginated list of entity summaries\n   *\n   * @example\n   * ```typescript\n   * // Get first page\n   * const page1 = await content.list({ limit: 20, include_metadata: true });\n   *\n   * // Get next page\n   * if (page1.next_cursor) {\n   *   const page2 = await content.list({ cursor: page1.next_cursor });\n   * }\n   * ```\n   */\n  async list(options: ListOptions = {}): Promise<ListResponse> {\n    return this.request<ListResponse>('/api/entities', {\n      query: {\n        limit: options.limit,\n        cursor: options.cursor,\n        include_metadata: options.include_metadata,\n      },\n    });\n  }\n\n  /**\n   * Get version history for an entity.\n   *\n   * @param pi - Persistent Identifier\n   * @param options - Pagination options\n   * @returns Version history (newest first)\n   *\n   * @example\n   * ```typescript\n   * const history = await content.versions('01K75HQQXNTDG7BBP7PS9AWYAN');\n   * console.log('Total versions:', history.items.length);\n   * history.items.forEach(v => {\n   *   console.log(`v${v.ver}: ${v.ts} - ${v.note || 'no note'}`);\n   * });\n   * ```\n   */\n  async versions(pi: string, options: VersionsOptions = {}): Promise<VersionsResponse> {\n    try {\n      return await this.request<VersionsResponse>(\n        `/api/entities/${encodeURIComponent(pi)}/versions`,\n        {\n          query: {\n            limit: options.limit,\n            cursor: options.cursor,\n          },\n        }\n      );\n    } catch (err) {\n      if (err instanceof ContentError && err.code === 'NOT_FOUND') {\n        throw new EntityNotFoundError(pi);\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * Get a specific version of an entity.\n   *\n   * @param pi - Persistent Identifier\n   * @param selector - Version selector: 'ver:N' for version number or 'cid:...' for CID\n   * @returns Entity manifest for the specified version\n   *\n   * @example\n   * ```typescript\n   * // Get version 2\n   * const v2 = await content.getVersion('01K75HQQXNTDG7BBP7PS9AWYAN', 'ver:2');\n   *\n   * // Get by CID\n   * const vByCid = await content.getVersion('01K75HQQXNTDG7BBP7PS9AWYAN', 'cid:bafybeih...');\n   * ```\n   */\n  async getVersion(pi: string, selector: string): Promise<Entity> {\n    try {\n      return await this.request<Entity>(\n        `/api/entities/${encodeURIComponent(pi)}/versions/${encodeURIComponent(selector)}`\n      );\n    } catch (err) {\n      if (err instanceof ContentError && err.code === 'NOT_FOUND') {\n        throw new EntityNotFoundError(pi);\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * Resolve a PI to its tip CID (fast lookup without fetching manifest).\n   *\n   * @param pi - Persistent Identifier\n   * @returns PI and tip CID\n   *\n   * @example\n   * ```typescript\n   * const { tip } = await content.resolve('01K75HQQXNTDG7BBP7PS9AWYAN');\n   * console.log('Latest manifest CID:', tip);\n   * ```\n   */\n  async resolve(pi: string): Promise<ResolveResponse> {\n    try {\n      return await this.request<ResolveResponse>(`/api/resolve/${encodeURIComponent(pi)}`);\n    } catch (err) {\n      if (err instanceof ContentError && err.code === 'NOT_FOUND') {\n        throw new EntityNotFoundError(pi);\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * Get the list of child PIs for an entity (fast, returns only PIs).\n   *\n   * @param pi - Persistent Identifier of parent entity\n   * @returns Array of child PIs\n   *\n   * @example\n   * ```typescript\n   * const childPis = await content.children('01K75HQQXNTDG7BBP7PS9AWYAN');\n   * console.log('Children:', childPis);\n   * ```\n   */\n  async children(pi: string): Promise<string[]> {\n    const entity = await this.get(pi);\n    return entity.children_pi || [];\n  }\n\n  /**\n   * Get all child entities for a parent (fetches full entity for each child).\n   *\n   * @param pi - Persistent Identifier of parent entity\n   * @returns Array of child entities\n   *\n   * @example\n   * ```typescript\n   * const childEntities = await content.childrenEntities('01K75HQQXNTDG7BBP7PS9AWYAN');\n   * childEntities.forEach(child => {\n   *   console.log(`${child.pi}: v${child.ver}`);\n   * });\n   * ```\n   */\n  async childrenEntities(pi: string): Promise<Entity[]> {\n    const childPis = await this.children(pi);\n    if (childPis.length === 0) {\n      return [];\n    }\n\n    // Fetch all children in parallel\n    const results = await Promise.allSettled(\n      childPis.map(childPi => this.get(childPi))\n    );\n\n    // Return only successful fetches\n    return results\n      .filter((r): r is PromiseFulfilledResult<Entity> => r.status === 'fulfilled')\n      .map(r => r.value);\n  }\n\n  /**\n   * Get the Arke origin block (root of the archive tree).\n   *\n   * @returns Arke origin entity\n   *\n   * @example\n   * ```typescript\n   * const origin = await content.arke();\n   * console.log('Arke origin:', origin.pi);\n   * ```\n   */\n  async arke(): Promise<Entity> {\n    return this.request<Entity>('/api/arke');\n  }\n\n  // ---------------------------------------------------------------------------\n  // Content Download\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Download content by CID.\n   *\n   * Returns Blob in browser environments, Buffer in Node.js.\n   *\n   * @param cid - Content Identifier\n   * @returns Content as Blob (browser) or Buffer (Node)\n   * @throws ContentNotFoundError if the content doesn't exist\n   *\n   * @example\n   * ```typescript\n   * const content = await client.download('bafybeih...');\n   *\n   * // In browser\n   * const url = URL.createObjectURL(content as Blob);\n   *\n   * // In Node.js\n   * fs.writeFileSync('output.bin', content as Buffer);\n   * ```\n   */\n  async download(cid: string): Promise<Blob | Buffer> {\n    const url = this.buildUrl(`/api/cat/${encodeURIComponent(cid)}`);\n\n    let response: Response;\n    try {\n      response = await this.fetchImpl(url);\n    } catch (err) {\n      throw new NetworkError(\n        err instanceof Error ? err.message : 'Network request failed'\n      );\n    }\n\n    if (!response.ok) {\n      if (response.status === 404) {\n        throw new ContentNotFoundError(cid);\n      }\n      throw new ContentError(\n        `Failed to download content: ${response.status}`,\n        'DOWNLOAD_ERROR',\n        { status: response.status }\n      );\n    }\n\n    // Platform-aware response handling\n    if (typeof window !== 'undefined') {\n      // Browser environment\n      return response.blob();\n    } else {\n      // Node.js environment\n      const arrayBuffer = await response.arrayBuffer();\n      return Buffer.from(arrayBuffer);\n    }\n  }\n\n  /**\n   * Get a direct URL for content by CID.\n   *\n   * This is useful for embedding in img tags or for direct downloads.\n   *\n   * @param cid - Content Identifier\n   * @returns URL string\n   *\n   * @example\n   * ```typescript\n   * const url = content.getUrl('bafybeih...');\n   * // Use in img tag: <img src={url} />\n   * ```\n   */\n  getUrl(cid: string): string {\n    return `${this.baseUrl}/api/cat/${encodeURIComponent(cid)}`;\n  }\n\n  /**\n   * Stream content by CID.\n   *\n   * @param cid - Content Identifier\n   * @returns ReadableStream of the content\n   * @throws ContentNotFoundError if the content doesn't exist\n   *\n   * @example\n   * ```typescript\n   * const stream = await content.stream('bafybeih...');\n   * const reader = stream.getReader();\n   * while (true) {\n   *   const { done, value } = await reader.read();\n   *   if (done) break;\n   *   // Process chunk\n   * }\n   * ```\n   */\n  async stream(cid: string): Promise<ReadableStream<Uint8Array>> {\n    const url = this.buildUrl(`/api/cat/${encodeURIComponent(cid)}`);\n\n    let response: Response;\n    try {\n      response = await this.fetchImpl(url);\n    } catch (err) {\n      throw new NetworkError(\n        err instanceof Error ? err.message : 'Network request failed'\n      );\n    }\n\n    if (!response.ok) {\n      if (response.status === 404) {\n        throw new ContentNotFoundError(cid);\n      }\n      throw new ContentError(\n        `Failed to stream content: ${response.status}`,\n        'STREAM_ERROR',\n        { status: response.status }\n      );\n    }\n\n    if (!response.body) {\n      throw new ContentError('Response body is not available', 'STREAM_ERROR');\n    }\n\n    return response.body;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Component Helpers\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Download a component from an entity.\n   *\n   * @param entity - Entity containing the component\n   * @param componentName - Name of the component (e.g., 'pinax', 'description', 'source')\n   * @returns Component content as Blob (browser) or Buffer (Node)\n   * @throws ComponentNotFoundError if the component doesn't exist\n   *\n   * @example\n   * ```typescript\n   * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');\n   * const pinax = await content.getComponent(entity, 'pinax');\n   * ```\n   */\n  async getComponent(entity: Entity, componentName: string): Promise<Blob | Buffer> {\n    const cid = entity.components[componentName];\n    if (!cid) {\n      throw new ComponentNotFoundError(entity.pi, componentName);\n    }\n    return this.download(cid);\n  }\n\n  /**\n   * Get the URL for a component from an entity.\n   *\n   * @param entity - Entity containing the component\n   * @param componentName - Name of the component\n   * @returns URL string\n   * @throws ComponentNotFoundError if the component doesn't exist\n   *\n   * @example\n   * ```typescript\n   * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');\n   * const imageUrl = content.getComponentUrl(entity, 'source');\n   * // Use in img tag: <img src={imageUrl} />\n   * ```\n   */\n  getComponentUrl(entity: Entity, componentName: string): string {\n    const cid = entity.components[componentName];\n    if (!cid) {\n      throw new ComponentNotFoundError(entity.pi, componentName);\n    }\n    return this.getUrl(cid);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/content/index.ts","../../src/content/errors.ts","../../src/content/client.ts"],"sourcesContent":["/**\n * Content package for the Arke SDK\n *\n * Provides read-only access to entities and content from the IPFS Wrapper service.\n *\n * @example\n * ```typescript\n * import { ContentClient } from '@arke-institute/sdk/content';\n *\n * const content = new ContentClient({\n *   gatewayUrl: 'https://gateway.arke.institute',\n * });\n *\n * // Get an entity\n * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');\n *\n * // List entities\n * const { entities, next_cursor } = await content.list({ limit: 20 });\n *\n * // Download content\n * const blob = await content.download(entity.components.source);\n * ```\n */\n\nexport { ContentClient, type ContentClientConfig } from './client.js';\nexport * from './types.js';\nexport * from './errors.js';\n","/**\n * Content package error classes for the Arke SDK\n */\n\n/**\n * Base error class for content operations\n */\nexport class ContentError extends Error {\n  constructor(\n    message: string,\n    public code: string = 'CONTENT_ERROR',\n    public details?: unknown\n  ) {\n    super(message);\n    this.name = 'ContentError';\n  }\n}\n\n/**\n * Thrown when an entity is not found by ID\n */\nexport class EntityNotFoundError extends ContentError {\n  constructor(id: string) {\n    super(`Entity not found: ${id}`, 'ENTITY_NOT_FOUND', { id });\n    this.name = 'EntityNotFoundError';\n  }\n}\n\n/**\n * Thrown when content is not found by CID\n */\nexport class ContentNotFoundError extends ContentError {\n  constructor(cid: string) {\n    super(`Content not found: ${cid}`, 'CONTENT_NOT_FOUND', { cid });\n    this.name = 'ContentNotFoundError';\n  }\n}\n\n/**\n * Thrown when a component is not found on an entity\n */\nexport class ComponentNotFoundError extends ContentError {\n  constructor(id: string, componentName: string) {\n    super(\n      `Component '${componentName}' not found on entity ${id}`,\n      'COMPONENT_NOT_FOUND',\n      { id, componentName }\n    );\n    this.name = 'ComponentNotFoundError';\n  }\n}\n\n/**\n * Thrown when a version is not found\n */\nexport class VersionNotFoundError extends ContentError {\n  constructor(id: string, selector: string) {\n    super(\n      `Version not found: ${selector} for entity ${id}`,\n      'VERSION_NOT_FOUND',\n      { id, selector }\n    );\n    this.name = 'VersionNotFoundError';\n  }\n}\n\n/**\n * Thrown when a network error occurs\n */\nexport class NetworkError extends ContentError {\n  constructor(message: string, public statusCode?: number) {\n    super(message, 'NETWORK_ERROR', { statusCode });\n    this.name = 'NetworkError';\n  }\n}\n","import {\n  ContentError,\n  EntityNotFoundError,\n  ContentNotFoundError,\n  ComponentNotFoundError,\n  NetworkError,\n} from './errors.js';\nimport type {\n  Entity,\n  EntityVersion,\n  ListOptions,\n  ListResponse,\n  VersionsOptions,\n  VersionsResponse,\n  ResolveResponse,\n  RelationshipsComponent,\n  PropertiesComponent,\n} from './types.js';\n\n/**\n * Configuration for ContentClient\n */\nexport interface ContentClientConfig {\n  /**\n   * Gateway base URL (e.g., https://gateway.arke.institute).\n   * The client will call /api/* endpoints for IPFS Wrapper.\n   */\n  gatewayUrl: string;\n  /**\n   * Optional custom fetch implementation (useful for testing).\n   */\n  fetchImpl?: typeof fetch;\n}\n\ntype JsonBody = Record<string, unknown>;\n\n/**\n * Client for accessing entities and content from the Arke archive.\n *\n * All endpoints are public and do not require authentication.\n *\n * @example\n * ```typescript\n * const content = new ContentClient({\n *   gatewayUrl: 'https://gateway.arke.institute',\n * });\n *\n * // Get an entity\n * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');\n *\n * // Download content by CID\n * const blob = await content.download('bafybeihkoviema7g3gxyt6la7vd5ho32jywf7b4c4z3qtwcabpjqxwsumu');\n *\n * // Get component content\n * const pinax = await content.getComponent(entity, 'pinax');\n * ```\n */\nexport class ContentClient {\n  private baseUrl: string;\n  private fetchImpl: typeof fetch;\n\n  constructor(config: ContentClientConfig) {\n    this.baseUrl = config.gatewayUrl.replace(/\\/$/, '');\n    this.fetchImpl = config.fetchImpl ?? fetch;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Request helpers\n  // ---------------------------------------------------------------------------\n\n  private buildUrl(path: string, query?: Record<string, string | number | boolean | 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 async request<T>(\n    path: string,\n    options: RequestInit & {\n      query?: Record<string, string | number | boolean | undefined>;\n    } = {}\n  ): Promise<T> {\n    const url = this.buildUrl(path, options.query);\n    const headers = new Headers({ 'Content-Type': 'application/json' });\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    let response: Response;\n    try {\n      response = await this.fetchImpl(url, { ...options, headers });\n    } catch (err) {\n      throw new NetworkError(\n        err instanceof Error ? err.message : 'Network request failed'\n      );\n    }\n\n    if (response.ok) {\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    // Handle 404 specifically\n    if (response.status === 404) {\n      const errorCode = (body as JsonBody)?.error;\n      if (errorCode === 'NOT_FOUND' || errorCode === 'ENTITY_NOT_FOUND') {\n        throw new ContentError(\n          (body as JsonBody)?.message as string || 'Not found',\n          'NOT_FOUND',\n          body\n        );\n      }\n    }\n\n    const message =\n      (body as JsonBody)?.error && typeof (body as JsonBody).error === 'string'\n        ? ((body as JsonBody).error as string)\n        : (body as JsonBody)?.message && typeof (body as JsonBody).message === 'string'\n          ? ((body as JsonBody).message as string)\n          : `Request failed with status ${response.status}`;\n\n    throw new ContentError(message, 'HTTP_ERROR', {\n      status: response.status,\n      body,\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Entity Operations\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Get an entity by its Persistent Identifier (PI).\n   *\n   * @param pi - Persistent Identifier (ULID or test PI with II prefix)\n   * @returns Full entity manifest\n   * @throws EntityNotFoundError if the entity doesn't exist\n   *\n   * @example\n   * ```typescript\n   * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');\n   * console.log('Version:', entity.ver);\n   * console.log('Components:', Object.keys(entity.components));\n   * ```\n   */\n  async get(pi: string): Promise<Entity> {\n    try {\n      return await this.request<Entity>(`/api/entities/${encodeURIComponent(pi)}`);\n    } catch (err) {\n      if (err instanceof ContentError && err.code === 'NOT_FOUND') {\n        throw new EntityNotFoundError(pi);\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * List entities with pagination.\n   *\n   * @param options - Pagination and metadata options\n   * @returns Paginated list of entity summaries\n   *\n   * @example\n   * ```typescript\n   * // Get first page\n   * const page1 = await content.list({ limit: 20, include_metadata: true });\n   *\n   * // Get next page\n   * if (page1.next_cursor) {\n   *   const page2 = await content.list({ cursor: page1.next_cursor });\n   * }\n   * ```\n   */\n  async list(options: ListOptions = {}): Promise<ListResponse> {\n    return this.request<ListResponse>('/api/entities', {\n      query: {\n        limit: options.limit,\n        cursor: options.cursor,\n        include_metadata: options.include_metadata,\n      },\n    });\n  }\n\n  /**\n   * Get version history for an entity.\n   *\n   * @param pi - Persistent Identifier\n   * @param options - Pagination options\n   * @returns Version history (newest first)\n   *\n   * @example\n   * ```typescript\n   * const history = await content.versions('01K75HQQXNTDG7BBP7PS9AWYAN');\n   * console.log('Total versions:', history.items.length);\n   * history.items.forEach(v => {\n   *   console.log(`v${v.ver}: ${v.ts} - ${v.note || 'no note'}`);\n   * });\n   * ```\n   */\n  async versions(pi: string, options: VersionsOptions = {}): Promise<VersionsResponse> {\n    try {\n      return await this.request<VersionsResponse>(\n        `/api/entities/${encodeURIComponent(pi)}/versions`,\n        {\n          query: {\n            limit: options.limit,\n            cursor: options.cursor,\n          },\n        }\n      );\n    } catch (err) {\n      if (err instanceof ContentError && err.code === 'NOT_FOUND') {\n        throw new EntityNotFoundError(pi);\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * Get a specific version of an entity.\n   *\n   * @param pi - Persistent Identifier\n   * @param selector - Version selector: 'ver:N' for version number or 'cid:...' for CID\n   * @returns Entity manifest for the specified version\n   *\n   * @example\n   * ```typescript\n   * // Get version 2\n   * const v2 = await content.getVersion('01K75HQQXNTDG7BBP7PS9AWYAN', 'ver:2');\n   *\n   * // Get by CID\n   * const vByCid = await content.getVersion('01K75HQQXNTDG7BBP7PS9AWYAN', 'cid:bafybeih...');\n   * ```\n   */\n  async getVersion(pi: string, selector: string): Promise<Entity> {\n    try {\n      return await this.request<Entity>(\n        `/api/entities/${encodeURIComponent(pi)}/versions/${encodeURIComponent(selector)}`\n      );\n    } catch (err) {\n      if (err instanceof ContentError && err.code === 'NOT_FOUND') {\n        throw new EntityNotFoundError(pi);\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * Resolve a PI to its tip CID (fast lookup without fetching manifest).\n   *\n   * @param pi - Persistent Identifier\n   * @returns PI and tip CID\n   *\n   * @example\n   * ```typescript\n   * const { tip } = await content.resolve('01K75HQQXNTDG7BBP7PS9AWYAN');\n   * console.log('Latest manifest CID:', tip);\n   * ```\n   */\n  async resolve(pi: string): Promise<ResolveResponse> {\n    try {\n      return await this.request<ResolveResponse>(`/api/resolve/${encodeURIComponent(pi)}`);\n    } catch (err) {\n      if (err instanceof ContentError && err.code === 'NOT_FOUND') {\n        throw new EntityNotFoundError(pi);\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * Get the list of child PIs for an entity (fast, returns only PIs).\n   *\n   * @param pi - Persistent Identifier of parent entity\n   * @returns Array of child PIs\n   *\n   * @example\n   * ```typescript\n   * const childPis = await content.children('01K75HQQXNTDG7BBP7PS9AWYAN');\n   * console.log('Children:', childPis);\n   * ```\n   */\n  async children(pi: string): Promise<string[]> {\n    const entity = await this.get(pi);\n    return entity.children_pi || [];\n  }\n\n  /**\n   * Get all child entities for a parent (fetches full entity for each child).\n   *\n   * @param pi - Persistent Identifier of parent entity\n   * @returns Array of child entities\n   *\n   * @example\n   * ```typescript\n   * const childEntities = await content.childrenEntities('01K75HQQXNTDG7BBP7PS9AWYAN');\n   * childEntities.forEach(child => {\n   *   console.log(`${child.pi}: v${child.ver}`);\n   * });\n   * ```\n   */\n  async childrenEntities(pi: string): Promise<Entity[]> {\n    const childPis = await this.children(pi);\n    if (childPis.length === 0) {\n      return [];\n    }\n\n    // Fetch all children in parallel\n    const results = await Promise.allSettled(\n      childPis.map(childPi => this.get(childPi))\n    );\n\n    // Return only successful fetches\n    return results\n      .filter((r): r is PromiseFulfilledResult<Entity> => r.status === 'fulfilled')\n      .map(r => r.value);\n  }\n\n  /**\n   * Get the Arke origin block (root of the archive tree).\n   *\n   * @returns Arke origin entity\n   *\n   * @example\n   * ```typescript\n   * const origin = await content.arke();\n   * console.log('Arke origin:', origin.pi);\n   * ```\n   */\n  async arke(): Promise<Entity> {\n    return this.request<Entity>('/api/arke');\n  }\n\n  // ---------------------------------------------------------------------------\n  // Content Download\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Download content by CID.\n   *\n   * Returns Blob in browser environments, Buffer in Node.js.\n   *\n   * @param cid - Content Identifier\n   * @returns Content as Blob (browser) or Buffer (Node)\n   * @throws ContentNotFoundError if the content doesn't exist\n   *\n   * @example\n   * ```typescript\n   * const content = await client.download('bafybeih...');\n   *\n   * // In browser\n   * const url = URL.createObjectURL(content as Blob);\n   *\n   * // In Node.js\n   * fs.writeFileSync('output.bin', content as Buffer);\n   * ```\n   */\n  async download(cid: string): Promise<Blob | Buffer> {\n    const url = this.buildUrl(`/api/cat/${encodeURIComponent(cid)}`);\n\n    let response: Response;\n    try {\n      response = await this.fetchImpl(url);\n    } catch (err) {\n      throw new NetworkError(\n        err instanceof Error ? err.message : 'Network request failed'\n      );\n    }\n\n    if (!response.ok) {\n      if (response.status === 404) {\n        throw new ContentNotFoundError(cid);\n      }\n      throw new ContentError(\n        `Failed to download content: ${response.status}`,\n        'DOWNLOAD_ERROR',\n        { status: response.status }\n      );\n    }\n\n    // Platform-aware response handling\n    if (typeof window !== 'undefined') {\n      // Browser environment\n      return response.blob();\n    } else {\n      // Node.js environment\n      const arrayBuffer = await response.arrayBuffer();\n      return Buffer.from(arrayBuffer);\n    }\n  }\n\n  /**\n   * Get a direct URL for content by CID.\n   *\n   * This is useful for embedding in img tags or for direct downloads.\n   *\n   * @param cid - Content Identifier\n   * @returns URL string\n   *\n   * @example\n   * ```typescript\n   * const url = content.getUrl('bafybeih...');\n   * // Use in img tag: <img src={url} />\n   * ```\n   */\n  getUrl(cid: string): string {\n    return `${this.baseUrl}/api/cat/${encodeURIComponent(cid)}`;\n  }\n\n  /**\n   * Stream content by CID.\n   *\n   * @param cid - Content Identifier\n   * @returns ReadableStream of the content\n   * @throws ContentNotFoundError if the content doesn't exist\n   *\n   * @example\n   * ```typescript\n   * const stream = await content.stream('bafybeih...');\n   * const reader = stream.getReader();\n   * while (true) {\n   *   const { done, value } = await reader.read();\n   *   if (done) break;\n   *   // Process chunk\n   * }\n   * ```\n   */\n  async stream(cid: string): Promise<ReadableStream<Uint8Array>> {\n    const url = this.buildUrl(`/api/cat/${encodeURIComponent(cid)}`);\n\n    let response: Response;\n    try {\n      response = await this.fetchImpl(url);\n    } catch (err) {\n      throw new NetworkError(\n        err instanceof Error ? err.message : 'Network request failed'\n      );\n    }\n\n    if (!response.ok) {\n      if (response.status === 404) {\n        throw new ContentNotFoundError(cid);\n      }\n      throw new ContentError(\n        `Failed to stream content: ${response.status}`,\n        'STREAM_ERROR',\n        { status: response.status }\n      );\n    }\n\n    if (!response.body) {\n      throw new ContentError('Response body is not available', 'STREAM_ERROR');\n    }\n\n    return response.body;\n  }\n\n  /**\n   * Download a DAG node (JSON) by CID.\n   *\n   * Use this to fetch JSON components like properties and relationships.\n   *\n   * @param cid - Content Identifier of the DAG node\n   * @returns Parsed JSON object\n   * @throws ContentNotFoundError if the content doesn't exist\n   *\n   * @example\n   * ```typescript\n   * const relationships = await content.getDag<RelationshipsComponent>(\n   *   entity.components.relationships\n   * );\n   * console.log('Relationships:', relationships.relationships);\n   * ```\n   */\n  async getDag<T = unknown>(cid: string): Promise<T> {\n    const url = this.buildUrl(`/api/dag/${encodeURIComponent(cid)}`);\n\n    let response: Response;\n    try {\n      response = await this.fetchImpl(url);\n    } catch (err) {\n      throw new NetworkError(\n        err instanceof Error ? err.message : 'Network request failed'\n      );\n    }\n\n    if (!response.ok) {\n      if (response.status === 404) {\n        throw new ContentNotFoundError(cid);\n      }\n      throw new ContentError(\n        `Failed to fetch DAG node: ${response.status}`,\n        'DAG_ERROR',\n        { status: response.status }\n      );\n    }\n\n    return (await response.json()) as T;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Component Helpers\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Download a component from an entity.\n   *\n   * @param entity - Entity containing the component\n   * @param componentName - Name of the component (e.g., 'pinax', 'description', 'source')\n   * @returns Component content as Blob (browser) or Buffer (Node)\n   * @throws ComponentNotFoundError if the component doesn't exist\n   *\n   * @example\n   * ```typescript\n   * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');\n   * const pinax = await content.getComponent(entity, 'pinax');\n   * ```\n   */\n  async getComponent(entity: Entity, componentName: string): Promise<Blob | Buffer> {\n    const cid = entity.components[componentName];\n    if (!cid) {\n      throw new ComponentNotFoundError(entity.id, componentName);\n    }\n    return this.download(cid);\n  }\n\n  /**\n   * Get the URL for a component from an entity.\n   *\n   * @param entity - Entity containing the component\n   * @param componentName - Name of the component\n   * @returns URL string\n   * @throws ComponentNotFoundError if the component doesn't exist\n   *\n   * @example\n   * ```typescript\n   * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');\n   * const imageUrl = content.getComponentUrl(entity, 'source');\n   * // Use in img tag: <img src={imageUrl} />\n   * ```\n   */\n  getComponentUrl(entity: Entity, componentName: string): string {\n    const cid = entity.components[componentName];\n    if (!cid) {\n      throw new ComponentNotFoundError(entity.id, componentName);\n    }\n    return this.getUrl(cid);\n  }\n\n  /**\n   * Get the properties component for an entity.\n   *\n   * @param entity - Entity containing the properties component\n   * @returns Properties object, or null if no properties component exists\n   *\n   * @example\n   * ```typescript\n   * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');\n   * const props = await content.getProperties(entity);\n   * if (props) {\n   *   console.log('Title:', props.title);\n   * }\n   * ```\n   */\n  async getProperties(entity: Entity): Promise<PropertiesComponent | null> {\n    const cid = entity.components.properties;\n    if (!cid) {\n      return null;\n    }\n    return this.getDag<PropertiesComponent>(cid);\n  }\n\n  /**\n   * Get the relationships component for an entity.\n   *\n   * @param entity - Entity containing the relationships component\n   * @returns Relationships component, or null if no relationships exist\n   *\n   * @example\n   * ```typescript\n   * const entity = await content.get('01K75HQQXNTDG7BBP7PS9AWYAN');\n   * const rels = await content.getRelationships(entity);\n   * if (rels) {\n   *   rels.relationships.forEach(r => {\n   *     console.log(`${r.predicate} -> ${r.target_label}`);\n   *   });\n   * }\n   * ```\n   */\n  async getRelationships(entity: Entity): Promise<RelationshipsComponent | null> {\n    const cid = entity.components.relationships;\n    if (!cid) {\n      return null;\n    }\n    return this.getDag<RelationshipsComponent>(cid);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACOO,IAAM,eAAN,cAA2B,MAAM;AAAA,EACtC,YACE,SACO,OAAe,iBACf,SACP;AACA,UAAM,OAAO;AAHN;AACA;AAGP,SAAK,OAAO;AAAA,EACd;AACF;AAKO,IAAM,sBAAN,cAAkC,aAAa;AAAA,EACpD,YAAY,IAAY;AACtB,UAAM,qBAAqB,EAAE,IAAI,oBAAoB,EAAE,GAAG,CAAC;AAC3D,SAAK,OAAO;AAAA,EACd;AACF;AAKO,IAAM,uBAAN,cAAmC,aAAa;AAAA,EACrD,YAAY,KAAa;AACvB,UAAM,sBAAsB,GAAG,IAAI,qBAAqB,EAAE,IAAI,CAAC;AAC/D,SAAK,OAAO;AAAA,EACd;AACF;AAKO,IAAM,yBAAN,cAAqC,aAAa;AAAA,EACvD,YAAY,IAAY,eAAuB;AAC7C;AAAA,MACE,cAAc,aAAa,yBAAyB,EAAE;AAAA,MACtD;AAAA,MACA,EAAE,IAAI,cAAc;AAAA,IACtB;AACA,SAAK,OAAO;AAAA,EACd;AACF;AAKO,IAAM,uBAAN,cAAmC,aAAa;AAAA,EACrD,YAAY,IAAY,UAAkB;AACxC;AAAA,MACE,sBAAsB,QAAQ,eAAe,EAAE;AAAA,MAC/C;AAAA,MACA,EAAE,IAAI,SAAS;AAAA,IACjB;AACA,SAAK,OAAO;AAAA,EACd;AACF;AAKO,IAAM,eAAN,cAA2B,aAAa;AAAA,EAC7C,YAAY,SAAwB,YAAqB;AACvD,UAAM,SAAS,iBAAiB,EAAE,WAAW,CAAC;AADZ;AAElC,SAAK,OAAO;AAAA,EACd;AACF;;;ACjBO,IAAM,gBAAN,MAAoB;AAAA,EAIzB,YAAY,QAA6B;AACvC,SAAK,UAAU,OAAO,WAAW,QAAQ,OAAO,EAAE;AAClD,SAAK,YAAY,OAAO,aAAa;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA,EAMQ,SAAS,MAAc,OAA+D;AAC5F,UAAM,MAAM,IAAI,IAAI,GAAG,KAAK,OAAO,GAAG,IAAI,EAAE;AAC5C,QAAI,OAAO;AACT,aAAO,QAAQ,KAAK,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AAC9C,YAAI,UAAU,UAAa,UAAU,MAAM;AACzC,cAAI,aAAa,IAAI,KAAK,OAAO,KAAK,CAAC;AAAA,QACzC;AAAA,MACF,CAAC;AAAA,IACH;AACA,WAAO,IAAI,SAAS;AAAA,EACtB;AAAA,EAEA,MAAc,QACZ,MACA,UAEI,CAAC,GACO;AACZ,UAAM,MAAM,KAAK,SAAS,MAAM,QAAQ,KAAK;AAC7C,UAAM,UAAU,IAAI,QAAQ,EAAE,gBAAgB,mBAAmB,CAAC;AAClE,QAAI,QAAQ,SAAS;AACnB,aAAO,QAAQ,QAAQ,OAAO,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM;AAClD,YAAI,MAAM,OAAW,SAAQ,IAAI,GAAG,CAAW;AAAA,MACjD,CAAC;AAAA,IACH;AAEA,QAAI;AACJ,QAAI;AACF,iBAAW,MAAM,KAAK,UAAU,KAAK,EAAE,GAAG,SAAS,QAAQ,CAAC;AAAA,IAC9D,SAAS,KAAK;AACZ,YAAM,IAAI;AAAA,QACR,eAAe,QAAQ,IAAI,UAAU;AAAA,MACvC;AAAA,IACF;AAEA,QAAI,SAAS,IAAI;AACf,YAAM,cAAc,SAAS,QAAQ,IAAI,cAAc,KAAK;AAC5D,UAAI,YAAY,SAAS,kBAAkB,GAAG;AAC5C,eAAQ,MAAM,SAAS,KAAK;AAAA,MAC9B;AACA,aAAQ,MAAM,SAAS,KAAK;AAAA,IAC9B;AAEA,QAAI;AACJ,UAAM,OAAO,MAAM,SAAS,KAAK;AACjC,QAAI;AACF,aAAO,KAAK,MAAM,IAAI;AAAA,IACxB,QAAQ;AACN,aAAO;AAAA,IACT;AAGA,QAAI,SAAS,WAAW,KAAK;AAC3B,YAAM,YAAa,MAAmB;AACtC,UAAI,cAAc,eAAe,cAAc,oBAAoB;AACjE,cAAM,IAAI;AAAA,UACP,MAAmB,WAAqB;AAAA,UACzC;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,UAAM,UACH,MAAmB,SAAS,OAAQ,KAAkB,UAAU,WAC3D,KAAkB,QACnB,MAAmB,WAAW,OAAQ,KAAkB,YAAY,WACjE,KAAkB,UACpB,8BAA8B,SAAS,MAAM;AAErD,UAAM,IAAI,aAAa,SAAS,cAAc;AAAA,MAC5C,QAAQ,SAAS;AAAA,MACjB;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBA,MAAM,IAAI,IAA6B;AACrC,QAAI;AACF,aAAO,MAAM,KAAK,QAAgB,iBAAiB,mBAAmB,EAAE,CAAC,EAAE;AAAA,IAC7E,SAAS,KAAK;AACZ,UAAI,eAAe,gBAAgB,IAAI,SAAS,aAAa;AAC3D,cAAM,IAAI,oBAAoB,EAAE;AAAA,MAClC;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,MAAM,KAAK,UAAuB,CAAC,GAA0B;AAC3D,WAAO,KAAK,QAAsB,iBAAiB;AAAA,MACjD,OAAO;AAAA,QACL,OAAO,QAAQ;AAAA,QACf,QAAQ,QAAQ;AAAA,QAChB,kBAAkB,QAAQ;AAAA,MAC5B;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBA,MAAM,SAAS,IAAY,UAA2B,CAAC,GAA8B;AACnF,QAAI;AACF,aAAO,MAAM,KAAK;AAAA,QAChB,iBAAiB,mBAAmB,EAAE,CAAC;AAAA,QACvC;AAAA,UACE,OAAO;AAAA,YACL,OAAO,QAAQ;AAAA,YACf,QAAQ,QAAQ;AAAA,UAClB;AAAA,QACF;AAAA,MACF;AAAA,IACF,SAAS,KAAK;AACZ,UAAI,eAAe,gBAAgB,IAAI,SAAS,aAAa;AAC3D,cAAM,IAAI,oBAAoB,EAAE;AAAA,MAClC;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBA,MAAM,WAAW,IAAY,UAAmC;AAC9D,QAAI;AACF,aAAO,MAAM,KAAK;AAAA,QAChB,iBAAiB,mBAAmB,EAAE,CAAC,aAAa,mBAAmB,QAAQ,CAAC;AAAA,MAClF;AAAA,IACF,SAAS,KAAK;AACZ,UAAI,eAAe,gBAAgB,IAAI,SAAS,aAAa;AAC3D,cAAM,IAAI,oBAAoB,EAAE;AAAA,MAClC;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,QAAQ,IAAsC;AAClD,QAAI;AACF,aAAO,MAAM,KAAK,QAAyB,gBAAgB,mBAAmB,EAAE,CAAC,EAAE;AAAA,IACrF,SAAS,KAAK;AACZ,UAAI,eAAe,gBAAgB,IAAI,SAAS,aAAa;AAC3D,cAAM,IAAI,oBAAoB,EAAE;AAAA,MAClC;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,SAAS,IAA+B;AAC5C,UAAM,SAAS,MAAM,KAAK,IAAI,EAAE;AAChC,WAAO,OAAO,eAAe,CAAC;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,MAAM,iBAAiB,IAA+B;AACpD,UAAM,WAAW,MAAM,KAAK,SAAS,EAAE;AACvC,QAAI,SAAS,WAAW,GAAG;AACzB,aAAO,CAAC;AAAA,IACV;AAGA,UAAM,UAAU,MAAM,QAAQ;AAAA,MAC5B,SAAS,IAAI,aAAW,KAAK,IAAI,OAAO,CAAC;AAAA,IAC3C;AAGA,WAAO,QACJ,OAAO,CAAC,MAA2C,EAAE,WAAW,WAAW,EAC3E,IAAI,OAAK,EAAE,KAAK;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,MAAM,OAAwB;AAC5B,WAAO,KAAK,QAAgB,WAAW;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA0BA,MAAM,SAAS,KAAqC;AAClD,UAAM,MAAM,KAAK,SAAS,YAAY,mBAAmB,GAAG,CAAC,EAAE;AAE/D,QAAI;AACJ,QAAI;AACF,iBAAW,MAAM,KAAK,UAAU,GAAG;AAAA,IACrC,SAAS,KAAK;AACZ,YAAM,IAAI;AAAA,QACR,eAAe,QAAQ,IAAI,UAAU;AAAA,MACvC;AAAA,IACF;AAEA,QAAI,CAAC,SAAS,IAAI;AAChB,UAAI,SAAS,WAAW,KAAK;AAC3B,cAAM,IAAI,qBAAqB,GAAG;AAAA,MACpC;AACA,YAAM,IAAI;AAAA,QACR,+BAA+B,SAAS,MAAM;AAAA,QAC9C;AAAA,QACA,EAAE,QAAQ,SAAS,OAAO;AAAA,MAC5B;AAAA,IACF;AAGA,QAAI,OAAO,WAAW,aAAa;AAEjC,aAAO,SAAS,KAAK;AAAA,IACvB,OAAO;AAEL,YAAM,cAAc,MAAM,SAAS,YAAY;AAC/C,aAAO,OAAO,KAAK,WAAW;AAAA,IAChC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,OAAO,KAAqB;AAC1B,WAAO,GAAG,KAAK,OAAO,YAAY,mBAAmB,GAAG,CAAC;AAAA,EAC3D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBA,MAAM,OAAO,KAAkD;AAC7D,UAAM,MAAM,KAAK,SAAS,YAAY,mBAAmB,GAAG,CAAC,EAAE;AAE/D,QAAI;AACJ,QAAI;AACF,iBAAW,MAAM,KAAK,UAAU,GAAG;AAAA,IACrC,SAAS,KAAK;AACZ,YAAM,IAAI;AAAA,QACR,eAAe,QAAQ,IAAI,UAAU;AAAA,MACvC;AAAA,IACF;AAEA,QAAI,CAAC,SAAS,IAAI;AAChB,UAAI,SAAS,WAAW,KAAK;AAC3B,cAAM,IAAI,qBAAqB,GAAG;AAAA,MACpC;AACA,YAAM,IAAI;AAAA,QACR,6BAA6B,SAAS,MAAM;AAAA,QAC5C;AAAA,QACA,EAAE,QAAQ,SAAS,OAAO;AAAA,MAC5B;AAAA,IACF;AAEA,QAAI,CAAC,SAAS,MAAM;AAClB,YAAM,IAAI,aAAa,kCAAkC,cAAc;AAAA,IACzE;AAEA,WAAO,SAAS;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,MAAM,OAAoB,KAAyB;AACjD,UAAM,MAAM,KAAK,SAAS,YAAY,mBAAmB,GAAG,CAAC,EAAE;AAE/D,QAAI;AACJ,QAAI;AACF,iBAAW,MAAM,KAAK,UAAU,GAAG;AAAA,IACrC,SAAS,KAAK;AACZ,YAAM,IAAI;AAAA,QACR,eAAe,QAAQ,IAAI,UAAU;AAAA,MACvC;AAAA,IACF;AAEA,QAAI,CAAC,SAAS,IAAI;AAChB,UAAI,SAAS,WAAW,KAAK;AAC3B,cAAM,IAAI,qBAAqB,GAAG;AAAA,MACpC;AACA,YAAM,IAAI;AAAA,QACR,6BAA6B,SAAS,MAAM;AAAA,QAC5C;AAAA,QACA,EAAE,QAAQ,SAAS,OAAO;AAAA,MAC5B;AAAA,IACF;AAEA,WAAQ,MAAM,SAAS,KAAK;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBA,MAAM,aAAa,QAAgB,eAA+C;AAChF,UAAM,MAAM,OAAO,WAAW,aAAa;AAC3C,QAAI,CAAC,KAAK;AACR,YAAM,IAAI,uBAAuB,OAAO,IAAI,aAAa;AAAA,IAC3D;AACA,WAAO,KAAK,SAAS,GAAG;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,gBAAgB,QAAgB,eAA+B;AAC7D,UAAM,MAAM,OAAO,WAAW,aAAa;AAC3C,QAAI,CAAC,KAAK;AACR,YAAM,IAAI,uBAAuB,OAAO,IAAI,aAAa;AAAA,IAC3D;AACA,WAAO,KAAK,OAAO,GAAG;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,MAAM,cAAc,QAAqD;AACvE,UAAM,MAAM,OAAO,WAAW;AAC9B,QAAI,CAAC,KAAK;AACR,aAAO;AAAA,IACT;AACA,WAAO,KAAK,OAA4B,GAAG;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,MAAM,iBAAiB,QAAwD;AAC7E,UAAM,MAAM,OAAO,WAAW;AAC9B,QAAI,CAAC,KAAK;AACR,aAAO;AAAA,IACT;AACA,WAAO,KAAK,OAA+B,GAAG;AAAA,EAChD;AACF;","names":[]}

package/dist/content/index.d.cts

@@ -2,27 +2,40 @@
  * Content package types for the Arke SDK
  *
  * Types for interacting with entities and content from the IPFS Wrapper service.
+ * Based on the arke/eidos@v1 schema.
  */
 /**
  * Full entity manifest from IPFS Wrapper
  */
 interface Entity {
-    /** Persistent Identifier (ULID or test PI with II prefix) */
-    pi: string;
+    /** Entity identifier (ULID or test ID with II prefix) */
+    id: string;
+    /** Entity type (e.g., "PI", "person", "place", "concept", "document") */
+    type: string;
+    /** Creation timestamp (immutable, set at v1) */
+    created_at: string;
+    /** Display name */
+    label?: string;
+    /** Human-readable description */
+    description?: string;
     /** Version number */
     ver: number;
     /** Timestamp when this version was created */
     ts: string;
     /** CID of this manifest */
     manifest_cid: string;
-    /** CID of the previous version (undefined for version 1) */
-    prev_cid?: string;
+    /** CID of the previous version (null for version 1) */
+    prev_cid: string | null;
     /** Map of component names to their CIDs */
     components: Record<string, string>;
-    /** PIs of child entities */
+    /** IDs of child entities */
     children_pi?: string[];
-    /** PI of parent entity */
+    /** ID of parent entity */
     parent_pi?: string;
+    /** Provenance: which PI extracted this entity */
+    source_pi?: string;
+    /** IDs of entities that have been merged into this one */
+    merged_entities?: string[];
     /** Change note for this version */
     note?: string;
 }
@@ -30,10 +43,14 @@ interface Entity {
  * Summary entity info returned when listing entities
  */
 interface EntitySummary {
-    /** Persistent Identifier */
-    pi: string;
+    /** Entity identifier */
+    id: string;
     /** Tip CID (latest manifest) */
     tip: string;
+    /** Entity type (if include_metadata=true) */
+    type?: string;
+    /** Display name (if include_metadata=true) */
+    label?: string;
     /** Version number (if include_metadata=true) */
     ver?: number;
     /** Timestamp (if include_metadata=true) */
@@ -102,11 +119,55 @@ interface VersionsResponse {
  * Response from resolving a PI
  */
 interface ResolveResponse {
-    /** Persistent Identifier */
-    pi: string;
+    /** Entity identifier */
+    id: string;
     /** Tip CID (latest manifest) */
     tip: string;
 }
+/**
+ * A single relationship edge in the semantic graph.
+ *
+ * Represents a typed, directional relationship from the source entity
+ * to a target entity or PI.
+ */
+interface Relationship {
+    /** Relationship predicate (e.g., "authored_by", "mentions", "located_in") */
+    predicate: string;
+    /** Type of target */
+    target_type: 'pi' | 'entity';
+    /** Target entity identifier */
+    target_id: string;
+    /** Display label for the target (e.g., "Alice Austen") */
+    target_label: string;
+    /** Target entity type (e.g., "person", "place") - only if target is entity */
+    target_entity_type?: string;
+    /** Optional metadata on the relationship edge */
+    properties?: Record<string, unknown>;
+}
+/**
+ * Relationships component stored in IPFS (arke/relationships@v1 schema).
+ *
+ * Contains the semantic graph relationships for an entity.
+ */
+interface RelationshipsComponent {
+    /** Schema identifier */
+    schema: 'arke/relationships@v1';
+    /** Array of relationships */
+    relationships: Relationship[];
+    /** ISO 8601 timestamp when this component was created/updated */
+    timestamp: string;
+    /** Optional note about changes */
+    note?: string;
+}
+/**
+ * Properties component stored in IPFS.
+ *
+ * Contains arbitrary metadata properties for an entity.
+ */
+interface PropertiesComponent {
+    /** Arbitrary key-value properties */
+    [key: string]: unknown;
+}
 
 /**
  * Configuration for ContentClient
@@ -324,6 +385,24 @@ declare class ContentClient {
      * ```
      */
     stream(cid: string): Promise<ReadableStream<Uint8Array>>;
+    /**
+     * 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);
+     * ```
+     */
+    getDag<T = unknown>(cid: string): Promise<T>;
     /**
      * Download a component from an entity.
      *
@@ -355,6 +434,40 @@ declare class ContentClient {
      * ```
      */
     getComponentUrl(entity: Entity, componentName: string): string;
+    /**
+     * 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);
+     * }
+     * ```
+     */
+    getProperties(entity: Entity): Promise<PropertiesComponent | null>;
+    /**
+     * 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}`);
+     *   });
+     * }
+     * ```
+     */
+    getRelationships(entity: Entity): Promise<RelationshipsComponent | null>;
 }
 
 /**
@@ -369,10 +482,10 @@ declare class ContentError extends Error {
     constructor(message: string, code?: string, details?: unknown | undefined);
 }
 /**
- * Thrown when an entity is not found by PI
+ * Thrown when an entity is not found by ID
  */
 declare class EntityNotFoundError extends ContentError {
-    constructor(pi: string);
+    constructor(id: string);
 }
 /**
  * Thrown when content is not found by CID
@@ -384,13 +497,13 @@ declare class ContentNotFoundError extends ContentError {
  * Thrown when a component is not found on an entity
  */
 declare class ComponentNotFoundError extends ContentError {
-    constructor(pi: string, componentName: string);
+    constructor(id: string, componentName: string);
 }
 /**
  * Thrown when a version is not found
  */
 declare class VersionNotFoundError extends ContentError {
-    constructor(pi: string, selector: string);
+    constructor(id: string, selector: string);
 }
 /**
  * Thrown when a network error occurs
@@ -400,4 +513,4 @@ declare class NetworkError extends ContentError {
     constructor(message: string, statusCode?: number | undefined);
 }
 
-export { ComponentNotFoundError, ContentClient, type ContentClientConfig, ContentError, ContentNotFoundError, type Entity, EntityNotFoundError, type EntitySummary, type EntityVersion, type ListOptions, type ListResponse, NetworkError, type ResolveResponse, VersionNotFoundError, type VersionsOptions, type VersionsResponse };
+export { ComponentNotFoundError, ContentClient, type ContentClientConfig, ContentError, ContentNotFoundError, type Entity, EntityNotFoundError, type EntitySummary, type EntityVersion, type ListOptions, type ListResponse, NetworkError, type PropertiesComponent, type Relationship, type RelationshipsComponent, type ResolveResponse, VersionNotFoundError, type VersionsOptions, type VersionsResponse };