clinkx 1.2.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (270) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/README.md +4 -2
  3. package/clinkx-workflows/dist/architecture-arena/admission.d.ts +16 -0
  4. package/clinkx-workflows/dist/architecture-arena/admission.js +107 -0
  5. package/clinkx-workflows/dist/architecture-arena/admission.js.map +1 -0
  6. package/clinkx-workflows/dist/architecture-arena/contract.d.ts +1368 -0
  7. package/clinkx-workflows/dist/architecture-arena/contract.js +254 -0
  8. package/clinkx-workflows/dist/architecture-arena/contract.js.map +1 -0
  9. package/clinkx-workflows/dist/architecture-arena/runtime.d.ts +53 -0
  10. package/clinkx-workflows/dist/architecture-arena/runtime.js +511 -0
  11. package/clinkx-workflows/dist/architecture-arena/runtime.js.map +1 -0
  12. package/clinkx-workflows/dist/architecture-comparison/admission.d.ts +17 -1
  13. package/clinkx-workflows/dist/architecture-comparison/admission.js +27 -4
  14. package/clinkx-workflows/dist/architecture-comparison/admission.js.map +1 -1
  15. package/clinkx-workflows/dist/architecture-comparison/contract.d.ts +59 -62
  16. package/clinkx-workflows/dist/architecture-comparison/contract.js +4 -21
  17. package/clinkx-workflows/dist/architecture-comparison/contract.js.map +1 -1
  18. package/clinkx-workflows/dist/architecture-comparison/runtime.d.ts +4 -3
  19. package/clinkx-workflows/dist/architecture-comparison/runtime.js +22 -67
  20. package/clinkx-workflows/dist/architecture-comparison/runtime.js.map +1 -1
  21. package/clinkx-workflows/dist/artifacts.d.ts +19 -4
  22. package/clinkx-workflows/dist/artifacts.js +16 -7
  23. package/clinkx-workflows/dist/artifacts.js.map +1 -1
  24. package/clinkx-workflows/dist/backend.d.ts +30 -0
  25. package/clinkx-workflows/dist/clink-client.d.ts +8 -2
  26. package/clinkx-workflows/dist/clink-client.js +4 -2
  27. package/clinkx-workflows/dist/clink-client.js.map +1 -1
  28. package/clinkx-workflows/dist/context-preflight.d.ts +6 -0
  29. package/clinkx-workflows/dist/context-preflight.js.map +1 -1
  30. package/clinkx-workflows/dist/council-execution-policy.d.ts +3 -1
  31. package/clinkx-workflows/dist/council-execution-policy.js +4 -0
  32. package/clinkx-workflows/dist/council-execution-policy.js.map +1 -1
  33. package/clinkx-workflows/dist/dashboard/contracts.d.ts +586 -586
  34. package/clinkx-workflows/dist/dashboard/progress-report-contract.d.ts +28 -28
  35. package/clinkx-workflows/dist/dashboard/session-log-contract.d.ts +32 -32
  36. package/clinkx-workflows/dist/dashboard-ui/assets/index-DRId2DVA.js +119 -0
  37. package/clinkx-workflows/dist/dashboard-ui/assets/style-CHAw57y5.css +1 -0
  38. package/clinkx-workflows/dist/dashboard-ui/index.html +2 -2
  39. package/clinkx-workflows/dist/delegate-signature.d.ts +4 -3
  40. package/clinkx-workflows/dist/delegate-signature.js +4 -3
  41. package/clinkx-workflows/dist/delegate-signature.js.map +1 -1
  42. package/clinkx-workflows/dist/durable-file.d.ts +69 -0
  43. package/clinkx-workflows/dist/durable-file.js +145 -0
  44. package/clinkx-workflows/dist/durable-file.js.map +1 -0
  45. package/clinkx-workflows/dist/engine.d.ts +42 -7
  46. package/clinkx-workflows/dist/engine.js +196 -24
  47. package/clinkx-workflows/dist/engine.js.map +1 -1
  48. package/clinkx-workflows/dist/ping-pong/admission.d.ts +127 -0
  49. package/clinkx-workflows/dist/ping-pong/admission.js +522 -0
  50. package/clinkx-workflows/dist/ping-pong/admission.js.map +1 -0
  51. package/clinkx-workflows/dist/ping-pong/contract.d.ts +2539 -0
  52. package/clinkx-workflows/dist/ping-pong/contract.js +819 -0
  53. package/clinkx-workflows/dist/ping-pong/contract.js.map +1 -0
  54. package/clinkx-workflows/dist/ping-pong/control.d.ts +67 -0
  55. package/clinkx-workflows/dist/ping-pong/control.js +12 -0
  56. package/clinkx-workflows/dist/ping-pong/control.js.map +1 -0
  57. package/clinkx-workflows/dist/ping-pong/runtime-handle.d.ts +24 -0
  58. package/clinkx-workflows/dist/ping-pong/runtime-handle.js +55 -0
  59. package/clinkx-workflows/dist/ping-pong/runtime-handle.js.map +1 -0
  60. package/clinkx-workflows/dist/ping-pong/runtime.d.ts +235 -0
  61. package/clinkx-workflows/dist/ping-pong/runtime.js +1183 -0
  62. package/clinkx-workflows/dist/ping-pong/runtime.js.map +1 -0
  63. package/clinkx-workflows/dist/ping-pong/settle.d.ts +57 -0
  64. package/clinkx-workflows/dist/ping-pong/settle.js +58 -0
  65. package/clinkx-workflows/dist/ping-pong/settle.js.map +1 -0
  66. package/clinkx-workflows/dist/ping-pong/sidecar.d.ts +65 -0
  67. package/clinkx-workflows/dist/ping-pong/sidecar.js +138 -0
  68. package/clinkx-workflows/dist/ping-pong/sidecar.js.map +1 -0
  69. package/clinkx-workflows/dist/plan-review/publication.d.ts +2 -1
  70. package/clinkx-workflows/dist/plan-review/publication.js +5 -6
  71. package/clinkx-workflows/dist/plan-review/publication.js.map +1 -1
  72. package/clinkx-workflows/dist/plan-review/snapshot.d.ts +3 -2
  73. package/clinkx-workflows/dist/plan-review/snapshot.js +8 -8
  74. package/clinkx-workflows/dist/plan-review/snapshot.js.map +1 -1
  75. package/clinkx-workflows/dist/recipe-host.d.ts +315 -0
  76. package/clinkx-workflows/dist/recipe-host.js +183 -0
  77. package/clinkx-workflows/dist/recipe-host.js.map +1 -0
  78. package/clinkx-workflows/dist/recipe-seats.d.ts +96 -0
  79. package/clinkx-workflows/dist/recipe-seats.js +163 -0
  80. package/clinkx-workflows/dist/recipe-seats.js.map +1 -0
  81. package/clinkx-workflows/dist/recipe-shared/evidence.d.ts +67 -0
  82. package/clinkx-workflows/dist/recipe-shared/evidence.js +111 -0
  83. package/clinkx-workflows/dist/recipe-shared/evidence.js.map +1 -0
  84. package/clinkx-workflows/dist/reducers/index.d.ts +9 -1
  85. package/clinkx-workflows/dist/reducers/index.js +30 -0
  86. package/clinkx-workflows/dist/reducers/index.js.map +1 -1
  87. package/clinkx-workflows/dist/run-lock-reclaim.d.ts +44 -0
  88. package/clinkx-workflows/dist/run-lock-reclaim.js +86 -0
  89. package/clinkx-workflows/dist/run-lock-reclaim.js.map +1 -0
  90. package/clinkx-workflows/dist/state-schema.d.ts +11 -0
  91. package/clinkx-workflows/dist/state-schema.js +4 -1
  92. package/clinkx-workflows/dist/state-schema.js.map +1 -1
  93. package/clinkx-workflows/dist/state.d.ts +178 -3
  94. package/clinkx-workflows/dist/state.js +618 -83
  95. package/clinkx-workflows/dist/state.js.map +1 -1
  96. package/clinkx-workflows/dist/transport.d.ts +2 -1
  97. package/clinkx-workflows/dist/transport.js +5 -0
  98. package/clinkx-workflows/dist/transport.js.map +1 -1
  99. package/clinkx-workflows/dist/validators/architecture-arena.d.ts +6 -0
  100. package/clinkx-workflows/dist/validators/architecture-arena.js +16 -0
  101. package/clinkx-workflows/dist/validators/architecture-arena.js.map +1 -0
  102. package/clinkx-workflows/dist/validators/index.js +4 -0
  103. package/clinkx-workflows/dist/validators/index.js.map +1 -1
  104. package/clinkx-workflows/dist/validators/ping-pong.d.ts +6 -0
  105. package/clinkx-workflows/dist/validators/ping-pong.js +10 -0
  106. package/clinkx-workflows/dist/validators/ping-pong.js.map +1 -0
  107. package/clinkx-workflows/dist/workflow-tools.d.ts +51 -5
  108. package/clinkx-workflows/dist/workflow-tools.js +785 -34
  109. package/clinkx-workflows/dist/workflow-tools.js.map +1 -1
  110. package/clinkx-workflows/dist/workflow-verification-contract.d.ts +4 -4
  111. package/clinkx-workflows/templates/architecture-arena/candidate.txt +39 -0
  112. package/clinkx-workflows/templates/architecture-arena/judge.txt +34 -0
  113. package/clinkx-workflows/templates/ping-pong/implement.txt +14 -0
  114. package/clinkx-workflows/templates/ping-pong/remediate.txt +14 -0
  115. package/clinkx-workflows/templates/ping-pong/review.txt +27 -0
  116. package/clinkx-workflows/workflows/architecture-arena.yaml +127 -0
  117. package/clinkx-workflows/workflows/ping-pong.yaml +158 -0
  118. package/dist/context-builder/bundle.js +4 -3
  119. package/dist/context-builder/bundle.js.map +1 -1
  120. package/dist/context-builder/delegate-packet.d.ts +1 -0
  121. package/dist/context-builder/delegate-packet.js +66 -7
  122. package/dist/context-builder/delegate-packet.js.map +1 -1
  123. package/dist/context-builder/delegate-validation.d.ts +12 -3
  124. package/dist/context-builder/delegate-validation.js +23 -13
  125. package/dist/context-builder/delegate-validation.js.map +1 -1
  126. package/dist/context-builder/external-gaps.d.ts +14 -3
  127. package/dist/context-builder/external-gaps.js +124 -18
  128. package/dist/context-builder/external-gaps.js.map +1 -1
  129. package/dist/context-builder/handler.js +108 -191
  130. package/dist/context-builder/handler.js.map +1 -1
  131. package/dist/context-builder/review-coverage.js +27 -1
  132. package/dist/context-builder/review-coverage.js.map +1 -1
  133. package/dist/context-builder/secrets.js +1 -1
  134. package/dist/context-builder/secrets.js.map +1 -1
  135. package/dist/context-builder/versions.d.ts +10 -4
  136. package/dist/context-builder/versions.js +10 -4
  137. package/dist/context-builder/versions.js.map +1 -1
  138. package/dist/context-builder/workflow-runner.js +33 -24
  139. package/dist/context-builder/workflow-runner.js.map +1 -1
  140. package/dist/dashboard-cli.d.ts +2 -0
  141. package/dist/dashboard-cli.js +147 -57
  142. package/dist/dashboard-cli.js.map +1 -1
  143. package/dist/dashboard-companion/client.d.ts +10 -0
  144. package/dist/dashboard-companion/client.js +43 -1
  145. package/dist/dashboard-companion/client.js.map +1 -1
  146. package/dist/dashboard-companion/config.d.ts +19 -1
  147. package/dist/dashboard-companion/config.js +104 -3
  148. package/dist/dashboard-companion/config.js.map +1 -1
  149. package/dist/dashboard-companion/protocol.d.ts +16 -0
  150. package/dist/dashboard-companion/protocol.js +38 -1
  151. package/dist/dashboard-companion/protocol.js.map +1 -1
  152. package/dist/dashboard-companion/workstation-binding.d.ts +69 -0
  153. package/dist/dashboard-companion/workstation-binding.js +192 -0
  154. package/dist/dashboard-companion/workstation-binding.js.map +1 -0
  155. package/dist/dashboard-gateway/admin-cli.d.ts +10 -0
  156. package/dist/dashboard-gateway/admin-cli.js +266 -0
  157. package/dist/dashboard-gateway/admin-cli.js.map +1 -0
  158. package/dist/dashboard-gateway/config.d.ts +50 -0
  159. package/dist/dashboard-gateway/config.js +235 -1
  160. package/dist/dashboard-gateway/config.js.map +1 -1
  161. package/dist/dashboard-gateway/connection-registry.d.ts +100 -0
  162. package/dist/dashboard-gateway/connection-registry.js +228 -0
  163. package/dist/dashboard-gateway/connection-registry.js.map +1 -0
  164. package/dist/dashboard-gateway/control-plane/account-auth.d.ts +78 -0
  165. package/dist/dashboard-gateway/control-plane/account-auth.js +198 -0
  166. package/dist/dashboard-gateway/control-plane/account-auth.js.map +1 -0
  167. package/dist/dashboard-gateway/control-plane/billing.d.ts +264 -0
  168. package/dist/dashboard-gateway/control-plane/billing.js +787 -0
  169. package/dist/dashboard-gateway/control-plane/billing.js.map +1 -0
  170. package/dist/dashboard-gateway/control-plane/contracts.d.ts +1293 -0
  171. package/dist/dashboard-gateway/control-plane/contracts.js +280 -0
  172. package/dist/dashboard-gateway/control-plane/contracts.js.map +1 -0
  173. package/dist/dashboard-gateway/control-plane/cookies.d.ts +13 -0
  174. package/dist/dashboard-gateway/control-plane/cookies.js +46 -0
  175. package/dist/dashboard-gateway/control-plane/cookies.js.map +1 -0
  176. package/dist/dashboard-gateway/control-plane/credentials.d.ts +63 -0
  177. package/dist/dashboard-gateway/control-plane/credentials.js +66 -0
  178. package/dist/dashboard-gateway/control-plane/credentials.js.map +1 -0
  179. package/dist/dashboard-gateway/control-plane/entitlements.d.ts +118 -0
  180. package/dist/dashboard-gateway/control-plane/entitlements.js +329 -0
  181. package/dist/dashboard-gateway/control-plane/entitlements.js.map +1 -0
  182. package/dist/dashboard-gateway/control-plane/errors.d.ts +17 -0
  183. package/dist/dashboard-gateway/control-plane/errors.js +23 -0
  184. package/dist/dashboard-gateway/control-plane/errors.js.map +1 -0
  185. package/dist/dashboard-gateway/control-plane/hosts.d.ts +6 -0
  186. package/dist/dashboard-gateway/control-plane/hosts.js +16 -0
  187. package/dist/dashboard-gateway/control-plane/hosts.js.map +1 -0
  188. package/dist/dashboard-gateway/control-plane/http.d.ts +34 -0
  189. package/dist/dashboard-gateway/control-plane/http.js +331 -0
  190. package/dist/dashboard-gateway/control-plane/http.js.map +1 -0
  191. package/dist/dashboard-gateway/control-plane/schema.d.ts +9 -0
  192. package/dist/dashboard-gateway/control-plane/schema.js +247 -0
  193. package/dist/dashboard-gateway/control-plane/schema.js.map +1 -0
  194. package/dist/dashboard-gateway/control-plane/secrets.d.ts +20 -0
  195. package/dist/dashboard-gateway/control-plane/secrets.js +39 -0
  196. package/dist/dashboard-gateway/control-plane/secrets.js.map +1 -0
  197. package/dist/dashboard-gateway/control-plane/store.d.ts +579 -0
  198. package/dist/dashboard-gateway/control-plane/store.js +1115 -0
  199. package/dist/dashboard-gateway/control-plane/store.js.map +1 -0
  200. package/dist/dashboard-gateway/cookie-boundary.d.ts +60 -0
  201. package/dist/dashboard-gateway/cookie-boundary.js +205 -0
  202. package/dist/dashboard-gateway/cookie-boundary.js.map +1 -0
  203. package/dist/dashboard-gateway/index.js +271 -494
  204. package/dist/dashboard-gateway/index.js.map +1 -1
  205. package/dist/dashboard-gateway/main.js +7 -2
  206. package/dist/dashboard-gateway/main.js.map +1 -1
  207. package/dist/dashboard-gateway/routing.d.ts +43 -0
  208. package/dist/dashboard-gateway/routing.js +65 -0
  209. package/dist/dashboard-gateway/routing.js.map +1 -0
  210. package/dist/dashboard-gateway/tenant-gateway.d.ts +56 -0
  211. package/dist/dashboard-gateway/tenant-gateway.js +989 -0
  212. package/dist/dashboard-gateway/tenant-gateway.js.map +1 -0
  213. package/dist/dashboard-gateway/tenant-main.d.ts +41 -0
  214. package/dist/dashboard-gateway/tenant-main.js +303 -0
  215. package/dist/dashboard-gateway/tenant-main.js.map +1 -0
  216. package/dist/dashboard-gateway/tunnel-errors.d.ts +16 -0
  217. package/dist/dashboard-gateway/tunnel-errors.js +22 -0
  218. package/dist/dashboard-gateway/tunnel-errors.js.map +1 -0
  219. package/dist/dashboard-gateway/tunnel-http.d.ts +21 -0
  220. package/dist/dashboard-gateway/tunnel-http.js +175 -0
  221. package/dist/dashboard-gateway/tunnel-http.js.map +1 -0
  222. package/dist/handler.d.ts +6 -0
  223. package/dist/handler.js +17 -1
  224. package/dist/handler.js.map +1 -1
  225. package/dist/local-clink-backend.d.ts +2 -1
  226. package/dist/local-clink-backend.js +28 -4
  227. package/dist/local-clink-backend.js.map +1 -1
  228. package/dist/parsers/extract.d.ts +19 -1
  229. package/dist/parsers/extract.js +68 -3
  230. package/dist/parsers/extract.js.map +1 -1
  231. package/dist/pipeline.d.ts +17 -1
  232. package/dist/pipeline.js +34 -6
  233. package/dist/pipeline.js.map +1 -1
  234. package/dist/process-group.d.ts +65 -0
  235. package/dist/process-group.js +153 -0
  236. package/dist/process-group.js.map +1 -0
  237. package/dist/progress-report/schema.d.ts +23 -23
  238. package/dist/project-verification/files.js +1 -1
  239. package/dist/project-verification/files.js.map +1 -1
  240. package/dist/project-verification/process.js +23 -44
  241. package/dist/project-verification/process.js.map +1 -1
  242. package/dist/project-verification/service.js +9 -1
  243. package/dist/project-verification/service.js.map +1 -1
  244. package/dist/prompt.d.ts +7 -0
  245. package/dist/prompt.js +18 -1
  246. package/dist/prompt.js.map +1 -1
  247. package/dist/recipe-host/git-trust.d.ts +43 -0
  248. package/dist/recipe-host/git-trust.js +360 -0
  249. package/dist/recipe-host/git-trust.js.map +1 -0
  250. package/dist/recipe-host/git.d.ts +42 -0
  251. package/dist/recipe-host/git.js +207 -0
  252. package/dist/recipe-host/git.js.map +1 -0
  253. package/dist/recipe-host/native-recipe-host.d.ts +127 -0
  254. package/dist/recipe-host/native-recipe-host.js +880 -0
  255. package/dist/recipe-host/native-recipe-host.js.map +1 -0
  256. package/dist/recipe-host/seat-cwd.d.ts +16 -0
  257. package/dist/recipe-host/seat-cwd.js +170 -0
  258. package/dist/recipe-host/seat-cwd.js.map +1 -0
  259. package/dist/runner.d.ts +43 -1
  260. package/dist/runner.js +234 -35
  261. package/dist/runner.js.map +1 -1
  262. package/dist/server.js +9 -1
  263. package/dist/server.js.map +1 -1
  264. package/docs/configuration.md +24 -3
  265. package/docs/engineering-recipes.md +291 -0
  266. package/docs/security.md +84 -0
  267. package/docs/verification/project-checks.md +24 -2
  268. package/package.json +5 -1
  269. package/clinkx-workflows/dist/dashboard-ui/assets/index-BdpmbPps.js +0 -115
  270. package/clinkx-workflows/dist/dashboard-ui/assets/style-Im5i1iAs.css +0 -1
