@nebulr-group/bridge-cli 0.1.4 → 0.4.0-beta.0

package/README.md

@@ -154,6 +154,15 @@ bridge branding update --bg-color "#ffffff" --text-color "#000000"
 bridge plan list
 bridge plan create --key pro --name "Pro Plan"
 bridge plan update --key pro --name "Pro Plan v2"
+
+# Prices — a plan can have several (one per currency + interval). Idempotent.
+bridge plan price set pro --amount 29 --currency usd --interval month
+bridge plan price set pro --amount 290 --currency usd --interval year
+bridge plan price rm  pro --interval year
+
+# Usage quotas (hard | metered caps)
+bridge plan quota set pro --metric ai_completions --limit 1000 --policy hard
+bridge plan quota rm  pro --metric ai_completions
 ```
 
 ### API Tokens
@@ -191,14 +200,27 @@ bridge info roles
 
 ### Integration Guides
 
+Three master prompts orchestrate the per-framework guides:
+
+```bash
+bridge guide              # Bridge Auth master prompt (auth, RBAC, tenants)
+bridge guide flags        # Feature Flags 2.0 master prompt
+bridge guide billing      # Billing 2.0 master prompt (subscriptions, quotas, webhooks)
+```
+
+Per-framework guides:
+
 ```bash
 bridge guide list
