fluxion-ts 0.0.5 → 0.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fluxion-ts",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "author": {
     "name": "Kasukabe Tsumugi",
     "email": "futami16237@gmail.com"
@@ -9,6 +9,11 @@
   "description": "Fluxion is able to start a server that can dynamically load routers and js files. It is designed to be used to replace PHP",
   "description_zh": "Fluxion可以启动一个能够动态加载路由和js文件的服务器，旨在替代PHP",
   "type": "module",
+  "exports": {
+    "import": "./index.mjs",
+    "default": "./index.mjs",
+    "types": "./index.d.ts"
+  },
   "homepage": "https://github.com/baendlorel/fluxion#readme",
   "repository": {
     "type": "git",

package/src/core/server.ts

@@ -131,11 +131,7 @@ function normalizeDatabaseRuntimeConfigItem(
   }
 
   const rawDriver =
-    typeof input.driver === 'string'
-      ? input.driver
-      : typeof input.type === 'string'
-        ? input.type
-        : undefined;
+    typeof input.driver === 'string' ? input.driver : typeof input.type === 'string' ? input.type : undefined;
 
   if (rawDriver === undefined) {
     throw new Error(`Missing db driver for "${dbName}" in ${source}`);
@@ -209,11 +205,7 @@ function normalizeDatabaseConfigMap(input: unknown, source: string): protocol.Wo
       throw new Error(`Invalid db config for "${name}" in "${source}"`);
     }
 
-    normalized[name] = normalizeDatabaseRuntimeConfigItem(
-      name,
-      rawConfig as FluxionDatabaseRuntimeConfigInput,
-      source,
-    );
+    normalized[name] = normalizeDatabaseRuntimeConfigItem(name, rawConfig as FluxionDatabaseRuntimeConfigInput, source);
   }
 
   return normalized;
@@ -372,7 +364,7 @@ export function fluxion(options: FluxionOptions): http.Server {
 
     const bodyCapture = createBodyPreviewCapture(req);
 
-    logger.write('INFO', 'RequestReceived', { method, ip, path: url.pathname });
+    logger.write('INFO', 'Req', { method, ip, path: url.pathname });
 
     const start = performance.now();
     res.once('finish', () => {
@@ -395,7 +387,7 @@ export function fluxion(options: FluxionOptions): http.Server {
         fields.bodyTruncated = bodyPreview.truncated;
       }
 
-      logger.write('INFO', 'RequestCompleted', fields);
+      logger.write('INFO', 'Res', fields);
     });
 
     void metaApi

package/src/workers/file-runtime.ts

@@ -532,6 +532,25 @@ function buildHandlerCandidates(dynamicDirectory: string, segments: readonly str
   return [path.resolve(routePath, 'index.mjs'), `${routePath}.mjs`];
 }
 
+/**
+ * Builds ordered static file candidates for one route.
+ */
+function buildStaticCandidates(dynamicDirectory: string, segments: readonly string[]): string[] {
+  if (segments.length === 0) {
+    return [path.resolve(dynamicDirectory, 'index.html')];
+  }
+
+  const routePath = path.resolve(dynamicDirectory, ...segments);
+  const candidates = [routePath];
+  const lastSegment = segments[segments.length - 1];
+
+  if (path.extname(lastSegment).length === 0) {
+    candidates.push(path.resolve(routePath, 'index.html'));
+  }
+
+  return candidates;
+}
+
 /**
  * Streams static file to response.
  */
@@ -893,38 +912,40 @@ export function createFileRuntime(dir: string, options: FileRuntimeOptions = {})
       return HandlerResult.NotFound;
     }
 
-    if (parsedPath.segments.length === 0) {
-      return HandlerResult.NotFound;
-    }
+    const candidates = buildStaticCandidates(dir, parsedPath.segments);
 
