@moriajs/core 0.1.1

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @moriajs/core@0.1.1 build C:\Codes\node\2026\github\moriajs\packages\core
+> tsc
+

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+
+> @moriajs/core@0.0.1 typecheck C:\Codes\node\2026\github\moriajs\packages\core
+> tsc --noEmit
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Guntur D
+
+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/dist/app.d.ts

@@ -0,0 +1,42 @@
+import { type FastifyInstance, type FastifyServerOptions } from 'fastify';
+import { type MoriaConfig } from './config.js';
+import { type MoriaPlugin } from './plugins.js';
+/**
+ * Options for creating a MoriaJS application.
+ */
+export interface MoriaAppOptions {
+    /** MoriaJS configuration (from moria.config.ts) */
+    config?: Partial<MoriaConfig>;
+    /** Additional Fastify server options */
+    fastifyOptions?: FastifyServerOptions;
+}
+/**
+ * The MoriaJS application instance.
+ * Wraps a Fastify instance with framework-level features.
+ */
+export interface MoriaApp {
+    /** The underlying Fastify instance */
+    server: FastifyInstance;
+    /** Register a MoriaJS plugin */
+    use: (plugin: MoriaPlugin) => Promise<void>;
+    /** Start the server */
+    listen: (options?: {
+        port?: number;
+        host?: string;
+    }) => Promise<string>;
+    /** Stop the server */
+    close: () => Promise<void>;
+}
+/**
+ * Create a new MoriaJS application.
+ *
+ * @example
+ * ```ts
+ * import { createApp } from '@moriajs/core';
+ *
+ * const app = await createApp();
+ * await app.listen({ port: 3000 });
+ * ```
+ */
+export declare function createApp(options?: MoriaAppOptions): Promise<MoriaApp>;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAKnF,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,wCAAwC;IACxC,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACrB,sCAAsC;IACtC,MAAM,EAAE,eAAe,CAAC;IACxB,gCAAgC;IAChC,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,uBAAuB;IACvB,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACxE,sBAAsB;IACtB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA0DhF"}

package/dist/app.js

