uidex 0.2.1 → 0.3.0

package/dist/cloud/index.cjs

@@ -0,0 +1,149 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/cloud/index.ts
+var cloud_exports = {};
+__export(cloud_exports, {
+  CloudError: () => CloudError,
+  DEFAULT_CLOUD_ENDPOINT: () => DEFAULT_CLOUD_ENDPOINT,
+  cloud: () => cloud
+});
+module.exports = __toCommonJS(cloud_exports);
+
+// src/cloud/types.ts
+var DEFAULT_CLOUD_ENDPOINT = "https://app.uidex.dev";
+var CloudError = class extends Error {
+  status;
+  retryAfter;
+  details;
+  constructor(message, options) {
+    super(message);
+    this.name = "CloudError";
+    this.status = options.status;
+    this.retryAfter = options.retryAfter;
+    this.details = options.details;
+  }
+};
+
+// src/cloud/client.ts
+function resolveFetch(override) {
+  if (override) return override;
+  if (typeof globalThis !== "undefined" && typeof globalThis.fetch === "function") {
+    return globalThis.fetch.bind(globalThis);
+  }
+  throw new Error(
+    "uidex/cloud: global fetch is not available; pass a `fetch` override"
+  );
+}
+function trimEndpoint(endpoint) {
+  return endpoint.endsWith("/") ? endpoint.slice(0, -1) : endpoint;
+}
+function parseRetryAfter(header) {
+  if (!header) return void 0;
+  const seconds = Number(header);
+  if (Number.isFinite(seconds) && seconds >= 0) return seconds;
+  const date = Date.parse(header);
+  if (Number.isFinite(date)) {
+    const delta = Math.ceil((date - Date.now()) / 1e3);
+    return delta > 0 ? delta : 0;
+  }
+  return void 0;
+}
+async function readBody(response) {
+  const text = await response.text();
+  if (!text) return void 0;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+function errorMessage(body, fallback) {
+  if (body && typeof body === "object" && "error" in body && typeof body.error === "string") {
+    return body.error;
+  }
+  return fallback;
+}
+function cloud(options) {
+  const projectKey = options.projectKey;
+  if (!projectKey) {
+    throw new Error("uidex/cloud: `projectKey` is required");
+  }
+  const endpoint = trimEndpoint(options.endpoint ?? DEFAULT_CLOUD_ENDPOINT);
+  const fetchImpl = resolveFetch(options.fetch);
+  const authHeader = `Bearer ${projectKey}`;
+  async function submit(payload) {
+    const response = await fetchImpl(`${endpoint}/api/ingest`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: authHeader
+      },
+      body: JSON.stringify(payload)
+    });
+    const body = await readBody(response);
+    if (!response.ok) {
+      const retryAfter = response.status === 429 ? parseRetryAfter(response.headers.get("Retry-After")) : void 0;
+      throw new CloudError(
+        errorMessage(body, `Feedback submission failed (${response.status})`),
+        { status: response.status, retryAfter, details: body }
+      );
+    }
+    if (!body || typeof body !== "object") {
+      throw new CloudError("Feedback submission returned an empty response", {
+        status: response.status
+      });
+    }
+    return body;
+  }
+  async function getConfig() {
+    const response = await fetchImpl(`${endpoint}/api/ingest/config`, {
+      method: "GET",
+      headers: {
+        Accept: "application/json",
+        Authorization: authHeader
+      }
+    });
+    const body = await readBody(response);
+    if (!response.ok) {
+      const retryAfter = response.status === 429 ? parseRetryAfter(response.headers.get("Retry-After")) : void 0;
+      throw new CloudError(
+        errorMessage(body, `Ingest config request failed (${response.status})`),
+        { status: response.status, retryAfter, details: body }
+      );
+    }
+    if (!body || typeof body !== "object") {
+      throw new CloudError("Ingest config returned an empty response", {
+        status: response.status
+      });
+    }
+    return body;
+  }
+  return {
+    feedback: { submit },
+    integrations: { getConfig }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CloudError,
+  DEFAULT_CLOUD_ENDPOINT,
+  cloud
+});
+//# sourceMappingURL=index.cjs.map

