@playdrop/playdrop-cli 0.6.1 → 0.6.4

package/README.md

@@ -4,6 +4,8 @@ Official Playdrop CLI for the live [Playdrop](https://www.playdrop.ai/) platform
 
 Use it to browse live examples, create or remix projects, publish browser games and creator apps, and work with AI-generated game assets on Playdrop.
 
+For AI coding workflows, pair the CLI with the public Playdrop plugin. The plugin is the preferred public setup and contains many specialist Playdrop skills for Codex, Claude Code, and Cursor.
+
 ## Install
 
 ```bash
@@ -33,11 +35,12 @@ playdrop project publish .
 
 - Website: [playdrop.ai](https://www.playdrop.ai/)
 - Getting started: [playdrop.ai/getting-started](https://www.playdrop.ai/getting-started)
+- Plugin docs: [playdrop.ai/docs/plugin](https://www.playdrop.ai/docs/plugin)
 - CLI docs: [playdrop.ai/docs/cli](https://www.playdrop.ai/docs/cli)
 - Runtime docs: [playdrop.ai/docs/runtime](https://www.playdrop.ai/docs/runtime)
 - Templates and demos: [playdrop.ai/docs/examples#templates-and-demos](https://www.playdrop.ai/docs/examples#templates-and-demos)
 - Canonical public plugin repo: [github.com/playdrop-ai/playdrop-plugin](https://github.com/playdrop-ai/playdrop-plugin)
-- Legacy public skill surface: [skills.sh/playdrop-ai/playdrop-skills/playdrop](https://skills.sh/playdrop-ai/playdrop-skills/playdrop)
+- Legacy public skill compatibility: [skills.sh/playdrop-ai/playdrop-skills/playdrop](https://skills.sh/playdrop-ai/playdrop-skills/playdrop)
 
 ## Live Examples
 

package/config/client-meta.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.6.1",
+  "version": "0.6.4",
   "build": 1,
   "platforms": {
     "ios": {
@@ -26,19 +26,27 @@
   },
   "clients": {
     "web": {
-      "minimumVersion": "0.6.1",
+      "minimumVersion": "0.6.4",
       "minimumBuild": 1
     },
     "admin": {
-      "minimumVersion": "0.6.1",
+      "minimumVersion": "0.6.4",
       "minimumBuild": 1
     },
     "apple": {
       "minimumVersion": "0.3.10",
       "minimumBuild": 1
     },
+    "apple-playdrop": {
+      "minimumVersion": "0.3.10",
+      "minimumBuild": 1
+    },
+    "apple-games": {
+      "minimumVersion": "0.3.10",
+      "minimumBuild": 1
+    },
     "cli": {
-      "minimumVersion": "0.6.1"
+      "minimumVersion": "0.6.4"
     }
   }
 }

package/dist/apps/index.d.ts

@@ -1,11 +1,12 @@
 import type { ApiClient } from '@playdrop/api-client';
 import type { AppTask } from '../catalogue';
-import { validateAppTask, runFormatScript } from './validate';
+import { collectAppValidationWarnings, validateAppTask, runFormatScript } from './validate';
 import { buildApp, type AppBuildArtifacts } from './build';
 import { uploadApp, type AppUploadResult } from './upload';
 export type AppPipelineResult = {
     artifacts: AppBuildArtifacts | null;
     upload: AppUploadResult;
+    warnings: string[];
 };
 export type AppPipelineOptions = {
     skipEcs?: boolean;
@@ -14,4 +15,4 @@ export type AppPipelineOptions = {
     creatorUsername?: string;
 };
 export declare function runAppPipeline(client: ApiClient, task: AppTask, options?: AppPipelineOptions): Promise<AppPipelineResult>;
-export { validateAppTask, buildApp, uploadApp, runFormatScript };
+export { collectAppValidationWarnings, validateAppTask, buildApp, uploadApp, runFormatScript };

package/dist/apps/index.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runFormatScript = exports.uploadApp = exports.buildApp = exports.validateAppTask = void 0;
+exports.runFormatScript = exports.uploadApp = exports.buildApp = exports.validateAppTask = exports.collectAppValidationWarnings = void 0;
 exports.runAppPipeline = runAppPipeline;
 const validate_1 = require("./validate");
+Object.defineProperty(exports, "collectAppValidationWarnings", { enumerable: true, get: function () { return validate_1.collectAppValidationWarnings; } });
 Object.defineProperty(exports, "validateAppTask", { enumerable: true, get: function () { return validate_1.validateAppTask; } });
 Object.defineProperty(exports, "runFormatScript", { enumerable: true, get: function () { return validate_1.runFormatScript; } });
 const build_1 = require("./build");
@@ -14,6 +15,7 @@ async function runAppPipeline(client, task, options) {
     // External apps don't need to be built - they're hosted elsewhere
     const isExternal = task.hostingMode === 'EXTERNAL' || !!task.externalUrl;
     const artifacts = isExternal ? null : await (0, build_1.buildApp)(task);
+    const warnings = (0, validate_1.collectAppValidationWarnings)(task, isExternal ? 'source' : 'bundle');
     const uploadOptions = {
         skipEcs: options?.skipEcs,
         skipReview: options?.skipReview,
@@ -21,5 +23,5 @@ async function runAppPipeline(client, task, options) {
         creatorUsername: options?.creatorUsername,
     };
     const upload = await (0, upload_1.uploadApp)(client, task, artifacts, uploadOptions);
-    return { artifacts, upload };
+    return { artifacts, upload, warnings };
 }

package/dist/apps/upload.js

@@ -114,6 +114,7 @@ async function prepareOwnedAssetUpload(task) {
         subcategory: task.subcategory,
         format: task.format || (0, node_path_1.extname)(files[0]?.filename || '').replace(/^\./, '').toUpperCase() || 'GLB',
         visibility: task.visibility,
+        license: task.license,
         assetSpec: task.assetSpec,
         shopListed: task.shopListed,
         shopPriceCredits: task.shopPriceCredits,
@@ -253,6 +254,7 @@ async function uploadAppVersion(client, task, artifacts, options) {
         version: task.version,
         releaseNotes: task.releaseNotes,
         visibility: task.versionVisibility,
+        license: task.license,
         remixRef: task.remix,
         usesAssets: task.uses.assets.map((entry) => ({
             ref: entry.ref,
@@ -313,6 +315,7 @@ async function uploadAppVersion(client, task, artifacts, options) {
             format: ownedAsset.format,
             assetSpec: ownedAsset.assetSpec,
             visibility: ownedAsset.visibility,
+            license: ownedAsset.license,
             shopListed: ownedAsset.shopListed,
             shopPriceCredits: ownedAsset.shopPriceCredits,
             files: ownedAsset.files.map((file) => ({

package/dist/apps/validate.d.ts

@@ -1,3 +1,5 @@
 import type { AppTask } from '../catalogue';
+export type AppValidationWarningMode = 'source' | 'bundle';
+export declare function collectAppValidationWarnings(task: AppTask, mode?: AppValidationWarningMode): string[];
 export declare function runFormatScript(task: AppTask): Promise<boolean>;
 export declare function validateAppTask(task: AppTask): Promise<void>;

package/dist/apps/validate.js

@@ -1,14 +1,39 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectAppValidationWarnings = collectAppValidationWarnings;
 exports.runFormatScript = runFormatScript;
 exports.validateAppTask = validateAppTask;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
+const semver_1 = require("semver");
+const clientInfo_1 = require("../clientInfo");
 const build_1 = require("./build");
 const projectValidateCache = new Map();
 const projectFormatCache = new Map();
 const LEGACY_SCAN_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.html']);
 const LEGACY_SCAN_IGNORED_DIRS = new Set(['node_modules', '.git', 'dist-test', 'coverage']);
+const SDK_SCAN_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.mts', '.cts', '.vue', '.svelte', '.astro', '.html']);
+const SDK_SCAN_IGNORED_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    'out',
+    '.next',
+    '.turbo',
+    '.cache',
+    '.svelte-kit',
+    'coverage',
+    'tmp',
+    'logs',
+    'test',
+    'tests',
+    '__tests__',
+]);
+const SDK_ENTRY_HTML_FILENAMES = ['index.html', 'main.html', 'template.html'];
+const SDK_ENTRY_SOURCE_BASENAMES = ['main', 'index', 'app', 'bootstrap', 'entry', 'client'];
+const SDK_ENTRY_ROOT_DIRS = ['src', 'app', 'pages'];
+const SDK_SPECIAL_ENTRY_PATHS = ['app/page', 'app/layout', 'pages/index', 'pages/_app'];
 const LEGACY_SDK_SYMBOL_PATTERNS = [
     { symbol: 'selectedAvatarKey', pattern: /\bselectedAvatarKey\b/g },
     { symbol: 'sdk.entities', pattern: /\bsdk\s*\.\s*entities\b/g },
@@ -16,6 +41,21 @@ const LEGACY_SDK_SYMBOL_PATTERNS = [
     { symbol: 'sdk.assets.block', pattern: /\bsdk\s*\.\s*assets\s*\.\s*block\b/g },
     { symbol: 'loadEntity(', pattern: /\.\s*loadEntity\s*\(/g },
 ];
+const SDK_REFERENCE_PATTERNS = [
+    /https:\/\/assets\.playdrop\.ai\/sdk\/playdrop\.js/g,
+    /@playdrop\/sdk(?:\/browser)?/g,
+];
+const SDK_INIT_PATTERNS = [
+    /\bwindow\s*\.\s*playdrop\s*\.\s*init\s*\(/g,
+    /\bplaydrop\s*\.\s*init\s*\(/g,
+    /\bsdk\s*\.\s*initialize\s*\(/g,
+];
+const LOCAL_HTML_SCRIPT_PATTERN = /<script\b[^>]*\bsrc\s*=\s*["']([^"']+)["'][^>]*>/gi;
+const LOCAL_IMPORT_PATTERNS = [
+    /(?:import|export)\s+(?:[^'"`]*?\s+from\s+)?["']([^"']+)["']/g,
+    /import\s*\(\s*["']([^"']+)["']\s*\)/g,
+];
+const LOCAL_SCRIPT_COMMAND_PATTERN = /(?:^|(?:&&|\|\||;)\s*)(?:node(?:\s+--[^\s"'`;|&]+)*|tsx|ts-node(?:-esm)?|bun|deno\s+run)\s+(["']?)([^"'`\s;&|]+)\1/g;
 function ensureWithinProject(task) {
     const relativePath = (0, node_path_1.relative)(task.projectDir, task.filePath);
     const segments = relativePath.split(/[/\\]+/);
@@ -81,6 +121,345 @@ function scanForLegacySdkSymbols(task) {
         throw new Error(`[apps][validate] legacy SDK symbols detected for ${task.name}: ${details}${suffix}. Remove entity-era APIs before publishing.`);
     }
 }
+function stripSpecifierDecorators(specifier) {
+    return specifier.split(/[?#]/, 1)[0]?.trim() ?? '';
+}
+function safeReadFile(filePath) {
+    try {
+        return (0, node_fs_1.readFileSync)(filePath, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+function isIgnoredSdkScanDirectory(name) {
+    return SDK_SCAN_IGNORED_DIRS.has(name);
+}
+function resolveSdkModulePath(basePath) {
+    const tryFile = (candidate) => {
+        if (!(0, node_fs_1.existsSync)(candidate)) {
+            return null;
+        }
+        try {
+            return (0, node_fs_1.statSync)(candidate).isFile() ? candidate : null;
+        }
+        catch {
+            return null;
+        }
+    };
+    const direct = tryFile(basePath);
+    if (direct) {
+        return direct;
+    }
+    if (!(0, node_path_1.extname)(basePath)) {
+        for (const extension of SDK_SCAN_EXTENSIONS) {
+            const withExtension = tryFile(`${basePath}${extension}`);
+            if (withExtension) {
+                return withExtension;
+            }
+        }
+    }
+    if ((0, node_fs_1.existsSync)(basePath)) {
+        try {
+            if ((0, node_fs_1.statSync)(basePath).isDirectory()) {
+                for (const extension of SDK_SCAN_EXTENSIONS) {
+                    const indexCandidate = tryFile((0, node_path_1.join)(basePath, `index${extension}`));
+                    if (indexCandidate) {
+                        return indexCandidate;
+                    }
+                }
+            }
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+function resolveLocalSpecifier(task, sourceFilePath, specifier) {
+    const normalized = stripSpecifierDecorators(specifier);
+    if (!normalized) {
+        return null;
+    }
+    if (normalized.startsWith('/')) {
+        return resolveSdkModulePath((0, node_path_1.resolve)(task.projectDir, `.${normalized}`));
+    }
+    if (!normalized.startsWith('.')) {
+        return null;
+    }
+    return resolveSdkModulePath((0, node_path_1.resolve)((0, node_path_1.dirname)(sourceFilePath), normalized));
+}
+function extractLocalHtmlScriptFiles(task, filePath, source) {
+    const matches = [];
+    LOCAL_HTML_SCRIPT_PATTERN.lastIndex = 0;
+    let match = null;
+    while ((match = LOCAL_HTML_SCRIPT_PATTERN.exec(source)) !== null) {
+        const specifier = match[1];
+        if (!specifier) {
+            continue;
+        }
+        const resolved = resolveLocalSpecifier(task, filePath, specifier);
+        if (resolved) {
+            matches.push(resolved);
+        }
+    }
+    return matches;
+}
+function extractLocalImportedFiles(task, filePath, source) {
+    const matches = [];
+    for (const pattern of LOCAL_IMPORT_PATTERNS) {
+        pattern.lastIndex = 0;
+        let match = null;
+        while ((match = pattern.exec(source)) !== null) {
+            const specifier = match[1];
+            if (!specifier) {
+                continue;
+            }
+            const resolved = resolveLocalSpecifier(task, filePath, specifier);
+            if (resolved) {
+                matches.push(resolved);
+            }
+        }
+    }
+    return matches;
+}
+function addFileIfPresent(target, filePath) {
+    if (!(0, node_fs_1.existsSync)(filePath)) {
+        return;
+    }
+    try {
+        if ((0, node_fs_1.statSync)(filePath).isFile()) {
+            target.add(filePath);
+        }
+    }
+    catch {
+        // Ignore unreadable candidates and continue scanning the rest.
+    }
+}
+function extractLocalScriptCommandFiles(task) {
+    if (!task.packageJsonPath) {
+        return [];
+    }
+    const rawPackageJson = safeReadFile(task.packageJsonPath);
+    if (!rawPackageJson) {
+        return [];
+    }
+    let packageJson;
+    try {
+        packageJson = JSON.parse(rawPackageJson);
+    }
+    catch {
+        return [];
+    }
+    const scripts = packageJson?.scripts;
+    if (!scripts || typeof scripts !== 'object') {
+        return [];
+    }
+    const matches = new Set();
+    Object.values(scripts).forEach((scriptValue) => {
+        if (typeof scriptValue !== 'string') {
+            return;
+        }
+        LOCAL_SCRIPT_COMMAND_PATTERN.lastIndex = 0;
+        let match = null;
+        while ((match = LOCAL_SCRIPT_COMMAND_PATTERN.exec(scriptValue)) !== null) {
+            const specifier = stripSpecifierDecorators(match[2] ?? '');
+            if (!specifier || specifier.startsWith('-')) {
+                continue;
+            }
+            const resolvedPath = specifier.startsWith('/')
+                ? resolveSdkModulePath((0, node_path_1.resolve)(specifier))
+                : resolveSdkModulePath((0, node_path_1.resolve)(task.projectDir, specifier));
+            if (resolvedPath) {
+                matches.add(resolvedPath);
+            }
+        }
+    });
+    return [...matches];
+}
+function collectSourceSeedFiles(task) {
+    const seeds = new Set();
+    const entryRelativePath = (0, node_path_1.relative)(task.projectDir, task.filePath);
+    const entrySegments = entryRelativePath.split(/[/\\]+/);
+    const entryCrossesIgnoredSourceDirectory = entrySegments.some((segment) => isIgnoredSdkScanDirectory(segment));
+    if (entryRelativePath && !entryRelativePath.startsWith('..') && !entryCrossesIgnoredSourceDirectory) {
+        addFileIfPresent(seeds, task.filePath);
+    }
+    SDK_ENTRY_HTML_FILENAMES.forEach((filename) => {
+        addFileIfPresent(seeds, (0, node_path_1.join)(task.projectDir, filename));
+        addFileIfPresent(seeds, (0, node_path_1.join)(task.projectDir, 'public', filename));
+    });
+    const sourceExtensions = [...SDK_SCAN_EXTENSIONS].filter((extension) => extension !== '.html');
+    const addEntryBasenames = (directory) => {
+        SDK_ENTRY_SOURCE_BASENAMES.forEach((basename) => {
+            sourceExtensions.forEach((extension) => {
+                addFileIfPresent(seeds, (0, node_path_1.join)(directory, `${basename}${extension}`));
+            });
+        });
+    };
+    addEntryBasenames(task.projectDir);
+    SDK_ENTRY_ROOT_DIRS.forEach((directory) => {
+        addEntryBasenames((0, node_path_1.join)(task.projectDir, directory));
+    });
+    SDK_SPECIAL_ENTRY_PATHS.forEach((relativePath) => {
+        sourceExtensions.forEach((extension) => {
+            addFileIfPresent(seeds, (0, node_path_1.join)(task.projectDir, `${relativePath}${extension}`));
+        });
+    });
+    extractLocalScriptCommandFiles(task).forEach((filePath) => {
+        const relativePath = (0, node_path_1.relative)(task.projectDir, filePath);
+        const segments = relativePath.split(/[/\\]+/);
+        const crossesIgnoredSourceDirectory = segments.some((segment) => isIgnoredSdkScanDirectory(segment));
+        if (!relativePath || relativePath.startsWith('..') || crossesIgnoredSourceDirectory) {
+            return;
+        }
+        seeds.add(filePath);
+    });
+    return [...seeds];
+}
+function collectBundleSeedFiles(task) {
+    const seeds = new Set();
+    addFileIfPresent(seeds, task.filePath);
+    return [...seeds];
+}
+function collectSdkDetectionFiles(task, mode) {
+    const queue = mode === 'bundle' ? collectBundleSeedFiles(task) : collectSourceSeedFiles(task);
+    const queued = new Set(queue);
+    const visited = new Set();
+    if (task.packageJsonPath) {
+        visited.add(task.packageJsonPath);
+    }
+    while (queue.length > 0) {
+        const filePath = queue.shift();
+        if (!filePath || visited.has(filePath)) {
+            continue;
+        }
+        if (!(0, node_fs_1.existsSync)(filePath)) {
+            continue;
+        }
+        let isFile = false;
+        try {
+            isFile = (0, node_fs_1.statSync)(filePath).isFile();
+        }
+        catch {
+            isFile = false;
+        }
+        if (!isFile) {
+            continue;
+        }
+        const extension = (0, node_path_1.extname)(filePath).toLowerCase();
+        if (extension && !SDK_SCAN_EXTENSIONS.has(extension)) {
+            continue;
+        }
+        visited.add(filePath);
+        const source = safeReadFile(filePath);
+        if (!source) {
+            continue;
+        }
+        const localReferences = extension === '.html'
+            ? extractLocalHtmlScriptFiles(task, filePath, source)
+            : extractLocalImportedFiles(task, filePath, source);
+        localReferences.forEach((resolvedPath) => {
+            const relativePath = (0, node_path_1.relative)(task.projectDir, resolvedPath);
+            const segments = relativePath.split(/[/\\]+/);
+            const crossesIgnoredSourceDirectory = mode === 'source'
+                && segments.some((segment) => isIgnoredSdkScanDirectory(segment));
+            if (!relativePath || relativePath.startsWith('..') || crossesIgnoredSourceDirectory) {
+                return;
+            }
+            if (!queued.has(resolvedPath) && !visited.has(resolvedPath)) {
+                queue.push(resolvedPath);
+                queued.add(resolvedPath);
+            }
+        });
+    }
+    return [...visited];
+}
+function detectSdkUsage(task, mode) {
+    let hasSdkReference = false;
+    let hasSdkInit = false;
+    const files = collectSdkDetectionFiles(task, mode);
+    for (const filePath of files) {
+        if (hasSdkReference && hasSdkInit) {
+            break;
+        }
+        const source = safeReadFile(filePath);
+        if (!source) {
+            continue;
+        }
+        if (!hasSdkReference) {
+            hasSdkReference = SDK_REFERENCE_PATTERNS.some((pattern) => {
+                pattern.lastIndex = 0;
+                return pattern.test(source);
+            });
+        }
+        if (!hasSdkInit) {
+            hasSdkInit = SDK_INIT_PATTERNS.some((pattern) => {
+                pattern.lastIndex = 0;
+                return pattern.test(source);
+            });
+        }
+    }
+    return { hasSdkReference, hasSdkInit };
+}
+function collectOutdatedSdkVersionWarnings(task) {
+    if (!task.packageJsonPath) {
+        return [];
+    }
+    const rawPackageJson = safeReadFile(task.packageJsonPath);
+    if (!rawPackageJson) {
+        return [];
+    }
+    let packageJson;
+    try {
+        packageJson = JSON.parse(rawPackageJson);
+    }
+    catch {
+        return [];
+    }
+    const cliVersion = (0, clientInfo_1.getCliVersion)();
+    if (!(0, semver_1.valid)(cliVersion)) {
+        return [];
+    }
+    const sdkTypesDependency = typeof packageJson?.devDependencies?.['playdrop-sdk-types'] === 'string'
+        ? packageJson.devDependencies['playdrop-sdk-types']
+        : typeof packageJson?.dependencies?.['playdrop-sdk-types'] === 'string'
+            ? packageJson.dependencies['playdrop-sdk-types']
+            : '';
+    const sdkTypesVersion = typeof packageJson?.playdrop?.sdkTypesVersion === 'string'
+        ? packageJson.playdrop.sdkTypesVersion.trim()
+        : '';
+    const usesVendoredSdkTypes = sdkTypesDependency.includes('playdrop-sdk-types')
+        && (sdkTypesDependency.startsWith('file:') || sdkTypesDependency.includes('.tgz'));
+    if (!usesVendoredSdkTypes
+        || !(0, semver_1.valid)(sdkTypesVersion)
+        || !(0, semver_1.lt)(sdkTypesVersion, cliVersion)) {
+        return [];
+    }
+    return [
+        `[apps][validate] ${task.name} vendors playdrop-sdk-types.tgz at ${sdkTypesVersion}, which is older than this CLI version ${cliVersion}. Refresh vendor/playdrop-sdk-types.tgz and package.json playdrop.sdkTypesVersion before upload.`,
+    ];
+}
+function collectAppValidationWarnings(task, mode = 'source') {
+    const isExternal = task.hostingMode === 'EXTERNAL' || !!task.externalUrl;
+    if (isExternal) {
+        return [];
+    }
+    const primaryDetection = detectSdkUsage(task, mode);
+    const sourceDetection = mode === 'bundle'
+        ? detectSdkUsage(task, 'source')
+        : primaryDetection;
+    const hasSdkReference = primaryDetection.hasSdkReference || sourceDetection.hasSdkReference;
+    const hasSdkInit = primaryDetection.hasSdkInit || sourceDetection.hasSdkInit;
+    const warnings = [];
+    if (!hasSdkReference) {
+        warnings.push(`[apps][validate] Could not detect the Playdrop SDK loader or @playdrop/sdk import for ${task.name}. We could not find https://assets.playdrop.ai/sdk/playdrop.js or @playdrop/sdk in the app files, so it might not work once uploaded.`);
+    }
+    if (!hasSdkInit) {
+        warnings.push(`[apps][validate] Could not detect Playdrop SDK initialization for ${task.name}. We could not find playdrop.init() in the app files, so it might not work once uploaded.`);
+    }
+    return [...warnings, ...collectOutdatedSdkVersionWarnings(task)];
+}
 async function runFormatScript(task) {
     if (!task.packageJsonPath || !task.hasFormatScript) {
         return false;

package/dist/catalogue.d.ts

@@ -1,4 +1,4 @@
-import { type AppSurface, type AppType, type AppHostingMode, type AppAuthMode, type AppControllerMode, type AppVersionVisibility, type AppAchievementCatalogueDefinition, type AppLeaderboardCatalogueDefinition, type PlayerMetaDefinitionStatus, type CatalogueTagGroupDefinition, type AppMetadataAssetSpecSupport, type AssetSpecContract, type AssetSpecStatus, type AssetSpecValidationKind } from '@playdrop/types';
+import { type AppSurface, type AppType, type AppHostingMode, type AppAuthMode, type AppControllerMode, type AppVersionVisibility, type AppAchievementCatalogueDefinition, type AppLeaderboardCatalogueDefinition, type PlayerMetaDefinitionStatus, type CatalogueTagGroupDefinition, type AppMetadataAssetSpecSupport, type AssetSpecContract, type AssetSpecStatus, type AssetSpecValidationKind, type ContentLicense } from '@playdrop/types';
 import { type AssetSpecSupportDeclaration } from './assetSpecs';
 export type CatalogueJson = {
     apps?: Array<Record<string, unknown>>;
@@ -44,6 +44,7 @@ export type AppCatalogueEntry = {
     version?: string;
     releaseNotes?: string;
     visibility?: string;
+    license?: string;
     hostingMode?: string;
     authMode?: string;
     controllerMode?: string;
@@ -76,6 +77,7 @@ export type AssetCatalogueEntry = {
     username?: string;
     files?: Record<string, string>;
     visibility?: string;
+    license?: string;
     tags?: string[];
     shopListed?: boolean;
     shopPriceCredits?: number;
@@ -107,6 +109,7 @@ export type OwnedAssetCatalogueEntry = {
     format?: string;
     files?: Record<string, string>;
     visibility?: string;
+    license?: string;
     shopListed?: boolean;
     shopPriceCredits?: number;
 };
@@ -121,6 +124,7 @@ export type AssetPackCatalogueEntry = {
     externalUrl?: string;
     downloadUrl?: string;
     visibility?: string;
+    license?: string;
     releaseNotes?: string;
     listing?: AppListingConfig;
     tags?: string[];
@@ -176,6 +180,7 @@ export type AppTask = {
     version?: string;
     releaseNotes?: string;
     versionVisibility?: AppVersionVisibility;
+    license: ContentLicense;
     tags: string[];
     hostingMode?: AppHostingMode;
     authMode?: AppAuthMode;
@@ -212,6 +217,7 @@ export type AssetTask = {
     remix?: string;
     format?: string;
     visibility?: string;
+    license: ContentLicense;
     tags: string[];
     shopListed?: boolean;
     shopPriceCredits?: number;
@@ -255,6 +261,7 @@ export type OwnedAssetTask = {
     assetSpecContract?: AssetSpecContract;
     format?: string;
     visibility?: string;
+    license: ContentLicense;
     shopListed?: boolean;
     shopPriceCredits?: number;
     files: Record<string, string>;
@@ -269,6 +276,7 @@ export type PackOwnedAssetTask = {
     assetSpecContract?: AssetSpecContract;
     format?: string;
     visibility?: string;
+    license: ContentLicense;
     shopListed?: boolean;
     shopPriceCredits?: number;
     files: Record<string, string>;
@@ -289,6 +297,7 @@ export type AssetPackTask = {
     externalUrl?: string;
     downloadUrl?: string;
     visibility?: string;
+    license: ContentLicense;
     releaseNotes?: string;
     listing?: ResolvedListingAssets;
     relations?: Array<{