@@ -0,0 +1,65 @@
+import Fastify from 'fastify';
+import cors from '@fastify/cors';
+import cookie from '@fastify/cookie';
+import compress from '@fastify/compress';
+import helmet from '@fastify/helmet';
+/**
+ * Create a new MoriaJS application.
+ *
+ * @example
+ * ```ts
+ * import { createApp } from '@moriajs/core';
+ *
+ * const app = await createApp();
+ * await app.listen({ port: 3000 });
+ * ```
+ */
+export async function createApp(options = {}) {
+    const config = options.config ?? {};
+    const port = config.server?.port ?? 3000;
+    const host = config.server?.host ?? '0.0.0.0';
+    // Create Fastify instance with sensible defaults
+    const server = Fastify({
+        logger: {
+            level: config.server?.logLevel ?? 'info',
+            transport: process.env.NODE_ENV !== 'production'
+                ? { target: 'pino-pretty', options: { colorize: true } }
+                : undefined,
+        },
+        ...options.fastifyOptions,
+    });
+    // Register core plugins
+    await server.register(cors, {
+        origin: config.server?.cors?.origin ?? true,
+        credentials: config.server?.cors?.credentials ?? true,
+    });
+    await server.register(cookie);
+    await server.register(compress);
+    await server.register(helmet, {
+        // Relax CSP in development for Vite HMR
+        contentSecurityPolicy: process.env.NODE_ENV === 'production',
+    });
+    // Health check route
+    server.get('/health', async () => ({ status: 'ok', timestamp: new Date().toISOString() }));
+    // Plugin registry
+    const plugins = [];
+    const app = {
+        server,
+        async use(plugin) {
+            plugins.push(plugin);
+            await plugin.register({ server, config });
+        },
+        async listen(listenOptions) {
+            const addr = await server.listen({
+                port: listenOptions?.port ?? port,
+                host: listenOptions?.host ?? host,
+            });
+            return addr;
+        },
+        async close() {
+            await server.close();
+        },
+    };
+    return app;
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,OAA4D,MAAM,SAAS,CAAC;AACnF,OAAO,IAAI,MAAM,eAAe,CAAC;AACjC,OAAO,MAAM,MAAM,iBAAiB,CAAC;AACrC,OAAO,QAAQ,MAAM,mBAAmB,CAAC;AACzC,OAAO,MAAM,MAAM,iBAAiB,CAAC;AA6BrC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAA2B,EAAE;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,SAAS,CAAC;IAE9C,iDAAiD;IACjD,MAAM,MAAM,GAAG,OAAO,CAAC;QACnB,MAAM,EAAE;YACJ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,IAAI,MAAM;YACxC,SAAS,EACL,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;gBACjC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;gBACxD,CAAC,CAAC,SAAS;SACtB;QACD,GAAG,OAAO,CAAC,cAAc;KAC5B,CAAC,CAAC;IAEH,wBAAwB;IACxB,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,IAAI;QAC3C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,IAAI,IAAI;KACxD,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;QAC1B,wCAAwC;QACxC,qBAAqB,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;KAC/D,CAAC,CAAC;IAEH,qBAAqB;IACrB,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;IAE3F,kBAAkB;IAClB,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,MAAM,GAAG,GAAa;QAClB,MAAM;QAEN,KAAK,CAAC,GAAG,CAAC,MAAmB;YACzB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,aAAa;YACtB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;gBAC7B,IAAI,EAAE,aAAa,EAAE,IAAI,IAAI,IAAI;gBACjC,IAAI,EAAE,aAAa,EAAE,IAAI,IAAI,IAAI;aACpC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,KAAK,CAAC,KAAK;YACP,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;KACJ,CAAC;IAEF,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,61 @@
+/**
+ * MoriaJS configuration type.
+ * Used in `moria.config.ts` files in user projects.
+ */
+export interface MoriaConfig {
+    /** Server configuration */
+    server?: {
+        /** Port to listen on (default: 3000) */
+        port?: number;
+        /** Host to bind to (default: '0.0.0.0') */
+        host?: string;
+        /** Log level (default: 'info') */
+        logLevel?: 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace' | 'silent';
+        /** CORS configuration */
+        cors?: {
+            origin?: string | string[] | boolean;
+            credentials?: boolean;
+        };
+    };
+    /** Database configuration */
+    database?: {
+        /** Database adapter: 'pg' | 'sqlite' | 'mysql' */
+        adapter?: string;
+        /** Connection URL */
+        url?: string;
+        /** Path to SQLite file (for SQLite adapter) */
+        filename?: string;
+    };
+    /** Authentication configuration */
+    auth?: {
+        /** JWT secret key */
+        secret?: string;
+        /** Token expiration (e.g., '7d', '24h') */
+        expiresIn?: string;
+        /** Cookie name for JWT token */
+        cookieName?: string;
+        /** Enable secure cookies (HTTPS only) */
+        secureCookies?: boolean;
+    };
+    /** Vite / build configuration */
+    vite?: {
+        /** Path to Vite config file */
+        configFile?: string;
+    };
+}
+/**
+ * Helper to define a type-safe MoriaJS configuration.
+ *
+ * @example
+ * ```ts
+ * // moria.config.ts
+ * import { defineConfig } from '@moriajs/core';
+ *
+ * export default defineConfig({
+ *   server: { port: 3000 },
+ *   database: { adapter: 'sqlite', filename: './dev.db' },
+ * });
+ * ```
+ */
+export declare function defineConfig(config: MoriaConfig): MoriaConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,2BAA2B;IAC3B,MAAM,CAAC,EAAE;QACL,wCAAwC;QACxC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,2CAA2C;QAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,kCAAkC;QAClC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;QAC9E,yBAAyB;QACzB,IAAI,CAAC,EAAE;YACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;YACrC,WAAW,CAAC,EAAE,OAAO,CAAC;SACzB,CAAC;KACL,CAAC;IAEF,6BAA6B;IAC7B,QAAQ,CAAC,EAAE;QACP,kDAAkD;QAClD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,qBAAqB;QACrB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,+CAA+C;QAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,mCAAmC;IACnC,IAAI,CAAC,EAAE;QACH,qBAAqB;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,2CAA2C;QAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gCAAgC;QAChC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,yCAAyC;QACzC,aAAa,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;IAEF,iCAAiC;IACjC,IAAI,CAAC,EAAE;QACH,+BAA+B;QAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACL;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE7D"}

package/dist/config.js

@@ -0,0 +1,18 @@
+/**
+ * Helper to define a type-safe MoriaJS configuration.
+ *
+ * @example
+ * ```ts
+ * // moria.config.ts
+ * import { defineConfig } from '@moriajs/core';
+ *
+ * export default defineConfig({
+ *   server: { port: 3000 },
+ *   database: { adapter: 'sqlite', filename: './dev.db' },
+ * });
+ * ```
+ */
+export function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAiDA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC5C,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @moriajs/core
+ *
+ * Framework core: Fastify server factory with sensible defaults,
+ * plugin registration, and configuration system.
+ */
+export { createApp } from './app.js';
+export { defineConfig } from './config.js';
+export { defineMoriaPlugin } from './plugins.js';
+export type { MoriaApp, MoriaAppOptions } from './app.js';
+export type { MoriaConfig } from './config.js';
+export type { MoriaPlugin, MoriaPluginContext } from './plugins.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @moriajs/core
+ *
+ * Framework core: Fastify server factory with sensible defaults,
+ * plugin registration, and configuration system.
+ */
+export { createApp } from './app.js';
+export { defineConfig } from './config.js';
+export { defineMoriaPlugin } from './plugins.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/plugins.d.ts

@@ -0,0 +1,38 @@
+import type { FastifyInstance } from 'fastify';
+import type { MoriaConfig } from './config.js';
+/**
+ * Context provided to MoriaJS plugins during registration.
+ */
+export interface MoriaPluginContext {
+    /** The Fastify server instance */
+    server: FastifyInstance;
+    /** The MoriaJS configuration */
+    config: Partial<MoriaConfig>;
+}
+/**
+ * A MoriaJS plugin.
+ * Plugins extend the framework with additional functionality.
+ */
+export interface MoriaPlugin {
+    /** Unique plugin name */
+    name: string;
+    /** Plugin registration function */
+    register: (context: MoriaPluginContext) => Promise<void>;
+}
+/**
+ * Helper to define a type-safe MoriaJS plugin.
+ *
+ * @example
+ * ```ts
+ * import { defineMoriaPlugin } from '@moriajs/core';
+ *
+ * export default defineMoriaPlugin({
+ *   name: 'my-plugin',
+ *   async register({ server, config }) {
+ *     server.get('/my-route', async () => ({ hello: 'plugin' }));
+ *   },
+ * });
+ * ```
+ */
+export declare function defineMoriaPlugin(plugin: MoriaPlugin): MoriaPlugin;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,kCAAkC;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,gCAAgC;IAChC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,QAAQ,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAElE"}

package/dist/plugins.js

@@ -0,0 +1,19 @@
+/**
+ * Helper to define a type-safe MoriaJS plugin.
+ *
+ * @example
+ * ```ts
+ * import { defineMoriaPlugin } from '@moriajs/core';
+ *
+ * export default defineMoriaPlugin({
+ *   name: 'my-plugin',
+ *   async register({ server, config }) {
+ *     server.get('/my-route', async () => ({ hello: 'plugin' }));
+ *   },
+ * });
+ * ```
+ */
+export function defineMoriaPlugin(plugin) {
+    return plugin;
+}
+//# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAwBA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACjD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@moriajs/core",
+  "version": "0.1.1",
+  "type": "module",
+  "description": "MoriaJS framework core — Fastify server, Vite integration, and routing",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "fastify": "^5.2.0",
+    "@fastify/cors": "^11.0.0",
+    "@fastify/cookie": "^11.0.0",
+    "@fastify/compress": "^8.0.0",
+    "@fastify/static": "^9.0.0",
+    "@fastify/helmet": "^13.0.0",
+    "pino-pretty": "^13.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "rimraf": "^6.0.0",
+    "@types/node": "^22.0.0"
+  },
+  "license": "MIT",
+  "author": "Guntur-D <guntur.d.npm@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/guntur-d/moriajs.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/guntur-d/moriajs/tree/main/packages/core#readme",
+  "bugs": {
+    "url": "https://github.com/guntur-d/moriajs/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist .turbo"
+  }
+}

