@playdrop/playdrop-cli 0.5.2 → 0.5.4

package/dist/index.js

@@ -8,13 +8,17 @@ const clientInfo_1 = require("./clientInfo");
 const login_1 = require("./commands/login");
 const whoami_1 = require("./commands/whoami");
 const logout_1 = require("./commands/logout");
+const accounts_1 = require("./commands/accounts");
 const browse_1 = require("./commands/browse");
 const search_1 = require("./commands/search");
+const tags_1 = require("./commands/tags");
 const detail_1 = require("./commands/detail");
 const play_1 = require("./commands/play");
+const ads_1 = require("./commands/ads");
 const comments_1 = require("./commands/comments");
 const versionsBrowse_1 = require("./commands/versionsBrowse");
 const credits_1 = require("./commands/credits");
+const boosts_1 = require("./commands/boosts");
 const notifications_1 = require("./commands/notifications");
 const creations_1 = require("./commands/creations");
 const generation_1 = require("./commands/generation");
@@ -23,6 +27,8 @@ const create_1 = require("./commands/create");
 const createRemixContent_1 = require("./commands/createRemixContent");
 const dev_1 = require("./commands/dev");
 const capture_1 = require("./commands/capture");
+const devServer_1 = require("./commands/devServer");
+const captureListing_1 = require("./commands/captureListing");
 const captureRemote_1 = require("./commands/captureRemote");
 const validate_1 = require("./commands/validate");
 const build_1 = require("./commands/build");
