@traffical/core 0.1.2

package/dist/hashing/bucket.js

@@ -0,0 +1,89 @@
+/**
+ * Bucket Computation
+ *
+ * Deterministic bucket assignment for traffic splitting.
+ * The bucket is computed as: hash(unitKeyValue + ":" + layerId) % bucketCount
+ *
+ * This ensures:
+ * - Same user always gets same bucket for a given layer
+ * - Different layers can have independent bucketing (orthogonality)
+ * - Deterministic results across SDK and server
+ */
+import { fnv1a } from "./fnv1a.js";
+/**
+ * Computes the bucket for a given unit and layer.
+ *
+ * @param unitKeyValue - The value of the unit key (e.g., userId value)
+ * @param layerId - The layer ID for orthogonal bucketing
+ * @param bucketCount - Total number of buckets (e.g., 1000)
+ * @returns Bucket number in range [0, bucketCount - 1]
+ */
+export function computeBucket(unitKeyValue, layerId, bucketCount) {
+    // Concatenate unit key and layer ID with separator
+    const input = `${unitKeyValue}:${layerId}`;
+    // Use FNV-1a for consistent hashing
+    const hash = fnv1a(input);
+    // Map to bucket range
+    return hash % bucketCount;
+}
+/**
+ * Checks if a bucket falls within a range.
+ *
+ * @param bucket - The computed bucket
+ * @param range - [start, end] inclusive range
+ * @returns True if bucket is in range
+ */
+export function isInBucketRange(bucket, range) {
+    return bucket >= range[0] && bucket <= range[1];
+}
+/**
+ * Finds which allocation matches a given bucket.
+ *
+ * @param bucket - The computed bucket
+ * @param allocations - Array of allocations with bucket ranges
+ * @returns The matching allocation, or null if none match
+ */
+export function findMatchingAllocation(bucket, allocations) {
+    for (const allocation of allocations) {
+        if (isInBucketRange(bucket, allocation.bucketRange)) {
+            return allocation;
+        }
+    }
+    return null;
+}
+/**
+ * Converts a percentage to a bucket range.
+ *
+ * @param percentage - Traffic percentage (0-100)
+ * @param bucketCount - Total buckets
+ * @param startBucket - Starting bucket (default 0)
+ * @returns [start, end] bucket range
+ */
+export function percentageToBucketRange(percentage, bucketCount, startBucket = 0) {
+    const bucketsNeeded = Math.floor((percentage / 100) * bucketCount);
+    const endBucket = Math.min(startBucket + bucketsNeeded - 1, bucketCount - 1);
+    return [startBucket, endBucket];
+}
+/**
+ * Creates non-overlapping bucket ranges for multiple variants.
+ *
+ * @param percentages - Array of percentages that should sum to <= 100
+ * @param bucketCount - Total buckets
+ * @returns Array of [start, end] bucket ranges
+ */
+export function createBucketRanges(percentages, bucketCount) {
+    const ranges = [];
+    let currentBucket = 0;
+    for (const percentage of percentages) {
+        if (percentage <= 0)
+            continue;
+        const bucketsNeeded = Math.floor((percentage / 100) * bucketCount);
+        if (bucketsNeeded > 0) {
+            const endBucket = currentBucket + bucketsNeeded - 1;
+            ranges.push([currentBucket, endBucket]);
+            currentBucket = endBucket + 1;
+        }
+    }
+    return ranges;
+}
+//# sourceMappingURL=bucket.js.map

