@flagify/astro 1.0.0

package/README.md

@@ -0,0 +1,127 @@
+# @flagify/astro
+
+Official [Flagify](https://flagify.dev) integration for [Astro](https://astro.build). Evaluate feature flags in Astro pages and components with a dev toolbar for overrides.
+
+## Installation
+
+```bash
+npm install @flagify/astro @flagify/node
+# or
+pnpm add @flagify/astro @flagify/node
+```
+
+## Setup
+
+### 1. Add environment variables
+
+```bash
+# .env
+FLAGIFY_PROJECT_KEY=your-project-key
+FLAGIFY_PUBLIC_KEY=pk_dev_xxx
+FLAGIFY_SECRET_KEY=sk_dev_xxx  # optional, for SSR evaluation
+```
+
+### 2. Add the integration
+
+```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config';
+import flagify from '@flagify/astro';
+
+export default defineConfig({
+  integrations: [flagify()],
+});
+```
+
+This automatically registers:
+- **Middleware** that initializes the Flagify client and parses override cookies
+- **Dev toolbar app** for toggling flag overrides during development
+
+## Usage
+
+### Define flags
+
+```ts
+// src/flags.ts
+import { defineFlag } from '@flagify/astro';
+
+export const newCheckout = defineFlag({
+  key: 'new-checkout-flow',
+  description: 'New checkout flow experience',
+  default: false,
+});
+
+export const heroVariant = defineFlag({
+  key: 'hero-variant',
+  description: 'A/B test for hero section',
+  default: 'control',
+  options: [
+    { value: 'control', label: 'Control' },
+    { value: 'variant-a', label: 'Variant A' },
+  ],
+});
+```
+
+### Evaluate in pages/components
+
+```astro
+---
+// src/pages/index.astro
+import { newCheckout, heroVariant } from '../flags';
+
+const isNewCheckout = await newCheckout(Astro);
+const hero = await heroVariant(Astro);
+---
+
+{isNewCheckout && <NewCheckoutBanner />}
+<Hero variant={hero} />
+```
+
+### Flag evaluation priority
+
+1. **Override cookie** — dev overrides from the toolbar take highest priority
+2. **Flagify SDK** — evaluated via `@flagify/node` (cached locally)
+3. **Default value** — the `default` from `defineFlag()`
+
+## Dev Toolbar
+
+In development mode, the Flagify toolbar app lets you set flag overrides as JSON. Overrides are stored in a `flagify-overrides` cookie and persist across page navigations.
+
+## Vercel Flags SDK Adapter
+
+For projects using the [Vercel Flags SDK](https://flags-sdk.dev):
+
+```ts
+import { createFlagifyAdapter } from '@flagify/astro/adapter';
+
+const { adapter } = createFlagifyAdapter();
+
+export const checkout = flag({
+  key: 'new-checkout-flow',
+  adapter: adapter('new-checkout-flow'),
+  defaultValue: false,
+});
+```
+
+## SSG Limitations
+
+In static builds (SSG), flags are evaluated at **build time** without user context. This works for global flags (kill switches, percentage rollouts) but not for user-targeted flags. For user-targeted evaluation, use SSR mode.
+
+## TypeScript
+
+Add type safety for `context.locals`:
+
+```ts
+// src/env.d.ts
+/// <reference types="astro/client" />
+
+declare namespace App {
+  interface Locals {
+    flagifyOverrides: Record<string, unknown>;
+  }
+}
+```
+
+## License
+
+MIT

package/dist/adapter.cjs

@@ -0,0 +1,57 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapter.ts
+var adapter_exports = {};
+__export(adapter_exports, {
+  createFlagifyAdapter: () => createFlagifyAdapter
+});
+module.exports = __toCommonJS(adapter_exports);
+
+// src/client.ts
+var import_node = require("@flagify/node");
+var client = null;
+var clientReady = null;
+async function waitForClient() {
+  if (clientReady) await clientReady;
+  return client;
+}
+
+// src/adapter.ts
+function createFlagifyAdapter(options) {
+  const baseOrigin = options?.origin ?? "https://app.flagify.dev";
+  return {
+    adapter: (key) => ({
+      decide: async ({ entities, defaultValue }) => {
+        const client2 = await waitForClient();
+        if (!client2) return defaultValue;
+        if (entities) {
+          const result = await client2.evaluate(key, entities);
+          return result.value;
+        }
+        return client2.getValue(key, defaultValue);
+      },
+      origin: `${baseOrigin}/flags/${key}`
+    })
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createFlagifyAdapter
+});

package/dist/adapter.d.cts

@@ -0,0 +1,31 @@
+import { FlagifyUser } from '@flagify/node';
+
+interface FlagAdapter<T, E> {
+    decide: (params: {
+        entities?: E;
+        defaultValue?: T;
+    }) => Promise<T>;
+    origin?: string;
+}
+/**
+ * Creates a Flagify adapter compatible with the Vercel Flags SDK.
+ *
+ * ```ts
+ * import { createFlagifyAdapter } from '@flagify/astro/adapter';
+ *
+ * const { adapter } = createFlagifyAdapter();
+ *
+ * export const newCheckout = flag({
+ *   key: 'new-checkout-flow',
+ *   adapter: adapter('new-checkout-flow'),
+ *   defaultValue: false,
+ * });
+ * ```
+ */
+declare function createFlagifyAdapter(options?: {
+    origin?: string;
+}): {
+    adapter: <T>(key: string) => FlagAdapter<T, FlagifyUser>;
+};
+
+export { createFlagifyAdapter };

package/dist/adapter.d.ts

@@ -0,0 +1,31 @@
+import { FlagifyUser } from '@flagify/node';
+
+interface FlagAdapter<T, E> {
+    decide: (params: {
+        entities?: E;
+        defaultValue?: T;
+    }) => Promise<T>;
+    origin?: string;
+}
+/**
+ * Creates a Flagify adapter compatible with the Vercel Flags SDK.
+ *
+ * ```ts
+ * import { createFlagifyAdapter } from '@flagify/astro/adapter';
+ *
+ * const { adapter } = createFlagifyAdapter();
+ *
+ * export const newCheckout = flag({
+ *   key: 'new-checkout-flow',
+ *   adapter: adapter('new-checkout-flow'),
+ *   defaultValue: false,
+ * });
+ * ```
+ */
+declare function createFlagifyAdapter(options?: {
+    origin?: string;
+}): {
+    adapter: <T>(key: string) => FlagAdapter<T, FlagifyUser>;
+};
+
+export { createFlagifyAdapter };

package/dist/adapter.js

@@ -0,0 +1,25 @@
+import {
+  waitForClient
+} from "./chunk-XPJW7PJL.js";
+
+// src/adapter.ts
+function createFlagifyAdapter(options) {
+  const baseOrigin = options?.origin ?? "https://app.flagify.dev";
+  return {
+    adapter: (key) => ({
+      decide: async ({ entities, defaultValue }) => {
+        const client = await waitForClient();
+        if (!client) return defaultValue;
+        if (entities) {
+          const result = await client.evaluate(key, entities);
+          return result.value;
+        }
+        return client.getValue(key, defaultValue);
+      },
+      origin: `${baseOrigin}/flags/${key}`
+    })
+  };
+}
+export {
+  createFlagifyAdapter
+};

package/dist/chunk-XPJW7PJL.js

@@ -0,0 +1,28 @@
+// src/client.ts
+import { Flagify } from "@flagify/node";
+var client = null;
+var clientReady = null;
+function initClient(config) {
+  if (client) return;
+  client = new Flagify(config);
+  clientReady = client.ready();
+}
+function getClient() {
+  return client;
+}
+async function waitForClient() {
+  if (clientReady) await clientReady;
+  return client;
+}
+function destroyClient() {
+  client?.destroy();
+  client = null;
+  clientReady = null;
+}
+
+export {
+  initClient,
+  getClient,
+  waitForClient,
+  destroyClient
+};

package/dist/index.cjs

@@ -0,0 +1,111 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => flagifyIntegration,
+  defineFlag: () => defineFlag,
+  destroyClient: () => destroyClient,
+  getClient: () => getClient,
+  initClient: () => initClient,
+  waitForClient: () => waitForClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/integration.ts
+var import_meta = {};
+var FLAG_ICON = `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M4 15s1-1 4-1 5 2 8 2 4-1 4-1V3s-1 1-4 1-5-2-8-2-4 1-4 1z"/><line x1="4" y1="22" x2="4" y2="15"/></svg>`;
+function flagifyIntegration(_options) {
+  return {
+    name: "@flagify/astro",
+    hooks: {
+      "astro:config:setup": ({
+        addMiddleware,
+        addDevToolbarApp
+      }) => {
+        addMiddleware({
+          entrypoint: "@flagify/astro/middleware",
+          order: "pre"
+        });
+        addDevToolbarApp({
+          id: "flagify-flags",
+          name: "Feature Flags",
+          icon: FLAG_ICON,
+          entrypoint: new URL("./toolbar/app.js", import_meta.url)
+        });
+      }
+    }
+  };
+}
+
+// src/client.ts
+var import_node = require("@flagify/node");
+var client = null;
+var clientReady = null;
+function initClient(config) {
+  if (client) return;
+  client = new import_node.Flagify(config);
+  clientReady = client.ready();
+}
+function getClient() {
+  return client;
+}
+async function waitForClient() {
+  if (clientReady) await clientReady;
+  return client;
+}
+function destroyClient() {
+  client?.destroy();
+  client = null;
+  clientReady = null;
+}
+
+// src/flag.ts
+var OVERRIDE_COOKIE = "flagify-overrides";
+function defineFlag(definition) {
+  const evaluate = async (astro) => {
+    const overrideCookie = astro.cookies.get(OVERRIDE_COOKIE);
+    if (overrideCookie) {
+      try {
+        const overrides = JSON.parse(overrideCookie.value);
+        if (definition.key in overrides) {
+          return overrides[definition.key];
+        }
+      } catch {
+      }
+    }
+    const client2 = getClient();
+    if (!client2) return definition.default;
+    if (typeof definition.default === "boolean") {
+      return client2.isEnabled(definition.key);
+    }
+    return client2.getValue(definition.key, definition.default);
+  };
+  evaluate._definition = definition;
+  return evaluate;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineFlag,
+  destroyClient,
+  getClient,
+  initClient,
+  waitForClient
+});

package/dist/index.d.cts

@@ -0,0 +1,97 @@
+import { FlagifyOptions, FlagifyUser, Flagify } from '@flagify/node';
+
+/**
+ * Options passed to the flagify() integration in astro.config.mjs.
+ */
+interface FlagifyAstroOptions extends FlagifyOptions {
+    /**
+     * Function to extract user context from the request.
+     * Called by middleware on each request.
+     * If not provided, no user context is set.
+     */
+    identify?: (context: {
+        cookies: Record<string, string>;
+        headers: Headers;
+        url: URL;
+    }) => FlagifyUser | undefined;
+}
+/**
+ * Shape of a flag definition passed to defineFlag().
+ */
+interface FlagDefinition<T> {
+    key: string;
+    description?: string;
+    default: T;
+    options?: Array<T | {
+        value: T;
+        label: string;
+    }>;
+}
+/**
+ * What gets stored in context.locals by the middleware.
+ */
+interface FlagifyLocals {
+    flagifyOverrides: Record<string, unknown>;
+}
+
+/**
+ * Astro integration for Flagify feature flags.
+ *
+ * Registers middleware for flag evaluation and a dev toolbar app
+ * for toggling flag overrides during development.
+ *
+ * ```js
+ * // astro.config.mjs
+ * import { defineConfig } from 'astro/config';
+ * import flagify from '@flagify/astro';
+ *
+ * export default defineConfig({
+ *   integrations: [flagify()],
+ * });
+ * ```
+ */
+declare function flagifyIntegration(_options?: FlagifyAstroOptions): {
+    name: string;
+    hooks: Record<string, (params: any) => void>;
+};
+
+interface FlagEvaluator<T> {
+    (astro: {
+        cookies: {
+            get(name: string): {
+                value: string;
+            } | undefined;
+        };
+    }): Promise<T>;
+    _definition: FlagDefinition<T>;
+}
+/**
+ * Define a feature flag that can be evaluated in Astro pages and components.
+ *
+ * Returns an async function that accepts the Astro global object
+ * and resolves the flag value with this priority:
+ * 1. Override cookie value (for dev testing)
+ * 2. Flagify SDK evaluation
+ * 3. Default fallback
+ */
+declare function defineFlag<T>(definition: FlagDefinition<T>): FlagEvaluator<T>;
+
+/**
+ * Initialize the singleton Flagify client.
+ * Subsequent calls are no-ops if the client already exists.
+ */
+declare function initClient(config: FlagifyOptions): void;
+/**
+ * Returns the singleton Flagify client, or null if not initialized.
+ */
+declare function getClient(): Flagify | null;
+/**
+ * Waits for the client to complete its initial flag sync.
+ */
+declare function waitForClient(): Promise<Flagify | null>;
+/**
+ * Destroy the singleton client and free resources.
+ */
+declare function destroyClient(): void;
+
+export { type FlagDefinition, type FlagEvaluator, type FlagifyAstroOptions, type FlagifyLocals, flagifyIntegration as default, defineFlag, destroyClient, getClient, initClient, waitForClient };

package/dist/index.d.ts

@@ -0,0 +1,97 @@
+import { FlagifyOptions, FlagifyUser, Flagify } from '@flagify/node';
+
+/**
+ * Options passed to the flagify() integration in astro.config.mjs.
+ */
+interface FlagifyAstroOptions extends FlagifyOptions {
+    /**
+     * Function to extract user context from the request.
+     * Called by middleware on each request.
+     * If not provided, no user context is set.
+     */
+    identify?: (context: {
+        cookies: Record<string, string>;
+        headers: Headers;
+        url: URL;
+    }) => FlagifyUser | undefined;
+}
+/**
+ * Shape of a flag definition passed to defineFlag().
+ */
+interface FlagDefinition<T> {
+    key: string;
+    description?: string;
+    default: T;
+    options?: Array<T | {
+        value: T;
+        label: string;
+    }>;
+}
+/**
+ * What gets stored in context.locals by the middleware.
+ */
+interface FlagifyLocals {
+    flagifyOverrides: Record<string, unknown>;
+}
+
+/**
+ * Astro integration for Flagify feature flags.
+ *
+ * Registers middleware for flag evaluation and a dev toolbar app
+ * for toggling flag overrides during development.
+ *
+ * ```js
+ * // astro.config.mjs
+ * import { defineConfig } from 'astro/config';
+ * import flagify from '@flagify/astro';
+ *
+ * export default defineConfig({
+ *   integrations: [flagify()],
+ * });
+ * ```
+ */
+declare function flagifyIntegration(_options?: FlagifyAstroOptions): {
+    name: string;
+    hooks: Record<string, (params: any) => void>;
+};
+
+interface FlagEvaluator<T> {
+    (astro: {
+        cookies: {
+            get(name: string): {
+                value: string;
+            } | undefined;
+        };
+    }): Promise<T>;
+    _definition: FlagDefinition<T>;
+}
+/**
+ * Define a feature flag that can be evaluated in Astro pages and components.
+ *
+ * Returns an async function that accepts the Astro global object
+ * and resolves the flag value with this priority:
+ * 1. Override cookie value (for dev testing)
+ * 2. Flagify SDK evaluation
+ * 3. Default fallback
+ */
+declare function defineFlag<T>(definition: FlagDefinition<T>): FlagEvaluator<T>;
+
+/**
+ * Initialize the singleton Flagify client.
+ * Subsequent calls are no-ops if the client already exists.
+ */
+declare function initClient(config: FlagifyOptions): void;
+/**
+ * Returns the singleton Flagify client, or null if not initialized.
+ */
+declare function getClient(): Flagify | null;
+/**
+ * Waits for the client to complete its initial flag sync.
+ */
+declare function waitForClient(): Promise<Flagify | null>;
+/**
+ * Destroy the singleton client and free resources.
+ */
+declare function destroyClient(): void;
+
+export { type FlagDefinition, type FlagEvaluator, type FlagifyAstroOptions, type FlagifyLocals, flagifyIntegration as default, defineFlag, destroyClient, getClient, initClient, waitForClient };

package/dist/index.js

@@ -0,0 +1,64 @@
+import {
+  destroyClient,
+  getClient,
+  initClient,
+  waitForClient
+} from "./chunk-XPJW7PJL.js";
+
+// src/integration.ts
+var FLAG_ICON = `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M4 15s1-1 4-1 5 2 8 2 4-1 4-1V3s-1 1-4 1-5-2-8-2-4 1-4 1z"/><line x1="4" y1="22" x2="4" y2="15"/></svg>`;
+function flagifyIntegration(_options) {
+  return {
+    name: "@flagify/astro",
+    hooks: {
+      "astro:config:setup": ({
+        addMiddleware,
+        addDevToolbarApp
+      }) => {
+        addMiddleware({
+          entrypoint: "@flagify/astro/middleware",
+          order: "pre"
+        });
+        addDevToolbarApp({
+          id: "flagify-flags",
+          name: "Feature Flags",
+          icon: FLAG_ICON,
+          entrypoint: new URL("./toolbar/app.js", import.meta.url)
+        });
+      }
+    }
+  };
+}
+
+// src/flag.ts
+var OVERRIDE_COOKIE = "flagify-overrides";
+function defineFlag(definition) {
+  const evaluate = async (astro) => {
+    const overrideCookie = astro.cookies.get(OVERRIDE_COOKIE);
+    if (overrideCookie) {
+      try {
+        const overrides = JSON.parse(overrideCookie.value);
+        if (definition.key in overrides) {
+          return overrides[definition.key];
+        }
+      } catch {
+      }
+    }
+    const client = getClient();
+    if (!client) return definition.default;
+    if (typeof definition.default === "boolean") {
+      return client.isEnabled(definition.key);
+    }
+    return client.getValue(definition.key, definition.default);
+  };
+  evaluate._definition = definition;
+  return evaluate;
+}
+export {
+  flagifyIntegration as default,
+  defineFlag,
+  destroyClient,
+  getClient,
+  initClient,
+  waitForClient
+};

package/dist/middleware.cjs

@@ -0,0 +1,67 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/middleware.ts
+var middleware_exports = {};
+__export(middleware_exports, {
+  onRequest: () => onRequest
+});
+module.exports = __toCommonJS(middleware_exports);
+
+// src/client.ts
+var import_node = require("@flagify/node");
+var client = null;
+var clientReady = null;
+function initClient(config) {
+  if (client) return;
+  client = new import_node.Flagify(config);
+  clientReady = client.ready();
+}
+async function waitForClient() {
+  if (clientReady) await clientReady;
+  return client;
+}
+
+// src/middleware.ts
+var import_meta = {};
+var OVERRIDE_COOKIE = "flagify-overrides";
+var onRequest = async (context, next) => {
+  const env = import_meta.env ?? {};
+  const projectKey = env.FLAGIFY_PROJECT_KEY ?? "";
+  const publicKey = env.FLAGIFY_PUBLIC_KEY ?? "";
+  const secretKey = env.FLAGIFY_SECRET_KEY;
+  if (projectKey && publicKey) {
+    initClient({ projectKey, publicKey, secretKey });
+    await waitForClient();
+  }
+  let overrides = {};
+  const overrideCookie = context.cookies?.get(OVERRIDE_COOKIE);
+  if (overrideCookie) {
+    try {
+      overrides = JSON.parse(overrideCookie.value);
+    } catch {
+    }
+  }
+  context.locals.flagifyOverrides = overrides;
+  return next();
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  onRequest
+});

