@fougere/log 0.16.3-alpha.0 → 0.16.5-alpha.0

package/dist/CallLines.d.ts

@@ -0,0 +1,10 @@
+import { type AppMiddleware, type Logger } from '@fougere/core';
+/**
+ * Two lines a call — that it began, and what it cost — written under the frond that answers. A
+ * call from another process names the one that signed it.
+ *
+ * An op that CARRIES a line writes none: it is dispatched, so logging it announces a line inside
+ * the announcement of one — `Emission cycle: logLine → logLine`.
+ */
+export declare function callLines(logger: Logger): AppMiddleware;
+//# sourceMappingURL=CallLines.d.ts.map

package/dist/CallLines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CallLines.d.ts","sourceRoot":"","sources":["../src/CallLines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAE9E;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAqBvD"}

package/dist/CallLines.js

@@ -0,0 +1,30 @@
+import { CARRIES_LINE } from '@fougere/core';
+/**
+ * Two lines a call — that it began, and what it cost — written under the frond that answers. A
+ * call from another process names the one that signed it.
+ *
+ * An op that CARRIES a line writes none: it is dispatched, so logging it announces a line inside
+ * the announcement of one — `Emission cycle: logLine → logLine`.
+ */
+export function callLines(logger) {
+    return async (context, next) => {
+        if (CARRIES_LINE.has(context.entity))
+            return next();
+        const log = context.frond ? logger.child(context.frond) : logger;
+        const call = `${context.handler ?? context.entity}.${context.operation}`;
+        const from = context.invocation?.caller ? ` ← ${context.invocation.caller}` : '';
+        const start = performance.now();
+        const cost = () => `(${(performance.now() - start).toFixed(1)}ms)`;
+        log.info(`${call}${from}`);
+        try {
+            const result = await next();
+            log.info(`${call} ${cost()}${from}`);
+            return result;
+        }
+        catch (error) {
+            log.error(`${call} ${cost()}${from}`, error);
+            throw error;
+        }
+    };
+}
+//# sourceMappingURL=CallLines.js.map

package/dist/CallLines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CallLines.js","sourceRoot":"","sources":["../src/CallLines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAmC,MAAM,eAAe,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QAC7B,IAAI,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,EAAE,CAAC;QAEpD,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACjE,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACzE,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QAEnE,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;YAC5B,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;YAErC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YAC7C,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,16 @@
+/**
+ * What is written about a call, and where a line GOES. The line itself is core's — the boot
+ * announces one before any frond exists, so naming it here would cost core an optional package's
+ * vocabulary — and the console is core's too: it writes every line whoever else took it.
+ *
+ * So this package holds the two lines every call writes, and a destination that sends a line
+ * SOMEWHERE ELSE. Stated and not scanned: `frond()` is what a published package hands over, so a
+ * consumer needs no TypeScript loader and no scan of its `node_modules`. The contract is written
+ * here for the same reason — nobody reads this handler's source at boot.
+ */
+import { type Extension } from '@fougere/core';
 export { default as FileHandler, LogFile } from './FileHandler.js';
+export { callLines } from './CallLines.js';
 /**
  * Lines to a file, one JSON object each. Leave it out and they only reach the console —
  * which is the whole difference from a logger you have to turn off.
@@ -8,9 +20,9 @@ export { default as FileHandler, LogFile } from './FileHandler.js';
  */
 export declare const logFrond: (path: string) => import("@fougere/core").FrondDescriptor;
 /**
- * The name `fronds: { '@fougere/log': './lines.jsonl' }` reaches — the last segment of the
- * specifier is the export, which is what the Nuxt module already assumes of `calls` and
- * `observability`.
+ * The name `fronds: { '@fougere/log': {} }` reaches — the last segment of the specifier is the
+ * export. An extension, so every process reading the config writes its calls, whatever `only:`
+ * it was started with; a path adds the file.
  */
-export declare const log: typeof logFrond;
+export declare const log: (path?: string) => Extension;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,SAAU,MAAM,4CAoBpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,GAAG,iBAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAkB,KAAK,SAAS,EAAe,MAAM,eAAe,CAAC;AAI5E,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,SAAU,MAAM,4CAoBpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,GAAG,UAAW,MAAM,KAAG,SAMlC,CAAC"}

package/dist/index.js

