@jazzmind/busibox-app 3.0.18

package/dist/lib/deploy/default-apps.js

@@ -0,0 +1,142 @@
+/**
+ * Seeded app defaults used when App table is unavailable.
+ *
+ * This mirrors the bootstrap entries from prisma/seed.ts so admin routes can
+ * still operate in environments where Prisma app tables are intentionally absent.
+ */
+const SEEDED_TIMESTAMP = new Date('2026-01-01T00:00:00.000Z');
+const SEEDED_APPS = [
+    {
+        id: 'busibox-agents',
+        name: 'Agent Manager',
+        description: 'AI agent interaction and management interface',
+        type: 'BUILT_IN',
+        url: '/agents',
+        deployedPath: null,
+        iconUrl: null,
+        selectedIcon: 'cpu',
+        displayOrder: 1,
+        isActive: true,
+        healthEndpoint: '/api/health',
+        createdAt: SEEDED_TIMESTAMP,
+        updatedAt: SEEDED_TIMESTAMP,
+        lastDeploymentStatus: null,
+        lastDeploymentEndedAt: null,
+        deployedVersion: null,
+        latestVersion: null,
+        updateAvailable: false,
+        devMode: false,
+    },
+    {
+        id: 'busibox-appbuilder',
+        name: 'App Builder',
+        description: 'Lovable-style AI app builder with live preview and deployment workflows',
+        type: 'BUILT_IN',
+        url: '/builder',
+        deployedPath: null,
+        iconUrl: null,
+        selectedIcon: 'mobile',
+        displayOrder: 2,
+        isActive: true,
+        healthEndpoint: '/api/health',
+        createdAt: SEEDED_TIMESTAMP,
+        updatedAt: SEEDED_TIMESTAMP,
+        lastDeploymentStatus: null,
+        lastDeploymentEndedAt: null,
+        deployedVersion: null,
+        latestVersion: null,
+        updateAvailable: false,
+        devMode: false,
+    },
+    {
+        id: 'busibox-media',
+        name: 'Media Generator',
+        description: 'AI-powered media content generation and library',
+        type: 'BUILT_IN',
+        url: '/media',
+        deployedPath: null,
+        iconUrl: null,
+        selectedIcon: 'video',
+        displayOrder: 4,
+        isActive: true,
+        healthEndpoint: null,
+        createdAt: SEEDED_TIMESTAMP,
+        updatedAt: SEEDED_TIMESTAMP,
+        lastDeploymentStatus: null,
+        lastDeploymentEndedAt: null,
+        deployedVersion: null,
+        latestVersion: null,
+        updateAvailable: false,
+        devMode: false,
+    },
+    {
+        id: 'busibox-chat',
+        name: 'Chat',
+        description: 'Chat with AI models via liteLLM',
+        type: 'BUILT_IN',
+        url: '/chat',
+        deployedPath: null,
+        iconUrl: null,
+        selectedIcon: 'chat',
+        displayOrder: 5,
+        isActive: true,
+        healthEndpoint: null,
+        createdAt: SEEDED_TIMESTAMP,
+        updatedAt: SEEDED_TIMESTAMP,
+        lastDeploymentStatus: null,
+        lastDeploymentEndedAt: null,
+        deployedVersion: null,
+        latestVersion: null,
+        updateAvailable: false,
+        devMode: false,
+    },
+    {
+        id: 'busibox-documents',
+        name: 'Document Manager',
+        description: 'Upload, process, and search documents with AI',
+        type: 'BUILT_IN',
+        url: '/documents',
+        deployedPath: null,
+        iconUrl: null,
+        selectedIcon: 'documents',
+        displayOrder: 6,
+        isActive: true,
+        healthEndpoint: null,
+        createdAt: SEEDED_TIMESTAMP,
+        updatedAt: SEEDED_TIMESTAMP,
+        lastDeploymentStatus: null,
+        lastDeploymentEndedAt: null,
+        deployedVersion: null,
+        latestVersion: null,
+        updateAvailable: false,
+        devMode: false,
+    },
+    {
+        id: 'busibox-admin',
+        name: 'Admin',
+        description: 'Admin dashboard for managing Busibox',
+        type: 'BUILT_IN',
+        url: '/admin',
+        deployedPath: null,
+        iconUrl: null,
+        selectedIcon: 'settings',
+        displayOrder: 7,
+        isActive: true,
+        healthEndpoint: '/api/health',
+        createdAt: SEEDED_TIMESTAMP,
+        updatedAt: SEEDED_TIMESTAMP,
+        lastDeploymentStatus: null,
+        lastDeploymentEndedAt: null,
+        deployedVersion: null,
+        latestVersion: null,
+        updateAvailable: false,
+        devMode: false,
+    },
+];
+export function getSeededApps() {
+    return SEEDED_APPS.map((app) => ({ ...app }));
+}
+export function getSeededAppIds() {
+    return SEEDED_APPS.map((app) => app.id);
+}
+//# sourceMappingURL=default-apps.js.map

