@volter/twin-sentry 0.1.0

package/src/sentry-server.ts

@@ -0,0 +1,35 @@
+// Sentry twin HTTP server — serve the full Sentry twin handler over HTTP so the real
+// `@sentry/node` SDK (pointed at a twin DSN whose host is this server) POSTs captured
+// events to /api/:projectId/envelope/ and they become grouped issues, AND the Web API
+// (/api/0/...) answers reads/writes. Writable by default; pass readOnly to reject writes.
+// No real Sentry is ever contacted (D4) — fully local + offline.
+//
+// FETCH-FIRST (runtime contract R12b): the serve path is the plain fetch below, built from the
+// kernel's ONE adaptation (`createTwinFetchFromHandler`); this file contributes only VALUES. The
+// vendor's 204 deletes return `{ status: 204, body: null }`, which the adapter's null-body rule
+// serves as a genuinely empty response. The server is one line of Bun.serve around that closure.
+import { serveHttp } from '@volter/world-core';
+import { handleSentryTwinRequest } from './sentry-twin.ts';
+import { createTwinFetchFromHandler, statefulTwinManifest } from '@volter/world-core';
+
+/** Options every Sentry-twin HTTP surface needs, independent of who owns the socket. */
+export interface SentryTwinFetchOptions {
+  root?: string;
+  readOnly?: boolean;
+}
+
+export function createSentryTwinFetch(options: SentryTwinFetchOptions = {}): (request: Request) => Promise<Response> {
+  return createTwinFetchFromHandler(handleSentryTwinRequest, {
+    ...options,
+    manifest: statefulTwinManifest({ vendor: 'sentry', twinOf: 'the Sentry error-monitoring API', stores: 'ingested error/transaction envelopes, readable back per project' }),
+  });
+}
+
+export async function createSentryTwinServer(options: { root?: string; port?: number; readOnly?: boolean } = {}): Promise<{ port: number; stop: () => void }> {
+  const server = await serveHttp({
+    port: options.port ?? 0,
+    idleTimeout: 60,
+    fetch: createSentryTwinFetch(options),
+  });
+  return { port: server.port ?? options.port ?? 0, stop: () => server.stop(true) };
+}