@@ -95,6 +101,9 @@ program.on('command:*', (unknownCommands) => {
 function createEnvOption() {
     return new commander_1.Option('--env <env>', 'Environment (dev|local|prod)').default('prod');
 }
+function collectRepeatedOption(value, previous = []) {
+    return [...previous, value];
+}
 function registerLoginCommand(parent) {
     parent
         .command('login')
@@ -115,8 +124,10 @@ function registerLogoutCommand(parent) {
     parent
         .command('logout')
         .description('Log out of Playdrop')
-        .action(() => {
-        (0, logout_1.logout)();
+        .argument('[username]', 'Username to log out')
+        .option('--env <env>', 'Environment for targeted logout')
+        .action((username, opts) => {
+        (0, logout_1.logout)({ username, env: opts.env });
     });
 }
 function registerWhoamiCommand(parent) {
@@ -127,6 +138,23 @@ function registerWhoamiCommand(parent) {
         await (0, whoami_1.whoami)();
     });
 }
+function registerAccountsCommand(parent) {
+    parent
+        .command('accounts')
+        .description('List stored Playdrop accounts')
+        .action(() => {
+        (0, accounts_1.listAccounts)();
+    });
+}
+function registerUseAccountCommand(parent) {
+    parent
+        .command('use <username>')
+        .description('Switch the default Playdrop account')
+        .option('--env <env>', 'Environment for the selected account')
+        .action((username, opts) => {
+        (0, accounts_1.useAccount)(username, opts.env);
+    });
+}
 registerLoginCommand(program);
 registerLogoutCommand(program);
 registerWhoamiCommand(program);
@@ -134,15 +162,22 @@ const auth = program.command('auth').description('Authentication commands');
 registerLoginCommand(auth);
 registerLogoutCommand(auth);
 registerWhoamiCommand(auth);
+registerAccountsCommand(auth);
+registerUseAccountCommand(auth);
 const browseCommand = program.command('browse').description('Browse public content');
 browseCommand
-    .option('--kind <kind>', 'app, asset, asset-pack, or all')
+    .option('--kind <kind>', 'app, asset, asset-pack, asset-spec, or all')
     .option('--creator <creator>', 'all, me, or a creator slug')
     .option('--app-type <type>', 'game, demo, tool, or template')
     .option('--asset-category <category>', 'Asset category filter')
     .option('--asset-subcategory <subcategory>', 'Asset subcategory filter')
+    .option('--asset-spec <ref>', 'Asset spec family or version filter for assets')
+    .option('--asset-spec-owner <creator>', 'Asset spec owner filter for assets')
+    .option('--asset-spec-name <name>', 'Asset spec name filter for assets')
+    .option('--sort <sort>', 'Sort asset or asset-spec browse results')
     .option('--limit <number>', 'Maximum number of results to return')
     .option('--offset <number>', 'Result offset')
+    .option('--tag <ref>', 'Filter by canonical tag ref', collectRepeatedOption, [])
     .option('--json', 'Output JSON')
     .action(async (opts) => {
     await (0, browse_1.browse)(opts);
@@ -157,18 +192,33 @@ browseCommand
 program
     .command('search <query>')
     .description('Search public content')
-    .option('--kind <kind>', 'app, asset, asset-pack, or all')
+    .option('--kind <kind>', 'app, asset, asset-pack, asset-spec, or all')
     .option('--app-type <type>', 'game, demo, tool, or template')
     .option('--asset-category <category>', 'Asset category filter')
     .option('--asset-subcategory <subcategory>', 'Asset subcategory filter')
+    .option('--asset-spec <ref>', 'Asset spec family or version filter for assets')
+    .option('--asset-spec-owner <creator>', 'Asset spec owner filter for assets')
+    .option('--asset-spec-name <name>', 'Asset spec name filter for assets')
+    .option('--sort <sort>', 'Sort search results')
     .option('--pack-contains-category <category>', 'Asset pack category filter')
     .option('--pack-contains-subcategory <subcategory>', 'Asset pack subcategory filter')
     .option('--limit <number>', 'Maximum number of results to return')
     .option('--offset <number>', 'Result offset')
+    .option('--tag <ref>', 'Filter by canonical tag ref', collectRepeatedOption, [])
     .option('--json', 'Output JSON')
     .action(async (query, opts) => {
     await (0, search_1.search)(query, opts);
 });
+const tags = program.command('tags').description('Browse and inspect tags');
+tags
+    .command('browse')
+    .description('Browse public tags')
+    .option('--group <slug>', 'Filter to one tag group')
+    .option('--kind <kind>', 'Filter to one target kind')
+    .option('--json', 'Output JSON')
+    .action(async (opts) => {
+    await (0, tags_1.browseTags)(opts);
+});
 program
     .command('detail <ref>')
     .description('Show one app, asset, or asset pack')
@@ -234,6 +284,88 @@ credits
     .action(async (opts) => {
     await (0, credits_1.browseCreditTransactions)(opts);
 });
+credits
+    .command('earnings')
+    .description('Show creator ad earnings and boost spend summary')
+    .option('--days <number>', 'Number of days to include')
+    .option('--app-id <number>', 'Filter to one app id')
+    .option('--json', 'Output JSON')
+    .action(async (opts) => {
+    await (0, credits_1.showCreatorEarnings)(opts);
+});
+const ads = program.command('ads').description('Creator ad earnings and reporting');
+ads
+    .command('earnings')
+    .description('Show ad earnings grouped by app and format')
+    .option('--app <ref>', 'Filter to one app ref')
+    .option('--days <number>', 'Number of days to include')
+    .option('--json', 'Output JSON')
+    .action(async (opts) => {
+    await (0, ads_1.showAdsEarnings)(opts);
+});
+ads
+    .command('report')
+    .description('Show daily ad reporting buckets')
+    .option('--app <ref>', 'Filter to one app ref')
+    .option('--days <number>', 'Number of days to include')
+    .option('--json', 'Output JSON')
+    .action(async (opts) => {
+    await (0, ads_1.showAdsReport)(opts);
+});
+const boosts = program.command('boosts').description('Buy, activate, and inspect game boosts');
+boosts
+    .command('balance')
+    .description('Show your available boost inventory')
+    .option('--json', 'Output JSON')
+    .action(async (opts) => {
+    await (0, boosts_1.showBoostBalance)(opts);
+});
+boosts
+    .command('offers')
+    .description('List available boost packs')
+    .option('--json', 'Output JSON')
+    .action(async (opts) => {
+    await (0, boosts_1.browseBoostOffers)(opts);
+});
+boosts
+    .command('buy <sku>')
+    .description('Buy one boost pack')
+    .option('--quantity <number>', 'Number of packs to buy')
+    .option('--json', 'Output JSON')
+    .action(async (sku, opts) => {
+    await (0, boosts_1.buyBoostPack)(sku, opts);
+});
+boosts
+    .command('activate <ref>')
+    .description('Activate one or more boosts for an app')
+    .option('--units <number>', 'Number of boosts to consume')
+    .option('--json', 'Output JSON')
+    .action(async (ref, opts) => {
+    await (0, boosts_1.activateBoost)(ref, opts);
+});
+boosts
+    .command('status <ref>')
+    .description('Show the current boost status for an app')
+    .option('--json', 'Output JSON')
+    .action(async (ref, opts) => {
+    await (0, boosts_1.showBoostStatus)(ref, opts);
+});
+boosts
+    .command('history <ref>')
+    .description('Show past boost runs for an app')
+    .option('--limit <number>', 'Maximum number of boost runs to include')
+    .option('--json', 'Output JSON')
+    .action(async (ref, opts) => {
+    await (0, boosts_1.showBoostHistory)(ref, opts);
+});
+boosts
+    .command('report <ref>')
+    .description('Show daily boost performance for an app')
+    .option('--days <number>', 'Number of days to include')
+    .option('--json', 'Output JSON')
+    .action(async (ref, opts) => {
+    await (0, boosts_1.showBoostReport)(ref, opts);
+});
 const notifications = program.command('notifications').description('Notification inbox');
 notifications
     .command('browse')
@@ -504,6 +636,13 @@ aiJobs
     await (0, generation_1.showGenerationJob)(id, opts);
 });
 const project = program.command('project').description('Local workspace tooling');
+const internalDevRouter = project.command('_dev-router').description('Internal shared dev router');
+internalDevRouter
+    .command('serve')
+    .description('Run the internal shared dev router')
+    .action(async () => {
+    await (0, devServer_1.runDevRouterServer)();
+});
 project
     .command('init [path]')
     .description('Initialize a Playdrop workspace')
@@ -519,6 +658,12 @@ projectCreate
     .action(async (name, opts) => {
     await (0, create_1.create)(name, opts);
 });
+projectCreate
+    .command('asset-spec <name>')
+    .description('Create a new custom asset spec scaffold')
+    .action(async (name) => {
+    await (0, create_1.createAssetSpecProject)(name);
+});
 projectCreate
     .command('asset <name>')
     .description('Create a new asset remix from an exact asset version')
@@ -562,6 +707,31 @@ projectCapture
         password: opts.password,
     });
 });
