@playdrop/playdrop-cli 0.5.1 → 0.5.3

package/dist/commands/captureRemote.js

@@ -9,6 +9,29 @@ const http_1 = require("../http");
 const messages_1 = require("../messages");
 const devShared_1 = require("./devShared");
 const captureRuntime_1 = require("../captureRuntime");
+function readUnsupportedPlaydropCaptureMessage(targetUrl) {
+    let parsed;
+    try {
+        parsed = new URL(targetUrl);
+    }
+    catch {
+        return null;
+    }
+    const hostname = parsed.hostname.toLowerCase();
+    const isPlaydropHost = hostname === 'www.playdrop.ai'
+        || hostname === 'playdrop.ai'
+        || hostname === 'localhost'
+        || hostname === '127.0.0.1';
+    if (!isPlaydropHost) {
+        return null;
+    }
+    const pathname = parsed.pathname.replace(/\/+$/, '') || '/';
+    const matchesCreatorAppRoute = /^\/(?:_auth\/)?creators\/[^/]+\/apps\/[^/]+\/[^/]+(?:\/.*)?$/i.test(pathname);
+    if (!matchesCreatorAppRoute || pathname.endsWith('/play')) {
+        return null;
+    }
+    return `Only Playdrop /play URLs are supported for remote capture. Use ${parsed.origin}${pathname}/play instead.`;
+}
 function parseTimeout(raw) {
     if (raw === undefined) {
         return 10;
@@ -70,6 +93,10 @@ function parseOptions(url, options = {}) {
     if (expectedUrl) {
         assertValidUrl(expectedUrl, 'invalid_expected_url');
     }
+    const unsupportedPlaydropCaptureMessage = readUnsupportedPlaydropCaptureMessage(trimmedUrl);
+    if (unsupportedPlaydropCaptureMessage) {
+        throw new Error(`unsupported_playdrop_capture_target:${unsupportedPlaydropCaptureMessage}`);
+    }
     const { username, password } = parseCredentialPair(options);
     return {
         targetUrl: trimmedUrl,
@@ -92,6 +119,12 @@ async function captureRemote(url, options = {}) {
         parsed = parseOptions(url, options);
     }
     catch (error) {
+        if (error instanceof Error && error.message.startsWith('unsupported_playdrop_capture_target:')) {
+            const detail = error.message.slice('unsupported_playdrop_capture_target:'.length).trim();
+            (0, messages_1.printErrorWithHelp)(detail, [], { command: 'project capture remote' });
+            process.exitCode = 1;
+            return;
+        }
         if (error instanceof Error && error.message === 'invalid_expected_url') {
             (0, messages_1.printErrorWithHelp)('The --expected-url value must be a valid URL.', [], { command: 'project capture remote' });
             process.exitCode = 1;

package/dist/commands/create.d.ts

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

package/dist/commands/create.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAssetSpecProject = createAssetSpecProject;
 exports.create = create;
 const promises_1 = __importDefault(require("node:readline/promises"));
 const node_process_1 = require("node:process");
@@ -22,7 +23,7 @@ const catalogue_utils_1 = require("../catalogue-utils");
 const catalogue_1 = require("../catalogue");
 const CATALOGUE_FILENAME = 'catalogue.json';
 const LEGACY_CATALOGUE_VERSION_KEY = ['schema', 'Version'].join('');
-const ALLOWED_CATALOGUE_TOP_LEVEL_KEYS = new Set(['apps', 'assets', 'assetPacks']);
+const ALLOWED_CATALOGUE_TOP_LEVEL_KEYS = new Set(['apps', 'assetSpecs', 'assets', 'assetPacks']);
 async function downloadArchive(url) {
     const response = await fetch(url);
     if (!response.ok) {
@@ -176,6 +177,7 @@ const DEFAULT_SURFACE_TARGETS = {
     mobilePortrait: app_1.DEFAULT_APP_SURFACE_TARGETS.includes('MOBILE_PORTRAIT'),
 };
 const DEFAULT_APP_VERSION = '1.0.0';
+const DEFAULT_ASSET_SPEC_VERSION = '1.0.0';
 function makeDefaultAppEntry(name, filePath) {
     return {
         name,
@@ -187,6 +189,19 @@ function makeDefaultAppEntry(name, filePath) {
         surfaceTargets: { ...DEFAULT_SURFACE_TARGETS },
     };
 }
+function makeDefaultAssetSpecEntry(name) {
+    const basePath = `asset-specs/${name}`;
+    return {
+        name,
+        version: DEFAULT_ASSET_SPEC_VERSION,
+        displayName: name,
+        description: '',
+        symbol: `${basePath}/symbol.svg`,
+        contract: `${basePath}/contract.json`,
+        documentation: `${basePath}/README.md`,
+        visibility: 'PUBLIC',
+    };
+}
 function buildCatalogueEntry(name, metadata, sourceInfo, relativeFilePath) {
     const entry = makeDefaultAppEntry(name, relativeFilePath);
     if (!metadata) {
@@ -366,7 +381,7 @@ function logCatalogueOutcome(result, name) {
         return false;
     }
     if (result.error === 'unsupported_top_level_key') {
-        (0, messages_1.printErrorWithHelp)(`${label} contains unsupported top-level key "${result.unsupportedKey || 'unknown'}".`, ['Keep catalogue.json limited to apps, assets, and assetPacks, then rerun `playdrop project create app`.'], { command: 'project create app' });
+        (0, messages_1.printErrorWithHelp)(`${label} contains unsupported top-level key "${result.unsupportedKey || 'unknown'}".`, ['Keep catalogue.json limited to apps, assetSpecs, assets, and assetPacks, then rerun `playdrop project create app`.'], { command: 'project create app' });
         process.exitCode = process.exitCode || 1;
         return false;
     }
@@ -388,6 +403,85 @@ function logCatalogueOutcome(result, name) {
     }
     return true;
 }
+function ensureAssetSpecCatalogueEntry(name, cataloguePath) {
+    const path = (0, node_path_1.resolve)(cataloguePath);
+    const catalogueDir = (0, node_path_1.dirname)(path);
+    if (hasNestedCatalogueFiles(catalogueDir)) {
+        return { path, createdFile: false, addedEntry: false, error: 'workspace_root_marker_required' };
+    }
+    const entry = makeDefaultAssetSpecEntry(name);
+    if (!(0, node_fs_1.existsSync)(path)) {
+        const catalogue = { assetSpecs: [entry] };
+        (0, node_fs_1.writeFileSync)(path, `${JSON.stringify(catalogue, null, 2)}\n`);
+        return { path, createdFile: true, addedEntry: true };
+    }
+    const parsed = readCatalogue(path);
+    if (!parsed) {
+        return { path, createdFile: false, addedEntry: false, error: 'invalid_json' };
+    }
+    if (Object.prototype.hasOwnProperty.call(parsed, LEGACY_CATALOGUE_VERSION_KEY)) {
+        return { path, createdFile: false, addedEntry: false, error: 'invalid_schema_version' };
+    }
+    const unsupportedKey = findUnsupportedCatalogueTopLevelKey(parsed);
+    if (unsupportedKey) {
+        return { path, createdFile: false, addedEntry: false, error: 'unsupported_top_level_key', unsupportedKey };
+    }
+    if (!Array.isArray(parsed.apps) && Array.isArray(parsed.games)) {
+        return { path, createdFile: false, addedEntry: false, error: 'legacy_games_property' };
+    }
+    const assetSpecs = Array.isArray(parsed.assetSpecs) ? [...parsed.assetSpecs] : [];
+    if (assetSpecs.some((assetSpec) => typeof assetSpec?.name === 'string' && assetSpec.name === name)) {
+        return { path, createdFile: false, addedEntry: false, alreadyPresent: true };
+    }
+    assetSpecs.push(entry);
+    const updated = { ...parsed, assetSpecs };
+    (0, node_fs_1.writeFileSync)(path, `${JSON.stringify(updated, null, 2)}\n`);
+    return { path, createdFile: false, addedEntry: true };
+}
+function logAssetSpecCatalogueOutcome(result, name) {
+    const label = (0, node_path_1.relative)(process.cwd(), result.path) || CATALOGUE_FILENAME;
+    if (result.error === 'invalid_json') {
+        (0, messages_1.printErrorWithHelp)(`Could not update ${label} because it contains invalid JSON.`, [
+            `Fix the JSON in ${label} and add ${name} to the assetSpecs list, then rerun "playdrop project create asset-spec ${name}" if needed.`,
+        ], { command: 'project create asset-spec' });
+        process.exitCode = process.exitCode || 1;
+        return false;
+    }
+    if (result.error === 'legacy_games_property') {
+        (0, messages_1.printErrorWithHelp)(`${label} still uses the legacy "games" catalogue field.`, [
+            'Rename the top-level "games" array to "apps" and rerun `playdrop project create asset-spec`.',
+        ], { command: 'project create asset-spec' });
+        process.exitCode = process.exitCode || 1;
+        return false;
+    }
+    if (result.error === 'invalid_schema_version') {
+        (0, messages_1.printErrorWithHelp)(`${label} must not define the legacy top-level version field.`, ['Remove the legacy top-level version field from the file and rerun `playdrop project create asset-spec`.'], { command: 'project create asset-spec' });
+        process.exitCode = process.exitCode || 1;
+        return false;
+    }
+    if (result.error === 'unsupported_top_level_key') {
+        (0, messages_1.printErrorWithHelp)(`${label} contains unsupported top-level key "${result.unsupportedKey || 'unknown'}".`, ['Keep catalogue.json limited to apps, assetSpecs, assets, and assetPacks, then rerun `playdrop project create asset-spec`.'], { command: 'project create asset-spec' });
+        process.exitCode = process.exitCode || 1;
+        return false;
+    }
+    if (result.error === 'workspace_root_marker_required') {
+        (0, messages_1.printErrorWithHelp)(`${label} must stay {} because nested catalogue.json files already exist below this directory.`, ['Create the asset spec inside its own project folder instead of writing entries into the workspace root catalogue.json.'], { command: 'project create asset-spec' });
+        process.exitCode = process.exitCode || 1;
+        return false;
+    }
+    if (result.createdFile) {
+        console.log(`Initialized ${label} and added asset spec ${name}.`);
+        return true;
+    }
+    if (result.addedEntry) {
+        console.log(`Added asset spec ${name} to ${label}.`);
+        return true;
+    }
+    if (result.alreadyPresent) {
+        console.log(`${label} already contains asset spec ${name}; keeping existing entry.`);
+    }
+    return true;
+}
 function updateExtractedProjectCatalogue(name, metadata, projectCataloguePath, sourceInfo, htmlFilePath) {
     const path = (0, node_path_1.resolve)(projectCataloguePath);
     if (hasNestedCatalogueFiles((0, node_path_1.dirname)(path))) {
@@ -494,7 +588,7 @@ function logProjectCatalogueOutcome(result, name) {
         return false;
     }
     if (result.error === 'unsupported_top_level_key') {
-        (0, messages_1.printErrorWithHelp)(`${label} contains unsupported top-level key "${result.unsupportedKey || 'unknown'}".`, ['Keep catalogue.json limited to apps, assets, and assetPacks, then rerun `playdrop project create app`.'], { command: 'project create app' });
+        (0, messages_1.printErrorWithHelp)(`${label} contains unsupported top-level key "${result.unsupportedKey || 'unknown'}".`, ['Keep catalogue.json limited to apps, assetSpecs, assets, and assetPacks, then rerun `playdrop project create app`.'], { command: 'project create app' });
         process.exitCode = process.exitCode || 1;
         return false;
     }
@@ -534,6 +628,8 @@ function buildPendingExternalRemixTask(name, metadata, sourceInfo, cataloguePath
         emoji: entry.emoji,
         color: entry.color,
         surfaceTargets,
+        assetSpecSupport: [],
+        tags: [],
         missingMetadata: [],
         version: entry.version,
         remix: typeof entry.remix === 'string' ? entry.remix : undefined,
@@ -626,6 +722,90 @@ function findWorkspaceRootDirectory(cataloguePath) {
         currentDir = parentDir;
     }
 }
+function buildAssetSpecSymbolSvg() {
+    return [
+        '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">',
+        '  <path d="M14 18h36v28H14z" stroke="#fff" stroke-width="4" stroke-linejoin="round"/>',
+        '  <path d="M24 28h16" stroke="#fff" stroke-width="4" stroke-linecap="round"/>',
+        '  <path d="M24 36h10" stroke="#fff" stroke-width="4" stroke-linecap="round"/>',
+        '</svg>',
+        '',
+    ].join('\n');
+}
+function buildAssetSpecContractTemplate() {
+    return `${JSON.stringify({
+        primaryRole: 'primary',
+        roles: [
+            {
+                name: 'primary',
+                required: true,
+                contentTypes: ['application/json'],
+                extensions: ['.json'],
+                mode: 'TEXT',
+            },
+        ],
+    }, null, 2)}\n`;
+}
+function buildAssetSpecReadmeTemplate(name) {
+    return [
+        `# ${name}`,
+        '',
+        'Describe the custom asset format in plain English.',
+        '',
+        '## Files',
+        '',
+        '- `primary`: Main JSON payload for this asset format.',
+        '',
+        '## Notes',
+        '',
+        '- Update `contract.json` as the format evolves.',
+        '- Keep this documentation in sync with the published version.',
+        '',
+    ].join('\n');
+}
+async function createAssetSpecProject(name) {
+    const normalizedName = name.trim();
+    if (!normalizedName) {
+        (0, messages_1.printErrorWithHelp)('An asset spec name is required.', ['Example: playdrop project create asset-spec platformer-level'], {
+            command: 'project create asset-spec',
+        });
+        process.exitCode = process.exitCode || 1;
+        return;
+    }
+    if (!(0, types_1.isValidAssetSpecName)(normalizedName)) {
+        (0, messages_1.printErrorWithHelp)(`Asset spec name "${normalizedName}" is not valid.`, ['Use lowercase kebab-case, for example: playdrop project create asset-spec platformer-level'], { command: 'project create asset-spec' });
+        process.exitCode = process.exitCode || 1;
+        return;
+    }
+    const cataloguePath = (0, node_path_1.resolve)(process.cwd(), CATALOGUE_FILENAME);
+    const assetSpecDir = (0, node_path_1.resolve)(process.cwd(), 'asset-specs', normalizedName);
+    const contractPath = (0, node_path_1.resolve)(assetSpecDir, 'contract.json');
+    const symbolPath = (0, node_path_1.resolve)(assetSpecDir, 'symbol.svg');
+    const readmePath = (0, node_path_1.resolve)(assetSpecDir, 'README.md');
+    if ((0, node_fs_1.existsSync)(assetSpecDir)) {
+        (0, messages_1.printErrorWithHelp)(`Asset spec directory already exists at ${(0, node_path_1.relative)(process.cwd(), assetSpecDir) || assetSpecDir}.`, ['Choose a different asset spec name or remove the existing directory before rerunning the command.'], { command: 'project create asset-spec' });
+        process.exitCode = process.exitCode || 1;
+        return;
+    }
+    (0, node_fs_1.mkdirSync)(assetSpecDir, { recursive: true });
+    (0, node_fs_1.writeFileSync)(symbolPath, buildAssetSpecSymbolSvg());
+    (0, node_fs_1.writeFileSync)(contractPath, buildAssetSpecContractTemplate());
+    (0, node_fs_1.writeFileSync)(readmePath, buildAssetSpecReadmeTemplate(normalizedName));
+    const catalogueResult = ensureAssetSpecCatalogueEntry(normalizedName, cataloguePath);
+    const catalogueUpdated = logAssetSpecCatalogueOutcome(catalogueResult, normalizedName);
+    if (!catalogueUpdated) {
+        (0, node_fs_1.rmSync)(assetSpecDir, { recursive: true, force: true });
+        return;
+    }
+    const relativeAssetSpecDir = (0, node_path_1.relative)(process.cwd(), assetSpecDir) || assetSpecDir;
+    const catalogueLabel = (0, node_path_1.relative)(process.cwd(), cataloguePath) || CATALOGUE_FILENAME;
+    console.log('\nNext steps:');
+    console.log(` - Review ${catalogueLabel} and update the assetSpecs entry for ${normalizedName}.`);
+    console.log(` - Edit ${relativeAssetSpecDir}/contract.json to define the file contract.`);
+    console.log(` - Replace ${relativeAssetSpecDir}/symbol.svg with your final icon.`);
+    console.log(` - Expand ${relativeAssetSpecDir}/README.md with format documentation.`);
+    console.log(` - Validate locally with "playdrop project validate ." and publish with "playdrop project publish ${normalizedName}".`);
+}
 function warnMissingWorkspaceReadme(cataloguePath) {
     const workspaceRoot = findWorkspaceRootDirectory(cataloguePath);
     const readmePath = (0, node_path_1.resolve)(workspaceRoot, 'README.md');

package/dist/commands/credits.d.ts

@@ -3,8 +3,14 @@ type TransactionsOptions = {
     offset?: string | number;
     json?: boolean;
 };
+type EarningsOptions = {
+    days?: string | number;
+    appId?: string | number;
+    json?: boolean;
+};
 export declare function showCreditBalance(options?: {
     json?: boolean;
 }): Promise<void>;
 export declare function browseCreditTransactions(options?: TransactionsOptions): Promise<void>;
+export declare function showCreatorEarnings(options?: EarningsOptions): Promise<void>;
 export {};

package/dist/commands/credits.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.showCreditBalance = showCreditBalance;
 exports.browseCreditTransactions = browseCreditTransactions;
+exports.showCreatorEarnings = showCreatorEarnings;
 const commandContext_1 = require("../commandContext");
 const errors_1 = require("../errors");
 const messages_1 = require("../messages");
@@ -19,6 +20,19 @@ function parsePositiveInteger(raw, label, fallback) {
     }
     return parsed;
 }
+function formatTransactionTitle(transaction) {
+    if (transaction.type === 'AD_PAYOUT') {
+        const appName = typeof transaction.metadata?.appName === 'string' ? transaction.metadata.appName : transaction.displayName;
+        const adFormat = typeof transaction.metadata?.adFormat === 'string' ? transaction.metadata.adFormat : null;
+        const dateUtc = typeof transaction.metadata?.dateUtc === 'string' ? transaction.metadata.dateUtc : null;
+        return [appName, adFormat, dateUtc].filter(Boolean).join(' | ');
+    }
+    if (transaction.type === 'BOOST_PURCHASE') {
+        const units = typeof transaction.metadata?.units === 'number' ? transaction.metadata.units : null;
+        return units ? `${transaction.displayName} | ${units} units` : transaction.displayName;
+    }
+    return transaction.displayName;
+}
 async function showCreditBalance(options = {}) {
     await (0, commandContext_1.withEnvironment)('credits balance', 'Checking your credit balance', async ({ client }) => {
         try {
@@ -72,7 +86,7 @@ async function browseCreditTransactions(options = {}) {
             console.log('Credit transactions:\n');
             for (const transaction of transactions) {
                 console.log(`#${transaction.id} | ${transaction.kind.toLowerCase()} | ${transaction.amount} | ${transaction.status.toLowerCase()} | ${(0, output_1.formatTimestamp)(transaction.createdAt)}`);
-                console.log(`  ${transaction.displayName}`);
+                console.log(`  ${formatTransactionTitle(transaction)}`);
             }
             console.log('\nNext: run "playdrop credits balance" to confirm your latest balance.');
         }
@@ -89,3 +103,35 @@ async function browseCreditTransactions(options = {}) {
         }
     });
 }
+async function showCreatorEarnings(options = {}) {
+    const days = parsePositiveInteger(options.days, 'days', 30);
+    if (days === null) {
+        (0, messages_1.printErrorWithHelp)('The --days value must be a positive integer.', ['Example: --days 30'], { command: 'credits earnings' });
+        process.exitCode = 1;
+        return;
+    }
+    const appId = options.appId === undefined ? undefined : parsePositiveInteger(options.appId, 'appId', 0);
+    if (options.appId !== undefined && appId === null) {
+        (0, messages_1.printErrorWithHelp)('The --app-id value must be a positive integer.', ['Example: --app-id 123'], { command: 'credits earnings' });
+        process.exitCode = 1;
+        return;
+    }
+    await (0, commandContext_1.withEnvironment)('credits earnings', 'Checking creator ad earnings', async ({ client }) => {
+        const response = await client.fetchCreatorEarnings({
+            days,
+            ...(appId && appId > 0 ? { appId } : {}),
+        });
+        if (options.json) {
+            (0, output_1.printJson)(response);
+            return;
+        }
+        console.log(`Today provisional: ${response.summary.provisionalToday}`);
+        console.log(`Last 7 days settled: ${response.summary.settledLast7Days}`);
+        console.log(`Last 30 days settled: ${response.summary.settledLast30Days}`);
+        console.log(`Last 30 days boost spend: ${response.summary.boostSpendLast30Days}`);
+        console.log('\nDaily rows:\n');
+        for (const row of response.days) {
+            console.log(`${row.dateUtc} | total ${row.totalAmount} | interstitial ${row.interstitialAmount} | rewarded ${row.rewardedAmount} | served ${row.servedCount} | credited ${row.creditedCount}${row.provisional ? ' | provisional' : ''}`);
+        }
+    });
+}

package/dist/commands/detail.js

@@ -10,7 +10,7 @@ const appUrls_1 = require("../appUrls");
 function printRefValidationError(raw) {
     (0, messages_1.printErrorWithHelp)('A canonical ref is required.', [
         'Use the format <creator>/<kind>/<name>.',
-        'Kinds must be exactly app, asset, or asset-pack.',
+        'Kinds must be exactly app, asset, asset-spec, or asset-pack.',
         `Example: playdrop detail playdrop/app/hangingout`,
         `Example: playdrop detail playdrop/asset/astro`,
     ], { command: 'detail' });
@@ -73,6 +73,13 @@ function decorateAssetPack(apiBase, ref, pack) {
         },
     };
 }
+function formatTagSummary(tags) {
+    const normalizedTags = Array.isArray(tags) ? tags : [];
+    if (normalizedTags.length === 0) {
+        return 'none';
+    }
+    return normalizedTags.map((tag) => `${tag.ref} (${tag.displayName})`).join(', ');
+}
 function printAppText(ref, app) {
     console.log(`[app] ${ref}`);
     console.log(`Display name: ${(0, output_1.formatOptionalValue)(app.displayName)}`);
@@ -82,6 +89,7 @@ function printAppText(ref, app) {
     console.log(`Created: ${(0, output_1.formatTimestamp)(app.createdAt)}`);
     console.log(`Updated: ${(0, output_1.formatTimestamp)(app.updatedAt)}`);
     console.log(`Current version: ${(0, output_1.formatOptionalValue)(app.currentVersion)}`);
+    console.log(`Tags: ${formatTagSummary(app.tags)}`);
     console.log(`Play URL: ${(0, output_1.formatOptionalValue)(app.urls.play)}`);
     console.log(`Source URL: ${(0, output_1.formatOptionalValue)(app.urls.source)}`);
     console.log('\nNext: run "playdrop versions browse ' + ref + '" to inspect version history.');
@@ -96,6 +104,7 @@ function printAssetText(ref, asset) {
     console.log(`Updated: ${(0, output_1.formatTimestamp)(asset.updatedAt)}`);
     console.log(`Current revision: ${asset.currentVersion ? asset.currentVersion.revisionLabel : 'none'}`);
     console.log(`Current subcategory: ${(0, output_1.formatOptionalValue)(asset.currentVersion?.subcategory)}`);
+    console.log(`Tags: ${formatTagSummary(asset.tags)}`);
     console.log(`Source URL: ${(0, output_1.formatOptionalValue)(asset.urls.source)}`);
     if (asset.urls.files.length > 0) {
         for (const file of asset.urls.files) {
@@ -115,10 +124,25 @@ function printAssetPackText(ref, pack) {
     console.log(`Created: ${(0, output_1.formatTimestamp)(pack.createdAt)}`);
     console.log(`Updated: ${(0, output_1.formatTimestamp)(pack.updatedAt)}`);
     console.log(`Current version: ${(0, output_1.formatOptionalValue)(pack.currentVersion?.version)}`);
+    console.log(`Tags: ${formatTagSummary(pack.tags)}`);
     console.log(`Download URL: ${(0, output_1.formatOptionalValue)(pack.urls.download)}`);
     console.log(`Source URL: ${(0, output_1.formatOptionalValue)(pack.urls.source)}`);
     console.log('\nNext: run "playdrop versions browse ' + ref + '" to inspect other versions.');
 }
+function printAssetSpecText(ref, assetSpec) {
+    console.log(`[asset-spec] ${ref}`);
+    console.log(`Display name: ${(0, output_1.formatOptionalValue)(assetSpec.displayName)}`);
+    console.log(`Creator: @${assetSpec.creatorUsername}`);
+    console.log(`Description: ${(0, output_1.formatOptionalValue)(assetSpec.description)}`);
+    console.log(`Current version: ${(0, output_1.formatOptionalValue)(assetSpec.currentVersion?.version)}`);
+    console.log(`Status: ${(0, output_1.formatOptionalValue)(assetSpec.status)}`);
+    console.log(`Public assets: ${assetSpec.publicAssetCount.toLocaleString('en-US')}`);
+    console.log(`Supporting apps: ${assetSpec.supportingAppCount.toLocaleString('en-US')}`);
+    console.log(`Documentation: ${assetSpec.documentationAvailable ? 'available' : 'none'}`);
+    console.log(`Created: ${(0, output_1.formatTimestamp)(assetSpec.createdAt)}`);
+    console.log(`Updated: ${(0, output_1.formatTimestamp)(assetSpec.updatedAt)}`);
+    console.log('\nNext: run "playdrop versions browse ' + ref + '" to inspect version history.');
+}
 async function detail(rawRef, options = {}) {
     let ref;
     try {
@@ -150,13 +174,23 @@ async function detail(rawRef, options = {}) {
                 printAssetText(ref.ref, item);
                 return;
             }
-            const response = await client.fetchAssetPackBySlug(ref.creator, ref.name);
-            const item = decorateAssetPack(envConfig.apiBase, ref, response.pack);
+            if (ref.kind === 'asset-pack') {
+                const response = await client.fetchAssetPackBySlug(ref.creator, ref.name);
+                const item = decorateAssetPack(envConfig.apiBase, ref, response.pack);
+                if (options.json) {
+                    (0, output_1.printJson)({ kind: ref.kind, ref: ref.ref, item });
+                    return;
+                }
+                printAssetPackText(ref.ref, item);
+                return;
+            }
+            const response = await client.fetchAssetSpecBySlug(ref.creator, ref.name);
+            const item = response.assetSpec;
             if (options.json) {
                 (0, output_1.printJson)({ kind: ref.kind, ref: ref.ref, item });
                 return;
             }
-            printAssetPackText(ref.ref, item);
+            printAssetSpecText(ref.ref, item);
         }
         catch (error) {
             const handled = (0, errors_1.handleCommandFailure)(error, 'detail', 'Detail lookup', {

package/dist/commands/devServer.js

@@ -69,17 +69,22 @@ function spawnDevScript(projectInfo) {
         stdio: 'inherit',
         env: { ...process.env },
     });
-    child.on('exit', code => {
-        if (code !== 0) {
-            console.warn(`npm run dev exited with code ${code}.`);
-        }
-    });
     return child;
 }
 async function startDevServer(options) {
     const { appName, htmlPath, port, projectInfo } = options;
     let closing = false;
     const devProcess = spawnDevScript(projectInfo);
+    if (devProcess) {
+        devProcess.on('exit', code => {
+            if (closing) {
+                return;
+            }
+            if (code !== 0 && code !== null) {
+                console.warn(`npm run dev exited with code ${code}.`);
+            }
+        });
+    }
     const startedDevProcess = Boolean(devProcess);
     const staticRoot = (0, node_path_1.resolve)((0, node_path_1.dirname)(htmlPath));
     const server = node_http_1.default.createServer((req, res) => {

package/dist/commands/generation.d.ts

@@ -1,3 +1,4 @@
+import type { ImageAttachment } from '@playdrop/ai-client';
 type AiGenerateOptions = {
     subcategory?: string;
     assetName?: string;
@@ -28,6 +29,7 @@ type AiListOptions = {
     offset?: string | number;
     format?: string;
 };
+export declare function resolveImageAttachment(value: string | undefined, optionName: 'image1' | 'image2'): ImageAttachment | undefined;
 export declare function generate(typeInput: string, promptInput: string, options?: AiGenerateOptions): Promise<void>;
 type AiJobBrowseOptions = {
     type?: string;

package/dist/commands/generation.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveImageAttachment = resolveImageAttachment;
 exports.generate = generate;
 exports.browseGenerationJobs = browseGenerationJobs;
 exports.showGenerationJob = showGenerationJob;

package/dist/commands/search.d.ts

@@ -3,10 +3,15 @@ type SearchOptions = {
     appType?: string;
     assetCategory?: string;
     assetSubcategory?: string;
+    assetSpec?: string;
+    assetSpecOwner?: string;
+    assetSpecName?: string;
     packContainsCategory?: string;
     packContainsSubcategory?: string;
+    sort?: string;
     limit?: string | number;
     offset?: string | number;
+    tag?: string[];
     json?: boolean;
 };
 export declare function search(query: string | undefined, options?: SearchOptions): Promise<void>;