@revenexx/studio-integrations 3.0.3 → 3.1.0

package/dist/runtime/i18n/messages/en.json

@@ -3,8 +3,12 @@
   "integration.audit.action.create": "create",
   "integration.audit.action.delete": "delete",
   "integration.audit.action.loadMore": "Load more",
+  "integration.audit.action.restore": "restore",
+  "integration.audit.action.retire": "retire",
+  "integration.audit.action.runCancelled": "run cancelled",
   "integration.audit.action.runFailed": "run failed",
   "integration.audit.action.runFinished": "run finished",
+  "integration.audit.action.runResumed": "run resumed",
   "integration.audit.action.runStarted": "run started",
   "integration.audit.action.update": "update",
   "integration.audit.actor.system": "system",
@@ -14,13 +18,18 @@
   "integration.audit.detail.id": "ID",
   "integration.audit.detail.tenant": "Tenant",
   "integration.audit.head.title": "Audit Log · Integration Studio",
-  "integration.audit.header.description": "Who changed what, and when. Append-only, per-tenant — credentials, secrets, workflows, triggers and runs.",
+  "integration.audit.header.description": "Who changed what, and when. Append-only, per-tenant — credentials, secrets, workflows, triggers, runs, node versions and stored state.",
   "integration.audit.header.title": "Audit Log",
   "integration.audit.panel.close.aria": "Close entry details",
   "integration.audit.panel.dismiss.aria": "Dismiss entry details",
   "integration.audit.panel.title.aria": "Audit entry details",
+  "integration.audit.resource.run": "Run of workflow #{workflow}",
+  "integration.audit.resource.trigger": "{type} trigger of workflow #{workflow}",
   "integration.audit.resourceType.credential": "credential",
+  "integration.audit.resourceType.nodeVersion": "node version",
   "integration.audit.resourceType.secret": "secret",
+  "integration.audit.resourceType.stateEntry": "state entry",
+  "integration.audit.resourceType.stateNamespace": "state namespace",
   "integration.audit.resourceType.trigger": "trigger",
   "integration.audit.resourceType.workflow": "workflow",
   "integration.audit.resourceType.workflowRun": "workflow run",
@@ -285,6 +294,9 @@
   "integration.credentials.shared.field.select.placeholder": "Pick one",
   "integration.credentials.shared.oauthHint": "After saving, a window opens to connect with the provider.",
   "integration.credentials.shared.test.failed": "Connection failed.",
+  "integration.credentials.shared.test.notAllowed": "Only someone who may change this credential can test changes to it.",
+  "integration.credentials.shared.test.notTested": "Not tested — the platform could not run the test. Nothing is known about the connection.",
+  "integration.credentials.shared.test.notTestedBecause": "Not tested — {reason}",
   "integration.credentials.shared.test.ok": "Connection ok.",
   "integration.credentials.state.connected": "Connected",
   "integration.credentials.state.failed": "Failed",
@@ -1096,10 +1108,10 @@
   "integration.secrets.dialog.create.title": "Create a secret",
   "integration.secrets.dialog.delete.body": "will be permanently removed. Workflows that reference it will break the next time they run.",
   "integration.secrets.dialog.delete.title": "Delete secret?",
-  "integration.secrets.error.invalidKey": "Key must match ^[A-Z0-9_]+$",
+  "integration.secrets.error.invalidKey": "Key must match ^[A-Za-z0-9_-]+$ and be at most 191 characters",
   "integration.secrets.error.loadFailed": "Could not load secrets.",
   "integration.secrets.error.valueRequired": "Value is required.",
-  "integration.secrets.form.error.invalidKey": "Key must match ^[A-Z0-9_]+$ (uppercase letters, digits, underscores).",
+  "integration.secrets.form.error.invalidKey": "Key must match ^[A-Za-z0-9_-]+$ (letters, digits, underscores, hyphens).",
   "integration.secrets.form.error.saveFailed": "Could not save the secret.",
   "integration.secrets.form.key.label": "Key",
   "integration.secrets.form.key.patternLabel": "Pattern:",
@@ -1156,6 +1168,7 @@
   "integration.templates.detail.install.secretsDescriptionSuffix": "page.",
   "integration.templates.detail.install.secretsHeader": "Secrets",
   "integration.templates.detail.install.selectLater": "Select later",
+  "integration.templates.detail.install.settingLabel": "node {id} · {setting}",
   "integration.templates.detail.install.state.loading": "Checking what this template needs…",
   "integration.templates.detail.install.submit": "Install",
   "integration.templates.detail.install.submitting": "Setting up…",

package/dist/runtime/pages/integrations/audit.vue