package/dist/middleware.d.cts

@@ -0,0 +1,15 @@
+/**
+ * Astro middleware that initializes the Flagify client and parses
+ * override cookies on each request.
+ *
+ * Usage in astro.config.mjs — this is auto-injected by the integration,
+ * but can also be used standalone:
+ *
+ * ```ts
+ * // src/middleware.ts
+ * export { onRequest } from '@flagify/astro/middleware';
+ * ```
+ */
+declare const onRequest: (context: any, next: () => Promise<Response>) => Promise<Response>;
+
+export { onRequest };

package/dist/middleware.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Astro middleware that initializes the Flagify client and parses
+ * override cookies on each request.
+ *
+ * Usage in astro.config.mjs — this is auto-injected by the integration,
+ * but can also be used standalone:
+ *
+ * ```ts
+ * // src/middleware.ts
+ * export { onRequest } from '@flagify/astro/middleware';
+ * ```
+ */
+declare const onRequest: (context: any, next: () => Promise<Response>) => Promise<Response>;
+
+export { onRequest };

package/dist/middleware.js

@@ -0,0 +1,30 @@
+import {
+  initClient,
+  waitForClient
+} from "./chunk-XPJW7PJL.js";
+
+// src/middleware.ts
+var OVERRIDE_COOKIE = "flagify-overrides";
+var onRequest = async (context, next) => {
+  const env = import.meta.env ?? {};
+  const projectKey = env.FLAGIFY_PROJECT_KEY ?? "";
+  const publicKey = env.FLAGIFY_PUBLIC_KEY ?? "";
+  const secretKey = env.FLAGIFY_SECRET_KEY;
+  if (projectKey && publicKey) {
+    initClient({ projectKey, publicKey, secretKey });
+    await waitForClient();
+  }
+  let overrides = {};
+  const overrideCookie = context.cookies?.get(OVERRIDE_COOKIE);
+  if (overrideCookie) {
+    try {
+      overrides = JSON.parse(overrideCookie.value);
+    } catch {
+    }
+  }
+  context.locals.flagifyOverrides = overrides;
+  return next();
+};
+export {
+  onRequest
+};

