@flamingo-stack/openframe-frontend-core 0.0.239 → 0.0.241

package/dist/types/content-ref.d.ts

@@ -0,0 +1,35 @@
+/**
+ * ContentRef — the unified link/embed shape stored in JSONB columns
+ * across investor updates, performance baselines, and any other entity
+ * that surfaces "related content" rails.
+ *
+ * Lifted from `lib/data/investor-update-utils-shared.ts` in the hub
+ * (the server-side data utils in the same file stay hub-side; only the
+ * TYPE moves here). RELOCATED from `components/chat/types/entities/`
+ * to this server-safe home when `RelatedContentSection` moved into the
+ * lib — the chat path re-exports from here, so there is exactly ONE
+ * `ContentRef` definition package-wide.
+ */
+export interface ContentRef {
+    type: string;
+    id: string;
+    slug: string;
+    url: string;
+    targetPlatform?: string | null;
+    title: string;
+    summary?: string;
+    image_url?: string;
+    image_bg_color?: string;
+    visibility: 'public' | 'internal';
+    display_order: number;
+}
+/**
+ * A ContentRef as returned by the suggestion service (`/api/related-content`)
+ * — carries the 5-tier engine's placement reason. Widened to `string` here
+ * (the narrow reason union is hub-server vocabulary); data-only, never
+ * rendered by the rail.
+ */
+export type ContentRefWithReason = ContentRef & {
+    reason: string;
+};
+//# sourceMappingURL=content-ref.d.ts.map

package/dist/types/content-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-ref.d.ts","sourceRoot":"","sources":["../../src/types/content-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,QAAQ,GAAG,UAAU,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types/index.d.ts

@@ -22,6 +22,7 @@ export * from './user';
 export * from './slack';
 export * from './waitlist';
 export * from './faq';
+export * from './content-ref';
 export * from './report';
 export * from './stack';
 export * from './navigation';

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAA;AAC9B,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACtF,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,IAAI,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAGjK,cAAc,YAAY,CAAA;AAG1B,cAAc,QAAQ,CAAA;AAGtB,cAAc,QAAQ,CAAA;AACtB,cAAc,cAAc,CAAA;AAC5B,cAAc,sBAAsB,CAAA;AACpC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,QAAQ,CAAA;AACtB,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAGlC,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA;AAGtB,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAG1B,cAAc,OAAO,CAAA;AACrB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AAGvB,cAAc,cAAc,CAAA;AAG5B,cAAc,cAAc,CAAA;AAG5B,cAAc,eAAe,CAAA;AAG7B,cAAc,YAAY,CAAA;AAG1B,cAAc,aAAa,CAAA;AAE3B,cAAc,uBAAuB,CAAA;AACrC,cAAc,SAAS,CAAA;AACvB,cAAc,eAAe,CAAA;AAC7B,cAAc,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAA;AAC9B,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACtF,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,IAAI,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAGjK,cAAc,YAAY,CAAA;AAG1B,cAAc,QAAQ,CAAA;AAGtB,cAAc,QAAQ,CAAA;AACtB,cAAc,cAAc,CAAA;AAC5B,cAAc,sBAAsB,CAAA;AACpC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,QAAQ,CAAA;AACtB,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAGlC,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA;AAGtB,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAG1B,cAAc,OAAO,CAAA;AACrB,cAAc,eAAe,CAAA;AAC7B,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AAGvB,cAAc,cAAc,CAAA;AAG5B,cAAc,cAAc,CAAA;AAG5B,cAAc,eAAe,CAAA;AAG7B,cAAc,YAAY,CAAA;AAG1B,cAAc,aAAa,CAAA;AAE3B,cAAc,uBAAuB,CAAA;AACrC,cAAc,SAAS,CAAA;AACvB,cAAc,eAAe,CAAA;AAC7B,cAAc,QAAQ,CAAA"}

