@sanity/workbench 0.1.0-alpha.2 → 0.1.0-alpha.3

package/dist/_internal.d.ts

@@ -3,7 +3,12 @@
  *
  * @public
  */
-export declare type Config = undefined;
+export declare type Config = {
+  /**
+   * The organization ID to use when rendering the workbench.
+   */
+  organizationId: string | undefined;
+};
 
 /**
  * Creates a Module Federation instance, loads a remote workbench

package/dist/_internal.js

@@ -1,36 +1,33 @@
 import { createInstance } from "@sanity/federation/runtime";
-const REMOTE_NAME = "workbench-remote", REMOTE_MODULE = "App";
+import { log } from "@sanity/federation/runtime/plugins/log";
+import { createLogger } from "./log.js";
+const logger = createLogger({
+  namespace: "sanity-workbench",
+  logLevel: "debug"
+}), REMOTE_NAME = "workbench-remote", REMOTE_MODULE = "App";
 async function renderWorkbench(rootElement, config, options) {
   if (!rootElement)
     throw new Error("Missing root element to mount application into");
   const remoteUrl = import.meta.env.SANITY_INTERNAL_WORKBENCH_REMOTE_URL;
   if (!remoteUrl)
     throw new Error("SANITY_INTERNAL_WORKBENCH_REMOTE_URL is not set");
-  const mf = createInstance({
-    name: "sanity-workbench"
-  });
-  mf.registerRemotes([
-    {
-      name: REMOTE_NAME,
-      entry: remoteUrl
-    }
-  ]);
-  let remoteModule;
-  try {
-    remoteModule = await mf.loadRemote(
-      `${REMOTE_NAME}/${REMOTE_MODULE}`
-    );
-  } catch (error) {
-    throw new Error(
-      `Failed to load remote workbench module from "${remoteUrl}"`,
-      { cause: error }
-    );
-  }
-  if (!remoteModule || typeof remoteModule.render != "function")
+  let remoteModule = await createInstance({
+    name: "sanity-workbench",
+    plugins: [log(logger.debug)],
+    remotes: [
+      {
+        name: REMOTE_NAME,
+        entry: remoteUrl
+      }
+    ]
+  }).loadRemote(
+    `${REMOTE_NAME}/${REMOTE_MODULE}`
+  );
+  if (!remoteModule || typeof remoteModule.setup != "function")
     throw new Error(
-      `Remote module from "${remoteUrl}" did not expose a render function`
+      `Remote module "${REMOTE_NAME}/${REMOTE_MODULE}" did not expose a setup function`
     );
-  return remoteModule.render(rootElement, config, options);
+  return remoteModule.setup(config, options).render(rootElement);
 }
 export {
   renderWorkbench

package/dist/_internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"_internal.js","sources":["../src/_internal/render.ts"],"sourcesContent":["import { createInstance } from \"@sanity/federation/runtime\";\n\n/**\n * Workbench configuration.\n *\n * @public\n */\nexport type Config = undefined;\n\n/**\n * Options for rendering the workbench.\n *\n * @public\n */\nexport interface RenderWorkbenchOptions {\n  reactStrictMode?: boolean;\n}\n\ndeclare global {\n  interface ImportMetaEnv {\n    readonly SANITY_INTERNAL_WORKBENCH_REMOTE_URL: string;\n  }\n  interface ImportMeta {\n    readonly env: ImportMetaEnv;\n  }\n}\n\nconst REMOTE_NAME = \"workbench-remote\";\nconst REMOTE_MODULE = \"App\";\n\ninterface RemoteModule {\n  render(\n    rootElement: HTMLElement,\n    config?: Config,\n    options?: RenderWorkbenchOptions,\n  ): () => void;\n}\n\n/**\n * Creates a Module Federation instance, loads a remote workbench\n * application, and renders it into the provided root element.\n *\n * @param rootElement - The DOM element to render into\n * @param config - Workbench configuration (reserved for future use)\n * @param options - Rendering options forwarded to the remote\n * @returns A cleanup function that unmounts the remote application\n *\n * @public\n */\nexport async function renderWorkbench(\n  rootElement: HTMLElement,\n  config?: Config,\n  options?: RenderWorkbenchOptions,\n): Promise<() => void> {\n  if (!rootElement) {\n    throw new Error(\"Missing root element to mount application into\");\n  }\n\n  const remoteUrl = import.meta.env.SANITY_INTERNAL_WORKBENCH_REMOTE_URL;\n\n  if (!remoteUrl) {\n    throw new Error(\"SANITY_INTERNAL_WORKBENCH_REMOTE_URL is not set\");\n  }\n\n  const mf = createInstance({\n    name: \"sanity-workbench\",\n  });\n\n  mf.registerRemotes([\n    {\n      name: REMOTE_NAME,\n      entry: remoteUrl,\n    },\n  ]);\n\n  let remoteModule: RemoteModule | null;\n  try {\n    remoteModule = await mf.loadRemote<RemoteModule>(\n      `${REMOTE_NAME}/${REMOTE_MODULE}`,\n    );\n  } catch (error) {\n    throw new Error(\n      `Failed to load remote workbench module from \"${remoteUrl}\"`,\n      { cause: error },\n    );\n  }\n\n  if (!remoteModule || typeof remoteModule.render !== \"function\") {\n    throw new Error(\n      `Remote module from \"${remoteUrl}\" did not expose a render function`,\n    );\n  }\n\n  return remoteModule.render(rootElement, config, options);\n}\n"],"names":[],"mappings":";AA2BA,MAAM,cAAc,oBACd,gBAAgB;AAqBtB,eAAsB,gBACpB,aACA,QACA,SACqB;AACrB,MAAI,CAAC;AACH,UAAM,IAAI,MAAM,gDAAgD;AAGlE,QAAM,YAAY,YAAY,IAAI;AAElC,MAAI,CAAC;AACH,UAAM,IAAI,MAAM,iDAAiD;AAGnE,QAAM,KAAK,eAAe;AAAA,IACxB,MAAM;AAAA,EAAA,CACP;AAED,KAAG,gBAAgB;AAAA,IACjB;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,IAAA;AAAA,EACT,CACD;AAED,MAAI;AACJ,MAAI;AACF,mBAAe,MAAM,GAAG;AAAA,MACtB,GAAG,WAAW,IAAI,aAAa;AAAA,IAAA;AAAA,EAEnC,SAAS,OAAO;AACd,UAAM,IAAI;AAAA,MACR,gDAAgD,SAAS;AAAA,MACzD,EAAE,OAAO,MAAA;AAAA,IAAM;AAAA,EAEnB;AAEA,MAAI,CAAC,gBAAgB,OAAO,aAAa,UAAW;AAClD,UAAM,IAAI;AAAA,MACR,uBAAuB,SAAS;AAAA,IAAA;AAIpC,SAAO,aAAa,OAAO,aAAa,QAAQ,OAAO;AACzD;"}
+{"version":3,"file":"_internal.js","sources":["../src/_internal/render.ts"],"sourcesContent":["import { createInstance } from \"@sanity/federation/runtime\";\nimport { log } from \"@sanity/federation/runtime/plugins/log\";\nimport { createLogger } from \"../log\";\n\nconst logger = createLogger({\n  namespace: \"sanity-workbench\",\n  logLevel: \"debug\",\n});\n\n/**\n * Workbench configuration.\n *\n * @public\n */\nexport type Config = {\n  /**\n   * The organization ID to use when rendering the workbench.\n   */\n  organizationId: string | undefined;\n};\n\n/**\n * Options for rendering the workbench.\n *\n * @public\n */\nexport interface RenderWorkbenchOptions {\n  reactStrictMode?: boolean;\n}\n\ndeclare global {\n  interface ImportMetaEnv {\n    readonly SANITY_INTERNAL_WORKBENCH_REMOTE_URL: string;\n  }\n  interface ImportMeta {\n    readonly env: ImportMetaEnv;\n  }\n}\n\n/**\n * Module defining the remote workbench application.\n *\n * @public\n */\ninterface WorkbenchRemoteModule {\n  setup: (\n    config?: Config,\n    options?: RenderWorkbenchOptions,\n  ) => {\n    render(rootElement: HTMLElement): () => void;\n  };\n}\n\nconst REMOTE_NAME = \"workbench-remote\";\nconst REMOTE_MODULE = \"App\";\n\n/**\n * Creates a Module Federation instance, loads a remote workbench\n * application, and renders it into the provided root element.\n *\n * @param rootElement - The DOM element to render into\n * @param config - Workbench configuration (reserved for future use)\n * @param options - Rendering options forwarded to the remote\n * @returns A cleanup function that unmounts the remote application\n *\n * @public\n */\nexport async function renderWorkbench(\n  rootElement: HTMLElement,\n  config?: Config,\n  options?: RenderWorkbenchOptions,\n) {\n  if (!rootElement) {\n    throw new Error(\"Missing root element to mount application into\");\n  }\n\n  const remoteUrl = import.meta.env.SANITY_INTERNAL_WORKBENCH_REMOTE_URL;\n\n  if (!remoteUrl) {\n    throw new Error(\"SANITY_INTERNAL_WORKBENCH_REMOTE_URL is not set\");\n  }\n\n  const mf = createInstance({\n    name: \"sanity-workbench\",\n    plugins: [log(logger.debug)],\n\n    remotes: [\n      {\n        name: REMOTE_NAME,\n        entry: remoteUrl,\n      },\n    ],\n  });\n\n  let remoteModule = await mf.loadRemote<WorkbenchRemoteModule>(\n    `${REMOTE_NAME}/${REMOTE_MODULE}`,\n  );\n\n  if (!remoteModule || typeof remoteModule.setup !== \"function\") {\n    throw new Error(\n      `Remote module \"${REMOTE_NAME}/${REMOTE_MODULE}\" did not expose a setup function`,\n    );\n  }\n\n  const instance = remoteModule.setup(config, options);\n\n  return instance.render(rootElement);\n}\n"],"names":[],"mappings":";;;AAIA,MAAM,SAAS,aAAa;AAAA,EAC1B,WAAW;AAAA,EACX,UAAU;AACZ,CAAC,GA8CK,cAAc,oBACd,gBAAgB;AAatB,eAAsB,gBACpB,aACA,QACA,SACA;AACA,MAAI,CAAC;AACH,UAAM,IAAI,MAAM,gDAAgD;AAGlE,QAAM,YAAY,YAAY,IAAI;AAElC,MAAI,CAAC;AACH,UAAM,IAAI,MAAM,iDAAiD;AAenE,MAAI,eAAe,MAZR,eAAe;AAAA,IACxB,MAAM;AAAA,IACN,SAAS,CAAC,IAAI,OAAO,KAAK,CAAC;AAAA,IAE3B,SAAS;AAAA,MACP;AAAA,QACE,MAAM;AAAA,QACN,OAAO;AAAA,MAAA;AAAA,IACT;AAAA,EACF,CACD,EAE2B;AAAA,IAC1B,GAAG,WAAW,IAAI,aAAa;AAAA,EAAA;AAGjC,MAAI,CAAC,gBAAgB,OAAO,aAAa,SAAU;AACjD,UAAM,IAAI;AAAA,MACR,kBAAkB,WAAW,IAAI,aAAa;AAAA,IAAA;AAMlD,SAFiB,aAAa,MAAM,QAAQ,OAAO,EAEnC,OAAO,WAAW;AACpC;"}

