@timber-js/app 0.1.48 → 0.1.49

package/dist/index.d.ts

@@ -34,16 +34,6 @@ export interface TimberUserConfig {
      * Server-side JS still runs — this only affects what is sent to the browser.
      */
     clientJavascript?: boolean | ClientJavascriptConfig;
-    /**
-     * @deprecated Use `clientJavascript: false` or `clientJavascript: { disabled: true }` instead.
-     *
-     * Disable all client-side JavaScript output. When true, no client JS
-     * bundles are emitted or referenced in HTML. Pages work entirely via
-     * server-rendered HTML. Works in both 'server' and 'static' modes.
-     *
-     * Server-side JS still runs — this only affects what is sent to the browser.
-     */
-    noClientJavascript?: boolean;
     adapter?: unknown;
     cacheHandler?: unknown;
     allowedOrigins?: string[];
@@ -54,6 +44,13 @@ export interface TimberUserConfig {
         maxFields?: number;
     };
     pageExtensions?: string[];
+    /**
+     * Slow request threshold in milliseconds. Requests exceeding this emit
+     * a warning via the logger. Set to 0 to disable. Default: 3000.
+     *
+     * See design/17-logging.md §"slowRequestMs".
+     */
+    slowRequestMs?: number;
     /** Dev-mode options. These have no effect in production builds. */
     dev?: {
         /** Threshold in ms to highlight slow phases in dev logging output. Default: 200. */
@@ -88,8 +85,7 @@ export interface TimberUserConfig {
     };
 }
 /**
- * Resolve `clientJavascript` (new) and `noClientJavascript` (deprecated) into
- * a fully resolved config. Emits a deprecation warning for the old option.
+ * Resolve `clientJavascript` into a fully resolved config.
  */
 export declare function resolveClientJavascript(config: TimberUserConfig): ResolvedClientJavascript;
 /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -11856,7 +11856,8 @@ var VIRTUAL_IDS = {
 	rscEntry: "virtual:timber-rsc-entry",
 	ssrEntry: "virtual:timber-ssr-entry",
 	browserEntry: "virtual:timber-browser-entry",
-	config: "virtual:timber-config"
+	config: "virtual:timber-config",
+	instrumentation: "virtual:timber-instrumentation"
 };
 /**
 * Map from virtual module IDs to their resolved file paths.
@@ -11874,6 +11875,8 @@ var ENTRY_FILE_MAP = {
 };
 /** The \0-prefixed resolved ID for virtual:timber-config */
 var RESOLVED_CONFIG_ID = `\0${VIRTUAL_IDS.config}`;
+/** The \0-prefixed resolved ID for virtual:timber-instrumentation */
+var RESOLVED_INSTRUMENTATION_ID = `\0${VIRTUAL_IDS.instrumentation}`;
 /**
 * Strip the \0 prefix from a module ID.
 *
@@ -11914,6 +11917,7 @@ function generateConfigModule(ctx) {
 		clientJavascript: ctx.clientJavascript,
 		dev: ctx.dev ?? false,
 		slowPhaseMs: ctx.config.dev?.slowPhaseMs ?? 200,
+		slowRequestMs: ctx.config.slowRequestMs ?? 3e3,
 		cookieSecrets
 	};
 	return [
@@ -11926,6 +11930,51 @@ function generateConfigModule(ctx) {
 	].join("\n");
 }
 /**
+* Detect the user's instrumentation.ts file at the project root.
+*
+* Checks for instrumentation.ts, .js, and .mjs — matching the same
+* extensions as timber.config.ts detection.
+*/
+function detectInstrumentationFile(root) {
+	for (const ext of [
+		".ts",
+		".js",
+		".mjs"
+	]) {
+		const candidate = resolve(root, `instrumentation${ext}`);
+		if (existsSync(candidate)) return candidate;
+	}
+	return null;
+}
+/**
+* Generate the virtual:timber-instrumentation module source.
+*
+* When the user's instrumentation.ts exists, generates a module that
+* dynamically imports it. When it doesn't exist, generates a module
+* that returns null. The RSC entry calls this loader at startup time.
+*
+* See design/17-logging.md §"instrumentation.ts — The Entry Point"
+*/
+function generateInstrumentationModule(instrumentationPath) {
+	if (instrumentationPath) return [
+		"// Auto-generated instrumentation loader — do not edit.",
+		"// Generated by timber-entries plugin.",
+		"",
+		`export default async function loadUserInstrumentation() {`,
+		`  return import(${JSON.stringify(instrumentationPath)});`,
+		`}`
+	].join("\n");
+	return [
+		"// Auto-generated instrumentation loader — do not edit.",
+		"// Generated by timber-entries plugin.",
+		"// No instrumentation.ts found at project root.",
+		"",
+		`export default async function loadUserInstrumentation() {`,
+		`  return null;`,
+		`}`
+	].join("\n");
+}
+/**
 * Create the timber-entries Vite plugin.
 *
 * Hooks: resolveId, load
@@ -11938,10 +11987,12 @@ function timberEntries(ctx) {
 			cleanId = stripRootPrefix(cleanId, ctx.root);
 			if (cleanId in ENTRY_FILE_MAP) return ENTRY_FILE_MAP[cleanId];
 			if (cleanId === VIRTUAL_IDS.config) return RESOLVED_CONFIG_ID;
+			if (cleanId === VIRTUAL_IDS.instrumentation) return RESOLVED_INSTRUMENTATION_ID;
 			return null;
 		},
 		load(id) {
 			if (id === RESOLVED_CONFIG_ID) return generateConfigModule(ctx);
+			if (id === RESOLVED_INSTRUMENTATION_ID) return generateInstrumentationModule(detectInstrumentationFile(ctx.root));
 			return null;
 		}
 	};
@@ -14733,8 +14784,7 @@ function createNoopTimer() {
 //#endregion
 //#region src/index.ts
 /**
-* Resolve `clientJavascript` (new) and `noClientJavascript` (deprecated) into
-* a fully resolved config. Emits a deprecation warning for the old option.
+* Resolve `clientJavascript` into a fully resolved config.
 */
 function resolveClientJavascript(config) {
 	if (config.clientJavascript !== void 0) {
@@ -14747,13 +14797,6 @@ function resolveClientJavascript(config) {
 			enableHMRInDev: config.clientJavascript.enableHMRInDev ?? config.clientJavascript.disabled
 		};
 	}
-	if (config.noClientJavascript !== void 0) {
-		console.warn("[timber] `noClientJavascript` is deprecated. Use `clientJavascript: false` or `clientJavascript: { disabled: true, enableHMRInDev: true }` instead.");
-		return {
-			disabled: config.noClientJavascript,
-			enableHMRInDev: config.noClientJavascript
-		};
-	}
 	return {
 		disabled: false,
 		enableHMRInDev: false