@robosystems/client 0.2.18 → 0.2.21

package/extensions/FileClient.d.ts

@@ -1,6 +1,5 @@
 export interface FileUploadOptions {
     onProgress?: (message: string) => void;
-    fixLocalStackUrl?: boolean;
     fileName?: string;
     ingestToGraph?: boolean;
 }
@@ -30,6 +29,7 @@ export declare class FileClient {
         credentials?: 'include' | 'same-origin' | 'omit';
         headers?: Record<string, string>;
         token?: string;
+        s3EndpointUrl?: string;
     });
     /**
      * Upload a Parquet file to staging

package/extensions/FileClient.js

@@ -48,8 +48,14 @@ class FileClient {
             const uploadData = uploadUrlResponse.data;
             let uploadUrl = uploadData.upload_url;
             const fileId = uploadData.file_id;
-            if (options.fixLocalStackUrl && uploadUrl.includes('localstack:4566')) {
-                uploadUrl = uploadUrl.replace('localstack:4566', 'localhost:4566');
+            // Override S3 endpoint if configured (e.g., for LocalStack)
+            if (this.config.s3EndpointUrl) {
+                const originalUrl = new URL(uploadUrl);
+                const overrideUrl = new URL(this.config.s3EndpointUrl);
+                // Replace scheme, host, and port with the override endpoint
+                originalUrl.protocol = overrideUrl.protocol;
+                originalUrl.host = overrideUrl.host;
+                uploadUrl = originalUrl.toString();
             }
             options.onProgress?.(`Uploading ${fileName} to S3...`);
             const fileContent = await this.getFileContent(fileOrBuffer);
@@ -205,7 +211,15 @@ class FileClient {
             return fileOrBuffer.arrayBuffer();
         }
         if (Buffer.isBuffer(fileOrBuffer)) {
-            return fileOrBuffer.buffer.slice(fileOrBuffer.byteOffset, fileOrBuffer.byteOffset + fileOrBuffer.byteLength);
+            const buffer = fileOrBuffer.buffer.slice(fileOrBuffer.byteOffset, fileOrBuffer.byteOffset + fileOrBuffer.byteLength);
+            // Convert SharedArrayBuffer to ArrayBuffer if needed
+            if (buffer instanceof ArrayBuffer) {
+                return buffer;
+            }
+            // Handle SharedArrayBuffer by copying to ArrayBuffer
+            const arrayBuffer = new ArrayBuffer(buffer.byteLength);
+            new Uint8Array(arrayBuffer).set(new Uint8Array(buffer));
+            return arrayBuffer;
         }
         if ('getReader' in fileOrBuffer) {
             const reader = fileOrBuffer.getReader();

package/extensions/FileClient.ts

@@ -12,7 +12,6 @@ import type { FileStatusUpdate, FileUploadRequest, FileUploadResponse } from '..
 
 export interface FileUploadOptions {
   onProgress?: (message: string) => void
-  fixLocalStackUrl?: boolean
   fileName?: string
   ingestToGraph?: boolean
 }
@@ -45,6 +44,7 @@ export class FileClient {
     credentials?: 'include' | 'same-origin' | 'omit'
     headers?: Record<string, string>
     token?: string
+    s3EndpointUrl?: string // Override S3 endpoint (e.g., for LocalStack)
   }
 
   constructor(config: {
@@ -52,6 +52,7 @@ export class FileClient {
     credentials?: 'include' | 'same-origin' | 'omit'
     headers?: Record<string, string>
     token?: string
+    s3EndpointUrl?: string
   }) {
     this.config = config
   }
@@ -102,8 +103,14 @@ export class FileClient {
       let uploadUrl = uploadData.upload_url
       const fileId = uploadData.file_id
 
-      if (options.fixLocalStackUrl && uploadUrl.includes('localstack:4566')) {
-        uploadUrl = uploadUrl.replace('localstack:4566', 'localhost:4566')
+      // Override S3 endpoint if configured (e.g., for LocalStack)
+      if (this.config.s3EndpointUrl) {
+        const originalUrl = new URL(uploadUrl)
+        const overrideUrl = new URL(this.config.s3EndpointUrl)
+        // Replace scheme, host, and port with the override endpoint
+        originalUrl.protocol = overrideUrl.protocol
+        originalUrl.host = overrideUrl.host
+        uploadUrl = originalUrl.toString()
       }
 
       options.onProgress?.(`Uploading ${fileName} to S3...`)
@@ -284,10 +291,18 @@ export class FileClient {
     }
 
     if (Buffer.isBuffer(fileOrBuffer)) {
-      return fileOrBuffer.buffer.slice(
+      const buffer = fileOrBuffer.buffer.slice(
         fileOrBuffer.byteOffset,
         fileOrBuffer.byteOffset + fileOrBuffer.byteLength
       )
+      // Convert SharedArrayBuffer to ArrayBuffer if needed
+      if (buffer instanceof ArrayBuffer) {
+        return buffer
+      }
+      // Handle SharedArrayBuffer by copying to ArrayBuffer
+      const arrayBuffer = new ArrayBuffer(buffer.byteLength)
+      new Uint8Array(arrayBuffer).set(new Uint8Array(buffer))
+      return arrayBuffer
     }
 
     if ('getReader' in fileOrBuffer) {

package/extensions/index.d.ts

@@ -17,6 +17,7 @@ export interface RoboSystemsExtensionConfig {
     headers?: Record<string, string>;
     maxRetries?: number;
     retryDelay?: number;
+    s3EndpointUrl?: string;
 }
 export declare class RoboSystemsExtensions {
     readonly query: QueryClient;

package/extensions/index.js

@@ -49,6 +49,7 @@ class RoboSystemsExtensions {
             headers: config.headers,
             maxRetries: config.maxRetries || 5,
             retryDelay: config.retryDelay || 1000,
+            s3EndpointUrl: config.s3EndpointUrl,
         };
         this.query = new QueryClient_1.QueryClient({
             baseUrl: this.config.baseUrl,
@@ -74,6 +75,7 @@ class RoboSystemsExtensions {
             credentials: this.config.credentials,
             token: this.config.token,
             headers: this.config.headers,
+            s3EndpointUrl: this.config.s3EndpointUrl,
         });
         this.materialization = new MaterializationClient_1.MaterializationClient({
             baseUrl: this.config.baseUrl,

package/extensions/index.ts

@@ -21,6 +21,7 @@ export interface RoboSystemsExtensionConfig {
   headers?: Record<string, string>
   maxRetries?: number
   retryDelay?: number
+  s3EndpointUrl?: string // Override S3 endpoint (e.g., for LocalStack)
 }
 
 // Properly typed configuration interface
@@ -31,6 +32,7 @@ interface ResolvedConfig {
   headers?: Record<string, string>
   maxRetries: number
   retryDelay: number
+  s3EndpointUrl?: string
 }
 
 export class RoboSystemsExtensions {
@@ -57,6 +59,7 @@ export class RoboSystemsExtensions {
       headers: config.headers,
       maxRetries: config.maxRetries || 5,
       retryDelay: config.retryDelay || 1000,
+      s3EndpointUrl: config.s3EndpointUrl,
     }
 
     this.query = new QueryClient({
@@ -86,6 +89,7 @@ export class RoboSystemsExtensions {
       credentials: this.config.credentials,
       token: this.config.token,
       headers: this.config.headers,
+      s3EndpointUrl: this.config.s3EndpointUrl,
     })
 
     this.materialization = new MaterializationClient({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robosystems/client",
-  "version": "0.2.18",
+  "version": "0.2.21",
   "description": "TypeScript client library for RoboSystems Financial Knowledge Graph API",
   "main": "index.js",
   "types": "index.d.ts",
@@ -109,8 +109,8 @@
     "@testing-library/react": "^16.3.0",
     "@types/node": "^22.0.0",
     "@types/react": "^19.1.9",
-    "@typescript-eslint/eslint-plugin": "^7.0.0",
-    "@typescript-eslint/parser": "^7.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
     "eslint": "^8.0.0",
     "eslint-config-prettier": "^10.0.0",
     "eslint-plugin-prettier": "^5.0.0",
@@ -119,7 +119,7 @@
     "prettier-plugin-organize-imports": "^4.0.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
-    "typescript": "5.5.4",
+    "typescript": "^5.7.2",
     "vitest": "^4.0.3"
   },
   "publishConfig": {

package/sdk-extensions/FileClient.d.ts

@@ -1,6 +1,5 @@
 export interface FileUploadOptions {
     onProgress?: (message: string) => void;
-    fixLocalStackUrl?: boolean;
     fileName?: string;
     ingestToGraph?: boolean;
 }
@@ -30,6 +29,7 @@ export declare class FileClient {
         credentials?: 'include' | 'same-origin' | 'omit';
         headers?: Record<string, string>;
         token?: string;
+        s3EndpointUrl?: string;
     });
     /**
      * Upload a Parquet file to staging

package/sdk-extensions/FileClient.js

@@ -48,8 +48,14 @@ class FileClient {
             const uploadData = uploadUrlResponse.data;
             let uploadUrl = uploadData.upload_url;
             const fileId = uploadData.file_id;
-            if (options.fixLocalStackUrl && uploadUrl.includes('localstack:4566')) {
-                uploadUrl = uploadUrl.replace('localstack:4566', 'localhost:4566');
+            // Override S3 endpoint if configured (e.g., for LocalStack)
+            if (this.config.s3EndpointUrl) {
+                const originalUrl = new URL(uploadUrl);
+                const overrideUrl = new URL(this.config.s3EndpointUrl);
+                // Replace scheme, host, and port with the override endpoint
+                originalUrl.protocol = overrideUrl.protocol;
+                originalUrl.host = overrideUrl.host;
+                uploadUrl = originalUrl.toString();
             }
             options.onProgress?.(`Uploading ${fileName} to S3...`);
             const fileContent = await this.getFileContent(fileOrBuffer);
@@ -205,7 +211,15 @@ class FileClient {
             return fileOrBuffer.arrayBuffer();
         }
         if (Buffer.isBuffer(fileOrBuffer)) {
-            return fileOrBuffer.buffer.slice(fileOrBuffer.byteOffset, fileOrBuffer.byteOffset + fileOrBuffer.byteLength);
+            const buffer = fileOrBuffer.buffer.slice(fileOrBuffer.byteOffset, fileOrBuffer.byteOffset + fileOrBuffer.byteLength);
+            // Convert SharedArrayBuffer to ArrayBuffer if needed
+            if (buffer instanceof ArrayBuffer) {
+                return buffer;
+            }
+            // Handle SharedArrayBuffer by copying to ArrayBuffer
+            const arrayBuffer = new ArrayBuffer(buffer.byteLength);
+            new Uint8Array(arrayBuffer).set(new Uint8Array(buffer));
+            return arrayBuffer;
         }
         if ('getReader' in fileOrBuffer) {
             const reader = fileOrBuffer.getReader();

package/sdk-extensions/FileClient.ts

@@ -12,7 +12,6 @@ import type { FileStatusUpdate, FileUploadRequest, FileUploadResponse } from '..
 
 export interface FileUploadOptions {
   onProgress?: (message: string) => void
-  fixLocalStackUrl?: boolean
   fileName?: string
   ingestToGraph?: boolean
 }
@@ -45,6 +44,7 @@ export class FileClient {
     credentials?: 'include' | 'same-origin' | 'omit'
     headers?: Record<string, string>
     token?: string
+    s3EndpointUrl?: string // Override S3 endpoint (e.g., for LocalStack)
   }
 
   constructor(config: {
@@ -52,6 +52,7 @@ export class FileClient {
     credentials?: 'include' | 'same-origin' | 'omit'
     headers?: Record<string, string>
     token?: string
+    s3EndpointUrl?: string
   }) {
     this.config = config
   }
@@ -102,8 +103,14 @@ export class FileClient {
       let uploadUrl = uploadData.upload_url
       const fileId = uploadData.file_id
 
-      if (options.fixLocalStackUrl && uploadUrl.includes('localstack:4566')) {
-        uploadUrl = uploadUrl.replace('localstack:4566', 'localhost:4566')
+      // Override S3 endpoint if configured (e.g., for LocalStack)
+      if (this.config.s3EndpointUrl) {
+        const originalUrl = new URL(uploadUrl)
+        const overrideUrl = new URL(this.config.s3EndpointUrl)
+        // Replace scheme, host, and port with the override endpoint
+        originalUrl.protocol = overrideUrl.protocol
+        originalUrl.host = overrideUrl.host
+        uploadUrl = originalUrl.toString()
       }
 
       options.onProgress?.(`Uploading ${fileName} to S3...`)
@@ -284,10 +291,18 @@ export class FileClient {
     }
 
     if (Buffer.isBuffer(fileOrBuffer)) {
-      return fileOrBuffer.buffer.slice(
+      const buffer = fileOrBuffer.buffer.slice(
         fileOrBuffer.byteOffset,
         fileOrBuffer.byteOffset + fileOrBuffer.byteLength
       )
+      // Convert SharedArrayBuffer to ArrayBuffer if needed
+      if (buffer instanceof ArrayBuffer) {
+        return buffer
+      }
+      // Handle SharedArrayBuffer by copying to ArrayBuffer
+      const arrayBuffer = new ArrayBuffer(buffer.byteLength)
+      new Uint8Array(arrayBuffer).set(new Uint8Array(buffer))
+      return arrayBuffer
     }
 
     if ('getReader' in fileOrBuffer) {

package/sdk-extensions/index.d.ts

@@ -17,6 +17,7 @@ export interface RoboSystemsExtensionConfig {
     headers?: Record<string, string>;
     maxRetries?: number;
     retryDelay?: number;
+    s3EndpointUrl?: string;
 }
 export declare class RoboSystemsExtensions {
     readonly query: QueryClient;

package/sdk-extensions/index.js

@@ -49,6 +49,7 @@ class RoboSystemsExtensions {
             headers: config.headers,
             maxRetries: config.maxRetries || 5,
             retryDelay: config.retryDelay || 1000,
+            s3EndpointUrl: config.s3EndpointUrl,
         };
         this.query = new QueryClient_1.QueryClient({
             baseUrl: this.config.baseUrl,
@@ -74,6 +75,7 @@ class RoboSystemsExtensions {
             credentials: this.config.credentials,
             token: this.config.token,
             headers: this.config.headers,
+            s3EndpointUrl: this.config.s3EndpointUrl,
         });
         this.materialization = new MaterializationClient_1.MaterializationClient({
             baseUrl: this.config.baseUrl,

package/sdk-extensions/index.ts

@@ -21,6 +21,7 @@ export interface RoboSystemsExtensionConfig {
   headers?: Record<string, string>
   maxRetries?: number
   retryDelay?: number
+  s3EndpointUrl?: string // Override S3 endpoint (e.g., for LocalStack)
 }
 
 // Properly typed configuration interface
@@ -31,6 +32,7 @@ interface ResolvedConfig {
   headers?: Record<string, string>
   maxRetries: number
   retryDelay: number
+  s3EndpointUrl?: string
 }
 
 export class RoboSystemsExtensions {
@@ -57,6 +59,7 @@ export class RoboSystemsExtensions {
       headers: config.headers,
       maxRetries: config.maxRetries || 5,
       retryDelay: config.retryDelay || 1000,
+      s3EndpointUrl: config.s3EndpointUrl,
     }
 
     this.query = new QueryClient({
@@ -86,6 +89,7 @@ export class RoboSystemsExtensions {
       credentials: this.config.credentials,
       token: this.config.token,
       headers: this.config.headers,
+      s3EndpointUrl: this.config.s3EndpointUrl,
     })
 
     this.materialization = new MaterializationClient({