package/dist/lib/deploy/default-apps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-apps.js","sourceRoot":"","sources":["../../../src/lib/deploy/default-apps.ts"],"names":[],"mappings":"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"}

package/dist/lib/deploy/deployment-client.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Deployment Service Client
+ *
+ * Server-side client for calling the deployment service API.
+ * Deployment service runs on port 8011 in the authz container.
+ */
+import type { BusiboxManifest } from './manifest-schema';
+export interface DeployAppRequest {
+    appId: string;
+    appName: string;
+    githubRepo?: string;
+    githubToken?: string;
+    localDevDir?: string;
+    manifest: BusiboxManifest;
+    environment?: 'production' | 'staging' | 'development';
+    devMode?: boolean;
+}
+export interface DeploymentResult {
+    deploymentId: string;
+    status: string;
+    message?: string;
+}
+export interface DeploymentStatus {
+    deploymentId: string;
+    status: 'pending' | 'provisioning_db' | 'deploying' | 'configuring_nginx' | 'completed' | 'failed';
+    progress: number;
+    currentStep: string;
+    logs: string[];
+    startedAt: string;
+    completedAt?: string;
+    error?: string;
+}
+/**
+ * Deploy an app via deployment service
+ *
+ * This is a SERVER-SIDE function that requires an admin JWT token.
+ * Call this from API routes with the session JWT.
+ */
+export declare function deployApp(request: DeployAppRequest, adminToken: string): Promise<DeploymentResult>;
+/**
+ * Validate a local dev directory
+ *
+ * This is a SERVER-SIDE function that requires an admin JWT token.
+ */
+export interface LocalDevValidationResult {
+    valid: boolean;
+    manifest?: BusiboxManifest;
+    dirPath?: string;
+    error?: string;
+}
+export declare function validateLocalDevDirectory(dirName: string, adminToken: string): Promise<LocalDevValidationResult>;
+/**
+ * Get deployment status
+ *
+ * This is a SERVER-SIDE function that requires an admin JWT token.
+ */
+export declare function getDeploymentStatus(deploymentId: string, adminToken: string): Promise<DeploymentStatus>;
+/**
+ * CLIENT-SIDE: Connect to deployment logs WebSocket
+ *
+ * This is for client-side use in React components.
+ * Token must be obtained from session.
+ */
+export declare function connectDeploymentLogs(deploymentId: string, token: string, onStatus: (status: DeploymentStatus) => void, onError: (error: Error) => void): Promise<() => void>;
+/**
+ * Undeploy result from deployment service
+ */
+export interface UndeployResult {
+    success: boolean;
+    appId: string;
+    logs: string[];
+    error?: string;
+}
+/**
+ * Undeploy an app, removing all associated resources
+ *
+ * This cleans up:
+ * - Running process
+ * - Docker volumes (node_modules, .next cache)
+ * - nginx configuration
+ * - Build artifacts
+ *
+ * Use this when:
+ * - Deployment failed due to package-lock.json sync errors
+ * - You need to clean up volumes that are blocking file operations
+ * - You want to completely remove an app from the system
+ *
+ * After undeploying, you can redeploy with a fresh state.
+ *
+ * This is a SERVER-SIDE function that requires an admin JWT token.
+ */
+export declare function undeployApp(appId: string, adminToken: string, removeVolumes?: boolean): Promise<UndeployResult>;
+/**
+ * Stop an app without removing volumes
+ *
+ * This is a lighter operation than undeploy - it just stops the process.
+ *
+ * This is a SERVER-SIDE function that requires an admin JWT token.
+ */
+export declare function stopApp(appId: string, adminToken: string): Promise<{
+    success: boolean;
+    appId: string;
+    logs: string[];
+    error?: string;
+}>;
+/**
+ * Version check response from deployment service
+ */
+export interface VersionCheckResult {
+    latestVersion: string;
+    latestReleaseUrl?: string;
+    latestReleaseNotes?: string;
+    publishedAt?: string;
+    updateAvailable: boolean;
+}
+/**
+ * Check for updates to a GitHub app
+ *
+ * This is a SERVER-SIDE function that requires an admin JWT token.
+ */
+export declare function checkAppVersion(githubRepoOwner: string, githubRepoName: string, currentVersion: string | undefined, githubToken: string | undefined, adminToken: string): Promise<VersionCheckResult>;
+//# sourceMappingURL=deployment-client.d.ts.map

