@flamingo-stack/openframe-frontend-core 0.0.436 → 0.0.437-snapshot.20260716153430

package/dist/utils/video-bite-id.cjs

@@ -0,0 +1,37 @@
+'use strict';
+
+// src/utils/video-bite-id.ts
+var BITE_ID_RE = /^[0-9a-f]{8}$/;
+function generateBiteId() {
+  return crypto.randomUUID().replace(/-/g, "").slice(0, 8);
+}
+function ensureBiteIds(bites) {
+  const seen = /* @__PURE__ */ new Set();
+  let changed = false;
+  const out = bites.map((bite) => {
+    const valid = typeof bite.id === "string" && BITE_ID_RE.test(bite.id) && !seen.has(bite.id);
+    if (valid) {
+      seen.add(bite.id);
+      return bite;
+    }
+    changed = true;
+    let id = generateBiteId();
+    while (seen.has(id)) id = generateBiteId();
+    seen.add(id);
+    return { ...bite, id };
+  });
+  return changed ? { bites: out, changed } : { bites, changed };
+}
+function matchBiteElement(existing, incoming) {
+  if (existing.id && incoming.id && existing.id === incoming.id) return true;
+  if (incoming.url === existing.url) return true;
+  if (existing.source_url && incoming.url === existing.source_url) return true;
+  return false;
+}
+
+exports.BITE_ID_RE = BITE_ID_RE;
+exports.ensureBiteIds = ensureBiteIds;
+exports.generateBiteId = generateBiteId;
+exports.matchBiteElement = matchBiteElement;
+//# sourceMappingURL=video-bite-id.cjs.map
+//# sourceMappingURL=video-bite-id.cjs.map

