@buildrflags/angular 1.0.0

package/README.md

@@ -0,0 +1,198 @@
+# @buildrflags/angular
+
+Angular SDK for [BuildrFlags](https://flags.buildrlab.com) feature flags.
+
+## Installation
+
+```bash
+npm install @buildrflags/angular
+# or
+pnpm add @buildrflags/angular
+# or
+yarn add @buildrflags/angular
+```
+
+## Setup
+
+Import `BuildrFlagsModule` in your root AppModule:
+
+```typescript
+import { NgModule } from '@angular/core';
+import { BuildrFlagsModule } from '@buildrflags/angular';
+
+@NgModule({
+  imports: [
+    BuildrFlagsModule.forRoot({
+      apiKey: 'bf_production_xxx',
+      baseUrl: 'https://api.flags.buildrlab.com', // optional
+      refreshInterval: 60000, // optional, default 60s
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+### Standalone Components
+
+For standalone components, import the module directly:
+
+```typescript
+import { Component } from '@angular/core';
+import { BuildrFlagsModule } from '@buildrflags/angular';
+
+@Component({
+  standalone: true,
+  imports: [BuildrFlagsModule],
+  template: `
+    <div *ifFlag="'features.newUI'">
+      New UI enabled!
+    </div>
+  `,
+})
+export class MyComponent {}
+```
+
+## Usage
+
+### Structural Directive
+
+Use `*ifFlag` to conditionally render content:
+
+```html
+<!-- Show when flag is enabled -->
+<div *ifFlag="'features.darkMode'">
+  Dark mode content
+</div>
+
+<!-- With else template -->
+<div *ifFlag="'features.newDashboard'; else oldDashboard">
+  New dashboard
+</div>
+<ng-template #oldDashboard>
+  Old dashboard
+</ng-template>
+
+<!-- Negated (show when flag is OFF) -->
+<div *ifFlag="'features.maintenance'; negate: true">
+  Site is operational
+</div>
+```
+
+### Pipe
+
+Use the `flag` pipe with `async` for reactive flag evaluation:
+
+```html
+<!-- In *ngIf -->
+<div *ngIf="'features.darkMode' | flag | async">
+  Dark mode enabled
+</div>
+
+<!-- In attribute binding -->
+<button [disabled]="!('features.submit' | flag | async)">
+  Submit
+</button>
+
+<!-- In class binding -->
+<div [class.dark-theme]="'features.darkMode' | flag | async">
+  Content
+</div>
+```
+
+### Service
+
+Inject `BuildrFlagsService` for programmatic access:
+
+```typescript
+import { Component } from '@angular/core';
+import { BuildrFlagsService } from '@buildrflags/angular';
+
+@Component({
+  selector: 'app-example',
+  template: `
+    <div *ngIf="darkMode$ | async">Dark mode!</div>
+  `,
+})
+export class ExampleComponent {
+  // Observable for reactive updates
+  darkMode$ = this.flags.flag$('features.darkMode');
+
+  constructor(private flags: BuildrFlagsService) {}
+
+  // Snapshot value
+  checkFlag() {
+    const enabled = this.flags.getFlag('features.someFlag');
+    console.log('Flag enabled:', enabled);
+  }
+
+  // Manual refresh
+  async refreshFlags() {
+    await this.flags.refresh();
+  }
+}
+```
+
+### Service API
+
+```typescript
+interface BuildrFlagsService {
+  // Observables
+  flags$: Observable<BuildrFlagsState>;     // Full state
+  flag$(key: string, defaultValue?: boolean): Observable<boolean>;
+  isLoading$: Observable<boolean>;
+  error$: Observable<string | null>;
+
+  // Snapshots
+  snapshot: BuildrFlagsState;               // Current state
+  getFlag(key: string, defaultValue?: boolean): boolean;
+  isLoading: boolean;
+
+  // Actions
+  refresh(): Promise<void>;                 // Manual refresh
+}
+```
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `apiKey` | `string` | *required* | Your BuildrFlags API key |
+| `baseUrl` | `string` | `https://api.flags.buildrlab.com` | API base URL |
+| `refreshInterval` | `number` | `60000` | Auto-refresh interval (ms), 0 to disable |
+| `initialFlags` | `Record<string, boolean>` | `undefined` | Initial flags for SSR |
+
+## Server-Side Rendering (SSR)
+
+For SSR, provide initial flags to avoid flicker:
+
+```typescript
+// In your SSR bootstrap
+BuildrFlagsModule.forRoot({
+  apiKey: 'bf_production_xxx',
+  initialFlags: {
+    'features.darkMode': true,
+    'features.newUI': false,
+  },
+});
+```
+
+## TypeScript
+
+All types are exported:
+
+```typescript
+import type {
+  BuildrFlagsConfig,
+  BuildrFlagsState,
+  FlagResult,
+} from '@buildrflags/angular';
+```
+
+## Requirements
+
+- Angular 17+
+- RxJS 7+
+
+## License
+
+MIT

package/dist/buildrflags.module.d.ts

@@ -0,0 +1,47 @@
+import { ModuleWithProviders } from '@angular/core';
+import { BuildrFlagsConfig } from './types.js';
+import * as i0 from "@angular/core";
+import * as i1 from "@angular/common";
+import * as i2 from "./if-flag.directive";
+import * as i3 from "./flag.pipe";
+/**
+ * Angular module for BuildrFlags feature flags.
+ *
+ * Import this module in your root AppModule and call forRoot() with your configuration.
+ *
+ * @example
+ * ```typescript
+ * @NgModule({
+ *   imports: [
+ *     BuildrFlagsModule.forRoot({
+ *       apiKey: 'bf_production_xxx',
+ *       baseUrl: 'https://api.flags.buildrlab.com',
+ *       refreshInterval: 60000,
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * Then use in components:
+ * ```html
+ * <div *ifFlag="'features.darkMode'">Dark mode enabled!</div>
+ * ```
+ *
+ * Or with the pipe:
+ * ```html
+ * <button [disabled]="!('features.submit' | flag | async)">Submit</button>
+ * ```
+ */
+export declare class BuildrFlagsModule {
+    /**
+     * Configure BuildrFlags for the root module
+     *
+     * @param config - BuildrFlags configuration
+     */
+    static forRoot(config: BuildrFlagsConfig): ModuleWithProviders<BuildrFlagsModule>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BuildrFlagsModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<BuildrFlagsModule, never, [typeof i1.CommonModule, typeof i2.IfFlagDirective, typeof i3.FlagPipe], [typeof i2.IfFlagDirective, typeof i3.FlagPipe]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<BuildrFlagsModule>;
+}
+//# sourceMappingURL=buildrflags.module.d.ts.map

package/dist/buildrflags.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildrflags.module.d.ts","sourceRoot":"","sources":["../src/buildrflags.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAsB,MAAM,YAAY,CAAC;;;;;AAKnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAIa,iBAAiB;IAC5B;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,CAAC,iBAAiB,CAAC;yCANtE,iBAAiB;0CAAjB,iBAAiB;0CAAjB,iBAAiB;CAe7B"}

package/dist/buildrflags.module.js

@@ -0,0 +1,63 @@
+import { NgModule } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { BUILDRFLAGS_CONFIG } from './types.js';
+import { BuildrFlagsService } from './buildrflags.service.js';
+import { IfFlagDirective } from './if-flag.directive.js';
+import { FlagPipe } from './flag.pipe.js';
+import * as i0 from "@angular/core";
+/**
+ * Angular module for BuildrFlags feature flags.
+ *
+ * Import this module in your root AppModule and call forRoot() with your configuration.
+ *
+ * @example
+ * ```typescript
+ * @NgModule({
+ *   imports: [
+ *     BuildrFlagsModule.forRoot({
+ *       apiKey: 'bf_production_xxx',
+ *       baseUrl: 'https://api.flags.buildrlab.com',
+ *       refreshInterval: 60000,
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * Then use in components:
+ * ```html
+ * <div *ifFlag="'features.darkMode'">Dark mode enabled!</div>
+ * ```
+ *
+ * Or with the pipe:
+ * ```html
+ * <button [disabled]="!('features.submit' | flag | async)">Submit</button>
+ * ```
+ */
+export class BuildrFlagsModule {
+    /**
+     * Configure BuildrFlags for the root module
+     *
+     * @param config - BuildrFlags configuration
+     */
+    static forRoot(config) {
+        return {
+            ngModule: BuildrFlagsModule,
+            providers: [
+                { provide: BUILDRFLAGS_CONFIG, useValue: config },
+                BuildrFlagsService,
+            ],
+        };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: BuildrFlagsModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "21.1.4", ngImport: i0, type: BuildrFlagsModule, imports: [CommonModule, IfFlagDirective, FlagPipe], exports: [IfFlagDirective, FlagPipe] }); }
+    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: BuildrFlagsModule, imports: [CommonModule] }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: BuildrFlagsModule, decorators: [{
+            type: NgModule,
+            args: [{
+                    imports: [CommonModule, IfFlagDirective, FlagPipe],
+                    exports: [IfFlagDirective, FlagPipe],
+                }]
+        }] });
+//# sourceMappingURL=buildrflags.module.js.map

