@revenexx/studio-integrations 3.0.3 → 3.2.0

package/dist/runtime/utils/credentialTest.d.ts

@@ -0,0 +1,17 @@
+import type { CredentialTestResult } from '../composables/useIntegrationsCredentials.js';
+/** What a connection test came to, as the three surfaces that run one draw it. */
+export interface TestOutcomeView {
+    kind: 'ok' | 'failed' | 'untested';
+    /** The tone of the box: green, red, or neutral for a test that did not happen. */
+    toneClass: string;
+    text: string;
+}
+/**
+ * One reading of a test result for every surface (specs/credential-test.md).
+ *
+ * Three answers, not two: a test the platform could not run — its test broker had no
+ * room, or the reader may not try an edit — said nothing about the credential, and
+ * drawing it red told the operator the connection was broken (IN-22). The words are
+ * the platform's where it sent any, the studio's fixed sentence otherwise.
+ */
+export declare function testOutcomeView(result: CredentialTestResult, t: (key: string, params?: Record<string, unknown>) => string): TestOutcomeView;

package/dist/runtime/utils/credentialTest.js

@@ -0,0 +1,14 @@
+export function testOutcomeView(result, t) {
+  if (result.ok) {
+    return { kind: "ok", toneClass: "bg-emerald-500/10 text-emerald-700", text: result.message ?? t("integration.credentials.shared.test.ok") };
+  }
+  if (result.untested) {
+    const reason = result.error ?? result.message;
+    return {
+      kind: "untested",
+      toneClass: "bg-slate-500/10 text-slate-700",
+      text: reason ? t("integration.credentials.shared.test.notTestedBecause", { reason }) : t("integration.credentials.shared.test.notTested")
+    };
+  }
+  return { kind: "failed", toneClass: "bg-rose-500/10 text-rose-700", text: result.error ?? result.message ?? t("integration.credentials.shared.test.failed") };
+}

package/dist/runtime/utils/runEnvelope.d.ts

@@ -1,28 +1,5 @@
 /** A run as the API sends it, before anything has been read out of it. */
 export type RunLike = Record<string, unknown>;
-/**
- * The run out of a single-run response, enveloped or not.
- *
- * `GET /workflows/{id}/runs/{runId}` answers the run itself, and the studio's own
- * mock and some callers wrap it in `{ data: … }`. So the envelope has to be
- * optional — but unwrapping on the mere presence of a `data` key is wrong: a run
- * that ever carried one would be unwrapped into it, and the caller would be
- * handed a field instead of a run. Hence the two guards: a body that already
- * looks like a run (`status`, `temporal_run_id`) is the run, whatever else it has
- * on it.
- *
- * The two guards are `RUN_OWN_FIELDS`, exported because `unwrapRecord` reads the
- * same endpoint from `useIntegrationsRuns.ts` and has to apply the same rule —
- * one list, two readers, rather than the two literals that used to sit here
- * (PO-394). What stays different is deliberate: this one answers `null` where
- * `unwrapRecord` throws, because a caller following a run has to count an
- * unusable answer as a failed read rather than have it raised at it.
- *
- * This is deliberately generous about the *rest* of the shape. It answers "where
- * is the run in this body", not "is this a usable run" — the caller decides that,
- * because a caller following a run has to be able to count an unusable answer as
- * a failed read rather than sit on it.
- */
 /**
  * The raw platform statuses a run does not come back from.
  *
@@ -37,7 +14,28 @@ export declare function isTerminalRun(run: {
 } | null | undefined): boolean;
 /**
  * The fields that mark a body as the run itself rather than an envelope around
- * one. A run carrying its own `data` field would otherwise be unwrapped into it.
+ * one. A run carrying its own `data` field would otherwise be taken for an envelope.
  */
 export declare const RUN_OWN_FIELDS: readonly ["status", "temporal_run_id"];