package/dist/lib/deploy/deployment-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-client.d.ts","sourceRoot":"","sources":["../../../src/lib/deploy/deployment-client.ts"],"names":[],"mappings":"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"}

package/dist/lib/deploy/deployment-client.js

@@ -0,0 +1,245 @@
+/**
+ * Deployment Service Client
+ *
+ * Server-side client for calling the deployment service API.
+ * Deployment service runs on port 8011 in the authz container.
+ */
+// Deployment service runs on port 8011 (separate from authz on 8010)
+// For local dev: localhost:8011, for production: 10.96.200.210:8011
+const DEPLOYMENT_SERVICE_URL = process.env.DEPLOYMENT_SERVICE_URL ||
+    (process.env.NODE_ENV === 'production' ? 'http://10.96.200.210:8011/api/v1/deployment' : 'http://localhost:8011/api/v1/deployment');
+/**
+ * Deploy an app via deployment service
+ *
+ * This is a SERVER-SIDE function that requires an admin JWT token.
+ * Call this from API routes with the session JWT.
+ */
+export async function deployApp(request, adminToken) {
+    let githubRepoOwner;
+    let githubRepoName;
+    // For GitHub mode, parse repo URL
+    if (request.githubRepo && !request.devMode) {
+        const repoMatch = request.githubRepo.match(/github\.com\/([^\/]+)\/([^\/\.]+)/);
+        if (!repoMatch) {
+            throw new Error('Invalid GitHub repository URL');
+        }
+        [, githubRepoOwner, githubRepoName] = repoMatch;
+    }
+    // Build request body matching DeployRequest model on the server
+    const requestBody = {
+        manifest: {
+            name: request.manifest.name,
+            id: request.manifest.id,
+            version: request.manifest.version,
+            description: request.manifest.description,
+            icon: request.manifest.icon || 'Rocket',
+            defaultPath: request.manifest.defaultPath,
+            defaultPort: request.manifest.defaultPort,
+            healthEndpoint: request.manifest.healthEndpoint,
+            buildCommand: request.manifest.buildCommand,
+            startCommand: request.manifest.startCommand,
+            appMode: request.manifest.appMode,
+            database: request.manifest.database,
+            requiredEnvVars: request.manifest.requiredEnvVars || [],
+            optionalEnvVars: request.manifest.optionalEnvVars || [],
+            busiboxAppVersion: request.manifest.busiboxAppVersion,
+        },
+        config: {
+            githubRepoOwner: githubRepoOwner || '',
+            githubRepoName: githubRepoName || '',
+            githubBranch: 'main',
+            githubToken: request.githubToken,
+            environment: request.environment || 'production',
+            secrets: {},
+            // Local dev mode fields
+            localDevDir: request.localDevDir,
+            devMode: request.devMode || false,
+        },
+    };
+    const response = await fetch(`${DEPLOYMENT_SERVICE_URL}/deploy`, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${adminToken}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(requestBody),
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({ detail: response.statusText }));
+        throw new Error(error.detail || `Deployment failed: ${response.statusText}`);
+    }
+    const data = await response.json();
+    return {
+        deploymentId: data.deploymentId,
+        status: data.status,
+        message: `App URL: ${data.appUrl}`,
+    };
+}
+export async function validateLocalDevDirectory(dirName, adminToken) {
+    const response = await fetch(`${DEPLOYMENT_SERVICE_URL}/validate-local-dev`, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${adminToken}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ dirName }),
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({ detail: response.statusText }));
+        return {
+            valid: false,
+            error: error.detail || `Validation failed: ${response.statusText}`,
+        };
+    }
+    return response.json();
+}
+/**
+ * Get deployment status
+ *
+ * This is a SERVER-SIDE function that requires an admin JWT token.
+ */
+export async function getDeploymentStatus(deploymentId, adminToken) {
+    const response = await fetch(`${DEPLOYMENT_SERVICE_URL}/deploy/${deploymentId}/status`, {
+        headers: {
+            'Authorization': `Bearer ${adminToken}`,
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to get deployment status: ${response.statusText}`);
+    }
+    return response.json();
+}
+/**
+ * CLIENT-SIDE: Connect to deployment logs WebSocket
+ *
+ * This is for client-side use in React components.
+ * Token must be obtained from session.
+ */
+export async function connectDeploymentLogs(deploymentId, token, onStatus, onError) {
+    const wsUrl = DEPLOYMENT_SERVICE_URL.replace(/^http/, 'ws');
+    // Pass token as query parameter for WebSocket auth
+    const ws = new WebSocket(`${wsUrl}/deploy/${deploymentId}/logs?token=${encodeURIComponent(token)}`);
+    ws.onmessage = (event) => {
+        try {
+            const data = JSON.parse(event.data);
+            if (data.error) {
+                onError(new Error(data.error));
+                ws.close();
+                return;
+            }
+            if (data.final) {
+                onStatus(data.status);
+                ws.close();
+                return;
+            }
+            onStatus(data);
+        }
+        catch (err) {
+            onError(err instanceof Error ? err : new Error('Failed to parse message'));
+        }
+    };
+    ws.onerror = () => {
+        onError(new Error('WebSocket connection error'));
+    };
+    ws.onclose = () => {
+        console.log('[Deployment] WebSocket connection closed');
+    };
+    // Return cleanup function
+    return () => {
+        if (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING) {
+            ws.close();
+        }
+    };
+}
+/**
+ * Undeploy an app, removing all associated resources
+ *
+ * This cleans up:
+ * - Running process
+ * - Docker volumes (node_modules, .next cache)
+ * - nginx configuration
+ * - Build artifacts
+ *
+ * Use this when:
+ * - Deployment failed due to package-lock.json sync errors
+ * - You need to clean up volumes that are blocking file operations
+ * - You want to completely remove an app from the system
+ *
+ * After undeploying, you can redeploy with a fresh state.
+ *
+ * This is a SERVER-SIDE function that requires an admin JWT token.
+ */
+export async function undeployApp(appId, adminToken, removeVolumes = true) {
+    const response = await fetch(`${DEPLOYMENT_SERVICE_URL}/undeploy`, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${adminToken}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            appId,
+            removeVolumes,
+        }),
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({ detail: response.statusText }));
+        return {
+            success: false,
+            appId,
+            logs: [],
+            error: error.detail || `Undeploy failed: ${response.statusText}`,
+        };
+    }
+    return response.json();
+}
+/**
+ * Stop an app without removing volumes
+ *
+ * This is a lighter operation than undeploy - it just stops the process.
+ *
+ * This is a SERVER-SIDE function that requires an admin JWT token.
+ */
+export async function stopApp(appId, adminToken) {
+    const response = await fetch(`${DEPLOYMENT_SERVICE_URL}/stop/${appId}`, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${adminToken}`,
+        },
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({ detail: response.statusText }));
+        return {
+            success: false,
+            appId,
+            logs: [],
+            error: error.detail || `Stop failed: ${response.statusText}`,
+        };
+    }
+    return response.json();
+}
+/**
+ * Check for updates to a GitHub app
+ *
+ * This is a SERVER-SIDE function that requires an admin JWT token.
+ */
+export async function checkAppVersion(githubRepoOwner, githubRepoName, currentVersion, githubToken, adminToken) {
+    const response = await fetch(`${DEPLOYMENT_SERVICE_URL}/version-check`, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${adminToken}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            githubOwner: githubRepoOwner,
+            githubRepo: githubRepoName,
+            currentVersion,
+            githubToken,
+        }),
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({ detail: response.statusText }));
+        throw new Error(error.detail || `Version check failed: ${response.statusText}`);
+    }
+    return response.json();
+}
+//# sourceMappingURL=deployment-client.js.map

