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

package/dist/frameworks/vue/composables.js

@@ -0,0 +1,39 @@
+import {
+  $flags,
+  $isReady
+} from "../../chunk-FK633ULF.js";
+
+// src/frameworks/vue/composables.ts
+import { computed } from "vue";
+import { useStore } from "@nanostores/vue";
+function useFeatureFlag(flagKey, defaultValue = false) {
+  const flags = useStore($flags);
+  const isReady = useStore($isReady);
+  const enabled = computed(() => flags.value[flagKey] ?? defaultValue);
+  return { enabled, isReady };
+}
+function useFeatureGate(flagKeys, requirement = "all", negate = false) {
+  const flags = useStore($flags);
+  const isReady = useStore($isReady);
+  const enabled = computed(() => {
+    if (flagKeys.length === 0) {
+      return !negate;
+    }
+    let isEnabled;
+    if (requirement === "any") {
+      isEnabled = flagKeys.some((key) => flags.value[key] === true);
+    } else {
+      isEnabled = flagKeys.every((key) => flags.value[key] === true);
+    }
+    if (negate) {
+      isEnabled = !isEnabled;
+    }
+    return isEnabled;
+  });
+  return { enabled, isReady };
+}
+export {
+  useFeatureFlag,
+  useFeatureGate
+};
+//# sourceMappingURL=composables.js.map

package/dist/frameworks/vue/composables.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/frameworks/vue/composables.ts"],"sourcesContent":["/**\n * Vue Composables for Toggly\n */\n\nimport { computed, type Ref } from 'vue';\nimport { useStore } from '@nanostores/vue';\nimport { $flags, $isReady } from '../../client/store.js';\n\n/**\n * Hook to check if a feature flag is enabled\n * \n * @param flagKey - Feature flag key to check\n * @param defaultValue - Default value if flag not found (default: false)\n * @returns Object with enabled state and ready state\n * \n * @example\n * ```vue\n * <script setup>\n * const { enabled, isReady } = useFeatureFlag('new-dashboard');\n * </script>\n * \n * <template>\n *   <Loading v-if=\"!isReady\" />\n *   <NewDashboard v-else-if=\"enabled\" />\n *   <OldDashboard v-else />\n * </template>\n * ```\n */\nexport function useFeatureFlag(\n  flagKey: string,\n  defaultValue: boolean = false\n): {\n  enabled: Readonly<Ref<boolean>>;\n  isReady: Readonly<Ref<boolean>>;\n} {\n  const flags = useStore($flags);\n  const isReady = useStore($isReady);\n\n  const enabled = computed(() => flags.value[flagKey] ?? defaultValue);\n\n  return { enabled, isReady };\n}\n\n/**\n * Hook to check if multiple feature flags are enabled\n * \n * @param flagKeys - Array of feature flag keys to check\n * @param requirement - 'all' or 'any' (default: 'all')\n * @param negate - If true, negates the result (default: false)\n * @returns Object with enabled state and ready state\n * \n * @example\n * ```vue\n * <script setup>\n * const { enabled } = useFeatureGate(['feature1', 'feature2'], 'any');\n * </script>\n * \n * <template>\n *   <NewFeatures v-if=\"enabled\" />\n *   <OldFeatures v-else />\n * </template>\n * ```\n */\nexport function useFeatureGate(\n  flagKeys: string[],\n  requirement: 'all' | 'any' = 'all',\n  negate: boolean = false\n): {\n  enabled: Readonly<Ref<boolean>>;\n  isReady: Readonly<Ref<boolean>>;\n} {\n  const flags = useStore($flags);\n  const isReady = useStore($isReady);\n\n  const enabled = computed(() => {\n    if (flagKeys.length === 0) {\n      return !negate;\n    }\n\n    let isEnabled: boolean;\n\n    if (requirement === 'any') {\n      isEnabled = flagKeys.some((key) => flags.value[key] === true);\n    } else {\n      isEnabled = flagKeys.every((key) => flags.value[key] === true);\n    }\n\n    if (negate) {\n      isEnabled = !isEnabled;\n    }\n\n    return isEnabled;\n  });\n\n  return { enabled, isReady };\n}\n\n\n"],"mappings":";;;;;;AAIA,SAAS,gBAA0B;AACnC,SAAS,gBAAgB;AAuBlB,SAAS,eACd,SACA,eAAwB,OAIxB;AACA,QAAM,QAAQ,SAAS,MAAM;AAC7B,QAAM,UAAU,SAAS,QAAQ;AAEjC,QAAM,UAAU,SAAS,MAAM,MAAM,MAAM,OAAO,KAAK,YAAY;AAEnE,SAAO,EAAE,SAAS,QAAQ;AAC5B;AAsBO,SAAS,eACd,UACA,cAA6B,OAC7B,SAAkB,OAIlB;AACA,QAAM,QAAQ,SAAS,MAAM;AAC7B,QAAM,UAAU,SAAS,QAAQ;AAEjC,QAAM,UAAU,SAAS,MAAM;AAC7B,QAAI,SAAS,WAAW,GAAG;AACzB,aAAO,CAAC;AAAA,IACV;AAEA,QAAI;AAEJ,QAAI,gBAAgB,OAAO;AACzB,kBAAY,SAAS,KAAK,CAAC,QAAQ,MAAM,MAAM,GAAG,MAAM,IAAI;AAAA,IAC9D,OAAO;AACL,kBAAY,SAAS,MAAM,CAAC,QAAQ,MAAM,MAAM,GAAG,MAAM,IAAI;AAAA,IAC/D;AAEA,QAAI,QAAQ;AACV,kBAAY,CAAC;AAAA,IACf;AAEA,WAAO;AAAA,EACT,CAAC;AAED,SAAO,EAAE,SAAS,QAAQ;AAC5B;","names":[]}

