@flamingo-stack/openframe-frontend-core 0.0.565-1861.5100.1 → 0.0.565

package/src/types/design-doc.ts

@@ -1,295 +0,0 @@
-// Design Doc Types (product-hub)
-// Mirrors product-release.ts — entity + child tables + create/update/filter shapes.
-//
-// Participant sections are keyed by the employee DEPARTMENT (FK to the ONE
-// `departments` table — see department.ts); there is no function enum.
-// Completion-gate math and status transitions live in the hub's
-// `lib/utils/design-doc-gate.ts` (isomorphic, shared by server + client).
-
-import type { EntityAuthor } from './entity-author'
-import type { DeliveryItem } from './delivery'
-import type { RoadmapItem } from '../components/chat/types/entities/roadmap-item'
-import type { DepartmentRef } from './department'
-import type { EmployeeDirectoryRow } from './employee'
-
-// ---------------------------------------------------------------------------
-// Value vocabularies — TYPES ONLY.
-//
-// The runtime lists live ONCE, in the hub's `lib/utils/design-doc-gate.ts`,
-// beside the labels and badge colors that make them useful; that module pins
-// each tuple against the union here at compile time, so the two cannot drift.
-// Declaring `as const` arrays here as well would ship a second copy of every
-// vocabulary that nothing reads — the copy a future contributor edits expecting
-// an effect.
-// ---------------------------------------------------------------------------
-
-export type DesignDocStatus = 'draft' | 'in_review' | 'approved' | 'building' | 'shipped' | 'abandoned'
-
-export type DesignDocTier = 'S' | 'M' | 'L'
-
-export type DesignDocParticipantStatus = 'pending' | 'in_progress' | 'completed' | 'blocked'
-
-export type DesignDocCommentType = 'blocking' | 'suggestion' | 'question' | 'note'
-
-export type DesignDocCommentStatus = 'open' | 'resolved' | 'declined'
-
-export type DesignDocLinkType = 'roadmap_task' | 'figma' | 'claude_artifact' | 'claude_design' | 'brief' | 'other'
-
-export type DesignDocMediaType = 'image' | 'video' | 'screenshot' | 'demo'
-
-// ---------------------------------------------------------------------------
-// Rows (as returned by the hub DAL — hydrated)
-// ---------------------------------------------------------------------------
-
-/**
- * The profile identity the DAL embeds on participants / comment authors — THE
- * shared person projection, not a second declaration of it. `email` rides the
- * detail payload only and is stripped from lists.
- */
-export type DesignDocPerson = EmployeeDirectoryRow
-
-export interface DesignDocClickUpTask {
-  id: number
-  doc_id: number
-  participant_id: number | null
-  clickup_task_id: string
-  display_order: number | null
-  created_at: string
-  /** Hydrated from the `clickup_tasks` mirror (never the live API). `undefined` = not in the mirror. */
-  task?: DeliveryItem
-}
-
-export interface DesignDocLink {
-  id: number
-  doc_id: number
-  link_type: DesignDocLinkType
-  url: string | null
-  clickup_task_id: string | null
-  title: string | null
-  display_order: number | null
-  created_at: string
-  /**
-   * A `roadmap_task` link, hydrated from the mirror as the ROADMAP item it is —
-   * so it renders with the roadmap card, the same as `/roadmap` and the chat.
-   * `undefined` = the mirror has not seen that id. (Section tasks are a
-   * different entity and carry `DeliveryItem` on `DesignDocClickUpTask`.)
-   */
-  roadmap?: RoadmapItem
-}
-
-export interface DesignDocMedia {
-  id: number
-  doc_id: number
-  participant_id: number | null
-  media_type: DesignDocMediaType
-  media_url: string
-  title: string | null
-  description: string | null
-  display_order: number | null
-  created_at: string
-  created_by: string | null
-}
-
-/**
- * A comment. ROOT comments (`parent_comment_id === null`) carry `comment_type`
- * + `status` and gate approval when `blocking` + `open`; REPLIES carry neither
- * (single-level threads — a reply to a reply is re-parented to the root).
- */
-export interface DesignDocComment {
-  id: number
-  doc_id: number
-  participant_id: number | null
-  parent_comment_id: number | null
-  author_id: string | null
-  comment_type: DesignDocCommentType | null
-  title: string | null
-  body: string
-  status: DesignDocCommentStatus | null
-  resolved_at: string | null
-  created_at: string
-  author?: DesignDocPerson | null
-  /** Threaded by the DAL; always `[]` on replies. */
-  replies: DesignDocComment[]
-}
-
-export interface DesignDocParticipant {
-  id: number
-  doc_id: number
-  department_id: string
-  department: DepartmentRef
-  assignee_id: string | null
-  assignee?: DesignDocPerson | null
-  status: DesignDocParticipantStatus
-  content: string | null
-  completed_at: string | null
-  display_order: number | null
-  created_at: string
-  updated_at: string
-  tasks: DesignDocClickUpTask[]
-  media: DesignDocMedia[]
-  /** Section-scoped root comments (threaded). */
-  comments: DesignDocComment[]
-}
-
-export interface DesignDocCompletion {
-  total: number
-  completed: number
-  blocked: number
-  openBlocking: number
-  isComplete: boolean
-  waitingOn: Array<{
-    participantId: number
-    department: DepartmentRef
-    assigneeName: string | null
-    status: DesignDocParticipantStatus
-  }>
-}
-
-/** R13 — what the signed-in viewer still owes on one doc. */
-export interface DesignDocMyOpenWork {
-  /** One person may own several department sections on the same doc. */
-  participants: Array<{ id: number; department: DepartmentRef; status: DesignDocParticipantStatus }>
-  openTasks: DeliveryItem[]
-}
-
-export interface DesignDoc {
-  id: number
-  title: string
-  slug: string
-  tier: DesignDocTier
-  summary: string | null
-  content: string | null
-  status: DesignDocStatus
-  author_id: string | null
-  /**
-   * EVERYONE who has handed the DRI role away on this doc (appended, never
-   * overwritten). The third-party break-glass excludes all of them: a DRI who
-   * also holds management could otherwise vacate the seat, act as a "third
-   * party" on their own doc and approve it alone — and with a single scalar,
-   * simply hand the seat on twice to erase the memory of their own vacating.
-   */
-  dri_vacated_by: string[]
-  approved_at: string | null
-  created_at: string
-  updated_at: string
-  /** DRI, hydrated via the shared author hydrator. */
-  author?: EntityAuthor
-  participants: DesignDocParticipant[]
-  links: DesignDocLink[]
-  /** Doc-level comments only (participant-scoped comments ride on their participant). */
-  comments: DesignDocComment[]
-  completion: DesignDocCompletion
-  my_open_work?: DesignDocMyOpenWork
-}
-
-// ---------------------------------------------------------------------------
-// Write shapes
-// ---------------------------------------------------------------------------
-
-export interface DesignDocLinkInput {
-  link_type: DesignDocLinkType
-  url?: string | null
-  clickup_task_id?: string | null
-  title?: string | null
-  display_order?: number
-}
-
-export interface DesignDocClickUpTaskInput {
-  clickup_task_id: string
-  display_order?: number
-}
-
-export interface DesignDocMediaInput {
-  media_type: DesignDocMediaType
-  media_url: string
-  title?: string | null
-  description?: string | null
-  display_order?: number
-}
-
-export interface CreateDesignDocParticipantInput {
-  /** Defaults to the assignee's profile department when omitted. */
-  department_id?: string
-  assignee_id: string
-}
-
-/** Wizard payload (POST /api/admin/design-docs). */
-export interface CreateDesignDocData {
-  title: string
-  slug: string
-  tier: DesignDocTier
-  summary?: string | null
-  /** Spec markdown (Why / What / How); the create screen carries the same body editor as edit. */
-  content?: string | null
-  /** DRI; defaults to the caller. */
-  author_id?: string | null
-  participants: CreateDesignDocParticipantInput[]
-  links: DesignDocLinkInput[]
-}
-
-/**
- * Doc-level allowlist (PUT). `status` and `participants` are NOT here — status
- * only moves through PATCH (the gate), participants only through their routes.
- */
-export interface UpdateDesignDocData {
-  title?: string
-  slug?: string
-  tier?: DesignDocTier
-  summary?: string | null
-  content?: string | null
-  author_id?: string | null
-  links?: DesignDocLinkInput[]
-  /** OCC token — the `updated_at` the editor seeded from; mismatch → 409. */
-  expected_updated_at?: string
-}
-
-export interface UpdateDesignDocParticipantData {
-  content?: string | null
-  status?: DesignDocParticipantStatus
-  assignee_id?: string | null
-  department_id?: string
-  clickup_tasks?: DesignDocClickUpTaskInput[]
-  media?: DesignDocMediaInput[]
-  expected_updated_at?: string
-}
-
-export interface AddDesignDocParticipantData {
-  /** Defaults to the assignee's profile department when omitted. */
-  department_id?: string
-  assignee_id: string
-}
-
-export interface AddDesignDocCommentData {
-  participant_id?: number | null
-  /** Set for a reply; the DAL re-parents replies-of-replies to the root. */
-  parent_comment_id?: number | null
-  /** Required on root comments, ignored on replies. */
-  comment_type?: DesignDocCommentType
-  title?: string | null
-  body: string
-}
-
-export interface DesignDocFilters {
-  status?: string
-  search?: string
-  mine?: 'open'
-  limit?: number
-  offset?: number
-}
-
-export interface DesignDocListResponse {
-  data: DesignDoc[]
-  count: number
-  /** Server-computed status facet counts (how-i-work feed convention). */
-  facets: { status: Record<string, number> }
-}
-
-export interface DesignDocStats {
-  total: number
-  draft: number
-  in_review: number
-  approved: number
-  building: number
-  waiting_on_me_docs: number
-  waiting_on_me_tasks: number
-}

