@gitbook/adaptive

packages/adaptive/.gitignore

@@ -0,0 +1 @@
+dist

packages/adaptive/esbuild.config.js

@@ -0,0 +1,42 @@
+const esbuild = require('esbuild');
+
+// Common settings
+const commonSettings = {
+    entryPoints: ['src/index.ts'],
+    bundle: true,
+    minify: true,
+    sourcemap: true,
+    target: ['es2020', 'chrome70', 'firefox70', 'safari12', 'edge79'],
+    plugins: [],
+    logLevel: 'info',
+};
+
+// Build ESM module
+esbuild
+    .build({
+        ...commonSettings,
+        outfile: 'dist/index.esm.js',
+        format: 'esm',
+    })
+    .catch(() => process.exit(1));
+
+// Build CommonJS module
+esbuild
+    .build({
+        ...commonSettings,
+        outfile: 'dist/index.js',
+        format: 'cjs',
+    })
+    .catch(() => process.exit(1));
+
+// Build UMD/IIFE bundle for direct browser usage
+esbuild
+    .build({
+        ...commonSettings,
+        outfile: 'dist/index.umd.js',
+        format: 'iife',
+        globalName: 'MyPackage',
+        // Remove external modules handling for IIFE build
+        plugins: [],
+    })
+    .catch(() => process.exit(1));

packages/adaptive/package.json

@@ -0,0 +1,35 @@
+{
+    "name": "@gitbook/adaptive",
+    "description": "Utility to use adaptive content in GitBook",
+    "type": "module",
+    "version": "0.0.1",
+    "sideEffects": false,
+    "main": "dist/index.js",
+    "module": "dist/index.esm.js",
+    "unpkg": "dist/index.umd.js",
+    "types": "dist/index.d.ts",
+    "files": [
+        "README.md",
+        "dist/**"
+    ],
+    "dependencies": {
+        "js-cookie": "^3.0.5"
+    },
+    "devDependencies": {
+        "@gitbook/tsconfig": "*",
+        "typescript": "^5.6.2",
+        "@bucketco/browser-sdk": "^3.1.2",
+        "@types/js-cookie": "^3.0.6",
+        "esbuild": "^0.25.3"
+    },
+    "scripts": {
+        "build": "bun esbuild.config.js && tsc --emitDeclarationOnly",
+        "typecheck": "tsc --noEmit"
+    },
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    }
+}

packages/adaptive/src/client.ts

@@ -0,0 +1,53 @@
+import type { BucketClient } from '@bucketco/browser-sdk';
+import Cookies from 'js-cookie';
+
+const COOKIE_NAME = 'gitbook-visitor-public-bucket';
+
+/**
+ * Sets a client-side session cookie with the features enabled in the bucket client.
+ */
+export function withBucket(client: BucketClient): () => void {
+    const handler = () => {
+        const features: Record<string, boolean> = {};
+        // Check features enabled in the client
+        for (const [key, value] of Object.entries(client.getFeatures())) {
+            const enabled =
+                typeof value.isEnabledOverride === 'boolean'
+                    ? value.isEnabledOverride
+                    : value.isEnabled;
+            features[key] = enabled;
+        }
+
+        // Set a session cookie with the features
+        Cookies.set(COOKIE_NAME, JSON.stringify(features), {
+            secure: true,
+        });
+    };
+
+    // Determine if we're in a browser environment
+    const isBrowser = typeof window !== 'undefined';
+
+    if (!isBrowser) {
+        console.warn('withBucket was called in a non-browser environment');
+        return () => {};
+    }
+
+    const cleanup: Array<() => void> = [];
+
+    // Add event listener for when the DOM is ready
+    if (document.readyState === 'interactive' || document.readyState === 'complete') {
+        handler();
+    } else {
+        document.addEventListener('DOMContentLoaded', handler);
+        cleanup.push(() => {
+            document.removeEventListener('DOMContentLoaded', handler);
+        });
+    }
+    // Add event listeners for feature updates
+    cleanup.push(client.on('featuresUpdated', handler));
+
+    // Return cleanup function
+    return () => {
+        cleanup.forEach((fn) => fn());
+    };
+}

packages/adaptive/src/index.ts

@@ -0,0 +1 @@
+export * from './client';

packages/adaptive/tsconfig.json

@@ -0,0 +1,12 @@
+{
+    "extends": "@gitbook/tsconfig/base.json",
+    "include": ["src/**/*"],
+    "rootDir": "./src",
+    "compilerOptions": {
+        "outDir": "./dist",
+        "baseUrl": "./src",
+        "allowImportingTsExtensions": false,
+        "noEmit": false,
+        "declaration": true
+    }
+}