@kurdel/facade 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Andrii Sorokin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+# @kurdel/facade
+
+Simplified **application entry point** for the Kurdel framework.  
+Provides ready-to-use factories for Node and Express runtimes.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @kurdel/facade
+```
+
+---
+
+## 🚀 Usage
+
+```ts
+import { createNodeApplication } from '@kurdel/facade';
+import { Controller, route, Ok } from '@kurdel/core/http';
+
+class HelloController extends Controller {
+  readonly routes = { hello: route({ method: 'GET', path: '/hello' })(this.hello) };
+  async hello() { return Ok({ message: 'Hello, kurdel!' }); }
+}
+
+const app = await createNodeApplication({
+  modules: [{ controllers: [{ use: HelloController }] }],
+});
+app.listen(3000);
+```
+
+---
+
+## 🧩 Exports
+
+| Function                     | Runtime | Description                     |
+| ---------------------------- | ------- | ------------------------------- |
+| `createNodeApplication()`    | Node.js | Uses native HTTP server         |
+| `createExpressApplication()` | Express | Uses Express middleware adapter |
+
+---
+
+## 📄 License
+
+MIT © Andrii Sorokin

package/lib/create-application.d.ts

@@ -0,0 +1,6 @@
+import type { AppConfig, Application } from '@kurdel/core/app';
+/**
+ * Runtime façade that constructs and bootstraps the application,
+ * returning only the public Application interface.
+ */
+export declare function createApplication(config: AppConfig): Promise<Application>;

package/lib/create-application.js

@@ -0,0 +1,11 @@
+import { RuntimeApplication } from '@kurdel/runtime/app';
+/**
+ * Runtime façade that constructs and bootstraps the application,
+ * returning only the public Application interface.
+ */
+export async function createApplication(config) {
+    const app = new RuntimeApplication(config);
+    await app.bootstrap();
+    return app;
+}
+//# sourceMappingURL=create-application.js.map

package/lib/create-application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-application.js","sourceRoot":"","sources":["../src/create-application.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAiB;IACvD,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC;IACtB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/lib/create-express-application.d.ts

@@ -0,0 +1,26 @@
+import type { AppConfig } from '@kurdel/core/app';
+/**
+ * Factory for initializing a Kurdel application on the Express.js platform.
+ *
+ * ## Responsibilities
+ * - Registers the Express-specific platform module (`ExpressPlatformModule`), which provides:
+ *   - `ExpressServerAdapter` — platform-specific `ServerAdapter` implementation
+ *   - `ExpressResponseRenderer` — response renderer compatible with Express `Response`
+ * - Bootstraps a fully platform-agnostic Kurdel `RuntimeApplication` instance
+ *
+ * ## Usage
+ * ```ts
+ * import { createExpressApplication } from '@kurdel/facade';
+ *
+ * const app = await createExpressApplication({
+ *   modules: [MyHttpModule],
+ *   db: false,
+ * });
+ *
+ * const server = app.listen(3000, () => console.log('Running on Express'));
+ * ```
+ *
+ * @param config - Application configuration object (controllers, db, modules, etc.)
+ * @returns Fully configured application instance using the Express runtime.
+ */
+export declare function createExpressApplication({ modules, ...config }: AppConfig): Promise<import("@kurdel/core/app").Application>;

package/lib/create-express-application.js

@@ -0,0 +1,33 @@
+import { ExpressPlatformModule } from '@kurdel/runtime-express/modules';
+import { createApplication } from './create-application.js';
+/**
+ * Factory for initializing a Kurdel application on the Express.js platform.
+ *
+ * ## Responsibilities
+ * - Registers the Express-specific platform module (`ExpressPlatformModule`), which provides:
+ *   - `ExpressServerAdapter` — platform-specific `ServerAdapter` implementation
+ *   - `ExpressResponseRenderer` — response renderer compatible with Express `Response`
+ * - Bootstraps a fully platform-agnostic Kurdel `RuntimeApplication` instance
+ *
+ * ## Usage
+ * ```ts
+ * import { createExpressApplication } from '@kurdel/facade';
+ *
+ * const app = await createExpressApplication({
+ *   modules: [MyHttpModule],
+ *   db: false,
+ * });
+ *
+ * const server = app.listen(3000, () => console.log('Running on Express'));
+ * ```
+ *
+ * @param config - Application configuration object (controllers, db, modules, etc.)
+ * @returns Fully configured application instance using the Express runtime.
+ */
+export function createExpressApplication({ modules = [], ...config }) {
+    return createApplication({
+        ...config,
+        modules: [...modules, ExpressPlatformModule],
+    });
+}
+//# sourceMappingURL=create-express-application.js.map

package/lib/create-express-application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-express-application.js","sourceRoot":"","sources":["../src/create-express-application.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,wBAAwB,CAAC,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,MAAM,EAAa;IAC7E,OAAO,iBAAiB,CAAC;QACvB,GAAG,MAAM;QACT,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,qBAAqB,CAAC;KAC7C,CAAC,CAAC;AACL,CAAC"}

package/lib/create-node-application.d.ts

@@ -0,0 +1,26 @@
+import type { AppConfig } from '@kurdel/core/app';
+/**
+ * Factory for initializing a Kurdel application on the native Node.js platform.
+ *
+ * ## Responsibilities
+ * - Registers the Node-specific platform module (`NodePlatformModule`), which provides:
+ *   - `NativeHttpServerAdapter` — platform-specific `ServerAdapter` implementation
+ *   - `NodeResponseRenderer` — renderer for native Node.js HTTP responses
+ * - Bootstraps a fully platform-agnostic Kurdel `RuntimeApplication` instance
+ *
+ * ## Usage
+ * ```ts
+ * import { createNodeApplication } from '@kurdel/facade';
+ *
+ * const app = await createNodeApplication({
+ *   modules: [MyHttpModule],
+ *   db: false,
+ * });
+ *
+ * const server = app.listen(3000, () => console.log('Running on native Node.js'));
+ * ```
+ *
+ * @param config - Application configuration object (controllers, db, modules, etc.)
+ * @returns Fully configured application instance using the Node.js runtime.
+ */
+export declare function createNodeApplication({ modules, ...config }: AppConfig): Promise<import("@kurdel/core/app").Application>;

package/lib/create-node-application.js

@@ -0,0 +1,33 @@
+import { NodePlatformModule } from '@kurdel/runtime-node/modules';
+import { createApplication } from './create-application.js';
+/**
+ * Factory for initializing a Kurdel application on the native Node.js platform.
+ *
+ * ## Responsibilities
+ * - Registers the Node-specific platform module (`NodePlatformModule`), which provides:
+ *   - `NativeHttpServerAdapter` — platform-specific `ServerAdapter` implementation
+ *   - `NodeResponseRenderer` — renderer for native Node.js HTTP responses
+ * - Bootstraps a fully platform-agnostic Kurdel `RuntimeApplication` instance
+ *
+ * ## Usage
+ * ```ts
+ * import { createNodeApplication } from '@kurdel/facade';
+ *
+ * const app = await createNodeApplication({
+ *   modules: [MyHttpModule],
+ *   db: false,
+ * });
+ *
+ * const server = app.listen(3000, () => console.log('Running on native Node.js'));
+ * ```
+ *
+ * @param config - Application configuration object (controllers, db, modules, etc.)
+ * @returns Fully configured application instance using the Node.js runtime.
+ */
+export function createNodeApplication({ modules = [], ...config }) {
+    return createApplication({
+        ...config,
+        modules: [...modules, NodePlatformModule],
+    });
+}
+//# sourceMappingURL=create-node-application.js.map

package/lib/create-node-application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-node-application.js","sourceRoot":"","sources":["../src/create-node-application.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,MAAM,EAAa;IAC1E,OAAO,iBAAiB,CAAC;QACvB,GAAG,MAAM;QACT,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,kBAAkB,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+export * from './create-application.js';
+export * from './create-node-application.js';
+export * from './create-express-application.js';

package/lib/index.js

@@ -0,0 +1,4 @@
+export * from './create-application.js';
+export * from './create-node-application.js';
+export * from './create-express-application.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@kurdel/facade",
+  "version": "0.1.0-beta.1",
+  "description": "High-level application factories and public facade for Kurdel",
+  "type": "module",
+  "exports": {
+    ".": "./lib/index.js"
+  },
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "files": [
+    "lib"
+  ],
+  "scripts": {
+    "prepack": "npm run build",
+    "test": "vitest run",
+    "test:ui": "vitest",
+    "test:watch": "vitest --watch",
+    "coverage": "vitest run --coverage",
+    "clean": "rimraf lib ../../.cache/tsconfig.facade.build.tsbuildinfo",
+    "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "build:force": "npm run clean && tsc -p tsconfig.build.json --force && tsc-alias -p tsconfig.build.json"
+  },
+  "keywords": [
+    "kurdel",
+    "framework",
+    "application",
+    "http"
+  ],
+  "author": "Andrii Sorokin",
+  "license": "MIT",
+  "engines": {
+    "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ignorantic/kurdel.git",
+    "directory": "packages/facade"
+  },
+  "homepage": "https://github.com/ignorantic/kurdel/tree/main/packages/facade#readme",
+  "bugs": {
+    "url": "https://github.com/ignorantic/kurdel/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "devDependencies": {
+    "@types/node": "^20.9.0",
+    "@types/supertest": "^6.0.3",
+    "@vitest/coverage-v8": "^3.2.4",
+    "rimraf": "^6.0.1",
+    "supertest": "^7.1.4",
+    "tsc-alias": "^1.8.16"
+  },
+  "dependencies": {
+    "@kurdel/core": "0.1.0-beta.1",
+    "@kurdel/runtime": "0.1.0-beta.1",
+    "@kurdel/runtime-express": "0.1.0-beta.1",
+    "@kurdel/runtime-node": "0.1.0-beta.1"
+  }
+}