package/dist/log.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @public
+ */
+export declare function createLogger({
+  namespace,
+  context: baseContext,
+  logLevel,
+}?: LoggerOptions): Logger;
+
+declare type LogContext = {
+  [key: string]: unknown;
+};
+
+/**
+ * @public
+ */
+export declare interface Logger {
+  error: (message: string, context?: LogContext) => void;
+  warn: (message: string, context?: LogContext) => void;
+  info: (message: string, context?: LogContext) => void;
+  debug: (message: string, context?: LogContext) => void;
+}
+
+declare interface LoggerOptions {
+  namespace?: LogNamespace;
+  context?: LogContext;
+  logLevel?: LogLevel;
+}
+
+/**
+ * Log levels in order of verbosity (least to most)
+ * - none: Silent
+ * - error: Critical failures that prevent operation
+ * - warn: Issues that may cause problems but don't stop execution
+ * - info: High-level informational messages (default)
+ * - debug: Detailed debugging information (maintainer level)
+ * - trace: Very detailed tracing — sets `internal: true` on context
+ * @public
+ */
+export declare type LogLevel = "none" | "error" | "warn" | "info" | "debug";
+
+/**
+ * Namespaces organize logs by functional domain.
+ * @internal
+ */
+export declare type LogNamespace = string;
+
+export {};