package/dist/hashing/bucket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bucket.js","sourceRoot":"","sources":["../../src/hashing/bucket.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,YAAoB,EACpB,OAAe,EACf,WAAmB;IAEnB,mDAAmD;IACnD,MAAM,KAAK,GAAG,GAAG,YAAY,IAAI,OAAO,EAAE,CAAC;IAE3C,oCAAoC;IACpC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAE1B,sBAAsB;IACtB,OAAO,IAAI,GAAG,WAAW,CAAC;AAC5B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,KAAuB;IAEvB,OAAO,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAEpC,MAAc,EAAE,WAAgB;IAChC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACpD,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAAkB,EAClB,WAAmB,EACnB,WAAW,GAAG,CAAC;IAEf,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,aAAa,GAAG,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC;IAC7E,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAAqB,EACrB,WAAmB;IAEnB,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,UAAU,IAAI,CAAC;YAAE,SAAS;QAE9B,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;QACnE,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,SAAS,GAAG,aAAa,GAAG,aAAa,GAAG,CAAC,CAAC;YACpD,MAAM,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;YACxC,aAAa,GAAG,SAAS,GAAG,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/hashing/fnv1a.d.ts

@@ -0,0 +1,17 @@
+/**
+ * FNV-1a Hash Function
+ *
+ * A simple, fast hash function with good distribution properties.
+ * Used by Google's experimentation system for bucket assignment.
+ *
+ * This implementation produces consistent results across all platforms
+ * and is the canonical hash for Traffical SDKs.
+ */
+/**
+ * Computes the FNV-1a hash of a string.
+ *
+ * @param input - The string to hash
+ * @returns Unsigned 32-bit integer hash
+ */
+export declare function fnv1a(input: string): number;
+//# sourceMappingURL=fnv1a.d.ts.map

package/dist/hashing/fnv1a.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fnv1a.d.ts","sourceRoot":"","sources":["../../src/hashing/fnv1a.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAU3C"}

package/dist/hashing/fnv1a.js

@@ -0,0 +1,27 @@
+/**
+ * FNV-1a Hash Function
+ *
+ * A simple, fast hash function with good distribution properties.
+ * Used by Google's experimentation system for bucket assignment.
+ *
+ * This implementation produces consistent results across all platforms
+ * and is the canonical hash for Traffical SDKs.
+ */
+const FNV_OFFSET_BASIS = 2166136261;
+const FNV_PRIME = 16777619;
+/**
+ * Computes the FNV-1a hash of a string.
+ *
+ * @param input - The string to hash
+ * @returns Unsigned 32-bit integer hash
+ */
+export function fnv1a(input) {
+    let hash = FNV_OFFSET_BASIS;
+    for (let i = 0; i < input.length; i++) {
+        hash ^= input.charCodeAt(i);
+        hash = Math.imul(hash, FNV_PRIME);
+    }
+    // Convert to unsigned 32-bit integer
+    return hash >>> 0;
+}
+//# sourceMappingURL=fnv1a.js.map

package/dist/hashing/fnv1a.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fnv1a.js","sourceRoot":"","sources":["../../src/hashing/fnv1a.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,gBAAgB,GAAG,UAAU,CAAC;AACpC,MAAM,SAAS,GAAG,QAAQ,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,IAAI,IAAI,GAAG,gBAAgB,CAAC;IAE5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,qCAAqC;IACrC,OAAO,IAAI,KAAK,CAAC,CAAC;AACpB,CAAC"}

package/dist/hashing/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hashing Module
+ *
+ * Exports all hashing-related functions for deterministic bucket assignment.
+ */
+export { fnv1a } from "./fnv1a.js";
+export { computeBucket, isInBucketRange, findMatchingAllocation, percentageToBucketRange, createBucketRanges, } from "./bucket.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/hashing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hashing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EACL,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/dist/hashing/index.js

@@ -0,0 +1,8 @@
+/**
+ * Hashing Module
+ *
+ * Exports all hashing-related functions for deterministic bucket assignment.
+ */
+export { fnv1a } from "./fnv1a.js";
+export { computeBucket, isInBucketRange, findMatchingAllocation, percentageToBucketRange, createBucketRanges, } from "./bucket.js";
+//# sourceMappingURL=index.js.map

