@w6w/embed 0.2.11 → 0.2.20

package/dist/lib/workflow-validity.d.ts

@@ -8,6 +8,22 @@
  * > and every step is valid. Graph well-formedness (orphaned/unreachable
  * > nodes, dangling edges) is explicitly OUT of scope for this project.
  *
+ * **Amended 2026-10-29: no trigger NODE is required.** A workflow without one is
+ * a manual workflow (`rfcs/workflow.md:114`): it already runs from the editor's
+ * Run button and from code, and the server publishes it, so gating Publish on a
+ * trigger node only blocked a workflow that works. The workflow is now valid iff
+ * it has at least one step and every step is valid.
+ *
+ * **Amended 2026-11-01: an app trigger node is never test-gated.** A node with
+ * `uses.trigger: true` runs when its app reports the event; its Test tab has
+ * nothing to run by hand ("Publish the workflow to start listening",
+ * `AppTriggerTestNote` in `@w6w/ui`), so it can never hold a saved passing
+ * test. Gating it on one made every app-triggered workflow unpublishable.
+ *
+ * **Amended 2026-11-02: tests never gate publishing.** Successful runs and saved
+ * test records can disagree, and users may publish without testing. Only the
+ * target and required configuration are checked; test history is advisory.
+ *
  * Pure and testable by design: `WorkflowsPage.tsx` is JSX, which Node 24's
  * type-stripping cannot parse, so nothing in it can be loaded by `node --test`
  * (same shape as `src/lib/workflow-save.ts` + its `.test.ts`). This module
@@ -18,11 +34,7 @@
  * the two functions the pinned predicate reuses
  * (`requiredParamsFilled`/`isTestRequired`) are **caller-injected** on
  * `ValidityContext` — `WorkflowsPage.tsx` (unaffected by the JSX constraint)
