@ekanos/harness 0.1.0 → 0.1.2

package/README.md

@@ -738,6 +738,12 @@ Every invocation runs against **one** `createMockContext()` per visit, so state
 accumulates across invocations the way it would in a real account. Leaving the
 page resets it.
 
+**`onActivate` runs on the Activation surface, not here.** Submitting the
+activation form there runs your real `onActivate` hook (if declared) against
+its own `createMockContext()`, seeded from the same `triggerMocks` below, and
+shows the outcome — ran / skipped (not declared) / threw with the message —
+right under the connect dialog.
+
 ### `triggerMocks`
 
 The mock context is derived from the definition — slug, storage schemas, egress

package/dist/internal/lib/definition-mock-context.d.ts

@@ -0,0 +1,14 @@
+import { type MockIntegrationContext } from '@ekanos/sdk/testing';
+import { type FixtureVariant, type HarnessIntegration } from '../../registry.js';
+/**
+ * One `createMockContext()` derived from a harness integration's definition
+ * (slug, storage schemas, egress) plus its `triggerMocks` seeds — the exact
+ * construction the Triggers surface uses for webhooks/schedules, extracted
+ * here so the Activation surface can run `onActivate` against the SAME kind
+ * of context a partner's handlers see elsewhere in the harness.
+ *
+ * One context per mount: `useState`'s initializer keeps it stable across
+ * re-renders without an effect, and state (storage, secrets, logs)
+ * accumulates for the life of the visit, like a real account.
+ */
+export declare function useDefinitionMockContext(integration: HarnessIntegration, variant: FixtureVariant): MockIntegrationContext | null;

package/dist/internal/lib/definition-mock-context.js

@@ -0,0 +1,43 @@
+"use client";
+import { useState } from "react";
+import {
+  createMockContext
+} from "@ekanos/sdk/testing";
+import {
+  HARNESS_ACCOUNT_ID,
+  resolveEgress
+} from "../../registry.js";
+import { compileFixtures, fixturesToMockHandlers } from "./http-fixtures.js";
+function useDefinitionMockContext(integration, variant) {
+  const [ctx] = useState(() => {
+    const definition = integration.definition;
+    if (!definition) return null;
+    const mocks = integration.triggerMocks ?? {};
+    return createMockContext({
+      accountId: HARNESS_ACCOUNT_ID,
+      integration: { slug: definition.slug },
+      ...definition.storage ? { storageSchemas: definition.storage } : {},
+      egress: definition.egress ?? [],
+      ...mocks.storage ? {
+        storage: mocks.storage
+      } : {},
+      ...mocks.secrets ? { secrets: mocks.secrets } : {},
+      fetchHandlers: [
+        ...mocks.fetchHandlers ?? [],
+        ...fixturesToMockHandlers(
+          // Client-only, like the layout: no origin on the server, and
+          // nothing fetches there.
+          globalThis.location === void 0 ? [] : compileFixtures(
+            integration.fixtures?.[variant] ?? [],
+            resolveEgress(integration),
+            globalThis.location.origin
+          )
+        )
+      ]
+    });
+  });
+  return ctx;
+}
+export {
+  useDefinitionMockContext
+};

package/dist/internal/lib/run-activation-hook.d.ts

@@ -0,0 +1,28 @@
+import type { IntegrationDefinition } from '@ekanos/sdk/integration';
+import { type MockIntegrationContext } from '@ekanos/sdk/testing';
+/**
+ * The outcome of one local run of a definition's `onActivate` hook, for the
+ * Activation surface's readout:
+ *
+ *  - `'skipped'`   — the definition (or the harness entry) declares no
+ *    `onActivate` at all. Not an error: most integrations have nothing to
+ *    seed and this is a perfectly good answer.
+ *  - `'ran'`       — the hook completed without throwing.
+ *  - `'threw'`     — the hook threw. In production this is NON-FATAL (logged
+ *    as a warning, activation stays active — see `OnActivateHandler`'s
+ *    TSDoc); the harness surfaces the same "not fatal, but look at this"
+ *    framing rather than treating it as a failed activation.
+ *
+ * Pulled out of the activation route component so it is testable without
+ * rendering anything — the harness deliberately carries no component/DOM
+ * tests (see vitest.config.ts), only the underlying logic.
+ */
+export type OnActivateOutcome = {
+    status: 'skipped';
+} | {
+    status: 'ran';
+} | {
+    status: 'threw';
+    message: string;
+};
+export declare function runOnActivateHook(definition: IntegrationDefinition | undefined, ctx: MockIntegrationContext | null): Promise<OnActivateOutcome>;

