@arkstack/contract 0.11.0 → 0.11.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +5 -2
- package/dist/index.js +31 -0
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/dist/index.d.ts
CHANGED
|
@@ -39,14 +39,17 @@ type PromiseOrValue<T> = T | Promise<T>;
|
|
|
39
39
|
type ENV = 'development' | 'production' | 'stagging' | 'testing';
|
|
40
40
|
type RootDirChangeListener = (dir: string, previousDir: string) => void;
|
|
41
41
|
declare abstract class Arkstack<TApp, TRoutes = unknown, THandler = unknown> {
|
|
42
|
+
static app: unknown;
|
|
42
43
|
private static appRootDir;
|
|
43
44
|
protected app: TApp;
|
|
44
45
|
protected driver: ArkstackKitDriver<TApp, THandler>;
|
|
45
|
-
abstract getAppInstance(): TApp;
|
|
46
46
|
abstract getRouter(): ArkstackRouterContract<TApp, TRoutes>;
|
|
47
47
|
abstract boot(port: number, dontStart?: boolean): Promise<void>;
|
|
48
|
-
|
|
48
|
+
getAppInstance(): TApp;
|
|
49
|
+
static getAppInstance<TApp = unknown>(): TApp;
|
|
50
|
+
getDriver(): ArkstackKitDriver<TApp, THandler>;
|
|
49
51
|
startup(defaultPort?: number, dontStart?: boolean): Promise<void>;
|
|
52
|
+
shutdown(): Promise<void>;
|
|
50
53
|
static rootDir(): string;
|
|
51
54
|
rootDir(): string;
|
|
52
55
|
static getRootDir(): string;
|
package/dist/index.js
CHANGED
|
@@ -1,10 +1,35 @@
|
|
|
1
1
|
import { Hook } from "@arkstack/foundry";
|
|
2
2
|
//#region src/Arkstack.ts
|
|
3
3
|
var Arkstack = class Arkstack {
|
|
4
|
+
static app;
|
|
4
5
|
static appRootDir = process.cwd();
|
|
5
6
|
app;
|
|
6
7
|
driver;
|
|
7
8
|
/**
|
|
9
|
+
* Gets the driver application instance.
|
|
10
|
+
*
|
|
11
|
+
* @returns
|
|
12
|
+
*/
|
|
13
|
+
getAppInstance() {
|
|
14
|
+
return this.app;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Gets the static driver application instance.
|
|
18
|
+
*
|
|
19
|
+
* @returns
|
|
20
|
+
*/
|
|
21
|
+
static getAppInstance() {
|
|
22
|
+
return Arkstack.app;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* Gets the ArkstackKitDriver instance used by the application.
|
|
26
|
+
*
|
|
27
|
+
* @returns
|
|
28
|
+
*/
|
|
29
|
+
getDriver() {
|
|
30
|
+
return this.driver;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
8
33
|
* Boostrap the app and start up the server
|
|
9
34
|
*
|
|
10
35
|
* @param defaultPort start the server with this port if none is APP_PORT env variable is not set
|
|
@@ -17,6 +42,12 @@ var Arkstack = class Arkstack {
|
|
|
17
42
|
}, Number(process.env.APP_PORT ?? defaultPort), this);
|
|
18
43
|
}
|
|
19
44
|
/**
|
|
45
|
+
* Shuts down the application by disconnecting from the database and exiting the process.
|
|
46
|
+
*/
|
|
47
|
+
async shutdown() {
|
|
48
|
+
process.exit(0);
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
20
51
|
* Get the current app root directory
|
|
21
52
|
*
|
|
22
53
|
* @alias getRootDir()
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../src/Arkstack.ts","../src/kits.ts"],"sourcesContent":["import { ArkstackKitDriver } from './kits'\nimport { ArkstackRouterContract } from './routing'\nimport { Hook } from '@arkstack/foundry'\n\nexport type PromiseOrValue<T> = T | Promise<T>;\n\nexport type ENV = 'development' | 'production' | 'stagging' | 'testing'\nexport type RootDirChangeListener = (dir: string, previousDir: string) => void\n\nexport abstract class Arkstack<TApp, TRoutes = unknown, THandler = unknown> {\n private static appRootDir: string = process.cwd()\n protected app!: TApp\n protected driver!: ArkstackKitDriver<TApp, THandler>\n\n abstract
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../src/Arkstack.ts","../src/kits.ts"],"sourcesContent":["import { ArkstackKitDriver } from './kits'\nimport { ArkstackRouterContract } from './routing'\nimport { Hook } from '@arkstack/foundry'\n\nexport type PromiseOrValue<T> = T | Promise<T>;\n\nexport type ENV = 'development' | 'production' | 'stagging' | 'testing'\nexport type RootDirChangeListener = (dir: string, previousDir: string) => void\n\nexport abstract class Arkstack<TApp, TRoutes = unknown, THandler = unknown> {\n static app: unknown\n private static appRootDir: string = process.cwd()\n protected app!: TApp\n protected driver!: ArkstackKitDriver<TApp, THandler>\n\n abstract getRouter (): ArkstackRouterContract<TApp, TRoutes>;\n /**\n * Boots the application by mounting public assets, binding the \n * router, applying middleware, and starting the server.\n * \n * @param port The numeric port to run the server on\n * @param dontStart Set to true to skip server startup\n */\n abstract boot (port: number, dontStart?: boolean): Promise<void>\n\n /**\n * Gets the driver application instance.\n * \n * @returns \n */\n getAppInstance () {\n return this.app\n }\n\n /**\n * Gets the static driver application instance.\n * \n * @returns \n */\n static getAppInstance<TApp = unknown> (): TApp {\n return Arkstack.app as TApp\n }\n\n /**\n * Gets the ArkstackKitDriver instance used by the application.\n * \n * @returns \n */\n getDriver () {\n return this.driver\n }\n\n /**\n * Boostrap the app and start up the server\n * \n * @param defaultPort start the server with this port if none is APP_PORT env variable is not set\n * @param dontStart Set to true to skip server startup\n */\n async startup (defaultPort: number = 3000, dontStart?: boolean) {\n const { bootWithDetectedPort } = await import('@arkstack/common')\n await bootWithDetectedPort<TApp, TRoutes, THandler>(async (port) => {\n await this.boot(port, dontStart)\n }, Number(process.env.APP_PORT ?? defaultPort), this as never)\n }\n\n /**\n * Shuts down the application by disconnecting from the database and exiting the process.\n */\n async shutdown () {\n process.exit(0)\n }\n\n /**\n * Get the current app root directory\n * \n * @alias getRootDir()\n * @returns\n */\n static rootDir (): string {\n return Arkstack.appRootDir\n }\n\n /**\n * Get the current app root directory\n * \n * @alias getRootDir()\n * @returns\n */\n rootDir (): string {\n return Arkstack.appRootDir\n }\n\n /**\n * Get the current app root directory\n * \n * @returns\n */\n static getRootDir (): string {\n return Arkstack.appRootDir\n }\n\n /**\n * Set the current app root directory\n * \n * @param dir The prefered app root directory\n * @returns\n */\n setRootDir (dir: string): void {\n Arkstack.setRootDir(dir)\n }\n\n /**\n * Set the current app root directory\n * \n * @param dir The prefered app root directory\n * @returns\n */\n static setRootDir (dir: string): void {\n const previousDir = Arkstack.appRootDir\n Arkstack.appRootDir = dir\n\n if (previousDir === dir) {\n return\n }\n\n if (Hook.has('set:root-dir', 'after'))\n Hook.get('set:root-dir', 'after', dir)\n }\n}\n","import { ArkstackMiddlewareConfig } from './http'\nimport { PromiseOrValue } from './Arkstack'\n\n/**\n * The ArkstackKitDriver class defines the contract for a driver \n * that can be used with the ArkstackKitContract. \n */\nexport abstract class ArkstackKitDriver<TApp, TMiddleware> {\n abstract readonly name: string;\n abstract createApp (): TApp;\n abstract mountPublicAssets (app: TApp, publicPath: string): PromiseOrValue<void>;\n abstract bindRouter (app: TApp): PromiseOrValue<void>;\n abstract applyMiddleware (app: TApp, middleware: ArkstackMiddlewareConfig<TMiddleware>): PromiseOrValue<void>;\n abstract applyMiddleware (app: TApp, middleware: TMiddleware): PromiseOrValue<void>;\n registerErrorHandler (_app: TApp): PromiseOrValue<void> {\n return\n }\n abstract start (app: TApp, port: number): PromiseOrValue<void>;\n}\n\n/**\n * The ArkstackKitContract class defines the contract for an \n * application that uses the ArkstackKitDriver.\n */\nexport abstract class ArkstackKitContract<TApp, TMiddleware> {\n abstract app: TApp;\n abstract driver: ArkstackKitDriver<TApp, TMiddleware>;\n abstract middleware: ArkstackMiddlewareConfig<TMiddleware>;\n abstract boot (port: number): Promise<void>;\n abstract shutdown (): Promise<void>;\n}"],"mappings":";;AASA,IAAsB,WAAtB,MAAsB,SAAsD;CACxE,OAAO;CACP,OAAe,aAAqB,QAAQ,KAAK;CACjD;CACA;;;;;;CAiBA,iBAAkB;EACd,OAAO,KAAK;;;;;;;CAQhB,OAAO,iBAAwC;EAC3C,OAAO,SAAS;;;;;;;CAQpB,YAAa;EACT,OAAO,KAAK;;;;;;;;CAShB,MAAM,QAAS,cAAsB,KAAM,WAAqB;EAC5D,MAAM,EAAE,yBAAyB,MAAM,OAAO;EAC9C,MAAM,qBAA8C,OAAO,SAAS;GAChE,MAAM,KAAK,KAAK,MAAM,UAAU;KACjC,OAAO,QAAQ,IAAI,YAAY,YAAY,EAAE,KAAc;;;;;CAMlE,MAAM,WAAY;EACd,QAAQ,KAAK,EAAE;;;;;;;;CASnB,OAAO,UAAmB;EACtB,OAAO,SAAS;;;;;;;;CASpB,UAAmB;EACf,OAAO,SAAS;;;;;;;CAQpB,OAAO,aAAsB;EACzB,OAAO,SAAS;;;;;;;;CASpB,WAAY,KAAmB;EAC3B,SAAS,WAAW,IAAI;;;;;;;;CAS5B,OAAO,WAAY,KAAmB;EAClC,MAAM,cAAc,SAAS;EAC7B,SAAS,aAAa;EAEtB,IAAI,gBAAgB,KAChB;EAGJ,IAAI,KAAK,IAAI,gBAAgB,QAAQ,EACjC,KAAK,IAAI,gBAAgB,SAAS,IAAI;;;;;;;;;ACvHlD,IAAsB,oBAAtB,MAA2D;CAOvD,qBAAsB,MAAkC;;;;;;AAU5D,IAAsB,sBAAtB,MAA6D"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@arkstack/contract",
|
|
3
|
-
"version": "0.11.
|
|
3
|
+
"version": "0.11.1",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "Contract module for Arkstack, providing shared interfaces and type contracts used across the framework.",
|
|
6
6
|
"homepage": "https://arkstack.toneflix.net",
|
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
"./package.json": "./package.json"
|
|
29
29
|
},
|
|
30
30
|
"dependencies": {
|
|
31
|
-
"@arkstack/foundry": "^0.11.
|
|
31
|
+
"@arkstack/foundry": "^0.11.1"
|
|
32
32
|
},
|
|
33
33
|
"scripts": {
|
|
34
34
|
"build": "tsdown --config-loader unrun",
|