@arke-institute/sdk 0.1.3 → 2.1.0

package/dist/operations/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/operations/index.ts","../../src/operations/upload/cid.ts","../../src/operations/upload/engine.ts","../../src/operations/upload/scanners.ts","../../src/operations/folders.ts","../../src/operations/batch.ts","../../src/operations/crypto.ts"],"sourcesContent":["/**\n * High-level operations built on top of the generated API client\n *\n * These provide convenience methods for common multi-step workflows.\n */\n\n// Upload operations (primary folder/file upload functionality)\nexport {\n  uploadTree,\n  computeCid,\n  verifyCid,\n  scanDirectory,\n  scanFileSystemEntries,\n  scanFileList,\n  buildUploadTree,\n  getMimeType,\n  type UploadFile,\n  type UploadFolder,\n  type UploadTree,\n  type UploadTarget,\n  type UploadProgress,\n  type UploadOptions,\n  type UploadResult,\n  type CreatedEntity,\n} from './upload/index.js';\n\n// Legacy FolderOperations class (deprecated - use uploadTree instead)\nexport { FolderOperations, type UploadDirectoryOptions, type UploadDirectoryResult } from './folders.js';\n\n// Batch operations (placeholder)\nexport { BatchOperations, type BatchCreateOptions, type BatchResult } from './batch.js';\n\n// Crypto operations (placeholder)\nexport { CryptoOperations, type KeyPair, type SignedPayload } from './crypto.js';\n","/**\n * CID Computation Utility\n *\n * Computes IPFS CIDv1 (base32) for file content.\n * Uses raw codec (0x55) and SHA-256 hash.\n */\n\nimport { CID } from 'multiformats/cid';\nimport { sha256 } from 'multiformats/hashes/sha2';\nimport * as raw from 'multiformats/codecs/raw';\n\n/**\n * Compute CIDv1 for binary content.\n * Returns base32 encoded string (bafk... prefix for raw codec).\n *\n * @param data - Binary content as ArrayBuffer, Uint8Array, or Blob\n * @returns CIDv1 string in base32 encoding\n *\n * @example\n * ```typescript\n * const cid = await computeCid(new TextEncoder().encode('hello world'));\n * // Returns: \"bafkreifzjut3te2nhyekklss27nh3k72ysco7y32koao5eei66wof36n5e\"\n * ```\n */\nexport async function computeCid(data: ArrayBuffer | Uint8Array | Blob): Promise<string> {\n  // Convert to Uint8Array\n  let bytes: Uint8Array;\n\n  if (data instanceof Blob) {\n    const buffer = await data.arrayBuffer();\n    bytes = new Uint8Array(buffer);\n  } else if (data instanceof ArrayBuffer) {\n    bytes = new Uint8Array(data);\n  } else {\n    bytes = data;\n  }\n\n  // Compute SHA-256 hash\n  const hash = await sha256.digest(bytes);\n\n  // Create CIDv1 with raw codec\n  const cid = CID.create(1, raw.code, hash);\n\n  // Return base32 encoded string\n  return cid.toString();\n}\n\n/**\n * Verify a CID matches the content.\n *\n * @param data - Binary content\n * @param expectedCid - CID to verify against\n * @returns true if CID matches\n */\nexport async function verifyCid(\n  data: ArrayBuffer | Uint8Array | Blob,\n  expectedCid: string\n): Promise<boolean> {\n  const computed = await computeCid(data);\n  return computed === expectedCid;\n}\n","/**\n * Upload Engine\n *\n * Core upload implementation that handles the multi-phase upload process:\n * 1. Create collection (if needed)\n * 2. Compute CIDs for all files\n * 3. Create all entities (folders + files) in parallel\n * 4. Upload file content to presigned URLs\n * 5. Bulk link children to their parents\n */\n\nimport type { ArkeClient } from '../../client/ArkeClient.js';\nimport type { components } from '../../generated/types.js';\nimport { computeCid } from './cid.js';\nimport type {\n  UploadTree,\n  UploadOptions,\n  UploadResult,\n  UploadProgress,\n  UploadFile,\n  UploadFolder,\n  PreparedFile,\n  CreatedFolder,\n  CreatedFile,\n  CreatedEntity,\n} from './types.js';\n\ntype CreateCollectionRequest = components['schemas']['CreateCollectionRequest'];\ntype CreateFolderRequest = components['schemas']['CreateFolderRequest'];\ntype CreateFileRequest = components['schemas']['CreateFileRequest'];\ntype BulkAddChildrenRequest = components['schemas']['BulkAddChildrenRequest'];\n\n/**\n * Simple concurrency limiter for parallel operations.\n */\nasync function parallelLimit<T, R>(\n  items: T[],\n  concurrency: number,\n  fn: (item: T, index: number) => Promise<R>\n): Promise<R[]> {\n  const results: R[] = [];\n  let index = 0;\n\n  async function worker(): Promise<void> {\n    while (index < items.length) {\n      const currentIndex = index++;\n      const item = items[currentIndex]!;\n      results[currentIndex] = await fn(item, currentIndex);\n    }\n  }\n\n  const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker());\n  await Promise.all(workers);\n\n  return results;\n}\n\n/**\n * Parse folder path to get parent path.\n * e.g., \"docs/images/photos\" -> \"docs/images\"\n */\nfunction getParentPath(relativePath: string): string | null {\n  const lastSlash = relativePath.lastIndexOf('/');\n  if (lastSlash === -1) return null;\n  return relativePath.slice(0, lastSlash);\n}\n\n/**\n * Get the immediate children paths for a given parent path.\n */\nfunction getImmediateChildren(\n  parentPath: string | null,\n  folders: UploadFolder[],\n  files: PreparedFile[]\n): { folders: UploadFolder[]; files: PreparedFile[] } {\n  const childFolders = folders.filter((f) => getParentPath(f.relativePath) === parentPath);\n  const childFiles = files.filter((f) => getParentPath(f.relativePath) === parentPath);\n  return { folders: childFolders, files: childFiles };\n}\n\n/**\n * Main upload function.\n * Orchestrates the entire upload process.\n */\nexport async function uploadTree(\n  client: ArkeClient,\n  tree: UploadTree,\n  options: UploadOptions\n): Promise<UploadResult> {\n  const { target, onProgress, concurrency = 5, continueOnError = false, note } = options;\n\n  const errors: Array<{ path: string; error: string }> = [];\n  const createdFolders: CreatedFolder[] = [];\n  const createdFiles: CreatedFile[] = [];\n\n  // Helper to report progress\n  const reportProgress = (progress: Partial<UploadProgress>) => {\n    if (onProgress) {\n      onProgress({\n        phase: 'scanning',\n        totalFiles: tree.files.length,\n        completedFiles: 0,\n        totalFolders: tree.folders.length,\n        completedFolders: 0,\n        ...progress,\n      } as UploadProgress);\n    }\n  };\n\n  try {\n    // ─────────────────────────────────────────────────────────────────────────\n    // PHASE 1: Resolve or create collection\n    // ─────────────────────────────────────────────────────────────────────────\n    let collectionId: string;\n    let collectionCid: string;\n    let collectionCreated = false;\n\n    if (target.createCollection) {\n      reportProgress({ phase: 'scanning', currentFolder: 'Creating collection...' });\n\n      const collectionBody: CreateCollectionRequest = {\n        label: target.createCollection.label,\n        description: target.createCollection.description,\n        roles: target.createCollection.roles,\n        note,\n      };\n\n      const { data, error } = await client.api.POST('/collections', {\n        body: collectionBody,\n      });\n\n      if (error || !data) {\n        throw new Error(`Failed to create collection: ${JSON.stringify(error)}`);\n      }\n\n      collectionId = data.id;\n      collectionCid = data.cid;\n      collectionCreated = true;\n    } else if (target.collectionId) {\n      collectionId = target.collectionId;\n\n      // Fetch collection to get current CID\n      const { data, error } = await client.api.GET('/collections/{id}', {\n        params: { path: { id: collectionId } },\n      });\n\n      if (error || !data) {\n        throw new Error(`Failed to fetch collection: ${JSON.stringify(error)}`);\n      }\n\n      collectionCid = data.cid;\n    } else {\n      throw new Error('Must provide either collectionId or createCollection in target');\n    }\n\n    // Determine the parent for root-level items\n    const rootParentId = target.parentId ?? collectionId;\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // PHASE 2: Compute CIDs for all files\n    // ─────────────────────────────────────────────────────────────────────────\n    reportProgress({\n      phase: 'computing-cids',\n      totalFiles: tree.files.length,\n      completedFiles: 0,\n    });\n\n    const preparedFiles: PreparedFile[] = [];\n    let cidProgress = 0;\n\n    await parallelLimit(tree.files, concurrency, async (file) => {\n      try {\n        const data = await file.getData();\n        const cid = await computeCid(data);\n\n        preparedFiles.push({\n          ...file,\n          cid,\n        });\n\n        cidProgress++;\n        reportProgress({\n          phase: 'computing-cids',\n          completedFiles: cidProgress,\n          currentFile: file.relativePath,\n        });\n      } catch (err) {\n        const errorMsg = err instanceof Error ? err.message : String(err);\n        if (continueOnError) {\n          errors.push({ path: file.relativePath, error: `CID computation failed: ${errorMsg}` });\n        } else {\n          throw new Error(`Failed to compute CID for ${file.relativePath}: ${errorMsg}`);\n        }\n      }\n    });\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // PHASE 3: Create all folder entities\n    // ─────────────────────────────────────────────────────────────────────────\n    reportProgress({\n      phase: 'creating-folders',\n      totalFolders: tree.folders.length,\n      completedFolders: 0,\n    });\n\n    // Sort folders by depth (parents first)\n    const sortedFolders = [...tree.folders].sort(\n      (a, b) => a.relativePath.split('/').length - b.relativePath.split('/').length\n    );\n\n    // Create folders sequentially to ensure parents exist first\n    // (We don't set parent relationships here - we'll do that in the linking phase)\n    for (let i = 0; i < sortedFolders.length; i++) {\n      const folder = sortedFolders[i]!;\n\n      try {\n        const folderBody: CreateFolderRequest = {\n          label: folder.name,\n          collection: collectionId,\n          note,\n        };\n\n        const { data, error } = await client.api.POST('/folders', {\n          body: folderBody,\n        });\n\n        if (error || !data) {\n          throw new Error(JSON.stringify(error));\n        }\n\n        createdFolders.push({\n          name: folder.name,\n          relativePath: folder.relativePath,\n          id: data.id,\n          entityCid: data.cid,\n        });\n\n        reportProgress({\n          phase: 'creating-folders',\n          completedFolders: i + 1,\n          currentFolder: folder.relativePath,\n        });\n      } catch (err) {\n        const errorMsg = err instanceof Error ? err.message : String(err);\n        if (continueOnError) {\n          errors.push({ path: folder.relativePath, error: `Folder creation failed: ${errorMsg}` });\n        } else {\n          throw new Error(`Failed to create folder ${folder.relativePath}: ${errorMsg}`);\n        }\n      }\n    }\n\n    // Build folder path -> entity map for linking phase\n    const folderPathToEntity = new Map<string, CreatedFolder>();\n    for (const folder of createdFolders) {\n      folderPathToEntity.set(folder.relativePath, folder);\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // PHASE 4: Create all file entities (parallel)\n    // ─────────────────────────────────────────────────────────────────────────\n    reportProgress({\n      phase: 'creating-files',\n      totalFiles: preparedFiles.length,\n      completedFiles: 0,\n    });\n\n    let fileCreateProgress = 0;\n\n    await parallelLimit(preparedFiles, concurrency, async (file) => {\n      try {\n        const fileBody: CreateFileRequest = {\n          key: file.cid, // Use CID as storage key (best practice)\n          filename: file.name,\n          content_type: file.mimeType,\n          size: file.size,\n          cid: file.cid,\n          collection: collectionId,\n        };\n\n        const { data, error } = await client.api.POST('/files', {\n          body: fileBody,\n        });\n\n        if (error || !data) {\n          throw new Error(JSON.stringify(error));\n        }\n\n        createdFiles.push({\n          ...file,\n          id: data.id,\n          entityCid: data.cid,\n          uploadUrl: data.upload_url,\n          uploadExpiresAt: data.upload_expires_at,\n        });\n\n        fileCreateProgress++;\n        reportProgress({\n          phase: 'creating-files',\n          completedFiles: fileCreateProgress,\n          currentFile: file.relativePath,\n        });\n      } catch (err) {\n        const errorMsg = err instanceof Error ? err.message : String(err);\n        if (continueOnError) {\n          errors.push({ path: file.relativePath, error: `File creation failed: ${errorMsg}` });\n        } else {\n          throw new Error(`Failed to create file ${file.relativePath}: ${errorMsg}`);\n        }\n      }\n    });\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // PHASE 5: Upload file content to presigned URLs\n    // ─────────────────────────────────────────────────────────────────────────\n    const totalBytes = createdFiles.reduce((sum, f) => sum + f.size, 0);\n    let bytesUploaded = 0;\n\n    reportProgress({\n      phase: 'uploading-content',\n      totalFiles: createdFiles.length,\n      completedFiles: 0,\n      totalBytes,\n      bytesUploaded: 0,\n    });\n\n    let uploadProgress = 0;\n\n    await parallelLimit(createdFiles, concurrency, async (file) => {\n      try {\n        // Get the file data again for upload\n        const data = await file.getData();\n\n        // Convert to appropriate format for fetch\n        let body: Blob;\n        if (data instanceof Blob) {\n          body = data;\n        } else if (data instanceof Uint8Array) {\n          // Convert Uint8Array to Blob - copy to new ArrayBuffer to handle SharedArrayBuffer case\n          const arrayBuffer = new ArrayBuffer(data.byteLength);\n          new Uint8Array(arrayBuffer).set(data);\n          body = new Blob([arrayBuffer], { type: file.mimeType });\n        } else {\n          // ArrayBuffer\n          body = new Blob([data], { type: file.mimeType });\n        }\n\n        // Upload to presigned URL\n        const response = await fetch(file.uploadUrl, {\n          method: 'PUT',\n          body,\n          headers: {\n            'Content-Type': file.mimeType,\n          },\n        });\n\n        if (!response.ok) {\n          throw new Error(`Upload failed with status ${response.status}`);\n        }\n\n        bytesUploaded += file.size;\n        uploadProgress++;\n\n        reportProgress({\n          phase: 'uploading-content',\n          completedFiles: uploadProgress,\n          currentFile: file.relativePath,\n          bytesUploaded,\n          totalBytes,\n        });\n      } catch (err) {\n        const errorMsg = err instanceof Error ? err.message : String(err);\n        if (continueOnError) {\n          errors.push({ path: file.relativePath, error: `Upload failed: ${errorMsg}` });\n        } else {\n          throw new Error(`Failed to upload ${file.relativePath}: ${errorMsg}`);\n        }\n      }\n    });\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // PHASE 6: Link children to parents using bulk operations\n    // ─────────────────────────────────────────────────────────────────────────\n    reportProgress({ phase: 'linking' });\n\n    // Build file path -> entity map\n    const filePathToEntity = new Map<string, CreatedFile>();\n    for (const file of createdFiles) {\n      filePathToEntity.set(file.relativePath, file);\n    }\n\n    // Group items by their parent path\n    // For root items (no parent path), parent is rootParentId (collection or specified folder)\n    const parentGroups = new Map<string, { folderId: string; children: { id: string }[] }>();\n\n    // Add folders to their parent groups\n    for (const folder of createdFolders) {\n      const parentPath = getParentPath(folder.relativePath);\n      let parentId: string;\n\n      if (parentPath === null) {\n        // Root level folder - parent is the target\n        parentId = rootParentId;\n      } else {\n        // Nested folder - find parent folder entity\n        const parentFolder = folderPathToEntity.get(parentPath);\n        if (!parentFolder) {\n          errors.push({\n            path: folder.relativePath,\n            error: `Parent folder not found: ${parentPath}`,\n          });\n          continue;\n        }\n        parentId = parentFolder.id;\n      }\n\n      if (!parentGroups.has(parentId)) {\n        parentGroups.set(parentId, { folderId: parentId, children: [] });\n      }\n      parentGroups.get(parentId)!.children.push({ id: folder.id });\n    }\n\n    // Add files to their parent groups\n    for (const file of createdFiles) {\n      const parentPath = getParentPath(file.relativePath);\n      let parentId: string;\n\n      if (parentPath === null) {\n        // Root level file - parent is the target\n        parentId = rootParentId;\n      } else {\n        // Nested file - find parent folder entity\n        const parentFolder = folderPathToEntity.get(parentPath);\n        if (!parentFolder) {\n          errors.push({\n            path: file.relativePath,\n            error: `Parent folder not found: ${parentPath}`,\n          });\n          continue;\n        }\n        parentId = parentFolder.id;\n      }\n\n      if (!parentGroups.has(parentId)) {\n        parentGroups.set(parentId, { folderId: parentId, children: [] });\n      }\n      parentGroups.get(parentId)!.children.push({ id: file.id });\n    }\n\n    // Execute bulk add children for each parent\n    // We need to get current CID for each parent before linking\n    for (const [parentId, group] of parentGroups) {\n      if (group.children.length === 0) continue;\n\n      try {\n        // Get current parent CID\n        // If parent is collection, we already have it. Otherwise fetch folder.\n        let expectTip: string;\n\n        if (parentId === collectionId) {\n          // For collection, refetch to get current CID (might have changed)\n          const { data, error } = await client.api.GET('/collections/{id}', {\n            params: { path: { id: collectionId } },\n          });\n          if (error || !data) {\n            throw new Error(`Failed to fetch collection CID: ${JSON.stringify(error)}`);\n          }\n          expectTip = data.cid;\n        } else {\n          // For folder, fetch current state\n          const { data, error } = await client.api.GET('/folders/{id}', {\n            params: { path: { id: parentId } },\n          });\n          if (error || !data) {\n            throw new Error(`Failed to fetch folder CID: ${JSON.stringify(error)}`);\n          }\n          expectTip = data.cid;\n        }\n\n        // Bulk add children\n        const bulkBody: BulkAddChildrenRequest = {\n          expect_tip: expectTip,\n          children: group.children,\n          note,\n        };\n\n        const { error } = await client.api.POST('/folders/{id}/children/bulk', {\n          params: { path: { id: parentId } },\n          body: bulkBody,\n        });\n\n        if (error) {\n          throw new Error(JSON.stringify(error));\n        }\n      } catch (err) {\n        const errorMsg = err instanceof Error ? err.message : String(err);\n        if (continueOnError) {\n          errors.push({\n            path: `parent:${parentId}`,\n            error: `Bulk linking failed: ${errorMsg}`,\n          });\n        } else {\n          throw new Error(`Failed to link children to ${parentId}: ${errorMsg}`);\n        }\n      }\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // Complete!\n    // ─────────────────────────────────────────────────────────────────────────\n    reportProgress({ phase: 'complete' });\n\n    // Build result\n    const resultFolders: CreatedEntity[] = createdFolders.map((f) => ({\n      id: f.id,\n      cid: f.entityCid,\n      type: 'folder' as const,\n      relativePath: f.relativePath,\n    }));\n\n    const resultFiles: CreatedEntity[] = createdFiles.map((f) => ({\n      id: f.id,\n      cid: f.entityCid,\n      type: 'file' as const,\n      relativePath: f.relativePath,\n    }));\n\n    return {\n      success: errors.length === 0,\n      collection: {\n        id: collectionId,\n        cid: collectionCid,\n        created: collectionCreated,\n      },\n      folders: resultFolders,\n      files: resultFiles,\n      errors,\n    };\n  } catch (err) {\n    const errorMsg = err instanceof Error ? err.message : String(err);\n\n    reportProgress({\n      phase: 'error',\n      error: errorMsg,\n    });\n\n    return {\n      success: false,\n      collection: {\n        id: target.collectionId ?? '',\n        cid: '',\n        created: false,\n      },\n      folders: createdFolders.map((f) => ({\n        id: f.id,\n        cid: f.entityCid,\n        type: 'folder' as const,\n        relativePath: f.relativePath,\n      })),\n      files: createdFiles.map((f) => ({\n        id: f.id,\n        cid: f.entityCid,\n        type: 'file' as const,\n        relativePath: f.relativePath,\n      })),\n      errors: [...errors, { path: '', error: errorMsg }],\n    };\n  }\n}\n","/**\n * Platform-specific Scanners\n *\n * Helpers to build UploadTree from different input sources.\n * These are optional utilities - users can also build UploadTree manually.\n */\n\n/// <reference lib=\"dom\" />\n\nimport type { UploadTree, UploadFile, UploadFolder } from './types.js';\n\n/**\n * Detect MIME type from filename.\n * Falls back to 'application/octet-stream' if unknown.\n */\nexport function getMimeType(filename: string): string {\n  const ext = filename.toLowerCase().split('.').pop() || '';\n\n  const mimeTypes: Record<string, string> = {\n    // Images\n    jpg: 'image/jpeg',\n    jpeg: 'image/jpeg',\n    png: 'image/png',\n    gif: 'image/gif',\n    webp: 'image/webp',\n    svg: 'image/svg+xml',\n    ico: 'image/x-icon',\n    bmp: 'image/bmp',\n    tiff: 'image/tiff',\n    tif: 'image/tiff',\n\n    // Documents\n    pdf: 'application/pdf',\n    doc: 'application/msword',\n    docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n    xls: 'application/vnd.ms-excel',\n    xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n    ppt: 'application/vnd.ms-powerpoint',\n    pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',\n    odt: 'application/vnd.oasis.opendocument.text',\n    ods: 'application/vnd.oasis.opendocument.spreadsheet',\n    odp: 'application/vnd.oasis.opendocument.presentation',\n\n    // Text\n    txt: 'text/plain',\n    md: 'text/markdown',\n    csv: 'text/csv',\n    html: 'text/html',\n    htm: 'text/html',\n    css: 'text/css',\n    xml: 'text/xml',\n    rtf: 'application/rtf',\n\n    // Code\n    js: 'text/javascript',\n    mjs: 'text/javascript',\n    ts: 'text/typescript',\n    jsx: 'text/javascript',\n    tsx: 'text/typescript',\n    json: 'application/json',\n    yaml: 'text/yaml',\n    yml: 'text/yaml',\n\n    // Archives\n    zip: 'application/zip',\n    tar: 'application/x-tar',\n    gz: 'application/gzip',\n    rar: 'application/vnd.rar',\n    '7z': 'application/x-7z-compressed',\n\n    // Audio\n    mp3: 'audio/mpeg',\n    wav: 'audio/wav',\n    ogg: 'audio/ogg',\n    m4a: 'audio/mp4',\n    flac: 'audio/flac',\n\n    // Video\n    mp4: 'video/mp4',\n    webm: 'video/webm',\n    avi: 'video/x-msvideo',\n    mov: 'video/quicktime',\n    mkv: 'video/x-matroska',\n\n    // Fonts\n    woff: 'font/woff',\n    woff2: 'font/woff2',\n    ttf: 'font/ttf',\n    otf: 'font/otf',\n\n    // Other\n    wasm: 'application/wasm',\n  };\n\n  return mimeTypes[ext] || 'application/octet-stream';\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Node.js Scanner\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Scan a local directory and build an UploadTree.\n *\n * **Node.js only** - uses fs and path modules.\n *\n * @param directoryPath - Absolute path to directory\n * @param options - Scanner options\n * @returns UploadTree ready for upload\n *\n * @example\n * ```typescript\n * import { scanDirectory } from '@arke-institute/sdk/operations';\n *\n * const tree = await scanDirectory('/path/to/my-project');\n * const result = await uploadTree(client, tree, { target: { collectionId: '...' } });\n * ```\n */\nexport async function scanDirectory(\n  directoryPath: string,\n  options: {\n    /** Patterns to ignore (glob-style, e.g., 'node_modules', '.git') */\n    ignore?: string[];\n    /** Whether to include hidden files (default: false) */\n    includeHidden?: boolean;\n  } = {}\n): Promise<UploadTree> {\n  // Dynamic import for Node.js modules (allows SDK to be used in browser too)\n  const fs = await import('node:fs/promises');\n  const path = await import('node:path');\n\n  const { ignore = ['node_modules', '.git', '.DS_Store'], includeHidden = false } = options;\n\n  const files: UploadFile[] = [];\n  const folders: UploadFolder[] = [];\n\n  // Get the root folder name\n  const rootName = path.basename(directoryPath);\n\n  async function scanDir(dirPath: string, relativePath: string): Promise<void> {\n    const entries = await fs.readdir(dirPath, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const name = entry.name;\n\n      // Skip hidden files unless explicitly included\n      if (!includeHidden && name.startsWith('.')) {\n        continue;\n      }\n\n      // Skip ignored patterns\n      if (ignore.some((pattern) => name === pattern || name.match(pattern))) {\n        continue;\n      }\n\n      const fullPath = path.join(dirPath, name);\n      const entryRelativePath = relativePath ? `${relativePath}/${name}` : name;\n\n      if (entry.isDirectory()) {\n        folders.push({\n          name,\n          relativePath: entryRelativePath,\n        });\n\n        // Recurse into subdirectory\n        await scanDir(fullPath, entryRelativePath);\n      } else if (entry.isFile()) {\n        const stat = await fs.stat(fullPath);\n\n        files.push({\n          name,\n          relativePath: entryRelativePath,\n          size: stat.size,\n          mimeType: getMimeType(name),\n          getData: async () => {\n            const buffer = await fs.readFile(fullPath);\n            // Convert Node.js Buffer to ArrayBuffer\n            return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);\n          },\n        });\n      }\n      // Skip symlinks, etc.\n    }\n  }\n\n  await scanDir(directoryPath, '');\n\n  // Sort folders by depth (important for creation order)\n  folders.sort((a, b) => a.relativePath.split('/').length - b.relativePath.split('/').length);\n\n  return { files, folders };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Browser Scanners\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Scan browser FileSystemEntry objects (from drag-drop or showDirectoryPicker).\n *\n * **Browser only** - uses FileSystemEntry API.\n *\n * @param entries - FileSystemEntry array from DataTransferItem.webkitGetAsEntry()\n * @returns UploadTree ready for upload\n *\n * @example\n * ```typescript\n * // In a drop handler\n * dropzone.ondrop = async (e) => {\n *   const entries = Array.from(e.dataTransfer.items)\n *     .map(item => item.webkitGetAsEntry())\n *     .filter(Boolean);\n *\n *   const tree = await scanFileSystemEntries(entries);\n *   const result = await uploadTree(client, tree, { target: { collectionId: '...' } });\n * };\n * ```\n */\nexport async function scanFileSystemEntries(\n  entries: FileSystemEntry[],\n  options: {\n    /** Patterns to ignore */\n    ignore?: string[];\n  } = {}\n): Promise<UploadTree> {\n  const { ignore = ['node_modules', '.git', '.DS_Store'] } = options;\n\n  const files: UploadFile[] = [];\n  const folders: UploadFolder[] = [];\n\n  async function processEntry(entry: FileSystemEntry, parentPath: string): Promise<void> {\n    const name = entry.name;\n\n    // Skip ignored patterns\n    if (ignore.some((pattern) => name === pattern)) {\n      return;\n    }\n\n    const relativePath = parentPath ? `${parentPath}/${name}` : name;\n\n    if (entry.isFile) {\n      const fileEntry = entry as FileSystemFileEntry;\n\n      // Get File object from FileSystemFileEntry\n      const file = await new Promise<File>((resolve, reject) => {\n        fileEntry.file(resolve, reject);\n      });\n\n      files.push({\n        name,\n        relativePath,\n        size: file.size,\n        mimeType: file.type || getMimeType(name),\n        getData: async () => file.arrayBuffer(),\n      });\n    } else if (entry.isDirectory) {\n      const dirEntry = entry as FileSystemDirectoryEntry;\n\n      folders.push({\n        name,\n        relativePath,\n      });\n\n      // Read directory contents\n      const reader = dirEntry.createReader();\n      const childEntries = await new Promise<FileSystemEntry[]>((resolve, reject) => {\n        const allEntries: FileSystemEntry[] = [];\n\n        function readEntries() {\n          reader.readEntries((entries) => {\n            if (entries.length === 0) {\n              resolve(allEntries);\n            } else {\n              allEntries.push(...entries);\n              readEntries(); // Continue reading (readEntries returns max 100 at a time)\n            }\n          }, reject);\n        }\n\n        readEntries();\n      });\n\n      // Process children\n      for (const childEntry of childEntries) {\n        await processEntry(childEntry, relativePath);\n      }\n    }\n  }\n\n  // Process all root entries\n  for (const entry of entries) {\n    if (entry) {\n      await processEntry(entry, '');\n    }\n  }\n\n  // Sort folders by depth\n  folders.sort((a, b) => a.relativePath.split('/').length - b.relativePath.split('/').length);\n\n  return { files, folders };\n}\n\n/**\n * Build UploadTree from a FileList (from <input type=\"file\"> with webkitdirectory).\n *\n * **Browser only** - uses File API.\n *\n * @param fileList - FileList from input element\n * @returns UploadTree ready for upload\n *\n * @example\n * ```typescript\n * <input type=\"file\" webkitdirectory multiple onChange={async (e) => {\n *   const tree = await scanFileList(e.target.files);\n *   const result = await uploadTree(client, tree, { target: { collectionId: '...' } });\n * }} />\n * ```\n */\nexport async function scanFileList(\n  fileList: FileList,\n  options: {\n    /** Patterns to ignore */\n    ignore?: string[];\n  } = {}\n): Promise<UploadTree> {\n  const { ignore = ['node_modules', '.git', '.DS_Store'] } = options;\n\n  const files: UploadFile[] = [];\n  const folderPaths = new Set<string>();\n\n  for (let i = 0; i < fileList.length; i++) {\n    const file = fileList[i];\n    if (!file) continue;\n\n    // webkitRelativePath gives us the path including the root folder\n    const relativePath = file.webkitRelativePath || file.name;\n    const name = file.name;\n\n    // Skip ignored patterns (check each path segment)\n    const pathSegments = relativePath.split('/');\n    if (pathSegments.some((segment: string) => ignore.includes(segment))) {\n      continue;\n    }\n\n    // Extract folder paths\n    const pathParts = relativePath.split('/');\n    for (let j = 1; j < pathParts.length; j++) {\n      const folderPath = pathParts.slice(0, j).join('/');\n      folderPaths.add(folderPath);\n    }\n\n    // Capture file reference for closure\n    const fileRef = file;\n    files.push({\n      name,\n      relativePath,\n      size: fileRef.size,\n      mimeType: fileRef.type || getMimeType(name),\n      getData: async () => fileRef.arrayBuffer(),\n    });\n  }\n\n  // Convert folder paths to UploadFolder objects\n  const folders: UploadFolder[] = Array.from(folderPaths)\n    .map((path) => ({\n      name: path.split('/').pop()!,\n      relativePath: path,\n    }))\n    .sort((a, b) => a.relativePath.split('/').length - b.relativePath.split('/').length);\n\n  return { files, folders };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Utility: Build tree from flat file list\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Build an UploadTree from a flat array of files with paths.\n *\n * Useful for programmatically constructing uploads without filesystem access.\n *\n * @param items - Array of file items with path, data, and optional metadata\n * @returns UploadTree ready for upload\n *\n * @example\n * ```typescript\n * const tree = buildUploadTree([\n *   { path: 'docs/readme.md', data: new Blob(['# Hello']) },\n *   { path: 'docs/images/logo.png', data: logoBlob },\n * ]);\n * ```\n */\nexport function buildUploadTree(\n  items: Array<{\n    /** Relative path (e.g., \"docs/readme.md\") */\n    path: string;\n    /** File data */\n    data: Blob | ArrayBuffer | Uint8Array;\n    /** MIME type (auto-detected if not provided) */\n    mimeType?: string;\n  }>\n): UploadTree {\n  const files: UploadFile[] = [];\n  const folderPaths = new Set<string>();\n\n  for (const item of items) {\n    const pathParts = item.path.split('/');\n    const name = pathParts.pop()!;\n\n    // Extract folder paths\n    for (let i = 1; i <= pathParts.length; i++) {\n      folderPaths.add(pathParts.slice(0, i).join('/'));\n    }\n\n    // Determine size\n    let size: number;\n    if (item.data instanceof Blob) {\n      size = item.data.size;\n    } else if (item.data instanceof ArrayBuffer) {\n      size = item.data.byteLength;\n    } else {\n      size = item.data.length;\n    }\n\n    files.push({\n      name,\n      relativePath: item.path,\n      size,\n      mimeType: item.mimeType || getMimeType(name),\n      getData: async () => item.data,\n    });\n  }\n\n  const folders: UploadFolder[] = Array.from(folderPaths)\n    .map((path) => ({\n      name: path.split('/').pop()!,\n      relativePath: path,\n    }))\n    .sort((a, b) => a.relativePath.split('/').length - b.relativePath.split('/').length);\n\n  return { files, folders };\n}\n","/**\n * Folder Operations (Legacy)\n *\n * @deprecated Use the new upload module instead:\n * ```typescript\n * import { uploadTree, scanDirectory } from '@arke-institute/sdk/operations';\n *\n * const tree = await scanDirectory('/path/to/folder');\n * const result = await uploadTree(client, tree, {\n *   target: { collectionId: '...' },\n * });\n * ```\n */\n\nimport type { ArkeClient } from '../client/ArkeClient.js';\nimport { uploadTree, scanDirectory, type UploadResult } from './upload/index.js';\n\n/**\n * @deprecated Use UploadProgress from upload module\n */\nexport interface UploadProgress {\n  phase: 'scanning' | 'creating-folders' | 'uploading-files' | 'linking' | 'complete';\n  totalFiles: number;\n  completedFiles: number;\n  totalFolders: number;\n  completedFolders: number;\n  currentFile?: string;\n}\n\n/**\n * @deprecated Use UploadOptions from upload module\n */\nexport interface UploadDirectoryOptions {\n  /** Collection to upload into */\n  collectionId: string;\n  /** Parent folder ID (optional - creates at root if not provided) */\n  parentFolderId?: string;\n  /** Progress callback */\n  onProgress?: (progress: UploadProgress) => void;\n  /** Max concurrent uploads */\n  concurrency?: number;\n}\n\n/**\n * @deprecated Use UploadResult from upload module\n */\nexport interface UploadDirectoryResult {\n  /** Root folder entity */\n  rootFolder: unknown;\n  /** All created folder entities */\n  folders: unknown[];\n  /** All created file entities */\n  files: unknown[];\n}\n\n/**\n * Folder operations helper\n *\n * @deprecated Use uploadTree and scanDirectory functions instead:\n * ```typescript\n * import { uploadTree, scanDirectory } from '@arke-institute/sdk/operations';\n *\n * const tree = await scanDirectory('/path/to/folder');\n * const result = await uploadTree(client, tree, {\n *   target: { collectionId: '...' },\n *   onProgress: (p) => console.log(`${p.completedFiles}/${p.totalFiles} files`),\n * });\n * ```\n */\nexport class FolderOperations {\n  constructor(private client: ArkeClient) {}\n\n  /**\n   * Upload a local directory to Arke\n   *\n   * @deprecated Use uploadTree and scanDirectory instead\n   */\n  async uploadDirectory(\n    localPath: string,\n    options: UploadDirectoryOptions\n  ): Promise<UploadDirectoryResult> {\n    // Use the new implementation\n    const tree = await scanDirectory(localPath);\n\n    const result: UploadResult = await uploadTree(this.client, tree, {\n      target: {\n        collectionId: options.collectionId,\n        parentId: options.parentFolderId,\n      },\n      concurrency: options.concurrency,\n      onProgress: options.onProgress\n        ? (p) => {\n            // Map new progress to old format\n            options.onProgress!({\n              phase:\n                p.phase === 'computing-cids' || p.phase === 'creating-folders'\n                  ? 'creating-folders'\n                  : p.phase === 'creating-files' || p.phase === 'uploading-content'\n                    ? 'uploading-files'\n                    : p.phase === 'linking'\n                      ? 'linking'\n                      : p.phase === 'complete'\n                        ? 'complete'\n                        : 'scanning',\n              totalFiles: p.totalFiles,\n              completedFiles: p.completedFiles,\n              totalFolders: p.totalFolders,\n              completedFolders: p.completedFolders,\n              currentFile: p.currentFile,\n            });\n          }\n        : undefined,\n    });\n\n    return {\n      rootFolder: result.folders[0] || null,\n      folders: result.folders,\n      files: result.files,\n    };\n  }\n}\n","/**\n * Batch Operations\n *\n * High-level operations for bulk entity and relationship management.\n *\n * TODO: Implement batch operations\n * - createEntities: Create multiple entities in parallel\n * - updateEntities: Update multiple entities in parallel\n * - createRelationships: Create multiple relationships in parallel\n */\n\nimport type { ArkeClient } from '../client/ArkeClient.js';\n\nexport interface BatchCreateOptions {\n  /** Max concurrent operations */\n  concurrency?: number;\n  /** Continue on individual failures */\n  continueOnError?: boolean;\n  /** Progress callback */\n  onProgress?: (completed: number, total: number) => void;\n}\n\nexport interface BatchResult<T> {\n  /** Successfully completed operations */\n  succeeded: T[];\n  /** Failed operations with errors */\n  failed: Array<{ input: unknown; error: Error }>;\n}\n\n/**\n * Batch operations helper\n *\n * @example\n * ```typescript\n * const batch = new BatchOperations(arkeClient);\n * const result = await batch.createEntities([\n *   { type: 'document', properties: { title: 'Doc 1' } },\n *   { type: 'document', properties: { title: 'Doc 2' } },\n * ], { concurrency: 5 });\n * ```\n */\nexport class BatchOperations {\n  constructor(private client: ArkeClient) {}\n\n  /**\n   * Create multiple entities in parallel\n   *\n   * TODO: Implement this method\n   */\n  async createEntities(\n    _entities: Array<{\n      collectionId: string;\n      type: string;\n      properties?: Record<string, unknown>;\n    }>,\n    _options?: BatchCreateOptions\n  ): Promise<BatchResult<unknown>> {\n    throw new Error('BatchOperations.createEntities is not yet implemented');\n  }\n\n  /**\n   * Create multiple relationships in parallel\n   *\n   * TODO: Implement this method\n   */\n  async createRelationships(\n    _relationships: Array<{\n      sourceId: string;\n      targetId: string;\n      predicate: string;\n      bidirectional?: boolean;\n      properties?: Record<string, unknown>;\n    }>,\n    _options?: BatchCreateOptions\n  ): Promise<BatchResult<unknown>> {\n    throw new Error('BatchOperations.createRelationships is not yet implemented');\n  }\n}\n","/**\n * Crypto Operations\n *\n * Cryptographic utilities for agents and content addressing.\n *\n * TODO: Implement crypto operations\n * - generateKeyPair: Generate Ed25519 key pair for agent authentication\n * - signPayload: Sign a payload with agent private key\n * - computeCID: Compute IPFS CID for content\n */\n\n/**\n * Ed25519 key pair for agent authentication\n */\nexport interface KeyPair {\n  /** Public key in base64 */\n  publicKey: string;\n  /** Private key in base64 (keep secret!) */\n  privateKey: string;\n}\n\n/**\n * Signed payload with signature\n */\nexport interface SignedPayload {\n  /** Original payload */\n  payload: string;\n  /** Ed25519 signature in base64 */\n  signature: string;\n  /** Timestamp of signature */\n  timestamp: number;\n}\n\n/**\n * Crypto operations helper\n *\n * @example\n * ```typescript\n * // Generate key pair for a new agent\n * const { publicKey, privateKey } = await CryptoOperations.generateKeyPair();\n *\n * // Sign a payload\n * const signed = await CryptoOperations.signPayload(privateKey, payload);\n * ```\n */\nexport class CryptoOperations {\n  /**\n   * Generate an Ed25519 key pair for agent authentication\n   *\n   * TODO: Implement using Node.js crypto or Web Crypto API\n   */\n  static async generateKeyPair(): Promise<KeyPair> {\n    throw new Error('CryptoOperations.generateKeyPair is not yet implemented');\n  }\n\n  /**\n   * Sign a payload with an Ed25519 private key\n   *\n   * TODO: Implement signature generation\n   */\n  static async signPayload(_privateKey: string, _payload: string): Promise<SignedPayload> {\n    throw new Error('CryptoOperations.signPayload is not yet implemented');\n  }\n\n  /**\n   * Verify an Ed25519 signature\n   *\n   * TODO: Implement signature verification\n   */\n  static async verifySignature(\n    _publicKey: string,\n    _payload: string,\n    _signature: string\n  ): Promise<boolean> {\n    throw new Error('CryptoOperations.verifySignature is not yet implemented');\n  }\n\n  /**\n   * Compute IPFS CID for content\n   *\n   * TODO: Implement using multiformats library\n   */\n  static async computeCID(_content: Uint8Array): Promise<string> {\n    throw new Error('CryptoOperations.computeCID is not yet implemented');\n  }\n}\n"],"mappings":"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","names":["error","entries"]}

