@ops-ai/astro-feature-flags-toggly 1.0.0

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2024 Ops.AI
+
+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,462 @@
+# Toggly Astro SDK
+
+Feature flag management for Astro applications with support for SSR, SSG, and client-side rendering.
+
+## Features
+
+- 🚀 **Native Astro Components** - Server-rendered `.astro` components for optimal performance
+- 🏝️ **Island Architecture** - Client-side hydration with Astro islands
+- ⚛️ **Framework Support** - React, Vue, and Svelte component wrappers
+- 📄 **Page-Level Gating** - Control entire pages via frontmatter
+- 🔄 **SSR & SSG Support** - Works seamlessly with both rendering modes
+- 🎯 **User Targeting** - Identity-based feature rollouts
+- ⚡ **Lightweight** - Minimal client bundle using nanostores (~300 bytes)
+- 🔌 **Edge Ready** - Optional Cloudflare Worker integration
+
+## Installation
+
+```bash
+npm install @ops-ai/astro-feature-flags-toggly
+```
+
+## Quick Start
+
+### 1. Add the Integration
+
+In your `astro.config.mjs`:
+
+```javascript
+import { defineConfig } from 'astro/config';
+import togglyIntegration from '@ops-ai/astro-feature-flags-toggly/integration';
+
+export default defineConfig({
+  integrations: [
+    togglyIntegration({
+      appKey: process.env.TOGGLY_APP_KEY,
+      environment: process.env.TOGGLY_ENVIRONMENT || 'Production',
+      baseURI: 'https://client.toggly.io',
+      flagDefaults: {
+        // Fallback values when API is unavailable
+        'example-feature': false,
+      },
+      isDebug: process.env.NODE_ENV === 'development',
+    }),
+  ],
+});
+```
+
+### 2. Configure Middleware
+
+Create or update `src/middleware.ts`:
+
+```typescript
+import { sequence } from 'astro:middleware';
+import { createTogglyMiddleware } from '@ops-ai/astro-feature-flags-toggly';
+
+const toggly = createTogglyMiddleware({
+  appKey: import.meta.env.TOGGLY_APP_KEY,
+  environment: import.meta.env.TOGGLY_ENVIRONMENT || 'Production',
+});
+
+export const onRequest = sequence(toggly);
+```
+
+### 3. Use the Feature Component
+
+In your `.astro` files:
+
+```astro
+---
+import Feature from '@ops-ai/astro-feature-flags-toggly/components/Feature.astro';
+---
+
+<Feature flag="new-dashboard">
+  <h1>New Dashboard</h1>
+  <p>This content is only visible when the feature is enabled</p>
+</Feature>
+```
+
+## Usage
+
+### Server-Side Components (Recommended)
+
+Use the `Feature.astro` component for server-side evaluation (SSR/SSG):
+
+```astro
+---
+import Feature from '@ops-ai/astro-feature-flags-toggly/components/Feature.astro';
+---
+
+<!-- Single flag -->
+<Feature flag="beta-feature">
+  <p>Beta content</p>
+</Feature>
+
+<!-- Multiple flags with 'all' requirement -->
+<Feature flags={['feature1', 'feature2']}>
+  <p>Both features must be enabled</p>
+</Feature>
+
+<!-- Multiple flags with 'any' requirement -->
+<Feature flags={['feature1', 'feature2']} requirement="any">
+  <p>At least one feature must be enabled</p>
+</Feature>
+
+<!-- With fallback content -->
+<Feature flag="premium-feature">
+  <p>Premium content</p>
+  <div slot="fallback">
+    <p>Upgrade to unlock this feature</p>
+  </div>
+</Feature>
+
+<!-- Negated (show when disabled) -->
+<Feature flag="old-feature" negate={true}>
+  <p>This shows when the feature is OFF</p>
+</Feature>
+```
+
+### Client-Side Components (Islands)
+
+Use `FeatureClient.astro` for client-side evaluation with hydration:
+
+```astro
+---
+import FeatureClient from '@ops-ai/astro-feature-flags-toggly/components/FeatureClient.astro';
+---
+
+<!-- Hydrate on page load -->
+<FeatureClient flag="interactive-widget" client="load">
+  <InteractiveWidget />
+</FeatureClient>
+
+<!-- Lazy hydration when visible -->
+<FeatureClient flag="below-fold-content" client="visible">
+  <HeavyComponent />
+</FeatureClient>
+
+<!-- Hydrate when browser is idle -->
+<FeatureClient flag="non-critical-feature" client="idle">
+  <NonCriticalContent />
+</FeatureClient>
+```
+
+### Page-Level Gating
+
+Control entire pages using frontmatter:
+
+```astro
+---
+// src/pages/beta-feature.astro
+x-feature: beta-feature
+---
+
+<html>
+  <body>
+    <h1>Beta Feature Page</h1>
+    <p>This entire page is gated by the 'beta-feature' flag</p>
+  </body>
+</html>
+```
+
+During build, the integration generates a `toggly-page-features.json` manifest that can be used with a Cloudflare Worker for true edge enforcement (404s for disabled pages).
+
+### React Integration
+
+Use in React islands:
+
+```tsx
+// Component.tsx
+import { Feature, useFeatureFlag } from '@ops-ai/astro-feature-flags-toggly/react';
+
+// With component
+export function Dashboard() {
+  return (
+    <Feature flag="new-dashboard">
+      <NewDashboard />
+    </Feature>
+  );
+}
+
+// With hook
+export function ConditionalContent() {
+  const { enabled, isReady } = useFeatureFlag('premium-feature');
+
+  if (!isReady) return <Loading />;
+  if (!enabled) return <FreeTier />;
+  return <PremiumTier />;
+}
+```
+
+In your Astro file:
+
+```astro
+---
+import Dashboard from '../components/Dashboard.tsx';
+---
+
+<Dashboard client:load />
+```
+
+### Vue Integration
+
+```vue
+<!-- Component.vue -->
+<script setup>
+import Feature from '@ops-ai/astro-feature-flags-toggly/vue/Feature.vue';
+import { useFeatureFlag } from '@ops-ai/astro-feature-flags-toggly/vue';
+
+const { enabled } = useFeatureFlag('new-feature');
+</script>
+
+<template>
+  <Feature flag="beta-widget">
+    <BetaWidget />
+    <template #fallback>
+      <ComingSoon />
+    </template>
+  </Feature>
+
+  <div v-if="enabled">
+    <p>Feature-controlled content</p>
+  </div>
+</template>
+```
+
+### Svelte Integration
+
+```svelte
+<!-- Component.svelte -->
+<script>
+import Feature from '@ops-ai/astro-feature-flags-toggly/svelte/Feature.svelte';
+import { featureFlag } from '@ops-ai/astro-feature-flags-toggly/svelte';
+
+const newDashboard = featureFlag('new-dashboard');
+</script>
+
+<Feature flag="beta-feature">
+  <BetaContent />
+  <svelte:fragment slot="fallback">
+    <RegularContent />
+  </svelte:fragment>
+</Feature>
+
+{#if $newDashboard}
+  <NewDashboard />
+{:else}
+  <OldDashboard />
+{/if}
+```
+
+## Configuration Options
+
+```typescript
+interface TogglyConfig {
+  /** Base URI for the Toggly API (default: 'https://client.toggly.io') */
+  baseURI?: string;
+  
+  /** Application key from Toggly */
+  appKey?: string;
+  
+  /** Environment name (default: 'Production') */
+  environment?: string;
+  
+  /** Default flag values to use when API is unavailable */
+  flagDefaults?: Record<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;
+}
+```
+
+## SSR vs SSG Considerations
+
+### SSR (Server-Side Rendering)
+
+- Flags are fetched on each request
+- Fresh flag values for every visitor
+- Slightly slower initial page load
+- Use `output: 'server'` in `astro.config.mjs`
+
+```javascript
+export default defineConfig({
+  output: 'server',
+  // ...
+});
+```
+
+### SSG (Static Site Generation)
+
+- Flags are fetched at build time
+- Same flag values for all visitors
+- Fastest possible page loads
+- Requires rebuild to update flags
+- Use client-side components for dynamic updates
+
+```javascript
+export default defineConfig({
+  output: 'static',
+  // ...
+});
+```
+
+### Hybrid Approach
+
+Use server components for critical gating and client components for non-critical features:
+
+```astro
+---
+import Feature from '@ops-ai/astro-feature-flags-toggly/components/Feature.astro';
+import FeatureClient from '@ops-ai/astro-feature-flags-toggly/components/FeatureClient.astro';
+---
+
+<!-- Critical feature - evaluated at build/request time -->
+<Feature flag="access-control">
+  <SecureContent />
+</Feature>
+
+<!-- Non-critical feature - evaluated on client -->
+<FeatureClient flag="ui-enhancement" client="idle">
+  <EnhancedUI />
+</FeatureClient>
+```
+
+## Advanced Usage
+
+### User Identity for Targeting
+
+```typescript
+// In middleware or component
+import { setIdentity } from '@ops-ai/astro-feature-flags-toggly';
+
+// Set user identity for targeting
+setIdentity('user-123');
+
+// Clear identity (e.g., on logout)
+import { clearIdentity } from '@ops-ai/astro-feature-flags-toggly';
+clearIdentity();
+```
+
+### Manual Flag Refresh
+
+```typescript
+import { refreshFlags } from '@ops-ai/astro-feature-flags-toggly';
+
+// Manually refresh flags
+await refreshFlags();
+```
+
+### Programmatic Flag Evaluation
+
+In server-side code:
+
+```typescript
+const toggly = Astro.locals.toggly;
+
+const isEnabled = await toggly.getFlag('feature-key');
+const allFlags = await toggly.getFlags();
+```
+
+## Edge Enforcement (Optional)
+
+For true enforcement at the edge (prevents page access even if client-side JS is disabled):
+
+1. The integration generates `toggly-page-features.json` during build
+2. Deploy a Cloudflare Worker that reads this manifest
+3. The worker intercepts requests and returns 404 for disabled pages
+
+See the [Cloudflare Worker integration guide](https://github.com/ops-ai/Toggly.CloudflareWorker) for setup instructions.
+
+## TypeScript Support
+
+Full TypeScript support is included:
+
+```typescript
+import type {
+  TogglyConfig,
+  Flags,
+  TogglyClient,
+  FeatureProps,
+} from '@ops-ai/astro-feature-flags-toggly';
+
+// Augmented Astro global
+Astro.locals.toggly; // Typed as TogglyClient
+```
+
+## Best Practices
+
+1. **Use Server Components When Possible** - Better performance, no client-side JavaScript
+2. **Set Flag Defaults** - Always provide fallback values for offline scenarios
+3. **Use Environment Variables** - Never hardcode credentials
+4. **Enable Debug Mode in Development** - Helps troubleshoot issues
+5. **Cache Appropriately** - Adjust `featureFlagsRefreshInterval` based on your needs
+6. **Provide User Identity** - Required for targeting and consistent rollouts
+7. **Consider SSR vs SSG** - Choose based on how dynamic your flags need to be
+8. **Use Page-Level Gating** - For entire pages, use frontmatter instead of wrapping all content
+
+## Troubleshooting
+
+### Flags not loading
+
+1. Check that the integration is properly configured in `astro.config.mjs`
+2. Verify `appKey` and `environment` are correct
+3. Enable debug mode: `isDebug: true`
+4. Check browser console and server logs
+
+### TypeScript errors
+
+Make sure you have the necessary dependencies:
+
+```bash
+npm install -D @types/node astro
+```
+
+### Client components not hydrating
+
+Ensure you're using the correct hydration directive:
+
+```astro
+<FeatureClient flag="test" client="load">
+  <!-- content -->
+</FeatureClient>
+```
+
+### Middleware not working
+
+Verify middleware is properly configured in `src/middleware.ts` and exported as `onRequest`.
+
+## Examples
+
+Check the `examples/` directory for complete working examples:
+
+- Basic Astro + Toggly setup
+- SSR with feature flags
+- SSG with client-side updates
+- React/Vue/Svelte islands
+
+## License
+
+MIT
+
+## Support
+
+- [Documentation](https://docs.toggly.io)
+- [GitHub Issues](https://github.com/ops-ai/Toggly.FeatureManagement/issues)
+- [Discord Community](https://discord.gg/toggly)
+
+## Related
+
+- [@ops-ai/toggly-docusaurus-plugin](https://www.npmjs.com/package/@ops-ai/toggly-docusaurus-plugin) - Docusaurus integration
+- [@ops-ai/react-feature-flags-toggly](https://www.npmjs.com/package/@ops-ai/react-feature-flags-toggly) - React SDK
+- [@ops-ai/feature-flags-toggly](https://www.npmjs.com/package/@ops-ai/feature-flags-toggly) - Vanilla JavaScript SDK
+
+

package/dist/chunk-354E3C57.js

@@ -0,0 +1,173 @@
+import {
+  createTogglyServerClient
+} from "./chunk-XQGKGTBK.js";
+
+// src/integration/index.ts
+import * as fs from "fs";
+import * as path from "path";
+import { glob } from "glob";
+function togglyIntegration(options = {}) {
+  const config = {
+    baseURI: "https://client.toggly.io",
+    environment: "Production",
+    flagDefaults: {},
+    featureFlagsRefreshInterval: 3 * 60 * 1e3,
+    isDebug: false,
+    connectTimeout: 5 * 1e3,
+    ...options
+  };
+  let pageFeatureMapping = {};
+  let astroConfig;
+  return {
+    name: "@ops-ai/astro-feature-flags-toggly",
+    hooks: {
+      "astro:config:setup": async ({ config: cfg, injectScript, updateConfig }) => {
+        astroConfig = cfg;
+        if (config.isDebug) {
+          console.log("[Toggly Integration] Setting up integration...");
+        }
+        injectScript(
+          "page",
+          `
+          window.__TOGGLY_CONFIG__ = ${JSON.stringify(config)};
+          import('@ops-ai/astro-feature-flags-toggly/client/setup');
+        `
+        );
+        updateConfig({
+          vite: {
+            ssr: {
+              noExternal: ["@ops-ai/astro-feature-flags-toggly"]
+            }
+          }
+        });
+      },
+      "astro:server:setup": async ({ server }) => {
+        if (config.isDebug) {
+          console.log("[Toggly Integration] Server setup...");
+        }
+        const togglyClient = createTogglyServerClient(config);
+        server.middlewares.use((req, res, next) => {
+          req.togglyClient = togglyClient;
+          next();
+        });
+      },
+      "astro:build:start": async () => {
+        if (config.isDebug) {
+          console.log("[Toggly Integration] Build started, extracting frontmatter...");
+        }
+        pageFeatureMapping = await extractPageFeatures(astroConfig, config.isDebug);
+        if (config.isDebug) {
+          console.log(
+            `[Toggly Integration] Found ${Object.keys(pageFeatureMapping).length} pages with x-feature`
+          );
+          Object.entries(pageFeatureMapping).forEach(([route, feature]) => {
+            console.log(`  ${route} -> ${feature}`);
+          });
+        }
+      },
+      "astro:build:done": async ({ dir }) => {
+        if (config.isDebug) {
+          console.log("[Toggly Integration] Build done, writing manifest...");
+        }
+        const manifestPath = path.join(dir.pathname, "toggly-page-features.json");
+        fs.writeFileSync(manifestPath, JSON.stringify(pageFeatureMapping, null, 2), "utf-8");
+        if (config.isDebug) {
+          console.log(`[Toggly Integration] Manifest written to: ${manifestPath}`);
+        }
+        const configPath = path.join(dir.pathname, "toggly-config.json");
+        fs.writeFileSync(
+          configPath,
+          JSON.stringify(
+            {
+              ...config,
+              // Don't expose appKey in public build output
+              appKey: config.appKey ? "***" : void 0
+            },
+            null,
+            2
+          ),
+          "utf-8"
+        );
+      },
+      "astro:config:done": ({ config: cfg, setAdapter }) => {
+        astroConfig = cfg;
+        if (config.isDebug) {
+          console.log("[Toggly Integration] Configuration finalized");
+        }
+      }
+    }
+  };
+}
+async function extractPageFeatures(astroConfig, isDebug) {
+  const mapping = {};
+  const srcDir = astroConfig.srcDir?.pathname || path.join(process.cwd(), "src");
+  const pagesDir = path.join(srcDir, "pages");
+  const contentDir = path.join(srcDir, "content");
+  const dirsToScan = [];
+  if (fs.existsSync(pagesDir)) {
+    dirsToScan.push(pagesDir);
+  }
+  if (fs.existsSync(contentDir)) {
+    dirsToScan.push(contentDir);
+  }
+  if (dirsToScan.length === 0) {
+    if (isDebug) {
+      console.warn("[Toggly Integration] No pages or content directories found");
+    }
+    return mapping;
+  }
+  for (const dir of dirsToScan) {
+    const files = await glob("**/*.{astro,md,mdx}", {
+      cwd: dir,
+      absolute: false,
+      ignore: ["node_modules/**", "**/node_modules/**"]
+    });
+    for (const file of files) {
+      const filePath = path.join(dir, file);
+      const content = fs.readFileSync(filePath, "utf-8");
+      const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+      if (!frontmatterMatch) {
+        continue;
+      }
+      const frontmatter = frontmatterMatch[1];
+      const xFeatureMatch = frontmatter.match(/^x-feature:\s*(.+)$/m);
+      if (!xFeatureMatch) {
+        continue;
+      }
+      let featureKey = xFeatureMatch[1].trim();
+      featureKey = featureKey.replace(/^["']|["']$/g, "");
+      let route = convertFilePathToRoute(file, dir === pagesDir);
+      const base = astroConfig.base || "/";
+      if (base !== "/") {
+        route = path.join(base, route).replace(/\\/g, "/");
+      }
+      mapping[route] = featureKey;
+    }
+  }
+  return mapping;
+}
+function convertFilePathToRoute(filePath, isPages) {
+  let route = filePath.replace(/\.(astro|md|mdx)$/, "");
+  route = route.split("/").map((segment) => segment.replace(/^\d+-/, "")).join("/");
+  if (route.endsWith("/index") || route === "index") {
+    route = route.replace(/\/index$/, "") || "/";
+  }
+  if (!route.startsWith("/")) {
+    route = "/" + route;
+  }
+  return route;
+}
+function createTogglyMiddleware(config) {
+  return async function togglyMiddleware({ locals }, next) {
+    if (!locals.toggly) {
+      locals.toggly = createTogglyServerClient(config);
+    }
+    return next();
+  };
+}
+
+export {
+  togglyIntegration,
+  createTogglyMiddleware
+};
+//# sourceMappingURL=chunk-354E3C57.js.map

package/dist/chunk-354E3C57.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/integration/index.ts"],"sourcesContent":["/**\n * Toggly Astro Integration\n * \n * Provides build-time configuration, frontmatter extraction, and runtime injection\n */\n\nimport type { AstroIntegration, AstroConfig } from 'astro';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { glob } from 'glob';\nimport type { TogglyConfig, PageFeatureMapping } from '../types/index.js';\nimport { createTogglyServerClient } from '../server/toggly-server.js';\n\nexport interface TogglyIntegrationOptions extends TogglyConfig {}\n\n/**\n * Toggly Astro Integration\n */\nexport default function togglyIntegration(\n  options: TogglyIntegrationOptions = {}\n): AstroIntegration {\n  const config: TogglyConfig = {\n    baseURI: 'https://client.toggly.io',\n    environment: 'Production',\n    flagDefaults: {},\n    featureFlagsRefreshInterval: 3 * 60 * 1000,\n    isDebug: false,\n    connectTimeout: 5 * 1000,\n    ...options,\n  };\n\n  let pageFeatureMapping: PageFeatureMapping = {};\n  let astroConfig: AstroConfig;\n\n  return {\n    name: '@ops-ai/astro-feature-flags-toggly',\n    hooks: {\n      'astro:config:setup': async ({ config: cfg, injectScript, updateConfig }) => {\n        astroConfig = cfg;\n\n        if (config.isDebug) {\n          console.log('[Toggly Integration] Setting up integration...');\n        }\n\n        // Inject client setup script\n        injectScript(\n          'page',\n          `\n          window.__TOGGLY_CONFIG__ = ${JSON.stringify(config)};\n          import('@ops-ai/astro-feature-flags-toggly/client/setup');\n        `\n        );\n\n        // Add middleware to inject Toggly client into Astro.locals\n        updateConfig({\n          vite: {\n            ssr: {\n              noExternal: ['@ops-ai/astro-feature-flags-toggly'],\n            },\n          },\n        });\n      },\n\n      'astro:server:setup': async ({ server }) => {\n        if (config.isDebug) {\n          console.log('[Toggly Integration] Server setup...');\n        }\n\n        // Create server client for SSR\n        const togglyClient = createTogglyServerClient(config);\n\n        // Inject into server context (this will be available in SSR)\n        server.middlewares.use((req, res, next) => {\n          // @ts-ignore - Adding toggly to request\n          req.togglyClient = togglyClient;\n          next();\n        });\n      },\n\n      'astro:build:start': async () => {\n        if (config.isDebug) {\n          console.log('[Toggly Integration] Build started, extracting frontmatter...');\n        }\n\n        // Extract page feature mapping from frontmatter\n        pageFeatureMapping = await extractPageFeatures(astroConfig, config.isDebug);\n\n        if (config.isDebug) {\n          console.log(\n            `[Toggly Integration] Found ${Object.keys(pageFeatureMapping).length} pages with x-feature`\n          );\n          Object.entries(pageFeatureMapping).forEach(([route, feature]) => {\n            console.log(`  ${route} -> ${feature}`);\n          });\n        }\n      },\n\n      'astro:build:done': async ({ dir }) => {\n        if (config.isDebug) {\n          console.log('[Toggly Integration] Build done, writing manifest...');\n        }\n\n        // Write page feature manifest for edge workers\n        const manifestPath = path.join(dir.pathname, 'toggly-page-features.json');\n        fs.writeFileSync(manifestPath, JSON.stringify(pageFeatureMapping, null, 2), 'utf-8');\n\n        if (config.isDebug) {\n          console.log(`[Toggly Integration] Manifest written to: ${manifestPath}`);\n        }\n\n        // Also write config for reference\n        const configPath = path.join(dir.pathname, 'toggly-config.json');\n        fs.writeFileSync(\n          configPath,\n          JSON.stringify(\n            {\n              ...config,\n              // Don't expose appKey in public build output\n              appKey: config.appKey ? '***' : undefined,\n            },\n            null,\n            2\n          ),\n          'utf-8'\n        );\n      },\n\n      'astro:config:done': ({ config: cfg, setAdapter }) => {\n        // Store final config\n        astroConfig = cfg;\n\n        if (config.isDebug) {\n          console.log('[Toggly Integration] Configuration finalized');\n        }\n      },\n    },\n  };\n}\n\n/**\n * Extract x-feature frontmatter from pages\n */\nasync function extractPageFeatures(\n  astroConfig: AstroConfig,\n  isDebug?: boolean\n): Promise<PageFeatureMapping> {\n  const mapping: PageFeatureMapping = {};\n\n  // Determine source directory\n  const srcDir = astroConfig.srcDir?.pathname || path.join(process.cwd(), 'src');\n  const pagesDir = path.join(srcDir, 'pages');\n  const contentDir = path.join(srcDir, 'content');\n\n  // Check if directories exist\n  const dirsToScan: string[] = [];\n  if (fs.existsSync(pagesDir)) {\n    dirsToScan.push(pagesDir);\n  }\n  if (fs.existsSync(contentDir)) {\n    dirsToScan.push(contentDir);\n  }\n\n  if (dirsToScan.length === 0) {\n    if (isDebug) {\n      console.warn('[Toggly Integration] No pages or content directories found');\n    }\n    return mapping;\n  }\n\n  for (const dir of dirsToScan) {\n    // Find all .astro, .md, .mdx files\n    const files = await glob('**/*.{astro,md,mdx}', {\n      cwd: dir,\n      absolute: false,\n      ignore: ['node_modules/**', '**/node_modules/**'],\n    });\n\n    for (const file of files) {\n      const filePath = path.join(dir, file);\n      const content = fs.readFileSync(filePath, 'utf-8');\n\n      // Extract frontmatter\n      const frontmatterMatch = content.match(/^---\\s*\\n([\\s\\S]*?)\\n---/);\n      if (!frontmatterMatch) {\n        continue;\n      }\n\n      const frontmatter = frontmatterMatch[1];\n\n      // Look for x-feature in frontmatter\n      const xFeatureMatch = frontmatter.match(/^x-feature:\\s*(.+)$/m);\n      if (!xFeatureMatch) {\n        continue;\n      }\n\n      let featureKey = xFeatureMatch[1].trim();\n      // Remove quotes if present\n      featureKey = featureKey.replace(/^[\"']|[\"']$/g, '');\n\n      // Convert file path to route\n      let route = convertFilePathToRoute(file, dir === pagesDir);\n\n      // Prepend base if configured\n      const base = astroConfig.base || '/';\n      if (base !== '/') {\n        route = path.join(base, route).replace(/\\\\/g, '/');\n      }\n\n      mapping[route] = featureKey;\n    }\n  }\n\n  return mapping;\n}\n\n/**\n * Convert file path to Astro route\n */\nfunction convertFilePathToRoute(filePath: string, isPages: boolean): string {\n  // Remove file extension\n  let route = filePath.replace(/\\.(astro|md|mdx)$/, '');\n\n  // Remove numeric prefixes (e.g., 01-intro.md -> intro.md)\n  route = route\n    .split('/')\n    .map((segment) => segment.replace(/^\\d+-/, ''))\n    .join('/');\n\n  // Handle index files\n  if (route.endsWith('/index') || route === 'index') {\n    route = route.replace(/\\/index$/, '') || '/';\n  }\n\n  // Ensure leading slash\n  if (!route.startsWith('/')) {\n    route = '/' + route;\n  }\n\n  // For content collections, prepend with collection name if not pages\n  // This is a simplification - Astro content collections have more complex routing\n\n  return route;\n}\n\n/**\n * Astro middleware to inject Toggly into locals\n * This should be added to src/middleware.ts in the user's project\n */\nexport function createTogglyMiddleware(config: TogglyConfig) {\n  return async function togglyMiddleware(\n    { locals }: { locals: Record<string, any> },\n    next: () => Promise<Response>\n  ): Promise<Response> {\n    // Create or reuse Toggly client\n    if (!locals.toggly) {\n      locals.toggly = createTogglyServerClient(config);\n    }\n\n    return next();\n  };\n}\n\n\n"],"mappings":"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","names":[]}