farseer-cli 1.0.0

package/dist/mcp/tools/syncTools.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/tools/syncTools.ts"],
+  "sourcesContent": ["/**\n * File Synchronization Tools\n *\n * Tools for syncing files between local repository and Farseer instance.\n */\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\nimport { createPatch } from 'diff';\nimport { SyncService } from '../../services/syncService';\nimport { AppSyncService } from '../../services/appSyncService';\nimport { getFarseerClientWithFallback } from '../../services/farseerFactory';\nimport { getCurrentCheckout } from '../../services/configService';\nimport {\n    successResponse,\n    errorResponse,\n    authRequiredResponse,\n    tenantRequiredResponse,\n} from '../utils/helpers';\n\n// Define schemas outside of tool registration to avoid deep type instantiation\nconst pullSchema = {\n    tenant: z.string().optional().describe('Tenant name. Uses checked-out tenant if omitted.'),\n    tenantId: z\n        .string()\n        .optional()\n        .describe('Override X-TENANT-ID header if different from tenant name'),\n    all: z.boolean().optional().describe('Download all files, not just scripts (.ts, .js)'),\n};\n\nconst pushSchema = {\n    tenant: z.string().optional().describe('Tenant name. Uses checked-out tenant if omitted.'),\n    tenantId: z\n        .string()\n        .optional()\n        .describe('Override X-TENANT-ID header if different from tenant name'),\n    force: z.boolean().optional().describe('Skip remote changes check (may overwrite remote changes)'),\n};\n\nconst statusSchema = {\n    tenant: z.string().optional().describe('Tenant name. Uses checked-out tenant if omitted.'),\n    tenantId: z.string().optional().describe('Override X-TENANT-ID header'),\n    all: z.boolean().optional().describe('Show all files, not just scripts'),\n};\n\nconst diffSchema = {\n    tenant: z.string().optional().describe('Tenant name'),\n    file: z.string().optional().describe('Specific file path to diff. If omitted, shows all differences.'),\n    showRemote: z.boolean().optional().describe('Show only the remote content instead of diff'),\n};\n\nconst listFilesSchema = {\n    tenant: z.string().optional().describe('Tenant name'),\n    all: z.boolean().optional().describe('Show all files, not just scripts'),\n};\n\nexport function registerSyncTools(server: McpServer): void {\n    // farseer_pull - Download files from remote\n    server.tool(\n        'farseer_pull',\n        `Pull (download) files and app configurations from a Farseer instance to the local repository.\n\nWhat gets pulled:\n- TypeScript/JavaScript scripts from Files/ folder (searched recursively)\n- App configurations (saved as JSON in apps/ folder)\n\nFiles are saved to: apps/<tenant>/files/\nApps are saved to: apps/<tenant>/apps/\n\nBy default only script files (.ts, .js, .mjs, .cjs) are pulled.\nUse all=true to pull all files including images, data files, etc.\n\nIf no tenant is specified, uses the currently checked-out tenant.`,\n        pullSchema,\n        async (params: { tenant?: string; tenantId?: string; all?: boolean }) => {\n            const { tenant: tenantArg, tenantId, all } = params;\n            const checkout = getCurrentCheckout();\n            const tenant = tenantArg || checkout?.tenant;\n            const organisation = tenantArg || checkout?.organisation;\n\n            if (!tenant || !organisation) {\n                return tenantRequiredResponse();\n            }\n\n            const clientResult = await getFarseerClientWithFallback(organisation, tenantId || tenant);\n            if (!clientResult) {\n                return authRequiredResponse(tenant);\n            }\n\n            try {\n                // Pull files\n                const syncService = new SyncService(organisation, clientResult.client);\n                const fileResult = await syncService.pull({ all });\n\n                // Pull apps (only with JWT auth)\n                let appResult = null;\n                if (clientResult.authType === 'jwt') {\n                    const appSyncService = new AppSyncService(organisation, clientResult.client);\n                    appResult = await appSyncService.pull();\n                }\n\n                return successResponse({\n                    tenant,\n                    files: {\n                        downloaded: fileResult.downloaded,\n                        deleted: fileResult.deleted,\n                        unchanged: fileResult.unchanged.length,\n                    },\n                    apps: appResult\n                        ? {\n                              created: appResult.created,\n                              updated: appResult.updated,\n                              deleted: appResult.deleted,\n                              unchanged: appResult.unchanged.length,\n                          }\n                        : { note: 'App sync requires browser login (JWT)' },\n                    message: `Pulled ${fileResult.downloaded.length} files${appResult ? ` and ${appResult.created.length + appResult.updated.length} apps` : ''}`,\n                });\n            } catch (error) {\n                return errorResponse(\n                    `Pull failed: ${error instanceof Error ? error.message : 'Unknown error'}`,\n                    'NETWORK_ERROR'\n                );\n            }\n        }\n    );\n\n    // farseer_push - Upload files to remote\n    server.tool(\n        'farseer_push',\n        `Push (upload) local file and app changes to a Farseer instance.\n\nWhat gets pushed:\n- New/modified scripts from apps/<tenant>/files/\n- New/modified app configurations from apps/<tenant>/apps/\n- Deleted files (if they were previously synced)\n\nImportant:\n- Checks for unpulled remote changes first to prevent conflicts\n- Use force=true to skip this check (may overwrite remote changes)\n\nIf no tenant is specified, uses the currently checked-out tenant.`,\n        pushSchema,\n        async (params: { tenant?: string; tenantId?: string; force?: boolean }) => {\n            const { tenant: tenantArg, tenantId, force } = params;\n            const checkout = getCurrentCheckout();\n            const tenant = tenantArg || checkout?.tenant;\n            const organisation = tenantArg || checkout?.organisation;\n\n            if (!tenant || !organisation) {\n                return tenantRequiredResponse();\n            }\n\n            const clientResult = await getFarseerClientWithFallback(organisation, tenantId || tenant);\n            if (!clientResult) {\n                return authRequiredResponse(tenant);\n            }\n\n            try {\n                const syncService = new SyncService(organisation, clientResult.client);\n\n                // Check for remote changes unless force is true\n                if (!force) {\n                    const hasRemoteChanges = await syncService.checkRemoteChanges();\n                    if (hasRemoteChanges) {\n                        return errorResponse(\n                            'Remote has unpulled changes. Pull first or use force=true to overwrite.',\n                            'VALIDATION_ERROR'\n                        );\n                    }\n                }\n\n                // Push files\n                const fileResult = await syncService.push();\n\n                // Push apps (only with JWT auth)\n                let appResult = null;\n                if (clientResult.authType === 'jwt') {\n                    const appSyncService = new AppSyncService(organisation, clientResult.client);\n                    appResult = await appSyncService.push();\n                }\n\n                return successResponse({\n                    tenant,\n                    files: {\n                        uploaded: fileResult.uploaded,\n                        updated: fileResult.updated,\n                        deleted: fileResult.deleted,\n                        unchanged: fileResult.unchanged.length,\n                    },\n                    apps: appResult\n                        ? {\n                              created: appResult.created,\n                              updated: appResult.updated,\n                              unchanged: appResult.unchanged.length,\n                          }\n                        : { note: 'App sync requires browser login (JWT)' },\n                    summary: `Pushed ${fileResult.uploaded.length + fileResult.updated.length} files${appResult ? ` and ${appResult.created.length + appResult.updated.length} apps` : ''}`,\n                });\n            } catch (error) {\n                return errorResponse(\n                    `Push failed: ${error instanceof Error ? error.message : 'Unknown error'}`,\n                    'NETWORK_ERROR'\n                );\n            }\n        }\n    );\n\n    // farseer_status - Check sync status\n    server.tool(\n        'farseer_status',\n        `Check the synchronization status between local files and the remote Farseer instance.\n\nShows which files are:\n- Modified locally (changed since last sync)\n- Modified remotely (changed on server since last sync)\n- Only local (new files not yet pushed)\n- Only remote (files not yet pulled)\n- In sync (no changes)\n\nAlso shows app sync status if using JWT authentication.\n\nIf no tenant is specified, uses the currently checked-out tenant.`,\n        statusSchema,\n        async (params: { tenant?: string; tenantId?: string; all?: boolean }) => {\n            const { tenant: tenantArg, tenantId, all } = params;\n            const checkout = getCurrentCheckout();\n            const tenant = tenantArg || checkout?.tenant;\n            const organisation = tenantArg || checkout?.organisation;\n\n            if (!tenant || !organisation) {\n                return tenantRequiredResponse();\n            }\n\n            const clientResult = await getFarseerClientWithFallback(organisation, tenantId || tenant);\n            if (!clientResult) {\n                return authRequiredResponse(tenant);\n            }\n\n            try {\n                const syncService = new SyncService(organisation, clientResult.client);\n                const fileStatus = await syncService.getStatus({ all });\n\n                // Get app status (only with JWT auth)\n                let appStatus = null;\n                if (clientResult.authType === 'jwt') {\n                    const appSyncService = new AppSyncService(organisation, clientResult.client);\n                    appStatus = await appSyncService.getStatus();\n                }\n\n                const hasChanges =\n                    fileStatus.modifiedLocally.length > 0 ||\n                    fileStatus.modifiedRemotely.length > 0 ||\n                    fileStatus.onlyLocal.length > 0 ||\n                    fileStatus.onlyRemote.length > 0;\n\n                return successResponse({\n                    tenant,\n                    files: {\n                        modifiedLocally: fileStatus.modifiedLocally,\n                        modifiedRemotely: fileStatus.modifiedRemotely,\n                        onlyLocal: fileStatus.onlyLocal,\n                        onlyRemote: fileStatus.onlyRemote,\n                        inSync: fileStatus.inSync.length,\n                    },\n                    apps: appStatus\n                        ? {\n                              newLocal: appStatus.newLocal,\n                              newRemote: appStatus.newRemote,\n                              modified: appStatus.modified,\n                              synced: appStatus.synced.length,\n                          }\n                        : { note: 'App sync requires browser login (JWT)' },\n                    summary: hasChanges ? 'Changes detected' : 'Everything is in sync',\n                });\n            } catch (error) {\n                return errorResponse(\n                    `Status check failed: ${error instanceof Error ? error.message : 'Unknown error'}`,\n                    'NETWORK_ERROR'\n                );\n            }\n        }\n    );\n\n    // farseer_diff - Show file differences\n    server.tool(\n        'farseer_diff',\n        `Show the differences between local and remote versions of files.\n\nCan show:\n- Unified diff format (default)\n- Just the remote content (showRemote=true)\n\nUseful for reviewing changes before pull or push.\n\nIf no file is specified, shows diffs for all changed files.`,\n        diffSchema,\n        async (params: { tenant?: string; file?: string; showRemote?: boolean }) => {\n            const { tenant: tenantArg, file, showRemote } = params;\n            const checkout = getCurrentCheckout();\n            const tenant = tenantArg || checkout?.tenant;\n            const organisation = tenantArg || checkout?.organisation;\n\n            if (!tenant || !organisation) {\n                return tenantRequiredResponse();\n            }\n\n            const clientResult = await getFarseerClientWithFallback(organisation, tenant);\n            if (!clientResult) {\n                return authRequiredResponse(tenant);\n            }\n\n            try {\n                const syncService = new SyncService(organisation, clientResult.client);\n\n                if (file) {\n                    // Single file diff\n                    const { localContent, remoteContent } = await syncService.getFileDiff(file);\n\n                    if (showRemote) {\n                        return successResponse({\n                            file,\n                            remoteContent: remoteContent || '(file does not exist on remote)',\n                        });\n                    }\n\n                    const diff = createPatch(\n                        file,\n                        remoteContent || '',\n                        localContent || '',\n                        'remote',\n                        'local'\n                    );\n\n                    return successResponse({\n                        file,\n                        localExists: localContent !== null,\n                        remoteExists: remoteContent !== null,\n                        diff,\n                    });\n                } else {\n                    // All changed files\n                    const status = await syncService.getStatus();\n                    const changedFiles = [\n                        ...status.modifiedLocally,\n                        ...status.modifiedRemotely,\n                        ...status.onlyLocal,\n                        ...status.onlyRemote,\n                    ];\n\n                    const diffs: Array<{\n                        file: string;\n                        localExists: boolean;\n                        remoteExists: boolean;\n                        diff: string;\n                    }> = [];\n\n                    for (const f of changedFiles.slice(0, 10)) {\n                        // Limit to 10 files\n                        const { localContent, remoteContent } = await syncService.getFileDiff(f);\n                        const diff = createPatch(f, remoteContent || '', localContent || '', 'remote', 'local');\n                        diffs.push({\n                            file: f,\n                            localExists: localContent !== null,\n                            remoteExists: remoteContent !== null,\n                            diff,\n                        });\n                    }\n\n                    return successResponse({\n                        totalChangedFiles: changedFiles.length,\n                        diffs,\n                        note:\n                            changedFiles.length > 10\n                                ? `Showing first 10 of ${changedFiles.length} changed files`\n                                : undefined,\n                    });\n                }\n            } catch (error) {\n                return errorResponse(\n                    `Diff failed: ${error instanceof Error ? error.message : 'Unknown error'}`,\n                    'NETWORK_ERROR'\n                );\n            }\n        }\n    );\n\n    // farseer_list_files - List remote files\n    server.tool(\n        'farseer_list_files',\n        `List all files stored on the remote Farseer instance in the Files/ folder.\n\nBy default shows only script files (.ts, .js, .mjs, .cjs).\nUse all=true to show all files including images, data files, etc.\n\nReturns file paths relative to the Files/ folder.`,\n        listFilesSchema,\n        async (params: { tenant?: string; all?: boolean }) => {\n            const { tenant: tenantArg, all } = params;\n            const checkout = getCurrentCheckout();\n            const tenant = tenantArg || checkout?.tenant;\n            const organisation = tenantArg || checkout?.organisation;\n\n            if (!tenant || !organisation) {\n                return tenantRequiredResponse();\n            }\n\n            const clientResult = await getFarseerClientWithFallback(organisation, tenant);\n            if (!clientResult) {\n                return authRequiredResponse(tenant);\n            }\n\n            try {\n                let files = await clientResult.client.listFiles();\n\n                // Filter to scripts unless --all\n                if (!all) {\n                    const scriptExtensions = ['.ts', '.js', '.mjs', '.cjs'];\n                    files = files.filter((f) =>\n                        scriptExtensions.some((ext) => f.name.toLowerCase().endsWith(ext))\n                    );\n                }\n\n                // Group by directory\n                const byDirectory: Record<string, string[]> = {};\n                for (const file of files) {\n                    const dir = file.path.includes('/') ? file.path.split('/').slice(0, -1).join('/') : '.';\n                    if (!byDirectory[dir]) {\n                        byDirectory[dir] = [];\n                    }\n                    byDirectory[dir].push(file.name);\n                }\n\n                return successResponse({\n                    tenant,\n                    totalFiles: files.length,\n                    files: files.map((f) => ({\n                        name: f.name,\n                        path: f.path,\n                        reference: f.reference,\n                    })),\n                    byDirectory,\n                });\n            } catch (error) {\n                return errorResponse(\n                    `List files failed: ${error instanceof Error ? error.message : 'Unknown error'}`,\n                    'NETWORK_ERROR'\n                );\n            }\n        }\n    );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/mcp/utils/helpers.d.ts

@@ -0,0 +1,69 @@
+/**
+ * MCP Utility Functions
+ *
+ * Helper functions for MCP tools including tenant resolution and response formatting.
+ */
+import { IFarseerClient } from '../../services/farseerFactory';
+/**
+ * Resolve tenant from argument or checkout state
+ */
+export declare function resolveTenant(tenantArg?: string): string | null;
+/**
+ * Resolve organisation from argument or checkout state
+ */
+export declare function resolveOrganisation(orgArg?: string, tenantArg?: string): string | null;
+/**
+ * Get authenticated Farseer client
+ */
+export declare function getClient(tenant: string, tenantId?: string): Promise<IFarseerClient | null>;
+/**
+ * Create a success response
+ */
+export declare function successResponse(data: Record<string, unknown>): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+/**
+ * Create an error response
+ */
+export declare function errorResponse(message: string, errorCode?: 'AUTH_REQUIRED' | 'NOT_FOUND' | 'NETWORK_ERROR' | 'VALIDATION_ERROR' | 'UNKNOWN'): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError: true;
+};
+/**
+ * Create auth required error response
+ */
+export declare function authRequiredResponse(tenant?: string): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError: true;
+};
+/**
+ * Create tenant required error response
+ */
+export declare function tenantRequiredResponse(): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError: true;
+};
+/**
+ * Get auth status info
+ */
+export declare function getAuthStatus(): {
+    jwtValid: boolean;
+    jwtExpiresAt?: string;
+    currentCheckout?: {
+        organisation: string;
+        tenant: string;
+    };
+    configuredTenants: string[];
+};