package/dist/operations/index.d.cts

@@ -0,0 +1,157 @@
+import { A as ArkeClient, h as UploadTree, i as UploadOptions, j as UploadResult } from '../crypto-iYgzUi77.cjs';
+export { f as BatchCreateOptions, B as BatchOperations, g as BatchResult, n as CreatedEntity, C as CryptoOperations, F as FolderOperations, K as KeyPair, S as SignedPayload, d as UploadDirectoryOptions, e as UploadDirectoryResult, k as UploadFile, l as UploadFolder, U as UploadProgress, m as UploadTarget } from '../crypto-iYgzUi77.cjs';
+import 'openapi-fetch';
+import '../generated/index.cjs';
+
+/**
+ * Upload Engine
+ *
+ * Core upload implementation that handles the multi-phase upload process:
+ * 1. Create collection (if needed)
+ * 2. Compute CIDs for all files
+ * 3. Create all entities (folders + files) in parallel
+ * 4. Upload file content to presigned URLs
+ * 5. Bulk link children to their parents
+ */
+
+/**
+ * Main upload function.
+ * Orchestrates the entire upload process.
+ */
+declare function uploadTree(client: ArkeClient, tree: UploadTree, options: UploadOptions): Promise<UploadResult>;
+
+/**
+ * CID Computation Utility
+ *
+ * Computes IPFS CIDv1 (base32) for file content.
+ * Uses raw codec (0x55) and SHA-256 hash.
+ */
+/**
+ * Compute CIDv1 for binary content.
+ * Returns base32 encoded string (bafk... prefix for raw codec).
+ *
+ * @param data - Binary content as ArrayBuffer, Uint8Array, or Blob
+ * @returns CIDv1 string in base32 encoding
+ *
+ * @example
+ * ```typescript
+ * const cid = await computeCid(new TextEncoder().encode('hello world'));
+ * // Returns: "bafkreifzjut3te2nhyekklss27nh3k72ysco7y32koao5eei66wof36n5e"
+ * ```
+ */
+declare function computeCid(data: ArrayBuffer | Uint8Array | Blob): Promise<string>;
+/**
+ * Verify a CID matches the content.
+ *
+ * @param data - Binary content
+ * @param expectedCid - CID to verify against
+ * @returns true if CID matches
+ */
+declare function verifyCid(data: ArrayBuffer | Uint8Array | Blob, expectedCid: string): Promise<boolean>;
+
+/**
+ * Platform-specific Scanners
+ *
+ * Helpers to build UploadTree from different input sources.
+ * These are optional utilities - users can also build UploadTree manually.
+ */
+
+/**
+ * Detect MIME type from filename.
+ * Falls back to 'application/octet-stream' if unknown.
+ */
+declare function getMimeType(filename: string): string;
+/**
+ * Scan a local directory and build an UploadTree.
+ *
+ * **Node.js only** - uses fs and path modules.
+ *
+ * @param directoryPath - Absolute path to directory
+ * @param options - Scanner options
+ * @returns UploadTree ready for upload
+ *
+ * @example
+ * ```typescript
+ * import { scanDirectory } from '@arke-institute/sdk/operations';
+ *
+ * const tree = await scanDirectory('/path/to/my-project');
+ * const result = await uploadTree(client, tree, { target: { collectionId: '...' } });
+ * ```
+ */
+declare function scanDirectory(directoryPath: string, options?: {
+    /** Patterns to ignore (glob-style, e.g., 'node_modules', '.git') */
+    ignore?: string[];
+    /** Whether to include hidden files (default: false) */
+    includeHidden?: boolean;
+}): Promise<UploadTree>;
+/**
+ * Scan browser FileSystemEntry objects (from drag-drop or showDirectoryPicker).
+ *
+ * **Browser only** - uses FileSystemEntry API.
+ *
+ * @param entries - FileSystemEntry array from DataTransferItem.webkitGetAsEntry()
+ * @returns UploadTree ready for upload
+ *
+ * @example
+ * ```typescript
+ * // In a drop handler
+ * dropzone.ondrop = async (e) => {
+ *   const entries = Array.from(e.dataTransfer.items)
+ *     .map(item => item.webkitGetAsEntry())
+ *     .filter(Boolean);
+ *
+ *   const tree = await scanFileSystemEntries(entries);
+ *   const result = await uploadTree(client, tree, { target: { collectionId: '...' } });
+ * };
+ * ```
+ */
+declare function scanFileSystemEntries(entries: FileSystemEntry[], options?: {
+    /** Patterns to ignore */
+    ignore?: string[];
+}): Promise<UploadTree>;
+/**
+ * Build UploadTree from a FileList (from <input type="file"> with webkitdirectory).
+ *
+ * **Browser only** - uses File API.
+ *
+ * @param fileList - FileList from input element
+ * @returns UploadTree ready for upload
+ *
+ * @example
+ * ```typescript
+ * <input type="file" webkitdirectory multiple onChange={async (e) => {
+ *   const tree = await scanFileList(e.target.files);
+ *   const result = await uploadTree(client, tree, { target: { collectionId: '...' } });
+ * }} />
+ * ```
+ */
+declare function scanFileList(fileList: FileList, options?: {
+    /** Patterns to ignore */
+    ignore?: string[];
+}): Promise<UploadTree>;
+/**
+ * Build an UploadTree from a flat array of files with paths.
+ *
+ * Useful for programmatically constructing uploads without filesystem access.
+ *
+ * @param items - Array of file items with path, data, and optional metadata
+ * @returns UploadTree ready for upload
+ *
+ * @example
+ * ```typescript
+ * const tree = buildUploadTree([
+ *   { path: 'docs/readme.md', data: new Blob(['# Hello']) },
+ *   { path: 'docs/images/logo.png', data: logoBlob },
+ * ]);
+ * ```
+ */
+declare function buildUploadTree(items: Array<{
+    /** Relative path (e.g., "docs/readme.md") */
+    path: string;
+    /** File data */
+    data: Blob | ArrayBuffer | Uint8Array;
+    /** MIME type (auto-detected if not provided) */
+    mimeType?: string;
+}>): UploadTree;
+
+export { UploadOptions, UploadResult, UploadTree, buildUploadTree, computeCid, getMimeType, scanDirectory, scanFileList, scanFileSystemEntries, uploadTree, verifyCid };

