@node-llm/core 1.7.0 → 1.8.0

package/dist/providers/openai/Capabilities.js

@@ -24,19 +24,19 @@ export class Capabilities {
         return 4_096;
     }
     static supportsVision(modelId) {
-        const model = ModelRegistry.find(modelId, "openai");
+        const model = this.findModel(modelId);
         if (model?.modalities?.input?.includes("image"))
             return true;
         return /gpt-4(?!-3)|o1/.test(modelId) && !/audio|realtime|voice/.test(modelId);
     }
     static supportsTools(modelId) {
-        const model = ModelRegistry.find(modelId, "openai");
+        const model = this.findModel(modelId);
         if (model?.capabilities?.includes("function_calling") || model?.capabilities?.includes("tools"))
             return true;
         return !/embedding|moderation|dall-e|tts|whisper/.test(modelId);
     }
     static supportsStructuredOutput(modelId) {
-        const model = ModelRegistry.find(modelId, "openai");
+        const model = this.findModel(modelId);
         if (model?.capabilities?.includes("structured_output"))
             return true;
         return /gpt-4|o1|o3/.test(modelId);
@@ -45,32 +45,32 @@ export class Capabilities {
         return this.supportsStructuredOutput(modelId);
     }
     static supportsEmbeddings(modelId) {
-        const model = ModelRegistry.find(modelId, "openai");
+        const model = this.findModel(modelId);
         if (model?.modalities?.output?.includes("embeddings"))
             return true;
         return /embedding/.test(modelId);
     }
     static supportsImageGeneration(modelId) {
-        const model = ModelRegistry.find(modelId, "openai");
+        const model = this.findModel(modelId);
         if (model?.capabilities?.includes("image_generation") ||
             model?.modalities?.output?.includes("image"))
             return true;
         return /dall-e|image/.test(modelId);
     }
     static supportsTranscription(modelId) {
-        const model = ModelRegistry.find(modelId, "openai");
+        const model = this.findModel(modelId);
         if (model?.modalities?.input?.includes("audio"))
             return true;
         return /whisper|audio|transcribe/.test(modelId);
     }
     static supportsModeration(modelId) {
-        const model = ModelRegistry.find(modelId, "openai");
+        const model = this.findModel(modelId);
         if (model?.modalities?.output?.includes("moderation"))
             return true;
         return /moderation/.test(modelId);
     }
     static supportsReasoning(modelId) {
-        const model = ModelRegistry.find(modelId, "openai");
+        const model = this.findModel(modelId);
         if (model?.capabilities?.includes("reasoning"))
             return true;
         return /o\d|gpt-5/.test(modelId);
@@ -101,7 +101,7 @@ export class Capabilities {
     static getModalities(modelId) {
         const input = ["text"];
         const output = ["text"];
-        const model = ModelRegistry.find(modelId, "openai");
+        const model = this.findModel(modelId);
         if (model?.modalities)
             return model.modalities;
         if (this.supportsVision(modelId))
@@ -118,7 +118,7 @@ export class Capabilities {
     }
     static getCapabilities(modelId) {
         const caps = ["streaming"];
-        const model = ModelRegistry.find(modelId, "openai");
+        const model = this.findModel(modelId);
         if (model) {
             model.capabilities.forEach((c) => {
                 if (!caps.includes(c))
@@ -148,7 +148,7 @@ export class Capabilities {
         return temperature;
     }
     static formatDisplayName(modelId) {
-        const model = ModelRegistry.find(modelId, "openai");
+        const model = this.findModel(modelId);
         if (model?.name && model.name !== modelId)
             return model.name;
         return modelId.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
@@ -156,4 +156,7 @@ export class Capabilities {
     static getPricing(modelId) {
         return PricingRegistry.getPricing(modelId, "openai");
     }
+    static findModel(modelId) {
+        return ModelRegistry.find(modelId, "openai");
+    }
 }

package/dist/providers/registry.d.ts

@@ -5,6 +5,7 @@ import { registerGeminiProvider } from "./gemini/index.js";
 import { registerDeepSeekProvider } from "./deepseek/index.js";
 import { registerOllamaProvider } from "./ollama/index.js";
 import { registerOpenRouterProvider } from "./openrouter/index.js";
+import { registerBedrockProvider } from "./bedrock/index.js";
 import { NodeLLMConfig } from "../config.js";
 type ProviderFactory = (config?: NodeLLMConfig) => Provider;
 declare class ProviderRegistry {
@@ -42,5 +43,5 @@ declare class ProviderRegistry {
  * ```
  */
 export declare const providerRegistry: ProviderRegistry;
-export { registerOpenAIProvider as ensureOpenAIRegistered, registerOpenAIProvider, registerAnthropicProvider, registerGeminiProvider, registerDeepSeekProvider, registerOllamaProvider, registerOpenRouterProvider };
+export { registerOpenAIProvider as ensureOpenAIRegistered, registerOpenAIProvider, registerAnthropicProvider, registerGeminiProvider, registerDeepSeekProvider, registerOllamaProvider, registerOpenRouterProvider, registerBedrockProvider };
 //# sourceMappingURL=registry.d.ts.map

package/dist/providers/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,KAAK,eAAe,GAAG,CAAC,MAAM,CAAC,EAAE,aAAa,KAAK,QAAQ,CAAC;AAE5D,cAAM,gBAAgB;IACpB,OAAO,CAAC,SAAS,CAAsC;IAEvD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAQtD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,QAAQ;IAUvD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;CAGjB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,kBAAyB,CAAC;AAGvD,OAAO,EACL,sBAAsB,IAAI,sBAAsB,EAChD,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC3B,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,KAAK,eAAe,GAAG,CAAC,MAAM,CAAC,EAAE,aAAa,KAAK,QAAQ,CAAC;AAE5D,cAAM,gBAAgB;IACpB,OAAO,CAAC,SAAS,CAAsC;IAEvD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAQtD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,QAAQ;IAUvD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;CAGjB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,kBAAyB,CAAC;AAGvD,OAAO,EACL,sBAAsB,IAAI,sBAAsB,EAChD,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACxB,CAAC"}

package/dist/providers/registry.js

@@ -4,6 +4,7 @@ import { registerGeminiProvider } from "./gemini/index.js";
 import { registerDeepSeekProvider } from "./deepseek/index.js";
 import { registerOllamaProvider } from "./ollama/index.js";
 import { registerOpenRouterProvider } from "./openrouter/index.js";
+import { registerBedrockProvider } from "./bedrock/index.js";
 class ProviderRegistry {
     providers = new Map();
     /**
@@ -55,4 +56,4 @@ class ProviderRegistry {
  */
 export const providerRegistry = new ProviderRegistry();
 // Exported registration functions (delegates to provider-specific index files)
-export { registerOpenAIProvider as ensureOpenAIRegistered, registerOpenAIProvider, registerAnthropicProvider, registerGeminiProvider, registerDeepSeekProvider, registerOllamaProvider, registerOpenRouterProvider };
+export { registerOpenAIProvider as ensureOpenAIRegistered, registerOpenAIProvider, registerAnthropicProvider, registerGeminiProvider, registerDeepSeekProvider, registerOllamaProvider, registerOpenRouterProvider, registerBedrockProvider };

package/dist/utils/AwsSigV4.d.ts

@@ -0,0 +1,51 @@
+/**
+ * AWS Signature Version 4 (SigV4) Request Signing Utility
+ *
+ * This is a minimal, focused implementation for signing AWS API requests.
+ * It uses only Node.js native `crypto` module — no AWS SDK dependencies.
+ *
+ * Reference: https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html
+ */
+export interface AwsCredentials {
+    accessKeyId: string;
+    secretAccessKey: string;
+    sessionToken?: string;
+}
+export interface SignRequestOptions {
+    method: "POST" | "GET";
+    url: string;
+    body: string;
+    credentials: AwsCredentials;
+    region: string;
+    service: string;
+    timestamp?: Date;
+}
+export interface SignedHeaders {
+    host: string;
+    "x-amz-date": string;
+    "x-amz-content-sha256": string;
+    authorization: string;
+    "x-amz-security-token"?: string;
+}
+/**
+ * Sign an AWS API request using SigV4.
+ *
+ * @param options - The request details and credentials
+ * @returns Headers to include in the HTTP request
+ *
+ * @example
+ * ```ts
+ * const headers = signRequest({
+ *   method: "POST",
+ *   url: "https://bedrock-runtime.us-east-1.amazonaws.com/model/.../converse",
+ *   body: JSON.stringify({ messages: [...] }),
+ *   credentials: { accessKeyId: "...", secretAccessKey: "..." },
+ *   region: "us-east-1",
+ *   service: "bedrock"
+ * });
+ *
+ * fetch(url, { headers: { ...headers, "Content-Type": "application/json" }, body });
+ * ```
+ */
+export declare function signRequest(options: SignRequestOptions): SignedHeaders;
+//# sourceMappingURL=AwsSigV4.d.ts.map

package/dist/utils/AwsSigV4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AwsSigV4.d.ts","sourceRoot":"","sources":["../../src/utils/AwsSigV4.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,cAAc,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AA8KD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa,CAwEtE"}

package/dist/utils/AwsSigV4.js

@@ -0,0 +1,209 @@
+/**
+ * AWS Signature Version 4 (SigV4) Request Signing Utility
+ *
+ * This is a minimal, focused implementation for signing AWS API requests.
+ * It uses only Node.js native `crypto` module — no AWS SDK dependencies.
+ *
+ * Reference: https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html
+ */
+import { createHmac, createHash } from "node:crypto";
+// ─────────────────────────────────────────────────────────────────────────────
+// Constants
+// ─────────────────────────────────────────────────────────────────────────────
+const ALGORITHM = "AWS4-HMAC-SHA256";
+const AWS4_REQUEST = "aws4_request";
+// ─────────────────────────────────────────────────────────────────────────────
+// Helper Functions
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * SHA256 hash of a string, returned as hex.
+ */
+function sha256Hex(data) {
+    return createHash("sha256").update(data, "utf8").digest("hex");
+}
+/**
+ * HMAC-SHA256, returns raw bytes (Buffer).
+ */
+function hmacSha256(key, data) {
+    return createHmac("sha256", key).update(data, "utf8").digest();
+}
+/**
+ * HMAC-SHA256, returns hex string.
+ */
+function hmacSha256Hex(key, data) {
+    return createHmac("sha256", key).update(data, "utf8").digest("hex");
+}
+/**
+ * Format a Date as AWS timestamp: YYYYMMDD'T'HHMMSS'Z'
+ */
+function formatAmzDate(date) {
+    return date.toISOString().replace(/[:-]|\.\d{3}/g, "");
+}
+/**
+ * Extract just the date portion: YYYYMMDD
+ */
+function formatDateOnly(amzDate) {
+    return amzDate.substring(0, 8);
+}
+/**
+ * Parse host from URL.
+ */
+function extractHost(url) {
+    const parsed = new URL(url);
+    return parsed.host;
+}
+/**
+ * Parse path from URL (without query string).
+ */
+function extractPath(url) {
+    const parsed = new URL(url);
+    const path = parsed.pathname || "/";
+    return path
+        .split("/")
+        .map((segment) => encodeURIComponent(segment))
+        .join("/")
+        .replace(/%20/g, "%20") // encodeURIComponent already does %20
+        .replace(/'/g, "%27") // AWS expects single quotes encoded
+        .replace(/\(/g, "%28")
+        .replace(/\)/g, "%29")
+        .replace(/\*/g, "%2A");
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Core Signing Logic
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Step 4: Derive the signing key.
+ *
+ * kSecret  = "AWS4" + secretAccessKey
+ * kDate    = HMAC-SHA256(kSecret, dateStamp)
+ * kRegion  = HMAC-SHA256(kDate, region)
+ * kService = HMAC-SHA256(kRegion, service)
+ * kSigning = HMAC-SHA256(kService, "aws4_request")
+ */
+function deriveSigningKey(secretAccessKey, dateStamp, region, service) {
+    const kSecret = "AWS4" + secretAccessKey;
+    const kDate = hmacSha256(kSecret, dateStamp);
+    const kRegion = hmacSha256(kDate, region);
+    const kService = hmacSha256(kRegion, service);
+    const kSigning = hmacSha256(kService, AWS4_REQUEST);
+    return kSigning;
+}
+/**
+ * Step 2: Build the canonical request string.
+ *
+ * Format:
+ *   HTTPMethod
+ *   CanonicalURI
+ *   CanonicalQueryString (empty for us)
+ *   CanonicalHeaders
+ *   (blank line)
+ *   SignedHeaders
+ *   HashedPayload
+ */
+function buildCanonicalRequest(method, path, headers, signedHeadersList, payloadHash) {
+    // Sort headers alphabetically
+    const sortedHeaders = signedHeadersList.sort();
+    // Build canonical headers: each line is "lowercase-key:trimmed-value\n"
+    const canonicalHeaders = sortedHeaders
+        .map((key) => `${key}:${(headers[key] ?? "").trim()}`)
+        .join("\n");
+    // Signed headers: semicolon-separated list
+    const signedHeaders = sortedHeaders.join(";");
+    return [
+        method,
+        path,
+        "", // Query string (empty)
+        canonicalHeaders + "\n", // Must end with newline
+        signedHeaders,
+        payloadHash
+    ].join("\n");
+}
+/**
+ * Step 3: Build the string to sign.
+ *
+ * Format:
+ *   Algorithm
+ *   RequestDateTime
+ *   CredentialScope
+ *   HashedCanonicalRequest
+ */
+function buildStringToSign(amzDate, credentialScope, canonicalRequest) {
+    const hashedCanonicalRequest = sha256Hex(canonicalRequest);
+    return [ALGORITHM, amzDate, credentialScope, hashedCanonicalRequest].join("\n");
+}
+/**
+ * Step 6: Build the Authorization header value.
+ */
+function buildAuthorizationHeader(accessKeyId, credentialScope, signedHeaders, signature) {
+    return `${ALGORITHM} Credential=${accessKeyId}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Public API
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Sign an AWS API request using SigV4.
+ *
+ * @param options - The request details and credentials
+ * @returns Headers to include in the HTTP request
+ *
+ * @example
+ * ```ts
+ * const headers = signRequest({
+ *   method: "POST",
+ *   url: "https://bedrock-runtime.us-east-1.amazonaws.com/model/.../converse",
+ *   body: JSON.stringify({ messages: [...] }),
+ *   credentials: { accessKeyId: "...", secretAccessKey: "..." },
+ *   region: "us-east-1",
+ *   service: "bedrock"
+ * });
+ *
+ * fetch(url, { headers: { ...headers, "Content-Type": "application/json" }, body });
+ * ```
+ */
+export function signRequest(options) {
+    const { method, url, body, credentials, region, service, timestamp } = options;
+    // Timestamps (use provided timestamp for testing, or current time)
+    const now = timestamp ?? new Date();
+    const amzDate = formatAmzDate(now);
+    const dateStamp = formatDateOnly(amzDate);
+    // Step 1: Hash the payload
+    const payloadHash = sha256Hex(body);
+    // Extract URL components
+    const host = extractHost(url);
+    const path = extractPath(url);
+    // Build headers to sign (sorted alphabetically)
+    const headersToSign = {
+        host: host,
+        "x-amz-content-sha256": payloadHash,
+        "x-amz-date": amzDate
+    };
+    // Add session token if present
+    if (credentials.sessionToken) {
+        headersToSign["x-amz-security-token"] = credentials.sessionToken;
+    }
+    const signedHeadersList = Object.keys(headersToSign);
+    // Step 2: Canonical Request
+    const canonicalRequest = buildCanonicalRequest(method, path, headersToSign, signedHeadersList, payloadHash);
+    // Credential scope: date/region/service/aws4_request
+    const credentialScope = `${dateStamp}/${region}/${service}/${AWS4_REQUEST}`;
+    // Step 3: String to Sign
+    const stringToSign = buildStringToSign(amzDate, credentialScope, canonicalRequest);
+    // Step 4: Signing Key
+    const signingKey = deriveSigningKey(credentials.secretAccessKey, dateStamp, region, service);
+    // Step 5: Signature
+    const signature = hmacSha256Hex(signingKey, stringToSign);
+    // Step 6: Authorization Header
+    const signedHeaders = signedHeadersList.sort().join(";");
+    const authorization = buildAuthorizationHeader(credentials.accessKeyId, credentialScope, signedHeaders, signature);
+    // Build final headers
+    const result = {
+        host: host,
+        "x-amz-date": amzDate,
+        "x-amz-content-sha256": payloadHash,
+        authorization: authorization
+    };
+    if (credentials.sessionToken) {
+        result["x-amz-security-token"] = credentials.sessionToken;
+    }
+    return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@node-llm/core",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",