langsmith 0.1.43 → 0.1.44

package/dist/utils/error.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.printErrorStackTrace = void 0;
+exports.raiseForStatus = exports.LangSmithConflictError = exports.printErrorStackTrace = void 0;
 function getErrorStackTrace(e) {
     if (typeof e !== "object" || e == null)
         return undefined;
@@ -23,3 +23,67 @@ function printErrorStackTrace(e) {
     console.error(stack);
 }
 exports.printErrorStackTrace = printErrorStackTrace;
+/**
+ * LangSmithConflictError
+ *
+ * Represents an error that occurs when there's a conflict during an operation,
+ * typically corresponding to HTTP 409 status code responses.
+ *
+ * This error is thrown when an attempt to create or modify a resource conflicts
+ * with the current state of the resource on the server. Common scenarios include:
+ * - Attempting to create a resource that already exists
+ * - Trying to update a resource that has been modified by another process
+ * - Violating a uniqueness constraint in the data
+ *
+ * @extends Error
+ *
+ * @example
+ * try {
+ *   await createProject("existingProject");
+ * } catch (error) {
+ *   if (error instanceof ConflictError) {
+ *     console.log("A conflict occurred:", error.message);
+ *     // Handle the conflict, e.g., by suggesting a different project name
+ *   } else {
+ *     // Handle other types of errors
+ *   }
+ * }
+ *
+ * @property {string} name - Always set to 'ConflictError' for easy identification
+ * @property {string} message - Detailed error message including server response
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/409
+ */
+class LangSmithConflictError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "LangSmithConflictError";
+    }
+}
+exports.LangSmithConflictError = LangSmithConflictError;
+/**
+ * Throws an appropriate error based on the response status and body.
+ *
+ * @param response - The fetch Response object
+ * @param context - Additional context to include in the error message (e.g., operation being performed)
+ * @throws {LangSmithConflictError} When the response status is 409
+ * @throws {Error} For all other non-ok responses
+ */
+async function raiseForStatus(response, context, consume) {
+    // consume the response body to release the connection
+    // https://undici.nodejs.org/#/?id=garbage-collection
+    let errorBody;
+    if (response.ok) {
+        if (consume) {
+            errorBody = await response.text();
+        }
+        return;
+    }
+    errorBody = await response.text();
+    const fullMessage = `Failed to ${context}. Received status [${response.status}]: ${response.statusText}. Server response: ${errorBody}`;
+    if (response.status === 409) {
+        throw new LangSmithConflictError(fullMessage);
+    }
+    throw new Error(fullMessage);
+}
+exports.raiseForStatus = raiseForStatus;

package/dist/utils/error.d.ts

@@ -1 +1,44 @@
 export declare function printErrorStackTrace(e: unknown): void;
+/**
+ * LangSmithConflictError
+ *
+ * Represents an error that occurs when there's a conflict during an operation,
+ * typically corresponding to HTTP 409 status code responses.
+ *
+ * This error is thrown when an attempt to create or modify a resource conflicts
+ * with the current state of the resource on the server. Common scenarios include:
+ * - Attempting to create a resource that already exists
+ * - Trying to update a resource that has been modified by another process
+ * - Violating a uniqueness constraint in the data
+ *
+ * @extends Error
+ *
+ * @example
+ * try {
+ *   await createProject("existingProject");
+ * } catch (error) {
+ *   if (error instanceof ConflictError) {
+ *     console.log("A conflict occurred:", error.message);
+ *     // Handle the conflict, e.g., by suggesting a different project name
+ *   } else {
+ *     // Handle other types of errors
+ *   }
+ * }
+ *
+ * @property {string} name - Always set to 'ConflictError' for easy identification
+ * @property {string} message - Detailed error message including server response
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/409
+ */
+export declare class LangSmithConflictError extends Error {
+    constructor(message: string);
+}
+/**
+ * Throws an appropriate error based on the response status and body.
+ *
+ * @param response - The fetch Response object
+ * @param context - Additional context to include in the error message (e.g., operation being performed)
+ * @throws {LangSmithConflictError} When the response status is 409
+ * @throws {Error} For all other non-ok responses
+ */
+export declare function raiseForStatus(response: Response, context: string, consume?: boolean): Promise<void>;

package/dist/utils/error.js

@@ -19,3 +19,65 @@ export function printErrorStackTrace(e) {
         return;
     console.error(stack);
 }
+/**
+ * LangSmithConflictError
+ *
+ * Represents an error that occurs when there's a conflict during an operation,
+ * typically corresponding to HTTP 409 status code responses.
+ *
+ * This error is thrown when an attempt to create or modify a resource conflicts
+ * with the current state of the resource on the server. Common scenarios include:
+ * - Attempting to create a resource that already exists
+ * - Trying to update a resource that has been modified by another process
+ * - Violating a uniqueness constraint in the data
+ *
+ * @extends Error
+ *
+ * @example
+ * try {
+ *   await createProject("existingProject");
+ * } catch (error) {
+ *   if (error instanceof ConflictError) {
+ *     console.log("A conflict occurred:", error.message);
+ *     // Handle the conflict, e.g., by suggesting a different project name
+ *   } else {
+ *     // Handle other types of errors
+ *   }
+ * }
+ *
+ * @property {string} name - Always set to 'ConflictError' for easy identification
+ * @property {string} message - Detailed error message including server response
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/409
+ */
+export class LangSmithConflictError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "LangSmithConflictError";
+    }
+}
+/**
+ * Throws an appropriate error based on the response status and body.
+ *
+ * @param response - The fetch Response object
+ * @param context - Additional context to include in the error message (e.g., operation being performed)
+ * @throws {LangSmithConflictError} When the response status is 409
+ * @throws {Error} For all other non-ok responses
+ */
+export async function raiseForStatus(response, context, consume) {
+    // consume the response body to release the connection
+    // https://undici.nodejs.org/#/?id=garbage-collection
+    let errorBody;
+    if (response.ok) {
+        if (consume) {
+            errorBody = await response.text();
+        }
+        return;
+    }
+    errorBody = await response.text();
+    const fullMessage = `Failed to ${context}. Received status [${response.status}]: ${response.statusText}. Server response: ${errorBody}`;
+    if (response.status === 409) {
+        throw new LangSmithConflictError(fullMessage);
+    }
+    throw new Error(fullMessage);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langsmith",
-  "version": "0.1.43",
+  "version": "0.1.44",
   "description": "Client library to connect to the LangSmith LLM Tracing and Evaluation Platform.",
   "packageManager": "yarn@1.22.19",
   "files": [