package/dist/utils/video-bite-id.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/video-bite-id.ts"],"names":[],"mappings":";;;AAiBO,IAAM,UAAA,GAAa;AAGnB,SAAS,cAAA,GAAyB;AACvC,EAAA,OAAO,MAAA,CAAO,YAAW,CAAE,OAAA,CAAQ,MAAM,EAAE,CAAA,CAAE,KAAA,CAAM,CAAA,EAAG,CAAC,CAAA;AACzD;AAOO,SAAS,cAAyC,KAAA,EAAuD;AAC9G,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAY;AAC7B,EAAA,IAAI,OAAA,GAAU,KAAA;AACd,EAAA,MAAM,GAAA,GAAM,KAAA,CAAM,GAAA,CAAI,CAAA,IAAA,KAAQ;AAC5B,IAAA,MAAM,KAAA,GAAQ,OAAO,IAAA,CAAK,EAAA,KAAO,YAAY,UAAA,CAAW,IAAA,CAAK,IAAA,CAAK,EAAE,CAAA,IAAK,CAAC,IAAA,CAAK,GAAA,CAAI,KAAK,EAAE,CAAA;AAC1F,IAAA,IAAI,KAAA,EAAO;AACT,MAAA,IAAA,CAAK,GAAA,CAAI,KAAK,EAAY,CAAA;AAC1B,MAAA,OAAO,IAAA;AAAA,IACT;AACA,IAAA,OAAA,GAAU,IAAA;AACV,IAAA,IAAI,KAAK,cAAA,EAAe;AACxB,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,EAAE,CAAA,OAAQ,cAAA,EAAe;AACzC,IAAA,IAAA,CAAK,IAAI,EAAE,CAAA;AACX,IAAA,OAAO,EAAE,GAAG,IAAA,EAAM,EAAA,EAAG;AAAA,EACvB,CAAC,CAAA;AACD,EAAA,OAAO,OAAA,GAAU,EAAE,KAAA,EAAO,GAAA,EAAK,SAAQ,GAAI,EAAE,OAAqB,OAAA,EAAQ;AAC5E;AAiBO,SAAS,gBAAA,CAAiB,UAAwB,QAAA,EAAiC;AACxF,EAAA,IAAI,QAAA,CAAS,MAAM,QAAA,CAAS,EAAA,IAAM,SAAS,EAAA,KAAO,QAAA,CAAS,IAAI,OAAO,IAAA;AACtE,EAAA,IAAI,QAAA,CAAS,GAAA,KAAQ,QAAA,CAAS,GAAA,EAAK,OAAO,IAAA;AAC1C,EAAA,IAAI,SAAS,UAAA,IAAc,QAAA,CAAS,GAAA,KAAQ,QAAA,CAAS,YAAY,OAAO,IAAA;AACxE,EAAA,OAAO,KAAA;AACT","file":"video-bite-id.cjs","sourcesContent":["// Video-bite element identity — SSOT for the stable per-element `id` on\n// `video_bites` / `teasers` jsonb elements (see types/video-processing.ts\n// `VideoTeaser.id`) and for the ONE element-matching predicate shared by the\n// hub's bite writers (`saveEntityVideoBitesResult` merge + the\n// `reconcileIncomingBites` clobber guard).\n//\n// Isomorphic by design: runs in the admin editor (browser) and in the hub's\n// Mux reconciliation sweep (Node). Zero dependencies.\n\n/** Shape every matcher/stamper here operates on — the identity-relevant subset of VideoTeaser. */\nexport interface BiteIdentity {\n  id?: string\n  url: string\n  source_url?: string\n}\n\n/** 8 lowercase hex chars. Collision-safe within one array (n≤~100 → p≈1e-6); identity is always scoped to (table, row, column). */\nexport const BITE_ID_RE = /^[0-9a-f]{8}$/\n\n/** Generate a new 8-hex bite element id. */\nexport function generateBiteId(): string {\n  return crypto.randomUUID().replace(/-/g, '').slice(0, 8)\n}\n\n/**\n * Stamp missing ids and re-stamp in-array duplicates (copy/pasted bites).\n * Returns the SAME array reference when nothing changed so callers can cheaply\n * skip persistence (`changed === false` ⇒ no write needed).\n */\nexport function ensureBiteIds<T extends { id?: string }>(bites: readonly T[]): { bites: T[]; changed: boolean } {\n  const seen = new Set<string>()\n  let changed = false\n  const out = bites.map(bite => {\n    const valid = typeof bite.id === 'string' && BITE_ID_RE.test(bite.id) && !seen.has(bite.id)\n    if (valid) {\n      seen.add(bite.id as string)\n      return bite\n    }\n    changed = true\n    let id = generateBiteId()\n    while (seen.has(id)) id = generateBiteId()\n    seen.add(id)\n    return { ...bite, id }\n  })\n  return changed ? { bites: out, changed } : { bites: bites as T[], changed }\n}\n\n/**\n * The ONE element-identity predicate. Matching legs (any-of, NOT\n * short-circuit-on-id-inequality — two sides can carry DIFFERENT ids for\n * the same clip, e.g. a redelivered Vizard ingest regenerates ids):\n *   1. `id` equality — when both sides carry one and they match.\n *   2. `incoming.url === existing.url` — plain url (pre-flip stale sessions,\n *      plain re-saves).\n *   3. `incoming.url === existing.source_url` — the incoming side still holds\n *      the original storage URL of an element the Mux pipeline already flipped\n *      to HLS (redelivered ingests, stale editor arrays).\n *\n * Callers that match a whole incoming array against an existing array MUST\n * consume each existing element at most once (multiset matching) — duplicate\n * incoming urls must not all bind to one element and clone its id.\n */\nexport function matchBiteElement(existing: BiteIdentity, incoming: BiteIdentity): boolean {\n  if (existing.id && incoming.id && existing.id === incoming.id) return true\n  if (incoming.url === existing.url) return true\n  if (existing.source_url && incoming.url === existing.source_url) return true\n  return false\n}\n"]}

package/dist/utils/video-bite-id.d.ts