package/dist/internal/lib/run-activation-hook.js

@@ -0,0 +1,20 @@
+import {
+  invokeActivate
+} from "@ekanos/sdk/testing";
+function describeError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+async function runOnActivateHook(definition, ctx) {
+  if (!definition?.onActivate || !ctx) {
+    return { status: "skipped" };
+  }
+  try {
+    await invokeActivate(definition, { context: ctx });
+    return { status: "ran" };
+  } catch (error) {
+    return { status: "threw", message: describeError(error) };
+  }
+}
+export {
+  runOnActivateHook
+};

package/dist/internal/routes/activation-page.js

@@ -1,5 +1,5 @@
 "use client";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useState } from "react";
 import { notFound } from "next/navigation";
 import { Alert, AlertDescription, AlertTitle } from "@ekanos/ui/alert";
@@ -13,11 +13,27 @@ import {
   DialogTitle
 } from "@ekanos/ui/dialog";
 import { HARNESS_ACCOUNT_ID } from "../../registry.js";
+import { useDefinitionMockContext } from "../lib/definition-mock-context.js";
 import { hasSensitiveValues, redactSensitive } from "../lib/redact.js";
+import {
+  runOnActivateHook
+} from "../lib/run-activation-hook.js";
+import { useToolbar } from "../lib/toolbar-context.js";
 import { useHarnessIntegration } from "../registry-context.js";
 function ActivationPage() {
-  const [flow, setFlow] = useState({ open: true, connected: false, result: null, revealed: false });
+  const [flow, setFlow] = useState({
+    open: true,
+    connected: false,
+    result: null,
+    revealed: false,
+    activationHook: null
+  });
   const integration = useHarnessIntegration();
+  const { state: toolbar } = useToolbar();
+  const ctx = useDefinitionMockContext(
+    integration ?? { slug: "", name: "", description: "", widgets: [] },
+    toolbar.variant
+  );
   if (!integration) notFound();
   const ActivationForm = integration.activationForm;
   const definition = integration.definition;
@@ -67,7 +83,8 @@ function ActivationPage() {
                   open: false,
                   connected: false,
                   result: null,
-                  revealed: false
+                  revealed: false,
+                  activationHook: null
                 }),
                 children: "Reset flow"
               }
@@ -98,7 +115,8 @@ function ActivationPage() {
                       open: true,
                       connected: false,
                       result: null,
-                      revealed: false
+                      revealed: false,
+                      activationHook: null
                     })
                   }
                 ) : (
@@ -113,12 +131,19 @@ function ActivationPage() {
                       accountId: HARNESS_ACCOUNT_ID,
                       productSlug: integration.slug,
                       inline: true,
-                      onSuccess: (result) => setFlow({
-                        open: false,
-                        connected: true,
-                        result: result ?? null,
-                        revealed: false
-                      }),
+                      onSuccess: async (result) => {
+                        const activationHook = await runOnActivateHook(
+                          definition,
+                          ctx
+                        );
+                        setFlow({
+                          open: false,
+                          connected: true,
+                          result: result ?? null,
+                          revealed: false,
+                          activationHook
+                        });
+                      },
                       onCancel: () => setFlow((prev) => ({ ...prev, open: false }))
                     }
                   )
@@ -174,7 +199,34 @@ function ActivationPage() {
             null,
             2
           ) })