package/src/app.ts

@@ -0,0 +1,103 @@
+import Fastify, { type FastifyInstance, type FastifyServerOptions } from 'fastify';
+import cors from '@fastify/cors';
+import cookie from '@fastify/cookie';
+import compress from '@fastify/compress';
+import helmet from '@fastify/helmet';
+import { type MoriaConfig } from './config.js';
+import { type MoriaPlugin } from './plugins.js';
+
+/**
+ * Options for creating a MoriaJS application.
+ */
+export interface MoriaAppOptions {
+    /** MoriaJS configuration (from moria.config.ts) */
+    config?: Partial<MoriaConfig>;
+    /** Additional Fastify server options */
+    fastifyOptions?: FastifyServerOptions;
+}
+
+/**
+ * The MoriaJS application instance.
+ * Wraps a Fastify instance with framework-level features.
+ */
+export interface MoriaApp {
+    /** The underlying Fastify instance */
+    server: FastifyInstance;
+    /** Register a MoriaJS plugin */
+    use: (plugin: MoriaPlugin) => Promise<void>;
+    /** Start the server */
+    listen: (options?: { port?: number; host?: string }) => Promise<string>;
+    /** Stop the server */
+    close: () => Promise<void>;
+}
+
+/**
+ * Create a new MoriaJS application.
+ *
+ * @example
+ * ```ts
+ * import { createApp } from '@moriajs/core';
+ *
+ * const app = await createApp();
+ * await app.listen({ port: 3000 });
+ * ```
+ */
+export async function createApp(options: MoriaAppOptions = {}): Promise<MoriaApp> {
+    const config = options.config ?? {};
+    const port = config.server?.port ?? 3000;
+    const host = config.server?.host ?? '0.0.0.0';
+
+    // Create Fastify instance with sensible defaults
+    const server = Fastify({
+        logger: {
+            level: config.server?.logLevel ?? 'info',
+            transport:
+                process.env.NODE_ENV !== 'production'
+                    ? { target: 'pino-pretty', options: { colorize: true } }
+                    : undefined,
+        },
+        ...options.fastifyOptions,
+    });
+
+    // Register core plugins
+    await server.register(cors, {
+        origin: config.server?.cors?.origin ?? true,
+        credentials: config.server?.cors?.credentials ?? true,
+    });
+
+    await server.register(cookie);
+    await server.register(compress);
+    await server.register(helmet, {
+        // Relax CSP in development for Vite HMR
+        contentSecurityPolicy: process.env.NODE_ENV === 'production',
+    });
+
+    // Health check route
+    server.get('/health', async () => ({ status: 'ok', timestamp: new Date().toISOString() }));
+
+    // Plugin registry
+    const plugins: MoriaPlugin[] = [];
+
+    const app: MoriaApp = {
+        server,
+
+        async use(plugin: MoriaPlugin) {
+            plugins.push(plugin);
+            await plugin.register({ server, config });
+        },
+
+        async listen(listenOptions) {
+            const addr = await server.listen({
+                port: listenOptions?.port ?? port,
+                host: listenOptions?.host ?? host,
+            });
+            return addr;
+        },
+
+        async close() {
+            await server.close();
+        },
+    };
+
+    return app;
+}