package/dist/cloud/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cloud/index.ts","../../src/cloud/types.ts","../../src/cloud/client.ts"],"sourcesContent":["export { cloud } from \"./client\"\nexport {\n  CloudError,\n  DEFAULT_CLOUD_ENDPOINT,\n  type CloudAdapter,\n  type CloudOptions,\n  type FeedbackExternalLink,\n  type FeedbackPayload,\n  type FeedbackResult,\n  type FeedbackSuggestedTarget,\n  type IngestConfig,\n  type IngestConfigEpic,\n  type SourceRef,\n} from \"./types\"\n","export type {\n  CloudAdapter,\n  FeedbackExternalLink,\n  FeedbackPayload,\n  FeedbackResult,\n  FeedbackSuggestedTarget,\n  IngestConfig,\n  IngestConfigEpic,\n  SourceRef,\n} from \"../ingest/feedback-contract\"\n\nexport const DEFAULT_CLOUD_ENDPOINT = \"https://app.uidex.dev\"\n\nexport interface CloudOptions {\n  projectKey: string\n  endpoint?: string\n  fetch?: typeof fetch\n}\n\nexport class CloudError extends Error {\n  readonly status: number\n  readonly retryAfter?: number\n  readonly details?: unknown\n\n  constructor(\n    message: string,\n    options: { status: number; retryAfter?: number; details?: unknown }\n  ) {\n    super(message)\n    this.name = \"CloudError\"\n    this.status = options.status\n    this.retryAfter = options.retryAfter\n    this.details = options.details\n  }\n}\n","import {\n  CloudError,\n  DEFAULT_CLOUD_ENDPOINT,\n  type CloudAdapter,\n  type CloudOptions,\n  type FeedbackPayload,\n  type FeedbackResult,\n  type IngestConfig,\n} from \"./types\"\n\nfunction resolveFetch(override?: typeof fetch): typeof fetch {\n  if (override) return override\n  if (\n    typeof globalThis !== \"undefined\" &&\n    typeof globalThis.fetch === \"function\"\n  ) {\n    return globalThis.fetch.bind(globalThis)\n  }\n  throw new Error(\n    \"uidex/cloud: global fetch is not available; pass a `fetch` override\"\n  )\n}\n\nfunction trimEndpoint(endpoint: string): string {\n  return endpoint.endsWith(\"/\") ? endpoint.slice(0, -1) : endpoint\n}\n\nfunction parseRetryAfter(header: string | null): number | undefined {\n  if (!header) return undefined\n  const seconds = Number(header)\n  if (Number.isFinite(seconds) && seconds >= 0) return seconds\n  const date = Date.parse(header)\n  if (Number.isFinite(date)) {\n    const delta = Math.ceil((date - Date.now()) / 1000)\n    return delta > 0 ? delta : 0\n  }\n  return undefined\n}\n\nasync function readBody(response: Response): Promise<unknown> {\n  const text = await response.text()\n  if (!text) return undefined\n  try {\n    return JSON.parse(text)\n  } catch {\n    return text\n  }\n}\n\nfunction errorMessage(body: unknown, fallback: string): string {\n  if (\n    body &&\n    typeof body === \"object\" &&\n    \"error\" in body &&\n    typeof (body as { error: unknown }).error === \"string\"\n  ) {\n    return (body as { error: string }).error\n  }\n  return fallback\n}\n\nexport function cloud(options: CloudOptions): CloudAdapter {\n  const projectKey = options.projectKey\n  if (!projectKey) {\n    throw new Error(\"uidex/cloud: `projectKey` is required\")\n  }\n  const endpoint = trimEndpoint(options.endpoint ?? DEFAULT_CLOUD_ENDPOINT)\n  const fetchImpl = resolveFetch(options.fetch)\n  const authHeader = `Bearer ${projectKey}`\n\n  async function submit(payload: FeedbackPayload): Promise<FeedbackResult> {\n    const response = await fetchImpl(`${endpoint}/api/ingest`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: authHeader,\n      },\n      body: JSON.stringify(payload),\n    })\n\n    const body = await readBody(response)\n\n    if (!response.ok) {\n      const retryAfter =\n        response.status === 429\n          ? parseRetryAfter(response.headers.get(\"Retry-After\"))\n          : undefined\n      throw new CloudError(\n        errorMessage(body, `Feedback submission failed (${response.status})`),\n        { status: response.status, retryAfter, details: body }\n      )\n    }\n\n    if (!body || typeof body !== \"object\") {\n      throw new CloudError(\"Feedback submission returned an empty response\", {\n        status: response.status,\n      })\n    }\n    return body as FeedbackResult\n  }\n\n  async function getConfig(): Promise<IngestConfig> {\n    const response = await fetchImpl(`${endpoint}/api/ingest/config`, {\n      method: \"GET\",\n      headers: {\n        Accept: \"application/json\",\n        Authorization: authHeader,\n      },\n    })\n\n    const body = await readBody(response)\n\n    if (!response.ok) {\n      const retryAfter =\n        response.status === 429\n          ? parseRetryAfter(response.headers.get(\"Retry-After\"))\n          : undefined\n      throw new CloudError(\n        errorMessage(body, `Ingest config request failed (${response.status})`),\n        { status: response.status, retryAfter, details: body }\n      )\n    }\n\n    if (!body || typeof body !== \"object\") {\n      throw new CloudError(\"Ingest config returned an empty response\", {\n        status: response.status,\n      })\n    }\n    return body as IngestConfig\n  }\n\n  return {\n    feedback: { submit },\n    integrations: { getConfig },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/cloud/index.d.cts

