@armco/analytics 0.3.1 → 0.3.3

package/core/analytics.js

@@ -9,6 +9,7 @@ import { UserPlugin } from "../plugins/enrichment/user";
 import { validateConfig, sanitizeEventData } from "../utils/validation";
 import { createLogger } from "../utils/logging";
 import { getEnvironmentType, isDoNotTrackEnabled, getTimestamp, deepMerge, } from "../utils/helpers";
+import { ensureRegion } from "../utils/region";
 import { resolveEndpoint, detectEnvironment } from "../utils/config-loader";
 export class AnalyticsBuilder {
     constructor() {
@@ -197,7 +198,7 @@ export class Analytics {
             eventType,
             timestamp: getTimestamp(),
             eventId: uuidv4(),
-            data: sanitizeEventData(data || {}),
+            data: ensureRegion(sanitizeEventData(data || {})),
         };
         for (const plugin of this.plugins) {
             if (plugin.processEvent) {

package/index.d.ts

@@ -19,6 +19,7 @@ export { validateConfig, validateUser, validatePageView, validateClickEvent, val
 export { Logger, getLogger, createLogger } from "./utils/logging";
 export { generateId, getEnvironmentType, getEnvironment, isDoNotTrackEnabled, isBrowser, areCookiesAvailable, isLocalStorageAvailable, debounce, throttle, deepClone, deepMerge, } from "./utils/helpers";
 export { loadConfigFromFile, loadConfig, detectEnvironment, checkEndpointHealth, resolveEndpoint } from "./utils/config-loader";
+export { getRegionFallback, ensureRegion } from "./utils/region";
 import { AnalyticsBuilder as Builder } from "./core/analytics";
 export declare function createAnalytics(): Builder;
 export default Builder;

package/index.js

@@ -17,6 +17,7 @@ export { validateConfig, validateUser, validatePageView, validateClickEvent, val
 export { Logger, getLogger, createLogger } from "./utils/logging";
 export { generateId, getEnvironmentType, getEnvironment, isDoNotTrackEnabled, isBrowser, areCookiesAvailable, isLocalStorageAvailable, debounce, throttle, deepClone, deepMerge, } from "./utils/helpers";
 export { loadConfigFromFile, loadConfig, detectEnvironment, checkEndpointHealth, resolveEndpoint } from "./utils/config-loader";
+export { getRegionFallback, ensureRegion } from "./utils/region";
 import { AnalyticsBuilder as Builder } from "./core/analytics";
 export function createAnalytics() {
     return new Builder();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@armco/analytics",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Universal Analytics Library for Browser and Node.js",
   "main": "index.js",
   "types": "index.d.ts",

package/utils/region.d.ts

@@ -0,0 +1,2 @@
+export declare function getRegionFallback(): string;
+export declare function ensureRegion<T extends Record<string, unknown>>(data: T): T;

package/utils/region.js

@@ -0,0 +1,34 @@
+import { getEnvironmentType } from "./helpers";
+import { detectEnvironment } from "./config-loader";
+export function getRegionFallback() {
+    const envType = getEnvironmentType();
+    if (envType === "node") {
+        const explicit = process.env.ANALYTICS_REGION ||
+            process.env.REGION ||
+            process.env.AWS_REGION ||
+            process.env.AWS_DEFAULT_REGION;
+        if (explicit && explicit.trim().length > 0) {
+            return explicit.trim();
+        }
+        const currentEnv = detectEnvironment();
+        return currentEnv === "development" || currentEnv === "local"
+            ? "local"
+            : "unknown";
+    }
+    if (envType === "browser") {
+        const win = window;
+        if (win.__ANALYTICS_REGION__ && typeof win.__ANALYTICS_REGION__ === "string") {
+            return win.__ANALYTICS_REGION__;
+        }
+    }
+    return "unknown";
+}
+export function ensureRegion(data) {
+    if (data.region && typeof data.region === "string" && data.region.trim().length > 0) {
+        return data;
+    }
+    return {
+        ...data,
+        region: getRegionFallback(),
+    };
+}

package/utils/validation.js

@@ -1,8 +1,9 @@
 import { z } from "zod";
 import { ValidationError } from "../core/errors";
+const endpointConfigSchema = z.record(z.string(), z.string().url());
 const configSchema = z.object({
     apiKey: z.string().optional(),
-    endpoint: z.string().url().optional(),
+    endpoint: z.union([z.string().url(), endpointConfigSchema]).optional(),
     hostProjectName: z.string().optional(),
     trackEvents: z.array(z.string()).optional(),
     submissionStrategy: z.enum(["ONEVENT", "DEFER"]).optional(),