@flowrunner/cli 0.1.3 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/ai-docs/instructions/service-code-format/02-zod-types.md +20 -14
  2. package/ai-docs/instructions/service-code-format/08-polling-triggers.md +2 -2
  3. package/dist/cli.js +18 -8
  4. package/dist/cli.js.map +2 -2
  5. package/dist/index.js +14 -7
  6. package/dist/index.js.map +2 -2
  7. package/dist/types/shared/src/constants/error-codes.d.ts +1 -0
  8. package/dist/types/shared/src/constants/knowledge-base.d.ts +1 -0
  9. package/dist/types/shared/src/constants/notification-types.d.ts +95 -22
  10. package/dist/types/shared/src/constants/shared-extensions.d.ts +9 -0
  11. package/dist/types/shared/src/errors/k8s.d.ts +10 -0
  12. package/dist/types/shared/src/scheme/crm/dto.d.ts +2 -2
  13. package/dist/types/shared/src/scheme/flowrunner/custom-elements.d.ts +20 -29
  14. package/dist/types/shared/src/scheme/integration-connection/dto.d.ts +2 -2
  15. package/dist/types/shared/src/scheme/knowledge-base/dto.d.ts +80 -0
  16. package/dist/types/shared/src/scheme/notifications/dto.d.ts +3 -0
  17. package/dist/types/shared/src/scheme/notifications/rest.d.ts +6 -0
  18. package/dist/types/shared/src/scheme/shared-extensions/config.d.ts +20 -20
  19. package/dist/types/shared/src/scheme/shared-extensions/custom-extensions.d.ts +30 -36
  20. package/dist/types/shared/src/scheme/shared-extensions/extension.d.ts +40 -40
  21. package/dist/types/shared/src/scheme/shared-extensions/index.d.ts +1 -0
  22. package/dist/types/shared/src/scheme/shared-extensions/resolve.d.ts +15 -24
  23. package/dist/types/shared/src/scheme/shared-extensions/search.d.ts +10 -10
  24. package/dist/types/shared/src/scheme/shared-extensions/workspace-stack.d.ts +44 -0
  25. package/dist/types/shared/src/scheme/workspace/dto.d.ts +1 -1
  26. package/package.json +4 -1
  27. package/runtime/index.js +14 -7
  28. package/runtime/index.js.map +2 -2
  29. package/runtime/types/shared/src/constants/error-codes.d.ts +1 -0
  30. package/runtime/types/shared/src/constants/knowledge-base.d.ts +1 -0
  31. package/runtime/types/shared/src/constants/notification-types.d.ts +95 -22
  32. package/runtime/types/shared/src/constants/shared-extensions.d.ts +9 -0
  33. package/runtime/types/shared/src/errors/k8s.d.ts +10 -0
  34. package/runtime/types/shared/src/scheme/flowrunner/custom-elements.d.ts +20 -29
  35. package/runtime/types/shared/src/scheme/integration-connection/dto.d.ts +2 -2
  36. package/runtime/types/shared/src/scheme/knowledge-base/dto.d.ts +80 -0
  37. package/runtime/types/shared/src/scheme/notifications/dto.d.ts +3 -0
  38. package/runtime/types/shared/src/scheme/notifications/rest.d.ts +6 -0
  39. package/runtime/types/shared/src/scheme/shared-extensions/config.d.ts +20 -20
  40. package/runtime/types/shared/src/scheme/shared-extensions/custom-extensions.d.ts +30 -36
  41. package/runtime/types/shared/src/scheme/shared-extensions/extension.d.ts +40 -40
  42. package/runtime/types/shared/src/scheme/shared-extensions/index.d.ts +1 -0
  43. package/runtime/types/shared/src/scheme/shared-extensions/resolve.d.ts +15 -24
  44. package/runtime/types/shared/src/scheme/shared-extensions/search.d.ts +10 -10
  45. package/runtime/types/shared/src/scheme/shared-extensions/workspace-stack.d.ts +44 -0
@@ -21,8 +21,10 @@ and behaviors.
21
21
 
22
22
  Notes:
23
23
 