-bridge guide react
-bridge guide nextjs
-bridge guide express
-bridge guide custom
+bridge guide <framework>                    # auth guide (svelte | react | nextjs | angular | nestjs | express)
+bridge guide <framework> sdk-auth           # in-app auth UI (frontend frameworks only)
+bridge guide flags --framework <name>       # flags-specific guide
+bridge guide billing --framework <name>     # billing-specific guide
+bridge guide custom                         # REST API fallback for any language
 ```
 
+`bridge guide flags` and `bridge guide billing` auto-detect the framework from `package.json` when `--framework` is omitted — they fall back to the generic master prompt if no framework signal is found.
+
 ## Output Format
 
 **Success:**

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBpC,eAAO,MAAM,OAAO,SAAgB,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBpC,eAAO,MAAM,OAAO,SAAgB,CAAC"}

package/dist/cli.js

@@ -15,6 +15,8 @@ import { registerEventCommands } from './commands/event.command.js';
 import { registerSetupCommands } from './commands/setup.command.js';
 import { registerInfoCommands } from './commands/info.command.js';
 import { registerGuideCommands } from './commands/guide.command.js';
+import { registerOpsCommands } from './commands/ops.command.js';
+import { registerStripeCommands } from './commands/stripe.command.js';
 // Read version from package.json so `bridge --version` never drifts from the
 // published package. dist/cli.js lives at <pkg>/dist/cli.js, so `../package.json`
 // resolves to the package root in both the published tarball and during dev.
@@ -38,4 +40,6 @@ registerEventCommands(program);
 registerSetupCommands(program);
 registerInfoCommands(program);
 registerGuideCommands(program);
+registerOpsCommands(program);
+registerStripeCommands(program);
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,6EAA6E;AAC7E,kFAAkF;AAClF,6EAA6E;AAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;AACpF,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAwB,CAAC;AAErF,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAErC,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,sDAAsD,CAAC;KACnE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAClC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,6EAA6E;AAC7E,kFAAkF;AAClF,6EAA6E;AAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;AACpF,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAwB,CAAC;AAErF,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAErC,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,sDAAsD,CAAC;KACnE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAClC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,sBAAsB,CAAC,OAAO,CAAC,CAAC"}

package/dist/commands/app.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.command.d.ts","sourceRoot":"","sources":["../../src/commands/app.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyC1D"}
+{"version":3,"file":"app.command.d.ts","sourceRoot":"","sources":["../../src/commands/app.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2C1D"}

package/dist/commands/app.command.js

@@ -22,6 +22,7 @@ export function registerAppCommands(program) {
         .option('--mfa-enabled <bool>', 'Enable MFA', parseBool)
         .option('--passkeys-enabled <bool>', 'Enable passkeys', parseBool)
         .option('--magic-link-enabled <bool>', 'Enable magic links', parseBool)
+        .option('--payments-auto-redirect <bool>', 'Force new users to pick a plan before entering the app (billing paywall)', parseBool)
         .option('--redirect-uris <uris>', 'Comma-separated list of allowed OAuth callback URIs', parseList)
         .option('--allowed-origins <origins>', 'Comma-separated list of allowed CORS origins', parseList)
         .option('--default-callback-uri <uri>', 'Default OAuth callback URI')
@@ -36,6 +37,7 @@ export function registerAppCommands(program) {
                 mfaEnabled: opts.mfaEnabled,
                 passkeysEnabled: opts.passkeysEnabled,
                 magicLinkEnabled: opts.magicLinkEnabled,
+                paymentsAutoRedirect: opts.paymentsAutoRedirect,
                 redirectUris: opts.redirectUris,
                 allowedOrigins: opts.allowedOrigins,
                 defaultCallbackUri: opts.defaultCallbackUri,

package/dist/commands/app.command.js.map

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

package/dist/commands/flag-init.command.d.ts

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+export type FlagsFramework = 'svelte' | 'react' | 'nextjs' | 'angular' | 'nestjs' | 'express' | 'unknown';
+export declare function registerFlagInitCommand(flagParent: Command): void;
+export declare function detectFramework(cwd: string): Promise<FlagsFramework>;
+interface SnippetCtx {
+    appId: string;
+    baseUrl: string;
+}
+export declare function renderSnippet(framework: FlagsFramework, ctx: SnippetCtx): string;
+/** Probe whether a path exists (used by tests). */
+export declare function pathExists(path: string): Promise<boolean>;
+export {};
+//# sourceMappingURL=flag-init.command.d.ts.map

package/dist/commands/flag-init.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-init.command.d.ts","sourceRoot":"","sources":["../../src/commands/flag-init.command.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,CAAC;AAEd,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CA+DjE;AAID,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAwB1E;AAID,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM,CAsOhF;AA2BD,mDAAmD;AACnD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D"}

package/dist/commands/flag-init.command.js

@@ -0,0 +1,353 @@
+// TBP-198 — Flags-only integration scaffold.
+//
+// `bridge flag init` (alias for the eventual `bridge init --flags-only`).
+// Detects the project framework from package.json and prints:
+//   - The appropriate `bridge.flag(...)` setup snippet for the framework
+//   - A `bridge-flags.config.json` next to package.json with appId + baseUrl
+//     + suggested provider config
+//
+// The command is deliberately NON-destructive: it never overwrites source
+// files. The "scaffold" is text output (snippet + config file) for the agent
+// or the developer to apply.
+import { readFile, writeFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getManagementClient, DEFAULT_BASE_URL } from '../config.js';
+import { outputSuccess, outputError } from '../output.js';
+import { readCredentials } from '../credentials.js';
+export function registerFlagInitCommand(flagParent) {
+    flagParent
+        .command('init')
+        .description('Scaffold a flags-only Bridge integration (no auth setup) — detects framework, prints setup snippet, writes bridge-flags.config.json')
+        .option('--framework <name>', 'Override framework detection: svelte | react | nextjs | angular | nestjs | express')
+        .option('--cwd <path>', 'Project directory (defaults to current)', process.cwd())
+        .option('--no-config', 'Skip writing bridge-flags.config.json')
+        .option('--base-url <url>', 'Override the base URL written to config')
+        .action(async (opts) => {
+        try {
+            const cwd = opts.cwd;
+            const framework = opts.framework ?? (await detectFramework(cwd));
+            const client = getManagementClient();
+            const app = (await client.app.get());
+            const appId = app.id ?? '';
+            const appName = app.name ?? '';
+            const baseUrl = opts.baseUrl ??
+                // Pull the credentials file's baseUrl when available; falls back to
+                // the public default. (BRIDGE_BASE_URL is honored by getManagementClient
+                // already; we don't re-read it here to avoid divergence.)
+                readCredentials()?.baseUrl ??
+                DEFAULT_BASE_URL;
+            const snippet = renderSnippet(framework, { appId, baseUrl });
+            let configPath;
+            if (opts.config !== false) {
+                configPath = join(cwd, 'bridge-flags.config.json');
+                await writeFile(configPath, JSON.stringify({
+                    appId,
+                    appName,
+                    baseUrl,
+                    framework,
+                    provider: suggestedProviderConfig(framework),
+                }, null, 2) + '\n', 'utf8');
+            }
+            outputSuccess({
+                framework,
+                app: { id: appId, name: appName },
+                baseUrl,
+                configFile: configPath,
+                nextSteps: nextStepsFor(framework),
+                snippet,
+            });
+        }
+        catch (err) {
+            outputError(err);
+        }
+    });
+}
+// ── Framework detection ─────────────────────────────────────────────────────
+export async function detectFramework(cwd) {
+    const pkgPath = join(cwd, 'package.json');
+    let pkgRaw;
+    try {
+        pkgRaw = await readFile(pkgPath, 'utf8');
+    }
+    catch {
+        return 'unknown';
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(pkgRaw);
+    }
+    catch {
+        return 'unknown';
+    }
+    const deps = { ...(pkg.dependencies ?? {}), ...(pkg.devDependencies ?? {}) };
+    // Order matters: Next.js + React is detected as Next.js.
+    if ('next' in deps)
+        return 'nextjs';
+    if ('@sveltejs/kit' in deps || 'svelte' in deps)
+        return 'svelte';
+    if ('@nestjs/core' in deps)
+        return 'nestjs';
+    if ('@angular/core' in deps)
+        return 'angular';
+    if ('react' in deps)
+        return 'react';
+    if ('express' in deps)
+        return 'express';
+    return 'unknown';
+}
+export function renderSnippet(framework, ctx) {
+    const pkgFor = {
+        svelte: '@nebulr-group/bridge-svelte/flags',
+        react: '@nebulr-group/bridge-react/flags',
+        nextjs: '@nebulr-group/bridge-nextjs/flags',
+        angular: '@nebulr-group/bridge-angular/flags',
+        nestjs: '@nebulr-group/bridge-nestjs/flags',
+        express: '@nebulr-group/bridge-express/flags',
+    };
+    if (framework === 'unknown') {
+        return [
+            `# Bridge Flags — generic setup`,
+            ``,
+            `Couldn't auto-detect your framework. Use the core SDK directly:`,
+            ``,
+            '```ts',
+            `import { BridgeFlags } from '@nebulr-group/bridge-auth-core';`,
+            ``,
+            `export const bridge = new BridgeFlags();`,
+            `bridge.setContext({ identity: 'user-id', attributes: { /* ... */ } });`,
+            ``,
+            `// Read a flag — type is inferred from defaultValue.`,
+            `const newDashboard = bridge.flag('new-dashboard', false);`,
+            '```',
+            ``,
+            `Then point the SDK at appId=${ctx.appId} via ${ctx.baseUrl}/cloud-views/flags.`,
+        ].join('\n');
+    }
+    const pkg = pkgFor[framework];
+    // Per-framework idiomatic snippet.
+    switch (framework) {
+        case 'svelte':
+            return [
+                '# Bridge Flags — SvelteKit (flags-only)',
+                '',
+                `1. Install:`,
+                '   ```bash',
+                '   bun add @nebulr-group/bridge-svelte',
+                '   ```',
+                '',
+                '2. In `src/routes/+layout.ts`:',
+                '   ```ts',
+                `   import { BridgeFlags } from '${pkg}';`,
+                '',
+                '   export const bridge = new BridgeFlags();',
+                `   bridge.configure({ appId: '${ctx.appId}', baseUrl: '${ctx.baseUrl}' });`,
+                '   ```',
+                '',
+                '3. Use anywhere:',
+                '   ```ts',
+                '   const enabled = bridge.flag("new-dashboard", false);',
+                '   ```',
+            ].join('\n');
+        case 'react':
+            return [
+                '# Bridge Flags — React (flags-only)',
+                '',
+                `1. Install:`,
+                '   ```bash',
+                '   bun add @nebulr-group/bridge-react',
+                '   ```',
+                '',
+                '2. In `src/main.tsx`:',
+                '   ```tsx',
+                `   import { BridgeFlagsProvider } from '${pkg}';`,
+                '',
+                '   <BridgeFlagsProvider',
+                `     appId="${ctx.appId}"`,
+                `     baseUrl="${ctx.baseUrl}"`,
+                '   >',
+                '     <App />',
+                '   </BridgeFlagsProvider>',
+                '   ```',
+                '',
+                '3. Use the hook in any component:',
+                '   ```tsx',
+                `   import { useFlag } from '${pkg}';`,
+                '',
+                '   function NewDashboard() {',
+                '     const enabled = useFlag("new-dashboard", false);',
+                '     return enabled ? <V2 /> : <V1 />;',
+                '   }',
+                '   ```',
+            ].join('\n');
+        case 'nextjs':
+            return [
+                '# Bridge Flags — Next.js (flags-only)',
+                '',
+                `1. Install:`,
+                '   ```bash',
+                '   bun add @nebulr-group/bridge-nextjs',
+                '   ```',
+                '',
+                '2. Client side — `app/providers.tsx`:',
+                '   ```tsx',
+                `   "use client";`,
+                `   import { BridgeFlagsProvider } from '${pkg}';`,
+                '',
+                '   export function Providers({ children }: { children: React.ReactNode }) {',
+                '     return (',
+                '       <BridgeFlagsProvider',
+                `         appId="${ctx.appId}"`,
+                `         baseUrl="${ctx.baseUrl}"`,
+                '       >',
+                '         {children}',
+                '       </BridgeFlagsProvider>',
+                '     );',
+                '   }',
+                '   ```',
+                '',
+                '3. Server side — anywhere in a Server Component / Route Handler:',
+                '   ```ts',
+                `   import { getServerBridgeFlags } from '${pkg}/server';`,
+                '   const bridge = await getServerBridgeFlags({',
+                `     appId: '${ctx.appId}',`,
+                `     baseUrl: '${ctx.baseUrl}',`,
+                '   });',
+                '   const enabled = bridge.flag("new-dashboard", false);',
+                '   ```',
+            ].join('\n');
+        case 'angular':
+            return [
+                '# Bridge Flags — Angular (flags-only)',
+                '',
+                `1. Install:`,
+                '   ```bash',
+                '   bun add @nebulr-group/bridge-angular',
+                '   ```',
+                '',
+                '2. In `app.config.ts`:',
+                '   ```ts',
+                `   import { provideBridgeFlags } from '${pkg}';`,
+                '',
+                '   export const appConfig: ApplicationConfig = {',
+                '     providers: [',
+                '       provideBridgeFlags({',
+                `         appId: '${ctx.appId}',`,
+                `         baseUrl: '${ctx.baseUrl}',`,
+                '       }),',
+                '     ],',
+                '   };',
+                '   ```',
+                '',
+                '3. Inject the service:',
+                '   ```ts',
+                `   import { BridgeFlagsService } from '${pkg}';`,
+                '',
+                '   constructor(private flags: BridgeFlagsService) {}',
+                '',
+                '   newDashboard = this.flags.flag("new-dashboard", false);',
+                '   ```',
+            ].join('\n');
+        case 'nestjs':
+            return [
+                '# Bridge Flags — NestJS (flags-only, backend mode)',
+                '',
+                `1. Install:`,
+                '   ```bash',
+                '   bun add @nebulr-group/bridge-nestjs',
+                '   ```',
+                '',
+                '2. Import the module in `app.module.ts`:',
+                '   ```ts',
+                `   import { BridgeFlagsModule } from '${pkg}';`,
+                '',
+                '   @Module({',
+                '     imports: [',
+                '       BridgeFlagsModule.forRoot({',
+                `         appId: '${ctx.appId}',`,
+                `         baseUrl: '${ctx.baseUrl}',`,
+                '         mode: "backend",',
+                '       }),',
+                '     ],',
+                '   })',
+                '   export class AppModule {}',
+                '   ```',
+                '',
+                '3. Inject in any service / controller:',
+                '   ```ts',
+                `   import { BridgeFlagsService } from '${pkg}';`,
+                '',
+                '   constructor(private flags: BridgeFlagsService) {}',
+                '',
+                '   async handleRequest(req) {',
+                '     const enabled = this.flags.flag("new-checkout", false, {',
+                '       identity: req.user?.id,',
+                '       attributes: { plan: req.user?.plan },',
+                '     });',
+                '   }',
+                '   ```',
+            ].join('\n');
+        case 'express':
+            return [
+                '# Bridge Flags — Express (flags-only, backend mode)',
+                '',
+                `1. Install:`,
+                '   ```bash',
+                '   bun add @nebulr-group/bridge-express',
+                '   ```',
+                '',
+                '2. At app bootstrap:',
+                '   ```ts',
+                `   import { createBridgeFlags } from '${pkg}';`,
+                '',
+                '   const bridge = createBridgeFlags({',
+                `     appId: '${ctx.appId}',`,
+                `     baseUrl: '${ctx.baseUrl}',`,
+                '     mode: "backend",',
+                '   });',
+                '',
+                '   app.use(bridge.middleware());',
+                '   ```',
+                '',
+                '3. In a handler:',
+                '   ```ts',
+                '   app.get("/", (req, res) => {',
+                '     const enabled = req.bridge.flag("new-home", false);',
+                '     res.send(enabled ? "v2" : "v1");',
+                '   });',
+                '   ```',
+            ].join('\n');
+    }
+}
+// ── Provider config + next-steps blurbs ─────────────────────────────────────
+function suggestedProviderConfig(framework) {
+    if (framework === 'nestjs' || framework === 'express') {
+        return { mode: 'backend', telemetry: { enabled: true, flushIntervalMs: 5000 } };
+    }
+    return { mode: 'frontend', telemetry: { enabled: true, flushIntervalMs: 5000 } };
+}
+function nextStepsFor(framework) {
+    const base = [
+        'Apply the printed snippet to the file noted above.',
+        'Run `bridge guide flags' + (framework !== 'unknown' ? ` --framework ${framework}` : '') + '` for the full integration prompt.',
+        'Create your first flag: `bridge flag create --key hello-flag --state on --value-type boolean --on-value true --off-value false`',
+        'Eval it locally: `bridge flag eval hello-flag --identity demo-user`',
+    ];
+    if (framework === 'unknown') {
+        return [
+            'Could not auto-detect your framework — pass --framework <name> to scope the snippet.',
+            ...base,
+        ];
+    }
+    return base;
+}
+/** Probe whether a path exists (used by tests). */
+export async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=flag-init.command.js.map