+/**
+ * The run out of a single-run response — the body itself.
+ *
+ * `GET /workflows/{id}/runs/{runId}` answers the run bare, and no version of it
+ * sent an envelope. Until IN-22 this accepted `{ data: run }` as well, because the
+ * studio's own mocks wrapped it; that tolerance is what let them stay wrong, so a
+ * body shaped like an envelope is now no run at all. "Shaped like an envelope"
+ * needs care: a run may carry a `data` field of its own, so a body that already
+ * looks like a run (`status`, `temporal_run_id`) is the run, whatever else it has
+ * on it.
+ *
+ * Those two guards are `RUN_OWN_FIELDS`, exported because `bareRecord` reads the
+ * same endpoint from `useIntegrationsRuns.ts` and has to apply the same rule —
+ * one list, two readers, rather than the two literals that used to sit here
+ * (PO-394). What stays different is deliberate: this one answers `null` where
+ * `bareRecord` throws, because a caller following a run has to count an
+ * unusable answer as a failed read rather than have it raised at it.
+ *
+ * This is deliberately generous about the *rest* of the shape. It answers "is
+ * there a run in this body", not "is this a usable run" — the caller decides that.
+ */
 export declare function unwrapRun(res: unknown): RunLike | null;

package/dist/runtime/utils/runEnvelope.js

@@ -4,10 +4,8 @@ export function isTerminalRun(run) {
 }
 export const RUN_OWN_FIELDS = ["status", "temporal_run_id"];
 export function unwrapRun(res) {
-  if (!res || typeof res !== "object") return null;
+  if (!res || typeof res !== "object" || Array.isArray(res)) return null;
   const o = res;
-  if ("data" in o && o.data && typeof o.data === "object" && !RUN_OWN_FIELDS.some((f) => f in o)) {
-    return o.data;
-  }
+  if ("data" in o && !RUN_OWN_FIELDS.some((f) => f in o)) return null;
   return o;
 }

package/dist/runtime/utils/stepError.d.ts

@@ -0,0 +1,13 @@
+import type { RunStepError, RunStepFrame } from '../types/integrations.js';
+/**
+ * A failed step's error as an operator reads it (IN-12).
+ *
+ * The platform sends it as an object — the message, the failure's type, and where
+ * the node package's own code was when it failed (`frames`, PO-447). The studio used
+ * to read it as text, and a template prints an object as JSON. A row from before the
+ * object, or a mock that still answers a string, is read as the message itself, so
+ * no shape ever reaches the screen as a dump.
+ */
+export declare function stepError(error: unknown): RunStepError | null;
+/** One frame as a reader names it: `src/nodes/Foo.ts:12:5` and the function, where known. */
+export declare function frameLabel(frame: RunStepFrame): string;

package/dist/runtime/utils/stepError.js