package/dist/buildrflags.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildrflags.module.js","sourceRoot":"","sources":["../src/buildrflags.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAuB,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAqB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,MAAM,OAAO,iBAAiB;IAC5B;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,MAAyB;QACtC,OAAO;YACL,QAAQ,EAAE,iBAAiB;YAC3B,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE;gBACjD,kBAAkB;aACnB;SACF,CAAC;IACJ,CAAC;8GAdU,iBAAiB;+GAAjB,iBAAiB,YAHlB,YAAY,EAAE,eAAe,EAAE,QAAQ,aACvC,eAAe,EAAE,QAAQ;+GAExB,iBAAiB,YAHlB,YAAY;;2FAGX,iBAAiB;kBAJ7B,QAAQ;mBAAC;oBACR,OAAO,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,QAAQ,CAAC;oBAClD,OAAO,EAAE,CAAC,eAAe,EAAE,QAAQ,CAAC;iBACrC"}

package/dist/buildrflags.service.d.ts

@@ -0,0 +1,70 @@
+import { OnDestroy } from '@angular/core';
+import { Observable } from 'rxjs';
+import { BuildrFlagsConfig, BuildrFlagsState } from './types.js';
+import * as i0 from "@angular/core";
+/**
+ * Service for evaluating feature flags from BuildrFlags API.
+ *
+ * Fetches flags on initialization and refreshes periodically.
+ *
+ * @example
+ * ```typescript
+ * @Component({...})
+ * export class MyComponent {
+ *   darkMode$ = this.flags.flag$('features.darkMode');
+ *
+ *   constructor(private flags: BuildrFlagsService) {}
+ * }
+ * ```
+ */
+export declare class BuildrFlagsService implements OnDestroy {
+    private readonly state$;
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly refreshInterval;
+    private refreshSubscription?;
+    constructor(config: BuildrFlagsConfig);
+    ngOnDestroy(): void;
+    /**
+     * Observable of all flags state
+     */
+    get flags$(): Observable<BuildrFlagsState>;
+    /**
+     * Current flags state (snapshot)
+     */
+    get snapshot(): BuildrFlagsState;
+    /**
+     * Observable for a single flag's enabled state
+     *
+     * @param flagKey - The key of the flag to observe
+     * @param defaultValue - Value to return while loading or if flag not found (default: false)
+     */
+    flag$(flagKey: string, defaultValue?: boolean): Observable<boolean>;
+    /**
+     * Get a flag's current value (snapshot)
+     *
+     * @param flagKey - The key of the flag to evaluate
+     * @param defaultValue - Value to return if flag not found or loading (default: false)
+     */
+    getFlag(flagKey: string, defaultValue?: boolean): boolean;
+    /**
+     * Check if flags are currently loading
+     */
+    get isLoading(): boolean;
+    /**
+     * Observable of loading state
+     */
+    get isLoading$(): Observable<boolean>;
+    /**
+     * Observable of error state
+     */
+    get error$(): Observable<string | null>;
+    /**
+     * Manually refresh flags from the API
+     */
+    refresh(): Promise<void>;
+    private fetchFlags;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BuildrFlagsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<BuildrFlagsService>;
+}
+//# sourceMappingURL=buildrflags.service.d.ts.map