package/dist/log.js

@@ -0,0 +1,29 @@
+const LEVELS = ["none", "error", "warn", "info", "debug"];
+function createLogger({
+  namespace,
+  context: baseContext,
+  logLevel = "info"
+} = {}) {
+  function isLevelEnabled(level) {
+    return LEVELS.indexOf(level) <= LEVELS.indexOf(logLevel);
+  }
+  function logAtLevel(level, message, context) {
+    if (!isLevelEnabled(level)) return;
+    const merged = baseContext ?? context ? { ...baseContext, ...context } : void 0, args = [
+      ...namespace ? [`[${namespace}]`] : [],
+      message,
+      ...merged ? [merged] : []
+    ];
+    level === "error" ? console.error(...args) : level === "warn" ? console.warn(...args) : level === "info" ? console.info(...args) : console.debug(...args);
+  }
+  return {
+    error: (message, context) => logAtLevel("error", message, context),
+    warn: (message, context) => logAtLevel("warn", message, context),
+    info: (message, context) => logAtLevel("info", message, context),
+    debug: (message, context) => logAtLevel("debug", message, context)
+  };
+}
+export {
+  createLogger
+};
+//# sourceMappingURL=log.js.map

package/dist/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sources":["../src/log/index.ts"],"sourcesContent":["/**\n * Log levels in order of verbosity (least to most)\n * - none: Silent\n * - error: Critical failures that prevent operation\n * - warn: Issues that may cause problems but don't stop execution\n * - info: High-level informational messages (default)\n * - debug: Detailed debugging information (maintainer level)\n * - trace: Very detailed tracing — sets `internal: true` on context\n * @public\n */\nexport type LogLevel = \"none\" | \"error\" | \"warn\" | \"info\" | \"debug\";\n\n/**\n * Namespaces organize logs by functional domain.\n * @internal\n */\nexport type LogNamespace = string;\n\ntype LogContext = { [key: string]: unknown };\n\n/**\n * @public\n */\nexport interface Logger {\n  error: (message: string, context?: LogContext) => void;\n  warn: (message: string, context?: LogContext) => void;\n  info: (message: string, context?: LogContext) => void;\n  debug: (message: string, context?: LogContext) => void;\n}\n\nconst LEVELS: readonly LogLevel[] = [\"none\", \"error\", \"warn\", \"info\", \"debug\"];\n\ninterface LoggerOptions {\n  namespace?: LogNamespace;\n  context?: LogContext;\n  logLevel?: LogLevel;\n}\n\n/**\n * @public\n */\nexport function createLogger({\n  namespace,\n  context: baseContext,\n  logLevel = \"info\",\n}: LoggerOptions = {}): Logger {\n  function isLevelEnabled(level: LogLevel): boolean {\n    return LEVELS.indexOf(level) <= LEVELS.indexOf(logLevel);\n  }\n\n  function logAtLevel(\n    level: LogLevel,\n    message: string,\n    context?: LogContext,\n  ): void {\n    if (!isLevelEnabled(level)) return;\n\n    const merged =\n      (baseContext ?? context) ? { ...baseContext, ...context } : undefined;\n    const args: unknown[] = [\n      ...(namespace ? [`[${namespace}]`] : []),\n      message,\n      ...(merged ? [merged] : []),\n    ];\n\n    if (level === \"error\") console.error(...args);\n    else if (level === \"warn\") console.warn(...args);\n    // oxlint-disable-next-line no-console\n    else if (level === \"info\") console.info(...args);\n    // oxlint-disable-next-line no-console\n    else console.debug(...args);\n  }\n\n  return {\n    error: (message, context) => logAtLevel(\"error\", message, context),\n    warn: (message, context) => logAtLevel(\"warn\", message, context),\n    info: (message, context) => logAtLevel(\"info\", message, context),\n    debug: (message, context) => logAtLevel(\"debug\", message, context),\n  };\n}\n"],"names":[],"mappings":"AA8BA,MAAM,SAA8B,CAAC,QAAQ,SAAS,QAAQ,QAAQ,OAAO;AAWtE,SAAS,aAAa;AAAA,EAC3B;AAAA,EACA,SAAS;AAAA,EACT,WAAW;AACb,IAAmB,IAAY;AAC7B,WAAS,eAAe,OAA0B;AAChD,WAAO,OAAO,QAAQ,KAAK,KAAK,OAAO,QAAQ,QAAQ;AAAA,EACzD;AAEA,WAAS,WACP,OACA,SACA,SACM;AACN,QAAI,CAAC,eAAe,KAAK,EAAG;AAE5B,UAAM,SACH,eAAe,UAAW,EAAE,GAAG,aAAa,GAAG,QAAA,IAAY,QACxD,OAAkB;AAAA,MACtB,GAAI,YAAY,CAAC,IAAI,SAAS,GAAG,IAAI,CAAA;AAAA,MACrC;AAAA,MACA,GAAI,SAAS,CAAC,MAAM,IAAI,CAAA;AAAA,IAAC;AAGvB,cAAU,UAAS,QAAQ,MAAM,GAAG,IAAI,IACnC,UAAU,SAAQ,QAAQ,KAAK,GAAG,IAAI,IAEtC,UAAU,SAAQ,QAAQ,KAAK,GAAG,IAAI,IAE1C,QAAQ,MAAM,GAAG,IAAI;AAAA,EAC5B;AAEA,SAAO;AAAA,IACL,OAAO,CAAC,SAAS,YAAY,WAAW,SAAS,SAAS,OAAO;AAAA,IACjE,MAAM,CAAC,SAAS,YAAY,WAAW,QAAQ,SAAS,OAAO;AAAA,IAC/D,MAAM,CAAC,SAAS,YAAY,WAAW,QAAQ,SAAS,OAAO;AAAA,IAC/D,OAAO,CAAC,SAAS,YAAY,WAAW,SAAS,SAAS,OAAO;AAAA,EAAA;AAErE;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/workbench",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.3",
   "description": "Workbench component for the Sanity Content Operating System",
   "keywords": [],
   "homepage": "https://github.com/sanity-io/workbench/packages/@sanity/workbench#readme",
