@daouy/loader-splits 1.0.67

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Chung Wu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# @daouy/loader-splits
+
+Library of utilities to instrument A/B tests and segmentation in daouy.

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+import type { Split } from '@daouy/loader-fetcher';
+
+/**
+ * Gets a more human-readable description of the variation
+ */
+export declare function describeVariation(splits: Split[], variation: Record<string, string>): Record<string, PickedVariationDescription>;
+
+export declare function describeVariationForKey(splits: Split[], key: string, value: string): PickedVariationDescription;
+
+declare interface ExternalIDsFilters {
+    projectIds?: string[];
+    customFilter?: (split: Split) => boolean;
+}
+
+export declare function getActiveVariation(opts: {
+    splits: Split[];
+    traits: Record<string, string | number | boolean>;
+    getKnownValue?: (key: string) => string | undefined;
+    updateKnownValue?: (key: string, value: string) => void;
+    getRandomValue?: (key: string) => number;
+    enableUnseededExperiments?: boolean;
+    useSeedBucketing?: boolean;
+    seedRange?: number;
+}): Record<string, string>;
+
+export declare function getExternalIds(splits: Split[], variation: Record<string, string>, filters?: ExternalIDsFilters): Record<string, string>;
+
+export declare const getSeededRandomFunction: (strSeed: string) => () => number;
+
+export declare const getSplitKey: (split: Split) => string;
+
+export declare interface PickedVariationDescription {
+    name: string;
+    description?: string;
+    pagesPaths: string[];
+    type: "original" | "override";
+    chosenValue: string;
+    externalIdGroup?: string;
+    externalIdValue?: string;
+}
+
+export { }

package/dist/index.esm.js