-    const filePath = path.resolve(dir, ...parsedPath.segments);
+    for (let i = 0; i < candidates.length; i++) {
+      const filePath = candidates[i];
 
-    if (!isUnderDirectory(filePath, dir)) {
-      return HandlerResult.NotFound;
-    }
+      if (!isUnderDirectory(filePath, dir)) {
+        continue;
+      }
 
-    if (path.extname(filePath).toLowerCase() === '.mjs') {
-      return HandlerResult.NotFound;
-    }
+      if (path.extname(filePath).toLowerCase() === '.mjs') {
+        continue;
+      }
 
-    try {
-      const stat = await fs.promises.stat(filePath);
+      try {
+        const stat = await fs.promises.stat(filePath);
 
-      if (!stat.isFile()) {
-        return HandlerResult.NotFound;
-      }
+        if (!stat.isFile()) {
+          continue;
+        }
 
-      await streamStaticFile(filePath, stat, method, res);
-      return HandlerResult.Handled;
-    } catch (error) {
-      const code = (error as NodeJS.ErrnoException).code;
+        await streamStaticFile(filePath, stat, method, res);
+        return HandlerResult.Handled;
+      } catch (error) {
+        const code = (error as NodeJS.ErrnoException).code;
 
-      if (code === 'ENOENT' || code === 'ENOTDIR') {
-        return HandlerResult.NotFound;
-      }
+        if (code === 'ENOENT' || code === 'ENOTDIR') {
+          continue;
+        }
 
-      throw error;
+        throw error;
+      }
     }
+
+    return HandlerResult.NotFound;
   };
 
   /**

package/tests/core/file-runtime.test.ts

@@ -169,6 +169,33 @@ describe('file-runtime', () => {
     expect(await hiddenStaticResponse.text()).toBe('not_found');
   });
 
+  it('falls back to route index.html when direct file is not matched', async () => {
+    const dynamicDirectory = await createTempDirectory('fluxion-runtime-static-index-');
+    tempDirectories.push(dynamicDirectory);
+
+    await writeFile(
+      path.join(dynamicDirectory, 'docs', 'index.html'),
+      '<html><body><h1>docs-home</h1></body></html>',
+    );
+    await writeFile(
+      path.join(dynamicDirectory, 'index.html'),
+      '<html><body><h1>root-home</h1></body></html>',
+    );
+
+    const { server, baseUrl } = await startRuntimeServer(dynamicDirectory);
+    servers.push(server);
+
+    const docsResponse = await fetch(`${baseUrl}/docs`);
+    expect(docsResponse.status).toBe(200);
+    expect(docsResponse.headers.get('content-type')).toContain('text/html');
+    expect(await docsResponse.text()).toContain('docs-home');
+
+    const rootResponse = await fetch(`${baseUrl}/`);
+    expect(rootResponse.status).toBe(200);
+    expect(rootResponse.headers.get('content-type')).toContain('text/html');
+    expect(await rootResponse.text()).toContain('root-home');
+  });
+
   it('creates route snapshot from .mjs handlers and static files', async () => {
     const dynamicDirectory = await createTempDirectory('fluxion-runtime-snapshot-');
     tempDirectories.push(dynamicDirectory);

package/Dockerfile

@@ -1,13 +0,0 @@
-FROM node:24
-WORKDIR /app
-COPY package.json pnpm-lock.yaml ./
-RUN npm install -g pnpm && pnpm install --frozen-lockfile
-RUN pnpm install 
-COPY ./dist /app/
-WORKDIR /app
-
-RUN curl -fsSL https://code-server.dev/install.sh | sh
-
-ENV NODE_ENV=production
-EXPOSE 3000
-CMD ["pnpm", "start"]

package/scripts/build-image.ts

@@ -1,13 +0,0 @@
-import { execSync } from 'node:child_process';
-import { readFileSync } from 'node:fs';
-import path from 'node:path';
-import { bumpVersion } from './bump-version';
-
-const pkgPath = path.resolve(import.meta.dirname, '..', '.image.json');
-const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8')) as { name: string; version: string };
-const imageName = `${pkg.name}:${pkg.version}`;
-
-execSync('pnpm build', { stdio: 'inherit' });
-execSync(`docker build -t ${imageName} .`, { stdio: 'inherit' });
-
-bumpVersion(pkgPath);

package/scripts/configs.ts

@@ -1,79 +0,0 @@
-import path from 'node:path';
-import fs from 'node:fs';
-
-import type { RollupReplaceOptions } from '@rollup/plugin-replace';
-
-export const getTSConfig = () => {
-  const tsconfigBuildPath = path.join(import.meta.dirname, '..', 'tsconfig.build.json');
-  const tsconfigPath = path.join(import.meta.dirname, '..', 'tsconfig.json');
-  return fs.existsSync(tsconfigBuildPath) ? tsconfigBuildPath : tsconfigPath;
-};
-
-// #region replace options
-
-interface CommonPackageJson {
-  name: string;
-  version: string;
-  description: string;
-  description_zh: string;
-  author: {
-    name: string;
-    email: string;
-  };
-  license: string;
-  repository: {
-    type: string;
-    url: string;
-  };
-}
-
-export function replaceOpts(): RollupReplaceOptions {
-  const pkg = JSON.parse(
-    fs.readFileSync(path.join(import.meta.dirname, '..', 'package.json'), 'utf-8'),
-  ) as CommonPackageJson;
-  function formatDateFull(dt = new Date()) {
-    const y = dt.getFullYear();
-    const m = String(dt.getMonth() + 1).padStart(2, '0');
-    const d = String(dt.getDate()).padStart(2, '0');
-    const hh = String(dt.getHours()).padStart(2, '0');
-    const mm = String(dt.getMinutes()).padStart(2, '0');
-    const ss = String(dt.getSeconds()).padStart(2, '0');
-    const ms = String(dt.getMilliseconds()).padStart(3, '0');
-    return `${y}.${m}.${d} ${hh}:${mm}:${ss}.${ms}`;
-  }
-
-  const __KEBAB_NAME__ = pkg.name.replace('rollup-plugin-', '');
-  const __VERSION__ = pkg.version;
-  const __NAME__ = __KEBAB_NAME__.replace(/(^|-)(\w)/g, (_, __, c) => c.toUpperCase());
-
-  const __PKG_INFO__ = `## About
- * @package ${__NAME__}
- * @author ${pkg.author.name} <${pkg.author.email}>
- * @version ${pkg.version} (Last Update: ${formatDateFull()})
- * @license ${pkg.license}
- * @link ${pkg.repository.url}
- * @link https://baendlorel.github.io/ Welcome to my site!
- * @description ${pkg.description.replace(/\n/g, '\n * \n * ')}
- * @copyright Copyright (c) ${new Date().getFullYear()} ${pkg.author.name}. All rights reserved.`;
-
-  return {
-    preventAssignment: true,
-    delimiters: ['', ''],
-    values: {
-      __IS_DEV__: 'false',
-      __NAME__,
-      __KEBAB_NAME__,
-      __PKG_INFO__,
-      __VERSION__,
-
-      // global error/warn/debug
-      "$throw('": `throw new Error('[${__NAME__} error] `,
-      '$throw(`': `throw new Error(\`[${__NAME__} error] `,
-      '$throw("': `throw new Error("[${__NAME__} error] `,
-      '$warn(': `console.warn('[${__NAME__} warn]',`,
-      '$error(': `console.error('[${__NAME__} error]',`,
-      '$debug(': `console.debug('[${__NAME__} debug]',`,
-    },
-  };
-}
-// #endregion