package/dist/index-S3g0i0FH.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Toggly Astro SDK - Type Definitions
+ */
+/**
+ * Configuration options for Toggly integration
+ */
+interface TogglyConfig {
+    /** 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?: 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;
+}
+/**
+ * Map of feature flag keys to their boolean values
+ */
+type Flags = Record<string, boolean>;
+/**
+ * Toggly client instance interface
+ */
+interface TogglyClient {
+    /**
+     * Get all feature flags as a map of key-value pairs
+     * @returns Promise resolving to a map of flag keys to boolean values
+     */
+    getFlags(): Promise<Flags>;
+    /**
+     * Get a single feature flag value
+     * @param key - The feature flag key
+     * @param defaultValue - Optional default value if flag is not found (default: false)
+     * @returns Promise resolving to the flag's boolean value
+     */
+    getFlag(key: string, defaultValue?: boolean): Promise<boolean>;
+    /**
+     * Evaluate a feature gate with multiple flags
+     * @param keys - Array of feature flag keys to evaluate
+     * @param requirement - 'all' requires all flags to be true, 'any' requires at least one
+     * @param negate - If true, negates the result
+     * @returns Promise resolving to boolean evaluation result
+     */
+    evaluateGate(keys: string[], requirement?: 'all' | 'any', negate?: boolean): Promise<boolean>;
+    /**
+     * Manually refresh the feature flags cache by fetching from the API
+     * @returns Promise that resolves when flags have been refreshed
+     */
+    refreshFlags(): Promise<void>;
+}
+/**
+ * Page feature mapping for frontmatter extraction
+ */
+interface PageFeatureMapping {
+    [routePath: string]: string;
+}
+/**
+ * Props for Feature component
+ */
+interface FeatureProps {
+    /** Single feature flag key to check */
+    flag?: string;
+    /** Multiple feature flag keys to check */
+    flags?: string[];
+    /** Requirement for multiple flags: 'all' or 'any' (default: 'all') */
+    requirement?: 'all' | 'any';
+    /** If true, negates the result (default: false) */
+    negate?: boolean;
+}
+/**
+ * Props for FeatureClient component
+ */
+interface FeatureClientProps {
+    /** Feature flag key to check */
+    flag: string;
+    /** Hydration strategy: 'load', 'idle', or 'visible' */
+    client?: 'load' | 'idle' | 'visible';
+}
+/**
+ * Augment Astro global types
+ */
+declare global {
+    namespace App {
+        interface Locals {
+            toggly: TogglyClient;
+        }
+    }
+    interface Window {
+        __TOGGLY_CONFIG__?: TogglyConfig;
+        __TOGGLY_PAGE_FEATURES__?: PageFeatureMapping;
+    }
+}
+
+export type { Flags as F, PageFeatureMapping as P, TogglyConfig as T, TogglyClient as a, FeatureProps as b, FeatureClientProps as c };

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { TogglyIntegrationOptions, createTogglyMiddleware, default as togglyIntegration } from './integration/index.js';
+export { TogglyServer, createTogglyServerClient } from './server/toggly-server.js';
+export { allFeaturesEnabled, anyFeatureEnabled, getTogglyFromAstroGlobal, withFeatureFlag } from './server/utils.js';
+export { $error, $flag, $flags, $gate, $isReady, clearIdentity, initTogglyClient, refreshFlags, setIdentity, stopRefreshInterval } from './client/store.js';
+export { c as FeatureClientProps, b as FeatureProps, F as Flags, P as PageFeatureMapping, a as TogglyClient, T as TogglyConfig } from './index-S3g0i0FH.js';
+import 'astro';
+import 'nanostores';

package/dist/index.js

@@ -0,0 +1,47 @@
+import {
+  createTogglyMiddleware,
+  togglyIntegration
+} from "./chunk-354E3C57.js";
+import {
+  TogglyServer,
+  createTogglyServerClient
+} from "./chunk-XQGKGTBK.js";
+import {
+  allFeaturesEnabled,
+  anyFeatureEnabled,
+  getTogglyFromAstroGlobal,
+  withFeatureFlag
+} from "./chunk-4UKIT2NP.js";
+import {
+  $error,
+  $flag,
+  $flags,
+  $gate,
+  $isReady,
+  clearIdentity,
+  initTogglyClient,
+  refreshFlags,
+  setIdentity,
+  stopRefreshInterval
+} from "./chunk-FK633ULF.js";
+export {
+  $error,
+  $flag,
+  $flags,
+  $gate,
+  $isReady,
+  TogglyServer,
+  allFeaturesEnabled,
+  anyFeatureEnabled,
+  clearIdentity,
+  createTogglyMiddleware,
+  createTogglyServerClient,
+  getTogglyFromAstroGlobal,
+  initTogglyClient,
+  refreshFlags,
+  setIdentity,
+  stopRefreshInterval,
+  togglyIntegration,
+  withFeatureFlag
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/integration/index.d.ts

@@ -0,0 +1,24 @@
+import { AstroIntegration } from 'astro';
+import { T as TogglyConfig } from '../index-S3g0i0FH.js';
+
+/**
+ * Toggly Astro Integration
+ *
+ * Provides build-time configuration, frontmatter extraction, and runtime injection
+ */
+
+interface TogglyIntegrationOptions extends TogglyConfig {
+}
+/**
+ * Toggly Astro Integration
+ */
+declare function togglyIntegration(options?: TogglyIntegrationOptions): AstroIntegration;
+/**
+ * Astro middleware to inject Toggly into locals
+ * This should be added to src/middleware.ts in the user's project
+ */
+declare function createTogglyMiddleware(config: TogglyConfig): ({ locals }: {
+    locals: Record<string, any>;
+}, next: () => Promise<Response>) => Promise<Response>;
+
+export { type TogglyIntegrationOptions, createTogglyMiddleware, togglyIntegration as default };

package/dist/integration/index.js

@@ -0,0 +1,10 @@
+import {
+  createTogglyMiddleware,
+  togglyIntegration
+} from "../chunk-354E3C57.js";
+import "../chunk-XQGKGTBK.js";
+export {
+  createTogglyMiddleware,
+  togglyIntegration as default
+};
+//# sourceMappingURL=index.js.map

package/dist/integration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/server/toggly-server.d.ts

@@ -0,0 +1,53 @@
+import { T as TogglyConfig, a as TogglyClient, F as Flags } from '../index-S3g0i0FH.js';
+
+/**
+ * Toggly Server-Side Client for Astro SSR/SSG
+ *
+ * This module provides server-side feature flag evaluation for Astro applications.
+ * It caches flags for SSG builds and fetches fresh flags for SSR requests.
+ * This is a complete, embedded Toggly client implementation.
+ */
+
+/**
+ * Server-side Toggly client implementation
+ */
+declare class TogglyServer implements TogglyClient {
+    private config;
+    private cache;
+    private fetchPromise;
+    constructor(config: TogglyConfig);
+    /**
+     * Get API URL for fetching flags
+     */
+    private getApiUrl;
+    /**
+     * Check if cache is valid
+     */
+    private isCacheValid;
+    /**
+     * Fetch flags from Toggly API
+     */
+    private fetchFlags;
+    /**
+     * Refresh flags cache
+     */
+    refreshFlags(): Promise<void>;
+    /**
+     * Get all feature flags
+     */
+    getFlags(): Promise<Flags>;
+    /**
+     * Get a single feature flag value
+     */
+    getFlag(key: string, defaultValue?: boolean): Promise<boolean>;
+    /**
+     * Evaluate a feature gate with multiple flags
+     */
+    evaluateGate(keys: string[], requirement?: 'all' | 'any', negate?: boolean): Promise<boolean>;
+}
+/**
+ * Create a new Toggly server-side client instance
+ */
+declare function createTogglyServerClient(config: TogglyConfig): TogglyServer;
+
+export { TogglyServer, createTogglyServerClient };

package/dist/server/toggly-server.js

@@ -0,0 +1,9 @@
+import {
+  TogglyServer,
+  createTogglyServerClient
+} from "../chunk-XQGKGTBK.js";
+export {
+  TogglyServer,
+  createTogglyServerClient
+};
+//# sourceMappingURL=toggly-server.js.map

package/dist/server/toggly-server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/server/utils.d.ts

@@ -0,0 +1,43 @@
+import { AstroGlobal } from 'astro';
+import { a as TogglyClient } from '../index-S3g0i0FH.js';
+
+/**
+ * Toggly Server Utilities for Astro
+ *
+ * Helper functions for server-side feature flag evaluation
+ */
+
+/**
+ * Get Toggly client from Astro global
+ *
+ * @param Astro - Astro global object
+ * @returns TogglyClient instance
+ * @throws Error if Toggly client is not initialized
+ */
+declare function getTogglyFromAstroGlobal(Astro: AstroGlobal): TogglyClient;
+/**
+ * Higher-order function for page-level feature gating
+ *
+ * @param featureKey - Feature flag key to check
+ * @param Astro - Astro global object
+ * @returns Boolean indicating if feature is enabled
+ */
+declare function withFeatureFlag(featureKey: string, Astro: AstroGlobal): Promise<boolean>;
+/**
+ * Check if any of the provided feature flags are enabled
+ *
+ * @param featureKeys - Array of feature flag keys to check
+ * @param Astro - Astro global object
+ * @returns Boolean indicating if any feature is enabled
+ */
+declare function anyFeatureEnabled(featureKeys: string[], Astro: AstroGlobal): Promise<boolean>;
+/**
+ * Check if all of the provided feature flags are enabled
+ *
+ * @param featureKeys - Array of feature flag keys to check
+ * @param Astro - Astro global object
+ * @returns Boolean indicating if all features are enabled
+ */
+declare function allFeaturesEnabled(featureKeys: string[], Astro: AstroGlobal): Promise<boolean>;
+
+export { allFeaturesEnabled, anyFeatureEnabled, getTogglyFromAstroGlobal, withFeatureFlag };

package/dist/server/utils.js

@@ -0,0 +1,13 @@
+import {
+  allFeaturesEnabled,
+  anyFeatureEnabled,
+  getTogglyFromAstroGlobal,
+  withFeatureFlag
+} from "../chunk-4UKIT2NP.js";
+export {
+  allFeaturesEnabled,
+  anyFeatureEnabled,
+  getTogglyFromAstroGlobal,
+  withFeatureFlag
+};
+//# sourceMappingURL=utils.js.map

package/dist/server/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "@ops-ai/astro-feature-flags-toggly",
+  "version": "1.0.0",
+  "description": "Toggly feature flags SDK for Astro with SSR, SSG, and framework support",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./integration": {
+      "types": "./dist/integration/index.d.ts",
+      "import": "./dist/integration/index.js"
+    },
+    "./components/Feature.astro": "./dist/components/Feature.astro",
+    "./components/FeatureClient.astro": "./dist/components/FeatureClient.astro",
+    "./react": {
+      "types": "./dist/frameworks/react/index.d.ts",
+      "import": "./dist/frameworks/react/index.js"
+    },
+    "./vue": {
+      "types": "./dist/frameworks/vue/index.d.ts",
+      "import": "./dist/frameworks/vue/index.js"
+    },
+    "./vue/Feature.vue": "./dist/frameworks/vue/Feature.vue",
+    "./svelte": {
+      "types": "./dist/frameworks/svelte/index.d.ts",
+      "import": "./dist/frameworks/svelte/index.js"
+    },
+    "./svelte/Feature.svelte": "./dist/frameworks/svelte/Feature.svelte"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup && npm run copy-components",
+    "copy-components": "mkdir -p dist/components dist/frameworks/vue dist/frameworks/svelte && cp src/components/*.astro dist/components/ && cp src/frameworks/vue/*.vue dist/frameworks/vue/ && cp src/frameworks/svelte/*.svelte dist/frameworks/svelte/",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "astro",
+    "feature-flags",
+    "toggly",
+    "feature-toggle",
+    "ssr",
+    "ssg"
+  ],
+  "author": "Ops.AI <hello@ops.ai>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ops-ai/Toggly.FeatureManagement"
+  },
+  "dependencies": {
+    "glob": "^10.3.10"
+  },
+  "devDependencies": {
+    "@astrojs/check": "^0.9.0",
+    "@nanostores/react": "^1.0.0",
+    "@nanostores/vue": "^1.0.1",
+    "@types/node": "^20.11.0",
+    "@types/react": "^19.2.7",
+    "astro": "^5.16.0",
+    "react": "^19.2.3",
+    "svelte": "^5.46.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.3",
+    "vue": "^3.5.26"
+  },
+  "peerDependencies": {
+    "@nanostores/react": "^1.0.0",
+    "@nanostores/svelte": "^0.10.0",
+    "@nanostores/vue": "^1.0.0",
+    "astro": "^5.0.0",
+    "nanostores": "^1.0.0",
+    "react": ">=18.0.0",
+    "svelte": ">=4.0.0",
+    "vue": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@nanostores/react": {
+      "optional": true
+    },
+    "@nanostores/svelte": {
+      "optional": true
+    },
+    "@nanostores/vue": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  }
+}