nesoi 3.1.6 → 3.1.8

package/lib/elements/edge/controller/controller.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Controller = exports.ControllerEndpoint = void 0;
+exports.Controller = exports.ControllerTopic = exports.ControllerEndpoint = void 0;
 const cli_controller_adapter_1 = require("./adapters/cli.controller_adapter");
 const trx_node_1 = require("../../../engine/transaction/trx_node");
+const error_1 = require("../../../engine/data/error");
 /**
  * @category Elements
  * @subcategory Edge
@@ -33,6 +34,38 @@ class ControllerEndpoint {
     }
 }
 exports.ControllerEndpoint = ControllerEndpoint;
+/**
+ * @category Elements
+ * @subcategory Edge
+ */
+class ControllerTopic {
+    constructor(schema, adapter, path) {
+        this.schema = schema;
+        this.adapter = adapter;
+        this.path = path;
+    }
+    async subscribe(fn, authn) {
+        const response = await this.adapter.trx(trx => {
+            trx_node_1.TrxNode.checkAuthn(trx, this.schema.authn);
+            return trx.topic(this.schema.name).subscribe(fn);
+        }, authn);
+        if (response.state === 'error') {
+            throw error_1.NesoiError.Controller.SubscribeFailed({ topic: this.schema.alias });
+        }
+        return response.output;
+    }
+    async unsubscribe(id) {
+        const response = await this.adapter.trx(trx => {
+            trx_node_1.TrxNode.checkAuthn(trx, this.schema.authn);
+            return trx.topic(this.schema.name).unsubscribe(id);
+        });
+        if (response.state === 'error') {
+            throw error_1.NesoiError.Controller.UnsubscribeFailed({ topic: this.schema.alias });
+        }
+        return response.output;
+    }
+}
+exports.ControllerTopic = ControllerTopic;
 class Controller {
     constructor(module, schema, config, services = {}) {
         this.schema = schema;

package/lib/elements/edge/controller/controller.schema.d.ts

@@ -15,6 +15,20 @@ export declare class $ControllerEndpoint {
     $t: string;
     constructor(name: string, alias: string, authn: string[], tags: string[], msg: $Dependency, target: $Dependency);
 }
+/**
+ * @category Schemas
+ * @subcategory Edge
+ */
+export declare class $ControllerTopic {
+    name: string;
+    alias: string;
+    authn: string[];
+    tags: string[];
+    msgs: $Dependency[];
+    topic: $Dependency;
+    $t: string;
+    constructor(name: string, alias: string, authn: string[], tags: string[], msgs: $Dependency[], topic: $Dependency);
+}
 /**
  * @category Schemas
  * @subcategory Edge
@@ -53,8 +67,9 @@ export declare class $Controller {
     authn: string[];
     input: $Dependency[];
     domains: Record<string, $ControllerDomain>;
+    topics: Record<string, $ControllerTopic>;
     $t: "controller";
     '#authn': AnyUsers;
     '#input': $Message;
-    constructor(module: string, name: string, alias: string, authn: string[], input: $Dependency[], domains?: Record<string, $ControllerDomain>);
+    constructor(module: string, name: string, alias: string, authn: string[], input: $Dependency[], domains?: Record<string, $ControllerDomain>, topics?: Record<string, $ControllerTopic>);
 }

package/lib/elements/edge/controller/controller.schema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.$Controller = exports.$ControllerDomain = exports.$ControllerGroup = exports.$ControllerEndpoint = void 0;
+exports.$Controller = exports.$ControllerDomain = exports.$ControllerGroup = exports.$ControllerTopic = exports.$ControllerEndpoint = void 0;
 /**
  * @category Schemas
  * @subcategory Edge
@@ -17,6 +17,22 @@ class $ControllerEndpoint {
     }
 }
 exports.$ControllerEndpoint = $ControllerEndpoint;
+/**
+ * @category Schemas
+ * @subcategory Edge
+ */
+class $ControllerTopic {
+    constructor(name, alias, authn, tags, msgs, topic) {
+        this.name = name;
+        this.alias = alias;
+        this.authn = authn;
+        this.tags = tags;
+        this.msgs = msgs;
+        this.topic = topic;
+        this.$t = 'controller.topic';
+    }
+}
+exports.$ControllerTopic = $ControllerTopic;
 /**
  * @category Schemas
  * @subcategory Edge
@@ -54,13 +70,14 @@ exports.$ControllerDomain = $ControllerDomain;
  * @subcategory Edge
  */
 class $Controller {
-    constructor(module, name, alias, authn, input, domains = {}) {
+    constructor(module, name, alias, authn, input, domains = {}, topics = {}) {
         this.module = module;
         this.name = name;
         this.alias = alias;
         this.authn = authn;
         this.input = input;
         this.domains = domains;
+        this.topics = topics;
         this.$t = 'controller';
     }
 }

package/lib/elements/entities/bucket/bucket.d.ts

@@ -197,8 +197,8 @@ export declare class Bucket<M extends $Module, $ extends $Bucket> {
      */
     protected addMeta(trx: AnyTrxNode, obj: Record<string, any>, operation: 'create' | 'update'): void;
     getTenancyQuery(trx: AnyTrxNode): import("./query/nql.schema").NQL_Query<any, any> | undefined;
-    protected encrypt(trx: AnyTrxNode, obj: Record<string, any>, fields?: $BucketModelFields): void;
-    protected decrypt(trx: AnyTrxNode, obj: Record<string, any>, fields?: $BucketModelFields): void;
+    protected encrypt(trx: AnyTrxNode, obj: Record<string, any>, fields?: $BucketModelFields): Promise<void>;
+    protected decrypt(trx: AnyTrxNode, obj: Record<string, any>, fields?: $BucketModelFields): Promise<void>;
     /**
      * Copy all files from the object to the bucket's Drive
      * - Call `drive.upload` to send the files to the drive preserving the local copy

package/lib/elements/entities/bucket/bucket.js

@@ -101,7 +101,7 @@ class Bucket {
         }
         // Encryption
         if (this.schema.model.hasEncryptedField) {
-            this.decrypt(trx, raw);
+            await this.decrypt(trx, raw);
         }
         return raw;
     }
@@ -132,7 +132,7 @@ class Bucket {
         // Encryption
         if (this.schema.model.hasEncryptedField) {
             for (const raw of raws) {
-                this.decrypt(trx, raw);
+                await this.decrypt(trx, raw);
             }
         }
         return raws;
@@ -196,7 +196,7 @@ class Bucket {
         // Encryption
         if (linkObj) {
             if (this.schema.model.hasEncryptedField) {
-                this.decrypt(trx, linkObj);
+                await this.decrypt(trx, linkObj);
             }
         }
         return linkObj;
@@ -230,10 +230,10 @@ class Bucket {
         if (linkObj && this.schema.model.hasEncryptedField) {
             if (Array.isArray(linkObj)) {
                 for (const obj of linkObj)
-                    this.decrypt(trx, obj);
+                    await this.decrypt(trx, obj);
             }
             else {
-                this.decrypt(trx, linkObj);
+                await this.decrypt(trx, linkObj);
             }
         }
         return linkObj;
@@ -287,7 +287,7 @@ class Bucket {
         this.addMeta(trx, obj, 'create');
         // Encryption
         if (this.schema.model.hasEncryptedField) {
-            this.encrypt(trx, obj);
+            await this.encrypt(trx, obj);
         }
         // Drive
         if (this.schema.model.hasFileField) {
@@ -413,7 +413,7 @@ class Bucket {
         this.addMeta(trx, obj, 'update');
         // Encryption
         if (this.schema.model.hasEncryptedField) {
-            this.encrypt(trx, obj);
+            await this.encrypt(trx, obj);
         }
         // Drive
         if (this.schema.model.hasFileField) {
@@ -461,7 +461,7 @@ class Bucket {
         this.addMeta(trx, obj, 'create');
         // Encryption
         if (this.schema.model.hasEncryptedField) {
-            this.encrypt(trx, obj);
+            await this.encrypt(trx, obj);
         }
         // Drive
         if (this.schema.model.hasFileField) {
@@ -678,7 +678,7 @@ class Bucket {
         // Encryption
         if (this.schema.model.hasEncryptedField) {
             for (const obj of result.data) {
-                this.decrypt(trx, obj);
+                await this.decrypt(trx, obj);
             }
         }
         // Build
@@ -712,27 +712,35 @@ class Bucket {
         return this.schema.tenancy[match.provider]?.(match.user);
     }
     // Encryption
-    encrypt(trx, obj, fields = this.schema.model.fields) {
+    async encrypt(trx, obj, fields = this.schema.model.fields) {
         for (const key in fields) {
             const field = fields[key];
             if (field.crypto) {
                 const key = trx.value(field.crypto.key);
-                tree_1.Tree.set(obj, field.path, val => crypto_1.Crypto.encrypt(val, key));
+                const val = tree_1.Tree.get(obj, field.path);
+                if (val !== undefined) {
+                    const encrypted = await crypto_1.NesoiCrypto.encrypt(val, key);
+                    tree_1.Tree.set(obj, field.path, () => encrypted);
+                }
             }
             if (field.children) {
-                this.encrypt(trx, obj, field.children);
+                await this.encrypt(trx, obj, field.children);
             }
         }
     }
-    decrypt(trx, obj, fields = this.schema.model.fields) {
+    async decrypt(trx, obj, fields = this.schema.model.fields) {
         for (const key in fields) {
             const field = fields[key];
             if (field.crypto) {
                 const key = trx.value(field.crypto.key);
-                tree_1.Tree.set(obj, field.path, val => crypto_1.Crypto.decrypt(val, key));
+                const val = tree_1.Tree.get(obj, field.path);
+                if (val !== undefined) {
+                    const encrypted = await crypto_1.NesoiCrypto.decrypt(val, key);
+                    tree_1.Tree.set(obj, field.path, () => encrypted);
+                }
             }
             if (field.children) {
-                this.decrypt(trx, obj, field.children);
+                await this.decrypt(trx, obj, field.children);
             }
         }
     }

package/lib/elements/entities/bucket/model/bucket_model_field.builder.d.ts

@@ -164,7 +164,7 @@ export declare class BucketModelFieldBuilder<Module extends $Module, Input, Outp
      * > If you want unconstrained enum you must specify `null` here.
      */
     maxLength(val: number | null): void;
-    encrypt(key: keyof Module['constants']['values'], algorithm?: string): void;
+    encrypt(key: keyof Module['constants']['values'], algorithm?: string): this;
     static build(builder: AnyBucketModelFieldBuilder, name: string, basePath?: string): {
         schema: $BucketModelField;
         hasFile: boolean;

package/lib/elements/entities/bucket/model/bucket_model_field.builder.js

@@ -152,6 +152,7 @@ class BucketModelFieldBuilder {
             algorithm,
             key: key
         };
+        return this;
     }
     // Build
     static build(builder, name, basePath = '') {

package/lib/elements/index.d.ts

@@ -7,5 +7,6 @@ export { $Bucket } from './entities/bucket/bucket.schema';
 export { $Job } from './blocks/job/job.schema';
 export { $Resource } from './blocks/resource/resource.schema';
 export { $Queue } from './blocks/queue/queue.schema';
+export { $Topic } from './blocks/topic/topic.schema';
 export { $Externals } from './edge/externals/externals.schema';
 export { $Space, $Module } from '../schema';

package/lib/elements/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.$Externals = exports.$Queue = exports.$Resource = exports.$Job = exports.$Bucket = exports.$Message = exports.$Constants = exports.$Machine = exports.$Controller = exports.MemoryBucketAdapter = void 0;
+exports.$Externals = exports.$Topic = exports.$Queue = exports.$Resource = exports.$Job = exports.$Bucket = exports.$Message = exports.$Constants = exports.$Machine = exports.$Controller = exports.MemoryBucketAdapter = void 0;
 var memory_bucket_adapter_1 = require("./entities/bucket/adapters/memory.bucket_adapter");
 Object.defineProperty(exports, "MemoryBucketAdapter", { enumerable: true, get: function () { return memory_bucket_adapter_1.MemoryBucketAdapter; } });
 var controller_schema_1 = require("./edge/controller/controller.schema");
@@ -19,5 +19,7 @@ var resource_schema_1 = require("./blocks/resource/resource.schema");
 Object.defineProperty(exports, "$Resource", { enumerable: true, get: function () { return resource_schema_1.$Resource; } });
 var queue_schema_1 = require("./blocks/queue/queue.schema");
 Object.defineProperty(exports, "$Queue", { enumerable: true, get: function () { return queue_schema_1.$Queue; } });
+var topic_schema_1 = require("./blocks/topic/topic.schema");
+Object.defineProperty(exports, "$Topic", { enumerable: true, get: function () { return topic_schema_1.$Topic; } });
 var externals_schema_1 = require("./edge/externals/externals.schema");
 Object.defineProperty(exports, "$Externals", { enumerable: true, get: function () { return externals_schema_1.$Externals; } });

package/lib/engine/apps/inline.app.d.ts

@@ -38,6 +38,11 @@ export declare class InlineApp<S extends $Space, ModuleNames extends string = Mo
      * TODO: allow overriding this behavior with adapters
      */
     protected linkExternals(modules: Record<string, Module<S, $Module>>): void;
+    /**
+     * This method injects values from environment variables into each module's
+     * app constants.
+     */
+    protected linkAppValues(modules: Record<string, Module<S, $Module>>): void;
     modules<M extends ModuleName<S>>(modules: M[]): InlineApp<S, M & ModuleNames>;
     service<T extends IService>($: T): InlineApp<S, ModuleNames, Services & { [K in T["name"]]: T; }>;
     get config(): AppConfigFactory<S, ModuleNames, Services, typeof this>;

package/lib/engine/apps/inline.app.js

@@ -85,6 +85,8 @@ class InlineApp extends app_1.App {
         }
         log_1.Log.debug('app', this.name, 'Linking externals');
         this.linkExternals(modules);
+        log_1.Log.debug('app', this.name, 'Linking app values');
+        this.linkAppValues(modules);
         return {
             modules,
             services,
@@ -132,6 +134,20 @@ class InlineApp extends app_1.App {
             });
         });
     }
+    /**
+     * This method injects values from environment variables into each module's
+     * app constants.
+     */
+    linkAppValues(modules) {
+        Object.values(modules).forEach(module => {
+            const values = module.schema.constants.values;
+            Object.values(values).forEach(value => {
+                if (value.scope !== 'app')
+                    return;
+                value.value = process.env[value.key];
+            });
+        });
+    }
     // Type Builder Overrides
     modules(modules) {
         super.modules(modules);

package/lib/engine/daemon.js

@@ -154,7 +154,7 @@ class DaemonTrx {
      * @param fn A function to execute inside the transaction
      * @returns A `TrxStatus` containing metadata about the transaction and the function response
      */
-    async run(fn) {
+    run(fn) {
         return this.trxEngine.trx(fn, this.authnRequest);
     }
 }

package/lib/engine/data/error.d.ts

@@ -1,7 +1,6 @@
 import { AnyModule } from "../module";
 import { $MessageTemplateRule } from "../../elements/entities/message/template/message_template.schema";
 import { $Resource } from "../../elements/blocks/resource/resource.schema";
-import { $Controller } from "../../elements/edge/controller/controller.schema";
 import { AnyQuery } from "../../elements/entities/bucket/query/nql.schema";
 export declare namespace NesoiError {
     class BaseError extends Error {
@@ -46,6 +45,7 @@ export declare namespace NesoiError {
         function ResourceNotIncluded(module: AnyModule, resource: string): BaseError;
         function MachineNotIncluded(module: AnyModule, machine: string): BaseError;
         function QueueNotIncluded(module: AnyModule, queue: string): BaseError;
+        function TopicNotIncluded(module: AnyModule, topic: string): BaseError;
         function ControllerNotIncluded(module: AnyModule, controller: string): BaseError;
         function InlineMessageNotFoundOnMerge(msg: string): BaseError;
         function InlineJobNotFoundOnMerge(job: string): BaseError;
@@ -251,6 +251,11 @@ export declare namespace NesoiError {
         function UnmetCondition(alias: string, msg: string): BaseError;
     }
     namespace Controller {
-        function PortNotFound(controller: $Controller, port: string): BaseError;
+        function SubscribeFailed($: {
+            topic: string;
+        }): BaseError;
+        function UnsubscribeFailed($: {
+            topic: string;
+        }): BaseError;
     }
 }

package/lib/engine/data/error.js

@@ -111,6 +111,10 @@ var NesoiError;
             return new BaseError('Module.QueueNotIncluded', `Queue ${queue} not included on module ${module.name}`, Status.NOT_FOUND);
         }
         Module.QueueNotIncluded = QueueNotIncluded;
+        function TopicNotIncluded(module, topic) {
+            return new BaseError('Module.TopicNotIncluded', `Topic ${topic} not included on module ${module.name}`, Status.NOT_FOUND);
+        }
+        Module.TopicNotIncluded = TopicNotIncluded;
         function ControllerNotIncluded(module, controller) {
             return new BaseError('Module.ControllerNotIncluded', `Controller ${controller} not included on module ${module.name}`, Status.NOT_FOUND);
         }
@@ -406,9 +410,13 @@ var NesoiError;
     */
     let Controller;
     (function (Controller) {
-        function PortNotFound(controller, port) {
-            return new BaseError('Controller.PortNotFound', `Port ${port} not found on controller ${controller.name}`, Status.NOT_FOUND);
+        function SubscribeFailed($) {
+            return new BaseError('Controller.SubscribeFailed', `Failed to subscribe to topic '${$.topic}'`, Status.BAD_REQUEST, $);
+        }
+        Controller.SubscribeFailed = SubscribeFailed;
+        function UnsubscribeFailed($) {
+            return new BaseError('Controller.UnsubscribeFailed', `Failed to unsubscribe to topic '${$.topic}'`, Status.BAD_REQUEST, $);
         }
-        Controller.PortNotFound = PortNotFound;
+        Controller.UnsubscribeFailed = UnsubscribeFailed;
     })(Controller = NesoiError.Controller || (NesoiError.Controller = {}));
 })(NesoiError || (exports.NesoiError = NesoiError = {}));

package/lib/engine/module.d.ts

@@ -32,8 +32,11 @@ import { AnyQueueBuilder } from "../elements/blocks/queue/queue.builder";
 import { $Queue } from "../elements/blocks/queue/queue.schema";
 import { NQL_Engine } from "../elements/entities/bucket/query/nql_engine";
 import { AnyDaemon } from './daemon';
-export type AnyBuilder = AnyExternalsBuilder | ConstantsBuilder | AnyMessageBuilder | AnyBucketBuilder | AnyJobBuilder | AnyResourceJobBuilder | AnyMachineJobBuilder | AnyResourceBuilder | AnyMachineBuilder | AnyControllerBuilder | AnyQueueBuilder;
-export type AnyElementSchema = $Externals | $Constants | $Message | $Bucket | $Job | $Resource | $Machine | $Controller | $Queue;
+import { AnyTopicBuilder } from "../elements/blocks/topic/topic.builder";
+import { $Topic } from "../elements/blocks/topic/topic.schema";
+import { Topic } from "../elements/blocks/topic/topic";
+export type AnyBuilder = AnyExternalsBuilder | ConstantsBuilder | AnyMessageBuilder | AnyBucketBuilder | AnyJobBuilder | AnyResourceJobBuilder | AnyMachineJobBuilder | AnyResourceBuilder | AnyMachineBuilder | AnyControllerBuilder | AnyQueueBuilder | AnyTopicBuilder;
+export type AnyElementSchema = $Externals | $Constants | $Message | $Bucket | $Job | $Resource | $Machine | $Controller | $Queue | $Topic;
 export type AnyInlineElementSchema = $Message | $Job;
 export type VirtualModuleDef = {
     name: string;
@@ -71,6 +74,7 @@ export declare class Module<S extends $Space, $ extends $Module> {
     resources: { [B in keyof $["resources"]]: Resource<S, $, $["resources"][B]>; };
     machines: { [B in keyof $["machines"]]: Machine<S, $, $["machines"][B]>; };
     queues: { [B in keyof $["queues"]]: Queue<$, $["queues"][B]>; };
+    topics: { [B in keyof $["topics"]]: Topic<S, $, $["topics"][B]>; };
     controllers: { [B in keyof $["controllers"]]: Controller<S, $, $["controllers"][B]>; };
     trash?: AnyBucket;
     /**
@@ -124,6 +128,7 @@ export declare class Module<S extends $Space, $ extends $Module> {
         resources?: $Resource[];
         machines?: $Machine[];
         queues?: $Queue[];
+        topics?: $Topic[];
         controllers?: $Controller[];
     }): this;
     /**

package/lib/engine/module.js

@@ -60,6 +60,8 @@ const queue_builder_1 = require("../elements/blocks/queue/queue.builder");
 const nql_engine_1 = require("../elements/entities/bucket/query/nql_engine");
 const daemon_1 = require("./daemon");
 const trash_1 = require("./data/trash");
+const topic_builder_1 = require("../elements/blocks/topic/topic.builder");
+const topic_1 = require("../elements/blocks/topic/topic");
 /**
  * A `Module` is an isolated named collection of _Elements_.
  *
@@ -92,6 +94,7 @@ class Module {
             machines: {},
             controllers: {},
             queues: {},
+            topics: {},
         };
         /* Entities */
         this.buckets = {};
@@ -101,6 +104,7 @@ class Module {
         this.resources = {};
         this.machines = {};
         this.queues = {};
+        this.topics = {};
         /* Edge */
         this.controllers = {};
         this.schema.name = name;
@@ -120,6 +124,7 @@ class Module {
             machines: Object.keys(this.machines),
             controllers: Object.keys(this.controllers),
             queues: Object.keys(this.queues),
+            topics: Object.keys(this.topics),
         });
     }
     // Manual injection
@@ -156,6 +161,9 @@ class Module {
         schemas.queues?.forEach(schema => {
             this.schema.queues[schema.name] = schema;
         });
+        schemas.topics?.forEach(schema => {
+            this.schema.topics[schema.name] = schema;
+        });
         schemas.controllers?.forEach(schema => {
             this.schema.controllers[schema.name] = schema;
         });
@@ -296,6 +304,11 @@ class Module {
             this.schema.queues[node.name] = schema;
             this.mergeInlineMessages(inlineMessages);
         }
+        else if (node.builder.$b === 'topic') {
+            const { schema, inlineMessages } = topic_builder_1.TopicBuilder.build(node, tree, this.schema);
+            this.schema.topics[node.name] = schema;
+            this.mergeInlineMessages(inlineMessages);
+        }
         else {
             throw error_1.NesoiError.Module.UnknownBuilderType(this, node.filepath.toString(), node.name, node.builder.$b);
         }
@@ -357,6 +370,9 @@ class Module {
         Object.entries(this.schema.queues).forEach(([name, schema]) => {
             this.queues[name] = new queue_1.Queue(this, schema);
         });
+        Object.entries(this.schema.topics).forEach(([name, schema]) => {
+            this.topics[name] = new topic_1.Topic(this, schema);
+        });
         this.nql = new nql_engine_1.NQL_Engine(this);
         if (config.trash?.[this.name]) {
             this.trash = new bucket_1.Bucket(this, trash_1.$TrashBucket, config.trash[this.name], services);
@@ -391,6 +407,10 @@ class Module {
         for (const name in this.queues || []) {
             this.destroyElement('queue', name);
         }
+        // Destroy topics
+        for (const name in this.topics || []) {
+            this.destroyElement('topic', name);
+        }
         // Destroy controllers
         for (const name in this.controllers || []) {
             this.destroyElement('controller', name);

package/lib/engine/space.d.ts

@@ -11,6 +11,7 @@ import { $Message } from "../elements/entities/message/message.schema";
 import { BucketModelDef } from "../elements/entities/bucket/model/bucket_model.builder";
 import { QueueBuilder } from "../elements/blocks/queue/queue.builder";
 import { $Bucket, $Job, $Resource } from "../elements";
+import { TopicBuilder } from "../elements/blocks/topic/topic.builder";
 /**
  * When using Nesoi as a framework (not a library), the `Space`
  * is a collection of all modules.
@@ -155,6 +156,17 @@ export declare class Space<$ extends $Space> {
     queue<M extends keyof $['modules'], K extends string, Module extends $Module = $['modules'][M]>(globalName: `${M & string}::${K}`): QueueBuilder<$, Module, Module["queues"][K] & {
         name: K;
     }>;
+    /**
+     * > Elements / Blocks / Topic
+     *
+     * A `Topic` is used to broadcast messages to different listeners.
+     *
+     * @param globalName A _Topic_ name in the format `module::name`
+     * @returns A `Topic` builder
+     */
+    topic<M extends keyof $['modules'], K extends string, Module extends $Module = $['modules'][M]>(globalName: `${M & string}::${K}`): TopicBuilder<$, Module, Module["topics"][K] & {
+        name: K;
+    }>;
     /**
      * > Elements / Edge / Externals
      *

package/lib/engine/space.js

@@ -49,6 +49,7 @@ const bucket_model_builder_1 = require("../elements/entities/bucket/model/bucket
 const bucket_model_field_builder_1 = require("../elements/entities/bucket/model/bucket_model_field.builder");
 const error_1 = require("../compiler/error");
 const queue_builder_1 = require("../elements/blocks/queue/queue.builder");
+const topic_builder_1 = require("../elements/blocks/topic/topic.builder");
 /**
  * When using Nesoi as a framework (not a library), the `Space`
  * is a collection of all modules.
@@ -221,6 +222,18 @@ class Space {
         const [module, name] = globalName.split('::');
         return new queue_builder_1.QueueBuilder(module, name);
     }
+    /**
+     * > Elements / Blocks / Topic
+     *
+     * A `Topic` is used to broadcast messages to different listeners.
+     *
+     * @param globalName A _Topic_ name in the format `module::name`
+     * @returns A `Topic` builder
+     */
+    topic(globalName) {
+        const [module, name] = globalName.split('::');
+        return new topic_builder_1.TopicBuilder(module, name);
+    }
     // Edge
     /**
      * > Elements / Edge / Externals

package/lib/engine/transaction/nodes/topic.trx_node.d.ts

@@ -0,0 +1,17 @@
+import { $Module } from "../../../schema";
+import { TrxNode } from '../trx_node';
+import { $Topic } from "../../../elements/blocks/topic/topic.schema";
+import { Topic } from "../../../elements/blocks/topic/topic";
+import { AnyMessage } from "../../../elements/entities/message/message";
+/**
+ * @category Engine
+ * @subcategory Transaction
+ */
+export declare class TopicTrxNode<M extends $Module, $ extends $Topic> {
+    private trx;
+    private topic;
+    constructor(trx: TrxNode<any, M, any>, topic: Topic<any, M, $>);
+    subscribe(fn: (msg: AnyMessage) => void): Promise<string>;
+    unsubscribe(id: string): Promise<void>;
+    publish(raw: $['#input']['#raw']): Promise<void>;
+}

package/lib/engine/transaction/nodes/topic.trx_node.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopicTrxNode = void 0;
+const trx_node_1 = require("../trx_node");
+/**
+ * @category Engine
+ * @subcategory Transaction
+ */
+class TopicTrxNode {
+    constructor(trx, topic) {
+        this.trx = trx;
+        this.topic = topic;
+    }
+    async subscribe(fn) {
+        const trx = trx_node_1.TrxNode.makeChildNode(this.trx, this.topic.schema.module, 'topic', this.topic.schema.name);
+        await trx_node_1.TrxNode.open(trx, 'subscribe', {});
+        let id;
+        try {
+            id = await this.topic.subscribe(this.trx, fn);
+        }
+        catch (e) {
+            throw await trx_node_1.TrxNode.error(trx, e);
+        }
+        await trx_node_1.TrxNode.ok(trx, { id });
+        return id;
+    }
+    async unsubscribe(id) {
+        const trx = trx_node_1.TrxNode.makeChildNode(this.trx, this.topic.schema.module, 'topic', this.topic.schema.name);
+        await trx_node_1.TrxNode.open(trx, 'unsubscribe', {});
+        try {
+            await this.topic.unsubscribe(this.trx, id);
+        }
+        catch (e) {
+            throw await trx_node_1.TrxNode.error(trx, e);
+        }
+        await trx_node_1.TrxNode.ok(trx, undefined);
+    }
+    async publish(raw) {
+        const trx = trx_node_1.TrxNode.makeChildNode(this.trx, this.topic.schema.module, 'topic', this.topic.schema.name);
+        await trx_node_1.TrxNode.open(trx, 'publish', { raw });
+        try {
+            await this.topic.consumeRaw(trx, raw);
+        }
+        catch (e) {
+            throw await trx_node_1.TrxNode.error(trx, e);
+        }
+        await trx_node_1.TrxNode.ok(trx, undefined);
+    }
+}
+exports.TopicTrxNode = TopicTrxNode;