package/dist/commands/flag-init.command.js.map

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

package/dist/commands/flag.command.d.ts

@@ -1,3 +1,95 @@
 import { Command } from 'commander';
+import type { FlagState, FlagValueType } from '@nebulr-group/bridge-auth-core';
+interface Condition {
+    attribute: string;
+    operator: string;
+    value?: unknown;
+}
+interface Branch {
+    conditions: Condition[];
+    returnValue: unknown;
+}
+interface Rule {
+    branches: Branch[];
+    otherwiseValue: unknown;
+    rolloutPct: number;
+    groupRef?: string;
+}
 export declare function registerFlagCommands(program: Command): void;
+interface FlagDoc {
+    key: string;
+    description?: string;
+    state: FlagState;
+    valueType: FlagValueType;
+    offValue?: unknown;
+    onValue?: unknown;
+    rule?: Rule | null;
+    schedule?: unknown;
+}
+/** Build the canonical, portable doc from a remote flag record. Pure. */
+export declare function toFlagDoc(f: Record<string, unknown>): FlagDoc;
+/** Build a create/update write payload from a doc. Pure. */
+export declare function buildWritePayloadFromDoc(doc: FlagDoc): Record<string, unknown>;
+/** Validate + normalize a doc parsed from a file. Throws on the first problem. */
+export declare function validateFlagDoc(input: unknown, index: number): FlagDoc;
+interface FlagDiff {
+    create: FlagDoc[];
+    update: {
+        id: string;
+        doc: FlagDoc;
+        changes: string[];
+    }[];
+    prune: {
+        id: string;
+        key: string;
+    }[];
+    unchanged: string[];
+}
+/** Diff file docs against remote flags (matched by key). Pure. */
+export declare function diffFlags(remote: Record<string, unknown>[], docs: FlagDoc[], opts?: {
+    prune?: boolean;
+}): FlagDiff;
+interface FlagWriteOpts {
+    key?: string;
+    description?: string;
+    state?: string;
+    valueType?: string;
+    onValue?: string;
+    offValue?: string;
+    rule?: string;
+    enabled?: boolean;
+    defaultValue?: boolean;
+}
+export declare function buildFlagWritePayload(opts: FlagWriteOpts, { partial }?: {
+    partial?: boolean;
+}): Record<string, unknown>;
+export declare function coerceValue(raw: string, type: FlagValueType): unknown;
+export declare function parseRuleArg(raw: string): Rule;
+export declare function parseAttributes(pairs: string[]): Record<string, unknown>;
+interface RuleValidationError {
+    branchIndex: number;
+    conditionIndex: number;
+    message: string;
+}
+export declare function validateRule(rule: unknown): RuleValidationError[];
+interface EvalContext {
+    identity?: string;
+    attributes: Record<string, unknown>;
+}
+interface EvalResult {
+    value: unknown;
+    variantIndex: number;
+    matched: boolean;
+    excludedByRollout: boolean;
+}
+interface CachedFlag {
+    key: string;
+    state: FlagState;
+    valueType: FlagValueType;
+    offValue: unknown;
+    onValue: unknown;
+    rule?: Rule;
+}
+export declare function evaluateLocally(cached: CachedFlag, ctx: EvalContext): EvalResult;
+export {};
 //# sourceMappingURL=flag.command.d.ts.map

package/dist/commands/flag.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flag.command.d.ts","sourceRoot":"","sources":["../../src/commands/flag.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4D3D"}
+{"version":3,"file":"flag.command.d.ts","sourceRoot":"","sources":["../../src/commands/flag.command.ts"],"names":[],"mappings":"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"}