@coframe/sdk 1.1.56 → 1.1.60

package/dist/pkg/server.cjs.js

@@ -236,6 +236,8 @@ const ID_FIELDS = ['projectId', 'experimentId', 'userToken'];
 function invalidAssignmentIdField(body) {
     for (const field of ID_FIELDS) {
         const value = body[field];
+        if (field === 'experimentId' && value === undefined)
+            continue;
         if (typeof value !== 'string' || !value) {
             return { field, message: 'is required' };
         }
@@ -515,6 +517,25 @@ async function flushFeatureFlagEvents() {
     }
 }
 
+const IDLE_MS = 60000;
+let dispatcher;
+function runsOnNode() {
+    var _a;
+    return (typeof process !== 'undefined' &&
+        typeof ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node) === 'string' &&
+        !('EdgeRuntime' in globalThis));
+}
+function edgeDispatcher() {
+    if (!runsOnNode())
+        return Promise.resolve(undefined);
+    dispatcher !== null && dispatcher !== void 0 ? dispatcher : (dispatcher = import('undici').then(({ Agent }) => new Agent({ keepAliveTimeout: IDLE_MS, keepAliveMaxTimeout: IDLE_MS }), () => undefined));
+    return dispatcher;
+}
+async function edgeFetch(url, init = {}) {
+    const agent = await edgeDispatcher();
+    return fetch(url, agent ? { ...init, dispatcher: agent } : init);
+}
+
 const DEFAULT_ASSIGNMENT_TIMEOUT_MS = 1500;
 function normalizeRequestHeaders(headers) {
     const normalized = new Headers();
@@ -601,6 +622,13 @@ function effectiveVisitCount(headers) {
     const next = nextVisitCount(existing, lastVisitTime, Date.now());
     return Number.isSafeInteger(next) ? next : existing;
 }
+function isAssignedVariant(value) {
+    return (isRecord(value) &&
+        typeof value.id === 'string' &&
+        typeof value.slug === 'string' &&
+        typeof value.experimentId === 'string' &&
+        typeof value.iterationId === 'string');
+}
 function isExperimentAssignmentResult(value, experimentId) {
     if (!isRecord(value) || !isRecord(value.projectData))
         return false;
@@ -617,22 +645,32 @@ function isExperimentAssignmentResult(value, experimentId) {
         context.userVisitCount < 0) {
         return false;
     }
+    if (value.variants !== undefined && !Array.isArray(value.variants))
+        return false;
+    if (Array.isArray(value.variants) && !value.variants.every(isAssignedVariant))
+        return false;
+    if (experimentId === undefined) {
+        return value.variant === null && Array.isArray(value.variants);
+    }
     if (value.variant === null) {
         return typeof value.reason === 'string';
     }
-    if (!isRecord(value.variant))
-        return false;
-    return (typeof value.variant.id === 'string' &&
-        typeof value.variant.slug === 'string' &&
-        value.variant.experimentId === experimentId &&
-        typeof value.variant.iterationId === 'string');
+    return (isAssignedVariant(value.variant) &&
+        value.variant.experimentId === experimentId);
 }
 function generateUserToken() {
     return generateUUID();
 }
-async function getExperimentAssignment(options) {
+function getExperimentAssignment(options) {
+    var _a;
+    return fetchAssignment(options, (_a = options.experimentId) !== null && _a !== void 0 ? _a : '');
+}
+function getAssignments(options) {
+    return fetchAssignment(options, undefined);
+}
+async function fetchAssignment(options, experimentId) {
     var _a, _b, _c, _d, _e, _f;
-    const idProblem = invalidAssignmentIdField(options);
+    const idProblem = invalidAssignmentIdField({ ...options, experimentId });
     if (idProblem)
         throw new Error(`${idProblem.field} ${idProblem.message}`);
     if (options.timeoutMs !== undefined &&
@@ -658,7 +696,7 @@ async function getExperimentAssignment(options) {
             : clampHeader(incoming.get('referer'), ASSIGNMENT_FIELD_LIMITS.referrer);
         const requestBody = {
             projectId: options.projectId,
-            experimentId: options.experimentId,
+            ...(experimentId !== undefined ? { experimentId } : {}),
             userToken: options.userToken,
             context: {
                 currentUrl: options.currentUrl,
@@ -672,7 +710,7 @@ async function getExperimentAssignment(options) {
                 userVisitCount,
             },
         };
-        const response = await fetch(`${edgeBaseUrl(options.edgeUrl)}/api/v1/assignment`, {
+        const response = await edgeFetch(`${edgeBaseUrl(options.edgeUrl)}/api/v1/assignment`, {
             method: 'POST',
             headers: createAssignmentHeaders(incoming),
             signal: controller.signal,
@@ -681,7 +719,7 @@ async function getExperimentAssignment(options) {
         if (!response.ok)
             return undefined;
         const result = await response.json();
-        return isExperimentAssignmentResult(result, options.experimentId)
+        return isExperimentAssignmentResult(result, experimentId)
             ? result
             : undefined;
     }
@@ -697,7 +735,7 @@ async function requestFeatureFlags(options) {
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), (_a = options.requestTimeoutMs) !== null && _a !== void 0 ? _a : 3000);
     try {
-        const response = await fetch(`${edgeBaseUrl(options.edgeUrl)}/api/v1/flags?v=1`, {
+        const response = await edgeFetch(`${edgeBaseUrl(options.edgeUrl)}/api/v1/flags?v=1`, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
@@ -784,7 +822,7 @@ async function fetchAntiflickerFromEdge(projectId, currentUrl, referrer, userCon
         const config = encodeURIComponent(JSON.stringify(payload));
         const edgeUrl = new URL(`${"https://edge.cofra.me"}/cf.css`);
         edgeUrl.searchParams.set('config', config);
-        const response = await fetch(edgeUrl, {
+        const response = await edgeFetch(edgeUrl, {
             headers,
         });
         if (!response.ok)
@@ -836,6 +874,7 @@ async function getProjectData(options) {
 exports.evaluateFlags = evaluateFlags;
 exports.flushFeatureFlagEvents = flushFeatureFlagEvents;
 exports.generateUserToken = generateUserToken;
+exports.getAssignments = getAssignments;
 exports.getExperimentAssignment = getExperimentAssignment;
 exports.getFeatureFlag = getFeatureFlag;
 exports.getFeatureFlagPayload = getFeatureFlagPayload;

package/dist/pkg/server.esm.mjs

@@ -234,6 +234,8 @@ const ID_FIELDS = ['projectId', 'experimentId', 'userToken'];
 function invalidAssignmentIdField(body) {
     for (const field of ID_FIELDS) {
         const value = body[field];
+        if (field === 'experimentId' && value === undefined)
+            continue;
         if (typeof value !== 'string' || !value) {
             return { field, message: 'is required' };
         }
@@ -513,6 +515,25 @@ async function flushFeatureFlagEvents() {
     }
 }
 
+const IDLE_MS = 60000;
+let dispatcher;
+function runsOnNode() {
+    var _a;
+    return (typeof process !== 'undefined' &&
+        typeof ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node) === 'string' &&
+        !('EdgeRuntime' in globalThis));
+}
+function edgeDispatcher() {
+    if (!runsOnNode())
+        return Promise.resolve(undefined);
+    dispatcher !== null && dispatcher !== void 0 ? dispatcher : (dispatcher = import('undici').then(({ Agent }) => new Agent({ keepAliveTimeout: IDLE_MS, keepAliveMaxTimeout: IDLE_MS }), () => undefined));
+    return dispatcher;
+}
+async function edgeFetch(url, init = {}) {
+    const agent = await edgeDispatcher();
+    return fetch(url, agent ? { ...init, dispatcher: agent } : init);
+}
+
 const DEFAULT_ASSIGNMENT_TIMEOUT_MS = 1500;
 function normalizeRequestHeaders(headers) {
     const normalized = new Headers();
@@ -599,6 +620,13 @@ function effectiveVisitCount(headers) {
     const next = nextVisitCount(existing, lastVisitTime, Date.now());
     return Number.isSafeInteger(next) ? next : existing;
 }
+function isAssignedVariant(value) {
+    return (isRecord(value) &&
+        typeof value.id === 'string' &&
+        typeof value.slug === 'string' &&
+        typeof value.experimentId === 'string' &&
+        typeof value.iterationId === 'string');
+}
 function isExperimentAssignmentResult(value, experimentId) {
     if (!isRecord(value) || !isRecord(value.projectData))
         return false;
@@ -615,22 +643,32 @@ function isExperimentAssignmentResult(value, experimentId) {
         context.userVisitCount < 0) {
         return false;
     }
+    if (value.variants !== undefined && !Array.isArray(value.variants))
+        return false;
+    if (Array.isArray(value.variants) && !value.variants.every(isAssignedVariant))
+        return false;
+    if (experimentId === undefined) {
+        return value.variant === null && Array.isArray(value.variants);
+    }
     if (value.variant === null) {
         return typeof value.reason === 'string';
     }
-    if (!isRecord(value.variant))
-        return false;
-    return (typeof value.variant.id === 'string' &&
-        typeof value.variant.slug === 'string' &&
-        value.variant.experimentId === experimentId &&
-        typeof value.variant.iterationId === 'string');
+    return (isAssignedVariant(value.variant) &&
+        value.variant.experimentId === experimentId);
 }
 function generateUserToken() {
     return generateUUID();
 }
-async function getExperimentAssignment(options) {
+function getExperimentAssignment(options) {
+    var _a;
+    return fetchAssignment(options, (_a = options.experimentId) !== null && _a !== void 0 ? _a : '');
+}
+function getAssignments(options) {
+    return fetchAssignment(options, undefined);
+}
+async function fetchAssignment(options, experimentId) {
     var _a, _b, _c, _d, _e, _f;
-    const idProblem = invalidAssignmentIdField(options);
+    const idProblem = invalidAssignmentIdField({ ...options, experimentId });
     if (idProblem)
         throw new Error(`${idProblem.field} ${idProblem.message}`);
     if (options.timeoutMs !== undefined &&
@@ -656,7 +694,7 @@ async function getExperimentAssignment(options) {
             : clampHeader(incoming.get('referer'), ASSIGNMENT_FIELD_LIMITS.referrer);
         const requestBody = {
             projectId: options.projectId,
-            experimentId: options.experimentId,
+            ...(experimentId !== undefined ? { experimentId } : {}),
             userToken: options.userToken,
             context: {
                 currentUrl: options.currentUrl,
@@ -670,7 +708,7 @@ async function getExperimentAssignment(options) {
                 userVisitCount,
             },
         };
-        const response = await fetch(`${edgeBaseUrl(options.edgeUrl)}/api/v1/assignment`, {
+        const response = await edgeFetch(`${edgeBaseUrl(options.edgeUrl)}/api/v1/assignment`, {
             method: 'POST',
             headers: createAssignmentHeaders(incoming),
             signal: controller.signal,
@@ -679,7 +717,7 @@ async function getExperimentAssignment(options) {
         if (!response.ok)
             return undefined;
         const result = await response.json();
-        return isExperimentAssignmentResult(result, options.experimentId)
+        return isExperimentAssignmentResult(result, experimentId)
             ? result
             : undefined;
     }
@@ -695,7 +733,7 @@ async function requestFeatureFlags(options) {
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), (_a = options.requestTimeoutMs) !== null && _a !== void 0 ? _a : 3000);
     try {
-        const response = await fetch(`${edgeBaseUrl(options.edgeUrl)}/api/v1/flags?v=1`, {
+        const response = await edgeFetch(`${edgeBaseUrl(options.edgeUrl)}/api/v1/flags?v=1`, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
@@ -782,7 +820,7 @@ async function fetchAntiflickerFromEdge(projectId, currentUrl, referrer, userCon
         const config = encodeURIComponent(JSON.stringify(payload));
         const edgeUrl = new URL(`${"https://edge.cofra.me"}/cf.css`);
         edgeUrl.searchParams.set('config', config);
-        const response = await fetch(edgeUrl, {
+        const response = await edgeFetch(edgeUrl, {
             headers,
         });
         if (!response.ok)
@@ -831,4 +869,4 @@ async function getProjectData(options) {
     return null;
 }
 
-export { evaluateFlags, flushFeatureFlagEvents, generateUserToken, getExperimentAssignment, getFeatureFlag, getFeatureFlagPayload, getFeatureFlagResult, getProjectData, getRemoteConfig, isFeatureEnabled };
+export { evaluateFlags, flushFeatureFlagEvents, generateUserToken, getAssignments, getExperimentAssignment, getFeatureFlag, getFeatureFlagPayload, getFeatureFlagResult, getProjectData, getRemoteConfig, isFeatureEnabled };

package/dist/pkg/types/index.d.ts

@@ -68,6 +68,7 @@ type ModificationAddBanner = {
 type ModificationExecuteJs = {
     type: 'execute_js';
     js: string;
+    css?: string | string[];
 };
 type ModalTrigger = 'exit' | 'scroll' | 'enter' | 'timer';
 

package/dist/pkg/types/react.d.ts

@@ -88,6 +88,7 @@ type ModificationAddBanner = {
 type ModificationExecuteJs = {
     type: 'execute_js';
     js: string;
+    css?: string | string[];
 };
 type ModalTrigger = 'exit' | 'scroll' | 'enter' | 'timer';
 

package/dist/pkg/types/server.d.ts

@@ -68,6 +68,7 @@ type ModificationAddBanner = {
 type ModificationExecuteJs = {
     type: 'execute_js';
     js: string;
+    css?: string | string[];
 };
 type ModalTrigger = 'exit' | 'scroll' | 'enter' | 'timer';
 
@@ -268,7 +269,7 @@ interface AssignedVariant$1 {
     experimentId: string;
     iterationId: string;
 }
-type AssignmentMissReason$1 = 'experiment_not_found' | 'not_assigned' | 'unsupported_experiment_type' | 'preview_active';
+type AssignmentMissReason$1 = 'experiment_not_found' | 'not_assigned' | 'unsupported_experiment_type' | 'preview_active' | 'no_target_experiment';
 type AssignmentOutcome<Reason extends string = AssignmentMissReason$1> = {
     variant: AssignedVariant$1;
 } | {
@@ -276,6 +277,7 @@ type AssignmentOutcome<Reason extends string = AssignmentMissReason$1> = {
     reason: Reason;
 };
 type AssignmentResponse<Reason extends string = AssignmentMissReason$1> = AssignmentOutcome<Reason> & {
+    variants?: AssignedVariant$1[];
     projectData: AssignmentProjectData;
 };
 
@@ -307,6 +309,7 @@ interface FeatureFlagSelector {
 
 declare function flushFeatureFlagEvents(): Promise<void>;
 
+type AssignmentFetchOptions = Omit<GetExperimentAssignmentOptions, 'experimentId'>;
 type RequestHeaders = Headers | Record<string, string | string[] | undefined>;
 interface GetExperimentAssignmentOptions extends AssignmentContext {
     projectId: string;
@@ -335,7 +338,9 @@ interface CoframeProjectPayload {
     antiflickerCSS?: string;
 }
 declare function generateUserToken(): string;
+type GetAssignmentsOptions = AssignmentFetchOptions;
 declare function getExperimentAssignment(options: GetExperimentAssignmentOptions): Promise<ExperimentAssignmentResult | undefined>;
+declare function getAssignments(options: GetAssignmentsOptions): Promise<ExperimentAssignmentResult | undefined>;
 interface EvaluateFlagsOptions {
     apiKey: string;
     projectId: string;
@@ -365,5 +370,5 @@ declare const getRemoteConfig: typeof getFeatureFlagPayload;
 
 declare function getProjectData(options: GetProjectDataOptions): Promise<CoframeProjectPayload | null>;
 
-export { evaluateFlags, flushFeatureFlagEvents, generateUserToken, getExperimentAssignment, getFeatureFlag, getFeatureFlagPayload, getFeatureFlagResult, getProjectData, getRemoteConfig, isFeatureEnabled };
-export type { AssignedVariant, AssignmentMissReason, CoframeProjectPayload, EvaluateFlagsOptions, ExperimentAssignmentResult, FeatureFlagServerReadOptions, GetExperimentAssignmentOptions, GetProjectDataOptions, RequestHeaders };
+export { evaluateFlags, flushFeatureFlagEvents, generateUserToken, getAssignments, getExperimentAssignment, getFeatureFlag, getFeatureFlagPayload, getFeatureFlagResult, getProjectData, getRemoteConfig, isFeatureEnabled };
+export type { AssignedVariant, AssignmentMissReason, CoframeProjectPayload, EvaluateFlagsOptions, ExperimentAssignmentResult, FeatureFlagServerReadOptions, GetAssignmentsOptions, GetExperimentAssignmentOptions, GetProjectDataOptions, RequestHeaders };

package/package.json

@@ -1,37 +1,37 @@
 {
   "name": "@coframe/sdk",
-  "version": "1.1.56",
+  "version": "1.1.60",
   "description": "Coframe optimizes your website using generative AI to deliver maximum impact to your audience and allow your site to improve itself as you sleep. Learn more at coframe.com.",
   "main": "dist/pkg/cf.cjs.js",
   "module": "dist/pkg/cf.esm.mjs",
   "types": "dist/pkg/types/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/pkg/types/index.d.ts",
       "import": "./dist/pkg/cf.esm.mjs",
-      "require": "./dist/pkg/cf.cjs.js",
-      "types": "./dist/pkg/types/index.d.ts"
+      "require": "./dist/pkg/cf.cjs.js"
     },
     "./server": {
+      "types": "./dist/pkg/types/server.d.ts",
       "import": "./dist/pkg/server.esm.mjs",
-      "require": "./dist/pkg/server.cjs.js",
-      "types": "./dist/pkg/types/server.d.ts"
+      "require": "./dist/pkg/server.cjs.js"
     },
     "./feature-flags": {
+      "types": "./dist/pkg/types/feature-flags.d.ts",
       "import": "./dist/pkg/feature-flags.esm.mjs",
-      "require": "./dist/pkg/feature-flags.cjs.js",
-      "types": "./dist/pkg/types/feature-flags.d.ts"
+      "require": "./dist/pkg/feature-flags.cjs.js"
     },
     "./react": {
+      "types": "./dist/pkg/types/react.d.ts",
       "import": "./dist/pkg/react.esm.mjs",
-      "require": "./dist/pkg/react.cjs.js",
-      "types": "./dist/pkg/types/react.d.ts"
+      "require": "./dist/pkg/react.cjs.js"
     }
   },
   "files": [
     "dist/pkg"
   ],
   "scripts": {
-    "test:jest": "jest --maxWorkers=2",
+    "test:jest": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js --maxWorkers=2",
     "test:playwright": "npx playwright test --retries=5 --reporter=list",
     "test:package": "node ./tests/package/scripts/test-package.mjs",
     "test:browserstack:full": "jest --config jest.browserstack.config.js --suite=full",
@@ -100,7 +100,7 @@
   "dependencies": {
     "@rrweb/record": "2.1.0",
     "fflate": "0.8.3",
-    "typescript": "^6.0.2"
+    "undici": "7.30.1"
   },
   "devDependencies": {
     "@babel/core": "^7.29.6",
@@ -122,9 +122,7 @@
     "jest-expect-message": "^1.1.3",
     "jest-localstorage-mock": "^2.4.26",
     "jest-raw-loader": "^1.0.1",
-    "path-exists-cli": "^2.0.0",
     "playwright": "1.58.2",
-    "prettier": "^3.8.1",
     "rollup": "^4.60.0",
     "rollup-plugin-dts": "^6.4.1",
     "rollup-plugin-json": "^4.0.0",
@@ -132,9 +130,9 @@
     "rollup-plugin-string": "^3.0.0",
     "rollup-plugin-typescript2": "^0.36.0",
     "selenium-webdriver": "^4.41.0",
-    "terser": "^5.46.1",
     "ts-jest": "^29.4.6",
     "tslib": "^2.8.1",
+    "typescript": "^6.0.2",
     "ua-parser-js": "^2.0.10"
   },
   "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"