@node-llm/core 1.1.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/README.md +243 -0
  2. package/dist/chat/Chat.d.ts +11 -8
  3. package/dist/chat/Chat.d.ts.map +1 -1
  4. package/dist/chat/Chat.js +24 -14
  5. package/dist/chat/ChatOptions.d.ts +2 -2
  6. package/dist/chat/ChatOptions.d.ts.map +1 -1
  7. package/dist/chat/ChatStream.d.ts.map +1 -1
  8. package/dist/chat/ChatStream.js +85 -34
  9. package/dist/chat/Tool.d.ts +35 -1
  10. package/dist/chat/Tool.d.ts.map +1 -1
  11. package/dist/chat/Tool.js +38 -1
  12. package/dist/config.d.ts +1 -1
  13. package/dist/errors/index.d.ts +2 -2
  14. package/dist/errors/index.js +3 -3
  15. package/dist/llm.d.ts +27 -15
  16. package/dist/llm.d.ts.map +1 -1
  17. package/dist/llm.js +37 -5
  18. package/dist/models/models.js +15 -15
  19. package/dist/providers/BaseProvider.d.ts +2 -1
  20. package/dist/providers/BaseProvider.d.ts.map +1 -1
  21. package/dist/providers/BaseProvider.js +4 -1
  22. package/dist/providers/Provider.d.ts +4 -2
  23. package/dist/providers/Provider.d.ts.map +1 -1
  24. package/dist/providers/anthropic/AnthropicProvider.d.ts +1 -0
  25. package/dist/providers/anthropic/AnthropicProvider.d.ts.map +1 -1
  26. package/dist/providers/anthropic/AnthropicProvider.js +3 -0
  27. package/dist/providers/anthropic/Chat.d.ts.map +1 -1
  28. package/dist/providers/anthropic/Chat.js +5 -1
  29. package/dist/providers/anthropic/Streaming.d.ts.map +1 -1
  30. package/dist/providers/anthropic/Streaming.js +49 -2
  31. package/dist/providers/deepseek/Chat.d.ts.map +1 -1
  32. package/dist/providers/deepseek/Chat.js +5 -4
  33. package/dist/providers/deepseek/DeepSeekProvider.d.ts +1 -0
  34. package/dist/providers/deepseek/DeepSeekProvider.d.ts.map +1 -1
  35. package/dist/providers/deepseek/DeepSeekProvider.js +3 -0
  36. package/dist/providers/deepseek/Streaming.d.ts.map +1 -1
  37. package/dist/providers/deepseek/Streaming.js +49 -3
  38. package/dist/providers/gemini/Chat.d.ts.map +1 -1
  39. package/dist/providers/gemini/Chat.js +3 -0
  40. package/dist/providers/gemini/Embeddings.d.ts.map +1 -1
  41. package/dist/providers/gemini/Embeddings.js +3 -0
  42. package/dist/providers/gemini/GeminiProvider.d.ts +1 -0
  43. package/dist/providers/gemini/GeminiProvider.d.ts.map +1 -1
  44. package/dist/providers/gemini/GeminiProvider.js +3 -0
  45. package/dist/providers/gemini/Image.d.ts.map +1 -1
  46. package/dist/providers/gemini/Image.js +3 -0
  47. package/dist/providers/gemini/Streaming.d.ts.map +1 -1
  48. package/dist/providers/gemini/Streaming.js +32 -1
  49. package/dist/providers/gemini/Transcription.d.ts.map +1 -1
  50. package/dist/providers/gemini/Transcription.js +3 -0
  51. package/dist/providers/ollama/OllamaProvider.d.ts +1 -0
  52. package/dist/providers/ollama/OllamaProvider.d.ts.map +1 -1
  53. package/dist/providers/ollama/OllamaProvider.js +3 -0
  54. package/dist/providers/openai/Chat.d.ts.map +1 -1
  55. package/dist/providers/openai/Chat.js +5 -4
  56. package/dist/providers/openai/Embedding.d.ts.map +1 -1
  57. package/dist/providers/openai/Embedding.js +5 -1
  58. package/dist/providers/openai/Image.d.ts.map +1 -1
  59. package/dist/providers/openai/Image.js +5 -1
  60. package/dist/providers/openai/Moderation.d.ts.map +1 -1
  61. package/dist/providers/openai/Moderation.js +12 -6
  62. package/dist/providers/openai/OpenAIProvider.d.ts +1 -0
  63. package/dist/providers/openai/OpenAIProvider.d.ts.map +1 -1
  64. package/dist/providers/openai/OpenAIProvider.js +3 -0
  65. package/dist/providers/openai/Streaming.d.ts.map +1 -1
  66. package/dist/providers/openai/Streaming.js +53 -4
  67. package/dist/providers/openai/Transcription.d.ts.map +1 -1
  68. package/dist/providers/openai/Transcription.js +9 -2
  69. package/dist/providers/registry.js +1 -1
  70. package/dist/utils/FileLoader.d.ts.map +1 -1
  71. package/dist/utils/FileLoader.js +2 -1
  72. package/dist/utils/logger.d.ts +9 -1
  73. package/dist/utils/logger.d.ts.map +1 -1
  74. package/dist/utils/logger.js +23 -1
  75. package/package.json +3 -3