package/dist/lib/deploy/deployment-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-client.js","sourceRoot":"","sources":["../../../src/lib/deploy/deployment-client.ts"],"names":[],"mappings":"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"}

package/dist/lib/deploy/github-manifest.d.ts

@@ -0,0 +1,52 @@
+/**
+ * GitHub Manifest Fetcher
+ *
+ * Fetches and validates busibox.json manifests from GitHub repositories.
+ */
+import type { BusiboxManifest } from './manifest-schema';
+interface GitHubUrlParts {
+    owner: string;
+    repo: string;
+}
+/**
+ * Parse GitHub URL into owner and repo
+ */
+export declare function parseGitHubUrl(url: string): GitHubUrlParts;
+/**
+ * Check if URL is a GitHub URL
+ */
+export declare function isGitHubUrl(url: string): boolean;
+/**
+ * Fetch busibox.json manifest from GitHub repository
+ *
+ * @param repoUrl - GitHub repository URL
+ * @param token - Optional GitHub token (uses env var if not provided)
+ * @param branch - Branch to fetch from (default: main)
+ * @returns Parsed manifest
+ */
+export declare function fetchManifestFromGitHub(repoUrl: string, token?: string, branch?: string): Promise<BusiboxManifest>;
+/**
+ * Validate GitHub repository access
+ *
+ * @param repoUrl - GitHub repository URL
+ * @param token - Optional GitHub token
+ * @returns True if repo is accessible
+ */
+export declare function validateGitHubAccess(repoUrl: string, token?: string): Promise<{
+    accessible: boolean;
+    error?: string;
+}>;
+/**
+ * Fetch manifest and validate GitHub access
+ *
+ * @param repoUrl - GitHub repository URL
+ * @param token - Optional GitHub token
+ * @returns Validation result with manifest if successful
+ */
+export declare function fetchAndValidateManifest(repoUrl: string, token?: string): Promise<{
+    valid: boolean;
+    manifest?: BusiboxManifest;
+    error?: string;
+}>;
+export {};
+//# sourceMappingURL=github-manifest.d.ts.map

package/dist/lib/deploy/github-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-manifest.d.ts","sourceRoot":"","sources":["../../../src/lib/deploy/github-manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CA4B1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,GAAE,MAAe,GACtB,OAAO,CAAC,eAAe,CAAC,CA6C1B;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA2ClD;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC;IACT,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAgCD"}