package/dist/mcp/utils/helpers.js

@@ -0,0 +1,113 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var helpers_exports = {};
+__export(helpers_exports, {
+  authRequiredResponse: () => authRequiredResponse,
+  errorResponse: () => errorResponse,
+  getAuthStatus: () => getAuthStatus,
+  getClient: () => getClient,
+  resolveOrganisation: () => resolveOrganisation,
+  resolveTenant: () => resolveTenant,
+  successResponse: () => successResponse,
+  tenantRequiredResponse: () => tenantRequiredResponse
+});
+module.exports = __toCommonJS(helpers_exports);
+var import_configService = require("../../services/configService");
+var import_farseerFactory = require("../../services/farseerFactory");
+function resolveTenant(tenantArg) {
+  if (tenantArg) {
+    return tenantArg;
+  }
+  return (0, import_configService.getCurrentTenant)() || null;
+}
+function resolveOrganisation(orgArg, tenantArg) {
+  if (orgArg) {
+    return orgArg;
+  }
+  if (tenantArg) {
+    return tenantArg;
+  }
+  const checkout = (0, import_configService.getCurrentCheckout)();
+  return checkout?.organisation || null;
+}
+async function getClient(tenant, tenantId) {
+  const result = await (0, import_farseerFactory.getFarseerClientWithFallback)(tenant, tenantId);
+  return result?.client || null;
+}
+function successResponse(data) {
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify({ success: true, ...data }, null, 2)
+      }
+    ]
+  };
+}
+function errorResponse(message, errorCode) {
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(
+          {
+            success: false,
+            error: message,
+            errorCode: errorCode || "UNKNOWN"
+          },
+          null,
+          2
+        )
+      }
+    ],
+    isError: true
+  };
+}
+function authRequiredResponse(tenant) {
+  const message = tenant ? `Authentication required for tenant "${tenant}". Run "farseer login" to authenticate.` : 'Authentication required. Run "farseer login" to authenticate.';
+  return errorResponse(message, "AUTH_REQUIRED");
+}
+function tenantRequiredResponse() {
+  return errorResponse(
+    'No tenant specified. Either provide tenant parameter or run "farseer checkout <tenant>" first.',
+    "VALIDATION_ERROR"
+  );
+}
+function getAuthStatus() {
+  const auth = (0, import_configService.getUserAuth)();
+  const checkout = (0, import_configService.getCurrentCheckout)();
+  const credentials = (0, import_configService.listCredentials)();
+  return {
+    jwtValid: (0, import_configService.isUserAuthValid)(),
+    jwtExpiresAt: auth?.expiresAt,
+    currentCheckout: checkout,
+    configuredTenants: Object.keys(credentials)
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  authRequiredResponse,
+  errorResponse,
+  getAuthStatus,
+  getClient,
+  resolveOrganisation,
+  resolveTenant,
+  successResponse,
+  tenantRequiredResponse
+});
+//# sourceMappingURL=helpers.js.map

