@veridia/node-sdk 1.0.2 → 1.0.5

package/dist/cjs/client.d.ts

@@ -7,6 +7,7 @@ export declare class VeridiaClient {
     private readonly logger;
     private readonly baseUrl;
     private readonly region;
+    private readonly autoFlush;
     private readonly maxBufferSize;
     private readonly maxBufferTimeMs;
     private readonly retries;
@@ -38,9 +39,10 @@ export declare class VeridiaClient {
      *
      * @param identifierType - The type of user identifier ("userId" | "email").
      * @param identifierId - The unique ID or email.
+     * @param [noSegmentsOnError=true] - Whether to throw an error or to return empty array of segments. Defaults to true.
      * @returns A list of segment identifiers the user currently belongs to.
      */
-    getUserSegments(identifierType: IdentifierPayload['type'], identifierId: string): Promise<string[]>;
+    getUserSegments(identifierType: IdentifierPayload['type'], identifierId: string, noSegmentsOnError?: boolean): Promise<string[]>;
     /**
      * Sends all queued identify and track data to the Veridia API immediately.
      * Automatically called when buffers reach their limit or after the configured time interval.

package/dist/cjs/client.js

@@ -44,6 +44,7 @@ class VeridiaClient {
         this.identifyBuffer = [];
         this.baseUrl = options.endpoint ?? 'https://api.veridia.io/v1';
         this.region = options.region ?? 'default';
+        this.autoFlush = options.autoFlush ?? true;
         this.maxBufferSize = options.maxBufferSize ?? 500;
         this.maxBufferTimeMs = options.maxBufferTimeMs ?? 5000;
         this.retries = options.retries ?? 3;
@@ -67,7 +68,8 @@ class VeridiaClient {
             },
             attributes,
         });
-        this.scheduleFlushIfNeeded(this.identifyBuffer);
+        if (this.autoFlush)
+            this.scheduleFlushIfNeeded('profiles', this.identifyBuffer);
     }
     /**
      * Sends a tracking event for the given user.
@@ -87,16 +89,18 @@ class VeridiaClient {
             eventTime,
             properties,
         });
-        this.scheduleFlushIfNeeded(this.trackBuffer);
+        if (this.autoFlush)
+            this.scheduleFlushIfNeeded('events', this.trackBuffer);
     }
     /**
      * Retrieves the current segments for the given user.
      *
      * @param identifierType - The type of user identifier ("userId" | "email").
      * @param identifierId - The unique ID or email.
+     * @param [noSegmentsOnError=true] - Whether to throw an error or to return empty array of segments. Defaults to true.
      * @returns A list of segment identifiers the user currently belongs to.
      */
-    async getUserSegments(identifierType, identifierId) {
+    async getUserSegments(identifierType, identifierId, noSegmentsOnError = true) {
         try {
             const path = `/segments/${identifierType}/${encodeURIComponent(identifierId)}`;
             const url = `${this.baseUrl}${path}`;
@@ -118,7 +122,10 @@ class VeridiaClient {
             }).finally(() => clearTimeout(timeout));
             if (!res.ok) {
                 this.logger?.error('segments', 'getUserSegments API call failed', { status: res.status });
-                return [];
+                if (noSegmentsOnError)
+                    return [];
+                else
+                    throw new Error(`getUserSegments API call failed: ${res.status}`);
             }
             const data = (await res.json());
             if (data.status === 'success' && Array.isArray(data.data)) {
@@ -127,13 +134,19 @@ class VeridiaClient {
             this.logger?.error('segments', 'getUserSegments API returned invalid response', {
                 data: data,
             });
-            return [];
+            if (noSegmentsOnError)
+                return [];
+            else
+                throw new Error(`getUserSegments API returned invalid response: ${JSON.stringify(data)}`);
         }
         catch (err) {
             this.logger?.error('segments', 'getUserSegments encountered an error', {
                 error: err,
             });
-            return [];
+            if (noSegmentsOnError)
+                return [];
+            else
+                throw err;
         }
     }
     /**
@@ -157,12 +170,18 @@ class VeridiaClient {
     async close() {
         await this.flush();
     }
-    scheduleFlushIfNeeded(buffer) {
+    scheduleFlushIfNeeded(service, buffer) {
         if (buffer.length >= this.maxBufferSize) {
-            void this.flush();
+            this.flush().catch((error) => {
+                this.logger?.error(service, 'automatic flush failed', { error });
+            });
         }
         else if (!this.flushTimer) {
-            this.flushTimer = setTimeout(() => this.flush(), this.maxBufferTimeMs);
+            this.flushTimer = setTimeout(() => {
+                this.flush().catch((error) => {
+                    this.logger?.error(service, 'automatic flush failed', { error });
+                });
+            }, this.maxBufferTimeMs);
         }
     }
     async flushBatch(service, buffer) {

package/dist/cjs/types.d.ts

@@ -32,6 +32,7 @@ export type VeridiaClientOptions = {
     secretAccessKey: string;
     endpoint?: string;
     region?: string;
+    autoFlush?: boolean;
     maxBufferSize?: number;
     maxBufferTimeMs?: number;
     retries?: number;

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.0.2";
+export declare const SDK_VERSION = "1.0.5";

package/dist/cjs/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = '1.0.2';
+exports.SDK_VERSION = '1.0.5';
 //# sourceMappingURL=version.js.map

package/dist/esm/client.d.ts

@@ -7,6 +7,7 @@ export declare class VeridiaClient {
     private readonly logger;
     private readonly baseUrl;
     private readonly region;
+    private readonly autoFlush;
     private readonly maxBufferSize;
     private readonly maxBufferTimeMs;
     private readonly retries;
@@ -38,9 +39,10 @@ export declare class VeridiaClient {
      *
      * @param identifierType - The type of user identifier ("userId" | "email").
      * @param identifierId - The unique ID or email.
+     * @param [noSegmentsOnError=true] - Whether to throw an error or to return empty array of segments. Defaults to true.
      * @returns A list of segment identifiers the user currently belongs to.
      */
-    getUserSegments(identifierType: IdentifierPayload['type'], identifierId: string): Promise<string[]>;
+    getUserSegments(identifierType: IdentifierPayload['type'], identifierId: string, noSegmentsOnError?: boolean): Promise<string[]>;
     /**
      * Sends all queued identify and track data to the Veridia API immediately.
      * Automatically called when buffers reach their limit or after the configured time interval.

package/dist/esm/client.js

@@ -44,6 +44,7 @@ class VeridiaClient {
         this.identifyBuffer = [];
         this.baseUrl = options.endpoint ?? 'https://api.veridia.io/v1';
         this.region = options.region ?? 'default';
+        this.autoFlush = options.autoFlush ?? true;
         this.maxBufferSize = options.maxBufferSize ?? 500;
         this.maxBufferTimeMs = options.maxBufferTimeMs ?? 5000;
         this.retries = options.retries ?? 3;
@@ -67,7 +68,8 @@ class VeridiaClient {
             },
             attributes,
         });
-        this.scheduleFlushIfNeeded(this.identifyBuffer);
+        if (this.autoFlush)
+            this.scheduleFlushIfNeeded('profiles', this.identifyBuffer);
     }
     /**
      * Sends a tracking event for the given user.
@@ -87,16 +89,18 @@ class VeridiaClient {
             eventTime,
             properties,
         });
-        this.scheduleFlushIfNeeded(this.trackBuffer);
+        if (this.autoFlush)
+            this.scheduleFlushIfNeeded('events', this.trackBuffer);
     }
     /**
      * Retrieves the current segments for the given user.
      *
      * @param identifierType - The type of user identifier ("userId" | "email").
      * @param identifierId - The unique ID or email.
+     * @param [noSegmentsOnError=true] - Whether to throw an error or to return empty array of segments. Defaults to true.
      * @returns A list of segment identifiers the user currently belongs to.
      */
-    async getUserSegments(identifierType, identifierId) {
+    async getUserSegments(identifierType, identifierId, noSegmentsOnError = true) {
         try {
             const path = `/segments/${identifierType}/${encodeURIComponent(identifierId)}`;
             const url = `${this.baseUrl}${path}`;
@@ -118,7 +122,10 @@ class VeridiaClient {
             }).finally(() => clearTimeout(timeout));
             if (!res.ok) {
                 this.logger?.error('segments', 'getUserSegments API call failed', { status: res.status });
-                return [];
+                if (noSegmentsOnError)
+                    return [];
+                else
+                    throw new Error(`getUserSegments API call failed: ${res.status}`);
             }
             const data = (await res.json());
             if (data.status === 'success' && Array.isArray(data.data)) {
@@ -127,13 +134,19 @@ class VeridiaClient {
             this.logger?.error('segments', 'getUserSegments API returned invalid response', {
                 data: data,
             });
-            return [];
+            if (noSegmentsOnError)
+                return [];
+            else
+                throw new Error(`getUserSegments API returned invalid response: ${JSON.stringify(data)}`);
         }
         catch (err) {
             this.logger?.error('segments', 'getUserSegments encountered an error', {
                 error: err,
             });
-            return [];
+            if (noSegmentsOnError)
+                return [];
+            else
+                throw err;
         }
     }
     /**
@@ -157,12 +170,18 @@ class VeridiaClient {
     async close() {
         await this.flush();
     }
-    scheduleFlushIfNeeded(buffer) {
+    scheduleFlushIfNeeded(service, buffer) {
         if (buffer.length >= this.maxBufferSize) {
-            void this.flush();
+            this.flush().catch((error) => {
+                this.logger?.error(service, 'automatic flush failed', { error });
+            });
         }
         else if (!this.flushTimer) {
-            this.flushTimer = setTimeout(() => this.flush(), this.maxBufferTimeMs);
+            this.flushTimer = setTimeout(() => {
+                this.flush().catch((error) => {
+                    this.logger?.error(service, 'automatic flush failed', { error });
+                });
+            }, this.maxBufferTimeMs);
         }
     }
     async flushBatch(service, buffer) {

package/dist/esm/types.d.ts

@@ -32,6 +32,7 @@ export type VeridiaClientOptions = {
     secretAccessKey: string;
     endpoint?: string;
     region?: string;
+    autoFlush?: boolean;
     maxBufferSize?: number;
     maxBufferTimeMs?: number;
     retries?: number;

package/dist/esm/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.0.2";
+export declare const SDK_VERSION = "1.0.5";

package/dist/esm/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = '1.0.2';
+exports.SDK_VERSION = '1.0.5';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veridia/node-sdk",
-  "version": "1.0.2",
+  "version": "1.0.5",
   "description": "",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -41,5 +41,6 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/veridia-io/veridia-node-sdk.git"
-  }
+  },
+  "license": "MIT"
 }

package/.github/workflows/publish.yml

@@ -1,49 +0,0 @@
-name: Build & Publish
-
-on:
-  push:
-    tags:
-      - 'v*.*.*' # triggers only for version tags (v1.0.0, v1.1.2, etc.)
-
-jobs:
-  build-and-publish:
-    name: Build and publish to npm
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Use Node.js 22
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          registry-url: 'https://registry.npmjs.org/'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Lint
-        run: npm run lint --if-present
-
-      - name: Run tests
-        run: npm test --if-present
-
-      - name: Build SDK (CJS + ESM)
-        run: npm run build
-
-      - name: Verify package contents
-        run: npm pack --dry-run
-
-      - name: Publish to npm
-        if: startsWith(github.ref, 'refs/tags/v')
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-        run: npm publish --access public
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
-        with:
-          generate_release_notes: true