pixelkiln 0.40.0 → 0.41.0

package/dist/cli.js

@@ -5448,12 +5448,7 @@ var PixelLabProvider = class _PixelLabProvider {
     const character = await this.client.getCharacter(jobId);
     if (character.status === "failed") return { status: "failed", error: "character generation failed upstream" };
     if (character.status !== "completed" || !character.rotation_urls) return { status: "processing" };
-    const order = character.directions === 4 ? CHARACTER_DIRECTIONS_4 : CHARACTER_DIRECTIONS_8;
-    const sources = [];
-    for (const direction of order) {
-      const url = character.rotation_urls[direction];
-      if (url) sources.push({ url, role: direction });
-    }
+    const sources = rotationSources(character);
     if (!sources.length) return { status: "failed", error: "character completed with no rotation images" };
     return {
       status: "ready",
@@ -5745,6 +5740,27 @@ var PixelLabProvider = class _PixelLabProvider {
       })))
     };
   }
+  /**
+   * A character's rotation and frame URLs carry its last edit time as a
+   * cache-buster, so the record's URLs can name bytes a cache still holds
+   * after an edit in PixelLab's editor. Objects keep stable URLs.
+   */
+  async refreshSources(objectId, context) {
+    if (context.generator !== "character") return void 0;
+    const [characterId, groupId] = objectId.split("#");
+    const character = await this.client.getCharacter(characterId).catch((err) => {
+      if (err instanceof PixelLabError && err.status === 404) return null;
+      throw err;
+    });
+    if (!character) return null;
+    if (!groupId) return character.status === "completed" ? rotationSources(character) : void 0;
+    const recorded = context.metadata?.character ?? {};
+    const direction = recorded.direction ?? "south";
+    const group = character.animations.find((g) => g.animation_group_id === groupId);
+    const frames = group?.directions.find((d) => d.direction === direction && d.frames.length)?.frames ?? (recorded.animationName ? findAnimation(character, recorded.animationName, direction, recorded.animationId ?? null)?.frames : void 0);
+    if (!frames) return null;
+    return frames.map((url, index) => ({ url, role: `frame-${String(index).padStart(2, "0")}` }));
+  }
 };
 function remoteCharacter(character) {
   return {
@@ -5775,6 +5791,15 @@ function firstUrl(urls) {
   if (!urls) return null;
   return Object.values(urls).find((u) => typeof u === "string") ?? null;
 }
+function rotationSources(character) {
+  const order = character.directions === 4 ? CHARACTER_DIRECTIONS_4 : CHARACTER_DIRECTIONS_8;
+  const sources = [];
+  for (const direction of order) {
+    const url = character.rotation_urls?.[direction];
+    if (url) sources.push({ url, role: direction });
+  }
+  return sources;
+}
 function findAnimation(character, name, direction, animationId) {
   for (const group of character.animations) {
     const match = group.directions.find((d) => d.direction === direction && d.frames.length > 0);
@@ -7331,7 +7356,40 @@ async function fetchAssets(provider, specs, lock, lockPath, opts = {}) {
         result.skipped++;
         continue;
       }
-      const sources = entry.sourceUrls?.length ? entry.sourceUrls : entry.sourceUrl ? [{ url: entry.sourceUrl }] : opts.repair && entry.outputs.length ? entry.outputs.map((o) => ({ url: "", role: o.role, mediaType: o.mediaType })) : [];
+      const recordedSources = entry.sourceUrls?.length ? entry.sourceUrls : entry.sourceUrl ? [{ url: entry.sourceUrl }] : opts.repair && entry.outputs.length ? entry.outputs.map((o) => ({ url: "", role: o.role, mediaType: o.mediaType })) : [];
+      let sources = recordedSources;
+      let rotated = false;
+      if (opts.refresh && entry.status === "downloaded" && entry.objectId && provider.refreshSources) {
+        let current;
+        try {
+          current = await provider.refreshSources(entry.objectId, {
+            generator: entry.generator,
+            metadata: entry.providerMetadata?.[provider.id],
+            sources: recordedSources
+          });
+        } catch (err) {
+          const message6 = err instanceof Error ? err.message : String(err);
+          upsert(lock, key, { status: "download-failed", error: `download failed: ${message6}` });
+          result.failed++;
+          log2(`  FAILED  ${key}: ${message6}`);
+          await saveLock(lockPath, lock);
+          continue;
+        }
+        if (current === null) {
+          upsert(lock, key, { status: "download-failed", error: `download failed: ${entry.objectId} no longer exists upstream` });
+          result.failed++;
+          log2(`  FAILED  ${key}: ${entry.objectId} no longer exists upstream`);
+          await saveLock(lockPath, lock);
+          continue;
+        }
+        if (current) {
+          sources = current.map((source) => ({
+            ...source,
+            mediaType: source.mediaType ?? recordedSources.find((r) => r.role === source.role)?.mediaType
+          }));
+          rotated = sources.length !== recordedSources.length || sources.some((source, index) => source.url !== recordedSources[index]?.url || source.role !== recordedSources[index]?.role);
+        }
+      }
       if (!sources.length) {
         upsert(lock, key, {
           status: "download-failed",
@@ -7460,6 +7518,10 @@ async function fetchAssets(provider, specs, lock, lockPath, opts = {}) {
           log2(`  wrote   ${path13.relative(process.cwd(), target)}`);
         }
         if (opts.refresh && !wrote) {
+          if (rotated) {
+            const persistent = sources.filter((source) => shouldPersistSourceUrl(source.url));
+            upsert(lock, key, { sourceUrl: persistent[0]?.url ?? null, sourceUrls: persistent });
+          }
           result.unchanged = (result.unchanged ?? 0) + 1;
           continue;
         }
@@ -10177,6 +10239,32 @@ async function samePixels(a, b) {
   }
 }
 var metadataFps = (entry) => entry ? frameSetFps(entry) : null;
+function describeCharacter(spec, entry) {
+  const recorded = entry?.providerMetadata?.[entry.provider]?.character;
+  if (spec?.character) {
+    const character = spec.character;
+    return {
+      kind: character.kind,
+      parentKey: character.parentAssetId ? lockKey(spec.styleId, character.parentAssetId) : null,
+      mode: character.kind === "animation" ? character.animation.mode : character.mode,
+      directions: character.directions,
+      direction: character.animation?.direction ?? null,
+      characterId: recorded?.characterId ?? entry?.objectId?.split("#")[0] ?? null
+    };
+  }
+  if (entry?.generator === "character") {
+    const kind = recorded?.kind === "animation" || entry.outputs.some((o) => o.role?.startsWith("frame-")) ? "animation" : "base";
+    return {
+      kind,
+      parentKey: null,
+      mode: recorded?.mode ?? "standard",
+      directions: recorded?.directions ?? entry.outputs.length,
+      direction: recorded?.direction ?? null,
+      characterId: recorded?.characterId ?? entry.objectId?.split("#")[0] ?? null
+    };
+  }
+  return null;
+}
 async function fileInfo(absolutePath) {
   try {
     const info = await stat2(absolutePath);
@@ -10385,6 +10473,7 @@ async function buildGallerySnapshot(opts) {
       currentSpecHash: spec.specHash,
       revision: entry?.revision ?? null,
       revisionParentKey: spec.revision ? lockKey(spec.styleId, spec.revision.sourceAssetId) : entry?.revision ? lockKey(spec.styleId, entry.revision.sourceAssetId) : null,
+      character: describeCharacter(spec, entry),
       outputs,
       quality,
       providerMetadata: entry?.providerMetadata ?? {},
@@ -10446,6 +10535,7 @@ async function buildGallerySnapshot(opts) {
       currentSpecHash: null,
       revision: entry.revision,
       revisionParentKey: entry.revision ? lockKey(entry.styleId, entry.revision.sourceAssetId) : null,
+      character: describeCharacter(void 0, entry),
       outputs,
       quality: null,
       providerMetadata: entry.providerMetadata ?? {},
@@ -10502,6 +10592,11 @@ async function buildGallerySnapshot(opts) {
       view: style?.view ?? null,
       noBackground: style?.noBackground ?? true,
       quality: Boolean(style?.quality),
+      characters: style?.generator === "character" ? {
+        bases: styleItems.filter((item) => item.character?.kind === "base").length,
+        states: styleItems.filter((item) => item.character?.kind === "state").length,
+        animations: styleItems.filter((item) => item.character?.kind === "animation").length
+      } : null,
       tags: style?.tags ?? [],
       extends: typeof rawStyle?.extends === "string" ? rawStyle.extends : null,
       ownFields: rawStyle ? Object.keys(rawStyle).filter((key) => key !== "extends") : [],