@revenexx/studio-integrations 0.6.0 → 1.0.0

package/dist/runtime/utils/schedule.js

@@ -1,4 +1,14 @@
-const DAY_NAMES = ["Sundays", "Mondays", "Tuesdays", "Wednesdays", "Thursdays", "Fridays", "Saturdays"];
+import { useIntegrationsT } from "../composables/useIntegrationsT.js";
+import { studioLocale } from "./localize.js";
+const WEEKDAY_KEYS = [
+  "integration.schedules.cron.weekday.sunday",
+  "integration.schedules.cron.weekday.monday",
+  "integration.schedules.cron.weekday.tuesday",
+  "integration.schedules.cron.weekday.wednesday",
+  "integration.schedules.cron.weekday.thursday",
+  "integration.schedules.cron.weekday.friday",
+  "integration.schedules.cron.weekday.saturday"
+];
 export const PLATFORM_TIMEZONE = "UTC";
 export function scheduleTimezone(timezone) {
   return typeof timezone === "string" && timezone.trim() !== "" ? timezone.trim() : PLATFORM_TIMEZONE;
@@ -126,54 +136,56 @@ export function toCron(r) {
 function at(hour, minute) {
   return `${String(hour).padStart(2, "0")}:${String(minute).padStart(2, "0")}`;
 }
-function plural(n, unit) {
-  return `${n} ${unit}${n === 1 ? "" : "s"}`;
-}
 function ordinal(n) {
+  if (studioLocale().split("-")[0] === "de") return `${n}.`;
   const suffix = n % 100 >= 11 && n % 100 <= 13 ? "th" : ["th", "st", "nd", "rd"][n % 10] ?? "th";
   return `${n}${suffix}`;
 }
 function sameDays(days, other) {
   return days.length === other.length && days.every((d) => other.includes(d));
 }
-function listWords(words) {
+function listWords(words, t) {
   if (words.length <= 1) return words[0] ?? "";
-  return `${words.slice(0, -1).join(", ")} and ${words[words.length - 1]}`;
+  return `${words.slice(0, -1).join(", ")} ${t("integration.common.list.and")} ${words[words.length - 1]}`;
+}
+function isEveryDay(days) {
+  if (!days) return true;
+  const set = new Set(days.map((d) => d === 7 ? 0 : d));
+  return set.size === 0 || set.size === 7;
 }
-function dayPhrase(days) {
-  if (!days) return "Daily";
-  const set = [...new Set(days.map((d) => d === 7 ? 0 : d))].sort((a, b) => a - b);
-  if (!set.length || set.length === 7) return "Daily";
-  if (sameDays(set, WEEKDAYS)) return "Weekdays";
-  if (sameDays(set, WEEKEND)) return "Weekends";
-  return listWords(set.map((d) => DAY_NAMES[d] ?? "").filter(Boolean));
+function dayPhrase(days, t) {
+  if (isEveryDay(days)) return t("integration.schedules.cron.day.daily");
+  const set = [...new Set((days ?? []).map((d) => d === 7 ? 0 : d))].sort((a, b) => a - b);
+  if (sameDays(set, WEEKDAYS)) return t("integration.schedules.cron.day.weekdays");
+  if (sameDays(set, WEEKEND)) return t("integration.schedules.cron.day.weekends");
+  return listWords(set.map((d) => t(WEEKDAY_KEYS[d])), t);
 }
 export function describeRecurrence(r) {
+  const t = useIntegrationsT();
   switch (r.kind) {
     case "minutes":
-      return r.interval <= 1 ? "Every minute" : `Every ${plural(r.interval, "minute")}`;
+      return r.interval <= 1 ? t("integration.schedules.cron.everyMinute") : t("integration.schedules.cron.everyNMinutes", { n: r.interval });
     case "hourly":
-      return r.minute === 0 ? "Hourly, on the hour" : `Hourly at :${String(r.minute).padStart(2, "0")}`;
+      return r.minute === 0 ? t("integration.schedules.cron.hourlyOnTheHour") : t("integration.schedules.cron.hourlyAt", { minute: String(r.minute).padStart(2, "0") });
     case "hours":
       if (r.interval <= 1) return describeRecurrence({ kind: "hourly", minute: r.minute });
-      return r.minute === 0 ? `Every ${plural(r.interval, "hour")}, on the hour` : `Every ${plural(r.interval, "hour")} at :${String(r.minute).padStart(2, "0")}`;
+      return r.minute === 0 ? t("integration.schedules.cron.everyNHoursOnTheHour", { n: r.interval }) : t("integration.schedules.cron.everyNHoursAt", { n: r.interval, minute: String(r.minute).padStart(2, "0") });
     case "daily":
-      return `Daily at ${at(r.hour, r.minute)}`;
+      return t("integration.schedules.cron.dailyAt", { time: at(r.hour, r.minute) });
     case "times": {
       const hours = [...new Set(r.hours)].sort((a, b) => a - b);
       if (hours.length < 2) return describeRecurrence({ kind: "weekly", days: r.days ?? [0, 1, 2, 3, 4, 5, 6], hour: hours[0] ?? 0, minute: r.minute });
-      const phrase = dayPhrase(r.days);
       if (saysAsSpan(hours)) {
-        const span = `hourly from ${at(hours[0], r.minute)} to ${at(hours[hours.length - 1], r.minute)}`;
-        return phrase === "Daily" ? `Hourly from ${at(hours[0], r.minute)} to ${at(hours[hours.length - 1], r.minute)}` : `${phrase}, ${span}`;
+        const from = at(hours[0], r.minute);
+        const to = at(hours[hours.length - 1], r.minute);
+        return isEveryDay(r.days) ? t("integration.schedules.cron.spanAllDay", { from, to }) : t("integration.schedules.cron.spanWithDays", { days: dayPhrase(r.days, t), from, to });
       }
-      return `${phrase} at ${listWords(hours.map((h) => at(h, r.minute)))}`;
-    }
-    case "weekly": {
-      return `${dayPhrase(r.days)} at ${at(r.hour, r.minute)}`;
+      return t("integration.schedules.cron.namedTimes", { days: dayPhrase(r.days, t), times: listWords(hours.map((h) => at(h, r.minute)), t) });
     }
+    case "weekly":
+      return t("integration.schedules.cron.weeklyAt", { days: dayPhrase(r.days, t), time: at(r.hour, r.minute) });
     case "monthly":
-      return `Monthly on the ${ordinal(r.day)}, at ${at(r.hour, r.minute)}`;
+      return t("integration.schedules.cron.monthlyAt", { ordinal: ordinal(r.day), time: at(r.hour, r.minute) });
   }
 }
 export function describeCron(cron) {

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

@@ -0,0 +1,22 @@
+/**
+ * The `/integrations/…` paths a host actually serves, out of the route records its
+ * router hands back.
+ *
+ * The dashboard's four shortcuts into Import & Export, the SFTP server, the event
+ * stream and inbound webhooks point at pages this module does not have — they are
+ * the host's (PO-223, [`docs/host-surfaces.md`](../../../docs/host-surfaces.md)) —
+ * so each card is offered as a way in only where the host has the path.
+ *
+ * It lives here rather than in the page for the same reason `scanRoutes` lives in
+ * `src/pageRoutes.ts`: the trailing-slash strip and the decision to compare exactly
+ * are what the doc names as the *misinforming* failure mode, and prose does not
+ * fail. `servedPaths.test.ts` pins the three cases that matter.
+ *
+ * **Exact strings, deliberately.** A parametrised page registers
+ * `/integrations/:surface`, and a route-prefixing i18n strategy registers
+ * `/en/integrations/io`; neither is one of the four literals, so a host built that
+ * way is told its own surfaces live elsewhere. That is the documented limit of the
+ * question — narrower than resolving through the matcher, which a host with a
+ * catch-all page answers "yes" to everywhere.
+ */
+export declare function servedPaths(routePaths: string[]): Set<string>;

package/dist/runtime/utils/servedPaths.js

@@ -0,0 +1,3 @@
+export function servedPaths(routePaths) {
+  return new Set(routePaths.map((path) => path.replace(/\/$/, "")));
+}

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

@@ -13,9 +13,33 @@ export declare function statusTone(status: string | null | undefined): StatusTon
 export declare function statusClass(status: string | null | undefined): string;
 /** Tone classes directly (when you already have a tone). */
 export declare function toneClass(tone: StatusTone): string;
+/** The run-status words the studio itself displays (as opposed to whatever
+ * vocabulary Temporal or the raw API used to get there) — the only ones
+ * `runStatusLabel` translates. Anything else passes through unlabelled: a
+ * status this catalogue doesn't know is a raw field, not the studio's chrome.
+ *
+ * An array rather than a set, and exported, because the runs list offers these
+ * five as the choices it can be narrowed to and has to offer them in a fixed
+ * order. It used to keep its own copy of the list, so a sixth word added here
+ * would have been labelled everywhere and silently missing from that menu. */
+export declare const RUN_STATUS_WORDS: readonly ["running", "succeeded", "failed", "cancelled", "queued"];
 /**
  * Raw API/Temporal run vocabulary → the cockpit's run-status labels, so a run
- * never reads "completed" in one surface and "succeeded" in another. Unknown
- * statuses pass through lowercased.
+ * never reads "completed" in one surface and "succeeded" in another. This IS
+ * the studio's own chrome (Temporal's "completed" becomes our "succeeded"), so
+ * unlike a raw `run.status` read elsewhere, it is translated. Unknown statuses
+ * still pass through lowercased, untranslated — this function only relabels
+ * the fixed run-status vocabulary, not arbitrary strings.
+ */
+/**
+ * The platform's run vocabulary reduced to the studio's own five words — Temporal's
+ * `completed` is our `succeeded`, `pending` is `queued`, and two ways of dying are
+ * both `failed`. A status this catalogue does not know comes back as itself.
+ *
+ * Exported because a run's status is used as an *identity* as well as a word: the runs
+ * list narrows by it, and what a filter stores has to be something that does not move
+ * when the reader's language does. Both sides read this, so a filter and a row can
+ * never disagree about which status they mean.
  */
+export declare function normalisedRunStatus(status: string | null | undefined): string;
 export declare function runStatusLabel(status: string | null | undefined): string;

package/dist/runtime/utils/statusStyle.js

@@ -76,7 +76,9 @@ export function statusClass(status) {
 export function toneClass(tone) {
   return TONE_CLASS[tone];
 }
-export function runStatusLabel(status) {
+export const RUN_STATUS_WORDS = ["running", "succeeded", "failed", "cancelled", "queued"];
+const RUN_STATUS_WORD_SET = new Set(RUN_STATUS_WORDS);
+export function normalisedRunStatus(status) {
   if (!status) return "";
   const s = String(status).toLowerCase().replace(/[\s-]+/g, "_");
   switch (s) {
@@ -91,3 +93,9 @@ export function runStatusLabel(status) {
       return s;
   }
 }
+export function runStatusLabel(status) {
+  const normalized = normalisedRunStatus(status);
+  if (!normalized) return "";
+  if (!RUN_STATUS_WORD_SET.has(normalized)) return normalized;
+  return useIntegrationsT()(`integration.runs.status.${normalized}`);
+}

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

@@ -2,7 +2,7 @@ import type { WorkflowNode } from '../types/integrations.js';
 /**
  * Reading the backend's validation findings — for the editor's validation
  * banner (behavior specs/workflow-validation.md, how docs/workflow-validation.md)
- * and for the node configuration dialog (specs/node-inspector.md AC-8).
+ * and for the node configuration dialog (specs/node-configuration.md AC-8).
  *
  * The backend reports one finding per incomplete setting, each keyed by its
  * blob path (`blob.nodes.4.config.companyId`). The two readers want different
@@ -74,7 +74,7 @@ export declare function findingFieldKey(path: string): string | null;
 export declare function groupFindingsByNode(findings: readonly ValidationFinding[], nodes: readonly WorkflowNode[], labelOf?: (node: WorkflowNode) => string): FindingNodeGroup[];
 /**
  * Node id → config key → the message to show AT that setting
- * (specs/node-inspector.md AC-8).
+ * (specs/node-configuration.md AC-8).
  *
  * First finding wins: the backend reports the most specific reason first, and
  * two sentences stacked under one input would be noise.

package/dist/runtime/utils/validationFindings.js

@@ -1,3 +1,4 @@
+import { useIntegrationsT } from "../composables/useIntegrationsT.js";
 import { findManifest } from "../data/integrationNodeCatalog.js";
 import { resolveLocalized } from "./localize.js";
 export function nodeDisplayLabel(node) {
@@ -47,7 +48,7 @@ export function findingsByNodeField(findings, nodes) {
   return out;
 }
 export function findingsSummary(findingCount, nodeCount) {
-  const settings = `${findingCount} setting${findingCount === 1 ? "" : "s"}`;
-  const inNodes = nodeCount ? ` in ${nodeCount} node${nodeCount === 1 ? "" : "s"}` : "";
-  return `${settings}${inNodes} still need${findingCount === 1 ? "s" : ""} fixing`;
+  const t = useIntegrationsT();
+  const nodesClause = nodeCount ? ` ${t("integration.workflows.validation.summary.nodesClause", nodeCount)}` : "";
+  return t("integration.workflows.validation.summary", findingCount, { nodesClause });
 }

package/dist/types.d.mts

@@ -1,9 +1,5 @@
-import type { NuxtModule } from '@nuxt/schema'
-
-import type { default as Module } from './module.mjs'
-
-export type ModuleOptions = typeof Module extends NuxtModule<infer O> ? Partial<O> : Record<string, any>
-
 export { default } from './module.mjs'
 
+export { type ModuleOptions } from './module.mjs'
+
 export * from '../dist/runtime/types/integrations.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revenexx/studio-integrations",
-  "version": "0.6.0",
+  "version": "1.0.0",
   "type": "module",
   "description": "Integration Studio (core: workflows, node editor, runs, schedules, credentials, secrets, audit) as a standalone, publishable Nuxt module.",
   "repository": {
@@ -26,7 +26,7 @@
   },
   "dependencies": {
     "@nuxt/kit": "^4.0.0",
-    "@revenexx/studio-shared": "^0.2.0",
+    "@revenexx/studio-shared": "^0.3.0",
     "@solar-icons/nuxt": "^1.2.0",
     "marked": "^18.0.5"
   },
@@ -55,6 +55,7 @@
     "@nuxt/module-builder": "^1.0.2",
     "@playwright/test": "^1.57.0",
     "@nuxt/kit": "^4.0.0",
+    "@revenexx/talkback-js": "^0.3.0",
     "@nuxt/schema": "^4.0.0",
     "nuxt": "^4.2.2",
     "vitest": "^3.2.0",