@playdrop/playdrop-cli 0.3.8-build.3 → 0.3.10

package/dist/commands/create.js

@@ -21,6 +21,8 @@ const app_1 = require("@playdrop/types/app");
 const catalogue_utils_1 = require("../catalogue-utils");
 const catalogue_1 = require("../catalogue");
 const CATALOGUE_FILENAME = 'catalogue.json';
+const LEGACY_CATALOGUE_VERSION_KEY = ['schema', 'Version'].join('');
+const ALLOWED_CATALOGUE_TOP_LEVEL_KEYS = new Set(['apps', 'assets', 'assetPacks']);
 async function downloadArchive(url) {
     const response = await fetch(url);
     if (!response.ok) {
@@ -147,6 +149,14 @@ function runNpmInstall(projectDir) {
     });
     return result.status === 0;
 }
+function findUnsupportedCatalogueTopLevelKey(parsed) {
+    for (const key of Object.keys(parsed)) {
+        if (!ALLOWED_CATALOGUE_TOP_LEVEL_KEYS.has(key) && key !== 'games') {
+            return key;
+        }
+    }
+    return null;
+}
 function extractEntryPointFromMetadata(metadata) {
     if (!metadata) {
         return null;
@@ -265,9 +275,6 @@ function buildCatalogueEntry(name, metadata, sourceInfo, relativeFilePath) {
 function readCatalogue(path) {
     try {
         const raw = (0, node_fs_1.readFileSync)(path, 'utf8');
-        if (!raw.trim()) {
-            return { schemaVersion: 2, apps: [] };
-        }
         const parsed = JSON.parse(raw);
         if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
             return null;
@@ -278,14 +285,39 @@ function readCatalogue(path) {
         return null;
     }
 }
+function hasNestedCatalogueFiles(rootDir) {
+    const rootCataloguePath = (0, node_path_1.join)(rootDir, CATALOGUE_FILENAME);
+    const stack = [rootDir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        const entries = (0, node_fs_1.readdirSync)(current, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') || entry.name === 'node_modules') {
+                continue;
+            }
+            const absolutePath = (0, node_path_1.join)(current, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(absolutePath);
+                continue;
+            }
+            if (entry.isFile() && entry.name === CATALOGUE_FILENAME && absolutePath !== rootCataloguePath) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
 function ensureCatalogueEntry(name, metadata, cataloguePath, sourceInfo, htmlFilePath) {
     const path = (0, node_path_1.resolve)(cataloguePath);
     const catalogueDir = (0, node_path_1.dirname)(path);
+    if (hasNestedCatalogueFiles(catalogueDir)) {
+        return { path, createdFile: false, addedEntry: false, error: 'workspace_root_marker_required' };
+    }
     const relativeFilePath = (0, node_path_1.relative)(catalogueDir, (0, node_path_1.resolve)(htmlFilePath)) || `${name}.html`;
     const normalizedFilePath = relativeFilePath.replace(/\\/g, '/');
     const entry = buildCatalogueEntry(name, metadata, sourceInfo, normalizedFilePath);
     if (!(0, node_fs_1.existsSync)(path)) {
-        const catalogue = { schemaVersion: 2, apps: [entry] };
+        const catalogue = { apps: [entry] };
         (0, node_fs_1.writeFileSync)(path, `${JSON.stringify(catalogue, null, 2)}\n`);
         return { path, createdFile: true, addedEntry: true };
     }
@@ -293,9 +325,13 @@ function ensureCatalogueEntry(name, metadata, cataloguePath, sourceInfo, htmlFil
     if (!parsed) {
         return { path, createdFile: false, addedEntry: false, error: 'invalid_json' };
     }
-    if (parsed.schemaVersion !== 2) {
+    if (Object.prototype.hasOwnProperty.call(parsed, LEGACY_CATALOGUE_VERSION_KEY)) {
         return { path, createdFile: false, addedEntry: false, error: 'invalid_schema_version' };
     }
+    const unsupportedKey = findUnsupportedCatalogueTopLevelKey(parsed);
+    if (unsupportedKey) {
+        return { path, createdFile: false, addedEntry: false, error: 'unsupported_top_level_key', unsupportedKey };
+    }
     if (!Array.isArray(parsed.apps) && Array.isArray(parsed.games)) {
         return { path, createdFile: false, addedEntry: false, error: 'legacy_games_property' };
     }
@@ -325,7 +361,17 @@ function logCatalogueOutcome(result, name) {
         return false;
     }
     if (result.error === 'invalid_schema_version') {
-        (0, messages_1.printErrorWithHelp)(`${label} must set "schemaVersion": 2.`, ['Update the file to schema v2 and rerun `playdrop project create app`.'], { command: 'project create app' });
+        (0, messages_1.printErrorWithHelp)(`${label} must not define the legacy top-level version field.`, ['Remove the legacy top-level version field from the file and rerun `playdrop project create app`.'], { command: 'project create app' });
+        process.exitCode = process.exitCode || 1;
+        return false;
+    }
+    if (result.error === 'unsupported_top_level_key') {
+        (0, messages_1.printErrorWithHelp)(`${label} contains unsupported top-level key "${result.unsupportedKey || 'unknown'}".`, ['Keep catalogue.json limited to apps, assets, and assetPacks, then rerun `playdrop project create app`.'], { command: 'project create app' });
+        process.exitCode = process.exitCode || 1;
+        return false;
+    }
+    if (result.error === 'workspace_root_marker_required') {
+        (0, messages_1.printErrorWithHelp)(`${label} must stay {} because nested catalogue.json files already exist below this directory.`, ['Create the app inside its own project folder instead of writing entries into the workspace root catalogue.json.'], { command: 'project create app' });
         process.exitCode = process.exitCode || 1;
         return false;
     }
@@ -344,13 +390,20 @@ function logCatalogueOutcome(result, name) {
 }
 function updateExtractedProjectCatalogue(name, metadata, projectCataloguePath, sourceInfo, htmlFilePath) {
     const path = (0, node_path_1.resolve)(projectCataloguePath);
+    if (hasNestedCatalogueFiles((0, node_path_1.dirname)(path))) {
+        return { path, updated: false, error: 'workspace_root_marker_required' };
+    }
     const parsed = readCatalogue(path);
     if (!parsed) {
         return { path, updated: false, error: 'invalid_json' };
     }
-    if (parsed.schemaVersion !== 2) {
+    if (Object.prototype.hasOwnProperty.call(parsed, LEGACY_CATALOGUE_VERSION_KEY)) {
         return { path, updated: false, error: 'invalid_schema_version' };
     }
+    const unsupportedKey = findUnsupportedCatalogueTopLevelKey(parsed);
+    if (unsupportedKey) {
+        return { path, updated: false, error: 'unsupported_top_level_key', unsupportedKey };
+    }
     if (!Array.isArray(parsed.apps) && Array.isArray(parsed.games)) {
         return { path, updated: false, error: 'legacy_games_property' };
     }
@@ -436,7 +489,17 @@ function logProjectCatalogueOutcome(result, name) {
         return false;
     }
     if (result.error === 'invalid_schema_version') {
-        (0, messages_1.printErrorWithHelp)(`${label} must set "schemaVersion": 2.`, ['Update the file to schema v2 and rerun `playdrop project create app`.'], { command: 'project create app' });
+        (0, messages_1.printErrorWithHelp)(`${label} must not define the legacy top-level version field.`, ['Remove the legacy top-level version field from the file and rerun `playdrop project create app`.'], { command: 'project create app' });
+        process.exitCode = process.exitCode || 1;
+        return false;
+    }
+    if (result.error === 'unsupported_top_level_key') {
+        (0, messages_1.printErrorWithHelp)(`${label} contains unsupported top-level key "${result.unsupportedKey || 'unknown'}".`, ['Keep catalogue.json limited to apps, assets, and assetPacks, then rerun `playdrop project create app`.'], { command: 'project create app' });
+        process.exitCode = process.exitCode || 1;
+        return false;
+    }
+    if (result.error === 'workspace_root_marker_required') {
+        (0, messages_1.printErrorWithHelp)(`${label} must stay {} because nested catalogue.json files already exist below this directory.`, ['Create the app inside its own project folder instead of writing entries into the workspace root catalogue.json.'], { command: 'project create app' });
         process.exitCode = process.exitCode || 1;
         return false;
     }
@@ -602,55 +665,91 @@ function parseRemixRef(value) {
         ref: (0, types_1.formatContentVersionRef)(parsed),
     };
 }
+function parseRemixScaffoldResponse(response, version) {
+    const remixMode = typeof response?.remixMode === 'string' ? response.remixMode : '';
+    const archiveUrl = typeof response?.archiveUrl === 'string' && response.archiveUrl.trim().length > 0
+        ? response.archiveUrl.trim()
+        : null;
+    const htmlContent = typeof response?.html === 'string' ? response.html : null;
+    const externalListingUrl = typeof response?.externalListingUrl === 'string' && response.externalListingUrl.trim().length > 0
+        ? response.externalListingUrl.trim()
+        : null;
+    const metadata = response.metadata;
+    const entryPoint = extractEntryPointFromMetadata(metadata);
+    if (remixMode === 'archive') {
+        if (!archiveUrl) {
+            throw new Error('Remix response missing archiveUrl');
+        }
+        return {
+            html: null,
+            metadata,
+            archiveUrl,
+            entryPoint,
+            sourceVersion: version,
+        };
+    }
+    if (remixMode === 'inline-html') {
+        if (!htmlContent) {
+            throw new Error('Remix response missing html');
+        }
+        return {
+            html: htmlContent,
+            metadata,
+            entryPoint,
+            sourceVersion: null,
+        };
+    }
+    if (remixMode === 'external-metadata-only') {
+        if (!externalListingUrl) {
+            throw new Error('Remix response missing externalListingUrl');
+        }
+        const externalMetadata = parseExternalRemixMetadata(response.metadata);
+        return {
+            html: null,
+            metadata: externalMetadata,
+            externalListingUrl,
+            entryPoint,
+            sourceVersion: null,
+        };
+    }
+    throw new Error(`Unsupported remix mode: ${remixMode || 'missing'}`);
+}
+function parseExternalRemixMetadata(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Remix response missing external metadata');
+    }
+    const record = value;
+    const name = typeof record.name === 'string' ? record.name.trim() : '';
+    const displayName = typeof record.displayName === 'string' ? record.displayName.trim() : '';
+    const description = typeof record.description === 'string' ? record.description.trim() : '';
+    const creatorUsername = typeof record.creatorUsername === 'string' ? record.creatorUsername.trim() : '';
+    const type = (0, app_1.parseAppType)(record.type) ?? '';
+    const emoji = record.emoji;
+    const color = record.color;
+    if (!name || !displayName || !description || !creatorUsername || !type) {
+        throw new Error('Remix response missing required external metadata fields');
+    }
+    if (emoji !== null && typeof emoji !== 'string') {
+        throw new Error('Remix response has invalid external metadata emoji');
+    }
+    if (color !== null && typeof color !== 'string') {
+        throw new Error('Remix response has invalid external metadata color');
+    }
+    return {
+        name,
+        displayName,
+        description,
+        creatorUsername,
+        type,
+        emoji,
+        color,
+        surfaceTargets: (0, catalogue_utils_1.parseSurfaceTargets)(record.surfaceTargets).list,
+    };
+}
 async function fetchRemixScaffold(client, creator, app, version) {
     try {
         const response = await client.fetchRemixScaffold(creator, app, version);
-        const remixMode = typeof response?.remixMode === 'string' ? response.remixMode : '';
-        const archiveUrl = typeof response?.archiveUrl === 'string' && response.archiveUrl.trim().length > 0
-            ? response.archiveUrl.trim()
-            : null;
-        const htmlContent = typeof response?.html === 'string' ? response.html : null;
-        const externalListingUrl = typeof response?.externalListingUrl === 'string' && response.externalListingUrl.trim().length > 0
-            ? response.externalListingUrl.trim()
-            : null;
-        const metadata = response.metadata;
-        const entryPoint = extractEntryPointFromMetadata(metadata);
-        if (remixMode === 'archive') {
-            if (!archiveUrl) {
-                throw new Error('Remix response missing archiveUrl');
-            }
-            return {
-                html: null,
-                metadata,
-                archiveUrl,
-                entryPoint,
-                sourceVersion: version,
-            };
-        }
-        if (remixMode === 'inline-html') {
-            if (!htmlContent) {
-                throw new Error('Remix response missing html');
-            }
-            return {
-                html: htmlContent,
-                metadata,
-                entryPoint,
-                sourceVersion: null,
-            };
-        }
-        if (remixMode === 'external-metadata-only') {
-            if (!externalListingUrl) {
-                throw new Error('Remix response missing externalListingUrl');
-            }
-            return {
-                html: null,
-                metadata,
-                externalListingUrl,
-                entryPoint,
-                sourceVersion: null,
-            };
-        }
-        throw new Error(`Unsupported remix mode: ${remixMode || 'missing'}`);
+        return parseRemixScaffoldResponse(response, version);
     }
     catch (unknownError) {
         if (unknownError instanceof types_1.UnsupportedClientError) {

package/dist/commands/createRemixContent.js

@@ -13,6 +13,33 @@ const http_1 = require("../http");
 const messages_1 = require("../messages");
 const init_1 = require("./init");
 const CATALOGUE_FILENAME = 'catalogue.json';
+const LEGACY_CATALOGUE_VERSION_KEY = ['schema', 'Version'].join('');
+const ALLOWED_CATALOGUE_TOP_LEVEL_KEYS = new Set(['apps', 'assets', 'assetPacks']);
+const MIME_TYPE_TO_EXTENSION = {
+    'image/png': '.png',
+    'image/jpeg': '.jpg',
+    'image/webp': '.webp',
+    'image/gif': '.gif',
+    'audio/mpeg': '.mp3',
+    'audio/wav': '.wav',
+    'audio/ogg': '.ogg',
+    'video/mp4': '.mp4',
+    'video/webm': '.webm',
+    'model/gltf+json': '.gltf',
+    'model/gltf-binary': '.glb',
+    'application/json': '.json',
+};
+function inferExtensionFromCandidate(candidate) {
+    try {
+        if (candidate.startsWith('http://') || candidate.startsWith('https://')) {
+            return (0, node_path_1.extname)(new URL(candidate).pathname);
+        }
+    }
+    catch {
+        return (0, node_path_1.extname)(candidate);
+    }
+    return (0, node_path_1.extname)(candidate);
+}
 async function ensureWorkspaceCataloguePath() {
     const path = (0, node_path_1.resolve)(process.cwd(), CATALOGUE_FILENAME);
     if ((0, node_fs_1.existsSync)(path) && (0, node_fs_1.statSync)(path).isFile()) {
@@ -42,14 +69,40 @@ function readWorkspaceCatalogue(path) {
         throw new Error(`Invalid catalogue.json at ${path}.`);
     }
     const catalogue = parsed;
-    if (catalogue.schemaVersion !== 2) {
-        throw new Error(`catalogue.json at ${path} must set "schemaVersion": 2.`);
+    if (Object.prototype.hasOwnProperty.call(catalogue, LEGACY_CATALOGUE_VERSION_KEY)) {
+        throw new Error(`catalogue.json at ${path} must not define the legacy top-level version field.`);
+    }
+    const unsupportedKey = Object.keys(catalogue).find((key) => !ALLOWED_CATALOGUE_TOP_LEVEL_KEYS.has(key));
+    if (unsupportedKey) {
+        throw new Error(`catalogue.json at ${path} contains unsupported top-level key "${unsupportedKey}".`);
     }
     return catalogue;
 }
 function writeWorkspaceCatalogue(path, catalogue) {
     (0, node_fs_1.writeFileSync)(path, `${JSON.stringify(catalogue, null, 2)}\n`);
 }
+function assertWorkspaceRootCanOwnEntries(cataloguePath) {
+    const rootDir = (0, node_path_1.resolve)(cataloguePath, '..');
+    const rootCataloguePath = (0, node_path_1.join)(rootDir, CATALOGUE_FILENAME);
+    const stack = [rootDir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        const entries = (0, node_fs_1.readdirSync)(current, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') || entry.name === 'node_modules') {
+                continue;
+            }
+            const absolutePath = (0, node_path_1.join)(current, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(absolutePath);
+                continue;
+            }
+            if (entry.isFile() && entry.name === CATALOGUE_FILENAME && absolutePath !== rootCataloguePath) {
+                throw new Error(`catalogue.json at ${cataloguePath} must stay {} because nested catalogue.json files already exist below this directory.`);
+            }
+        }
+    }
+}
 async function createAuthenticatedClient(commandLabel) {
     const cfg = (0, config_1.loadConfig)();
     const envName = cfg.env;
@@ -100,53 +153,13 @@ function parseAssetManifestFiles(value) {
 function inferExtensionFromManifestEntry(entry) {
     const candidates = [entry.key, entry.url].filter((value) => typeof value === 'string' && value.length > 0);
     for (const candidate of candidates) {
-        try {
-            if (candidate.startsWith('http://') || candidate.startsWith('https://')) {
-                const extension = (0, node_path_1.extname)(new URL(candidate).pathname);
-                if (extension) {
-                    return extension;
-                }
-            }
-            else {
-                const extension = (0, node_path_1.extname)(candidate);
-                if (extension) {
-                    return extension;
-                }
-            }
-        }
-        catch {
-            const extension = (0, node_path_1.extname)(candidate);
-            if (extension) {
-                return extension;
-            }
+        const extension = inferExtensionFromCandidate(candidate);
+        if (extension) {
+            return extension;
         }
     }
     const mimeType = typeof entry.contentType === 'string' ? entry.contentType.trim().toLowerCase() : '';
-    if (mimeType === 'image/png')
-        return '.png';
-    if (mimeType === 'image/jpeg')
-        return '.jpg';
-    if (mimeType === 'image/webp')
-        return '.webp';
-    if (mimeType === 'image/gif')
-        return '.gif';
-    if (mimeType === 'audio/mpeg')
-        return '.mp3';
-    if (mimeType === 'audio/wav')
-        return '.wav';
-    if (mimeType === 'audio/ogg')
-        return '.ogg';
-    if (mimeType === 'video/mp4')
-        return '.mp4';
-    if (mimeType === 'video/webm')
-        return '.webm';
-    if (mimeType === 'model/gltf+json')
-        return '.gltf';
-    if (mimeType === 'model/gltf-binary')
-        return '.glb';
-    if (mimeType === 'application/json')
-        return '.json';
-    return '';
+    return MIME_TYPE_TO_EXTENSION[mimeType] ?? '';
 }
 function buildLocalFilename(entry, usedNames) {
     const sourceName = typeof entry.key === 'string' && entry.key.length > 0
@@ -193,6 +206,7 @@ async function createAssetRemix(name, remixRef) {
     const client = await createAuthenticatedClient('project create asset');
     const cataloguePath = await ensureWorkspaceCataloguePath();
     const catalogue = readWorkspaceCatalogue(cataloguePath);
+    assertWorkspaceRootCanOwnEntries(cataloguePath);
     ensureUniqueEntryName(catalogue, 'asset', name);
     const detail = await client.fetchAssetBySlug(parsedRef.creatorUsername, parsedRef.name);
     const versions = await client.listAssetVersions(parsedRef.creatorUsername, parsedRef.name, { limit: 200, offset: 0 });
@@ -238,6 +252,7 @@ async function createPackRemix(name, remixRef) {
     const client = await createAuthenticatedClient('project create pack');
     const cataloguePath = await ensureWorkspaceCataloguePath();
     const catalogue = readWorkspaceCatalogue(cataloguePath);
+    assertWorkspaceRootCanOwnEntries(cataloguePath);
     ensureUniqueEntryName(catalogue, 'pack', name);
     const detail = await client.fetchAssetPackBySlug(parsedRef.creatorUsername, parsedRef.name);
     const versions = await client.listAssetPackVersions(parsedRef.creatorUsername, parsedRef.name, { limit: 200, offset: 0 });

package/dist/commands/creations.js

@@ -99,7 +99,16 @@ function formatCountValue(value) {
 }
 function buildCountsSuffix(item) {
     const parts = [];
-    if ('playCount' in item.item && typeof item.item.playCount === 'number') {
+    if (item.kind === 'app' && 'playCount' in item.item && typeof item.item.playCount === 'number') {
+        if (typeof item.item.viewCount === 'number') {
+            parts.push(`view ${formatCountValue(item.item.viewCount)}`);
+        }
+        parts.push(`launch ${formatCountValue(item.item.playCount)}`);
+    }
+    if (item.kind === 'asset' && 'playCount' in item.item && typeof item.item.playCount === 'number') {
+        if (typeof item.item.viewCount === 'number') {
+            parts.push(`view ${formatCountValue(item.item.viewCount)}`);
+        }
         parts.push(`play ${formatCountValue(item.item.playCount)}`);
     }
     if (typeof item.item.likeCount === 'number') {

package/dist/commands/devServer.d.ts

@@ -1,6 +1,6 @@
 import http from 'node:http';
 import { type ChildProcess } from 'node:child_process';
-import { ProjectInfo } from './devShared';
+import type { ProjectInfo } from './devShared';
 export interface StartDevServerOptions {
     appName: string;
     htmlPath: string;

package/dist/commands/devShared.js

@@ -63,7 +63,7 @@ async function assertAppRegistered(client, creatorUsername, appName) {
 }
 function findNearestCatalogue(startDir) {
     let current = (0, node_path_1.resolve)(startDir);
-    while (true) { // eslint-disable-line no-constant-condition
+    while (true) {
         const candidate = (0, node_path_1.join)(current, 'catalogue.json');
         if ((0, node_fs_1.existsSync)(candidate)) {
             return candidate;

package/dist/commands/generation.js

@@ -36,6 +36,95 @@ const LOCAL_IMAGE_MIME_BY_EXTENSION = {
     '.jpeg': 'image/jpeg',
     '.webp': 'image/webp',
 };
+function handleGenerateBuildRequestError(message) {
+    const errorByCode = {
+        missing_type: {
+            title: 'A generation type is required.',
+            details: ['Use one of: image, music, sfx, video, model_3d.'],
+        },
+        missing_prompt: {
+            title: 'A prompt is required.',
+            details: ['Example: playdrop ai create image "A pixel art hero portrait"'],
+        },
+        invalid_type: {
+            title: 'The generation type is invalid.',
+            details: ['Use one of: image, music, sfx, video, model_3d.'],
+        },
+        invalid_duration: {
+            title: 'The --duration value is invalid.',
+            details: ['Use a positive value like 20000, 20s, or 20000ms.'],
+        },
+        invalid_video_duration: {
+            title: 'The --duration value for video is invalid.',
+            details: ['Use 4s or 8s for video generation.'],
+        },
+        invalid_aspect_ratio: {
+            title: 'The --ratio value is invalid.',
+            details: ['Image: 1:1, 3:4, 9:16, 4:3, 16:9. Video: 16:9, 9:16.'],
+        },
+        missing_model3d_images: {
+            title: 'Model 3D IMAGE source mode requires at least one reference image.',
+            details: ['Provide --image1 <url> or --image2 <url>, or switch to --source-mode TEXT.'],
+        },
+        model3d_text_mode_disallows_images: {
+            title: 'Model 3D TEXT source mode cannot include reference images.',
+            details: ['Remove --image1/--image2 or switch to --source-mode IMAGE.'],
+        },
+        invalid_asset_subcategory: {
+            title: 'The --subcategory value is invalid.',
+            details: ['Use a lowercase slug such as generic, music, sfx, or avatar.'],
+        },
+    };
+    const entry = errorByCode[message];
+    if (!entry) {
+        return false;
+    }
+    (0, messages_1.printErrorWithHelp)(entry.title, entry.details, { command: 'ai create' });
+    process.exitCode = 1;
+    return true;
+}
+function handleGenerateImageReferenceError(message) {
+    const imageRefHandlers = [
+        {
+            prefix: 'image_ref_not_found:',
+            title: (optionName) => `The ${optionName || 'image'} reference file was not found.`,
+            details: (path) => [path ? `Missing file: ${path}` : 'Provide a valid local file path or HTTPS URL.'],
+        },
+        {
+            prefix: 'image_ref_not_file:',
+            title: (optionName) => `The ${optionName || 'image'} reference is not a file.`,
+            details: (path) => [path ? `Path must point to a file: ${path}` : 'Provide a valid local file path.'],
+        },
+        {
+            prefix: 'image_ref_invalid_scheme:',
+            title: (optionName) => `The ${optionName || 'image'} reference URL uses an unsupported scheme.`,
+            details: (scheme) => [`Use an HTTPS URL or a local file path. Received: ${scheme || 'unknown'}`],
+        },
+        {
+            prefix: 'image_ref_signature_mismatch:',
+            title: (optionName) => `The ${optionName || 'image'} reference file extension does not match its image signature.`,
+            details: (path) => [path ? `Fix file type mismatch for: ${path}` : 'Ensure extension and file signature match (.png, .jpg, .jpeg, .webp).'],
+        },
+        {
+            prefix: 'image_ref_unsupported_type:',
+            title: (optionName) => `The ${optionName || 'image'} reference file type is unsupported.`,
+            details: (path) => [
+                path ? `Unsupported file: ${path}` : 'Provide a supported local file.',
+                'Supported local image types: .png, .jpg, .jpeg, .webp.',
+            ],
+        },
+    ];
+    for (const handler of imageRefHandlers) {
+        if (!message.startsWith(handler.prefix)) {
+            continue;
+        }
+        const [, optionName, value] = message.split(':');
+        (0, messages_1.printErrorWithHelp)(handler.title(optionName), handler.details(value), { command: 'ai create' });
+        process.exitCode = 1;
+        return true;
+    }
+    return false;
+}
 function sleep(ms) {
     return new Promise((resolve) => {
         setTimeout(resolve, ms);
@@ -442,82 +531,10 @@ async function generate(typeInput, promptInput, options = {}) {
     }
     catch (error) {
         const message = typeof error?.message === 'string' ? error.message : 'invalid_input';
-        if (message === 'missing_type') {
-            (0, messages_1.printErrorWithHelp)('A generation type is required.', ['Use one of: image, music, sfx, video, model_3d.'], { command: 'ai create' });
-            process.exitCode = 1;
-            return;
-        }
-        if (message === 'missing_prompt') {
-            (0, messages_1.printErrorWithHelp)('A prompt is required.', ['Example: playdrop ai create image "A pixel art hero portrait"'], { command: 'ai create' });
-            process.exitCode = 1;
-            return;
-        }
-        if (message === 'invalid_type') {
-            (0, messages_1.printErrorWithHelp)('The generation type is invalid.', ['Use one of: image, music, sfx, video, model_3d.'], { command: 'ai create' });
-            process.exitCode = 1;
+        if (handleGenerateBuildRequestError(message)) {
             return;
         }
-        if (message === 'invalid_duration') {
-            (0, messages_1.printErrorWithHelp)('The --duration value is invalid.', ['Use a positive value like 20000, 20s, or 20000ms.'], { command: 'ai create' });
-            process.exitCode = 1;
-            return;
-        }
-        if (message === 'invalid_video_duration') {
-            (0, messages_1.printErrorWithHelp)('The --duration value for video is invalid.', ['Use 4s or 8s for video generation.'], { command: 'ai create' });
-            process.exitCode = 1;
-            return;
-        }
-        if (message === 'invalid_aspect_ratio') {
-            (0, messages_1.printErrorWithHelp)('The --ratio value is invalid.', ['Image: 1:1, 3:4, 9:16, 4:3, 16:9. Video: 16:9, 9:16.'], { command: 'ai create' });
-            process.exitCode = 1;
-            return;
-        }
-        if (message === 'missing_model3d_images') {
-            (0, messages_1.printErrorWithHelp)('Model 3D IMAGE source mode requires at least one reference image.', ['Provide --image1 <url> or --image2 <url>, or switch to --source-mode TEXT.'], { command: 'ai create' });
-            process.exitCode = 1;
-            return;
-        }
-        if (message === 'model3d_text_mode_disallows_images') {
-            (0, messages_1.printErrorWithHelp)('Model 3D TEXT source mode cannot include reference images.', ['Remove --image1/--image2 or switch to --source-mode IMAGE.'], { command: 'ai create' });
-            process.exitCode = 1;
-            return;
-        }
-        if (message === 'invalid_asset_subcategory') {
-            (0, messages_1.printErrorWithHelp)('The --subcategory value is invalid.', ['Use a lowercase slug such as generic, music, sfx, or avatar.'], { command: 'ai create' });
-            process.exitCode = 1;
-            return;
-        }
-        if (message.startsWith('image_ref_not_found:')) {
-            const [, optionName, path] = message.split(':');
-            (0, messages_1.printErrorWithHelp)(`The ${optionName || 'image'} reference file was not found.`, [path ? `Missing file: ${path}` : 'Provide a valid local file path or HTTPS URL.'], { command: 'ai create' });
-            process.exitCode = 1;
-            return;
-        }
-        if (message.startsWith('image_ref_not_file:')) {
-            const [, optionName, path] = message.split(':');
-            (0, messages_1.printErrorWithHelp)(`The ${optionName || 'image'} reference is not a file.`, [path ? `Path must point to a file: ${path}` : 'Provide a valid local file path.'], { command: 'ai create' });
-            process.exitCode = 1;
-            return;
-        }
-        if (message.startsWith('image_ref_invalid_scheme:')) {
-            const [, optionName, scheme] = message.split(':');
-            (0, messages_1.printErrorWithHelp)(`The ${optionName || 'image'} reference URL uses an unsupported scheme.`, [`Use an HTTPS URL or a local file path. Received: ${scheme || 'unknown'}`], { command: 'ai create' });
-            process.exitCode = 1;
-            return;
-        }
-        if (message.startsWith('image_ref_signature_mismatch:')) {
-            const [, optionName, path] = message.split(':');
-            (0, messages_1.printErrorWithHelp)(`The ${optionName || 'image'} reference file extension does not match its image signature.`, [path ? `Fix file type mismatch for: ${path}` : 'Ensure extension and file signature match (.png, .jpg, .jpeg, .webp).'], { command: 'ai create' });
-            process.exitCode = 1;
-            return;
-        }
-        if (message.startsWith('image_ref_unsupported_type:')) {
-            const [, optionName, path] = message.split(':');
-            (0, messages_1.printErrorWithHelp)(`The ${optionName || 'image'} reference file type is unsupported.`, [
-                path ? `Unsupported file: ${path}` : 'Provide a supported local file.',
-                'Supported local image types: .png, .jpg, .jpeg, .webp.',
-            ], { command: 'ai create' });
-            process.exitCode = 1;
+        if (handleGenerateImageReferenceError(message)) {
             return;
         }
         (0, messages_1.printErrorWithHelp)(`Invalid AI create input: ${message}.`, ['Run "playdrop help ai create" for valid options.'], {

package/dist/commands/gettingStarted.js

@@ -10,7 +10,7 @@ function printGettingStarted() {
     console.log('   playdrop project init .');
     console.log('');
     console.log('3. Create an app');
-    console.log('   playdrop project create app my-app --template playdrop/template/html_template');
+    console.log('   playdrop project create app my-app --template playdrop/template/typescript_template');
     console.log('');
     console.log('4. Preview locally');
     console.log('   playdrop project dev my-app');