@@ -0,0 +1,38 @@
+/** Shape every matcher/stamper here operates on — the identity-relevant subset of VideoTeaser. */
+export interface BiteIdentity {
+    id?: string;
+    url: string;
+    source_url?: string;
+}
+/** 8 lowercase hex chars. Collision-safe within one array (n≤~100 → p≈1e-6); identity is always scoped to (table, row, column). */
+export declare const BITE_ID_RE: RegExp;
+/** Generate a new 8-hex bite element id. */
+export declare function generateBiteId(): string;
+/**
+ * Stamp missing ids and re-stamp in-array duplicates (copy/pasted bites).
+ * Returns the SAME array reference when nothing changed so callers can cheaply
+ * skip persistence (`changed === false` ⇒ no write needed).
+ */
+export declare function ensureBiteIds<T extends {
+    id?: string;
+}>(bites: readonly T[]): {
+    bites: T[];
+    changed: boolean;
+};
+/**
+ * The ONE element-identity predicate. Matching legs (any-of, NOT
+ * short-circuit-on-id-inequality — two sides can carry DIFFERENT ids for
+ * the same clip, e.g. a redelivered Vizard ingest regenerates ids):
+ *   1. `id` equality — when both sides carry one and they match.
+ *   2. `incoming.url === existing.url` — plain url (pre-flip stale sessions,
+ *      plain re-saves).
+ *   3. `incoming.url === existing.source_url` — the incoming side still holds
+ *      the original storage URL of an element the Mux pipeline already flipped
+ *      to HLS (redelivered ingests, stale editor arrays).
+ *
+ * Callers that match a whole incoming array against an existing array MUST
+ * consume each existing element at most once (multiset matching) — duplicate
+ * incoming urls must not all bind to one element and clone its id.
+ */
+export declare function matchBiteElement(existing: BiteIdentity, incoming: BiteIdentity): boolean;
+//# sourceMappingURL=video-bite-id.d.ts.map

package/dist/utils/video-bite-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-bite-id.d.ts","sourceRoot":"","sources":["../../src/utils/video-bite-id.ts"],"names":[],"mappings":"AASA,kGAAkG;AAClG,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,mIAAmI;AACnI,eAAO,MAAM,UAAU,QAAkB,CAAA;AAEzC,4CAA4C;AAC5C,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAgB9G;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAKxF"}

package/dist/utils/video-bite-id.js

@@ -0,0 +1,32 @@
+// src/utils/video-bite-id.ts
+var BITE_ID_RE = /^[0-9a-f]{8}$/;
+function generateBiteId() {
+  return crypto.randomUUID().replace(/-/g, "").slice(0, 8);
+}
+function ensureBiteIds(bites) {
+  const seen = /* @__PURE__ */ new Set();
+  let changed = false;
+  const out = bites.map((bite) => {
+    const valid = typeof bite.id === "string" && BITE_ID_RE.test(bite.id) && !seen.has(bite.id);
+    if (valid) {
+      seen.add(bite.id);
+      return bite;
+    }
+    changed = true;
+    let id = generateBiteId();
+    while (seen.has(id)) id = generateBiteId();
+    seen.add(id);
+    return { ...bite, id };
+  });
+  return changed ? { bites: out, changed } : { bites, changed };
+}
+function matchBiteElement(existing, incoming) {
+  if (existing.id && incoming.id && existing.id === incoming.id) return true;
+  if (incoming.url === existing.url) return true;
+  if (existing.source_url && incoming.url === existing.source_url) return true;
+  return false;
+}
+
+export { BITE_ID_RE, ensureBiteIds, generateBiteId, matchBiteElement };
+//# sourceMappingURL=video-bite-id.js.map
+//# sourceMappingURL=video-bite-id.js.map

