@ops-ai/toggly-docusaurus-plugin 0.1.0

package/README.md

@@ -0,0 +1,235 @@
+# @ops-ai/toggly-docusaurus-plugin
+
+Docusaurus plugin and React bindings for gating documentation content with Toggly feature flags.
+
+## Installation
+
+```bash
+npm install @ops-ai/toggly-docusaurus-plugin @ops-ai/toggly-client-core
+# or
+pnpm add @ops-ai/toggly-docusaurus-plugin @ops-ai/toggly-client-core
+# or
+yarn add @ops-ai/toggly-docusaurus-plugin @ops-ai/toggly-client-core
+```
+
+## Configuration
+
+Add the plugin to your `docusaurus.config.js` or `docusaurus.config.ts`:
+
+```js
+// docusaurus.config.js
+module.exports = {
+  // ... other config
+  plugins: [
+    [
+      '@ops-ai/toggly-docusaurus-plugin',
+      {
+        baseURI: 'https://client.toggly.io',
+        appKey: 'your-app-key',
+        environment: 'Production',
+        flagDefaults: {
+          'beta-feature': false,
+        },
+        featureFlagsRefreshInterval: 180000, // 3 minutes
+        isDebug: false,
+        connectTimeout: 5000,
+      },
+    ],
+  ],
+};
+```
+
+### Plugin Options
+
+- `baseURI` (string, optional): Base URI for the Toggly API (default: `'https://client.toggly.io'`)
+- `appKey` (string, optional): Application key from Toggly
+- `environment` (string, optional): Environment name (default: `'Production'`)
+- `flagDefaults` (object, optional): Default flag values when API is unavailable
+- `featureFlagsRefreshInterval` (number, optional): Refresh interval in milliseconds (default: `180000` = 3 minutes)
+- `isDebug` (boolean, optional): Enable debug logging (default: `false`)
+- `connectTimeout` (number, optional): Connection timeout in milliseconds (default: `5000`)
+- `identity` (string, optional): User identity for targeting
+
+## Page-Level Gating
+
+Add `x-feature` to the frontmatter of any MD/MDX file to gate the entire page:
+
+```markdown
+---
+id: sso-setup
+title: Single Sign-On Setup
+x-feature: enterprise_sso
+---
+
+This page is only visible when the `enterprise_sso` feature flag is enabled.
+
+The Cloudflare Worker will gate this page according to the `enterprise_sso` flag.
+If the feature is off, the page will return a 404 (or redirect, depending on Worker configuration).
+```
+
+### How It Works
+
+1. **During Build**: The plugin inspects each doc's metadata and extracts the `x-feature` frontmatter property
+2. **Route Mapping**: It creates a mapping from the doc's route path (e.g., `/docs/enterprise/sso-setup`) to the feature key (e.g., `enterprise_sso`)
+3. **Manifest Generation**: At the end of the build, it emits a JSON file at `${outDir}/toggly-page-features.json` in the build output directory
+4. **Edge Enforcement**: The Cloudflare Worker reads this manifest and enforces gating at the edge
+
+### Generated Manifest
+
+The plugin automatically generates a JSON manifest in your build output directory:
+
+**Location**: `build/toggly-page-features.json` (or `${outDir}/toggly-page-features.json`)
+
+**Example content**:
+```json
+{
+  "/docs/enterprise/sso-setup": "enterprise_sso",
+  "/docs/advanced/filters": "beta_advanced_filters"
+}
+```
+
+This manifest is consumed by the Cloudflare Worker to determine which pages should be gated and which feature flag to check for each route.
+
+## React Components and Hooks
+
+### Setup TogglyProvider
+
+Wrap your Docusaurus app with `TogglyProvider`. You can do this by swizzling the root layout:
+
+```bash
+npm run swizzle @docusaurus/theme-classic Root -- --wrap
+```
+
+Then modify `src/theme/Root/index.js`:
+
+```jsx
+import React from 'react';
+import Root from '@theme/Root';
+import { TogglyProvider } from '@ops-ai/toggly-docusaurus-plugin/client';
+
+export default function RootWrapper({ children }) {
+  // Config is automatically injected by the plugin
+  const config = typeof window !== 'undefined' ? window.__TOGGLY_CONFIG__ : {};
+  
+  return (
+    <TogglyProvider config={config}>
+      <Root>{children}</Root>
+    </TogglyProvider>
+  );
+}
+```
+
+### Using the Feature Component
+
+```tsx
+import { Feature } from '@ops-ai/toggly-docusaurus-plugin/client';
+
+function MyComponent() {
+  return (
+    <div>
+      <h1>Public Content</h1>
+      
+      <Feature flag="beta_advanced_filters" fallback={<p>This feature is coming soon!</p>}>
+        <h2>Advanced Filters (Beta)</h2>
+        <p>This feature is in beta...</p>
+      </Feature>
+    </div>
+  );
+}
+```
+
+### Using the useFlag Hook
+
+```tsx
+import { useFlag } from '@ops-ai/toggly-docusaurus-plugin/client';
+
+function MyComponent() {
+  const { enabled, isReady } = useFlag('beta_advanced_filters', false);
+  
+  if (!isReady) {
+    return <div>Loading...</div>;
+  }
+  
+  return enabled ? (
+    <div>Beta feature is enabled!</div>
+  ) : (
+    <div>Beta feature is disabled</div>
+  );
+}
+```
+
+### Using the useToggly Hook
+
+```tsx
+import { useToggly } from '@ops-ai/toggly-docusaurus-plugin/client';
+
+function MyComponent() {
+  const { flags, isReady, getFlag } = useToggly();
+  
+  const handleClick = async () => {
+    const isEnabled = await getFlag('my-feature', false);
+    console.log('Feature enabled:', isEnabled);
+  };
+  
+  return (
+    <button onClick={handleClick} disabled={!isReady}>
+      Check Feature
+    </button>
+  );
+}
+```
+
+## Section-Level Gating
+
+For section-level gating, you can use the `data-feature` attribute with a client-side script or component:
+
+```tsx
+import { useFlag } from '@ops-ai/toggly-docusaurus-plugin/client';
+
+function FeatureSection({ flag, children }) {
+  const { enabled, isReady } = useFlag(flag);
+  
+  if (!isReady || !enabled) {
+    return null;
+  }
+  
+  return <div data-feature={flag}>{children}</div>;
+}
+```
+
+Or in MDX:
+
+```mdx
+import { Feature } from '@ops-ai/toggly-docusaurus-plugin/client';
+
+<Feature flag="beta_advanced_filters">
+  <div data-feature="beta_advanced_filters">
+    <h2>Advanced Filters (Beta)</h2>
+    <p>This section is gated by the feature flag.</p>
+  </div>
+</Feature>
+```
+
+## Generated Files
+
+The plugin generates:
+
+- `build/toggly-page-features.json` (or `${outDir}/toggly-page-features.json`): A mapping of route paths to feature flag keys, used by the Cloudflare Worker for edge enforcement
+
+This file is generated during the Docusaurus build process and is placed in the build output directory, making it accessible to the Cloudflare Worker at the root of your deployed site.
+
+## TypeScript Support
+
+Full TypeScript support is included. Import types as needed:
+
+```tsx
+import type {
+  TogglyProviderProps,
+  TogglyContextValue,
+  FeatureProps,
+} from '@toggly/docusaurus-plugin/client';
+```
+
+## License
+
+MIT