@@ -0,0 +1,108 @@
+interface ConsoleLogEntry {
+    level: "log" | "warn" | "error" | "info";
+    message: string;
+    timestamp: string;
+}
+interface NetworkErrorEntry {
+    url: string;
+    method: string;
+    status: number | null;
+    statusText: string | null;
+    timestamp: string;
+}
+interface Viewport {
+    width: number;
+    height: number;
+}
+interface SourceRef {
+    filePath: string;
+    line: number;
+}
+interface FeedbackSuggestedTarget {
+    integrationId: string;
+    targetConfig: Record<string, unknown>;
+}
+interface FeedbackPayload {
+    type: "bug" | "feature" | "improvement" | "question";
+    severity: "low" | "medium" | "high" | "critical";
+    title?: string;
+    description: string;
+    componentId: string;
+    element?: string | null;
+    sources?: SourceRef[];
+    url: string;
+    path: string;
+    route?: string | null;
+    pageTitle?: string;
+    sessionId?: string;
+    reporterEmail?: string;
+    reporterName?: string;
+    timestamp: string;
+    viewport: Viewport;
+    screen: Viewport;
+    userAgent: string;
+    locale?: string;
+    environment?: string;
+    appVersion?: string;
+    consoleLogs?: ConsoleLogEntry[];
+    networkErrors?: NetworkErrorEntry[];
+    metadata?: Record<string, string>;
+    screenshot?: string;
+    suggestedTarget?: FeedbackSuggestedTarget;
+}
+interface FeedbackExternalLink {
+    ok: boolean;
+    url?: string;
+    key?: string;
+    error?: string;
+}
+interface FeedbackResult {
+    id: string;
+    sequenceNumber: number;
+    externalLink?: FeedbackExternalLink;
+}
+interface IngestConfigEpic {
+    key: string;
+    summary: string;
+    status: string;
+}
+interface IngestConfig {
+    hasJira: boolean;
+    integrationId?: string;
+    epics?: IngestConfigEpic[];
+}
+/**
+ * Generic so third-party adapters (e.g. `uidex-cloud`) can plug in their own
+ * payload/result/integration shapes. SDK-bundled `cloud()` returns the
+ * defaulted form. `ViewContext.cloud` uses the fully-open variant; consumers
+ * that need the SDK shape narrow with `as CloudAdapter`.
+ */
+interface CloudAdapter<TPayload = FeedbackPayload, TResult = FeedbackResult, TIntegrations = {
+    getConfig(): Promise<IngestConfig>;
+}> {
+    readonly feedback: {
+        submit(payload: TPayload): Promise<TResult>;
+    };
+    readonly integrations: TIntegrations;
+}
+
+declare const DEFAULT_CLOUD_ENDPOINT = "https://app.uidex.dev";
+interface CloudOptions {
+    projectKey: string;
+    endpoint?: string;
+    fetch?: typeof fetch;
+}
+declare class CloudError extends Error {
+    readonly status: number;
+    readonly retryAfter?: number;
+    readonly details?: unknown;
+    constructor(message: string, options: {
+        status: number;
+        retryAfter?: number;
+        details?: unknown;
+    });
+}
+
+declare function cloud(options: CloudOptions): CloudAdapter;
+
+export { type CloudAdapter, CloudError, type CloudOptions, DEFAULT_CLOUD_ENDPOINT, type FeedbackExternalLink, type FeedbackPayload, type FeedbackResult, type FeedbackSuggestedTarget, type IngestConfig, type IngestConfigEpic, type SourceRef, cloud };

