@arke-institute/sdk 2.1.0 → 2.2.0

package/dist/{crypto-CQnwqWQn.d.ts → crypto-7c990p-j.d.ts}

@@ -11,7 +11,12 @@ interface ArkeClientConfig {
      */
     baseUrl?: string;
     /**
-     * Authentication token (JWT or API key)
+     * Authentication token - accepts either:
+     * - JWT token from Supabase auth (sent as Bearer)
+     * - Agent API key with 'ak_' prefix (sent as ApiKey)
+     * - User API key with 'uk_' prefix (sent as ApiKey)
+     *
+     * The correct Authorization header format is auto-detected from the token prefix.
      */
     authToken?: string;
     /**
@@ -39,13 +44,28 @@ declare const DEFAULT_CONFIG: Required<Pick<ArkeClientConfig, 'baseUrl' | 'netwo
  */
 
 type ArkeApiClient = Client<paths>;
+/**
+ * Check if a token is an API key (starts with 'ak_' or 'uk_')
+ */
+declare function isApiKey(token: string): boolean;
+/**
+ * Get the appropriate Authorization header value for a token
+ * - API keys (ak_*, uk_*) use: ApiKey {token}
+ * - JWT tokens use: Bearer {token}
+ */
+declare function getAuthorizationHeader(token: string): string;
 /**
  * Type-safe client for the Arke API
  *
  * @example
  * ```typescript
+ * // With JWT token
  * const arke = new ArkeClient({ authToken: 'your-jwt-token' });
  *
+ * // With API key (agent or user)
+ * const arke = new ArkeClient({ authToken: 'ak_your-agent-api-key' });
+ * const arke = new ArkeClient({ authToken: 'uk_your-user-api-key' });
+ *
  * // Create an entity
  * const { data, error } = await arke.api.POST('/entities', {
  *   body: {
@@ -175,22 +195,26 @@ interface UploadTarget {
  */
 interface UploadProgress$1 {
     /** Current phase of the upload */
-    phase: 'scanning' | 'computing-cids' | 'creating-folders' | 'creating-files' | 'uploading-content' | 'linking' | 'complete' | 'error';
-    /** Total number of files to upload */
-    totalFiles: number;
-    /** Number of files completed */
-    completedFiles: number;
-    /** Total number of folders to create */
-    totalFolders: number;
-    /** Number of folders completed */
-    completedFolders: number;
-    /** Current file being processed */
-    currentFile?: string;
-    /** Current folder being processed */
-    currentFolder?: string;
+    phase: 'computing-cids' | 'creating' | 'backlinking' | 'uploading' | 'complete' | 'error';
+    /** Current phase index (0=computing-cids, 1=creating, 2=backlinking, 3=uploading) */
+    phaseIndex: number;
+    /** Total number of phases (4, excluding complete/error) */
+    phaseCount: number;
+    /** Progress within current phase (0-100) */
+    phasePercent: number;
+    /** Total number of entities (files + folders) */
+    totalEntities: number;
+    /** Number of entities completed */
+    completedEntities: number;
+    /** Total number of parents to backlink */
+    totalParents: number;
+    /** Number of parents backlinked */
+    completedParents: number;
+    /** Current item being processed */
+    currentItem?: string;
     /** Error message if phase is 'error' */
     error?: string;
-    /** Bytes uploaded so far (for content upload phase) */
+    /** Bytes uploaded so far */
     bytesUploaded?: number;
     /** Total bytes to upload */
     totalBytes?: number;
@@ -456,4 +480,4 @@ declare class CryptoOperations {
     static computeCID(_content: Uint8Array): Promise<string>;
 }
 
-export { ArkeClient as A, BatchOperations as B, CryptoOperations as C, DEFAULT_CONFIG as D, FolderOperations as F, type KeyPair as K, type SignedPayload as S, type UploadProgress$1 as U, type ArkeApiClient as a, type ArkeClientConfig as b, createArkeClient as c, type UploadDirectoryOptions as d, type UploadDirectoryResult as e, type BatchCreateOptions as f, type BatchResult as g, type UploadTree as h, type UploadOptions as i, type UploadResult as j, type UploadFile as k, type UploadFolder as l, type UploadTarget as m, type CreatedEntity as n };
+export { ArkeClient as A, BatchOperations as B, CryptoOperations as C, DEFAULT_CONFIG as D, FolderOperations as F, type KeyPair as K, type SignedPayload as S, type UploadProgress$1 as U, type ArkeApiClient as a, type ArkeClientConfig as b, createArkeClient as c, type UploadDirectoryOptions as d, type UploadDirectoryResult as e, type BatchCreateOptions as f, getAuthorizationHeader as g, type BatchResult as h, isApiKey as i, type UploadTree as j, type UploadOptions as k, type UploadResult as l, type UploadFile as m, type UploadFolder as n, type UploadTarget as o, type CreatedEntity as p };

package/dist/{crypto-iYgzUi77.d.cts → crypto-El5Z3bNI.d.cts}

@@ -11,7 +11,12 @@ interface ArkeClientConfig {
      */
     baseUrl?: string;
     /**
-     * Authentication token (JWT or API key)
+     * Authentication token - accepts either:
+     * - JWT token from Supabase auth (sent as Bearer)
+     * - Agent API key with 'ak_' prefix (sent as ApiKey)
+     * - User API key with 'uk_' prefix (sent as ApiKey)
+     *
+     * The correct Authorization header format is auto-detected from the token prefix.
      */
     authToken?: string;
     /**
@@ -39,13 +44,28 @@ declare const DEFAULT_CONFIG: Required<Pick<ArkeClientConfig, 'baseUrl' | 'netwo
  */
 
 type ArkeApiClient = Client<paths>;
+/**
+ * Check if a token is an API key (starts with 'ak_' or 'uk_')
+ */
+declare function isApiKey(token: string): boolean;
+/**
+ * Get the appropriate Authorization header value for a token
+ * - API keys (ak_*, uk_*) use: ApiKey {token}
+ * - JWT tokens use: Bearer {token}
+ */
+declare function getAuthorizationHeader(token: string): string;
 /**
  * Type-safe client for the Arke API
  *
  * @example
  * ```typescript
+ * // With JWT token
  * const arke = new ArkeClient({ authToken: 'your-jwt-token' });
  *
+ * // With API key (agent or user)
+ * const arke = new ArkeClient({ authToken: 'ak_your-agent-api-key' });
+ * const arke = new ArkeClient({ authToken: 'uk_your-user-api-key' });
+ *
  * // Create an entity
  * const { data, error } = await arke.api.POST('/entities', {
  *   body: {
@@ -175,22 +195,26 @@ interface UploadTarget {
  */
 interface UploadProgress$1 {
     /** Current phase of the upload */
-    phase: 'scanning' | 'computing-cids' | 'creating-folders' | 'creating-files' | 'uploading-content' | 'linking' | 'complete' | 'error';
-    /** Total number of files to upload */
-    totalFiles: number;
-    /** Number of files completed */
-    completedFiles: number;
-    /** Total number of folders to create */
-    totalFolders: number;
-    /** Number of folders completed */
-    completedFolders: number;
-    /** Current file being processed */
-    currentFile?: string;
-    /** Current folder being processed */
-    currentFolder?: string;
+    phase: 'computing-cids' | 'creating' | 'backlinking' | 'uploading' | 'complete' | 'error';
+    /** Current phase index (0=computing-cids, 1=creating, 2=backlinking, 3=uploading) */
+    phaseIndex: number;
+    /** Total number of phases (4, excluding complete/error) */
+    phaseCount: number;
+    /** Progress within current phase (0-100) */
+    phasePercent: number;
+    /** Total number of entities (files + folders) */
+    totalEntities: number;
+    /** Number of entities completed */
+    completedEntities: number;
+    /** Total number of parents to backlink */
+    totalParents: number;
+    /** Number of parents backlinked */
+    completedParents: number;
+    /** Current item being processed */
+    currentItem?: string;
     /** Error message if phase is 'error' */
     error?: string;
-    /** Bytes uploaded so far (for content upload phase) */
+    /** Bytes uploaded so far */
     bytesUploaded?: number;
     /** Total bytes to upload */
     totalBytes?: number;
@@ -456,4 +480,4 @@ declare class CryptoOperations {
     static computeCID(_content: Uint8Array): Promise<string>;
 }
 
-export { ArkeClient as A, BatchOperations as B, CryptoOperations as C, DEFAULT_CONFIG as D, FolderOperations as F, type KeyPair as K, type SignedPayload as S, type UploadProgress$1 as U, type ArkeApiClient as a, type ArkeClientConfig as b, createArkeClient as c, type UploadDirectoryOptions as d, type UploadDirectoryResult as e, type BatchCreateOptions as f, type BatchResult as g, type UploadTree as h, type UploadOptions as i, type UploadResult as j, type UploadFile as k, type UploadFolder as l, type UploadTarget as m, type CreatedEntity as n };
+export { ArkeClient as A, BatchOperations as B, CryptoOperations as C, DEFAULT_CONFIG as D, FolderOperations as F, type KeyPair as K, type SignedPayload as S, type UploadProgress$1 as U, type ArkeApiClient as a, type ArkeClientConfig as b, createArkeClient as c, type UploadDirectoryOptions as d, type UploadDirectoryResult as e, type BatchCreateOptions as f, getAuthorizationHeader as g, type BatchResult as h, isApiKey as i, type UploadTree as j, type UploadOptions as k, type UploadResult as l, type UploadFile as m, type UploadFolder as n, type UploadTarget as o, type CreatedEntity as p };