@flowrunner/cli 0.1.18 → 0.1.19-dev.2

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 (318) hide show
  1. package/ai-docs/instructions/service-code-format/01-service-structure.md +1 -1
  2. package/ai-docs/instructions/service-code-format/02-zod-types.md +115 -7
  3. package/ai-docs/instructions/service-code-format/05-dictionaries.md +1 -1
  4. package/ai-docs/instructions/service-code-format/11-output-model.md +5 -5
  5. package/ai-docs/instructions/service-code-format/13-runtime-contracts.md +2 -3
  6. package/ai-docs/instructions/service-code-format/16-gotchas.md +30 -6
  7. package/ai-docs/instructions/service-code-format/README.md +2 -2
  8. package/dist/cli.js +944 -958
  9. package/dist/cli.js.map +4 -4
  10. package/dist/index.js +977 -988
  11. package/dist/index.js.map +4 -4
  12. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/context/execution-context.d.ts +10 -2
  13. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/extension.d.ts +3 -3
  14. package/dist/types/flow-extension-runner/src/global.d.ts +6 -18
  15. package/dist/types/flow-extension-runner/src/index.d.ts +39 -13
  16. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/model/field-mapper.d.ts +1 -1
  17. package/dist/types/flow-extension-runner/src/{v2/model → model}/model-types.d.ts +11 -1
  18. package/dist/types/flow-extension-runner/src/{v2/model → model}/params-model.d.ts +1 -1
  19. package/dist/types/flow-extension-runner/src/{v2/params → params}/config-params.d.ts +1 -1
  20. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/params/index.d.ts +2 -0
  21. package/dist/types/flow-extension-runner/src/{v2/params → params}/json/types.d.ts +2 -0
  22. package/dist/types/flow-extension-runner/src/params/schema/date-format.d.ts +80 -0
  23. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/params/schema/defaults.d.ts +3 -2
  24. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/params/schema/field-plan.d.ts +9 -2
  25. package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/introspect.d.ts +8 -0
  26. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/params/schema/messages.d.ts +1 -1
  27. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/params/schema/normalize.d.ts +1 -1
  28. package/dist/types/flow-extension-runner/src/params/schema/notices.d.ts +15 -0
  29. package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/parse.d.ts +1 -1
  30. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/params/types.d.ts +1 -1
  31. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/params/zod.d.ts +21 -0
  32. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/registry.d.ts +2 -0
  33. package/dist/types/flow-extension-runner/src/{v2/types.d.ts → types.d.ts} +1 -1
  34. package/dist/types/packages/cli/src/operations/deploy/discover-services.d.ts +2 -4
  35. package/dist/types/shared/src/constants/activity-log.d.ts +248 -2
  36. package/dist/types/shared/src/constants/error-codes.d.ts +6 -0
  37. package/dist/types/shared/src/constants/index.d.ts +1 -0
  38. package/dist/types/shared/src/constants/notification-types.d.ts +309 -0
  39. package/dist/types/shared/src/constants/panic-mode.d.ts +17 -0
  40. package/dist/types/shared/src/constants/shared-extensions.d.ts +10 -0
  41. package/dist/types/shared/src/errors/index.d.ts +1 -0
  42. package/dist/types/shared/src/errors/secrets.d.ts +16 -0
  43. package/dist/types/shared/src/scheme/access-keys/dto.d.ts +35 -13
  44. package/dist/types/shared/src/scheme/api-keys/dto.d.ts +29 -4
  45. package/dist/types/shared/src/scheme/flowrunner/custom-elements.d.ts +0 -16
  46. package/dist/types/shared/src/scheme/flowrunner/index.d.ts +1 -0
  47. package/dist/types/shared/src/scheme/flowrunner/java.dto.d.ts +26 -0
  48. package/dist/types/shared/src/scheme/flowrunner/workspace-dashboard.dto.d.ts +207 -0
  49. package/dist/types/shared/src/scheme/integration-connection/dto.d.ts +22 -0
  50. package/dist/types/shared/src/scheme/notifications/dto.d.ts +10 -0
  51. package/dist/types/shared/src/scheme/notifications/rest.d.ts +20 -0
  52. package/dist/types/shared/src/scheme/remote-mcp-server/dto.d.ts +153 -29
  53. package/dist/types/shared/src/scheme/shared-extensions/base.d.ts +0 -4
  54. package/dist/types/shared/src/scheme/shared-extensions/custom-extensions.d.ts +0 -24
  55. package/dist/types/shared/src/scheme/shared-extensions/extension.d.ts +0 -18
  56. package/dist/types/shared/src/scheme/shared-extensions/flow-extensions.d.ts +0 -3
  57. package/dist/types/shared/src/scheme/shared-extensions/index.d.ts +1 -0
  58. package/dist/types/shared/src/scheme/shared-extensions/list.d.ts +0 -28
  59. package/dist/types/shared/src/scheme/shared-extensions/methods.d.ts +0 -1
  60. package/dist/types/shared/src/scheme/shared-extensions/resolve.d.ts +0 -12
  61. package/dist/types/shared/src/scheme/shared-extensions/search.d.ts +0 -8
  62. package/dist/types/shared/src/scheme/shared-extensions/usage-stats.d.ts +189 -0
  63. package/package.json +1 -4
  64. package/project-files/sandbox/files-mock.js +3 -5
  65. package/project-files/sandbox/service.js +10 -11
  66. package/runtime/index.js +794 -896
  67. package/runtime/index.js.map +4 -4
  68. package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/context/execution-context.d.ts +10 -2
  69. package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/extension.d.ts +3 -3
  70. package/runtime/types/flow-extension-runner/src/global.d.ts +6 -18
  71. package/runtime/types/flow-extension-runner/src/index.d.ts +39 -13
  72. package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/model/field-mapper.d.ts +1 -1
  73. package/runtime/types/flow-extension-runner/src/{v2/model → model}/model-types.d.ts +11 -1
  74. package/runtime/types/flow-extension-runner/src/{v2/model → model}/params-model.d.ts +1 -1
  75. package/runtime/types/flow-extension-runner/src/{v2/params → params}/config-params.d.ts +1 -1
  76. package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/params/index.d.ts +2 -0
  77. package/runtime/types/flow-extension-runner/src/{v2/params → params}/json/types.d.ts +2 -0
  78. package/runtime/types/flow-extension-runner/src/params/schema/date-format.d.ts +80 -0
  79. package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/params/schema/defaults.d.ts +3 -2
  80. package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/params/schema/field-plan.d.ts +9 -2
  81. package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/introspect.d.ts +8 -0
  82. package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/params/schema/messages.d.ts +1 -1
  83. package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/params/schema/normalize.d.ts +1 -1
  84. package/runtime/types/flow-extension-runner/src/params/schema/notices.d.ts +15 -0
  85. package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/parse.d.ts +1 -1
  86. package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/params/types.d.ts +1 -1
  87. package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/params/zod.d.ts +21 -0
  88. package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/registry.d.ts +2 -0
  89. package/runtime/types/flow-extension-runner/src/{v2/types.d.ts → types.d.ts} +1 -1
  90. package/runtime/types/packages/cli/src/runtime/index.d.ts +6 -5
  91. package/dist/types/flow-extension-runner/src/common/config.d.ts +0 -12
  92. package/dist/types/flow-extension-runner/src/common/context.d.ts +0 -6
  93. package/dist/types/flow-extension-runner/src/common/types.d.ts +0 -11
  94. package/dist/types/flow-extension-runner/src/v1/config.d.ts +0 -3
  95. package/dist/types/flow-extension-runner/src/v1/constants.d.ts +0 -4
  96. package/dist/types/flow-extension-runner/src/v1/index.d.ts +0 -11
  97. package/dist/types/flow-extension-runner/src/v1/namespace.d.ts +0 -9
  98. package/dist/types/flow-extension-runner/src/v1/service.d.ts +0 -29
  99. package/dist/types/flow-extension-runner/src/v1/types.d.ts +0 -13
  100. package/dist/types/flow-extension-runner/src/v2/index.d.ts +0 -39
  101. package/dist/types/jsdoc-parser/src/custom-type-defs/files.d.ts +0 -2
  102. package/dist/types/jsdoc-parser/src/index.d.ts +0 -2
  103. package/dist/types/jsdoc-parser/src/lib.d.ts +0 -42
  104. package/dist/types/jsdoc-parser/src/types.d.ts +0 -2
  105. package/runtime/types/flow-extension-runner/src/common/config.d.ts +0 -12
  106. package/runtime/types/flow-extension-runner/src/common/context.d.ts +0 -6
  107. package/runtime/types/flow-extension-runner/src/common/types.d.ts +0 -11
  108. package/runtime/types/flow-extension-runner/src/v1/config.d.ts +0 -3
  109. package/runtime/types/flow-extension-runner/src/v1/constants.d.ts +0 -4
  110. package/runtime/types/flow-extension-runner/src/v1/index.d.ts +0 -11
  111. package/runtime/types/flow-extension-runner/src/v1/namespace.d.ts +0 -9
  112. package/runtime/types/flow-extension-runner/src/v1/service.d.ts +0 -29
  113. package/runtime/types/flow-extension-runner/src/v1/types.d.ts +0 -13
  114. package/runtime/types/flow-extension-runner/src/v2/index.d.ts +0 -39
  115. package/runtime/types/jsdoc-parser/src/custom-type-defs/files.d.ts +0 -2
  116. package/runtime/types/jsdoc-parser/src/index.d.ts +0 -2
  117. package/runtime/types/jsdoc-parser/src/lib.d.ts +0 -42
  118. package/runtime/types/jsdoc-parser/src/types.d.ts +0 -2
  119. package/runtime/types/shared/src/constants/activity-log.d.ts +0 -1573
  120. package/runtime/types/shared/src/constants/ai-agent-tools.d.ts +0 -20
  121. package/runtime/types/shared/src/constants/ai.d.ts +0 -11
  122. package/runtime/types/shared/src/constants/api-keys.d.ts +0 -1
  123. package/runtime/types/shared/src/constants/app.d.ts +0 -57
  124. package/runtime/types/shared/src/constants/billing.d.ts +0 -16
  125. package/runtime/types/shared/src/constants/compliances.d.ts +0 -3
  126. package/runtime/types/shared/src/constants/data-types.d.ts +0 -26
  127. package/runtime/types/shared/src/constants/docs.d.ts +0 -6
  128. package/runtime/types/shared/src/constants/error-codes.d.ts +0 -20
  129. package/runtime/types/shared/src/constants/flow.d.ts +0 -12
  130. package/runtime/types/shared/src/constants/index.d.ts +0 -18
  131. package/runtime/types/shared/src/constants/knowledge-base.d.ts +0 -15
  132. package/runtime/types/shared/src/constants/notification-types.d.ts +0 -1234
  133. package/runtime/types/shared/src/constants/notifications.d.ts +0 -10
  134. package/runtime/types/shared/src/constants/oauth-connection-error.d.ts +0 -3
  135. package/runtime/types/shared/src/constants/patterns.d.ts +0 -28
  136. package/runtime/types/shared/src/constants/retry-policy.d.ts +0 -30
  137. package/runtime/types/shared/src/constants/severity.d.ts +0 -9
  138. package/runtime/types/shared/src/constants/shared-extensions-search.d.ts +0 -6
  139. package/runtime/types/shared/src/constants/shared-extensions.d.ts +0 -56
  140. package/runtime/types/shared/src/constants/zod.d.ts +0 -2
  141. package/runtime/types/shared/src/errors/api.d.ts +0 -15
  142. package/runtime/types/shared/src/errors/base.d.ts +0 -38
  143. package/runtime/types/shared/src/errors/common.d.ts +0 -39
  144. package/runtime/types/shared/src/errors/index.d.ts +0 -14
  145. package/runtime/types/shared/src/errors/k8s.d.ts +0 -14
  146. package/runtime/types/shared/src/errors/message.d.ts +0 -48
  147. package/runtime/types/shared/src/errors/oauth-connection.d.ts +0 -4
  148. package/runtime/types/shared/src/errors/open-search.d.ts +0 -4
  149. package/runtime/types/shared/src/errors/s3.d.ts +0 -11
  150. package/runtime/types/shared/src/extensions/zod.d.ts +0 -25
  151. package/runtime/types/shared/src/scheme/access-keys/dto.d.ts +0 -101
  152. package/runtime/types/shared/src/scheme/access-keys/index.d.ts +0 -2
  153. package/runtime/types/shared/src/scheme/account/dto.d.ts +0 -63
  154. package/runtime/types/shared/src/scheme/account/index.d.ts +0 -1
  155. package/runtime/types/shared/src/scheme/activity-log-base.d.ts +0 -35
  156. package/runtime/types/shared/src/scheme/ai-agent-tools/dto.d.ts +0 -69
  157. package/runtime/types/shared/src/scheme/ai-agent-tools/index.d.ts +0 -2
  158. package/runtime/types/shared/src/scheme/ai-agent-tools/parameters.d.ts +0 -7
  159. package/runtime/types/shared/src/scheme/ai-router/dto.d.ts +0 -23
  160. package/runtime/types/shared/src/scheme/ai-router/index.d.ts +0 -2
  161. package/runtime/types/shared/src/scheme/api-keys/dto.d.ts +0 -28
  162. package/runtime/types/shared/src/scheme/api-keys/index.d.ts +0 -2
  163. package/runtime/types/shared/src/scheme/app/index.d.ts +0 -1
  164. package/runtime/types/shared/src/scheme/app/java.dto.d.ts +0 -6
  165. package/runtime/types/shared/src/scheme/billing/index.d.ts +0 -1
  166. package/runtime/types/shared/src/scheme/billing/java.dto.d.ts +0 -181
  167. package/runtime/types/shared/src/scheme/crm/billing.d.ts +0 -149
  168. package/runtime/types/shared/src/scheme/crm/dto.d.ts +0 -218
  169. package/runtime/types/shared/src/scheme/crm/index.d.ts +0 -3
  170. package/runtime/types/shared/src/scheme/data-types/index.d.ts +0 -1
  171. package/runtime/types/shared/src/scheme/data-types/java.dto.d.ts +0 -22
  172. package/runtime/types/shared/src/scheme/dynamic-forms/dto.d.ts +0 -30
  173. package/runtime/types/shared/src/scheme/dynamic-forms/index.d.ts +0 -2
  174. package/runtime/types/shared/src/scheme/extensions/index.d.ts +0 -1
  175. package/runtime/types/shared/src/scheme/extensions/params-to-zod.d.ts +0 -14
  176. package/runtime/types/shared/src/scheme/flowrunner/custom-elements.d.ts +0 -383
  177. package/runtime/types/shared/src/scheme/flowrunner/index.d.ts +0 -3
  178. package/runtime/types/shared/src/scheme/flowrunner/java.dto.d.ts +0 -655
  179. package/runtime/types/shared/src/scheme/index.d.ts +0 -21
  180. package/runtime/types/shared/src/scheme/integration-connection/dto.d.ts +0 -135
  181. package/runtime/types/shared/src/scheme/integration-connection/index.d.ts +0 -2
  182. package/runtime/types/shared/src/scheme/knowledge-base/dto.d.ts +0 -776
  183. package/runtime/types/shared/src/scheme/knowledge-base/index.d.ts +0 -2
  184. package/runtime/types/shared/src/scheme/mcp-oauth/dto.d.ts +0 -9
  185. package/runtime/types/shared/src/scheme/mcp-oauth/index.d.ts +0 -2
  186. package/runtime/types/shared/src/scheme/notifications/dto.d.ts +0 -118
  187. package/runtime/types/shared/src/scheme/notifications/index.d.ts +0 -3
  188. package/runtime/types/shared/src/scheme/notifications/rest.d.ts +0 -162
  189. package/runtime/types/shared/src/scheme/onboarding/dto.d.ts +0 -29
  190. package/runtime/types/shared/src/scheme/onboarding/index.d.ts +0 -1
  191. package/runtime/types/shared/src/scheme/properties/account.d.ts +0 -3
  192. package/runtime/types/shared/src/scheme/properties/app.d.ts +0 -5
  193. package/runtime/types/shared/src/scheme/properties/billing.d.ts +0 -12
  194. package/runtime/types/shared/src/scheme/properties/common.d.ts +0 -2
  195. package/runtime/types/shared/src/scheme/properties/db.d.ts +0 -8
  196. package/runtime/types/shared/src/scheme/properties/flow-extensions.d.ts +0 -7
  197. package/runtime/types/shared/src/scheme/properties/index.d.ts +0 -7
  198. package/runtime/types/shared/src/scheme/remote-mcp-server/dto.d.ts +0 -278
  199. package/runtime/types/shared/src/scheme/remote-mcp-server/index.d.ts +0 -2
  200. package/runtime/types/shared/src/scheme/shared-extensions/base.d.ts +0 -62
  201. package/runtime/types/shared/src/scheme/shared-extensions/config.d.ts +0 -96
  202. package/runtime/types/shared/src/scheme/shared-extensions/custom-extensions.d.ts +0 -631
  203. package/runtime/types/shared/src/scheme/shared-extensions/extension.d.ts +0 -411
  204. package/runtime/types/shared/src/scheme/shared-extensions/flow-extensions.d.ts +0 -64
  205. package/runtime/types/shared/src/scheme/shared-extensions/index.d.ts +0 -17
  206. package/runtime/types/shared/src/scheme/shared-extensions/light.d.ts +0 -38
  207. package/runtime/types/shared/src/scheme/shared-extensions/list.d.ts +0 -250
  208. package/runtime/types/shared/src/scheme/shared-extensions/logs.d.ts +0 -21
  209. package/runtime/types/shared/src/scheme/shared-extensions/methods.d.ts +0 -112
  210. package/runtime/types/shared/src/scheme/shared-extensions/params-schema.d.ts +0 -48
  211. package/runtime/types/shared/src/scheme/shared-extensions/popular-pool.d.ts +0 -11
  212. package/runtime/types/shared/src/scheme/shared-extensions/resolve.d.ts +0 -373
  213. package/runtime/types/shared/src/scheme/shared-extensions/rest.d.ts +0 -9
  214. package/runtime/types/shared/src/scheme/shared-extensions/search.d.ts +0 -189
  215. package/runtime/types/shared/src/scheme/shared-extensions/service-identity.d.ts +0 -10
  216. package/runtime/types/shared/src/scheme/shared-extensions/service-info.d.ts +0 -16
  217. package/runtime/types/shared/src/scheme/shared-extensions/workspace-stack.d.ts +0 -44
  218. package/runtime/types/shared/src/scheme/workspace/dto.d.ts +0 -40
  219. package/runtime/types/shared/src/scheme/workspace/index.d.ts +0 -1
  220. package/runtime/types/shared/src/utils/object.d.ts +0 -8
  221. package/runtime/types/shared/src/utils/uuid.d.ts +0 -5
  222. package/runtime/types/shared/src/utils/versions.d.ts +0 -4
  223. package/dist/types/flow-extension-runner/src/{v2/actions → actions}/action-method.d.ts +0 -0
  224. package/dist/types/flow-extension-runner/src/{common/context-files.d.ts → context/files.d.ts} +0 -0
  225. package/dist/types/flow-extension-runner/src/{v2/context → context}/logger.d.ts +0 -0
  226. package/dist/types/flow-extension-runner/src/{v2/context → context}/method-input.d.ts +0 -0
  227. package/dist/types/flow-extension-runner/src/{v2/context → context}/proxies.d.ts +0 -0
  228. package/dist/types/flow-extension-runner/src/{v2/create-extension.d.ts → create-extension.d.ts} +0 -0
  229. package/dist/types/flow-extension-runner/src/{v2/crypto.d.ts → crypto.d.ts} +0 -0
  230. package/dist/types/flow-extension-runner/src/{v2/dictionaries → dictionaries}/dictionary-method.d.ts +0 -0
  231. package/dist/types/flow-extension-runner/src/{v2/dictionaries → dictionaries}/payload-schema.d.ts +0 -0
  232. package/dist/types/flow-extension-runner/src/{v2/loaders → loaders}/loader-method.d.ts +0 -0
  233. package/dist/types/flow-extension-runner/src/{v2/loaders → loaders}/loader-owner.d.ts +0 -0
  234. package/dist/types/flow-extension-runner/src/{v2/loaders → loaders}/payload-schema.d.ts +0 -0
  235. package/dist/types/flow-extension-runner/src/{v2/method.d.ts → method.d.ts} +0 -0
  236. package/dist/types/flow-extension-runner/src/{v2/model → model}/method-model.d.ts +0 -0
  237. package/dist/types/flow-extension-runner/src/{v2/oauth → oauth}/method-names.d.ts +0 -0
  238. package/dist/types/flow-extension-runner/src/{v2/oauth → oauth}/oauth2.d.ts +0 -0
  239. package/dist/types/flow-extension-runner/src/{v2/oauth → oauth}/system-params.d.ts +0 -0
  240. package/dist/types/flow-extension-runner/src/{v2/oauth → oauth}/types.d.ts +0 -0
  241. package/dist/types/flow-extension-runner/src/{common/constants.d.ts → params/config-types.d.ts} +0 -0
  242. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/params/files-options.d.ts +4 -4
  243. /package/dist/types/flow-extension-runner/src/{v2/params → params}/json/checks.d.ts +0 -0
  244. /package/dist/types/flow-extension-runner/src/{v2/params → params}/json/decode.d.ts +0 -0
  245. /package/dist/types/flow-extension-runner/src/{v2/params → params}/json/encode.d.ts +0 -0
  246. /package/dist/types/flow-extension-runner/src/{v2/params → params}/json/values.d.ts +0 -0
  247. /package/dist/types/flow-extension-runner/src/{v2/params → params}/method-params.d.ts +0 -0
  248. /package/dist/types/flow-extension-runner/src/{v2/params → params}/params.d.ts +0 -0
  249. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/assert-object-schema.d.ts +0 -0
  250. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/assert-supported-schema.d.ts +0 -0
  251. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/coerce.d.ts +0 -0
  252. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/dates.d.ts +0 -0
  253. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/dictionary-binding.d.ts +0 -0
  254. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/labels.d.ts +0 -0
  255. /package/dist/types/flow-extension-runner/src/{v2/params → params}/widget-types.d.ts +0 -0
  256. /package/dist/types/flow-extension-runner/src/{v2/path.d.ts → path.d.ts} +0 -0
  257. /package/dist/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/mechanisms.d.ts +0 -0
  258. /package/dist/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/method-names.d.ts +0 -0
  259. /package/dist/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/polling-triggers.d.ts +0 -0
  260. /package/dist/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/system-params.d.ts +0 -0
  261. /package/dist/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/trigger-method.d.ts +0 -0
  262. /package/dist/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/types.d.ts +0 -0
  263. /package/dist/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/method-names.d.ts +0 -0
  264. /package/dist/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/realtime-setup.d.ts +0 -0
  265. /package/dist/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/system-params.d.ts +0 -0
  266. /package/dist/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/trigger-method.d.ts +0 -0
  267. /package/dist/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/types.d.ts +0 -0
  268. /package/dist/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/verify.d.ts +0 -0
  269. /package/dist/types/flow-extension-runner/src/{v2/result.d.ts → result.d.ts} +0 -0
  270. /package/dist/types/flow-extension-runner/src/{v2/system-method.d.ts → system-method.d.ts} +0 -0
  271. /package/runtime/types/flow-extension-runner/src/{v2/actions → actions}/action-method.d.ts +0 -0
  272. /package/runtime/types/flow-extension-runner/src/{common/context-files.d.ts → context/files.d.ts} +0 -0
  273. /package/runtime/types/flow-extension-runner/src/{v2/context → context}/logger.d.ts +0 -0
  274. /package/runtime/types/flow-extension-runner/src/{v2/context → context}/method-input.d.ts +0 -0
  275. /package/runtime/types/flow-extension-runner/src/{v2/context → context}/proxies.d.ts +0 -0
  276. /package/runtime/types/flow-extension-runner/src/{v2/create-extension.d.ts → create-extension.d.ts} +0 -0
  277. /package/runtime/types/flow-extension-runner/src/{v2/crypto.d.ts → crypto.d.ts} +0 -0
  278. /package/runtime/types/flow-extension-runner/src/{v2/dictionaries → dictionaries}/dictionary-method.d.ts +0 -0
  279. /package/runtime/types/flow-extension-runner/src/{v2/dictionaries → dictionaries}/payload-schema.d.ts +0 -0
  280. /package/runtime/types/flow-extension-runner/src/{v2/loaders → loaders}/loader-method.d.ts +0 -0
  281. /package/runtime/types/flow-extension-runner/src/{v2/loaders → loaders}/loader-owner.d.ts +0 -0
  282. /package/runtime/types/flow-extension-runner/src/{v2/loaders → loaders}/payload-schema.d.ts +0 -0
  283. /package/runtime/types/flow-extension-runner/src/{v2/method.d.ts → method.d.ts} +0 -0
  284. /package/runtime/types/flow-extension-runner/src/{v2/model → model}/method-model.d.ts +0 -0
  285. /package/runtime/types/flow-extension-runner/src/{v2/oauth → oauth}/method-names.d.ts +0 -0
  286. /package/runtime/types/flow-extension-runner/src/{v2/oauth → oauth}/oauth2.d.ts +0 -0
  287. /package/runtime/types/flow-extension-runner/src/{v2/oauth → oauth}/system-params.d.ts +0 -0
  288. /package/runtime/types/flow-extension-runner/src/{v2/oauth → oauth}/types.d.ts +0 -0
  289. /package/runtime/types/flow-extension-runner/src/{common/constants.d.ts → params/config-types.d.ts} +0 -0
  290. /package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/params/files-options.d.ts +0 -0
  291. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/json/checks.d.ts +0 -0
  292. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/json/decode.d.ts +0 -0
  293. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/json/encode.d.ts +0 -0
  294. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/json/values.d.ts +0 -0
  295. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/method-params.d.ts +0 -0
  296. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/params.d.ts +0 -0
  297. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/assert-object-schema.d.ts +0 -0
  298. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/assert-supported-schema.d.ts +0 -0
  299. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/coerce.d.ts +0 -0
  300. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/dates.d.ts +0 -0
  301. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/dictionary-binding.d.ts +0 -0
  302. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/labels.d.ts +0 -0
  303. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/widget-types.d.ts +0 -0
  304. /package/runtime/types/flow-extension-runner/src/{v2/path.d.ts → path.d.ts} +0 -0
  305. /package/runtime/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/mechanisms.d.ts +0 -0
  306. /package/runtime/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/method-names.d.ts +0 -0
  307. /package/runtime/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/polling-triggers.d.ts +0 -0
  308. /package/runtime/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/system-params.d.ts +0 -0
  309. /package/runtime/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/trigger-method.d.ts +0 -0
  310. /package/runtime/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/types.d.ts +0 -0
  311. /package/runtime/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/method-names.d.ts +0 -0
  312. /package/runtime/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/realtime-setup.d.ts +0 -0
  313. /package/runtime/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/system-params.d.ts +0 -0
  314. /package/runtime/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/trigger-method.d.ts +0 -0
  315. /package/runtime/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/types.d.ts +0 -0
  316. /package/runtime/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/verify.d.ts +0 -0
  317. /package/runtime/types/flow-extension-runner/src/{v2/result.d.ts → result.d.ts} +0 -0
  318. /package/runtime/types/flow-extension-runner/src/{v2/system-method.d.ts → system-method.d.ts} +0 -0
