@plitzi/plitzi-builder 0.35.10 → 0.36.1

package/CHANGELOG.md

@@ -1,5 +1,84 @@
 # @plitzi/plitzi-builder
 
+## 0.36.1
+
+### Patch Changes
+
+- v0.36.1
+- Updated dependencies
+  - @plitzi/plitzi-sdk@0.36.1
+  - @plitzi/sdk-auth@0.36.1
+  - @plitzi/sdk-dev-tools@0.36.1
+  - @plitzi/sdk-elements@0.36.1
+  - @plitzi/sdk-event-bridge@0.36.1
+  - @plitzi/sdk-interactions@0.36.1
+  - @plitzi/sdk-navigation@0.36.1
+  - @plitzi/sdk-plugins@0.36.1
+  - @plitzi/sdk-schema@0.36.1
+  - @plitzi/sdk-shared@0.36.1
+  - @plitzi/sdk-style@0.36.1
+  - @plitzi/sdk-variables@0.36.1
+
+## 0.36.0
+
+### Minor Changes
+
+- - **An `apiContainer` can keep its browser requests in a query cache, the way react-query does.** Moving between
+    sections or pages used to ask the API again every time a provider was shown: a provider in a hidden section is
+    mounted but disabled, so showing it fired a fresh request, and a page navigation remounted it and did the same.
+    With the new `cache: true` an answer is kept for `staleTime` seconds (30 by default) and shared by every cached
+    provider asking the same thing — same method, URL, credentials and headers, the token included, so two visitors
+    never share one. Past its time the answer is still drawn at once and a fresh one is fetched behind it; an answer
+    nobody shows is forgotten after `gcTime` seconds (300 by default). A refused request (`4xx`/`5xx`) is shown but
+    never kept. **The cache is off unless an element asks for it**: an uncached provider behaves as before, asking on
+    every mount and sharing nothing.
+
+    The cache is `@plitzi/sdk-shared/queries` (`queryCache`, `useQuery`, `invalidateQueries`,
+    `invalidateQueriesForWrite`), a nexus store written with the per-path `ttl` of `@plitzi/nexus` 1.2.0, which every
+    consumer now requires. It reacts to the store's own freshness events, so anything that expires a query's path
+    makes the providers on screen ask again.
+
+    An answer stops counting as current before its time when the element's `performQuery` runs (it always asks
+    again), when a flow runs the new global `invalidateQueries` step (source `queries`: `elements`, api container ids
+    — a container's requests are tagged with its own id — and/or a `url` prefix), and after a write. Both write steps
+    gained `invalidateQueries` / `invalidateElements`: a `webHook` sent with anything but `GET`/`HEAD` refreshes the
+    requests to its own site by default, a completed `runServerAction` refreshes all of them by default, and either
+    can name containers instead or refresh nothing. A `writeRecord` refreshes all. Providers on screen ask again at
+    once; the rest when they are next shown. A sign-in, sign-out or change of account drops everything held. Server-driven
+    providers and RSC are untouched.
+
+  - **A `webHook` that reads can be cached** (`cache`, `staleTime`), in the same cache and under the same key as an api
+    container asking the same thing. Its declaration now lives beside it (`utility/webHookSpec`) and the authoring
+    catalog gathers it instead of keeping a copy. A `HEAD` is no longer sent with a body, which `fetch` refused.
+
+  - **Step params can pick several elements.** A new param type, `elementIds` (with an `elementType` filter), is drawn
+    in the flow editor as a picker: the matching elements of the space to add, and the picked ones as chips to remove —
+    an id no element answers to any more is kept and flagged. The value is a list of ids, so nobody types a
+    comma-separated list; `invalidateQueries.elements` and the write steps' `invalidateElements` use it, and the MCP
+    catalog says which element type each such param takes.
+
+  - The dev-tools' Store tab lists the paths a store holds with a TTL — how long ago each was written, what is left
+    of it, and a button to expire one or all of them. The query cache appears there as "Queries".
+
+  - `useApi` no longer takes `params`: nothing passed them, and a GET cannot carry a body anyway. A mock now answers
+    synchronously, without a loading frame, and a provider whose URL has not resolved asks for nothing.
+
+### Patch Changes
+
+- Updated dependencies
+  - @plitzi/plitzi-sdk@0.36.0
+  - @plitzi/sdk-auth@0.36.0
+  - @plitzi/sdk-dev-tools@0.36.0
+  - @plitzi/sdk-elements@0.36.0
+  - @plitzi/sdk-event-bridge@0.36.0
+  - @plitzi/sdk-interactions@0.36.0
+  - @plitzi/sdk-navigation@0.36.0
+  - @plitzi/sdk-plugins@0.36.0
+  - @plitzi/sdk-schema@0.36.0
+  - @plitzi/sdk-shared@0.36.0
+  - @plitzi/sdk-style@0.36.0
+  - @plitzi/sdk-variables@0.36.0
+
 ## 0.35.10
 
 ### Patch Changes

package/dist/index.html

@@ -56,10 +56,10 @@
       render(
         'plitzi',
         {
-          webKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxIiwib3JpZ2lucyI6WyJodHRwczovL3dlYnNpdGUucGxpdHppLmFwcCIsImh0dHBzOi8vcGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsOjMwMDAiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWw6MzAwMSIsImh0dHBzOi8vc3NyLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vc2VydmVyLnBsaXR6aS5sb2NhbCIsImh0dHA6Ly9sb2NhbGhvc3Q6MzAwMCIsImh0dHA6Ly9sb2NhbGhvc3Q6ODA4MCIsImh0dHA6Ly8xMjcuMC4wLjE6ODA4MCJdLCJpc3MiOiJodHRwczovL3NlcnZlci5wbGl0emkubG9jYWwiLCJhdWQiOlsiaHR0cHM6Ly9wbGl0emkubG9jYWwiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWwiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWw6MzAwMCIsImh0dHBzOi8vYXBwLnBsaXR6aS5sb2NhbDozMDAxIiwiaHR0cHM6Ly9hcGkucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9zc3IucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9zZXJ2ZXIucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9tY3AucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hdXRoLnBsaXR6aS5sb2NhbCIsImh0dHA6Ly8xMjcuMC4wLjE6NTMwMCIsImh0dHA6Ly9sb2NhbGhvc3Q6NTE4MCJdLCJzY29wZSI6InNwYWNlOnJlbmRlciIsImlhdCI6MTc4OTQxODY5NSwianRpIjoiMjJlZTI4YjJlYmMwNjQyOSIsIm5iZiI6MTc4OTQxODY5NX0.vfOSHVMxccFKkTxBE5A0T4N6pijATjLE8cngR6srQLc',
+          webKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxIiwib3JpZ2lucyI6WyJodHRwczovL3dlYnNpdGUucGxpdHppLmFwcCIsImh0dHBzOi8vcGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsOjMwMDAiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWw6MzAwMSIsImh0dHBzOi8vc3NyLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vc2VydmVyLnBsaXR6aS5sb2NhbCIsImh0dHA6Ly9sb2NhbGhvc3Q6MzAwMCIsImh0dHA6Ly9sb2NhbGhvc3Q6ODA4MCIsImh0dHA6Ly8xMjcuMC4wLjE6ODA4MCJdLCJpc3MiOiJodHRwczovL3NlcnZlci5wbGl0emkubG9jYWwiLCJhdWQiOlsiaHR0cHM6Ly9wbGl0emkubG9jYWwiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWwiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWw6MzAwMCIsImh0dHBzOi8vYXBwLnBsaXR6aS5sb2NhbDozMDAxIiwiaHR0cHM6Ly9hcGkucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9zc3IucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9zZXJ2ZXIucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9tY3AucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hdXRoLnBsaXR6aS5sb2NhbCIsImh0dHA6Ly8xMjcuMC4wLjE6NTMwMCIsImh0dHA6Ly9sb2NhbGhvc3Q6NTE4MCJdLCJzY29wZSI6InNwYWNlOnJlbmRlciIsImlhdCI6MTc4OTYzNjkxNiwianRpIjoiY2E3NTRhMzYyNGRlMmMwMiIsIm5iZiI6MTc4OTYzNjkxNn0.KXNGtSvJhBPr31zM-bvEgq4X0imMKMwxfS3VoAzXMYo',
           // The actor. Without it the builder loads and every write is refused, since authorization is
           // can(actor, space, permission). Both halves come from `yarn token 1 --user admin` in plitzi-sdk-server.
-          userKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxIiwiaXNzIjoiaHR0cHM6Ly9zZXJ2ZXIucGxpdHppLmxvY2FsIiwiYXVkIjpbImh0dHBzOi8vcGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsOjMwMDAiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWw6MzAwMSIsImh0dHBzOi8vYXBpLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vc3NyLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vc2VydmVyLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vbWNwLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vYXV0aC5wbGl0emkubG9jYWwiLCJodHRwOi8vMTI3LjAuMC4xOjUzMDAiLCJodHRwOi8vbG9jYWxob3N0OjUxODAiXSwic2NvcGUiOiJ1c2VyIiwiZXhwIjoxNzg5NTA1MTI5LCJpYXQiOjE3ODk0MTg3MjksImp0aSI6IjhkODZiNGM0NGY1N2UxNGIiLCJuYmYiOjE3ODk0MTg3Mjl9.xT_Re3lVuVT68s4UnfOXvmf0fW5Hv8Ktu_4XdgMnuBA',
+          userKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxIiwiaXNzIjoiaHR0cHM6Ly9zZXJ2ZXIucGxpdHppLmxvY2FsIiwiYXVkIjpbImh0dHBzOi8vcGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsOjMwMDAiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWw6MzAwMSIsImh0dHBzOi8vYXBpLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vc3NyLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vc2VydmVyLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vbWNwLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vYXV0aC5wbGl0emkubG9jYWwiLCJodHRwOi8vMTI3LjAuMC4xOjUzMDAiLCJodHRwOi8vbG9jYWxob3N0OjUxODAiXSwic2NvcGUiOiJ1c2VyIiwiZXhwIjoxNzg5NzIzMDE5LCJpYXQiOjE3ODk2MzY2MTksImp0aSI6IjhlZjJmZmFmOGM0M2M3NmYiLCJuYmYiOjE3ODk2MzY2MTl9.sqmBSkAm3J2VSarPRvk2ChTHQ38lqOAOVKszW_MLPu0',
           environment: 'main',
           server: {
             basePath: '',

package/dist/modules/Interactions/components/Workflow/Workflow.d.ts

@@ -1,3 +1,4 @@
+import { WorkflowElement } from './WorkflowContext';
 import { ElementInteraction, InteractionCallback, Source } from '@plitzi/sdk-shared';
 export type WorkflowProps = {
     nodes?: Record<string, ElementInteraction>;
@@ -10,7 +11,9 @@ export type WorkflowProps = {
     /** What a new TRIGGER starts as. A server action defaults to `call`; an element's flows have no obvious one. */
     defaultTrigger?: string;
     dataSource?: Record<string, Source['meta']>;
+    /** The space's elements, for a step param that picks some of them. */
+    elements?: WorkflowElement[];
     onChange?: (nodes: Record<string, ElementInteraction>) => void;
 };
-declare const Workflow: ({ nodes: nodesProp, triggerTitle, callbackTitle, nodeDefinitions, direction, dataSource, stepType, defaultTrigger, onChange }: WorkflowProps) => import("react").JSX.Element;
+declare const Workflow: ({ nodes: nodesProp, triggerTitle, callbackTitle, nodeDefinitions, direction, dataSource, elements, stepType, defaultTrigger, onChange }: WorkflowProps) => import("react").JSX.Element;
 export default Workflow;

package/dist/modules/Interactions/components/Workflow/WorkflowContext.d.ts

@@ -1,10 +1,18 @@
 import { ElementInteraction, InteractionCallback, Source, SourceField } from '@plitzi/sdk-shared';
+/** An element of the space a step param can name, as the element picker lists it. */
+export type WorkflowElement = {
+    id: string;
+    type: string;
+    label: string;
+};
 export type WorkflowContextValue = {
     direction: 'horizontal' | 'vertical';
     nodeDefinitions?: InteractionCallback[];
     previewData: Record<string, ElementInteraction['preview']>;
     dataSource: Record<string, Source['meta']>;
     dataSourceContent: Record<string, SourceField[]>;
+    /** The space's elements, for a param that picks some of them. */
+    elements: WorkflowElement[];
     addNode: (nodeType: ElementInteraction['type'], siblingNodeId?: string, flowId?: string) => void;
     updateNode: (node: ElementInteraction) => void;
     removeNode: (nodeId: string) => void;

package/dist/modules/Interactions/components/Workflow/WorkflowContextProvider.d.ts

@@ -1,3 +1,4 @@
+import { WorkflowElement } from './WorkflowContext';
 import { ElementInteraction, InteractionCallback, Source } from '@plitzi/sdk-shared';
 import { ReactNode } from 'react';
 export type WorkflowContextProviderProps = {
@@ -5,11 +6,12 @@ export type WorkflowContextProviderProps = {
     nodes: Record<string, ElementInteraction>;
     direction: 'horizontal' | 'vertical';
     dataSource?: Record<string, Source['meta']>;
+    elements?: WorkflowElement[];
     nodeDefinitions?: InteractionCallback[];
     /** Default action for a new trigger, when the flow kind has an obvious one. */
     defaultTrigger?: string;
     onChange: (nodes: Record<string, ElementInteraction>, debounced?: boolean) => void;
     setFlowId: (flowId: string) => void;
 };
-declare const WorkflowContextProvider: ({ children, nodes, direction, dataSource, nodeDefinitions, defaultTrigger, setFlowId, onChange }: WorkflowContextProviderProps) => import("react").JSX.Element;
+declare const WorkflowContextProvider: ({ children, nodes, direction, dataSource, elements, nodeDefinitions, defaultTrigger, setFlowId, onChange }: WorkflowContextProviderProps) => import("react").JSX.Element;
 export default WorkflowContextProvider;

package/dist/modules/Interactions/components/Workflow/WorkflowNode/NodeBodyParam.d.ts

@@ -5,8 +5,10 @@ export type NodeBodyParamProps = {
     nodeId?: string;
     id: keyof ElementInteraction;
     label?: string;
-    value?: string | boolean | number;
+    value?: string | boolean | number | string[];
     type?: InteractionParamType | ((params: Record<string, unknown>) => InteractionParamType);
+    /** For an `elements` param: the element type offered. */
+    elementType?: string;
     options?: Option[] | ((params: Record<string, unknown>) => Option[]);
     canBind?: boolean;
     params?: Record<string, unknown>;
@@ -16,7 +18,7 @@ export type NodeBodyParamProps = {
         placeholder: string;
         group: string;
     }>;
-    onChange?: (id: keyof ElementInteraction, value: string | boolean | number) => void;
+    onChange?: (id: keyof ElementInteraction, value: string | boolean | number | string[]) => void;
 };
-declare const NodeBodyParam: ({ className, nodeId, id, label, value, type: typeProp, options: optionsProp, canBind, params, fields, onChange }: NodeBodyParamProps) => import("react").JSX.Element;
+declare const NodeBodyParam: ({ className, nodeId, id, label, value, type: typeProp, options: optionsProp, elementType, canBind, params, fields, onChange }: NodeBodyParamProps) => import("react").JSX.Element;
 export default NodeBodyParam;

package/dist/modules/Interactions/components/Workflow/WorkflowNode/ParamElementChip.d.ts

@@ -0,0 +1,7 @@
+import { PickedElement } from '../helpers/elementOptions';
+export type ParamElementChipProps = {
+    element: PickedElement;
+    onRemove: (id: string) => void;
+};
+declare const ParamElementChip: ({ element, onRemove }: ParamElementChipProps) => import("react").JSX.Element;
+export default ParamElementChip;

package/dist/modules/Interactions/components/Workflow/WorkflowNode/ParamElements.d.ts

@@ -0,0 +1,12 @@
+import { ElementInteraction } from '@plitzi/sdk-shared';
+export type ParamElementsProps = {
+    id: keyof ElementInteraction;
+    label: string;
+    value?: unknown;
+    /** Only elements of this type are offered; every element without one. */
+    elementType?: string;
+    onChange?: (id: keyof ElementInteraction, value: string[]) => void;
+};
+/** Several elements of the space, picked one at a time and stored as their ids. */
+declare const ParamElements: ({ id, label, value, elementType, onChange }: ParamElementsProps) => import("react").JSX.Element;
+export default ParamElements;

package/dist/modules/Interactions/components/Workflow/helpers/elementOptions.d.ts

@@ -0,0 +1,18 @@
+import { WorkflowElement } from '../WorkflowContext';
+import { Element } from '@plitzi/sdk-shared';
+/** The space's elements as the picker lists them, sorted by id — which is also the name an author gave them. */
+export declare const toWorkflowElements: (flat: Record<string, Element> | undefined) => WorkflowElement[];
+export type PickedElement = {
+    id: string;
+    label: string;
+    missing: boolean;
+};
+/** What is picked, in the order it was picked; an id no element answers to any more is kept and flagged. */
+export declare const pickedElements: (ids: readonly string[], elements: readonly WorkflowElement[]) => PickedElement[];
+/** What can still be picked: elements of the type the param asks for, minus the ones already picked. */
+export declare const pickableOptions: (elements: readonly WorkflowElement[], elementType: string | undefined, picked: readonly string[]) => {
+    value: string;
+    label: string;
+}[];
+/** A stored value read as a list of ids — anything else is nothing picked yet. */
+export declare const toIdList: (value: unknown) => string[];

package/dist/modules/Interactions/components/Workflow/helpers/elementOptions.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/package.json.d.ts

@@ -1,6 +1,6 @@
 declare const _default: {
   "name": "@plitzi/plitzi-builder",
-  "version": "0.35.10",
+  "version": "0.36.1",
   "homepage": "./",
   "license": "AGPL-3.0",
   "files": [
@@ -28,7 +28,7 @@ declare const _default: {
   "dependencies": {
     "@apollo/client": "^4.3.0",
     "@fortawesome/fontawesome-free": "^7.3.1",
-    "@plitzi/nexus": "^1.1.4",
+    "@plitzi/nexus": "^1.2.0",
     "@plitzi/plitzi-sdk": "workspace:*",
     "@plitzi/plitzi-ui": "^1.6.21",
     "@plitzi/sdk-auth": "workspace:*",