package/dist/operations/index.d.ts

@@ -0,0 +1,157 @@
+import { A as ArkeClient, h as UploadTree, i as UploadOptions, j as UploadResult } from '../crypto-CQnwqWQn.js';
+export { f as BatchCreateOptions, B as BatchOperations, g as BatchResult, n as CreatedEntity, C as CryptoOperations, F as FolderOperations, K as KeyPair, S as SignedPayload, d as UploadDirectoryOptions, e as UploadDirectoryResult, k as UploadFile, l as UploadFolder, U as UploadProgress, m as UploadTarget } from '../crypto-CQnwqWQn.js';
+import 'openapi-fetch';
+import '../generated/index.js';
+
+/**
+ * Upload Engine
+ *
+ * Core upload implementation that handles the multi-phase upload process:
+ * 1. Create collection (if needed)
+ * 2. Compute CIDs for all files
+ * 3. Create all entities (folders + files) in parallel
+ * 4. Upload file content to presigned URLs
+ * 5. Bulk link children to their parents
+ */
+
+/**
+ * Main upload function.
+ * Orchestrates the entire upload process.
+ */
+declare function uploadTree(client: ArkeClient, tree: UploadTree, options: UploadOptions): Promise<UploadResult>;
+
+/**
+ * CID Computation Utility
+ *
+ * Computes IPFS CIDv1 (base32) for file content.
+ * Uses raw codec (0x55) and SHA-256 hash.
+ */
+/**
+ * Compute CIDv1 for binary content.
+ * Returns base32 encoded string (bafk... prefix for raw codec).
+ *
+ * @param data - Binary content as ArrayBuffer, Uint8Array, or Blob
+ * @returns CIDv1 string in base32 encoding
+ *
+ * @example
+ * ```typescript
+ * const cid = await computeCid(new TextEncoder().encode('hello world'));
+ * // Returns: "bafkreifzjut3te2nhyekklss27nh3k72ysco7y32koao5eei66wof36n5e"
+ * ```
+ */
+declare function computeCid(data: ArrayBuffer | Uint8Array | Blob): Promise<string>;
+/**
+ * Verify a CID matches the content.
+ *
+ * @param data - Binary content
+ * @param expectedCid - CID to verify against
+ * @returns true if CID matches
+ */
+declare function verifyCid(data: ArrayBuffer | Uint8Array | Blob, expectedCid: string): Promise<boolean>;
+
+/**
+ * Platform-specific Scanners
+ *
+ * Helpers to build UploadTree from different input sources.
+ * These are optional utilities - users can also build UploadTree manually.
+ */
+
+/**
+ * Detect MIME type from filename.
+ * Falls back to 'application/octet-stream' if unknown.
+ */
+declare function getMimeType(filename: string): string;
+/**
+ * Scan a local directory and build an UploadTree.
+ *
+ * **Node.js only** - uses fs and path modules.
+ *
+ * @param directoryPath - Absolute path to directory
+ * @param options - Scanner options
+ * @returns UploadTree ready for upload
+ *
+ * @example
+ * ```typescript
+ * import { scanDirectory } from '@arke-institute/sdk/operations';
+ *
+ * const tree = await scanDirectory('/path/to/my-project');
+ * const result = await uploadTree(client, tree, { target: { collectionId: '...' } });
+ * ```
+ */
+declare function scanDirectory(directoryPath: string, options?: {
+    /** Patterns to ignore (glob-style, e.g., 'node_modules', '.git') */
+    ignore?: string[];
+    /** Whether to include hidden files (default: false) */
+    includeHidden?: boolean;
+}): Promise<UploadTree>;
+/**
+ * Scan browser FileSystemEntry objects (from drag-drop or showDirectoryPicker).
+ *
+ * **Browser only** - uses FileSystemEntry API.
+ *
+ * @param entries - FileSystemEntry array from DataTransferItem.webkitGetAsEntry()
+ * @returns UploadTree ready for upload
+ *
+ * @example
+ * ```typescript
+ * // In a drop handler
+ * dropzone.ondrop = async (e) => {
+ *   const entries = Array.from(e.dataTransfer.items)
+ *     .map(item => item.webkitGetAsEntry())
+ *     .filter(Boolean);
+ *
+ *   const tree = await scanFileSystemEntries(entries);
+ *   const result = await uploadTree(client, tree, { target: { collectionId: '...' } });
+ * };
+ * ```
+ */
+declare function scanFileSystemEntries(entries: FileSystemEntry[], options?: {
+    /** Patterns to ignore */
+    ignore?: string[];
+}): Promise<UploadTree>;
+/**
+ * Build UploadTree from a FileList (from <input type="file"> with webkitdirectory).
+ *
+ * **Browser only** - uses File API.
+ *
+ * @param fileList - FileList from input element
+ * @returns UploadTree ready for upload
+ *
+ * @example
+ * ```typescript
+ * <input type="file" webkitdirectory multiple onChange={async (e) => {
+ *   const tree = await scanFileList(e.target.files);
+ *   const result = await uploadTree(client, tree, { target: { collectionId: '...' } });
+ * }} />
+ * ```
+ */
+declare function scanFileList(fileList: FileList, options?: {
+    /** Patterns to ignore */
+    ignore?: string[];
+}): Promise<UploadTree>;
+/**
+ * Build an UploadTree from a flat array of files with paths.
+ *
+ * Useful for programmatically constructing uploads without filesystem access.
+ *
+ * @param items - Array of file items with path, data, and optional metadata
+ * @returns UploadTree ready for upload
+ *
+ * @example
+ * ```typescript
+ * const tree = buildUploadTree([
+ *   { path: 'docs/readme.md', data: new Blob(['# Hello']) },
+ *   { path: 'docs/images/logo.png', data: logoBlob },
+ * ]);
+ * ```
+ */
+declare function buildUploadTree(items: Array<{
+    /** Relative path (e.g., "docs/readme.md") */
+    path: string;
+    /** File data */
+    data: Blob | ArrayBuffer | Uint8Array;
+    /** MIME type (auto-detected if not provided) */
+    mimeType?: string;
+}>): UploadTree;
+
+export { UploadOptions, UploadResult, UploadTree, buildUploadTree, computeCid, getMimeType, scanDirectory, scanFileList, scanFileSystemEntries, uploadTree, verifyCid };