package/dist/cloud/index.d.ts

@@ -0,0 +1,108 @@
+interface ConsoleLogEntry {
+    level: "log" | "warn" | "error" | "info";
+    message: string;
+    timestamp: string;
+}
+interface NetworkErrorEntry {
+    url: string;
+    method: string;
+    status: number | null;
+    statusText: string | null;
+    timestamp: string;
+}
+interface Viewport {
+    width: number;
+    height: number;
+}
+interface SourceRef {
+    filePath: string;
+    line: number;
+}
+interface FeedbackSuggestedTarget {
+    integrationId: string;
+    targetConfig: Record<string, unknown>;
+}
+interface FeedbackPayload {
+    type: "bug" | "feature" | "improvement" | "question";
+    severity: "low" | "medium" | "high" | "critical";
+    title?: string;
+    description: string;
+    componentId: string;
+    element?: string | null;
+    sources?: SourceRef[];
+    url: string;
+    path: string;
+    route?: string | null;
+    pageTitle?: string;
+    sessionId?: string;
+    reporterEmail?: string;
+    reporterName?: string;
+    timestamp: string;
+    viewport: Viewport;
+    screen: Viewport;
+    userAgent: string;
+    locale?: string;
+    environment?: string;
+    appVersion?: string;
+    consoleLogs?: ConsoleLogEntry[];
+    networkErrors?: NetworkErrorEntry[];
+    metadata?: Record<string, string>;
+    screenshot?: string;
+    suggestedTarget?: FeedbackSuggestedTarget;
+}
+interface FeedbackExternalLink {
+    ok: boolean;
+    url?: string;
+    key?: string;
+    error?: string;
+}
+interface FeedbackResult {
+    id: string;
+    sequenceNumber: number;
+    externalLink?: FeedbackExternalLink;
+}
+interface IngestConfigEpic {
+    key: string;
+    summary: string;
+    status: string;
+}
+interface IngestConfig {
+    hasJira: boolean;
+    integrationId?: string;
+    epics?: IngestConfigEpic[];
+}
+/**
+ * Generic so third-party adapters (e.g. `uidex-cloud`) can plug in their own
+ * payload/result/integration shapes. SDK-bundled `cloud()` returns the
+ * defaulted form. `ViewContext.cloud` uses the fully-open variant; consumers
+ * that need the SDK shape narrow with `as CloudAdapter`.
+ */
+interface CloudAdapter<TPayload = FeedbackPayload, TResult = FeedbackResult, TIntegrations = {
+    getConfig(): Promise<IngestConfig>;
+}> {
+    readonly feedback: {
+        submit(payload: TPayload): Promise<TResult>;
+    };
+    readonly integrations: TIntegrations;
+}
+
+declare const DEFAULT_CLOUD_ENDPOINT = "https://app.uidex.dev";
+interface CloudOptions {
+    projectKey: string;
+    endpoint?: string;
+    fetch?: typeof fetch;
+}
+declare class CloudError extends Error {
+    readonly status: number;
+    readonly retryAfter?: number;
+    readonly details?: unknown;
+    constructor(message: string, options: {
+        status: number;
+        retryAfter?: number;
+        details?: unknown;
+    });
+}
+
+declare function cloud(options: CloudOptions): CloudAdapter;
+
+export { type CloudAdapter, CloudError, type CloudOptions, DEFAULT_CLOUD_ENDPOINT, type FeedbackExternalLink, type FeedbackPayload, type FeedbackResult, type FeedbackSuggestedTarget, type IngestConfig, type IngestConfigEpic, type SourceRef, cloud };

package/dist/cloud/index.js