@@ -1,3 +1,4 @@
1
+ import { isAbsolute, normalize } from "node:path";
1
2
  import { isDashboardPairingToken } from "../dashboard-pairing-token.js";
2
3
  const LOOPBACK_HOSTS = new Set(["localhost", "127.0.0.1", "[::1]"]);
3
4
  export function parseDashboardGatewayEndpoint(value) {
@@ -28,6 +29,12 @@ function parsePort(value) {
28
29
  return port;
29
30
  }
30
31
  export function loadDashboardGatewayConfig(env = process.env) {
32
+ if (resolveDashboardGatewayMode(env) === "tenant") {
33
+ throw new Error("CLINKX_DASHBOARD_GATEWAY_MODE=tenant is not served by the legacy gateway entry point");
34
+ }
35
+ return loadLegacyConfig(env);
36
+ }
37
+ function loadLegacyConfig(env) {
31
38
  const token = env.CLINKX_DASHBOARD_GATEWAY_TOKEN;
32
39
  if (token === undefined || token === "") {
33
40
  throw new Error("CLINKX_DASHBOARD_GATEWAY_TOKEN is required");
@@ -35,10 +42,237 @@ export function loadDashboardGatewayConfig(env = process.env) {
35
42
  if (!isDashboardPairingToken(token)) {
36
43
  throw new Error("CLINKX_DASHBOARD_GATEWAY_TOKEN is invalid");
37
44
  }
45
+ return { token, ...parseListen(env) };
46
+ }
47
+ function parseListen(env) {
38
48
  const host = env.CLINKX_DASHBOARD_GATEWAY_HOST ?? env.HOST ?? "0.0.0.0";
39
49
  if (host.length === 0 || /\s/.test(host)) {
40
50
  throw new Error("CLINKX_DASHBOARD_GATEWAY_HOST must be a non-empty host");
41
51
  }
42
- return { token, host, port: parsePort(env.PORT) };
52
+ return { host, port: parsePort(env.PORT) };
53
+ }
54
+ const MODE_ENV = "CLINKX_DASHBOARD_GATEWAY_MODE";
55
+ const LEGACY_TOKEN_ENV = "CLINKX_DASHBOARD_GATEWAY_TOKEN";
56
+ const TENANT_CORE_ENV = {
57
+ cloudDbPath: "CLINKX_DASHBOARD_GATEWAY_CLOUD_DB_PATH",
58
+ publicOrigin: "CLINKX_DASHBOARD_GATEWAY_PUBLIC_ORIGIN",
59
+ oidcIssuer: "CLINKX_DASHBOARD_GATEWAY_OIDC_ISSUER",
60
+ oidcClientId: "CLINKX_DASHBOARD_GATEWAY_OIDC_CLIENT_ID",
61
+ oidcClientSecretEnv: "CLINKX_DASHBOARD_GATEWAY_OIDC_CLIENT_SECRET_ENV",
62
+ billing: "CLINKX_DASHBOARD_GATEWAY_BILLING",
63
+ };
64
+ const TENANT_BILLING_ENV = {
65
+ stripeEnvironment: "CLINKX_DASHBOARD_GATEWAY_STRIPE_ENVIRONMENT",
66
+ stripeSecretKeyEnv: "CLINKX_DASHBOARD_GATEWAY_STRIPE_SECRET_KEY_ENV",
67
+ stripeWebhookSecretEnv: "CLINKX_DASHBOARD_GATEWAY_STRIPE_WEBHOOK_SECRET_ENV",
68
+ stripePriceIds: "CLINKX_DASHBOARD_GATEWAY_STRIPE_PRICE_IDS",
69
+ graceSeconds: "CLINKX_DASHBOARD_GATEWAY_BILLING_GRACE_SECONDS",
70
+ reconciliationIntervalSeconds: "CLINKX_DASHBOARD_GATEWAY_BILLING_RECONCILE_INTERVAL_SECONDS",
71
+ maxStalenessSeconds: "CLINKX_DASHBOARD_GATEWAY_BILLING_MAX_STALENESS_SECONDS",
72
+ };
73
+ const TENANT_ENV = { ...TENANT_CORE_ENV, ...TENANT_BILLING_ENV };
74
+ /** Tenant settings every tenant deployment sets, whatever its billing mode. */
75
+ export const DASHBOARD_GATEWAY_TENANT_CORE_ENV_NAMES = Object.values(TENANT_CORE_ENV);
76
+ /** Stripe settings: required with `CLINKX_DASHBOARD_GATEWAY_BILLING=stripe`, refused with `off`. */
77
+ export const DASHBOARD_GATEWAY_TENANT_BILLING_ENV_NAMES = Object.values(TENANT_BILLING_ENV);
78
+ export const DASHBOARD_GATEWAY_TENANT_ENV_NAMES = [
79
+ ...DASHBOARD_GATEWAY_TENANT_CORE_ENV_NAMES,
80
+ ...DASHBOARD_GATEWAY_TENANT_BILLING_ENV_NAMES,
81
+ ];
82
+ /** Not a tenant setting: the image sets it, so legacy mode accepts and ignores it. */
83
+ export const REQUIRE_PERSISTENT_DB_ENV = "CLINKX_DASHBOARD_GATEWAY_REQUIRE_PERSISTENT_DB";
84
+ /** Subdomain-model names replaced by the public origin. Rejected in every mode so a stale deployment fails loudly. */
85
+ const RETIRED_TENANT_ENV_NAMES = [
86
+ "CLINKX_DASHBOARD_GATEWAY_ACCOUNT_ORIGIN",
87
+ "CLINKX_DASHBOARD_GATEWAY_TENANT_BASE_DOMAIN",
88
+ ];
89
+ // setInterval clamps delays above 2^31-1 ms to 1 ms, which would turn a long
90
+ // reconciliation interval into a hot loop.
91
+ const MAX_TIMER_SECONDS = Math.floor(2_147_483_647 / 1000);
92
+ const MAX_DURATION_SECONDS = Math.floor(Number.MAX_SAFE_INTEGER / 1000);
93
+ const DNS_LABEL = "[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?";
94
+ const DNS_NAME_PATTERN = new RegExp(`^${DNS_LABEL}(?:\\.${DNS_LABEL})+$`);
95
+ const ENV_NAME_PATTERN = /^[A-Z_][A-Z0-9_]{0,127}$/;
96
+ const CLIENT_ID_PATTERN = /^[\x21-\x7e]{1,255}$/;
97
+ const PRICE_ID_PATTERN = /^price_[A-Za-z0-9]{1,255}$/;
98
+ function isDnsName(value) {
99
+ return DNS_NAME_PATTERN.test(value) && /[a-z]/.test(value.slice(value.lastIndexOf(".") + 1));
100
+ }
101
+ function isSet(value) {
102
+ return value !== undefined && value !== "";
103
+ }
104
+ export function resolveDashboardGatewayMode(env = process.env) {
105
+ const raw = env[MODE_ENV];
106
+ if (!isSet(raw) || raw === "legacy") {
107
+ const stray = [...DASHBOARD_GATEWAY_TENANT_ENV_NAMES, ...RETIRED_TENANT_ENV_NAMES].filter((name) => isSet(env[name]));
108
+ if (stray.length > 0) {
109
+ throw new Error(`${stray.join(", ")} require ${MODE_ENV}=tenant`);
110
+ }
111
+ return "legacy";
112
+ }
113
+ if (raw === "tenant")
114
+ return "tenant";
115
+ throw new Error(`${MODE_ENV} must be "legacy" or "tenant"`);
116
+ }
117
+ export function loadDashboardGatewayModeConfig(env = process.env) {
118
+ if (resolveDashboardGatewayMode(env) === "legacy") {
119
+ return { mode: "legacy", ...loadLegacyConfig(env) };
120
+ }
121
+ return loadTenantConfig(env);
122
+ }
123
+ function required(env, name) {
124
+ const value = env[name];
125
+ if (!isSet(value))
126
+ throw new Error(`${name} is required in tenant mode`);
127
+ return value;
128
+ }
129
+ function parseCloudDbPath(value) {
130
+ if (value.includes("\0") || !isAbsolute(value) || normalize(value) !== value || value.endsWith("/")) {
131
+ throw new Error(`${TENANT_ENV.cloudDbPath} must be a normalized absolute file path`);
132
+ }
133
+ return value;
134
+ }
135
+ function parsePublicOrigin(value) {
136
+ const message = `${TENANT_ENV.publicOrigin} must be a canonical HTTPS origin on a DNS host without a port`;
137
+ let parsed;
138
+ try {
139
+ parsed = new URL(value);
140
+ }
141
+ catch {
142
+ throw new Error(message);
143
+ }
144
+ if (parsed.protocol !== "https:" ||
145
+ parsed.origin !== value ||
146
+ parsed.port !== "" ||
147
+ !isDnsName(parsed.hostname)) {
148
+ throw new Error(message);
149
+ }
150
+ return value;
151
+ }
152
+ function parseOidcIssuer(value) {
153
+ const message = `${TENANT_ENV.oidcIssuer} must be an HTTPS URL without credentials, query, or fragment`;
154
+ let parsed;
155
+ try {
156
+ parsed = new URL(value);
157
+ }
158
+ catch {
159
+ throw new Error(message);
160
+ }
161
+ if (value.length > 2048 ||
162
+ parsed.protocol !== "https:" ||
163
+ parsed.username !== "" ||
164
+ parsed.password !== "" ||
165
+ value.includes("?") ||
166
+ value.includes("#")) {
167
+ throw new Error(message);
168
+ }
169
+ return value;
170
+ }
171
+ function parseSecretEnvName(env, name) {
172
+ const target = required(env, name);
173
+ if (!ENV_NAME_PATTERN.test(target) || target.startsWith("CLINKX_DASHBOARD_GATEWAY_")) {
174
+ throw new Error(`${name} must name a separate environment variable`);
175
+ }
176
+ if (!isSet(env[target])) {
177
+ throw new Error(`${name} names ${target}, which is not set`);
178
+ }
179
+ return target;
180
+ }
181
+ function parseStripeEnvironment(value) {
182
+ if (value === "live") {
183
+ throw new Error(`${TENANT_ENV.stripeEnvironment}=live is refused: live billing is disabled until the billing milestone; use "test"`);
184
+ }
185
+ if (value === "test")
186
+ return value;
187
+ throw new Error(`${TENANT_ENV.stripeEnvironment} must be "test" or "live"`);
188
+ }
189
+ function parseBillingMode(value) {
190
+ if (value === "off" || value === "stripe")
191
+ return value;
192
+ throw new Error(`${TENANT_ENV.billing} must be "off" or "stripe"`);
193
+ }
194
+ function parseRequirePersistentDb(value) {
195
+ if (!isSet(value))
196
+ return false;
197
+ if (value === "true")
198
+ return true;
199
+ throw new Error(`${REQUIRE_PERSISTENT_DB_ENV} must be "true" or unset`);
200
+ }
201
+ function parsePriceIds(value) {
202
+ const ids = value.split(",");
203
+ if (ids.some((id) => !PRICE_ID_PATTERN.test(id)) || new Set(ids).size !== ids.length) {
204
+ throw new Error(`${TENANT_ENV.stripePriceIds} must be a comma-separated list of distinct Stripe Price IDs`);
205
+ }
206
+ return ids;
207
+ }
208
+ function parseSeconds(env, name, max) {
209
+ const value = required(env, name);
210
+ const seconds = /^[1-9][0-9]*$/.test(value) ? Number(value) : Number.NaN;
211
+ if (!Number.isSafeInteger(seconds) || seconds > max) {
212
+ throw new Error(`${name} must be an integer number of seconds from 1 through ${max}`);
213
+ }
214
+ return seconds;
215
+ }
216
+ function loadTenantConfig(env) {
217
+ if (isSet(env[LEGACY_TOKEN_ENV])) {
218
+ throw new Error(`${LEGACY_TOKEN_ENV} must not be set in tenant mode`);
219
+ }
220
+ const retired = RETIRED_TENANT_ENV_NAMES.filter((name) => isSet(env[name]));
221
+ if (retired.length > 0) {
222
+ throw new Error(`${retired.join(", ")} ${retired.length === 1 ? "is" : "are"} no longer supported; set ${TENANT_ENV.publicOrigin}`);
223
+ }
224
+ const listen = parseListen(env);
225
+ const cloudDbPath = parseCloudDbPath(required(env, TENANT_ENV.cloudDbPath));
226
+ const publicOrigin = parsePublicOrigin(required(env, TENANT_ENV.publicOrigin));
227
+ const issuer = parseOidcIssuer(required(env, TENANT_ENV.oidcIssuer));
228
+ const clientId = required(env, TENANT_ENV.oidcClientId);
229
+ if (!CLIENT_ID_PATTERN.test(clientId)) {
230
+ throw new Error(`${TENANT_ENV.oidcClientId} must be 1-255 printable ASCII characters without spaces`);
231
+ }
232
+ const clientSecretEnv = parseSecretEnvName(env, TENANT_ENV.oidcClientSecretEnv);
233
+ const billingMode = parseBillingMode(required(env, TENANT_ENV.billing));
234
+ const requirePersistentDb = parseRequirePersistentDb(env[REQUIRE_PERSISTENT_DB_ENV]);
235
+ const core = {
236
+ mode: "tenant",
237
+ ...listen,
238
+ cloudDbPath,
239
+ publicOrigin,
240
+ oidc: { issuer, clientId, clientSecretEnv },
241
+ requirePersistentDb,
242
+ };
243
+ if (billingMode === "off") {
244
+ const stray = DASHBOARD_GATEWAY_TENANT_BILLING_ENV_NAMES.filter((name) => isSet(env[name]));
245
+ if (stray.length > 0) {
246
+ throw new Error(`${stray.join(", ")} must not be set when ${TENANT_ENV.billing}=off`);
247
+ }
248
+ return { ...core, billingMode };
249
+ }
250
+ return { ...core, billingMode, ...loadStripeBilling(env, clientSecretEnv) };
251
+ }
252
+ function loadStripeBilling(env, clientSecretEnv) {
253
+ const environment = parseStripeEnvironment(required(env, TENANT_ENV.stripeEnvironment));
254
+ const secretKeyEnv = parseSecretEnvName(env, TENANT_ENV.stripeSecretKeyEnv);
255
+ const webhookSecretEnv = parseSecretEnvName(env, TENANT_ENV.stripeWebhookSecretEnv);
256
+ if (new Set([clientSecretEnv, secretKeyEnv, webhookSecretEnv]).size !== 3) {
257
+ throw new Error("OIDC client secret, Stripe secret key, and Stripe webhook secret must use distinct environment variables");
258
+ }
259
+ const secretKey = env[secretKeyEnv] ?? "";
260
+ if (!secretKey.startsWith(`sk_${environment}_`) && !secretKey.startsWith(`rk_${environment}_`)) {
261
+ throw new Error(`${secretKeyEnv} is not a Stripe ${environment}-mode secret or restricted key`);
262
+ }
263
+ if (!(env[webhookSecretEnv] ?? "").startsWith("whsec_")) {
264
+ throw new Error(`${webhookSecretEnv} is not a Stripe webhook signing secret`);
265
+ }
266
+ const priceIds = parsePriceIds(required(env, TENANT_ENV.stripePriceIds));
267
+ const graceSeconds = parseSeconds(env, TENANT_ENV.graceSeconds, MAX_DURATION_SECONDS);
268
+ const reconciliationIntervalSeconds = parseSeconds(env, TENANT_ENV.reconciliationIntervalSeconds, MAX_TIMER_SECONDS);
269
+ const maxStalenessSeconds = parseSeconds(env, TENANT_ENV.maxStalenessSeconds, MAX_DURATION_SECONDS);
270
+ if (maxStalenessSeconds < reconciliationIntervalSeconds) {
271
+ throw new Error(`${TENANT_ENV.maxStalenessSeconds} must be at least ${TENANT_ENV.reconciliationIntervalSeconds}`);
272
+ }
273
+ return {
274
+ stripe: { environment, secretKeyEnv, webhookSecretEnv, priceIds },
275
+ billing: { graceSeconds, reconciliationIntervalSeconds, maxStalenessSeconds },
276
+ };
43
277
  }
44
278
  //# sourceMappingURL=config.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/dashboard-gateway/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAUxE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;AAEpE,MAAM,UAAU,6BAA6B,CAAC,KAAa;IACzD,MAAM,OAAO,GAAG,4FAA4F,CAAC;IAC7G,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC;IAC1E,MAAM,QAAQ,GACZ,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC;QAC1D,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAChF,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED,SAAS,SAAS,CAAC,KAAyB;IAC1C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC7F,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,MAAM,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAmB,OAAO,CAAC,GAAG;IACvE,MAAM,KAAK,GAAG,GAAG,CAAC,8BAA8B,CAAC;IACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,6BAA6B,IAAI,GAAG,CAAC,IAAI,IAAI,SAAS,CAAC;IACxE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;AACpD,CAAC"}
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/dashboard-gateway/config.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,100 @@
1
+ export declare const LEGACY_CONNECTION_SLOT = "legacy";
2
+ export type RequestPhase = "admitted" | "forwarded";
3
+ export interface OwnedRequest<TValue> {
4
+ readonly id: string;
5
+ readonly phase: RequestPhase;
6
+ readonly value: TValue;
7
+ }
8
+ export interface GatewayConnection<TSocket> {
9
+ readonly slot: string;
10
+ readonly generation: number;
11
+ readonly socket: TSocket;
12
+ readonly version: 1 | 2;
13
+ }
14
+ export interface UpgradeClaim {
15
+ readonly slot: string;
16
+ }
17
+ export interface ConnectionCounters {
18
+ admitted: number;
19
+ rejectedOverCapacity: number;
20
+ forwarded: number;
21
+ completed: number;
22
+ failed: number;
23
+ lostOnDisconnect: number;
24
+ }
25
+ export interface ConnectionSnapshot {
26
+ readonly slot: string;
27
+ readonly generation: number;
28
+ readonly version: 1 | 2;
29
+ readonly attached: boolean;
30
+ readonly pending: number;
31
+ readonly counters: Readonly<ConnectionCounters>;
32
+ }
33
+ export type AdmitResult = "admitted" | "not_current" | "over_capacity" | "duplicate_id";
34
+ /**
35
+ * `abandoned` is a failure whose companion response may still arrive later
36
+ * (timeout, browser cancel, send error); its id is remembered so that late
37
+ * reply is dropped instead of being treated as a protocol violation.
38
+ */
39
+ export type SettleOutcome = "completed" | "failed" | "abandoned";
40
+ export type ResponseLookup<TValue> = {
41
+ readonly kind: "owned";
42
+ readonly request: OwnedRequest<TValue>;
43
+ } | {
44
+ readonly kind: "late";
45
+ } | {
46
+ readonly kind: "unknown";
47
+ } | {
48
+ readonly kind: "stale_connection";
49
+ };
50
+ export interface AttachResult<TSocket, TValue> {
51
+ readonly connection: GatewayConnection<TSocket>;
52
+ readonly displaced?: GatewayConnection<TSocket>;
53
+ readonly displacedRequests: readonly OwnedRequest<TValue>[];
54
+ }
55
+ /**
56
+ * At most one live companion connection per slot. Legacy mode uses
57
+ * LEGACY_CONNECTION_SLOT; tenant mode keys slots by the companion id taken from
58
+ * the authenticated device credential, so each workstation holds its own slot.
59
+ *
60
+ * Second-connection policy: the live holder always wins. A claim is refused
61
+ * while the slot's current socket is open or another upgrade holds the claim.
62
+ * A current connection whose socket is no longer open is displaced by the next
63
+ * attach, and its owned requests are handed back for failure.
64
+ *
65
+ * Requests are owned by exactly one connection handle. Every lookup is scoped
66
+ * to the handle that asks, so a socket can never observe, complete, or remove
67
+ * another connection's request, and a retired handle owns nothing.
68
+ */
69
+ export declare class ConnectionRegistry<TSocket, TValue> {
70
+ private readonly isOpen;
71
+ private readonly slots;
72
+ private readonly records;
73
+ private readonly lastGenerations;
74
+ private readonly nextGeneration;
75
+ constructor(isOpen: (socket: TSocket) => boolean, nextGeneration?: () => number);
76
+ claim(slot: string): UpgradeClaim | undefined;
77
+ isClaimValid(claim: UpgradeClaim): boolean;
78
+ release(claim: UpgradeClaim): void;
79
+ attach(claim: UpgradeClaim, socket: TSocket, version: 1 | 2): AttachResult<TSocket, TValue> | undefined;
80
+ current(slot: string): GatewayConnection<TSocket> | undefined;
81
+ isAttached(connection: GatewayConnection<TSocket>): boolean;
82
+ isCurrent(connection: GatewayConnection<TSocket>): boolean;
83
+ /** Close-callback entry point. A stale handle (already displaced) is a no-op. */
84
+ detach(connection: GatewayConnection<TSocket>): OwnedRequest<TValue>[];
85
+ admit(connection: GatewayConnection<TSocket>, id: string, value: TValue, limit: number): AdmitResult;
86
+ /** Marks an admitted request as handed to the socket. Fails unless the owner is still current. */
87
+ markForwarded(connection: GatewayConnection<TSocket>, id: string): boolean;
88
+ owned(connection: GatewayConnection<TSocket>, id: string): OwnedRequest<TValue> | undefined;
89
+ settle(connection: GatewayConnection<TSocket>, id: string, outcome: SettleOutcome): OwnedRequest<TValue> | undefined;
90
+ /**
91
+ * Resolves a response id against the responding connection only. It never
92
+ * changes pending state; the caller settles after validating the payload.
93
+ */
94
+ lookupResponse(connection: GatewayConnection<TSocket>, id: string): ResponseLookup<TValue>;
95
+ snapshot(connection: GatewayConnection<TSocket>): ConnectionSnapshot | undefined;
96
+ /** Invalidates every outstanding claim and returns the attached connections for termination. */
97
+ shutdown(): GatewayConnection<TSocket>[];
98
+ private retire;
99
+ private pruneSlot;
100
+ }
@@ -0,0 +1,228 @@
1
+ export const LEGACY_CONNECTION_SLOT = "legacy";
2
+ const MAX_RETIRED_REQUEST_IDS = 1_024;
3
+ /**
4
+ * At most one live companion connection per slot. Legacy mode uses
5
+ * LEGACY_CONNECTION_SLOT; tenant mode keys slots by the companion id taken from
6
+ * the authenticated device credential, so each workstation holds its own slot.
7
+ *
8
+ * Second-connection policy: the live holder always wins. A claim is refused
9
+ * while the slot's current socket is open or another upgrade holds the claim.
10
+ * A current connection whose socket is no longer open is displaced by the next
11
+ * attach, and its owned requests are handed back for failure.
12
+ *
13
+ * Requests are owned by exactly one connection handle. Every lookup is scoped
14
+ * to the handle that asks, so a socket can never observe, complete, or remove
15
+ * another connection's request, and a retired handle owns nothing.
16
+ */
17
+ export class ConnectionRegistry {
18
+ isOpen;
19
+ slots = new Map();
20
+ records = new WeakMap();
21
+ lastGenerations = new Map();
22
+ nextGeneration;
23
+ constructor(isOpen, nextGeneration) {
24
+ this.isOpen = isOpen;
25
+ let counter = 0;
26
+ this.nextGeneration = nextGeneration ?? (() => ++counter);
27
+ }
28
+ claim(slot) {
29
+ const state = this.slots.get(slot) ?? { current: undefined, claim: undefined };
30
+ if (state.claim !== undefined)
31
+ return undefined;
32
+ if (state.current !== undefined && this.isOpen(state.current.socket))
33
+ return undefined;
34
+ const claim = Object.freeze({ slot });
35
+ state.claim = claim;
36
+ this.slots.set(slot, state);
37
+ return claim;
38
+ }
39
+ isClaimValid(claim) {
40
+ return this.slots.get(claim.slot)?.claim === claim;
41
+ }
42
+ release(claim) {
43
+ const state = this.slots.get(claim.slot);
44
+ if (state?.claim !== claim)
45
+ return;
46
+ state.claim = undefined;
47
+ this.pruneSlot(claim.slot);
48
+ }
49
+ attach(claim, socket, version) {
50
+ const state = this.slots.get(claim.slot);
51
+ if (state?.claim !== claim)
52
+ return undefined;
53
+ state.claim = undefined;
54
+ const previous = state.current;
55
+ if (previous !== undefined && this.isOpen(previous.socket)) {
56
+ this.pruneSlot(claim.slot);
57
+ return undefined;
58
+ }
59
+ const displacedRequests = previous === undefined ? [] : this.retire(previous);
60
+ const lastGeneration = this.lastGenerations.get(claim.slot);
61
+ let generation = this.nextGeneration();
62
+ while (generation === lastGeneration)
63
+ generation = this.nextGeneration();
64
+ this.lastGenerations.set(claim.slot, generation);
65
+ const connection = Object.freeze({
66
+ slot: claim.slot,
67
+ generation,
68
+ socket,
69
+ version,
70
+ });
71
+ state.current = connection;
72
+ this.records.set(connection, {
73
+ attached: true,
74
+ requests: new Map(),
75
+ retiredRequestIds: new Set(),
76
+ counters: {
77
+ admitted: 0,
78
+ rejectedOverCapacity: 0,
79
+ forwarded: 0,
80
+ completed: 0,
81
+ failed: 0,
82
+ lostOnDisconnect: 0,
83
+ },
84
+ });
85
+ return previous === undefined
86
+ ? { connection, displacedRequests }
87
+ : { connection, displaced: previous, displacedRequests };
88
+ }
89
+ current(slot) {
90
+ const connection = this.slots.get(slot)?.current;
91
+ return connection !== undefined && this.isOpen(connection.socket) ? connection : undefined;
92
+ }
93
+ isAttached(connection) {
94
+ return this.records.get(connection)?.attached === true;
95
+ }
96
+ isCurrent(connection) {
97
+ return this.slots.get(connection.slot)?.current === connection
98
+ && this.isAttached(connection)
99
+ && this.isOpen(connection.socket);
100
+ }
101
+ /** Close-callback entry point. A stale handle (already displaced) is a no-op. */
102
+ detach(connection) {
103
+ if (this.slots.get(connection.slot)?.current !== connection)
104
+ return [];
105
+ const lost = this.retire(connection);
106
+ this.pruneSlot(connection.slot);
107
+ return lost;
108
+ }
109
+ admit(connection, id, value, limit) {
110
+ const record = this.records.get(connection);
111
+ if (record === undefined || !this.isCurrent(connection))
112
+ return "not_current";
113
+ if (record.requests.has(id) || record.retiredRequestIds.has(id))
114
+ return "duplicate_id";
115
+ if (record.requests.size >= limit) {
116
+ record.counters.rejectedOverCapacity += 1;
117
+ return "over_capacity";
118
+ }
119
+ record.requests.set(id, { phase: "admitted", value });
120
+ record.counters.admitted += 1;
121
+ return "admitted";
122
+ }
123
+ /** Marks an admitted request as handed to the socket. Fails unless the owner is still current. */
124
+ markForwarded(connection, id) {
125
+ const record = this.records.get(connection);
126
+ const entry = record?.requests.get(id);
127
+ if (record === undefined || entry === undefined || entry.phase !== "admitted")
128
+ return false;
129
+ if (!this.isCurrent(connection))
130
+ return false;
131
+ entry.phase = "forwarded";
132
+ record.counters.forwarded += 1;
133
+ return true;
134
+ }
135
+ owned(connection, id) {
136
+ const entry = this.records.get(connection)?.requests.get(id);
137
+ return entry === undefined ? undefined : { id, phase: entry.phase, value: entry.value };
138
+ }
139
+ settle(connection, id, outcome) {
140
+ const record = this.records.get(connection);
141
+ const entry = record?.requests.get(id);
142
+ if (record === undefined || entry === undefined)
143
+ return undefined;
144
+ record.requests.delete(id);
145
+ if (outcome === "completed") {
146
+ record.counters.completed += 1;
147
+ }
148
+ else {
149
+ record.counters.failed += 1;
150
+ if (outcome === "abandoned" && entry.phase === "forwarded") {
151
+ record.retiredRequestIds.add(id);
152
+ while (record.retiredRequestIds.size > MAX_RETIRED_REQUEST_IDS) {
153
+ const oldest = record.retiredRequestIds.values().next().value;
154
+ if (oldest === undefined)
155
+ break;
156
+ record.retiredRequestIds.delete(oldest);
157
+ }
158
+ }
159
+ }
160
+ return { id, phase: entry.phase, value: entry.value };
161
+ }
162
+ /**
163
+ * Resolves a response id against the responding connection only. It never
164
+ * changes pending state; the caller settles after validating the payload.
165
+ */
166
+ lookupResponse(connection, id) {
167
+ const record = this.records.get(connection);
168
+ if (record === undefined || !record.attached)
169
+ return { kind: "stale_connection" };
170
+ const entry = record.requests.get(id);
171
+ if (entry !== undefined) {
172
+ return entry.phase === "forwarded"
173
+ ? { kind: "owned", request: { id, phase: entry.phase, value: entry.value } }
174
+ : { kind: "unknown" };
175
+ }
176
+ if (record.retiredRequestIds.delete(id))
177
+ return { kind: "late" };
178
+ return { kind: "unknown" };
179
+ }
180
+ snapshot(connection) {
181
+ const record = this.records.get(connection);
182
+ if (record === undefined)
183
+ return undefined;
184
+ return {
185
+ slot: connection.slot,
186
+ generation: connection.generation,
187
+ version: connection.version,
188
+ attached: record.attached,
189
+ pending: record.requests.size,
190
+ counters: { ...record.counters },
191
+ };
192
+ }
193
+ /** Invalidates every outstanding claim and returns the attached connections for termination. */
194
+ shutdown() {
195
+ const attached = [];
196
+ for (const [slot, state] of this.slots) {
197
+ state.claim = undefined;
198
+ if (state.current !== undefined)
199
+ attached.push(state.current);
200
+ this.pruneSlot(slot);
201
+ }
202
+ return attached;
203
+ }
204
+ retire(connection) {
205
+ const state = this.slots.get(connection.slot);
206
+ if (state?.current === connection)
207
+ state.current = undefined;
208
+ const record = this.records.get(connection);
209
+ if (record === undefined || !record.attached)
210
+ return [];
211
+ record.attached = false;
212
+ const lost = [...record.requests].map(([id, entry]) => ({
213
+ id,
214
+ phase: entry.phase,
215
+ value: entry.value,
216
+ }));
217
+ record.counters.lostOnDisconnect += lost.length;
218
+ record.requests.clear();
219
+ return lost;
220
+ }
221
+ pruneSlot(slot) {
222
+ const state = this.slots.get(slot);
223
+ if (state !== undefined && state.current === undefined && state.claim === undefined) {
224
+ this.slots.delete(slot);
225
+ }
226
+ }
227
+ }
228
+ //# sourceMappingURL=connection-registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"connection-registry.js","sourceRoot":"","sources":["../../src/dashboard-gateway/connection-registry.ts"],"names":[],"mappings":"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"}