package/dist/hashing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hashing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EACL,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/dist/ids/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * ID Generation Utilities
+ *
+ * Provides consistent ID generation with type prefixes for all entities and events.
+ *
+ * Entity IDs: 8-character NanoID with prefix (e.g., "proj_hVF1cCoC")
+ * - Compact and URL-friendly
+ * - 64^8 = 281 trillion combinations
+ * - With DB constraints, collisions are handled via retry
+ *
+ * Event IDs: ULID with prefix (e.g., "dec_01JHFK1WWMMG7M0XPEBTYXZEBW")
+ * - Lexicographically sortable (time-ordered)
+ * - Contains millisecond timestamp for analytics
+ */
+/**
+ * Entity ID prefixes for each entity type.
+ */
+export type EntityIdPrefix = "org" | "proj" | "env" | "ns" | "lay" | "pol" | "alloc" | "param" | "dom" | "ovr" | "ak";
+/**
+ * Event ID prefixes for each event type.
+ */
+export type EventIdPrefix = "dec" | "exp" | "trk";
+/**
+ * Generates a prefixed 8-char NanoID for the specified entity type.
+ *
+ * @param prefix - The entity type prefix
+ * @returns A prefixed NanoID string (e.g., "proj_hVF1cCoC")
+ */
+export declare function generateEntityId(prefix: EntityIdPrefix): string;
+/**
+ * Generates a prefixed ULID for the specified event type.
+ * Events use ULID for time-sortability in analytics.
+ *
+ * @param prefix - The event type prefix
+ * @returns A prefixed ULID string (e.g., "dec_01JHFK1WWMMG7M0XPEBTYXZEBW")
+ */
+export declare function generateEventId(prefix: EventIdPrefix): string;
+/**
+ * Generates a plain 8-char NanoID without prefix.
+ * Used for internal IDs that don't need type identification.
+ */
+export declare function generateShortId(): string;
+/** Generates an Organization ID with "org_" prefix */
+export declare function generateOrgId(): string;
+/** Generates a Project ID with "proj_" prefix */
+export declare function generateProjectId(): string;
+/** Generates an Environment ID with "env_" prefix */
+export declare function generateEnvironmentId(): string;
+/** Generates a Namespace ID with "ns_" prefix */
+export declare function generateNamespaceId(): string;
+/** Generates a Layer ID with "lay_" prefix */
+export declare function generateLayerId(): string;
+/** Generates a Policy ID with "pol_" prefix */
+export declare function generatePolicyId(): string;
+/** Generates an Allocation ID with "alloc_" prefix */
+export declare function generateAllocationId(): string;
+/** Generates a Parameter ID with "param_" prefix */
+export declare function generateParameterId(): string;
+/** Generates a DOM Binding ID with "dom_" prefix */
+export declare function generateDomBindingId(): string;
+/** Generates an Environment Override ID with "ovr_" prefix */
+export declare function generateOverrideId(): string;
+/** Generates an API Key ID with "ak_" prefix */
+export declare function generateApiKeyId(): string;
+/** Generates a Decision event ID with "dec_" prefix (ULID) */
+export declare function generateDecisionId(): string;
+/** Generates an Exposure event ID with "exp_" prefix (ULID) */
+export declare function generateExposureId(): string;
+/** Generates a Track event ID with "trk_" prefix (ULID) */
+export declare function generateTrackEventId(): string;
+/**
+ * Extracts the timestamp from a ULID-based ID.
+ * Only works for event IDs (ULID format).
+ *
+ * @param id - A prefixed ULID (e.g., "dec_01JHFK1WWMMG7M0XPEBTYXZEBW")
+ * @returns The timestamp as a Date, or null if invalid
+ */
+export declare function getIdTimestamp(id: string): Date | null;
+/**
+ * @deprecated Use getIdTimestamp instead
+ */
+export declare function getEventIdTimestamp(eventId: string): Date | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/ids/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ids/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA8BH;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,KAAK,GACL,MAAM,GACN,KAAK,GACL,IAAI,GACJ,KAAK,GACL,KAAK,GACL,OAAO,GACP,OAAO,GACP,KAAK,GACL,KAAK,GACL,IAAI,CAAC;AAET;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAMlD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAE7D;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAMD,sDAAsD;AACtD,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,iDAAiD;AACjD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,qDAAqD;AACrD,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,8CAA8C;AAC9C,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,sDAAsD;AACtD,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,oDAAoD;AACpD,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,oDAAoD;AACpD,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,gDAAgD;AAChD,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAMD,8DAA8D;AAC9D,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,2DAA2D;AAC3D,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CA2BtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEhE"}