package/dist/toolbar/app.cjs

@@ -0,0 +1,85 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/toolbar/app.ts
+var app_exports = {};
+__export(app_exports, {
+  default: () => app_default
+});
+module.exports = __toCommonJS(app_exports);
+var OVERRIDE_COOKIE = "flagify-overrides";
+function getCookieOverrides() {
+  const match = document.cookie.match(
+    new RegExp(`${OVERRIDE_COOKIE}=([^;]+)`)
+  );
+  if (!match) return {};
+  try {
+    return JSON.parse(decodeURIComponent(match[1]));
+  } catch {
+    return {};
+  }
+}
+function setCookieOverrides(overrides) {
+  document.cookie = `${OVERRIDE_COOKIE}=${encodeURIComponent(JSON.stringify(overrides))}; path=/; max-age=86400`;
+}
+var app_default = {
+  id: "flagify-flags",
+  name: "Feature Flags",
+  init(canvas) {
+    const overrides = getCookieOverrides();
+    const container = document.createElement("astro-dev-toolbar-window");
+    container.innerHTML = `
+      <div style="padding: 12px; font-family: system-ui, sans-serif;">
+        <h2 style="margin: 0 0 8px; font-size: 15px; font-weight: 600;">Flagify Overrides</h2>
+        <p style="font-size: 13px; opacity: 0.7; margin: 0 0 12px;">
+          Add flag overrides for local development.
+        </p>
+        <textarea
+          id="flagify-overrides-editor"
+          style="width: 100%; min-height: 140px; font-family: monospace; font-size: 13px; padding: 8px; border-radius: 6px; border: 1px solid rgba(255,255,255,0.15); background: rgba(0,0,0,0.3); color: inherit; resize: vertical;"
+        >${JSON.stringify(overrides, null, 2)}</textarea>
+        <div style="margin-top: 8px; display: flex; gap: 8px;">
+          <button id="flagify-save" style="padding: 6px 14px; border-radius: 6px; border: none; background: #6366f1; color: white; cursor: pointer; font-size: 13px;">
+            Save &amp; Reload
+          </button>
+          <button id="flagify-clear" style="padding: 6px 14px; border-radius: 6px; border: 1px solid rgba(255,255,255,0.2); background: transparent; color: inherit; cursor: pointer; font-size: 13px;">
+            Clear All
+          </button>
+        </div>
+      </div>
+    `;
+    canvas.appendChild(container);
+    container.querySelector("#flagify-save")?.addEventListener("click", () => {
+      const textarea = container.querySelector(
+        "#flagify-overrides-editor"
+      );
+      try {
+        const parsed = JSON.parse(textarea.value);
+        setCookieOverrides(parsed);
+        window.location.reload();
+      } catch {
+        alert("Invalid JSON");
+      }
+    });
+    container.querySelector("#flagify-clear")?.addEventListener("click", () => {
+      document.cookie = `${OVERRIDE_COOKIE}=; path=/; max-age=0`;
+      window.location.reload();
+    });
+  }
+};