package/dist/client/index.d.ts

@@ -0,0 +1,82 @@
+/**
+ * React client bindings for Toggly in Docusaurus
+ *
+ * Provides React context, hooks, and components for feature flag evaluation
+ */
+import { ReactNode } from 'react';
+import { type TogglyConfig, type Flags } from '@toggly/client-core';
+export interface TogglyProviderProps {
+    config: TogglyConfig;
+    children: ReactNode;
+}
+export interface TogglyContextValue {
+    flags: Flags;
+    isReady: boolean;
+    getFlag: (key: string, defaultValue?: boolean) => Promise<boolean>;
+    error: Error | null;
+}
+/**
+ * TogglyProvider - React context provider for Toggly feature flags
+ *
+ * Wrap your Docusaurus app with this provider to enable feature flag evaluation.
+ * The config can be read from window.__TOGGLY_CONFIG__ (injected by the plugin)
+ * or passed directly.
+ *
+ * @example
+ * ```tsx
+ * // Option 1: Read from window (recommended)
+ * const config = (window as any).__TOGGLY_CONFIG__ || {};
+ * <TogglyProvider config={config}>
+ *   {children}
+ * </TogglyProvider>
+ *
+ * // Option 2: Pass config directly
+ * <TogglyProvider config={{ appKey: '...', environment: 'Production' }}>
+ *   {children}
+ * </TogglyProvider>
+ * ```
+ */
+export declare function TogglyProvider({ config: providedConfig, children, }: TogglyProviderProps): JSX.Element;
+/**
+ * useToggly - Hook to access Toggly context
+ *
+ * Returns the Toggly context value with flags and helper methods.
+ */
+export declare function useToggly(): TogglyContextValue;
+/**
+ * useFlag - Hook to check if a feature flag is enabled
+ *
+ * @param flagKey - The key of the feature flag to check
+ * @param defaultValue - Optional default value if flag is not found
+ * @returns Object with enabled state and ready state
+ */
+export declare function useFlag(flagKey: string, defaultValue?: boolean): {
+    enabled: boolean;
+    isReady: boolean;
+};
+/**
+ * Feature component - Conditionally renders children based on feature flag
+ */
+export interface FeatureProps {
+    /** The feature flag key to check */
+    flag: string;
+    /** Content to render when flag is enabled */
+    children: ReactNode;
+    /** Content to render when flag is disabled (optional) */
+    fallback?: ReactNode;
+    /** Default value if flag is not found (default: false) */
+    defaultValue?: boolean;
+}
+/**
+ * Feature - React component for conditional rendering based on feature flags
+ *
+ * @example
+ * ```tsx
+ * <Feature flag="beta_advanced_filters">
+ *   <h2>Advanced Filters (Beta)</h2>
+ *   <p>This feature is in beta...</p>
+ * </Feature>
+ * ```
+ */
+export declare function Feature({ flag, children, fallback, defaultValue, }: FeatureProps): JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAc,EAKZ,SAAS,EACV,MAAM,OAAO,CAAC;AACf,OAAO,EAAsB,KAAK,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAExF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EAAE,cAAc,EACtB,QAAQ,GACT,EAAE,mBAAmB,GAAG,GAAG,CAAC,OAAO,CAgDnC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,kBAAkB,CAM9C;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,OAAO,GACrB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAiBxC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,EAAE,SAAS,CAAC;IACpB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,EACtB,IAAI,EACJ,QAAQ,EACR,QAAe,EACf,YAAoB,GACrB,EAAE,YAAY,GAAG,GAAG,CAAC,OAAO,CAS5B"}

