@ekanos/harness 0.17.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 +30 -16
  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,125 @@
1
+ import * as crypto from "node:crypto";
2
+ import * as fs from "node:fs";
3
+ import { createRequire } from "node:module";
4
+ import * as path from "node:path";
5
+ import { pathToFileURL } from "node:url";
6
+ import { readProjectManifest } from "./project-manifest.js";
7
+ const stubServerOnly = {
8
+ name: "ekanos-harness-stub-server-only",
9
+ setup(build) {
10
+ build.onResolve({ filter: /^server-only$/ }, () => ({
11
+ path: "server-only",
12
+ namespace: "ekanos-harness-server-only-stub"
13
+ }));
14
+ build.onLoad(
15
+ { filter: /.*/, namespace: "ekanos-harness-server-only-stub" },
16
+ () => ({ contents: "", loader: "js" })
17
+ );
18
+ }
19
+ };
20
+ function pickDefinition(mod) {
21
+ const candidates = [];
22
+ if ("default" in mod) candidates.push(mod.default);
23
+ for (const [key, value] of Object.entries(mod)) {
24
+ if (key !== "default") candidates.push(value);
25
+ }
26
+ for (const candidate of candidates) {
27
+ if (candidate && typeof candidate === "object" && typeof candidate.slug === "string") {
28
+ return candidate;
29
+ }
30
+ }
31
+ return null;
32
+ }
33
+ async function importEntryFromSource(directory, entry) {
34
+ const entryPath = path.resolve(directory, entry);
35
+ let esbuild;
36
+ try {
37
+ esbuild = createRequire(path.join(directory, "package.json"))(
38
+ "esbuild"
39
+ );
40
+ } catch {
41
+ throw new Error(
42
+ `esbuild is not installed in ${directory}; it is needed to load ${entry} from source (it ships with @ekanos/cli).`
43
+ );
44
+ }
45
+ const cacheDir = path.join(
46
+ directory,
47
+ "node_modules",
48
+ ".cache",
49
+ "ekanos-harness"
50
+ );
51
+ fs.mkdirSync(cacheDir, { recursive: true });
52
+ const outfile = path.join(
53
+ cacheDir,
54
+ `entry-${crypto.randomBytes(6).toString("hex")}.mjs`
55
+ );
56
+ try {
57
+ await esbuild.build({
58
+ entryPoints: [entryPath],
59
+ outfile,
60
+ platform: "node",
61
+ format: "esm",
62
+ bundle: true,
63
+ external: ["@ekanos/*", "react", "react-dom", "next", "zod"],
64
+ plugins: [stubServerOnly],
65
+ loader: { ".css": "empty" },
66
+ logLevel: "silent",
67
+ absWorkingDir: directory
68
+ });
69
+ return await import(
70
+ /* webpackIgnore: true */
71
+ pathToFileURL(outfile).href
72
+ );
73
+ } finally {
74
+ fs.rmSync(outfile, { force: true });
75
+ }
76
+ }
77
+ const loadDefinitionFromSource = async (directory) => {
78
+ const manifest = readProjectManifest(directory);
79
+ if (!manifest.entry) {
80
+ throw new Error(`${directory}/ekanos.json names no "entry" to load.`);
81
+ }
82
+ const definition = pickDefinition(
83
+ await importEntryFromSource(directory, manifest.entry)
84
+ );
85
+ if (!definition) {
86
+ throw new Error(
87
+ `${manifest.entry} exports no integration definition (no export is an object with a string "slug").`
88
+ );
89
+ }
90
+ return definition;
91
+ };
92
+ const loadDefinitionFromPackage = async (packageDir) => {
93
+ const manifest = JSON.parse(
94
+ fs.readFileSync(path.join(packageDir, "package.json"), "utf8")
95
+ );
96
+ const rootExport = (() => {
97
+ const exportsField = manifest.exports;
98
+ if (typeof exportsField === "string") return exportsField;
99
+ if (exportsField && typeof exportsField === "object") {
100
+ const root = exportsField["."] ?? exportsField;
101
+ if (typeof root === "string") return root;
102
+ if (root && typeof root === "object") {
103
+ const record = root;
104
+ const pick = record.import ?? record.default ?? record.require;
105
+ if (typeof pick === "string") return pick;
106
+ }
107
+ }
108
+ return void 0;
109
+ })();
110
+ const relative = rootExport ?? manifest.module ?? manifest.main ?? "index.js";
111
+ const mod = await import(
112
+ /* webpackIgnore: true */
113
+ pathToFileURL(path.resolve(packageDir, relative)).href
114
+ );
115
+ const definition = pickDefinition(mod);
116
+ if (!definition) {
117
+ throw new Error(`${relative} exports no integration definition.`);
118
+ }
119
+ return definition;
120
+ };
121
+ export {
122
+ importEntryFromSource,
123
+ loadDefinitionFromPackage,
124
+ loadDefinitionFromSource
125
+ };
@@ -0,0 +1,34 @@
1
+ import { type LoadedExperience } from './experience-loader.js';
2
+ import { type ResolveIntegrationsOptions } from './integration-resolver.js';
3
+ import { type FixtureSource, type HttpWritePolicy, type LiveInvoker } from './operation-runner.js';
4
+ /**
5
+ * ─────────────────────────────────────────────────────────────────────────────
6
+ * `/__ekanos/api/*` — the experience harness's API (typed in `api-types.ts`)
7
+ * ─────────────────────────────────────────────────────────────────────────────
8
+ *
9
+ * One router over one lazily-built state: the resolved integrations (with
10
+ * provenance), the approvals tray, the run log and the runner dependencies.
11
+ * Every handler is `(Request) => Response` over web standards, so the whole
12
+ * thing runs under vitest with `new Request(...)` and no Next.
13
+ *
14
+ * Guards, in order: loopback `Host` (the same fence as the integration API),
15
+ * then a cross-origin refusal — a `POST` that runs integration code must not
16
+ * be triggerable by a page on another origin, so an `Origin` header that is
17
+ * not loopback is refused unless exposure was explicitly allowed.
18
+ */
19
+ export interface EkanosApiDeps {
20
+ env: Readonly<Record<string, string | undefined>>;
21
+ cwd: string;
22
+ /** Skip project-root discovery (tests). */
23
+ projectRoot: string;
24
+ contractsDir: string;
25
+ httpWrites: HttpWritePolicy;
26
+ approvalTimeoutMs: number;
27
+ now: () => Date;
28
+ resolve: Omit<ResolveIntegrationsOptions, 'projectRoot' | 'env' | 'contractsDir'>;
29
+ fixtures: (projectRoot: string) => FixtureSource;
30
+ live: LiveInvoker;
31
+ loadExperience: (projectRoot: string) => Promise<LoadedExperience | null>;
32
+ }
33
+ export type EkanosApiRouter = (request: Request, path: string[]) => Promise<Response>;
34
+ export declare function createEkanosApiRouter(partial?: Partial<EkanosApiDeps>): EkanosApiRouter;