@@ -0,0 +1,120 @@
+// src/cloud/types.ts
+var DEFAULT_CLOUD_ENDPOINT = "https://app.uidex.dev";
+var CloudError = class extends Error {
+  status;
+  retryAfter;
+  details;
+  constructor(message, options) {
+    super(message);
+    this.name = "CloudError";
+    this.status = options.status;
+    this.retryAfter = options.retryAfter;
+    this.details = options.details;
+  }
+};
+
+// src/cloud/client.ts
+function resolveFetch(override) {
+  if (override) return override;
+  if (typeof globalThis !== "undefined" && typeof globalThis.fetch === "function") {
+    return globalThis.fetch.bind(globalThis);
+  }
+  throw new Error(
+    "uidex/cloud: global fetch is not available; pass a `fetch` override"
+  );
+}
+function trimEndpoint(endpoint) {
+  return endpoint.endsWith("/") ? endpoint.slice(0, -1) : endpoint;
+}
+function parseRetryAfter(header) {
+  if (!header) return void 0;
+  const seconds = Number(header);
+  if (Number.isFinite(seconds) && seconds >= 0) return seconds;
+  const date = Date.parse(header);
+  if (Number.isFinite(date)) {
+    const delta = Math.ceil((date - Date.now()) / 1e3);
+    return delta > 0 ? delta : 0;
+  }
+  return void 0;
+}
+async function readBody(response) {
+  const text = await response.text();
+  if (!text) return void 0;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+function errorMessage(body, fallback) {
+  if (body && typeof body === "object" && "error" in body && typeof body.error === "string") {
+    return body.error;
+  }
+  return fallback;
+}
+function cloud(options) {
+  const projectKey = options.projectKey;
+  if (!projectKey) {
+    throw new Error("uidex/cloud: `projectKey` is required");
+  }
+  const endpoint = trimEndpoint(options.endpoint ?? DEFAULT_CLOUD_ENDPOINT);
+  const fetchImpl = resolveFetch(options.fetch);
+  const authHeader = `Bearer ${projectKey}`;
+  async function submit(payload) {
+    const response = await fetchImpl(`${endpoint}/api/ingest`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: authHeader
+      },
+      body: JSON.stringify(payload)
+    });
+    const body = await readBody(response);
+    if (!response.ok) {
+      const retryAfter = response.status === 429 ? parseRetryAfter(response.headers.get("Retry-After")) : void 0;
+      throw new CloudError(
+        errorMessage(body, `Feedback submission failed (${response.status})`),
+        { status: response.status, retryAfter, details: body }
+      );
+    }
+    if (!body || typeof body !== "object") {
+      throw new CloudError("Feedback submission returned an empty response", {
+        status: response.status
+      });
+    }
+    return body;
+  }
+  async function getConfig() {
+    const response = await fetchImpl(`${endpoint}/api/ingest/config`, {
+      method: "GET",
+      headers: {
+        Accept: "application/json",
+        Authorization: authHeader
+      }
+    });
+    const body = await readBody(response);
+    if (!response.ok) {
+      const retryAfter = response.status === 429 ? parseRetryAfter(response.headers.get("Retry-After")) : void 0;
+      throw new CloudError(
+        errorMessage(body, `Ingest config request failed (${response.status})`),
+        { status: response.status, retryAfter, details: body }
+      );
+    }
+    if (!body || typeof body !== "object") {
+      throw new CloudError("Ingest config returned an empty response", {
+        status: response.status
+      });
+    }
+    return body;
+  }
+  return {
+    feedback: { submit },
+    integrations: { getConfig }
+  };
+}
+export {
+  CloudError,
+  DEFAULT_CLOUD_ENDPOINT,
+  cloud
+};
+//# sourceMappingURL=index.js.map

