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

package/README.md

@@ -1,6 +1,48 @@
 # @playdrop/playdrop-cli
 
-Command-line interface for creators and AI agents using Playdrop.
+Official Playdrop CLI for the live [Playdrop](https://www.playdrop.ai/) platform.
+
+Use it to browse live examples, create or remix projects, publish browser games and creator apps, and work with AI-generated game assets on Playdrop.
+
+## Install
+
+```bash
+npm install -g @playdrop/playdrop-cli
+```
+
+## Quick Start
+
+```bash
+playdrop auth login
+playdrop auth whoami
+playdrop project init .
+playdrop project create app my-first-game --template playdrop/template/typescript_template
+playdrop project dev my-first-game
+playdrop project publish .
+```
+
+## What You Can Do
+
+- Browse the live Playdrop catalogue of apps, assets, and packs
+- Inspect real references before building or remixing
+- Create, remix, validate, and publish Playdrop projects
+- Manage comments, versions, credits, notifications, and creations
+- Read the public Playdrop docs directly from the CLI
+
+## Links
+
+- Website: [playdrop.ai](https://www.playdrop.ai/)
+- Getting started: [playdrop.ai/docs/getting-started](https://www.playdrop.ai/docs/getting-started)
+- CLI docs: [playdrop.ai/docs/cli](https://www.playdrop.ai/docs/cli)
+- SDK docs: [playdrop.ai/docs/sdk](https://www.playdrop.ai/docs/sdk)
+- Templates and demos: [playdrop.ai/docs/samples/templates-and-demos](https://www.playdrop.ai/docs/samples/templates-and-demos)
+- Public Playdrop skill: [skills.sh/playdrop-ai/playdrop-skills/playdrop](https://skills.sh/playdrop-ai/playdrop-skills/playdrop)
+
+## Live Examples
+
+- [Starter Kit Racing](https://www.playdrop.ai/creators/playdrop/apps/game/starter-kit-racing)
+- [Hangingout](https://www.playdrop.ai/creators/playdrop/apps/game/hangingout)
+- [Top Creators](https://www.playdrop.ai/top-creators)
 
 ## Main Commands
 

package/config/client-meta.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.3.8",
+  "version": "0.3.10",
   "build": 1,
   "platforms": {
     "ios": {
@@ -26,20 +26,19 @@
   },
   "clients": {
     "web": {
-      "minimumVersion": "0.3.8",
+      "minimumVersion": "0.3.10",
       "minimumBuild": 1
     },
     "admin": {
-      "minimumVersion": "0.3.8",
+      "minimumVersion": "0.3.10",
       "minimumBuild": 1
     },
     "apple": {
-      "minimumVersion": "0.3.8",
+      "minimumVersion": "0.3.10",
       "minimumBuild": 1
     },
     "cli": {
-      "minimumVersion": "0.3.8",
-      "minimumBuild": 1
+      "minimumVersion": "0.3.10"
     }
   }
 }

package/dist/apps/build.js

@@ -182,6 +182,47 @@ function isPathWithinRoot(rootDir, targetPath) {
     const rootPrefix = normalizedRoot.endsWith(node_path_1.sep) ? normalizedRoot : `${normalizedRoot}${node_path_1.sep}`;
     return normalizedTarget.startsWith(rootPrefix);
 }
+function readProjectDirEntries(current) {
+    try {
+        return (0, node_fs_1.readdirSync)(current, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+}
+function appendIncludedProjectFile(rootDir, includePath, fileByRelativePath, results, enforceReservedBundleNames) {
+    const normalizedIncludePath = (0, node_path_1.normalize)(includePath).split(node_path_1.sep).join('/');
+    if (!normalizedIncludePath || normalizedIncludePath === '.') {
+        return;
+    }
+    if (normalizedIncludePath.startsWith('..')) {
+        throw new Error(`[apps][build] Invalid include file path "${includePath}".`);
+    }
+    if (fileByRelativePath.has(normalizedIncludePath)) {
+        return;
+    }
+    const absolutePath = (0, node_path_1.resolve)(rootDir, normalizedIncludePath);
+    if (!isPathWithinRoot(rootDir, absolutePath)) {
+        throw new Error(`[apps][build] Included file "${includePath}" escapes the project root.`);
+    }
+    if (!(0, node_fs_1.existsSync)(absolutePath)) {
+        return;
+    }
+    const stats = (0, node_fs_1.statSync)(absolutePath);
+    if (!stats.isFile()) {
+        return;
+    }
+    if (enforceReservedBundleNames && isReservedBundlePath(normalizedIncludePath)) {
+        throw new Error(`[apps][build] Reserved bundle filename "${normalizedIncludePath}" is not allowed. Use dedicated source/ecs/server upload fields.`);
+    }
+    const record = {
+        absolutePath,
+        relativePath: normalizedIncludePath,
+        mtime: stats.mtime,
+    };
+    results.push(record);
+    fileByRelativePath.set(record.relativePath, record);
+}
 function collectProjectFiles(rootDir, rules, options) {
     const includeRelativeFiles = options?.includeRelativeFiles ?? [];
     const enforceReservedBundleNames = options?.enforceReservedBundleNames ?? false;
@@ -194,13 +235,7 @@ function collectProjectFiles(rootDir, rules, options) {
         if (visited.has(current))
             continue;
         visited.add(current);
-        let dirEntries = [];
-        try {
-            dirEntries = (0, node_fs_1.readdirSync)(current, { withFileTypes: true });
-        }
-        catch {
-            continue;
-        }
+        const dirEntries = readProjectDirEntries(current);
         for (const entry of dirEntries) {
             const absolutePath = (0, node_path_1.join)(current, entry.name);
             const relativePath = normalizeRelativePath(rootDir, absolutePath);
@@ -238,37 +273,7 @@ function collectProjectFiles(rootDir, rules, options) {
         }
     }
     for (const includePath of includeRelativeFiles) {
-        const normalizedIncludePath = (0, node_path_1.normalize)(includePath).split(node_path_1.sep).join('/');
-        if (!normalizedIncludePath || normalizedIncludePath === '.') {
-            continue;
-        }
-        if (normalizedIncludePath.startsWith('..')) {
-            throw new Error(`[apps][build] Invalid include file path "${includePath}".`);
-        }
-        if (fileByRelativePath.has(normalizedIncludePath)) {
-            continue;
-        }
-        const absolutePath = (0, node_path_1.resolve)(rootDir, normalizedIncludePath);
-        if (!isPathWithinRoot(rootDir, absolutePath)) {
-            throw new Error(`[apps][build] Included file "${includePath}" escapes the project root.`);
-        }
-        if (!(0, node_fs_1.existsSync)(absolutePath)) {
-            continue;
-        }
-        const stats = (0, node_fs_1.statSync)(absolutePath);
-        if (!stats.isFile()) {
-            continue;
-        }
-        if (enforceReservedBundleNames && isReservedBundlePath(normalizedIncludePath)) {
-            throw new Error(`[apps][build] Reserved bundle filename "${normalizedIncludePath}" is not allowed. Use dedicated source/ecs/server upload fields.`);
-        }
-        const record = {
-            absolutePath,
-            relativePath: normalizedIncludePath,
-            mtime: stats.mtime,
-        };
-        results.push(record);
-        fileByRelativePath.set(record.relativePath, record);
+        appendIncludedProjectFile(rootDir, includePath, fileByRelativePath, results, enforceReservedBundleNames);
     }
     results.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
     return results;

package/dist/catalogue-utils.js

@@ -42,6 +42,34 @@ function parseSurfaceTargets(input) {
     return { map, list };
 }
 const DEFAULT_SURFACE_TARGETS_OBJECT = { desktop: true, mobileLandscape: false, mobilePortrait: false };
+const LEGACY_CATALOGUE_VERSION_KEY = ['schema', 'Version'].join('');
+function parseCatalogueEntries(cataloguePath) {
+    try {
+        const raw = (0, node_fs_1.readFileSync)(cataloguePath, 'utf8');
+        const data = JSON.parse(raw);
+        if (!data || typeof data !== 'object' || Array.isArray(data)) {
+            throw new Error('catalogue.json must be an object');
+        }
+        if (Object.prototype.hasOwnProperty.call(data, LEGACY_CATALOGUE_VERSION_KEY)) {
+            throw new Error('legacy top-level version field is not supported');
+        }
+        const entries = data?.apps;
+        return Array.isArray(entries)
+            ? entries.filter((entry) => Boolean(entry && typeof entry === 'object'))
+            : [];
+    }
+    catch {
+        throw new Error(`Failed to parse ${cataloguePath}. Fix the JSON and retry.`);
+    }
+}
+function findMatchingCatalogueEntries(apps, relativePath, fileName) {
+    return apps.filter((entry) => {
+        const entryName = typeof entry.name === 'string' ? entry.name.trim() : '';
+        const entryFile = typeof entry.file === 'string' ? entry.file.trim() : `${entryName}.html`;
+        const normalized = entryFile.replace(/\\/g, '/');
+        return normalized === relativePath || normalized === fileName;
+    });
+}
 function cloneSurfaceTargets(targets) {
     return {
         list: [...targets.list],
@@ -54,25 +82,9 @@ function findAppCatalogueInfo(htmlPath) {
     for (let dir = (0, node_path_1.dirname)(absolute);; dir = (0, node_path_1.dirname)(dir)) {
         const cataloguePath = (0, node_path_1.join)(dir, 'catalogue.json');
         if ((0, node_fs_1.existsSync)(cataloguePath) && (0, node_fs_1.statSync)(cataloguePath).isFile()) {
-            let entries;
-            try {
-                const raw = (0, node_fs_1.readFileSync)(cataloguePath, 'utf8');
-                const data = raw.trim() ? JSON.parse(raw) : {};
-                entries = Array.isArray(data) ? data : data?.apps;
-            }
-            catch {
-                throw new Error(`Failed to parse ${cataloguePath}. Fix the JSON and retry.`);
-            }
-            const apps = Array.isArray(entries) ? entries : [];
             const rel = (0, node_path_1.relative)(dir, absolute).replace(/\\/g, '/');
-            const matches = apps.filter((entry) => {
-                if (!entry || typeof entry !== 'object')
-                    return false;
-                const entryName = typeof entry.name === 'string' ? entry.name.trim() : '';
-                const entryFile = typeof entry.file === 'string' ? entry.file.trim() : `${entryName}.html`;
-                const normalized = entryFile.replace(/\\/g, '/');
-                return normalized === rel || normalized === fileName;
-            });
+            const apps = parseCatalogueEntries(cataloguePath);
+            const matches = findMatchingCatalogueEntries(apps, rel, fileName);
             if (matches.length > 1) {
                 throw new Error(`Multiple entries in ${cataloguePath} reference ${absolute}.`);
             }

package/dist/catalogue.d.ts

@@ -1,6 +1,5 @@
 import { type AppSurface, type AppType, type AppHostingMode, type AppVersionVisibility } from '@playdrop/types';
 export type CatalogueJson = {
-    schemaVersion?: number;
     apps?: Array<Record<string, unknown>>;
     assets?: Array<Record<string, unknown>>;
     assetPacks?: Array<Record<string, unknown>>;
@@ -85,7 +84,6 @@ export type AssetPackCatalogueEntry = {
     hostingMode?: string;
     externalUrl?: string;
     downloadUrl?: string;
-    previewApp?: string;
     visibility?: string;
     releaseNotes?: string;
     listing?: AppListingConfig;
@@ -200,7 +198,6 @@ export type AssetPackTask = {
     hostingMode?: AppHostingMode;
     externalUrl?: string;
     downloadUrl?: string;
-    previewApp?: string;
     visibility?: string;
     releaseNotes?: string;
     listing?: ResolvedListingAssets;

package/dist/catalogue.js

@@ -12,6 +12,7 @@ const types_1 = require("@playdrop/types");
 const catalogue_utils_1 = require("./catalogue-utils");
 const HEX_COLOR_REGEX = /^#?(?:[0-9a-fA-F]{6})$/;
 const SEMVER_REGEX = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
+const LEGACY_CATALOGUE_VERSION_KEY = ['schema', 'Version'].join('');
 const ASSET_CATEGORY_SET = new Set(types_1.ASSET_CATEGORY_VALUES);
 const LISTING_IMAGE_EXTENSIONS = new Set(['.png']);
 const LISTING_VIDEO_EXTENSIONS = new Set(['.mp4']);
@@ -192,24 +193,24 @@ function shouldSkipDirectory(name) {
 function readCatalogueFile(rootDir, filePath) {
     try {
         const raw = (0, node_fs_1.readFileSync)(filePath, 'utf8');
-        const parsed = raw.trim() ? JSON.parse(raw) : {};
+        const parsed = JSON.parse(raw);
         if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
             return { error: 'catalogue.json must contain a JSON object' };
         }
-        if (parsed.schemaVersion !== 2) {
-            return { error: 'catalogue.json must set "schemaVersion": 2' };
+        if (Object.prototype.hasOwnProperty.call(parsed, LEGACY_CATALOGUE_VERSION_KEY)) {
+            return { error: 'catalogue.json must not define the legacy top-level version field. Remove it and retry.' };
         }
         const forbiddenKeys = ['avatars', 'humanoids', 'creatures', 'blocks', 'games'];
         for (const key of forbiddenKeys) {
             if (Object.prototype.hasOwnProperty.call(parsed, key)) {
-                return { error: `catalogue.json schema v2 forbids top-level "${key}"` };
+                return { error: `catalogue.json forbids top-level "${key}"` };
             }
         }
-        const allowedKeys = new Set(['schemaVersion', 'apps', 'assets', 'assetPacks']);
+        const allowedKeys = new Set(['apps', 'assets', 'assetPacks']);
         const unknownKeys = Object.keys(parsed).filter((key) => !allowedKeys.has(key));
         if (unknownKeys.length > 0) {
             return {
-                error: `catalogue.json schema v2 contains unsupported top-level key "${unknownKeys[0]}"`,
+                error: `catalogue.json contains unsupported top-level key "${unknownKeys[0]}"`,
             };
         }
         const directory = (0, node_path_1.dirname)(filePath);
@@ -283,6 +284,9 @@ function walkCatalogueTree(rootDir) {
     files.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
     return { files, errors };
 }
+function isCatalogueMarker(file) {
+    return Object.keys(file.data).length === 0;
+}
 const packageJsonCache = new Map();
 function resolvePackageJson(projectDir) {
     const candidate = (0, node_path_1.join)(projectDir, 'package.json');
@@ -396,6 +400,48 @@ function normalizeAssetSubcategoryValue(raw, category, errors, label) {
     }
     return normalized;
 }
+function validateOptionalEmoji(value, hasEmojiField, errors) {
+    const emoji = value;
+    if (!hasEmojiField) {
+        return emoji;
+    }
+    if (emoji !== null && typeof emoji === 'string') {
+        const trimmed = emoji.trim();
+        if (!trimmed) {
+            return null;
+        }
+        if (Array.from(trimmed).length > 4) {
+            errors.push('emoji must be a single character');
+            return emoji;
+        }
+        return trimmed;
+    }
+    if (emoji !== null) {
+        errors.push('emoji must be a string or null');
+    }
+    return emoji;
+}
+function validateOptionalColor(value, hasColorField, errors) {
+    const color = value;
+    if (!hasColorField) {
+        return color;
+    }
+    if (color !== null && typeof color === 'string') {
+        const trimmed = color.trim();
+        if (!trimmed) {
+            return null;
+        }
+        if (!HEX_COLOR_REGEX.test(trimmed)) {
+            errors.push('color must be a hex RGB value like #FFAA00');
+            return color;
+        }
+        return trimmed.startsWith('#') ? trimmed.toUpperCase() : `#${trimmed.toUpperCase()}`;
+    }
+    if (color !== null) {
+        errors.push('color must be a string or null');
+    }
+    return color;
+}
 function validateAppMetadata(entry) {
     const warnings = [];
     const errors = [];
@@ -403,42 +449,8 @@ function validateAppMetadata(entry) {
     if (missingFields.length > 0) {
         warnings.push(formatMissingMetadata(missingFields));
     }
-    let emoji = entry.emoji;
-    if (Object.prototype.hasOwnProperty.call(entry, 'emoji')) {
-        if (emoji !== null && typeof emoji === 'string') {
-            const trimmed = emoji.trim();
-            if (!trimmed) {
-                emoji = null;
-            }
-            else if (Array.from(trimmed).length > 4) {
-                errors.push('emoji must be a single character');
-            }
-            else {
-                emoji = trimmed;
-            }
-        }
-        else if (emoji !== null) {
-            errors.push('emoji must be a string or null');
-        }
-    }
-    let color = entry.color;
-    if (Object.prototype.hasOwnProperty.call(entry, 'color')) {
-        if (color !== null && typeof color === 'string') {
-            const trimmed = color.trim();
-            if (!trimmed) {
-                color = null;
-            }
-            else if (!HEX_COLOR_REGEX.test(trimmed)) {
-                errors.push('color must be a hex RGB value like #FFAA00');
-            }
-            else {
-                color = trimmed.startsWith('#') ? trimmed.toUpperCase() : `#${trimmed.toUpperCase()}`;
-            }
-        }
-        else if (color !== null) {
-            errors.push('color must be a string or null');
-        }
-    }
+    const emoji = validateOptionalEmoji(entry.emoji, Object.prototype.hasOwnProperty.call(entry, 'emoji'), errors);
+    const color = validateOptionalColor(entry.color, Object.prototype.hasOwnProperty.call(entry, 'color'), errors);
     let type;
     if (typeof entry.type === 'string' && entry.type.trim()) {
         const parsedType = (0, types_1.parseAppType)(entry.type.trim());
@@ -625,18 +637,17 @@ function buildAppTasks(rootDir, catalogues, options) {
                 }
                 serverPath = absoluteServerPath;
             }
-            // Parse versioning fields (required in schema v2)
-            let version;
+            // Parse versioning fields.
             const rawVersion = typeof entry.version === 'string' ? entry.version.trim() : '';
             if (!rawVersion) {
-                errors.push(`[${label}] Skipping ${rawName}: app version is required in schema v2 (e.g., "1.0.0").`);
+                errors.push(`[${label}] Skipping ${rawName}: app version is required (e.g., "1.0.0").`);
                 continue;
             }
             if (!SEMVER_REGEX.test(rawVersion)) {
                 errors.push(`[${label}] Skipping ${rawName}: version must be in Major.Minor.Patch format (e.g., "1.0.0").`);
                 continue;
             }
-            version = rawVersion;
+            const version = rawVersion;
             const releaseNotes = typeof entry.releaseNotes === 'string' ? entry.releaseNotes : undefined;
             let versionVisibility;
             const rawVisibility = typeof entry.visibility === 'string' ? entry.visibility.trim().toUpperCase() : '';
@@ -936,7 +947,7 @@ function buildAppTasks(rootDir, catalogues, options) {
                     category,
                     subcategory,
                     format: embeddedFormat,
-                    visibility: normalizeAssetVisibilityValue(embedded?.visibility, errors, `${label} embedded asset \"${embeddedName}\"`),
+                    visibility: normalizeAssetVisibilityValue(embedded?.visibility, errors, `${label} embedded asset "${embeddedName}"`),
                     shopListed: typeof embedded?.shopListed === 'boolean' ? embedded.shopListed : undefined,
                     shopPriceCredits: Number.isInteger(embedded?.shopPriceCredits) ? Number(embedded.shopPriceCredits) : undefined,
                     files,
@@ -1107,7 +1118,7 @@ function buildAssetTasks(catalogues) {
                 username,
                 remix,
                 format,
-                visibility: normalizeAssetVisibilityValue(entry.visibility, errors, `${label} asset \"${name}\"`),
+                visibility: normalizeAssetVisibilityValue(entry.visibility, errors, `${label} asset "${name}"`),
                 shopListed: typeof entry.shopListed === 'boolean' ? entry.shopListed : undefined,
                 shopPriceCredits: Number.isInteger(entry.shopPriceCredits) ? Number(entry.shopPriceCredits) : undefined,
                 files,
@@ -1351,6 +1362,13 @@ function buildAssetPackTasks(catalogues) {
                 }
                 listing = resolvedListing;
             }
+            const previewApp = typeof entry.previewApp === 'string'
+                ? String(entry.previewApp).trim()
+                : '';
+            if (previewApp.length > 0) {
+                errors.push(`[${label}] Skipping asset pack "${name}": previewApp is no longer supported during publish. Upload the pack first, then set previewAppVersionId explicitly with creations asset-packs update.`);
+                continue;
+            }
             tasks.push({
                 kind: 'asset-pack',
                 name,
@@ -1363,7 +1381,6 @@ function buildAssetPackTasks(catalogues) {
                 hostingMode,
                 externalUrl,
                 downloadUrl,
-                previewApp: typeof entry.previewApp === 'string' && entry.previewApp.trim().length > 0 ? entry.previewApp.trim() : undefined,
                 visibility,
                 releaseNotes: typeof entry.releaseNotes === 'string' ? entry.releaseNotes : undefined,
                 listing,
@@ -1385,6 +1402,20 @@ function resolveCatalogueEntries(rootDir, options = {}) {
             errors: discoveryErrors,
         };
     }
+    const rootCatalogue = files.find((file) => file.relativePath === 'catalogue.json');
+    const hasNestedCatalogues = files.some((file) => file.relativePath !== 'catalogue.json');
+    if (rootCatalogue && hasNestedCatalogues && !isCatalogueMarker(rootCatalogue)) {
+        return {
+            apps: [],
+            assets: [],
+            embeddedAssets: [],
+            assetPacks: [],
+            warnings: [],
+            errors: [
+                '[catalogue.json] Workspace root catalogue.json must be {} when nested catalogue.json files exist below it.',
+            ],
+        };
+    }
     const { tasks: appTasks, warnings: appWarnings, errors: appErrors } = buildAppTasks(rootDir, files, options);
     const { tasks: assetTasks, warnings: assetWarnings, errors: assetErrors } = buildAssetTasks(files);
     const { tasks: assetPackTasks, warnings: assetPackWarnings, errors: assetPackErrors } = buildAssetPackTasks(files);

package/dist/clientInfo.js

@@ -12,14 +12,28 @@ const os_1 = __importDefault(require("os"));
 const config_1 = require("@playdrop/config");
 function mapPlatform(platform) {
     switch (platform) {
+        case 'aix':
+            return 'aix';
+        case 'android':
+            return 'android';
+        case 'cygwin':
+            return 'cygwin';
         case 'darwin':
             return 'macos';
+        case 'freebsd':
+            return 'freebsd';
+        case 'haiku':
+            return 'haiku';
         case 'win32':
             return 'windows';
         case 'linux':
             return 'linux';
-        default:
-            return platform || 'unknown';
+        case 'netbsd':
+            return 'netbsd';
+        case 'openbsd':
+            return 'openbsd';
+        case 'sunos':
+            return 'sunos';
     }
 }
 function detectPlatformVersion() {

package/dist/commands/browse.js

@@ -91,7 +91,16 @@ function formatCountValue(value) {
 }
 function buildCountsSuffix(item) {
     const parts = [];
-    if ((item.kind === 'app' || item.kind === 'asset') && typeof item.item.playCount === 'number') {
+    if (item.kind === 'app' && 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' && 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/capture.js

@@ -35,6 +35,8 @@ function formatAppTypeSlug(type) {
             return 'template';
         case 'DEMO':
             return 'demo';
+        case undefined:
+            return 'game';
         default:
             return 'game';
     }
@@ -414,8 +416,7 @@ async function capture(targetArg, options = {}) {
                 projectInfo,
             });
             signalHandler = () => {
-                cleanup()
-                    .finally(() => process.exit(130));
+                void cleanup().finally(() => process.exit(130));
             };
             process.on('SIGINT', signalHandler);
             process.on('SIGTERM', signalHandler);