@shop-os/modelkit 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -9,6 +9,14 @@ header in the release PR.
 
 ## [Unreleased]
 
+## [0.2.3] - 2026-09-15
+
+### Changed
+- `display.sortOrder` sorts descending: a higher number shows first, so a new model takes the next number up. No published row set it before.
+
+### Fixed
+- `primeCatalog` treats a remote response with zero rows as a failure and keeps the last-good or snapshot rows, so a pro-backend whose catalog table is not seeded yet cannot empty every consumer's pickers.
+
 ## [0.2.2] - 2026-09-15
 
 Option audit against provider docs, limited to options a product surface sets.

package/dist/catalog.cjs

@@ -164,6 +164,12 @@ var GEMINI_RATIOS = [
   "adaptive"
 ];
 function geminiImage(id, label, aliases, sizes, display, exposure, references) {
+  const constraints = {
+    aspectRatios: [...GEMINI_RATIOS],
+    sizes,
+    supports: ["safetySettings", "temperature"]
+  };
+  if (references !== void 0) constraints.references = references;
   const model = {
     id,
     aliases,
@@ -173,12 +179,7 @@ function geminiImage(id, label, aliases, sizes, display, exposure, references) {
     providerModelId: id,
     lifecycle: "active",
     exposure,
-    constraints: {
-      aspectRatios: [...GEMINI_RATIOS],
-      sizes,
-      supports: ["safetySettings", "temperature"],
-      ...references ? { references } : {}
-    },
+    constraints,
     defaults: { size: "1K", aspectRatio: "1:1" },
     usage: { ...IMAGE_USAGE, slug: "gemini" },
     pricingKind: "image_size",
@@ -305,6 +306,7 @@ var IMAGE_MODELS = [
     pricingKind: "image_size",
     display: {
       provider: "openai",
+      sortOrder: 20,
       description: "OpenAI's most capable GPT Image 2.5 tier, built for editing precision; takes text and image input and outputs images in low, medium, high, xhigh, or max quality."
     }
   },
@@ -339,6 +341,7 @@ var IMAGE_MODELS = [
     pricingKind: "image_size",
     display: {
       provider: "openai",
+      sortOrder: 10,
       description: "OpenAI's fastest GPT Image 2.5 tier for high-quality everyday image generation and editing; takes text and image input and outputs images."
     }
   },
@@ -2079,23 +2082,22 @@ var liveState = store[KEY] ??= {
 var liveCatalog = liveState.catalog;
 
 // src/catalog/load.ts
+var import_zod2 = require("zod");
 function rowCount() {
   return liveCatalog.list({ lifecycle: ["active", "deprecated", "retired"] }).length;
 }
 function authHeaders(auth) {
   return "bearer" in auth ? { Authorization: `Bearer ${auth.bearer}` } : { "x-api-key": auth.apiKey };
 }
-function describeError(err) {
-  return err instanceof Error ? err.message : String(err);
-}
-function parseEnvelope(json) {
-  if (typeof json !== "object" || json === null || !("rows" in json)) {
-    throw new Error("invalid catalog response: missing rows");
-  }
-  const rows = CatalogSchema.parse(json.rows);
-  const rev = json.revision;
-  if (typeof rev === "string") return { rows, revision: rev };
-  return { rows };
+var EnvelopeSchema = import_zod2.z.object({
+  rows: CatalogSchema,
+  revision: import_zod2.z.string().optional()
+});
+function toEnvelope(data) {
+  if (data.rows.length === 0) throw new Error("invalid catalog response: no rows");
+  const envelope = { rows: data.rows };
+  if (data.revision !== void 0) envelope.revision = data.revision;
+  return envelope;
 }
 function logPrimed(logger, result) {
   const { origin: loggedOrigin, rowCount: loggedCount, revision: loggedRevision } = result;
@@ -2116,7 +2118,9 @@ async function fetchRemote(source, logger) {
   if (res.status === 304) return { kept: true };
   if (!res.ok) throw new Error(`catalog fetch failed with status ${res.status}`);
   const json = await res.json();
-  const { rows, revision: rev } = parseEnvelope(json);
+  const parsed = EnvelopeSchema.safeParse(json);
+  if (!parsed.success) throw new Error("invalid catalog response: missing rows");
+  const { rows, revision: rev } = toEnvelope(parsed.data);
   if (rev === void 0) return { rows, fromCache: false };
   return { rows, revision: rev, fromCache: false };
 }
@@ -2147,11 +2151,13 @@ async function prime(source, logger) {
     return result;
   } catch (err) {
     logger.warn("[modelkit] catalog remote failed, trying cache", err);
-    const error = describeError(err);
+    const error = err instanceof Error ? err.message : String(err);
     try {
       const cached = await source.cache?.get();
       if (!cached) throw new Error("no cached catalog");
-      const { rows, revision: rev } = parseEnvelope(JSON.parse(cached));
+      const cachedParsed = EnvelopeSchema.safeParse(JSON.parse(cached));
+      if (!cachedParsed.success) throw new Error("invalid catalog response: missing rows");
+      const { rows, revision: rev } = toEnvelope(cachedParsed.data);
       liveCatalog.replace(rows);
       liveState.origin = "last-good";
       liveState.revision = rev;
@@ -2191,19 +2197,18 @@ async function refresh(source, logger) {
   }
 }
 function primeCatalog(source) {
-  const memo = liveState.memo;
-  if (memo) return memo;
+  if (liveState.memo) return liveState.memo;
   const logger = source.logger ?? console;
-  liveState.memo = prime(source, logger).then((result) => {
+  const pending = prime(source, logger).then((result) => {
     const ttlMs = source.ttlMs ?? 3e5;
     if (ttlMs > 0 && liveState.timer === void 0) {
       liveState.timer = setInterval(() => void refresh(source, logger), ttlMs);
-      const maybeUnref = liveState.timer;
-      maybeUnref.unref?.();
+      liveState.timer.unref?.();
     }
     return result;
   });
-  return liveState.memo;
+  liveState.memo = pending;
+  return pending;
 }
 function resetLiveCatalog() {
   if (liveState.timer !== void 0) {