@@ -1,16 +1,18 @@
 /**
- * Where a log line GOES. The line itself is core's — the boot announces one before any
- * frond exists, so naming it there would cost core an optional package's vocabulary, and
- * the console is core's too: it writes every line whoever else took it.
+ * What is written about a call, and where a line GOES. The line itself is core's — the boot
+ * announces one before any frond exists, so naming it here would cost core an optional package's
+ * vocabulary — and the console is core's too: it writes every line whoever else took it.
  *
- * So what this package holds is a destination that sends a line SOMEWHERE ELSE. Stated and
- * not scanned: `frond()` is what a published package hands over, so a consumer needs no
- * TypeScript loader and no scan of its `node_modules`. The contract is written here for the
- * same reason — nobody reads this handler's source at boot.
+ * So this package holds the two lines every call writes, and a destination that sends a line
+ * SOMEWHERE ELSE. Stated and not scanned: `frond()` is what a published package hands over, so a
+ * consumer needs no TypeScript loader and no scan of its `node_modules`. The contract is written
+ * here for the same reason — nobody reads this handler's source at boot.
  */
 import { frond, LogLine } from '@fougere/core';
 import FileHandler, { LogFile } from './FileHandler.js';
+import { callLines } from './CallLines.js';
 export { default as FileHandler, LogFile } from './FileHandler.js';
+export { callLines } from './CallLines.js';
 /**
  * Lines to a file, one JSON object each. Leave it out and they only reach the console —
  * which is the whole difference from a logger you have to turn off.
@@ -39,9 +41,15 @@ export const logFrond = (path) => {
     });
 };
 /**
- * The name `fronds: { '@fougere/log': './lines.jsonl' }` reaches — the last segment of the
- * specifier is the export, which is what the Nuxt module already assumes of `calls` and
- * `observability`.
+ * The name `fronds: { '@fougere/log': {} }` reaches — the last segment of the specifier is the
+ * export. An extension, so every process reading the config writes its calls, whatever `only:`
+ * it was started with; a path adds the file.
  */