package/dist/utils/video-bite-id.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/video-bite-id.ts"],"names":[],"mappings":";AAiBO,IAAM,UAAA,GAAa;AAGnB,SAAS,cAAA,GAAyB;AACvC,EAAA,OAAO,MAAA,CAAO,YAAW,CAAE,OAAA,CAAQ,MAAM,EAAE,CAAA,CAAE,KAAA,CAAM,CAAA,EAAG,CAAC,CAAA;AACzD;AAOO,SAAS,cAAyC,KAAA,EAAuD;AAC9G,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAY;AAC7B,EAAA,IAAI,OAAA,GAAU,KAAA;AACd,EAAA,MAAM,GAAA,GAAM,KAAA,CAAM,GAAA,CAAI,CAAA,IAAA,KAAQ;AAC5B,IAAA,MAAM,KAAA,GAAQ,OAAO,IAAA,CAAK,EAAA,KAAO,YAAY,UAAA,CAAW,IAAA,CAAK,IAAA,CAAK,EAAE,CAAA,IAAK,CAAC,IAAA,CAAK,GAAA,CAAI,KAAK,EAAE,CAAA;AAC1F,IAAA,IAAI,KAAA,EAAO;AACT,MAAA,IAAA,CAAK,GAAA,CAAI,KAAK,EAAY,CAAA;AAC1B,MAAA,OAAO,IAAA;AAAA,IACT;AACA,IAAA,OAAA,GAAU,IAAA;AACV,IAAA,IAAI,KAAK,cAAA,EAAe;AACxB,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,EAAE,CAAA,OAAQ,cAAA,EAAe;AACzC,IAAA,IAAA,CAAK,IAAI,EAAE,CAAA;AACX,IAAA,OAAO,EAAE,GAAG,IAAA,EAAM,EAAA,EAAG;AAAA,EACvB,CAAC,CAAA;AACD,EAAA,OAAO,OAAA,GAAU,EAAE,KAAA,EAAO,GAAA,EAAK,SAAQ,GAAI,EAAE,OAAqB,OAAA,EAAQ;AAC5E;AAiBO,SAAS,gBAAA,CAAiB,UAAwB,QAAA,EAAiC;AACxF,EAAA,IAAI,QAAA,CAAS,MAAM,QAAA,CAAS,EAAA,IAAM,SAAS,EAAA,KAAO,QAAA,CAAS,IAAI,OAAO,IAAA;AACtE,EAAA,IAAI,QAAA,CAAS,GAAA,KAAQ,QAAA,CAAS,GAAA,EAAK,OAAO,IAAA;AAC1C,EAAA,IAAI,SAAS,UAAA,IAAc,QAAA,CAAS,GAAA,KAAQ,QAAA,CAAS,YAAY,OAAO,IAAA;AACxE,EAAA,OAAO,KAAA;AACT","file":"video-bite-id.js","sourcesContent":["// Video-bite element identity — SSOT for the stable per-element `id` on\n// `video_bites` / `teasers` jsonb elements (see types/video-processing.ts\n// `VideoTeaser.id`) and for the ONE element-matching predicate shared by the\n// hub's bite writers (`saveEntityVideoBitesResult` merge + the\n// `reconcileIncomingBites` clobber guard).\n//\n// Isomorphic by design: runs in the admin editor (browser) and in the hub's\n// Mux reconciliation sweep (Node). Zero dependencies.\n\n/** Shape every matcher/stamper here operates on — the identity-relevant subset of VideoTeaser. */\nexport interface BiteIdentity {\n  id?: string\n  url: string\n  source_url?: string\n}\n\n/** 8 lowercase hex chars. Collision-safe within one array (n≤~100 → p≈1e-6); identity is always scoped to (table, row, column). */\nexport const BITE_ID_RE = /^[0-9a-f]{8}$/\n\n/** Generate a new 8-hex bite element id. */\nexport function generateBiteId(): string {\n  return crypto.randomUUID().replace(/-/g, '').slice(0, 8)\n}\n\n/**\n * Stamp missing ids and re-stamp in-array duplicates (copy/pasted bites).\n * Returns the SAME array reference when nothing changed so callers can cheaply\n * skip persistence (`changed === false` ⇒ no write needed).\n */\nexport function ensureBiteIds<T extends { id?: string }>(bites: readonly T[]): { bites: T[]; changed: boolean } {\n  const seen = new Set<string>()\n  let changed = false\n  const out = bites.map(bite => {\n    const valid = typeof bite.id === 'string' && BITE_ID_RE.test(bite.id) && !seen.has(bite.id)\n    if (valid) {\n      seen.add(bite.id as string)\n      return bite\n    }\n    changed = true\n    let id = generateBiteId()\n    while (seen.has(id)) id = generateBiteId()\n    seen.add(id)\n    return { ...bite, id }\n  })\n  return changed ? { bites: out, changed } : { bites: bites as T[], changed }\n}\n\n/**\n * The ONE element-identity predicate. Matching legs (any-of, NOT\n * short-circuit-on-id-inequality — two sides can carry DIFFERENT ids for\n * the same clip, e.g. a redelivered Vizard ingest regenerates ids):\n *   1. `id` equality — when both sides carry one and they match.\n *   2. `incoming.url === existing.url` — plain url (pre-flip stale sessions,\n *      plain re-saves).\n *   3. `incoming.url === existing.source_url` — the incoming side still holds\n *      the original storage URL of an element the Mux pipeline already flipped\n *      to HLS (redelivered ingests, stale editor arrays).\n *\n * Callers that match a whole incoming array against an existing array MUST\n * consume each existing element at most once (multiset matching) — duplicate\n * incoming urls must not all bind to one element and clone its id.\n */\nexport function matchBiteElement(existing: BiteIdentity, incoming: BiteIdentity): boolean {\n  if (existing.id && incoming.id && existing.id === incoming.id) return true\n  if (incoming.url === existing.url) return true\n  if (existing.source_url && incoming.url === existing.source_url) return true\n  return false\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flamingo-stack/openframe-frontend-core",
-  "version": "0.0.436",
+  "version": "0.0.437-snapshot.20260716153430",
   "description": "Shared design system and components for all Flamingo platforms",
   "type": "module",
   "main": "./dist/index.js",
