@jazzmind/busibox-app 3.0.18

package/dist/lib/deploy/github-manifest.js

@@ -0,0 +1,168 @@
+/**
+ * GitHub Manifest Fetcher
+ *
+ * Fetches and validates busibox.json manifests from GitHub repositories.
+ */
+/**
+ * Parse GitHub URL into owner and repo
+ */
+export function parseGitHubUrl(url) {
+    // Handle various GitHub URL formats:
+    // https://github.com/owner/repo
+    // https://github.com/owner/repo.git
+    // git@github.com:owner/repo.git
+    let cleanUrl = url.trim();
+    // Remove .git suffix if present
+    if (cleanUrl.endsWith('.git')) {
+        cleanUrl = cleanUrl.slice(0, -4);
+    }
+    // Handle SSH format
+    if (cleanUrl.startsWith('git@github.com:')) {
+        cleanUrl = cleanUrl.replace('git@github.com:', 'https://github.com/');
+    }
+    // Extract owner/repo from URL
+    const match = cleanUrl.match(/github\.com\/([^\/]+)\/([^\/]+)/);
+    if (!match) {
+        throw new Error('Invalid GitHub URL format');
+    }
+    return {
+        owner: match[1],
+        repo: match[2],
+    };
+}
+/**
+ * Check if URL is a GitHub URL
+ */
+export function isGitHubUrl(url) {
+    return url.includes('github.com');
+}
+/**
+ * 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 async function fetchManifestFromGitHub(repoUrl, token, branch = 'main') {
+    const { owner, repo } = parseGitHubUrl(repoUrl);
+    // Try main first, then master
+    const branches = branch === 'main' ? ['main', 'master'] : [branch];
+    for (const branchName of branches) {
+        try {
+            const manifestUrl = `https://raw.githubusercontent.com/${owner}/${repo}/${branchName}/busibox.json`;
+            const headers = {
+                'Accept': 'application/json',
+            };
+            // Add token if provided (required for private repos)
+            const githubToken = token || process.env.GITHUB_TOKEN;
+            if (githubToken) {
+                headers['Authorization'] = `token ${githubToken}`;
+            }
+            const response = await fetch(manifestUrl, { headers });
+            if (response.ok) {
+                const manifest = await response.json();
+                return manifest;
+            }
+            // If this branch doesn't exist, try next
+            if (response.status === 404 && branchName !== branches[branches.length - 1]) {
+                continue;
+            }
+            // Other errors
+            if (!response.ok) {
+                throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+            }
+        }
+        catch (error) {
+            // If this is the last branch to try, throw the error
+            if (branchName === branches[branches.length - 1]) {
+                throw error;
+            }
+        }
+    }
+    throw new Error('Could not find busibox.json in main or master branch');
+}
+/**
+ * Validate GitHub repository access
+ *
+ * @param repoUrl - GitHub repository URL
+ * @param token - Optional GitHub token
+ * @returns True if repo is accessible
+ */
+export async function validateGitHubAccess(repoUrl, token) {
+    try {
+        const { owner, repo } = parseGitHubUrl(repoUrl);
+        const headers = {
+            'Accept': 'application/vnd.github.v3+json',
+        };
+        const githubToken = token || process.env.GITHUB_TOKEN;
+        if (githubToken) {
+            headers['Authorization'] = `token ${githubToken}`;
+        }
+        const response = await fetch(`https://api.github.com/repos/${owner}/${repo}`, { headers });
+        if (response.ok) {
+            return { accessible: true };
+        }
+        if (response.status === 404) {
+            return {
+                accessible: false,
+                error: 'Repository not found or you do not have access. For private repos, provide a GitHub token.'
+            };
+        }
+        if (response.status === 401 || response.status === 403) {
+            return {
+                accessible: false,
+                error: 'Invalid GitHub token or insufficient permissions'
+            };
+        }
+        return {
+            accessible: false,
+            error: `GitHub API error: ${response.status}`
+        };
+    }
+    catch (error) {
+        return {
+            accessible: false,
+            error: error instanceof Error ? error.message : 'Failed to validate GitHub access'
+        };
+    }
+}
+/**
+ * Fetch manifest and validate GitHub access
+ *
+ * @param repoUrl - GitHub repository URL
+ * @param token - Optional GitHub token
+ * @returns Validation result with manifest if successful
+ */
+export async function fetchAndValidateManifest(repoUrl, token) {
+    try {
+        // First validate repo access
+        const accessCheck = await validateGitHubAccess(repoUrl, token);
+        if (!accessCheck.accessible) {
+            return {
+                valid: false,
+                error: accessCheck.error,
+            };
+        }
+        // Fetch manifest
+        const manifest = await fetchManifestFromGitHub(repoUrl, token);
+        // Basic validation
+        if (!manifest.name || !manifest.id || !manifest.defaultPath || !manifest.defaultPort) {
+            return {
+                valid: false,
+                error: 'Invalid manifest: missing required fields (name, id, defaultPath, defaultPort)',
+            };
+        }
+        return {
+            valid: true,
+            manifest,
+        };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            error: error instanceof Error ? error.message : 'Failed to fetch manifest',
+        };
+    }
+}
+//# sourceMappingURL=github-manifest.js.map