@@ -24,6 +24,10 @@
       "source": "./src/_exports/_internal.ts",
       "default": "./dist/_internal.js"
     },
+    "./log": {
+      "source": "./src/_exports/log.ts",
+      "default": "./dist/log.js"
+    },
     "./package.json": "./package.json"
   },
   "dependencies": {
@@ -31,7 +35,7 @@
   },
   "devDependencies": {
     "@sanity/pkg-utils": "^9.2.3",
-    "typescript": "^5.9.2",
+    "typescript": "^6.0.2",
     "@repo/oxc-config": "0.0.0",
     "@repo/tsconfig": "0.0.1"
   },

package/src/_exports/log.ts

@@ -0,0 +1 @@
+export * from "../log";

package/src/_internal/render.ts

@@ -1,11 +1,23 @@
 import { createInstance } from "@sanity/federation/runtime";
+import { log } from "@sanity/federation/runtime/plugins/log";
+import { createLogger } from "../log";
+
+const logger = createLogger({
+  namespace: "sanity-workbench",
+  logLevel: "debug",
+});
 
 /**
  * Workbench configuration.
  *
  * @public
  */
-export type Config = undefined;
+export type Config = {
+  /**
+   * The organization ID to use when rendering the workbench.
+   */
+  organizationId: string | undefined;
+};
 
 /**
  * Options for rendering the workbench.
@@ -25,17 +37,23 @@ declare global {
   }
 }
 
-const REMOTE_NAME = "workbench-remote";
-const REMOTE_MODULE = "App";
-
-interface RemoteModule {
-  render(
-    rootElement: HTMLElement,
+/**
+ * Module defining the remote workbench application.
+ *
+ * @public
+ */
+interface WorkbenchRemoteModule {
+  setup: (
     config?: Config,
     options?: RenderWorkbenchOptions,
-  ): () => void;
+  ) => {
+    render(rootElement: HTMLElement): () => void;
+  };
 }
 
