@ekanos/harness 0.18.0 → 0.19.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 (184) hide show
  1. package/dist/api-types.d.ts +490 -0
  2. package/dist/api-types.js +6 -0
  3. package/dist/api.d.ts +33 -0
  4. package/dist/api.js +36 -1
  5. package/dist/app.js +6 -1
  6. package/dist/internal/components/approvals-tray.d.ts +17 -0
  7. package/dist/internal/components/approvals-tray.js +116 -0
  8. package/dist/internal/components/connect-controls.d.ts +12 -0
  9. package/dist/internal/components/connect-controls.js +69 -0
  10. package/dist/internal/components/connect-dialog.d.ts +19 -0
  11. package/dist/internal/components/connect-dialog.js +61 -0
  12. package/dist/internal/components/connect-panel.d.ts +25 -0
  13. package/dist/internal/components/connect-panel.js +292 -0
  14. package/dist/internal/components/connection-chip.d.ts +14 -0
  15. package/dist/internal/components/connection-chip.js +75 -0
  16. package/dist/internal/components/dashboard-grid.js +38 -24
  17. package/dist/internal/components/dev-toolbar.js +176 -103
  18. package/dist/internal/components/events-panel.d.ts +10 -0
  19. package/dist/internal/components/events-panel.js +111 -0
  20. package/dist/internal/components/health-panel.d.ts +4 -0
  21. package/dist/internal/components/health-panel.js +56 -0
  22. package/dist/internal/components/integration-badge.d.ts +29 -0
  23. package/dist/internal/components/integration-badge.js +105 -0
  24. package/dist/internal/components/local-oauth-panel.js +21 -1
  25. package/dist/internal/components/operation-runner-panel.d.ts +12 -0
  26. package/dist/internal/components/operation-runner-panel.js +331 -0
  27. package/dist/internal/components/provenance-banner.d.ts +12 -0
  28. package/dist/internal/components/provenance-banner.js +107 -0
  29. package/dist/internal/components/repo-connection.d.ts +10 -0
  30. package/dist/internal/components/repo-connection.js +32 -0
  31. package/dist/internal/components/run-log.d.ts +9 -0
  32. package/dist/internal/components/run-log.js +228 -0
  33. package/dist/internal/components/runtime-strip.d.ts +12 -0
  34. package/dist/internal/components/runtime-strip.js +158 -0
  35. package/dist/internal/components/schema-form.d.ts +13 -0
  36. package/dist/internal/components/schema-form.js +382 -0
  37. package/dist/internal/components/scrollable-nav.d.ts +12 -0
  38. package/dist/internal/components/scrollable-nav.js +68 -0
  39. package/dist/internal/components/surface-nav.d.ts +31 -1
  40. package/dist/internal/components/surface-nav.js +238 -31
  41. package/dist/internal/components/workflow-runner.d.ts +14 -0
  42. package/dist/internal/components/workflow-runner.js +104 -0
  43. package/dist/internal/lib/bundled-secrets.d.ts +9 -0
  44. package/dist/internal/lib/bundled-secrets.js +24 -0
  45. package/dist/internal/lib/chrome-slot.d.ts +2 -0
  46. package/dist/internal/lib/chrome-slot.js +25 -0
  47. package/dist/internal/lib/connection-facts.d.ts +44 -0
  48. package/dist/internal/lib/connection-facts.js +116 -0
  49. package/dist/internal/lib/console-client.d.ts +55 -0
  50. package/dist/internal/lib/console-client.js +295 -0
  51. package/dist/internal/lib/console-context.d.ts +40 -0
  52. package/dist/internal/lib/console-context.js +67 -0
  53. package/dist/internal/lib/console-hooks.d.ts +33 -0
  54. package/dist/internal/lib/console-hooks.js +118 -0
  55. package/dist/internal/lib/console-types.d.ts +279 -0
  56. package/dist/internal/lib/console-types.js +0 -0
  57. package/dist/internal/lib/experience-runtime.d.ts +8 -0
  58. package/dist/internal/lib/experience-runtime.js +22 -0
  59. package/dist/internal/lib/preview-sections.d.ts +13 -0
  60. package/dist/internal/lib/preview-sections.js +32 -0
  61. package/dist/internal/lib/repo-context.d.ts +20 -0
  62. package/dist/internal/lib/repo-context.js +64 -0
  63. package/dist/internal/lib/run-log-view.d.ts +24 -0
  64. package/dist/internal/lib/run-log-view.js +57 -0
  65. package/dist/internal/lib/schema-form-model.d.ts +34 -0
  66. package/dist/internal/lib/schema-form-model.js +272 -0
  67. package/dist/internal/lib/toolbar-context.d.ts +9 -1
  68. package/dist/internal/lib/toolbar-context.js +13 -3
  69. package/dist/internal/lib/toolbar-visibility.d.ts +16 -0
  70. package/dist/internal/lib/toolbar-visibility.js +31 -0
  71. package/dist/internal/registry-context.d.ts +2 -0
  72. package/dist/internal/registry-context.js +11 -9
  73. package/dist/internal/routes/activation-page.js +44 -20
  74. package/dist/internal/routes/console-home-page.d.ts +5 -0
  75. package/dist/internal/routes/console-home-page.js +18 -0
  76. package/dist/internal/routes/experience-connect-page.d.ts +6 -0
  77. package/dist/internal/routes/experience-connect-page.js +127 -0
  78. package/dist/internal/routes/experience-page-host.d.ts +2 -0
  79. package/dist/internal/routes/experience-page-host.js +18 -0
  80. package/dist/internal/routes/experience-review-queue-page.d.ts +2 -0
  81. package/dist/internal/routes/experience-review-queue-page.js +60 -0
  82. package/dist/internal/routes/experience-runs-page.d.ts +1 -0
  83. package/dist/internal/routes/experience-runs-page.js +13 -0
  84. package/dist/internal/routes/experience-summary-page.d.ts +1 -0
  85. package/dist/internal/routes/experience-summary-page.js +101 -0
  86. package/dist/internal/routes/experience-widget-page.d.ts +1 -0
  87. package/dist/internal/routes/experience-widget-page.js +26 -0
  88. package/dist/internal/routes/experience-widgets-page.d.ts +6 -0
  89. package/dist/internal/routes/experience-widgets-page.js +22 -0
  90. package/dist/internal/routes/experience-workflow-page.d.ts +1 -0
  91. package/dist/internal/routes/experience-workflow-page.js +24 -0
  92. package/dist/internal/routes/experience-workflows-page.d.ts +1 -0
  93. package/dist/internal/routes/experience-workflows-page.js +44 -0
  94. package/dist/internal/routes/index-page.d.ts +10 -9
  95. package/dist/internal/routes/index-page.js +3 -68
  96. package/dist/internal/routes/integration-layout.d.ts +12 -1
  97. package/dist/internal/routes/integration-layout.js +20 -6
  98. package/dist/internal/routes/integrations-connect-page.d.ts +1 -0
  99. package/dist/internal/routes/integrations-connect-page.js +19 -0
  100. package/dist/internal/routes/integrations-events-page.d.ts +1 -0
  101. package/dist/internal/routes/integrations-events-page.js +10 -0
  102. package/dist/internal/routes/integrations-health-page.d.ts +1 -0
  103. package/dist/internal/routes/integrations-health-page.js +10 -0
  104. package/dist/internal/routes/integrations-layout.d.ts +17 -0
  105. package/dist/internal/routes/integrations-layout.js +106 -0
  106. package/dist/internal/routes/integrations-list-page.d.ts +2 -0
  107. package/dist/internal/routes/integrations-list-page.js +94 -0
  108. package/dist/internal/routes/integrations-operation-page.d.ts +1 -0
  109. package/dist/internal/routes/integrations-operation-page.js +29 -0
  110. package/dist/internal/routes/integrations-operations-page.d.ts +1 -0
  111. package/dist/internal/routes/integrations-operations-page.js +61 -0
  112. package/dist/internal/routes/integrations-overview-page.d.ts +1 -0
  113. package/dist/internal/routes/integrations-overview-page.js +90 -0
  114. package/dist/internal/routes/integrations-runs-page.d.ts +1 -0
  115. package/dist/internal/routes/integrations-runs-page.js +14 -0
  116. package/dist/internal/routes/integrations-scope.d.ts +12 -0
  117. package/dist/internal/routes/integrations-scope.js +39 -0
  118. package/dist/internal/routes/legacy-preview-redirect.d.ts +6 -0
  119. package/dist/internal/routes/legacy-preview-redirect.js +12 -0
  120. package/dist/internal/routes/preview-index-page.d.ts +2 -0
  121. package/dist/internal/routes/preview-index-page.js +14 -0
  122. package/dist/internal/routes/repo-connections-page.d.ts +6 -0
  123. package/dist/internal/routes/repo-connections-page.js +8 -0
  124. package/dist/internal/routes/repo-home-page.d.ts +2 -0
  125. package/dist/internal/routes/repo-home-page.js +320 -0
  126. package/dist/internal/routes/repo-layout.d.ts +7 -0
  127. package/dist/internal/routes/repo-layout.js +76 -0
  128. package/dist/internal/routes/repo-package-layouts.d.ts +20 -0
  129. package/dist/internal/routes/repo-package-layouts.js +104 -0
  130. package/dist/internal/routes/root-layout.d.ts +3 -1
  131. package/dist/internal/routes/root-layout.js +13 -3
  132. package/dist/internal/routes/single-widget-page.js +5 -12
  133. package/dist/internal/routes/tile-page.js +20 -41
  134. package/dist/internal/routes/triggers-page.js +55 -62
  135. package/dist/internal/routes/widgets-page.js +1 -1
  136. package/dist/internal/server/api-router.js +46 -4
  137. package/dist/internal/server/approvals.d.ts +44 -0
  138. package/dist/internal/server/approvals.js +76 -0
  139. package/dist/internal/server/contract-sources.d.ts +28 -0
  140. package/dist/internal/server/contract-sources.js +83 -0
  141. package/dist/internal/server/definition-loader.d.ts +22 -0
  142. package/dist/internal/server/definition-loader.js +125 -0
  143. package/dist/internal/server/ekanos-api-router.d.ts +34 -0
  144. package/dist/internal/server/ekanos-api-router.js +835 -0
  145. package/dist/internal/server/experience-loader.d.ts +57 -0
  146. package/dist/internal/server/experience-loader.js +146 -0
  147. package/dist/internal/server/integration-lookup.d.ts +29 -0
  148. package/dist/internal/server/integration-lookup.js +33 -0
  149. package/dist/internal/server/integration-resolver.d.ts +121 -0
  150. package/dist/internal/server/integration-resolver.js +605 -0
  151. package/dist/internal/server/live-invoker.d.ts +11 -0
  152. package/dist/internal/server/live-invoker.js +106 -0
  153. package/dist/internal/server/local-secrets.d.ts +82 -1
  154. package/dist/internal/server/local-secrets.js +112 -1
  155. package/dist/internal/server/local-state.d.ts +12 -0
  156. package/dist/internal/server/local-state.js +45 -0
  157. package/dist/internal/server/oauth-persistence.d.ts +19 -0
  158. package/dist/internal/server/oauth-persistence.js +76 -0
  159. package/dist/internal/server/operation-runner.d.ts +95 -0
  160. package/dist/internal/server/operation-runner.js +231 -0
  161. package/dist/internal/server/project-manifest.d.ts +71 -0
  162. package/dist/internal/server/project-manifest.js +215 -0
  163. package/dist/internal/server/registry-cache.d.ts +68 -0
  164. package/dist/internal/server/registry-cache.js +328 -0
  165. package/dist/internal/server/repo-api-router.d.ts +33 -0
  166. package/dist/internal/server/repo-api-router.js +391 -0
  167. package/dist/internal/server/run-log.d.ts +22 -0
  168. package/dist/internal/server/run-log.js +32 -0
  169. package/dist/internal/server/semantics.d.ts +28 -0
  170. package/dist/internal/server/semantics.js +67 -0
  171. package/dist/internal/server/session-catalog.d.ts +67 -0
  172. package/dist/internal/server/session-catalog.js +18 -0
  173. package/dist/internal/server/workflow-runner.d.ts +36 -0
  174. package/dist/internal/server/workflow-runner.js +183 -0
  175. package/dist/registry.d.ts +7 -0
  176. package/dist/resolver.d.ts +145 -0
  177. package/dist/resolver.js +211 -0
  178. package/dist/routes.d.ts +64 -2
  179. package/dist/routes.js +59 -3
  180. package/dist/runtime.d.ts +46 -0
  181. package/dist/runtime.js +60 -0
  182. package/package.json +23 -9
  183. package/dist/internal/routes/integration-index-page.d.ts +0 -13
  184. package/dist/internal/routes/integration-index-page.js +0 -17
