@volter/twin-hubspot 0.1.36 → 1.0.0

package/spec/sources.json

@@ -0,0 +1,32 @@
+{
+  "https://developers.hubspot.com/docs/api-reference/error-handling": {
+    "status": 200,
+    "checked": "2026-10-03",
+    "quotes": {
+      "return a JSON formatted response with details about the error": true,
+      "Returned when the authentication provided is invalid.": true
+    }
+  },
+  "https://developers.hubspot.com/docs/api-reference/webhooks-webhooks-v3/guide": {
+    "status": 200,
+    "checked": "2026-10-03",
+    "quotes": {
+      "404 Not Found : requested resource not found": true,
+      "Authorization : Bearer YOUR_ACCESS_TOKEN": true
+    }
+  },
+  "https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines": {
+    "status": 200,
+    "checked": "2026-10-03",
+    "quotes": {
+      "110 requests every 10 seconds": true
+    }
+  },
+  "https://raw.githubusercontent.com/dubinc/dub/7e0101363b2ab30afc537c1893f159d1dcba513a/apps/web/lib/integrations/hubspot/oauth.ts": {
+    "status": 200,
+    "checked": "2026-10-03",
+    "quotes": {
+      "process.env.HUBSPOT_CLIENT_ID": true
+    }
+  }
+}

package/src/cli.ts

@@ -1,29 +1,20 @@
 #!/usr/bin/env node
-import { keepProcessAlive } from '@volter/world-core/lifecycle';
-// world-hubspot CLI: serve the HubSpot CRM API twin, the CRM mirror UI, or run conformance.
+// world-hubspot: serve the hubspot twin.
 import { hasFlag, optionValue } from '@volter/world-core/args';
-import { createHubspotTwinServer } from './hubspot-server.ts';
-import { createHubspotMirrorServer } from './hubspot-mirror-ui.ts';
+import { keepProcessAlive } from '@volter/world-core/lifecycle';
+import { createHubspotTwinServer } from './server.ts';
 
 const [cmd, ...rest] = process.argv.slice(2);
 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');
+// the World's managed Postgres, which the runtime binds a pack declaring managedDatabase to
+const database = optionValue(rest, '--database') || undefined;
 
-if (cmd === 'serve') {
-  const s = await createHubspotTwinServer({ readOnly, ...(root ? { root } : {}), ...(port ? { port } : {}) });
-  process.stdout.write(`hubspot twin (CRM v3/v4)${readOnly ? ' [read-only]' : ''} at ${s.url}\n`);
-  await keepProcessAlive();
-} else if (cmd === 'mirror') {
-  const s = await createHubspotMirrorServer({ ...(root ? { root } : {}), ...(port ? { port } : {}) });
-  process.stdout.write(`hubspot mirror UI (CRM) at ${s.url}\n`);
+if (cmd === 'serve' || cmd === undefined) {
+  const s = await createHubspotTwinServer({ readOnly, ...(root ? { root } : {}), ...(port ? { port } : {}), ...(database ? { database } : {}) });
+  process.stdout.write(`hubspot twin${readOnly ? ' [read-only]' : ''} at http://127.0.0.1:${s.port}\n`);
   await keepProcessAlive();
-} else if (cmd === 'conformance') {
-  // dev-only; lazy so the bin runs without @volter/world-tooling in the runtime graph
-  const { checkHubspotConformance } = await import('./hubspot-conformance.ts');
-  const report = await checkHubspotConformance({ ...(root ? { root } : {}) });
-  process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
-  if (!report.ok) process.exitCode = 1;
 } else {
-  process.stdout.write('Usage: world-hubspot serve|mirror|conformance [--port N] [--root DIR] [--read-only]\n');
+  process.stdout.write('Usage: world-hubspot serve [--port N] [--root DIR] [--read-only] [--database URL]\n');
 }

package/src/fetch.ts

@@ -0,0 +1,14 @@
+// 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 { hubspotSemantics } from './semantics/index.ts';
+
+export function createHubspotFetch(options: PackFetchOptions = {}): DerivedFetch {
+  return createPackFetch({
+    manifest,
+    surface: surface as DerivedSurface,
+    handlers: hubspotSemantics,
+  }, options);
+}