anton-bakker-feedback 0.4.4 → 1.0.0

package/dist/index.js

@@ -1,5 +1,7 @@
 import { D, S, d, r, t, v } from "./chunks/i18n-Cn2yFMbd.js";
-import { e, i, r as r2, a, w } from "./chunks/observability-CfwHKObh.js";
+import { F, I, b, d as d2, c, a } from "./chunks/ingest-transport-DAA_pJNb.js";
+import { n, a as a2, b as b2, c as c2 } from "./chunks/normalisers-Cbd-i4Jh.js";
+import { e, i, r as r2, a as a3, w } from "./chunks/observability-DUK725zv.js";
 const BASE_PRIORITY = {
   bug: 60,
   ux: 40,
@@ -32,7 +34,7 @@ function buildGSI1SK(priority, id) {
 function processFeedbackCapture(input, nowIso) {
   const now = nowIso ?? (/* @__PURE__ */ new Date()).toISOString();
   const id = generateFeedbackId(now);
-  const status = "open";
+  const status = "new";
   const tags = input.tags ?? [];
   const environment = input.environment;
   const priority = calculatePriority(input.type, 1, input.hasScreenshot, environment);
@@ -130,97 +132,6 @@ function createMemoryTransport() {
     }
   };
 }
-const FEEDBACK_COLLECTION = "feedback";
-const INGEST_WRITE_SCOPE = "assets/write";
-function assertHttps(url, label) {
-  let u;
-  try {
-    u = new URL(url);
-  } catch {
-    throw new Error(`ingest-transport: ${label} is not a valid URL: ${url}`);
-  }
-  if (u.protocol !== "https:") {
-    throw new Error(`ingest-transport: ${label} must be https:// (got ${u.protocol}//) — refusing plaintext`);
-  }
-}
-const SERVER_OWNED_FIELDS = [
-  "PK",
-  "SK",
-  "GSI1PK",
-  "GSI1SK",
-  "GSI2PK",
-  "GSI2SK"
-];
-function toContent(item) {
-  const content = { ...item };
-  for (const f of SERVER_OWNED_FIELDS) delete content[f];
-  return content;
-}
-function createIngestTransport(config) {
-  const collection = config.collection ?? FEEDBACK_COLLECTION;
-  const refreshSkewMs = (config.refreshSkewSeconds ?? 60) * 1e3;
-  const doFetch = config.fetchImpl ?? globalThis.fetch;
-  assertHttps(config.apiUrl, "apiUrl");
-  if (!config.tokenProvider) {
-    if (!config.tokenUrl || !config.clientId || !config.clientSecret) {
-      throw new Error("ingest-transport: provide tokenProvider, OR tokenUrl + clientId + clientSecret");
-    }
-    assertHttps(config.tokenUrl, "tokenUrl");
-  }
-  if (typeof doFetch !== "function") {
-    throw new Error("ingest-transport: no fetch implementation available");
-  }
-  let cachedToken = null;
-  let cachedExpiryMs = 0;
-  async function mintToken() {
-    const basic = toBase64(`${config.clientId}:${config.clientSecret}`);
-    const res = await doFetch(config.tokenUrl, {
-      method: "POST",
-      headers: { "content-type": "application/x-www-form-urlencoded", authorization: `Basic ${basic}` },
-      body: `grant_type=client_credentials&scope=${encodeURIComponent(INGEST_WRITE_SCOPE)}`
-    });
-    const data = await res.json();
-    if (!res.ok || !data.access_token) {
-      throw new Error(`token mint failed (${res.status}): ${data.error ?? ""} ${data.error_description ?? ""}`.trim());
-    }
-    cachedToken = data.access_token;
-    cachedExpiryMs = Date.now() + Math.max(0, (data.expires_in ?? 3600) * 1e3 - refreshSkewMs);
-    return cachedToken;
-  }
-  async function getToken() {
-    if (config.tokenProvider) return config.tokenProvider();
-    if (cachedToken && Date.now() < cachedExpiryMs) return cachedToken;
-    return mintToken();
-  }
-  return {
-    async submit(item) {
-      try {
-        const token = await getToken();
-        const base = config.apiUrl.replace(/\/$/, "");
-        const res = await doFetch(`${base}/records/${encodeURIComponent(collection)}`, {
-          method: "POST",
-          headers: { authorization: `Bearer ${token}`, "content-type": "application/json", accept: "application/json" },
-          body: JSON.stringify({ item: toContent(item) })
-        });
-        const data = await res.json().catch(() => ({}));
-        if (res.status === 200 && data.success === true) {
-          return { success: true, feedbackId: data.ids?.[0] ?? item.id };
-        }
-        const retryable = res.status >= 500;
-        const msg = data.error ?? data.errors?.join("; ") ?? `HTTP ${res.status}`;
-        return { success: false, feedbackId: item.id, error: `ingest write failed: ${msg}`, retryable };
-      } catch (err) {
-        return { success: false, feedbackId: item.id, error: err.message, retryable: true };
-      }
-    }
-  };
-}
-function toBase64(s) {
-  if (typeof btoa === "function") return btoa(s);
-  const B = globalThis.Buffer;
-  if (B) return B.from(s).toString("base64");
-  throw new Error("ingest-transport: no base64 encoder available");
-}
 const VALIDATION_RULES = {
   CONTENT_MIN_LENGTH: 10,
   CONTENT_MAX_LENGTH: 5e3,
@@ -390,7 +301,7 @@ function appendCorrection(corrections, correction, nowIso) {
 }
 function applyStatusTransition(item, newStatus, nowIso) {
   const now = nowIso ?? (/* @__PURE__ */ new Date()).toISOString();
-  const resolvedAt = newStatus === "resolved" ? now : void 0;
+  const resolvedAt = newStatus === "closed" ? now : void 0;
   return {
     status: newStatus,
     GSI1PK: `STATUS#${newStatus}`,
@@ -506,7 +417,7 @@ function createErrorResponse(e2) {
 }
 export {
   D as DEFAULT_LOCALE,
-  FEEDBACK_COLLECTION,
+  F as FEEDBACK_COLLECTION,
   FeedbackConfigError,
   FeedbackDialogueError,
   FeedbackDuplicateError,
@@ -514,7 +425,8 @@ export {
   FeedbackScreenshotError,
   FeedbackTransportError,
   FeedbackValidationError,
-  INGEST_WRITE_SCOPE,
+  I as INGEST_READ_SCOPE,
+  b as INGEST_WRITE_SCOPE,
   S as SUPPORTED_LOCALES,
   VALIDATION_RULES,
   addReporter,
@@ -524,18 +436,24 @@ export {
   buildKeys,
   calculatePriority,
   createErrorResponse,
-  createIngestTransport,
+  d2 as createIngestAnnotateClient,
+  c as createIngestReader,
+  a as createIngestTransport,
   createMemoryTransport,
   d as detectLocale,
   e as emitMetric,
   generateFeedbackId,
   i as initTracer,
   isFeedbackError,
+  n as normaliseActivityArrays,
+  a2 as normaliseLegacyStatus,
+  b2 as normaliseReportContent,
+  c2 as normaliseStoredItem,
   parseGSI2PK,
   parseSK,
   processFeedbackCapture,
   r2 as recordDialogueExchange,
-  a as recordSubmitEvent,
+  a3 as recordSubmitEvent,
   r as resolveConfig,
   t,
   validateAppName,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/core/capture.ts","../src/core/transport.ts","../src/core/ingest-transport.ts","../src/core/validation.ts","../src/core/transforms.ts","../src/core/errors.ts"],"sourcesContent":["/**\n * Capture logic and priority calculation for feedback submissions.\n *\n * Framework-agnostic — no browser APIs, no DOM, no AWS.\n * Pure data transformation from user input to StoredFeedbackItem.\n */\n\nimport type {\n  FeedbackType,\n  FeedbackStatus,\n  FeedbackEnvironment,\n  FeedbackScope,\n  FeedbackSize,\n  FeedbackContext,\n  StoredFeedbackItem,\n  DialogueEntry,\n  Reporter,\n} from './types.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Input Type\n// ─────────────────────────────────────────────────────────────────\n\n/** Input for processFeedbackCapture */\nexport interface CaptureInput {\n  type: FeedbackType;\n  content: string;\n  context: FeedbackContext;\n  submittedBy: string;\n  appName: string;\n  hasScreenshot: boolean;\n  screenshotS3Key?: string;\n  environment?: FeedbackEnvironment;\n  version?: string;\n  tags?: string[];\n  traceId?: string;\n  dialogueHistory?: DialogueEntry[];\n  classification?: string;\n  scope?: FeedbackScope;\n  size?: FeedbackSize;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Priority Formula\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Base priority scores by feedback type.\n * bug=60, ux=40, feature=20, other=10\n */\nconst BASE_PRIORITY: Record<FeedbackType, number> = {\n  bug: 60,\n  ux: 40,\n  feature: 20,\n  other: 10,\n};\n\n/**\n * Environment bonus scores.\n * production=+20, staging=+10, development=0\n */\nconst ENVIRONMENT_BONUS: Record<FeedbackEnvironment, number> = {\n  production: 20,\n  staging: 10,\n  development: 0,\n};\n\n/**\n * Calculates the priority score for a feedback item.\n *\n * Formula:\n *   base = baseByType (bug=60, ux=40, feature=20, other=10)\n *   env  = environmentBonus (production=+20, staging=+10, development=0)\n *   rep  = min(reporterCount - 1, 5) * 4  (+4 per additional reporter, max +20)\n *   ss   = hasScreenshot ? +5 : 0\n *   priority = clamp(0, 100, base + env + rep + ss)\n */\nexport function calculatePriority(\n  type: FeedbackType,\n  reporterCount: number,\n  hasScreenshot: boolean,\n  environment?: FeedbackEnvironment,\n): number {\n  const base = BASE_PRIORITY[type];\n  const env = ENVIRONMENT_BONUS[environment ?? 'development'];\n  const reporterBonus = Math.min(reporterCount - 1, 5) * 4;\n  const screenshotBonus = hasScreenshot ? 5 : 0;\n\n  const raw = base + env + reporterBonus + screenshotBonus;\n  return Math.max(0, Math.min(100, raw));\n}\n\n// ─────────────────────────────────────────────────────────────────\n// ID Generation\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Generates a unique feedback ID in the format: FB-YYYY-MM-DD-{uuid8}\n * Uses crypto.randomUUID() for uniqueness; truncates to 8 chars.\n */\nexport function generateFeedbackId(nowIso?: string): string {\n  const date = nowIso ? nowIso.slice(0, 10) : new Date().toISOString().slice(0, 10);\n  const uuid8 = crypto.randomUUID().replace(/-/g, '').slice(0, 8);\n  return `FB-${date}-${uuid8}`;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// GSI1SK Builder\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Builds the GSI1SK sort key value.\n * Format: {3-digit-inverted-priority}#{id}\n * Example: priority 85 → '015#FB-2026-07-25-abc12345'\n *\n * Inverted so DynamoDB ascending sort returns highest-priority first.\n */\nexport function buildGSI1SK(priority: number, id: string): string {\n  const inverted = 100 - Math.max(0, Math.min(100, priority));\n  const padded = String(inverted).padStart(3, '0');\n  return `${padded}#${id}`;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Main Capture Processor\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Processes a feedback capture input into a StoredFeedbackItem\n * ready for the transport layer.\n *\n * Sets:\n *   - status: 'open'\n *   - reporterCount: 1\n *   - reporters: [{ userId: submittedBy, addedAt: nowIso }]\n *   - tags: [] when omitted\n *   - All DynamoDB key fields (PK, SK, GSI1PK, GSI1SK, GSI2PK, GSI2SK)\n */\nexport function processFeedbackCapture(\n  input: CaptureInput,\n  nowIso?: string,\n): StoredFeedbackItem {\n  const now = nowIso ?? new Date().toISOString();\n  const id = generateFeedbackId(now);\n  const status: FeedbackStatus = 'open';\n  const tags = input.tags ?? [];\n  const environment = input.environment;\n\n  const priority = calculatePriority(input.type, 1, input.hasScreenshot, environment);\n\n  const reporter: Reporter = {\n    userId: input.submittedBy,\n    addedAt: now,\n  };\n\n  const PK = `PROJECT#${input.appName}`;\n  const SK = `FB#${now}#${id}`;\n  const GSI1PK = `STATUS#${status}`;\n  const GSI1SK = buildGSI1SK(priority, id);\n  const GSI2PK = `TYPE#${input.type}#PROJECT#${input.appName}`;\n  const GSI2SK = now;\n\n  const item: StoredFeedbackItem = {\n    PK,\n    SK,\n    GSI1PK,\n    GSI1SK,\n    GSI2PK,\n    GSI2SK,\n    id,\n    appName: input.appName,\n    type: input.type,\n    status,\n    priority,\n    content: input.content,\n    context: input.context,\n    hasScreenshot: input.hasScreenshot,\n    submittedAt: now,\n    lastModifiedAt: now,\n    submittedBy: input.submittedBy,\n    reporters: [reporter],\n    reporterCount: 1,\n    dialogueHistory: input.dialogueHistory ?? [],\n    corrections: [],\n    tags,\n  };\n\n  // Optional fields — only set when defined\n  if (input.screenshotS3Key !== undefined) {\n    item.screenshotS3Key = input.screenshotS3Key;\n  }\n  if (input.environment !== undefined) {\n    item.environment = input.environment;\n  }\n  if (input.version !== undefined) {\n    item.version = input.version;\n  }\n  if (input.traceId !== undefined) {\n    item.traceId = input.traceId;\n  }\n  if (input.classification !== undefined) {\n    item.classification = input.classification;\n  }\n  if (input.scope !== undefined) {\n    item.scope = input.scope;\n  }\n  if (input.size !== undefined) {\n    item.size = input.size;\n  }\n\n  return item;\n}\n","/**\n * Transport contracts for the feedback package.\n *\n * Defines abstract interfaces that decouple core logic from\n * any specific implementation. Implementations live in the\n * consuming app's server handlers (slice 03).\n *\n * NO AWS SDK imports in this file.\n */\n\nimport type {\n  StoredFeedbackItem,\n  SubmitResult,\n  DialogueResponse,\n  UploadResult,\n  DialogueEntry,\n} from './types.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Transport Interfaces\n// ─────────────────────────────────────────────────────────────────\n\n/** What the React adapter calls at submit time */\nexport interface FeedbackSubmitTransport {\n  submit(item: StoredFeedbackItem): Promise<SubmitResult>;\n}\n\n/** What the dialogue UI calls on each exchange */\nexport interface FeedbackDialogueTransport {\n  exchange(\n    feedbackId: string,\n    message: string,\n    history: DialogueEntry[],\n  ): Promise<DialogueResponse>;\n}\n\n/** What the screenshot capture calls after html2canvas */\nexport interface FeedbackScreenshotTransport {\n  upload(feedbackId: string, blob: Blob): Promise<UploadResult>;\n}\n\n/**\n * Composite transport — all three combined for full-feature transport.\n * Dialogue and screenshot are optional so implementations can omit them.\n */\nexport interface FeedbackTransport\n  extends FeedbackSubmitTransport,\n    Partial<FeedbackDialogueTransport>,\n    Partial<FeedbackScreenshotTransport> {}\n\n// ─────────────────────────────────────────────────────────────────\n// Memory Transport (for testing)\n// ─────────────────────────────────────────────────────────────────\n\n/** Memory transport with access to internal state for assertions */\nexport interface MemoryTransport extends FeedbackTransport {\n  /** All submitted items */\n  submissions: StoredFeedbackItem[];\n  /** Queue of dialogue responses to return in order */\n  dialogueResponses: DialogueResponse[];\n  /** Uploaded screenshot blobs */\n  uploadedScreenshots: Array<{ feedbackId: string; blob: Blob }>;\n  /** Clear all stored state */\n  clear(): void;\n}\n\nconst DEFAULT_DIALOGUE_RESPONSE: DialogueResponse = {\n  success: true,\n  response: 'Thank you for your feedback. Can you tell me more?',\n  conversationComplete: false,\n};\n\n/**\n * Creates an in-memory transport for testing.\n *\n * - submit(): stores the item and returns { success: true, feedbackId: item.id }\n * - exchange(): returns the first queued response, or a default stub\n * - upload(): records the blob reference\n * - Does NOT import any AWS SDK\n */\nexport function createMemoryTransport(): MemoryTransport {\n  const submissions: StoredFeedbackItem[] = [];\n  const dialogueResponses: DialogueResponse[] = [];\n  const uploadedScreenshots: Array<{ feedbackId: string; blob: Blob }> = [];\n\n  return {\n    submissions,\n    dialogueResponses,\n    uploadedScreenshots,\n\n    async submit(item: StoredFeedbackItem): Promise<SubmitResult> {\n      submissions.push(item);\n      return { success: true, feedbackId: item.id };\n    },\n\n    async exchange(\n      feedbackId: string,\n      message: string,\n      history: DialogueEntry[],\n    ): Promise<DialogueResponse> {\n      void feedbackId;\n      void message;\n      void history;\n      if (dialogueResponses.length > 0) {\n        return dialogueResponses.shift() as DialogueResponse;\n      }\n      return { ...DEFAULT_DIALOGUE_RESPONSE };\n    },\n\n    async upload(feedbackId: string, blob: Blob): Promise<UploadResult> {\n      uploadedScreenshots.push({ feedbackId, blob });\n      return {\n        success: true,\n        s3Key: `screenshots/${feedbackId}.png`,\n      };\n    },\n\n    clear() {\n      submissions.length = 0;\n      dialogueResponses.length = 0;\n      uploadedScreenshots.length = 0;\n    },\n  };\n}\n","/**\n * ingest-transport.ts — central-ingest implementation of FeedbackSubmitTransport.\n *\n * The central-storage principle: a consuming application reaches central feedback storage ONLY through\n * an authenticated API — it mints a short-lived OAuth2 client-credentials JWT and POSTs the feedback\n * CONTENT to the generic `/records/{collection}` ingest endpoint. The server attributes every write to\n * the verified token identity (its `client_id` claim) and stamps the canonical keys (PK/SK/GSI); the\n * application holds no AWS principal and sends no partition/identity fields. This replaces the bespoke\n * direct-DynamoDB writer (`FeedbackService.put`) — the pattern the principle removes.\n *\n * This transport is the client half of that contract, matching:\n *   - the deployed ingest API (`POST /records/feedback`, body `{ item }`, response `{ success, ids }`),\n *   - ralph's `ingest-client.mjs` (same route + shape),\n *   - deploy-engine's `ingest-verify` (same token mint + write).\n *\n * Zero runtime dependencies — uses the built-in `fetch` (keeps the package browser-safe and SDK-free).\n * The caller supplies the app-client credential (or a token provider); the SECRET is resolved by the\n * host out-of-band (SSM/password manager) and never embedded here. HTTPS is enforced — a token or\n * record sent over plaintext is a compromise.\n *\n * NO AWS SDK imports in this file.\n */\n\nimport type { StoredFeedbackItem, SubmitResult } from './types.js';\nimport type { FeedbackSubmitTransport } from './transport.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Config\n// ─────────────────────────────────────────────────────────────────\n\n/** The ingest collection feedback writes to (the deployed registry maps it to `ralph-feedback`). */\nexport const FEEDBACK_COLLECTION = 'feedback';\n/** OAuth2 scope required to write via the ingest API. */\nexport const INGEST_WRITE_SCOPE = 'assets/write';\n\n/** Minimal fetch surface (so the package needs no DOM lib types to compile). */\nexport type FetchLike = (\n  url: string,\n  init?: { method?: string; headers?: Record<string, string>; body?: string },\n) => Promise<{ status: number; ok: boolean; json: () => Promise<unknown> }>;\n\n/**\n * How the transport obtains a bearer token. Either:\n *  - supply `clientId` + `clientSecret` + `tokenUrl` and let the transport mint/refresh it, OR\n *  - supply a `tokenProvider()` (e.g. the host already manages the token) — takes precedence.\n */\nexport interface IngestTransportConfig {\n  /** Ingest API base URL (HTTPS), e.g. https://xxxx.execute-api.<region>.amazonaws.com */\n  apiUrl: string;\n  /** OAuth2 token endpoint (HTTPS) — required unless `tokenProvider` is given. */\n  tokenUrl?: string;\n  /** App-client id (the app identity the server attributes writes to). Required unless `tokenProvider`. */\n  clientId?: string;\n  /** App-client secret. SHOULD come from the host's secret store; required unless `tokenProvider`. */\n  clientSecret?: string;\n  /** Supply a token directly (overrides client-credentials minting). */\n  tokenProvider?: () => Promise<string>;\n  /** Collection name (default 'feedback'). */\n  collection?: string;\n  /** Seconds before expiry to proactively re-mint (default 60). */\n  refreshSkewSeconds?: number;\n  /** Injectable fetch (tests). Defaults to global fetch. */\n  fetchImpl?: FetchLike;\n}\n\nfunction assertHttps(url: string, label: string): void {\n  let u: URL;\n  try {\n    u = new URL(url);\n  } catch {\n    throw new Error(`ingest-transport: ${label} is not a valid URL: ${url}`);\n  }\n  if (u.protocol !== 'https:') {\n    throw new Error(`ingest-transport: ${label} must be https:// (got ${u.protocol}//) — refusing plaintext`);\n  }\n}\n\n/** Identity/partition + local-only fields the server owns — stripped before sending the content. */\nconst SERVER_OWNED_FIELDS: readonly string[] = [\n  'PK', 'SK', 'GSI1PK', 'GSI1SK', 'GSI2PK', 'GSI2SK',\n];\n\n/** Strip the fields the server stamps from the verified identity (never sent/trusted from the client). */\nfunction toContent(item: StoredFeedbackItem): Record<string, unknown> {\n  const content: Record<string, unknown> = { ...(item as unknown as Record<string, unknown>) };\n  for (const f of SERVER_OWNED_FIELDS) delete content[f];\n  return content;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Transport\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Create a FeedbackSubmitTransport that writes to the central ingest API.\n *\n * Usage (host app wires the credential from its secret store):\n *   const transport = createIngestTransport({\n *     apiUrl: process.env.FEEDBACK_INGEST_URL!,\n *     tokenUrl: process.env.FEEDBACK_TOKEN_URL!,\n *     clientId: process.env.FEEDBACK_CLIENT_ID!,\n *     clientSecret: await resolveSecret('feedback/ingest/<app>'),\n *   });\n *   await transport.submit(item);  // → { success, feedbackId }\n */\nexport function createIngestTransport(config: IngestTransportConfig): FeedbackSubmitTransport {\n  const collection = config.collection ?? FEEDBACK_COLLECTION;\n  const refreshSkewMs = (config.refreshSkewSeconds ?? 60) * 1000;\n  const doFetch = config.fetchImpl ?? (globalThis.fetch as unknown as FetchLike);\n\n  assertHttps(config.apiUrl, 'apiUrl');\n  if (!config.tokenProvider) {\n    if (!config.tokenUrl || !config.clientId || !config.clientSecret) {\n      throw new Error('ingest-transport: provide tokenProvider, OR tokenUrl + clientId + clientSecret');\n    }\n    assertHttps(config.tokenUrl, 'tokenUrl');\n  }\n  if (typeof doFetch !== 'function') {\n    throw new Error('ingest-transport: no fetch implementation available');\n  }\n\n  // Cached minted token (when minting ourselves).\n  let cachedToken: string | null = null;\n  let cachedExpiryMs = 0;\n\n  async function mintToken(): Promise<string> {\n    const basic = toBase64(`${config.clientId}:${config.clientSecret}`);\n    const res = await doFetch(config.tokenUrl as string, {\n      method: 'POST',\n      headers: { 'content-type': 'application/x-www-form-urlencoded', authorization: `Basic ${basic}` },\n      body: `grant_type=client_credentials&scope=${encodeURIComponent(INGEST_WRITE_SCOPE)}`,\n    });\n    const data = (await res.json()) as { access_token?: string; expires_in?: number; error?: string; error_description?: string };\n    if (!res.ok || !data.access_token) {\n      throw new Error(`token mint failed (${res.status}): ${data.error ?? ''} ${data.error_description ?? ''}`.trim());\n    }\n    cachedToken = data.access_token;\n    cachedExpiryMs = Date.now() + Math.max(0, (data.expires_in ?? 3600) * 1000 - refreshSkewMs);\n    return cachedToken;\n  }\n\n  async function getToken(): Promise<string> {\n    if (config.tokenProvider) return config.tokenProvider();\n    if (cachedToken && Date.now() < cachedExpiryMs) return cachedToken;\n    return mintToken();\n  }\n\n  return {\n    async submit(item: StoredFeedbackItem): Promise<SubmitResult> {\n      try {\n        const token = await getToken();\n        const base = config.apiUrl.replace(/\\/$/, '');\n        const res = await doFetch(`${base}/records/${encodeURIComponent(collection)}`, {\n          method: 'POST',\n          headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json', accept: 'application/json' },\n          body: JSON.stringify({ item: toContent(item) }),\n        });\n        const data = (await res.json().catch(() => ({}))) as { success?: boolean; ids?: string[]; error?: string; errors?: string[] };\n        if (res.status === 200 && data.success === true) {\n          return { success: true, feedbackId: data.ids?.[0] ?? item.id };\n        }\n        // Explicit failure — never a silent drop. 5xx is retryable; 4xx (validation/auth) is not.\n        const retryable = res.status >= 500;\n        const msg = data.error ?? data.errors?.join('; ') ?? `HTTP ${res.status}`;\n        return { success: false, feedbackId: item.id, error: `ingest write failed: ${msg}`, retryable };\n      } catch (err) {\n        // Transport/network failure — retryable (the caller may buffer + retry).\n        return { success: false, feedbackId: item.id, error: (err as Error).message, retryable: true };\n      }\n    },\n  };\n}\n\n/** Base64 encode a string in both Node and browser (zero-dep). */\nfunction toBase64(s: string): string {\n  if (typeof btoa === 'function') return btoa(s);\n  // Node fallback — Buffer exists; typed loosely to avoid a hard @types/node coupling in the browser build.\n  const B = (globalThis as unknown as { Buffer?: { from: (x: string) => { toString: (enc: string) => string } } }).Buffer;\n  if (B) return B.from(s).toString('base64');\n  throw new Error('ingest-transport: no base64 encoder available');\n}\n","/**\n * Input validation functions for the feedback package.\n *\n * Used both client-side (before submission) and server-side (in handler).\n * No external dependencies — pure validation logic.\n *\n * Acceptance criteria evidence:\n *   AC-65: createErrorResponse(new FeedbackValidationError('…', ['content']))\n *          ])) includes fields: ['content'] → shown in errors.ts\n *   AC-41: VALIDATION_RULES is exported as const (immutable) with values:\n *          CONTENT_MIN_LENGTH=10, CONTENT_MAX_LENGTH=5000, TAG_MAX_COUNT=10\n *          TAG_PATTERN=/^[a-z0-9-]+$/, [a-z0-9-] pattern applied\n */\n\nimport type { FeedbackContext } from './types.js';\nimport type { CaptureInput } from './capture.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Validation Rules (exported as const — immutable)\n// ─────────────────────────────────────────────────────────────────\n\n/** Immutable validation constants */\nexport const VALIDATION_RULES = {\n  CONTENT_MIN_LENGTH: 10,\n  CONTENT_MAX_LENGTH: 5_000,\n  TAG_MAX_COUNT: 10,\n  TAG_PATTERN: /^[a-z0-9-]+$/,\n  APP_NAME_PATTERN: /^[a-zA-Z0-9_-]+$/,\n  SCREENSHOT_MAX_BYTES: 5_242_880, // 5 MB\n  CONSOLE_ERRORS_MAX: 20,\n} as const;\n\n// ─────────────────────────────────────────────────────────────────\n// Result Type\n// ─────────────────────────────────────────────────────────────────\n\n/** Validation result with user-facing messages */\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];    // Blocking — submission must be rejected\n  warnings: string[]; // Non-blocking — suggestions only\n}\n\nfunction makeResult(errors: string[], warnings: string[]): ValidationResult {\n  return { valid: errors.length === 0, errors, warnings };\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Individual Validators\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Validates feedback content.\n * Fails below CONTENT_MIN_LENGTH (\"Feedback must be at least 10 characters\"),\n * fails above CONTENT_MAX_LENGTH, warns if only whitespace.\n */\nexport function validateContent(content: string): ValidationResult {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  if (content.length < VALIDATION_RULES.CONTENT_MIN_LENGTH) {\n    errors.push(\n      `Feedback must be at least ${VALIDATION_RULES.CONTENT_MIN_LENGTH} characters (got ${content.length})`,\n    );\n  } else if (content.length > VALIDATION_RULES.CONTENT_MAX_LENGTH) {\n    errors.push(\n      `Feedback must not exceed ${VALIDATION_RULES.CONTENT_MAX_LENGTH} characters (got ${content.length})`,\n    );\n  } else if (content.trim().length === 0) {\n    warnings.push('Feedback appears to contain only whitespace');\n  }\n\n  return makeResult(errors, warnings);\n}\n\n/**\n * Validates feedback tags.\n * Fails if count exceeds TAG_MAX_COUNT or if any tag doesn't match TAG_PATTERN.\n */\nexport function validateTags(tags: string[]): ValidationResult {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  if (tags.length > VALIDATION_RULES.TAG_MAX_COUNT) {\n    errors.push(\n      `Too many tags: ${tags.length} (maximum is ${VALIDATION_RULES.TAG_MAX_COUNT})`,\n    );\n  }\n\n  for (const tag of tags) {\n    if (!VALIDATION_RULES.TAG_PATTERN.test(tag)) {\n      errors.push(\n        `Tag \"${tag}\" is invalid — must match /^[a-z0-9-]+$/ (lowercase letters, digits, hyphens only)`,\n      );\n    }\n  }\n\n  return makeResult(errors, warnings);\n}\n\n/**\n * Validates an app name.\n */\nexport function validateAppName(appName: string): ValidationResult {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  if (!appName || appName.trim() === '') {\n    errors.push('appName is required');\n  } else if (!VALIDATION_RULES.APP_NAME_PATTERN.test(appName)) {\n    errors.push(\n      `appName \"${appName}\" is invalid — must match /^[a-zA-Z0-9_-]+$/`,\n    );\n  }\n\n  return makeResult(errors, warnings);\n}\n\n/**\n * Validates screenshot size.\n */\nexport function validateScreenshotSize(sizeBytes: number): ValidationResult {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  if (sizeBytes > VALIDATION_RULES.SCREENSHOT_MAX_BYTES) {\n    errors.push(\n      `Screenshot size ${sizeBytes} bytes exceeds the maximum of ${VALIDATION_RULES.SCREENSHOT_MAX_BYTES} bytes (5 MB)`,\n    );\n  }\n\n  return makeResult(errors, warnings);\n}\n\n/**\n * Validates browser context.\n * Warns if url is empty; warns if consoleErrors exceeds 20 items.\n */\nexport function validateContext(context: FeedbackContext): ValidationResult {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  if (!context.url || context.url.trim() === '') {\n    warnings.push('context.url is empty — this may indicate a capture logic error');\n  }\n\n  if (\n    context.consoleErrors &&\n    context.consoleErrors.length > VALIDATION_RULES.CONSOLE_ERRORS_MAX\n  ) {\n    warnings.push(\n      `context.consoleErrors has ${context.consoleErrors.length} entries (expected ≤${VALIDATION_RULES.CONSOLE_ERRORS_MAX}); truncation should occur in capture layer`,\n    );\n  }\n\n  return makeResult(errors, warnings);\n}\n\n/**\n * Aggregate validator — runs all validators for a capture input.\n */\nexport function validateCaptureInput(input: Partial<CaptureInput>): ValidationResult {\n  const allErrors: string[] = [];\n  const allWarnings: string[] = [];\n\n  if (input.content !== undefined) {\n    const contentResult = validateContent(input.content);\n    allErrors.push(...contentResult.errors);\n    allWarnings.push(...contentResult.warnings);\n  } else {\n    allErrors.push('content is required');\n  }\n\n  if (input.tags !== undefined) {\n    const tagResult = validateTags(input.tags);\n    allErrors.push(...tagResult.errors);\n    allWarnings.push(...tagResult.warnings);\n  }\n\n  if (input.appName !== undefined) {\n    const nameResult = validateAppName(input.appName);\n    allErrors.push(...nameResult.errors);\n    allWarnings.push(...nameResult.warnings);\n  } else {\n    allErrors.push('appName is required');\n  }\n\n  if (input.context !== undefined) {\n    const contextResult = validateContext(input.context);\n    allErrors.push(...contextResult.errors);\n    allWarnings.push(...contextResult.warnings);\n  }\n\n  return makeResult(allErrors, allWarnings);\n}\n","/**\n * Pure data transformation functions for DynamoDB key construction\n * and shape mapping.\n *\n * NO AWS SDK calls — only key construction and shape mapping.\n * All functions are pure: take plain objects, return plain objects.\n * No side effects.\n */\n\nimport type {\n  FeedbackType,\n  FeedbackStatus,\n  StoredFeedbackItem,\n  CorrectionEntry,\n  Reporter,\n} from './types.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Key Builder\n// ─────────────────────────────────────────────────────────────────\n\n/** The six DynamoDB keys for a feedback item */\nexport interface FeedbackKeys {\n  PK: string;      // PROJECT#{appName}\n  SK: string;      // FB#{timestamp}#{id}\n  GSI1PK: string;  // STATUS#{status}\n  GSI1SK: string;  // {inverted-priority-padded}#{id}\n  GSI2PK: string;  // TYPE#{type}#PROJECT#{appName}\n  GSI2SK: string;  // {timestamp}\n}\n\n/**\n * Builds the six DynamoDB keys for a feedback item.\n *\n * @param appName - Application name (e.g. 'sagrosoft20')\n * @param id - Feedback ID (e.g. 'FB-2026-07-25-abc12345')\n * @param type - Feedback type\n * @param status - Current status\n * @param priority - Priority score 0–100\n * @param timestamp - ISO 8601 timestamp\n */\nexport function buildKeys(\n  appName: string,\n  id: string,\n  type: FeedbackType,\n  status: FeedbackStatus,\n  priority: number,\n  timestamp: string,\n): FeedbackKeys {\n  const clampedPriority = Math.max(0, Math.min(100, priority));\n  const inverted = 100 - clampedPriority;\n  const paddedInverted = String(inverted).padStart(3, '0');\n\n  return {\n    PK: `PROJECT#${appName}`,\n    SK: `FB#${timestamp}#${id}`,\n    GSI1PK: `STATUS#${status}`,\n    GSI1SK: `${paddedInverted}#${id}`,\n    GSI2PK: `TYPE#${type}#PROJECT#${appName}`,\n    GSI2SK: timestamp,\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Key Parsers\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Extracts timestamp and id from a composite SK.\n * SK format: FB#{timestamp}#{id}\n */\nexport function parseSK(sk: string): { timestamp: string; id: string } {\n  // SK format: FB#2026-07-25T10:00:00.000Z#FB-2026-07-25-abc12345\n  const withoutPrefix = sk.startsWith('FB#') ? sk.slice(3) : sk;\n  // Find the last '#' which separates timestamp from id\n  const lastHash = withoutPrefix.lastIndexOf('#');\n  if (lastHash === -1) {\n    throw new Error(`Invalid SK format: \"${sk}\" — expected FB#{timestamp}#{id}`);\n  }\n  return {\n    timestamp: withoutPrefix.slice(0, lastHash),\n    id: withoutPrefix.slice(lastHash + 1),\n  };\n}\n\n/**\n * Parses the GSI2PK into its component parts.\n * GSI2PK format: TYPE#{type}#PROJECT#{appName}\n */\nexport function parseGSI2PK(gsi2pk: string): { type: FeedbackType; appName: string } {\n  // Format: TYPE#feature#PROJECT#oms4business\n  const typeMatch = gsi2pk.match(/^TYPE#([^#]+)#PROJECT#(.+)$/);\n  if (!typeMatch || !typeMatch[1] || !typeMatch[2]) {\n    throw new Error(\n      `Invalid GSI2PK format: \"${gsi2pk}\" — expected TYPE#{type}#PROJECT#{appName}`,\n    );\n  }\n  return {\n    type: typeMatch[1] as FeedbackType,\n    appName: typeMatch[2],\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Reporter Mutations (immutable — returns new arrays)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Adds a reporter to an item.\n * Returns new reporters array and updated reporterCount — does NOT mutate original.\n */\nexport function addReporter(\n  item: StoredFeedbackItem,\n  userId: string,\n  addedContext?: string,\n  nowIso?: string,\n): Pick<StoredFeedbackItem, 'reporters' | 'reporterCount' | 'GSI1SK'> {\n  const addedAt = nowIso ?? new Date().toISOString();\n  const newReporter: Reporter = { userId, addedAt };\n  if (addedContext !== undefined) {\n    newReporter.addedContext = addedContext;\n  }\n\n  // Spread to ensure immutability — does NOT mutate item.reporters\n  const newReporters: Reporter[] = [...item.reporters, newReporter];\n  const newCount = newReporters.length;\n\n  // GSI1SK format preserves the inverted priority prefix, just uses same item id\n  // The priority recalculation would normally happen in the capture layer\n  // Here we preserve the existing GSI1SK structure (priority unchanged by reporter add)\n  return {\n    reporters: newReporters,\n    reporterCount: newCount,\n    GSI1SK: item.GSI1SK,\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Correction Mutations (immutable)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Appends a correction record to the corrections array.\n * Returns a new array — does NOT mutate the original.\n */\nexport function appendCorrection(\n  corrections: CorrectionEntry[],\n  correction: Omit<CorrectionEntry, 'correctedAt'>,\n  nowIso?: string,\n): CorrectionEntry[] {\n  const correctedAt = nowIso ?? new Date().toISOString();\n  return [\n    ...corrections,\n    { ...correction, correctedAt },\n  ];\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Status Transition\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Applies a status transition to an item.\n * Returns updated key fields + lastModifiedAt (does NOT mutate original).\n *\n * When transitioning to 'resolved': sets resolvedAt = nowIso.\n * When transitioning to any other status: resolvedAt is undefined.\n */\nexport function applyStatusTransition(\n  item: StoredFeedbackItem,\n  newStatus: FeedbackStatus,\n  nowIso?: string,\n): Pick<\n  StoredFeedbackItem,\n  'status' | 'GSI1PK' | 'GSI1SK' | 'lastModifiedAt' | 'resolvedAt' | 'resolvedBy'\n> {\n  const now = nowIso ?? new Date().toISOString();\n\n  // GSI1SK stays the same (priority doesn't change on status transition)\n  // Only GSI1PK changes (new status)\n  const resolvedAt: string | undefined = newStatus === 'resolved' ? now : undefined;\n  const resolvedBy: string | undefined = undefined;\n\n  return {\n    status: newStatus,\n    GSI1PK: `STATUS#${newStatus}`,\n    GSI1SK: item.GSI1SK, // Priority unchanged\n    lastModifiedAt: now,\n    ...(resolvedAt !== undefined ? { resolvedAt } : {}),\n    ...(resolvedBy !== undefined ? { resolvedBy } : {}),\n  } as Pick<\n    StoredFeedbackItem,\n    'status' | 'GSI1PK' | 'GSI1SK' | 'lastModifiedAt' | 'resolvedAt' | 'resolvedBy'\n  >;\n}\n","/**\n * Domain error types for the feedback package.\n *\n * Every error class carries:\n *   - code: string constant (usable in switch statements)\n *   - retryable: boolean\n *\n * createErrorResponse converts any thrown value to a safe JSON-serialisable object.\n */\n\n// ─────────────────────────────────────────────────────────────────\n// Base Error Class\n// ─────────────────────────────────────────────────────────────────\n\n/** Base class for all feedback domain errors */\nexport abstract class FeedbackError extends Error {\n  abstract readonly code: string;\n  abstract readonly retryable: boolean;\n\n  constructor(message: string, readonly cause?: unknown) {\n    super(message);\n    this.name = this.constructor.name;\n    // Fix prototype chain for instanceof checks\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Concrete Error Classes\n// ─────────────────────────────────────────────────────────────────\n\n/** Thrown when input validation fails */\nexport class FeedbackValidationError extends FeedbackError {\n  readonly code = 'FEEDBACK_VALIDATION_ERROR';\n  readonly retryable = false;\n\n  constructor(\n    message: string,\n    readonly fields?: string[],\n  ) {\n    super(message);\n    this.name = 'FeedbackValidationError';\n    Object.setPrototypeOf(this, FeedbackValidationError.prototype);\n  }\n}\n\n/** Thrown when the transport layer fails (network, server error) */\nexport class FeedbackTransportError extends FeedbackError {\n  readonly code = 'FEEDBACK_TRANSPORT_ERROR';\n  readonly retryable = true;\n\n  constructor(\n    message: string,\n    readonly statusCode?: number,\n    cause?: unknown,\n  ) {\n    super(message, cause);\n    this.name = 'FeedbackTransportError';\n    Object.setPrototypeOf(this, FeedbackTransportError.prototype);\n  }\n}\n\n/** Thrown when configuration is invalid or missing */\nexport class FeedbackConfigError extends FeedbackError {\n  readonly code = 'FEEDBACK_CONFIG_ERROR';\n  readonly retryable = false;\n\n  constructor(message: string, cause?: unknown) {\n    super(message, cause);\n    this.name = 'FeedbackConfigError';\n    Object.setPrototypeOf(this, FeedbackConfigError.prototype);\n  }\n}\n\n/** Thrown when dialogue exchange fails */\nexport class FeedbackDialogueError extends FeedbackError {\n  readonly code = 'FEEDBACK_DIALOGUE_ERROR';\n  readonly retryable = true;\n\n  constructor(message: string, cause?: unknown) {\n    super(message, cause);\n    this.name = 'FeedbackDialogueError';\n    Object.setPrototypeOf(this, FeedbackDialogueError.prototype);\n  }\n}\n\n/** Thrown when screenshot capture or upload fails */\nexport class FeedbackScreenshotError extends FeedbackError {\n  readonly code = 'FEEDBACK_SCREENSHOT_ERROR';\n  readonly retryable = false;\n\n  constructor(message: string, cause?: unknown) {\n    super(message, cause);\n    this.name = 'FeedbackScreenshotError';\n    Object.setPrototypeOf(this, FeedbackScreenshotError.prototype);\n  }\n}\n\n/** Thrown when a duplicate feedback submission is detected */\nexport class FeedbackDuplicateError extends FeedbackError {\n  readonly code = 'FEEDBACK_DUPLICATE_ERROR';\n  readonly retryable = false;\n\n  constructor(\n    message: string,\n    readonly existingId: string,\n  ) {\n    super(message);\n    this.name = 'FeedbackDuplicateError';\n    Object.setPrototypeOf(this, FeedbackDuplicateError.prototype);\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Type Guard\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Type guard — returns true if the value is a FeedbackError subclass.\n * Returns false for plain Error instances and other values.\n */\nexport function isFeedbackError(e: unknown): e is FeedbackError {\n  return e instanceof FeedbackError;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Error Response Serialiser\n// ─────────────────────────────────────────────────────────────────\n\n/** Safe JSON-serialisable error response */\nexport interface ErrorResponse {\n  code: string;\n  message: string;\n  retryable: boolean;\n  fields?: string[];       // present for FeedbackValidationError\n  existingId?: string;     // present for FeedbackDuplicateError\n}\n\n/**\n * Converts any thrown value to a safe JSON-serialisable response object.\n *\n * - FeedbackError subclasses → uses their code, message, retryable\n * - FeedbackValidationError → includes fields\n * - FeedbackDuplicateError → includes existingId\n * - Plain string → { code: 'UNKNOWN_ERROR', message: theString, retryable: false }\n * - Plain Error → { code: 'UNKNOWN_ERROR', message: error.message, retryable: false }\n * - null/undefined/other → { code: 'UNKNOWN_ERROR', message: 'An unknown error occurred', retryable: false }\n */\nexport function createErrorResponse(e: unknown): ErrorResponse {\n  if (isFeedbackError(e)) {\n    const base: ErrorResponse = {\n      code: e.code,\n      message: e.message,\n      retryable: e.retryable,\n    };\n\n    if (e instanceof FeedbackValidationError && e.fields !== undefined) {\n      base.fields = e.fields;\n    }\n\n    if (e instanceof FeedbackDuplicateError) {\n      base.existingId = e.existingId;\n    }\n\n    return base;\n  }\n\n  if (typeof e === 'string') {\n    return {\n      code: 'UNKNOWN_ERROR',\n      message: e,\n      retryable: false,\n    };\n  }\n\n  if (e instanceof Error) {\n    return {\n      code: 'UNKNOWN_ERROR',\n      message: e.message,\n      retryable: false,\n    };\n  }\n\n  return {\n    code: 'UNKNOWN_ERROR',\n    message: 'An unknown error occurred',\n    retryable: false,\n  };\n}\n"],"names":["e"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/core/capture.ts","../src/core/transport.ts","../src/core/validation.ts","../src/core/transforms.ts","../src/core/errors.ts"],"sourcesContent":["/**\n * Capture logic and priority calculation for feedback submissions.\n *\n * Framework-agnostic — no browser APIs, no DOM, no AWS.\n * Pure data transformation from user input to StoredFeedbackItem.\n */\n\nimport type {\n  FeedbackType,\n  FeedbackStatus,\n  FeedbackEnvironment,\n  FeedbackScope,\n  FeedbackSize,\n  FeedbackContext,\n  StoredFeedbackItem,\n  DialogueEntry,\n  Reporter,\n} from './types.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Input Type\n// ─────────────────────────────────────────────────────────────────\n\n/** Input for processFeedbackCapture */\nexport interface CaptureInput {\n  type: FeedbackType;\n  content: string;\n  context: FeedbackContext;\n  submittedBy: string;\n  appName: string;\n  hasScreenshot: boolean;\n  screenshotS3Key?: string;\n  environment?: FeedbackEnvironment;\n  version?: string;\n  tags?: string[];\n  traceId?: string;\n  dialogueHistory?: DialogueEntry[];\n  classification?: string;\n  scope?: FeedbackScope;\n  size?: FeedbackSize;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Priority Formula\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Base priority scores by feedback type.\n * bug=60, ux=40, feature=20, other=10\n */\nconst BASE_PRIORITY: Record<FeedbackType, number> = {\n  bug: 60,\n  ux: 40,\n  feature: 20,\n  other: 10,\n};\n\n/**\n * Environment bonus scores.\n * production=+20, staging=+10, development=0\n */\nconst ENVIRONMENT_BONUS: Record<FeedbackEnvironment, number> = {\n  production: 20,\n  staging: 10,\n  development: 0,\n};\n\n/**\n * Calculates the priority score for a feedback item.\n *\n * Formula:\n *   base = baseByType (bug=60, ux=40, feature=20, other=10)\n *   env  = environmentBonus (production=+20, staging=+10, development=0)\n *   rep  = min(reporterCount - 1, 5) * 4  (+4 per additional reporter, max +20)\n *   ss   = hasScreenshot ? +5 : 0\n *   priority = clamp(0, 100, base + env + rep + ss)\n */\nexport function calculatePriority(\n  type: FeedbackType,\n  reporterCount: number,\n  hasScreenshot: boolean,\n  environment?: FeedbackEnvironment,\n): number {\n  const base = BASE_PRIORITY[type];\n  const env = ENVIRONMENT_BONUS[environment ?? 'development'];\n  const reporterBonus = Math.min(reporterCount - 1, 5) * 4;\n  const screenshotBonus = hasScreenshot ? 5 : 0;\n\n  const raw = base + env + reporterBonus + screenshotBonus;\n  return Math.max(0, Math.min(100, raw));\n}\n\n// ─────────────────────────────────────────────────────────────────\n// ID Generation\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Generates a unique feedback ID in the format: FB-YYYY-MM-DD-{uuid8}\n * Uses crypto.randomUUID() for uniqueness; truncates to 8 chars.\n */\nexport function generateFeedbackId(nowIso?: string): string {\n  const date = nowIso ? nowIso.slice(0, 10) : new Date().toISOString().slice(0, 10);\n  const uuid8 = crypto.randomUUID().replace(/-/g, '').slice(0, 8);\n  return `FB-${date}-${uuid8}`;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// GSI1SK Builder\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Builds the GSI1SK sort key value.\n * Format: {3-digit-inverted-priority}#{id}\n * Example: priority 85 → '015#FB-2026-07-25-abc12345'\n *\n * Inverted so DynamoDB ascending sort returns highest-priority first.\n */\nexport function buildGSI1SK(priority: number, id: string): string {\n  const inverted = 100 - Math.max(0, Math.min(100, priority));\n  const padded = String(inverted).padStart(3, '0');\n  return `${padded}#${id}`;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Main Capture Processor\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Processes a feedback capture input into a StoredFeedbackItem\n * ready for the transport layer.\n *\n * Sets:\n *   - status: 'open'\n *   - reporterCount: 1\n *   - reporters: [{ userId: submittedBy, addedAt: nowIso }]\n *   - tags: [] when omitted\n *   - All DynamoDB key fields (PK, SK, GSI1PK, GSI1SK, GSI2PK, GSI2SK)\n */\nexport function processFeedbackCapture(\n  input: CaptureInput,\n  nowIso?: string,\n): StoredFeedbackItem {\n  const now = nowIso ?? new Date().toISOString();\n  const id = generateFeedbackId(now);\n  const status: FeedbackStatus = 'new';\n  const tags = input.tags ?? [];\n  const environment = input.environment;\n\n  const priority = calculatePriority(input.type, 1, input.hasScreenshot, environment);\n\n  const reporter: Reporter = {\n    userId: input.submittedBy,\n    addedAt: now,\n  };\n\n  const PK = `PROJECT#${input.appName}`;\n  const SK = `FB#${now}#${id}`;\n  const GSI1PK = `STATUS#${status}`;\n  const GSI1SK = buildGSI1SK(priority, id);\n  const GSI2PK = `TYPE#${input.type}#PROJECT#${input.appName}`;\n  const GSI2SK = now;\n\n  const item: StoredFeedbackItem = {\n    PK,\n    SK,\n    GSI1PK,\n    GSI1SK,\n    GSI2PK,\n    GSI2SK,\n    id,\n    appName: input.appName,\n    type: input.type,\n    status,\n    priority,\n    content: input.content,\n    context: input.context,\n    hasScreenshot: input.hasScreenshot,\n    submittedAt: now,\n    lastModifiedAt: now,\n    submittedBy: input.submittedBy,\n    reporters: [reporter],\n    reporterCount: 1,\n    dialogueHistory: input.dialogueHistory ?? [],\n    corrections: [],\n    tags,\n  };\n\n  // Optional fields — only set when defined\n  if (input.screenshotS3Key !== undefined) {\n    item.screenshotS3Key = input.screenshotS3Key;\n  }\n  if (input.environment !== undefined) {\n    item.environment = input.environment;\n  }\n  if (input.version !== undefined) {\n    item.version = input.version;\n  }\n  if (input.traceId !== undefined) {\n    item.traceId = input.traceId;\n  }\n  if (input.classification !== undefined) {\n    item.classification = input.classification;\n  }\n  if (input.scope !== undefined) {\n    item.scope = input.scope;\n  }\n  if (input.size !== undefined) {\n    item.size = input.size;\n  }\n\n  return item;\n}\n","/**\n * Transport contracts for the feedback package.\n *\n * Defines abstract interfaces that decouple core logic from\n * any specific implementation. Implementations live in the\n * consuming app's server handlers (slice 03).\n *\n * NO AWS SDK imports in this file.\n */\n\nimport type {\n  StoredFeedbackItem,\n  SubmitResult,\n  DialogueResponse,\n  UploadResult,\n  DialogueEntry,\n} from './types.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Transport Interfaces\n// ─────────────────────────────────────────────────────────────────\n\n/** What the React adapter calls at submit time */\nexport interface FeedbackSubmitTransport {\n  submit(item: StoredFeedbackItem): Promise<SubmitResult>;\n}\n\n/** What the dialogue UI calls on each exchange */\nexport interface FeedbackDialogueTransport {\n  exchange(\n    feedbackId: string,\n    message: string,\n    history: DialogueEntry[],\n  ): Promise<DialogueResponse>;\n}\n\n/** What the screenshot capture calls after html2canvas */\nexport interface FeedbackScreenshotTransport {\n  upload(feedbackId: string, blob: Blob): Promise<UploadResult>;\n}\n\n/**\n * Composite transport — all three combined for full-feature transport.\n * Dialogue and screenshot are optional so implementations can omit them.\n */\nexport interface FeedbackTransport\n  extends FeedbackSubmitTransport,\n    Partial<FeedbackDialogueTransport>,\n    Partial<FeedbackScreenshotTransport> {}\n\n// ─────────────────────────────────────────────────────────────────\n// Memory Transport (for testing)\n// ─────────────────────────────────────────────────────────────────\n\n/** Memory transport with access to internal state for assertions */\nexport interface MemoryTransport extends FeedbackTransport {\n  /** All submitted items */\n  submissions: StoredFeedbackItem[];\n  /** Queue of dialogue responses to return in order */\n  dialogueResponses: DialogueResponse[];\n  /** Uploaded screenshot blobs */\n  uploadedScreenshots: Array<{ feedbackId: string; blob: Blob }>;\n  /** Clear all stored state */\n  clear(): void;\n}\n\nconst DEFAULT_DIALOGUE_RESPONSE: DialogueResponse = {\n  success: true,\n  response: 'Thank you for your feedback. Can you tell me more?',\n  conversationComplete: false,\n};\n\n/**\n * Creates an in-memory transport for testing.\n *\n * - submit(): stores the item and returns { success: true, feedbackId: item.id }\n * - exchange(): returns the first queued response, or a default stub\n * - upload(): records the blob reference\n * - Does NOT import any AWS SDK\n */\nexport function createMemoryTransport(): MemoryTransport {\n  const submissions: StoredFeedbackItem[] = [];\n  const dialogueResponses: DialogueResponse[] = [];\n  const uploadedScreenshots: Array<{ feedbackId: string; blob: Blob }> = [];\n\n  return {\n    submissions,\n    dialogueResponses,\n    uploadedScreenshots,\n\n    async submit(item: StoredFeedbackItem): Promise<SubmitResult> {\n      submissions.push(item);\n      return { success: true, feedbackId: item.id };\n    },\n\n    async exchange(\n      feedbackId: string,\n      message: string,\n      history: DialogueEntry[],\n    ): Promise<DialogueResponse> {\n      void feedbackId;\n      void message;\n      void history;\n      if (dialogueResponses.length > 0) {\n        return dialogueResponses.shift() as DialogueResponse;\n      }\n      return { ...DEFAULT_DIALOGUE_RESPONSE };\n    },\n\n    async upload(feedbackId: string, blob: Blob): Promise<UploadResult> {\n      uploadedScreenshots.push({ feedbackId, blob });\n      return {\n        success: true,\n        s3Key: `screenshots/${feedbackId}.png`,\n      };\n    },\n\n    clear() {\n      submissions.length = 0;\n      dialogueResponses.length = 0;\n      uploadedScreenshots.length = 0;\n    },\n  };\n}\n","/**\n * Input validation functions for the feedback package.\n *\n * Used both client-side (before submission) and server-side (in handler).\n * No external dependencies — pure validation logic.\n *\n * Acceptance criteria evidence:\n *   AC-65: createErrorResponse(new FeedbackValidationError('…', ['content']))\n *          ])) includes fields: ['content'] → shown in errors.ts\n *   AC-41: VALIDATION_RULES is exported as const (immutable) with values:\n *          CONTENT_MIN_LENGTH=10, CONTENT_MAX_LENGTH=5000, TAG_MAX_COUNT=10\n *          TAG_PATTERN=/^[a-z0-9-]+$/, [a-z0-9-] pattern applied\n */\n\nimport type { FeedbackContext } from './types.js';\nimport type { CaptureInput } from './capture.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Validation Rules (exported as const — immutable)\n// ─────────────────────────────────────────────────────────────────\n\n/** Immutable validation constants */\nexport const VALIDATION_RULES = {\n  CONTENT_MIN_LENGTH: 10,\n  CONTENT_MAX_LENGTH: 5_000,\n  TAG_MAX_COUNT: 10,\n  TAG_PATTERN: /^[a-z0-9-]+$/,\n  APP_NAME_PATTERN: /^[a-zA-Z0-9_-]+$/,\n  SCREENSHOT_MAX_BYTES: 5_242_880, // 5 MB\n  CONSOLE_ERRORS_MAX: 20,\n} as const;\n\n// ─────────────────────────────────────────────────────────────────\n// Result Type\n// ─────────────────────────────────────────────────────────────────\n\n/** Validation result with user-facing messages */\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];    // Blocking — submission must be rejected\n  warnings: string[]; // Non-blocking — suggestions only\n}\n\nfunction makeResult(errors: string[], warnings: string[]): ValidationResult {\n  return { valid: errors.length === 0, errors, warnings };\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Individual Validators\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Validates feedback content.\n * Fails below CONTENT_MIN_LENGTH (\"Feedback must be at least 10 characters\"),\n * fails above CONTENT_MAX_LENGTH, warns if only whitespace.\n */\nexport function validateContent(content: string): ValidationResult {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  if (content.length < VALIDATION_RULES.CONTENT_MIN_LENGTH) {\n    errors.push(\n      `Feedback must be at least ${VALIDATION_RULES.CONTENT_MIN_LENGTH} characters (got ${content.length})`,\n    );\n  } else if (content.length > VALIDATION_RULES.CONTENT_MAX_LENGTH) {\n    errors.push(\n      `Feedback must not exceed ${VALIDATION_RULES.CONTENT_MAX_LENGTH} characters (got ${content.length})`,\n    );\n  } else if (content.trim().length === 0) {\n    warnings.push('Feedback appears to contain only whitespace');\n  }\n\n  return makeResult(errors, warnings);\n}\n\n/**\n * Validates feedback tags.\n * Fails if count exceeds TAG_MAX_COUNT or if any tag doesn't match TAG_PATTERN.\n */\nexport function validateTags(tags: string[]): ValidationResult {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  if (tags.length > VALIDATION_RULES.TAG_MAX_COUNT) {\n    errors.push(\n      `Too many tags: ${tags.length} (maximum is ${VALIDATION_RULES.TAG_MAX_COUNT})`,\n    );\n  }\n\n  for (const tag of tags) {\n    if (!VALIDATION_RULES.TAG_PATTERN.test(tag)) {\n      errors.push(\n        `Tag \"${tag}\" is invalid — must match /^[a-z0-9-]+$/ (lowercase letters, digits, hyphens only)`,\n      );\n    }\n  }\n\n  return makeResult(errors, warnings);\n}\n\n/**\n * Validates an app name.\n */\nexport function validateAppName(appName: string): ValidationResult {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  if (!appName || appName.trim() === '') {\n    errors.push('appName is required');\n  } else if (!VALIDATION_RULES.APP_NAME_PATTERN.test(appName)) {\n    errors.push(\n      `appName \"${appName}\" is invalid — must match /^[a-zA-Z0-9_-]+$/`,\n    );\n  }\n\n  return makeResult(errors, warnings);\n}\n\n/**\n * Validates screenshot size.\n */\nexport function validateScreenshotSize(sizeBytes: number): ValidationResult {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  if (sizeBytes > VALIDATION_RULES.SCREENSHOT_MAX_BYTES) {\n    errors.push(\n      `Screenshot size ${sizeBytes} bytes exceeds the maximum of ${VALIDATION_RULES.SCREENSHOT_MAX_BYTES} bytes (5 MB)`,\n    );\n  }\n\n  return makeResult(errors, warnings);\n}\n\n/**\n * Validates browser context.\n * Warns if url is empty; warns if consoleErrors exceeds 20 items.\n */\nexport function validateContext(context: FeedbackContext): ValidationResult {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  if (!context.url || context.url.trim() === '') {\n    warnings.push('context.url is empty — this may indicate a capture logic error');\n  }\n\n  if (\n    context.consoleErrors &&\n    context.consoleErrors.length > VALIDATION_RULES.CONSOLE_ERRORS_MAX\n  ) {\n    warnings.push(\n      `context.consoleErrors has ${context.consoleErrors.length} entries (expected ≤${VALIDATION_RULES.CONSOLE_ERRORS_MAX}); truncation should occur in capture layer`,\n    );\n  }\n\n  return makeResult(errors, warnings);\n}\n\n/**\n * Aggregate validator — runs all validators for a capture input.\n */\nexport function validateCaptureInput(input: Partial<CaptureInput>): ValidationResult {\n  const allErrors: string[] = [];\n  const allWarnings: string[] = [];\n\n  if (input.content !== undefined) {\n    const contentResult = validateContent(input.content);\n    allErrors.push(...contentResult.errors);\n    allWarnings.push(...contentResult.warnings);\n  } else {\n    allErrors.push('content is required');\n  }\n\n  if (input.tags !== undefined) {\n    const tagResult = validateTags(input.tags);\n    allErrors.push(...tagResult.errors);\n    allWarnings.push(...tagResult.warnings);\n  }\n\n  if (input.appName !== undefined) {\n    const nameResult = validateAppName(input.appName);\n    allErrors.push(...nameResult.errors);\n    allWarnings.push(...nameResult.warnings);\n  } else {\n    allErrors.push('appName is required');\n  }\n\n  if (input.context !== undefined) {\n    const contextResult = validateContext(input.context);\n    allErrors.push(...contextResult.errors);\n    allWarnings.push(...contextResult.warnings);\n  }\n\n  return makeResult(allErrors, allWarnings);\n}\n","/**\n * Pure data transformation functions for DynamoDB key construction\n * and shape mapping.\n *\n * NO AWS SDK calls — only key construction and shape mapping.\n * All functions are pure: take plain objects, return plain objects.\n * No side effects.\n */\n\nimport type {\n  FeedbackType,\n  FeedbackStatus,\n  StoredFeedbackItem,\n  CorrectionEntry,\n  Reporter,\n} from './types.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Key Builder\n// ─────────────────────────────────────────────────────────────────\n\n/** The six DynamoDB keys for a feedback item */\nexport interface FeedbackKeys {\n  PK: string;      // PROJECT#{appName}\n  SK: string;      // FB#{timestamp}#{id}\n  GSI1PK: string;  // STATUS#{status}\n  GSI1SK: string;  // {inverted-priority-padded}#{id}\n  GSI2PK: string;  // TYPE#{type}#PROJECT#{appName}\n  GSI2SK: string;  // {timestamp}\n}\n\n/**\n * Builds the six DynamoDB keys for a feedback item.\n *\n * @param appName - Application name (e.g. 'sagrosoft20')\n * @param id - Feedback ID (e.g. 'FB-2026-07-25-abc12345')\n * @param type - Feedback type\n * @param status - Current status\n * @param priority - Priority score 0–100\n * @param timestamp - ISO 8601 timestamp\n */\nexport function buildKeys(\n  appName: string,\n  id: string,\n  type: FeedbackType,\n  status: FeedbackStatus,\n  priority: number,\n  timestamp: string,\n): FeedbackKeys {\n  const clampedPriority = Math.max(0, Math.min(100, priority));\n  const inverted = 100 - clampedPriority;\n  const paddedInverted = String(inverted).padStart(3, '0');\n\n  return {\n    PK: `PROJECT#${appName}`,\n    SK: `FB#${timestamp}#${id}`,\n    GSI1PK: `STATUS#${status}`,\n    GSI1SK: `${paddedInverted}#${id}`,\n    GSI2PK: `TYPE#${type}#PROJECT#${appName}`,\n    GSI2SK: timestamp,\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Key Parsers\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Extracts timestamp and id from a composite SK.\n * SK format: FB#{timestamp}#{id}\n */\nexport function parseSK(sk: string): { timestamp: string; id: string } {\n  // SK format: FB#2026-07-25T10:00:00.000Z#FB-2026-07-25-abc12345\n  const withoutPrefix = sk.startsWith('FB#') ? sk.slice(3) : sk;\n  // Find the last '#' which separates timestamp from id\n  const lastHash = withoutPrefix.lastIndexOf('#');\n  if (lastHash === -1) {\n    throw new Error(`Invalid SK format: \"${sk}\" — expected FB#{timestamp}#{id}`);\n  }\n  return {\n    timestamp: withoutPrefix.slice(0, lastHash),\n    id: withoutPrefix.slice(lastHash + 1),\n  };\n}\n\n/**\n * Parses the GSI2PK into its component parts.\n * GSI2PK format: TYPE#{type}#PROJECT#{appName}\n */\nexport function parseGSI2PK(gsi2pk: string): { type: FeedbackType; appName: string } {\n  // Format: TYPE#feature#PROJECT#oms4business\n  const typeMatch = gsi2pk.match(/^TYPE#([^#]+)#PROJECT#(.+)$/);\n  if (!typeMatch || !typeMatch[1] || !typeMatch[2]) {\n    throw new Error(\n      `Invalid GSI2PK format: \"${gsi2pk}\" — expected TYPE#{type}#PROJECT#{appName}`,\n    );\n  }\n  return {\n    type: typeMatch[1] as FeedbackType,\n    appName: typeMatch[2],\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Reporter Mutations (immutable — returns new arrays)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Adds a reporter to an item.\n * Returns new reporters array and updated reporterCount — does NOT mutate original.\n */\nexport function addReporter(\n  item: StoredFeedbackItem,\n  userId: string,\n  addedContext?: string,\n  nowIso?: string,\n): Pick<StoredFeedbackItem, 'reporters' | 'reporterCount' | 'GSI1SK'> {\n  const addedAt = nowIso ?? new Date().toISOString();\n  const newReporter: Reporter = { userId, addedAt };\n  if (addedContext !== undefined) {\n    newReporter.addedContext = addedContext;\n  }\n\n  // Spread to ensure immutability — does NOT mutate item.reporters\n  const newReporters: Reporter[] = [...item.reporters, newReporter];\n  const newCount = newReporters.length;\n\n  // GSI1SK format preserves the inverted priority prefix, just uses same item id\n  // The priority recalculation would normally happen in the capture layer\n  // Here we preserve the existing GSI1SK structure (priority unchanged by reporter add)\n  return {\n    reporters: newReporters,\n    reporterCount: newCount,\n    GSI1SK: item.GSI1SK,\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Correction Mutations (immutable)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Appends a correction record to the corrections array.\n * Returns a new array — does NOT mutate the original.\n */\nexport function appendCorrection(\n  corrections: CorrectionEntry[],\n  correction: Omit<CorrectionEntry, 'correctedAt'>,\n  nowIso?: string,\n): CorrectionEntry[] {\n  const correctedAt = nowIso ?? new Date().toISOString();\n  return [\n    ...corrections,\n    { ...correction, correctedAt },\n  ];\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Status Transition\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Applies a status transition to an item.\n * Returns updated key fields + lastModifiedAt (does NOT mutate original).\n *\n * When transitioning to 'resolved': sets resolvedAt = nowIso.\n * When transitioning to any other status: resolvedAt is undefined.\n */\nexport function applyStatusTransition(\n  item: StoredFeedbackItem,\n  newStatus: FeedbackStatus,\n  nowIso?: string,\n): Pick<\n  StoredFeedbackItem,\n  'status' | 'GSI1PK' | 'GSI1SK' | 'lastModifiedAt' | 'resolvedAt' | 'resolvedBy'\n> {\n  const now = nowIso ?? new Date().toISOString();\n\n  // GSI1SK stays the same (priority doesn't change on status transition)\n  // Only GSI1PK changes (new status)\n  // 'resolvedAt' is stamped when the item reaches the terminal 'closed' state\n  // (the new-lifecycle successor of the legacy 'resolved' value — see normaliseLegacyStatus).\n  const resolvedAt: string | undefined = newStatus === 'closed' ? now : undefined;\n  const resolvedBy: string | undefined = undefined;\n\n  return {\n    status: newStatus,\n    GSI1PK: `STATUS#${newStatus}`,\n    GSI1SK: item.GSI1SK, // Priority unchanged\n    lastModifiedAt: now,\n    ...(resolvedAt !== undefined ? { resolvedAt } : {}),\n    ...(resolvedBy !== undefined ? { resolvedBy } : {}),\n  } as Pick<\n    StoredFeedbackItem,\n    'status' | 'GSI1PK' | 'GSI1SK' | 'lastModifiedAt' | 'resolvedAt' | 'resolvedBy'\n  >;\n}\n","/**\n * Domain error types for the feedback package.\n *\n * Every error class carries:\n *   - code: string constant (usable in switch statements)\n *   - retryable: boolean\n *\n * createErrorResponse converts any thrown value to a safe JSON-serialisable object.\n */\n\n// ─────────────────────────────────────────────────────────────────\n// Base Error Class\n// ─────────────────────────────────────────────────────────────────\n\n/** Base class for all feedback domain errors */\nexport abstract class FeedbackError extends Error {\n  abstract readonly code: string;\n  abstract readonly retryable: boolean;\n\n  constructor(message: string, readonly cause?: unknown) {\n    super(message);\n    this.name = this.constructor.name;\n    // Fix prototype chain for instanceof checks\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Concrete Error Classes\n// ─────────────────────────────────────────────────────────────────\n\n/** Thrown when input validation fails */\nexport class FeedbackValidationError extends FeedbackError {\n  readonly code = 'FEEDBACK_VALIDATION_ERROR';\n  readonly retryable = false;\n\n  constructor(\n    message: string,\n    readonly fields?: string[],\n  ) {\n    super(message);\n    this.name = 'FeedbackValidationError';\n    Object.setPrototypeOf(this, FeedbackValidationError.prototype);\n  }\n}\n\n/** Thrown when the transport layer fails (network, server error) */\nexport class FeedbackTransportError extends FeedbackError {\n  readonly code = 'FEEDBACK_TRANSPORT_ERROR';\n  readonly retryable = true;\n\n  constructor(\n    message: string,\n    readonly statusCode?: number,\n    cause?: unknown,\n  ) {\n    super(message, cause);\n    this.name = 'FeedbackTransportError';\n    Object.setPrototypeOf(this, FeedbackTransportError.prototype);\n  }\n}\n\n/** Thrown when configuration is invalid or missing */\nexport class FeedbackConfigError extends FeedbackError {\n  readonly code = 'FEEDBACK_CONFIG_ERROR';\n  readonly retryable = false;\n\n  constructor(message: string, cause?: unknown) {\n    super(message, cause);\n    this.name = 'FeedbackConfigError';\n    Object.setPrototypeOf(this, FeedbackConfigError.prototype);\n  }\n}\n\n/** Thrown when dialogue exchange fails */\nexport class FeedbackDialogueError extends FeedbackError {\n  readonly code = 'FEEDBACK_DIALOGUE_ERROR';\n  readonly retryable = true;\n\n  constructor(message: string, cause?: unknown) {\n    super(message, cause);\n    this.name = 'FeedbackDialogueError';\n    Object.setPrototypeOf(this, FeedbackDialogueError.prototype);\n  }\n}\n\n/** Thrown when screenshot capture or upload fails */\nexport class FeedbackScreenshotError extends FeedbackError {\n  readonly code = 'FEEDBACK_SCREENSHOT_ERROR';\n  readonly retryable = false;\n\n  constructor(message: string, cause?: unknown) {\n    super(message, cause);\n    this.name = 'FeedbackScreenshotError';\n    Object.setPrototypeOf(this, FeedbackScreenshotError.prototype);\n  }\n}\n\n/** Thrown when a duplicate feedback submission is detected */\nexport class FeedbackDuplicateError extends FeedbackError {\n  readonly code = 'FEEDBACK_DUPLICATE_ERROR';\n  readonly retryable = false;\n\n  constructor(\n    message: string,\n    readonly existingId: string,\n  ) {\n    super(message);\n    this.name = 'FeedbackDuplicateError';\n    Object.setPrototypeOf(this, FeedbackDuplicateError.prototype);\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Type Guard\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Type guard — returns true if the value is a FeedbackError subclass.\n * Returns false for plain Error instances and other values.\n */\nexport function isFeedbackError(e: unknown): e is FeedbackError {\n  return e instanceof FeedbackError;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Error Response Serialiser\n// ─────────────────────────────────────────────────────────────────\n\n/** Safe JSON-serialisable error response */\nexport interface ErrorResponse {\n  code: string;\n  message: string;\n  retryable: boolean;\n  fields?: string[];       // present for FeedbackValidationError\n  existingId?: string;     // present for FeedbackDuplicateError\n}\n\n/**\n * Converts any thrown value to a safe JSON-serialisable response object.\n *\n * - FeedbackError subclasses → uses their code, message, retryable\n * - FeedbackValidationError → includes fields\n * - FeedbackDuplicateError → includes existingId\n * - Plain string → { code: 'UNKNOWN_ERROR', message: theString, retryable: false }\n * - Plain Error → { code: 'UNKNOWN_ERROR', message: error.message, retryable: false }\n * - null/undefined/other → { code: 'UNKNOWN_ERROR', message: 'An unknown error occurred', retryable: false }\n */\nexport function createErrorResponse(e: unknown): ErrorResponse {\n  if (isFeedbackError(e)) {\n    const base: ErrorResponse = {\n      code: e.code,\n      message: e.message,\n      retryable: e.retryable,\n    };\n\n    if (e instanceof FeedbackValidationError && e.fields !== undefined) {\n      base.fields = e.fields;\n    }\n\n    if (e instanceof FeedbackDuplicateError) {\n      base.existingId = e.existingId;\n    }\n\n    return base;\n  }\n\n  if (typeof e === 'string') {\n    return {\n      code: 'UNKNOWN_ERROR',\n      message: e,\n      retryable: false,\n    };\n  }\n\n  if (e instanceof Error) {\n    return {\n      code: 'UNKNOWN_ERROR',\n      message: e.message,\n      retryable: false,\n    };\n  }\n\n  return {\n    code: 'UNKNOWN_ERROR',\n    message: 'An unknown error occurred',\n    retryable: false,\n  };\n}\n"],"names":["e"],"mappings":";;;;AAkDA,MAAM,gBAA8C;AAAA,EAClD,KAAK;AAAA,EACL,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,OAAO;AACT;AAMA,MAAM,oBAAyD;AAAA,EAC7D,YAAY;AAAA,EACZ,SAAS;AAAA,EACT,aAAa;AACf;AAYO,SAAS,kBACd,MACA,eACA,eACA,aACQ;AACR,QAAM,OAAO,cAAc,IAAI;AAC/B,QAAM,MAAM,kBAAkB,eAAe,aAAa;AAC1D,QAAM,gBAAgB,KAAK,IAAI,gBAAgB,GAAG,CAAC,IAAI;AACvD,QAAM,kBAAkB,gBAAgB,IAAI;AAE5C,QAAM,MAAM,OAAO,MAAM,gBAAgB;AACzC,SAAO,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC;AACvC;AAUO,SAAS,mBAAmB,QAAyB;AAC1D,QAAM,OAAO,SAAS,OAAO,MAAM,GAAG,EAAE,KAAI,oBAAI,KAAA,GAAO,YAAA,EAAc,MAAM,GAAG,EAAE;AAChF,QAAM,QAAQ,OAAO,WAAA,EAAa,QAAQ,MAAM,EAAE,EAAE,MAAM,GAAG,CAAC;AAC9D,SAAO,MAAM,IAAI,IAAI,KAAK;AAC5B;AAaO,SAAS,YAAY,UAAkB,IAAoB;AAChE,QAAM,WAAW,MAAM,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,QAAQ,CAAC;AAC1D,QAAM,SAAS,OAAO,QAAQ,EAAE,SAAS,GAAG,GAAG;AAC/C,SAAO,GAAG,MAAM,IAAI,EAAE;AACxB;AAiBO,SAAS,uBACd,OACA,QACoB;AACpB,QAAM,MAAM,WAAU,oBAAI,KAAA,GAAO,YAAA;AACjC,QAAM,KAAK,mBAAmB,GAAG;AACjC,QAAM,SAAyB;AAC/B,QAAM,OAAO,MAAM,QAAQ,CAAA;AAC3B,QAAM,cAAc,MAAM;AAE1B,QAAM,WAAW,kBAAkB,MAAM,MAAM,GAAG,MAAM,eAAe,WAAW;AAElF,QAAM,WAAqB;AAAA,IACzB,QAAQ,MAAM;AAAA,IACd,SAAS;AAAA,EAAA;AAGX,QAAM,KAAK,WAAW,MAAM,OAAO;AACnC,QAAM,KAAK,MAAM,GAAG,IAAI,EAAE;AAC1B,QAAM,SAAS,UAAU,MAAM;AAC/B,QAAM,SAAS,YAAY,UAAU,EAAE;AACvC,QAAM,SAAS,QAAQ,MAAM,IAAI,YAAY,MAAM,OAAO;AAC1D,QAAM,SAAS;AAEf,QAAM,OAA2B;AAAA,IAC/B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,MAAM;AAAA,IACf,MAAM,MAAM;AAAA,IACZ;AAAA,IACA;AAAA,IACA,SAAS,MAAM;AAAA,IACf,SAAS,MAAM;AAAA,IACf,eAAe,MAAM;AAAA,IACrB,aAAa;AAAA,IACb,gBAAgB;AAAA,IAChB,aAAa,MAAM;AAAA,IACnB,WAAW,CAAC,QAAQ;AAAA,IACpB,eAAe;AAAA,IACf,iBAAiB,MAAM,mBAAmB,CAAA;AAAA,IAC1C,aAAa,CAAA;AAAA,IACb;AAAA,EAAA;AAIF,MAAI,MAAM,oBAAoB,QAAW;AACvC,SAAK,kBAAkB,MAAM;AAAA,EAC/B;AACA,MAAI,MAAM,gBAAgB,QAAW;AACnC,SAAK,cAAc,MAAM;AAAA,EAC3B;AACA,MAAI,MAAM,YAAY,QAAW;AAC/B,SAAK,UAAU,MAAM;AAAA,EACvB;AACA,MAAI,MAAM,YAAY,QAAW;AAC/B,SAAK,UAAU,MAAM;AAAA,EACvB;AACA,MAAI,MAAM,mBAAmB,QAAW;AACtC,SAAK,iBAAiB,MAAM;AAAA,EAC9B;AACA,MAAI,MAAM,UAAU,QAAW;AAC7B,SAAK,QAAQ,MAAM;AAAA,EACrB;AACA,MAAI,MAAM,SAAS,QAAW;AAC5B,SAAK,OAAO,MAAM;AAAA,EACpB;AAEA,SAAO;AACT;ACjJA,MAAM,4BAA8C;AAAA,EAClD,SAAS;AAAA,EACT,UAAU;AAAA,EACV,sBAAsB;AACxB;AAUO,SAAS,wBAAyC;AACvD,QAAM,cAAoC,CAAA;AAC1C,QAAM,oBAAwC,CAAA;AAC9C,QAAM,sBAAiE,CAAA;AAEvE,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IAEA,MAAM,OAAO,MAAiD;AAC5D,kBAAY,KAAK,IAAI;AACrB,aAAO,EAAE,SAAS,MAAM,YAAY,KAAK,GAAA;AAAA,IAC3C;AAAA,IAEA,MAAM,SACJ,YACA,SACA,SAC2B;AAI3B,UAAI,kBAAkB,SAAS,GAAG;AAChC,eAAO,kBAAkB,MAAA;AAAA,MAC3B;AACA,aAAO,EAAE,GAAG,0BAAA;AAAA,IACd;AAAA,IAEA,MAAM,OAAO,YAAoB,MAAmC;AAClE,0BAAoB,KAAK,EAAE,YAAY,KAAA,CAAM;AAC7C,aAAO;AAAA,QACL,SAAS;AAAA,QACT,OAAO,eAAe,UAAU;AAAA,MAAA;AAAA,IAEpC;AAAA,IAEA,QAAQ;AACN,kBAAY,SAAS;AACrB,wBAAkB,SAAS;AAC3B,0BAAoB,SAAS;AAAA,IAC/B;AAAA,EAAA;AAEJ;ACrGO,MAAM,mBAAmB;AAAA,EAC9B,oBAAoB;AAAA,EACpB,oBAAoB;AAAA,EACpB,eAAe;AAAA,EACf,aAAa;AAAA,EACb,kBAAkB;AAAA,EAClB,sBAAsB;AAAA;AAAA,EACtB,oBAAoB;AACtB;AAaA,SAAS,WAAW,QAAkB,UAAsC;AAC1E,SAAO,EAAE,OAAO,OAAO,WAAW,GAAG,QAAQ,SAAA;AAC/C;AAWO,SAAS,gBAAgB,SAAmC;AACjE,QAAM,SAAmB,CAAA;AACzB,QAAM,WAAqB,CAAA;AAE3B,MAAI,QAAQ,SAAS,iBAAiB,oBAAoB;AACxD,WAAO;AAAA,MACL,6BAA6B,iBAAiB,kBAAkB,oBAAoB,QAAQ,MAAM;AAAA,IAAA;AAAA,EAEtG,WAAW,QAAQ,SAAS,iBAAiB,oBAAoB;AAC/D,WAAO;AAAA,MACL,4BAA4B,iBAAiB,kBAAkB,oBAAoB,QAAQ,MAAM;AAAA,IAAA;AAAA,EAErG,WAAW,QAAQ,KAAA,EAAO,WAAW,GAAG;AACtC,aAAS,KAAK,6CAA6C;AAAA,EAC7D;AAEA,SAAO,WAAW,QAAQ,QAAQ;AACpC;AAMO,SAAS,aAAa,MAAkC;AAC7D,QAAM,SAAmB,CAAA;AACzB,QAAM,WAAqB,CAAA;AAE3B,MAAI,KAAK,SAAS,iBAAiB,eAAe;AAChD,WAAO;AAAA,MACL,kBAAkB,KAAK,MAAM,gBAAgB,iBAAiB,aAAa;AAAA,IAAA;AAAA,EAE/E;AAEA,aAAW,OAAO,MAAM;AACtB,QAAI,CAAC,iBAAiB,YAAY,KAAK,GAAG,GAAG;AAC3C,aAAO;AAAA,QACL,QAAQ,GAAG;AAAA,MAAA;AAAA,IAEf;AAAA,EACF;AAEA,SAAO,WAAW,QAAQ,QAAQ;AACpC;AAKO,SAAS,gBAAgB,SAAmC;AACjE,QAAM,SAAmB,CAAA;AACzB,QAAM,WAAqB,CAAA;AAE3B,MAAI,CAAC,WAAW,QAAQ,KAAA,MAAW,IAAI;AACrC,WAAO,KAAK,qBAAqB;AAAA,EACnC,WAAW,CAAC,iBAAiB,iBAAiB,KAAK,OAAO,GAAG;AAC3D,WAAO;AAAA,MACL,YAAY,OAAO;AAAA,IAAA;AAAA,EAEvB;AAEA,SAAO,WAAW,QAAQ,QAAQ;AACpC;AAKO,SAAS,uBAAuB,WAAqC;AAC1E,QAAM,SAAmB,CAAA;AACzB,QAAM,WAAqB,CAAA;AAE3B,MAAI,YAAY,iBAAiB,sBAAsB;AACrD,WAAO;AAAA,MACL,mBAAmB,SAAS,iCAAiC,iBAAiB,oBAAoB;AAAA,IAAA;AAAA,EAEtG;AAEA,SAAO,WAAW,QAAQ,QAAQ;AACpC;AAMO,SAAS,gBAAgB,SAA4C;AAC1E,QAAM,SAAmB,CAAA;AACzB,QAAM,WAAqB,CAAA;AAE3B,MAAI,CAAC,QAAQ,OAAO,QAAQ,IAAI,KAAA,MAAW,IAAI;AAC7C,aAAS,KAAK,gEAAgE;AAAA,EAChF;AAEA,MACE,QAAQ,iBACR,QAAQ,cAAc,SAAS,iBAAiB,oBAChD;AACA,aAAS;AAAA,MACP,6BAA6B,QAAQ,cAAc,MAAM,uBAAuB,iBAAiB,kBAAkB;AAAA,IAAA;AAAA,EAEvH;AAEA,SAAO,WAAW,QAAQ,QAAQ;AACpC;AAKO,SAAS,qBAAqB,OAAgD;AACnF,QAAM,YAAsB,CAAA;AAC5B,QAAM,cAAwB,CAAA;AAE9B,MAAI,MAAM,YAAY,QAAW;AAC/B,UAAM,gBAAgB,gBAAgB,MAAM,OAAO;AACnD,cAAU,KAAK,GAAG,cAAc,MAAM;AACtC,gBAAY,KAAK,GAAG,cAAc,QAAQ;AAAA,EAC5C,OAAO;AACL,cAAU,KAAK,qBAAqB;AAAA,EACtC;AAEA,MAAI,MAAM,SAAS,QAAW;AAC5B,UAAM,YAAY,aAAa,MAAM,IAAI;AACzC,cAAU,KAAK,GAAG,UAAU,MAAM;AAClC,gBAAY,KAAK,GAAG,UAAU,QAAQ;AAAA,EACxC;AAEA,MAAI,MAAM,YAAY,QAAW;AAC/B,UAAM,aAAa,gBAAgB,MAAM,OAAO;AAChD,cAAU,KAAK,GAAG,WAAW,MAAM;AACnC,gBAAY,KAAK,GAAG,WAAW,QAAQ;AAAA,EACzC,OAAO;AACL,cAAU,KAAK,qBAAqB;AAAA,EACtC;AAEA,MAAI,MAAM,YAAY,QAAW;AAC/B,UAAM,gBAAgB,gBAAgB,MAAM,OAAO;AACnD,cAAU,KAAK,GAAG,cAAc,MAAM;AACtC,gBAAY,KAAK,GAAG,cAAc,QAAQ;AAAA,EAC5C;AAEA,SAAO,WAAW,WAAW,WAAW;AAC1C;ACzJO,SAAS,UACd,SACA,IACA,MACA,QACA,UACA,WACc;AACd,QAAM,kBAAkB,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,QAAQ,CAAC;AAC3D,QAAM,WAAW,MAAM;AACvB,QAAM,iBAAiB,OAAO,QAAQ,EAAE,SAAS,GAAG,GAAG;AAEvD,SAAO;AAAA,IACL,IAAI,WAAW,OAAO;AAAA,IACtB,IAAI,MAAM,SAAS,IAAI,EAAE;AAAA,IACzB,QAAQ,UAAU,MAAM;AAAA,IACxB,QAAQ,GAAG,cAAc,IAAI,EAAE;AAAA,IAC/B,QAAQ,QAAQ,IAAI,YAAY,OAAO;AAAA,IACvC,QAAQ;AAAA,EAAA;AAEZ;AAUO,SAAS,QAAQ,IAA+C;AAErE,QAAM,gBAAgB,GAAG,WAAW,KAAK,IAAI,GAAG,MAAM,CAAC,IAAI;AAE3D,QAAM,WAAW,cAAc,YAAY,GAAG;AAC9C,MAAI,aAAa,IAAI;AACnB,UAAM,IAAI,MAAM,uBAAuB,EAAE,kCAAkC;AAAA,EAC7E;AACA,SAAO;AAAA,IACL,WAAW,cAAc,MAAM,GAAG,QAAQ;AAAA,IAC1C,IAAI,cAAc,MAAM,WAAW,CAAC;AAAA,EAAA;AAExC;AAMO,SAAS,YAAY,QAAyD;AAEnF,QAAM,YAAY,OAAO,MAAM,6BAA6B;AAC5D,MAAI,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG;AAChD,UAAM,IAAI;AAAA,MACR,2BAA2B,MAAM;AAAA,IAAA;AAAA,EAErC;AACA,SAAO;AAAA,IACL,MAAM,UAAU,CAAC;AAAA,IACjB,SAAS,UAAU,CAAC;AAAA,EAAA;AAExB;AAUO,SAAS,YACd,MACA,QACA,cACA,QACoE;AACpE,QAAM,UAAU,WAAU,oBAAI,KAAA,GAAO,YAAA;AACrC,QAAM,cAAwB,EAAE,QAAQ,QAAA;AACxC,MAAI,iBAAiB,QAAW;AAC9B,gBAAY,eAAe;AAAA,EAC7B;AAGA,QAAM,eAA2B,CAAC,GAAG,KAAK,WAAW,WAAW;AAChE,QAAM,WAAW,aAAa;AAK9B,SAAO;AAAA,IACL,WAAW;AAAA,IACX,eAAe;AAAA,IACf,QAAQ,KAAK;AAAA,EAAA;AAEjB;AAUO,SAAS,iBACd,aACA,YACA,QACmB;AACnB,QAAM,cAAc,WAAU,oBAAI,KAAA,GAAO,YAAA;AACzC,SAAO;AAAA,IACL,GAAG;AAAA,IACH,EAAE,GAAG,YAAY,YAAA;AAAA,EAAY;AAEjC;AAaO,SAAS,sBACd,MACA,WACA,QAIA;AACA,QAAM,MAAM,WAAU,oBAAI,KAAA,GAAO,YAAA;AAMjC,QAAM,aAAiC,cAAc,WAAW,MAAM;AAGtE,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,QAAQ,UAAU,SAAS;AAAA,IAC3B,QAAQ,KAAK;AAAA;AAAA,IACb,gBAAgB;AAAA,IAChB,GAAI,eAAe,SAAY,EAAE,WAAA,IAAe,CAAA;AAAA,IAChD,GAAgD,CAAA;AAAA,EAAC;AAKrD;ACrLO,MAAe,sBAAsB,MAAM;AAAA,EAIhD,YAAY,SAA0B,OAAiB;AACrD,UAAM,OAAO;AADuB,SAAA,QAAA;AAEpC,SAAK,OAAO,KAAK,YAAY;AAE7B,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EAClD;AACF;AAOO,MAAM,gCAAgC,cAAc;AAAA,EAIzD,YACE,SACS,QACT;AACA,UAAM,OAAO;AAFJ,SAAA,SAAA;AAGT,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,wBAAwB,SAAS;AAAA,EAC/D;AAAA,EAVS,OAAO;AAAA,EACP,YAAY;AAUvB;AAGO,MAAM,+BAA+B,cAAc;AAAA,EAIxD,YACE,SACS,YACT,OACA;AACA,UAAM,SAAS,KAAK;AAHX,SAAA,aAAA;AAIT,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,uBAAuB,SAAS;AAAA,EAC9D;AAAA,EAXS,OAAO;AAAA,EACP,YAAY;AAWvB;AAGO,MAAM,4BAA4B,cAAc;AAAA,EAC5C,OAAO;AAAA,EACP,YAAY;AAAA,EAErB,YAAY,SAAiB,OAAiB;AAC5C,UAAM,SAAS,KAAK;AACpB,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,oBAAoB,SAAS;AAAA,EAC3D;AACF;AAGO,MAAM,8BAA8B,cAAc;AAAA,EAC9C,OAAO;AAAA,EACP,YAAY;AAAA,EAErB,YAAY,SAAiB,OAAiB;AAC5C,UAAM,SAAS,KAAK;AACpB,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,sBAAsB,SAAS;AAAA,EAC7D;AACF;AAGO,MAAM,gCAAgC,cAAc;AAAA,EAChD,OAAO;AAAA,EACP,YAAY;AAAA,EAErB,YAAY,SAAiB,OAAiB;AAC5C,UAAM,SAAS,KAAK;AACpB,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,wBAAwB,SAAS;AAAA,EAC/D;AACF;AAGO,MAAM,+BAA+B,cAAc;AAAA,EAIxD,YACE,SACS,YACT;AACA,UAAM,OAAO;AAFJ,SAAA,aAAA;AAGT,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,uBAAuB,SAAS;AAAA,EAC9D;AAAA,EAVS,OAAO;AAAA,EACP,YAAY;AAUvB;AAUO,SAAS,gBAAgBA,IAAgC;AAC9D,SAAOA,cAAa;AACtB;AAyBO,SAAS,oBAAoBA,IAA2B;AAC7D,MAAI,gBAAgBA,EAAC,GAAG;AACtB,UAAM,OAAsB;AAAA,MAC1B,MAAMA,GAAE;AAAA,MACR,SAASA,GAAE;AAAA,MACX,WAAWA,GAAE;AAAA,IAAA;AAGf,QAAIA,cAAa,2BAA2BA,GAAE,WAAW,QAAW;AAClE,WAAK,SAASA,GAAE;AAAA,IAClB;AAEA,QAAIA,cAAa,wBAAwB;AACvC,WAAK,aAAaA,GAAE;AAAA,IACtB;AAEA,WAAO;AAAA,EACT;AAEA,MAAI,OAAOA,OAAM,UAAU;AACzB,WAAO;AAAA,MACL,MAAM;AAAA,MACN,SAASA;AAAA,MACT,WAAW;AAAA,IAAA;AAAA,EAEf;AAEA,MAAIA,cAAa,OAAO;AACtB,WAAO;AAAA,MACL,MAAM;AAAA,MACN,SAASA,GAAE;AAAA,MACX,WAAW;AAAA,IAAA;AAAA,EAEf;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IACT,WAAW;AAAA,EAAA;AAEf;"}

package/dist/react/admin/ActivityTimeline.d.ts

@@ -0,0 +1,9 @@
+import { ActivityEntry } from '../../core/types.js';
+import * as React from 'react';
+interface ActivityTimelineProps {
+    activity: ActivityEntry[];
+    className?: string;
+}
+export declare function ActivityTimeline({ activity, className }: ActivityTimelineProps): React.ReactElement;
+export {};
+//# sourceMappingURL=ActivityTimeline.d.ts.map

package/dist/react/admin/ActivityTimeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityTimeline.d.ts","sourceRoot":"","sources":["../../../src/react/admin/ActivityTimeline.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CAuBnG"}

package/dist/react/admin/AnnotationComposer.d.ts

@@ -0,0 +1,30 @@
+import { StoredFeedbackItem } from '../../core/types.js';
+import { FeedbackAnnotateClient } from '../../core/ingest-transport.js';
+import { CapabilityKey } from './hooks/can.js';
+/**
+ * AnnotationComposer.tsx
+ * Location: src/react/admin/AnnotationComposer.tsx
+ *
+ * Capability-gated comment/note/question/answer form calling appendActivity.
+ * Surfaces AnnotateResult.conflictReason inline.
+ * Hidden entirely when no annotation capability is allowed.
+ */
+import * as React from 'react';
+export interface AnnotationComposerProps {
+    feedbackId: string;
+    item: StoredFeedbackItem;
+    currentUser: {
+        userId: string;
+        name?: string;
+    };
+    can: (cap: CapabilityKey) => boolean;
+    appendActivity: FeedbackAnnotateClient['appendActivity'];
+    appSource: string;
+    onAppended?: () => void;
+}
+/**
+ * AnnotationComposer calls appendActivity with a correctly-constructed ActivityEntry
+ * (id, actor, occurredAt, recordedAt, source, kind, body, schemaVersion) on submit.
+ */
+export declare const AnnotationComposer: React.ForwardRefExoticComponent<AnnotationComposerProps & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=AnnotationComposer.d.ts.map

package/dist/react/admin/AnnotationComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnnotationComposer.d.ts","sourceRoot":"","sources":["../../../src/react/admin/AnnotationComposer.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,kBAAkB,EAAiB,MAAM,qBAAqB,CAAC;AAC7E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,GAAG,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC;IACrC,cAAc,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,gGAwG9B,CAAC"}

package/dist/react/admin/FeedbackListPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FeedbackListPage.d.ts","sourceRoot":"","sources":["../../../src/react/admin/FeedbackListPage.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAsB,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAiBxD,iBAAS,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,qBAE1D;AAED,iBAAS,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,qBAElD;AAED,QAAA,MAAM,gBAAgB,8FA0FrB,CAAC;AAGF,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"FeedbackListPage.d.ts","sourceRoot":"","sources":["../../../src/react/admin/FeedbackListPage.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAsB,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAwBxD,iBAAS,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,qBAE1D;AAED,iBAAS,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,qBAElD;AAED,QAAA,MAAM,gBAAgB,8FA0FrB,CAAC;AAGF,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC"}

package/dist/react/admin/FeedbackUpdatePage.d.ts

@@ -3,6 +3,12 @@ import { FeedbackUpdatePageProps } from './types.js';
  * FeedbackUpdatePage.tsx
  * Location: src/react/admin/FeedbackUpdatePage.tsx
  *
+ * @deprecated This component is deprecated and will be removed in a future version.
+ * Use FeedbackAnnotateClient.appendActivity() and FeedbackAnnotateClient.transitionStatus()
+ * from ingest-transport.ts instead. The whole-array corrections[] PATCH has been removed
+ * to prevent data loss (sagrosoft20-class silent drop). This shell is kept for backward
+ * compatibility during stage-3 consumer migration.
+ *
  * Admin update page for editing mutable fields of a feedback item.
  * Uses UpdatePage + EnumField + TextField + TextareaField from anton-bakker-tailwind-components.
  */

package/dist/react/admin/FeedbackUpdatePage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FeedbackUpdatePage.d.ts","sourceRoot":"","sources":["../../../src/react/admin/FeedbackUpdatePage.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAiC1D,QAAA,MAAM,kBAAkB,gGAiMvB,CAAC;AAGF,OAAO,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"FeedbackUpdatePage.d.ts","sourceRoot":"","sources":["../../../src/react/admin/FeedbackUpdatePage.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAiC1D,QAAA,MAAM,kBAAkB,gGA6LvB,CAAC;AAGF,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/react/admin/LifecycleControls.d.ts

@@ -0,0 +1,28 @@
+import { StoredFeedbackItem } from '../../core/types.js';
+import { FeedbackAnnotateClient } from '../../core/ingest-transport.js';
+import { CapabilityKey } from './hooks/can.js';
+/**
+ * LifecycleControls.tsx
+ * Location: src/react/admin/LifecycleControls.tsx
+ *
+ * Legal+authorized transition buttons, assignment, duplicate merge via transitionStatus.
+ * Surfaces AnnotateResult.conflictReason inline.
+ * Renders only transition buttons for targets where can(requiredCapability) is true.
+ */
+import * as React from 'react';
+export interface LifecycleControlsProps {
+    feedbackId: string;
+    item: StoredFeedbackItem;
+    currentUser: {
+        userId: string;
+        name?: string;
+    };
+    can: (cap: CapabilityKey) => boolean;
+    transitionStatus: FeedbackAnnotateClient['transitionStatus'];
+    onTransitioned?: () => void;
+}
+/**
+ * LifecycleControls renders only transition buttons for targets where can(requiredCapability) is true.
+ */
+export declare const LifecycleControls: React.ForwardRefExoticComponent<LifecycleControlsProps & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=LifecycleControls.d.ts.map

package/dist/react/admin/LifecycleControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LifecycleControls.d.ts","sourceRoot":"","sources":["../../../src/react/admin/LifecycleControls.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,kBAAkB,EAAkB,MAAM,qBAAqB,CAAC;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAA2B,MAAM,gCAAgC,CAAC;AACtG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,GAAG,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC;IACrC,gBAAgB,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;IAC7D,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AA8BD;;GAEG;AACH,eAAO,MAAM,iBAAiB,+FA6H7B,CAAC"}

package/dist/react/admin/__tests__/ActivityTimeline.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ActivityTimeline.test.d.ts.map

package/dist/react/admin/__tests__/ActivityTimeline.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityTimeline.test.d.ts","sourceRoot":"","sources":["../../../../src/react/admin/__tests__/ActivityTimeline.test.tsx"],"names":[],"mappings":""}

package/dist/react/admin/__tests__/AnnotationComposer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AnnotationComposer.test.d.ts.map

package/dist/react/admin/__tests__/AnnotationComposer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnnotationComposer.test.d.ts","sourceRoot":"","sources":["../../../../src/react/admin/__tests__/AnnotationComposer.test.tsx"],"names":[],"mappings":""}

package/dist/react/admin/__tests__/LifecycleControls.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=LifecycleControls.test.d.ts.map

package/dist/react/admin/__tests__/LifecycleControls.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LifecycleControls.test.d.ts","sourceRoot":"","sources":["../../../../src/react/admin/__tests__/LifecycleControls.test.tsx"],"names":[],"mappings":""}

package/dist/react/admin/hooks/can.d.ts

@@ -0,0 +1,47 @@
+import { StoredFeedbackItem } from '../../../core/types.js';
+
+/**
+ * Capability keys for feedback operations.
+ * Each key grants permission for a specific action on feedback items.
+ */
+export type CapabilityKey = 'feedback:comment' | 'feedback:annotate' | 'feedback:triage' | 'feedback:assign' | 'feedback:resolve' | 'feedback:verify' | 'feedback:reopen' | 'feedback:reject' | 'feedback:delete';
+/**
+ * Record mapping each capability key to itself.
+ * Facilitates autocomplete and exhaustiveness checking.
+ */
+export declare const CAPABILITIES: Record<CapabilityKey, CapabilityKey>;
+/**
+ * User identity with resolved capabilities.
+ * Consuming apps (PEP) translate their identity system to this format at the system boundary.
+ */
+export interface CapabilityUser {
+    userId: string;
+    capabilities: Set<CapabilityKey>;
+}
+/** Alias for CapabilityUser — both names refer to the same type. */
+export type UserWithCapabilities = CapabilityUser;
+/**
+ * Pure capability-based authorization guard.
+ * Returns true if the user has the specified capability OR if ownership rules grant it.
+ *
+ * Ownership rules:
+ * - Submitters (userId === item.submittedBy) can comment and annotate without explicit capability
+ * - Reporters (userId in item.reporters[].userId) can comment and annotate without explicit capability
+ * - All other capabilities require explicit presence in user.capabilities
+ *
+ * @param capability - The capability being checked
+ * @param item - The feedback item
+ * @param user - The user with resolved capabilities
+ * @returns true if authorized, false otherwise
+ *
+ * @example
+ * const user = { userId: 'alice', capabilities: new Set(['feedback:triage']) };
+ * can('feedback:triage', item, user)  // → true (explicit capability)
+ * can('feedback:comment', item, user) // → false (no capability, not owner)
+ *
+ * const submitter = { userId: item.submittedBy, capabilities: new Set([]) };
+ * can('feedback:comment', item, submitter) // → true (ownership rule)
+ * can('feedback:triage', item, submitter)  // → false (ownership doesn't grant admin capabilities)
+ */
+export declare function can(capability: CapabilityKey, item: StoredFeedbackItem, user: CapabilityUser): boolean;
+//# sourceMappingURL=can.d.ts.map

package/dist/react/admin/hooks/can.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"can.d.ts","sourceRoot":"","sources":["../../../../src/react/admin/hooks/can.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB,kBAAkB,GAClB,mBAAmB,GACnB,iBAAiB,GACjB,iBAAiB,GACjB,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,aAAa,EAAE,aAAa,CAU7D,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;CAClC;AAED,oEAAoE;AACpE,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,GAAG,CACjB,UAAU,EAAE,aAAa,EACzB,IAAI,EAAE,kBAAkB,EACxB,IAAI,EAAE,cAAc,GACnB,OAAO,CAiBT"}

package/dist/react/admin/hooks/useStatusTransition.d.ts

@@ -1,5 +1,19 @@
 import { FeedbackStatus } from '../../../core/types.js';
 
+/**
+ * Exhaustive legal transitions for the 12-state QA lifecycle. Readonly so consumers and
+ * tests can enumerate legal pairs. No self-loops.
+ */
+export declare const QA_LIFECYCLE_TRANSITIONS: Readonly<Record<FeedbackStatus, readonly FeedbackStatus[]>>;
+/**
+ * Pure predicate: is a transition from `from` to `to` legal in the QA lifecycle?
+ * Self-transitions are never legal.
+ *
+ * @param from - current status
+ * @param to - proposed target status
+ * @returns true if the transition is encoded in QA_LIFECYCLE_TRANSITIONS
+ */
+export declare function canTransitionTo(from: FeedbackStatus, to: FeedbackStatus): boolean;
 export interface UseStatusTransitionResult {
     /** Statuses reachable from the current status (current status excluded) */
     allowedTargets: FeedbackStatus[];
@@ -11,8 +25,8 @@ export interface UseStatusTransitionResult {
  * @returns Object with `allowedTargets` — statuses the item can transition to
  *
  * @example
- * const { allowedTargets } = useStatusTransition('open');
- * // allowedTargets → ['approved', 'deferred', 'wontfix']
+ * const { allowedTargets } = useStatusTransition('new');
+ * // allowedTargets → ['triaged']
  */
 export declare function useStatusTransition(currentStatus: FeedbackStatus): UseStatusTransitionResult;
 //# sourceMappingURL=useStatusTransition.d.ts.map