@@ -0,0 +1,328 @@
1
+ import { compareSemver, compatLine } from "@ekanos/integration-schema";
2
+ import { spawn } from "node:child_process";
3
+ import { createHash, randomBytes } from "node:crypto";
4
+ import * as fs from "node:fs";
5
+ import * as path from "node:path";
6
+ const DEFAULT_REGISTRY_URL = "https://npm.pkg.github.com";
7
+ const PACKAGE_SCOPE = "@companydotcom";
8
+ const CACHE_MARKER = ".ekanos-cache.json";
9
+ function integrationPackageName(slug) {
10
+ return `${PACKAGE_SCOPE}/integration-${slug}`;
11
+ }
12
+ function registryTokenEnvName(registryUrl) {
13
+ return `npm_config_//${new URL(registryUrl).host}/:_authToken`;
14
+ }
15
+ function cacheRoot(projectRoot) {
16
+ return path.join(projectRoot, ".ekanos", "cache", "integrations");
17
+ }
18
+ function defaultEnsureDeps(env = process.env) {
19
+ return {
20
+ env,
21
+ fetch: (input, init) => globalThis.fetch(input, init),
22
+ registryUrl: DEFAULT_REGISTRY_URL,
23
+ extract: extractWithSystemTar,
24
+ installDependencies: installWithNpm
25
+ };
26
+ }
27
+ function scrub(text, token) {
28
+ return token ? text.split(token).join("\u2039token\u203A") : text;
29
+ }
30
+ function candidateVersions(versions, line) {
31
+ const stable = versions.filter((version) => {
32
+ try {
33
+ compatLine(version);
34
+ return !version.includes("-");
35
+ } catch {
36
+ return false;
37
+ }
38
+ }).sort((a, b) => compareSemver(b, a));
39
+ const same = stable.filter((version) => compatLine(version) === line);
40
+ const others = stable.filter((version) => compatLine(version) !== line);
41
+ return [...same, ...others].slice(0, 8);
42
+ }
43
+ function shippedLine(packageDir, version) {
44
+ try {
45
+ const contract = JSON.parse(
46
+ fs.readFileSync(path.join(packageDir, "contract.json"), "utf8")
47
+ );
48
+ if (typeof contract.compatLine === "string") return contract.compatLine;
49
+ } catch {
50
+ }
51
+ try {
52
+ return compatLine(version);
53
+ } catch {
54
+ return null;
55
+ }
56
+ }
57
+ function verifyIntegrity(bytes, dist) {
58
+ if (dist.integrity) {
59
+ const match = /^sha512-(.+)$/.exec(dist.integrity);
60
+ if (!match) return false;
61
+ return createHash("sha512").update(bytes).digest("base64") === match[1];
62
+ }
63
+ if (dist.shasum) {
64
+ return createHash("sha1").update(bytes).digest("hex") === dist.shasum;
65
+ }
66
+ return false;
67
+ }
68
+ async function ensurePublishedIntegration(args, deps = defaultEnsureDeps()) {
69
+ const token = deps.env[registryTokenEnvName(deps.registryUrl)]?.trim();
70
+ if (!token) {
71
+ return {
72
+ ok: false,
73
+ reason: "no_token",
74
+ message: `No registry token: set ${registryTokenEnvName(deps.registryUrl)} to run ${args.integration} live from its published package.`
75
+ };
76
+ }
77
+ const name = integrationPackageName(args.integration);
78
+ const registryHost = new URL(deps.registryUrl).host;
79
+ const headers = {
80
+ authorization: `Bearer ${token}`,
81
+ accept: "application/json"
82
+ };
83
+ const fail = (reason, message) => ({ ok: false, reason, message: scrub(message, token) });
84
+ let packument;
85
+ try {
86
+ const response = await deps.fetch(
87
+ `${deps.registryUrl}/${name.replace("/", "%2f")}`,
88
+ { headers, redirect: "error" }
89
+ );
90
+ if (!response.ok) {
91
+ return fail(
92
+ "registry_rejected",
93
+ `The registry answered ${response.status} for ${name}.`
94
+ );
95
+ }
96
+ packument = await response.json();
97
+ } catch (error) {
98
+ return fail(
99
+ "registry_unreachable",
100
+ `Could not reach the registry for ${name}: ${error instanceof Error ? error.message : String(error)}`
101
+ );
102
+ }
103
+ const candidates = candidateVersions(
104
+ Object.keys(packument.versions ?? {}),
105
+ args.line
106
+ );
107
+ if (candidates.length === 0) {
108
+ return fail(
109
+ "no_version_in_line",
110
+ `${name} has no published version on compat line ${args.line}.`
111
+ );
112
+ }
113
+ for (const version of candidates) {
114
+ const outcome = await installVersion({
115
+ args,
116
+ deps,
117
+ token,
118
+ registryHost,
119
+ name,
120
+ version,
121
+ dist: packument.versions?.[version]?.dist ?? {},
122
+ fail
123
+ });
124
+ if (outcome !== "wrong_line") return outcome;
125
+ }
126
+ return fail(
127
+ "no_version_in_line",
128
+ `No recent release of ${name} ships a contract on compat line ${args.line}.`
129
+ );
130
+ }
131
+ async function installVersion(context) {
132
+ const { args, deps, token, registryHost, name, version, dist, fail } = context;
133
+ const finalDir = path.join(
134
+ cacheRoot(args.projectRoot),
135
+ `${args.integration}@${version}`
136
+ );
137
+ const packageDir = path.join(finalDir, "package");
138
+ const marker = readMarker(finalDir);
139
+ if (marker && marker.version === version && marker.name === name && marker.line === args.line) {
140
+ return { ok: true, version, packageDir, fromCache: true };
141
+ }
142
+ if (!dist.tarball) {
143
+ return fail("registry_rejected", `${name}@${version} lists no tarball.`);
144
+ }
145
+ let tarballUrl;
146
+ try {
147
+ tarballUrl = new URL(dist.tarball);
148
+ } catch {
149
+ return fail(
150
+ "registry_rejected",
151
+ `${name}@${version} lists an invalid tarball URL.`
152
+ );
153
+ }
154
+ const tarballHeaders = tarballUrl.host === registryHost ? { authorization: `Bearer ${token}` } : {};
155
+ let bytes;
156
+ try {
157
+ const response = await deps.fetch(tarballUrl, {
158
+ headers: tarballHeaders,
159
+ redirect: tarballUrl.host === registryHost ? "follow" : "error"
160
+ });
161
+ if (!response.ok) {
162
+ return fail(
163
+ "registry_rejected",
164
+ `Downloading ${name}@${version} answered ${response.status}.`
165
+ );
166
+ }
167
+ bytes = Buffer.from(await response.arrayBuffer());
168
+ } catch (error) {
169
+ return fail(
170
+ "registry_unreachable",
171
+ `Downloading ${name}@${version} failed: ${error instanceof Error ? error.message : String(error)}`
172
+ );
173
+ }
174
+ if (!verifyIntegrity(bytes, dist)) {
175
+ return fail(
176
+ "integrity_failed",
177
+ `${name}@${version} failed its integrity check; nothing was installed.`
178
+ );
179
+ }
180
+ const staging = `${finalDir}.tmp-${randomBytes(4).toString("hex")}`;
181
+ try {
182
+ fs.mkdirSync(staging, { recursive: true });
183
+ const tarballFile = path.join(staging, "package.tgz");
184
+ fs.writeFileSync(tarballFile, bytes);
185
+ await deps.extract(tarballFile, staging);
186
+ fs.rmSync(tarballFile, { force: true });
187
+ const stagedPackage = path.join(staging, "package");
188
+ if (!fs.existsSync(path.join(stagedPackage, "package.json"))) {
189
+ throw new Error("the tarball has no package/package.json");
190
+ }
191
+ if (shippedLine(stagedPackage, version) !== args.line) {
192
+ fs.rmSync(staging, { recursive: true, force: true });
193
+ return "wrong_line";
194
+ }
195
+ await deps.installDependencies({
196
+ packageDir: stagedPackage,
197
+ env: installEnv(deps.env, deps.registryUrl, token)
198
+ });
199
+ linkProjectPeers(args.projectRoot, stagedPackage);
200
+ fs.writeFileSync(
201
+ path.join(staging, CACHE_MARKER),
202
+ `${JSON.stringify({ name, version, line: args.line, integrity: dist.integrity ?? dist.shasum ?? null }, null, 2)}
203
+ `
204
+ );
205
+ fs.rmSync(finalDir, { recursive: true, force: true });
206
+ fs.renameSync(staging, finalDir);
207
+ } catch (error) {
208
+ fs.rmSync(staging, { recursive: true, force: true });
209
+ return fail(
210
+ "install_failed",
211
+ `Installing ${name}@${version} failed: ${error instanceof Error ? error.message : String(error)}`
212
+ );
213
+ }
214
+ return { ok: true, version, packageDir, fromCache: false };
215
+ }
216
+ function readMarker(dir) {
217
+ try {
218
+ const parsed = JSON.parse(
219
+ fs.readFileSync(path.join(dir, CACHE_MARKER), "utf8")
220
+ );
221
+ return typeof parsed.name === "string" && typeof parsed.version === "string" ? {
222
+ name: parsed.name,
223
+ version: parsed.version,
224
+ line: typeof parsed.line === "string" ? parsed.line : null
225
+ } : null;
226
+ } catch {
227
+ return null;
228
+ }
229
+ }
230
+ function installEnv(env, registryUrl, token) {
231
+ const out = {};
232
+ for (const [key, value] of Object.entries(env)) {
233
+ if (value !== void 0) out[key] = value;
234
+ }
235
+ out[registryTokenEnvName(registryUrl)] = token;
236
+ out[`npm_config_${PACKAGE_SCOPE}:registry`] = registryUrl;
237
+ return out;
238
+ }
239
+ const LINKED_PEERS = ["react", "react-dom", "zod", "@tanstack/react-query"];
240
+ function linkProjectPeers(projectRoot, packageDir) {
241
+ const projectModules = path.join(projectRoot, "node_modules");
242
+ const targetModules = path.join(packageDir, "node_modules");
243
+ fs.mkdirSync(targetModules, { recursive: true });
244
+ const names = [...LINKED_PEERS];
245
+ const ekanosDir = path.join(projectModules, "@ekanos");
246
+ if (fs.existsSync(ekanosDir)) {
247
+ for (const entry of fs.readdirSync(ekanosDir))
248
+ names.push(`@ekanos/${entry}`);
249
+ }
250
+ for (const name of names) {
251
+ const source = path.join(projectModules, ...name.split("/"));
252
+ const dest = path.join(targetModules, ...name.split("/"));
253
+ if (!fs.existsSync(source) || fs.existsSync(dest)) continue;
254
+ fs.mkdirSync(path.dirname(dest), { recursive: true });
255
+ fs.symlinkSync(fs.realpathSync(source), dest, "dir");
256
+ }
257
+ }
258
+ function run(bin, argv, options) {
259
+ return new Promise((resolve, reject) => {
260
+ const child = spawn(bin, argv, {
261
+ cwd: options.cwd,
262
+ env: { ...process.env, ...options.env ?? {} },
263
+ stdio: ["ignore", "pipe", "pipe"]
264
+ });
265
+ let output = "";
266
+ child.stdout.on("data", (chunk) => {
267
+ output += chunk.toString();
268
+ });
269
+ child.stderr.on("data", (chunk) => {
270
+ output += chunk.toString();
271
+ });
272
+ child.on("error", reject);
273
+ child.on("close", (code) => resolve({ code: code ?? 1, output }));
274
+ });
275
+ }
276
+ async function extractWithSystemTar(tarball, destDir) {
277
+ const listing = await run("tar", ["-tzf", tarball], {});
278
+ if (listing.code !== 0) throw new Error("tar could not list the tarball");
279
+ for (const entry of listing.output.split("\n").filter(Boolean)) {
280
+ const normalized = entry.replace(/\\/g, "/");
281
+ if (normalized.startsWith("/") || normalized.split("/").includes("..") || !normalized.startsWith("package/")) {
282
+ throw new Error(`the tarball contains an unsafe entry (${entry})`);
283
+ }
284
+ }
285
+ const result = await run(
286
+ "tar",
287
+ ["-xzf", tarball, "-C", destDir, "--no-same-owner"],
288
+ {}
289
+ );
290
+ if (result.code !== 0) throw new Error("tar failed to extract the tarball");
291
+ }
292
+ async function installWithNpm(args) {
293
+ const manifest = JSON.parse(
294
+ fs.readFileSync(path.join(args.packageDir, "package.json"), "utf8")
295
+ );
296
+ if (Object.keys(manifest.dependencies ?? {}).length === 0) return;
297
+ const result = await run(
298
+ "npm",
299
+ [
300
+ "install",
301
+ "--omit=dev",
302
+ "--omit=peer",
303
+ "--ignore-scripts",
304
+ "--no-audit",
305
+ "--no-fund",
306
+ "--no-package-lock"
307
+ ],
308
+ { cwd: args.packageDir, env: args.env }
309
+ );
310
+ if (result.code !== 0) {
311
+ const token = args.env[Object.keys(args.env).find((key) => key.endsWith(":_authToken")) ?? ""];
312
+ throw new Error(
313
+ `npm install failed: ${scrub(result.output.slice(-800), token)}`
314
+ );
315
+ }
316
+ }
317
+ export {
318
+ CACHE_MARKER,
319
+ DEFAULT_REGISTRY_URL,
320
+ PACKAGE_SCOPE,
321
+ cacheRoot,
322
+ defaultEnsureDeps,
323
+ ensurePublishedIntegration,
324
+ extractWithSystemTar,
325
+ integrationPackageName,
326
+ registryTokenEnvName,
327
+ scrub
328
+ };
@@ -0,0 +1,33 @@
1
+ import { type RepoDiscovery, type RepoPackage } from '@ekanos/integration-schema/repo';
2
+ import { type EkanosApiRouter } from './ekanos-api-router.js';
3
+ /**
4
+ * ─────────────────────────────────────────────────────────────────────────────
5
+ * `/__ekanos/api/*` for a REPO root: one server, every package
6
+ * ─────────────────────────────────────────────────────────────────────────────
7
+ *
8
+ * GET repo everything the repo home
9
+ * and Connections page draw
10
+ * POST repo/connections/:integration/disconnect
11
+ * * packages/(integrations|experiences)/:name/… that package's own harness
12
+ * API, served by a router
13
+ * rooted at the package, so
14
+ * its credentials stay in
15
+ * its own `.ekanos/` store
16
+ *
17
+ * A package router is the ordinary single-project router, unchanged. A
18
+ * single-package project never reaches this file.
19
+ */
20
+ export interface RepoApiDeps {
21
+ env: Readonly<Record<string, string | undefined>>;
22
+ repoRoot: string;
23
+ discover: (root: string) => RepoDiscovery;
24
+ /** Build the router for one package. Tests inject fakes. */
25
+ createPackageRouter: (pkg: RepoPackage) => EkanosApiRouter;
26
+ /** Is an OAuth connection held in this process, or stored under `root`, for the integration? */
27
+ hasOauthConnection: (slug: string, root: string) => boolean;
28
+ forgetOauthConnection: (slug: string) => void;
29
+ }
30
+ export type RepoApiRouter = EkanosApiRouter;
31
+ export declare function createRepoApiRouter(partial: Partial<RepoApiDeps> & {
32
+ repoRoot: string;
33
+ }): RepoApiRouter;