nesoi 3.0.8 → 3.0.10

package/lib/elements/entities/constants/constants.schema.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.$Constants = exports.$ConstantEnum = exports.$ConstantEnumOption = exports.$ConstantValue = void 0;
+/**
+ * @category Schemas
+ * @subcategory Entity
+ * */
 class $ConstantValue {
     constructor(scope, key, value) {
         this.scope = scope;
@@ -9,6 +13,10 @@ class $ConstantValue {
     }
 }
 exports.$ConstantValue = $ConstantValue;
+/**
+ * @category Schemas
+ * @subcategory Entity
+ * */
 class $ConstantEnumOption {
     constructor(key, value) {
         this.key = key;
@@ -16,6 +24,10 @@ class $ConstantEnumOption {
     }
 }
 exports.$ConstantEnumOption = $ConstantEnumOption;
+/**
+ * @category Schemas
+ * @subcategory Entity
+ * */
 class $ConstantEnum {
     constructor(name, options) {
         this.name = name;
@@ -29,6 +41,10 @@ class $ConstantEnum {
     }
 }
 exports.$ConstantEnum = $ConstantEnum;
+/**
+ * @category Schemas
+ * @subcategory Entity
+ * */
 class $Constants {
     constructor(name, values = {}, enums = {}) {
         this.name = name;

package/lib/elements/entities/drive/drive_adapter.d.ts

@@ -3,17 +3,21 @@ export type DriveAdapterConfig = {
     hashAlgorithm?: 'sha1' | 'md5' | 'sha256';
     maxsize?: number;
 };
+/**
+ * @category Adapters
+ * @subcategory Entity
+ * */
 export declare abstract class DriveAdapter {
-    dirpath: string;
     config: DriveAdapterConfig;
-    constructor(dirpath: string, config?: DriveAdapterConfig);
+    constructor(config?: DriveAdapterConfig);
     /**
      * Return a public reference to the file as a string, which
      *  can be used outside the application to reach it.
      *
-     * @returns A `string` which publicly refers to the file
+     * @param filename An optional filename to use on Content-Disposition header
+     * @returns A list of `string` which publicly refers to the files
      */
-    abstract public(remoteFile: NesoiFile[]): Promise<string[]>;
+    abstract public(remoteFile: NesoiFile, filename?: string): Promise<string>;
     /**
      * Read one file from the Drive, given a NesoiFile specifier.
      *
@@ -25,20 +29,21 @@ export declare abstract class DriveAdapter {
      */
     abstract delete(remoteFile: NesoiFile): Promise<void>;
     /**
-     * Move a file inside the Drive
+     * Move a file within the Drive
      */
     abstract move(remoteFile: NesoiFile, newRemotePath: string): Promise<void>;
     /**
      * Create a new file on the Drive, from the contents.
      *
-     * @returns A new `NesoiFile` which refers to the Drive
+     * @returns A new `NesoiFile` referencing a file on the Drive
      */
-    abstract new(filepath: string, data: string | NodeJS.ArrayBufferView): Promise<NesoiFile>;
+    abstract new(filename: string, data: string | NodeJS.ArrayBufferView, dirpath?: string): Promise<NesoiFile>;
     /**
      * Copy a local file to the Drive
-     * - Fails if a file with the same name exists on the target dirpath of the Drive
+     * - Should fail if a file with the same name exists on the target dirpath of the Drive
+     * - Should preserve originalFilename, extname and mimetype
      *
-     * @returns A new `NesoiFile` which refers to the Drive
+     * @returns A new `NesoiFile` referencing a file on the Drive
      */
-    abstract copy(localFile: NesoiFile, dirpath: string, newFilename?: string): Promise<NesoiFile>;
+    abstract upload(localFile: NesoiFile, dirpath?: string, newFilename?: string): Promise<NesoiFile>;
 }

package/lib/elements/entities/drive/drive_adapter.js

@@ -1,9 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DriveAdapter = void 0;
+/**
+ * @category Adapters
+ * @subcategory Entity
+ * */
 class DriveAdapter {
-    constructor(dirpath, config = {}) {
-        this.dirpath = dirpath;
+    constructor(config = {}) {
         this.config = config;
     }
 }

package/lib/elements/entities/drive/local.drive_adapter.d.ts

@@ -1,10 +1,16 @@
 import { NesoiFile } from "../../../engine/data/file";
-import { DriveAdapter } from './drive_adapter';
+import { DriveAdapter, DriveAdapterConfig } from './drive_adapter';
+/**
+ * @category Adapters
+ * @subcategory Entity
+ * */
 export declare class LocalDriveAdapter extends DriveAdapter {
-    public(remoteFiles: NesoiFile[]): Promise<string[]>;
+    dirpath: string;
+    constructor(dirpath: string, config?: DriveAdapterConfig);
+    public(remoteFile: NesoiFile): Promise<string>;
     read(remoteFile: NesoiFile): Promise<Buffer>;
     delete(remoteFile: NesoiFile): Promise<void>;
     move(remoteFile: NesoiFile, remotePath: string): Promise<void>;
-    new(filepath: string, data: string | NodeJS.ArrayBufferView): Promise<NesoiFile>;
-    copy(localFile: NesoiFile, dirpath: string): Promise<NesoiFile>;
+    new(filename: string, data: string | NodeJS.ArrayBufferView, dirpath?: string): Promise<NesoiFile>;
+    upload(localFile: NesoiFile, dirpath?: string, newFilename?: string): Promise<NesoiFile>;
 }

package/lib/elements/entities/drive/local.drive_adapter.js

@@ -8,9 +8,17 @@ const file_1 = require("../../../engine/data/file");
 const drive_adapter_1 = require("./drive_adapter");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+/**
+ * @category Adapters
+ * @subcategory Entity
+ * */
 class LocalDriveAdapter extends drive_adapter_1.DriveAdapter {
-    public(remoteFiles) {
-        return Promise.resolve(remoteFiles.map(file => path_1.default.join(process.cwd(), file.filepath)));
+    constructor(dirpath, config) {
+        super(config);
+        this.dirpath = dirpath;
+    }
+    public(remoteFile) {
+        return Promise.resolve('file://' + path_1.default.join(process.cwd(), remoteFile.filepath));
     }
     read(remoteFile) {
         return Promise.resolve(fs_1.default.readFileSync(remoteFile.filepath));
@@ -21,14 +29,21 @@ class LocalDriveAdapter extends drive_adapter_1.DriveAdapter {
     move(remoteFile, remotePath) {
         return Promise.resolve(fs_1.default.renameSync(remoteFile.filepath, remotePath));
     }
-    async new(filepath, data) {
-        fs_1.default.writeFileSync(filepath, data);
-        return new file_1.NesoiFile(filepath);
+    async new(filename, data, dirpath) {
+        dirpath = dirpath ? path_1.default.join(this.dirpath, dirpath) : this.dirpath;
+        const remoteFilepath = path_1.default.join(dirpath, filename);
+        fs_1.default.writeFileSync(remoteFilepath, data);
+        return file_1.NesoiFile.local.from(remoteFilepath);
     }
-    async copy(localFile, dirpath) {
-        const remoteFilepath = path_1.default.join(dirpath, localFile.newFilename);
+    async upload(localFile, dirpath, newFilename) {
+        dirpath = dirpath ? path_1.default.join(this.dirpath, dirpath) : this.dirpath;
+        const remoteFilepath = path_1.default.join(dirpath, newFilename || localFile.filename);
         fs_1.default.copyFileSync(localFile.filepath, remoteFilepath);
-        return new file_1.NesoiFile(remoteFilepath, { originalFilename: localFile.originalFilename });
+        return file_1.NesoiFile.local.from(remoteFilepath, {
+            originalFilename: localFile.originalFilename,
+            extname: localFile.extname,
+            mimetype: localFile.mimetype
+        });
     }
 }
 exports.LocalDriveAdapter = LocalDriveAdapter;

package/lib/elements/entities/message/message.builder.d.ts

@@ -4,6 +4,10 @@ import { MessageTemplateDef } from './template/message_template.builder';
 import { $MessageInfer } from './message.infer';
 import { ModuleTree } from "../../../engine/tree";
 import { ResolvedBuilderNode } from "../../../engine/dependency";
+/**
+ * @category Builders
+ * @subcategory Entity
+ * */
 export declare class MessageBuilder<Space extends $Space, Module extends $Module, Message extends $Message = $Message> {
     private module;
     private name;

package/lib/elements/entities/message/message.builder.js

@@ -5,6 +5,10 @@ const message_schema_1 = require("./message.schema");
 const message_template_schema_1 = require("./template/message_template.schema");
 const message_template_builder_1 = require("./template/message_template.builder");
 const message_template_field_builder_1 = require("./template/message_template_field.builder");
+/**
+ * @category Builders
+ * @subcategory Entity
+ * */
 class MessageBuilder {
     constructor(module, name) {
         this.module = module;

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

@@ -1,4 +1,8 @@
 import { $Message as $Message } from './message.schema';
+/**
+ * @category Elements
+ * @subcategory Entity
+ * */
 export declare class Message<$ extends $Message> {
     $: string;
     private __meta__;

package/lib/elements/entities/message/message.js

@@ -5,6 +5,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Message = void 0;
 const crypto_1 = __importDefault(require("crypto"));
+/**
+ * @category Elements
+ * @subcategory Entity
+ * */
 class Message {
     constructor(_$, data, sigKey) {
         this.$ = _$;

package/lib/elements/entities/message/message.schema.d.ts

@@ -1,4 +1,8 @@
 import { $MessageTemplate } from './template/message_template.schema';
+/**
+ * @category Schemas
+ * @subcategory Entity
+ * */
 export declare class $Message {
     module: string;
     name: string;

package/lib/elements/entities/message/message.schema.js

@@ -2,6 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.$Message = void 0;
 const string_1 = require("../../../engine/util/string");
+/**
+ * @category Schemas
+ * @subcategory Entity
+ * */
 class $Message {
     constructor(module, name, alias, template) {
         this.module = module;

package/lib/elements/entities/message/message_parser.d.ts

@@ -2,6 +2,10 @@ import { AnyTrxNode } from "../../../engine/transaction/trx_node";
 import { RawMessageInput } from "../../../schema";
 import { Message } from './message';
 import { $Message } from './message.schema';
+/**
+ * @category Elements
+ * @subcategory Entity
+ * */
 export declare class MessageParser<$ extends $Message> {
     schema: $;
     constructor(schema: $);

package/lib/elements/entities/message/message_parser.js

@@ -6,6 +6,10 @@ const error_1 = require("../../../engine/data/error");
 const message_1 = require("./message");
 const log_1 = require("../../../engine/util/log");
 const message_template_parser_1 = require("./template/message_template_parser");
+/**
+ * @category Elements
+ * @subcategory Entity
+ * */
 class MessageParser {
     constructor(schema) {
         this.schema = schema;

package/lib/elements/entities/message/template/message_template.builder.d.ts

@@ -2,6 +2,10 @@ import { $Module, $Space } from "../../../../schema";
 import { $MessageTemplate } from './message_template.schema';
 import { MessageTemplateFieldBuilders, MessageTemplateFieldFactory } from './message_template_field.builder';
 import { ModuleTree } from "../../../../engine/tree";
+/**
+ * @category Builders
+ * @subcategory Entity
+ * */
 export declare class MessageTemplateBuilder {
     private _fields;
     constructor();

package/lib/elements/entities/message/template/message_template.builder.js

@@ -3,6 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MessageTemplateBuilder = void 0;
 const message_template_schema_1 = require("./message_template.schema");
 const message_template_field_builder_1 = require("./message_template_field.builder");
+/**
+ * @category Builders
+ * @subcategory Entity
+ * */
 class MessageTemplateBuilder {
     constructor() {
         this._fields = {};

package/lib/elements/entities/message/template/message_template.schema.d.ts

@@ -31,6 +31,10 @@ export type $MessageTemplateFieldMeta = {
     msg?: $Dependency;
 };
 export type $MessageTemplateFieldType = $BucketModelFieldType | 'string_or_number' | 'id' | 'msg';
+/**
+ * @category Schemas
+ * @subcategory Entity
+ * */
 export declare class $MessageTemplateField {
     type: $MessageTemplateFieldType;
     name: string;
@@ -52,8 +56,13 @@ export declare class $MessageTemplateField {
 export type $MessageTemplateFields = {
     [x: string]: $MessageTemplateField;
 };
+/**
+ * @category Schemas
+ * @subcategory Entity
+ * */
 export declare class $MessageTemplate {
     fields: $MessageTemplateFields;
     $t: string;
     constructor(fields?: $MessageTemplateFields);
+    static fieldsOfType(template: $MessageTemplate, type: $MessageTemplateFieldType): $MessageTemplateField[];
 }

package/lib/elements/entities/message/template/message_template.schema.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.$MessageTemplate = exports.$MessageTemplateField = void 0;
+/**
+ * @category Schemas
+ * @subcategory Entity
+ * */
 class $MessageTemplateField {
     constructor(type, name, alias, path, array, required, defaultValue, nullable, rules, meta, children, or) {
         this.type = type;
@@ -19,10 +23,31 @@ class $MessageTemplateField {
     }
 }
 exports.$MessageTemplateField = $MessageTemplateField;
+/**
+ * @category Schemas
+ * @subcategory Entity
+ * */
 class $MessageTemplate {
     constructor(fields = {}) {
         this.fields = fields;
         this.$t = 'message.template';
     }
+    static fieldsOfType(template, type) {
+        const fields = [];
+        let poll = Object.values(template.fields);
+        while (poll.length) {
+            const next = [];
+            for (const field of poll) {
+                if (field.type === type) {
+                    fields.push(field);
+                }
+                if (field.children) {
+                    next.push(...Object.values(field.children));
+                }
+            }
+            poll = next;
+        }
+        return fields;
+    }
 }
 exports.$MessageTemplate = $MessageTemplate;

package/lib/elements/entities/message/template/message_template_field.builder.d.ts

@@ -9,6 +9,10 @@ import { MessageEnumpath } from '../../constants/constants.schema';
 import { NesoiDecimal } from "../../../../engine/data/decimal";
 import { NesoiDatetime } from "../../../../engine/data/datetime";
 import { NesoiFile } from "../../../../engine/data/file";
+/**
+ * @category Builders
+ * @subcategory Entity
+ * */
 export declare class MessageTemplateFieldFactory<Space extends $Space, Module extends $Module, MsgName extends keyof Module['messages'], Message extends $Message = Module['messages'][MsgName]> {
     private module;
     private alias?;
@@ -197,6 +201,10 @@ export declare class MessageTemplateFieldFactory<Space extends $Space, Module ex
     }, {}, [never, never], [never, never]>;
     extend<MsgName extends keyof Module['messages'], Builders extends MessageTemplateFieldBuilders>(name: MsgName, fields: Builders): $MessageTemplateBuilderInfer<Module, Module["messages"][MsgName], Module["messages"][MsgName]["#raw"], Module["messages"][MsgName]["#parsed"]> & Builders;
 }
+/**
+ * @category Builders
+ * @subcategory Entity
+ * */
 export declare class MessageTemplateFieldBuilder<Module extends $Module, Message extends $Message, DefinedInput, DefinedOutput, Children extends MessageTemplateFieldBuilders, Optional extends [undefined | never, undefined | never] = [never, never], // Used to infer the message type
 Nullable extends [null | never, null | never] = [never, never]> {
     private type;

package/lib/elements/entities/message/template/message_template_field.builder.js

@@ -4,6 +4,10 @@ exports.MessageTemplateFieldBuilder = exports.MessageTemplateFieldFactory = void
 const message_template_schema_1 = require("./message_template.schema");
 const error_1 = require("../../../../engine/data/error");
 const dependency_1 = require("../../../../engine/dependency");
+/**
+ * @category Builders
+ * @subcategory Entity
+ * */
 class MessageTemplateFieldFactory {
     constructor(module) {
         this.module = module;
@@ -81,6 +85,10 @@ class MessageTemplateFieldFactory {
     }
 }
 exports.MessageTemplateFieldFactory = MessageTemplateFieldFactory;
+/**
+ * @category Builders
+ * @subcategory Entity
+ * */
 class MessageTemplateFieldBuilder {
     constructor(type, value, alias, children) {
         this.type = type;

package/lib/elements/index.d.ts

@@ -7,5 +7,5 @@ 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 { $Externals } from './blocks/externals/externals.schema';
+export { $Externals } from './edge/externals/externals.schema';
 export { $Space, $Module } from '../schema';

package/lib/elements/index.js

@@ -19,5 +19,5 @@ 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 externals_schema_1 = require("./blocks/externals/externals.schema");
+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/app.config.d.ts

@@ -5,6 +5,7 @@ import { ControllerConfig } from "../../elements/edge/controller/controller.conf
 import { TrxEngineConfig } from '../transaction/trx_engine.config';
 import { CompilerConfig } from "../../compiler/compiler";
 import { App } from './app';
+import { IService } from './service';
 import { CLIConfig } from '../cli/cli';
 import { BucketAdapter } from "../../elements/entities/bucket/adapters/bucket_adapter";
 import { TrashObj } from '../data/trash';
@@ -27,9 +28,9 @@ export type AppI18nConfig = {
 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>, Providers extends Record<string, any>> = Partial<{
+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], Providers>;
+        [K in keyof S['modules'][M]['buckets']]: BucketConfig<S['modules'][M], S['modules'][M]['buckets'][K], Services>;
     }>;
 }>;
 export type AppTrashConfig = {
@@ -37,13 +38,13 @@ export type AppTrashConfig = {
         '#data': TrashObj;
     }>) => BucketAdapter<TrashObj>;
 };
-export type AppControllerConfig<S extends $Space, Modules extends ModuleName<S>, Providers extends Record<string, any>> = Partial<{
+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]['controllers'][K], Providers>;
+        [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>, Providers extends Record<string, any>> = Partial<{
-    [M in (Modules & keyof S['modules'])]: TrxEngineConfig<S, S['modules'][M], any, Providers>;
+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 AppAuditConfig = {
     adapter: ($: Overlay<$Bucket, {
@@ -54,17 +55,20 @@ export type AppAuditConfig = {
 /**
  * Factory
  */
-export declare class AppConfigFactory<S extends $Space, Modules extends string = ModuleName<S> & string, Providers extends Record<string, any> = Record<string, any>, _App = App<S, Modules, Providers>> {
+/**
+ * @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>> {
     private app;
     private config;
     constructor(app: _App);
     i18n(config: AppI18nConfig): _App;
     authn(config: AppAuthnConfig<S>): _App;
-    buckets(config: AppBucketConfig<S, Modules, Providers>): _App;
+    buckets(config: AppBucketConfig<S, Modules, Services>): _App;
     trash(config: AppTrashConfig): _App;
-    controllers(config: AppControllerConfig<S, Modules, Providers>): _App;
+    controllers(config: AppControllerConfig<S, Modules, Services>): _App;
     audit(config: AppI18nConfig): _App;
     compiler(config: CompilerConfig): _App;
-    cli(config: CLIConfig<Providers>): _App;
-    trx(config: AppTrxEngineConfig<S, Modules, Providers>): _App;
+    cli(config: CLIConfig<Services>): _App;
+    trx(config: AppTrxEngineConfig<S, Modules, Services>): _App;
 }

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

@@ -4,6 +4,9 @@ exports.AppConfigFactory = void 0;
 /**
  * Factory
  */
+/**
+ * @category App
+ */
 class AppConfigFactory {
     constructor(app) {
         this.app = app;

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

@@ -3,24 +3,16 @@ import { AnyBuilder, AnyModule } from '../module';
 import { Space } from '../space';
 import { Daemon } from '../daemon';
 import { AnyAppConfig, AppConfigFactory } from './app.config';
+import { IService } from './service';
 /**
- * Provider
+ * @category App
  */
-export type AppProvider<out Name, T> = {
-    name: Name;
-    up: ($: {
-        modules: Record<string, AnyModule>;
-    }) => T;
-    down: (provider: NoInfer<T>) => any;
-    libPaths?: string[];
-};
-export type AnyAppProvider = AppProvider<any, any>;
-export declare abstract class App<S extends $Space, Modules extends string = ModuleName<S> & string, Providers extends Record<string, any> = Record<string, any>> {
+export declare abstract class App<S extends $Space, Modules extends string = ModuleName<S> & string, Services extends Record<string, any> = Record<string, any>> {
     name: string;
     protected _config: AnyAppConfig;
     protected _spaceModuleNames: ModuleName<S>[];
     protected _injectedModules: AnyModule[];
-    protected _providers: Record<string, AnyAppProvider>;
+    protected _services: Record<string, IService>;
     protected space?: Space<S>;
     protected builders?: AnyBuilder[];
     constructor(name: string, boot?: {
@@ -34,7 +26,7 @@ export declare abstract class App<S extends $Space, Modules extends string = Mod
      * This can be run without await before the daemon,
      * to preload the module in background.
      */
-    abstract boot(): App<S, Modules, Providers>;
+    abstract boot(): App<S, Modules, Services>;
     /**
      * Spawn a daemon for this app.
      */
@@ -45,7 +37,7 @@ 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, Providers>;
+    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.
@@ -54,16 +46,16 @@ export declare abstract class App<S extends $Space, Modules extends string = Mod
      */
     inject(modules: AnyModule[]): this;
     /**
-     * Declares a `Provider` with a given name.
+     * Declares a `Service`.
      *
-     * Providers are started and ended along with the daemon, and can be used on the App
+     * Services are started and ended along with the daemon, and can be used on the App
      * config to share globals between adapters and other methods.
-     * @param $ `AppProvider` with an `up` and `down` method to create/destroy the provider.
+     * @param $ object with an `up` and `down` method to create/destroy the service
      */
-    provider<Name extends string, T>($: AppProvider<Name, T>): App<S, Modules, Providers & { [K in Name]: T; }>;
-    get config(): AppConfigFactory<S, Modules, Providers>;
+    service<T extends IService>($: T): App<S, Modules, Services & { [K in T["name"]]: T; }>;
+    get config(): AppConfigFactory<S, Modules, Services>;
     protected makeModules(): Record<string, AnyModule>;
-    static getProviders(app: AnyApp): Record<string, AnyAppProvider>;
+    static getServices(app: AnyApp): Record<string, IService>;
     static getInfo(app: AnyApp): {
         spaceModules: (string | number | symbol)[];
         config: AnyAppConfig;

package/lib/engine/apps/app.js

@@ -7,6 +7,9 @@ const app_config_1 = require("./app.config");
 /*
     App
 */
+/**
+ * @category App
+ */
 class App {
     constructor(name, boot) {
         this.name = name;
@@ -18,10 +21,10 @@ class App {
         // running the daemon. These will be included on the daemon
         // once it's run.
         this._injectedModules = [];
-        // A list of providers, which are created and destroyed
+        // A list of services, which are created and destroyed
         // along with the daemon. These are internally available for
         // blocks - usually used by adapters.
-        this._providers = {};
+        this._services = {};
         if (boot) {
             if ('space' in boot) {
                 this.space = boot.space;
@@ -53,14 +56,14 @@ class App {
         return this;
     }
     /**
-     * Declares a `Provider` with a given name.
+     * Declares a `Service`.
      *
-     * Providers are started and ended along with the daemon, and can be used on the App
+     * Services are started and ended along with the daemon, and can be used on the App
      * config to share globals between adapters and other methods.
-     * @param $ `AppProvider` with an `up` and `down` method to create/destroy the provider.
+     * @param $ object with an `up` and `down` method to create/destroy the service
      */
-    provider($) {
-        this._providers[$.name] = $;
+    service($) {
+        this._services[$.name] = $;
         return this;
     }
     //
@@ -73,7 +76,7 @@ class App {
         if (this.space) {
             space_1.Space.scan(this.space, (name, path) => {
                 if (this._spaceModuleNames.includes(name)) {
-                    modules[name] = new module_1.Module(name, { path });
+                    modules[name] = new module_1.Module(name, { dirpath: path });
                 }
             });
         }
@@ -91,8 +94,8 @@ class App {
         return modules;
     }
     //
-    static getProviders(app) {
-        return app._providers;
+    static getServices(app) {
+        return app._services;
     }
     static getInfo(app) {
         return {