@volter/twin-polar 2.0.37 → 3.0.0

package/spec/sources.json

@@ -0,0 +1,71 @@
+{
+  "https://polar.sh/docs/api-reference/introduction": {
+    "status": 200,
+    "checked": "2026-10-01",
+    "quotes": {
+      "Create separate tokens in each environment.": true,
+      "500 requests per minute": true,
+      "100 requests per minute": true
+    }
+  },
+  "https://polar.sh/docs/features/checkout/session": {
+    "status": 200,
+    "checked": "2026-10-03",
+    "quotes": {
+      "Ad-hoc prices are temporary prices that exist only for that specific checkout session": true
+    }
+  },
+  "https://polar.sh/docs/features/customer-portal": {
+    "status": 200,
+    "checked": "2026-10-03",
+    "quotes": {
+      "active subscriptions": true
+    }
+  },
+  "https://polar.sh/docs/features/customer-portal/navigate-customers": {
+    "status": 200,
+    "checked": "2026-10-03",
+    "quotes": {
+      "no email code required": true
+    }
+  },
+  "https://polar.sh/docs/features/subscriptions/introduction": {
+    "status": 200,
+    "checked": "2026-10-01",
+    "quotes": {
+      "At the end of each billing period, Polar advances the subscription to the next cycle and creates a new order": true,
+      "creates a new order": true,
+      "Daily, weekly, monthly or yearly.": true
+    }
+  },
+  "https://polar.sh/docs/features/subscriptions/trials": {
+    "status": 200,
+    "checked": "2026-10-01",
+    "quotes": {
+      "they will not be charged immediately": true,
+      "Once the trial period ends, the customer will be automatically charged for the subscription, and their billing cycle will begin.": true
+    }
+  },
+  "https://polar.sh/docs/features/usage-based-billing/event-ingestion": {
+    "status": 200,
+    "checked": "2026-10-01",
+    "quotes": {
+      "Polar never issues retroactive invoices or credits for late events.": true
+    }
+  },
+  "https://polar.sh/docs/features/usage-based-billing/meters": {
+    "status": 200,
+    "checked": "2026-10-01",
+    "quotes": {
+      "Counts the number of unique values of a property.": true,
+      "Operators are the operators that you want to use to filter the events.": true
+    }
+  },
+  "https://raw.githubusercontent.com/polarsource/polar/main/server/polar/config.py": {
+    "status": 200,
+    "checked": "2026-10-01",
+    "quotes": {
+      "CHECKOUT_TTL_SECONDS: int = 60 * 60 * 24": true
+    }
+  }
+}

package/src/cli.ts

@@ -1,25 +1,18 @@
 #!/usr/bin/env node
-import { keepProcessAlive } from '@volter/world-core/lifecycle';
-// world-polar CLI: serve the KERNEL-BACKED Polar API twin, or run conformance. State lives in
-// the @volter/world-core action log (no in-memory side-store). Conformance is dev-only + lazy-imported
-// so the bin runs without @volter/world-tooling (E2).
+// world-polar: serve the polar twin.
 import { hasFlag, optionValue } from '@volter/world-core/args';
-import { createPolarTwinServer } from './polar-server.ts';
+import { keepProcessAlive } from '@volter/world-core/lifecycle';
+import { createPolarTwinServer } from './server.ts';
 
 const [cmd, ...rest] = process.argv.slice(2);
-const port = Number(optionValue(rest, '--port', String(process.env.PORT ?? '0'))) || undefined;
+const port = Number(optionValue(rest, '--port', '0')) || undefined;
 const root = optionValue(rest, '--root') || undefined;
-const readOnly = hasFlag(rest, '--read-only'); // a twin accepts writes unless started read-only
+const readOnly = hasFlag(rest, '--read-only');
 
 if (cmd === 'serve' || cmd === undefined) {
   const s = await createPolarTwinServer({ readOnly, ...(root ? { root } : {}), ...(port ? { port } : {}) });
-  process.stdout.write(`polar twin (merchant-of-record billing API)${readOnly ? ' [read-only]' : ''} at http://127.0.0.1:${s.port}\n`);
+  process.stdout.write(`polar twin${readOnly ? ' [read-only]' : ''} at http://127.0.0.1:${s.port}\n`);
   await keepProcessAlive();
-} else if (cmd === 'conformance') {
-  const { checkPolarConformance } = await import('./polar-conformance.ts');
-  const report = checkPolarConformance();
-  process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
-  if (!report.ok) process.exitCode = 1;
 } else {
-  process.stdout.write('Usage: world-polar serve|conformance [--port N] [--root DIR] [--read-only]\n');
+  process.stdout.write('Usage: world-polar serve [--port N] [--root DIR] [--read-only]\n');
 }

package/src/fetch.ts

@@ -0,0 +1,25 @@
+// GENERATED by scripts/create-pack.ts (--init, --index): a fixed file. The kernel serves the discovery door, the clock,
+// the World's doors, the vendor's screens and the API from the pack's parts (architecture, "The pack contract").
+import { createPackFetch, type DerivedFetch, type DerivedSurface, type PackFetchOptions } from '@volter/world-core';
+import surface from './generated/surface.gen.json' with { type: 'json' };
+import { manifest } from './manifest.ts';
+import { around } from './semantics/around.ts';
+import { clock } from './semantics/clock.ts';
+import { tenant } from './semantics/tenant.ts';
+import * as doors from './semantics/doors.ts';
+import { polarSemantics } from './semantics/index.ts';
+import { screen as screen_checkout } from './screens/checkout.ts';
+import { screen as screen_portal } from './screens/portal.ts';
+
+export function createPolarFetch(options: PackFetchOptions = {}): DerivedFetch {
+  return createPackFetch({
+    manifest,
+    surface: surface as DerivedSurface,
+    handlers: polarSemantics,
+    doors,
+    around,
+    clock,
+    tenant,
+    screens: { "checkout": screen_checkout, "portal": screen_portal },
+  }, options);
+}