@artstesh/postboy 3.5.0 → 3.5.2

package/AI_SKILL.md

@@ -0,0 +1,229 @@
+# AI_SKILL.md — @artstesh/postboy v3.5 (Context Document for AI Agents)
+
+> Source of truth: `src/index.ts` + `src/**/*.ts` of this repository. This document targets **consumers** of the library (code written against `@artstesh/postboy`), not contributors.
+
+## 1. 🚀 SCOPE & IMPORTS
+
+`@artstesh/postboy` is a framework-agnostic, strongly-typed message bus for TypeScript. Use it for decoupled pub/sub (`fire`/`sub`), synchronous command execution (`exec`), async request/response (`fireCallback`), a staged middleware pipeline with cancellation, and namespaced feature registrators with lifecycle (`up`/`down`). Sole runtime dependency: `rxjs` >= 7 (peer dependency).
+
+Package entry (dual-format build since 3.4, produced with `tsup`):
+
+```json
+{
+  "main": "lib/index.cjs",
+  "module": "lib/index.mjs",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.mjs",
+      "require": "./lib/index.cjs"
+    }
+  }
+}
+```
+
+```ts
+// ESM / TypeScript (named exports only — there is no default export)
+import { PostboyService, PostboyGenericMessage, PostboyCallbackMessage, PostboyExecutor } from '@artstesh/postboy';
+
+// CommonJS
+const { PostboyService } = require('@artstesh/postboy');
+```
+
+Everything below is exported from the package root: `PostboyService`, `PostboyAbstractRegistrator`, `MessageType`, `IPostboyDependingService`, `PostboyMessage`, `PostboyGenericMessage`, `PostboyCallbackMessage`, `PostboyExecutor`, `PostboyExecutionHandler`, `PostboyMiddleware`, `PostboySubscription`, `PostboyMessageMetadata`, `PostboyMessageContext`, `PostboyMiddlewareService`, `PostboyMessageStore`, `PostboyNamespaceStore`, the pipeline types (`MiddlewareStage`, `MiddlewareDecision`, `MiddlewareDecisionType`, `PipelineContext`, `PipelineResult`, `CancelDetails`, `CancelError`), and the infrastructure messages `AddMiddleware`, `RemoveMiddleware`, `AddNamespace`, `EliminateNamespace`, `ConnectMessage`, `ConnectExecutor`, `ConnectHandler`, `DisconnectMessage`, `LockMessage`, `UnlockMessage`.
+
+## 2. 🛠️ CORE API REFERENCE
+
+### PostboyService
+
+```ts
+class PostboyService {
+  constructor(resolver?: PostboyDependencyResolver) // omit in app code
+
+  // Messaging
+  fire(message: PostboyGenericMessage): void                    // throws CancelError if middleware interrupts; throws if type not registered
+  fireCallback<T>(message: PostboyCallbackMessage<T>, action?: (e: T) => void): Observable<T> // action is invoked exactly once per emitted value; without action the dispatch is lazy (see §4)
+  sub<T extends PostboyGenericMessage>(type: MessageType<T>): Observable<T>
+  once<T extends PostboyGenericMessage>(type: MessageType<T>): Observable<T>   // = sub(type).pipe(first())
+  exec<T>(executor: PostboyExecutor<T>): T                       // synchronous; throws if executor not registered or cancelled
+  dispose(): void                                                // disposes namespaces, store, middleware
+
+  // Bus mutations — @deprecated since v3; use exec(new XxxMessage(...)) equivalents below
+  record<T>(type: MessageType<T>, sub: Subject<T>): void
+  recordWithPipe<T>(type: MessageType<T>, sub: Subject<T>, pipe: (s: Subject<T>) => Observable<T>): void
+  recordExecutor<E extends PostboyExecutor<T>, T>(type: MessageType<E>, exec: (e: E) => T): void
+  recordHandler<E extends PostboyExecutor<R>, R>(executor: new (...a: any[]) => E, handler: PostboyExecutionHandler<R, E>): void
+}
+```
+
+> Removed in v3.5: `lock`, `unlock`, `addMiddleware`, `removeMiddleware`, `addNamespace`, `eliminateNamespace`, `unregister` no longer exist on `PostboyService` — the message-driven flow is the **only** way to perform these operations.
+
+### Infrastructure messages (the only way to mutate the bus)
+
+All extend `PostboyExecutor<void>`-like executors, have a static readonly `ID`, and are dispatched via `postboy.exec(...)`:
+
+| Message | Constructor | Purpose |
+|---|---|---|
+| `ConnectMessage<T>` | `(type: MessageType<T>, sub: Subject<T>, pipe?: (s: Subject<T>) => Observable<T>)` | register a message subject (replaces deprecated `record` / `recordWithPipe`) |
+| `ConnectExecutor<E, T>` | `(type: MessageType<E>, exec: (e: E) => T)` | register an executor function (replaces `recordExecutor`) |
+| `ConnectHandler<E, R>` | `(executor: new (...a: any[]) => E, handler: PostboyExecutionHandler<R, E>)` | register a handler object (replaces `recordHandler`) |
+| `DisconnectMessage` | `(messageId: string)` — the static `ID` to remove; closes subscriptions and blocks further fire/sub |
+| `AddMiddleware` / `RemoveMiddleware` | `(middleware: PostboyMiddleware)` | manage the middleware pipeline |
+| `LockMessage<T>` / `UnlockMessage<T>` | `(type: MessageType<T>)` | locked message types are silently not dispatched (registration still works) |
+| `AddNamespace` | `(space: string)` — returns the created `PostboyAbstractRegistrator` |
+| `EliminateNamespace` | `(space: string)` |
+
+### Middleware pipeline (v3.5)
+
+Middleware is an abstract class with a staged lifecycle. Every `fire` / `fireCallback` / `exec` passes through it:
+
+```ts
+enum MiddlewareStage { Publish = 1, Callback, Execute }
+enum MiddlewareDecisionType { Continue = 1, Interrupt }
+interface MiddlewareDecision { type: MiddlewareDecisionType }
+interface PipelineContext<T extends PostboyMessage = PostboyMessage> { stage: MiddlewareStage; message: T }
+
+abstract class PostboyMiddleware {
+  readonly name: string;                                  // defaults to class name
+  canHandle(context: PipelineContext): boolean            // filter by stage/message; default true
+  before(context: PipelineContext): MiddlewareDecision    // return { type: MiddlewareDecisionType.Interrupt } to CANCEL
+  after(context: PipelineContext, result?: unknown): void // post-hook; `result` set for the Execute stage
+  dispose(): void                                         // called on removal / bus dispose
+}
+
+class CancelError extends Error {                         // thrown when a middleware interrupts
+  readonly details: CancelDetails;                        // { stage, middleware, messageId, namespace?, reason? }
+  name = 'PostboyCancelError';
+}
+```
+
+Key rules:
+
+- An `Interrupt` returned from `before(...)` throws `CancelError` from `fire`/`exec`/`fireCallback` — the operation does NOT run and `after` hooks for it are not called.
+- `canHandle` is consulted for both `before` and `after`; use `context.stage` to distinguish Publish/Callback/Execute.
+- Middleware runs for infrastructure messages too — filter with `canHandle` if needed.
+- Registration/removal via `exec(new AddMiddleware(mw))` / `exec(new RemoveMiddleware(mw))`; `RemoveMiddleware` calls `mw.dispose()`.
+
+### PostboyAbstractRegistrator
+
+Groups registrations under a namespace; auto-disconnects everything on `down()`.
+
+```ts
+abstract class PostboyAbstractRegistrator {
+  constructor(postboy: PostboyService, namespace?: string | null) // null → generated id
+  get namespace(): string
+  registerServices(services: IPostboyDependingService[]): void
+  up(): void          // calls abstract protected _up(), then services' up()
+  down(): void        // calls services' down(), then exec(new DisconnectMessage(id)) for each recorded id
+  protected abstract _up(): void
+
+  // chainable (return this); NOT deprecated — internally use the v3 Connect* messages:
+  record<T>(type: MessageType<T>, sub: Subject<T>): this
+  recordWithPipe<T>(type, sub, pipe: (s: Subject<T>) => Observable<T>): this
+  recordExecutor<E extends PostboyExecutor<T>, T>(type: MessageType<E>, exec: (e: E) => T): this
+  recordHandler<E extends PostboyExecutor<R>, R>(executor: ctor, handler: PostboyExecutionHandler<R, E>): this
+  recordReplay<T>(type: MessageType<T>, bufferSize = 1): this     // ReplaySubject
+  recordBehavior<T>(type: MessageType<T>, initial: T): this      // BehaviorSubject
+  recordSubject<T>(type: MessageType<T>): this                   // plain Subject
+}
+```
+
+## 3. 📐 TYPESCRIPT TYPES
+
+```ts
+// Every message and executor MUST declare: static readonly ID = '<unique-string>';
+type MessageType<T extends PostboyGenericMessage> = new (...args: any[]) => T;
+
+abstract class PostboyMessage {
+  metadata: PostboyMessageMetadata;
+  get id(): string;                       // = constructor.ID
+  setMetadata(m: Partial<PostboyMessageMetadata>): this;
+}
+abstract class PostboyGenericMessage extends PostboyMessage {}          // base for pub/sub messages
+abstract class PostboyCallbackMessage<T> extends PostboyGenericMessage {
+  result: Observable<T>;                  // readonly observable over an internal Subject
+  next(value: T): void;                   // emit partial result
+  finish(value: T): void;                 // emit final value + complete
+  complete(): void;
+}
+abstract class PostboyExecutor<T> extends PostboyMessage {}             // base for sync commands
+abstract class PostboyExecutionHandler<R, E extends PostboyExecutor<R>> {
+  abstract handle(executor: E): R;
+}
+
+interface PostboyMessageMetadata { correlationId?: string; causationId?: string; tags?: Set<string>; [key: string]: any }
+interface PostboyMessageContext { correlationId: string; currentMessageId: string; parentMessageId?: string; depth: number; startedAt: Date; tags?: Set<string> }
+interface IPostboyDependingService { up(): void; down?(): void }
+```
+
+Note: `PostboyContextService` exists in `src/services/` (correlation-context tracking based on `node:async_hooks`) but is **not exported** from the package root — do not reference it.
+
+## 4. 💡 BEST PRACTICES & IDIOMATIC USAGE
+
+Canonical wiring order: **define class with static ID → register (registrator or ConnectMessage) → subscribe → fire/exec**.
+
+```ts
+import { PostboyService, PostboyGenericMessage, PostboyCallbackMessage, PostboyExecutor } from '@artstesh/postboy';
+import { Subject } from 'rxjs';
+
+// 1. Define messages (static ID is mandatory)
+class PingMessage extends PostboyGenericMessage { static readonly ID = 'app.ping'; constructor(public text: string) { super(); } }
+class FetchDataMessage extends PostboyCallbackMessage<string> { static readonly ID = 'app.fetch-data'; }
+class GetDataExecutor extends PostboyExecutor<string> { static readonly ID = 'app.get-data'; }
+
+const postboy = new PostboyService();
+
+// 2. Register (v3 style — via infrastructure messages)
+postboy.exec(new ConnectMessage(PingMessage, new Subject<PingMessage>()));
+postboy.exec(new ConnectExecutor(GetDataExecutor, (e) => 'some-data'));
+
+// 3. Subscribe / execute
+postboy.sub(PingMessage).subscribe((m) => console.log(m.text));
+postboy.fire(new PingMessage('hello'));
+const data: string = postboy.exec(new GetDataExecutor());   // synchronous
+
+// 4. Async request/response: the responder subscribes to the callback message and completes it
+postboy.sub(FetchDataMessage).subscribe((m) => m.finish('payload'));
+const result = await postboy.fireCallback(new FetchDataMessage()).toPromise(); // or firstValueFrom(...)
+
+// 5. Feature-scoped registrator with lifecycle
+class FeatureRegistrator extends PostboyAbstractRegistrator {
+  protected _up(): void { this.recordSubject(PingMessage); }
+}
+const reg = new FeatureRegistrator(postboy, 'feature-a');
+reg.up();     // registrations active
+reg.down();   // auto-disconnects everything recorded by this registrator
+```
+
+Rules of composition:
+
+- One registration per message ID; re-registering overwrites silently. Group a feature's registrations in one `PostboyAbstractRegistrator` subclass so `down()` cleans them all.
+- Use `recordReplay` for "latest value on subscribe" semantics and `recordBehavior` for state; use `recordWithPipe`/`ConnectMessage` with a pipe for shared/debounced streams.
+- Prefer registrators over bare `exec(new ConnectMessage(...))` in application code — they track IDs and dispose.
+- Middleware: move validation/gating to `before` (return `Interrupt` to cancel), logging/side effects to `after`. Catch `CancelError` at call sites where cancellation is expected and check `error.details` (stage, middleware, messageId, reason).
+- `fireCallback` with no `action` argument dispatches the message **lazily** — the subject fires only when the returned Observable is subscribed. Pass `action` (or subscribe immediately) when the request must be sent right away. When `action` IS passed, it is invoked exactly once per emitted value, no matter how many subscriptions the returned Observable has — do not add extra `subscribe(action)` calls on the result. `after` middleware hooks for the Callback stage fire on each result emission.
+- Error handling: `checkId` throws `"<ClassName> should have a static ID field"`; `fire` throws for unregistered message IDs; `exec` throws for unregistered executor IDs (TypeError calling undefined). Wrap `exec`/`fire` in try/catch at call sites where registration is not guaranteed; treat a locked message as a no-op, not an error.
+
+## 5. ⚠️ ANTI-PATTERNS & PITFALLS
+
+**Do NOT use these (common LLM hallucinations):**
+
+- `postboy.lock(...)` / `unlock(...)` / `addMiddleware(...)` / `removeMiddleware(...)` / `addNamespace(...)` / `eliminateNamespace(...)` / `unregister(...)` — **removed in v3.5**, they no longer exist. Generate `exec(new LockMessage/UnlockMessage/AddMiddleware/RemoveMiddleware/AddNamespace/EliminateNamespace/DisconnectMessage(...))` instead.
+- `postboy.record(...)`, `recordExecutor`, `recordHandler` — still present but `@deprecated`; generate `exec(new ConnectMessage/ConnectExecutor/ConnectHandler(...))` instead. (Exception: the chainable `record*` methods on `PostboyAbstractRegistrator` are NOT deprecated — use those.)
+- Old single-hook middleware (`interface PostboyMiddleware { handle(message) }`) — replaced in v3.5 by the abstract class with `canHandle`/`before`/`after`/`dispose` and stage-based `PipelineContext`. There is no `handle()` anymore.
+- `PostboyContextService` — not exported from the package root (and it depends on `node:async_hooks`, server-only). Do not import or emulate it.
+- `postboy.subscribe(...)` / `postboy.on(...)` / `postboy.emit(...)` — do not exist. The verbs are `sub`, `once`, `fire`, `fireCallback`, `exec`.
+- `new PostboyService(someConfig)` — the optional constructor arg is a `PostboyDependencyResolver`, not settings. Construct with no arguments.
+- `PostboyMessage` without a static `ID` — `checkId` throws. `ID` must be `static readonly` on the class itself (inheriting a parent's `ID` causes ID collisions and cross-talk).
+- Mocking helper assumptions: `postboy.sub(type)` returns `Observable<T>` (not a `Subject`). Do not call `.next()` on it.
+- `isCancelError(...)` exists in sources but is not exported from the package root — use `error.name === 'PostboyCancelError'` or `error instanceof CancelError`.
+
+**Hard constraints:**
+
+- Never `fire`/`sub` a message before it is registered (throws / cold no-op respectively). Register in `up()` / module init, subscribe after.
+- Never fire `LockMessage`/`DisconnectMessage` for infrastructure IDs you don't own — locked messages are silently dropped, which looks like data loss.
+- Never reuse the same `ID` string across two message classes; all routing is keyed by static `ID`, not class identity.
+- Never fire a callback message's `result` from outside: the responder calls `message.next/finish` in its `sub` handler; calling `fireCallback` again with the same instance re-subscribes `action`.
+- Do not forget `registrator.down()` / `postboy.dispose()` on teardown — Subjects are not auto-completed otherwise. `dispose()` also calls `dispose()` on every registered middleware.
+- `exec` is synchronous and returns `T` directly — do not `await` it or treat its result as an `Observable`. For async results use `PostboyCallbackMessage` + `fireCallback`.

package/README.md

@@ -14,6 +14,8 @@ Modern web development often feels like a survival race: components are scattere
 
 Postboy doesn’t aim to replace NgRx or Akita—it solves a narrower set of problems but does so with minimal entry barriers.
 
+> **Note for AI-assisted development:** the package ships with an `AI_SKILL.md` file (also available in the repository root) — a compact, up-to-date reference of the library's API, idiomatic usage patterns, and common pitfalls, written specifically for AI coding agents. If you use an AI assistant to work with `@artstesh/postboy`, feed it this file as context.
+
 ---
 
 ## 1.2. Core Concepts

package/lib/index.cjs

@@ -1,2 +1,2 @@
-'use strict';var rxjs=require('rxjs');var d=class{constructor(){this.metadata={};}get id(){return this.constructor.ID}setMetadata(e){return this.metadata={...this.metadata,...e},this}};var P=class extends d{};function i(o){if(!o.ID)throw new Error(`${o.name} should have a static ID field`);return o.ID}var l=class{constructor(e,t){this.subscription=e;this._subscription=t?t(e):e.asObservable();}sub(){return this._subscription}fire(e){this.subscription.next(e);}finish(){this.subscription.complete();}};var M=(r=>(r[r.Publish=1]="Publish",r[r.Callback=2]="Callback",r[r.Execute=3]="Execute",r))(M||{});var j=(t=>(t[t.Continue=1]="Continue",t[t.Interrupt=2]="Interrupt",t))(j||{});var T=class extends Error{constructor(e){super(e.reason??`Postboy operation was cancelled at stage "${M[e.stage]}"`),this.name="PostboyCancelError",this.details=e;}};var E=class{constructor(){this.middlewares=[];}addMiddleware(e){this.middlewares.push(e);}removeMiddleware(e){this.middlewares=this.middlewares.filter(t=>t!==e?true:(t.dispose(),false));}dispose(){this.middlewares.forEach(e=>e.dispose()),this.middlewares=[];}before(e,t){for(let r of this.middlewares){let a=this.buildContext(e,t);r.canHandle(a)&&r.before(a).type===2&&this.throwIfCancelled(e,r.name,t.id);}}after(e,t,r){for(let a of this.middlewares){let g=this.buildContext(e,t);a.canHandle(g)&&a.after(g,r);}}beforePublish(e){this.before(1,e);}afterPublish(e){this.after(1,e);}beforeCallback(e){this.before(2,e);}afterCallback(e,t){this.after(2,e,t);}beforeExecute(e){this.before(3,e);}afterExecute(e,t){this.after(3,e,t);}buildContext(e,t){return {stage:e,message:t}}throwIfCancelled(e,t,r,a){throw new T({stage:e,middleware:t,messageId:r,namespace:a,reason:t?`Cancelled by middleware "${t}"`:void 0})}};var w=class{constructor(){this.messages=new Map;this.executors=new Map;this.callbacks=new Map;}registerMessage(e,t){this.messages.has(e)&&console.warn(`Message with id ${e} already registered. Overriding...`),this.messages.set(e,t);}registerExecutor(e,t){this.executors.has(e)&&console.warn(`Executor with id ${e} already registered. Overriding...`),this.executors.set(e,t);}callbackFired(e){let t=this.callbacks.get(e.id);t?t.push(()=>e.complete()):this.callbacks.set(e.id,[()=>e.complete()]);}getMessage(e,t){let r=this.messages.get(e);if(!r)throw new Error(`There is no registered event ${t}`);return r}getExecutor(e){let t=this.executors.get(e);if(!t)throw new Error(`There is no registered executor with id ${e}`);return t}unregister(e){this.messages.get(e)?.finish(),this.messages.delete(e),this.callbacks.get(e)?.forEach(t=>t()),this.callbacks.delete(e),this.executors.delete(e);}dispose(){this.messages.forEach((e,t)=>this.unregister(t)),this.callbacks.forEach(e=>e.forEach(t=>t())),this.messages.clear(),this.executors.clear(),this.callbacks.clear();}};var C=class C{static get(){let e=[];for(let t=0;t<7;t++)e.push(C.collection.sort(()=>.5-Math.random()).slice(0,5).join(""));return e.join("-")}};C.collection="ABCDEFGHIJKLMNOPQRSTUVWXTZ0123456789".split("");var S=C;var s=class extends d{};var c=class extends s{constructor(t,r,a){super();this.type=t;this.sub=r;this.pipe=a;}};c.ID="aa03a192-bdc7-402d-9f2f-bf3748229ea2";var n=class extends s{constructor(t){super();this.messageId=t;}};n.ID="94579e43-5bc9-4517-bcda-b595bcda1ae7";var p=class extends s{constructor(t,r){super();this.type=t;this.exec=r;}};p.ID="cb80e8ad-b68c-4b2d-8c44-617ea6017cb3";var b=class extends s{constructor(t,r){super();this.executor=t;this.handler=r;}};b.ID="bf618cea-6f32-417c-9548-8eafe937378b";var D=class{constructor(e,t=null){this.postboy=e;this.ids=[];this.services=[];this._namespace=t??S.get();}get namespace(){return this._namespace}registerServices(e){this.services=e;}up(){this._up?.(),this.services.forEach(e=>e.up());}down(){this.services.forEach(e=>!!e.down&&e.down()),this.services=[],this.ids.forEach(e=>this.postboy.exec(new n(e)));}record(e,t){return this.ids.push(i(e)),this.postboy.exec(new c(e,t)),this}recordWithPipe(e,t,r){return this.ids.push(i(e)),this.postboy.exec(new c(e,t,r)),this}recordExecutor(e,t){return this.ids.push(i(e)),this.postboy.exec(new p(e,t)),this}recordHandler(e,t){return this.ids.push(i(e)),this.postboy.exec(new b(e,t)),this}recordReplay(e,t=1){return this.record(e,new rxjs.ReplaySubject(t)),this}recordBehavior(e,t){return this.record(e,new rxjs.BehaviorSubject(t)),this}recordSubject(e){return this.record(e,new rxjs.Subject),this}};var I=class extends D{constructor(e){super(e);}_up(){}};var v=class{constructor(){this.spaces=new Map;}addSpace(e,t){if(this.spaces.has(e))return this.spaces.get(e);let r=new I(t);return this.spaces.set(e,r),r}eliminateSpace(e){this.spaces.has(e)&&(this.spaces.get(e)?.down(),this.spaces.delete(e));}dispose(){this.spaces.forEach(e=>e.down()),this.spaces.clear();}};var R=class{constructor(){this.getMiddlewareService=()=>new E;this.getMessageStore=()=>new w;this.getNamespaceStore=()=>new v;}};var u=class extends s{constructor(t){super();this.space=t;}};u.ID="6d1a6f7d-6b6e-4c4d-8af8-9cc9a32e850c";var m=class extends s{constructor(t){super();this.space=t;}};m.ID="03bb03bb-53e0-4b74-9aad-64d5c54a8972";var f=class extends s{constructor(t){super();this.middleware=t;}};f.ID="0a8cfe0a-6193-4082-8440-d0793367b21d";var x=class extends s{constructor(t){super();this.middleware=t;}};x.ID="c25c708c-53c9-498d-a28b-936fbaf68b91";var y=class extends s{constructor(t){super();this.type=t;}};y.ID="477df3e2-1f99-4476-9a3b-afd1fa426436";var h=class extends s{constructor(t){super();this.type=t;}};h.ID="d71d25e3-90ac-4009-b972-9e6c6b05611e";var H=class{constructor(e){this.locked=new Set;this.dependencyResolver=e||new R,this.middleware=this.dependencyResolver.getMiddlewareService(),this.store=this.dependencyResolver.getMessageStore(),this.namespaceStore=this.dependencyResolver.getNamespaceStore(),this.registerInfrastructureMessages();}registerInfrastructureMessages(){this.store.registerExecutor(n.ID,e=>this.store.unregister(e.messageId)),this.store.registerExecutor(h.ID,e=>this.locked.delete(i(e.type))),this.store.registerExecutor(y.ID,e=>this.locked.add(i(e.type))),this.store.registerExecutor(f.ID,e=>this.middleware.addMiddleware(e.middleware)),this.store.registerExecutor(x.ID,e=>this.middleware.removeMiddleware(e.middleware)),this.store.registerExecutor(u.ID,e=>this.namespaceStore.addSpace(e.space,this)),this.store.registerExecutor(m.ID,e=>this.namespaceStore.eliminateSpace(e.space)),this.store.registerExecutor(c.ID,e=>{let{type:t,sub:r,pipe:a}=e;this.store.registerMessage(i(t),new l(r,a));}),this.store.registerExecutor(p.ID,e=>{let{type:t,exec:r}=e;this.store.registerExecutor(i(t),r);}),this.store.registerExecutor(b.ID,e=>{let{executor:t,handler:r}=e;this.store.registerExecutor(i(t),a=>r.handle(a));});}fire(e){this.middleware.beforePublish(e),this.locked.has(e.id)||this.store.getMessage(e.id,e.constructor.name).fire(e),this.middleware.afterPublish(e);}fireCallback(e,t){this.middleware.beforeCallback(e),t&&e.result.subscribe(t),this.store.callbackFired(e);let r=t?e.result.pipe(rxjs.tap(t)):e.result,a=this.store.getMessage(e.id,e.constructor.name),g=new rxjs.Observable($=>{let _=r.pipe(rxjs.tap(()=>this.middleware.afterCallback(e))).subscribe($);return this.locked.has(e.id)||a.fire(e),()=>_.unsubscribe()});return t&&g.subscribe(),g}exec(e){this.middleware.beforeExecute(e);let t=this.store.getExecutor(e.id)(e);return this.middleware.afterExecute(e,t),t}sub(e){return this.store.getMessage(i(e),e.name).sub()}once(e){return this.sub(e).pipe(rxjs.first())}record(e,t){this.store.registerMessage(i(e),new l(t,r=>r.asObservable()));}recordWithPipe(e,t,r){this.store.registerMessage(i(e),new l(t,r));}recordExecutor(e,t){this.store.registerExecutor(i(e),t);}recordHandler(e,t){this.store.registerExecutor(i(e),r=>t.handle(r));}dispose(){this.namespaceStore?.dispose(),this.store.dispose(),this.middleware.dispose();}};var A=class{constructor(e){this.name=e??this.constructor.name;}canHandle(e){return  true}before(e){return {type:1}}after(e,t){}dispose(){}};var k=class extends P{constructor(){super(...arguments);this.result$=new rxjs.Subject;this.result=this.result$.asObservable();this.next=t=>this.result$.next(t);}finish(t){this.result$.next(t),this.result$.complete();}complete(){this.result$.complete();}};var O=class{};exports.AddMiddleware=f;exports.AddNamespace=u;exports.CancelError=T;exports.ConnectExecutor=p;exports.ConnectHandler=b;exports.ConnectMessage=c;exports.DisconnectMessage=n;exports.EliminateNamespace=m;exports.LockMessage=y;exports.MiddlewareDecisionType=j;exports.MiddlewareStage=M;exports.PostboyAbstractRegistrator=D;exports.PostboyCallbackMessage=k;exports.PostboyExecutionHandler=O;exports.PostboyExecutor=s;exports.PostboyGenericMessage=P;exports.PostboyMessage=d;exports.PostboyMessageStore=w;exports.PostboyMiddleware=A;exports.PostboyMiddlewareService=E;exports.PostboyNamespaceStore=v;exports.PostboyService=H;exports.PostboySubscription=l;exports.RemoveMiddleware=x;exports.UnlockMessage=h;//# sourceMappingURL=index.cjs.map
+'use strict';var rxjs=require('rxjs');var d=class{constructor(){this.metadata={};}get id(){return this.constructor.ID}setMetadata(e){return this.metadata={...this.metadata,...e},this}};var g=class extends d{};function i(s){if(!s.ID)throw new Error(`${s.name} should have a static ID field`);return s.ID}var l=class{constructor(e,t){this.subscription=e;this._subscription=t?t(e):e.asObservable();}sub(){return this._subscription}fire(e){this.subscription.next(e);}finish(){this.subscription.complete();}};var M=(r=>(r[r.Publish=1]="Publish",r[r.Callback=2]="Callback",r[r.Execute=3]="Execute",r))(M||{});var j=(t=>(t[t.Continue=1]="Continue",t[t.Interrupt=2]="Interrupt",t))(j||{});var P=class extends Error{constructor(e){super(e.reason??`Postboy operation was cancelled at stage "${M[e.stage]}"`),this.name="PostboyCancelError",this.details=e;}};var E=class{constructor(){this.middlewares=[];}addMiddleware(e){this.middlewares.push(e);}removeMiddleware(e){this.middlewares=this.middlewares.filter(t=>t!==e?true:(t.dispose(),false));}dispose(){this.middlewares.forEach(e=>e.dispose()),this.middlewares=[];}before(e,t){for(let r of this.middlewares){let a=this.buildContext(e,t);r.canHandle(a)&&r.before(a).type===2&&this.throwIfCancelled(e,r.name,t.id);}}after(e,t,r){for(let a of this.middlewares){let v=this.buildContext(e,t);a.canHandle(v)&&a.after(v,r);}}beforePublish(e){this.before(1,e);}afterPublish(e){this.after(1,e);}beforeCallback(e){this.before(2,e);}afterCallback(e,t){this.after(2,e,t);}beforeExecute(e){this.before(3,e);}afterExecute(e,t){this.after(3,e,t);}buildContext(e,t){return {stage:e,message:t}}throwIfCancelled(e,t,r,a){throw new P({stage:e,middleware:t,messageId:r,namespace:a,reason:t?`Cancelled by middleware "${t}"`:void 0})}};var w=class{constructor(){this.messages=new Map;this.executors=new Map;this.callbacks=new Map;}registerMessage(e,t){this.messages.has(e)&&console.warn(`Message with id ${e} already registered. Overriding...`),this.messages.set(e,t);}registerExecutor(e,t){this.executors.has(e)&&console.warn(`Executor with id ${e} already registered. Overriding...`),this.executors.set(e,t);}callbackFired(e){let t=this.callbacks.get(e.id);t?t.push(()=>e.complete()):this.callbacks.set(e.id,[()=>e.complete()]);}getMessage(e,t){let r=this.messages.get(e);if(!r)throw new Error(`There is no registered event ${t}`);return r}getExecutor(e){let t=this.executors.get(e);if(!t)throw new Error(`There is no registered executor with id ${e}`);return t}unregister(e){this.messages.get(e)?.finish(),this.messages.delete(e),this.callbacks.get(e)?.forEach(t=>t()),this.callbacks.delete(e),this.executors.delete(e);}dispose(){this.messages.forEach((e,t)=>this.unregister(t)),this.callbacks.forEach(e=>e.forEach(t=>t())),this.messages.clear(),this.executors.clear(),this.callbacks.clear();}};var C=class C{static get(){let e=[];for(let t=0;t<7;t++)e.push(C.collection.sort(()=>.5-Math.random()).slice(0,5).join(""));return e.join("-")}};C.collection="ABCDEFGHIJKLMNOPQRSTUVWXTZ0123456789".split("");var S=C;var o=class extends d{};var c=class extends o{constructor(t,r,a){super();this.type=t;this.sub=r;this.pipe=a;}};c.ID="aa03a192-bdc7-402d-9f2f-bf3748229ea2";var n=class extends o{constructor(t){super();this.messageId=t;}};n.ID="94579e43-5bc9-4517-bcda-b595bcda1ae7";var p=class extends o{constructor(t,r){super();this.type=t;this.exec=r;}};p.ID="cb80e8ad-b68c-4b2d-8c44-617ea6017cb3";var b=class extends o{constructor(t,r){super();this.executor=t;this.handler=r;}};b.ID="bf618cea-6f32-417c-9548-8eafe937378b";var D=class{constructor(e,t=null){this.postboy=e;this.ids=[];this.services=[];this._namespace=t??S.get();}get namespace(){return this._namespace}registerServices(e){this.services=e;}up(){this._up?.(),this.services.forEach(e=>e.up());}down(){this.services.forEach(e=>!!e.down&&e.down()),this.services=[],this.ids.forEach(e=>this.postboy.exec(new n(e)));}record(e,t){return this.ids.push(i(e)),this.postboy.exec(new c(e,t)),this}recordWithPipe(e,t,r){return this.ids.push(i(e)),this.postboy.exec(new c(e,t,r)),this}recordExecutor(e,t){return this.ids.push(i(e)),this.postboy.exec(new p(e,t)),this}recordHandler(e,t){return this.ids.push(i(e)),this.postboy.exec(new b(e,t)),this}recordReplay(e,t=1){return this.record(e,new rxjs.ReplaySubject(t)),this}recordBehavior(e,t){return this.record(e,new rxjs.BehaviorSubject(t)),this}recordSubject(e){return this.record(e,new rxjs.Subject),this}};var I=class extends D{constructor(e){super(e);}_up(){}};var T=class{constructor(){this.spaces=new Map;}addSpace(e,t){if(this.spaces.has(e))return this.spaces.get(e);let r=new I(t);return this.spaces.set(e,r),r}eliminateSpace(e){this.spaces.has(e)&&(this.spaces.get(e)?.down(),this.spaces.delete(e));}dispose(){this.spaces.forEach(e=>e.down()),this.spaces.clear();}};var R=class{constructor(){this.getMiddlewareService=()=>new E;this.getMessageStore=()=>new w;this.getNamespaceStore=()=>new T;}};var u=class extends o{constructor(t){super();this.space=t;}};u.ID="6d1a6f7d-6b6e-4c4d-8af8-9cc9a32e850c";var m=class extends o{constructor(t){super();this.space=t;}};m.ID="03bb03bb-53e0-4b74-9aad-64d5c54a8972";var f=class extends o{constructor(t){super();this.middleware=t;}};f.ID="0a8cfe0a-6193-4082-8440-d0793367b21d";var x=class extends o{constructor(t){super();this.middleware=t;}};x.ID="c25c708c-53c9-498d-a28b-936fbaf68b91";var y=class extends o{constructor(t){super();this.type=t;}};y.ID="477df3e2-1f99-4476-9a3b-afd1fa426436";var h=class extends o{constructor(t){super();this.type=t;}};h.ID="d71d25e3-90ac-4009-b972-9e6c6b05611e";var G=class{constructor(e){this.locked=new Set;this.dependencyResolver=e||new R,this.middleware=this.dependencyResolver.getMiddlewareService(),this.store=this.dependencyResolver.getMessageStore(),this.namespaceStore=this.dependencyResolver.getNamespaceStore(),this.registerInfrastructureMessages();}registerInfrastructureMessages(){this.store.registerExecutor(n.ID,e=>this.store.unregister(e.messageId)),this.store.registerExecutor(h.ID,e=>this.locked.delete(i(e.type))),this.store.registerExecutor(y.ID,e=>this.locked.add(i(e.type))),this.store.registerExecutor(f.ID,e=>this.middleware.addMiddleware(e.middleware)),this.store.registerExecutor(x.ID,e=>this.middleware.removeMiddleware(e.middleware)),this.store.registerExecutor(u.ID,e=>this.namespaceStore.addSpace(e.space,this)),this.store.registerExecutor(m.ID,e=>this.namespaceStore.eliminateSpace(e.space)),this.store.registerExecutor(c.ID,e=>{let{type:t,sub:r,pipe:a}=e;this.store.registerMessage(i(t),new l(r,a));}),this.store.registerExecutor(p.ID,e=>{let{type:t,exec:r}=e;this.store.registerExecutor(i(t),r);}),this.store.registerExecutor(b.ID,e=>{let{executor:t,handler:r}=e;this.store.registerExecutor(i(t),a=>r.handle(a));});}fire(e){this.middleware.beforePublish(e),this.locked.has(e.id)||this.store.getMessage(e.id,e.constructor.name).fire(e),this.middleware.afterPublish(e);}fireCallback(e,t){this.middleware.beforeCallback(e),this.store.callbackFired(e),t&&e.result.subscribe(t);let r=this.store.getMessage(e.id,e.constructor.name),a=new rxjs.Observable(v=>{let H=e.result.pipe(rxjs.tap(()=>this.middleware.afterCallback(e))).subscribe(v);return this.locked.has(e.id)||r.fire(e),()=>H.unsubscribe()});return t&&a.subscribe(),a}exec(e){this.middleware.beforeExecute(e);let t=this.store.getExecutor(e.id)(e);return this.middleware.afterExecute(e,t),t}sub(e){return this.store.getMessage(i(e),e.name).sub()}once(e){return this.sub(e).pipe(rxjs.first())}record(e,t){this.store.registerMessage(i(e),new l(t,r=>r.asObservable()));}recordWithPipe(e,t,r){this.store.registerMessage(i(e),new l(t,r));}recordExecutor(e,t){this.store.registerExecutor(i(e),t);}recordHandler(e,t){this.store.registerExecutor(i(e),r=>t.handle(r));}dispose(){this.namespaceStore?.dispose(),this.store.dispose(),this.middleware.dispose();}};var A=class{constructor(e){this.name=e??this.constructor.name;}canHandle(e){return  true}before(e){return {type:1}}after(e,t){}dispose(){}};var k=class extends g{constructor(){super(...arguments);this.result$=new rxjs.Subject;this.result=this.result$.asObservable();this.next=t=>this.result$.next(t);}finish(t){this.result$.next(t),this.result$.complete();}complete(){this.result$.complete();}};var O=class{};exports.AddMiddleware=f;exports.AddNamespace=u;exports.CancelError=P;exports.ConnectExecutor=p;exports.ConnectHandler=b;exports.ConnectMessage=c;exports.DisconnectMessage=n;exports.EliminateNamespace=m;exports.LockMessage=y;exports.MiddlewareDecisionType=j;exports.MiddlewareStage=M;exports.PostboyAbstractRegistrator=D;exports.PostboyCallbackMessage=k;exports.PostboyExecutionHandler=O;exports.PostboyExecutor=o;exports.PostboyGenericMessage=g;exports.PostboyMessage=d;exports.PostboyMessageStore=w;exports.PostboyMiddleware=A;exports.PostboyMiddlewareService=E;exports.PostboyNamespaceStore=T;exports.PostboyService=G;exports.PostboySubscription=l;exports.RemoveMiddleware=x;exports.UnlockMessage=h;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map