@se-studio/ab-testing 1.0.73 → 1.0.74

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @se-studio/ab-testing
 
+## 1.0.74
+
+### Patch Changes
+
+- Version bump: patch for changed packages
+
 ## 1.0.73
 
 ### Patch Changes

package/dist/codegen/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/codegen/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/codegen/cli.ts"],"names":[],"mappings":""}

package/dist/codegen/cli.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+/** biome-ignore-all lint/suspicious/noConsole: CLI script */
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { transformPageTest } from '../webhook/handler';
+import { buildStaticTestsByPath, generateAbTestsFileContent } from './generator';
+async function loadEnvFile(path) {
+    try {
+        const content = await readFile(path, 'utf-8');
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            const eq = trimmed.indexOf('=');
+            if (eq === -1)
+                continue;
+            const key = trimmed.slice(0, eq).trim();
+            const val = trimmed
+                .slice(eq + 1)
+                .trim()
+                .replace(/^["']|["']$/g, '');
+            if (key && !(key in process.env))
+                process.env[key] = val;
+        }
+    }
+    catch {
+        // .env.local not present — rely on process.env
+    }
+}
+function getOutputPath() {
+    const outputArg = process.argv.find((a) => a.startsWith('--output='));
+    if (outputArg)
+        return outputArg.slice('--output='.length);
+    return process.env['AB_TESTS_OUTPUT'] ?? './src/generated/abTests.ts';
+}
+async function main() {
+    await loadEnvFile('.env.local');
+    const draftOnly = process.env['DRAFT_ONLY'] === 'true';
+    const spaceId = process.env['CONTENTFUL_SPACE_ID'];
+    const accessToken = draftOnly
+        ? process.env['CONTENTFUL_PREVIEW_ACCESS_TOKEN']
+        : process.env['CONTENTFUL_ACCESS_TOKEN'];
+    const environment = process.env['CONTENTFUL_ENVIRONMENT'] ?? process.env['CONTENTFUL_ENVIRONMENT_NAME'] ?? 'master';
+    if (!spaceId || !accessToken) {
+        console.error(draftOnly
+            ? 'Missing CONTENTFUL_SPACE_ID or CONTENTFUL_PREVIEW_ACCESS_TOKEN'
+            : 'Missing CONTENTFUL_SPACE_ID or CONTENTFUL_ACCESS_TOKEN');
+        process.exit(1);
+    }
+    const host = draftOnly ? 'preview.contentful.com' : 'cdn.contentful.com';
+    const url = `https://${host}/spaces/${spaceId}/environments/${environment}/entries?content_type=pageTest&include=1`;
+    console.log(`Fetching A/B tests from Contentful (environment: ${environment}, preview: ${String(draftOnly)})...`);
+    const response = await fetch(url, {
+        headers: { Authorization: `Bearer ${accessToken}` },
+    });
+    if (!response.ok) {
+        console.error(`Contentful API error: ${response.status} ${response.statusText}`);
+        process.exit(1);
+    }
+    const data = (await response.json());
+    const rawCount = data.items?.length ?? 0;
+    const includesCount = data.includes?.Entry?.length ?? 0;
+    console.log(`  → ${rawCount} pageTest entry(s) returned, ${includesCount} linked entry(s) in includes`);
+    const includesMap = new Map();
+    for (const entry of data.includes?.Entry ?? []) {
+        includesMap.set(entry.sys.id, entry);
+    }
+    const rawTests = (data.items ?? []).map((item) => {
+        const { fields, sys } = item;
+        const controlRef = fields['control'];
+        const controlEntry = controlRef ? includesMap.get(controlRef.sys.id) : undefined;
+        if (controlRef && !controlEntry) {
+            console.warn(`  → Test ${sys.id} ("${fields['cmsLabel']}"): control entry ${controlRef.sys.id} not found in includes (not published?)`);
+        }
+        const variantRefs = fields['variants'] ?? [];
+        const variantItems = variantRefs
+            .map((ref) => {
+            const entry = includesMap.get(ref.sys.id);
+            if (!entry) {
+                console.warn(`  → Test ${sys.id}: variant entry ${ref.sys.id} not found in includes (not published?)`);
+                return null;
+            }
+            return { sys: ref.sys, slug: entry.fields['slug'] };
+        })
+            .filter((v) => v !== null);
+        console.log(`  → Test "${fields['cmsLabel']}" (${sys.id}): enabled=${String(fields['enabled'])}, control slug="${controlEntry?.fields['slug'] ?? 'MISSING'}", ${variantItems.length} variant(s)`);
+        return {
+            sys,
+            cmsLabel: fields['cmsLabel'],
+            trackingLabel: fields['trackingLabel'],
+            enabled: fields['enabled'],
+            searchParameters: fields['searchParameters'],
+            configuration: fields['configuration'],
+            control: controlRef && controlEntry
+                ? { sys: controlRef.sys, slug: controlEntry.fields['slug'] }
+                : null,
+            variantsCollection: { items: variantItems },
+        };
+    });
+    const tests = rawTests
+        .map((raw) => transformPageTest(raw, (id, reason) => console.warn(`  → Skipping test ${id}: ${reason}`)))
+        .filter((t) => t !== null);
+    console.log(`Found ${tests.length} active test(s)`);
+    for (const test of tests) {
+        console.log(`  → "${test.cmsLabel}" on /${test.controlSlug} with ${test.variants.length} variant(s)`);
+    }
+    const testsByPath = buildStaticTestsByPath(tests);
+    const pathCount = Object.keys(testsByPath).length;
+    console.log(`Mapped to ${pathCount} path(s): ${Object.keys(testsByPath).join(', ')}`);
+    const content = generateAbTestsFileContent(testsByPath);
+    const outputPath = resolve(getOutputPath());
+    await mkdir(dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, content);
+    console.log(`Written to ${outputPath}`);
+}
+main().catch((error) => {
+    console.error('Failed to generate A/B test config:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/codegen/cli.js.map

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

package/dist/codegen/generator.js

@@ -45,8 +45,8 @@ export function buildStaticTestsByPath(tests) {
 export function generateAbTestsFileContent(testsByPath, options = {}) {
     const { importPath = '@se-studio/ab-testing' } = options;
     const json = JSON.stringify(testsByPath, null, 2);
-    return `// This file is automatically generated — do not edit manually.
-// Re-generate by running your management/generateAbTests script.
+    return `// This file is automatically generated from Contentful CMS — do not edit manually.
+// Re-generate: pnpm generate:ab-tests  (runs automatically via predev/prebuild)
 
 import type { CachedAbTest } from '${importPath}';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/ab-testing",
-  "version": "1.0.73",
+  "version": "1.0.74",
   "description": "Server-side A/B testing framework for Next.js applications with Contentful CMS",
   "repository": {
     "type": "git",
@@ -37,6 +37,9 @@
       "import": "./dist/components/index.js"
     }
   },
+  "bin": {
+    "generate-ab-tests": "./dist/codegen/cli.js"
+  },
   "files": [
     "dist",
     "*.md"
@@ -63,7 +66,7 @@
     "react": "^19.0.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.12",
+    "@biomejs/biome": "^2.4.14",
     "@types/node": "^22.19.17",
     "@types/react": "^19.2.14",
     "next": "^15.5.15",