@@ -2,6 +2,7 @@ import { handleOpenAIError } from "./Errors.js";
2
2
  import { AudioUtils } from "../../utils/audio.js";
3
3
  import { DEFAULT_MODELS } from "../../constants.js";
4
4
  import { buildUrl } from "./utils.js";
5
+ import { logger } from "../../utils/logger.js";
5
6
  export class OpenAITranscription {
6
7
  baseUrl;
7
8
  apiKey;
@@ -30,7 +31,9 @@ export class OpenAITranscription {
30
31
  if (request.language) {
31
32
  formData.append("language", request.language);
32
33
  }
33
- const response = await fetch(buildUrl(this.baseUrl, '/audio/transcriptions'), {
34
+ const url = buildUrl(this.baseUrl, '/audio/transcriptions');
35
+ logger.logRequest("OpenAI", "POST", url, { model: request.model || DEFAULT_MODELS.TRANSCRIPTION, file: fileName });
36
+ const response = await fetch(url, {
34
37
  method: "POST",
35
38
  headers: {
36
39
  "Authorization": `Bearer ${this.apiKey}`,
@@ -41,6 +44,7 @@ export class OpenAITranscription {
41
44
  await handleOpenAIError(response, request.model || DEFAULT_MODELS.TRANSCRIPTION);
42
45
  }
43
46
  const json = (await response.json());
47
+ logger.logResponse("OpenAI", response.status, response.statusText, json);
44
48
  return {
45
49
  text: json.text,
46
50
  model: json.model || request.model || DEFAULT_MODELS.TRANSCRIPTION,
@@ -120,7 +124,9 @@ export class OpenAITranscription {
120
124
  }
121
125
  ]
122
126
  };
123
- const response = await fetch(buildUrl(this.baseUrl, '/chat/completions'), {
127
+ const url = buildUrl(this.baseUrl, '/chat/completions');
128
+ logger.logRequest("OpenAI", "POST", url, body);
129
+ const response = await fetch(url, {
124
130
  method: "POST",
125
131
  headers: {
126
132
  "Authorization": `Bearer ${this.apiKey}`,
@@ -132,6 +138,7 @@ export class OpenAITranscription {
132
138
  await handleOpenAIError(response, actualModel);
133
139
  }
134
140
  const json = await response.json();
141
+ logger.logResponse("OpenAI", response.status, response.statusText, json);
135
142
  const content = json.choices[0]?.message?.content || "";
136
143
  let text = content;
137
144
  let segments = [];
@@ -21,7 +21,7 @@ class ProviderRegistry {
21
21
  resolve(name) {
22
22
  const factory = this.providers.get(name);
23
23
  if (!factory) {
24
- throw new Error(`Unknown NodeLLM provider '${name}'`);
24
+ throw new Error(`Unknown LLM provider '${name}'`);
25
25
  }
26
26
  return factory();
27
27
  }
@@ -1 +1 @@
1
- {"version":3,"file":"FileLoader.d.ts","sourceRoot":"","sources":["../../src/utils/FileLoader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA2CjD,qBAAa,UAAU;WACR,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAkF1D"}
1
+ {"version":3,"file":"FileLoader.d.ts","sourceRoot":"","sources":["../../src/utils/FileLoader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA2CjD,qBAAa,UAAU;WACR,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAmF1D"}
@@ -47,7 +47,8 @@ export class FileLoader {
47
47
  if (!response.ok)
48
48
  throw new Error(`Failed to fetch file: ${response.statusText}`);
49
49
  const buffer = await response.arrayBuffer();
50
- const contentType = response.headers.get("content-type") || "image/jpeg";
50
+ const contentTypeFull = response.headers.get("content-type") || "image/jpeg";
51
+ const contentType = (contentTypeFull.split(";")[0] ?? "image/jpeg").trim();
51
52
  const base64 = Buffer.from(buffer).toString("base64");
52
53
  const dataUri = `data:${contentType};base64,${base64}`;
53
54
  if (contentType.startsWith("image/")) {
@@ -1,9 +1,17 @@
1
1
  /**
2
- * Centralized logger for node-llm
2
+ * Centralized logger for`NodeLLM`
3
3
  */
4
4
  declare class Logger {
5
5
  private isDebugEnabled;
6
6
  debug(message: string, data?: any): void;
7
+ /**
8
+ * Log HTTP request details for debugging
9
+ */
10
+ logRequest(provider: string, method: string, url: string, body?: any): void;
11
+ /**
12
+ * Log HTTP response details for debugging
13
+ */
14
+ logResponse(provider: string, status: number, statusText: string, body?: any): void;
7
15
  warn(message: string): void;
8
16
  error(message: string, error?: Error): void;
9
17
  info(message: string): void;
@@ -1 +1 @@
1
- {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAM,MAAM;IACV,OAAO,CAAC,cAAc;IAItB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAOxC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAI3C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG5B;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}
1
+ {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAM,MAAM;IACV,OAAO,CAAC,cAAc;IAItB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAOxC;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAS3E;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IASnF,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAI3C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG5B;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Centralized logger for node-llm
2
+ * Centralized logger for`NodeLLM`
3
3
  */
4
4
  class Logger {
5
5
  isDebugEnabled() {
@@ -11,6 +11,28 @@ class Logger {
11
11
  console.log(`[NodeLLM Debug] ${message}${formattedData}`);
12
12
  }
13
13
  }
14
+ /**
15
+ * Log HTTP request details for debugging
16
+ */
17
+ logRequest(provider, method, url, body) {
18
+ if (this.isDebugEnabled()) {
19
+ console.log(`[NodeLLM] [${provider}] Request: ${method} ${url}`);
20
+ if (body) {
21
+ console.log(JSON.stringify(body, null, 2));
22
+ }
23
+ }
24
+ }
25
+ /**
26
+ * Log HTTP response details for debugging
27
+ */
28
+ logResponse(provider, status, statusText, body) {
29
+ if (this.isDebugEnabled()) {
30
+ console.log(`[NodeLLM] [${provider}] Response: ${status} ${statusText}`);
31
+ if (body) {
32
+ console.log(JSON.stringify(body, null, 2));
33
+ }
34
+ }
35
+ }
14
36
  warn(message) {
15
37
  console.warn(`[NodeLLM] ${message}`);
16
38
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@node-llm/core",
3
- "version": "1.1.0",
3
+ "version": "1.3.0",
4
4
  "type": "module",
5
5
  "main": "./dist/index.js",
6
6
  "types": "./dist/index.d.ts",
@@ -10,8 +10,8 @@
10
10
  "default": "./dist/index.js"
11
11
  }
12
12
  },
13
- "description": "A provider-agnostic NodeLLM core for Node.js, inspired by ruby-llm.",
14
- "author": "node-llm contributors",
13
+ "description": "A provider-agnostic LLM core for Node.js, inspired by ruby-llm.",
14
+ "author": "NodeLLM contributors",
15
15
  "license": "MIT",
16
16
  "engines": {
17
17
  "node": ">=20.0.0"