@barry-rocks/sdk/logging/edge

The logger for code that runs on an edge runtime such as Cloudflare Workers, where Node’s file and process APIs aren’t available. It exposes createWorkerLogger with the same log shape as the Node logger.

import { … } from "@barry-rocks/sdk/logging/edge";

API

Interfaces

CloudflareExecutionContext

Methods

passThroughOnException()

passThroughOnException(): void

Returns

void

waitUntil()

waitUntil(promise): void

Parameters

Parameter	Type
promise	Promise<unknown>

Returns

void

---

WorkerLoggerEnv

Indexable

[binding: string]: unknown

---

WorkerLoggerOptions

Properties

Property	Type	Description
ctx?	CloudflareExecutionContext	ExecutionContext — a remote sink would flush through waitUntil.
env?	WorkerLoggerEnv	Worker env bindings.

Functions

createWorkerLogger()

createWorkerLogger(service, options?, baseContext?): Logger

Create a logger for a Cloudflare Worker.

Parameters

Parameter	Type
service	string
options	WorkerLoggerOptions
baseContext	LogContext

Returns

Logger

Example

import { createWorkerLogger } from "./emit-edge.js";

export default {
  async fetch(request: Request, env: Env, ctx: ExecutionContext) {
    const log = createWorkerLogger("artifacts", { env, ctx });
    log.info("request.start", { path: new URL(request.url).pathname });
    await log.flush();
    return response;
  }
};

References

LogContext

Re-exports LogContext

---

Logger

Re-exports Logger

---

LogLevel

Re-exports LogLevel