-export const log = logFrond;
+export const log = (path) => ({
+    name: 'log',
+    ...(path ? { fronds: [logFrond(path)] } : {}),
+    up(app) {
+        app.use(callLines(app.container.resolve('Logger')));
+    },
+});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE;IACvC,MAAM,KAAM,SAAQ,WAAW;QAC7B;YACE,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3B,CAAC;KACF;IAED,OAAO,KAAK,CAAC,KAAK,EAAE;QAClB,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,QAAQ,EAAE,CAAC;gBACT,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,EAAE;gBACR,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,KAAK,EAAE,OAAO;wBACd,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,CAAC;qBAC5F;iBACF;aACF,CAAC;KACH,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,EAAE,OAAO,EAA+B,MAAM,eAAe,CAAC;AAC5E,OAAO,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE;IACvC,MAAM,KAAM,SAAQ,WAAW;QAC7B;YACE,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3B,CAAC;KACF;IAED,OAAO,KAAK,CAAC,KAAK,EAAE;QAClB,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,QAAQ,EAAE,CAAC;gBACT,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,EAAE;gBACR,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,KAAK,EAAE,OAAO;wBACd,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,CAAC;qBAC5F;iBACF;aACF,CAAC;KACH,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,IAAa,EAAa,EAAE,CAAC,CAAC;IAChD,IAAI,EAAE,KAAK;IACX,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,EAAE,CAAC,GAAG;QACJ,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAS,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;CACF,CAAC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fougere/log",
-  "version": "0.16.3-alpha.0",
-  "description": "Logging for Fougere: a line is an announced fact, and a destination is a handler that accepts it. Ships the console one.",
+  "version": "0.16.5-alpha.0",
+  "description": "Logging for Fougere: two lines for every call, in every process, and a file destination for the lines.",
   "keywords": [
     "fougere",
     "typescript",
@@ -29,17 +29,17 @@
     "src"
   ],
   "peerDependencies": {
-    "@fougere/core": "^0.16.3-alpha.0",
-    "@fougere/schema": "^0.16.3-alpha.0"
+    "@fougere/core": "^0.16.5-alpha.0",
+    "@fougere/schema": "^0.16.5-alpha.0"
   },
   "devDependencies": {
-    "@fougere/compiler": "0.16.3-alpha.0",
-    "@fougere/container": "0.16.3-alpha.0",
-    "@fougere/core": "0.16.3-alpha.0",
-    "@fougere/schema": "0.16.3-alpha.0",
+    "@fougere/compiler": "0.16.5-alpha.0",
+    "@fougere/container": "0.16.5-alpha.0",
+    "@fougere/core": "0.16.5-alpha.0",
+    "@fougere/schema": "0.16.5-alpha.0",
     "vitest": "^4.1.0",
     "jiti": "^2.6.1",
-    "@fougere/testing": "0.16.3-alpha.0"
+    "@fougere/testing": "0.16.5-alpha.0"
   },
   "publishConfig": {
     "access": "public"

package/src/CallLines.ts

@@ -0,0 +1,31 @@
+import { CARRIES_LINE, type AppMiddleware, type Logger } from '@fougere/core';
+
+/**
+ * Two lines a call — that it began, and what it cost — written under the frond that answers. A
+ * call from another process names the one that signed it.
+ *
+ * An op that CARRIES a line writes none: it is dispatched, so logging it announces a line inside
+ * the announcement of one — `Emission cycle: logLine → logLine`.
+ */
+export function callLines(logger: Logger): AppMiddleware {
+  return async (context, next) => {
+    if (CARRIES_LINE.has(context.entity)) return next();
+
+    const log = context.frond ? logger.child(context.frond) : logger;
+    const call = `${context.handler ?? context.entity}.${context.operation}`;
+    const from = context.invocation?.caller ? ` ← ${context.invocation.caller}` : '';
+    const start = performance.now();
+    const cost = () => `(${(performance.now() - start).toFixed(1)}ms)`;
+
+    log.info(`${call}${from}`);
+    try {
+      const result = await next();
+      log.info(`${call} ${cost()}${from}`);
+
+      return result;
+    } catch (error) {
+      log.error(`${call} ${cost()}${from}`, error);
+      throw error;
+    }
+  };
+}

package/src/index.ts

@@ -1,17 +1,19 @@
 /**
- * Where a log line GOES. The line itself is core's — the boot announces one before any
- * frond exists, so naming it there would cost core an optional package's vocabulary, and
- * the console is core's too: it writes every line whoever else took it.
+ * What is written about a call, and where a line GOES. The line itself is core's — the boot
+ * announces one before any frond exists, so naming it here would cost core an optional package's
+ * vocabulary — and the console is core's too: it writes every line whoever else took it.
  *
- * So what this package holds is a destination that sends a line SOMEWHERE ELSE. Stated and
- * not scanned: `frond()` is what a published package hands over, so a consumer needs no
- * TypeScript loader and no scan of its `node_modules`. The contract is written here for the
- * same reason — nobody reads this handler's source at boot.
+ * So this package holds the two lines every call writes, and a destination that sends a line
+ * SOMEWHERE ELSE. Stated and not scanned: `frond()` is what a published package hands over, so a
+ * consumer needs no TypeScript loader and no scan of its `node_modules`. The contract is written
+ * here for the same reason — nobody reads this handler's source at boot.
  */
-import { frond, LogLine } from '@fougere/core';
+import { frond, LogLine, type Extension, type Logger } from '@fougere/core';
 import FileHandler, { LogFile } from './FileHandler.js';
+import { callLines } from './CallLines.js';
 
 export { default as FileHandler, LogFile } from './FileHandler.js';
+export { callLines } from './CallLines.js';
 
 /**
  * Lines to a file, one JSON object each. Leave it out and they only reach the console —
@@ -43,8 +45,14 @@ export const logFrond = (path: string) => {
 };
 
 /**
- * The name `fronds: { '@fougere/log': './lines.jsonl' }` reaches — the last segment of the
- * specifier is the export, which is what the Nuxt module already assumes of `calls` and
- * `observability`.
+ * The name `fronds: { '@fougere/log': {} }` reaches — the last segment of the specifier is the
+ * export. An extension, so every process reading the config writes its calls, whatever `only:`
+ * it was started with; a path adds the file.
  */
-export const log = logFrond;
+export const log = (path?: string): Extension => ({
+  name: 'log',
+  ...(path ? { fronds: [logFrond(path)] } : {}),
+  up(app) {
+    app.use(callLines(app.container.resolve<Logger>('Logger')));
+  },
+});