package/dist/mcp/utils/helpers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/utils/helpers.ts"],
+  "sourcesContent": ["/**\n * MCP Utility Functions\n *\n * Helper functions for MCP tools including tenant resolution and response formatting.\n */\n\nimport {\n    getCurrentCheckout,\n    getCurrentTenant,\n    getUserAuth,\n    isUserAuthValid,\n    listCredentials,\n} from '../../services/configService';\nimport { getFarseerClientWithFallback, IFarseerClient } from '../../services/farseerFactory';\n\n/**\n * Resolve tenant from argument or checkout state\n */\nexport function resolveTenant(tenantArg?: string): string | null {\n    if (tenantArg) {\n        return tenantArg;\n    }\n    return getCurrentTenant() || null;\n}\n\n/**\n * Resolve organisation from argument or checkout state\n */\nexport function resolveOrganisation(orgArg?: string, tenantArg?: string): string | null {\n    if (orgArg) {\n        return orgArg;\n    }\n    if (tenantArg) {\n        // If tenant specified but not org, assume org = tenant\n        return tenantArg;\n    }\n    const checkout = getCurrentCheckout();\n    return checkout?.organisation || null;\n}\n\n/**\n * Get authenticated Farseer client\n */\nexport async function getClient(tenant: string, tenantId?: string): Promise<IFarseerClient | null> {\n    const result = await getFarseerClientWithFallback(tenant, tenantId);\n    return result?.client || null;\n}\n\n/**\n * Create a success response\n */\nexport function successResponse(data: Record<string, unknown>): { content: Array<{ type: 'text'; text: string }> } {\n    return {\n        content: [\n            {\n                type: 'text',\n                text: JSON.stringify({ success: true, ...data }, null, 2),\n            },\n        ],\n    };\n}\n\n/**\n * Create an error response\n */\nexport function errorResponse(\n    message: string,\n    errorCode?: 'AUTH_REQUIRED' | 'NOT_FOUND' | 'NETWORK_ERROR' | 'VALIDATION_ERROR' | 'UNKNOWN'\n): { content: Array<{ type: 'text'; text: string }>; isError: true } {\n    return {\n        content: [\n            {\n                type: 'text',\n                text: JSON.stringify(\n                    {\n                        success: false,\n                        error: message,\n                        errorCode: errorCode || 'UNKNOWN',\n                    },\n                    null,\n                    2\n                ),\n            },\n        ],\n        isError: true,\n    };\n}\n\n/**\n * Create auth required error response\n */\nexport function authRequiredResponse(tenant?: string): {\n    content: Array<{ type: 'text'; text: string }>;\n    isError: true;\n} {\n    const message = tenant\n        ? `Authentication required for tenant \"${tenant}\". Run \"farseer login\" to authenticate.`\n        : 'Authentication required. Run \"farseer login\" to authenticate.';\n\n    return errorResponse(message, 'AUTH_REQUIRED');\n}\n\n/**\n * Create tenant required error response\n */\nexport function tenantRequiredResponse(): { content: Array<{ type: 'text'; text: string }>; isError: true } {\n    return errorResponse(\n        'No tenant specified. Either provide tenant parameter or run \"farseer checkout <tenant>\" first.',\n        'VALIDATION_ERROR'\n    );\n}\n\n/**\n * Get auth status info\n */\nexport function getAuthStatus(): {\n    jwtValid: boolean;\n    jwtExpiresAt?: string;\n    currentCheckout?: { organisation: string; tenant: string };\n    configuredTenants: string[];\n} {\n    const auth = getUserAuth();\n    const checkout = getCurrentCheckout();\n    const credentials = listCredentials();\n\n    return {\n        jwtValid: isUserAuthValid(),\n        jwtExpiresAt: auth?.expiresAt,\n        currentCheckout: checkout,\n        configuredTenants: Object.keys(credentials),\n    };\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,2BAMO;AACP,4BAA6D;AAKtD,SAAS,cAAc,WAAmC;AAC7D,MAAI,WAAW;AACX,WAAO;AAAA,EACX;AACA,aAAO,uCAAiB,KAAK;AACjC;AAKO,SAAS,oBAAoB,QAAiB,WAAmC;AACpF,MAAI,QAAQ;AACR,WAAO;AAAA,EACX;AACA,MAAI,WAAW;AAEX,WAAO;AAAA,EACX;AACA,QAAM,eAAW,yCAAmB;AACpC,SAAO,UAAU,gBAAgB;AACrC;AAKA,eAAsB,UAAU,QAAgB,UAAmD;AAC/F,QAAM,SAAS,UAAM,oDAA6B,QAAQ,QAAQ;AAClE,SAAO,QAAQ,UAAU;AAC7B;AAKO,SAAS,gBAAgB,MAAmF;AAC/G,SAAO;AAAA,IACH,SAAS;AAAA,MACL;AAAA,QACI,MAAM;AAAA,QACN,MAAM,KAAK,UAAU,EAAE,SAAS,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAAA,MAC5D;AAAA,IACJ;AAAA,EACJ;AACJ;AAKO,SAAS,cACZ,SACA,WACiE;AACjE,SAAO;AAAA,IACH,SAAS;AAAA,MACL;AAAA,QACI,MAAM;AAAA,QACN,MAAM,KAAK;AAAA,UACP;AAAA,YACI,SAAS;AAAA,YACT,OAAO;AAAA,YACP,WAAW,aAAa;AAAA,UAC5B;AAAA,UACA;AAAA,UACA;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAAA,IACA,SAAS;AAAA,EACb;AACJ;AAKO,SAAS,qBAAqB,QAGnC;AACE,QAAM,UAAU,SACV,uCAAuC,MAAM,4CAC7C;AAEN,SAAO,cAAc,SAAS,eAAe;AACjD;AAKO,SAAS,yBAA4F;AACxG,SAAO;AAAA,IACH;AAAA,IACA;AAAA,EACJ;AACJ;AAKO,SAAS,gBAKd;AACE,QAAM,WAAO,kCAAY;AACzB,QAAM,eAAW,yCAAmB;AACpC,QAAM,kBAAc,sCAAgB;AAEpC,SAAO;AAAA,IACH,cAAU,sCAAgB;AAAA,IAC1B,cAAc,MAAM;AAAA,IACpB,iBAAiB;AAAA,IACjB,mBAAmB,OAAO,KAAK,WAAW;AAAA,EAC9C;AACJ;",
+  "names": []
+}