package/dist/utils/content-ref-groups.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Content Ref Group Configuration
+ *
+ * Single source of truth for grouping content_refs by type. Used by both:
+ *  - components/related-content (detail page rail — lives in this lib)
+ *  - the hub's lib/utils/investor-email-utils.ts (email builder, via the
+ *    hub's re-export shim at lib/config/content-ref-groups.ts)
+ *
+ * Lives in utils/ (server-safe tsup block) so hub server-side code can
+ * import it.
+ *
+ * Each entry carries the metadata RelatedContentSection needs to render the
+ * group WITHOUT re-implementing per-type logic locally:
+ *   - `label`: section heading.
+ *   - `order`: source-stable ordering (lowest first).
+ *   - `layout`: 'list' (one-per-row, full-width cards) or 'grid' (responsive
+ *     column grid).
+ *   - `gridSize`: card-size variant passed to the per-type card dispatch.
+ *     `'lg'` matches the canonical large-card variant openframe + flamingo
+ *     apps already use; `'default'` is the legacy denser variant. New types
+ *     should pick `'lg'` whenever the card has a large variant.
+ *
+ * Adding a new content type = one entry here. RelatedContentSection picks up
+ * the new group automatically (no hardcoded set to update). NOTE: the hub's
+ * related-content SUGGESTION candidate list is DERIVED from these keys (minus
+ * an explicit exclusion knob) — a new entry here becomes a suggestion
+ * candidate iff it also resolves through the hub's TYPE_TO_ENTITY → RAG
+ * config chain (unresolvable entries are dropped loudly at module load).
+ */
+export type ContentRefLayout = 'list' | 'grid';
+/** Subset of `EntityCardSize` (entity-card dispatch) appropriate for
+ *  grid/list rendering in RelatedContentSection. Duplicated as a literal
+ *  union here to avoid a config→component import cycle. Kept in lockstep
+ *  with `EntityCardSize`; widen here when a new size is added there. */
+export type ContentRefGridSize = 'lg' | 'default' | 'sm';
+export interface ContentRefGroupConfig {
+    label: string;
+    order: number;
+    layout: ContentRefLayout;
+    gridSize: ContentRefGridSize;
+}
+export declare const CONTENT_REF_GROUPS: Record<string, ContentRefGroupConfig>;
+/** Human-readable label for a content_ref `type`. Returns null when the type
+ *  isn't registered — caller decides the fallback. Use `getContentRefLabelOrTitleCase`
+ *  to get a consistent title-cased fallback across all surfaces. */
+export declare function getContentRefLabel(type: string): string | null;
+/** Resolved label with a single shared fallback shape — title-cased version
+ *  of the raw type string for any unregistered type. Both RelatedContentSection
+ *  AND the investor-email builder consume this so cross-surface label rendering
+ *  for unregistered types is identical (no drift between "podcast guest" and
+ *  "Podcast Guest"). */
+export declare function getContentRefLabelOrTitleCase(type: string): string;
+/** Sort a set of present content_ref types into the canonical group order
+ *  (registered types first in CONTENT_REF_GROUPS `order`, then unregistered
+ *  types appended in insertion order). Used by RelatedContentSection AND the
+ *  investor-email builder so cross-surface ordering stays identical. */
+export declare function orderContentRefTypes(present: Iterable<string>): string[];
+//# sourceMappingURL=content-ref-groups.d.ts.map

package/dist/utils/content-ref-groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-ref-groups.d.ts","sourceRoot":"","sources":["../../src/utils/content-ref-groups.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAAA;AAE9C;;;wEAGwE;AACxE,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAA;AAExD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,gBAAgB,CAAA;IACxB,QAAQ,EAAE,kBAAkB,CAAA;CAC7B;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAUpE,CAAA;AAED;;oEAEoE;AACpE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE9D;AAED;;;;wBAIwB;AACxB,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED;;;wEAGwE;AACxE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAQxE"}

package/dist/utils/extract-items.d.ts

@@ -0,0 +1,18 @@
+/**
+ * List-API response normalizers — HOISTED from
+ * `components/chat/hooks/use-chat-card-item.ts` (private copies) so the
+ * related-content rail can import them WITHOUT touching the chat hooks
+ * chunk (which reaches `@tanstack/react-query`). Pure + server-safe.
+ *
+ * The hub's `lib/utils/entity-list-api.ts` re-exports these — one
+ * implementation of response-shape normalization across both repos.
+ */
+/** Extract the items array from each endpoint's response shape (some
+ *  return `{ items }`, others `{ posts }`, etc.). Single normalization
+ *  point — callers always read `Item[]`. */
+export declare function extractItems(data: unknown): unknown[];
+/** Extract a stable id from a fetched item — different shapes use
+ *  `id` vs `external_id`. Used by the chat loader to match the fetched
+ *  array element back to the marker's id. */
+export declare function extractItemId(type: string, item: unknown): string | null;
+//# sourceMappingURL=extract-items.d.ts.map

