nesoi 3.1.8 → 3.2.2

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

@@ -4,6 +4,7 @@ exports.BucketGraph = void 0;
 const trx_node_1 = require("../../../../engine/transaction/trx_node");
 const log_1 = require("../../../../engine/util/log");
 const error_1 = require("../../../../engine/data/error");
+const memory_bucket_adapter_1 = require("../adapters/memory.bucket_adapter");
 /**
  * @category Elements
  * @subcategory Entity
@@ -35,7 +36,7 @@ class BucketGraph {
             '#and': tenancy
         }, {
             perPage: schema.many ? undefined : 1,
-        }, { ...obj });
+        }, [{ ...obj }]);
         // Empty response
         if (!schema.many && !schema.optional && !links.data.length) {
             // silent = undefined
@@ -57,6 +58,52 @@ class BucketGraph {
             return links.data[0];
         }
     }
+    /**
+     * Read the data from a link
+     *
+     * - Options
+     *   - `silent`: If not found, returns undefined instead of raising an exception (default: `false`)
+     *   - `no_tenancy`: Don't apply tenancy rules (default: `false`)
+     */
+    async readManyLinks(trx, objs, link, options) {
+        log_1.Log.trace('bucket', this.bucketName, `Read link ${link}`);
+        const schema = this.schema.links[link];
+        // Make tenancy query
+        const tenancy = (options?.no_tenancy)
+            ? undefined
+            : this.bucket.getTenancyQuery(trx);
+        // Query
+        const otherBucket = trx_node_1.TrxNode.getModule(trx).buckets[schema.bucket.refName];
+        // let tempData: Record<string, any> = {};
+        let tempAdapter;
+        if (otherBucket.adapter instanceof memory_bucket_adapter_1.MemoryBucketAdapter) {
+            tempAdapter = otherBucket.adapter;
+        }
+        else {
+            const allLinks = await otherBucket.adapter.query(trx, {
+                ...schema.query,
+                '#and': tenancy
+            }, undefined, objs.map(obj => ({ ...obj })));
+            const tempData = {};
+            for (const obj of allLinks.data)
+                tempData[obj.id] = obj;
+            tempAdapter = new memory_bucket_adapter_1.MemoryBucketAdapter(otherBucket.schema, tempData);
+        }
+        const links = [];
+        for (const obj of objs) {
+            const result = await tempAdapter.query(trx, schema.query, {
+                perPage: schema.many ? undefined : 1,
+            }, [{ ...obj }], undefined, tempAdapter.nql);
+            if (schema.many) {
+                links.push(result.data);
+            }
+            else {
+                links.push(result.data[0]);
+            }
+        }
+        // Empty response
+        return links;
+    }
     /**
      * Read the data from a link and build it with a given view
      *
@@ -102,7 +149,7 @@ class BucketGraph {
             '#and': tenancy
         }, {
             perPage: 1,
-        }, { ...obj });
+        }, [{ ...obj }]);
         return !!links.data.length;
     }
 }

package/lib/elements/entities/bucket/model/bucket_model.schema.js

@@ -55,7 +55,6 @@ class $BucketModel {
                 }
                 // If it's a list or dict, or an object 
                 if (field.type === 'list' || field.type === 'dict') {
-                    // If not, iterate
                     next.push({
                         i: item.i + 1,
                         field: field.children['#']
@@ -70,6 +69,10 @@ class $BucketModel {
                     })));
                     continue;
                 }
+                if (field.type === 'unknown') {
+                    results.push(field);
+                    continue;
+                }
                 const child = field.children[path];
                 if (child) {
                     next.push({
@@ -127,53 +130,53 @@ class $BucketModel {
         while (poll.length) {
             const next = [];
             for (const entry of poll) {
-                const val = obj[entry.path];
+                const val = entry.obj[entry.path];
                 if (val === undefined) {
                     continue;
                 }
                 if (val === null) {
-                    copy[entry.path] = null;
+                    entry.copy[entry.path] = null;
                     continue;
                 }
                 if (entry.field.type === 'list') {
                     if (!Array.isArray(val))
                         continue;
-                    copy[entry.path] = [];
+                    entry.copy[entry.path] = [];
                     next.push(...val.map((_, i) => ({
                         path: i.toString(),
                         obj: val,
-                        copy: copy[entry.path],
+                        copy: entry.copy[entry.path],
                         field: entry.field.children['*']
                     })));
                 }
                 else if (entry.field.type === 'dict') {
                     if (typeof val !== 'object' || Array.isArray(val))
                         continue;
-                    copy[entry.path] = {};
+                    entry.copy[entry.path] = {};
                     next.push(...Object.keys(val).map((path) => ({
                         path,
                         obj: val,
-                        copy: copy[entry.path],
+                        copy: entry.copy[entry.path],
                         field: entry.field.children['*']
                     })));
                 }
                 else if (entry.field.type === 'obj') {
                     if (typeof val !== 'object' || Array.isArray(val))
                         continue;
-                    copy[entry.path] = {};
+                    entry.copy[entry.path] = {};
                     next.push(...Object.keys(entry.field.children).map(path => ({
                         path: path,
                         obj: val,
-                        copy: copy[entry.path],
+                        copy: entry.copy[entry.path],
                         field: entry.field.children[path]
                     })));
                 }
                 else if (entry.field.type === 'union') {
                     // TODO: ??????????   
-                    copy[entry.path] = obj[entry.path];
+                    entry.copy[entry.path] = entry.obj[entry.path];
                 }
                 else {
-                    copy[entry.path] = obj[entry.path];
+                    entry.copy[entry.path] = entry.obj[entry.path];
                 }
             }
             poll = next;

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

@@ -15,7 +15,7 @@ export type NQL_Result<T = Obj> = {
  * @category NQL
  * */
 export declare abstract class NQLRunner {
-    abstract run(trx: AnyTrxNode, part: NQL_Part, params: Record<string, any>, pagination?: NQL_Pagination, view?: $BucketView): Promise<NQL_Result>;
+    abstract run(trx: AnyTrxNode, part: NQL_Part, params: Record<string, any>[], pagination?: NQL_Pagination, view?: $BucketView): Promise<NQL_Result>;
 }
 /**
  * @category NQL
@@ -24,7 +24,7 @@ export declare class NQL_Engine {
     private module;
     private runners;
     constructor(module: AnyModule);
-    run(trx: AnyTrxNode, query: NQL_CompiledQuery, pagination?: NQL_Pagination, params?: Record<string, any>, view?: $BucketView): Promise<NQL_Result>;
+    run(trx: AnyTrxNode, query: NQL_CompiledQuery, pagination?: NQL_Pagination, params?: Record<string, any>[], view?: $BucketView, runner?: NQLRunner): Promise<NQL_Result>;
     linkExternal(bucket: AnyBucket): void;
 }
 export {};

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

@@ -22,7 +22,9 @@ class NQL_Engine {
             }
         }
     }
-    async run(trx, query, pagination, params = {}, view) {
+    async run(trx, query, pagination, params = [{}], view, runner) {
+        if (!params.length)
+            params = [{}];
         let result = {
             data: []
         };
@@ -30,8 +32,8 @@ class NQL_Engine {
             const part_i = query.execOrder[i];
             const part = query.parts[part_i];
             // Run part
-            const runner = this.runners[part.union.meta.scope];
-            const out = await runner.run(trx, part, params, pagination, view);
+            const _runner = runner || this.runners[part.union.meta.scope];
+            const out = await _runner.run(trx, part, params, pagination, view);
             result = out;
             // Part failed, return
             // Failure here is only when a single value is expected,
@@ -43,7 +45,9 @@ class NQL_Engine {
                 }
             }
             // Fill part params
-            params[`%__${part_i}__%`] = part.many ? result.data : result.data[0];
+            for (const paramGroup of params) {
+                paramGroup[`%__${part_i}__%`] = part.many ? result.data : result.data[0];
+            }
         }
         return result;
     }

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

@@ -4,9 +4,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BucketView = void 0;
+const trx_node_1 = require("../../../../engine/transaction/trx_node");
 const promise_1 = __importDefault(require("../../../../engine/util/promise"));
 const error_1 = require("../../../../engine/data/error");
 const tree_1 = require("../../../../engine/data/tree");
+const dependency_1 = require("../../../../engine/dependency");
 class ViewValue {
     constructor() {
         this.value = undefined;
@@ -27,6 +29,7 @@ class BucketView {
             Object.assign(parsed, raw);
         }
         let layer = Object.values(this.schema.fields).map(field => ({
+            bucket: this.bucket,
             field,
             data: [{
                     raw,
@@ -54,6 +57,7 @@ class BucketView {
             parseds.push(parsed);
         }
         let layer = Object.values(this.schema.fields).map(field => ({
+            bucket: this.bucket,
             field,
             data: raws.map((raw, i) => ({
                 raw,
@@ -89,7 +93,7 @@ class BucketView {
         for (const node of layer) {
             if (node.field.scope !== 'graph')
                 continue;
-            await this.parseGraphProp(trx, node);
+            next.push(...await this.parseGraphProp(trx, node));
         }
         // Drive props
         for (const node of layer) {
@@ -109,6 +113,7 @@ class BucketView {
                 }
             }
             next.push(...Object.values(node.field.children).map(field => ({
+                bucket: node.bucket,
                 field,
                 data: node.data
             })));
@@ -118,6 +123,7 @@ class BucketView {
             if (!node.field.chain)
                 continue;
             next.push({
+                bucket: node.bucket,
                 field: node.field.chain,
                 data: node.data.map(d => ({
                     index: d.index,
@@ -144,6 +150,7 @@ class BucketView {
             if (key === '__raw')
                 continue;
             next.push({
+                bucket: node.bucket,
                 field: node.field.children[key],
                 data: nextData
             });
@@ -249,7 +256,7 @@ class BucketView {
     async parseComputedProp(trx, node) {
         const meta = node.field.meta.computed;
         for (const entry of node.data) {
-            entry.target[node.field.name] = await promise_1.default.solve(meta.fn({ trx, raw: entry.raw, bucket: this.bucket.schema }));
+            entry.target[node.field.name] = await promise_1.default.solve(meta.fn({ trx, raw: entry.raw, bucket: node.bucket.schema }));
         }
     }
     /**
@@ -257,23 +264,69 @@ class BucketView {
      */
     async parseGraphProp(trx, node) {
         const meta = node.field.meta.graph;
-        for (const entry of node.data) {
-            let link;
-            if (!meta.view) {
-                link = this.bucket.graph.readLink(trx, entry.raw, meta.link, { silent: true });
+        const links = await node.bucket.graph.readManyLinks(trx, node.data.map(entry => entry.raw), meta.link, { silent: true });
+        for (let i = 0; i < links.length; i++) {
+            if (meta.view) {
+                const link = node.bucket.schema.graph.links[meta.link];
+                node.data[i].target[node.field.name] = link.many ? [] : {};
             }
             else {
-                link = this.bucket.graph.viewLink(trx, entry.raw, meta.link, meta.view, { silent: true });
+                node.data[i].target[node.field.name] = links[i];
             }
-            entry.target[node.field.name] = await promise_1.default.solve(link);
         }
+        let next = [];
+        if (meta.view) {
+            const schema = node.bucket.schema;
+            const otherBucketDep = schema.graph.links[meta.link].bucket;
+            const module = trx_node_1.TrxNode.getModule(trx);
+            const otherBucket = dependency_1.$Dependency.resolve(module.schema, otherBucketDep);
+            const view = otherBucket.views[meta.view];
+            const { __raw, ...v } = view.fields;
+            const link = node.bucket.schema.graph.links[meta.link];
+            let nextData;
+            if (link.many) {
+                const _links = links;
+                for (let i = 0; i < _links.length; i++) {
+                    const target = node.data[i].target[node.field.name];
+                    for (let j = 0; j < _links[i].length; j++) {
+                        target.push(__raw ? { ..._links[i][j] } : {});
+                        target[j].$v = meta.view;
+                    }
+                }
+                nextData = _links.map((ll, i) => ll.map((l, j) => ({ value: l, target: node.data[i].target[node.field.name][j] }))).flat(1);
+            }
+            else {
+                const _links = links;
+                for (let i = 0; i < _links.length; i++) {
+                    const target = node.data[i].target[node.field.name];
+                    if (__raw) {
+                        Object.assign(target, _links[i]);
+                    }
+                    target.$v = meta.view;
+                }
+                nextData = _links.map((l, i) => ({
+                    value: l, target: node.data[i].target[node.field.name]
+                }));
+            }
+            next = Object.values(v).map(field => ({
+                bucket: module.buckets[otherBucketDep.refName],
+                field,
+                data: nextData.map($ => ({
+                    raw: $.value,
+                    value: $.value,
+                    index: [],
+                    target: $.target
+                }))
+            }));
+        }
+        return next;
     }
     /**
      * [drive]
      */
     async parseDriveProp(trx, node) {
-        if (!this.bucket.drive) {
-            throw error_1.NesoiError.Bucket.Drive.NoAdapter({ bucket: this.bucket.schema.alias });
+        if (!node.bucket.drive) {
+            throw error_1.NesoiError.Bucket.Drive.NoAdapter({ bucket: node.bucket.schema.alias });
         }
         const meta = node.field.meta.drive;
         for (const entry of node.data) {
@@ -281,12 +334,12 @@ class BucketView {
             if (Array.isArray(value)) {
                 const public_urls = [];
                 for (const obj of value) {
-                    public_urls.push(await this.bucket.drive.public(obj));
+                    public_urls.push(await node.bucket.drive.public(obj));
                 }
                 entry.target[node.field.name] = public_urls;
             }
             else {
-                entry.target[node.field.name] = await this.bucket.drive.public(value);
+                entry.target[node.field.name] = await node.bucket.drive.public(value);
             }
         }
     }

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

@@ -13,41 +13,38 @@ import { $Bucket } from "../../elements";
 import { Overlay } from '../util/type';
 import { TrxStatus } from '../transaction/trx';
 import { NesoiObj } from '../data/obj';
-export type AppConfig<S extends $Space, Modules extends ModuleName<S>> = {
-    i18n?: AppI18nConfig;
+export type AppModuleConfig<S extends $Space, M extends ModuleName<S>, Services extends Record<string, IService>> = {
+    buckets?: AppBucketConfig<S, M, Services>;
+    trash?: AppTrashConfig<Services>;
+    controllers?: AppControllerConfig<S, M, Services>;
+    trx?: TrxEngineConfig<S, S['modules'][M], any, Services>;
+};
+export type AppConfig<S extends $Space, Modules extends ModuleName<S>, Services extends Record<string, IService>> = {
     authn?: AppAuthnConfig<S>;
-    buckets?: AppBucketConfig<S, Modules, any>;
-    controllers?: AppControllerConfig<S, Modules, any>;
+    modules?: Partial<{
+        [M in (Modules & keyof S['modules'])]: AppModuleConfig<S, M, Services>;
+    }>;
+    i18n?: AppI18nConfig;
     cli?: CLIConfig<any>;
     compiler?: CompilerConfig;
-    trxEngine?: AppTrxEngineConfig<S, Modules, any>;
-    trash?: AppTrashConfig<S, Modules, any>;
 };
-export type AnyAppConfig = AppConfig<any, any>;
+export type AnyAppConfig = AppConfig<any, any, any>;
 export type AppI18nConfig = {
     [x: string]: ($: Record<string, any>) => string;
 };
 export type AppAuthnConfig<S extends $Space> = {
     [K in keyof S['authnUsers']]: () => AuthnProvider<S['authnUsers'][K]>;
 };
-export type AppBucketConfig<S extends $Space, Modules extends ModuleName<S>, Services extends Record<string, IService>> = Partial<{
-    [M in (Modules & keyof S['modules'])]: Partial<{
-        [K in keyof S['modules'][M]['buckets']]: BucketConfig<S['modules'][M], S['modules'][M]['buckets'][K], Services>;
-    }>;
-}>;
-export type AppTrashConfig<S extends $Space, Modules extends ModuleName<S>, Services extends Record<string, IService>> = Partial<{
-    [M in (Modules & keyof S['modules'])]: {
-        adapter?: (schema: typeof $TrashBucket, services: Services) => BucketAdapter<typeof $TrashBucket['#data']>;
-    };
+export type AppBucketConfig<S extends $Space, M extends keyof S['modules'], Services extends Record<string, IService>> = Partial<{
+    [K in keyof S['modules'][M]['buckets']]: BucketConfig<S['modules'][M], S['modules'][M]['buckets'][K], Services>;
 }>;
-export type AppControllerConfig<S extends $Space, Modules extends ModuleName<S>, Services extends Record<string, IService>> = Partial<{
-    [M in (Modules & keyof S['modules'])]: Partial<{
-        [K in keyof S['modules'][M]['controllers']]: ControllerConfig<S['modules'][M], S['modules'][M]['controllers'][K], Services>;
-    }>;
-}>;
-export type AppTrxEngineConfig<S extends $Space, Modules extends ModuleName<S>, Services extends Record<string, IService>> = Partial<{
-    [M in (Modules & keyof S['modules'])]: TrxEngineConfig<S, S['modules'][M], any, Services>;
+export type AppTrashConfig<Services extends Record<string, IService>> = {
+    adapter?: (schema: typeof $TrashBucket, services: Services) => BucketAdapter<typeof $TrashBucket['#data']>;
+};
+export type AppControllerConfig<S extends $Space, M extends keyof S['modules'], Services extends Record<string, IService>> = Partial<{
+    [K in keyof S['modules'][M]['controllers']]: ControllerConfig<S['modules'][M], S['modules'][M]['controllers'][K], Services>;
 }>;
+export type AppTrxEngineConfig<S extends $Space, M extends keyof S['modules'], Services extends Record<string, IService>> = TrxEngineConfig<S, S['modules'][M], any, Services>;
 export type AppAuditConfig = {
     adapter: ($: Overlay<$Bucket, {
         '#data': NesoiObj;
@@ -60,17 +57,14 @@ export type AppAuditConfig = {
 /**
  * @category App
  */
-export declare class AppConfigFactory<S extends $Space, Modules extends string = ModuleName<S> & string, Services extends Record<string, any> = Record<string, any>, _App = App<S, Modules, Services>> {
+export declare class AppConfigBuilder<S extends $Space, Modules extends string = ModuleName<S> & string, Services extends Record<string, any> = Record<string, any>, _App = App<S, Modules, Services>> {
     private app;
     private config;
     constructor(app: _App);
-    i18n(config: AppI18nConfig): _App;
     authn(config: AppAuthnConfig<S>): _App;
-    buckets(config: AppBucketConfig<S, Modules, Services>): _App;
-    trash(config: AppTrashConfig<S, Modules, Services>): _App;
-    controllers(config: AppControllerConfig<S, Modules, Services>): _App;
+    module<M extends Modules>(name: M, config: AppModuleConfig<S, M, Services>): _App;
     audit(config: AppI18nConfig): _App;
-    compiler(config: CompilerConfig): _App;
+    i18n(config: AppI18nConfig): _App;
     cli(config: CLIConfig<Services>): _App;
-    trx(config: AppTrxEngineConfig<S, Modules, Services>): _App;
+    compiler(config: CompilerConfig): _App;
 }

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

@@ -1,52 +1,42 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AppConfigFactory = void 0;
+exports.AppConfigBuilder = void 0;
 /**
  * Factory
  */
 /**
  * @category App
  */
-class AppConfigFactory {
+class AppConfigBuilder {
     constructor(app) {
         this.app = app;
         this.config = app._config;
     }
-    i18n(config) {
-        this.config.i18n = config;
-        return this.app;
-    }
     authn(config) {
         this.config.authn = config;
         return this.app;
     }
-    buckets(config) {
-        this.config.buckets = config;
-        return this.app;
-    }
-    trash(config) {
-        this.config.trash = config;
-        return this.app;
-    }
-    controllers(config) {
-        this.config.controllers = config;
+    module(name, config) {
+        var _a;
+        (_a = this.config).modules ?? (_a.modules = {});
+        this.config.modules[name] = config;
         return this.app;
     }
     audit(config) {
         this.config.i18n = config;
         return this.app;
     }
-    compiler(config) {
-        this.config.compiler = config;
+    i18n(config) {
+        this.config.i18n = config;
         return this.app;
     }
     cli(config) {
         this.config.cli = config;
         return this.app;
     }
-    trx(config) {
-        this.config.trxEngine = config;
+    compiler(config) {
+        this.config.compiler = config;
         return this.app;
     }
 }
-exports.AppConfigFactory = AppConfigFactory;
+exports.AppConfigBuilder = AppConfigBuilder;

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

@@ -2,8 +2,9 @@ import { $Space, ModuleName } from "../../schema";
 import { AnyBuilder, AnyModule } from '../module';
 import { Space } from '../space';
 import { Daemon } from '../daemon';
-import { AnyAppConfig, AppConfigFactory } from './app.config';
+import { AnyAppConfig, AppConfigBuilder } from './app.config';
 import { IService } from './service';
+import { DistributedAppConfigBuilder } from './distributed/distributed.app.config';
 /**
  * @category App
  */
@@ -37,14 +38,14 @@ export declare abstract class App<S extends $Space, Modules extends string = Mod
      * ⚠ This has no effect on apps without a `Space`, such as `InlineApp`.
      * @param modules A list of names of modules from the current `Space`.
      */
-    modules<M extends ModuleName<S>>(modules: M[]): App<S, M & Modules, Services>;
+    protected modules<M extends ModuleName<S>>(modules: M[]): App<S, M & Modules, Services>;
     /**
      * Injects pre-built modules into this App.
      * These will be included on the Daemon once it starts.
      *
      * @param modules A list of pre-built modules.
      */
-    inject(modules: AnyModule[]): this;
+    protected inject(modules: AnyModule[]): this;
     /**
      * Declares a `Service`.
      *
@@ -52,8 +53,8 @@ export declare abstract class App<S extends $Space, Modules extends string = Mod
      * config to share globals between adapters and other methods.
      * @param $ object with an `up` and `down` method to create/destroy the service
      */
-    service<T extends IService>($: T): App<S, Modules, Services & { [K in T["name"]]: T; }>;
-    get config(): AppConfigFactory<S, Modules, Services>;
+    protected service<T extends IService>($: T): App<S, Modules, Services & { [K in T["name"]]: T; }>;
+    protected get config(): AppConfigBuilder<S, Modules, Services> | DistributedAppConfigBuilder<S, any, Modules, Services>;
     protected makeModules(): Record<string, AnyModule>;
     static getServices(app: AnyApp): Record<string, IService>;
     static getInfo(app: AnyApp): {

package/lib/engine/apps/app.js

@@ -68,7 +68,7 @@ class App {
     }
     //
     get config() {
-        return new app_config_1.AppConfigFactory(this);
+        return new app_config_1.AppConfigBuilder(this);
     }
     // 
     makeModules() {

package/lib/engine/apps/distributed/distributed.app.config.d.ts

@@ -0,0 +1,44 @@
+import { $Space, ModuleName } from "../../../schema";
+import { CompilerConfig } from "../../../compiler/compiler";
+import { AppAuthnConfig, AppI18nConfig, AppConfig, AppControllerConfig, AppTrashConfig } from '../app.config';
+import { CLIConfig } from "../../cli/cli";
+import { IService } from '../service';
+import { DistributedAppNode } from './distributed_node.app';
+import { TrxEngineConfig } from "../../transaction/trx_engine.config";
+import { BucketConfig } from "../../../elements/entities/bucket/bucket.config";
+export type DistributedAppModuleConfig<S extends $Space, M extends ModuleName<S>, Nodes extends Record<string, DistributedAppNode<any, any, any, any>>, Services extends Record<string, IService>> = {
+    buckets?: DistributedAppBucketConfig<S, M, Nodes, Services>;
+    jobs?: DistributedAppJobConfig<S, M, Nodes>;
+    trash?: AppTrashConfig<Services>;
+    controllers?: AppControllerConfig<S, M, Services>;
+    trx?: TrxEngineConfig<S, S['modules'][M], any, Services>;
+};
+export type DistributedAppConfig<S extends $Space, Modules extends ModuleName<S>, Nodes extends Record<string, DistributedAppNode<any, any, any, any>>, Services extends Record<string, IService>> = {
+    authn?: AppAuthnConfig<S>;
+    modules?: Partial<{
+        [M in (Modules & keyof S['modules'])]: DistributedAppModuleConfig<S, M, Nodes, Services>;
+    }>;
+    i18n?: AppI18nConfig;
+    cli?: CLIConfig<any>;
+    compiler?: CompilerConfig;
+};
+export type AnyAppConfig = AppConfig<any, any, any>;
+export type DistributedAppBucketConfig<S extends $Space, M extends keyof S['modules'], Nodes extends Record<string, DistributedAppNode<any, any, any, any>>, Services extends Record<string, IService>> = Partial<{
+    [K in keyof S['modules'][M]['buckets']]: keyof Nodes | BucketConfig<S['modules'][M], S['modules'][M]['buckets'][K], Services>;
+}>;
+export type DistributedAppJobConfig<S extends $Space, M extends keyof S['modules'], Nodes extends Record<string, DistributedAppNode<any, any, any, any>>> = Partial<{
+    [K in keyof S['modules'][M]['jobs']]: keyof Nodes;
+}>;
+/**
+ * @category DistributedApp
+ */
+export declare class DistributedAppConfigBuilder<S extends $Space, Nodes extends Record<string, DistributedAppNode<any, any, any, any>>, Modules extends string = ModuleName<S> & string, Services extends Record<string, any> = Record<string, any>> {
+    private node;
+    constructor(node: DistributedAppNode<S, Nodes, Modules, Services>);
+    authn(config: AppAuthnConfig<S>): DistributedAppNode<S, Nodes, Modules, Services>;
+    module<M extends Modules>(name: M, config: DistributedAppModuleConfig<S, M, Nodes, Services>): DistributedAppNode<S, Nodes, Modules, Services>;
+    audit(config: AppI18nConfig): DistributedAppNode<S, Nodes, Modules, Services>;
+    i18n(config: AppI18nConfig): DistributedAppNode<S, Nodes, Modules, Services>;
+    cli(config: CLIConfig<Services>): DistributedAppNode<S, Nodes, Modules, Services>;
+    compiler(config: CompilerConfig): DistributedAppNode<S, Nodes, Modules, Services>;
+}

package/lib/engine/apps/distributed/distributed.app.config.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DistributedAppConfigBuilder = void 0;
+/**
+ * @category DistributedApp
+ */
+class DistributedAppConfigBuilder {
+    constructor(node) {
+        this.node = node;
+    }
+    authn(config) {
+        // TODO
+        return this.node;
+    }
+    module(name, config) {
+        // TODO
+        return this.node;
+    }
+    audit(config) {
+        // TODO
+        return this.node;
+    }
+    i18n(config) {
+        // TODO
+        return this.node;
+    }
+    cli(config) {
+        // TODO
+        return this.node;
+    }
+    compiler(config) {
+        // TODO
+        return this.node;
+    }
+}
+exports.DistributedAppConfigBuilder = DistributedAppConfigBuilder;