-        ] }) : null
+        ] }) : null,
+        flow.activationHook ? /* @__PURE__ */ jsx(OnActivatePanel, { outcome: flow.activationHook }) : null
+      ]
+    }
+  );
+}
+function OnActivatePanel({ outcome }) {
+  const badge = outcome.status === "ran" ? { variant: "default", label: "onActivate ran" } : outcome.status === "skipped" ? {
+    variant: "secondary",
+    label: "onActivate skipped \u2014 not declared"
+  } : { variant: "destructive", label: "onActivate threw" };
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: "bg-card flex flex-col gap-2 rounded-lg border p-6",
+      "data-test": "activation-onactivate-outcome",
+      children: [
+        /* @__PURE__ */ jsx("div", { className: "flex items-center gap-2", children: /* @__PURE__ */ jsx(Badge, { variant: badge.variant, children: badge.label }) }),
+        outcome.status === "skipped" ? /* @__PURE__ */ jsxs("p", { className: "text-muted-foreground text-sm", children: [
+          "This integration declares no ",
+          /* @__PURE__ */ jsx("code", { children: "onActivate" }),
+          " hook \u2014 a perfectly good answer for one with nothing to seed at connect time. Add one to ",
+          /* @__PURE__ */ jsx("code", { children: "defineIntegration()" }),
+          " to warm a cache or sanity-check a credential the moment a user connects."
+        ] }) : outcome.status === "threw" ? /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx("p", { className: "text-muted-foreground text-sm", children: "In production this is NON-FATAL: the throw is logged and shown to the user as a warning, and the activation stays connected \u2014 this hook is for cache seeding and eager validation, not a connect gate." }),
+          /* @__PURE__ */ jsx("pre", { className: "bg-muted overflow-x-auto rounded-md p-3 text-xs", children: outcome.message })
+        ] }) : /* @__PURE__ */ jsx("p", { className: "text-muted-foreground text-sm", children: "Ran against the same kind of capability context (storage, secrets, egress) your schedules and webhooks run against." })
       ]
     }
   );

package/dist/internal/routes/triggers-page.js

@@ -4,7 +4,6 @@ import { useState } from "react";
 import { notFound } from "next/navigation";
 import { isEgressAllowed } from "@ekanos/sdk/context";
 import {
-  createMockContext,
   invokeSchedule,
   invokeWebhook
 } from "@ekanos/sdk/testing";
@@ -12,43 +11,9 @@ import { Alert, AlertDescription, AlertTitle } from "@ekanos/ui/alert";
 import { Badge } from "@ekanos/ui/badge";
 import { Button } from "@ekanos/ui/button";
 import { Textarea } from "@ekanos/ui/textarea";
-import {
-  HARNESS_ACCOUNT_ID,
-  resolveEgress
-} from "../../registry.js";
-import { compileFixtures, fixturesToMockHandlers } from "../lib/http-fixtures.js";
+import { useDefinitionMockContext } from "../lib/definition-mock-context.js";
 import { useToolbar } from "../lib/toolbar-context.js";
 import { useHarnessIntegration } from "../registry-context.js";