package/dist/client/index.js

@@ -0,0 +1,126 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * React client bindings for Toggly in Docusaurus
+ *
+ * Provides React context, hooks, and components for feature flag evaluation
+ */
+import { createContext, useContext, useState, useEffect, } from 'react';
+import { createTogglyClient } from '@toggly/client-core';
+const TogglyContext = createContext(null);
+/**
+ * TogglyProvider - React context provider for Toggly feature flags
+ *
+ * Wrap your Docusaurus app with this provider to enable feature flag evaluation.
+ * The config can be read from window.__TOGGLY_CONFIG__ (injected by the plugin)
+ * or passed directly.
+ *
+ * @example
+ * ```tsx
+ * // Option 1: Read from window (recommended)
+ * const config = (window as any).__TOGGLY_CONFIG__ || {};
+ * <TogglyProvider config={config}>
+ *   {children}
+ * </TogglyProvider>
+ *
+ * // Option 2: Pass config directly
+ * <TogglyProvider config={{ appKey: '...', environment: 'Production' }}>
+ *   {children}
+ * </TogglyProvider>
+ * ```
+ */
+export function TogglyProvider({ config: providedConfig, children, }) {
+    // If no config provided, try to read from window
+    const config = providedConfig ||
+        (typeof window !== 'undefined'
+            ? window.__TOGGLY_CONFIG__ || {}
+            : {});
+    const [client] = useState(() => {
+        // Ensure we have a valid config
+        if (!config || (!config.appKey && Object.keys(config).length === 0)) {
+            console.warn('[Toggly] No config provided. Please configure the plugin in docusaurus.config.js or pass config to TogglyProvider');
+        }
+        return createTogglyClient(config);
+    });
+    const [flags, setFlags] = useState({});
+    const [isReady, setIsReady] = useState(false);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        // Initialize client and load flags
+        client
+            .getFlags()
+            .then((loadedFlags) => {
+            setFlags(loadedFlags);
+            setIsReady(true);
+        })
+            .catch((err) => {
+            setError(err);
+            setIsReady(true); // Still mark as ready even on error
+        });
+    }, [client]);
+    const getFlag = async (key, defaultValue) => {
+        return client.getFlag(key, defaultValue);
+    };
+    const value = {
+        flags,
+        isReady,
+        getFlag,
+        error,
+    };
+    return (_jsx(TogglyContext.Provider, { value: value, children: children }));
+}
+/**
+ * useToggly - Hook to access Toggly context
+ *
+ * Returns the Toggly context value with flags and helper methods.
+ */
+export function useToggly() {
+    const context = useContext(TogglyContext);
+    if (!context) {
+        throw new Error('useToggly must be used within a TogglyProvider');
+    }
+    return context;
+}
+/**
+ * useFlag - Hook to check if a feature flag is enabled
+ *
+ * @param flagKey - The key of the feature flag to check
+ * @param defaultValue - Optional default value if flag is not found
+ * @returns Object with enabled state and ready state
+ */
+export function useFlag(flagKey, defaultValue) {
+    const { flags, isReady, getFlag } = useToggly();
+    const [enabled, setEnabled] = useState(defaultValue ?? false);
+    useEffect(() => {
+        if (isReady) {
+            // First check cached flags
+            if (flags[flagKey] !== undefined) {
+                setEnabled(flags[flagKey]);
+            }
+            else {
+                // Fallback to async getFlag
+                getFlag(flagKey, defaultValue).then(setEnabled);
+            }
+        }
+    }, [flagKey, flags, isReady, getFlag, defaultValue]);
+    return { enabled, isReady };
+}
+/**
+ * Feature - React component for conditional rendering based on feature flags
+ *
+ * @example
+ * ```tsx
+ * <Feature flag="beta_advanced_filters">
+ *   <h2>Advanced Filters (Beta)</h2>
+ *   <p>This feature is in beta...</p>
+ * </Feature>
+ * ```
+ */
+export function Feature({ flag, children, fallback = null, defaultValue = false, }) {
+    const { enabled, isReady } = useFlag(flag, defaultValue);
+    if (!isReady) {
+        // While loading, show nothing or a loading state
+        return _jsx(_Fragment, { children: fallback });
+    }
+    return _jsx(_Fragment, { children: enabled ? children : fallback });
+}
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

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