package/dist/ids/index.js

@@ -0,0 +1,165 @@
+/**
+ * ID Generation Utilities
+ *
+ * Provides consistent ID generation with type prefixes for all entities and events.
+ *
+ * Entity IDs: 8-character NanoID with prefix (e.g., "proj_hVF1cCoC")
+ * - Compact and URL-friendly
+ * - 64^8 = 281 trillion combinations
+ * - With DB constraints, collisions are handled via retry
+ *
+ * Event IDs: ULID with prefix (e.g., "dec_01JHFK1WWMMG7M0XPEBTYXZEBW")
+ * - Lexicographically sortable (time-ordered)
+ * - Contains millisecond timestamp for analytics
+ */
+import { customAlphabet } from "nanoid";
+import { ulid } from "ulid";
+// =============================================================================
+// NanoID Configuration
+// =============================================================================
+/**
+ * URL-safe alphabet for NanoID (64 characters).
+ * Includes: 0-9, A-Z, a-z (no special chars to avoid URL encoding issues)
+ */
+const NANOID_ALPHABET = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+/**
+ * Default length for entity IDs (without prefix).
+ * 64^8 = 281,474,976,710,656 (~281 trillion) combinations.
+ */
+const ENTITY_ID_LENGTH = 8;
+/**
+ * NanoID generator with custom alphabet.
+ */
+const nanoid = customAlphabet(NANOID_ALPHABET, ENTITY_ID_LENGTH);
+// =============================================================================
+// Generic ID Generation
+// =============================================================================
+/**
+ * Generates a prefixed 8-char NanoID for the specified entity type.
+ *
+ * @param prefix - The entity type prefix
+ * @returns A prefixed NanoID string (e.g., "proj_hVF1cCoC")
+ */
+export function generateEntityId(prefix) {
+    return `${prefix}_${nanoid()}`;
+}
+/**
+ * Generates a prefixed ULID for the specified event type.
+ * Events use ULID for time-sortability in analytics.
+ *
+ * @param prefix - The event type prefix
+ * @returns A prefixed ULID string (e.g., "dec_01JHFK1WWMMG7M0XPEBTYXZEBW")
+ */
+export function generateEventId(prefix) {
+    return `${prefix}_${ulid()}`;
+}
+/**
+ * Generates a plain 8-char NanoID without prefix.
+ * Used for internal IDs that don't need type identification.
+ */
+export function generateShortId() {
+    return nanoid();
+}
+// =============================================================================
+// Entity ID Convenience Functions
+// =============================================================================
+/** Generates an Organization ID with "org_" prefix */
+export function generateOrgId() {
+    return generateEntityId("org");
+}
+/** Generates a Project ID with "proj_" prefix */
+export function generateProjectId() {
+    return generateEntityId("proj");
+}
+/** Generates an Environment ID with "env_" prefix */
+export function generateEnvironmentId() {
+    return generateEntityId("env");
+}
+/** Generates a Namespace ID with "ns_" prefix */
+export function generateNamespaceId() {
+    return generateEntityId("ns");
+}
+/** Generates a Layer ID with "lay_" prefix */
+export function generateLayerId() {
+    return generateEntityId("lay");
+}
+/** Generates a Policy ID with "pol_" prefix */
+export function generatePolicyId() {
+    return generateEntityId("pol");
+}
+/** Generates an Allocation ID with "alloc_" prefix */
+export function generateAllocationId() {
+    return generateEntityId("alloc");
+}
+/** Generates a Parameter ID with "param_" prefix */
+export function generateParameterId() {
+    return generateEntityId("param");
+}
+/** Generates a DOM Binding ID with "dom_" prefix */
+export function generateDomBindingId() {
+    return generateEntityId("dom");
+}
+/** Generates an Environment Override ID with "ovr_" prefix */
+export function generateOverrideId() {
+    return generateEntityId("ovr");
+}
+/** Generates an API Key ID with "ak_" prefix */
+export function generateApiKeyId() {
+    return generateEntityId("ak");
+}
+// =============================================================================
+// Event ID Convenience Functions (Keep ULID for time-sortability)
+// =============================================================================
+/** Generates a Decision event ID with "dec_" prefix (ULID) */
+export function generateDecisionId() {
+    return generateEventId("dec");
+}
+/** Generates an Exposure event ID with "exp_" prefix (ULID) */
+export function generateExposureId() {
+    return generateEventId("exp");
+}
+/** Generates a Track event ID with "trk_" prefix (ULID) */
+export function generateTrackEventId() {
+    return generateEventId("trk");
+}
+// =============================================================================
+// Utilities
+// =============================================================================
+/**
+ * Extracts the timestamp from a ULID-based ID.
+ * Only works for event IDs (ULID format).
+ *
+ * @param id - A prefixed ULID (e.g., "dec_01JHFK1WWMMG7M0XPEBTYXZEBW")
+ * @returns The timestamp as a Date, or null if invalid
+ */
+export function getIdTimestamp(id) {
+    // Extract the ULID part (after the prefix and underscore)
+    const parts = id.split("_");
+    if (parts.length < 2) {
+        return null;
+    }
+    const ulidPart = parts[1];
+    if (!ulidPart || ulidPart.length !== 26) {
+        return null;
+    }
+    // ULID timestamp is encoded in the first 10 characters (Crockford's Base32)
+    const ENCODING = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+    const TIME_LEN = 10;
+    let time = 0;
+    for (let i = 0; i < TIME_LEN; i++) {
+        const char = ulidPart.charAt(i).toUpperCase();
+        const index = ENCODING.indexOf(char);
+        if (index === -1) {
+            return null;
+        }
+        time = time * 32 + index;
+    }
+    return new Date(time);
+}
+/**
+ * @deprecated Use getIdTimestamp instead
+ */
+export function getEventIdTimestamp(eventId) {
+    return getIdTimestamp(eventId);
+}
+//# sourceMappingURL=index.js.map