package/src/config.ts

@@ -0,0 +1,66 @@
+/**
+ * MoriaJS configuration type.
+ * Used in `moria.config.ts` files in user projects.
+ */
+export interface MoriaConfig {
+    /** Server configuration */
+    server?: {
+        /** Port to listen on (default: 3000) */
+        port?: number;
+        /** Host to bind to (default: '0.0.0.0') */
+        host?: string;
+        /** Log level (default: 'info') */
+        logLevel?: 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace' | 'silent';
+        /** CORS configuration */
+        cors?: {
+            origin?: string | string[] | boolean;
+            credentials?: boolean;
+        };
+    };
+
+    /** Database configuration */
+    database?: {
+        /** Database adapter: 'pg' | 'sqlite' | 'mysql' */
+        adapter?: string;
+        /** Connection URL */
+        url?: string;
+        /** Path to SQLite file (for SQLite adapter) */
+        filename?: string;
+    };
+
+    /** Authentication configuration */
+    auth?: {
+        /** JWT secret key */
+        secret?: string;
+        /** Token expiration (e.g., '7d', '24h') */
+        expiresIn?: string;
+        /** Cookie name for JWT token */
+        cookieName?: string;
+        /** Enable secure cookies (HTTPS only) */
+        secureCookies?: boolean;
+    };
+
+    /** Vite / build configuration */
+    vite?: {
+        /** Path to Vite config file */
+        configFile?: string;
+    };
+}
+
+/**
+ * Helper to define a type-safe MoriaJS configuration.
+ *
+ * @example
+ * ```ts
+ * // moria.config.ts
+ * import { defineConfig } from '@moriajs/core';
+ *
+ * export default defineConfig({
+ *   server: { port: 3000 },
+ *   database: { adapter: 'sqlite', filename: './dev.db' },
+ * });
+ * ```
+ */
+export function defineConfig(config: MoriaConfig): MoriaConfig {
+    return config;
+}

