feat: rename to BitGate and close the drop-in gap

Renames the project and makes it as easy to adopt as BitLogin, which was the
stated bar and which it did not previously meet.

Rename (ADR 0005): @nostr-governance/* -> @bitgate/*, governance-* elements ->
bitgate-*, createGovernanceRuntime -> createBitGate. "Governance" reads as DAO
voting to this audience and named a category rather than a product; BitGate
names the benefit and joins the bit- family that BitVid and BitRoad compose
with. Domain types keep their names — the product is BitGate, the subject
matter is still governance. The migration plan is left as written; this ADR
records the change rather than rewriting history.

Drop-in distribution (ADR 0006): adopting BitGate meant supplying a transport,
authoring a policy, and wiring every element in JavaScript. Now:

- createRelayTransport(urls) — WebSocket transport with reconnection, backoff,
  subscription replay, and cross-relay dedupe
- policy presets (social, commerce, admin-only) addressable by name; the engine
  still carries no thresholds of its own
- <bitgate-provider> — configuration in markup, with descendants finding the
  runtime through a bubbling context event rather than DOM walking, which
  breaks across shadow boundaries
- npm run build:widget — a self-contained dist/bitgate.js

That last one came from running it in a browser rather than from a test. Bare
specifiers resolve in Node and vitest but not in a browser, so the widget
source worked everywhere except a plain static page — the one place it exists
to serve. The bundle is not committed: consumers build from reviewed source.

Also found by running it: the provider's ready event fires during element
upgrade, before a page that defines elements after parsing can attach a
listener, so it now exposes `ready` as a promise too.

Four bugs fixed along the way, three found by new tests and one by the browser:
admin state stayed silent when a roster change altered capabilities but no
denials; the relay transport sent every subscription twice on connect; the
commerce preset computed a meaningless visibility verdict at checkout and could
hide a listing from its own seller; <bitgate-status> threw on an unusable
decision.

759 tests; lint, typecheck, and both builds clean.
This commit is contained in:
thePR0M3TH3AN committed 2026-08-09 19:58:45 -04:00
1 parent 7f70a64d61
commit adeba151b8
63 files changed
+2774 -401

No files matched your search

+48 -47
View File
@@ -1,11 +1,11 @@
{
"name": "nostr-governance",
"name": "bitgate",
"version": "0.1.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "nostr-governance",
"name": "bitgate",
"version": "0.1.0",
"workspaces": [
"packages/*",
@@ -13,6 +13,7 @@
],
"devDependencies": {
"@types/node": "^22.10.0",
"esbuild": "^0.28.2",
"happy-dom": "^20.11.2",
"typescript": "^5.4.5",
"vitest": "^3.2.7"
@@ -22,13 +23,41 @@
}
},
"examples/commerce": {
"name": "@nostr-governance/example-commerce",
"name": "@bitgate/example-commerce",
"version": "0.1.0",
"dependencies": {
"@nostr-governance/core": "*",
"@nostr-governance/runtime": "*"
"@bitgate/core": "*",
"@bitgate/runtime": "*"
}
},
"node_modules/@bitgate/bitvid-compat": {
"resolved": "packages/bitvid-compat",
"link": true
},
"node_modules/@bitgate/core": {
"resolved": "packages/core",
"link": true
},
"node_modules/@bitgate/example-commerce": {
"resolved": "examples/commerce",
"link": true
},
"node_modules/@bitgate/nostr": {
"resolved": "packages/nostr",
"link": true
},
"node_modules/@bitgate/runtime": {
"resolved": "packages/runtime",
"link": true
},
"node_modules/@bitgate/testing": {
"resolved": "packages/testing",
"link": true
},
"node_modules/@bitgate/widget": {
"resolved": "packages/widget",
"link": true
},
"node_modules/@esbuild/aix-ppc64": {
"version": "0.28.2",
"resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.2.tgz",
@@ -495,34 +524,6 @@
"node": "^22.20 || ^24.12 || >=25"
}
},
"node_modules/@nostr-governance/bitvid-compat": {
"resolved": "packages/bitvid-compat",
"link": true
},
"node_modules/@nostr-governance/core": {
"resolved": "packages/core",
"link": true
},
"node_modules/@nostr-governance/example-commerce": {
"resolved": "examples/commerce",
"link": true
},
"node_modules/@nostr-governance/nostr": {
"resolved": "packages/nostr",
"link": true
},
"node_modules/@nostr-governance/runtime": {
"resolved": "packages/runtime",
"link": true
},
"node_modules/@nostr-governance/testing": {
"resolved": "packages/testing",
"link": true
},
"node_modules/@nostr-governance/widget": {
"resolved": "packages/widget",
"link": true
},
"node_modules/@rollup/rollup-android-arm-eabi": {
"version": "4.62.4",
"resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.62.4.tgz",
@@ -1771,45 +1772,45 @@
}
},
"packages/bitvid-compat": {
"name": "@nostr-governance/bitvid-compat",
"name": "@bitgate/bitvid-compat",
"version": "0.1.0",
"dependencies": {
"@nostr-governance/core": "*",
"@nostr-governance/nostr": "*"
"@bitgate/core": "*",
"@bitgate/nostr": "*"
}
},
"packages/core": {
"name": "@nostr-governance/core",
"name": "@bitgate/core",
"version": "0.1.0"
},
"packages/nostr": {
"name": "@nostr-governance/nostr",
"name": "@bitgate/nostr",
"version": "0.1.0",
"dependencies": {
"@nostr-governance/core": "*"
"@bitgate/core": "*"
}
},
"packages/runtime": {
"name": "@nostr-governance/runtime",
"name": "@bitgate/runtime",
"version": "0.1.0",
"dependencies": {
"@nostr-governance/core": "*",
"@nostr-governance/nostr": "*"
"@bitgate/core": "*",
"@bitgate/nostr": "*"
}
},
"packages/testing": {
"name": "@nostr-governance/testing",
"name": "@bitgate/testing",
"version": "0.1.0",
"dependencies": {
"@nostr-governance/core": "*"
"@bitgate/core": "*"
}
},
"packages/widget": {
"name": "@nostr-governance/widget",
"name": "@bitgate/widget",
"version": "0.1.0",
"dependencies": {
"@nostr-governance/core": "*",
"@nostr-governance/runtime": "*"
"@bitgate/core": "*",
"@bitgate/runtime": "*"
}
}
}