@nebulr-group/bridge-cli 0.6.6 → 1.0.0-alpha.0

package/dist/commands/auth/use.command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use.command.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/use.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAc1D"}

package/dist/commands/auth/use.command.js

@@ -1,47 +0,0 @@
-import { CredentialSelectorError, findCredential, isExpired, listCredentials, setActiveCredential, } from '../../credentials.js';
-import { resetManagementClient } from '../../config.js';
-export function registerAuthUseCommand(auth) {
-    auth
-        .command('use <profile>')
-        .description('Switch the default app to another stored credential (no re-login)')
-        .action((profile) => {
-        try {
-            runUse(profile);
-            process.exitCode = 0;
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            process.stderr.write(`bridge auth use: ${msg}\n`);
-            process.exitCode = 1;
-        }
-    });
-}
-function runUse(profile) {
-    const stdout = process.stdout;
-    let entry;
-    try {
-        entry = findCredential(profile);
-    }
-    catch (err) {
-        if (err instanceof CredentialSelectorError)
-            throw new Error(err.message);
-        throw err;
-    }
-    setActiveCredential(entry.key);
-    resetManagementClient();
-    const name = entry.creds.label ?? entry.creds.app.name;
-    stdout.write(`Now using ${name} — ${entry.creds.app.name} (${entry.creds.app.id})\n`);
-    stdout.write(`  baseUrl=${entry.creds.baseUrl}\n`);
-    // Switching TO an expired credential is allowed — it is the user's stated
-    // intent, and refusing would leave them unable to make it the default before
-    // re-authenticating it. But it must not be a surprise at the next command.
-    if (isExpired(entry.creds)) {
-        stdout.write(`  WARNING: this credential expired ${entry.creds.expiresAt}. ` +
-            'Run `bridge auth login` to refresh it.\n');
-    }
-    const others = listCredentials().filter((e) => e.key !== entry.key);
-    if (others.length > 0) {
-        stdout.write(`  also stored: ${others.map((e) => e.creds.label ?? e.creds.app.name).join(', ')}\n`);
-    }
-}
-//# sourceMappingURL=use.command.js.map

package/dist/commands/auth/use.command.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use.command.js","sourceRoot":"","sources":["../../../src/commands/auth/use.command.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,SAAS,EACT,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,UAAU,sBAAsB,CAAC,IAAa;IAClD,IAAI;SACD,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,mEAAmE,CAAC;SAChF,MAAM,CAAC,CAAC,OAAe,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,CAAC,OAAO,CAAC,CAAC;YAChB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;YAClD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,MAAM,CAAC,OAAe;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9B,IAAI,KAAK,CAAC;IACV,IAAI,CAAC;QACH,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,uBAAuB;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzE,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,qBAAqB,EAAE,CAAC;IAExB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;IACvD,MAAM,CAAC,KAAK,CAAC,aAAa,IAAI,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IACtF,MAAM,CAAC,KAAK,CAAC,aAAa,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;IAEnD,0EAA0E;IAC1E,6EAA6E;IAC7E,2EAA2E;IAC3E,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,CAAC,KAAK,CACV,sCAAsC,KAAK,CAAC,KAAK,CAAC,SAAS,IAAI;YAC7D,0CAA0C,CAC7C,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC;IACpE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,CAAC,KAAK,CACV,kBAAkB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACtF,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function registerBrandingCommands(program: Command): void;
-//# sourceMappingURL=branding.command.d.ts.map

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

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

package/dist/commands/branding.command.js

