slapflow 1.1.0 → 1.2.0

package/README.md

@@ -162,7 +162,7 @@ const config = {
 - A broad set of [built-in conditions](SPEC.md#built-in-conditions) for comparisons, type checks, collections, and compound logic.
 - Typed PubSub bindings and delegated DOM bindings.
 - `parallel`, `latest`, `queue`, and `drop` concurrency modes with per-entity lanes.
-- A WebSocket bridge for forwarding selected bus events.
+- A native WebSocket client that proxies socket events into the bus.
 - `core.fetch` with response parsing, cancellation, and retry backoff.
 - Normalized results, execution trace, validation, and lifecycle diagnostics such as `slapflow.run.started` and `slapflow.run.failed`.
 - Runtime variables for configuration values, templates, and expressions.

package/SPEC-RU.md

@@ -12,23 +12,20 @@
 
 ```ts
 import {
-  createActionsRegistry,
-  createConditionsRegistry,
+  BUILTIN_ACTIONS,
+  BUILTIN_CONDITIONS,
   createMemoryTraceSink,
   defineErrorReporter,
   createPubSub,
   PubSub,
   createFlow,
-  createWS,
+  createWebSocket,
   catchError,
 } from 'slapflow'
 ```
 
 ```ts
-const flow = createFlow<Context, Patch>(
-  { config: { strategies: {} } },
-  { context: () => ({} as Context) }
-)
+const flow = createFlow<Context, Patch>({ config: { strategies: {} } }, { context: () => ({}) as Context })
 const runner = flow.runner
 
 runner.registerAction('jobs.execute', executeJob)
@@ -48,10 +45,7 @@ type Config = {
   guards?: Record<string, ConditionExpression>
 }
 
-type ConditionExpression =
-  | boolean
-  | [operator: string, ...args: unknown[]]
-  | ['guard', name: string]
+type ConditionExpression = boolean | [operator: string, ...args: unknown[]] | ['guard', name: string]
 
 type Strategy = {
   fn: string
@@ -85,7 +79,7 @@ const reportError = defineErrorReporter({
 
 const flow = createFlow(
   { config: { strategies: {} } },
-  { context: () => ({} as Context), trace: true, onError: reportError }
+  { context: () => ({}) as Context, trace: true, onError: reportError }
 )
 ```
 
@@ -123,40 +117,34 @@ type ErrorStage = {
 
 Возвращаемое значение действия нормализуется в один итог. Соответствие:
 
-| Возврат                                           | Итог                                                         |
-| ------------------------------------------------- | ------------------------------------------------------------ |
-| `undefined` / `null`                              | `success`                                                    |
-| `false`                                           | `skipped`                                                    |
-| `{ type: 'skip', reason?, data? }`                | `skipped` (селектор пробует следующую ветку)                 |
-| `{ type: 'stop', reason?, patch?, events? }`      | `stopped` (цепочка останавливается без ошибки)               |
-| `{ type: 'fail', reason?, data?, error? }`        | `failed` (запускается `catch`, затем `onError`)              |
+| Возврат                                           | Итог                                                          |
+| ------------------------------------------------- | ------------------------------------------------------------- |
+| `undefined` / `null`                              | `success`                                                     |
+| `false`                                           | `skipped`                                                     |
+| `{ type: 'skip', reason?, data? }`                | `skipped` (селектор пробует следующую ветку)                  |
+| `{ type: 'stop', reason?, patch?, events? }`      | `stopped` (цепочка останавливается без ошибки)                |
+| `{ type: 'fail', reason?, data?, error? }`        | `failed` (запускается `catch`, затем `onError`)               |
 | `{ context?, data?, patch?, events?, continue? }` | `success`; `continue: false` прерывает оставшиеся `then`-цели |
 
 Брошенное исключение трактуется как `fail`. Возврат `false` и `{ type: 'skip' }` эквивалентны.
 
 ## Модель реестров
 
-Исполнитель использует собственные реестры:
+Встроенные элементы живут в двух общих константах — по одной на вид:
 
-```text
-src/registry/
-  actions.ts
-  conditions.ts
+```ts
+import { BUILTIN_ACTIONS, BUILTIN_CONDITIONS } from 'slapflow'
 ```
 
-`createActionsRegistry()` создаёт `Map`, предварительно заполненный встроенными действиями.
+`BUILTIN_ACTIONS` — это readonly-список `[name, action][]`, предварительно заполненный встроенными действиями; `BUILTIN_CONDITIONS` содержит встроенные условия. Каждый исполнитель получает собственный `new Map(BUILTIN_ACTIONS)` / `new Map(BUILTIN_CONDITIONS)`, поэтому регистрации остаются изолированными по исполнителям.
 
-`createConditionsRegistry()` создаёт `Map`, предварительно заполненный встроенными условиями.
-
-Каждый исполнитель получает собственную изменяемую копию реестра. Приложения могут переопределить любое встроенное действие или условие:
+Встроенные элементы неизменяемы: `registerAction` и `registerCondition` отклоняют попытку переопределить встроенное имя.
 
 ```ts
 runner.registerAction('app.setData', customSetData)
-runner.registerCondition('eq', customEq)
+runner.registerCondition('hasQueue', hasItems)
 ```
 
-Таким образом, встроенные элементы являются значениями по умолчанию, а не отдельным неизменяемым слоем.
-
 Проверка конфигурации обращается к реестрам через минимальный контракт `has(name)`.
 
 ## Встроенные действия
@@ -250,11 +238,11 @@ export const config = {
 
 Не-`success` итог шага меняет дальнейшее поведение в зависимости от режима:
 
-| Итог     | `sequence`                | `selector`                 |
-| -------- | ------------------------- | -------------------------- |
-| `skipped`| **прерывает остаток**      | пробует следующую ветку    |
+| Итог      | `sequence`            | `selector`              |
+| --------- | --------------------- | ----------------------- |
+| `skipped` | **прерывает остаток** | пробует следующую ветку |
 
-`sequence` — режим по умолчанию, и он прерывает оставшиеся `then`-цели на *любом* не-`success` (`skipped`, `stopped`, `failed`) — не только на сбое. Условный шаг внутри последовательности — это, таким образом, скрытый ранний выход для всего остатка. Если пропуск шага не должен рвать цепочку, заверните его в селектор с запасным `core.noop`.
+`sequence` — режим по умолчанию, и он прерывает оставшиеся `then`-цели на _любом_ не-`success` (`skipped`, `stopped`, `failed`) — не только на сбое. Условный шаг внутри последовательности — это, таким образом, скрытый ранний выход для всего остатка. Если пропуск шага не должен рвать цепочку, заверните его в селектор с запасным `core.noop`.
 
 `terminal: true` останавливает `then`-цепочку после этой стратегии даже при `success`; `continue: false` в `ActionSuccess` даёт тот же эффект.
 
@@ -399,12 +387,12 @@ type BusEvent<TPayload> = {
 На тему можно подписаться по шаблону, где `*` соответствует ровно одному сегменту, разделённому точкой. Шаблонный символ не пересекает границу `.`.
 
 ```ts
-bus.on('hub.user.*', ({ parsed }) => {})       // hub.user.created, hub.user.deleted
-bus.on('hub.*.created', ({ parsed }) => {})    // hub.user.created, hub.team.created
-bus.on('hub.*.export', ({ parsed }) => {})     // НЕ hub.user.audit.export (один сегмент)
+bus.on('hub.user.*', ({ parsed }) => {}) // hub.user.created, hub.user.deleted
+bus.on('hub.*.created', ({ parsed }) => {}) // hub.user.created, hub.team.created
+bus.on('hub.*.export', ({ parsed }) => {}) // НЕ hub.user.audit.export (один сегмент)
 ```
 
-Подписки с точным именем остаются O(1); шаблоны обрабатываются отдельно, поэтому регистрации без `*` не несут накладных затрат на сравнение. Обработчик шаблона получает `parsed` как `unknown` — сужайте тип перед использованием. Шаблоны работают в `bus.on`/`bus.off`, а также в `inboundTopics`/`outboundTopics` у `createWS`.
+Подписки с точным именем остаются O(1); шаблоны обрабатываются отдельно, поэтому регистрации без `*` не несут накладных затрат на сравнение. Обработчик шаблона получает `parsed` как `unknown` — сужайте тип перед использованием. Шаблоны работают в `bus.on`/`bus.off`.
 
 ## Поток
 
@@ -489,24 +477,30 @@ type ConcurrencyOptions<TPayload> = {
 
 `defaultInput` имеет тип `{ type, value?, dataset, form? }`. `dataset` содержит все атрибуты `data-*` совпавшего элемента в виде ключей camelCase. `form` строится по ближайшему элементу `<form>`; повторяющиеся поля формы превращаются в массивы, а `File` остаётся `File`. Для `submit` значение `preventDefault` по умолчанию равно `true`; для остальных событий оно и `stopPropagation` по умолчанию равны `false`.
 
-### WebSocket-мост
+### WebSocket-клиент
 
-`createWS` подключает шину к WebSocket-подобному транспорту. Мост принимает `createSocket`, поэтому одинаково работает с браузерным WebSocket и серверным адаптером.
+`createWebSocket` открывает нативный `WebSocket` по `url` и проксирует каждое событие сокета в шину. Формат провода не предполагается — каждое событие отправляется с фиксированной темой и конвертом, где `parsed` содержит сырую полезную нагрузку.
 
 ```ts
-const ws = createWS({
+const socket = createWebSocket({
+  url,
   bus,
-  createSocket: () => new WebSocket(url),
-  inboundTopics: ['order.created'],
-  outboundTopics: ['slapflow.run.finished'],
-  origin: 'worker',
-  retry: { initialDelay: 500, maxDelay: 10_000, multiplier: 2, jitter: true, maxAttempts: 5 },
+  origin: 'client',
 })
 
-ws.start()
+socket.start()
 ```
 
-Входящие темы проходят через явный список разрешений. Каждая запись может быть точной темой или шаблоном, где `*` соответствует одному сегменту, разделённому точкой. Мост разбирает JSON-конверт и вызывает `bus.dispatch(event)`, сохраняя `id`, `occurredAt`, `origin`, `parsed` и `serialized`; принятые входящие идентификаторы запоминаются и не отправляются обратно наружу. Исходящие темы отправляют полный JSON-конверт события, поэтому удалённый мост может передать его в шину, не создавая новый идентификатор. `maxAttempts` ограничивает reconnect; без него повторы идут бесконечно. `start`, `stop`, `reconnect` и `status` управляют жизненным циклом транспорта. Диагностические события: `slapflow.ws.connecting`, `slapflow.ws.connected`, `slapflow.ws.disconnected`, `slapflow.ws.retrying` и `slapflow.ws.message.rejected`.
+```ts
+bus.on('message', ({ parsed }) => {}) // parsed = сырое сообщение (JSON-декодированное, когда возможно)
+bus.on('open', ({ parsed }) => {}) // { url }
+bus.on('close', ({ parsed }) => {}) // { code, reason }
+bus.on('error', ({ parsed }) => {}) // { error }
+```
+
+События сокета приходят с темой `open`, `message`, `close` или `error`. Полезная нагрузка `message` JSON-декодируется в `parsed`, если валидна, иначе остаётся сырой строкой. Фильтрация тем — забота потребителя: внутри клиента ничего не разрешается и не отклоняется. `reconnect` принимает `initialDelay`, `maxDelay`, `multiplier`, `jitter` и `maxAttempts`; без `maxAttempts` повторы идут бесконечно. `start`, `stop`, `reconnect` и `status` управляют жизненным циклом; статус — одно из `idle`, `connecting`, `connected`, `reconnecting` или `stopped`.
+
+`createWS` помечен как deprecated и будет удалён; мигрируйте на `createWebSocket`.
 
 ## Ограничения безопасности
 

package/SPEC.md

@@ -12,23 +12,20 @@ The package is not coupled to a UI, server framework, scheduler, or domain model
 
 ```ts
 import {
-  createActionsRegistry,
-  createConditionsRegistry,
+  BUILTIN_ACTIONS,
+  BUILTIN_CONDITIONS,
   createMemoryTraceSink,
   defineErrorReporter,
   createPubSub,
   PubSub,
   createFlow,
-  createWS,
+  createWebSocket,
   catchError,
 } from 'slapflow'
 ```
 
 ```ts
-const flow = createFlow<Context, Patch>(
-  { config: { strategies: {} } },
-  { context: () => ({} as Context) }
-)
+const flow = createFlow<Context, Patch>({ config: { strategies: {} } }, { context: () => ({}) as Context })
 const runner = flow.runner
 
 runner.registerAction('jobs.execute', executeJob)
@@ -48,10 +45,7 @@ type Config = {
   guards?: Record<string, ConditionExpression>
 }
 
-type ConditionExpression =
-  | boolean
-  | [operator: string, ...args: unknown[]]
-  | ['guard', name: string]
+type ConditionExpression = boolean | [operator: string, ...args: unknown[]] | ['guard', name: string]
 
 type Strategy = {
   fn: string
@@ -85,7 +79,7 @@ const reportError = defineErrorReporter({
 
 const flow = createFlow(
   { config: { strategies: {} } },
-  { context: () => ({} as Context), trace: true, onError: reportError }
+  { context: () => ({}) as Context, trace: true, onError: reportError }
 )
 ```
 
@@ -123,40 +117,34 @@ If an error is recovered through `catch`, `onError` is still invoked for the ori
 
 An action's return value is normalized into one outcome. The mapping:
 
-| Return                                            | Outcome                                                        |
-| ------------------------------------------------- | -------------------------------------------------------------- |
-| `undefined` / `null`                              | `success`                                                      |
-| `false`                                           | `skipped`                                                      |
-| `{ type: 'skip', reason?, data? }`                | `skipped` (a selector tries the next branch)                   |
-| `{ type: 'stop', reason?, patch?, events? }`      | `stopped` (the chain halts without error)                      |
-| `{ type: 'fail', reason?, data?, error? }`        | `failed` (`catch` runs, then `onError`)                        |
+| Return                                            | Outcome                                                         |
+| ------------------------------------------------- | --------------------------------------------------------------- |
+| `undefined` / `null`                              | `success`                                                       |
+| `false`                                           | `skipped`                                                       |
+| `{ type: 'skip', reason?, data? }`                | `skipped` (a selector tries the next branch)                    |
+| `{ type: 'stop', reason?, patch?, events? }`      | `stopped` (the chain halts without error)                       |
+| `{ type: 'fail', reason?, data?, error? }`        | `failed` (`catch` runs, then `onError`)                         |
 | `{ context?, data?, patch?, events?, continue? }` | `success`; `continue: false` halts the remaining `then` targets |
 
 A thrown exception is treated as `fail`. Returning `false` and `{ type: 'skip' }` are equivalent.
 
 ## Registry Model
 
-The runner uses runner-scoped registries:
+Built-ins live in two shared constants, one per kind:
 
-```text
-src/registry/
-  actions.ts
-  conditions.ts
+```ts
+import { BUILTIN_ACTIONS, BUILTIN_CONDITIONS } from 'slapflow'
 ```
 
-`createActionsRegistry()` creates a `Map` prepopulated with built-in actions.
+`BUILTIN_ACTIONS` is a readonly `[name, action][]` list prepopulated with built-in actions; `BUILTIN_CONDITIONS` holds built-in conditions. Each runner receives its own `new Map(BUILTIN_ACTIONS)` / `new Map(BUILTIN_CONDITIONS)` seed, so registrations stay isolated per runner.
 
-`createConditionsRegistry()` creates a `Map` prepopulated with built-in conditions.
-
-Each runner receives its own mutable registry copy. Applications can override any built-in action or condition:
+Built-ins are immutable defaults: `registerAction` and `registerCondition` reject an attempt to override a built-in name.
 
 ```ts
 runner.registerAction('app.setData', customSetData)
-runner.registerCondition('eq', customEq)
+runner.registerCondition('hasQueue', hasItems)
 ```
 
-Built-ins are therefore default values, not a separate immutable layer.
-
 Configuration validation accesses registries through the minimal `has(name)` contract.
 
 ## Built-In Actions
@@ -250,11 +238,11 @@ export const config = {
 
 A non-`success` outcome at a step changes what happens next, depending on the mode:
 
-| Outcome   | `sequence`             | `selector`               |
-| --------- | ---------------------- | ------------------------ |
-| `skipped` | **interrupts the rest** | tries the next branch    |
+| Outcome   | `sequence`              | `selector`            |
+| --------- | ----------------------- | --------------------- |
+| `skipped` | **interrupts the rest** | tries the next branch |
 
-`sequence` is the default mode and interrupts the remaining `then` targets on *any* non-`success` (`skipped`, `stopped`, `failed`) — not only on failure. A conditional step inside a sequence is therefore a hidden early exit for the whole remainder. When skipping a step must not break the chain, wrap it in a selector with a `core.noop` fallback.
+`sequence` is the default mode and interrupts the remaining `then` targets on _any_ non-`success` (`skipped`, `stopped`, `failed`) — not only on failure. A conditional step inside a sequence is therefore a hidden early exit for the whole remainder. When skipping a step must not break the chain, wrap it in a selector with a `core.noop` fallback.
 
 `terminal: true` stops the `then` chain after that strategy even on `success`; `continue: false` in `ActionSuccess` has the same effect.
 
@@ -399,12 +387,12 @@ type BusEvent<TPayload> = {
 A topic may be subscribed by pattern, using `*` to match exactly one dot-delimited segment. A wildcard does not cross a `.` boundary.
 
 ```ts
-bus.on('hub.user.*', ({ parsed }) => {})       // hub.user.created, hub.user.deleted
-bus.on('hub.*.created', ({ parsed }) => {})    // hub.user.created, hub.team.created
-bus.on('hub.*.export', ({ parsed }) => {})     // NOT hub.user.audit.export (wildcard spans one segment)
+bus.on('hub.user.*', ({ parsed }) => {}) // hub.user.created, hub.user.deleted
+bus.on('hub.*.created', ({ parsed }) => {}) // hub.user.created, hub.team.created
+bus.on('hub.*.export', ({ parsed }) => {}) // NOT hub.user.audit.export (wildcard spans one segment)
 ```
 
-Exact-name subscriptions stay O(1); wildcard patterns are matched separately, so registrations without `*` pay no matching cost. A wildcard handler receives `parsed` as `unknown` — narrow it before use. Wildcards work in `bus.on`/`bus.off` and in `inboundTopics`/`outboundTopics` of `createWS`.
+Exact-name subscriptions stay O(1); wildcard patterns are matched separately, so registrations without `*` pay no matching cost. A wildcard handler receives `parsed` as `unknown` — narrow it before use. Wildcards work in `bus.on`/`bus.off`.
 
 ## Flow
 
@@ -489,24 +477,30 @@ A DOM binding key uses the `[dom] <css-selector>:<event>` format. Slapflow insta
 
 `defaultInput` has type `{ type, value?, dataset, form? }`. `dataset` contains all `data-*` attributes from the matching element as camelCase keys. `form` is built from the nearest `<form>`; repeated form entries become arrays and `File` remains `File`. For `submit`, `preventDefault` defaults to `true`; for other events, it and `stopPropagation` default to `false`.
 
-### WebSocket Bridge
+### WebSocket Client
 
-`createWS` connects a bus to a WebSocket-like transport. The bridge accepts `createSocket`, so it works with browser WebSocket and a server adapter alike.
+`createWebSocket` opens a native `WebSocket` to `url` and proxies every socket event into the bus. No wire format is assumed — each event is dispatched with a fixed topic and an envelope whose `parsed` holds the raw payload.
 
 ```ts
-const ws = createWS({
+const socket = createWebSocket({
+  url,
   bus,
-  createSocket: () => new WebSocket(url),
-  inboundTopics: ['order.created'],
-  outboundTopics: ['slapflow.run.finished'],
-  origin: 'worker',
-  retry: { initialDelay: 500, maxDelay: 10_000, multiplier: 2, jitter: true, maxAttempts: 5 },
+  origin: 'client',
 })
 
-ws.start()
+socket.start()
 ```
 
-Inbound topics pass an explicit allowlist. Each entry may be an exact topic or a wildcard pattern, where `*` matches one dot-delimited segment. The bridge parses a JSON envelope and calls `bus.dispatch(event)`, preserving `id`, `occurredAt`, `origin`, `parsed`, and `serialized`; it remembers accepted inbound IDs and does not send them back outbound. Outbound topics send the complete event envelope as JSON, so the remote bridge can dispatch it without recreating its identity. `maxAttempts` limits reconnects; omitting it retries indefinitely. `start`, `stop`, `reconnect`, and `status` manage the transport lifecycle. Diagnostics: `slapflow.ws.connecting`, `slapflow.ws.connected`, `slapflow.ws.disconnected`, `slapflow.ws.retrying`, and `slapflow.ws.message.rejected`.
+```ts
+bus.on('message', ({ parsed }) => {}) // parsed = the raw message (JSON-decoded when possible)
+bus.on('open', ({ parsed }) => {}) // { url }
+bus.on('close', ({ parsed }) => {}) // { code, reason }
+bus.on('error', ({ parsed }) => {}) // { error }
+```
+
+Socket events are forwarded with the topic `open`, `message`, `close`, or `error`. `message` payloads are JSON-decoded into `parsed` when valid, otherwise kept as the raw string. Filtering topics is the consumer's responsibility — nothing is allow-listed or rejected inside the client. `reconnect` accepts `initialDelay`, `maxDelay`, `multiplier`, `jitter`, and `maxAttempts`; omitting `maxAttempts` retries indefinitely. `start`, `stop`, `reconnect`, and `status` manage the lifecycle; status is one of `idle`, `connecting`, `connected`, `reconnecting`, or `stopped`.
+
+`createWS` is deprecated and will be removed; migrate to `createWebSocket`.
 
 ## Safety Limits
 

package/dist/index.cjs

@@ -20,14 +20,17 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  BUILTIN_ACTIONS: () => BUILTIN_ACTIONS,
+  BUILTIN_ACTION_NAMES: () => BUILTIN_ACTION_NAMES,
+  BUILTIN_CONDITIONS: () => BUILTIN_CONDITIONS,
+  BUILTIN_CONDITION_NAMES: () => BUILTIN_CONDITION_NAMES,
   PubSub: () => PubSub,
   catchError: () => catchError,
-  createActionsRegistry: () => createActionsRegistry,
-  createConditionsRegistry: () => createConditionsRegistry,
   createFlow: () => createFlow,
   createMemoryTraceSink: () => createMemoryTraceSink,
   createPubSub: () => createPubSub,
   createWS: () => createWS,
+  createWebSocket: () => createWebSocket,
   defineConfig: () => defineConfig,
   defineErrorReporter: () => defineErrorReporter
 });
@@ -36,9 +39,6 @@ module.exports = __toCommonJS(index_exports);
 // src/helpers/config/defineConfig.ts
 var defineConfig = (config) => config;
 
-// src/helpers/trace/cloneData.ts
-var cloneData = (data) => ({ ...data });
-
 // src/helpers/trace/createMemoryTraceSink.ts
 var createMemoryTraceSink = () => {
   const items = [];
@@ -50,22 +50,9 @@ var createMemoryTraceSink = () => {
   };
 };
 
-// src/helpers/errors/slapError.ts
-var slapError = (code, message, extras = {}) => ({ code, message, ...extras });
-
 // src/helpers/errors/defineErrorReporter.ts
 var defineErrorReporter = (handlers) => typeof handlers === "function" ? handlers : handlers.report;
 
-// src/errors.ts
-var SyncAsyncError = class extends Error {
-  slapError;
-  constructor(error) {
-    super(error.message);
-    this.name = "SyncAsyncError";
-    this.slapError = error;
-  }
-};
-
 // src/helpers/ids/createId.ts
 var alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
 var idLength = 12;
@@ -105,7 +92,7 @@ var serializeError = (error) => ({
   error: error instanceof Error ? error.message : String(error)
 });
 
-// src/pubSub.ts
+// src/createPubSub.ts
 var createPubSub = (options = {}) => {
   const subscribers = /* @__PURE__ */ new Map();
   const wildcardSubscribers = /* @__PURE__ */ new Map();
@@ -203,6 +190,16 @@ var createPubSub = (options = {}) => {
 };
 var PubSub = createPubSub();
 
+// src/helpers/errors/syncAsyncError.ts
+var SyncAsyncError = class extends Error {
+  slapError;
+  constructor(error) {
+    super(error.message);
+    this.name = "SyncAsyncError";
+    this.slapError = error;
+  }
+};
+
 // src/helpers/actions/coreDelay.ts
 var coreDelay = async ({
   props,
@@ -239,10 +236,7 @@ var coreEmit = ({
 };
 
 // src/helpers/actions/coreFail.ts
-var coreFail = ({
-  props,
-  runtime
-}) => runtime.fail(String(props.reason ?? "failed"), props.data);
+var coreFail = ({ props, runtime }) => runtime.fail(String(props.reason ?? "failed"), props.data);
 
 // src/helpers/retry/getRetryDelay.ts
 var getRetryDelay = (attempt, options) => {
@@ -449,10 +443,7 @@ var corePatch = ({
 };
 
 // src/helpers/actions/coreSet.ts
-var coreSet = ({
-  props,
-  runtime
-}) => {
+var coreSet = ({ props, runtime }) => {
   const path = props.path;
   if (typeof path === "string") {
     runtime.set(path, props.value);
@@ -473,13 +464,10 @@ var coreSetData = ({
 };
 
 // src/helpers/actions/coreStop.ts
-var coreStop = ({
-  props,
-  runtime
-}) => runtime.stop(String(props.reason ?? "stopped"));
+var coreStop = ({ props, runtime }) => runtime.stop(String(props.reason ?? "stopped"));
 
-// src/registry/actions.ts
-var createActionsRegistry = () => /* @__PURE__ */ new Map([
+// src/helpers/actions/index.ts
+var BUILTIN_ACTIONS = [
   ["core.noop", coreNoop],
   ["core.stop", coreStop],
   ["core.fail", coreFail],
@@ -493,7 +481,8 @@ var createActionsRegistry = () => /* @__PURE__ */ new Map([
   ["core.emit", coreEmit],
   ["core.patch", corePatch],
   ["core.delay", coreDelay]
-]);
+];
+var BUILTIN_ACTION_NAMES = new Set(BUILTIN_ACTIONS.map(([name]) => name));
 
 // src/helpers/conditions/changedCondition.ts
 var changedCondition = (_args, current, previous) => !Object.is(current, previous);
@@ -587,8 +576,8 @@ var typeIsCondition = (_args, value, expected) => {
   return expected === "string" || expected === "number" || expected === "boolean" ? typeof value === expected : false;
 };
 
-// src/registry/conditions.ts
-var createConditionsRegistry = () => /* @__PURE__ */ new Map([
+// src/helpers/conditions/index.ts
+var BUILTIN_CONDITIONS = [
   ["eq", eqCondition],
   ["neq", neqCondition],
   ["gt", gtCondition],
@@ -605,7 +594,8 @@ var createConditionsRegistry = () => /* @__PURE__ */ new Map([
   ["typeIs", typeIsCondition],
   ["changed", changedCondition],
   ["cooldownReady", cooldownReadyCondition]
-]);
+];
+var BUILTIN_CONDITION_NAMES = new Set(BUILTIN_CONDITIONS.map(([name]) => name));
 
 // src/helpers/runner/applyResult.ts
 var applyResult = (result, state, mergeData) => {
@@ -619,6 +609,9 @@ var applyResult = (result, state, mergeData) => {
   state.events.push(...result.events);
 };
 
+// src/helpers/errors/slapError.ts
+var slapError = (code, message, extras = {}) => ({ code, message, ...extras });
+
 // src/helpers/path/resolveValue.ts
 var import_objwalk3 = require("objwalk");
 
@@ -1057,7 +1050,7 @@ var executeNext = (item, depth, state, environment) => {
   const id = typeof item === "string" ? item : item.strategy;
   if (typeof item !== "string" && item.when) {
     const runtime = createRuntime(state);
-    const condition = evaluateCondition(item.when, environment.conditionsRegistry, { ...state, runtime, strategy: id });
+    const condition = evaluateCondition(item.when, environment.registry.conditions, { ...state, runtime, strategy: id });
     if (!condition.ok) {
       return { status: "failed", error: condition.error, patches: [], events: [] };
     }
@@ -1309,6 +1302,9 @@ var normalizeActionResult = (raw) => {
   };
 };
 
+// src/helpers/trace/cloneData.ts
+var cloneData = (data) => ({ ...data });
+
 // src/helpers/runner/pushTrace.ts
 var pushTrace = (state, step, depth, strategyId, strategy, status, props, dataBefore, startedAt, reason) => {
   state.traceSink?.push({
@@ -1491,7 +1487,7 @@ var executeStrategy = (id, extraProps, depth, state, environment) => {
       events: []
     };
   }
-  const action = environment.actionsRegistry.get(strategy.fn);
+  const action = environment.registry.actions.get(strategy.fn);
   if (!action) {
     return {
       status: "failed",
@@ -1546,7 +1542,7 @@ var executeStrategy = (id, extraProps, depth, state, environment) => {
   const dataBefore = cloneData(state.data);
   const traceStep = state.stepCounter.current + 1;
   const startedAt = Date.now();
-  const condition = evaluateCondition(strategy.when, environment.conditionsRegistry, {
+  const condition = evaluateCondition(strategy.when, environment.registry.conditions, {
     ...state,
     runtime,
     strategy: id
@@ -1860,7 +1856,12 @@ var validateCondition = (expression, strategy, path, conditionsRegistry, errors)
   const [operator, ...args] = expression;
   if (operator === "guard") {
     if (args.length !== 1 || typeof args[0] !== "string") {
-      errors.push({ code: "CONDITION_INVALID", message: "Guard reference must be a single string name", strategy, path });
+      errors.push({
+        code: "CONDITION_INVALID",
+        message: "Guard reference must be a single string name",
+        strategy,
+        path
+      });
     }
     return;
   }
@@ -1913,7 +1914,9 @@ var validateNextList = (config, list, path, strategy, conditionsRegistry, errors
 var isGuardRef = (expression) => Array.isArray(expression) && expression.length === 2 && expression[0] === "guard" && typeof expression[1] === "string";
 var resolveRef = (config, name, visiting, path) => {
   if (visiting.includes(name)) {
-    return { issue: { code: "GUARD_CYCLE", message: `Guard "${name}" is part of a reference cycle`, guard: name, path } };
+    return {
+      issue: { code: "GUARD_CYCLE", message: `Guard "${name}" is part of a reference cycle`, guard: name, path }
+    };
   }
   const guard = config.guards?.[name];
   if (guard === void 0) {
@@ -2136,10 +2139,10 @@ var createRunCancellation = (source) => {
   };
 };
 
-// src/helpers/runner/createRunner.ts
+// src/createRunner.ts
 var createRunner = (options = {}) => {
-  const actionsRegistry = createActionsRegistry();
-  const conditionsRegistry = createConditionsRegistry();
+  const actionsRegistry = new Map(BUILTIN_ACTIONS);
+  const conditionsRegistry = new Map(BUILTIN_CONDITIONS);
   const configRef = {};
   const timeout = options.timeout ?? options.timeoutMs;
   const runnerOptions = timeout === void 0 ? options : { ...options, timeout };
@@ -2149,19 +2152,24 @@ var createRunner = (options = {}) => {
     console.warn("timeoutMs is deprecated; use timeout. It will be removed in a future major release.");
   }
   const environment = {
-    actionsRegistry,
-    conditionsRegistry,
+    registry: { actions: actionsRegistry, conditions: conditionsRegistry },
     configRef,
     options: runnerOptions,
     mergeData
   };
   const registerAction = (name, action) => {
+    if (BUILTIN_ACTION_NAMES.has(name)) {
+      throw new Error(`Cannot override built-in action "${name}"`);
+    }
     actionsRegistry.set(name, action);
   };
   const registerActions = (items) => {
     Object.entries(items).forEach(([name, action]) => registerAction(name, action));
   };
   const registerCondition = (name, condition) => {
+    if (BUILTIN_CONDITION_NAMES.has(name)) {
+      throw new Error(`Cannot override built-in condition "${name}"`);
+    }
     conditionsRegistry.set(name, condition);
   };
   const registerConditions = (items) => {
@@ -2258,7 +2266,7 @@ var parseDomBinding = (binding, prefix) => {
   return separator <= 0 || separator === source.length - 1 ? void 0 : { selector: source.slice(0, separator), eventType: source.slice(separator + 1) };
 };
 
-// src/flow.ts
+// src/createFlow.ts
 var busBindingPrefix = "[bus] ";
 var domBindingPrefix = "[dom] ";
 var defaultMaxQueueSize = 50;
@@ -2499,10 +2507,11 @@ var createFlow = (definition, options) => {
   return { runner, start, stop };
 };
 
-// src/ws.ts
+// src/createWS.ts
 var openState = 1;
 var maxSeenEvents = 1e3;
 var createWS = (options) => {
+  console.warn("[slapflow] createWS is deprecated and will be removed soon. Use createWebSocket instead.");
   const inboundTopics = new Set(options.inboundTopics ?? []);
   const outboundTopics = new Set(options.outboundTopics ?? []);
   const seenEventIds = /* @__PURE__ */ new Set();
@@ -2666,7 +2675,117 @@ var createWS = (options) => {
   return { start, stop, reconnect, status: () => currentStatus };
 };
 
-// src/catchError.ts
+// src/createWebSocket.ts
+var createWebSocket = (options) => {
+  let socket;
+  let retryTimer;
+  let retryAttempt = 0;
+  let started = false;
+  let currentStatus = "idle";
+  const emitSocketEvent = (topic, payload) => {
+    options.bus.dispatch({
+      id: createId(),
+      topic,
+      occurredAt: Date.now(),
+      ...options.origin ? { origin: options.origin } : {},
+      parsed: payload,
+      serialized: JSON.stringify(payload)
+    });
+  };
+  const scheduleRetry = () => {
+    const delay = getRetryDelay(retryAttempt, options.reconnect ?? {});
+    const attempt = retryAttempt + 1;
+    currentStatus = "reconnecting";
+    retryAttempt = attempt;
+    retryTimer = setTimeout(() => {
+      retryTimer = void 0;
+      connect();
+    }, delay);
+  };
+  const connect = () => {
+    if (!started || socket) {
+      return;
+    }
+    currentStatus = "connecting";
+    try {
+      const current = new WebSocket(options.url, options.protocols ?? []);
+      socket = current;
+      current.addEventListener("open", () => {
+        if (socket === current) {
+          retryAttempt = 0;
+          currentStatus = "connected";
+          emitSocketEvent("open", { url: options.url });
+        }
+      });
+      current.addEventListener("message", (event) => {
+        if (socket !== current) {
+          return;
+        }
+        let parsed = event.data;
+        if (typeof parsed === "string") {
+          try {
+            parsed = JSON.parse(parsed);
+          } catch {
+            parsed = event.data;
+          }
+        }
+        emitSocketEvent("message", parsed);
+      });
+      current.addEventListener("close", (event) => {
+        if (socket !== current) {
+          return;
+        }
+        socket = void 0;
+        emitSocketEvent("close", { code: event.code, reason: event.reason });
+        if (started) {
+          scheduleRetry();
+        }
+      });
+      current.addEventListener("error", (event) => {
+        emitSocketEvent("error", { error: event });
+      });
+    } catch (error) {
+      socket = void 0;
+      emitSocketEvent("error", { error });
+      if (started) {
+        scheduleRetry();
+      }
+    }
+  };
+  const start = () => {
+    if (!started) {
+      started = true;
+      connect();
+    }
+  };
+  const stop = () => {
+    started = false;
+    if (retryTimer) {
+      clearTimeout(retryTimer);
+    }
+    retryTimer = void 0;
+    const current = socket;
+    socket = void 0;
+    current?.close();
+    currentStatus = "stopped";
+  };
+  const reconnect = () => {
+    if (!started) {
+      return;
+    }
+    if (retryTimer) {
+      clearTimeout(retryTimer);
+      retryTimer = void 0;
+    }
+    const current = socket;
+    socket = void 0;
+    current?.close();
+    connect();
+  };
+  return { start, stop, reconnect, status: () => currentStatus };
+};
+
+// src/helpers/catchError.ts
 var catchError = (callback) => new Promise((resolve, reject) => {
   try {
     resolve(callback());
@@ -2676,14 +2795,17 @@ var catchError = (callback) => new Promise((resolve, reject) => {
 });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BUILTIN_ACTIONS,
+  BUILTIN_ACTION_NAMES,
+  BUILTIN_CONDITIONS,
+  BUILTIN_CONDITION_NAMES,
   PubSub,
   catchError,
-  createActionsRegistry,
-  createConditionsRegistry,
   createFlow,
   createMemoryTraceSink,
   createPubSub,
   createWS,
+  createWebSocket,
   defineConfig,
   defineErrorReporter
 });

package/dist/index.d.cts

@@ -148,6 +148,21 @@ type WS = {
     reconnect(): void;
     status(): WSStatus;
 };
+type SocketEventTopic = 'open' | 'message' | 'close' | 'error';
+type WebSocketOptions<TEvents extends object = EventMap> = {
+    url: string;
+    bus: Bus<TEvents>;
+    origin?: string;
+    protocols?: string | string[];
+    reconnect?: RetryOptions;
+};
+type WebSocketStatus = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'stopped';
+type WSClient = {
+    start(): void;
+    stop(): void;
+    reconnect(): void;
+    status(): WebSocketStatus;
+};
 type BindingEventMap = Record<string, Input>;
 type BusBindingKey<TEvents extends object> = {
     [TEvent in EventName<TEvents>]: TEvents[TEvent] extends Input ? `[bus] ${TEvent}` : never;
@@ -374,14 +389,21 @@ declare const PubSub: Bus<EventMap>;
 
 declare const createFlow: <TContext, TPatch = unknown, TEvents extends object = BindingEventMap>(definition: FlowDefinition<TContext, TPatch, TEvents>, options: FlowOptions<TContext, TPatch, TEvents>) => Flow<TContext, TPatch>;
 
+/**
+ * @deprecated Use `createWebSocket` instead. This adapter will be removed in a future release.
+ */
 declare const createWS: <TEvents extends object = EventMap>(options: WSOptions<TEvents>) => WS;
 
+declare const createWebSocket: <TEvents extends object = EventMap>(options: WebSocketOptions<TEvents>) => WSClient;
+
 declare const catchError: <T>(callback: () => T | PromiseLike<T>) => Promise<T>;
 
 type ActionsRegistry<TContext, TPatch> = Map<string, Action<TContext, TPatch>>;
-declare const createActionsRegistry: <TContext, TPatch>() => ActionsRegistry<TContext, TPatch>;
+declare const BUILTIN_ACTIONS: readonly [name: string, action: Action<unknown, unknown>][];
+declare const BUILTIN_ACTION_NAMES: Set<string>;
 
 type ConditionsRegistry<TContext> = Map<string, ConditionFn<TContext>>;
-declare const createConditionsRegistry: <TContext>() => ConditionsRegistry<TContext>;
+declare const BUILTIN_CONDITIONS: readonly [name: string, condition: ConditionFn<unknown>][];
+declare const BUILTIN_CONDITION_NAMES: Set<string>;
 
-export { type Action, type ActionArgs, type ActionFail, type ActionResult, type ActionSkip, type ActionStop, type ActionSuccess, type ActionsRegistry, type BindingEventMap, type Bus, type BusBinding, type BusBindingKey, type BusBindings, type BusEmitOptions, type BusErrorEvent, type BusEvent, type BusOptions, type ConcurrencyMode, type ConcurrencyOptions, type ConditionExpression, type ConditionFn, type ConditionsRegistry, type Config, type DomBinding, type DomBindingKey, type DomBindings, type DomForm, type DomInput, type ErrorReporter, type ErrorReporterHandlers, type ErrorStage, type EventHandler, type EventMap, type EventName, type EventPattern, type ExpressionOperator, type FetchResponseType, type Flow, type FlowDefinition, type FlowOptions, type InactiveBinding, type Input, type Mode, type Next, type Props, PubSub, type QueueOverflow, type RetryOptions, type RunOptions, type RunResult, type Runner, type RunnerErrorEvent, type RunnerOptions, type Runtime, type SlapError, type SlapErrorEvent, type SlapEvent, type StartResult, type Strategy, type TraceEntry, type TraceSink, type ValidationIssue, type ValidationResult, type VariableValue, type Variables, type WS, type WSOptions, type WSRetryOptions, type WSSocket, type WSStatus, catchError, createActionsRegistry, createConditionsRegistry, createFlow, createMemoryTraceSink, createPubSub, createWS, defineConfig, defineErrorReporter };
+export { type Action, type ActionArgs, type ActionFail, type ActionResult, type ActionSkip, type ActionStop, type ActionSuccess, type ActionsRegistry, BUILTIN_ACTIONS, BUILTIN_ACTION_NAMES, BUILTIN_CONDITIONS, BUILTIN_CONDITION_NAMES, type BindingEventMap, type Bus, type BusBinding, type BusBindingKey, type BusBindings, type BusEmitOptions, type BusErrorEvent, type BusEvent, type BusOptions, type ConcurrencyMode, type ConcurrencyOptions, type ConditionExpression, type ConditionFn, type ConditionsRegistry, type Config, type DomBinding, type DomBindingKey, type DomBindings, type DomForm, type DomInput, type ErrorReporter, type ErrorReporterHandlers, type ErrorStage, type EventHandler, type EventMap, type EventName, type EventPattern, type ExpressionOperator, type FetchResponseType, type Flow, type FlowDefinition, type FlowOptions, type InactiveBinding, type Input, type Mode, type Next, type Props, PubSub, type QueueOverflow, type RetryOptions, type RunOptions, type RunResult, type Runner, type RunnerErrorEvent, type RunnerOptions, type Runtime, type SlapError, type SlapErrorEvent, type SlapEvent, type SocketEventTopic, type StartResult, type Strategy, type TraceEntry, type TraceSink, type ValidationIssue, type ValidationResult, type VariableValue, type Variables, type WS, type WSClient, type WSOptions, type WSRetryOptions, type WSSocket, type WSStatus, type WebSocketOptions, type WebSocketStatus, catchError, createFlow, createMemoryTraceSink, createPubSub, createWS, createWebSocket, defineConfig, defineErrorReporter };

package/dist/index.d.ts

@@ -148,6 +148,21 @@ type WS = {
     reconnect(): void;
     status(): WSStatus;
 };
+type SocketEventTopic = 'open' | 'message' | 'close' | 'error';
+type WebSocketOptions<TEvents extends object = EventMap> = {
+    url: string;
+    bus: Bus<TEvents>;
+    origin?: string;
+    protocols?: string | string[];
+    reconnect?: RetryOptions;
+};
+type WebSocketStatus = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'stopped';
+type WSClient = {
+    start(): void;
+    stop(): void;
+    reconnect(): void;
+    status(): WebSocketStatus;
+};
 type BindingEventMap = Record<string, Input>;
 type BusBindingKey<TEvents extends object> = {
     [TEvent in EventName<TEvents>]: TEvents[TEvent] extends Input ? `[bus] ${TEvent}` : never;
@@ -374,14 +389,21 @@ declare const PubSub: Bus<EventMap>;
 
 declare const createFlow: <TContext, TPatch = unknown, TEvents extends object = BindingEventMap>(definition: FlowDefinition<TContext, TPatch, TEvents>, options: FlowOptions<TContext, TPatch, TEvents>) => Flow<TContext, TPatch>;
 
+/**
+ * @deprecated Use `createWebSocket` instead. This adapter will be removed in a future release.
+ */
 declare const createWS: <TEvents extends object = EventMap>(options: WSOptions<TEvents>) => WS;
 
+declare const createWebSocket: <TEvents extends object = EventMap>(options: WebSocketOptions<TEvents>) => WSClient;
+
 declare const catchError: <T>(callback: () => T | PromiseLike<T>) => Promise<T>;
 
 type ActionsRegistry<TContext, TPatch> = Map<string, Action<TContext, TPatch>>;
-declare const createActionsRegistry: <TContext, TPatch>() => ActionsRegistry<TContext, TPatch>;
+declare const BUILTIN_ACTIONS: readonly [name: string, action: Action<unknown, unknown>][];
+declare const BUILTIN_ACTION_NAMES: Set<string>;
 
 type ConditionsRegistry<TContext> = Map<string, ConditionFn<TContext>>;
-declare const createConditionsRegistry: <TContext>() => ConditionsRegistry<TContext>;
+declare const BUILTIN_CONDITIONS: readonly [name: string, condition: ConditionFn<unknown>][];
+declare const BUILTIN_CONDITION_NAMES: Set<string>;
 
-export { type Action, type ActionArgs, type ActionFail, type ActionResult, type ActionSkip, type ActionStop, type ActionSuccess, type ActionsRegistry, type BindingEventMap, type Bus, type BusBinding, type BusBindingKey, type BusBindings, type BusEmitOptions, type BusErrorEvent, type BusEvent, type BusOptions, type ConcurrencyMode, type ConcurrencyOptions, type ConditionExpression, type ConditionFn, type ConditionsRegistry, type Config, type DomBinding, type DomBindingKey, type DomBindings, type DomForm, type DomInput, type ErrorReporter, type ErrorReporterHandlers, type ErrorStage, type EventHandler, type EventMap, type EventName, type EventPattern, type ExpressionOperator, type FetchResponseType, type Flow, type FlowDefinition, type FlowOptions, type InactiveBinding, type Input, type Mode, type Next, type Props, PubSub, type QueueOverflow, type RetryOptions, type RunOptions, type RunResult, type Runner, type RunnerErrorEvent, type RunnerOptions, type Runtime, type SlapError, type SlapErrorEvent, type SlapEvent, type StartResult, type Strategy, type TraceEntry, type TraceSink, type ValidationIssue, type ValidationResult, type VariableValue, type Variables, type WS, type WSOptions, type WSRetryOptions, type WSSocket, type WSStatus, catchError, createActionsRegistry, createConditionsRegistry, createFlow, createMemoryTraceSink, createPubSub, createWS, defineConfig, defineErrorReporter };
+export { type Action, type ActionArgs, type ActionFail, type ActionResult, type ActionSkip, type ActionStop, type ActionSuccess, type ActionsRegistry, BUILTIN_ACTIONS, BUILTIN_ACTION_NAMES, BUILTIN_CONDITIONS, BUILTIN_CONDITION_NAMES, type BindingEventMap, type Bus, type BusBinding, type BusBindingKey, type BusBindings, type BusEmitOptions, type BusErrorEvent, type BusEvent, type BusOptions, type ConcurrencyMode, type ConcurrencyOptions, type ConditionExpression, type ConditionFn, type ConditionsRegistry, type Config, type DomBinding, type DomBindingKey, type DomBindings, type DomForm, type DomInput, type ErrorReporter, type ErrorReporterHandlers, type ErrorStage, type EventHandler, type EventMap, type EventName, type EventPattern, type ExpressionOperator, type FetchResponseType, type Flow, type FlowDefinition, type FlowOptions, type InactiveBinding, type Input, type Mode, type Next, type Props, PubSub, type QueueOverflow, type RetryOptions, type RunOptions, type RunResult, type Runner, type RunnerErrorEvent, type RunnerOptions, type Runtime, type SlapError, type SlapErrorEvent, type SlapEvent, type SocketEventTopic, type StartResult, type Strategy, type TraceEntry, type TraceSink, type ValidationIssue, type ValidationResult, type VariableValue, type Variables, type WS, type WSClient, type WSOptions, type WSRetryOptions, type WSSocket, type WSStatus, type WebSocketOptions, type WebSocketStatus, catchError, createFlow, createMemoryTraceSink, createPubSub, createWS, createWebSocket, defineConfig, defineErrorReporter };

package/dist/index.js

@@ -1,9 +1,6 @@
 // src/helpers/config/defineConfig.ts
 var defineConfig = (config) => config;
 
-// src/helpers/trace/cloneData.ts
-var cloneData = (data) => ({ ...data });
-
 // src/helpers/trace/createMemoryTraceSink.ts
 var createMemoryTraceSink = () => {
   const items = [];
@@ -15,22 +12,9 @@ var createMemoryTraceSink = () => {
   };
 };
 
-// src/helpers/errors/slapError.ts
-var slapError = (code, message, extras = {}) => ({ code, message, ...extras });
-
 // src/helpers/errors/defineErrorReporter.ts
 var defineErrorReporter = (handlers) => typeof handlers === "function" ? handlers : handlers.report;
 
-// src/errors.ts
-var SyncAsyncError = class extends Error {
-  slapError;
-  constructor(error) {
-    super(error.message);
-    this.name = "SyncAsyncError";
-    this.slapError = error;
-  }
-};
-
 // src/helpers/ids/createId.ts
 var alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
 var idLength = 12;
@@ -70,7 +54,7 @@ var serializeError = (error) => ({
   error: error instanceof Error ? error.message : String(error)
 });
 
-// src/pubSub.ts
+// src/createPubSub.ts
 var createPubSub = (options = {}) => {
   const subscribers = /* @__PURE__ */ new Map();
   const wildcardSubscribers = /* @__PURE__ */ new Map();
@@ -168,6 +152,16 @@ var createPubSub = (options = {}) => {
 };
 var PubSub = createPubSub();
 
+// src/helpers/errors/syncAsyncError.ts
+var SyncAsyncError = class extends Error {
+  slapError;
+  constructor(error) {
+    super(error.message);
+    this.name = "SyncAsyncError";
+    this.slapError = error;
+  }
+};
+
 // src/helpers/actions/coreDelay.ts
 var coreDelay = async ({
   props,
@@ -204,10 +198,7 @@ var coreEmit = ({
 };
 
 // src/helpers/actions/coreFail.ts
-var coreFail = ({
-  props,
-  runtime
-}) => runtime.fail(String(props.reason ?? "failed"), props.data);
+var coreFail = ({ props, runtime }) => runtime.fail(String(props.reason ?? "failed"), props.data);
 
 // src/helpers/retry/getRetryDelay.ts
 var getRetryDelay = (attempt, options) => {
@@ -414,10 +405,7 @@ var corePatch = ({
 };
 
 // src/helpers/actions/coreSet.ts
-var coreSet = ({
-  props,
-  runtime
-}) => {
+var coreSet = ({ props, runtime }) => {
   const path = props.path;
   if (typeof path === "string") {
     runtime.set(path, props.value);
@@ -438,13 +426,10 @@ var coreSetData = ({
 };
 
 // src/helpers/actions/coreStop.ts
-var coreStop = ({
-  props,
-  runtime
-}) => runtime.stop(String(props.reason ?? "stopped"));
+var coreStop = ({ props, runtime }) => runtime.stop(String(props.reason ?? "stopped"));
 
-// src/registry/actions.ts
-var createActionsRegistry = () => /* @__PURE__ */ new Map([
+// src/helpers/actions/index.ts
+var BUILTIN_ACTIONS = [
   ["core.noop", coreNoop],
   ["core.stop", coreStop],
   ["core.fail", coreFail],
@@ -458,7 +443,8 @@ var createActionsRegistry = () => /* @__PURE__ */ new Map([
   ["core.emit", coreEmit],
   ["core.patch", corePatch],
   ["core.delay", coreDelay]
-]);
+];
+var BUILTIN_ACTION_NAMES = new Set(BUILTIN_ACTIONS.map(([name]) => name));
 
 // src/helpers/conditions/changedCondition.ts
 var changedCondition = (_args, current, previous) => !Object.is(current, previous);
@@ -552,8 +538,8 @@ var typeIsCondition = (_args, value, expected) => {
   return expected === "string" || expected === "number" || expected === "boolean" ? typeof value === expected : false;
 };
 
-// src/registry/conditions.ts
-var createConditionsRegistry = () => /* @__PURE__ */ new Map([
+// src/helpers/conditions/index.ts
+var BUILTIN_CONDITIONS = [
   ["eq", eqCondition],
   ["neq", neqCondition],
   ["gt", gtCondition],
@@ -570,7 +556,8 @@ var createConditionsRegistry = () => /* @__PURE__ */ new Map([
   ["typeIs", typeIsCondition],
   ["changed", changedCondition],
   ["cooldownReady", cooldownReadyCondition]
-]);
+];
+var BUILTIN_CONDITION_NAMES = new Set(BUILTIN_CONDITIONS.map(([name]) => name));
 
 // src/helpers/runner/applyResult.ts
 var applyResult = (result, state, mergeData) => {
@@ -584,6 +571,9 @@ var applyResult = (result, state, mergeData) => {
   state.events.push(...result.events);
 };
 
+// src/helpers/errors/slapError.ts
+var slapError = (code, message, extras = {}) => ({ code, message, ...extras });
+
 // src/helpers/path/resolveValue.ts
 import { pick as pick3 } from "objwalk";
 
@@ -1022,7 +1012,7 @@ var executeNext = (item, depth, state, environment) => {
   const id = typeof item === "string" ? item : item.strategy;
   if (typeof item !== "string" && item.when) {
     const runtime = createRuntime(state);
-    const condition = evaluateCondition(item.when, environment.conditionsRegistry, { ...state, runtime, strategy: id });
+    const condition = evaluateCondition(item.when, environment.registry.conditions, { ...state, runtime, strategy: id });
     if (!condition.ok) {
       return { status: "failed", error: condition.error, patches: [], events: [] };
     }
@@ -1274,6 +1264,9 @@ var normalizeActionResult = (raw) => {
   };
 };
 
+// src/helpers/trace/cloneData.ts
+var cloneData = (data) => ({ ...data });
+
 // src/helpers/runner/pushTrace.ts
 var pushTrace = (state, step, depth, strategyId, strategy, status, props, dataBefore, startedAt, reason) => {
   state.traceSink?.push({
@@ -1456,7 +1449,7 @@ var executeStrategy = (id, extraProps, depth, state, environment) => {
       events: []
     };
   }
-  const action = environment.actionsRegistry.get(strategy.fn);
+  const action = environment.registry.actions.get(strategy.fn);
   if (!action) {
     return {
       status: "failed",
@@ -1511,7 +1504,7 @@ var executeStrategy = (id, extraProps, depth, state, environment) => {
   const dataBefore = cloneData(state.data);
   const traceStep = state.stepCounter.current + 1;
   const startedAt = Date.now();
-  const condition = evaluateCondition(strategy.when, environment.conditionsRegistry, {
+  const condition = evaluateCondition(strategy.when, environment.registry.conditions, {
     ...state,
     runtime,
     strategy: id
@@ -1825,7 +1818,12 @@ var validateCondition = (expression, strategy, path, conditionsRegistry, errors)
   const [operator, ...args] = expression;
   if (operator === "guard") {
     if (args.length !== 1 || typeof args[0] !== "string") {
-      errors.push({ code: "CONDITION_INVALID", message: "Guard reference must be a single string name", strategy, path });
+      errors.push({
+        code: "CONDITION_INVALID",
+        message: "Guard reference must be a single string name",
+        strategy,
+        path
+      });
     }
     return;
   }
@@ -1878,7 +1876,9 @@ var validateNextList = (config, list, path, strategy, conditionsRegistry, errors
 var isGuardRef = (expression) => Array.isArray(expression) && expression.length === 2 && expression[0] === "guard" && typeof expression[1] === "string";
 var resolveRef = (config, name, visiting, path) => {
   if (visiting.includes(name)) {
-    return { issue: { code: "GUARD_CYCLE", message: `Guard "${name}" is part of a reference cycle`, guard: name, path } };
+    return {
+      issue: { code: "GUARD_CYCLE", message: `Guard "${name}" is part of a reference cycle`, guard: name, path }
+    };
   }
   const guard = config.guards?.[name];
   if (guard === void 0) {
@@ -2101,10 +2101,10 @@ var createRunCancellation = (source) => {
   };
 };
 
-// src/helpers/runner/createRunner.ts
+// src/createRunner.ts
 var createRunner = (options = {}) => {
-  const actionsRegistry = createActionsRegistry();
-  const conditionsRegistry = createConditionsRegistry();
+  const actionsRegistry = new Map(BUILTIN_ACTIONS);
+  const conditionsRegistry = new Map(BUILTIN_CONDITIONS);
   const configRef = {};
   const timeout = options.timeout ?? options.timeoutMs;
   const runnerOptions = timeout === void 0 ? options : { ...options, timeout };
@@ -2114,19 +2114,24 @@ var createRunner = (options = {}) => {
     console.warn("timeoutMs is deprecated; use timeout. It will be removed in a future major release.");
   }
   const environment = {
-    actionsRegistry,
-    conditionsRegistry,
+    registry: { actions: actionsRegistry, conditions: conditionsRegistry },
     configRef,
     options: runnerOptions,
     mergeData
   };
   const registerAction = (name, action) => {
+    if (BUILTIN_ACTION_NAMES.has(name)) {
+      throw new Error(`Cannot override built-in action "${name}"`);
+    }
     actionsRegistry.set(name, action);
   };
   const registerActions = (items) => {
     Object.entries(items).forEach(([name, action]) => registerAction(name, action));
   };
   const registerCondition = (name, condition) => {
+    if (BUILTIN_CONDITION_NAMES.has(name)) {
+      throw new Error(`Cannot override built-in condition "${name}"`);
+    }
     conditionsRegistry.set(name, condition);
   };
   const registerConditions = (items) => {
@@ -2223,7 +2228,7 @@ var parseDomBinding = (binding, prefix) => {
   return separator <= 0 || separator === source.length - 1 ? void 0 : { selector: source.slice(0, separator), eventType: source.slice(separator + 1) };
 };
 
-// src/flow.ts
+// src/createFlow.ts
 var busBindingPrefix = "[bus] ";
 var domBindingPrefix = "[dom] ";
 var defaultMaxQueueSize = 50;
@@ -2464,10 +2469,11 @@ var createFlow = (definition, options) => {
   return { runner, start, stop };
 };
 
-// src/ws.ts
+// src/createWS.ts
 var openState = 1;
 var maxSeenEvents = 1e3;
 var createWS = (options) => {
+  console.warn("[slapflow] createWS is deprecated and will be removed soon. Use createWebSocket instead.");
   const inboundTopics = new Set(options.inboundTopics ?? []);
   const outboundTopics = new Set(options.outboundTopics ?? []);
   const seenEventIds = /* @__PURE__ */ new Set();
@@ -2631,7 +2637,117 @@ var createWS = (options) => {
   return { start, stop, reconnect, status: () => currentStatus };
 };
 
-// src/catchError.ts
+// src/createWebSocket.ts
+var createWebSocket = (options) => {
+  let socket;
+  let retryTimer;
+  let retryAttempt = 0;
+  let started = false;
+  let currentStatus = "idle";
+  const emitSocketEvent = (topic, payload) => {
+    options.bus.dispatch({
+      id: createId(),
+      topic,
+      occurredAt: Date.now(),
+      ...options.origin ? { origin: options.origin } : {},
+      parsed: payload,
+      serialized: JSON.stringify(payload)
+    });
+  };
+  const scheduleRetry = () => {
+    const delay = getRetryDelay(retryAttempt, options.reconnect ?? {});
+    const attempt = retryAttempt + 1;
+    currentStatus = "reconnecting";
+    retryAttempt = attempt;
+    retryTimer = setTimeout(() => {
+      retryTimer = void 0;
+      connect();
+    }, delay);
+  };
+  const connect = () => {
+    if (!started || socket) {
+      return;
+    }
+    currentStatus = "connecting";
+    try {
+      const current = new WebSocket(options.url, options.protocols ?? []);
+      socket = current;
+      current.addEventListener("open", () => {
+        if (socket === current) {
+          retryAttempt = 0;
+          currentStatus = "connected";
+          emitSocketEvent("open", { url: options.url });
+        }
+      });
+      current.addEventListener("message", (event) => {
+        if (socket !== current) {
+          return;
+        }
+        let parsed = event.data;
+        if (typeof parsed === "string") {
+          try {
+            parsed = JSON.parse(parsed);
+          } catch {
+            parsed = event.data;
+          }
+        }
+        emitSocketEvent("message", parsed);
+      });
+      current.addEventListener("close", (event) => {
+        if (socket !== current) {
+          return;
+        }
+        socket = void 0;
+        emitSocketEvent("close", { code: event.code, reason: event.reason });
+        if (started) {
+          scheduleRetry();
+        }
+      });
+      current.addEventListener("error", (event) => {
+        emitSocketEvent("error", { error: event });
+      });
+    } catch (error) {
+      socket = void 0;
+      emitSocketEvent("error", { error });
+      if (started) {
+        scheduleRetry();
+      }
+    }
+  };
+  const start = () => {
+    if (!started) {
+      started = true;
+      connect();
+    }
+  };
+  const stop = () => {
+    started = false;
+    if (retryTimer) {
+      clearTimeout(retryTimer);
+    }
+    retryTimer = void 0;
+    const current = socket;
+    socket = void 0;
+    current?.close();
+    currentStatus = "stopped";
+  };
+  const reconnect = () => {
+    if (!started) {
+      return;
+    }
+    if (retryTimer) {
+      clearTimeout(retryTimer);
+      retryTimer = void 0;
+    }
+    const current = socket;
+    socket = void 0;
+    current?.close();
+    connect();
+  };
+  return { start, stop, reconnect, status: () => currentStatus };
+};
+
+// src/helpers/catchError.ts
 var catchError = (callback) => new Promise((resolve, reject) => {
   try {
     resolve(callback());
@@ -2640,14 +2756,17 @@ var catchError = (callback) => new Promise((resolve, reject) => {
   }
 });
 export {
+  BUILTIN_ACTIONS,
+  BUILTIN_ACTION_NAMES,
+  BUILTIN_CONDITIONS,
+  BUILTIN_CONDITION_NAMES,
   PubSub,
   catchError,
-  createActionsRegistry,
-  createConditionsRegistry,
   createFlow,
   createMemoryTraceSink,
   createPubSub,
   createWS,
+  createWebSocket,
   defineConfig,
   defineErrorReporter
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "slapflow",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Chain actions behavior runtime",
   "license": "ISC",
   "author": "Sergey Khalilov",
@@ -57,7 +57,9 @@
     "test": "npm run typecheck && vitest run",
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",
     "pack:check": "npm pack --dry-run",
-    "prepublishOnly": "npm test && npm run build"
+    "prepublishOnly": "npm test && npm run build",
+    "format": "prettier --write .",
+    "check": "prettier --check ."
   },
   "devDependencies": {
     "@types/node": "^26.1.0",