@playdrop/playdrop-cli 0.8.1 → 0.8.3

package/config/client-meta.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.8.1",
+  "version": "0.8.3",
   "runtimeSdkVersion": "0.7.21",
   "build": 1,
   "clients": {

package/dist/catalogue.js

@@ -1,4 +1,5 @@
 "use strict";
+/* eslint-disable complexity, max-lines, max-lines-per-function */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateAppMetadata = validateAppMetadata;
 exports.resolveCatalogueTagGroups = resolveCatalogueTagGroups;
@@ -2187,7 +2188,6 @@ function buildAssetPackTasks(catalogues) {
     }
     return { tasks, warnings, errors };
 }
-// eslint-disable-next-line complexity
 function resolveCatalogueTagGroups(rootDir) {
     const { files, errors: discoveryErrors } = walkCatalogueTree(rootDir);
     if (discoveryErrors.length > 0) {

package/dist/commands/create.d.ts

@@ -1,6 +1,7 @@
 type CreateOptions = {
     template?: string;
     remix?: string;
+    gameIdea?: string;
 };
 export declare function createAssetSpecProject(name: string): Promise<void>;
 export declare function create(name: string, options?: CreateOptions): Promise<void>;

package/dist/commands/create.js

@@ -1,4 +1,5 @@
 "use strict";
+/* eslint-disable complexity, max-lines, max-lines-per-function */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -23,6 +24,8 @@ const clientInfo_1 = require("../clientInfo");
 const CATALOGUE_FILENAME = 'catalogue.json';
 const LEGACY_CATALOGUE_VERSION_KEY = ['schema', 'Version'].join('');
 const ALLOWED_CATALOGUE_TOP_LEVEL_KEYS = new Set(['apps', 'assetSpecs', 'assets', 'assetPacks']);
+const DEFAULT_GAME_IDEA_TEMPLATE = 'playdrop/template/typescript_template';
+const GAME_IDEA_LOOKUP_PAGE_SIZE = 200;
 function buildArchiveDownloadHeaders(url, apiBase, token) {
     const targetUrl = new URL(url, apiBase);
     const apiOrigin = new URL(apiBase).origin;
@@ -1014,13 +1017,50 @@ function describeInitSummary(summary) {
     }
     return `Project bootstrap recap: ${parts.join('; ')}.`;
 }
+function gameIdeaMatchesRef(gameIdea, ref) {
+    return String(gameIdea.id) === ref || gameIdea.slug === ref;
+}
+async function findGameIdeaForCreate(client, gameIdeaRef) {
+    let offset = 0;
+    for (;;) {
+        const response = await client.listGameIdeas({
+            state: 'ALL',
+            limit: GAME_IDEA_LOOKUP_PAGE_SIZE,
+            offset,
+        });
+        const match = response.gameIdeas.find((gameIdea) => gameIdeaMatchesRef(gameIdea, gameIdeaRef));
+        if (match) {
+            return match;
+        }
+        if (!response.pagination.hasMore) {
+            throw new Error('game_idea_not_found');
+        }
+        offset += response.pagination.limit;
+    }
+}
+function inferCreateSourceFromGameIdea(gameIdea) {
+    if (gameIdea.inputMode !== 'REMIX') {
+        return { template: DEFAULT_GAME_IDEA_TEMPLATE };
+    }
+    const sourceAppRef = typeof gameIdea.inputData.sourceAppRef === 'string' ? gameIdea.inputData.sourceAppRef.trim() : '';
+    if (!sourceAppRef) {
+        throw new Error('game_idea_remix_source_missing');
+    }
+    return { remix: sourceAppRef };
+}
+async function inferCreateSourceOptionsForGameIdea(client, gameIdeaRef) {
+    const gameIdea = await findGameIdeaForCreate(client, gameIdeaRef);
+    return inferCreateSourceFromGameIdea(gameIdea);
+}
 async function create(name, options = {}) {
     const file = (0, node_path_1.resolve)(`${name}.html`);
     const projectDirCandidate = (0, node_path_1.resolve)(name);
-    const templateOptionRaw = options.template?.trim();
-    const remixOptionRaw = options.remix?.trim();
+    const gameIdeaRef = typeof options.gameIdea === 'string' ? options.gameIdea.trim() : '';
+    let templateOptionRaw = options.template?.trim();
+    let remixOptionRaw = options.remix?.trim();
     let parsedTemplate = null;
     let parsedRemix = null;
+    let ctx = null;
     const existingLookup = (0, catalogue_1.resolveCatalogueEntries)(process.cwd(), { filterName: name });
     if (existingLookup.errors.length > 0) {
         for (const error of existingLookup.errors) {
@@ -1040,7 +1080,56 @@ async function create(name, options = {}) {
         return;
     }
     const existingTask = existingLookup.apps.length === 1 ? existingLookup.apps[0] : null;
-    const reuseExistingApp = existingTask !== null && !templateOptionRaw && !remixOptionRaw;
+    if (templateOptionRaw && remixOptionRaw) {
+        (0, messages_1.printErrorWithHelp)('Cannot use --template and --remix at the same time.', ['Choose one source: use "--remix app:creator/name@1.2.3" to remix an app version, or "--template {creator}/template/{name}" to start from a template.'], { command: 'project create app' });
+        process.exitCode = 1;
+        return;
+    }
+    let reuseExistingApp = existingTask !== null && !templateOptionRaw && !remixOptionRaw;
+    if (!reuseExistingApp && !templateOptionRaw && !remixOptionRaw && gameIdeaRef) {
+        ctx = await (0, commandContext_1.resolveAuthenticatedEnvironmentContext)('project create app', 'Creating an app', { workspacePath: process.cwd() });
+        if (!ctx) {
+            return;
+        }
+        try {
+            const inferredSource = await inferCreateSourceOptionsForGameIdea(ctx.client, gameIdeaRef);
+            templateOptionRaw = inferredSource.template;
+            remixOptionRaw = inferredSource.remix;
+        }
+        catch (error) {
+            if (error instanceof http_1.CLIUnsupportedClientError) {
+                process.exitCode = 1;
+                return;
+            }
+            if (error instanceof types_1.UnsupportedClientError) {
+                (0, http_1.handleUnsupportedError)(error, 'Resolve game idea');
+                process.exitCode = 1;
+                return;
+            }
+            if (error instanceof types_1.ApiError) {
+                (0, messages_1.printErrorWithHelp)(`Failed to load game idea ${gameIdeaRef} (status ${error.status}).`, ['Confirm the game idea id or slug, then retry with "playdrop creations ideas browse --state all".'], { command: 'project create app' });
+                process.exitCode = 1;
+                return;
+            }
+            if (error instanceof TypeError) {
+                (0, messages_1.printNetworkIssue)('Could not reach the Playdrop API to load the game idea.', 'project create app');
+                process.exitCode = 1;
+                return;
+            }
+            if (error instanceof Error && error.message === 'game_idea_not_found') {
+                (0, messages_1.printErrorWithHelp)(`Could not find game idea ${gameIdeaRef}.`, ['Run "playdrop creations ideas browse --state all" and retry with the exact id or slug.'], { command: 'project create app' });
+                process.exitCode = 1;
+                return;
+            }
+            if (error instanceof Error && error.message === 'game_idea_remix_source_missing') {
+                (0, messages_1.printErrorWithHelp)(`Game idea ${gameIdeaRef} is a remix idea but does not include a source app ref.`, ['Create a new game idea from the web remix flow, then retry with that id or slug.'], { command: 'project create app' });
+                process.exitCode = 1;
+                return;
+            }
+            throw error;
+        }
+    }
+    reuseExistingApp = existingTask !== null && !templateOptionRaw && !remixOptionRaw;
     if (!reuseExistingApp && ((0, node_fs_1.existsSync)(file) || (0, node_fs_1.existsSync)(projectDirCandidate))) {
         (0, messages_1.printErrorWithHelp)(`Cannot create ${name} because a file or directory with that name already exists.`, [
             'Choose a different app name or remove the existing file before running "playdrop project create app" again.'
@@ -1048,11 +1137,6 @@ async function create(name, options = {}) {
         process.exitCode = 1;
         return;
     }
-    if (templateOptionRaw && remixOptionRaw) {
-        (0, messages_1.printErrorWithHelp)('Cannot use --template and --remix at the same time.', ['Choose one source: use "--remix app:creator/name@1.2.3" to remix an app version, or "--template {creator}/template/{name}" to start from a template.'], { command: 'project create app' });
-        process.exitCode = 1;
-        return;
-    }
     if (!templateOptionRaw && !remixOptionRaw) {
         if (!reuseExistingApp) {
             (0, messages_1.printErrorWithHelp)('Specify either --template or --remix when creating an app.', [
@@ -1087,7 +1171,7 @@ async function create(name, options = {}) {
             return;
         }
     }
-    const ctx = await (0, commandContext_1.resolveAuthenticatedEnvironmentContext)('project create app', 'Creating an app', { workspacePath: process.cwd() });
+    ctx = ctx ?? await (0, commandContext_1.resolveAuthenticatedEnvironmentContext)('project create app', 'Creating an app', { workspacePath: process.cwd() });
     if (!ctx) {
         return;
     }
@@ -1386,6 +1470,7 @@ async function create(name, options = {}) {
         }
         registrationTask = selectedTask;
     }
+    let gameIdeaAppRef = null;
     if (registrationTask) {
         const metadataWarning = (0, catalogue_1.formatMissingMetadataWarnings)(registrationTask);
         if (metadataWarning) {
@@ -1506,6 +1591,7 @@ async function create(name, options = {}) {
                 throw error;
             }
         }
+        gameIdeaAppRef = `${creatorUsername}/${name}`;
     }
     const projectDirLabel = projectDir ? ((0, node_path_1.relative)(process.cwd(), projectDir) || projectDir) : null;
     const entryPointLabel = (0, node_path_1.relative)(process.cwd(), htmlFilePath) || (0, node_path_1.basename)(htmlFilePath);
@@ -1543,6 +1629,70 @@ async function create(name, options = {}) {
             catalogueLabel = (0, node_path_1.relative)(process.cwd(), existingTask.catalogueAbsolutePath) || CATALOGUE_FILENAME;
         }
     }
+    if (gameIdeaRef) {
+        if (!gameIdeaAppRef) {
+            try {
+                const creatorUsername = await resolveAuthenticatedCreatorUsername(client);
+                gameIdeaAppRef = `${creatorUsername}/${name}`;
+            }
+            catch (error) {
+                if (error instanceof http_1.CLIUnsupportedClientError) {
+                    process.exitCode = 1;
+                    return;
+                }
+                if (error instanceof types_1.UnsupportedClientError) {
+                    (0, http_1.handleUnsupportedError)(error, 'Resolve creator account');
+                    process.exitCode = 1;
+                    return;
+                }
+                if (error instanceof types_1.ApiError) {
+                    (0, messages_1.printErrorWithHelp)(`Failed to resolve your creator account (status ${error.status}).`, ['Run "playdrop auth login" to refresh your session, then try again.'], { command: 'project create app' });
+                    process.exitCode = 1;
+                    return;
+                }
+                if (error instanceof TypeError) {
+                    (0, messages_1.printNetworkIssue)('Could not reach the Playdrop API to resolve your creator account.', 'project create app');
+                    process.exitCode = 1;
+                    return;
+                }
+                if (error instanceof Error && error.message === 'missing_creator_username') {
+                    (0, messages_1.printErrorWithHelp)('The API did not return a creator username.', ['Run "playdrop auth login" again, then retry.'], { command: 'project create app' });
+                    process.exitCode = 1;
+                    return;
+                }
+                throw error;
+            }
+        }
+        if (!gameIdeaAppRef) {
+            throw new Error('missing_game_idea_app_ref');
+        }
+        try {
+            const response = await client.startGameIdea(gameIdeaRef, { app: gameIdeaAppRef });
+            console.log(`Marked game idea ${response.gameIdea.slug} as started.`);
+        }
+        catch (error) {
+            if (error instanceof http_1.CLIUnsupportedClientError) {
+                process.exitCode = 1;
+                return;
+            }
+            if (error instanceof types_1.UnsupportedClientError) {
+                (0, http_1.handleUnsupportedError)(error, 'Mark game idea started');
+                process.exitCode = 1;
+                return;
+            }
+            if (error instanceof types_1.ApiError) {
+                (0, messages_1.printErrorWithHelp)(`Failed to mark game idea ${gameIdeaRef} as started (status ${error.status}).`, ['Confirm the game idea id or slug, then retry with "playdrop creations ideas start <id-or-slug>".'], { command: 'project create app' });
+                process.exitCode = 1;
+                return;
+            }
+            if (error instanceof TypeError) {
+                (0, messages_1.printNetworkIssue)('Could not reach the Playdrop API to mark the game idea started.', 'project create app');
+                process.exitCode = 1;
+                return;
+            }
+            throw error;
+        }
+    }
     logNextSteps(name, {
         hasCatalogue,
         catalogueLabel,

package/dist/commands/creations.d.ts

@@ -5,6 +5,16 @@ type BrowseCreationsOptions = {
     offset?: string | number;
     json?: boolean;
 };
+type BrowseIdeasOptions = {
+    state?: string;
+    limit?: string | number;
+    offset?: string | number;
+    json?: boolean;
+};
+type IdeaMutationOptions = {
+    app?: string;
+    json?: boolean;
+};
 type AppUpdateOptions = {
     creator?: string;
     displayName?: string;
@@ -28,6 +38,9 @@ type MutationOptions = {
     json?: boolean;
 };
 export declare function browseCreations(options?: BrowseCreationsOptions): Promise<void>;
+export declare function browseCreationIdeas(options?: BrowseIdeasOptions): Promise<void>;
+export declare function startCreationIdea(idOrSlug: string | undefined, options?: IdeaMutationOptions): Promise<void>;
+export declare function shipCreationIdea(idOrSlug: string | undefined, options?: IdeaMutationOptions): Promise<void>;
 export declare function updateCreationApp(nameArg: string | undefined, options?: AppUpdateOptions): Promise<void>;
 export declare function deleteCreationApp(nameArg: string | undefined, options?: MutationOptions): Promise<void>;
 export declare function setCurrentCreationAppVersion(nameArg: string | undefined, versionArg: string | undefined, options?: MutationOptions): Promise<void>;

package/dist/commands/creations.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.browseCreations = browseCreations;
+exports.browseCreationIdeas = browseCreationIdeas;
+exports.startCreationIdea = startCreationIdea;
+exports.shipCreationIdea = shipCreationIdea;
 exports.updateCreationApp = updateCreationApp;
 exports.deleteCreationApp = deleteCreationApp;
 exports.setCurrentCreationAppVersion = setCurrentCreationAppVersion;
@@ -26,6 +29,7 @@ const messages_1 = require("../messages");
 const output_1 = require("../output");
 const refs_1 = require("../refs");
 const MERGED_PAGE_SIZE = 100;
+const IDEA_STATE_VALUES = new Set(['idea', 'started', 'shipped', 'all']);
 function parseBrowseKind(raw) {
     if (!raw || raw.trim().length === 0) {
         return 'all';
@@ -49,6 +53,19 @@ function parsePositiveInteger(raw, label, fallback) {
     }
     return parsed;
 }
+function parseIdeaState(raw) {
+    if (!raw || raw.trim().length === 0) {
+        return 'IDEA';
+    }
+    const normalized = raw.trim().toLowerCase();
+    if (!IDEA_STATE_VALUES.has(normalized)) {
+        return null;
+    }
+    if (normalized === 'all') {
+        return 'ALL';
+    }
+    return normalized.toUpperCase();
+}
 async function resolveCreator(client, rawCreator, command) {
     let creator;
     try {
@@ -294,6 +311,130 @@ async function browseCreations(options = {}) {
         }
     });
 }
+async function browseCreationIdeas(options = {}) {
+    const state = parseIdeaState(options.state);
+    if (!state) {
+        (0, messages_1.printErrorWithHelp)('The --state value is invalid.', ['Use one of: idea, started, shipped, all.'], { command: 'creations ideas browse' });
+        process.exitCode = 1;
+        return;
+    }
+    const limit = parsePositiveInteger(options.limit, 'limit', 20);
+    if (limit === null) {
+        (0, messages_1.printErrorWithHelp)('The --limit value must be a positive integer.', ['Example: --limit 20'], { command: 'creations ideas browse' });
+        process.exitCode = 1;
+        return;
+    }
+    const offset = parsePositiveInteger(options.offset, 'offset', 0);
+    if (offset === null) {
+        (0, messages_1.printErrorWithHelp)('The --offset value must be zero or a positive integer.', ['Example: --offset 20'], { command: 'creations ideas browse' });
+        process.exitCode = 1;
+        return;
+    }
+    await (0, commandContext_1.withEnvironment)('creations ideas browse', 'Browsing your game ideas', async ({ client }) => {
+        try {
+            const response = await client.listGameIdeas({ state, limit, offset });
+            if (options.json) {
+                (0, output_1.printJson)(response);
+                return;
+            }
+            if (response.gameIdeas.length === 0) {
+                console.log('No game ideas found.');
+                console.log('Next: create one at https://playdrop.ai/create.');
+                return;
+            }
+            console.log('Game ideas:\n');
+            response.gameIdeas.forEach((idea, index) => {
+                const tags = idea.tagRefs.length > 0 ? ` | ${idea.tagRefs.join(', ')}` : '';
+                const app = idea.createdAppRef ? ` | app ${idea.createdAppRef}` : '';
+                console.log(`${index + 1}. ${idea.slug} | ${idea.displayName} | ${idea.state.toLowerCase()}${tags}${app}`);
+            });
+            if (response.pagination.hasMore) {
+                console.log(`\nNext page: playdrop creations ideas browse --state ${String(options.state ?? 'idea')} --offset ${response.pagination.offset + response.pagination.limit}`);
+            }
+        }
+        catch (error) {
+            const handled = (0, errors_1.handleCommandFailure)(error, 'creations ideas browse', 'Game idea lookup', {
+                apiMessage: (apiError) => ({
+                    problem: `Game idea lookup failed with status ${apiError.status}.`,
+                    suggestions: ['Run "playdrop auth login" and retry.'],
+                }),
+            });
+            if (!handled) {
+                throw error;
+            }
+        }
+    });
+}
+async function startCreationIdea(idOrSlug, options = {}) {
+    const ref = typeof idOrSlug === 'string' ? idOrSlug.trim() : '';
+    if (!ref) {
+        (0, messages_1.printErrorWithHelp)('Provide a game idea id or slug.', ['Example: playdrop creations ideas start foxfire-kitchen'], { command: 'creations ideas start' });
+        process.exitCode = 1;
+        return;
+    }
+    await (0, commandContext_1.withEnvironment)('creations ideas start', 'Marking game idea started', async ({ client }) => {
+        try {
+            const response = await client.startGameIdea(ref);
+            if (options.json) {
+                (0, output_1.printJson)(response);
+                return;
+            }
+            (0, output_1.printSuccess)(`Marked ${response.gameIdea.slug} as started.`, [
+                `Next: build and publish the app, then run "playdrop creations ideas ship ${response.gameIdea.slug} --app <creator>/<name>".`,
+            ]);
+        }
+        catch (error) {
+            const handled = (0, errors_1.handleCommandFailure)(error, 'creations ideas start', 'Game idea update', {
+                apiMessage: (apiError) => ({
+                    problem: `Game idea update failed with status ${apiError.status}.`,
+                    suggestions: ['Confirm the id or slug, then retry.'],
+                }),
+            });
+            if (!handled) {
+                throw error;
+            }
+        }
+    });
+}
+async function shipCreationIdea(idOrSlug, options = {}) {
+    const ref = typeof idOrSlug === 'string' ? idOrSlug.trim() : '';
+    const appRef = typeof options.app === 'string' ? options.app.trim() : '';
+    if (!ref) {
+        (0, messages_1.printErrorWithHelp)('Provide a game idea id or slug.', ['Example: playdrop creations ideas ship foxfire-kitchen --app olivier/foxfire-kitchen'], { command: 'creations ideas ship' });
+        process.exitCode = 1;
+        return;
+    }
+    if (!appRef) {
+        (0, messages_1.printErrorWithHelp)('Provide --app <creator>/<name>.', ['Example: --app olivier/foxfire-kitchen'], { command: 'creations ideas ship' });
+        process.exitCode = 1;
+        return;
+    }
+    await (0, commandContext_1.withEnvironment)('creations ideas ship', 'Marking game idea shipped', async ({ client }) => {
+        try {
+            const response = await client.shipGameIdea(ref, { app: appRef });
+            if (options.json) {
+                (0, output_1.printJson)(response);
+                return;
+            }
+            (0, output_1.printSuccess)(`Marked ${response.gameIdea.slug} as shipped.`, [
+                response.gameIdea.createdAppRef
+                    ? `Linked app: ${response.gameIdea.createdAppRef}.`
+                    : `Linked app: ${appRef}.`,
+            ]);
+        }
+        catch (error) {
+            const handled = (0, errors_1.handleCommandFailure)(error, 'creations ideas ship', 'Game idea update', {
+                apiMessage: (apiError) => ({
+                    problem: `Game idea update failed with status ${apiError.status}.`,
+                    suggestions: ['Confirm the id or slug and --app value, then retry.'],
+                }),
+            });
+            if (!handled) {
+                throw error;
+            }
+        }
+    });
+}
 async function updateCreationApp(nameArg, options = {}) {
     const name = parseManagedName(nameArg, 'creations apps update');
     if (!name) {

package/dist/commands/upload.d.ts

@@ -3,5 +3,6 @@ export type UploadCommandOptions = {
     skipEcs?: boolean;
     skipReview?: boolean;
     clearTags?: boolean;
+    gameIdea?: string;
 };
 export declare function upload(pathOrName: string, options?: UploadCommandOptions): Promise<void>;

package/dist/commands/upload.js

@@ -6,6 +6,7 @@ const node_path_1 = require("node:path");
 const semver_1 = require("semver");
 const types_1 = require("@playdrop/types");
 const apps_1 = require("../apps");
+const registration_1 = require("../apps/registration");
 const commandContext_1 = require("../commandContext");
 const http_1 = require("../http");
 const catalogue_1 = require("../catalogue");
@@ -811,6 +812,15 @@ function appendTaskRelations(graphState, fromNodeId, relations, contextLabel) {
     });
 }
 async function uploadAppTask(state, task, taskCreator, options) {
+    const gameIdeaRef = typeof options?.gameIdea === 'string' ? options.gameIdea.trim() : '';
+    if (gameIdeaRef) {
+        await (0, registration_1.ensureRegisteredHostedAppShell)({
+            client: state.client,
+            creatorUsername: taskCreator,
+            task,
+        });
+        await state.client.startGameIdea(gameIdeaRef, { app: `${taskCreator}/${task.name}` });
+    }
     const { upload, warnings } = await (0, apps_1.runAppPipeline)(state.client, task, {
         skipEcs: options?.skipEcs,
         skipReview: options?.skipReview,
@@ -844,6 +854,9 @@ async function uploadAppTask(state, task, taskCreator, options) {
     };
     state.uploadedAppsByName.set(task.name, uploadedApp);
     (0, upload_graph_1.registerCanonicalNode)(state.graphState, appRef, uploadedApp.versionNodeId);
+    if (gameIdeaRef) {
+        await state.client.shipGameIdea(gameIdeaRef, { app: `${taskCreator}/${task.name}` });
+    }
     (0, upload_graph_1.registerLocalRef)(state.graphState.localAppNodeByName, state.graphState.ambiguousAppNames, task.name, uploadedApp.versionNodeId);
     appendTaskRelations(state.graphState, uploadedApp.versionNodeId, task.graph.relations, `[${task.cataloguePath}] app "${task.name}"`);
     const entry = {
@@ -1166,6 +1179,15 @@ async function upload(pathOrName, options) {
     }
     const warnings = selection.warnings;
     const tasks = selection.tasks;
+    const gameIdeaRef = typeof options?.gameIdea === 'string' ? options.gameIdea.trim() : '';
+    if (gameIdeaRef) {
+        const appTasks = tasks.filter((task) => task.kind === 'app');
+        if (appTasks.length !== 1) {
+            (0, messages_1.printErrorWithHelp)('--game-idea can only be used when publishing exactly one app.', ['Publish a single app name or file, then retry with --game-idea.'], { command: 'project publish' });
+            process.exitCode = 1;
+            return;
+        }
+    }
     if (tagGroupLoad.groups.length > 0 && userInfo.role !== 'ADMIN') {
         (0, messages_1.printErrorWithHelp)('Publishing tagGroups requires an admin account.', [
             'Log in as an admin before publishing taxonomy changes.',

package/dist/index.js

@@ -412,6 +412,32 @@ creations
     .action(async (opts) => {
     await (0, creations_1.browseCreations)(opts);
 });
+const creationIdeas = creations.command('ideas').description('Manage game ideas');
+creationIdeas
+    .command('browse')
+    .description('Browse your game ideas')
+    .option('--state <state>', 'idea, started, shipped, or all')
+    .option('--limit <number>', 'Maximum number of results to return')
+    .option('--offset <number>', 'Result offset')
+    .option('--json', 'Output JSON')
+    .action(async (opts) => {
+    await (0, creations_1.browseCreationIdeas)(opts);
+});
+creationIdeas
+    .command('start <idOrSlug>')
+    .description('Mark a game idea as started')
+    .option('--json', 'Output JSON')
+    .action(async (idOrSlug, opts) => {
+    await (0, creations_1.startCreationIdea)(idOrSlug, opts);
+});
+creationIdeas
+    .command('ship <idOrSlug>')
+    .description('Mark a game idea as shipped')
+    .requiredOption('--app <creator/name>', 'Created app ref')
+    .option('--json', 'Output JSON')
+    .action(async (idOrSlug, opts) => {
+    await (0, creations_1.shipCreationIdea)(idOrSlug, opts);
+});
 const creationApps = creations.command('apps').description('Manage app creations');
 creationApps
     .command('update <name>')
@@ -680,6 +706,7 @@ projectCreate
     .description('Create a new app from a template or exact remix version')
     .option('--template <ref>', 'Template ref')
     .option('--remix <ref>', 'Canonical app version ref')
+    .option('--game-idea <idOrSlug>', 'Game idea id or slug to infer the source and mark started')
     .action(async (name, opts) => {
     await (0, create_1.create)(name, opts);
 });
@@ -822,6 +849,7 @@ project
     .option('--env <env>', 'Resolve this command against one logged-in environment')
     .option('--skip-ecs', 'Skip ecs.json and server.js during publish')
     .option('--clear-tags', 'Confirm clearing existing live tags when this publish removes them')
+    .option('--game-idea <idOrSlug>', 'Game idea id or slug to mark shipped')
     .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 ?? '.', {
@@ -829,6 +857,7 @@ project
         skipEcs: opts.skipEcs,
         skipReview: opts.skipReview,
         clearTags: opts.clearTags,
+        gameIdea: opts.gameIdea,
     });
 });
 const documentation = program.command('documentation').description('Public Playdrop documentation');

package/node_modules/@playdrop/api-client/dist/client.d.ts

@@ -1,4 +1,5 @@
-import type { AppleOAuthHandoffExchangeRequest, AppleOAuthHandoffExchangeResponse, AppleOAuthLinkStartRequest, AppleOAuthLinkStartResponse, ApplePushDeviceRequest, ApplePushDeviceStatusResponse, ApiKeyLoginRequest, CliApiKeyStatusResponse, CliLoginApproveRequest, CliLoginApproveResponse, CliLoginPollRequest, CliLoginPollResponse, CliLoginStartResponse, CliLoginStatusResponse, CliWebLaunchStartRequest, CliWebLaunchStartResponse, CompleteXSignupRequest, CompleteXSignupResponse, DeleteMyAccountRequest, DeleteMyAccountResponse, LoginRequest, LoginResponse, LogoutResponse, PrivacyExportResponse, RegisterRequest, RegisterResponse, StarterProfileAssetsResponse, CreateAppRequest, CreateAppResponse, UpdateAppRequest, AdminUpdateAppRequest, UpdateAppResponse, AppsListResponse, AppBrowseRequest, AppDetailRequest, AppDetailResponse, AppMoreCollectionKey, AppMoreCollectionPage, AppMoreCollectionRequest, AppMoreCollectionsRequest, AppMoreCollectionsResponse, CreatorAppsBrowseRequest, AppRuntimeAssetsResponse, ContentLicense, InitializeAppUploadRequest, InitializeAppUploadResponse, UploadAppSessionFileResponse, UploadAppSessionOwnedAssetResponse, FinalizeAppUploadResponse, AppUploadLaunchCheckPreviewResponse, AbortAppUploadResponse, RecordAppUploadLaunchCheckRequest, RecordAppUploadLaunchCheckResponse, MyAppsResponse, BootstrapResponse, SetProfileAssetRequest, SetProfileAssetResponse, MeResponse, UserDetailResponse, UsersListResponse, CreateUserRequest, CreateUserResponse, UpdateAdminUserRequest, RemixScaffoldResponse, TemplateScaffoldResponse, HomeResponse, HomeCollectionPageResponse, FetchHomeOptions, DeleteAppResponse, AppType, AppAccessTokenResponse, DevAppAccessTokenResponse, DevPlayerResetResponse, AppLogEntryRequest, AppLogEntryResponse, ClaimFreeCreditRewardResponse, SubmitFeedbackRequest, SubmitFeedbackResponse, FeedbackListResponse, AdminFeedbackListResponse, AdminFeedbackResponse, UpdateAdminFeedbackRequest, UpdateAdminFeedbackResponse, DeleteFeedbackResponse, FeedbackCategory, FeedbackClient, FeedbackStatus, ShopResponse, AdInterstitialShowResponse, AdLoadResponse, AdShowRequest, AdRewardedShowResponse, AssetPurchaseRequest, BoostActivationRequest, BoostBalanceResponse, BoostHistoryResponse, BoostPurchaseRequest, BoostPurchaseResponse, BoostReportQuery, BoostReportResponse, BoostStatusResponse, AdLoadRequest, CreditPackCheckoutSessionRequest, PurchaseResponse, CreditPackCheckoutSessionResponse, CreditPackCheckoutStatusResponse, CreatorEarningsResponse, TransactionsResponse, CreditPacksResponse, CreditPackResponse, PaymentProvider, PaymentStatus, AdminPaymentsListResponse, AdminPaymentDetailResponse, AdminRefundPaymentRequest, IapPurchaseRequest, IapPurchaseResponse, IapReceiptsResponse, IapReceiptListParams, IapReceiptResponse, AdminCreditTransactionsResponse, AiGenerationsResponse, AiGenerationDetailResponse, OwnedProfileAssetsResponse, SavedItemKind, CreateContentReportRequest, CreateCreatorReportRequest, CreateCommentReportRequest, CreatorBlockMutationResponse, LikedItemMutationResponse, DislikedItemMutationResponse, ModerationReportResponse, SavedItemMutationResponse, LibraryCategory, LibrarySort, LibraryResponse, TrackEngagementEventRequest, TrackEngagementEventResponse, CreatorFollowMutationResponse, ContentCommentsResponse, CreateContentCommentRequest, CreateContentCommentResponse, FollowingSort, FollowingCreatorsResponse, FollowingFeedSection, FollowingFeedResponse, DeleteContentCommentResponse, NotificationStatus, NotificationsResponse, NotificationReadResponse, PushSubscriptionMutationResponse, AdminUserResponse, DeleteAdminUserResponse, BatchCreateUsersResponse, UpsertWebPushSubscriptionRequest, UpdateProfileRequest, UpdateProfileResponse, WebPushConfigResponse, WebPushSubscriptionStatusResponse, ChangePasswordRequest, ChangePasswordResponse, UpgradeToCreatorResponse, AppleLinkRequest, AppleLinkResponse, AppleNativeChallengeResponse, ApplePendingSignupResponse, AppleSignInRequest, AppleSignInResponse, UnlinkXResponse, UnlinkGoogleResponse, GooglePendingSignupResponse, XPendingSignupResponse, GoogleOneTapExchangeRequest, GoogleOneTapExchangeResponse, UsernameAvailableResponse, CompleteAppleSignupRequest, CompleteAppleSignupResponse, CompleteGoogleSignupRequest, CompleteGoogleSignupResponse, GoogleAppleLinkRequest, GoogleAppleLinkResponse, GoogleAppleSignInRequest, GoogleAppleSignInResponse, AdminAppPlayerMetaResponse, AdminAppPlayerMetaUserResponse, AdminAppVersionReviewsListResponse, AdminClaimNextAppVersionReviewResponse, AdminMutateAchievementStateRequest, AdminMutateAchievementStateResponse, AdminMutateLeaderboardScoreRequest, AdminMutateLeaderboardScoreResponse, AdminRetirePlayerMetaDefinitionResponse, AdminUpdateAppVersionReviewRequest, AdminUpdateAppVersionReviewResponse, CreateCliApiKeyResponse, GetAchievementResponse, GetLeaderboardResponse, ListAchievementsResponse, ListLeaderboardsResponse, MyAchievementsResponse, MyLeaderboardsResponse, SetAchievementProgressRequest, SetAchievementProgressResponse, SubmitLeaderboardScoreRequest, SubmitLeaderboardScoreResponse, UnlockAchievementResponse, ReviewState, AppVersionVisibility, AppVersionsListResponse, AppVersionDetailResponse, AppSourceBundleResponse, UpdateVersionResponse, DeleteVersionResponse, AdminAppsListResponse, AdminGameCollectionCandidatesResponse, AdminGameCollectionResponse, AdminGameCollectionsResponse, AdminUpdateAppResponse, CreateAdminGameCollectionRequest, DeleteAdminGameCollectionResponse, UpdateAdminGameCollectionGamesRequest, UpdateAdminGameCollectionRequest, AssetBrowseKind, AssetCategory, AssetFormat, AssetVisibility, AssetSourceKind, AssetListSort, AssetListResponse, AssetCategoriesResponse, AssetDetailResponse, AssetVersionsListResponse, CreateAssetVersionResponse, DeleteOwnedCustomAssetResponse, CreateAssetSpecVersionResponse, ListOwnedCustomAssetsResponse, LoadOwnedCustomAssetResponse, MutateOwnedCustomAssetRequest, MutateOwnedCustomAssetResponse, UpdateAssetRequest, UpdateAssetResponse, UpdateAssetVersionRequest, UpdateAssetVersionResponse, UpdateAssetSpecVersionResponse, DeleteAssetVersionResponse, DeleteAssetResponse, DeleteAssetSpecVersionResponse, DeleteAssetSpecResponse, AssetSourceBundleResponse, AssetSpecAssetsListResponse, AssetSpecAppsListResponse, AssetSpecDetailResponse, AssetSpecListSort, AssetSpecListResponse, AssetSpecVersionResponseEnvelope, AssetSpecVersionsListResponse, AssetPackSourceBundleResponse, AssetPackListResponse, AssetPackDetailResponse, AssetPackVersionsListResponse, InitializeAssetPackUploadRequest, InitializeAssetPackUploadResponse, UploadAssetPackSessionAssetResponse, UploadAssetPackSessionMediaResponse, FinalizeAssetPackUploadResponse, AbortAssetPackUploadResponse, UpdateAssetPackRequest, UpdateAssetPackResponse, UpdateAssetPackVersionRequest, UpdateAssetPackVersionResponse, DeleteAssetPackVersionResponse, DeleteAssetPackResponse, BatchUpsertNodeRelationsRequest, BatchUpsertNodeRelationsResponse, ContentRemixRelationsResponse, SearchRequest, SearchResponse, SearchSuggestRequest, SearchSuggestResponse, AdminTagGroupResponse, AdminTagGroupsResponse, AdminTagResponse, CreateTagGroupRequest, CreateTagRequest, TagDirectoryResponse, TagDetailResponse, TagGroupDetailResponse, TagGroupSort, TagListResponse, UpdateTagGroupRequest, UpdateTagRequest, FreeCreditsResponse, InvitePreviewResponse, MyInviteCodeResponse } from '@playdrop/types';
+import type { AppleOAuthHandoffExchangeRequest, AppleOAuthHandoffExchangeResponse, AppleOAuthLinkStartRequest, AppleOAuthLinkStartResponse, ApplePushDeviceRequest, ApplePushDeviceStatusResponse, FirebasePushDeviceRequest, FirebasePushDeviceStatusResponse, ApiKeyLoginRequest, CliApiKeyStatusResponse, CliLoginApproveRequest, CliLoginApproveResponse, CliLoginPollRequest, CliLoginPollResponse, CliLoginStartResponse, CliLoginStatusResponse, CliWebLaunchStartRequest, CliWebLaunchStartResponse, CompleteXSignupRequest, CompleteXSignupResponse, DeleteMyAccountRequest, DeleteMyAccountResponse, LoginRequest, LoginResponse, LogoutResponse, PrivacyExportResponse, RegisterRequest, RegisterResponse, StarterProfileAssetsResponse, CreateAppRequest, CreateAppResponse, UpdateAppRequest, AdminUpdateAppRequest, UpdateAppResponse, AppsListResponse, AppBrowseRequest, AppDetailRequest, AppDetailResponse, AppMoreCollectionKey, AppMoreCollectionPage, AppMoreCollectionRequest, AppMoreCollectionsRequest, AppMoreCollectionsResponse, CreatorAppsBrowseRequest, AppRuntimeAssetsResponse, ContentLicense, InitializeAppUploadRequest, InitializeAppUploadResponse, UploadAppSessionFileResponse, UploadAppSessionOwnedAssetResponse, FinalizeAppUploadResponse, AppUploadLaunchCheckPreviewResponse, AbortAppUploadResponse, RecordAppUploadLaunchCheckRequest, RecordAppUploadLaunchCheckResponse, MyAppsResponse, BootstrapResponse, SetProfileAssetRequest, SetProfileAssetResponse, MeResponse, UserDetailResponse, UsersListResponse, CreateUserRequest, CreateUserResponse, UpdateAdminUserRequest, RemixScaffoldResponse, TemplateScaffoldResponse, HomeResponse, HomeCollectionPageResponse, FetchHomeOptions, DeleteAppResponse, AppType, AppAccessTokenResponse, DevAppAccessTokenResponse, DevPlayerResetResponse, AppLogEntryRequest, AppLogEntryResponse, ClaimFreeCreditRewardResponse, SubmitFeedbackRequest, SubmitFeedbackResponse, FeedbackListResponse, AdminFeedbackListResponse, AdminFeedbackResponse, UpdateAdminFeedbackRequest, UpdateAdminFeedbackResponse, DeleteFeedbackResponse, FeedbackCategory, FeedbackClient, FeedbackStatus, ShopResponse, AdInterstitialShowResponse, AdLoadResponse, AdShowRequest, AdRewardedShowResponse, AssetPurchaseRequest, BoostActivationRequest, BoostBalanceResponse, BoostHistoryResponse, BoostPurchaseRequest, BoostPurchaseResponse, BoostReportQuery, BoostReportResponse, BoostStatusResponse, AdLoadRequest, CreditPackCheckoutSessionRequest, PurchaseResponse, CreditPackCheckoutSessionResponse, CreditPackCheckoutStatusResponse, CreatorEarningsResponse, TransactionsResponse, CreditPacksResponse, CreditPackResponse, PaymentProvider, PaymentStatus, AdminPaymentsListResponse, AdminPaymentDetailResponse, AdminRefundPaymentRequest, IapPurchaseRequest, IapPurchaseResponse, IapReceiptsResponse, IapReceiptListParams, IapReceiptResponse, AdminCreditTransactionsResponse, AiGenerationsResponse, AiGenerationDetailResponse, OwnedProfileAssetsResponse, SavedItemKind, CreateContentReportRequest, CreateCreatorReportRequest, CreateCommentReportRequest, CreatorBlockMutationResponse, LikedItemMutationResponse, DislikedItemMutationResponse, ModerationReportResponse, SavedItemMutationResponse, LibraryCategory, LibrarySort, LibraryResponse, TrackEngagementEventRequest, TrackEngagementEventResponse, CreatorFollowMutationResponse, ContentCommentsResponse, CreateContentCommentRequest, CreateContentCommentResponse, FollowingSort, FollowingCreatorsResponse, FollowingFeedSection, FollowingFeedResponse, DeleteContentCommentResponse, NotificationStatus, NotificationsResponse, NotificationReadResponse, PushSubscriptionMutationResponse, AdminUserResponse, DeleteAdminUserResponse, BatchCreateUsersResponse, UpsertWebPushSubscriptionRequest, UpdateProfileRequest, UpdateProfileResponse, WebPushConfigResponse, WebPushSubscriptionStatusResponse, ChangePasswordRequest, ChangePasswordResponse, UpgradeToCreatorResponse, AppleLinkRequest, AppleLinkResponse, AppleNativeChallengeResponse, ApplePendingSignupResponse, AppleSignInRequest, AppleSignInResponse, UnlinkXResponse, UnlinkGoogleResponse, GooglePendingSignupResponse, XPendingSignupResponse, GoogleOneTapExchangeRequest, GoogleOneTapExchangeResponse, UsernameAvailableResponse, CompleteAppleSignupRequest, CompleteAppleSignupResponse, CompleteGoogleSignupRequest, CompleteGoogleSignupResponse, GoogleAppleLinkRequest, GoogleAppleLinkResponse, GoogleAppleSignInRequest, GoogleAppleSignInResponse, AdminAppPlayerMetaResponse, AdminAppPlayerMetaUserResponse, AdminAppVersionReviewsListResponse, AdminClaimNextAppVersionReviewResponse, AdminMutateAchievementStateRequest, AdminMutateAchievementStateResponse, AdminMutateLeaderboardScoreRequest, AdminMutateLeaderboardScoreResponse, AdminRetirePlayerMetaDefinitionResponse, AdminUpdateAppVersionReviewRequest, AdminUpdateAppVersionReviewResponse, CreateCliApiKeyResponse, GetAchievementResponse, GetLeaderboardResponse, ListAchievementsResponse, ListLeaderboardsResponse, MyAchievementsResponse, MyLeaderboardsResponse, SetAchievementProgressRequest, SetAchievementProgressResponse, SubmitLeaderboardScoreRequest, SubmitLeaderboardScoreResponse, UnlockAchievementResponse, ReviewState, AppVersionVisibility, AppVersionsListResponse, AppVersionDetailResponse, AppSourceBundleResponse, UpdateVersionResponse, DeleteVersionResponse, AdminAppsListResponse, AdminGameCollectionCandidatesResponse, AdminGameCollectionResponse, AdminGameCollectionsResponse, AdminUpdateAppResponse, CreateAdminGameCollectionRequest, DeleteAdminGameCollectionResponse, UpdateAdminGameCollectionGamesRequest, UpdateAdminGameCollectionRequest, AssetBrowseKind, AssetCategory, AssetFormat, AssetVisibility, AssetSourceKind, AssetListSort, AssetListResponse, AssetCategoriesResponse, AssetDetailResponse, AssetVersionsListResponse, CreateAssetVersionResponse, DeleteOwnedCustomAssetResponse, CreateAssetSpecVersionResponse, ListOwnedCustomAssetsResponse, LoadOwnedCustomAssetResponse, MutateOwnedCustomAssetRequest, MutateOwnedCustomAssetResponse, UpdateAssetRequest, UpdateAssetResponse, UpdateAssetVersionRequest, UpdateAssetVersionResponse, UpdateAssetSpecVersionResponse, DeleteAssetVersionResponse, DeleteAssetResponse, DeleteAssetSpecVersionResponse, DeleteAssetSpecResponse, AssetSourceBundleResponse, AssetSpecAssetsListResponse, AssetSpecAppsListResponse, AssetSpecDetailResponse, AssetSpecListSort, AssetSpecListResponse, AssetSpecVersionResponseEnvelope, AssetSpecVersionsListResponse, AssetPackSourceBundleResponse, AssetPackListResponse, AssetPackDetailResponse, AssetPackVersionsListResponse, InitializeAssetPackUploadRequest, InitializeAssetPackUploadResponse, UploadAssetPackSessionAssetResponse, UploadAssetPackSessionMediaResponse, FinalizeAssetPackUploadResponse, AbortAssetPackUploadResponse, UpdateAssetPackRequest, UpdateAssetPackResponse, UpdateAssetPackVersionRequest, UpdateAssetPackVersionResponse, DeleteAssetPackVersionResponse, DeleteAssetPackResponse, BatchUpsertNodeRelationsRequest, BatchUpsertNodeRelationsResponse, ContentRemixRelationsResponse, SearchRequest, SearchResponse, SearchSuggestRequest, SearchSuggestResponse, AdminTagGroupResponse, AdminTagGroupsResponse, AdminTagResponse, CreateTagGroupRequest, CreateTagRequest, TagDirectoryResponse, TagDetailResponse, TagGroupDetailResponse, TagGroupSort, TagListResponse, UpdateTagGroupRequest, UpdateTagRequest, FreeCreditsResponse, InvitePreviewResponse, MyInviteCodeResponse, CreateGameIdeaResponse, GameIdeaStatusResponse, GameIdeasListRequest, GameIdeasListResponse, RemixCandidatesResponse, ShipGameIdeaRequest, ShipGameIdeaResponse, StartGameIdeaRequest, StartGameIdeaResponse, UpdateGameIdeaRequest, UpdateGameIdeaResponse } from '@playdrop/types';
+import { type CreateGameIdeaOptions } from './domains/game-ideas.js';
 export interface HttpMethod {
     GET: 'GET';
     POST: 'POST';
@@ -131,6 +132,17 @@ export interface ApiClient {
     fetchInvitePreview(inviteCode: string): Promise<InvitePreviewResponse>;
     fetchMyInviteCode(): Promise<MyInviteCodeResponse>;
     submitMyInviteCode(inviteCode: string): Promise<MyInviteCodeResponse>;
+    createGameIdea(options: CreateGameIdeaOptions): Promise<CreateGameIdeaResponse>;
+    listGameIdeas(options?: GameIdeasListRequest): Promise<GameIdeasListResponse>;
+    getGameIdeaStatus(idOrSlug: string): Promise<GameIdeaStatusResponse>;
+    updateGameIdea(idOrSlug: string, body: UpdateGameIdeaRequest): Promise<UpdateGameIdeaResponse>;
+    startGameIdea(idOrSlug: string, body?: StartGameIdeaRequest): Promise<StartGameIdeaResponse>;
+    shipGameIdea(idOrSlug: string, body: ShipGameIdeaRequest): Promise<ShipGameIdeaResponse>;
+    fetchRemixCandidates(options?: {
+        q?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<RemixCandidatesResponse>;
     checkUsernameAvailable(username: string): Promise<UsernameAvailableResponse>;
     completeGoogleSignup(request: CompleteGoogleSignupRequest): Promise<CompleteGoogleSignupResponse>;
     completeXSignup(request: CompleteXSignupRequest): Promise<CompleteXSignupResponse>;
@@ -190,6 +202,9 @@ export interface ApiClient {
     fetchApplePushDeviceStatus(request: ApplePushDeviceRequest): Promise<ApplePushDeviceStatusResponse>;
     upsertApplePushDevice(request: ApplePushDeviceRequest): Promise<PushSubscriptionMutationResponse>;
     deleteApplePushDevice(request: ApplePushDeviceRequest): Promise<PushSubscriptionMutationResponse>;
+    fetchFirebasePushDeviceStatus(request: FirebasePushDeviceRequest): Promise<FirebasePushDeviceStatusResponse>;
+    upsertFirebasePushDevice(request: FirebasePushDeviceRequest): Promise<PushSubscriptionMutationResponse>;
+    deleteFirebasePushDevice(request: FirebasePushDeviceRequest): Promise<PushSubscriptionMutationResponse>;
     search(request: SearchRequest): Promise<SearchResponse>;
     suggestSearch(request: SearchSuggestRequest): Promise<SearchSuggestResponse>;
     fetchTagDirectory(options?: {