package/src/utils/__tests__/claude-embed-url.test.ts

@@ -1,42 +0,0 @@
-import { describe, it, expect } from 'vitest'
-import { toClaudeEmbedUrl } from '../embed-url-converters'
-
-/**
- * The Claude counterpart of `toFigmaEmbedUrl`, and the newest url-trust
- * boundary in the markdown pipeline: whatever it returns is put in an iframe
- * `src`, so "not a published claude.ai artifact" must be `null`, always.
- */
-describe('toClaudeEmbedUrl', () => {
-  it('normalises every shape of a PUBLISHED artifact url to its embed route', () => {
-    const embed = 'https://claude.ai/public/artifacts/abc-123/embed'
-    expect(toClaudeEmbedUrl('https://claude.ai/public/artifacts/abc-123')).toBe(embed)
-    expect(toClaudeEmbedUrl('https://claude.ai/public/artifacts/abc-123/')).toBe(embed)
-    // The url Anthropic's own "Get embed code" hands the author — the likeliest
-    // paste of all, and it must not be treated as un-embeddable.
-    expect(toClaudeEmbedUrl('https://claude.ai/public/artifacts/abc-123/embed')).toBe(embed)
-    expect(toClaudeEmbedUrl('https://claude.ai/public/artifacts/abc-123/embed/')).toBe(embed)
-    // claude.site short links (and their embed form) 308 to the same artifact.
-    expect(toClaudeEmbedUrl('https://claude.site/artifacts/abc-123')).toBe(embed)
-    expect(toClaudeEmbedUrl('https://claude.site/artifacts/abc-123/embed')).toBe(embed)
-    expect(toClaudeEmbedUrl('https://CLAUDE.AI/public/artifacts/abc-123')).toBe(embed)
-    // Query and fragment are the artifact's, not ours: the embed route is built
-    // from the id alone.
-    expect(toClaudeEmbedUrl('https://claude.ai/public/artifacts/abc-123?x=1#y')).toBe(embed)
-  })
-
-  it('refuses everything that is not a published artifact, and never throws', () => {
-    // A Claude CODE artifact has no embeddable route at all.
-    expect(toClaudeEmbedUrl('https://claude.ai/code/artifact/abc-123')).toBeNull()
-    expect(toClaudeEmbedUrl('https://claude.ai/design/abc-123')).toBeNull()
-    // Host must BE claude.ai/claude.site — not a prefix, a subdomain or userinfo.
-    expect(toClaudeEmbedUrl('https://claude.ai.evil.com/public/artifacts/abc')).toBeNull()
-    expect(toClaudeEmbedUrl('https://evil.com/public/artifacts/abc')).toBeNull()
-    expect(toClaudeEmbedUrl('https://evil.com/?u=https://claude.ai/public/artifacts/abc')).toBeNull()
-    expect(toClaudeEmbedUrl('javascript:alert(1)')).toBeNull()
-    expect(toClaudeEmbedUrl('//claude.ai/public/artifacts/abc')).toBeNull()
-    expect(toClaudeEmbedUrl('not a url')).toBeNull()
-    expect(toClaudeEmbedUrl('')).toBeNull()
-    expect(toClaudeEmbedUrl(null)).toBeNull()
-    expect(toClaudeEmbedUrl(undefined)).toBeNull()
-  })
-})