package/dist/ids/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ids/index.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @traffical/core
+ *
+ * Pure TypeScript core for Traffical SDK.
+ * This package performs no I/O and can be used in any JavaScript environment.
+ *
+ * Key features:
+ * - Deterministic parameter resolution
+ * - FNV-1a hashing for bucket assignment
+ * - Condition evaluation for targeting
+ * - Defaults-based graceful degradation
+ */
+export type { Timestamp, Id, ParameterType, ParameterValue, Context, ConfigBundle, BundleHashingConfig, BundleParameter, BundleDOMBinding, BundleLayer, BundlePolicy, BundleAllocation, BundleCondition, PolicyState, PolicyKind, ConditionOperator, EntityConfig, EntityWeights, BundleEntityPolicyState, ParameterDefaults, DecisionResult, DecisionMetadata, LayerResolution, BaseEventFields, ExposureEvent, TrackEvent, TrackAttribution, DecisionEvent, TrackableEvent, TrafficalClientOptions, GetParamsOptions, DecideOptions, TrackOptions, } from "./types/index.js";
+export { fnv1a, computeBucket, isInBucketRange, findMatchingAllocation, percentageToBucketRange, createBucketRanges, } from "./hashing/index.js";
+export { resolveParameters, decide, getUnitKeyValue, evaluateCondition, evaluateConditions, eq, neq, inValues, notIn, gt, gte, lt, lte, contains, startsWith, endsWith, regex, exists, notExists, } from "./resolution/index.js";
+export { DecisionDeduplicator, type DecisionDeduplicatorOptions, } from "./dedup/index.js";
+export { generateEventId, generateDecisionId, generateExposureId, generateTrackEventId, generateEntityId, generateShortId, generateOrgId, generateProjectId, generateEnvironmentId, generateNamespaceId, generateLayerId, generatePolicyId, generateAllocationId, generateParameterId, generateDomBindingId, generateOverrideId, generateApiKeyId, getIdTimestamp, getEventIdTimestamp, // deprecated
+type EventIdPrefix, type EntityIdPrefix, } from "./ids/index.js";
+export { EdgeClient, createEdgeDecideRequest, type EdgeClientConfig, type EdgeDecideRequest, type EdgeDecideResponse, type EdgeBatchDecideRequest, type EdgeBatchDecideResponse, } from "./edge/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,YAAY,EAEV,SAAS,EACT,EAAE,EACF,aAAa,EACb,cAAc,EACd,OAAO,EAEP,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,UAAU,EACV,iBAAiB,EAEjB,YAAY,EACZ,aAAa,EACb,uBAAuB,EAEvB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,eAAe,EAEf,eAAe,EACf,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,cAAc,EAEd,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,KAAK,EACL,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,iBAAiB,EACjB,MAAM,EACN,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAElB,EAAE,EACF,GAAG,EACH,QAAQ,EACR,KAAK,EACL,EAAE,EACF,GAAG,EACH,EAAE,EACF,GAAG,EACH,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,KAAK,EACL,MAAM,EACN,SAAS,GACV,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,GACjC,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAEL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EAEpB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAEhB,cAAc,EACd,mBAAmB,EAAE,aAAa;AAElC,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,UAAU,EACV,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+/**
+ * @traffical/core
+ *
+ * Pure TypeScript core for Traffical SDK.
+ * This package performs no I/O and can be used in any JavaScript environment.
+ *
+ * Key features:
+ * - Deterministic parameter resolution
+ * - FNV-1a hashing for bucket assignment
+ * - Condition evaluation for targeting
+ * - Defaults-based graceful degradation
+ */
+// Hashing
+export { fnv1a, computeBucket, isInBucketRange, findMatchingAllocation, percentageToBucketRange, createBucketRanges, } from "./hashing/index.js";
+// Resolution
+export { resolveParameters, decide, getUnitKeyValue, evaluateCondition, evaluateConditions, 
+// Condition builders
+eq, neq, inValues, notIn, gt, gte, lt, lte, contains, startsWith, endsWith, regex, exists, notExists, } from "./resolution/index.js";
+// Deduplication
+export { DecisionDeduplicator, } from "./dedup/index.js";
+// ID Generation
+export { 
+// Event IDs (ULID - time-sortable)
+generateEventId, generateDecisionId, generateExposureId, generateTrackEventId, 
+// Entity IDs (8-char NanoID)
+generateEntityId, generateShortId, generateOrgId, generateProjectId, generateEnvironmentId, generateNamespaceId, generateLayerId, generatePolicyId, generateAllocationId, generateParameterId, generateDomBindingId, generateOverrideId, generateApiKeyId, 
+// Utilities
+getIdTimestamp, getEventIdTimestamp, // deprecated
+ } from "./ids/index.js";
+// Edge Client (for per-entity policies)
+export { EdgeClient, createEdgeDecideRequest, } from "./edge/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA6CH,UAAU;AACV,OAAO,EACL,KAAK,EACL,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,aAAa;AACb,OAAO,EACL,iBAAiB,EACjB,MAAM,EACN,eAAe,EACf,iBAAiB,EACjB,kBAAkB;AAClB,qBAAqB;AACrB,EAAE,EACF,GAAG,EACH,QAAQ,EACR,KAAK,EACL,EAAE,EACF,GAAG,EACH,EAAE,EACF,GAAG,EACH,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,KAAK,EACL,MAAM,EACN,SAAS,GACV,MAAM,uBAAuB,CAAC;AAE/B,gBAAgB;AAChB,OAAO,EACL,oBAAoB,GAErB,MAAM,kBAAkB,CAAC;AAE1B,gBAAgB;AAChB,OAAO;AACL,mCAAmC;AACnC,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB;AACpB,6BAA6B;AAC7B,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB;AAChB,YAAY;AACZ,cAAc,EACd,mBAAmB,EAAE,aAAa;EAInC,MAAM,gBAAgB,CAAC;AAExB,wCAAwC;AACxC,OAAO,EACL,UAAU,EACV,uBAAuB,GAMxB,MAAM,iBAAiB,CAAC"}