24
- - **The Widget column is the PARAM rendering.** A `configItems` field publishes a smaller, closed set of
25
- types — notably `z.number()` lands on `string` and gets a plain text box, not a stepper. See
24
+ - **The Widget column applies to config fields too** — the configuration form is drawn from the same
25
+ declaration, so `z.number()` gets a numeric input there as it does for a param. What is smaller for a
26
+ config field is the `type` it **publishes**: a closed set in which `z.number()` lands on `string`. That is
27
+ what a test asserts, not what the form renders. See
26
28
  [Config fields publish a smaller set of types](#config-fields-publish-a-smaller-set-of-types).
27
29
  - **Required is the default** — mark optional fields with `.optional()`.
28
30
  - `.shared()` marks a config field as a **shared** (global) config value rather than per-app — used for
@@ -174,25 +176,29 @@ See [16-gotchas.md](16-gotchas.md) for the rest of that trap.
174
176
 
175
177
  ## Config fields publish a smaller set of types
176
178
 
177
- A `configItems` field is drawn from its declaration much as a param is — `z.boolean()` is a toggle,
178
- `z.enum([...])` a dropdown, `z.text()` a textarea — but a config item is published through a **smaller,
179
- closed vocabulary** than a param, and anything outside it lands on `string`:
179
+ A `configItems` field is **drawn from its declaration**, exactly as a param is — `z.boolean()` is a
180
+ toggle, `z.enum([...])` a dropdown, `z.text()` a textarea, `z.number()` a numeric input. But alongside the
181
+ declaration the platform also publishes a flat, **smaller, closed vocabulary** of config `type` strings, and
182
+ anything outside it lands on `string`:
180
183
 
181
- | Declared in `configItems` | Published `type` | Control |
184
+ | Declared in `configItems` | Published `type` | Control in the configuration form |
182
185
  |---|---|---|
183
186
  | `z.string()` | `string` | single-line text |
184
187
  | `z.text()` | `text` | textarea |
185
188
  | `z.boolean()` | `bool` | checkbox |
186
189
  | `z.enum([...])` | `choice` | dropdown |
187
190
  | `z.date()` | `date` | date picker |
188
- | **`z.number()`** | **`string`** | **single-line text — there is no numeric config type, so no stepper** |
189
-
190
- `z.number()` is the one that surprises: as a *param* it publishes `NUMBER` and renders a numeric stepper, in
191
- `configItems` it publishes `type: "string"` and renders a plain text box. `getServiceConfigItems()` reports
192
- `"string"` for it, and a test asserting the published config items must expect that. **Your handler still
193
- receives a number** — the declared type is what the value is converted to before validation (see below), so
194
- the widget is the only thing that differs. Declare `z.number()` anyway when the value is a number: it is
195
- what gives you the conversion and the validation.
191
+ | **`z.number()`** | **`string`** | **numeric input — there is no numeric config `type`, but the form reads the declaration** |
192
+
193
+ `z.number()` is the one that surprises, and it surprises in one place only: **`getServiceConfigItems()`
194
+ reports `type: "string"` for it**, because that vocabulary has no number in it. A test asserting the
195
+ published config items must expect `"string"`.
196
+
197
+ That published string is **not** what the user sees. The configuration form renders from the declared
198
+ schema, so a `z.number()` config field is a real numeric input, and **your handler still receives a
199
+ number** — the declared type is what the value is converted to before validation (see below). Declare
200
+ `z.number()` when the value is a number: it is what gives you the control, the conversion and the
201
+ validation, and nothing needs converting by hand.
196
202
 
197
203
  The two other differences are structural:
198
204
 
@@ -21,7 +21,7 @@ Declare **exactly one** mechanism.
21
21
 
22
22
  | Mechanism | Config | Runtime behavior |
23
23
  |---|---|---|
24
- | `dedupe` (seen-set) | `item => id` (or field path); or `{ by, stateKey='seen', max=500 }` | Keeps a bounded id set under `stateKey`; emits items whose id is new. Covers new-by-id + stateless-newest (head-only `fetch`). |
24
+ | `dedupe` (seen-set) | `item => id` (or field path); or `{ by, stateKey='seen', max=500 }` | Keeps the last `max` ids it has seen under `stateKey`, oldest first, and forgets the oldest when full (an id still in the feed counts as just seen); emits items whose id is new. Covers new-by-id + stateless-newest (head-only `fetch`). |
25
25
  | `watermark` (marker) | `{ by, stateKey='watermark', sortedDesc? }` — `by` = field path or `(item,{params})=>value` | Stores newest marker, emits items past it, advances. `sortedDesc:true` stops at the first non-newer item — **only for a strictly newest-first feed**, see below. Covers new-by-date + new-or-updated. |
26
26
  | `poll` (escape hatch) | fn (above) | Full control; author owns `state` shape. Covers overlap-window+dedup, lag-held cursor, consuming/offset feeds. |
27
27
 
@@ -29,7 +29,7 @@ Declare **exactly one** mechanism.
29
29
 
30
30
  | Phase | `dedupe` | `watermark` | `poll` |
31
31
  |---|---|---|---|
32
- | start (no state) | `null → { seen:{…} }` \| `[]` (seed) | `null → { <marker> }` \| `[]` (seed) | `null → seeded` \| `[]` (seed yourself) |
32
+ | start (no state) | `null → { seen:[…] }` \| `[]` (seed) | `null → { <marker> }` \| `[]` (seed) | `null → seeded` \| `[]` (seed yourself) |
33
33
  | learningMode | `null → null` \| everything `fetch` returned | `null → null` \| everything `fetch` returned | **no handling** — whatever you return |
34
34
  | timer | `{seen} → {seen+new}` \| `[new]` | `{marker} → {advanced}` \| `[past marker]` | yours → yours \| your delta |
35
35
 
package/dist/cli.js CHANGED
@@ -4185,10 +4185,13 @@ var require_package = __commonJS({
4185
4185
  "package.json"(exports2, module2) {
4186
4186
  module2.exports = {
4187
4187
  name: "@flowrunner/cli",
4188
+ version: "0.1.5",
4188
4189
  publishConfig: {
4189
4190
  access: "public"
4190
4191
  },
4191
- version: "0.1.3",
4192
+ engines: {
4193
+ node: ">=20"
4194
+ },
4192
4195
  description: "Flowrunner CLI for deploying Custom Extensions",
4193
4196
  bin: {
4194
4197
  flowrunner: "./bin/flowrunner.js"
@@ -7762,17 +7765,24 @@ var DedupeMechanism = class extends FetchingMechanism {
7762
7765
  delta(items, state) {
7763
7766
  const currentIds = items.map(this.#by).map((id) => `${id}`);
7764
7767
  if (!state?.[this.#stateKey]) {
7765
- return { events: [], state: { [this.#stateKey]: this.#buildSeen(currentIds) } };
7768
+ return { events: [], state: { [this.#stateKey]: this.#buildSeen([], currentIds) } };
7766
7769
  }
7767
- const seen = state[this.#stateKey];
7768
- const events = items.filter((item) => !seen[`${this.#by(item)}`]);
7769
- return { events, state: { [this.#stateKey]: this.#buildSeen([...Object.keys(seen), ...currentIds]) } };
7770
+ const seen = toSeenList(state[this.#stateKey]);
7771
+ const seenSet = new Set(seen);
7772
+ const events = items.filter((_item, index) => !seenSet.has(currentIds[index]));
7773
+ return { events, state: { [this.#stateKey]: this.#buildSeen(seen, currentIds) } };
7770
7774
  }
7771
- // Bounded id → 1 map, keeping the most-recent `max` ids (dedup, last occurrence wins).
7772
- #buildSeen(ids) {
7773
- return [...new Set(ids)].slice(-this.#max).reduce((acc, id) => ({ ...acc, [id]: 1 }), {});
7775
+ // Bounded id list, oldest first, keeping the most-recent `max` ids. An id fetched again moves to the end,
7776
+ // so an item that is still in the feed is never the one evicted. It is a list, not an `{ id: 1 }` map: a
7777
+ // map orders integer-like keys numerically, which evicted the SMALLEST id instead of the oldest one.
7778
+ #buildSeen(seen, currentIds) {
7779
+ const fetched = new Set(currentIds);
7780
+ return [...seen.filter((id) => !fetched.has(id)), ...fetched].slice(-this.#max);
7774
7781
  }
7775
7782
  };
7783
+ var toSeenList = (value) => {
7784
+ return Array.isArray(value) ? value.map((id) => `${id}`) : Object.keys(value);
7785
+ };
7776
7786
  var isNewer = (value, marker) => value > marker;
7777
7787
  var WatermarkMechanism = class extends FetchingMechanism {
7778
7788
  constructor(fetch2, config) {