- * imports the real ones from `@w6w/ui` and passes them in. Same for "a
- * trigger exists": that reads a graph STEP whose `INTERNAL_NODES` entry has
- * `group === "trigger"` (`@w6w/ui/flow`), never the workflow's top-level
- * `trigger` field (`rfcs/workflow.md:114`, "Absent means manual-only" — always
- * present, so it can't gate anything) — so `hasTrigger` is caller-computed too.
+ * imports the real ones from `@w6w/ui` and passes them in.
  *
  * `ActionParamLike`/`WorkflowStepLike`/`WorkflowLike` below are this file's
  * own minimal local types (see `rfcs/workflow.md` §"Step" for the real shape,
@@ -42,8 +54,12 @@ export interface WorkflowStepLike {
     uses?: {
         app?: string;
         action?: string;
+        connection?: string | null;
+        connectionRef?: string;
         /** The "or a function id" arm (`rfcs/function.md:49,260`) — `Step.uses.function`. */
         function?: string;
+        /** An app trigger node (`uses.trigger: true`): never gated on a saved test. */
+        trigger?: boolean;
     };
     with?: Record<string, unknown>;
 }
@@ -64,30 +80,62 @@ export interface WorkflowLike {
  * each field is caller-built rather than derived in here.
  */
 export interface ValidityContext {
-    /** Does the graph contain a step whose (app, action) is a trigger node? */
-    hasTrigger: boolean;
     /** Declared params for a step's target, keyed `` `${app}::${action}` ``. */
     actionParamsByKey: Record<string, ActionParamLike[]>;
-    /** The fetched apps list, keyed by app id — only a key present here is test-gated. */
+    /** @deprecated Kept for caller compatibility; app test policy does not gate publishing. */
     appsById: Record<string, unknown>;
-    /** Whether the given step id has a saved test that last ran successfully. */
+    /** @deprecated Kept for caller compatibility; test results do not gate publishing. */
     testStatus: Record<string, boolean>;
     /** `@w6w/ui`'s `requiredParamsFilled`, injected (see module docstring). */
     requiredParamsFilled: (params: ActionParamLike[], values: Record<string, unknown>) => boolean;
-    /** `@w6w/ui`'s `isTestRequired`, injected (see module docstring). */
+    /** @deprecated Kept for caller compatibility; never consulted for publishing. */
     isTestRequired: (app: unknown) => boolean;
 }
+/** Which of the pinned predicate's checks a step fails, or `null` when it's valid. */
+type StepFailure = "target missing" | "required params";
 /** Is this one step valid, per the pinned predicate? */
 export declare function stepValid(step: WorkflowStepLike, ctx: ValidityContext): boolean;
 /**
- * Is the whole workflow valid? A trigger step must exist and every step must
- * be individually valid — nothing about graph well-formedness (this never
- * reads `workflow.edges`, even when present).
+ * Is the whole workflow valid? It must have at least one step and every step
+ * must be individually valid — a trigger node is not required, and nothing
+ * about graph well-formedness is checked (this never reads `workflow.edges`).
  */
 export declare function workflowValid(workflow: WorkflowLike, ctx: ValidityContext): boolean;
 /**
- * `null` when the workflow is valid; otherwise names the cause — `"no trigger
- * step"`, or the id of the first invalid step in declared order plus which
- * check it fails.
+ * `null` when the workflow is valid; otherwise names the cause — `"no steps"`,
+ * or the id of the first invalid step in declared order plus which check it
+ * fails.
  */
 export declare function invalidReason(workflow: WorkflowLike, ctx: ValidityContext): string | null;
+/** One reason the workflow cannot be published: the node it is about and how to fix it. */
+export interface PublishProblem {
+    /** The node's id, or `null` for a workflow-wide problem (`"no steps"`). */
+    stepId: string | null;
+    check: StepFailure | "no steps";
+    /** Names the node and says how to fix it — shown verbatim in the tooltip and the list. */
+    message: string;
+}
+/**
+ * Every publish problem, in declared node order — the full list `invalidReason`
+ * stops at the first of. Empty iff `workflowValid`.
+ */
+export declare function publishProblems(workflow: WorkflowLike, ctx: ValidityContext): PublishProblem[];
+/** What the header Publish button's `disabled` reads, each cause kept apart for its reason. */
+export interface PublishGate {
+    /** No project to publish into. */
+    projectMissing: boolean;
+    /** The draft has not loaded, is saving, or is switching context. */
+    loading: boolean;
+    /** The draft refuses to save (and so to publish): its reason, verbatim. */
+    saveBlockedReason: string | null;
+    /** The node catalog the validity gate needs has not arrived yet. */
+    catalogLoading: boolean;
+    problems: readonly PublishProblem[];
+    publishing: boolean;
+}
+/**
+ * Why Publish is disabled, or `null` when it is enabled. Every disabled state
+ * has a reason, so the button never greys out silently.
+ */
+export declare function publishDisabledReason(g: PublishGate): string | null;
+export {};

package/dist/lib/workflow-variables.d.ts

@@ -66,7 +66,7 @@ export declare function variablesForSave(rows: WorkflowVariableRow[]): WorkflowV
  */
 export declare function duplicateKeyIndexes(rows: WorkflowVariableRow[]): number[];
 /**
- * The `vars.*` names to offer row `index`'s expression rail: the keys of
+ * The `var.*` names to offer row `index`'s expression rail: the keys of
  * rows **strictly above** it, then `projectVars`, deduped, with blanks
  * dropped. Declaration order is resolution order (D-5), so a row can only
  * reference a variable declared earlier than itself — offering a row at or

package/dist/lib/workflow-version.d.ts

@@ -0,0 +1,2 @@
+/** Compare JSON definitions independent of object property order. Array order is meaningful. */
+export declare function sameWorkflowDefinition(a: unknown, b: unknown): boolean;

package/dist/lib.mjs

@@ -1,86 +1,101 @@
 "use client";
-import { d as l, a as d, f as c, i as p, b as u, r as m, c as f, e as S, g, s as b, t as v, h as w, v as F, j as R, w as h, k as x } from "./trigger-preview-DKxfjzUY.js";
-import { d as I, e as A, i as P, p as E, t as K } from "./document-sources-UCwe8x77.js";
-import { e as T, h as k, a as C, b as U, i as V, m as L, p as W, r as _, s as B, v as j, w as H } from "./rail-settings-XYGToh00.js";
-import { c as q, d as G, i as O, p as Y } from "./settings-rail--GdRMusb.js";
-import { A as z, b as J, f as M, i as Q, a as X, c as Z, s as aa, u as ea } from "./slug-BVdgiP_L.js";
-import { i as ra, s as ia } from "./spec-import-invalidation-D3retX4Q.js";
-import { b as oa } from "./workflow-blank-DFpGObrn.js";
-import { I as la, c as da, f as ca, i as pa, a as ua, m as ma, p as fa, s as Sa, t as ga, b as ba, d as va, u as wa, e as Fa, g as Ra } from "./coerce-input-DttlcSdO.js";
-function i(s) {
+import { d as l, f as d, a as c, i as p, p as u, b as m, r as f, c as g, s as S, t as b, e as w, w as v, g as R } from "./setup-incomplete-BHs3Lpfy.js";
+import { d as F, a as y, e as I, i as x, b as D, p as C, r as P, c as A, f as E, s as K, g as T, t as U, v as k, h as V } from "./document-sources-DNmBojx6.js";
+import { a as L, b as W, e as _, h as N, c as j, d as H, i as q, m as G, p as M, r as O, f as Y, g as $, s as z, j as J, k as Q, l as X, t as Z, v as aa, w as ea, n as sa } from "./import-bindings-EUtxZ9Ti.js";
+import { c as ra, d as ia, i as oa, p as na } from "./settings-rail--GdRMusb.js";
+import { A as da, b as ca, f as pa, i as ua, a as ma, c as fa, s as ga, u as Sa } from "./slug-BVdgiP_L.js";
+import { i as wa, s as va } from "./spec-import-invalidation-D3retX4Q.js";
+import { b as ha } from "./workflow-blank-DFpGObrn.js";
+import { I as ya, c as Ia, f as xa, i as Da, a as Ca, m as Pa, p as Aa, s as Ea, t as Ka, b as Ta, d as Ua, u as ka, e as Va, g as Ba } from "./coerce-input-DFJ4n_wc.js";
+function r(s) {
   const e = new URLSearchParams(s), a = e.get("edit");
   if (a === null || a === "") return null;
   e.delete("edit");
-  const r = e.toString();
-  return { id: a, search: r === "" ? "" : `?${r}` };
+  const t = e.toString();
+  return { id: a, search: t === "" ? "" : `?${t}` };
 }
-function t(s) {
+function i(s) {
   const a = new URLSearchParams(s).get("run");
   return a != null && a.startsWith("run_") ? a : null;
 }
 export {
-  z as ACCOUNT_SLUG_RE,
-  la as INPUT_TYPES,
-  oa as blankDefinition,
-  J as buildSnippet,
-  q as callableRecord,
-  da as coerceInput,
-  G as definitionWithPolicy,
+  da as ACCOUNT_SLUG_RE,
+  ya as INPUT_TYPES,
+  L as allowedModes,
+  ha as blankDefinition,
+  W as buildRows,
+  ca as buildSnippet,
+  ra as callableRecord,
+  Ia as coerceInput,
+  ia as definitionWithPolicy,
   l as disabledBannerState,
-  I as documentSampleValues,
-  d as duplicateKeyIndexes,
-  A as errorHandlerSelfDecision,
-  T as evaluateEdit,
-  ca as fieldsFromWorkflow,
-  M as filterKeyInput,
-  c as findBindingProblems,
-  k as hasDefinitionActions,
-  C as hasDelete,
-  U as hasVersionHistory,
-  pa as implToTarget,
-  ua as inputsForSave,
+  F as documentSampleValues,
+  y as duplicateKeyIndexes,
+  I as errorHandlerSelfDecision,
+  _ as evaluateEdit,
+  xa as fieldsFromWorkflow,
+  pa as filterKeyInput,
+  d as findBindingProblems,
+  c as findSetupIncomplete,
+  N as hasDefinitionActions,
+  j as hasDelete,
+  H as hasVersionHistory,
+  Da as implToTarget,
+  Ca as inputsForSave,
   p as invalidReason,
-  ra as invalidateImportedCallable,
-  P as isCodeRailAvailable,
-  Q as isEndpointKey,
-  u as isExprDefault,
-  V as isRowArchived,
-  O as isSettingsRailAvailable,
-  X as isUrnAddressable,
-  Z as isValidAccountSlug,
-  i as legacyEditRedirect,
-  ma as mergeSeed,
-  L as metadataFieldsForKind,
-  fa as paramsToFields,
-  W as parseImportPaste,
-  Y as policyFromDefinition,
-  E as projectDocumentSources,
-  m as readSettings,
-  f as readVariables,
-  S as readWorkflowStatus,
-  _ as restoreRailState,
-  g as runFormFields,
-  t as runParamFromSearch,
-  Sa as shouldSeed,
-  aa as slugify,
-  B as specCollectionForKind,
-  ia as specImportListKey,
-  b as stepValid,
-  ga as targetIsBound,
-  ba as targetRef,
-  va as targetToImpl,
-  K as toSnippetCallable,
-  v as triggerInputSeed,
+  wa as invalidateImportedCallable,
+  x as isCodeRailAvailable,
+  ua as isEndpointKey,
+  D as isExprDefault,
+  q as isRowArchived,
+  oa as isSettingsRailAvailable,
+  ma as isUrnAddressable,
+  fa as isValidAccountSlug,
+  r as legacyEditRedirect,
+  Pa as mergeSeed,
+  G as metadataFieldsForKind,
+  Aa as paramsToFields,
+  M as parseImportPaste,
+  na as policyFromDefinition,
+  C as projectDocumentSources,
+  u as publishDisabledReason,
+  m as publishProblems,
+  f as readSettings,
+  P as readStartingData,
+  A as readVariables,
+  g as readWorkflowStatus,
+  O as restoreRailState,
+  Y as rowReady,
+  $ as rowsReady,
+  E as runFormFields,
+  i as runParamFromSearch,
+  z as setBind,
+  J as setCreateName,
+  Q as setUnconfigured,
+  Ea as shouldSeed,
+  ga as slugify,
+  X as specCollectionForKind,
+  va as specImportListKey,
+  K as startingDataCollisions,
+  T as startingDataForSave,
+  S as stepValid,
+  Ka as targetIsBound,
+  Ta as targetRef,
+  Ua as targetToImpl,
+  Z as toSelections,
+  U as toSnippetCallable,
+  b as triggerInputSeed,
   w as triggerPreviews,
-  ea as unavailableReason,
-  wa as uncoveredForEndpoint,
-  Fa as uncoveredForFunction,
-  Ra as uncoveredRequiredKeys,
-  F as variablesForSave,
-  R as varsRailFor,
-  j as visibleRows,
-  H as workflowKeyEditAllowed,
-  h as workflowValid,
-  x as writeSetting
+  Sa as unavailableReason,
+  ka as uncoveredForEndpoint,
+  Va as uncoveredForFunction,
+  Ba as uncoveredRequiredKeys,
+  k as variablesForSave,
+  V as varsRailFor,
+  aa as visibleRows,
+  ea as withCreatedConnection,
+  sa as workflowKeyEditAllowed,
+  v as workflowValid,
+  R as writeSetting
 };
 //# sourceMappingURL=lib.mjs.map

package/dist/lists/DataStoreList.d.ts

@@ -0,0 +1,17 @@
+import { MouseEvent, ReactNode } from 'react';
+export interface DataStoreListSlots {
+    /** Replaces the section heading and its description (the New button stays). `null`: none. */
+    header?: ReactNode;
+    /** Replaces the empty-state copy. */
+    empty?: ReactNode;
+}
+export interface DataStoreListProps {
+    /** Omitted: the provider's project. `null` or `""`: none; nothing is read and writes refuse. */
+    project?: string | null;
+    /** The host decides what opening a row means; with `getHref` it may `preventDefault`. */
+    onOpen?: (id: string, event: MouseEvent<Element>) => void;
+    /** Given, a row's main area is a real `<a href>`; its click still calls `onOpen`. */
+    getHref?: (id: string) => string;
+    slots?: DataStoreListSlots;
+}
+export declare function DataStoreList({ project, onOpen, getHref, slots }: DataStoreListProps): import("react").JSX.Element;

package/dist/lists/DataStoreView.d.ts

@@ -0,0 +1,19 @@
+import { DataStoreErrorLocator } from '@w6w/ui';
+import { ReactNode } from 'react';
+export interface DataStoreViewProps {
+    /** The store's id (`ds_…`). */
+    id: string;
+    /** Omitted: the provider's project. `null` or `""`: none; nothing is read and writes refuse. */
+    project?: string | null;
+    slots?: {
+        /** Replaces the store's name / kind heading. `null`: none. */
+        header?: ReactNode;
+    };
+}
+/**
+ * A thrown SDK failure as the locator the views place: `ApiError{status,code,raw}` with the
+ * server's `{error:{code,message,field?,row?,column?}}` read from `raw`. The error's own `code`
+ * stands in when the body carried none, so a conflict is never missed for want of an envelope.
+ */
+export declare function dataStoreErrorOf(e: unknown): DataStoreErrorLocator;
+export declare function DataStoreView({ id, project, slots }: DataStoreViewProps): import("react").JSX.Element;

package/dist/lists/Logs.d.ts

@@ -0,0 +1,19 @@
+import { ReactElement, ReactNode } from 'react';
+import { RunHistoryProps } from './RunHistory.tsx';
+export interface LogsProps extends RunHistoryProps {
+    /** The heading above the view. Defaults to `"Logs"`; `null` renders none (the host titles its
+     *  own page). */
+    title?: ReactNode | null;
+}
+/**
+ * The project's Logs: the most recent executions of every workflow, function and endpoint in the
+ * provider's project, newest first, and the selected one's detail (input, output, error, a
+ * workflow run's steps) opened in place. `RunHistory` under a heading — Studio's History page
+ * mounts the same body — so every `RunHistory` prop applies, and with none of them it is
+ * project-wide with filters held here. Never navigates; `onOpenInEditor` is the host's way into a
+ * workflow run's editor.
+ */
+export declare function Logs({ title, ...rest }: LogsProps): ReactElement;
+/** {@link Logs} under the name a host routing table tends to use for a page. */
+export declare const LogsView: typeof Logs;
+export type LogsViewProps = LogsProps;

package/dist/lists.d.ts

@@ -12,6 +12,8 @@ export { ActivitySummary } from './lists/ActivitySummary.tsx';
 export type { ActivitySummaryProps, ActivityTileTarget } from './lists/ActivitySummary.tsx';
 export { RunHistory } from './lists/RunHistory.tsx';
 export type { RunHistoryProps } from './lists/RunHistory.tsx';
+export { Logs, LogsView } from './lists/Logs.tsx';
+export type { LogsProps, LogsViewProps } from './lists/Logs.tsx';
 export { ServiceDetail } from './lists/ServiceDetail.tsx';
 export type { ServiceDetailProps } from './lists/ServiceDetail.tsx';
 export { ConnectionList } from './lists/ConnectionList.tsx';
@@ -26,3 +28,7 @@ export { CredentialList } from './lists/CredentialList.tsx';
 export type { CredentialListProps } from './lists/CredentialList.tsx';
 export { CredentialDetail } from './lists/CredentialDetail.tsx';
 export type { CredentialDetailProps } from './lists/CredentialDetail.tsx';
+export { DataStoreList } from './lists/DataStoreList.tsx';
+export type { DataStoreListProps, DataStoreListSlots } from './lists/DataStoreList.tsx';
+export { DataStoreView } from './lists/DataStoreView.tsx';
+export type { DataStoreViewProps } from './lists/DataStoreView.tsx';