package/dist/resolution/conditions.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Condition Evaluation
+ *
+ * Evaluates context predicates to determine policy eligibility.
+ * Conditions are AND-ed together: all must match for a policy to apply.
+ */
+import type { Context, BundleCondition } from "../types/index.js";
+/**
+ * Evaluates a single condition against a context.
+ *
+ * @param condition - The condition to evaluate
+ * @param context - The context to evaluate against
+ * @returns True if the condition matches
+ */
+export declare function evaluateCondition(condition: BundleCondition, context: Context): boolean;
+/**
+ * Evaluates all conditions against a context.
+ * All conditions must match (AND logic).
+ *
+ * @param conditions - Array of conditions
+ * @param context - The context to evaluate against
+ * @returns True if all conditions match (or if there are no conditions)
+ */
+export declare function evaluateConditions(conditions: BundleCondition[], context: Context): boolean;
+/**
+ * Creates an equality condition.
+ */
+export declare function eq(field: string, value: unknown): BundleCondition;
+/**
+ * Creates a not-equal condition.
+ */
+export declare function neq(field: string, value: unknown): BundleCondition;
+/**
+ * Creates an "in" condition.
+ */
+export declare function inValues(field: string, values: unknown[]): BundleCondition;
+/**
+ * Creates a "not in" condition.
+ */
+export declare function notIn(field: string, values: unknown[]): BundleCondition;
+/**
+ * Creates a greater-than condition.
+ */
+export declare function gt(field: string, value: number): BundleCondition;
+/**
+ * Creates a greater-than-or-equal condition.
+ */
+export declare function gte(field: string, value: number): BundleCondition;
+/**
+ * Creates a less-than condition.
+ */
+export declare function lt(field: string, value: number): BundleCondition;
+/**
+ * Creates a less-than-or-equal condition.
+ */
+export declare function lte(field: string, value: number): BundleCondition;
+/**
+ * Creates a string contains condition.
+ */
+export declare function contains(field: string, value: string): BundleCondition;
+/**
+ * Creates a string starts-with condition.
+ */
+export declare function startsWith(field: string, value: string): BundleCondition;
+/**
+ * Creates a string ends-with condition.
+ */
+export declare function endsWith(field: string, value: string): BundleCondition;
+/**
+ * Creates a regex match condition.
+ */
+export declare function regex(field: string, pattern: string): BundleCondition;
+/**
+ * Creates an exists condition.
+ */
+export declare function exists(field: string): BundleCondition;
+/**
+ * Creates a not-exists condition.
+ */
+export declare function notExists(field: string): BundleCondition;
+//# sourceMappingURL=conditions.d.ts.map

package/dist/resolution/conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../src/resolution/conditions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,eAAe,EAC1B,OAAO,EAAE,OAAO,GACf,OAAO,CAmFT;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,eAAe,EAAE,EAC7B,OAAO,EAAE,OAAO,GACf,OAAO,CAQT;AAgCD;;GAEG;AACH,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,eAAe,CAEjE;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,eAAe,CAElE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAE1E;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAEvE;AAED;;GAEG;AACH,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAEhE;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAEjE;AAED;;GAEG;AACH,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAEhE;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAEjE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAEtE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAExE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAEtE;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAErE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAErD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAExD"}