@@ -1,42 +0,0 @@
-import { getManagementClient } from '../config.js';
-import { outputSuccess, outputError } from '../output.js';
-export function registerBrandingCommands(program) {
-    const branding = program.command('branding').description('Manage branding');
-    branding.command('get')
-        .description('Get current branding configuration')
-        .action(async () => {
-        try {
-            outputSuccess(await getManagementClient().branding.get());
-        }
-        catch (err) {
-            outputError(err);
-        }
-    });
-    branding.command('update')
-        .description('Update branding')
-        .option('--bg-color <color>', 'Background color')
-        .option('--text-color <color>', 'Text color')
-        .option('--link-color <color>', 'Link color')
-        .option('--primary-btn-bg <color>', 'Primary button background')
-        .option('--primary-btn-text <color>', 'Primary button text')
-        .option('--font-family <font>', 'Font family')
-        .option('--border-radius <radius>', 'Border radius')
-        .action(async (opts) => {
-        try {
-            const data = Object.fromEntries(Object.entries({
-                bgColor: opts.bgColor,
-                textColor: opts.textColor,
-                linkColor: opts.linkColor,
-                primaryButtonBgColor: opts.primaryBtnBg,
-                primaryButtonTextColor: opts.primaryBtnText,
-                fontFamily: opts.fontFamily,
-                borderRadius: opts.borderRadius,
-            }).filter(([, v]) => v !== undefined));
-            outputSuccess(await getManagementClient().branding.update(data));
-        }
-        catch (err) {
-            outputError(err);
-        }
-    });
-}
-//# sourceMappingURL=branding.command.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"branding.command.js","sourceRoot":"","sources":["../../src/commands/branding.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,UAAU,wBAAwB,CAAC,OAAgB;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAE5E,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;SACpB,WAAW,CAAC,oCAAoC,CAAC;SACjD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,IAAI,CAAC;YAAC,aAAa,CAAC,MAAM,mBAAmB,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QAAC,CAAC;QAClE,OAAO,GAAG,EAAE,CAAC;YAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEL,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;SACvB,WAAW,CAAC,iBAAiB,CAAC;SAC9B,MAAM,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;SAChD,MAAM,CAAC,sBAAsB,EAAE,YAAY,CAAC;SAC5C,MAAM,CAAC,sBAAsB,EAAE,YAAY,CAAC;SAC5C,MAAM,CAAC,0BAA0B,EAAE,2BAA2B,CAAC;SAC/D,MAAM,CAAC,4BAA4B,EAAE,qBAAqB,CAAC;SAC3D,MAAM,CAAC,sBAAsB,EAAE,aAAa,CAAC;SAC7C,MAAM,CAAC,0BAA0B,EAAE,eAAe,CAAC;SACnD,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAC7B,MAAM,CAAC,OAAO,CAAC;gBACb,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,oBAAoB,EAAE,IAAI,CAAC,YAAY;gBACvC,sBAAsB,EAAE,IAAI,CAAC,cAAc;gBAC3C,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;aAChC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CACtC,CAAC;YACF,aAAa,CAAC,MAAM,mBAAmB,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAW,CAAC,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function registerEventCommands(program: Command): void;
-//# sourceMappingURL=event.command.d.ts.map

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

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

package/dist/commands/event.command.js

@@ -1,27 +0,0 @@
-import { getManagementClient } from '../config.js';
-import { outputSuccess, outputError } from '../output.js';
-export function registerEventCommands(program) {
-    const event = program.command('event').description('Query event log');
-    event.command('list')
-        .description('Query events')
-        .option('--type <type>', 'Event type filter')
-        .option('--tenant-id <id>', 'Filter by tenant')
-        .option('--user-id <id>', 'Filter by user')
-        .option('--since <duration>', 'Time filter (e.g., "24h", "7d", ISO date)')
-        .option('--limit <n>', 'Max results', parseInt)
-        .action(async (opts) => {
-        try {
-            outputSuccess(await getManagementClient().events.query({
-                type: opts.type,
-                tenantId: opts.tenantId,
-                userId: opts.userId,
-                since: opts.since,
-                limit: opts.limit,
-            }));
-        }
-        catch (err) {
-            outputError(err);
-        }
-    });
-}
-//# sourceMappingURL=event.command.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"event.command.js","sourceRoot":"","sources":["../../src/commands/event.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAEtE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;SAClB,WAAW,CAAC,cAAc,CAAC;SAC3B,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAAC;SAC5C,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;SAC9C,MAAM,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;SAC1C,MAAM,CAAC,oBAAoB,EAAE,2CAA2C,CAAC;SACzE,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,QAAQ,CAAC;SAC9C,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,IAAI,CAAC;YACH,aAAa,CAAC,MAAM,mBAAmB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;gBACrD,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC,CAAC,CAAC;QACN,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -1,13 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"flag-init.command.d.ts","sourceRoot":"","sources":["../../src/commands/flag-init.command.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,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,CAkEjE;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,CA8ThF;AAuCD,mDAAmD;AACnD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D"}

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