@@ -7,20 +7,33 @@ import {
   Key as Secret,
   Programming as Workflow,
   Bolt as Trigger,
-  Play as Run
+  Play as Run,
+  Box as NodeVersion,
+  Database as StateNamespace,
+  Document as StateEntry
 } from "#solar-icons";
 import { Badge, Button } from "@revenexx/studio";
 import { copyToClipboard } from "../../utils/clipboard";
 import { isBareIdentifier, personLabel } from "../../utils/personLabel";
+import { triggerTypeLabel } from "../../data/integrationNodeCatalog";
 const t = useIntegrationsT();
 useHead({ title: () => t("integration.audit.head.title") });
 const { entries, loading, error, hasMore, load, loadMore } = useIntegrationsAudit();
-const resourceTypes = ["credential", "secret", "workflow", "trigger", "workflow_run"];
-const actions = ["create", "update", "delete", "run.started", "run.finished", "run.failed"];
+const resourceTypes = ["credential", "secret", "workflow", "trigger", "workflow_run", "node_version", "state_namespace", "state_entry"];
+const actions = ["create", "update", "delete", "run.started", "run.finished", "run.failed", "run.cancelled", "run.resumed", "retire", "restore"];
 onMounted(() => {
   void load();
 });
-const resourceIcon = { credential: Credential, secret: Secret, workflow: Workflow, trigger: Trigger, workflow_run: Run };
+const resourceIcon = {
+  credential: Credential,
+  secret: Secret,
+  workflow: Workflow,
+  trigger: Trigger,
+  workflow_run: Run,
+  node_version: NodeVersion,
+  state_namespace: StateNamespace,
+  state_entry: StateEntry
+};
 function actionTone(a) {
   if (a === "create" || a === "run.finished") return "bg-emerald-500/10 text-emerald-700 border-emerald-500/20";
   if (a === "update") return "bg-amber-500/10 text-amber-700 border-amber-500/20";
@@ -32,7 +45,10 @@ const resourceTypeKeys = {
   secret: "integration.audit.resourceType.secret",
   workflow: "integration.audit.resourceType.workflow",
   trigger: "integration.audit.resourceType.trigger",
-  workflow_run: "integration.audit.resourceType.workflowRun"
+  workflow_run: "integration.audit.resourceType.workflowRun",
+  node_version: "integration.audit.resourceType.nodeVersion",
+  state_namespace: "integration.audit.resourceType.stateNamespace",
+  state_entry: "integration.audit.resourceType.stateEntry"
 };
 const actionKeys = {
   create: "integration.audit.action.create",
@@ -40,7 +56,11 @@ const actionKeys = {
   delete: "integration.audit.action.delete",
   "run.started": "integration.audit.action.runStarted",
   "run.finished": "integration.audit.action.runFinished",
-  "run.failed": "integration.audit.action.runFailed"
+  "run.failed": "integration.audit.action.runFailed",
+  "run.cancelled": "integration.audit.action.runCancelled",
+  "run.resumed": "integration.audit.action.runResumed",
+  retire: "integration.audit.action.retire",
+  restore: "integration.audit.action.restore"
 };
 function prettyAction(a) {
   const key = actionKeys[a];
@@ -51,7 +71,18 @@ function prettyType(rt) {
   return key ? t(key) : rt.replace("_", " ");
 }
 function resourceName(e) {
-  return e.metadata?.name || e.resource_id || "\u2014";
+  const m = e.metadata ?? {};
+  const text = (v) => typeof v === "string" && v !== "" ? v : void 0;
+  const workflow = m.workflow_id != null ? String(m.workflow_id) : void 0;
+  const name = text(m.name);
+  if (name) return name;
+  if (e.resource_type === "trigger" && workflow && text(m.type)) {
+    return t("integration.audit.resource.trigger", { type: triggerTypeLabel(text(m.type)), workflow });
+  }
+  if (e.resource_type === "workflow_run" && workflow) return t("integration.audit.resource.run", { workflow });
+  if (e.resource_type === "state_namespace" && text(m.namespace)) return text(m.namespace);
+  if (e.resource_type === "state_entry" && text(m.key)) return [text(m.namespace), text(m.key)].filter(Boolean).join(" \xB7 ");
+  return e.resource_id || "\u2014";
 }
 function fmtDate(iso) {
   return iso ? new Date(iso).toLocaleString() : "\u2014";
@@ -68,18 +99,21 @@ function actorIsId(e) {
 function actorIsPerson(e) {
   return !!(e.actor_name || e.actor_email);
 }
+function withHeld(known, of) {
+  return [...known, ...[...new Set(entries.value.map(of))].filter((v) => v && !known.includes(v)).sort()];
+}
 const filterTabs = computed(() => [
   {
     key: "resource",
     label: t("integration.audit.table.column.resource"),
     getter: (e) => e.resource_type,
-    options: resourceTypes.map((rt) => ({ value: rt, label: prettyType(rt) }))
+    options: withHeld(resourceTypes, (e) => e.resource_type).map((rt) => ({ value: rt, label: prettyType(rt) }))
   },
   {
     key: "action",
     label: t("integration.audit.table.column.action"),
     getter: (e) => e.action,
-    options: actions.map((a) => ({ value: a, label: prettyAction(a) }))
+    options: withHeld(actions, (e) => e.action).map((a) => ({ value: a, label: prettyAction(a) }))
   }
 ]);
 const columns = computed(() => [

package/dist/runtime/pages/integrations/credentials.vue

@@ -37,6 +37,7 @@ import { hasRevenexxSource } from "../../utils/revenexxCredentialSource";
 import { resolveLocalized } from "../../utils/localize";
 import { fromModelValue, toItemValue, toModelValue } from "../../utils/selectOptions";
 import { keepOpenBeside } from "../../utils/dialog";
+import { testOutcomeView } from "../../utils/credentialTest";
 const t = useIntegrationsT();
 useHead({ title: () => t("integration.credentials.list.head.title") });
 const { credentials, loading, error, load, create, update, remove, testInline, test, oauthAuthorizeUrl } = useIntegrationsCredentials();
@@ -462,12 +463,12 @@ async function confirmDelete() {
           <div
             v-if="testResult"
             class="rounded-md px-3 py-2 text-sm"
-            :class="testResult.ok ? 'bg-emerald-500/10 text-emerald-700' : 'bg-rose-500/10 text-rose-700'"
+            :class="testOutcomeView(testResult, t).toneClass"
           >
             <!-- What the credential type said, whichever way the test went. The fixed
                  sentences are the fallback for a type that reports nothing, not the
                  first choice (specs/credential-test.md). -->
-            {{ testResult.ok ? testResult.message ?? t("integration.credentials.shared.test.ok") : testResult.error ?? testResult.message ?? t("integration.credentials.shared.test.failed") }}
+            {{ testOutcomeView(testResult, t).text }}
           </div>
 
         </div>

package/dist/runtime/pages/integrations/runs.vue

@@ -41,7 +41,9 @@ function onReorder(order) {
   void setQuery(order);
 }
 let searchTimer;
-function onSearch(text) {
+const SEARCH_MAX = 200;
+function onSearch(typed) {
+  const text = [...typed].slice(0, SEARCH_MAX).join("");
   clearTimeout(searchTimer);
   if (text === query.value.search) return;
   searchTimer = setTimeout(() => {

package/dist/runtime/pages/integrations/secrets.vue

@@ -26,6 +26,7 @@ import {
 } from "@revenexx/studio";
 import { errorReason } from "../../utils/apiError";
 import { keepOpenBeside } from "../../utils/dialog";
+import { SECRET_KEY_MAX } from "../../composables/useIntegrationsSecrets";
 const t = useIntegrationsT();
 useHead({ title: () => t("integration.secrets.head.title") });
 const { secrets, loading, error, isValidKey, upsert, remove, load } = useIntegrationsSecrets();
@@ -121,9 +122,10 @@ const columns = computed(() => [
                   placeholder="STRIPE_API_KEY"
                   class="font-mono bg-white"
                   autocomplete="off"
+                  :maxlength="SECRET_KEY_MAX"
                 />
                 <p class="text-sm text-muted-foreground">
-                  {{ t("integration.secrets.form.key.patternLabel") }} <code class="font-mono">^[A-Z0-9_]+$</code>
+                  {{ t("integration.secrets.form.key.patternLabel") }} <code class="font-mono">^[A-Za-z0-9_-]+$</code>
                 </p>
               </div>
               <div class="space-y-1.5">

package/dist/runtime/pages/integrations/templates/[slug].vue

@@ -86,7 +86,7 @@ const triggerChips = computed(() => (tpl.value?.blob.triggers ?? []).map((trig)
     const when = describeCron(String(trig.config.cron)) ?? String(trig.config.cron);
     label = `${t("integration.templates.detail.trigger.schedule")} \xB7 ${when}${trig.config.timezone ? ` (${trig.config.timezone})` : ""}`;
   }
-  if (trig.type === "webhook" && trig.config?.path) label = `${t("integration.templates.trigger.webhook")} \xB7 ${trig.config.path}`;
+  if (trig.type === "webhook" && trig.config?.method) label = `${t("integration.templates.trigger.webhook")} \xB7 ${String(trig.config.method).toUpperCase()}`;
   if (trig.type === "manual") label = t("integration.templates.trigger.manual");
   return { key: trig.id, icon: glyphForTrigger(trig.type), label };
 }));

package/dist/runtime/types/integrations.d.ts

@@ -472,7 +472,7 @@ export interface CredentialTypeField {
     label: LocalizedString;
     required?: boolean;
     options?: Array<{
-        label: string;
+        label: LocalizedString;
         value: string | number | boolean;
     }>;
     validation?: {
@@ -495,8 +495,10 @@ export interface CredentialType {
     slug: string;
     version: string;
     name: LocalizedString;
-    description?: LocalizedString;
-    icon?: string;
+    /** Always sent; null where the descriptor has none. */
+    description?: LocalizedString | null;
+    /** Always sent; null where the descriptor has none. */
+    icon?: string | null;
     /** Signed logo/brand image URLs from the API (prefer `category: 'logo'`). */
     images?: CredentialTypeImage[];
     auth_kind: AuthKind;
@@ -629,7 +631,8 @@ export interface WorkflowTemplate {
      * under `sync` is a name invented by the reader's side of the wire.
      */
     category: TemplateCategory | '';
-    industries: Array<'mechanical-engineering' | 'chemicals' | 'wholesale' | 'manufacturing' | 'retail' | 'any'>;
+    /** Free-form registry tags; `any` is the one the studio words itself. */
+    industries: string[];
     /** Vendor slugs this template wires together (used to compute prerequisites). */
     vendors: string[];
     /** Required secret keys; UI shows which are missing. */
@@ -725,10 +728,10 @@ export interface RunStepRow {
 export interface DeadLetterRow {
     id: number;
     workflow_id: number;
-    trigger_id: string | null;
+    trigger_id: number | null;
     source: string | null;
     trigger_handle: string | null;
-    reason: string | null;
+    reason: string;
     status: 'pending' | 'replayed' | 'discarded' | string;
     created_at: string | null;
     updated_at: string | null;

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

@@ -1,9 +1,10 @@
 /**
- * One record, from `{ data: record }` or from a bare record.
+ * One record, out of the `{ data: record }` a wrapping endpoint sends — the
+ * template endpoints and `GET /credential-types/{slug}` (see the table above).
  *
- * Throws when the response carries an envelope with nothing in it, or no body at
- * all — the case the old expression turned into an object with none of the
- * caller's fields, which every page downstream drew as empty.
+ * Throws when the body carries no `data`, a null one, or no body at all — the
+ * case the old expression turned into an object with none of the caller's
+ * fields, which every page downstream drew as empty.
  *
  * **The thrown message is deliberately empty.** `errorReason(err, fallback)` in
  * `apiError.ts` falls back to the caller's own translated sentence when the
@@ -11,7 +12,16 @@
  * not load this" copy rather than as an untranslated technical string in the UI.
  * The response that caused it rides along in `body`.
  */
-export declare function unwrapRecord<T>(res: unknown, ownFields?: readonly string[]): T;
+export declare function unwrapRecord<T>(res: unknown): T;
+/**
+ * One record that IS the body — every single-record endpoint outside templates.
+ *
+ * Throws, the way `unwrapRecord` does, for no body at all and for a body shaped
+ * like an envelope: a `data` key and none of `ownFields`. No version of these
+ * endpoints sent one. `ownFields` is for a record that may carry a `data` field of
+ * its own — a run (`RUN_OWN_FIELDS`) — so that one is not mistaken for a wrapper.
+ */
+export declare function bareRecord<T>(res: unknown, ownFields?: readonly string[]): T;
 /**
  * A list, from `{ data: [ … ] }` or from a bare array.
  *

package/dist/runtime/utils/apiEnvelope.js

@@ -1,14 +1,17 @@
 import { IntegrationsApiError } from "./apiError.js";
-export function unwrapRecord(res, ownFields = []) {
-  if (res === null || res === void 0) {
+export function unwrapRecord(res) {
+  const data = res?.data;
+  if (data === null || data === void 0 || typeof data !== "object" || Array.isArray(data)) {
     throw new IntegrationsApiError(200, res, "");
   }
-  if (typeof res === "object" && "data" in res && !ownFields.some((f) => f in res)) {
-    const data = res.data;
-    if (data === null || data === void 0) {
-      throw new IntegrationsApiError(200, res, "");
-    }
-    return data;
+  return data;
+}
+export function bareRecord(res, ownFields = []) {
+  if (res === null || res === void 0 || typeof res !== "object" || Array.isArray(res)) {
+    throw new IntegrationsApiError(200, res, "");
+  }
+  if ("data" in res && !ownFields.some((f) => f in res)) {
+    throw new IntegrationsApiError(200, res, "");
   }
   return res;
 }

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revenexx/studio-integrations",
-  "version": "3.0.3",
+  "version": "3.1.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[];