@artstesh/postboy 1.4.5 → 1.5.0

package/lib/index.cjs

@@ -1,2 +1,850 @@
-'use strict';var rxjs=require('rxjs'),operators=require('rxjs/operators');var b=class{constructor(){this.metadata={};}get id(){return this.constructor.ID}setMetadata(e){return this.metadata={...this.metadata,...e},this}};var f=class extends b{};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 P=class{constructor(){this.middlewares=[];}addMiddleware(e){this.middlewares.push(e);}removeMiddleware(e){this.middlewares=this.middlewares.filter(t=>t!==e);}manage(e){for(let t of this.middlewares)t.handle(e);}dispose(){this.middlewares=[];}};var M=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 E=class E{static get(){let e=[];for(let t=0;t<7;t++)e.push(E.collection.sort(()=>.5-Math.random()).slice(0,5).join(""));return e.join("-")}};E.collection="ABCDEFGHIJKLMNOPQRSTUVWXTZ0123456789".split("");var w=E;var o=class extends b{};var a=class extends o{constructor(t,r,d){super();this.type=t;this.sub=r;this.pipe=d;}};a.ID="aa03a192-bdc7-402d-9f2f-bf3748229ea2";var c=class extends o{constructor(t){super();this.messageId=t;}};c.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 n=class extends o{constructor(t,r){super();this.executor=t;this.handler=r;}};n.ID="bf618cea-6f32-417c-9548-8eafe937378b";var v=class{constructor(e,t=null){this.postboy=e;this.ids=[];this.services=[];this._namespace=t??w.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 c(e)));}record(e,t){return this.ids.push(i(e)),this.postboy.exec(new a(e,t)),this}recordWithPipe(e,t,r){return this.ids.push(i(e)),this.postboy.exec(new a(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 n(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 S=class extends v{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 S(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 P;this.getMessageStore=()=>new M;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 y=class extends o{constructor(t){super();this.middleware=t;}};y.ID="0a8cfe0a-6193-4082-8440-d0793367b21d";var g=class extends o{constructor(t){super();this.middleware=t;}};g.ID="c25c708c-53c9-498d-a28b-936fbaf68b91";var h=class extends o{constructor(t){super();this.type=t;}};h.ID="477df3e2-1f99-4476-9a3b-afd1fa426436";var x=class extends o{constructor(t){super();this.type=t;}};x.ID="d71d25e3-90ac-4009-b972-9e6c6b05611e";var I=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(c.ID,e=>this.store.unregister(e.messageId)),this.store.registerExecutor(x.ID,e=>this.locked.delete(i(e.type))),this.store.registerExecutor(h.ID,e=>this.locked.add(i(e.type))),this.store.registerExecutor(y.ID,e=>this.middleware.addMiddleware(e.middleware)),this.store.registerExecutor(g.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(a.ID,e=>{let{type:t,sub:r,pipe:d}=e;this.store.registerMessage(i(t),new l(r,d));}),this.store.registerExecutor(p.ID,e=>{let{type:t,exec:r}=e;this.store.registerExecutor(i(t),r);}),this.store.registerExecutor(n.ID,e=>{let{executor:t,handler:r}=e;this.store.registerExecutor(i(t),d=>r.handle(d));});}lock(e){this.locked.add(i(e));}unlock(e){this.locked.delete(i(e));}addMiddleware(e){return this.middleware.addMiddleware(e)}removeMiddleware(e){return this.middleware.removeMiddleware(e)}unregister(e){return this.store.unregister(e)}fire(e){this.middleware.manage(e),this.locked.has(e.id)||this.store.getMessage(e.id,e.constructor.name).fire(e);}fireCallback(e,t){this.middleware.manage(e),this.store.callbackFired(e);let r=t?e.result.pipe(operators.tap(t)):e.result,d=new rxjs.Observable(G=>{let O=r.subscribe(G);return this.locked.has(e.id)||this.store.getMessage(e.id,e.constructor.name).fire(e),()=>O.unsubscribe()});return t&&d.subscribe(),d}exec(e){return this.middleware.manage(e),this.store.getExecutor(e.id)(e)}sub(e){return this.store.getMessage(i(e),e.name).sub()}once(e){return this.sub(e).pipe(operators.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));}addNamespace(e){return this.namespaceStore.addSpace(e,this)}eliminateNamespace(e){return this.namespaceStore?.eliminateSpace(e)}dispose(){this.namespaceStore?.dispose(),this.store.dispose(),this.middleware.dispose();}};var D=class extends f{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 k=class{};exports.AddMiddleware=y;exports.AddNamespace=u;exports.ConnectExecutor=p;exports.ConnectHandler=n;exports.ConnectMessage=a;exports.DisconnectMessage=c;exports.EliminateNamespace=m;exports.LockMessage=h;exports.PostboyAbstractRegistrator=v;exports.PostboyCallbackMessage=D;exports.PostboyExecutionHandler=k;exports.PostboyExecutor=o;exports.PostboyGenericMessage=f;exports.PostboyMessage=b;exports.PostboyMessageStore=M;exports.PostboyMiddlewareService=P;exports.PostboyNamespaceStore=T;exports.PostboyService=I;exports.PostboySubscription=l;exports.RemoveMiddleware=g;exports.UnlockMessage=x;exports.checkId=i;//# sourceMappingURL=index.cjs.map
+'use strict';
+
+var rxjs = require('rxjs');
+var operators = require('rxjs/operators');
+
+// src/postboy.service.ts
+
+// src/models/postboy.message.ts
+var PostboyMessage = class {
+  constructor() {
+    this.metadata = {};
+  }
+  get id() {
+    return this.constructor.ID;
+  }
+  setMetadata(metadata) {
+    this.metadata = { ...this.metadata, ...metadata };
+    return this;
+  }
+};
+
+// src/models/postboy-generic-message.ts
+var PostboyGenericMessage = class extends PostboyMessage {
+};
+function checkId(message) {
+  if (!message.ID) throw new Error(`${message.name} should have a static ID field`);
+  return message.ID;
+}
+
+// src/models/postboy-subscription.ts
+var PostboySubscription = class {
+  /**
+   * Constructs an instance of the class with a given subscription and a transformation pipe.
+   *
+   * @param {Subject<T>} subscription - The source Subject that will be transformed.
+   * @param {(s: Subject<T>) => Observable<T>} pipe - A function that applies a transformation to the subscription.
+   */
+  constructor(subscription, pipe2) {
+    this.subscription = subscription;
+    this._subscription = !!pipe2 ? pipe2(subscription) : subscription.asObservable();
+  }
+  /**
+   * Returns an observable subscription.
+   *
+   * @return {Observable<T>} An observable instance of type T.
+   */
+  sub() {
+    return this._subscription;
+  }
+  /**
+   * Triggers an event by emitting the provided data to all subscribers.
+   *
+   * @param {T} data - The data to emit to the subscribers.
+   * @return {void} - Does not return any value.
+   */
+  fire(data) {
+    this.subscription.next(data);
+  }
+  /**
+   * Completes the subscription, signaling that no further values will be sent.
+   * This is typically used to finalize or clean up resources.
+   * @return {void} This method does not return any value.
+   */
+  finish() {
+    this.subscription.complete();
+  }
+};
+
+// src/models/middleware-stage.enum.ts
+var MiddlewareStage = /* @__PURE__ */ ((MiddlewareStage2) => {
+  MiddlewareStage2[MiddlewareStage2["Publish"] = 1] = "Publish";
+  MiddlewareStage2[MiddlewareStage2["Callback"] = 2] = "Callback";
+  MiddlewareStage2[MiddlewareStage2["Execute"] = 3] = "Execute";
+  return MiddlewareStage2;
+})(MiddlewareStage || {});
+
+// src/models/middleware-decision.enum.ts
+var MiddlewareDecisionType = /* @__PURE__ */ ((MiddlewareDecisionType2) => {
+  MiddlewareDecisionType2[MiddlewareDecisionType2["Continue"] = 1] = "Continue";
+  MiddlewareDecisionType2[MiddlewareDecisionType2["Interrupt"] = 2] = "Interrupt";
+  return MiddlewareDecisionType2;
+})(MiddlewareDecisionType || {});
+
+// src/models/cancel-error.ts
+var CancelError = class extends Error {
+  constructor(details) {
+    super(details.reason ?? `Postboy operation was cancelled at stage "${MiddlewareStage[details.stage]}"`);
+    this.name = "PostboyCancelError";
+    this.details = details;
+  }
+};
+
+// src/services/postboy-middleware.service.ts
+var PostboyMiddlewareService = class {
+  constructor() {
+    this.middlewares = [];
+  }
+  addMiddleware(middleware) {
+    this.middlewares.push(middleware);
+  }
+  removeMiddleware(middleware) {
+    this.middlewares = this.middlewares.filter((m) => {
+      if (m !== middleware) return true;
+      m.dispose();
+      return false;
+    });
+  }
+  dispose() {
+    this.middlewares.forEach((m) => m.dispose());
+    this.middlewares = [];
+  }
+  before(stage, message) {
+    for (const middleware of this.middlewares) {
+      const context = this.buildContext(stage, message);
+      if (!middleware.canHandle(context)) continue;
+      if (middleware.before(context).type === 2 /* Interrupt */)
+        this.throwIfCancelled(stage, middleware.name, message.id);
+    }
+  }
+  after(stage, message, result) {
+    for (const middleware of this.middlewares) {
+      const context = this.buildContext(stage, message);
+      if (!middleware.canHandle(context)) continue;
+      middleware.after(context, result);
+    }
+  }
+  beforePublish(message) {
+    this.before(1 /* Publish */, message);
+  }
+  afterPublish(message) {
+    this.after(1 /* Publish */, message);
+  }
+  beforeCallback(message) {
+    this.before(2 /* Callback */, message);
+  }
+  afterCallback(message, result) {
+    this.after(2 /* Callback */, message, result);
+  }
+  beforeExecute(message) {
+    this.before(3 /* Execute */, message);
+  }
+  afterExecute(message, result) {
+    this.after(3 /* Execute */, message, result);
+  }
+  buildContext(stage, message) {
+    return { stage, message };
+  }
+  throwIfCancelled(stage, cancelledBy, messageId, namespace) {
+    throw new CancelError({
+      stage,
+      middleware: cancelledBy,
+      messageId,
+      namespace,
+      reason: cancelledBy ? `Cancelled by middleware "${cancelledBy}"` : void 0
+    });
+  }
+};
+
+// src/services/postboy-message.store.ts
+var PostboyMessageStore = class {
+  constructor() {
+    this.messages = /* @__PURE__ */ new Map();
+    this.executors = /* @__PURE__ */ new Map();
+    this.callbacks = /* @__PURE__ */ new Map();
+  }
+  registerMessage(id, sub) {
+    if (this.messages.has(id)) console.warn(`Message with id ${id} already registered. Overriding...`);
+    this.messages.set(id, sub);
+  }
+  registerExecutor(id, executor) {
+    if (this.executors.has(id)) console.warn(`Executor with id ${id} already registered. Overriding...`);
+    this.executors.set(id, executor);
+  }
+  callbackFired(message) {
+    const existingCallbacks = this.callbacks.get(message.id);
+    existingCallbacks ? existingCallbacks.push(() => message.complete()) : this.callbacks.set(message.id, [() => message.complete()]);
+  }
+  getMessage(id, name) {
+    const msg = this.messages.get(id);
+    if (!msg) throw new Error(`There is no registered event ${name}`);
+    return msg;
+  }
+  getExecutor(id) {
+    const executorFunction = this.executors.get(id);
+    if (!executorFunction) throw new Error(`There is no registered executor with id ${id}`);
+    return executorFunction;
+  }
+  unregister(id) {
+    this.messages.get(id)?.finish();
+    this.messages.delete(id);
+    this.callbacks.get(id)?.forEach((c) => c());
+    this.callbacks.delete(id);
+    this.executors.delete(id);
+  }
+  dispose() {
+    this.messages.forEach((m, id) => this.unregister(id));
+    this.callbacks.forEach((fs) => fs.forEach((f) => f()));
+    this.messages.clear();
+    this.executors.clear();
+    this.callbacks.clear();
+  }
+};
+
+// src/utils/id.generator.ts
+var _IdGenerator = class _IdGenerator {
+  static get() {
+    const result = [];
+    for (let i = 0; i < 7; i++) {
+      result.push(
+        _IdGenerator.collection.sort(() => 0.5 - Math.random()).slice(0, 5).join("")
+      );
+    }
+    return result.join("-");
+  }
+};
+_IdGenerator.collection = "ABCDEFGHIJKLMNOPQRSTUVWXTZ0123456789".split("");
+var IdGenerator = _IdGenerator;
+
+// src/models/postboy-executor.ts
+var PostboyExecutor = class extends PostboyMessage {
+};
+
+// src/messages/connect-message.executor.ts
+var ConnectMessage = class extends PostboyExecutor {
+  /**
+   * Constructs a new instance of the class.
+   *
+   * @param {MessageType<T>} type - The type of the message.
+   * @param {Subject<T>} sub - The subject to be used for message handling.
+   * @param {(s: Subject<T>) => Observable<T>} [pipe] - An optional function to transform the subject.
+   */
+  constructor(type, sub, pipe2) {
+    super();
+    this.type = type;
+    this.sub = sub;
+    this.pipe = pipe2;
+  }
+};
+ConnectMessage.ID = "aa03a192-bdc7-402d-9f2f-bf3748229ea2";
+
+// src/messages/disconnect-message.executor.ts
+var DisconnectMessage = class extends PostboyExecutor {
+  /**
+   * Creates an instance of the class with the specified message identifier.
+   *
+   * @param {string} messageId - The unique identifier for the message.
+   */
+  constructor(messageId) {
+    super();
+    this.messageId = messageId;
+  }
+};
+DisconnectMessage.ID = "94579e43-5bc9-4517-bcda-b595bcda1ae7";
+
+// src/messages/connect-executor.executor.ts
+var ConnectExecutor = class extends PostboyExecutor {
+  /**
+   * Constructs an instance of the class with the specified type and execution function.
+   *
+   * @param {MessageType<E>} type - The type of the message.
+   * @param {(e: E) => T} exec - The function to be executed with the input of type E that returns a value of type T.
+   */
+  constructor(type, exec) {
+    super();
+    this.type = type;
+    this.exec = exec;
+  }
+};
+ConnectExecutor.ID = "cb80e8ad-b68c-4b2d-8c44-617ea6017cb3";
+
+// src/messages/connect-handler.executor.ts
+var ConnectHandler = class extends PostboyExecutor {
+  /**
+   * Constructs an instance of the class.
+   *
+   * @param {new (...args: any[]) => E} executor - A constructor function for the executor object.
+   * @param {PostboyExecutionHandler<R, E>} handler - A handler that processes the execution logic.
+   */
+  constructor(executor, handler) {
+    super();
+    this.executor = executor;
+    this.handler = handler;
+  }
+};
+ConnectHandler.ID = "bf618cea-6f32-417c-9548-8eafe937378b";
+
+// src/postboy-abstract.registrator.ts
+var PostboyAbstractRegistrator = class {
+  constructor(postboy, namespace = null) {
+    this.postboy = postboy;
+    this.ids = [];
+    this.services = [];
+    this._namespace = namespace ?? IdGenerator.get();
+  }
+  get namespace() {
+    return this._namespace;
+  }
+  /**
+   * Registers a list of services to be used by the application.
+   *
+   * @param {IPostboyDependingService[]} services - An array of services to register.
+   * @return {void} This method does not return a value.
+   */
+  registerServices(services) {
+    this.services = services;
+  }
+  /**
+   * Initiates the 'up' process for the current instance and all associated services.
+   *
+   * @return {void} Does not return a value.
+   */
+  up() {
+    this._up?.();
+    this.services.forEach((s) => s.up());
+  }
+  down() {
+    this.services.forEach((s) => !!s.down && s.down());
+    this.services = [];
+    this.ids.forEach((id) => this.postboy.exec(new DisconnectMessage(id)));
+  }
+  /**
+   * Records a type and its corresponding Subject<T> into the Postboy system and updates the internal identifiers.
+   *
+   * @param {MessageType<T>} type - A constructor for the generic message type T.
+   * @param {Subject<T>} sub - The subject associated with the generic message type.
+   * @return {this} Returns the current instance for method chaining.
+   */
+  record(type, sub) {
+    this.ids.push(checkId(type));
+    this.postboy.exec(new ConnectMessage(type, sub));
+    return this;
+  }
+  /**
+   * Records a message type with a specific subject and applies a transformation pipe to the subject.
+   *
+   * @param {MessageType<T>} type - The constructor of the message type to record, which extends PostboyGenericMessage.
+   * @param {Subject<T>} sub - The Subject instance to associate with the message type.
+   * @param {(s: Subject<T>) => Observable<T>} pipe - A function that takes the subject as input and returns an Observable with transformations applied.
+   * @return {this} The current instance of the class for chaining.
+   */
+  recordWithPipe(type, sub, pipe2) {
+    this.ids.push(checkId(type));
+    this.postboy.exec(new ConnectMessage(type, sub, pipe2));
+    return this;
+  }
+  /**
+   * Records an executor associated with a specific type and execution logic.
+   *
+   * @param type The class constructor of the executor type to be recorded, which extends PostboyExecutor.
+   * @param exec A callback function that executes the logic using an instance of the specified executor type.
+   * @return void
+   */
+  recordExecutor(type, exec) {
+    this.ids.push(checkId(type));
+    this.postboy.exec(new ConnectExecutor(type, exec));
+    return this;
+  }
+  /**
+   * Records a handler for a specific executor type.
+   *
+   * @param executor The constructor of the executor type, which extends `PostboyExecutor`.
+   * @param handler The execution handler associated with the given executor type.
+   * @return void
+   */
+  recordHandler(executor, handler) {
+    this.ids.push(checkId(executor));
+    this.postboy.exec(new ConnectHandler(executor, handler));
+    return this;
+  }
+  /**
+   * A utility function that facilitates the recording and replaying of messages
+   * using a ReplaySubject. This function is designed to handle messages of a
+   * specific type and allows specifying a buffer size to determine how many
+   * of the most recent messages should be replayed.
+   *
+   * @template T Extends the PostboyGenericMessage type, representing the type of message
+   * to be recorded and replayed.
+   * @param {MessageType<T>} type The constructor of the message type to be recorded and replayed.
+   * @param {number} [bufferSize=1] The number of recent messages to retain in the ReplaySubject's buffer.
+   * Defaults to 1 if not specified.
+   * @returns The result of invoking the `record` method with the given message type and configured ReplaySubject.
+   */
+  recordReplay(type, bufferSize = 1) {
+    this.record(type, new rxjs.ReplaySubject(bufferSize));
+    return this;
+  }
+  /**
+   * Represents a method that records a specific behavior associated with a message type.
+   * It creates a `BehaviorSubject` initialized with the provided initial message
+   * and associates it with the given message type using the `record` method.
+   *
+   * @template T - A type parameter extending `PostboyGenericMessage` that defines the message structure.
+   * @param {MessageType<T>} type - The constructor function of the message type to be recorded.
+   * @param {T} initial - The initial value of the message that will be set in the `BehaviorSubject`.
+   * @returns {void} - This function does not return a value; instead, it modifies the internal state.
+   */
+  recordBehavior(type, initial) {
+    this.record(type, new rxjs.BehaviorSubject(initial));
+    return this;
+  }
+  /**
+   * A function that creates and returns a new generic message recorder for a specific message type.
+   *
+   * @template T - A type parameter extending from `PostboyGenericMessage`.
+   * @param {MessageType<T>} type - The constructor for the message type being recorded.
+   * @returns {Subject<T>} A new instance of `Subject<T>` bound to the specified message type.
+   */
+  recordSubject(type) {
+    this.record(type, new rxjs.Subject());
+    return this;
+  }
+};
+
+// src/services/namespace-registrator.ts
+var NamespaceRegistrator = class extends PostboyAbstractRegistrator {
+  constructor(postboy) {
+    super(postboy);
+  }
+  _up() {
+  }
+};
+
+// src/services/postboy-namespace.store.ts
+var PostboyNamespaceStore = class {
+  constructor() {
+    this.spaces = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Adds a new space or retrieves an existing one if it already exists.
+   *
+   * @param {string} space - The name of the space to add or retrieve.
+   * @param {PostboyService} postboy - The PostboyService instance used to create a namespace registrator.
+   * @return {PostboyAbstractRegistrator} The registrator associated with the specified space.
+   */
+  addSpace(space, postboy) {
+    if (this.spaces.has(space)) return this.spaces.get(space);
+    const registrator = new NamespaceRegistrator(postboy);
+    this.spaces.set(space, registrator);
+    return registrator;
+  }
+  /**
+   * Removes a specified space from the spaces collection if it exists.
+   * If the space exists, it will be deleted after invoking its down method.
+   *
+   * @param {string} space - The name of the space to be removed.
+   * @return {void} This method does not return a value.
+   */
+  eliminateSpace(space) {
+    if (!this.spaces.has(space)) return;
+    this.spaces.get(space)?.down();
+    this.spaces.delete(space);
+  }
+  /**
+   * Disposes of the current instance by performing cleanup operations.
+   * Iterates through all spaces, performs a "down" operation on each,
+   * and then clears the collection of spaces.
+   *
+   * @return {void} No return value.
+   */
+  dispose() {
+    this.spaces.forEach((space) => space.down());
+    this.spaces.clear();
+  }
+};
+
+// src/services/postboy-dependency.resolver.ts
+var PostboyDependencyResolver = class {
+  constructor() {
+    /**
+     * Retrieves an instance of the PostboyMiddlewareService.
+     *
+     * This function initializes and returns a new instance of the
+     * PostboyMiddlewareService, which can be used to configure and manage
+     * middleware for a specific module or application.
+     *
+     * @returns {PostboyMiddlewareService} A new instance of PostboyMiddlewareService.
+     */
+    this.getMiddlewareService = () => new PostboyMiddlewareService();
+    /**
+     * A function that instantiates and returns a new instance of PostboyMessageStore.
+     *
+     * This function serves as a factory method for creating instances
+     * of the PostboyMessageStore class.
+     *
+     * @returns {PostboyMessageStore} A new instance of the PostboyMessageStore class.
+     */
+    this.getMessageStore = () => new PostboyMessageStore();
+    /**
+     * Creates and initializes a new instance of PostboyNamespaceStore using the provided PostboyService instance.
+     *
+     * @function getNamespaceStore
+     * @returns {PostboyNamespaceStore} A new instance of PostboyNamespaceStore associated with the given PostboyService.
+     */
+    this.getNamespaceStore = () => new PostboyNamespaceStore();
+  }
+};
+
+// src/messages/add-namespace.executor.ts
+var AddNamespace = class extends PostboyExecutor {
+  /**
+   * Creates an instance of the class with the specified space identifier.
+   *
+   * @param {string} space - The identifier for the space.
+   */
+  constructor(space) {
+    super();
+    this.space = space;
+  }
+};
+AddNamespace.ID = "6d1a6f7d-6b6e-4c4d-8af8-9cc9a32e850c";
+
+// src/messages/eliminate-namespace.executor.ts
+var EliminateNamespace = class extends PostboyExecutor {
+  /**
+   * Creates an instance of the class with the specified space value.
+   *
+   * @param {string} space - The string value representing the space configuration.
+   */
+  constructor(space) {
+    super();
+    this.space = space;
+  }
+};
+EliminateNamespace.ID = "03bb03bb-53e0-4b74-9aad-64d5c54a8972";
+
+// src/messages/add-middleware.executor.ts
+var AddMiddleware = class extends PostboyExecutor {
+  /**
+   * Initializes a new instance of the class with the specified middleware.
+   *
+   * @param {PostboyMiddleware} middleware - The {@link PostboyMiddleware} to be used for processing.
+   */
+  constructor(middleware) {
+    super();
+    this.middleware = middleware;
+  }
+};
+AddMiddleware.ID = "0a8cfe0a-6193-4082-8440-d0793367b21d";
+
+// src/messages/remove-middleware.executor.ts
+var RemoveMiddleware = class extends PostboyExecutor {
+  /**
+   * Constructs an instance of the class with the specified middleware.
+   *
+   * @param {PostboyMiddleware} middleware - The {@link PostboyMiddleware} instance to be removed.
+   */
+  constructor(middleware) {
+    super();
+    this.middleware = middleware;
+  }
+};
+RemoveMiddleware.ID = "c25c708c-53c9-498d-a28b-936fbaf68b91";
+
+// src/messages/lock-message.executor.ts
+var LockMessage = class extends PostboyExecutor {
+  /**
+   * Constructs an instance of the class with the specified message type.
+   *
+   * @param {MessageType<T>} type - The type of the message to be used for the instance.
+   */
+  constructor(type) {
+    super();
+    this.type = type;
+  }
+};
+LockMessage.ID = "477df3e2-1f99-4476-9a3b-afd1fa426436";
+
+// src/messages/unlock-message.executor.ts
+var UnlockMessage = class extends PostboyExecutor {
+  /**
+   * Creates an instance of the class with the specified message type.
+   *
+   * @param {MessageType<T>} type - The message type for this instance.
+   */
+  constructor(type) {
+    super();
+    this.type = type;
+  }
+};
+UnlockMessage.ID = "d71d25e3-90ac-4009-b972-9e6c6b05611e";
+
+// src/postboy.service.ts
+var PostboyService = class {
+  constructor(resolver) {
+    this.locked = /* @__PURE__ */ new Set();
+    this.dependencyResolver = resolver || new PostboyDependencyResolver();
+    this.middleware = this.dependencyResolver.getMiddlewareService();
+    this.store = this.dependencyResolver.getMessageStore();
+    this.namespaceStore = this.dependencyResolver.getNamespaceStore();
+    this.registerInfrastructureMessages();
+  }
+  registerInfrastructureMessages() {
+    this.store.registerExecutor(DisconnectMessage.ID, (e) => this.store.unregister(e.messageId));
+    this.store.registerExecutor(UnlockMessage.ID, (e) => this.locked.delete(checkId(e.type)));
+    this.store.registerExecutor(LockMessage.ID, (e) => this.locked.add(checkId(e.type)));
+    this.store.registerExecutor(
+      AddMiddleware.ID,
+      (e) => this.middleware.addMiddleware(e.middleware)
+    );
+    this.store.registerExecutor(
+      RemoveMiddleware.ID,
+      (e) => this.middleware.removeMiddleware(e.middleware)
+    );
+    this.store.registerExecutor(AddNamespace.ID, (e) => this.namespaceStore.addSpace(e.space, this));
+    this.store.registerExecutor(
+      EliminateNamespace.ID,
+      (e) => this.namespaceStore.eliminateSpace(e.space)
+    );
+    this.store.registerExecutor(ConnectMessage.ID, (e) => {
+      const { type, sub, pipe: pipe2 } = e;
+      this.store.registerMessage(checkId(type), new PostboySubscription(sub, pipe2));
+    });
+    this.store.registerExecutor(ConnectExecutor.ID, (e) => {
+      const { type, exec } = e;
+      this.store.registerExecutor(checkId(type), exec);
+    });
+    this.store.registerExecutor(ConnectHandler.ID, (e) => {
+      const { executor, handler } = e;
+      this.store.registerExecutor(checkId(executor), (e2) => handler.handle(e2));
+    });
+  }
+  /**
+   * Fires a registered event and passes the message to its subscribers.
+   *
+   * @param {PostboyGenericMessage} message - The message object containing the event data.
+   * @return {void} This method does not return a value.
+   * @throws {Error} Throws an error if no registered event is found for the provided message ID.
+   */
+  fire(message) {
+    this.middleware.beforePublish(message);
+    if (!this.locked.has(message.id)) {
+      this.store.getMessage(message.id, message.constructor.name).fire(message);
+    }
+    this.middleware.afterPublish(message);
+  }
+  /**
+   * Triggers a callback function associated with a given message.
+   *
+   * @param {PostboyCallbackMessage<T>} message - The message object used to trigger the callback.
+   * It contains details about the event and result subscription.
+   * @param {(e: T) => void} [action] - Optional callback function to execute when the result of the message is emitted.
+   * @return {void} This method does not return any value.
+   */
+  fireCallback(message, action) {
+    this.middleware.beforeCallback(message);
+    if (action) message.result.subscribe(action);
+    this.store.callbackFired(message);
+    const result$ = action ? message.result.pipe(operators.tap(action)) : message.result;
+    const msg = this.store.getMessage(message.id, message.constructor.name);
+    const observable = new rxjs.Observable((subscriber) => {
+      const subscription = result$.pipe(operators.tap(() => this.middleware.afterCallback(message))).subscribe(subscriber);
+      if (!this.locked.has(message.id)) {
+        msg.fire(message);
+      }
+      return () => subscription.unsubscribe();
+    });
+    if (!!action) observable.subscribe();
+    return observable;
+  }
+  /**
+   * Executes the provided executor function and returns its result.
+   *
+   * @param {PostboyExecutor<T>} executor The executor to be executed, which includes its identifier and logic.
+   * @return {T} The resulting output from the executed executor function.
+   * @throws {Error} If the specified executor is not registered.
+   */
+  exec(executor) {
+    this.middleware.beforeExecute(executor);
+    const result = this.store.getExecutor(executor.id)(executor);
+    this.middleware.afterExecute(executor, result);
+    return result;
+  }
+  /**
+   * Subscribes to a specific message type and returns an observable of that type.
+   *
+   * @param type The constructor function of the type that extends PostboyGenericMessage.
+   * @return An Observable of the specified generic message type.
+   */
+  sub(type) {
+    return this.store.getMessage(checkId(type), type.name).sub();
+  }
+  /**
+   * Subscribes to a specific message type and automatically unsubscribes after receiving the first message.
+   *
+   * @param type The type of message to subscribe to.
+   * @return An observable that emits the first message of the specified type and then completes.
+   */
+  once(type) {
+    return this.sub(type).pipe(operators.first());
+  }
+  /**
+   * Registers a given message type and its associated subject subscription with the system.
+   *
+   * @deprecated The method should be replaced with firing {@link ConnectMessage} message.
+   * @param type The constructor function of the message type that extends the PostboyGenericMessage.
+   * @param sub The Subject instance for the provided message type, used for managing subscriptions.
+   * @return {void} No return value.
+   */
+  record(type, sub) {
+    this.store.registerMessage(checkId(type), new PostboySubscription(sub, (s) => s.asObservable()));
+  }
+  /**
+   * Registers a generic message type with a Subject and a transformation pipe.
+   *
+   * @deprecated The method should be replaced with firing {@link ConnectMessage} message.
+   * @param {MessageType<T>} type - The constructor of the message type being registered.
+   * @param {Subject<T>} sub - The Subject instance used to handle incoming messages of the specified type.
+   * @param {(s: Subject<T>) => Observable<T>} pipe - A function that applies a transformation or processing logic to the Subject and returns an Observable.
+   * @return {void} No return value.
+   */
+  recordWithPipe(type, sub, pipe2) {
+    this.store.registerMessage(checkId(type), new PostboySubscription(sub, pipe2));
+  }
+  /**
+   * Registers an executor for a specified message type.
+   *
+   * @deprecated The method should be replaced with firing {@link ConnectExecutor} message.
+   * @param {MessageType<E>} type - The message type for which the executor is being registered.
+   * @param {(e: E) => T} exec - The executor function that will handle messages of the specified type.
+   * @return {void} This method does not return any value.
+   */
+  recordExecutor(type, exec) {
+    this.store.registerExecutor(checkId(type), exec);
+  }
+  /**
+   * Registers a handler for a specific executor type.
+   *
+   * @deprecated The method should be replaced with firing {@link ConnectHandler} message.
+   * @param executor The constructor of the executor class that extends `PostboyExecutor<R>`.
+   * @param handler An instance of `PostboyExecutionHandler<R, E>` that defines the logic for handling the executor.
+   * @return void
+   */
+  recordHandler(executor, handler) {
+    this.store.registerExecutor(checkId(executor), (e) => handler.handle(e));
+  }
+  /**
+   * Disposes of resources and cleans up any internal components or stores associated with the instance.
+   * This method ensures that all resources are properly released to avoid memory leaks.
+   *
+   * @return {void} This method does not return a value.
+   */
+  dispose() {
+    this.namespaceStore?.dispose();
+    this.store.dispose();
+    this.middleware.dispose();
+  }
+};
+
+// src/services/postboy-middleware.ts
+var PostboyMiddleware = class {
+  /**
+   * Creates an instance of a class, optionally assigning a name.
+   *
+   * @param {string} [name] - An optional name to be assigned. If not provided, defaults to the class name.
+   */
+  constructor(name) {
+    this.name = name ?? this.constructor.name;
+  }
+  /**
+   * Optional filter to skip middleware for unrelated messages/stages.
+   */
+  canHandle(_context) {
+    return true;
+  }
+  /**
+   * Called before the stage is executed.
+   * Return Interrupt to cancel the operation.
+   */
+  before(_context) {
+    return { type: 1 /* Continue */ };
+  }
+  /**
+   * Called after the stage has finished successfully.
+   * `result` is typically set for execute-stage.
+   */
+  after(_context, _result) {
+  }
+  /**
+   * Optional cleanup hook.
+   */
+  dispose() {
+  }
+};
+var PostboyCallbackMessage = class extends PostboyGenericMessage {
+  constructor() {
+    super(...arguments);
+    this.result$ = new rxjs.Subject();
+    this.result = this.result$.asObservable();
+    /**
+     * Emits the provided value.
+     *
+     * @template T - The type of the value to emit.
+     * @param {T} value - The value to emit through the `result$` observable.
+     * @returns {void}
+     */
+    this.next = (value) => this.result$.next(value);
+  }
+  /**
+   * Marks the operation as complete by emitting the provided value and then completing the result stream.
+   *
+   * @param {T} value - The value to emit prior to completing the result stream.
+   * @return {void} This method does not return a value.
+   */
+  finish(value) {
+    this.result$.next(value);
+    this.result$.complete();
+  }
+  /**
+   * Completes the current observable result stream.
+   * This method marks the result observable as complete, ensuring no further values
+   * or events will be emitted from it.
+   *
+   * @return {void} No value is returned from this method.
+   */
+  complete() {
+    this.result$.complete();
+  }
+};
+
+// src/models/postboy-execution.handler.ts
+var PostboyExecutionHandler = class {
+};
+
+exports.AddMiddleware = AddMiddleware;
+exports.AddNamespace = AddNamespace;
+exports.CancelError = CancelError;
+exports.ConnectExecutor = ConnectExecutor;
+exports.ConnectHandler = ConnectHandler;
+exports.ConnectMessage = ConnectMessage;
+exports.DisconnectMessage = DisconnectMessage;
+exports.EliminateNamespace = EliminateNamespace;
+exports.LockMessage = LockMessage;
+exports.MiddlewareDecisionType = MiddlewareDecisionType;
+exports.MiddlewareStage = MiddlewareStage;
+exports.PostboyAbstractRegistrator = PostboyAbstractRegistrator;
+exports.PostboyCallbackMessage = PostboyCallbackMessage;
+exports.PostboyExecutionHandler = PostboyExecutionHandler;
+exports.PostboyExecutor = PostboyExecutor;
+exports.PostboyGenericMessage = PostboyGenericMessage;
+exports.PostboyMessage = PostboyMessage;
+exports.PostboyMessageStore = PostboyMessageStore;
+exports.PostboyMiddleware = PostboyMiddleware;
+exports.PostboyMiddlewareService = PostboyMiddlewareService;
+exports.PostboyNamespaceStore = PostboyNamespaceStore;
+exports.PostboyService = PostboyService;
+exports.PostboySubscription = PostboySubscription;
+exports.RemoveMiddleware = RemoveMiddleware;
+exports.UnlockMessage = UnlockMessage;
+//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map