@@ -1,463 +0,0 @@
-// 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 framework's REAL flag-reading setup snippet
-//   - A `bridge-flags.config.json` next to package.json with appId + baseUrl
-//     + suggested provider config
-//
-// TBP-206 — every snippet below MUST correspond to a symbol that actually
-// exists in the named package at an import specifier that actually resolves.
-// The previous revision invented `createBridgeFlags()` middleware for express,
-// `BridgeFlagsProvider` for react/nextjs and `provideBridgeFlags` for angular,
-// and pointed every framework at a `/flags` subpath — several of which are not
-// declared in the package's `exports` map. Agents followed the scaffold and
-// wrote code that could not resolve, let alone run. If you change a snippet,
-// re-verify it against the package source first.
-//
-// 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, getResolvedBaseUrl } from '../config.js';
-import { outputSuccess, outputError } from '../output.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')
-        .option('--force', 'Overwrite an existing bridge-flags.config.json')
-        .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 ?? '';
-            // The environment the app was just read from, so the project is wired
-            // to the same one (TBP-708).
-            const baseUrl = opts.baseUrl ?? getResolvedBaseUrl();
-            const snippet = renderSnippet(framework, { appId, baseUrl });
-            let configPath;
-            if (opts.config !== false) {
-                configPath = join(cwd, 'bridge-flags.config.json');
-                // Never clobber a config someone may have edited (TBP-706).
-                if (!opts.force && (await pathExists(configPath))) {
-                    throw new Error(`${configPath} already exists. Pass --force to overwrite it, or --no-config to leave it and only print the setup.`);
-                }
-                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) {
-    // Import specifiers that actually resolve for each framework (TBP-206).
-    //
-    //   svelte / react  — declare "./flags" in their package.json `exports` map.
-    //   nextjs          — has NO "./flags" and NO "." key; FF 2.0 is folded into
-    //                     "./client", server-side flags live under "./server".
-    //   angular         — ships a single ng-packagr entry point; everything comes
-    //                     from the bare specifier.
-    //   nestjs          — declares "./flags" since 0.6.0 (TBP-613). Before that
-    //                     it had no `exports` map, so `<pkg>/flags` fell back to
-    //                     legacy resolution and 404'd, and this scaffolder
-    //                     emitted `<pkg>/dist/flags` instead. Reaching into the
-    //                     build directory was never right — it froze the dist
-    //                     layout into a public contract — and generating it here
-    //                     is how the wrong path spread. Requires >= 0.6.0.
-    //   express         — no `exports` map and no flags entry point; the flag
-    //                     surface is on the bare specifier.
-    const pkgFor = {
-        svelte: '@nebulr-group/bridge-svelte/flags',
-        react: '@nebulr-group/bridge-react/flags',
-        nextjs: '@nebulr-group/bridge-nextjs/client',
-        angular: '@nebulr-group/bridge-angular',
-        nestjs: '@nebulr-group/bridge-nestjs/flags',
-        express: '@nebulr-group/bridge-express',
-    };
-    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';`,
-            ``,
-            `// 'backend' refuses to bucket rollout flags without an identity;`,
-            `// use 'frontend' in a browser runtime.`,
-            `export const bridge = new BridgeFlags({ mode: 'backend' });`,
-            ``,
-            `// Load the rule set for your app, for local evaluation (the framework SDKs do this`,
-            `// for you). To have Bridge evaluate for a signed-in user instead, see the`,
-            `// bulkEvaluate endpoint in \`bridge guide custom\`.`,
-            `const res = await fetch(`,
-            `  '${ctx.baseUrl}/admin/flags-internal/flags-cache/${ctx.appId}',`,
-            `);`,
-            `bridge.hydrate(await res.json());`,
-            ``,
-            `bridge.setContext({ identity: 'user-id', attributes: { /* plan, role, ... */ } });`,
-            ``,
-            `// Read a flag — T is inferred from defaultValue (boolean | string | number | json).`,
-            `// Returns FlagEvalResult<T> = { value, passed }, NOT a bare value.`,
-            `const { value: newDashboard } = bridge.flag('new-dashboard', false);`,
-            '```',
-        ].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. Configure + mount the runtime once — `src/routes/+layout.svelte`:',
-                '   ```svelte',
-                '   <script lang="ts">',
-                `     import { BridgeProvider, bridgeConfig } from '@nebulr-group/bridge-svelte';`,
-                '',
-                '     bridgeConfig.initConfig({',
-                `       appId: '${ctx.appId}',`,
-                `       apiBaseUrl: '${ctx.baseUrl}',`,
-                '     });',
-                '',
-                '     let { children } = $props();',
-                '   </script>',
-                '',
-                '   <BridgeProvider>{@render children()}</BridgeProvider>',
-                '   ```',
-                '',
-                '3. Read a flag in any component under the provider:',
-                '   ```svelte',
-                '   <script lang="ts">',
-                `     import { useFlag } from '${pkg}';`,
-                '',
-                '     // Sync rune. Returns { value, passed } — NOT a bare value.',
-                '     // T is inferred from the default: boolean | string | number | json.',
-                `     const newDashboard = useFlag('new-dashboard', false);`,
-                '   </script>',
-                '',
-                '   {#if newDashboard.value}<V2 />{:else}<V1 />{/if}',
-                '   ```',
-                '',
-                '   Or declaratively:',
-                '   ```svelte',
-                `   import { FeatureFlag } from '${pkg}';`,
-                '   <FeatureFlag flag="new-dashboard">…</FeatureFlag>',
-                '   ```',
-            ].join('\n');
-        case 'react':
-            return [
-                '# Bridge Flags — React (flags-only)',
-                '',
-                `1. Install:`,
-                '   ```bash',
-                '   bun add @nebulr-group/bridge-react',
-                '   ```',
-                '',
-                '2. In `src/main.tsx` — flags ride on the core Bridge runtime, so mount',
-                '   `<BridgeProvider>` (there is no separate flags provider):',
-                '   ```tsx',
-                `   import { BridgeProvider } from '@nebulr-group/bridge-react';`,
-                '',
-                `   <BridgeProvider config={{ appId: '${ctx.appId}', apiBaseUrl: '${ctx.baseUrl}' }}>`,
-                '     <App />',
-                '   </BridgeProvider>',
-                '   ```',
-                '   (`VITE_BRIDGE_APP_ID` / `VITE_BRIDGE_API_BASE_URL` override the props.)',
-                '',
-                '3. Use the hook in any component:',
-                '   ```tsx',
-                `   import { useFlag } from '${pkg}';`,
-                '',
-                '   function NewDashboard() {',
-                '     // Sync. Returns { value, passed } — destructure `value`.',
-                `     const { value: 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`. FF 2.0 is folded into the',
-                '   `./client` entry point; there is no `/flags` subpath and no separate',
-                '   flags provider:',
-                '   ```tsx',
-                `   "use client";`,
-                `   import { BridgeProvider } from '${pkg}';`,
-                '',
-                '   export function Providers({ children }: { children: React.ReactNode }) {',
-                '     return (',
-                `       <BridgeProvider config={{ appId: '${ctx.appId}', apiBaseUrl: '${ctx.baseUrl}' }}>`,
-                '         {children}',
-                '       </BridgeProvider>',
-                '     );',
-                '   }',
-                '   ```',
-                '',
-                '   Then in any client component:',
-                '   ```tsx',
-                `   import { useFlag } from '${pkg}';`,
-                `   const { value: enabled } = useFlag('new-dashboard', false);`,
-                '   ```',
-                '',
-                '3. Server side — Server Component / Route Handler / middleware. The',
-                '   server flag surface is a singleton, and every read is async and takes',
-                '   the `NextRequest` (that is where identity comes from):',
-                '   ```ts',
-                `   import { FeatureFlagServer } from '@nebulr-group/bridge-nextjs/server';`,
-                '',
-                '   // Once at boot:',
-                '   FeatureFlagServer.getInstance().init({',
-                `     appId: '${ctx.appId}',`,
-                `     apiBaseUrl: '${ctx.baseUrl}',`,
-                '   });',
-                '',
-                '   // Per request — evaluated locally in-process, no round trip per flag:',
-                `   const enabled = await FeatureFlagServer.getInstance().flagServer('new-dashboard', false, request);`,
-                '   ```',
-            ].join('\n');
-        case 'angular':
-            return [
-                '# Bridge Flags — Angular (flags-only)',
-                '',
-                `1. Install:`,
-                '   ```bash',
-                '   bun add @nebulr-group/bridge-angular',
-                '   ```',
-                '',
-                '2. In `app.config.ts` — one provider covers auth + flags (the package',
-                '   ships a single entry point, so import from the bare specifier):',
-                '   ```ts',
-                `   import { provideBridge } from '${pkg}';`,
-                '',
-                '   export const appConfig: ApplicationConfig = {',
-                '     providers: [',
-                '       provideBridge({',
-                `         appId: '${ctx.appId}',`,
-                `         apiBaseUrl: '${ctx.baseUrl}',`,
-                '       }),',
-                '     ],',
-                '   };',
-                '   ```',
-                '',
-                '3. Inject `BridgeService` — `flag()` returns a Signal of { value, passed }:',
-                '   ```ts',
-                `   import { BridgeService } from '${pkg}';`,
-                '',
-                '   private bridge = inject(BridgeService);',
-                '',
-                `   newDashboard = this.bridge.flag('new-dashboard', false);`,
-                '   // template: {{ newDashboard().value }}',
-                '',
-                '   // One-shot, non-reactive read:',
-                `   // const { value } = this.bridge.evaluate('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` (requires bridge-nestjs >= 0.6.0):',
-                '   ```ts',
-                `   import { BridgeFlagsModule } from '${pkg}';`,
-                '',
-                '   @Module({',
-                '     imports: [',
-                '       BridgeFlagsModule.forRoot({',
-                `         apiBaseUrl: '${ctx.baseUrl}',`,
-                `         appId: '${ctx.appId}',`,
-                `         apiKey: process.env.BRIDGE_API_KEY!, // a Bridge API token, never the app id`,
-                `         mode: 'backend',`,
-                '       }),',
-                '     ],',
-                '   })',
-                '   export class AppModule {}',
-                '   ```',
-                '',
-                '3. Inject in any service / controller:',
-                '   ```ts',
-                `   import { BridgeFlagsService } from '${pkg}';`,
-                '',
-                '   constructor(private flags: BridgeFlagsService) {}',
-                '',
-                '   handleRequest(req) {',
-                '     // Sync, evaluated locally in-process. Returns T directly.',
-                `     const enabled = this.flags.flag('new-checkout', false, {`,
-                '       identity: req.bridgeUser?.id,',
-                '       attributes: { plan: req.bridgeUser?.plan },',
-                '     });',
-                '   }',
-                '   ```',
-            ].join('\n');
-        case 'express':
-            return [
-                '# Bridge Flags — Express',
-                '',
-                '   NOTE: express does not have a standalone flags runtime. Flags are',
-                '   part of the auth middleware, are boolean-only, require a user JWT,',
-                '   and are evaluated remotely by the Bridge API (see TBP-516).',
-                '',
-                `1. Install:`,
-                '   ```bash',
-                '   bun add @nebulr-group/bridge-express',
-                '   ```',
-                '',
-                '2. At app bootstrap:',
-                '   ```ts',
-                `   import { createBridge } from '${pkg}';`,
-                '',
-                '   const bridge = createBridge({',
-                `     appId: '${ctx.appId}',`,
-                `     apiBaseUrl: '${ctx.baseUrl}',`,
-                '     guard: { defaultAccess: \'protected\' },',
-                '   });',
-                '',
-                '   app.use(bridge.auth());',
-                '   ```',
-                '',
-                '3. Gate a route on a flag — `featureFlag` accepts',
-                '   `string | { any: string[] } | { all: string[] }`; a miss is a 403:',
-                '   ```ts',
-                `   app.get('/beta', bridge.protect({ featureFlag: 'new-home' }), (req, res) => {`,
-                `     res.send('v2');`,
-                '   });',
-                '',
-                '   // Or centrally, via guard.rules:',
-                `   // { path: '/beta/**', privilege: 'AUTHENTICATED', featureFlag: { any: ['new-home', 'beta'] } }`,
-                '   ```',
-                '',
-                '4. Read a flag inside a handler:',
-                '   ```ts',
-                `   import { BridgeConfigService, FeatureFlagService } from '${pkg}';`,
-                '',
-                '   const flags = new FeatureFlagService(',
-                `     new BridgeConfigService({ appId: '${ctx.appId}', apiBaseUrl: '${ctx.baseUrl}' }),`,
-                '   );',
-                '',
-                `   app.get('/', bridge.protect(), async (req, res) => {`,
-                '     // Boolean only. Async — remote evaluation, cached 5 min per token.',
-                `     const enabled = await flags.isEnabled('new-home', req.bridgeAccessToken!);`,
-                `     res.send(enabled ? 'v2' : 'v1');`,
-                '   });',
-                '   ```',
-            ].join('\n');
-    }
-}
-// ── Provider config + next-steps blurbs ─────────────────────────────────────
-function suggestedProviderConfig(framework) {
-    // Keys mirror the real option names on the framework's flags runtime
-    // (`createBridgeFlags` / `BridgeFlagsModule.forRoot`) — `mode` is
-    // `'frontend' | 'backend'`, `telemetry` is a partial TelemetryBatcherConfig.
-    if (framework === 'express') {
-        // express has no BridgeFlags runtime — nothing to configure. Flags are
-        // enforced through `bridge.protect({ featureFlag })` and evaluated remotely
-        // by the Bridge API. See TBP-516.
-        return {
-            runtime: 'none',
-            note: 'bridge-express evaluates flags remotely inside the auth middleware; there is no local flags provider to configure.',
-        };
-    }
-    if (framework === 'nestjs') {
-        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