@langchain/langgraph-sdk 0.0.100 → 0.0.102

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @langchain/langgraph-sdk
 
+## 0.0.102
+
+### Patch Changes
+
+- 030698f: feat(api): add support for injecting `langgraph_node` in structured logs, expose structlog
+
+## 0.0.101
+
+### Patch Changes
+
+- f5e87cb: fix(sdk): allow async authorize callback
+
 ## 0.0.100
 
 ### Patch Changes

package/dist/auth/types.d.ts

@@ -282,7 +282,11 @@ export interface AuthenticateCallback<T extends BaseAuthReturn> {
 type OnKey = keyof ResourceType | keyof ActionType | keyof EventValueMap;
 type OnSingleParameter<T extends OnKey, TUser extends BaseUser = BaseUser> = T extends keyof ResourceType ? ResourceCallbackParameter<T, TUser> : T extends keyof ActionType ? ActionCallbackParameter<T, TUser> : T extends keyof EventValueMap ? AuthCallbackParameter<T, TUser> : never;
 type OnParameter<T extends "*" | OnKey | OnKey[], TUser extends BaseUser = BaseUser> = T extends OnKey[] ? OnSingleParameter<T[number], TUser> : T extends "*" ? AuthCallbackParameter<keyof EventValueMap, TUser> : T extends OnKey ? OnSingleParameter<T, TUser> : never;
-export type AnyCallback = (request: CallbackParameter) => void | boolean | Filters<string>;
+export type AnyCallback = {
+    (request: CallbackParameter): void | PromiseMaybe<boolean> | PromiseMaybe<Filters<string>>;
+};
 export type CallbackEvent = "*" | OnKey | OnKey[];
-export type OnCallback<T extends CallbackEvent, TUser extends BaseUser = BaseUser, TMetadata extends Record<string, unknown> = Record<string, unknown>> = (request: OnParameter<T, TUser>) => void | boolean | Filters<keyof TMetadata>;
+export type OnCallback<T extends CallbackEvent, TUser extends BaseUser = BaseUser, TMetadata extends Record<string, unknown> = Record<string, unknown>> = {
+    (request: OnParameter<T, TUser>): void | PromiseMaybe<boolean> | PromiseMaybe<Filters<keyof TMetadata>>;
+};
 export {};

package/dist/logging/index.cjs

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLogger = void 0;
+const GLOBAL_LOGGER = Symbol.for("langgraph.api.sdk-logger");
+/**
+ * Retrieves the global logger instance for LangGraph Platform.
+ *
+ * The logger provides structured logging capabilities with
+ * various log levels (error, warn, info, debug, etc.) and extra metadata such as node name etc.
+ *
+ * @returns {Logger} The global logger instance with leveled logging methods
+ *
+ * @throws {Error} When the logger is not available in the current environment
+ *
+ * @example
+ * ```typescript
+ * // Safe usage with fallback
+ * const logger = getLogger();
+ * logger.info("This will only work in LangGraph Platform environment");
+ * ```
+ *
+ * @remarks
+ * This method is designed to work specifically within the LangGraph Platform
+ * environment where a global logger is automatically registered. If you're
+ * developing locally or in an environment where LangGraph Platform is not
+ * available, this function will throw an error.
+ */
+const getLogger = () => {
+    const maybeGlobal = globalThis;
+    if (GLOBAL_LOGGER in maybeGlobal)
+        return maybeGlobal[GLOBAL_LOGGER];
+    throw new Error("Logger not available in current environment. " +
+        "This method requires LangGraph Platform environment where a global logger is automatically registered. " +
+        "If you're developing locally, consider using `console.log` or a local logging library instead.");
+};
+exports.getLogger = getLogger;

package/dist/logging/index.d.ts

@@ -0,0 +1,43 @@
+interface LeveledLogMethod {
+    (message: string, ...meta: any[]): Logger;
+    (message: any): Logger;
+    (infoObject: object): Logger;
+}
+interface Logger {
+    error: LeveledLogMethod;
+    warn: LeveledLogMethod;
+    help: LeveledLogMethod;
+    data: LeveledLogMethod;
+    info: LeveledLogMethod;
+    debug: LeveledLogMethod;
+    prompt: LeveledLogMethod;
+    http: LeveledLogMethod;
+    verbose: LeveledLogMethod;
+    input: LeveledLogMethod;
+    silly: LeveledLogMethod;
+}
+/**
+ * Retrieves the global logger instance for LangGraph Platform.
+ *
+ * The logger provides structured logging capabilities with
+ * various log levels (error, warn, info, debug, etc.) and extra metadata such as node name etc.
+ *
+ * @returns {Logger} The global logger instance with leveled logging methods
+ *
+ * @throws {Error} When the logger is not available in the current environment
+ *
+ * @example
+ * ```typescript
+ * // Safe usage with fallback
+ * const logger = getLogger();
+ * logger.info("This will only work in LangGraph Platform environment");
+ * ```
+ *
+ * @remarks
+ * This method is designed to work specifically within the LangGraph Platform
+ * environment where a global logger is automatically registered. If you're
+ * developing locally or in an environment where LangGraph Platform is not
+ * available, this function will throw an error.
+ */
+export declare const getLogger: () => Logger;
+export {};

package/dist/logging/index.js

@@ -0,0 +1,32 @@
+const GLOBAL_LOGGER = Symbol.for("langgraph.api.sdk-logger");
+/**
+ * Retrieves the global logger instance for LangGraph Platform.
+ *
+ * The logger provides structured logging capabilities with
+ * various log levels (error, warn, info, debug, etc.) and extra metadata such as node name etc.
+ *
+ * @returns {Logger} The global logger instance with leveled logging methods
+ *
+ * @throws {Error} When the logger is not available in the current environment
+ *
+ * @example
+ * ```typescript
+ * // Safe usage with fallback
+ * const logger = getLogger();
+ * logger.info("This will only work in LangGraph Platform environment");
+ * ```
+ *
+ * @remarks
+ * This method is designed to work specifically within the LangGraph Platform
+ * environment where a global logger is automatically registered. If you're
+ * developing locally or in an environment where LangGraph Platform is not
+ * available, this function will throw an error.
+ */
+export const getLogger = () => {
+    const maybeGlobal = globalThis;
+    if (GLOBAL_LOGGER in maybeGlobal)
+        return maybeGlobal[GLOBAL_LOGGER];
+    throw new Error("Logger not available in current environment. " +
+        "This method requires LangGraph Platform environment where a global logger is automatically registered. " +
+        "If you're developing locally, consider using `console.log` or a local logging library instead.");
+};

package/logging.cjs

@@ -0,0 +1 @@
+module.exports = require('./dist/logging/index.cjs');

package/logging.d.cts

@@ -0,0 +1 @@
+export * from './dist/logging/index.js'

package/logging.d.ts

@@ -0,0 +1 @@
+export * from './dist/logging/index.js'

package/logging.js

@@ -0,0 +1 @@
+export * from './dist/logging/index.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-sdk",
-  "version": "0.0.100",
+  "version": "0.0.102",
   "description": "Client library for interacting with the LangGraph API",
   "type": "module",
   "scripts": {
@@ -100,6 +100,15 @@
       "import": "./react.js",
       "require": "./react.cjs"
     },
+    "./logging": {
+      "types": {
+        "import": "./logging.d.ts",
+        "require": "./logging.d.cts",
+        "default": "./logging.d.ts"
+      },
+      "import": "./logging.js",
+      "require": "./logging.cjs"
+    },
     "./react-ui": {
       "types": {
         "import": "./react-ui.d.ts",
@@ -138,6 +147,10 @@
     "react.js",
     "react.d.ts",
     "react.d.cts",
+    "logging.cjs",
+    "logging.js",
+    "logging.d.ts",
+    "logging.d.cts",
     "react-ui.cjs",
     "react-ui.js",
     "react-ui.d.ts",