-function useTriggerContext(integration, variant) {
-  const [ctx] = useState(() => {
-    const definition = integration.definition;
-    if (!definition) return null;
-    const mocks = integration.triggerMocks ?? {};
-    return createMockContext({
-      accountId: HARNESS_ACCOUNT_ID,
-      integration: { slug: definition.slug },
-      ...definition.storage ? { storageSchemas: definition.storage } : {},
-      egress: definition.egress ?? [],
-      ...mocks.storage ? {
-        storage: mocks.storage
-      } : {},
-      ...mocks.secrets ? { secrets: mocks.secrets } : {},
-      fetchHandlers: [
-        ...mocks.fetchHandlers ?? [],
-        ...fixturesToMockHandlers(
-          // Client-only, like the layout: no origin on the server, and
-          // nothing fetches there.
-          globalThis.location === void 0 ? [] : compileFixtures(
-            integration.fixtures?.[variant] ?? [],
-            resolveEgress(integration),
-            globalThis.location.origin
-          )
-        )
-      ]
-    });
-  });
-  return ctx;
-}
 function OutcomePanel({ outcome }) {
   return /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-3", "data-test": "trigger-outcome", children: [
     /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
@@ -320,7 +285,7 @@ function OAuthCard({ definition }) {
 function TriggersPage() {
   const integration = useHarnessIntegration();
   const { state } = useToolbar();
-  const ctx = useTriggerContext(
+  const ctx = useDefinitionMockContext(
     integration ?? { slug: "", name: "", description: "", widgets: [] },
     state.variant
   );

package/dist/styles.css

@@ -161,8 +161,12 @@ i:is(.fa-light, .fa-thin, .fa-duotone, .fa-sharp) {
  * below and the authored Pro glyph renders exactly as designed. Nothing here
  * changes what a correctly licensed host shows.
  *
- * Keep this list to names our own bundled examples actually reference; it is a
- * courtesy for the demo surfaces, not a general-purpose Pro→Free shim. */
+ * Keep this list to names our own bundled examples actually reference, or a
+ * real Pro-only name a partner build hit and reported (the block below it) —
+ * it is a courtesy for demo/partner surfaces, not a general-purpose
+ * Pro→Free shim covering every Pro glyph. `src/_impl/__tests__/
+ * fa-free-icon-names.test.tsx` in `@ekanos/ui` asserts every name here is
+ * genuinely Free-missing and every codepoint names a real Free glyph. */
 i.fa-sun-bright {
   --fa: '\f185'; /* fa-sun */
 }
@@ -194,6 +198,37 @@ i.fa-sparkles {
   --fa: '\e2ca'; /* fa-wand-magic-sparkles */
 }
 
+/* Reported by a partner build (2026-09-08): all seven are real Font Awesome
+ * PRO names (verified against packages/ui/fontawesome) that Free does not
+ * ship, so every one of them was rendering the bare circle-question fallback
+ * with no indication why. `fa-circle-question` itself was also reported, but
+ * it is NOT Free-missing — Free ships it natively at the same codepoint
+ * (`\f059`) the fallback rule above uses, so a probe that treats "content
+ * resolved to \f059" as "broken" cannot tell a genuine circle-question icon
+ * apart from the fallback. That is a probe-methodology caveat, not a shim
+ * this file can fix. */
+i.fa-cloud-snow {
+  --fa: '\f2dc'; /* fa-snowflake */
+}
+i.fa-cloud-hail {
+  --fa: '\f73b'; /* fa-cloud-meatball */
+}
+i.fa-cloud-hail-mixed {
+  --fa: '\f73b'; /* fa-cloud-meatball */
+}
+i.fa-fog {
+  --fa: '\f75f'; /* fa-smog */
+}
+i.fa-sun-cloud {
+  --fa: '\f6c4'; /* fa-cloud-sun */
+}
+i.fa-moon-cloud {
+  --fa: '\f6c3'; /* fa-cloud-moon */
+}
+i.fa-cloud-bolt-sun {
+  --fa: '\f76c'; /* fa-cloud-bolt */
+}
+
 @layer base {
   body {
     @apply bg-background text-foreground;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekanos/harness",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "description": "The Ekanos integration dev harness — every surface of an integration rendered in real Fusion chrome, from fixtures, with no Supabase, auth or network.",
   "license": "MIT",
@@ -47,14 +47,14 @@
   },
   "dependencies": {
     "@fortawesome/fontawesome-free": "^7.3.1",
-    "i18next": "25.10.10",
+    "i18next": "^25.10.10",
     "next-themes": "0.4.6",
     "react-i18next": "^16.6.6",
     "tw-animate-css": "1.4.0"
   },
   "peerDependencies": {
-    "@ekanos/sdk": "^0.1.2",
-    "@ekanos/ui": "^0.1.2",
+    "@ekanos/sdk": "^0.1.4",
+    "@ekanos/ui": "^0.1.4",
     "@tanstack/react-query": "^5.101.4",
     "next": "^16.0.0",
     "react": "^19.2.8",
@@ -62,8 +62,8 @@
     "tailwindcss": "^4.0.0"
   },
   "devDependencies": {
-    "@ekanos/sdk": "0.1.2",
-    "@ekanos/ui": "0.1.2",
+    "@ekanos/sdk": "0.1.4",
+    "@ekanos/ui": "0.1.4",
     "@kit/eslint-config": "0.2.0",
     "@kit/prettier-config": "0.1.0",
     "@kit/tsconfig": "0.1.0",