@fastang/core 0.1.0-alpha.4 → 0.1.0-alpha.5

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.0-alpha.5
+
+- Default development Fastify/Vite logging to warn, retain the startup address and allow FASTANG_LOG_LEVEL overrides. Suppress successful dev check summaries with check --quiet.
+
+- Preserve relative dependency symlinks in Vercel functions for pnpm installations.
+
 ## 0.1.0-alpha.4
 
 - Add source-only `fastang check` diagnostics for API route/contract correspondence, with tsconfig resolution, JSON and strict mode.

package/README.md

@@ -1,7 +1,7 @@
 # @fastang/core
 
 Experimental FastAng runtime and tooling for Angular + Fastify applications.
-Version 0.1.0-alpha.4 is an experimental alpha. Public APIs may change between alpha releases.
+Version 0.1.0-alpha.5 is an experimental alpha. Public APIs may change between alpha releases.
 
 The package contains compiled JavaScript and TypeScript declarations. Angular,
 Fastify, Vite and the Angular compiler are explicit peer dependencies so the app
@@ -124,3 +124,20 @@ overlay on route/contract edits; fixing them triggers a full reload. `fastang de
 checks before restarting the backend and keeps an existing server during an invalid
 edit. The standalone CLI delegates `check` to the app's installed core: both need
 a release containing this command. Use `0.1.0-alpha.4` or later for both packages.
+
+## Development logging
+
+From `0.1.0-alpha.5`, development defaults to `warn` for both Fastify and Vite during `fastang dev`.
+The listening address remains visible. Routine HTTP request/completion logs and
+successful route-check summaries are omitted; warnings, errors and failed checks
+remain visible. Production logger configuration is unchanged.
+
+Set `FASTANG_LOG_LEVEL=info` or `FASTANG_LOG_LEVEL=debug` in the process environment
+when investigating requests. Accepted values are `trace`, `debug`, `info`, `warn`,
+`error`, `fatal` and `silent`. Vite maps trace/debug to info and fatal to error.
+This controls framework loggers, not application `console.log` calls or package
+manager output. The startup address is retained even with `silent`.
+
+`fastang check --quiet` suppresses only a successful text summary; diagnostics
+still print, and `--json` always returns the JSON report. The dev supervisor uses
+this option for checks before backend restarts. These options are available from `0.1.0-alpha.5`.

package/dist/adapters/vercel.js

@@ -1,5 +1,5 @@
-import { copyFile, mkdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
-import { dirname, resolve } from 'node:path';
+import { copyFile, mkdir, readFile, rm, stat, lstat, readlink, symlink, writeFile } from 'node:fs/promises';
+import { dirname, resolve, relative, isAbsolute } from 'node:path';
 import { createRequire } from 'node:module';
 import { nodeFileTrace } from '@vercel/nft';
 import { staticFile } from "../server.js";
@@ -15,7 +15,22 @@ export async function buildVercelOutput(plan, root = process.cwd()) {
     await rm(output, { recursive: true, force: true });
     const copy = async (file, destination) => {
         await mkdir(dirname(destination), { recursive: true });
-        await copyFile(resolve(root, file), destination);
+        const source = resolve(root, file);
+        const info = await lstat(source);
+        if (info.isSymbolicLink()) {
+            const target = await readlink(source);
+            const sourceTarget = relative(root, resolve(dirname(source), target));
+            if (isAbsolute(target) || sourceTarget === '..' || sourceTarget.startsWith('../') || sourceTarget.startsWith('..\\'))
+                throw new Error(`Dependency symlink outside project: ${file}`);
+            const directory = (await stat(source)).isDirectory();
+            if (directory)
+                await mkdir(resolve(dirname(destination), target), { recursive: true });
+            await symlink(target, destination, directory ? 'dir' : 'file');
+        }
+        else if (info.isDirectory())
+            await mkdir(destination, { recursive: true });
+        else
+            await copyFile(source, destination);
     };
     const { cp } = await import('node:fs/promises');
     await cp(resolve(root, 'dist/client/assets'), resolve(output, 'static/assets'), { recursive: true });
@@ -39,11 +54,16 @@ export async function buildVercelOutput(plan, root = process.cwd()) {
         traces.set(entryFile, trace);
         for (const warning of trace.warnings)
             console.warn(`[vercel:${name}] ${warning.message}`);
-        for (const file of trace.fileList) {
+        const files = await Promise.all([...trace.fileList].map(async (file) => {
             if (file.startsWith('../') || file.startsWith('/'))
                 throw new Error(`Dependency outside project: ${file}`);
+            return { file, link: (await lstat(resolve(root, file))).isSymbolicLink() };
+        }));
+        // pnpm exposes dependencies through relative directory symlinks. Keep that
+        // topology in the function, creating links before copying traced files.
+        files.sort((a, b) => Number(b.link) - Number(a.link) || a.file.length - b.file.length);
+        for (const { file } of files)
             await copy(file, resolve(directory, file));
-        }
         if (kind === 'ssr')
             await copy('dist/client/index.html', resolve(directory, dirname(entryFile), '../client/index.html'));
         await mkdir(directory, { recursive: true });

package/dist/cli.js

@@ -12,7 +12,7 @@ try {
     else if (command === 'build')
         await import("./commands/build.js");
     else if (!command || command === '--help' || command === '-h')
-        console.log('Usage: fastang <dev|generate|build|routes|check>\n  build [--vercel]\n  routes [--json]\n  check [--project tsconfig.node.json] [--json] [--strict]');
+        console.log('Usage: fastang <dev|generate|build|routes|check>\n  build [--vercel]\n  routes [--json]\n  check [--project tsconfig.node.json] [--json] [--strict] [--quiet]');
     else
         throw new Error(`Unknown command: ${command}`);
 }

package/dist/commands/check.js

@@ -4,10 +4,13 @@ let project;
 for (let index = 0; index < args.length; index++) {
     if (args[index] === '--project' && args[index + 1] && !args[index + 1].startsWith('-'))
         project = args[++index];
-    else if (!['--json', '--strict'].includes(args[index]))
-        throw new Error('Usage: fastang check [--project tsconfig.node.json] [--json] [--strict]');
+    else if (!['--json', '--strict', '--quiet'].includes(args[index]))
+        throw new Error('Usage: fastang check [--project tsconfig.node.json] [--json] [--strict] [--quiet]');
 }
 const result = await checkRoutes({ project, strict: args.includes('--strict') });
-console.log(args.includes('--json') ? JSON.stringify(result, null, 2) : formatCheck(result));
+if (args.includes('--json'))
+    console.log(JSON.stringify(result, null, 2));
+else if (!args.includes('--quiet') || result.diagnostics.length)
+    console.log(formatCheck(result));
 if (result.diagnostics.some(diagnostic => diagnostic.severity === 'error'))
     process.exitCode = 1;

package/dist/commands/dev-logging.d.ts

@@ -0,0 +1,10 @@
+import type { LogLevel } from 'vite';
+declare const levels: readonly ["trace", "debug", "info", "warn", "error", "fatal", "silent"];
+type Level = typeof levels[number];
+/** Development only: production servers keep their own logger configuration. */
+export declare function developmentLogging(value?: string | undefined): {
+    level: Level;
+    vite: LogLevel;
+    banner: boolean;
+};
+export {};

package/dist/commands/dev-logging.js

@@ -0,0 +1,13 @@
+const levels = ['trace', 'debug', 'info', 'warn', 'error', 'fatal', 'silent'];
+/** Development only: production servers keep their own logger configuration. */
+export function developmentLogging(value = process.env['FASTANG_LOG_LEVEL']) {
+    const level = value ?? 'warn';
+    if (!levels.includes(level))
+        throw new Error(`FASTANG_LOG_LEVEL must be one of: ${levels.join(', ')}`);
+    return {
+        level: level,
+        vite: ['trace', 'debug', 'info'].includes(level) ? 'info' : level === 'fatal' ? 'error' : level,
+        // Fastify already announces the address at info; preserve it at quieter levels.
+        banner: !['trace', 'debug', 'info'].includes(level),
+    };
+}

package/dist/commands/dev-server.js

@@ -6,16 +6,18 @@ import { listen } from "../listen.js";
 import { tsImport } from 'tsx/esm/api';
 import { resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
+import { developmentLogging } from "./dev-logging.js";
 import { loadFastangConfig } from "./load-config.js";
+const logging = developmentLogging();
 await loadFastangConfig('serve');
 const { configureServer } = await tsImport(pathToFileURL(resolve('src/server/plugins.ts')).href, import.meta.url);
 const { registerApi } = await tsImport(pathToFileURL(resolve('.fastang/api.ts')).href, import.meta.url);
 let vite;
 try {
     const app = await createServer({
-        logger: true, registerApi,
+        logger: { level: logging.level }, registerApi,
         async configure(server) {
-            vite = await createViteServer({ server: { middlewareMode: true, hmr: { server: server.server } }, appType: 'custom' });
+            vite = await createViteServer({ logLevel: logging.vite, server: { middlewareMode: true, hmr: { server: server.server } }, appType: 'custom' });
             server.addHook('onClose', async () => { await vite?.close(); });
             await server.register(middie);
             // Middie gestisce next(), risposte completate ed errori del middleware Connect.
@@ -36,6 +38,13 @@ try {
         },
     });
     await listen(app);
+    if (logging.banner) {
+        const address = app.server.address();
+        if (address && typeof address !== 'string') {
+            const host = address.family === 'IPv6' ? `[${address.address}]` : address.address;
+            console.log(`Server listening at http://${host}:${address.port}`);
+        }
+    }
 }
 catch (error) {
     await vite?.close();

package/dist/commands/dev.js

@@ -12,7 +12,7 @@ async function restart() {
     if (stopping)
         return;
     // Keep the previous server available for Vite diagnostics while an edit is invalid.
-    const checker = spawn(process.execPath, [fileURLToPath(new URL('../cli.js', import.meta.url)), 'check'], { stdio: 'inherit', env: process.env });
+    const checker = spawn(process.execPath, [fileURLToPath(new URL('../cli.js', import.meta.url)), 'check', '--quiet'], { stdio: 'inherit', env: process.env });
     const [checked] = await once(checker, 'exit');
     if (checked !== 0 || stopping)
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fastang/core",
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.5",
   "type": "module",
   "description": "Angular rendering, Fastify APIs and file-based routing.",
   "license": "MIT",