+projectCapture
+    .command('listing [target]', { hidden: true })
+    .description('Record private listing video for a hosted app')
+    .option('--app <name>', 'App name when the target is a workspace')
+    .option('--duration <seconds>', 'Recording duration in seconds')
+    .option('--width <pixels>', 'Final gameplay width in pixels')
+    .option('--height <pixels>', 'Final gameplay height in pixels')
+    .option('--fps <number>', 'Final output frame rate')
+    .option('--poster-at <seconds>', 'Poster frame offset in seconds')
+    .option('--audio', 'Capture gameplay audio')
+    .option('--output-dir <path>', 'Output directory for the capture artifacts')
+    .option('--keep-raw', 'Keep the raw intermediate recording')
+    .action(async (target, opts) => {
+    await (0, captureListing_1.captureListing)(target, {
+        app: opts.app,
+        duration: opts.duration,
+        width: opts.width,
+        height: opts.height,
+        fps: opts.fps,
+        posterAt: opts.posterAt,
+        audio: opts.audio,
+        outputDir: opts.outputDir,
+        keepRaw: opts.keepRaw,
+    });
+});
 projectCapture
     .command('remote <url>')
     .description('Run a Playwright capture against a published URL')
@@ -600,8 +770,10 @@ project
     .command('publish [target]')
     .description('Publish local content to Playdrop')
     .option('--skip-ecs', 'Skip ecs.json and server.js during publish')