package/src/index.ts

@@ -0,0 +1,14 @@
+/**
+ * @moriajs/core
+ *
+ * Framework core: Fastify server factory with sensible defaults,
+ * plugin registration, and configuration system.
+ */
+
+export { createApp } from './app.js';
+export { defineConfig } from './config.js';
+export { defineMoriaPlugin } from './plugins.js';
+
+export type { MoriaApp, MoriaAppOptions } from './app.js';
+export type { MoriaConfig } from './config.js';
+export type { MoriaPlugin, MoriaPluginContext } from './plugins.js';

package/src/plugins.ts

@@ -0,0 +1,42 @@
+import type { FastifyInstance } from 'fastify';
+import type { MoriaConfig } from './config.js';
+
+/**
+ * Context provided to MoriaJS plugins during registration.
+ */
+export interface MoriaPluginContext {
+    /** The Fastify server instance */
+    server: FastifyInstance;
+    /** The MoriaJS configuration */
+    config: Partial<MoriaConfig>;
+}
+
+/**
+ * A MoriaJS plugin.
+ * Plugins extend the framework with additional functionality.
+ */
+export interface MoriaPlugin {
+    /** Unique plugin name */
+    name: string;
+    /** Plugin registration function */
+    register: (context: MoriaPluginContext) => Promise<void>;
+}
+
+/**
+ * Helper to define a type-safe MoriaJS plugin.
+ *
+ * @example
+ * ```ts
+ * import { defineMoriaPlugin } from '@moriajs/core';
+ *
+ * export default defineMoriaPlugin({
+ *   name: 'my-plugin',
+ *   async register({ server, config }) {
+ *     server.get('/my-route', async () => ({ hello: 'plugin' }));
+ *   },
+ * });
+ * ```
+ */
+export function defineMoriaPlugin(plugin: MoriaPlugin): MoriaPlugin {
+    return plugin;
+}

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+    "extends": "../../tsconfig.base.json",
+    "compilerOptions": {
+        "outDir": "dist",
+        "rootDir": "src"
+    },
+    "include": [
+        "src"
+    ]
+}