Add realm operations API to BoxelCLIClient

packages/boxel-cli/api.ts

@@ -2,4 +2,14 @@ export {
   BoxelCLIClient,
   type CreateRealmOptions,
   type CreateRealmResult,
+  type PullOptions,
+  type PullResult,
+  type ReadResult,
+  type WriteResult,
+  type DeleteResult,
+  type SearchResult,
+  type ListFilesResult,
+  type RunCommandResult,
+  type LintMessage,
+  type LintResult,
 } from './src/lib/boxel-cli-client';

packages/boxel-cli/src/commands/realm/pull.ts

@@ -17,6 +17,7 @@ interface PullOptions extends SyncOptions {
 
 class RealmPuller extends RealmSyncBase {
   hasError = false;
+  downloadedFiles: string[] = [];
 
   constructor(
     private pullOptions: PullOptions,
@@ -106,7 +107,7 @@ class RealmPuller extends RealmSyncBase {
         }),
       ),
     );
-    const downloadedFiles = downloadResults.filter(
+    this.downloadedFiles = downloadResults.filter(
       (f): f is string => f !== null,
     );
 
@@ -138,10 +139,10 @@ class RealmPuller extends RealmSyncBase {
 
     if (
       !this.options.dryRun &&
-      downloadedFiles.length + deletedFiles.length > 0
+      this.downloadedFiles.length + deletedFiles.length > 0
     ) {
       const pullChanges: CheckpointChange[] = [
-        ...downloadedFiles.map((f) => ({
+        ...this.downloadedFiles.map((f) => ({
           file: f,
           status: 'modified' as const,
         })),
@@ -232,3 +233,46 @@ export async function pullCommand(
     process.exit(1);
   }
 }
+
+export async function pull(
+  realmUrl: string,
+  localDir: string,
+  options: PullCommandOptions,
+): Promise<{ files: string[]; error?: string }> {
+  let pm = options.profileManager ?? getProfileManager();
+  let active = pm.getActiveProfile();
+  if (!active) {
+    return {
+      files: [],
+      error: 'No active profile. Run `boxel profile add` to create one.',
+    };
+  }
+
+  try {
+    const puller = new RealmPuller(
+      {
+        realmUrl,
+        localDir,
+        deleteLocal: options.delete,
+      },
+      pm,
+    );
+
+    await puller.sync();
+
+    if (puller.hasError) {
+      return {
+        files: puller.downloadedFiles.sort(),
+        error:
+          'Pull completed with errors. Some files may not have been downloaded.',
+      };
+    }
+
+    return { files: puller.downloadedFiles.sort() };
+  } catch (error) {
+    return {
+      files: [],
+      error: `Pull failed: ${error instanceof Error ? error.message : String(error)}`,
+    };
+  }
+}