@@ -0,0 +1,24 @@
+export function stepError(error) {
+  if (typeof error === "string") return error.trim() === "" ? null : { message: error };
+  if (error === null || typeof error !== "object") return null;
+  const raw = error;
+  const message = typeof raw.message === "string" && raw.message.trim() !== "" ? raw.message : null;
+  if (message === null) return null;
+  return {
+    message,
+    ...typeof raw.type === "string" && raw.type.trim() !== "" ? { type: raw.type } : {},
+    ...Array.isArray(raw.frames) ? { frames: raw.frames.filter(isFrame).map(withName) } : {}
+  };
+}
+export function frameLabel(frame) {
+  const at = `${frame.file}:${frame.line}:${frame.column}`;
+  return frame.name ? `${frame.name} (${at})` : at;
+}
+function isFrame(value) {
+  if (value === null || typeof value !== "object") return false;
+  const f = value;
+  return typeof f.file === "string" && typeof f.line === "number" && typeof f.column === "number";
+}
+function withName(frame) {
+  return typeof frame.name === "string" && frame.name.trim() !== "" ? frame : { file: frame.file, line: frame.line, column: frame.column };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revenexx/studio-integrations",
-  "version": "3.0.3",
+  "version": "3.2.0",
   "type": "module",
   "description": "Integration Studio (core: workflows, node editor, runs, schedules, credentials, secrets, audit) as a standalone, publishable Nuxt module.",
   "repository": {

package/dist/runtime/data/integrationWorkflowSamples.d.ts

@@ -1,18 +0,0 @@
-import type { Connection, ConnectionTemplate, Workflow } from '../types/integrations.js';
-/**
- * Seed data for the workflow list. Built strictly with the manifests the
- * backend currently has fixtures for (`rest-get`, `control-if`,
- * `control-switch`) and the trigger output port the reference workflow
- * blobs use (`default` — see
- * `playground/integrations/tests/Fixtures/WorkflowBlobs/*.json`).
- *
- * If you change a manifest's `slug` / `version`, change it here too.
- */
-export declare const SAMPLE_WORKFLOWS: Workflow[];
-export declare const SAMPLE_SECRETS: {
-    key: string;
-    created_at: string;
-    updated_at: string;
-}[];
-export declare const CONNECTION_TEMPLATES: ConnectionTemplate[];
-export declare const SAMPLE_CONNECTIONS: Connection[];

package/dist/runtime/data/integrationWorkflowSamples.js

@@ -1,318 +0,0 @@
-export const SAMPLE_WORKFLOWS = [
-  // -----------------------------------------------------------------------
-  // 1) Manual REST call — mirrors manual-rest-call.json
-  // -----------------------------------------------------------------------
-  {
-    id: 1,
-    name: "Manual REST GET",
-    description: "User-triggered call to a REST endpoint configured via workflow variables.",
-    blob_definition_version: "v0-draft",
-    active: true,
-    revision: 4,
-    created_at: "2026-04-12T08:00:00Z",
-    updated_at: "2026-05-08T02:14:11Z",
-    blob: {
-      nodeManifestVersion: "v0-draft",
-      name: { en: "Manual REST GET", de: "Manueller REST-Abruf" },
-      description: {
-        en: "User-triggered call to a REST endpoint configured via workflow variables.",
-        de: "Benutzerausgel\xF6ster Aufruf eines REST-Endpunkts, konfiguriert \xFCber Workflow-Variablen."
-      },
-      variables: {
-        endpoint: {
-          type: "string",
-          default: "https://api.example.com/health",
-          description: { en: "Target URL", de: "Ziel-URL" }
-        },
-        timeoutSeconds: { type: "number", default: 30 }
-      },
-      triggers: [
-        {
-          id: "manual-1",
-          type: "manual",
-          name: { en: "Run now", de: "Jetzt ausf\xFChren" },
-          config: {}
-        }
-      ],
-      nodes: [
-        {
-          id: "fetch",
-          nodeSlug: "rest-get",
-          nodeVersion: "1.0.0",
-          config: {
-            url: "${{ vars.endpoint }}",
-            timeout: "${{ vars.timeoutSeconds }}"
-          },
-          position: { x: 220, y: 100 },
-          retry: { maxAttempts: 3, backoffSeconds: 2, strategy: "exponential" }
-        }
-      ],
-      edges: [
-        { id: "e1", from: { nodeId: "manual-1", output: "default" }, to: { nodeId: "fetch" } }
-      ]
-    }
-  },
-  // -----------------------------------------------------------------------
-  // 2) Webhook receiver with error routing — mirrors webhook-with-error-routing.json
-  // -----------------------------------------------------------------------
-  {
-    id: 2,
-    name: "Webhook order receiver",
-    description: "Receives Stripe order webhooks, validates the payload, and forwards to the fulfillment API. Errors flow into a notification node via the reserved error output.",
-    blob_definition_version: "v0-draft",
-    active: true,
-    revision: 3,
-    created_at: "2026-04-22T11:30:00Z",
-    updated_at: "2026-05-09T15:02:33Z",
-    blob: {
-      nodeManifestVersion: "v0-draft",
-      name: "Webhook order receiver",
-      description: "Receives Stripe order webhooks, validates the payload, and forwards to the fulfillment API. Errors flow into a notification node via the reserved error output.",
-      triggers: [
-        {
-          id: "stripe-hook",
-          type: "webhook",
-          name: "Stripe order created",
-          config: {
-            path: "/webhooks/stripe/orders",
-            method: "POST",
-            secretRef: "STRIPE_WEBHOOK_SECRET"
-          }
-        }
-      ],
-      nodes: [
-        {
-          id: "validate",
-          nodeSlug: "control-if",
-          nodeVersion: "1.0.0",
-          config: { condition: "${{ trigger.payload.type }}" },
-          position: { x: 260, y: 80 }
-        },
-        {
-          id: "forward",
-          nodeSlug: "rest-get",
-          nodeVersion: "1.0.0",
-          config: {
-            url: "https://fulfillment.internal/orders",
-            "bearer-token": "FULFILLMENT_API_TOKEN"
-          },
-          position: { x: 520, y: 0 },
-          retry: { maxAttempts: 4, backoffSeconds: 5, strategy: "linear" }
-        },
-        {
-          id: "notify-failure",
-          nodeSlug: "rest-get",
-          nodeVersion: "1.0.0",
-          config: { url: "https://alerts.internal/notify" },
-          position: { x: 760, y: 200 }
-        }
-      ],
-      edges: [
-        { id: "e1", from: { nodeId: "stripe-hook", output: "default" }, to: { nodeId: "validate" } },
-        { id: "e2", from: { nodeId: "validate", output: "true" }, to: { nodeId: "forward" } },
-        { id: "e3", from: { nodeId: "forward", output: "error" }, to: { nodeId: "notify-failure" } }
-      ]
-    }
-  },
-  // -----------------------------------------------------------------------
-  // 3) Scheduled ETL with branching — mirrors scheduled-with-branching.json
-  // -----------------------------------------------------------------------
-  {
-    id: 3,
-    name: "Daily ETL with branching",
-    description: "Pulls orders from upstream, branches per status with control-switch.",
-    blob_definition_version: "v0-draft",
-    active: true,
-    revision: 7,
-    created_at: "2026-04-12T08:00:00Z",
-    updated_at: "2026-05-08T02:14:11Z",
-    blob: {
-      nodeManifestVersion: "v0-draft",
-      name: "Daily ETL with branching",
-      triggers: [
-        {
-          id: "nightly",
-          type: "schedule",
-          config: { cron: "0 3 * * *", timezone: "Europe/Berlin" }
-        }
-      ],
-      variables: {
-        source: { type: "string", default: "primary" }
-      },
-      nodes: [
-        {
-          id: "fetch",
-          nodeSlug: "rest-get",
-          nodeVersion: "1.0.0",
-          config: { url: "https://api.example.com/orders?source=${{ vars.source }}" },
-          position: { x: 220, y: 80 },
-          retry: { maxAttempts: 5, backoffSeconds: 1, strategy: "exponential" }
-        },
-        {
-          id: "route",
-          nodeSlug: "control-switch",
-          nodeVersion: "1.0.0",
-          config: {
-            expression: "${{ nodes.fetch.outputs.success }}",
-            cases: ["paid", "pending", "failed"]
-          },
-          position: { x: 480, y: 80 }
-        },
-        {
-          id: "ship",
-          nodeSlug: "rest-get",
-          nodeVersion: "1.0.0",
-          config: { url: "https://api.example.com/ship" },
-          position: { x: 760, y: 0 }
-        },
-        {
-          id: "alert",
-          nodeSlug: "rest-get",
-          nodeVersion: "1.0.0",
-          config: { url: "https://api.example.com/alert" },
-          position: { x: 760, y: 200 }
-        }
-      ],
-      edges: [
-        { id: "e1", from: { nodeId: "nightly", output: "default" }, to: { nodeId: "fetch" } },
-        { id: "e2", from: { nodeId: "fetch", output: "success" }, to: { nodeId: "route" } },
-        { id: "e3", from: { nodeId: "route", output: "paid" }, to: { nodeId: "ship" } },
-        { id: "e4", from: { nodeId: "fetch", output: "error" }, to: { nodeId: "alert" } }
-      ]
-    }
-  },
-  // -----------------------------------------------------------------------
-  // 4) Empty draft — exists to demonstrate the "Draft" status group
-  // -----------------------------------------------------------------------
-  {
-    id: 4,
-    name: "Empty draft",
-    description: "No nodes yet. Drag from the palette to start.",
-    blob_definition_version: "v0-draft",
-    active: false,
-    revision: 0,
-    created_at: "2026-05-10T16:00:00Z",
-    updated_at: "2026-05-10T16:00:00Z",
-    blob: {
-      nodeManifestVersion: "v0-draft",
-      name: "Empty draft",
-      triggers: [
-        { id: "trg-1", type: "manual", config: {} }
-      ],
-      nodes: [],
-      edges: []
-    }
-  }
-];
-export const SAMPLE_SECRETS = [
-  { key: "STRIPE_WEBHOOK_SECRET", created_at: "2026-04-01T08:00:00Z", updated_at: "2026-04-01T08:00:00Z" },
-  { key: "FULFILLMENT_API_TOKEN", created_at: "2026-04-15T11:30:00Z", updated_at: "2026-04-15T11:30:00Z" },
-  { key: "ERP_API_KEY", created_at: "2026-03-12T09:14:00Z", updated_at: "2026-05-01T14:00:00Z" },
-  { key: "SLACK_WEBHOOK_URL", created_at: "2026-02-04T16:00:00Z", updated_at: "2026-02-04T16:00:00Z" },
-  { key: "HUBSPOT_ACCESS_TOKEN", created_at: "2026-04-22T12:00:00Z", updated_at: "2026-04-22T12:00:00Z" }
-];
-export const CONNECTION_TEMPLATES = [
-  {
-    vendor: "shopify",
-    name: "Shopify",
-    category: "shop",
-    icon: "ShoppingBag",
-    description: "Ingest orders, customers and products from a Shopify store.",
-    requiredSecrets: [
-      { key: "SHOPIFY_ACCESS_TOKEN", label: "Admin API token", sensitive: true },
-      { key: "SHOPIFY_WEBHOOK_SECRET", label: "Webhook signing secret", sensitive: true }
-    ]
-  },
-  {
-    vendor: "sap-business-one",
-    name: "SAP Business One",
-    category: "erp",
-    icon: "Server",
-    description: "Sync products, prices and orders with SAP Business One.",
-    requiredSecrets: [
-      { key: "SAP_B1_USER", label: "Service account", sensitive: false },
-      { key: "SAP_B1_PASSWORD", label: "Service password", sensitive: true }
-    ]
-  },
-  {
-    vendor: "hubspot",
-    name: "HubSpot",
-    category: "crm",
-    icon: "Contact",
-    description: "Two-way sync for contacts and deals.",
-    requiredSecrets: [{ key: "HUBSPOT_ACCESS_TOKEN", label: "Private app token", sensitive: true }]
-  },
-  {
-    vendor: "akeneo",
-    name: "Akeneo PIM",
-    category: "pim",
-    icon: "Layers",
-    description: "Pull product data and enrichment from Akeneo.",
-    requiredSecrets: [
-      { key: "AKENEO_CLIENT_ID", label: "Client ID", sensitive: false },
-      { key: "AKENEO_CLIENT_SECRET", label: "Client secret", sensitive: true }
-    ]
-  },
-  {
-    vendor: "slack",
-    name: "Slack",
-    category: "other",
-    icon: "MessageSquare",
-    description: "Post notifications and alerts to Slack channels.",
-    requiredSecrets: [{ key: "SLACK_WEBHOOK_URL", label: "Incoming webhook URL", sensitive: true }]
-  },
-  {
-    vendor: "stripe",
-    name: "Stripe",
-    category: "other",
-    icon: "CreditCard",
-    description: "Receive payment events from Stripe.",
-    requiredSecrets: [{ key: "STRIPE_WEBHOOK_SECRET", label: "Webhook signing secret", sensitive: true }]
-  }
-];
-export const SAMPLE_CONNECTIONS = [
-  {
-    id: "conn-stripe-1",
-    vendor: "stripe",
-    name: "Stripe \xB7 live",
-    status: "connected",
-    lastVerifiedAt: "2026-05-10T07:14:11Z",
-    secretRefs: ["STRIPE_WEBHOOK_SECRET"],
-    config: {},
-    createdAt: "2026-04-15T11:30:00Z",
-    updatedAt: "2026-05-09T15:02:33Z"
-  },
-  {
-    id: "conn-sap-1",
-    vendor: "sap-business-one",
-    name: "SAP Business One \xB7 production",
-    status: "misconfigured",
-    lastVerifiedAt: "2026-05-04T10:00:00Z",
-    secretRefs: [],
-    config: { host: "sap.acme.test" },
-    createdAt: "2026-04-22T11:00:00Z",
-    updatedAt: "2026-05-04T10:00:00Z"
-  },
-  {
-    id: "conn-hubspot-1",
-    vendor: "hubspot",
-    name: "HubSpot \xB7 Sales",
-    status: "connected",
-    lastVerifiedAt: "2026-05-10T08:00:00Z",
-    secretRefs: ["HUBSPOT_ACCESS_TOKEN"],
-    config: { portalId: "23456789" },
-    createdAt: "2026-04-22T12:00:00Z",
-    updatedAt: "2026-04-22T12:00:00Z"
-  },
-  {
-    id: "conn-slack-1",
-    vendor: "slack",
-    name: "Slack \xB7 #ops",
-    status: "connected",
-    lastVerifiedAt: "2026-05-10T09:00:00Z",
-    secretRefs: ["SLACK_WEBHOOK_URL"],
-    config: { channel: "#ops" },
-    createdAt: "2026-02-04T16:00:00Z",
-    updatedAt: "2026-02-04T16:00:00Z"
-  }
-];