package/dist/lib/deploy/github-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-manifest.js","sourceRoot":"","sources":["../../../src/lib/deploy/github-manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,qCAAqC;IACrC,gCAAgC;IAChC,oCAAoC;IACpC,gCAAgC;IAEhC,IAAI,QAAQ,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAE1B,gCAAgC;IAChC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,oBAAoB;IACpB,IAAI,QAAQ,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC3C,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,CAAC;IACxE,CAAC;IAED,8BAA8B;IAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAChE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACf,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;KACf,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAe,EACf,KAAc,EACd,SAAiB,MAAM;IAEvB,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAEhD,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAEnE,KAAK,MAAM,UAAU,IAAI,QAAQ,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,qCAAqC,KAAK,IAAI,IAAI,IAAI,UAAU,eAAe,CAAC;YAEpG,MAAM,OAAO,GAAgB;gBAC3B,QAAQ,EAAE,kBAAkB;aAC7B,CAAC;YAEF,qDAAqD;YACrD,MAAM,WAAW,GAAG,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;YACtD,IAAI,WAAW,EAAE,CAAC;gBAChB,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,WAAW,EAAE,CAAC;YACpD,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YAEvD,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACvC,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,yCAAyC;YACzC,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,UAAU,KAAK,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC5E,SAAS;YACX,CAAC;YAED,eAAe;YACf,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qDAAqD;YACrD,IAAI,UAAU,KAAK,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;gBACjD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAe,EACf,KAAc;IAEd,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QAEhD,MAAM,OAAO,GAAgB;YAC3B,QAAQ,EAAE,gCAAgC;SAC3C,CAAC;QAEF,MAAM,WAAW,GAAG,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QACtD,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,WAAW,EAAE,CAAC;QACpD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,gCAAgC,KAAK,IAAI,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAE3F,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QAC9B,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO;gBACL,UAAU,EAAE,KAAK;gBACjB,KAAK,EAAE,4FAA4F;aACpG,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvD,OAAO;gBACL,UAAU,EAAE,KAAK;gBACjB,KAAK,EAAE,kDAAkD;aAC1D,CAAC;QACJ,CAAC;QAED,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,qBAAqB,QAAQ,CAAC,MAAM,EAAE;SAC9C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,kCAAkC;SACnF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAe,EACf,KAAc;IAMd,IAAI,CAAC;QACH,6BAA6B;QAC7B,MAAM,WAAW,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC/D,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;YAC5B,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,WAAW,CAAC,KAAK;aACzB,CAAC;QACJ,CAAC;QAED,iBAAiB;QACjB,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAE/D,mBAAmB;QACnB,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;YACrF,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,gFAAgF;aACxF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,KAAK,EAAE,IAAI;YACX,QAAQ;SACT,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B;SAC3E,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,66 @@
+/**
+ * Busibox App Manifest Schema
+ *
+ * TypeScript types and Zod validation for busibox.json manifest files.
+ */
+import { z } from 'zod';
+export declare const BusiboxManifestSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    id: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodString;
+    icon: z.ZodString;
+    defaultPath: z.ZodString;
+    defaultPort: z.ZodNumber;
+    healthEndpoint: z.ZodString;
+    buildCommand: z.ZodString;
+    startCommand: z.ZodString;
+    appMode: z.ZodEnum<{
+        frontend: "frontend";
+        prisma: "prisma";
+    }>;
+    database: z.ZodOptional<z.ZodObject<{
+        required: z.ZodBoolean;
+        preferredName: z.ZodString;
+        schemaManagement: z.ZodEnum<{
+            manual: "manual";
+            prisma: "prisma";
+            migrations: "migrations";
+        }>;
+        seedCommand: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    requiredEnvVars: z.ZodArray<z.ZodString>;
+    optionalEnvVars: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    busiboxAppVersion: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BusiboxManifest = z.infer<typeof BusiboxManifestSchema>;
+export interface ManifestValidationResult {
+    success: boolean;
+    manifest?: BusiboxManifest;
+    errors?: Array<{
+        path: string;
+        message: string;
+    }>;
+}
+/**
+ * Validate a manifest object against the schema
+ */
+export declare function validateManifest(data: unknown): ManifestValidationResult;
+/**
+ * Check if a manifest requires database provisioning
+ */
+export declare function requiresDatabase(manifest: BusiboxManifest): boolean;
+/**
+ * Get database configuration from manifest
+ */
+export declare function getDatabaseConfig(manifest: BusiboxManifest): {
+    name: string;
+    schemaManagement: "manual" | "prisma" | "migrations";
+    seedCommand: string | undefined;
+} | null;
+/**
+ * Get all environment variables (required + optional)
+ */
+export declare function getAllEnvVars(manifest: BusiboxManifest): string[];
+//# sourceMappingURL=manifest-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.d.ts","sourceRoot":"","sources":["../../../src/lib/deploy/manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkChC,CAAC;AAGH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGpE,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,wBAAwB,CAiBxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAEnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe;;;;SAU1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,EAAE,CAIjE"}

package/dist/lib/deploy/manifest-schema.js

@@ -0,0 +1,86 @@
+/**
+ * Busibox App Manifest Schema
+ *
+ * TypeScript types and Zod validation for busibox.json manifest files.
+ */
+import { z } from 'zod';
+// Zod schema for validation
+export const BusiboxManifestSchema = z.object({
+    $schema: z.string().optional(),
+    name: z.string().min(1, 'Name is required'),
+    id: z.string()
+        .min(1, 'ID is required')
+        .regex(/^[a-z0-9-]+$/, 'ID must contain only lowercase letters, numbers, and hyphens'),
+    version: z.string()
+        .regex(/^\d+\.\d+\.\d+/, 'Version must be in semver format (e.g., 1.0.0)'),
+    description: z.string().min(1, 'Description is required'),
+    icon: z.string().min(1, 'Icon is required'),
+    defaultPath: z.string()
+        .regex(/^\/[a-z0-9-_]+$/, 'Path must start with / and contain only lowercase letters, numbers, hyphens, and underscores'),
+    defaultPort: z.number()
+        .int()
+        .min(1000, 'Port must be at least 1000')
+        .max(65535, 'Port must be at most 65535'),
+    healthEndpoint: z.string()
+        .startsWith('/', 'Health endpoint must start with /'),
+    buildCommand: z.string().min(1, 'Build command is required'),
+    startCommand: z.string().min(1, 'Start command is required'),
+    appMode: z.enum(['frontend', 'prisma']).refine((val) => val === 'frontend' || val === 'prisma', { message: 'App mode must be either "frontend" or "prisma"' }),
+    database: z.object({
+        required: z.boolean(),
+        preferredName: z.string()
+            .regex(/^[a-z0-9_]+$/, 'Database name must contain only lowercase letters, numbers, and underscores'),
+        schemaManagement: z.enum(['prisma', 'migrations', 'manual']),
+        seedCommand: z.string().optional(),
+    }).optional(),
+    requiredEnvVars: z.array(z.string()),
+    optionalEnvVars: z.array(z.string()).optional(),
+    busiboxAppVersion: z.string().optional(),
+});
+/**
+ * Validate a manifest object against the schema
+ */
+export function validateManifest(data) {
+    const result = BusiboxManifestSchema.safeParse(data);
+    if (result.success) {
+        return {
+            success: true,
+            manifest: result.data,
+        };
+    }
+    return {
+        success: false,
+        errors: result.error.issues.map(err => ({
+            path: err.path.join('.'),
+            message: err.message,
+        })),
+    };
+}
+/**
+ * Check if a manifest requires database provisioning
+ */
+export function requiresDatabase(manifest) {
+    return manifest.database?.required === true;
+}
+/**
+ * Get database configuration from manifest
+ */
+export function getDatabaseConfig(manifest) {
+    if (!manifest.database?.required) {
+        return null;
+    }
+    return {
+        name: manifest.database.preferredName,
+        schemaManagement: manifest.database.schemaManagement,
+        seedCommand: manifest.database.seedCommand,
+    };
+}
+/**
+ * Get all environment variables (required + optional)
+ */
+export function getAllEnvVars(manifest) {
+    const required = manifest.requiredEnvVars || [];
+    const optional = manifest.optionalEnvVars || [];
+    return [...required, ...optional];
+}
+//# sourceMappingURL=manifest-schema.js.map

package/dist/lib/deploy/manifest-schema.js.map

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

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

@@ -0,0 +1,25 @@
+/**
+ * Manifest Validator
+ *
+ * Validates busibox.json manifests against the schema.
+ */
+export interface ValidationError {
+    field: string;
+    message: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+/**
+ * Validate manifest schema
+ */
+export declare function validateManifest(manifest: any): ValidationResult;
+/**
+ * Validate manifest and return user-friendly error message
+ */
+export declare function validateManifestWithMessage(manifest: any): {
+    valid: boolean;
+    error?: string;
+};
+//# sourceMappingURL=manifest-validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-validator.d.ts","sourceRoot":"","sources":["../../../src/lib/deploy/manifest-validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,CAmIhE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,GAAG,GAAG;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAYA"}

package/dist/lib/deploy/manifest-validator.js

@@ -0,0 +1,142 @@
+/**
+ * Manifest Validator
+ *
+ * Validates busibox.json manifests against the schema.
+ */
+/**
+ * Validate manifest schema
+ */
+export function validateManifest(manifest) {
+    const errors = [];
+    // Required string fields
+    const requiredStrings = [
+        'name',
+        'id',
+        'version',
+        'description',
+        'icon',
+        'defaultPath',
+        'healthEndpoint',
+        'buildCommand',
+        'startCommand',
+        'appMode',
+        'busiboxAppVersion',
+    ];
+    for (const field of requiredStrings) {
+        if (!manifest[field] || typeof manifest[field] !== 'string') {
+            errors.push({
+                field,
+                message: `${field} is required and must be a string`,
+            });
+        }
+    }
+    // Required number fields
+    if (!manifest.defaultPort || typeof manifest.defaultPort !== 'number') {
+        errors.push({
+            field: 'defaultPort',
+            message: 'defaultPort is required and must be a number',
+        });
+    }
+    // Validate appMode enum
+    if (manifest.appMode && !['frontend', 'prisma'].includes(manifest.appMode)) {
+        errors.push({
+            field: 'appMode',
+            message: 'appMode must be either "frontend" or "prisma"',
+        });
+    }
+    // Validate defaultPath format
+    if (manifest.defaultPath && typeof manifest.defaultPath === 'string') {
+        if (!manifest.defaultPath.startsWith('/')) {
+            errors.push({
+                field: 'defaultPath',
+                message: 'defaultPath must start with /',
+            });
+        }
+        if (!/^\/[a-z0-9-_]+$/.test(manifest.defaultPath)) {
+            errors.push({
+                field: 'defaultPath',
+                message: 'defaultPath must contain only lowercase letters, numbers, hyphens, and underscores',
+            });
+        }
+    }
+    // Validate port range
+    if (manifest.defaultPort && typeof manifest.defaultPort === 'number') {
+        if (manifest.defaultPort < 1024 || manifest.defaultPort > 65535) {
+            errors.push({
+                field: 'defaultPort',
+                message: 'defaultPort must be between 1024 and 65535',
+            });
+        }
+    }
+    // Validate database config if present
+    if (manifest.database) {
+        if (typeof manifest.database !== 'object') {
+            errors.push({
+                field: 'database',
+                message: 'database must be an object',
+            });
+        }
+        else {
+            if (typeof manifest.database.required !== 'boolean') {
+                errors.push({
+                    field: 'database.required',
+                    message: 'database.required must be a boolean',
+                });
+            }
+            if (!manifest.database.preferredName || typeof manifest.database.preferredName !== 'string') {
+                errors.push({
+                    field: 'database.preferredName',
+                    message: 'database.preferredName is required and must be a string',
+                });
+            }
+            if (manifest.database.schemaManagement &&
+                !['prisma', 'manual'].includes(manifest.database.schemaManagement)) {
+                errors.push({
+                    field: 'database.schemaManagement',
+                    message: 'database.schemaManagement must be either "prisma" or "manual"',
+                });
+            }
+        }
+    }
+    // Validate arrays if present
+    if (manifest.requiredEnvVars && !Array.isArray(manifest.requiredEnvVars)) {
+        errors.push({
+            field: 'requiredEnvVars',
+            message: 'requiredEnvVars must be an array',
+        });
+    }
+    if (manifest.optionalEnvVars && !Array.isArray(manifest.optionalEnvVars)) {
+        errors.push({
+            field: 'optionalEnvVars',
+            message: 'optionalEnvVars must be an array',
+        });
+    }
+    // Validate healthEndpoint format
+    if (manifest.healthEndpoint && typeof manifest.healthEndpoint === 'string') {
+        if (!manifest.healthEndpoint.startsWith('/')) {
+            errors.push({
+                field: 'healthEndpoint',
+                message: 'healthEndpoint must start with /',
+            });
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Validate manifest and return user-friendly error message
+ */
+export function validateManifestWithMessage(manifest) {
+    const result = validateManifest(manifest);
+    if (result.valid) {
+        return { valid: true };
+    }
+    const errorMessages = result.errors.map(e => `${e.field}: ${e.message}`).join('; ');
+    return {
+        valid: false,
+        error: `Invalid manifest: ${errorMessages}`,
+    };
+}
+//# sourceMappingURL=manifest-validator.js.map

package/dist/lib/deploy/manifest-validator.js.map

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

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

@@ -0,0 +1,45 @@
+/**
+ * Busibox Manifest Fetcher
+ *
+ * Fetches and validates busibox.json manifest files from GitHub repositories.
+ */
+import { type BusiboxManifest } from './manifest-schema';
+export interface FetchManifestOptions {
+    owner: string;
+    repo: string;
+    branch?: string;
+    token?: string;
+}
+export interface FetchManifestResult {
+    success: boolean;
+    manifest?: BusiboxManifest;
+    error?: string;
+    validationErrors?: Array<{
+        path: string;
+        message: string;
+    }>;
+}
+/**
+ * Parse GitHub URL into owner and repo
+ * Supports:
+ * - https://github.com/owner/repo
+ * - github.com/owner/repo
+ * - owner/repo
+ */
+export declare function parseGitHubUrl(url: string): {
+    owner: string;
+    repo: string;
+} | null;
+/**
+ * Fetch manifest from GitHub repository
+ */
+export declare function fetchManifest(options: FetchManifestOptions): Promise<FetchManifestResult>;
+/**
+ * Fetch manifest from GitHub URL (convenience wrapper)
+ */
+export declare function fetchManifestFromUrl(url: string, token?: string, branch?: string): Promise<FetchManifestResult>;
+/**
+ * Check if a repository has a valid Busibox manifest
+ */
+export declare function hasValidManifest(owner: string, repo: string, token?: string): Promise<boolean>;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/lib/deploy/manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAoB,KAAK,eAAe,EAAiC,MAAM,mBAAmB,CAAC;AAE1G,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgClF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA0E/F;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,CAAC,CAgB9B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CAGlB"}