@playdrop/playdrop-cli 0.10.21 → 0.11.4

package/node_modules/@playdrop/types/dist/version.js

@@ -23,6 +23,8 @@ __export(version_exports, {
   APP_UPLOAD_INIT_STATUS_VALUES: () => APP_UPLOAD_INIT_STATUS_VALUES,
   APP_UPLOAD_LAUNCH_CHECK_STATUS_VALUES: () => APP_UPLOAD_LAUNCH_CHECK_STATUS_VALUES,
   APP_UPLOAD_SESSION_STATUS_VALUES: () => APP_UPLOAD_SESSION_STATUS_VALUES,
+  APP_VERSION_DESIGN_GROUP_VALUES: () => APP_VERSION_DESIGN_GROUP_VALUES,
+  APP_VERSION_DESIGN_SHAPE_HELP: () => APP_VERSION_DESIGN_SHAPE_HELP,
   APP_VERSION_VISIBILITY_VALUES: () => APP_VERSION_VISIBILITY_VALUES,
   DEFAULT_APP_AUTH_MODE: () => DEFAULT_APP_AUTH_MODE,
   DEFAULT_APP_CONTROLLER_MODE: () => DEFAULT_APP_CONTROLLER_MODE,
@@ -39,6 +41,7 @@ __export(version_exports, {
   isAppVersionVisibility: () => isAppVersionVisibility,
   isReviewState: () => isReviewState,
   isValidVersion: () => isValidVersion,
+  normalizeAppVersionDesign: () => normalizeAppVersionDesign,
   parseAppAuthMode: () => parseAppAuthMode,
   parseAppControllerMode: () => parseAppControllerMode,
   parseAppHostingMode: () => parseAppHostingMode,
@@ -102,6 +105,108 @@ function parseReviewState(value) {
   const normalized = value.trim().toUpperCase();
   return isReviewState(normalized) ? normalized : null;
 }
+const APP_VERSION_DESIGN_GROUP_VALUES = [
+  "genre",
+  "coreGameplay",
+  "render",
+  "camera",
+  "input",
+  "progression",
+  "artStyle",
+  "coreAssets",
+  "assetStrategy",
+  "engine",
+  "features",
+  "references"
+];
+const APP_VERSION_DESIGN_GROUPS = new Set(APP_VERSION_DESIGN_GROUP_VALUES);
+const APP_VERSION_DESIGN_NOTE_MAX_LENGTH = 140;
+const APP_VERSION_DESIGN_SHAPE_HELP = 'Expected catalogue design shape: {"genre":{"value":"arcade"},"coreGameplay":{"value":"short loop"},"render":{"value":"2d"},"camera":{"value":"fixed-screen"},"input":{"values":["tap","pointer"]},"progression":{"value":"waves"},"artStyle":{"value":"bright cartoon"},"assetStrategy":{"value":"procedural","note":"honest procedural draft"},"engine":{"value":"plain-html"},"coreAssets":{"values":[]},"features":{"values":[]},"references":{"values":[]}}. Allowed groups: genre, coreGameplay, render, camera, input, progression, artStyle, coreAssets, assetStrategy, engine, features, references. Use value for one-value groups and values for many-value groups.';
+const APP_VERSION_DESIGN_RULES = {
+  genre: { cardinality: "one" },
+  coreGameplay: { cardinality: "one" },
+  render: { cardinality: "one", values: ["2d", "3d"] },
+  camera: { cardinality: "one", values: ["top-down", "side", "isometric", "third-person", "first-person", "fixed-screen"] },
+  input: { cardinality: "many", values: ["one-thumb", "tap", "drag", "keyboard", "pointer", "virtual-stick", "gamepad"] },
+  progression: { cardinality: "one", values: ["endless", "levels", "waves", "rounds", "story"] },
+  artStyle: { cardinality: "one" },
+  coreAssets: { cardinality: "many", maxValues: 2 },
+  assetStrategy: { cardinality: "one", values: ["pack-first", "owned-assets", "mixed", "procedural"] },
+  engine: { cardinality: "one", values: ["phaser-2d", "three-js", "plain-html"] },
+  features: { cardinality: "many", values: ["multiplayer", "avatars", "achievements", "leaderboard", "saves", "ai-generation", "shop", "ads"] },
+  references: { cardinality: "many", maxValues: 2 }
+};
+function formatAppVersionDesignError(error) {
+  return `${error}. ${APP_VERSION_DESIGN_SHAPE_HELP}`;
+}
+function normalizeDesignString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function normalizeAppVersionDesign(value, options = {}) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return { ok: false, error: formatAppVersionDesignError("invalid_design") };
+  }
+  const record = value;
+  const allowedPackRefs = new Set((options.allowedPackRefs ?? []).map((ref) => ref.trim()).filter(Boolean));
+  const design = {};
+  for (const [rawGroup, rawEntry] of Object.entries(record)) {
+    if (!APP_VERSION_DESIGN_GROUPS.has(rawGroup)) {
+      return { ok: false, error: formatAppVersionDesignError(`invalid_design_group:${rawGroup}`) };
+    }
+    const group = rawGroup;
+    if (!rawEntry || typeof rawEntry !== "object" || Array.isArray(rawEntry)) {
+      return { ok: false, error: formatAppVersionDesignError(`invalid_design_entry:${group}`) };
+    }
+    const entry = rawEntry;
+    for (const key of Object.keys(entry)) {
+      if (key !== "value" && key !== "values" && key !== "note") {
+        return { ok: false, error: formatAppVersionDesignError(`invalid_design_entry_key:${group}:${key}`) };
+      }
+    }
+    const hasValue = Object.prototype.hasOwnProperty.call(entry, "value");
+    const hasValues = Object.prototype.hasOwnProperty.call(entry, "values");
+    if (hasValue === hasValues) {
+      return { ok: false, error: formatAppVersionDesignError(`invalid_design_value_shape:${group}`) };
+    }
+    const rule = APP_VERSION_DESIGN_RULES[group];
+    const values = hasValue ? [normalizeDesignString(entry["value"])] : Array.isArray(entry["values"]) ? entry["values"].map((item) => normalizeDesignString(item)) : null;
+    if (!values || values.some((item) => item === null)) {
+      return { ok: false, error: formatAppVersionDesignError(`invalid_design_value:${group}`) };
+    }
+    const normalizedValues = Array.from(new Set(values));
+    if (rule.cardinality === "one" && normalizedValues.length !== 1) {
+      return { ok: false, error: formatAppVersionDesignError(`invalid_design_value_count:${group}`) };
+    }
+    if (rule.maxValues !== void 0 && normalizedValues.length > rule.maxValues) {
+      return { ok: false, error: formatAppVersionDesignError(`invalid_design_value_count:${group}`) };
+    }
+    if (rule.values) {
+      const allowedValues = new Set(rule.values);
+      const invalidValue = normalizedValues.find((item) => !allowedValues.has(item));
+      if (invalidValue) {
+        return { ok: false, error: formatAppVersionDesignError(`invalid_design_value:${group}:${invalidValue}`) };
+      }
+    }
+    if (group === "coreAssets") {
+      const missingPackRef = normalizedValues.find((item) => !allowedPackRefs.has(item));
+      if (missingPackRef) {
+        return { ok: false, error: formatAppVersionDesignError(`design_core_asset_not_in_uses_packs:${missingPackRef}`) };
+      }
+    }
+    const note = Object.prototype.hasOwnProperty.call(entry, "note") ? normalizeDesignString(entry["note"]) : null;
+    if (Object.prototype.hasOwnProperty.call(entry, "note") && note === null) {
+      return { ok: false, error: formatAppVersionDesignError(`invalid_design_note:${group}`) };
+    }
+    if (note && note.length > APP_VERSION_DESIGN_NOTE_MAX_LENGTH) {
+      return { ok: false, error: formatAppVersionDesignError(`design_note_too_long:${group}`) };
+    }
+    design[group] = {
+      ...rule.cardinality === "one" ? { value: normalizedValues[0] } : { values: normalizedValues },
+      ...note ? { note } : {}
+    };
+  }
+  return { ok: true, value: design };
+}
 const APP_AUTH_MODE_VALUES = ["REQUIRED", "OPTIONAL", "NONE"];
 const DEFAULT_APP_AUTH_MODE = "REQUIRED";
 function isAppAuthMode(value) {
@@ -172,6 +277,8 @@ const APP_UPLOAD_LAUNCH_CHECK_STATUS_VALUES = ["NOT_RUN", "PASSED", "FAILED"];
   APP_UPLOAD_INIT_STATUS_VALUES,
   APP_UPLOAD_LAUNCH_CHECK_STATUS_VALUES,
   APP_UPLOAD_SESSION_STATUS_VALUES,
+  APP_VERSION_DESIGN_GROUP_VALUES,
+  APP_VERSION_DESIGN_SHAPE_HELP,
   APP_VERSION_VISIBILITY_VALUES,
   DEFAULT_APP_AUTH_MODE,
   DEFAULT_APP_CONTROLLER_MODE,
@@ -188,6 +295,7 @@ const APP_UPLOAD_LAUNCH_CHECK_STATUS_VALUES = ["NOT_RUN", "PASSED", "FAILED"];
   isAppVersionVisibility,
   isReviewState,
   isValidVersion,
+  normalizeAppVersionDesign,
   parseAppAuthMode,
   parseAppControllerMode,
   parseAppHostingMode,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playdrop/playdrop-cli",
-  "version": "0.10.21",
+  "version": "0.11.4",
   "description": "Official Playdrop CLI for publishing browser games, creator apps, and AI-generated game assets on playdrop.ai",
   "homepage": "https://www.playdrop.ai",
   "repository": {