package/dist/toolbar/app.d.cts

@@ -0,0 +1,7 @@
+declare const _default: {
+    id: string;
+    name: string;
+    init(canvas: any): void;
+};
+
+export { _default as default };

package/dist/toolbar/app.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+    id: string;
+    name: string;
+    init(canvas: any): void;
+};
+
+export { _default as default };

package/dist/toolbar/app.js

@@ -0,0 +1,64 @@
+// src/toolbar/app.ts
+var OVERRIDE_COOKIE = "flagify-overrides";
+function getCookieOverrides() {
+  const match = document.cookie.match(
+    new RegExp(`${OVERRIDE_COOKIE}=([^;]+)`)
+  );
+  if (!match) return {};
+  try {
+    return JSON.parse(decodeURIComponent(match[1]));
+  } catch {
+    return {};
+  }
+}
+function setCookieOverrides(overrides) {
+  document.cookie = `${OVERRIDE_COOKIE}=${encodeURIComponent(JSON.stringify(overrides))}; path=/; max-age=86400`;
+}
+var app_default = {
+  id: "flagify-flags",
+  name: "Feature Flags",
+  init(canvas) {
+    const overrides = getCookieOverrides();
+    const container = document.createElement("astro-dev-toolbar-window");
+    container.innerHTML = `
+      <div style="padding: 12px; font-family: system-ui, sans-serif;">
+        <h2 style="margin: 0 0 8px; font-size: 15px; font-weight: 600;">Flagify Overrides</h2>
+        <p style="font-size: 13px; opacity: 0.7; margin: 0 0 12px;">
+          Add flag overrides for local development.
+        </p>
+        <textarea
+          id="flagify-overrides-editor"
+          style="width: 100%; min-height: 140px; font-family: monospace; font-size: 13px; padding: 8px; border-radius: 6px; border: 1px solid rgba(255,255,255,0.15); background: rgba(0,0,0,0.3); color: inherit; resize: vertical;"
+        >${JSON.stringify(overrides, null, 2)}</textarea>
+        <div style="margin-top: 8px; display: flex; gap: 8px;">
+          <button id="flagify-save" style="padding: 6px 14px; border-radius: 6px; border: none; background: #6366f1; color: white; cursor: pointer; font-size: 13px;">
+            Save &amp; Reload
+          </button>
+          <button id="flagify-clear" style="padding: 6px 14px; border-radius: 6px; border: 1px solid rgba(255,255,255,0.2); background: transparent; color: inherit; cursor: pointer; font-size: 13px;">
+            Clear All
+          </button>
+        </div>
+      </div>
+    `;
+    canvas.appendChild(container);
+    container.querySelector("#flagify-save")?.addEventListener("click", () => {
+      const textarea = container.querySelector(
+        "#flagify-overrides-editor"
+      );
+      try {
+        const parsed = JSON.parse(textarea.value);
+        setCookieOverrides(parsed);
+        window.location.reload();
+      } catch {
+        alert("Invalid JSON");
+      }
+    });
+    container.querySelector("#flagify-clear")?.addEventListener("click", () => {
+      document.cookie = `${OVERRIDE_COOKIE}=; path=/; max-age=0`;
+      window.location.reload();
+    });
+  }
+};
+export {
+  app_default as default
+};

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@flagify/astro",
+  "version": "1.0.0",
+  "description": "Astro integration for Flagify — feature flags with dev toolbar and middleware.",
+  "author": "Mario Campbell R <mario@mariocampbellr.com>",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./middleware": {
+      "types": "./dist/middleware.d.ts",
+      "import": "./dist/middleware.js",
+      "require": "./dist/middleware.cjs"
+    },
+    "./adapter": {
+      "types": "./dist/adapter.d.ts",
+      "import": "./dist/adapter.js",
+      "require": "./dist/adapter.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@flagify/node": "1.0.0"
+  },
+  "peerDependencies": {
+    "astro": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "flags": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "astro": "^4.0.0"
+  },
+  "keywords": [
+    "astro-integration",
+    "feature-flags",
+    "flagify",
+    "feature-toggle"
+  ],
+  "homepage": "https://flagify.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flagifyhq/javascript",
+    "directory": "packages/astro"
+  },
+  "bugs": {
+    "url": "https://github.com/flagifyhq/javascript/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/middleware.ts src/adapter.ts src/toolbar/app.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts src/middleware.ts src/adapter.ts src/toolbar/app.ts --format esm,cjs --dts --watch",
+    "test": "vitest run",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}