@@ -198,6 +198,12 @@
       "require": "./dist/utils/humanity-signals.cjs",
       "default": "./dist/utils/humanity-signals.js"
     },
+    "./utils/video-bite-id": {
+      "types": "./dist/utils/video-bite-id.d.ts",
+      "import": "./dist/utils/video-bite-id.js",
+      "require": "./dist/utils/video-bite-id.cjs",
+      "default": "./dist/utils/video-bite-id.js"
+    },
     "./styles": {
       "types": "./src/styles/index.d.ts",
       "import": "./src/styles/index.css",

package/src/components/chat/guide-welcome.tsx

@@ -196,13 +196,13 @@ export function GuideWelcome({
           `ChatQuickActionRow` in `wrap` mode: ALL chips render (no "⋯" overflow
           collapse) so every action is directly hoverable; hover/focus previews
           the action's full prompt in the composer, click sends it. Capped height
-          + internal scroll so a long (host/admin-driven) list can't grow the
-          pinned area without bound and squeeze the composer on short screens. */}
+          + internal scroll (scrollbar-hide: scrollable, bar never shows) so a
+          long list can't squeeze the composer on short screens. */}
       {quickActions.length > 0 && (
         <ChatQuickActionRow
           wrap
           chips={chipItems}
-          className="max-h-28 overflow-y-auto scrollbar-thin scrollbar-track-transparent scrollbar-thumb-ods-border/30"
+          className="max-h-28 overflow-y-auto scrollbar-hide"
         />
       )}
     </div>

package/src/components/ui/tab-navigation.tsx

@@ -214,7 +214,8 @@ export function TabNavigation({
   return (
     <>
       <div className={cn("relative w-full", className)}>
-        <div ref={scrollRef} className="flex gap-[var(--spacing-system-xxs)] items-center justify-start h-full overflow-x-auto overflow-y-hidden">
+        {/* scrollbar-hide: tabs stay swipe/wheel-scrollable, bar never shows */}
+        <div ref={scrollRef} className="flex gap-[var(--spacing-system-xxs)] items-center justify-start h-full overflow-x-auto overflow-y-hidden scrollbar-hide">
           {tabs.map((tab) => {
             const isActive = activeTab === tab.id
 

package/src/styles/app-globals.css

@@ -3,37 +3,12 @@
   @apply border-border;
 }
 
-/* Elevator scrollbar, Firefox fallback. Scoped via @supports because
-   scrollbar-width/color would disable ::-webkit-scrollbar styling in Chrome */
-@supports not selector(::-webkit-scrollbar) {
-  * {
-    scrollbar-width: thin;
-    scrollbar-color: var(--ods-system-greys-grey) var(--ods-system-greys-soft-grey);
-  }
-}
-
-/* Elevator scrollbar (ODS): 8px track + draggable rounded thumb */
-*::-webkit-scrollbar {
-  width: 8px;
-  height: 8px;
-}
-
-*::-webkit-scrollbar-track {
-  background-color: var(--ods-system-greys-soft-grey);
-  border-radius: 4px;
-}
-
-*::-webkit-scrollbar-thumb {
-  background-color: var(--ods-system-greys-grey);
-  border-radius: 4px;
-}
-
-*::-webkit-scrollbar-thumb:hover {
-  background-color: var(--ods-system-greys-grey-hover);
-}
-
-*::-webkit-scrollbar-corner {
-  background-color: transparent;
+/* Elevator scrollbar (ODS): thin grey draggable thumb on a transparent track.
+   Standard properties only — no ::-webkit-scrollbar, so the platform keeps its
+   native rendering mode (e.g. auto-hiding overlay scrollbars on macOS). */
+* {
+  scrollbar-width: thin;
+  scrollbar-color: var(--ods-system-greys-grey) transparent;
 }
 
 body {
@@ -76,6 +51,12 @@ html {
      can't re-enable it for an ancestor scroll container. The self-driven rAF
      tween in scroll-into-view.ts is the primary fix; this is belt-and-braces. */
   overflow-anchor: none;
+  /* Reserve the scrollbar gutter permanently (classic scrollbars only — on
+     macOS overlay scrollbars this is a no-op). When a Drawer/Dialog locks the
+     page with `overflow: hidden`, the gutter stays reserved (per spec `stable`
+     applies to hidden too), so the content never shifts when the scrollbar
+     comes and goes. Pairs with the `data-scroll-locked` override below. */
+  scrollbar-gutter: stable;
 }
 
 body {
@@ -84,6 +65,18 @@ body {
   overflow-anchor: none;
 }
 
+/* Radix Dialog/Drawer scroll-lock (react-remove-scroll-bar) compensates for
+   the disappearing scrollbar by injecting
+   `body[data-scroll-locked] { margin-right: <gap>px !important }`.
+   With `scrollbar-gutter: stable` above, the scrollbar space never collapses,
+   so that compensation is no longer needed — it becomes the layout shift
+   itself (and it never fixed `position: fixed` chrome like the header anyway).
+   The doubled attribute selector out-specifies the injected rule (0,2,1 vs
+   0,1,1) so our `!important` wins. */
+body[data-scroll-locked][data-scroll-locked] {
+  margin-right: 0 !important;
+}
+
 /* Light mode specific styles (used in alternatives-list.tsx) */
 :root:not(.dark) .light-mode-shadow {
   box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1), 0 1px 2px rgba(0, 0, 0, 0.06);

package/src/types/video-processing.ts

@@ -12,7 +12,9 @@
  * below stays a separate shape by design.
  */
 export interface VideoTeaser {
+  id?: string // Stable 8-char lowercase-hex element id (see utils/video-bite-id.ts). Stamped at creation (editor + AI save) and lazily backfilled by the Mux reconciliation sweep. Identity key for the Mux transcode pipeline — never derived from url (urls have real-world duplicates).
   url: string
+  source_url?: string // Original storage URL, set by the Mux pipeline when it flips `url` to the HLS playback URL. Merge-identity leg for redelivered ingests + transcode dedup. Never set by editors.
   title?: string
   thumbnail_url?: string // Optional thumbnail image URL for video preview. If not provided, video player will show first frame automatically.
   published?: boolean // Controls visibility on public preview page (default: false, admin must select)

package/src/utils/index.ts

@@ -76,6 +76,9 @@ export { getPlatformIconComponent as getPlatformLogo } from './platform-config'
 export * from './tool-utils'
 // Shell type utilities
 export * from './shell-utils'
+// Video-bite element identity (id stamping + the ONE matching predicate) —
+// isomorphic; used by the admin bites editor AND the hub's Mux sweep/writers.
+export * from './video-bite-id'
 // OS type utilities
 export * from './os-utils'
 // Phone utilities

package/src/utils/video-bite-id.ts

@@ -0,0 +1,68 @@
+// Video-bite element identity — SSOT for the stable per-element `id` on
+// `video_bites` / `teasers` jsonb elements (see types/video-processing.ts
+// `VideoTeaser.id`) and for the ONE element-matching predicate shared by the
+// hub's bite writers (`saveEntityVideoBitesResult` merge + the
+// `reconcileIncomingBites` clobber guard).
+//
+// Isomorphic by design: runs in the admin editor (browser) and in the hub's
+// Mux reconciliation sweep (Node). Zero dependencies.
+
+/** Shape every matcher/stamper here operates on — the identity-relevant subset of VideoTeaser. */
+export interface BiteIdentity {
+  id?: string
+  url: string
+  source_url?: string
+}
+
+/** 8 lowercase hex chars. Collision-safe within one array (n≤~100 → p≈1e-6); identity is always scoped to (table, row, column). */
+export const BITE_ID_RE = /^[0-9a-f]{8}$/
+
+/** Generate a new 8-hex bite element id. */
+export function generateBiteId(): string {
+  return crypto.randomUUID().replace(/-/g, '').slice(0, 8)
+}
+
+/**
+ * Stamp missing ids and re-stamp in-array duplicates (copy/pasted bites).
+ * Returns the SAME array reference when nothing changed so callers can cheaply
+ * skip persistence (`changed === false` ⇒ no write needed).
+ */
+export function ensureBiteIds<T extends { id?: string }>(bites: readonly T[]): { bites: T[]; changed: boolean } {
+  const seen = new Set<string>()
+  let changed = false
+  const out = bites.map(bite => {
+    const valid = typeof bite.id === 'string' && BITE_ID_RE.test(bite.id) && !seen.has(bite.id)
+    if (valid) {
+      seen.add(bite.id as string)
+      return bite
+    }
+    changed = true
+    let id = generateBiteId()
+    while (seen.has(id)) id = generateBiteId()
+    seen.add(id)
+    return { ...bite, id }
+  })
+  return changed ? { bites: out, changed } : { bites: bites as T[], changed }
+}
+
+/**
+ * The ONE element-identity predicate. Matching legs (any-of, NOT
+ * short-circuit-on-id-inequality — two sides can carry DIFFERENT ids for
+ * the same clip, e.g. a redelivered Vizard ingest regenerates ids):
+ *   1. `id` equality — when both sides carry one and they match.
+ *   2. `incoming.url === existing.url` — plain url (pre-flip stale sessions,
+ *      plain re-saves).
+ *   3. `incoming.url === existing.source_url` — the incoming side still holds
+ *      the original storage URL of an element the Mux pipeline already flipped
+ *      to HLS (redelivered ingests, stale editor arrays).
+ *
+ * Callers that match a whole incoming array against an existing array MUST
+ * consume each existing element at most once (multiset matching) — duplicate
+ * incoming urls must not all bind to one element and clone its id.
+ */
+export function matchBiteElement(existing: BiteIdentity, incoming: BiteIdentity): boolean {
+  if (existing.id && incoming.id && existing.id === incoming.id) return true
+  if (incoming.url === existing.url) return true
+  if (existing.source_url && incoming.url === existing.source_url) return true
+  return false
+}