package/dist/client/setup.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Client-side setup for Toggly in Docusaurus
+ *
+ * This module runs in the browser and initializes the Toggly client.
+ * The config is available via window.__TOGGLY_CONFIG__ injected by the plugin.
+ *
+ * Note: Users need to wrap their app with TogglyProvider manually,
+ * or use the swizzle feature to inject it into the root layout.
+ */
+//# sourceMappingURL=setup.d.ts.map

package/dist/client/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/client/setup.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/client/setup.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Client-side setup for Toggly in Docusaurus
+ *
+ * This module runs in the browser and initializes the Toggly client.
+ * The config is available via window.__TOGGLY_CONFIG__ injected by the plugin.
+ *
+ * Note: Users need to wrap their app with TogglyProvider manually,
+ * or use the swizzle feature to inject it into the root layout.
+ */
+// This module is imported globally by Docusaurus
+// It can be used to set up global state or side effects
+if (typeof window !== 'undefined') {
+    // Config is already available via window.__TOGGLY_CONFIG__ from injectHtmlTags
+    // Users can access it in their components via:
+    // const config = (window as any).__TOGGLY_CONFIG__;
+}
+//# sourceMappingURL=setup.js.map

package/dist/client/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/client/setup.tsx"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;AAEH,iDAAiD;AACjD,wDAAwD;AAExD,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;IAClC,+EAA+E;IAC/E,+CAA+C;IAC/C,oDAAoD;AACtD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @toggly/docusaurus-plugin - Docusaurus plugin and React bindings
+ *
+ * Provides Docusaurus plugin integration and React components/hooks
+ * for gating documentation content with Toggly feature flags.
+ */
+import type { Plugin, LoadContext } from '@docusaurus/types';
+export interface TogglyPluginOptions {
+    /** Base URI for the Toggly API (default: 'https://client.toggly.io') */
+    baseURI?: string;
+    /** Application key from Toggly */
+    appKey?: string;
+    /** Environment name (e.g., 'Production', 'Staging') (default: 'Production') */
+    environment?: string;
+    /** Default flag values to use when API is unavailable */
+    flagDefaults?: {
+        [key: string]: boolean;
+    };
+    /** Feature flags refresh interval in milliseconds (default: 180000 = 3 minutes) */
+    featureFlagsRefreshInterval?: number;
+    /** Enable debug logging (default: false) */
+    isDebug?: boolean;
+    /** Connection timeout in milliseconds (default: 5000) */
+    connectTimeout?: number;
+    /** User identity for targeting (optional) */
+    identity?: string;
+}
+/**
+ * Docusaurus plugin for Toggly feature flag gating
+ */
+export default function togglyPlugin(context: LoadContext, options: TogglyPluginOptions): Plugin;
+export { TogglyProvider, useToggly, useFlag, Feature } from './client';
+export type { TogglyProviderProps, TogglyContextValue, FeatureProps, } from './client';
+//# 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;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAA8B,MAAM,mBAAmB,CAAC;AAMzF,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,YAAY,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC1C,mFAAmF;IACnF,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAmBD;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,mBAAmB,GAC3B,MAAM,CAqJR;AAmFD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACvE,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,GACb,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,193 @@
+/**
+ * @toggly/docusaurus-plugin - Docusaurus plugin and React bindings
+ *
+ * Provides Docusaurus plugin integration and React components/hooks
+ * for gating documentation content with Toggly feature flags.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { glob } from 'glob';
+import webpack from 'webpack';
+/**
+ * Docusaurus plugin for Toggly feature flag gating
+ */
+export default function togglyPlugin(context, options) {
+    const { baseURI = 'https://client.toggly.io', appKey, environment = 'Production', flagDefaults = {}, featureFlagsRefreshInterval = 3 * 60 * 1000, isDebug = false, connectTimeout = 5 * 1000, identity, } = options;
+    // Store page feature mapping for postBuild
+    let pageFeatureMapping = {};
+    return {
+        name: 'toggly-plugin',
+        /**
+         * Load content: Extract x-feature frontmatter from docs
+         * We'll access doc metadata through the content system
+         */
+        async loadContent() {
+            return {
+                config: {
+                    baseURI,
+                    appKey,
+                    environment,
+                    flagDefaults,
+                    featureFlagsRefreshInterval,
+                    isDebug,
+                    connectTimeout,
+                    identity,
+                },
+            };
+        },
+        /**
+         * Content loaded: Extract x-feature from doc metadata and build route mapping
+         */
+        async contentLoaded({ content, actions }) {
+            const { config: pluginConfig } = content;
+            // Extract page feature mapping from files
+            // We parse files directly to get x-feature frontmatter
+            // and will map to routes using Docusaurus's routing structure
+            pageFeatureMapping = await extractFromFiles(context);
+            // Store data for configureWebpack and postBuild
+            this.__togglyPluginData = {
+                pageFeatureMapping,
+                config: pluginConfig,
+            };
+            if (isDebug) {
+                console.log(`[Toggly Plugin] Found ${Object.keys(pageFeatureMapping).length} pages with x-feature frontmatter`);
+                if (Object.keys(pageFeatureMapping).length > 0) {
+                    console.log('[Toggly Plugin] Page feature mappings:');
+                    Object.entries(pageFeatureMapping).forEach(([route, feature]) => {
+                        console.log(`  ${route} -> ${feature}`);
+                    });
+                }
+            }
+        },
+        /**
+         * Post build: Write manifest to output directory
+         */
+        async postBuild({ outDir }) {
+            const pluginData = this.__togglyPluginData;
+            if (!pluginData) {
+                return;
+            }
+            const { pageFeatureMapping: mapping } = pluginData;
+            // Write manifest to build output directory
+            const manifestPath = path.join(outDir, 'toggly-page-features.json');
+            fs.writeFileSync(manifestPath, JSON.stringify(mapping, null, 2), 'utf-8');
+            if (isDebug) {
+                console.log(`[Toggly Plugin] Generated page feature manifest: ${manifestPath}`);
+            }
+        },
+        /**
+         * Configure Webpack: Inject Toggly config into client bundle
+         */
+        configureWebpack(config, isServer) {
+            if (isServer) {
+                return {};
+            }
+            // Get stored data from contentLoaded
+            const pluginData = this.__togglyPluginData;
+            if (!pluginData) {
+                return {};
+            }
+            const { pageFeatureMapping, config: pluginConfig } = pluginData;
+            return {
+                plugins: [
+                    new webpack.DefinePlugin({
+                        __TOGGLY_CONFIG__: JSON.stringify(pluginConfig),
+                        __TOGGLY_PAGE_FEATURES__: JSON.stringify(pageFeatureMapping),
+                    }),
+                ],
+            };
+        },
+        /**
+         * Inject HTML tags: Add script to make config available globally
+         */
+        injectHtmlTags() {
+            const pluginData = this.__togglyPluginData;
+            if (!pluginData) {
+                return {};
+            }
+            const { config: pluginConfig } = pluginData;
+            return {
+                headTags: [
+                    {
+                        tagName: 'script',
+                        innerHTML: `window.__TOGGLY_CONFIG__ = ${JSON.stringify(pluginConfig)};`,
+                    },
+                ],
+            };
+        },
+        /**
+         * Get client modules: Import the client setup module
+         */
+        getClientModules() {
+            return [path.resolve(__dirname, './client/setup')];
+        },
+    };
+}
+/**
+ * Extract page feature mapping by parsing files directly
+ * Maps file paths to Docusaurus route paths
+ */
+async function extractFromFiles(context) {
+    const { siteDir, baseUrl } = context;
+    const docsDir = path.join(siteDir, 'docs');
+    const pageFeatureMapping = {};
+    // Check if docs directory exists
+    if (!fs.existsSync(docsDir)) {
+        return pageFeatureMapping;
+    }
+    // Find all MD/MDX files in the docs directory
+    const files = await glob('**/*.{md,mdx}', {
+        cwd: docsDir,
+        absolute: false,
+        ignore: ['node_modules/**'],
+    });
+    for (const file of files) {
+        const filePath = path.join(docsDir, file);
+        const content = fs.readFileSync(filePath, 'utf-8');
+        // Extract frontmatter
+        const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n/);
+        if (frontmatterMatch) {
+            const frontmatter = frontmatterMatch[1];
+            // Extract x-feature property (supports YAML with or without quotes)
+            const xFeatureMatch = frontmatter.match(/^x-feature:\s*(.+)$/m);
+            if (xFeatureMatch) {
+                let featureKey = xFeatureMatch[1].trim();
+                // Remove quotes if present
+                featureKey = featureKey.replace(/^["']|["']$/g, '');
+                // Convert file path to Docusaurus route path
+                // Docusaurus routes docs as: /docs/<path>
+                // File structure: docs/<category>/<file>.md -> /docs/<category>/<file>
+                let routePath = file.replace(/\.(md|mdx)$/, '').replace(/\\/g, '/');
+                // Handle index files - they become the parent directory route
+                if (path.basename(routePath) === 'index') {
+                    routePath = path.dirname(routePath);
+                    if (routePath === '.') {
+                        routePath = '';
+                    }
+                }
+                // Ensure path starts with /
+                if (!routePath.startsWith('/')) {
+                    routePath = '/' + routePath;
+                }
+                // Prepend /docs/ if not already there
+                if (!routePath.startsWith('/docs')) {
+                    routePath = '/docs' + routePath;
+                }
+                // Remove trailing slash (except for root /docs)
+                routePath = routePath.replace(/\/$/, '') || '/docs';
+                // Prepend baseUrl if not root
+                // baseUrl is typically '/' but can be '/project-name/' for GitHub Pages
+                let fullRoutePath = routePath;
+                if (baseUrl !== '/') {
+                    const normalizedBaseUrl = baseUrl.replace(/\/$/, '');
+                    fullRoutePath = normalizedBaseUrl + routePath;
+                }
+                pageFeatureMapping[fullRoutePath] = featureKey;
+            }
+        }
+    }
+    return pageFeatureMapping;
+}
+// Export React components and hooks
+export { TogglyProvider, useToggly, useFlag, Feature } from './client';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@ops-ai/toggly-docusaurus-plugin",
+  "version": "0.1.0",
+  "description": "Docusaurus plugin and React bindings for Toggly feature flag gating",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.mjs",
+      "require": "./dist/client/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx"
+  },
+  "keywords": [
+    "toggly",
+    "docusaurus",
+    "feature-flags",
+    "react",
+    "documentation"
+  ],
+  "author": "Toggly",
+  "license": "MIT",
+  "dependencies": {
+    "@ops-ai/toggly-client-core": "workspace:*",
+    "glob": "^10.3.10",
+    "react": "^18.3.1"
+  },
+  "peerDependencies": {
+    "@docusaurus/core": "^3.0.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
+  },
+  "devDependencies": {
+    "@docusaurus/core": "^3.9.2",
+    "@docusaurus/types": "^3.9.2",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@types/webpack": "^5.28.0",
+    "typescript": "^5.3.3",
+    "webpack": "^5.89.0"
+  }
+}