package/dist/buildrflags.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildrflags.service.d.ts","sourceRoot":"","sources":["../src/buildrflags.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,SAAS,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAmB,UAAU,EAA0B,MAAM,MAAM,CAAC;AAE3E,OAAO,EAEL,iBAAiB,EACjB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;;AAKpB;;;;;;;;;;;;;;GAcG;AACH,qBACa,kBAAmB,YAAW,SAAS;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAIpB;IAEH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,mBAAmB,CAAC,CAAe;gBAEH,MAAM,EAAE,iBAAiB;IAyBjE,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,IAAI,MAAM,IAAI,UAAU,CAAC,gBAAgB,CAAC,CAEzC;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,gBAAgB,CAE/B;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,UAAU,CAAC,OAAO,CAAC;IAOjE;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,OAAO;IAMvD;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,UAAU,CAAC,OAAO,CAAC,CAKpC;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,CAKtC;IAED;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAIhB,UAAU;yCAlHb,kBAAkB;6CAAlB,kBAAkB;CAqJ9B"}

package/dist/buildrflags.service.js

@@ -0,0 +1,152 @@
+import { Injectable, Inject } from '@angular/core';
+import { BehaviorSubject, interval } from 'rxjs';
+import { map, distinctUntilChanged } from 'rxjs/operators';
+import { BUILDRFLAGS_CONFIG, } from './types.js';
+import * as i0 from "@angular/core";
+const DEFAULT_BASE_URL = 'https://api.flags.buildrlab.com';
+const DEFAULT_REFRESH_INTERVAL = 60_000; // 1 minute
+/**
+ * Service for evaluating feature flags from BuildrFlags API.
+ *
+ * Fetches flags on initialization and refreshes periodically.
+ *
+ * @example
+ * ```typescript
+ * @Component({...})
+ * export class MyComponent {
+ *   darkMode$ = this.flags.flag$('features.darkMode');
+ *
+ *   constructor(private flags: BuildrFlagsService) {}
+ * }
+ * ```
+ */
+export class BuildrFlagsService {
+    constructor(config) {
+        this.state$ = new BehaviorSubject({
+            flags: {},
+            isLoading: true,
+            error: null,
+        });
+        this.apiKey = config.apiKey;
+        this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, '');
+        this.refreshInterval = config.refreshInterval ?? DEFAULT_REFRESH_INTERVAL;
+        // Set initial flags if provided
+        if (config.initialFlags) {
+            this.state$.next({
+                flags: config.initialFlags,
+                isLoading: false,
+                error: null,
+            });
+        }
+        // Fetch flags immediately
+        void this.fetchFlags();
+        // Set up auto-refresh
+        if (this.refreshInterval > 0) {
+            this.refreshSubscription = interval(this.refreshInterval).subscribe(() => {
+                void this.fetchFlags();
+            });
+        }
+    }
+    ngOnDestroy() {
+        this.refreshSubscription?.unsubscribe();
+    }
+    /**
+     * Observable of all flags state
+     */
+    get flags$() {
+        return this.state$.asObservable();
+    }
+    /**
+     * Current flags state (snapshot)
+     */
+    get snapshot() {
+        return this.state$.getValue();
+    }
+    /**
+     * Observable for a single flag's enabled state
+     *
+     * @param flagKey - The key of the flag to observe
+     * @param defaultValue - Value to return while loading or if flag not found (default: false)
+     */
+    flag$(flagKey, defaultValue = false) {
+        return this.state$.pipe(map((state) => (state.isLoading ? defaultValue : (state.flags[flagKey] ?? defaultValue))), distinctUntilChanged());
+    }
+    /**
+     * Get a flag's current value (snapshot)
+     *
+     * @param flagKey - The key of the flag to evaluate
+     * @param defaultValue - Value to return if flag not found or loading (default: false)
+     */
+    getFlag(flagKey, defaultValue = false) {
+        const state = this.state$.getValue();
+        if (state.isLoading)
+            return defaultValue;
+        return state.flags[flagKey] ?? defaultValue;
+    }
+    /**
+     * Check if flags are currently loading
+     */
+    get isLoading() {
+        return this.state$.getValue().isLoading;
+    }
+    /**
+     * Observable of loading state
+     */
+    get isLoading$() {
+        return this.state$.pipe(map((state) => state.isLoading), distinctUntilChanged());
+    }
+    /**
+     * Observable of error state
+     */
+    get error$() {
+        return this.state$.pipe(map((state) => state.error), distinctUntilChanged());
+    }
+    /**
+     * Manually refresh flags from the API
+     */
+    async refresh() {
+        await this.fetchFlags();
+    }
+    async fetchFlags() {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/evaluate/all`, {
+                method: 'GET',
+                headers: {
+                    'X-API-Key': this.apiKey,
+                },
+            });
+            if (!response.ok) {
+                const text = await response.text().catch(() => 'Unknown error');
+                throw new Error(`API request failed: ${response.status} ${text}`);
+            }
+            const data = (await response.json());
+            const flagMap = {};
+            for (const flag of data.flags) {
+                flagMap[flag.flagKey] = flag.enabled;
+            }
+            this.state$.next({
+                flags: flagMap,
+                isLoading: false,
+                error: null,
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Failed to fetch flags';
+            this.state$.next({
+                ...this.state$.getValue(),
+                isLoading: false,
+                error: message,
+            });
+        }
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: BuildrFlagsService, deps: [{ token: BUILDRFLAGS_CONFIG }], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: BuildrFlagsService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: BuildrFlagsService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [{ type: undefined, decorators: [{
+                    type: Inject,
+                    args: [BUILDRFLAGS_CONFIG]
+                }] }] });
+//# sourceMappingURL=buildrflags.service.js.map

package/dist/buildrflags.service.js.map

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

package/dist/flag.pipe.d.ts

@@ -0,0 +1,40 @@
+import { PipeTransform } from '@angular/core';
+import { Observable } from 'rxjs';
+import { BuildrFlagsService } from './buildrflags.service.js';
+import * as i0 from "@angular/core";
+/**
+ * Pipe for getting a feature flag's enabled state as an Observable.
+ *
+ * Use with the async pipe for reactive flag evaluation.
+ *
+ * @example Basic usage
+ * ```html
+ * <div *ngIf="'features.darkMode' | flag | async">
+ *   Dark mode content
+ * </div>
+ * ```
+ *
+ * @example In attribute binding
+ * ```html
+ * <button [disabled]="!('features.submit' | flag | async)">Submit</button>
+ * ```
+ *
+ * @example In class binding
+ * ```html
+ * <div [class.dark-theme]="'features.darkMode' | flag | async">Content</div>
+ * ```
+ */
+export declare class FlagPipe implements PipeTransform {
+    private flagsService;
+    constructor(flagsService: BuildrFlagsService);
+    /**
+     * Transform a flag key into an Observable of its enabled state
+     *
+     * @param flagKey - The key of the flag to evaluate
+     * @param defaultValue - Value to return while loading (default: false)
+     */
+    transform(flagKey: string, defaultValue?: boolean): Observable<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FlagPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<FlagPipe, "flag", true>;
+}
+//# sourceMappingURL=flag.pipe.d.ts.map

package/dist/flag.pipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag.pipe.d.ts","sourceRoot":"","sources":["../src/flag.pipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,aAAa,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;;AAE9D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAIa,QAAS,YAAW,aAAa;IAChC,OAAO,CAAC,YAAY;gBAAZ,YAAY,EAAE,kBAAkB;IAEpD;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,UAAU,CAAC,OAAO,CAAC;yCAT1D,QAAQ;uCAAR,QAAQ;CAYpB"}

package/dist/flag.pipe.js

@@ -0,0 +1,50 @@
+import { Pipe } from '@angular/core';
+import { BuildrFlagsService } from './buildrflags.service.js';
+import * as i0 from "@angular/core";
+import * as i1 from "./buildrflags.service.js";
+/**
+ * Pipe for getting a feature flag's enabled state as an Observable.
+ *
+ * Use with the async pipe for reactive flag evaluation.
+ *
+ * @example Basic usage
+ * ```html
+ * <div *ngIf="'features.darkMode' | flag | async">
+ *   Dark mode content
+ * </div>
+ * ```
+ *
+ * @example In attribute binding
+ * ```html
+ * <button [disabled]="!('features.submit' | flag | async)">Submit</button>
+ * ```
+ *
+ * @example In class binding
+ * ```html
+ * <div [class.dark-theme]="'features.darkMode' | flag | async">Content</div>
+ * ```
+ */
+export class FlagPipe {
+    constructor(flagsService) {
+        this.flagsService = flagsService;
+    }
+    /**
+     * Transform a flag key into an Observable of its enabled state
+     *
+     * @param flagKey - The key of the flag to evaluate
+     * @param defaultValue - Value to return while loading (default: false)
+     */
+    transform(flagKey, defaultValue = false) {
+        return this.flagsService.flag$(flagKey, defaultValue);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: FlagPipe, deps: [{ token: i1.BuildrFlagsService }], target: i0.ɵɵFactoryTarget.Pipe }); }
+    static { this.ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.4", ngImport: i0, type: FlagPipe, isStandalone: true, name: "flag", pure: false }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: FlagPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'flag',
+                    pure: false,
+                }]
+        }], ctorParameters: () => [{ type: i1.BuildrFlagsService }] });
+//# sourceMappingURL=flag.pipe.js.map

package/dist/flag.pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag.pipe.js","sourceRoot":"","sources":["../src/flag.pipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAiB,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;;;AAE9D;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,MAAM,OAAO,QAAQ;IACnB,YAAoB,YAAgC;QAAhC,iBAAY,GAAZ,YAAY,CAAoB;IAAG,CAAC;IAExD;;;;;OAKG;IACH,SAAS,CAAC,OAAe,EAAE,YAAY,GAAG,KAAK;QAC7C,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACxD,CAAC;8GAXU,QAAQ;4GAAR,QAAQ;;2FAAR,QAAQ;kBAJpB,IAAI;mBAAC;oBACJ,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,KAAK;iBACZ"}

package/dist/if-flag.directive.d.ts

@@ -0,0 +1,50 @@
+import { TemplateRef, ViewContainerRef, OnInit, OnDestroy } from '@angular/core';
+import { BuildrFlagsService } from './buildrflags.service.js';
+import * as i0 from "@angular/core";
+/**
+ * Structural directive for conditionally rendering content based on a feature flag.
+ *
+ * @example Basic usage
+ * ```html
+ * <div *ifFlag="'features.newDashboard'">
+ *   New dashboard content
+ * </div>
+ * ```
+ *
+ * @example With else template
+ * ```html
+ * <div *ifFlag="'features.newDashboard'; else oldDashboard">
+ *   New dashboard content
+ * </div>
+ * <ng-template #oldDashboard>
+ *   Old dashboard content
+ * </ng-template>
+ * ```
+ *
+ * @example Negated (show when flag is OFF)
+ * ```html
+ * <div *ifFlag="'features.newDashboard'; negate: true">
+ *   Shown when newDashboard is disabled
+ * </div>
+ * ```
+ */
+export declare class IfFlagDirective implements OnInit, OnDestroy {
+    private templateRef;
+    private viewContainer;
+    private flagsService;
+    private flagKey;
+    private negate;
+    private hasView;
+    private subscription?;
+    private elseTemplateRef?;
+    set ifFlag(flagKey: string);
+    set ifFlagNegate(negate: boolean);
+    set ifFlagElse(templateRef: TemplateRef<unknown> | null);
+    constructor(templateRef: TemplateRef<unknown>, viewContainer: ViewContainerRef, flagsService: BuildrFlagsService);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    private updateView;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IfFlagDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<IfFlagDirective, "[ifFlag]", never, { "ifFlag": { "alias": "ifFlag"; "required": false; }; "ifFlagNegate": { "alias": "ifFlagNegate"; "required": false; }; "ifFlagElse": { "alias": "ifFlagElse"; "required": false; }; }, {}, never, never, true, never>;
+}
+//# sourceMappingURL=if-flag.directive.d.ts.map

package/dist/if-flag.directive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"if-flag.directive.d.ts","sourceRoot":"","sources":["../src/if-flag.directive.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,WAAW,EACX,gBAAgB,EAChB,MAAM,EACN,SAAS,EACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAGa,eAAgB,YAAW,MAAM,EAAE,SAAS;IA0BrD,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,YAAY;IA3BtB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,eAAe,CAAC,CAAuB;IAE/C,IACI,MAAM,CAAC,OAAO,EAAE,MAAM,EAGzB;IAED,IACI,YAAY,CAAC,MAAM,EAAE,OAAO,EAG/B;IAED,IACI,UAAU,CAAC,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,EAGtD;gBAGS,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,EACjC,aAAa,EAAE,gBAAgB,EAC/B,YAAY,EAAE,kBAAkB;IAG1C,QAAQ,IAAI,IAAI;IAMhB,WAAW,IAAI,IAAI;IAInB,OAAO,CAAC,UAAU;yCAzCP,eAAe;2CAAf,eAAe;CA2D3B"}

package/dist/if-flag.directive.js

@@ -0,0 +1,94 @@
+import { Directive, Input, TemplateRef, ViewContainerRef, } from '@angular/core';
+import { BuildrFlagsService } from './buildrflags.service.js';
+import * as i0 from "@angular/core";
+import * as i1 from "./buildrflags.service.js";
+/**
+ * Structural directive for conditionally rendering content based on a feature flag.
+ *
+ * @example Basic usage
+ * ```html
+ * <div *ifFlag="'features.newDashboard'">
+ *   New dashboard content
+ * </div>
+ * ```
+ *
+ * @example With else template
+ * ```html
+ * <div *ifFlag="'features.newDashboard'; else oldDashboard">
+ *   New dashboard content
+ * </div>
+ * <ng-template #oldDashboard>
+ *   Old dashboard content
+ * </ng-template>
+ * ```
+ *
+ * @example Negated (show when flag is OFF)
+ * ```html
+ * <div *ifFlag="'features.newDashboard'; negate: true">
+ *   Shown when newDashboard is disabled
+ * </div>
+ * ```
+ */
+export class IfFlagDirective {
+    set ifFlag(flagKey) {
+        this.flagKey = flagKey;
+        this.updateView();
+    }
+    set ifFlagNegate(negate) {
+        this.negate = negate;
+        this.updateView();
+    }
+    set ifFlagElse(templateRef) {
+        this.elseTemplateRef = templateRef ?? undefined;
+        this.updateView();
+    }
+    constructor(templateRef, viewContainer, flagsService) {
+        this.templateRef = templateRef;
+        this.viewContainer = viewContainer;
+        this.flagsService = flagsService;
+        this.flagKey = '';
+        this.negate = false;
+        this.hasView = false;
+    }
+    ngOnInit() {
+        this.subscription = this.flagsService.flag$(this.flagKey).subscribe(() => {
+            this.updateView();
+        });
+    }
+    ngOnDestroy() {
+        this.subscription?.unsubscribe();
+    }
+    updateView() {
+        if (!this.flagKey)
+            return;
+        const flagEnabled = this.flagsService.getFlag(this.flagKey);
+        const shouldShow = this.negate ? !flagEnabled : flagEnabled;
+        if (shouldShow && !this.hasView) {
+            this.viewContainer.clear();
+            this.viewContainer.createEmbeddedView(this.templateRef);
+            this.hasView = true;
+        }
+        else if (!shouldShow) {
+            this.viewContainer.clear();
+            if (this.elseTemplateRef) {
+                this.viewContainer.createEmbeddedView(this.elseTemplateRef);
+            }
+            this.hasView = false;
+        }
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: IfFlagDirective, deps: [{ token: i0.TemplateRef }, { token: i0.ViewContainerRef }, { token: i1.BuildrFlagsService }], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "21.1.4", type: IfFlagDirective, isStandalone: true, selector: "[ifFlag]", inputs: { ifFlag: "ifFlag", ifFlagNegate: "ifFlagNegate", ifFlagElse: "ifFlagElse" }, ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: IfFlagDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[ifFlag]',
+                }]
+        }], ctorParameters: () => [{ type: i0.TemplateRef }, { type: i0.ViewContainerRef }, { type: i1.BuildrFlagsService }], propDecorators: { ifFlag: [{
+                type: Input
+            }], ifFlagNegate: [{
+                type: Input
+            }], ifFlagElse: [{
+                type: Input
+            }] } });
+//# sourceMappingURL=if-flag.directive.js.map

package/dist/if-flag.directive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"if-flag.directive.js","sourceRoot":"","sources":["../src/if-flag.directive.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,EACL,WAAW,EACX,gBAAgB,GAGjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;;;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,MAAM,OAAO,eAAe;IAO1B,IACI,MAAM,CAAC,OAAe;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,IACI,YAAY,CAAC,MAAe;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,IACI,UAAU,CAAC,WAAwC;QACrD,IAAI,CAAC,eAAe,GAAG,WAAW,IAAI,SAAS,CAAC;QAChD,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,YACU,WAAiC,EACjC,aAA+B,EAC/B,YAAgC;QAFhC,gBAAW,GAAX,WAAW,CAAsB;QACjC,kBAAa,GAAb,aAAa,CAAkB;QAC/B,iBAAY,GAAZ,YAAY,CAAoB;QA3BlC,YAAO,GAAG,EAAE,CAAC;QACb,WAAM,GAAG,KAAK,CAAC;QACf,YAAO,GAAG,KAAK,CAAC;IA0BrB,CAAC;IAEJ,QAAQ;QACN,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE;YACvE,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,WAAW;QACT,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,CAAC;IACnC,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC;QAE5D,IAAI,UAAU,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAChC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;aAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YACvB,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACzB,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC9D,CAAC;YACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;8GA1DU,eAAe;kGAAf,eAAe;;2FAAf,eAAe;kBAH3B,SAAS;mBAAC;oBACT,QAAQ,EAAE,UAAU;iBACrB;;sBAQE,KAAK;;sBAML,KAAK;;sBAML,KAAK"}

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * BuildrFlags Angular SDK
+ *
+ * Angular module, service, directive, and pipe for feature flag evaluation.
+ *
+ * @example Module setup
+ * ```typescript
+ * import { BuildrFlagsModule } from '@buildrflags/angular';
+ *
+ * @NgModule({
+ *   imports: [
+ *     BuildrFlagsModule.forRoot({
+ *       apiKey: 'bf_production_xxx',
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * @example Using the directive
+ * ```html
+ * <div *ifFlag="'features.darkMode'">
+ *   Dark mode enabled!
+ * </div>
+ * ```
+ *
+ * @example Using the service
+ * ```typescript
+ * @Component({...})
+ * export class MyComponent {
+ *   darkMode$ = this.flags.flag$('features.darkMode');
+ *
+ *   constructor(private flags: BuildrFlagsService) {}
+ * }
+ * ```
+ *
+ * @example Using the pipe
+ * ```html
+ * <div *ngIf="'features.darkMode' | flag | async">
+ *   Dark mode enabled!
+ * </div>
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { BuildrFlagsModule } from './buildrflags.module.js';
+export { BuildrFlagsService } from './buildrflags.service.js';
+export { IfFlagDirective } from './if-flag.directive.js';
+export { FlagPipe } from './flag.pipe.js';
+export type { BuildrFlagsConfig, BuildrFlagsState, FlagResult, BulkEvaluateResponse, } from './types.js';
+export { BUILDRFLAGS_CONFIG } from './types.js';
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,56 @@
+/**
+ * BuildrFlags Angular SDK
+ *
+ * Angular module, service, directive, and pipe for feature flag evaluation.
+ *
+ * @example Module setup
+ * ```typescript
+ * import { BuildrFlagsModule } from '@buildrflags/angular';
+ *
+ * @NgModule({
+ *   imports: [
+ *     BuildrFlagsModule.forRoot({
+ *       apiKey: 'bf_production_xxx',
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * @example Using the directive
+ * ```html
+ * <div *ifFlag="'features.darkMode'">
+ *   Dark mode enabled!
+ * </div>
+ * ```
+ *
+ * @example Using the service
+ * ```typescript
+ * @Component({...})
+ * export class MyComponent {
+ *   darkMode$ = this.flags.flag$('features.darkMode');
+ *
+ *   constructor(private flags: BuildrFlagsService) {}
+ * }
+ * ```
+ *
+ * @example Using the pipe
+ * ```html
+ * <div *ngIf="'features.darkMode' | flag | async">
+ *   Dark mode enabled!
+ * </div>
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Module
+export { BuildrFlagsModule } from './buildrflags.module.js';
+// Service
+export { BuildrFlagsService } from './buildrflags.service.js';
+// Directive
+export { IfFlagDirective } from './if-flag.directive.js';
+// Pipe
+export { FlagPipe } from './flag.pipe.js';
+// Injection token
+export { BUILDRFLAGS_CONFIG } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,UAAU;AACV,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO;AACP,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAU1C,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,43 @@
+import { InjectionToken } from '@angular/core';
+/**
+ * Configuration for the BuildrFlags Angular SDK
+ */
+export interface BuildrFlagsConfig {
+    /** API key for authentication */
+    apiKey: string;
+    /** Base URL for the BuildrFlags API (defaults to https://api.flags.buildrlab.com) */
+    baseUrl?: string;
+    /** Refresh interval in milliseconds (defaults to 60000ms / 1 minute) */
+    refreshInterval?: number;
+    /** Initial flags to use before API fetch completes (for SSR) */
+    initialFlags?: Record<string, boolean>;
+}
+/**
+ * Individual flag evaluation result
+ */
+export interface FlagResult {
+    flagKey: string;
+    enabled: boolean;
+}
+/**
+ * Response from the bulk evaluate endpoint
+ */
+export interface BulkEvaluateResponse {
+    flags: FlagResult[];
+}
+/**
+ * State of the BuildrFlags service
+ */
+export interface BuildrFlagsState {
+    /** Map of flag keys to their enabled state */
+    flags: Record<string, boolean>;
+    /** True while initial flag fetch is in progress */
+    isLoading: boolean;
+    /** Error message if flag fetch failed */
+    error: string | null;
+}
+/**
+ * Injection token for BuildrFlags configuration
+ */
+export declare const BUILDRFLAGS_CONFIG: InjectionToken<BuildrFlagsConfig>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,mDAAmD;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,mCAA6D,CAAC"}

package/dist/types.js

@@ -0,0 +1,6 @@
+import { InjectionToken } from '@angular/core';
+/**
+ * Injection token for BuildrFlags configuration
+ */
+export const BUILDRFLAGS_CONFIG = new InjectionToken('BuildrFlagsConfig');
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AA2C/C;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,cAAc,CAAoB,mBAAmB,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@buildrflags/angular",
+  "version": "1.0.0",
+  "description": "Angular SDK for BuildrFlags feature flags",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "ngc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@angular/common": ">=17.0.0",
+    "@angular/core": ">=17.0.0",
+    "rxjs": ">=7.0.0"
+  },
+  "devDependencies": {
+    "@angular/common": "^21.1.4",
+    "@angular/compiler": "^21.1.4",
+    "@angular/compiler-cli": "^21.1.4",
+    "@angular/core": "^21.1.4",
+    "rxjs": "^7.8.1",
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.18",
+    "zone.js": "^0.16.0"
+  },
+  "keywords": [
+    "angular",
+    "feature-flags",
+    "buildrflags",
+    "flags",
+    "toggles"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/buildrlab/buildrflags.git",
+    "directory": "sdks/angular"
+  },
+  "homepage": "https://flags.buildrlab.com"
+}