+const REMOTE_NAME = "workbench-remote";
+const REMOTE_MODULE = "App";
+
 /**
  * Creates a Module Federation instance, loads a remote workbench
  * application, and renders it into the provided root element.
@@ -51,7 +69,7 @@ export async function renderWorkbench(
   rootElement: HTMLElement,
   config?: Config,
   options?: RenderWorkbenchOptions,
-): Promise<() => void> {
+) {
   if (!rootElement) {
     throw new Error("Missing root element to mount application into");
   }
@@ -64,32 +82,27 @@ export async function renderWorkbench(
 
   const mf = createInstance({
     name: "sanity-workbench",
+    plugins: [log(logger.debug)],
+
+    remotes: [
+      {
+        name: REMOTE_NAME,
+        entry: remoteUrl,
+      },
+    ],
   });
 
-  mf.registerRemotes([
-    {
-      name: REMOTE_NAME,
-      entry: remoteUrl,
-    },
-  ]);
+  let remoteModule = await mf.loadRemote<WorkbenchRemoteModule>(
+    `${REMOTE_NAME}/${REMOTE_MODULE}`,
+  );
 
-  let remoteModule: RemoteModule | null;
-  try {
-    remoteModule = await mf.loadRemote<RemoteModule>(
-      `${REMOTE_NAME}/${REMOTE_MODULE}`,
-    );
-  } catch (error) {
+  if (!remoteModule || typeof remoteModule.setup !== "function") {
     throw new Error(
-      `Failed to load remote workbench module from "${remoteUrl}"`,
-      { cause: error },
+      `Remote module "${REMOTE_NAME}/${REMOTE_MODULE}" did not expose a setup function`,
     );
   }
 
-  if (!remoteModule || typeof remoteModule.render !== "function") {
-    throw new Error(
-      `Remote module from "${remoteUrl}" did not expose a render function`,
-    );
-  }
+  const instance = remoteModule.setup(config, options);
 
-  return remoteModule.render(rootElement, config, options);
+  return instance.render(rootElement);
 }

package/src/log/index.test.ts

@@ -0,0 +1,133 @@
+import {
+  type MockInstance,
+  afterEach,
+  beforeEach,
+  describe,
+  expect,
+  it,
+  vi,
+} from "vitest";
+
+import { createLogger } from ".";
+
+describe("createLogger", () => {
+  let error: MockInstance;
+  let warn: MockInstance;
+  let info: MockInstance;
+  let debug: MockInstance;
+
+  beforeEach(() => {
+    error = vi.spyOn(console, "error").mockImplementation(() => undefined);
+    warn = vi.spyOn(console, "warn").mockImplementation(() => undefined);
+    info = vi.spyOn(console, "info").mockImplementation(() => undefined);
+    debug = vi.spyOn(console, "debug").mockImplementation(() => undefined);
+  });
+
+  afterEach(() => vi.restoreAllMocks());
+
+  it("'none': logs nothing", () => {
+    const logger = createLogger({ logLevel: "none" });
+
+    logger.error("e");
+    logger.warn("w");
+    logger.info("i");
+    logger.debug("d");
+
+    expect(error).not.toHaveBeenCalled();
+    expect(warn).not.toHaveBeenCalled();
+    expect(info).not.toHaveBeenCalled();
+    expect(debug).not.toHaveBeenCalled();
+  });
+
+  it("'error': logs only error", () => {
+    const logger = createLogger({ logLevel: "error" });
+
+    logger.error("e");
+    logger.warn("w");
+    logger.info("i");
+    logger.debug("d");
+
+    expect(error).toHaveBeenCalledOnce();
+    expect(warn).not.toHaveBeenCalled();
+    expect(info).not.toHaveBeenCalled();
+    expect(debug).not.toHaveBeenCalled();
+  });
+
+  it("'warn': logs error and warn", () => {
+    const logger = createLogger({ logLevel: "warn" });
+
+    logger.error("e");
+    logger.warn("w");
+    logger.info("i");
+    logger.debug("d");
+
+    expect(error).toHaveBeenCalledOnce();
+    expect(warn).toHaveBeenCalledOnce();
+    expect(info).not.toHaveBeenCalled();
+    expect(debug).not.toHaveBeenCalled();
+  });
+
+  it("'info' (default): logs error, warn, and info", () => {
+    const logger = createLogger();
+
+    logger.error("e");
+    logger.warn("w");
+    logger.info("i");
+    logger.debug("d");
+
+    expect(error).toHaveBeenCalledOnce();
+    expect(warn).toHaveBeenCalledOnce();
+    expect(info).toHaveBeenCalledOnce();
+    expect(debug).not.toHaveBeenCalled();
+  });
+
+  it("'debug': logs everything", () => {
+    const logger = createLogger({ logLevel: "debug" });
+
+    logger.error("e");
+    logger.warn("w");
+    logger.info("i");
+    logger.debug("d");
+
+    expect(error).toHaveBeenCalledOnce();
+    expect(warn).toHaveBeenCalledOnce();
+    expect(info).toHaveBeenCalledOnce();
+    expect(debug).toHaveBeenCalledOnce();
+  });
+
+  it("prepends [namespace] to all messages", () => {
+    const logger = createLogger({ namespace: "myns", logLevel: "debug" });
+
+    logger.error("msg");
+    logger.warn("msg");
+    logger.info("msg");
+    logger.debug("msg");
+
+    expect(error).toHaveBeenCalledWith("[myns]", "msg");
+    expect(warn).toHaveBeenCalledWith("[myns]", "msg");
+    expect(info).toHaveBeenCalledWith("[myns]", "msg");
+    expect(debug).toHaveBeenCalledWith("[myns]", "msg");
+  });
+
+  it("passes context as a third argument when provided", () => {
+    const logger = createLogger({ namespace: "ns", logLevel: "debug" });
+    const ctx = { requestId: "123" };
+    logger.error("msg", ctx);
+    expect(error).toHaveBeenCalledWith("[ns]", "msg", ctx);
+  });
+
+  it("merges base context with call-site context", () => {
+    const logger = createLogger({
+      namespace: "ns",
+      context: { service: "workbench" },
+      logLevel: "debug",
+    });
+
+    logger.debug("msg", { requestId: "42" });
+
+    expect(debug).toHaveBeenCalledWith("[ns]", "msg", {
+      service: "workbench",
+      requestId: "42",
+    });
+  });
+});

package/src/log/index.ts

@@ -0,0 +1,80 @@
+/**
+ * Log levels in order of verbosity (least to most)
+ * - none: Silent
+ * - error: Critical failures that prevent operation
+ * - warn: Issues that may cause problems but don't stop execution
+ * - info: High-level informational messages (default)
+ * - debug: Detailed debugging information (maintainer level)
+ * - trace: Very detailed tracing — sets `internal: true` on context
+ * @public
+ */
+export type LogLevel = "none" | "error" | "warn" | "info" | "debug";
+
+/**
+ * Namespaces organize logs by functional domain.
+ * @internal
+ */
+export type LogNamespace = string;
+
+type LogContext = { [key: string]: unknown };
+
+/**
+ * @public
+ */
+export interface Logger {
+  error: (message: string, context?: LogContext) => void;
+  warn: (message: string, context?: LogContext) => void;
+  info: (message: string, context?: LogContext) => void;
+  debug: (message: string, context?: LogContext) => void;
+}
+
+const LEVELS: readonly LogLevel[] = ["none", "error", "warn", "info", "debug"];
+
+interface LoggerOptions {
+  namespace?: LogNamespace;
+  context?: LogContext;
+  logLevel?: LogLevel;
+}
+
+/**
+ * @public
+ */
+export function createLogger({
+  namespace,
+  context: baseContext,
+  logLevel = "info",
+}: LoggerOptions = {}): Logger {
+  function isLevelEnabled(level: LogLevel): boolean {
+    return LEVELS.indexOf(level) <= LEVELS.indexOf(logLevel);
+  }
+
+  function logAtLevel(
+    level: LogLevel,
+    message: string,
+    context?: LogContext,
+  ): void {
+    if (!isLevelEnabled(level)) return;
+
+    const merged =
+      (baseContext ?? context) ? { ...baseContext, ...context } : undefined;
+    const args: unknown[] = [
+      ...(namespace ? [`[${namespace}]`] : []),
+      message,
+      ...(merged ? [merged] : []),
+    ];
+
+    if (level === "error") console.error(...args);
+    else if (level === "warn") console.warn(...args);
+    // oxlint-disable-next-line no-console
+    else if (level === "info") console.info(...args);
+    // oxlint-disable-next-line no-console
+    else console.debug(...args);
+  }
+
+  return {
+    error: (message, context) => logAtLevel("error", message, context),
+    warn: (message, context) => logAtLevel("warn", message, context),
+    info: (message, context) => logAtLevel("info", message, context),
+    debug: (message, context) => logAtLevel("debug", message, context),
+  };
+}