@volter/twin-polar 0.1.0

package/src/polar-server.ts

@@ -0,0 +1,33 @@
+// Polar twin HTTP server — serve the full Polar API twin handler over HTTP so the real
+// `@polar-sh/sdk` (pointed at this base URL) works unmodified. JSON bodies pass through to the
+// handler. Writable by default; pass readOnly to reject writes with 405 (D3). State is the
+// kernel projection (no side-store) — see polar-twin.ts.
+//
+// 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 { handlePolarTwinRequest } from './polar-twin.ts';
+import { createTwinFetchFromHandler, statefulTwinManifest } from '@volter/twin';
+
+/** Options every Polar-twin HTTP surface needs, independent of who owns the socket. */
+export interface PolarTwinFetchOptions {
+  root?: string;
+  readOnly?: boolean;
+}
+
+export function createPolarTwinFetch(options: PolarTwinFetchOptions = {}): (request: Request) => Promise<Response> {
+  return createTwinFetchFromHandler(handlePolarTwinRequest, {
+    ...options,
+    manifest: statefulTwinManifest({ vendor: 'polar', twinOf: 'the Polar billing API', stores: 'customers, checkouts, subscriptions, meters and usage events' }),
+  });
+}
+
+export function createPolarTwinServer(options: { root?: string; port?: number; readOnly?: boolean } = {}): { port: number; stop: () => void } {
+  const server = Bun.serve({
+    port: options.port ?? 0,
+    idleTimeout: 60,
+    fetch: createPolarTwinFetch(options),
+  });
+  return { port: server.port ?? options.port ?? 0, stop: () => server.stop(true) };
+}