@raindrop-ai/langchain 0.0.4 → 0.0.5

package/dist/index.d.mts

@@ -91,6 +91,13 @@ type EventShipperOptions = {
      * Pass `null` to opt out of all mirroring (including auto-detect).
      */
     localDebuggerUrl?: string | null;
+    /**
+     * Optional project slug. When set, every outbound cloud request includes an
+     * `X-Raindrop-Project-Id: <projectId>` header. Empty / whitespace-only
+     * values are ignored. Slug format is validated on construction but never
+     * throws — the backend returns 400 on invalid values.
+     */
+    projectId?: string;
     /**
      * Per-field character cap applied to event input/output BEFORE buffering
      * or serialization, so oversized payloads cost the cap — not the payload —
@@ -109,6 +116,7 @@ declare class EventShipper {
     private sdkName;
     private prefix;
     private defaultEventName;
+    private projectId;
     private context;
     private buffers;
     private sticky;
@@ -132,6 +140,7 @@ declare class EventShipper {
     constructor(opts: EventShipperOptions);
     isDebugEnabled(): boolean;
     private authHeaders;
+    private requestHeaders;
     /**
      * Build the retry/timeout options for one POST, honoring the shutdown
      * deadline. Returns `null` when the shutdown drain window is exhausted —
@@ -203,6 +212,13 @@ type TraceShipperOptions = {
      * Pass `null` to opt out of all mirroring (including auto-detect).
      */
     localDebuggerUrl?: string | null;
+    /**
+     * Optional project slug. When set, every OTLP trace export includes an
+     * `X-Raindrop-Project-Id: <projectId>` header. Empty / whitespace-only
+     * values are ignored. Slug format is validated on construction but never
+     * throws — the backend returns 400 on invalid values.
+     */
+    projectId?: string;
     /**
      * Per-span hook that fires for every OTLP span right before the span is
      * shipped (both to the Raindrop API and to a local debugger). Lets callers
@@ -260,6 +276,7 @@ declare class TraceShipper {
     private flushIntervalMs;
     private maxBatchSize;
     private maxQueueSize;
+    private projectId;
     private queue;
     private timer;
     private inFlight;
@@ -310,6 +327,7 @@ declare class TraceShipper {
     private redactSpan;
     isDebugEnabled(): boolean;
     private authHeaders;
+    private requestHeaders;
     startSpan(args: {
         name: string;
         parent?: {
@@ -441,6 +459,12 @@ interface LangChainOptions {
     debug?: boolean;
     userId?: string;
     convoId?: string;
+    /**
+     * Optional Raindrop project slug. When set, every outbound cloud request
+     * carries an `X-Raindrop-Project-Id` header. Unset → no header (the project
+     * resolves to `default` server-side; byte-identical to prior behavior).
+     */
+    projectId?: string;
     traceChains?: boolean;
     traceRetrievers?: boolean;
     /**

package/dist/index.d.ts

@@ -91,6 +91,13 @@ type EventShipperOptions = {
      * Pass `null` to opt out of all mirroring (including auto-detect).
      */
     localDebuggerUrl?: string | null;
+    /**
+     * Optional project slug. When set, every outbound cloud request includes an
+     * `X-Raindrop-Project-Id: <projectId>` header. Empty / whitespace-only
+     * values are ignored. Slug format is validated on construction but never
+     * throws — the backend returns 400 on invalid values.
+     */
+    projectId?: string;
     /**
      * Per-field character cap applied to event input/output BEFORE buffering
      * or serialization, so oversized payloads cost the cap — not the payload —
@@ -109,6 +116,7 @@ declare class EventShipper {
     private sdkName;
     private prefix;
     private defaultEventName;
+    private projectId;
     private context;
     private buffers;
     private sticky;
@@ -132,6 +140,7 @@ declare class EventShipper {
     constructor(opts: EventShipperOptions);
     isDebugEnabled(): boolean;
     private authHeaders;
+    private requestHeaders;
     /**
      * Build the retry/timeout options for one POST, honoring the shutdown
      * deadline. Returns `null` when the shutdown drain window is exhausted —
@@ -203,6 +212,13 @@ type TraceShipperOptions = {
      * Pass `null` to opt out of all mirroring (including auto-detect).
      */
     localDebuggerUrl?: string | null;
+    /**
+     * Optional project slug. When set, every OTLP trace export includes an
+     * `X-Raindrop-Project-Id: <projectId>` header. Empty / whitespace-only
+     * values are ignored. Slug format is validated on construction but never
+     * throws — the backend returns 400 on invalid values.
+     */
+    projectId?: string;
     /**
      * Per-span hook that fires for every OTLP span right before the span is
      * shipped (both to the Raindrop API and to a local debugger). Lets callers
@@ -260,6 +276,7 @@ declare class TraceShipper {
     private flushIntervalMs;
     private maxBatchSize;
     private maxQueueSize;
+    private projectId;
     private queue;
     private timer;
     private inFlight;
@@ -310,6 +327,7 @@ declare class TraceShipper {
     private redactSpan;
     isDebugEnabled(): boolean;
     private authHeaders;
+    private requestHeaders;
     startSpan(args: {
         name: string;
         parent?: {
@@ -441,6 +459,12 @@ interface LangChainOptions {
     debug?: boolean;
     userId?: string;
     convoId?: string;
+    /**
+     * Optional Raindrop project slug. When set, every outbound cloud request
+     * carries an `X-Raindrop-Project-Id` header. Unset → no header (the project
+     * resolves to `default` server-side; byte-identical to prior behavior).
+     */
+    projectId?: string;
     traceChains?: boolean;
     traceRetrievers?: boolean;
     /**

package/dist/index.js

@@ -28,7 +28,7 @@ module.exports = __toCommonJS(index_exports);
 // src/callback-handler.ts
 var import_base = require("@langchain/core/callbacks/base");
 
-// ../core/dist/chunk-U5HUTMR5.js
+// ../core/dist/chunk-SK6EJEO7.js
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -380,6 +380,25 @@ function mirrorPartialEventToLocalDebugger(event, options = {}) {
   }).catch(() => {
   });
 }
+var PROJECT_ID_HEADER = "X-Raindrop-Project-Id";
+var PROJECT_ID_SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
+function isValidProjectIdSlug(value) {
+  return PROJECT_ID_SLUG_PATTERN.test(value);
+}
+function normalizeProjectId(raw, opts) {
+  if (typeof raw !== "string") return void 0;
+  const trimmed = raw.trim();
+  if (!trimmed) return void 0;
+  if (!isValidProjectIdSlug(trimmed) && opts.debug) {
+    console.warn(
+      `${opts.prefix} projectId "${trimmed}" does not match slug ${PROJECT_ID_SLUG_PATTERN.source}; sending anyway \u2014 backend may reject with HTTP 400`
+    );
+  }
+  return trimmed;
+}
+function projectIdHeaders(projectId) {
+  return projectId ? { [PROJECT_ID_HEADER]: projectId } : {};
+}
 var SHUTDOWN_DEADLINE_MS = 1e4;
 var POST_SHUTDOWN_TIMEOUT_MS = 5e3;
 function mergePatches(target, source) {
@@ -414,6 +433,10 @@ var EventShipper = class {
     if (this.debug && this.localDebuggerUrl) {
       console.log(`${this.prefix} Local debugger mirroring: ${this.localDebuggerUrl}`);
     }
+    this.projectId = normalizeProjectId(opts.projectId, {
+      debug: this.debug,
+      prefix: this.prefix
+    });
     const isNode = typeof process !== "undefined" && typeof process.version === "string";
     this.context = {
       library: {
@@ -432,6 +455,9 @@ var EventShipper = class {
   authHeaders() {
     return this.writeKey ? { Authorization: `Bearer ${this.writeKey}` } : {};
   }
+  requestHeaders() {
+    return { ...this.authHeaders(), ...projectIdHeaders(this.projectId) };
+  }
   /**
    * Build the retry/timeout options for one POST, honoring the shutdown
    * deadline. Returns `null` when the shutdown drain window is exhausted —
@@ -561,7 +587,7 @@ var EventShipper = class {
       return;
     }
     try {
-      await postJson(url, body, this.authHeaders(), opts);
+      await postJson(url, body, this.requestHeaders(), opts);
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       rateLimitedLog(
@@ -597,7 +623,7 @@ var EventShipper = class {
       return;
     }
     try {
-      await postJson(url, body, this.authHeaders(), opts);
+      await postJson(url, body, this.requestHeaders(), opts);
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       rateLimitedLog(
@@ -693,7 +719,7 @@ var EventShipper = class {
       if (!isPending) this.sticky.delete(eventId);
       return;
     }
-    const p = postJson(url, payload, this.authHeaders(), opts);
+    const p = postJson(url, payload, this.requestHeaders(), opts);
     this.inFlight.add(p);
     try {
       try {
@@ -840,6 +866,10 @@ var TraceShipper = class {
     if (this.debug && this.localDebuggerUrl) {
       console.log(`${this.prefix} Local debugger mirroring: ${this.localDebuggerUrl}`);
     }
+    this.projectId = normalizeProjectId(opts.projectId, {
+      debug: this.debug,
+      prefix: this.prefix
+    });
     this.transformSpanHook = opts.transformSpan;
     this.disableDefaultRedaction = opts.disableDefaultRedaction === true;
     this.maxTextFieldCharsOpt = opts.maxTextFieldChars;
@@ -916,6 +946,9 @@ var TraceShipper = class {
   authHeaders() {
     return this.writeKey ? { Authorization: `Bearer ${this.writeKey}` } : {};
   }
+  requestHeaders() {
+    return { ...this.authHeaders(), ...projectIdHeaders(this.projectId) };
+  }
   startSpan(args) {
     var _a, _b;
     const ids = createSpanIds(args.parent);
@@ -1047,7 +1080,7 @@ var TraceShipper = class {
           endpoint: url
         });
       }
-      const p = postJson(url, body, this.authHeaders(), opts);
+      const p = postJson(url, body, this.requestHeaders(), opts);
       this.inFlight.add(p);
       try {
         try {
@@ -1642,7 +1675,7 @@ function extractLLMMetadata(output) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/langchain",
-  version: "0.0.4",
+  version: "0.0.5",
   description: "Raindrop integration for LangChain",
   main: "dist/index.js",
   module: "dist/index.mjs",
@@ -1725,6 +1758,7 @@ function createRaindropLangChain(opts) {
     endpoint: opts.endpoint,
     enabled,
     debug: (_a = opts.debug) != null ? _a : false,
+    projectId: opts.projectId,
     sdkName: "langchain",
     libraryName,
     libraryVersion
@@ -1734,6 +1768,7 @@ function createRaindropLangChain(opts) {
     endpoint: opts.endpoint,
     enabled,
     debug: (_b = opts.debug) != null ? _b : false,
+    projectId: opts.projectId,
     sdkName: "langchain",
     serviceName: "raindrop.langchain",
     serviceVersion: libraryVersion

package/dist/index.mjs

@@ -1,7 +1,7 @@
 // src/callback-handler.ts
 import { BaseCallbackHandler } from "@langchain/core/callbacks/base";
 
-// ../core/dist/chunk-U5HUTMR5.js
+// ../core/dist/chunk-SK6EJEO7.js
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -353,6 +353,25 @@ function mirrorPartialEventToLocalDebugger(event, options = {}) {
   }).catch(() => {
   });
 }
+var PROJECT_ID_HEADER = "X-Raindrop-Project-Id";
+var PROJECT_ID_SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
+function isValidProjectIdSlug(value) {
+  return PROJECT_ID_SLUG_PATTERN.test(value);
+}
+function normalizeProjectId(raw, opts) {
+  if (typeof raw !== "string") return void 0;
+  const trimmed = raw.trim();
+  if (!trimmed) return void 0;
+  if (!isValidProjectIdSlug(trimmed) && opts.debug) {
+    console.warn(
+      `${opts.prefix} projectId "${trimmed}" does not match slug ${PROJECT_ID_SLUG_PATTERN.source}; sending anyway \u2014 backend may reject with HTTP 400`
+    );
+  }
+  return trimmed;
+}
+function projectIdHeaders(projectId) {
+  return projectId ? { [PROJECT_ID_HEADER]: projectId } : {};
+}
 var SHUTDOWN_DEADLINE_MS = 1e4;
 var POST_SHUTDOWN_TIMEOUT_MS = 5e3;
 function mergePatches(target, source) {
@@ -387,6 +406,10 @@ var EventShipper = class {
     if (this.debug && this.localDebuggerUrl) {
       console.log(`${this.prefix} Local debugger mirroring: ${this.localDebuggerUrl}`);
     }
+    this.projectId = normalizeProjectId(opts.projectId, {
+      debug: this.debug,
+      prefix: this.prefix
+    });
     const isNode = typeof process !== "undefined" && typeof process.version === "string";
     this.context = {
       library: {
@@ -405,6 +428,9 @@ var EventShipper = class {
   authHeaders() {
     return this.writeKey ? { Authorization: `Bearer ${this.writeKey}` } : {};
   }
+  requestHeaders() {
+    return { ...this.authHeaders(), ...projectIdHeaders(this.projectId) };
+  }
   /**
    * Build the retry/timeout options for one POST, honoring the shutdown
    * deadline. Returns `null` when the shutdown drain window is exhausted —
@@ -534,7 +560,7 @@ var EventShipper = class {
       return;
     }
     try {
-      await postJson(url, body, this.authHeaders(), opts);
+      await postJson(url, body, this.requestHeaders(), opts);
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       rateLimitedLog(
@@ -570,7 +596,7 @@ var EventShipper = class {
       return;
     }
     try {
-      await postJson(url, body, this.authHeaders(), opts);
+      await postJson(url, body, this.requestHeaders(), opts);
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       rateLimitedLog(
@@ -666,7 +692,7 @@ var EventShipper = class {
       if (!isPending) this.sticky.delete(eventId);
       return;
     }
-    const p = postJson(url, payload, this.authHeaders(), opts);
+    const p = postJson(url, payload, this.requestHeaders(), opts);
     this.inFlight.add(p);
     try {
       try {
@@ -813,6 +839,10 @@ var TraceShipper = class {
     if (this.debug && this.localDebuggerUrl) {
       console.log(`${this.prefix} Local debugger mirroring: ${this.localDebuggerUrl}`);
     }
+    this.projectId = normalizeProjectId(opts.projectId, {
+      debug: this.debug,
+      prefix: this.prefix
+    });
     this.transformSpanHook = opts.transformSpan;
     this.disableDefaultRedaction = opts.disableDefaultRedaction === true;
     this.maxTextFieldCharsOpt = opts.maxTextFieldChars;
@@ -889,6 +919,9 @@ var TraceShipper = class {
   authHeaders() {
     return this.writeKey ? { Authorization: `Bearer ${this.writeKey}` } : {};
   }
+  requestHeaders() {
+    return { ...this.authHeaders(), ...projectIdHeaders(this.projectId) };
+  }
   startSpan(args) {
     var _a, _b;
     const ids = createSpanIds(args.parent);
@@ -1020,7 +1053,7 @@ var TraceShipper = class {
           endpoint: url
         });
       }
-      const p = postJson(url, body, this.authHeaders(), opts);
+      const p = postJson(url, body, this.requestHeaders(), opts);
       this.inFlight.add(p);
       try {
         try {
@@ -1615,7 +1648,7 @@ function extractLLMMetadata(output) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/langchain",
-  version: "0.0.4",
+  version: "0.0.5",
   description: "Raindrop integration for LangChain",
   main: "dist/index.js",
   module: "dist/index.mjs",
@@ -1698,6 +1731,7 @@ function createRaindropLangChain(opts) {
     endpoint: opts.endpoint,
     enabled,
     debug: (_a = opts.debug) != null ? _a : false,
+    projectId: opts.projectId,
     sdkName: "langchain",
     libraryName,
     libraryVersion
@@ -1707,6 +1741,7 @@ function createRaindropLangChain(opts) {
     endpoint: opts.endpoint,
     enabled,
     debug: (_b = opts.debug) != null ? _b : false,
+    projectId: opts.projectId,
     sdkName: "langchain",
     serviceName: "raindrop.langchain",
     serviceVersion: libraryVersion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raindrop-ai/langchain",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Raindrop integration for LangChain",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -36,7 +36,7 @@
     "tsup": "^8.4.0",
     "typescript": "^5.3.3",
     "vitest": "^2.1.9",
-    "@raindrop-ai/core": "0.0.3"
+    "@raindrop-ai/core": "0.0.4"
   },
   "tsup": {
     "entry": [