@logtape/logtape 2.2.0-dev.714 → 2.2.0-dev.715

package/README.md

@@ -125,6 +125,7 @@ list of the packages in the LogTape monorepo:
 | [*@logtape/redaction*](/packages/redaction/)               | [JSR][jsr:@logtape/redaction]        | [npm][npm:@logtape/redaction]        | Data redaction                |
 | [*@logtape/sentry*](/packages/sentry/)                     | [JSR][jsr:@logtape/sentry]           | [npm][npm:@logtape/sentry]           | [Sentry] sink                 |
 | [*@logtape/syslog*](/packages/syslog/)                     | [JSR][jsr:@logtape/syslog]           | [npm][npm:@logtape/syslog]           | Syslog sink                   |
+| [*@logtape/testing*](/packages/testing/)                   | [JSR][jsr:@logtape/testing]          | [npm][npm:@logtape/testing]          | Testing utilities             |
 | [*@logtape/windows-eventlog*](/packages/windows-eventlog/) | [JSR][jsr:@logtape/windows-eventlog] | [npm][npm:@logtape/windows-eventlog] | Windows Event Log sink        |
 
 [jsr:@logtape/logtape]: https://jsr.io/@logtape/logtape
@@ -175,6 +176,8 @@ list of the packages in the LogTape monorepo:
 [Sentry]: https://sentry.io/
 [jsr:@logtape/syslog]: https://jsr.io/@logtape/syslog
 [npm:@logtape/syslog]: https://www.npmjs.com/package/@logtape/syslog
+[jsr:@logtape/testing]: https://jsr.io/@logtape/testing
+[npm:@logtape/testing]: https://www.npmjs.com/package/@logtape/testing
 [jsr:@logtape/windows-eventlog]: https://jsr.io/@logtape/windows-eventlog
 [npm:@logtape/windows-eventlog]: https://www.npmjs.com/package/@logtape/windows-eventlog
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logtape/logtape",
-  "version": "2.2.0-dev.714+31374a57",
+  "version": "2.2.0-dev.715+dc8e6b45",
   "description": "Unobtrusive logging library with zero dependencies—library-first design for Deno/Node.js/Bun/browsers/edge",
   "keywords": [
     "logging",

package/skills/logtape/SKILL.md

@@ -480,26 +480,35 @@ See <https://logtape.org/manual/adaptors.md> for details.
 Testing
 -------
 
-For tests, configure a buffer sink and assert on collected records:
+For tests, use `@logtape/testing` and assert on collected records:
 
 ~~~~ typescript
-import { configure, getLogger, reset, type LogRecord } from "@logtape/logtape";
+import { configure, getLogger, reset } from "@logtape/logtape";
+import { createLogRecorder } from "@logtape/testing";
 
-const buffer: LogRecord[] = [];
+const recorder = createLogRecorder();
 
-await configure({
-  sinks: { buffer: buffer.push.bind(buffer) },
-  loggers: [{ category: "test", sinks: ["buffer"] }],
-});
-
-const logger = getLogger(["test"]);
-logger.info("hello");
+try {
+  await configure({
+    sinks: { recorder: recorder.sink },
+    loggers: [
+      { category: "test", sinks: ["recorder"] },
+      { category: ["logtape", "meta"], sinks: [] },
+    ],
+  });
 
-// Assert
-assert(buffer.length === 1);
-assert(buffer[0].level === "info");
+  const logger = getLogger(["test"]);
+  logger.info("User {userId} logged in.", { userId: "u-123" });
 
-await reset();
+  recorder.assertLogged({
+    category: "test",
+    level: "info",
+    message: "User u-123 logged in.",
+    properties: { userId: "u-123" },
+  });
+} finally {
+  await reset();
+}
 ~~~~
 
 If using `configureSync()`, reset with `resetSync()`:
@@ -550,6 +559,12 @@ Available packages
 | `@logtape/pretty`    | Pretty console formatter |
 | `@logtape/redaction` | Sensitive data redaction |
 
+### Testing
+
+| Package            | Description                  |
+| ------------------ | ---------------------------- |
+| `@logtape/testing` | Log recording and assertions |
+
 ### Adaptors (for existing loggers)
 
 | Package                    | Description           |