@playdrop/playdrop-cli 0.3.4-build.1 → 0.3.5-build.1

package/README.md

@@ -1,25 +1,62 @@
 # @playdrop/playdrop-cli
 
-command-line interface for creators and AI agents interacting with the Playdrop platform.
-Learn more at [https://playdrop.ai](https://playdrop.ai)
-
-## Key Commands
-- `playdrop-cli login` – authenticate
-- `playdrop-cli init <path>` – initialize a workspace directory (try `~/Documents/playdrop` or `.`)
-- `playdrop-cli create <name> (--template creator/template/name | --remix creator/type/name)` – scaffold a new project from a template or remix.
-- `playdrop-cli dev <name>` – serve an app locally.
-- `playdrop-cli capture [name] [--timeout seconds] [--log-level level] [--surface target] [--screenshot path]` – run the dev frame in Playwright, stream console logs, and fail on browser errors (timeout default: 5 seconds, max: 600; surfaces: desktop, mobile-landscape, mobile-portrait; log levels: debug, info, warn, error; screenshots saved as PNG).
-- `node packages/playdrop-cli/scripts/capture-url.mjs --url <play-url> --screenshot <path> [--timeout seconds] [--log <path>] [--username <name> --password <pass> [--login-url <url>]]` – run a Playwright smoke check against a published app URL and fail on browser errors.
-- `playdrop-cli detail <creator/type/name>` – inspect metadata for an app, asset, or pack (`--format json` for raw output).
-- `playdrop-cli list [--type ... --creator ... --max ...]` – discover apps, assets, and packs available to your account (defaults to all creators).
-- `playdrop-cli feedback --title <title> [--comment text|--file path]` – send feedback to the Playdrop team; CLI metadata is attached automatically.
-- `playdrop-cli upload <pathOrName>` – publish apps, assets, and packs from a catalogue root (`category` and `subcategory` are required for each catalogue asset entry).
-- `playdrop-cli versions <list|set-current|publish|unpublish|delete> <app> [version] [--creator <username|me>]` – manage app versions as owner or admin (`app` supports `name` or `creator/type/name`).
-- `playdrop-cli generate <image|music|sfx|video|model_3d> "<prompt>" [--duration <value>] [--ratio <ratio>]` – generate assets directly with the AI server and store them in your account (`--duration` accepts plain numbers, `s`, or `ms`; `--ratio` supports image `1:1|3:4|9:16|4:3|16:9` and video `16:9|9:16`).
-- `playdrop-cli generations [--type ... --limit ... --offset ... --format text|json]` – browse persisted AI generations and generated asset refs.
-- `playdrop-cli assets categories [--format text|json]` – list canonical category/subcategory definitions and format constraints.
-- `playdrop-cli assets download-file <asset-ref-or-key> [--revision rN] [--role primary] [--out path]` – download one runtime file for a specific role.
-- `playdrop-cli assets download-source <asset-ref-or-key> [--revision rN] [--out path]` – download the full source ZIP bundle.
-- `playdrop-cli assets versions <list|set-current|publish|unpublish|delete> <asset> [revision] [--creator <username|me>]` – manage asset version visibility/current/delete.
-- `playdrop-cli asset-packs download-source <pack-ref-or-key> [--version x.y.z] [--out path]` – download the full source ZIP bundle for an asset pack version.
-- `playdrop-cli asset-packs versions <list|set-current|publish|unpublish|delete> <pack> [version] [--creator <username|me>]` – manage asset pack versions.
+Command-line interface for creators and AI agents using Playdrop.
+
+## Main Commands
+
+```bash
+playdrop auth login
+playdrop browse
+playdrop search "city builder"
+playdrop detail playdrop/app/hangingout
+playdrop comments browse playdrop/app/hangingout
+playdrop versions browse playdrop/app/hangingout
+playdrop credits balance
+playdrop notifications browse
+playdrop creations browse
+playdrop ai create image "Pixel art hero portrait"
+playdrop project init .
+playdrop project create app my-app --template playdrop/template/html_template
+playdrop project dev my-app
+playdrop project publish .
+playdrop documentation browse
+playdrop feedback send --title "Bug report" --comment "Details here."
+playdrop getting-started
+```
+
+## Ref Format
+
+Public content refs are always:
+
+```text
+<creator>/<kind>/<name>
+```
+
+Valid kinds:
+
+- `app`
+- `asset`
+- `asset-pack`
+
+Examples:
+
+- `playdrop/app/hangingout`
+- `playdrop/asset/astro`
+- `playdrop/asset-pack/starter-kit`
+
+## Local Project Flow
+
+```bash
+playdrop auth login
+playdrop project init .
+playdrop project create app my-app --template playdrop/template/html_template
+playdrop project dev my-app
+playdrop project publish .
+```
+
+## Documentation
+
+```bash
+playdrop documentation browse
+playdrop documentation read getting-started.md
+```

package/config/client-meta.json

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

package/dist/apps/upload.js

@@ -47,6 +47,10 @@ async function uploadApp(client, task, artifacts, options) {
  * Upload an app version using the versioned API.
  */
 async function uploadAppVersion(client, task, artifacts, options) {
+    const creatorUsername = typeof options?.creatorUsername === 'string' ? options.creatorUsername.trim() : '';
+    if (!creatorUsername) {
+        throw new Error(`Missing creator username for app "${task.name}" upload.`);
+    }
     const versionOptions = {
         version: task.version,
         releaseNotes: task.releaseNotes,
@@ -59,8 +63,6 @@ async function uploadAppVersion(client, task, artifacts, options) {
         type: task.type,
         emoji: task.emoji ?? undefined,
         color: task.color ?? undefined,
-        // Admin-only: publish as different user
-        creatorUsername: options?.creatorUsername,
     };
     // For EXTERNAL hosting mode, use externalUrl instead of bundle
     if (task.hostingMode === 'EXTERNAL') {
@@ -105,7 +107,7 @@ async function uploadAppVersion(client, task, artifacts, options) {
         }
     }
     try {
-        const response = await client.uploadAppVersion(task.name, versionOptions);
+        const response = await client.uploadAppVersion(creatorUsername, task.name, versionOptions);
         return {
             versionCreated: true,
             version: response?.version?.version,

package/dist/assets/model-artifacts.js

@@ -93,7 +93,7 @@ const MODEL_PRESET_BY_SUBCATEGORY = {
         height: 1024,
     },
 };
-const TOOL_NAME = 'playdrop-cli';
+const TOOL_NAME = 'playdrop';
 const WORKER_ENTRY_BASENAMES = ['model-worker.ts', 'model-worker.js'];
 let workerBundlePromise = null;
 function normalizeRole(role) {

package/dist/catalogue.d.ts

@@ -79,6 +79,9 @@ export type AssetPackCatalogueEntry = {
     version?: string;
     username?: string;
     assets?: string[];
+    hostingMode?: string;
+    externalUrl?: string;
+    downloadUrl?: string;
     previewApp?: string;
     visibility?: string;
     releaseNotes?: string;
@@ -187,6 +190,9 @@ export type AssetPackTask = {
     cataloguePath: string;
     username?: string;
     assets: string[];
+    hostingMode?: AppHostingMode;
+    externalUrl?: string;
+    downloadUrl?: string;
     previewApp?: string;
     visibility?: string;
     releaseNotes?: string;

package/dist/catalogue.js

@@ -1110,7 +1110,41 @@ function buildAssetPackTasks(catalogues) {
             const assets = Array.isArray(entry.assets)
                 ? entry.assets.filter((value) => typeof value === 'string' && value.trim().length > 0).map((value) => value.trim())
                 : [];
-            if (assets.length === 0) {
+            let hostingMode;
+            const rawHostingMode = typeof entry.hostingMode === 'string' ? entry.hostingMode.trim().toUpperCase() : '';
+            if (rawHostingMode) {
+                if (!types_1.APP_HOSTING_MODE_VALUES.includes(rawHostingMode)) {
+                    errors.push(`[${label}] Asset pack "${name}" hostingMode must be one of ${types_1.APP_HOSTING_MODE_VALUES.join(', ')}.`);
+                    continue;
+                }
+                hostingMode = rawHostingMode;
+            }
+            let externalUrl;
+            const rawExternalUrl = typeof entry.externalUrl === 'string' ? entry.externalUrl.trim() : '';
+            if (rawExternalUrl) {
+                if (!/^https:\/\//i.test(rawExternalUrl)) {
+                    errors.push(`[${label}] Asset pack "${name}" externalUrl must be an HTTPS URL.`);
+                    continue;
+                }
+                externalUrl = rawExternalUrl;
+            }
+            let downloadUrl;
+            const rawDownloadUrl = typeof entry.downloadUrl === 'string' ? entry.downloadUrl.trim() : '';
+            if (rawDownloadUrl) {
+                if (!/^https:\/\//i.test(rawDownloadUrl)) {
+                    errors.push(`[${label}] Asset pack "${name}" downloadUrl must be an HTTPS URL.`);
+                    continue;
+                }
+                downloadUrl = rawDownloadUrl;
+            }
+            if (hostingMode === 'EXTERNAL' && !externalUrl) {
+                errors.push(`[${label}] Asset pack "${name}" externalUrl is required when hostingMode is EXTERNAL.`);
+                continue;
+            }
+            if (externalUrl && hostingMode !== 'EXTERNAL') {
+                hostingMode = 'EXTERNAL';
+            }
+            if (assets.length === 0 && hostingMode !== 'EXTERNAL') {
                 errors.push(`[${label}] Asset pack "${name}" must reference at least one asset.`);
                 continue;
             }
@@ -1289,6 +1323,9 @@ function buildAssetPackTasks(catalogues) {
                 cataloguePath: label,
                 username,
                 assets,
+                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,

package/dist/commandContext.d.ts

@@ -12,4 +12,5 @@ export type EnvironmentContext = {
 };
 type EnvironmentCallback = (ctx: EnvironmentContext) => Promise<void> | void;
 export declare function withEnvironment(command: string, actionLabel: string, callback: EnvironmentCallback): Promise<void>;
+export declare function withPublicEnvironment(command: string, callback: EnvironmentCallback): Promise<void>;
 export {};

package/dist/commandContext.js

@@ -1,40 +1,70 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.withEnvironment = withEnvironment;
+exports.withPublicEnvironment = withPublicEnvironment;
 const config_1 = require("./config");
 const apiClient_1 = require("./apiClient");
 const environment_1 = require("./environment");
 const messages_1 = require("./messages");
-async function withEnvironment(command, actionLabel, callback) {
-    const cfg = (0, config_1.loadConfig)();
-    if (!cfg.env) {
+const DEFAULT_PUBLIC_ENV = 'prod';
+function resolveConfiguredEnvironment(cfg, command, options) {
+    const configuredEnv = typeof cfg.env === 'string' && cfg.env.trim().length > 0
+        ? cfg.env.trim()
+        : undefined;
+    if (!configuredEnv && options.requireAuth) {
         (0, messages_1.printConfigEnvironmentMissing)(command);
         process.exitCode = 1;
-        return;
-    }
-    if (!cfg.token) {
-        (0, messages_1.printLoginRequired)(actionLabel, command);
-        process.exitCode = 1;
-        return;
+        return null;
     }
-    const envConfig = (0, environment_1.resolveEnvironmentConfig)(cfg.env);
+    const envName = configuredEnv ?? (options.allowDefaultPublicEnv ? DEFAULT_PUBLIC_ENV : undefined);
+    const envConfig = (0, environment_1.resolveEnvironmentConfig)(envName);
     if (!envConfig) {
         const choices = (0, environment_1.formatEnvironmentList)();
-        (0, messages_1.printUnknownEnvironment)(cfg.env, choices, command);
+        (0, messages_1.printUnknownEnvironment)(envName || '', choices, command);
         process.exitCode = 1;
-        return;
+        return null;
     }
     if (envConfig.allowInsecureRequests) {
         process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';
     }
+    return envConfig;
+}
+function buildContext(cfg, envConfig) {
     const client = (0, apiClient_1.createCliApiClient)({ baseUrl: envConfig.apiBase, token: cfg.token });
     const aiClient = (0, apiClient_1.createCliAiClient)({ baseUrl: envConfig.aiBase, token: cfg.token });
-    await callback({
+    return {
         client,
         aiClient,
-        env: cfg.env,
+        env: envConfig.name,
         envConfig,
-        token: cfg.token,
+        token: cfg.token || '',
         config: cfg,
+    };
+}
+async function withEnvironment(command, actionLabel, callback) {
+    const cfg = (0, config_1.loadConfig)();
+    if (!cfg.token) {
+        (0, messages_1.printLoginRequired)(actionLabel, command);
+        process.exitCode = 1;
+        return;
+    }
+    const envConfig = resolveConfiguredEnvironment(cfg, command, {
+        requireAuth: true,
+        allowDefaultPublicEnv: false,
     });
+    if (!envConfig) {
+        return;
+    }
+    await callback(buildContext(cfg, envConfig));
+}
+async function withPublicEnvironment(command, callback) {
+    const cfg = (0, config_1.loadConfig)();
+    const envConfig = resolveConfiguredEnvironment(cfg, command, {
+        requireAuth: false,
+        allowDefaultPublicEnv: true,
+    });
+    if (!envConfig) {
+        return;
+    }
+    await callback(buildContext(cfg, envConfig));
 }

package/dist/commands/browse.d.ts

@@ -0,0 +1,16 @@
+export type BrowseKind = 'app' | 'asset' | 'asset-pack' | 'all';
+export type BrowseCreator = 'all' | 'me' | string;
+export type BrowseOptions = {
+    kind?: string;
+    creator?: string;
+    appType?: string;
+    assetCategory?: string;
+    assetSubcategory?: string;
+    limit?: string | number;
+    offset?: string | number;
+    json?: boolean;
+};
+export declare function browse(options?: BrowseOptions): Promise<void>;
+export declare function browseCategories(options?: {
+    json?: boolean;
+}): Promise<void>;