package/dist/cloud/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cloud/types.ts","../../src/cloud/client.ts"],"sourcesContent":["export type {\n  CloudAdapter,\n  FeedbackExternalLink,\n  FeedbackPayload,\n  FeedbackResult,\n  FeedbackSuggestedTarget,\n  IngestConfig,\n  IngestConfigEpic,\n  SourceRef,\n} from \"../ingest/feedback-contract\"\n\nexport const DEFAULT_CLOUD_ENDPOINT = \"https://app.uidex.dev\"\n\nexport interface CloudOptions {\n  projectKey: string\n  endpoint?: string\n  fetch?: typeof fetch\n}\n\nexport class CloudError extends Error {\n  readonly status: number\n  readonly retryAfter?: number\n  readonly details?: unknown\n\n  constructor(\n    message: string,\n    options: { status: number; retryAfter?: number; details?: unknown }\n  ) {\n    super(message)\n    this.name = \"CloudError\"\n    this.status = options.status\n    this.retryAfter = options.retryAfter\n    this.details = options.details\n  }\n}\n","import {\n  CloudError,\n  DEFAULT_CLOUD_ENDPOINT,\n  type CloudAdapter,\n  type CloudOptions,\n  type FeedbackPayload,\n  type FeedbackResult,\n  type IngestConfig,\n} from \"./types\"\n\nfunction resolveFetch(override?: typeof fetch): typeof fetch {\n  if (override) return override\n  if (\n    typeof globalThis !== \"undefined\" &&\n    typeof globalThis.fetch === \"function\"\n  ) {\n    return globalThis.fetch.bind(globalThis)\n  }\n  throw new Error(\n    \"uidex/cloud: global fetch is not available; pass a `fetch` override\"\n  )\n}\n\nfunction trimEndpoint(endpoint: string): string {\n  return endpoint.endsWith(\"/\") ? endpoint.slice(0, -1) : endpoint\n}\n\nfunction parseRetryAfter(header: string | null): number | undefined {\n  if (!header) return undefined\n  const seconds = Number(header)\n  if (Number.isFinite(seconds) && seconds >= 0) return seconds\n  const date = Date.parse(header)\n  if (Number.isFinite(date)) {\n    const delta = Math.ceil((date - Date.now()) / 1000)\n    return delta > 0 ? delta : 0\n  }\n  return undefined\n}\n\nasync function readBody(response: Response): Promise<unknown> {\n  const text = await response.text()\n  if (!text) return undefined\n  try {\n    return JSON.parse(text)\n  } catch {\n    return text\n  }\n}\n\nfunction errorMessage(body: unknown, fallback: string): string {\n  if (\n    body &&\n    typeof body === \"object\" &&\n    \"error\" in body &&\n    typeof (body as { error: unknown }).error === \"string\"\n  ) {\n    return (body as { error: string }).error\n  }\n  return fallback\n}\n\nexport function cloud(options: CloudOptions): CloudAdapter {\n  const projectKey = options.projectKey\n  if (!projectKey) {\n    throw new Error(\"uidex/cloud: `projectKey` is required\")\n  }\n  const endpoint = trimEndpoint(options.endpoint ?? DEFAULT_CLOUD_ENDPOINT)\n  const fetchImpl = resolveFetch(options.fetch)\n  const authHeader = `Bearer ${projectKey}`\n\n  async function submit(payload: FeedbackPayload): Promise<FeedbackResult> {\n    const response = await fetchImpl(`${endpoint}/api/ingest`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: authHeader,\n      },\n      body: JSON.stringify(payload),\n    })\n\n    const body = await readBody(response)\n\n    if (!response.ok) {\n      const retryAfter =\n        response.status === 429\n          ? parseRetryAfter(response.headers.get(\"Retry-After\"))\n          : undefined\n      throw new CloudError(\n        errorMessage(body, `Feedback submission failed (${response.status})`),\n        { status: response.status, retryAfter, details: body }\n      )\n    }\n\n    if (!body || typeof body !== \"object\") {\n      throw new CloudError(\"Feedback submission returned an empty response\", {\n        status: response.status,\n      })\n    }\n    return body as FeedbackResult\n  }\n\n  async function getConfig(): Promise<IngestConfig> {\n    const response = await fetchImpl(`${endpoint}/api/ingest/config`, {\n      method: \"GET\",\n      headers: {\n        Accept: \"application/json\",\n        Authorization: authHeader,\n      },\n    })\n\n    const body = await readBody(response)\n\n    if (!response.ok) {\n      const retryAfter =\n        response.status === 429\n          ? parseRetryAfter(response.headers.get(\"Retry-After\"))\n          : undefined\n      throw new CloudError(\n        errorMessage(body, `Ingest config request failed (${response.status})`),\n        { status: response.status, retryAfter, details: body }\n      )\n    }\n\n    if (!body || typeof body !== \"object\") {\n      throw new CloudError(\"Ingest config returned an empty response\", {\n        status: response.status,\n      })\n    }\n    return body as IngestConfig\n  }\n\n  return {\n    feedback: { submit },\n    integrations: { getConfig },\n  }\n}\n"],"mappings":"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","names":[]}