@@ -1,18 +1,26 @@
1
- import type { ServiceConfigsValues } from '../../common/constants';
2
- import { type FilesApi, type FileScopes } from '../../common/context-files';
3
1
  import type { Extension } from '../extension';
4
2
  import type { OAuthBag } from '../oauth/types';
3
+ import type { ServiceConfigsValues } from '../params/config-types';
5
4
  import type { HandlerBag, Logger } from '../types';
5
+ import { type FilesApi, type FileScopes } from './files';
6
6
  export interface ExecutionContextOptions {
7
7
  configs?: ServiceConfigsValues;
8
8
  accessToken?: string;
9
9
  logger?: Logger;
10
10
  files?: unknown;
11
+ invocation?: {
12
+ flowId?: string;
13
+ executionId?: string;
14
+ };
11
15
  }
12
16
  export declare class ExecutionContext {
13
17
  #private;
14
18
  constructor(extension: Extension, options?: ExecutionContextOptions);
15
19
  get logger(): Logger;
20
+ get invocation(): {
21
+ flowId?: string;
22
+ executionId?: string;
23
+ };
16
24
  get config(): Record<string, unknown>;
17
25
  get oauth(): OAuthBag;
18
26
  get filesScope(): FileScopes;
@@ -1,6 +1,6 @@
1
- import type { ConfigItem } from '../common/types';
2
1
  import { ExecutionContext, type ExecutionContextOptions } from './context/execution-context';
3
2
  import type { ExtensionMethod } from './method';
3
+ import type { ConfigItem } from './model/model-types';
4
4
  import type { SharedExtensionDefinition, SharedExtensionServiceInfo } from './model/model-types';
5
5
  import { OAuth2 } from './oauth/oauth2';
6
6
  import type { OAuth2Props } from './oauth/types';
@@ -40,8 +40,8 @@ export declare class Extension {
40
40
  toConfigItems(): ConfigItem[];
41
41
  toServiceInfo(): SharedExtensionServiceInfo;
42
42
  /**
43
- * The published model — the v2 analogue of jsdoc-parser's `parseJsDocToServiceJson`, and the same
44
- * `{ serviceInfo, methodsMap }` shape the console consumes for a v1 service.
43
+ * The published model — the `{ serviceInfo, methodsMap }` shape the console consumes, the same one the
44
+ * removed v1 JSDoc parser produced.
45
45
  *
46
46
  * Every method describes itself, so this is one pass with no per-kind branches: what a service publishes
47
47
  * is exactly what it registered.
@@ -1,31 +1,19 @@
1
1
  import type BLRequest from 'backendless-request'
2
2
 
3
- import type { ServiceConfigItemTypes } from './common/constants'
4
- import type { ServiceClassType } from './v1/constants'
5
- import type { ConfigItemSource } from './v1/types'
6
- import type { createExtension } from './v2/create-extension'
7
- import type { FlowrunnerCrypto } from './v2/crypto'
8
- import type { ExtendedZod } from './v2/params'
9
- import type { getExtension } from './v2/registry'
3
+ import type { createExtension } from './create-extension'
4
+ import type { FlowrunnerCrypto } from './crypto'
5
+ import type { ExtendedZod } from './params'
6
+ import type { getExtension } from './registry'
10
7
 
11
- // The single `Flowrunner` runtime installed on the global scope by ../namespace.ts. Shared by v1 and v2:
8
+ // The single `Flowrunner` runtime installed on the global scope by ./namespace.ts:
12
9
  // - `Request` — HTTP client used by service code (`Flowrunner.Request.get(...)`).
13
- // - `z` / `createExtension` / `getExtension` — the v2 authoring surface (services do `const z = Flowrunner.z`).
14
- // - `ServerCode` — the v1-only registration seam, set for the duration of a v1 require (see v1/namespace.ts).
10
+ // - `z` / `createExtension` / `getExtension` — the authoring surface (services do `const z = Flowrunner.z`).
15
11
  export interface FlowrunnerRuntime {
16
12
  Request: typeof BLRequest
17
13
  z: ExtendedZod
18
14
  crypto: FlowrunnerCrypto
19
15
  createExtension: typeof createExtension
20
16
  getExtension: typeof getExtension
21
- ServerCode: FlowrunnerServerCode | null
22
- }
23
-
24
- export interface FlowrunnerServerCode {
25
- addService(ServiceClass: ServiceClassType, sourceConfigItems?: ConfigItemSource[]): void
26
- ConfigItems: {
27
- TYPES: typeof ServiceConfigItemTypes
28
- }
29
17
  }
30
18
 
31
19
  declare global {
@@ -1,15 +1,41 @@
1
1
  import './namespace';
2
- import * as v1 from './v1';
3
- import { createFlowrunnerSandboxV1 } from './v1/namespace';
4
- import * as v2 from './v2';
2
+ import { type FilesApi, type FlowrunnerContextFilesOptions } from './context/files';
3
+ import type { ConfigItem, SharedExtensionDefinition } from './model/model-types';
4
+ import { type ServiceConfigsValues } from './params/config-types';
5
+ import type { Logger } from './types';
5
6
  export * from './errors';
6
- export type { RunServiceMethodData } from './v2';
7
- export type { FlowrunnerContextOptions } from './common/context';
8
- export type { DeleteOptions, DeleteResult, FileInfo, FilesApi, GetOptions, ListOptions, ListResult, UploadFileOptions, UploadResult, UsageResult, } from './common/context-files';
9
- export { FileScope } from './common/context-files';
10
- export type ExtensionVersion = 'v1' | 'v2';
11
- export { createFlowrunnerSandboxV1, };
12
- export declare function detectVersion(serviceId: string, serviceEntryPointPath: string): ExtensionVersion;
13
- export declare function getServiceConfigs(serviceId: string, serviceEntryPointPath: string): ReturnType<typeof v1.getServiceConfigs>;
14
- export declare function runServiceMethod(data: v2.RunServiceMethodData): Promise<unknown>;
15
- export declare function buildServiceDefinition(serviceId: string, serviceEntryPointPath: string): v2.SharedExtensionDefinition | null;
7
+ export type { ConfigItem } from './model/model-types';
8
+ export type { SharedExtensionDefinition } from './model/model-types';
9
+ export type FlowrunnerContextOptions = FlowrunnerContextFilesOptions;
10
+ export type { DeleteOptions, DeleteResult, FileInfo, FilesApi, GetOptions, ListOptions, ListResult, UploadFileOptions, UploadResult, UsageResult, } from './context/files';
11
+ export { FileScope } from './context/files';
12
+ export { ExecutionContext } from './context/execution-context';
13
+ export { Extension } from './extension';
14
+ export { getAllExtensions, getExtension, resetRegistry } from './registry';
15
+ export type { PollingInvocation, PollingResult } from './polling-triggers/types';
16
+ export type { RealtimeInvocation } from './realtime-triggers/types';
17
+ export type { HandlerBag, Logger } from './types';
18
+ export interface RunServiceMethodData {
19
+ serviceId: string;
20
+ serviceEntryPointPath: string;
21
+ configs?: ServiceConfigsValues;
22
+ methodName: string;
23
+ methodData?: Record<string, unknown>;
24
+ logger?: Logger;
25
+ retrieveNewS3Token: (runtimeKey: string) => Promise<{
26
+ filesS3Token: string;
27
+ }>;
28
+ createFiles?: (options: FlowrunnerContextOptions) => FilesApi;
29
+ executionContext: {
30
+ runtimeKey: string;
31
+ accessToken: string;
32
+ appId: string;
33
+ apiKey: string;
34
+ serverURL: string;
35
+ flowId: string;
36
+ executionId: string;
37
+ };
38
+ }
39
+ export declare function getServiceConfigs(serviceId: string, serviceEntryPointPath: string): ConfigItem[];
40
+ export declare function buildServiceDefinition(serviceId: string, serviceEntryPointPath: string): SharedExtensionDefinition | null;
41
+ export declare function runServiceMethod(data: RunServiceMethodData): Promise<unknown>;
@@ -1,6 +1,6 @@
1
- import type { ConfigItem } from '../../common/types';
2
1
  import { DictionaryScope } from '../params/schema/dictionary-binding';
3
2
  import { type AnyZod } from '../params/schema/introspect';
3
+ import type { ConfigItem } from './model-types';
4
4
  import type { SharedExtensionMetaInfoArg, SharedExtensionParam } from './model-types';
5
5
  export interface FieldToParamOptions {
6
6
  nested?: boolean;
@@ -1,4 +1,5 @@
1
1
  import type { ParamsSchemaJSON } from '../params';
2
+ import type { ServiceConfigItemType } from '../params/config-types';
2
3
  export interface SharedExtensionParam {
3
4
  name: string;
4
5
  required: boolean;
@@ -66,8 +67,17 @@ export interface SharedExtensionServiceInfo {
66
67
  requireOAuth?: boolean | null;
67
68
  }
68
69
  export interface SharedExtensionDefinition {
69
- runnerVersion: 'v1' | 'v2';
70
70
  methodsMap: Record<string, SharedExtensionMethod>;
71
71
  serviceInfo: SharedExtensionServiceInfo;
72
72
  configSchema?: ParamsSchemaJSON | null;
73
73
  }
74
+ export interface ConfigItem {
75
+ name: string;
76
+ type: ServiceConfigItemType;
77
+ shared: boolean;
78
+ required: boolean;
79
+ description: string;
80
+ label: string;
81
+ defaultValue?: unknown;
82
+ options: string[];
83
+ }
@@ -1,5 +1,5 @@
1
- import type { ConfigItem } from '../../common/types';
2
1
  import { type ConfigParams, DictionaryScope, type MethodParams, type Params } from '../params';
2
+ import type { ConfigItem } from './model-types';
3
3
  import type { SharedExtensionMetaInfoArg, SharedExtensionParam } from './model-types';
4
4
  export declare function toBodyParams(params: MethodParams): SharedExtensionParam[];
5
5
  export declare function toArgs(params: MethodParams): Record<string, SharedExtensionMetaInfoArg>;
@@ -1,4 +1,4 @@
1
- import type { ServiceConfigsValues } from '../../common/constants';
1
+ import type { ServiceConfigsValues } from './config-types';
2
2
  import { Params } from './params';
3
3
  import type { SchemaSource } from './types';
4
4
  export declare class ConfigParams extends Params {
@@ -9,8 +9,10 @@ export type { AnyZod, Inspected, WidgetInfo } from './schema/introspect';
9
9
  export { deriveWidget, fieldLabels, inspect, shapeEntries } from './schema/introspect';
10
10
  export { humanizeKey, labelOf } from './schema/labels';
11
11
  export { coerceValue } from './schema/coerce';
12
+ export { compilePattern, formatParts, ISO_PATTERNS, parseInPattern } from './schema/date-format';
12
13
  export { absenceOf, type AbsencePolicy, type FieldPlan, planField } from './schema/field-plan';
13
14
  export { type FieldResult, normalizeField } from './schema/normalize';
15
+ export { collectNotices, type ParamNotice } from './schema/notices';
14
16
  export { type FailFn, parseSchema, toIssues } from './schema/parse';
15
17
  export { decodeField, decodeParams } from './json/decode';
16
18
  export { encodeField, encodeParams, type EncodeParamsOptions } from './json/encode';
@@ -31,6 +31,7 @@ export interface MetaJSON {
31
31
  dependsOn: string[];
32
32
  };
33
33
  frLabels?: Record<string, string>;
34
+ frDateFormat?: string;
34
35
  }
35
36
  export type FieldType = 'string' | 'number' | 'bigint' | 'boolean' | 'date' | 'enum' | 'literal' | 'object' | 'array' | 'record' | 'union'
36
37
  /**
@@ -45,6 +46,7 @@ export interface FieldJSON {
45
46
  name: string;
46
47
  type: FieldType;
47
48
  format?: string;
49
+ local?: true;
48
50
  optional?: true;
49
51
  nullable?: true;
50
52
  default?: JsonValue;
@@ -0,0 +1,80 @@
1
+ import { type AnyZod, type Inspected } from './introspect';
2
+ export type DateStringKind = 'date' | 'datetime' | 'time';
3
+ export declare const ISO_PATTERNS: Record<DateStringKind, string>;
4
+ /**
5
+ * ⚠️ TEMPORARY (FR-3920 lenient period). A flow saved before a service moved from `z.date()` to a string type
6
+ * holds a TIMESTAMP — epoch millis, the old picker's value. While this is true, such a timestamp is still
7
+ * accepted: read in the server's time zone, put into the declared pattern, and logged as a warning per
8
+ * conversion so the flows still holding one can be found.
9
+ *
10
+ * The next release flips it to `false` (a timestamp is refused, as the string types intend), once the
11
+ * warnings stop. Only a timestamp is affected — every other input follows the strict rules either way.
12
+ */
13
+ export declare const DATE_STRINGS_ACCEPT_TIMESTAMPS = true;
14
+ export interface DateParts {
15
+ year?: number;
16
+ month?: number;
17
+ day?: number;
18
+ hour?: number;
19
+ minute?: number;
20
+ second?: number;
21
+ }
22
+ /**
23
+ * Which date-string kind a field is, or `undefined` when it is not one.
24
+ *
25
+ * `z.iso.datetime()` WITHOUT `local: true` is an instant — it has a zone — and is not a date string: it
26
+ * keeps its own conversion in ./dates.ts.
27
+ */
28
+ export declare function dateStringKind(ins: Inspected): DateStringKind | undefined;
29
+ /** The pattern a date-string field hands to `execute`: the declared one, or the ISO one. */
30
+ export declare const patternOf: (ins: Inspected, kind: DateStringKind) => string;
31
+ type TokenName = 'yyyy' | 'yy' | 'MM' | 'M' | 'dd' | 'd' | 'HH' | 'H' | 'hh' | 'h' | 'mm' | 'ss' | 'a';
32
+ type Token = {
33
+ token: TokenName;
34
+ } | {
35
+ literal: string;
36
+ };
37
+ /** A pattern the runner cannot use. The message completes "`.dateFormat('…')` …". */
38
+ export declare class DateFormatError extends Error {
39
+ }
40
+ /**
41
+ * Check `pattern` for `kind` and return its tokens. Throws `DateFormatError` with a message naming the
42
+ * problem and, where it can, the pattern the author meant.
43
+ */
44
+ export declare function compilePattern(pattern: string, kind: DateStringKind): Token[];
45
+ /** The parts as text in `pattern`. The parts are assumed valid — they come from `parse*` below. */
46
+ export declare function formatParts(parts: DateParts, pattern: string, kind: DateStringKind): string;
47
+ /**
48
+ * `text` read STRICTLY in `pattern`: it must be exactly what formatting its own parts produces. That one
49
+ * rule refuses `1/2/2024` for `dd/MM/yyyy`, `31/02/2024`, `24:00` and `pm` for `PM` — and it is the rule the
50
+ * console's picker applies too, so the picker never commits a string the runner then refuses.
51
+ */
52
+ export declare function parseInPattern(text: string, pattern: string, kind: DateStringKind): DateParts | undefined;
53
+ /** An ISO string → the parts `kind` needs, or `undefined` when it does not carry them. */
54
+ export declare function parseIso(text: string, kind: DateStringKind): DateParts | undefined;
55
+ /** The parts as canonical ISO — what zod's check on the type accepts, and what the pipeline carries. */
56
+ export declare function toCanonical(parts: DateParts, kind: DateStringKind): string;
57
+ /**
58
+ * The canonical ISO text, written out in the declared pattern. Without a declared pattern it is returned as
59
+ * it is: canonical ISO is the ISO form, and keeps the seconds the input had.
60
+ */
61
+ export declare function canonicalToPattern(canonical: string, ins: Inspected, kind: DateStringKind): string;
62
+ export interface DateStringResult {
63
+ canonical?: string;
64
+ fromTimestamp?: boolean;
65
+ }
66
+ /**
67
+ * Any input → canonical ISO for a date-string field, in this order:
68
+ *
69
+ * 1. text in the DECLARED pattern, read strictly — first, so `yyyy-dd-MM` reads `2024-05-06` as 5 June;
70
+ * 2. an ISO date / date-time / time, read lexically (the zone dropped, nothing widened);
71
+ * 3. a timestamp — only during the lenient period, read in the server's zone.
72
+ *
73
+ * Anything else is not a date of this kind.
74
+ */
75
+ export declare function toDateString(value: unknown, ins: Inspected, kind: DateStringKind): DateStringResult;
76
+ /** "a date in dd/MM/yyyy, e.g. 31/01/2024" — completes "«Label» must be …". */
77
+ export declare function expectedDateString(ins: Inspected, kind: DateStringKind): string;
78
+ /** Whether `.dateFormat()` sits anywhere in `schema` — the field, a property, a list item, a union branch. */
79
+ export declare function hasDateFormat(schema: AnyZod | undefined, seen?: Set<unknown>): boolean;
80
+ export {};
@@ -21,8 +21,9 @@ export declare const FORMAT_DESCRIPTIONS: Record<string, string>;
21
21
  * What a field's declaration explains about itself, most specific wins:
22
22
  *
23
23
  * 1. a FlowRunner widget marker — `z.text()`, a string the console renders specially
24
- * 2. a zod `format` token — `z.email()`, `z.ipv4()`, `z.iso.date()`, …
25
- * 3. the plain core type — `number`, `bigint`, `literal`, `enum`, `date`
24
+ * 2. a date or time as text — `z.iso.date().dateFormat('dd/MM/yyyy')`: the pattern and an example
25
+ * 3. a zod `format` token — `z.email()`, `z.ipv4()`, `z.iso.datetime()`, …
26
+ * 4. the plain core type — `number`, `bigint`, `literal`, `enum`, `date`
26
27
  *
27
28
  * Each is read past the optional/nullable/default wrappers, so a modifier never changes the answer.
28
29
  */
@@ -1,3 +1,4 @@
1
+ import { type DateStringKind } from './date-format';
1
2
  import { type AnyZod } from './introspect';
2
3
  export type AbsencePolicy = 'as-received' | 'undefined' | 'null' | 'required';
3
4
  export interface Absence {
@@ -16,10 +17,10 @@ export interface FieldPlan {
16
17
  *
17
18
  * Carried because `coreType` alone stops describing the field: a union resolves to its first branch, so a
18
19
  * `z.union([z.email(), z.literal('')])` reports `'string'` and would then treat a blank as a VALUE. It is
19
- * not one — `''` has always been absence on a union, which is exactly what makes the documented
20
- * "blank means not set" spelling (`z.union([z.url(), z.literal('')]).optional()`) work.
20
+ * not one — `''` is absence on a union, unless the union declares it (`blankBranch`).
21
21
  */
22
22
  isUnion: boolean;
23
+ blankBranch: boolean;
23
24
  absence: AbsencePolicy;
24
25
  absorbsBlank: boolean;
25
26
  keepsEmpty: boolean;
@@ -32,6 +33,12 @@ export interface FieldPlan {
32
33
  */
33
34
  passThroughDate: boolean;
34
35
  restoresDates: boolean;
36
+ /**
37
+ * The field ITSELF is a date or time as text (FR-3920): `z.iso.date()`, `z.iso.datetime({ local: true })`,
38
+ * `z.iso.time()`. Its core type is `string`, but `''` is absence on it, as on every type with no empty value.
39
+ */
40
+ dateString?: DateStringKind;
41
+ formatsDates: boolean;
35
42
  }
36
43
  /** The absent forms a schema accepts, at any depth. Same question `planField` asks for a top-level field. */
37
44
  export declare function absenceOf(schema: AnyZod | undefined): Absence;
@@ -53,6 +53,14 @@ export interface WidgetInfo {
53
53
  };
54
54
  }
55
55
  export declare function literalType(core: AnyZod): string | undefined;
56
+ /**
57
+ * True when a union declares `''` as one of its forms — a `z.literal('')` branch (FR-3933).
58
+ *
59
+ * On such a union `''` is a VALUE, not a blank: the author listed it, so it is the deliberate "empty" a flow
60
+ * sends (the Empty Text chip, a bound `''`), while `null` and a missing value stay "not provided". That is the
61
+ * only way a flow can clear a date: an untouched block field arrives as `null`, so `null` cannot mean "clear".
62
+ */
63
+ export declare function hasBlankBranch(ins: Inspected): boolean;
56
64
  export declare function deriveWidget(ins: Inspected): WidgetInfo;
57
65
  export declare function shapeEntries(schema: AnyZod | undefined): [name: string, schema: AnyZod][];
58
66
  export declare function fieldLabels(schema: AnyZod): Record<string, string> | undefined;
@@ -1,4 +1,4 @@
1
- import type { ValidationIssue } from '../../../errors';
1
+ import type { ValidationIssue } from '../../errors';
2
2
  import type { ZodIssue } from '../types';
3
3
  import type { FieldPlan } from './field-plan';
4
4
  export declare const requiredMessage: (plan: FieldPlan) => string;
@@ -1,4 +1,4 @@
1
- import type { ValidationIssue } from '../../../errors';
1
+ import type { ValidationIssue } from '../../errors';
2
2
  import type { FieldPlan } from './field-plan';
3
3
  export interface FieldResult {
4
4
  value?: unknown;
@@ -0,0 +1,15 @@
1
+ export interface ParamNotice {
2
+ field?: string;
3
+ message: string;
4
+ value: unknown;
5
+ converted: string;
6
+ }
7
+ /** Run `fn`, returning what it returned and every notice raised while it ran. Nests: the inner one collects. */
8
+ export declare function collectNotices<T>(fn: () => T): {
9
+ result: T;
10
+ notices: ParamNotice[];
11
+ };
12
+ /** Run `fn` with notices attributed to `field`. */
13
+ export declare function withinField<T>(field: string, fn: () => T): T;
14
+ /** Raise a notice. Without an open collector — a console form, a test — it goes nowhere. */
15
+ export declare function notice(entry: Omit<ParamNotice, 'field'>): void;
@@ -1,4 +1,4 @@
1
- import type { ValidationIssue } from '../../../errors';
1
+ import type { ValidationIssue } from '../../errors';
2
2
  import type { ZodIssue, ZodSchema } from '../types';
3
3
  export type FailFn = (issues: ValidationIssue[]) => never;
4
4
  export declare function toIssues(error: {
@@ -1,4 +1,4 @@
1
- import type { ValidationIssue } from '../../errors';
1
+ import type { ValidationIssue } from '../errors';
2
2
  export interface ZodIssue {
3
3
  path?: readonly PropertyKey[];
4
4
  message?: string;
@@ -38,6 +38,8 @@ export interface FrMeta {
38
38
  * method that runs it on a decoded one. Never encoded as the spec: see ./json/encode.ts.
39
39
  */
40
40
  frDynamicProps?: DynamicPropsSpec | DynamicPropsRef;
41
+ /** `.dateFormat(pattern)` — the date-fns pattern a date-string field is handed to `execute` in. */
42
+ frDateFormat?: string;
41
43
  }
42
44
  declare module 'zod' {
43
45
  interface ZodType {
@@ -93,6 +95,25 @@ declare module 'zod' {
93
95
  /** Mark the field required — see `ZodUnknown.required`. */
94
96
  required(): this;
95
97
  }
98
+ interface ZodISODate {
99
+ /**
100
+ * The text `execute` receives, as a date-fns pattern: `z.iso.date().dateFormat('dd/MM/yyyy')` → `'31/01/2024'`.
101
+ * Without it the value is ISO (`2024-01-31`, `2024-01-31T13:45`, `13:45`). Tokens: yyyy yy MM M dd d HH H
102
+ * hh h mm ss a, and literal text in single quotes. Checked when the service loads.
103
+ *
104
+ * Not `.format()`: zod 4 keeps `format` as an own STRING property on every string schema
105
+ * (`z.iso.date().format === 'date'`), which shadows a prototype method and is restored on every clone.
106
+ */
107
+ dateFormat(pattern: string): this;
108
+ }
109
+ interface ZodISODateTime {
110
+ /** See `ZodISODate.dateFormat`. Only with `{ local: true }` — checked when the service loads. */
111
+ dateFormat(pattern: string): this;
112
+ }
113
+ interface ZodISOTime {
114
+ /** See `ZodISODate.dateFormat`. */
115
+ dateFormat(pattern: string): this;
116
+ }
96
117
  }
97
118
  declare function text(): baseZod.ZodString;
98
119
  /**
@@ -12,6 +12,8 @@ export declare class ExtensionRegistry {
12
12
  * which imports it.
13
13
  */
14
14
  load(id: string, entryPointPath: string): Extension;
15
+ /** As `load`, but `undefined` instead of throwing when the module registers no extension under `id`. */
16
+ tryLoad(id: string, entryPointPath: string): Extension | undefined;
15
17
  reset(): void;
16
18
  }
17
19
  export declare const registry: ExtensionRegistry;
@@ -1,5 +1,5 @@
1
1
  import type { z } from 'zod';
2
- import type { FilesApi, FileScopes } from '../common/context-files';
2
+ import type { FilesApi, FileScopes } from './context/files';
3
3
  import type { Extension } from './extension';
4
4
  import type { OAuth2Props, OAuthBag } from './oauth/types';
5
5
  import type { DictionaryRef } from './params';
@@ -7,9 +7,7 @@ export interface DiscoveredService {
7
7
  serviceInfo: SharedExtensionDefinition['serviceInfo'];
8
8
  methodsMap: SharedExtensionDefinition['methodsMap'];
9
9
  configDescriptions: SharedExtensionConfigItem[];
10
- /** Which authoring format the entry point turned out to be — the deploy carries it so the console can branch. */
11
- runnerVersion: SharedExtensionDefinition['runnerVersion'];
12
- /** v2 only: the declared config schema, encoded. `null` for a JSDoc-parsed service. */
10
+ /** The declared config schema, encoded. */
13
11
  configSchema: SharedExtensionDefinition['configSchema'];
14
12
  }
15
13
  export interface DiscoveryResult {
@@ -22,5 +20,5 @@ export interface DiscoveryResult {
22
20
  */
23
21
  skipped: SkippedService[];
24
22
  }
25
- /** Scan `services/*` under the project root and build each service's definition, v2 declarative or v1 JSDoc. */
23
+ /** Scan `services/*` under the project root and build each service's definition from its `createExtension` call. */
26
24
  export declare function discoverServices(projectRoot?: string): DiscoveryResult;