+    .option('--clear-tags', 'Confirm clearing existing live tags when this publish removes them')
+    .addOption(new commander_1.Option('--skip-review', 'Mark uploaded app versions as NOT_REQUIRED review. Admin-only.').hideHelp())
     .action(async (target, opts) => {
-    await (0, upload_1.upload)(target ?? '.', { skipEcs: opts.skipEcs });
+    await (0, upload_1.upload)(target ?? '.', { skipEcs: opts.skipEcs, skipReview: opts.skipReview, clearTags: opts.clearTags });
 });
 const documentation = program.command('documentation').description('Public Playdrop documentation');
 documentation

package/dist/refs.d.ts

@@ -1,6 +1,6 @@
 import type { ApiClient } from '@playdrop/api-client';
 import type { SavedItemKind } from '@playdrop/types';
-export type ContentKind = 'app' | 'asset' | 'asset-pack';
+export type ContentKind = 'app' | 'asset' | 'asset-pack' | 'asset-spec';
 export type ContentRef = {
     creator: string;
     kind: ContentKind;
@@ -13,6 +13,6 @@ export declare function parseCreatorOption(raw: string | undefined): string | 'm
 export declare function resolveCreatorOption(client: ApiClient, raw: string | undefined): Promise<string>;
 export declare function buildScopedRef(creator: string, kind: ContentKind, name: string): ContentRef;
 export declare function contentKindToSavedItemKind(kind: ContentKind): SavedItemKind;
-export declare function contentKindToSearchKind(kind: ContentKind | 'all'): 'all' | 'app' | 'asset' | 'pack';
+export declare function contentKindToSearchKind(kind: ContentKind | 'all'): 'all' | 'app' | 'asset' | 'asset-spec' | 'pack';
 export declare function contentKindLabel(kind: ContentKind): string;
 export declare function contentKindPluralLabel(kind: ContentKind): string;

package/dist/refs.js

@@ -31,7 +31,7 @@ function parseContentRef(raw) {
     const creator = sanitizeSegment(segments[0], 'creator');
     const kind = sanitizeSegment(segments[1], 'kind');
     const name = sanitizeSegment(segments[2], 'name');
-    if (kind !== 'app' && kind !== 'asset' && kind !== 'asset-pack') {
+    if (kind !== 'app' && kind !== 'asset' && kind !== 'asset-pack' && kind !== 'asset-spec') {
         throw new Error('invalid_kind');
     }
     return {
@@ -83,9 +83,15 @@ function contentKindToSavedItemKind(kind) {
     if (kind === 'asset') {
         return 'ASSET';
     }
+    if (kind === 'asset-spec') {
+        throw new Error('asset_specs_not_saveable');
+    }
     return 'PACK';
 }
 function contentKindToSearchKind(kind) {
+    if (kind === 'asset-spec') {
+        return 'asset-spec';
+    }
     if (kind === 'asset-pack') {
         return 'pack';
     }
@@ -95,11 +101,17 @@ function contentKindLabel(kind) {
     if (kind === 'asset-pack') {
         return 'asset pack';
     }
+    if (kind === 'asset-spec') {
+        return 'asset spec';
+    }
     return kind;
 }
 function contentKindPluralLabel(kind) {
     if (kind === 'asset-pack') {
         return 'asset packs';
     }
+    if (kind === 'asset-spec') {
+        return 'asset specs';
+    }
     return `${kind}s`;
 }

package/dist/taskSelection.js

@@ -29,6 +29,8 @@ function createDirectAppTask(htmlPath) {
         emoji: undefined,
         color: undefined,
         surfaceTargets: [],
+        assetSpecSupport: [],
+        tags: [],
         missingMetadata: [],
         achievements: [],
         leaderboards: [],
@@ -53,7 +55,7 @@ function selectTasks(pathOrName) {
                 });
                 return { tasks: [], warnings, errors, resolution: 'directory' };
             }
-            const { apps, assets, embeddedAssets, assetPacks, warnings: rawWarnings, errors: catalogueErrors } = (0, catalogue_1.resolveCatalogueEntries)(absolute);
+            const { apps, assetSpecs, assets, embeddedAssets, assetPacks, warnings: rawWarnings, errors: catalogueErrors } = (0, catalogue_1.resolveCatalogueEntries)(absolute);
             if (catalogueErrors.length > 0) {
                 catalogueErrors.forEach(message => {
                     errors.push({
@@ -64,12 +66,12 @@ function selectTasks(pathOrName) {
                 });
                 return { tasks: [], warnings, errors, resolution: 'directory' };
             }
-            const taskList = [...assets, ...apps, ...embeddedAssets, ...assetPacks];
+            const taskList = [...assetSpecs, ...assets, ...apps, ...embeddedAssets, ...assetPacks];
             if (taskList.length === 0) {
                 errors.push({
                     type: 'no-tasks',
                     message: `No publishable entries were found under ${absolute}.`,
-                    help: ['Add child catalogue.json files or add apps, assets, or assetPacks to the root catalogue.json, then rerun the command.'],
+                    help: ['Add child catalogue.json files or add apps, assetSpecs, assets, or assetPacks to the root catalogue.json, then rerun the command.'],
                     directory: absolute,
                 });
                 return { tasks: [], warnings, errors, resolution: 'directory' };
@@ -126,6 +128,7 @@ function selectTasks(pathOrName) {
     }
     const candidates = [
         ...lookup.apps.filter(task => task.name === pathOrName),
+        ...lookup.assetSpecs.filter(task => task.name === pathOrName),
         ...lookup.assets.filter(task => task.name === pathOrName),
         ...lookup.assetPacks.filter(task => task.name === pathOrName),
     ];

package/dist/taskUtils.d.ts

@@ -1,4 +1,4 @@
-import type { AppTask, AssetTask, EmbeddedAssetTask, AssetPackTask } from './catalogue';
-export type CliTask = AppTask | AssetTask | EmbeddedAssetTask | AssetPackTask;
+import type { AppTask, AssetSpecTask, AssetTask, EmbeddedAssetTask, AssetPackTask } from './catalogue';
+export type CliTask = AppTask | AssetSpecTask | AssetTask | EmbeddedAssetTask | AssetPackTask;
 export declare function sortTasks(tasks: CliTask[]): CliTask[];
 export declare function addTaskWarnings(warnings: Set<string>, tasks: CliTask[]): void;

package/dist/taskUtils.js

@@ -5,6 +5,7 @@ exports.addTaskWarnings = addTaskWarnings;
 const catalogue_1 = require("./catalogue");
 function sortTasks(tasks) {
     const order = {
+        'asset-spec': -1,
         asset: 0,
         app: 1,
         'embedded-asset': 2,

package/dist/uploadLog.d.ts

@@ -3,7 +3,7 @@ export type TaskStatus = 'success' | 'skipped' | 'error';
 export type TaskLogEntry = {
     action: TaskAction;
     status: TaskStatus;
-    entityType: 'app' | 'asset' | 'embedded-asset' | 'asset-pack';
+    entityType: 'app' | 'asset-spec' | 'asset' | 'embedded-asset' | 'asset-pack' | 'tag-group' | 'tag';
     entityId: string;
     catalogue: string;
     detail?: string;

package/dist/uploadLog.js

@@ -39,7 +39,7 @@ function formatLabel(entry) {
 function formatTaskLogLine(entry) {
     const prefix = `${STATUS_EMOJI[entry.status]} ${formatLabel(entry)}`;
     if (entry.detail) {
-        return `${prefix} – ${entry.detail}`;
+        return `${prefix} - ${entry.detail}`;
     }
     return prefix;
 }
@@ -108,7 +108,7 @@ function printTaskSummary(entries, warnings, options) {
         summaryText = labels.complete;
     }
     const parts = [
-        `${summaryEmoji} ${summaryText} – ${success} ${labels.unit}`,
+        `${summaryEmoji} ${summaryText} - ${success} ${labels.unit}`,
         `${skipped} skipped`,
         `${failed} failed`,
     ];

package/dist/workspaceAuth.d.ts

@@ -0,0 +1,14 @@
+export interface WorkspaceAuthConfig {
+    ownerUsername: string;
+    env?: string;
+}
+export interface ResolvedWorkspaceAuthConfig {
+    path: string;
+    directory: string;
+    config: WorkspaceAuthConfig;
+}
+export declare class WorkspaceAuthConfigError extends Error {
+    readonly filePath: string;
+    constructor(filePath: string, reason: 'invalid_json' | 'invalid_shape' | 'missing_owner_username');
+}
+export declare function findWorkspaceAuthConfig(startPath: string): ResolvedWorkspaceAuthConfig | null;

package/dist/workspaceAuth.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkspaceAuthConfigError = void 0;
+exports.findWorkspaceAuthConfig = findWorkspaceAuthConfig;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+class WorkspaceAuthConfigError extends Error {
+    constructor(filePath, reason) {
+        super(reason);
+        this.name = 'WorkspaceAuthConfigError';
+        this.filePath = filePath;
+    }
+}
+exports.WorkspaceAuthConfigError = WorkspaceAuthConfigError;
+const WORKSPACE_AUTH_FILENAME = '.playdrop.json';
+function normalizeOwnerUsername(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const normalized = value.trim();
+    return normalized.length > 0 ? normalized : null;
+}
+function normalizeEnv(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const normalized = value.trim();
+    return normalized.length > 0 ? normalized : undefined;
+}
+function readWorkspaceAuthConfig(filePath) {
+    let parsed;
+    try {
+        const raw = (0, node_fs_1.readFileSync)(filePath, 'utf8');
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new WorkspaceAuthConfigError(filePath, 'invalid_json');
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new WorkspaceAuthConfigError(filePath, 'invalid_shape');
+    }
+    const ownerUsername = normalizeOwnerUsername(parsed.ownerUsername);
+    if (!ownerUsername) {
+        throw new WorkspaceAuthConfigError(filePath, 'missing_owner_username');
+    }
+    return {
+        ownerUsername,
+        env: normalizeEnv(parsed.env),
+    };
+}
+function findWorkspaceAuthConfig(startPath) {
+    let current = (0, node_path_1.resolve)(startPath);
+    if ((0, node_fs_1.existsSync)(current) && (0, node_fs_1.statSync)(current).isFile()) {
+        current = (0, node_path_1.dirname)(current);
+    }
+    while (true) {
+        const candidate = (0, node_path_1.join)(current, WORKSPACE_AUTH_FILENAME);
+        if ((0, node_fs_1.existsSync)(candidate) && (0, node_fs_1.statSync)(candidate).isFile()) {
+            const config = readWorkspaceAuthConfig(candidate);
+            if (config) {
+                return {
+                    path: candidate,
+                    directory: current,
+                    config,
+                };
+            }
+            return null;
+        }
+        const parent = (0, node_path_1.dirname)(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}

package/node_modules/@playdrop/ai-client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playdrop/ai-client",
-  "version": "0.5.1",
+  "version": "0.5.4",
   "description": "Client SDK for the Playdrop AI server",
   "type": "module",
   "main": "dist/index.js",