package/dist/utils/extract-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-items.d.ts","sourceRoot":"","sources":["../../src/utils/extract-items.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;4CAE4C;AAC5C,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,EAAE,CAerD;AAED;;6CAE6C;AAC7C,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAcxE"}

package/dist/utils/index.cjs

@@ -3290,6 +3290,9 @@ function scrollElementIntoView(target, options = {}) {
 
 // src/utils/list-url.ts
 var ALIASES = { blog_post_existing: "blog_post" };
+function canonicalContentRefType(contentRefType) {
+  return ALIASES[contentRefType] ?? contentRefType;
+}
 var BUILDERS = {
   roadmap_item: (ids, b) => `${b}/api/roadmap?task_ids=${ids.join(",")}`,
   delivery_item: (ids, b) => `${b}/api/delivery?task_ids=${ids.join(",")}`,
@@ -3314,6 +3317,76 @@ function buildListUrl(contentRefType, ids, base = "") {
   return fn ? fn(ids, base) : null;
 }
 
+// src/utils/content-ref-groups.ts
+var CONTENT_REF_GROUPS = {
+  investor_update: { label: "Investor Updates", order: 1, layout: "grid", gridSize: "default" },
+  product_release: { label: "Product Releases", order: 2, layout: "list", gridSize: "lg" },
+  podcast: { label: "Podcasts", order: 3, layout: "list", gridSize: "default" },
+  webinar: { label: "Webinars", order: 4, layout: "list", gridSize: "default" },
+  case_study: { label: "Case Studies", order: 5, layout: "grid", gridSize: "default" },
+  event: { label: "Events", order: 6, layout: "list", gridSize: "default" },
+  blog_post_existing: { label: "Blog Posts", order: 7, layout: "grid", gridSize: "default" },
+  customer_interview: { label: "Customer Interviews", order: 8, layout: "grid", gridSize: "default" },
+  onboarding_guide: { label: "Onboarding Guides", order: 9, layout: "grid", gridSize: "default" }
+};
+function getContentRefLabel(type) {
+  return CONTENT_REF_GROUPS[type]?.label ?? null;
+}
+function getContentRefLabelOrTitleCase(type) {
+  return CONTENT_REF_GROUPS[type]?.label ?? type.replace(/_/g, " ").replace(/\b\w/g, (ch) => ch.toUpperCase());
+}
+function orderContentRefTypes(present) {
+  const presentSet = new Set(present);
+  const registeredInOrder = Object.entries(CONTENT_REF_GROUPS).sort(([, a], [, b]) => a.order - b.order).map(([type]) => type).filter((type) => presentSet.has(type));
+  const unregistered = [...presentSet].filter((type) => !CONTENT_REF_GROUPS[type]);
+  return [...registeredInOrder, ...unregistered];
+}
+
+// src/utils/extract-items.ts
+function extractItems(data) {
+  if (!data || typeof data !== "object") return [];
+  const obj = data;
+  if (Array.isArray(obj.items)) return obj.items;
+  if (Array.isArray(obj.posts)) return obj.posts;
+  if (Array.isArray(obj.campaigns)) return obj.campaigns;
+  if (Array.isArray(obj.completed) || Array.isArray(obj.inProgress)) {
+    const completed = Array.isArray(obj.completed) ? obj.completed : [];
+    const inProgress = Array.isArray(obj.inProgress) ? obj.inProgress : [];
+    return [...completed, ...inProgress];
+  }
+  if (Array.isArray(obj.data)) return obj.data;
+  if (Array.isArray(data)) return data;
+  return [];
+}
+function extractItemId(type, item) {
+  if (!item || typeof item !== "object") return null;
+  const obj = item;
+  if (type === "roadmap_item" || type === "delivery_item" || type === "internal_task") {
+    const ext = obj.external_id;
+    if (typeof ext === "string") return ext;
+  }
+  const id = obj.id;
+  if (typeof id === "string") return id;
+  if (typeof id === "number") return String(id);
+  return null;
+}
+
+// src/utils/suggestion-url.ts
+function buildSuggestionUrl(path, opts = {}) {
+  const qs = new URLSearchParams();
+  const { entityType, entityId } = opts;
+  if (entityType && entityId !== void 0 && entityId !== null && entityId !== "") {
+    qs.set("entityType", entityType);
+    qs.set("entityId", String(entityId));
+  }
+  if (opts.count !== void 0) qs.set("count", String(opts.count));
+  for (const [key, value] of Object.entries(opts.extraParams ?? {})) {
+    if (value !== void 0 && value !== "") qs.set(key, value);
+  }
+  const query = qs.toString();
+  return `${opts.apiBaseUrl ?? ""}${path}${query ? `?${query}` : ""}`;
+}
+
 // src/utils/content-href.ts
 var DEFAULT_CONTENT_SUFFIXES = {
   onboarding_guide: "onboarding-guides",
@@ -3379,6 +3452,7 @@ exports.CHAT_ATTACHMENT_MARKDOWN_PATTERN = CHAT_ATTACHMENT_MARKDOWN_PATTERN;
 exports.CHAT_ATTACHMENT_VIEW_TOKEN_QUERY_PARAM = CHAT_ATTACHMENT_VIEW_TOKEN_QUERY_PARAM;
 exports.CHAT_ATTACHMENT_VIEW_URL_PREFIX = CHAT_ATTACHMENT_VIEW_URL_PREFIX;
 exports.CHAT_ATTACHMENT_VIEW_URL_PREFIX_REGEX_ESCAPED = CHAT_ATTACHMENT_VIEW_URL_PREFIX_REGEX_ESCAPED;
+exports.CONTENT_REF_GROUPS = CONTENT_REF_GROUPS;
 exports.CUSTOM_ITEM_ID = CUSTOM_ITEM_ID;
 exports.DEFAULT_CONTENT_SUFFIXES = DEFAULT_CONTENT_SUFFIXES;
 exports.DEFAULT_MIN_FILL_MS = DEFAULT_MIN_FILL_MS;
@@ -3407,6 +3481,8 @@ exports.buildChatAttachmentViewUrl = buildChatAttachmentViewUrl;
 exports.buildDefaultHref = buildDefaultHref;
 exports.buildDiscussAddendum = buildDiscussAddendum;
 exports.buildListUrl = buildListUrl;
+exports.buildSuggestionUrl = buildSuggestionUrl;
+exports.canonicalContentRefType = canonicalContentRefType;
 exports.cleanEmailDomain = cleanEmailDomain;
 exports.clearEmbedProxyAuth = clearEmbedProxyAuth;
 exports.clickupTaskUrl = clickupTaskUrl;
@@ -3423,6 +3499,8 @@ exports.extractDominantColor = extractDominantColor;
 exports.extractEntityIdFilter = extractEntityIdFilter;
 exports.extractHumanitySignals = extractHumanitySignals;
 exports.extractImageEdgeColorAsync = extractImageEdgeColorAsync;
+exports.extractItemId = extractItemId;
+exports.extractItems = extractItems;
 exports.fetchPriorityProp = fetchPriorityProp;
 exports.flattenAssistantContent = flattenAssistantContent;
 exports.formatAbbreviatedNumber = formatAbbreviatedNumber;
@@ -3470,6 +3548,8 @@ exports.getConfidenceColorClass = getConfidenceColorClass;
 exports.getConfidenceLabel = getConfidenceLabel;
 exports.getConfidenceLevel = getConfidenceLevel;
 exports.getConfidenceTextClass = getConfidenceTextClass;
+exports.getContentRefLabel = getContentRefLabel;
+exports.getContentRefLabelOrTitleCase = getContentRefLabelOrTitleCase;
 exports.getContrastRatio = getContrastRatio;
 exports.getCountryByCode = getCountryByCode;
 exports.getCountryPhoneData = getCountryPhoneData;
@@ -3524,6 +3604,7 @@ exports.normalizeIconKey = normalizeIconKey;
 exports.normalizeOSType = normalizeOSType;
 exports.normalizeToolType = normalizeToolType;
 exports.normalizeToolTypeWithFallback = normalizeToolTypeWithFallback;
+exports.orderContentRefTypes = orderContentRefTypes;
 exports.parseScrollAnchor = parseScrollAnchor;
 exports.parseWireCommandOverride = parseWireCommandOverride;
 exports.platformColors = platformColors;