package/dist/services/appSyncService.d.ts

@@ -0,0 +1,75 @@
+import { IFarseerClient } from './farseerFactory';
+export interface LocalAppConfig {
+    name: string;
+    description: string;
+    entrypoint: string | null;
+    scripts: string[];
+    arguments: {
+        name: string;
+        defaultValue: string;
+    }[];
+    _remote?: {
+        id: number;
+        reference: string;
+    };
+}
+export interface AppSyncResult {
+    created: string[];
+    updated: string[];
+    deleted: string[];
+    unchanged: string[];
+}
+export interface AppSyncStatus {
+    newLocal: string[];
+    newRemote: string[];
+    modified: string[];
+    synced: string[];
+}
+/**
+ * Service for syncing app configurations between local JSON files and remote Farseer instance
+ */
+export declare class AppSyncService {
+    private api;
+    private appsDir;
+    constructor(tenant: string, api: IFarseerClient);
+    /**
+     * Get filename for an app (keep original name, just sanitize for filesystem)
+     */
+    private getAppFilename;
+    /**
+     * Load all local app configs
+     */
+    loadLocalApps(): Map<string, LocalAppConfig>;
+    /**
+     * Save a local app config
+     */
+    saveLocalApp(config: LocalAppConfig): void;
+    /**
+     * Delete a local app config
+     */
+    deleteLocalApp(name: string): boolean;
+    /**
+     * Convert remote app to local config format
+     */
+    private remoteToLocal;
+    /**
+     * Check if local and remote app configs are equivalent
+     */
+    private areAppsEqual;
+    /**
+     * Pull apps from remote and save locally
+     */
+    pull(): Promise<AppSyncResult>;
+    /**
+     * Push local apps to remote
+     */
+    push(): Promise<AppSyncResult>;
+    /**
+     * Build update payload for API
+     */
+    private buildUpdatePayload;
+    /**
+     * Get sync status without making changes
+     */
+    getStatus(): Promise<AppSyncStatus>;
+}