@@ -0,0 +1,236 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+
+// src/random.ts
+var getSeededRandomFunction = (strSeed) => {
+  function cyrb128(str) {
+    let h1 = 1779033703, h2 = 3144134277, h3 = 1013904242, h4 = 2773480762;
+    for (let i = 0, k; i < str.length; i++) {
+      k = str.charCodeAt(i);
+      h1 = h2 ^ Math.imul(h1 ^ k, 597399067);
+      h2 = h3 ^ Math.imul(h2 ^ k, 2869860233);
+      h3 = h4 ^ Math.imul(h3 ^ k, 951274213);
+      h4 = h1 ^ Math.imul(h4 ^ k, 2716044179);
+    }
+    h1 = Math.imul(h3 ^ h1 >>> 18, 597399067);
+    h2 = Math.imul(h4 ^ h2 >>> 22, 2869860233);
+    h3 = Math.imul(h1 ^ h3 >>> 17, 951274213);
+    h4 = Math.imul(h2 ^ h4 >>> 19, 2716044179);
+    return [
+      (h1 ^ h2 ^ h3 ^ h4) >>> 0,
+      (h2 ^ h1) >>> 0,
+      (h3 ^ h1) >>> 0,
+      (h4 ^ h1) >>> 0
+    ];
+  }
+  function sfc32(a, b, c, d) {
+    return function() {
+      a >>>= 0;
+      b >>>= 0;
+      c >>>= 0;
+      d >>>= 0;
+      let t = a + b | 0;
+      a = b ^ b >>> 9;
+      b = c + (c << 3) | 0;
+      c = c << 21 | c >>> 11;
+      d = d + 1 | 0;
+      t = t + d | 0;
+      c = c + t | 0;
+      return (t >>> 0) / 4294967296;
+    };
+  }
+  const seed = cyrb128(strSeed);
+  const rand = sfc32(seed[0], seed[1], seed[2], seed[3]);
+  return rand;
+};
+
+// src/variation.ts
+import jsonLogic from "json-logic-js";
+var isBrowser = typeof window !== "undefined" && window != null && typeof window.document !== "undefined";
+var DAOUY_SEED = "daouy_seed";
+var BUILTIN_TRAITS_UNKNOWN = {
+  pageUrl: "unknown"
+};
+var getBrowserBuiltinTraits = () => {
+  if (!isBrowser) {
+    return {};
+  }
+  return {
+    pageUrl: document.location.href
+  };
+};
+var getSplitKey = (split) => {
+  return `${split.type === "experiment" ? "exp." : "seg."}${split.id}`;
+};
+function getActiveVariation(opts) {
+  const { splits, getKnownValue, updateKnownValue } = opts;
+  const getRandomValue = (key) => {
+    var _a;
+    if (opts.getRandomValue) {
+      return opts.getRandomValue(key);
+    }
+    if (opts.traits[DAOUY_SEED]) {
+      const rand = getSeededRandomFunction(
+        ((_a = opts.traits[DAOUY_SEED]) != null ? _a : "") + key
+      );
+      return rand();
+    }
+    if (!opts.enableUnseededExperiments) {
+      return 0;
+    }
+    return Math.random();
+  };
+  const variation = {};
+  splits.forEach((split) => {
+    var _a;
+    const key = getSplitKey(split);
+    const knownVal = split.type === "experiment" ? getKnownValue == null ? void 0 : getKnownValue(key) : void 0;
+    if (knownVal) {
+      variation[key] = knownVal;
+      return;
+    }
+    const numSlices = split.slices.length;
+    let chosenSlice = void 0;
+    if (split.type === "experiment") {
+      if (opts.useSeedBucketing) {
+        const seed = opts.traits[DAOUY_SEED];
+        const buckets = [];
+        const totalBuckets = (_a = opts.seedRange) != null ? _a : 1;
+        let avaiableBuckets = totalBuckets;
+        for (let i = 0; i < numSlices; i++) {
+          const slice = split.slices[i];
+          const numBuckets = Math.min(
+            Math.floor(slice.prob * totalBuckets),
+            avaiableBuckets
+          );
+          for (let j = 0; j < numBuckets; j++) {
+            buckets.push(slice.id);
+          }
+          avaiableBuckets -= numBuckets;
+        }
+        if (buckets.length > 0) {
+          const shuffleRand = getSeededRandomFunction(split.id);
+          for (let i = 0; i < buckets.length; i++) {
+            const j = Math.floor(shuffleRand() * (i + 1));
+            [buckets[i], buckets[j]] = [buckets[j], buckets[i]];
+          }
+          const sliceIdx = +(seed != null ? seed : "0") % buckets.length;
+          chosenSlice = split.slices.find((s) => s.id === buckets[sliceIdx]);
+        } else {
+          chosenSlice = split.slices[numSlices - 1];
+        }
+      } else {
+        let p = getRandomValue(split.id);
+        chosenSlice = split.slices[numSlices - 1];
+        for (let i = 0; i < numSlices; i++) {
+          if (p - split.slices[i].prob <= 0) {
+            chosenSlice = split.slices[i];
+            break;
+          }
+          p -= split.slices[i].prob;
+        }
+      }
+    } else if (split.type === "segment") {
+      for (let i = 0; i < numSlices; i++) {
+        if (jsonLogic.apply(split.slices[i].cond, __spreadValues(__spreadValues(__spreadValues({
+          time: (/* @__PURE__ */ new Date()).toISOString()
+        }, BUILTIN_TRAITS_UNKNOWN), getBrowserBuiltinTraits()), opts.traits))) {
+          chosenSlice = split.slices[i];
+        }
+      }
+    }
+    if (chosenSlice) {
+      variation[key] = chosenSlice.id;
+      if (split.externalId && chosenSlice.externalId) {
+        variation[`ext.${split.externalId}`] = chosenSlice.externalId;
+      }
+      if (split.type === "experiment") {
+        updateKnownValue == null ? void 0 : updateKnownValue(key, chosenSlice.id);
+      }
+    }
+  });
+  return variation;
+}
+function getExternalIds(splits, variation, filters) {
+  const externalVariation = {};
+  function shouldIncludeSplit(split) {
+    if (!filters) {
+      return true;
+    }
+    if (filters.projectIds && !filters.projectIds.includes(split.projectId)) {
+      return false;
+    }
+    if (filters.customFilter && !filters.customFilter(split)) {
+      return false;
+    }
+    return true;
+  }
+  Object.keys(variation).forEach((variationKey) => {
+    const [, splitId] = variationKey.split(".");
+    const sliceId = variation[variationKey];
+    const split = splits.find(
+      (s) => s.id === splitId || s.externalId === splitId
+    );
+    if (split && split.externalId && shouldIncludeSplit(split)) {
+      const slice = split.slices.find((s) => s.id === sliceId || s.externalId === sliceId);
+      if (slice == null ? void 0 : slice.externalId) {
+        externalVariation[`${split.externalId}`] = slice.externalId;
+      }
+    }
+  });
+  return externalVariation;
+}
+function describeVariationForKey(splits, key, value) {
+  const [, splitId] = key.split(".");
+  const split = splits.find(
+    (s) => s.id === splitId || s.externalId === splitId
+  );
+  if (!split) {
+    throw new Error(`Split not found for key "${key}"`);
+  }
+  const sliceIndex = split.slices.findIndex(
+    (s) => s.id === value || s.externalId === value
+  );
+  if (sliceIndex === -1) {
+    throw new Error(`Invalid split value "${value}" for key "${key}"`);
+  }
+  return {
+    name: split.name,
+    description: split.description,
+    pagesPaths: split.pagesPaths,
+    type: sliceIndex === 0 ? "original" : "override",
+    chosenValue: value,
+    externalIdGroup: split.externalId,
+    externalIdValue: sliceIndex >= 0 && split.slices[sliceIndex].externalId ? split.slices[sliceIndex].externalId : void 0
+  };
+}
+function describeVariation(splits, variation) {
+  return Object.fromEntries(
+    Object.entries(variation).map(([key, value]) => {
+      return [key, describeVariationForKey(splits, key, value)];
+    })
+  );
+}
+export {
+  describeVariation,
+  describeVariationForKey,
+  getActiveVariation,
+  getExternalIds,
+  getSeededRandomFunction,
+  getSplitKey
+};
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/random.ts", "../src/variation.ts"],
+  "sourcesContent": ["export const getSeededRandomFunction = (strSeed: string) => {\n  // https://stackoverflow.com/questions/521295/seeding-the-random-number-generator-in-javascript\n  function cyrb128(str: string) {\n    let h1 = 1779033703,\n      h2 = 3144134277,\n      h3 = 1013904242,\n      h4 = 2773480762;\n    for (let i = 0, k; i < str.length; i++) {\n      k = str.charCodeAt(i);\n      h1 = h2 ^ Math.imul(h1 ^ k, 597399067);\n      h2 = h3 ^ Math.imul(h2 ^ k, 2869860233);\n      h3 = h4 ^ Math.imul(h3 ^ k, 951274213);\n      h4 = h1 ^ Math.imul(h4 ^ k, 2716044179);\n    }\n    h1 = Math.imul(h3 ^ (h1 >>> 18), 597399067);\n    h2 = Math.imul(h4 ^ (h2 >>> 22), 2869860233);\n    h3 = Math.imul(h1 ^ (h3 >>> 17), 951274213);\n    h4 = Math.imul(h2 ^ (h4 >>> 19), 2716044179);\n    return [\n      (h1 ^ h2 ^ h3 ^ h4) >>> 0,\n      (h2 ^ h1) >>> 0,\n      (h3 ^ h1) >>> 0,\n      (h4 ^ h1) >>> 0,\n    ];\n  }\n  function sfc32(a: number, b: number, c: number, d: number) {\n    return function () {\n      a >>>= 0;\n      b >>>= 0;\n      c >>>= 0;\n      d >>>= 0;\n      let t = (a + b) | 0;\n      a = b ^ (b >>> 9);\n      b = (c + (c << 3)) | 0;\n      c = (c << 21) | (c >>> 11);\n      d = (d + 1) | 0;\n      t = (t + d) | 0;\n      c = (c + t) | 0;\n      return (t >>> 0) / 4294967296;\n    };\n  }\n  const seed = cyrb128(strSeed);\n  const rand = sfc32(seed[0], seed[1], seed[2], seed[3]);\n  return rand;\n};\n", "import type {\n  ExperimentSlice,\n  SegmentSlice,\n  Split,\n} from \"@daouy/loader-fetcher\";\nimport jsonLogic from \"json-logic-js\";\nimport { getSeededRandomFunction } from \"./random\";\n\nconst isBrowser =\n  typeof window !== \"undefined\" &&\n  window != null &&\n  typeof window.document !== \"undefined\";\n\nconst DAOUY_SEED = \"daouy_seed\";\n\nconst BUILTIN_TRAITS_UNKNOWN = {\n  pageUrl: \"unknown\",\n};\n\nconst getBrowserBuiltinTraits = () => {\n  if (!isBrowser) {\n    return {};\n  }\n  return {\n    pageUrl: document.location.href,\n  };\n};\n\nexport const getSplitKey = (split: Split) => {\n  return `${split.type === \"experiment\" ? \"exp.\" : \"seg.\"}${split.id}`;\n};\n\nexport function getActiveVariation(opts: {\n  splits: Split[];\n  traits: Record<string, string | number | boolean>;\n  getKnownValue?: (key: string) => string | undefined;\n  updateKnownValue?: (key: string, value: string) => void;\n  getRandomValue?: (key: string) => number;\n  enableUnseededExperiments?: boolean;\n  useSeedBucketing?: boolean;\n  seedRange?: number;\n}) {\n  const { splits, getKnownValue, updateKnownValue } = opts;\n  const getRandomValue = (key: string) => {\n    if (opts.getRandomValue) {\n      return opts.getRandomValue(key);\n    }\n\n    if (opts.traits[DAOUY_SEED]) {\n      const rand = getSeededRandomFunction(\n        (opts.traits[DAOUY_SEED] ?? \"\") + key\n      );\n      return rand();\n    }\n\n    // If we don't have a seed we won't be able to get a consistent variation\n    // in SSR, so we just return 0. Unless if expressly enabled.\n    if (!opts.enableUnseededExperiments) {\n      return 0;\n    }\n\n    return Math.random();\n  };\n  const variation: Record<string, string> = {};\n  splits.forEach((split) => {\n    const key = getSplitKey(split);\n    // We will only get the known value for experiments, for segments we will always evaluate the traits\n    const knownVal =\n      split.type === \"experiment\" ? getKnownValue?.(key) : undefined;\n    if (knownVal) {\n      variation[key] = knownVal;\n      return;\n    }\n    const numSlices = split.slices.length;\n    let chosenSlice = undefined;\n    if (split.type === \"experiment\") {\n      /**\n       * If useSeedBucketing is enabled, we will use the seed to bucket the user\n       * into a slice. Otherwise, we will use the random value to bucket the user\n       * into a slice.\n       *\n       * By using seed bucketing, we ensure the number of seeds that each slice gets,\n       * is proportional to the slice's probability.\n       */\n      if (opts.useSeedBucketing) {\n        const seed = opts.traits[DAOUY_SEED];\n        const buckets: string[] = [];\n        const totalBuckets = opts.seedRange ?? 1;\n        let avaiableBuckets = totalBuckets;\n        for (let i = 0; i < numSlices; i++) {\n          const slice = split.slices[i];\n          const numBuckets = Math.min(\n            Math.floor(slice.prob * totalBuckets),\n            avaiableBuckets\n          );\n          for (let j = 0; j < numBuckets; j++) {\n            buckets.push(slice.id);\n          }\n          avaiableBuckets -= numBuckets;\n        }\n        if (buckets.length > 0) {\n          // We need to stable shuffle the buckets to ensure that the order of the\n          // buckets is deterministic.\n          const shuffleRand = getSeededRandomFunction(split.id);\n          for (let i = 0; i < buckets.length; i++) {\n            const j = Math.floor(shuffleRand() * (i + 1));\n            [buckets[i], buckets[j]] = [buckets[j], buckets[i]];\n          }\n          // We use the seed to bucket the user into a slice.\n          const sliceIdx = +(seed ?? \"0\") % buckets.length;\n          chosenSlice = split.slices.find((s) => s.id === buckets[sliceIdx]);\n        } else {\n          chosenSlice = split.slices[numSlices - 1];\n        }\n      } else {\n        let p = getRandomValue(split.id);\n        chosenSlice = split.slices[numSlices - 1];\n        for (let i = 0; i < numSlices; i++) {\n          if (p - split.slices[i].prob <= 0) {\n            chosenSlice = split.slices[i];\n            break;\n          }\n          p -= split.slices[i].prob;\n        }\n      }\n    } else if (split.type === \"segment\") {\n      for (let i = 0; i < numSlices; i++) {\n        if (\n          jsonLogic.apply(split.slices[i].cond, {\n            time: new Date().toISOString(),\n            ...BUILTIN_TRAITS_UNKNOWN,\n            ...getBrowserBuiltinTraits(),\n            ...opts.traits,\n          })\n        ) {\n          chosenSlice = split.slices[i];\n        }\n      }\n    }\n\n    if (chosenSlice) {\n      variation[key] = chosenSlice.id;\n      if (split.externalId && chosenSlice.externalId) {\n        variation[`ext.${split.externalId}`] = chosenSlice.externalId;\n      }\n      if (split.type === \"experiment\") {\n        updateKnownValue?.(key, chosenSlice.id);\n      }\n    }\n  });\n\n  return variation;\n}\n\ninterface ExternalIDsFilters {\n  projectIds?: string[];\n  customFilter?: (split: Split) => boolean;\n}\n\nexport function getExternalIds(\n  splits: Split[],\n  variation: Record<string, string>,\n  filters?: ExternalIDsFilters\n) {\n  const externalVariation: Record<string, string> = {};\n\n  function shouldIncludeSplit(split: Split) {\n    if (!filters) {\n      return true;\n    }\n    if (filters.projectIds && !filters.projectIds.includes(split.projectId)) {\n      return false;\n    }\n    if (filters.customFilter && !filters.customFilter(split)) {\n      return false;\n    }\n    return true;\n  }\n\n  Object.keys(variation).forEach((variationKey) => {\n    const [, splitId] = variationKey.split(\".\");\n    const sliceId = variation[variationKey];\n    const split = splits.find(\n      (s) => s.id === splitId || s.externalId === splitId\n    );\n    if (split && split.externalId && shouldIncludeSplit(split)) {\n      const slice = (\n        split.slices as Array<ExperimentSlice | SegmentSlice>\n      ).find((s) => s.id === sliceId || s.externalId === sliceId);\n      if (slice?.externalId) {\n        // Save variation without ext prefix\n        externalVariation[`${split.externalId}`] = slice.externalId;\n      }\n    }\n  });\n  return externalVariation;\n}\n\nexport interface PickedVariationDescription {\n  name: string;\n  description?: string;\n  pagesPaths: string[];\n  type: \"original\" | \"override\";\n  chosenValue: string;\n  externalIdGroup?: string;\n  externalIdValue?: string;\n}\n\nexport function describeVariationForKey(\n  splits: Split[],\n  key: string,\n  value: string\n): PickedVariationDescription {\n  const [, splitId] = key.split(\".\");\n  const split = splits.find(\n    (s) => s.id === splitId || s.externalId === splitId\n  );\n\n  if (!split) {\n    throw new Error(`Split not found for key \"${key}\"`);\n  }\n\n  const sliceIndex = split.slices.findIndex(\n    (s) => s.id === value || s.externalId === value\n  );\n\n  if (sliceIndex === -1) {\n    throw new Error(`Invalid split value \"${value}\" for key \"${key}\"`);\n  }\n\n  return {\n    name: split.name,\n    description: split.description,\n    pagesPaths: split.pagesPaths,\n    type: sliceIndex === 0 ? \"original\" : \"override\",\n    chosenValue: value,\n    externalIdGroup: split.externalId,\n    externalIdValue:\n      sliceIndex >= 0 && split.slices[sliceIndex].externalId\n        ? split.slices[sliceIndex].externalId\n        : undefined,\n  };\n}\n\n/**\n * Gets a more human-readable description of the variation\n */\nexport function describeVariation(\n  splits: Split[],\n  variation: Record<string, string>\n): Record<string, PickedVariationDescription> {\n  return Object.fromEntries(\n    Object.entries(variation).map(([key, value]) => {\n      return [key, describeVariationForKey(splits, key, value)];\n    })\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/index.js

@@ -0,0 +1,266 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  describeVariation: () => describeVariation,
+  describeVariationForKey: () => describeVariationForKey,
+  getActiveVariation: () => getActiveVariation,
+  getExternalIds: () => getExternalIds,
+  getSeededRandomFunction: () => getSeededRandomFunction,
+  getSplitKey: () => getSplitKey
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/random.ts
+var getSeededRandomFunction = (strSeed) => {
+  function cyrb128(str) {
+    let h1 = 1779033703, h2 = 3144134277, h3 = 1013904242, h4 = 2773480762;
+    for (let i = 0, k; i < str.length; i++) {
+      k = str.charCodeAt(i);
+      h1 = h2 ^ Math.imul(h1 ^ k, 597399067);
+      h2 = h3 ^ Math.imul(h2 ^ k, 2869860233);
+      h3 = h4 ^ Math.imul(h3 ^ k, 951274213);
+      h4 = h1 ^ Math.imul(h4 ^ k, 2716044179);
+    }
+    h1 = Math.imul(h3 ^ h1 >>> 18, 597399067);
+    h2 = Math.imul(h4 ^ h2 >>> 22, 2869860233);
+    h3 = Math.imul(h1 ^ h3 >>> 17, 951274213);
+    h4 = Math.imul(h2 ^ h4 >>> 19, 2716044179);
+    return [
+      (h1 ^ h2 ^ h3 ^ h4) >>> 0,
+      (h2 ^ h1) >>> 0,
+      (h3 ^ h1) >>> 0,
+      (h4 ^ h1) >>> 0
+    ];
+  }
+  function sfc32(a, b, c, d) {
+    return function() {
+      a >>>= 0;
+      b >>>= 0;
+      c >>>= 0;
+      d >>>= 0;
+      let t = a + b | 0;
+      a = b ^ b >>> 9;
+      b = c + (c << 3) | 0;
+      c = c << 21 | c >>> 11;
+      d = d + 1 | 0;
+      t = t + d | 0;
+      c = c + t | 0;
+      return (t >>> 0) / 4294967296;
+    };
+  }
+  const seed = cyrb128(strSeed);
+  const rand = sfc32(seed[0], seed[1], seed[2], seed[3]);
+  return rand;
+};
+
+// src/variation.ts
+var import_json_logic_js = __toESM(require("json-logic-js"));
+var isBrowser = typeof window !== "undefined" && window != null && typeof window.document !== "undefined";
+var DAOUY_SEED = "daouy_seed";
+var BUILTIN_TRAITS_UNKNOWN = {
+  pageUrl: "unknown"
+};
+var getBrowserBuiltinTraits = () => {
+  if (!isBrowser) {
+    return {};
+  }
+  return {
+    pageUrl: document.location.href
+  };
+};
+var getSplitKey = (split) => {
+  return `${split.type === "experiment" ? "exp." : "seg."}${split.id}`;
+};
+function getActiveVariation(opts) {
+  const { splits, getKnownValue, updateKnownValue } = opts;
+  const getRandomValue = (key) => {
+    var _a;
+    if (opts.getRandomValue) {
+      return opts.getRandomValue(key);
+    }
+    if (opts.traits[DAOUY_SEED]) {
+      const rand = getSeededRandomFunction(
+        ((_a = opts.traits[DAOUY_SEED]) != null ? _a : "") + key
+      );
+      return rand();
+    }
+    if (!opts.enableUnseededExperiments) {
+      return 0;
+    }
+    return Math.random();
+  };
+  const variation = {};
+  splits.forEach((split) => {
+    var _a;
+    const key = getSplitKey(split);
+    const knownVal = split.type === "experiment" ? getKnownValue == null ? void 0 : getKnownValue(key) : void 0;
+    if (knownVal) {
+      variation[key] = knownVal;
+      return;
+    }
+    const numSlices = split.slices.length;
+    let chosenSlice = void 0;
+    if (split.type === "experiment") {
+      if (opts.useSeedBucketing) {
+        const seed = opts.traits[DAOUY_SEED];
+        const buckets = [];
+        const totalBuckets = (_a = opts.seedRange) != null ? _a : 1;
+        let avaiableBuckets = totalBuckets;
+        for (let i = 0; i < numSlices; i++) {
+          const slice = split.slices[i];
+          const numBuckets = Math.min(
+            Math.floor(slice.prob * totalBuckets),
+            avaiableBuckets
+          );
+          for (let j = 0; j < numBuckets; j++) {
+            buckets.push(slice.id);
+          }
+          avaiableBuckets -= numBuckets;
+        }
+        if (buckets.length > 0) {
+          const shuffleRand = getSeededRandomFunction(split.id);
+          for (let i = 0; i < buckets.length; i++) {
+            const j = Math.floor(shuffleRand() * (i + 1));
+            [buckets[i], buckets[j]] = [buckets[j], buckets[i]];
+          }
+          const sliceIdx = +(seed != null ? seed : "0") % buckets.length;
+          chosenSlice = split.slices.find((s) => s.id === buckets[sliceIdx]);
+        } else {
+          chosenSlice = split.slices[numSlices - 1];
+        }
+      } else {
+        let p = getRandomValue(split.id);
+        chosenSlice = split.slices[numSlices - 1];
+        for (let i = 0; i < numSlices; i++) {
+          if (p - split.slices[i].prob <= 0) {
+            chosenSlice = split.slices[i];
+            break;
+          }
+          p -= split.slices[i].prob;
+        }
+      }
+    } else if (split.type === "segment") {
+      for (let i = 0; i < numSlices; i++) {
+        if (import_json_logic_js.default.apply(split.slices[i].cond, __spreadValues(__spreadValues(__spreadValues({
+          time: (/* @__PURE__ */ new Date()).toISOString()
+        }, BUILTIN_TRAITS_UNKNOWN), getBrowserBuiltinTraits()), opts.traits))) {
+          chosenSlice = split.slices[i];
+        }
+      }
+    }
+    if (chosenSlice) {
+      variation[key] = chosenSlice.id;
+      if (split.externalId && chosenSlice.externalId) {
+        variation[`ext.${split.externalId}`] = chosenSlice.externalId;
+      }
+      if (split.type === "experiment") {
+        updateKnownValue == null ? void 0 : updateKnownValue(key, chosenSlice.id);
+      }
+    }
+  });
+  return variation;
+}
+function getExternalIds(splits, variation, filters) {
+  const externalVariation = {};
+  function shouldIncludeSplit(split) {
+    if (!filters) {
+      return true;
+    }
+    if (filters.projectIds && !filters.projectIds.includes(split.projectId)) {
+      return false;
+    }
+    if (filters.customFilter && !filters.customFilter(split)) {
+      return false;
+    }
+    return true;
+  }
+  Object.keys(variation).forEach((variationKey) => {
+    const [, splitId] = variationKey.split(".");
+    const sliceId = variation[variationKey];
+    const split = splits.find(
+      (s) => s.id === splitId || s.externalId === splitId
+    );
+    if (split && split.externalId && shouldIncludeSplit(split)) {
+      const slice = split.slices.find((s) => s.id === sliceId || s.externalId === sliceId);
+      if (slice == null ? void 0 : slice.externalId) {
+        externalVariation[`${split.externalId}`] = slice.externalId;
+      }
+    }
+  });
+  return externalVariation;
+}
+function describeVariationForKey(splits, key, value) {
+  const [, splitId] = key.split(".");
+  const split = splits.find(
+    (s) => s.id === splitId || s.externalId === splitId
+  );
+  if (!split) {
+    throw new Error(`Split not found for key "${key}"`);
+  }
+  const sliceIndex = split.slices.findIndex(
+    (s) => s.id === value || s.externalId === value
+  );
+  if (sliceIndex === -1) {
+    throw new Error(`Invalid split value "${value}" for key "${key}"`);
+  }
+  return {
+    name: split.name,
+    description: split.description,
+    pagesPaths: split.pagesPaths,
+    type: sliceIndex === 0 ? "original" : "override",
+    chosenValue: value,
+    externalIdGroup: split.externalId,
+    externalIdValue: sliceIndex >= 0 && split.slices[sliceIndex].externalId ? split.slices[sliceIndex].externalId : void 0
+  };
+}
+function describeVariation(splits, variation) {
+  return Object.fromEntries(
+    Object.entries(variation).map(([key, value]) => {
+      return [key, describeVariationForKey(splits, key, value)];
+    })
+  );
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../src/random.ts", "../src/variation.ts"],
+  "sourcesContent": ["export { getSeededRandomFunction } from \"./random\";\nexport * from \"./variation\";\n", "export const getSeededRandomFunction = (strSeed: string) => {\n  // https://stackoverflow.com/questions/521295/seeding-the-random-number-generator-in-javascript\n  function cyrb128(str: string) {\n    let h1 = 1779033703,\n      h2 = 3144134277,\n      h3 = 1013904242,\n      h4 = 2773480762;\n    for (let i = 0, k; i < str.length; i++) {\n      k = str.charCodeAt(i);\n      h1 = h2 ^ Math.imul(h1 ^ k, 597399067);\n      h2 = h3 ^ Math.imul(h2 ^ k, 2869860233);\n      h3 = h4 ^ Math.imul(h3 ^ k, 951274213);\n      h4 = h1 ^ Math.imul(h4 ^ k, 2716044179);\n    }\n    h1 = Math.imul(h3 ^ (h1 >>> 18), 597399067);\n    h2 = Math.imul(h4 ^ (h2 >>> 22), 2869860233);\n    h3 = Math.imul(h1 ^ (h3 >>> 17), 951274213);\n    h4 = Math.imul(h2 ^ (h4 >>> 19), 2716044179);\n    return [\n      (h1 ^ h2 ^ h3 ^ h4) >>> 0,\n      (h2 ^ h1) >>> 0,\n      (h3 ^ h1) >>> 0,\n      (h4 ^ h1) >>> 0,\n    ];\n  }\n  function sfc32(a: number, b: number, c: number, d: number) {\n    return function () {\n      a >>>= 0;\n      b >>>= 0;\n      c >>>= 0;\n      d >>>= 0;\n      let t = (a + b) | 0;\n      a = b ^ (b >>> 9);\n      b = (c + (c << 3)) | 0;\n      c = (c << 21) | (c >>> 11);\n      d = (d + 1) | 0;\n      t = (t + d) | 0;\n      c = (c + t) | 0;\n      return (t >>> 0) / 4294967296;\n    };\n  }\n  const seed = cyrb128(strSeed);\n  const rand = sfc32(seed[0], seed[1], seed[2], seed[3]);\n  return rand;\n};\n", "import type {\n  ExperimentSlice,\n  SegmentSlice,\n  Split,\n} from \"@daouy/loader-fetcher\";\nimport jsonLogic from \"json-logic-js\";\nimport { getSeededRandomFunction } from \"./random\";\n\nconst isBrowser =\n  typeof window !== \"undefined\" &&\n  window != null &&\n  typeof window.document !== \"undefined\";\n\nconst DAOUY_SEED = \"daouy_seed\";\n\nconst BUILTIN_TRAITS_UNKNOWN = {\n  pageUrl: \"unknown\",\n};\n\nconst getBrowserBuiltinTraits = () => {\n  if (!isBrowser) {\n    return {};\n  }\n  return {\n    pageUrl: document.location.href,\n  };\n};\n\nexport const getSplitKey = (split: Split) => {\n  return `${split.type === \"experiment\" ? \"exp.\" : \"seg.\"}${split.id}`;\n};\n\nexport function getActiveVariation(opts: {\n  splits: Split[];\n  traits: Record<string, string | number | boolean>;\n  getKnownValue?: (key: string) => string | undefined;\n  updateKnownValue?: (key: string, value: string) => void;\n  getRandomValue?: (key: string) => number;\n  enableUnseededExperiments?: boolean;\n  useSeedBucketing?: boolean;\n  seedRange?: number;\n}) {\n  const { splits, getKnownValue, updateKnownValue } = opts;\n  const getRandomValue = (key: string) => {\n    if (opts.getRandomValue) {\n      return opts.getRandomValue(key);\n    }\n\n    if (opts.traits[DAOUY_SEED]) {\n      const rand = getSeededRandomFunction(\n        (opts.traits[DAOUY_SEED] ?? \"\") + key\n      );\n      return rand();\n    }\n\n    // If we don't have a seed we won't be able to get a consistent variation\n    // in SSR, so we just return 0. Unless if expressly enabled.\n    if (!opts.enableUnseededExperiments) {\n      return 0;\n    }\n\n    return Math.random();\n  };\n  const variation: Record<string, string> = {};\n  splits.forEach((split) => {\n    const key = getSplitKey(split);\n    // We will only get the known value for experiments, for segments we will always evaluate the traits\n    const knownVal =\n      split.type === \"experiment\" ? getKnownValue?.(key) : undefined;\n    if (knownVal) {\n      variation[key] = knownVal;\n      return;\n    }\n    const numSlices = split.slices.length;\n    let chosenSlice = undefined;\n    if (split.type === \"experiment\") {\n      /**\n       * If useSeedBucketing is enabled, we will use the seed to bucket the user\n       * into a slice. Otherwise, we will use the random value to bucket the user\n       * into a slice.\n       *\n       * By using seed bucketing, we ensure the number of seeds that each slice gets,\n       * is proportional to the slice's probability.\n       */\n      if (opts.useSeedBucketing) {\n        const seed = opts.traits[DAOUY_SEED];\n        const buckets: string[] = [];\n        const totalBuckets = opts.seedRange ?? 1;\n        let avaiableBuckets = totalBuckets;\n        for (let i = 0; i < numSlices; i++) {\n          const slice = split.slices[i];\n          const numBuckets = Math.min(\n            Math.floor(slice.prob * totalBuckets),\n            avaiableBuckets\n          );\n          for (let j = 0; j < numBuckets; j++) {\n            buckets.push(slice.id);\n          }\n          avaiableBuckets -= numBuckets;\n        }\n        if (buckets.length > 0) {\n          // We need to stable shuffle the buckets to ensure that the order of the\n          // buckets is deterministic.\n          const shuffleRand = getSeededRandomFunction(split.id);\n          for (let i = 0; i < buckets.length; i++) {\n            const j = Math.floor(shuffleRand() * (i + 1));\n            [buckets[i], buckets[j]] = [buckets[j], buckets[i]];\n          }\n          // We use the seed to bucket the user into a slice.\n          const sliceIdx = +(seed ?? \"0\") % buckets.length;\n          chosenSlice = split.slices.find((s) => s.id === buckets[sliceIdx]);\n        } else {\n          chosenSlice = split.slices[numSlices - 1];\n        }\n      } else {\n        let p = getRandomValue(split.id);\n        chosenSlice = split.slices[numSlices - 1];\n        for (let i = 0; i < numSlices; i++) {\n          if (p - split.slices[i].prob <= 0) {\n            chosenSlice = split.slices[i];\n            break;\n          }\n          p -= split.slices[i].prob;\n        }\n      }\n    } else if (split.type === \"segment\") {\n      for (let i = 0; i < numSlices; i++) {\n        if (\n          jsonLogic.apply(split.slices[i].cond, {\n            time: new Date().toISOString(),\n            ...BUILTIN_TRAITS_UNKNOWN,\n            ...getBrowserBuiltinTraits(),\n            ...opts.traits,\n          })\n        ) {\n          chosenSlice = split.slices[i];\n        }\n      }\n    }\n\n    if (chosenSlice) {\n      variation[key] = chosenSlice.id;\n      if (split.externalId && chosenSlice.externalId) {\n        variation[`ext.${split.externalId}`] = chosenSlice.externalId;\n      }\n      if (split.type === \"experiment\") {\n        updateKnownValue?.(key, chosenSlice.id);\n      }\n    }\n  });\n\n  return variation;\n}\n\ninterface ExternalIDsFilters {\n  projectIds?: string[];\n  customFilter?: (split: Split) => boolean;\n}\n\nexport function getExternalIds(\n  splits: Split[],\n  variation: Record<string, string>,\n  filters?: ExternalIDsFilters\n) {\n  const externalVariation: Record<string, string> = {};\n\n  function shouldIncludeSplit(split: Split) {\n    if (!filters) {\n      return true;\n    }\n    if (filters.projectIds && !filters.projectIds.includes(split.projectId)) {\n      return false;\n    }\n    if (filters.customFilter && !filters.customFilter(split)) {\n      return false;\n    }\n    return true;\n  }\n\n  Object.keys(variation).forEach((variationKey) => {\n    const [, splitId] = variationKey.split(\".\");\n    const sliceId = variation[variationKey];\n    const split = splits.find(\n      (s) => s.id === splitId || s.externalId === splitId\n    );\n    if (split && split.externalId && shouldIncludeSplit(split)) {\n      const slice = (\n        split.slices as Array<ExperimentSlice | SegmentSlice>\n      ).find((s) => s.id === sliceId || s.externalId === sliceId);\n      if (slice?.externalId) {\n        // Save variation without ext prefix\n        externalVariation[`${split.externalId}`] = slice.externalId;\n      }\n    }\n  });\n  return externalVariation;\n}\n\nexport interface PickedVariationDescription {\n  name: string;\n  description?: string;\n  pagesPaths: string[];\n  type: \"original\" | \"override\";\n  chosenValue: string;\n  externalIdGroup?: string;\n  externalIdValue?: string;\n}\n\nexport function describeVariationForKey(\n  splits: Split[],\n  key: string,\n  value: string\n): PickedVariationDescription {\n  const [, splitId] = key.split(\".\");\n  const split = splits.find(\n    (s) => s.id === splitId || s.externalId === splitId\n  );\n\n  if (!split) {\n    throw new Error(`Split not found for key \"${key}\"`);\n  }\n\n  const sliceIndex = split.slices.findIndex(\n    (s) => s.id === value || s.externalId === value\n  );\n\n  if (sliceIndex === -1) {\n    throw new Error(`Invalid split value \"${value}\" for key \"${key}\"`);\n  }\n\n  return {\n    name: split.name,\n    description: split.description,\n    pagesPaths: split.pagesPaths,\n    type: sliceIndex === 0 ? \"original\" : \"override\",\n    chosenValue: value,\n    externalIdGroup: split.externalId,\n    externalIdValue:\n      sliceIndex >= 0 && split.slices[sliceIndex].externalId\n        ? split.slices[sliceIndex].externalId\n        : undefined,\n  };\n}\n\n/**\n * Gets a more human-readable description of the variation\n */\nexport function describeVariation(\n  splits: Split[],\n  variation: Record<string, string>\n): Record<string, PickedVariationDescription> {\n  return Object.fromEntries(\n    Object.entries(variation).map(([key, value]) => {\n      return [key, describeVariationForKey(splits, key, value)];\n    })\n  );\n}\n"],
+  "mappings": "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",
+  "names": ["jsonLogic"]
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "version": "1.0.67",
+  "license": "MIT",
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "module": "./dist/index.esm.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=10"
+  },
+  "scripts": {
+    "build": "yarn build:types && yarn build:index",
+    "build:types": "yarn tsc",
+    "build:index": "node ../../build.mjs ./src/index.ts",
+    "yalcp": "yalc publish --push",
+    "test": "TEST_CWD=`pwd` yarn --cwd=../.. test --passWithNoTests",
+    "coverage": "TEST_CWD=`pwd` yarn --cwd=../.. test --coverage --passWithNoTests",
+    "lint": "eslint",
+    "prepublishOnly": "npm run build",
+    "postpublish": "bash ../../scripts/publish-api-doc-model.sh",
+    "size": "size-limit",
+    "analyze": "size-limit --why"
+  },
+  "name": "@daouy/loader-splits",
+  "author": "Chung Wu",
+  "size-limit": [
+    {
+      "path": "./dist/index.js",
+      "limit": "10 KB"
+    }
+  ],
+  "devDependencies": {
+    "@daouy/loader-fetcher": "^1.0.58",
+    "@types/json-logic-js": "^1.2.1",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "json-logic-js": "^2.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "fa53f7d79f0e26d8b061102fda0c06788da6f8a7"
+}