@adonis-agora/flags 0.0.0-stage → 0.1.0

package/dist/providers/dashboard_provider.js

@@ -0,0 +1,340 @@
+import { readFile } from 'node:fs/promises';
+import { basename, resolve as resolvePath } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { resolveAccessDeniedPage, } from '../src/dashboard/access_denied_page.js';
+import { defaultActor, FALLBACK_ACTOR, toActor } from '../src/dashboard/actor.js';
+import { resolveConsoleAuthorize, } from '../src/dashboard/console_authorize.js';
+import { resolveConfig, } from '../src/dashboard/define_config.js';
+import { approveChangeRequest, audit, cancelChangeRequest, cancelSchedule, createFlag, createSchedule, deleteFlag, deleteLayer, deleteSegment, evaluateContext, experimentDetail, exportRuleset, flagDetail, importRuleset, listChangeRequests, listExperiments, listFlags, listLayers, listSchedules, listSegments, meta, ops, preview, promote, recomputeExperiment, rejectChangeRequest, saveFlag, saveHoldout, saveLayer, saveSegment, setEnabled, setOverride, setRollout, setVariant, stale, updateDeclaration, } from '../src/dashboard/handlers.js';
+import { contentTypeFor, renderIndexHtml } from '../src/dashboard/spa.js';
+import { authkitIdentity } from '../src/http/subject_resolver.js';
+import { getRuntime, hasRuntime } from '../src/services/accessor.js';
+/**
+ * Directory of the built SPA (`dist/assets/spa`, copied in by `copy:spa`), relative to this
+ * compiled provider (`dist/providers`). Resolved lazily: `fileURLToPath` throws on a non-`file:`
+ * `import.meta.url`, which would make the provider unimportable under some test runners.
+ *
+ * This reads BUILT ASSETS FROM DISK. The provider never imports `@adonis-agora/flags-dashboard` —
+ * that package is a devDependency purely so the workspace build orders them.
+ */
+let spaDir;
+function spaDirectory() {
+    spaDir ??= fileURLToPath(new URL('../assets/spa/', import.meta.url));
+    return spaDir;
+}
+/** Logged once at boot when `authorize` is omitted. Same wording in every Agora console. */
+export const NO_AUTHORIZE_WARNING = '[@adonis-agora/flags] console has no `authorize` configured: it is open outside production and denies every request in production. Set `authorize` in config/flags_dashboard.ts.';
+/** Logged at boot on a tenant, which has nothing to edit locally. */
+export const TENANT_WARNING = '[@adonis-agora/flags] this app is a flags tenant: its flags are edited on the control-plane, so the console is not mounted here. Remove the dashboard provider or open the control-plane console.';
+/**
+ * Mounts the flags console into an AdonisJS app: the `@adonis-agora/flags-dashboard` React SPA plus
+ * a JSON API over the booted flags runtime (`getRuntime()`), under a configurable path (default
+ * `/flags`).
+ *
+ * Every write goes through `FlagsAdmin`, so the console gets the validation, `authorize` hook,
+ * two-person approvals and audit trail the commands get. Writes are `POST`/`PUT`/`DELETE` only —
+ * never a `GET` a prefetcher could follow — and sit behind the same {@link enforce} guard as every
+ * read. CSRF is the host app's: `@adonisjs/shield` guards these routes like any other
+ * state-changing route of the app, and the SPA echoes its `XSRF-TOKEN` cookie in `x-xsrf-token`.
+ *
+ * Routes (relative to the configured `path`):
+ * - `GET    /`, `/assets/:file`                        → the SPA
+ * - `GET    /api/meta`                                 → environments, approvals, the acting user
+ * - `GET    /api/flags`, `/api/flags/:key`             → list / one flag (definition, audit, schedules)
+ * - `PUT    /api/flags/:key`  `DELETE /api/flags/:key` → save / remove a definition
+ * - `POST   /api/flags/:key/{enabled,rollout,variant,overrides,schedules}`
+ * - `POST   /api/preview`, `/api/evaluate`             → validate a draft / test a context
+ * - `GET    /api/segments`  `PUT|DELETE /api/segments/:key`
+ * - `GET    /api/layers`    `PUT|DELETE /api/layers/:key`  `PUT /api/holdout`
+ * - `GET    /api/experiments`, `/api/experiments/:key`  `POST /api/experiments/:key/recompute`
+ * - `GET    /api/change-requests`  `POST /api/change-requests/:id/{approve,reject,cancel}`
+ * - `GET    /api/audit`, `/api/schedules`  `DELETE /api/schedules/:id`
+ * - `GET    /api/export`  `POST /api/import`, `/api/promote`
+ * - `GET    /api/stale`, `/api/ops`
+ *
+ * On a `tenant` (no store, no admin) nothing is registered and a warning is logged.
+ */
+export default class FlagsDashboardProvider {
+    app;
+    constructor(app) {
+        this.app = app;
+    }
+    warnedOnAuthorizeThrow = false;
+    authorizeGuard = async () => ({
+        allowed: false,
+        status: 403,
+        reason: 'forbidden',
+    });
+    identity;
+    async boot() {
+        const config = resolveConfig(this.app.config.get('flags_dashboard', {}));
+        if (!config.enabled)
+            return;
+        const flagsConfig = this.app.config.get('flags', undefined);
+        if (flagsConfig?.topology === 'tenant') {
+            await this.warn(TENANT_WARNING);
+            return;
+        }
+        this.identity = flagsConfig?.identity;
+        this.authorizeGuard = await this.resolveGuard(config);
+        // The router is committed only after every provider's `boot()`: register in `booted`.
+        await this.app.booted(async () => {
+            const router = await this.app.container.make('router');
+            this.registerRoutes(router, config);
+        });
+    }
+    registerRoutes(router, config) {
+        const api = `${config.path}/api`;
+        this.registerSpaRoutes(router, config, api);
+        const json = (handler) => async (ctx) => {
+            const guard = await this.enforce(config, ctx, 'api');
+            if (!guard.allowed)
+                return;
+            if (!hasRuntime()) {
+                return ctx.response.status(503).json({
+                    error: '@adonis-agora/flags is not booted: register "@adonis-agora/flags/flags_provider" in adonisrc.ts',
+                });
+            }
+            try {
+                const actor = await this.actorOf(config, ctx);
+                const result = await handler({ runtime: getRuntime(), actor }, toApiRequest(ctx));
+                return ctx.response.status(result.status).json(result.body);
+            }
+            catch (error) {
+                return ctx.response
+                    .status(500)
+                    .json({ error: error instanceof Error ? error.message : 'internal error' });
+            }
+        };
+        const name = (suffix) => `flags_dashboard.${suffix}`;
+        router.get(`${api}/meta`, json(meta)).as(name('meta'));
+        router.get(`${api}/flags`, json(listFlags)).as(name('flags'));
+        router.get(`${api}/flags/:key`, json(flagDetail)).as(name('flags.show'));
+        router.post(`${api}/flags`, json(createFlag)).as(name('flags.create'));
+        router.put(`${api}/flags/:key`, json(saveFlag)).as(name('flags.save'));
+        router
+            .put(`${api}/flags/:key/declaration`, json(updateDeclaration))
+            .as(name('flags.declaration'));
+        router.delete(`${api}/flags/:key`, json(deleteFlag)).as(name('flags.delete'));
+        router.post(`${api}/flags/:key/enabled`, json(setEnabled)).as(name('flags.enabled'));
+        router.post(`${api}/flags/:key/rollout`, json(setRollout)).as(name('flags.rollout'));
+        router.post(`${api}/flags/:key/variant`, json(setVariant)).as(name('flags.variant'));
+        router.post(`${api}/flags/:key/overrides`, json(setOverride)).as(name('flags.overrides'));
+        router.post(`${api}/flags/:key/schedules`, json(createSchedule)).as(name('flags.schedule'));
+        // Not writes, but they take a body (a draft definition, an evaluation context) — `POST`.
+        router.post(`${api}/preview`, json(preview)).as(name('preview'));
+        router.post(`${api}/evaluate`, json(evaluateContext)).as(name('evaluate'));
+        router.get(`${api}/segments`, json(listSegments)).as(name('segments'));
+        router.put(`${api}/segments/:key`, json(saveSegment)).as(name('segments.save'));
+        router.delete(`${api}/segments/:key`, json(deleteSegment)).as(name('segments.delete'));
+        router.get(`${api}/layers`, json(listLayers)).as(name('layers'));
+        router.put(`${api}/layers/:key`, json(saveLayer)).as(name('layers.save'));
+        router.delete(`${api}/layers/:key`, json(deleteLayer)).as(name('layers.delete'));
+        router.put(`${api}/holdout`, json(saveHoldout)).as(name('holdout.save'));
+        router.get(`${api}/experiments`, json(listExperiments)).as(name('experiments'));
+        router.get(`${api}/experiments/:key`, json(experimentDetail)).as(name('experiments.show'));
+        router
+            .post(`${api}/experiments/:key/recompute`, json(recomputeExperiment))
+            .as(name('experiments.recompute'));
+        router.get(`${api}/change-requests`, json(listChangeRequests)).as(name('requests'));
+        router
+            .post(`${api}/change-requests/:id/approve`, json(approveChangeRequest))
+            .as(name('requests.approve'));
+        router
+            .post(`${api}/change-requests/:id/reject`, json(rejectChangeRequest))
+            .as(name('requests.reject'));
+        router
+            .post(`${api}/change-requests/:id/cancel`, json(cancelChangeRequest))
+            .as(name('requests.cancel'));
+        router.get(`${api}/audit`, json(audit)).as(name('audit'));
+        router.get(`${api}/schedules`, json(listSchedules)).as(name('schedules'));
+        router.delete(`${api}/schedules/:id`, json(cancelSchedule)).as(name('schedules.cancel'));
+        router.get(`${api}/export`, json(exportRuleset)).as(name('export'));
+        router.post(`${api}/import`, json(importRuleset)).as(name('import'));
+        router.post(`${api}/promote`, json(promote)).as(name('promote'));
+        router.get(`${api}/stale`, json(stale)).as(name('stale'));
+        router.get(`${api}/ops`, json(ops)).as(name('ops'));
+    }
+    /**
+     * Who is acting: the configured `actor`, else the authkit identity (its `sub` and name), else
+     * `ctx.auth.user`, else the anonymous `'dashboard'` (refused where approvals are on).
+     */
+    async actorOf(config, ctx) {
+        if (!config.actor && this.identity?.actor) {
+            try {
+                return (await this.identity.actor(ctx)) ?? FALLBACK_ACTOR;
+            }
+            catch {
+                return FALLBACK_ACTOR;
+            }
+        }
+        if (!config.actor) {
+            const identity = await authkitIdentity(ctx);
+            if (identity) {
+                const name = identity.profile?.name ?? identity.email;
+                return name ? { id: identity.userId, name } : { id: identity.userId };
+            }
+            return defaultActor(ctx);
+        }
+        try {
+            return toActor(await config.actor(ctx));
+        }
+        catch {
+            return FALLBACK_ACTOR;
+        }
+    }
+    /** Mount the React SPA at `config.path` plus its hashed asset bundle. */
+    registerSpaRoutes(router, config, api) {
+        const indexPath = config.path === '' ? '/' : config.path;
+        router
+            .get(indexPath, async (ctx) => {
+            if (!(await this.enforce(config, ctx, 'page')).allowed)
+                return;
+            let html;
+            try {
+                html = await readFile(resolvePath(spaDirectory(), 'index.html'), 'utf8');
+            }
+            catch {
+                return ctx.response
+                    .status(404)
+                    .send('The flags console SPA is not built. Run `pnpm --filter @adonis-agora/flags-dashboard build` (or the package build) to emit dist/spa.');
+            }
+            const environment = hasRuntime() ? getRuntime().manager.environment : 'production';
+            return ctx.response
+                .header('content-type', 'text/html; charset=utf-8')
+                .header('cache-control', 'no-store, must-revalidate')
+                .send(renderIndexHtml(html, config.path, api, environment));
+        })
+            .as('flags_dashboard.index');
+        router
+            .get(`${config.path}/assets/:file`, async (ctx) => {
+            if (!(await this.enforce(config, ctx, 'page')).allowed)
+                return;
+            const file = basename(String(ctx.params.file));
+            const root = resolvePath(spaDirectory(), 'assets');
+            const assetPath = resolvePath(root, file);
+            if (!assetPath.startsWith(root))
+                return ctx.response.status(404).send('');
+            let bytes;
+            try {
+                bytes = await readFile(assetPath);
+            }
+            catch {
+                return ctx.response.status(404).send('');
+            }
+            return ctx.response
+                .header('content-type', contentTypeFor(file))
+                .header('cache-control', 'public, max-age=31536000, immutable')
+                .send(bytes);
+        })
+            .as('flags_dashboard.assets');
+    }
+    async warn(message) {
+        try {
+            const logger = await this.app.container.make('logger');
+            logger.warn(message);
+        }
+        catch {
+            // Logging is best-effort: a missing logger must not stop the app from booting.
+        }
+    }
+    /**
+     * The `authorize` option turned into one guard. Omitted: open outside production, every request
+     * refused (`403`) in production; either way it says so once at boot.
+     */
+    async resolveGuard(config) {
+        if (config.authorize)
+            return resolveConsoleAuthorize(config.authorize);
+        const identity = this.identity;
+        if (identity?.authorizeConsole) {
+            return resolveConsoleAuthorize((ctx) => identity.authorizeConsole(ctx));
+        }
+        await this.warn(NO_AUTHORIZE_WARNING);
+        if (this.app.inProduction !== true)
+            return async () => ({ allowed: true });
+        return async () => ({ allowed: false, status: 403, reason: 'forbidden' });
+    }
+    async warnAuthorizeThrow(hookError) {
+        if (this.warnedOnAuthorizeThrow)
+            return;
+        this.warnedOnAuthorizeThrow = true;
+        const message = hookError instanceof Error ? hookError.message : String(hookError);
+        await this.warn(`flags dashboard authorize hook threw; treating as denial (403). ${message}`);
+    }
+    /**
+     * Run the `authorize` gate. A denial answers `401`/`403` — the access-denied PAGE for a page
+     * navigation, `{ error }` JSON for an API call; `{ redirectTo }` is a `302` for a page and
+     * `401 { error, redirectTo }` for the API. A hook that already answered keeps its answer.
+     */
+    async enforce(config, ctx, mode) {
+        // Never `if (!(await authorize(ctx)))`: a `{ allowed: false }` decision is truthy.
+        const decision = await this.authorizeGuard(ctx);
+        if (decision.allowed)
+            return { allowed: true };
+        if (decision.status === 403 && decision.error !== undefined) {
+            await this.warnAuthorizeThrow(decision.error);
+        }
+        if (decision.status === 302) {
+            if (responseAnswered(ctx))
+                return { allowed: false };
+            if (mode === 'page')
+                ctx.response.redirect(decision.redirectTo);
+            else {
+                ctx.response
+                    .status(401)
+                    .json({ error: 'unauthenticated', redirectTo: decision.redirectTo });
+            }
+            return { allowed: false };
+        }
+        if (mode === 'page') {
+            await this.denyPage(ctx, config, { status: decision.status, reason: decision.reason });
+        }
+        else if (!responseAnswered(ctx)) {
+            ctx.response
+                .status(decision.status)
+                .json({ error: decision.status === 401 ? 'unauthenticated' : 'forbidden' });
+        }
+        return { allowed: false };
+    }
+    /** Answer a refused PAGE navigation with HTML: the built-in page or the host's own. */
+    async denyPage(ctx, config, denial) {
+        const answered = () => responseAnswered(ctx);
+        if (answered())
+            return;
+        const nonce = cspNonce(ctx);
+        const info = {
+            ...denial,
+            basePath: config.path,
+            ...(nonce !== undefined ? { nonce } : {}),
+        };
+        const html = await resolveAccessDeniedPage(info, config.accessDenied, ctx, answered);
+        if (html === null)
+            return;
+        ctx.response
+            .status(info.status)
+            .header('content-type', 'text/html; charset=utf-8')
+            .header('cache-control', 'no-store, must-revalidate')
+            .send(html);
+    }
+}
+/** Whether something already answered this request (a redirect or a queued body). */
+function responseAnswered(ctx) {
+    if (ctx.response.getHeader('location'))
+        return true;
+    const response = ctx.response;
+    return response.hasLazyBody === true || response.headersSent === true;
+}
+/** The request's CSP nonce when the host runs `@adonisjs/shield` with `@nonce`. */
+function cspNonce(ctx) {
+    const nonce = ctx.response.nonce;
+    return typeof nonce === 'string' && nonce !== '' ? nonce : undefined;
+}
+/** Adapt an AdonisJS `HttpContext` to the framework-light {@link ApiRequest}. */
+function toApiRequest(ctx) {
+    return {
+        params: ctx.params,
+        query: ctx.request.qs(),
+        body: ctx.request.body(),
+    };
+}
+//# sourceMappingURL=dashboard_provider.js.map

package/dist/providers/dashboard_provider.js.map

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

package/dist/providers/flags_provider.d.ts

@@ -0,0 +1,30 @@
+import type { ApplicationService } from '@adonisjs/core/types';
+import type { FlagsManager } from '../src/manager.js';
+import { type FlagsRuntime } from '../src/runtime.js';
+declare module '@adonisjs/core/types' {
+    interface ContainerBindings {
+        'flags.manager': FlagsManager;
+        'flags.runtime': FlagsRuntime;
+    }
+}
+/**
+ * Builds the flags runtime from `config/flags.ts` once the app has booted, publishes it to the
+ * container (`flags.manager`, `flags.runtime`) and to `services/main`, mounts the control-plane
+ * routes, and decides where background work runs:
+ *
+ * - `role: 'api'` — never runs background work.
+ * - `dispatcher: 'durable'` (or `auto` with the durable provider registered) — registers durable
+ *   workflows and schedules; the durable worker runs them.
+ * - `dispatcher: 'in-process'` (or `auto` without durable) — a timer in each web/worker process;
+ *   leases make concurrent replicas safe.
+ * - Ace commands never start the loop, except `node ace flags:work`.
+ */
+export default class FlagsProvider {
+    #private;
+    protected app: ApplicationService;
+    constructor(app: ApplicationService);
+    register(): void;
+    boot(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=flags_provider.d.ts.map

package/dist/providers/flags_provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags_provider.d.ts","sourceRoot":"","sources":["../../providers/flags_provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAM/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKrE,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,iBAAiB;QACzB,eAAe,EAAE,YAAY,CAAC;QAC9B,eAAe,EAAE,YAAY,CAAC;KAC/B;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;;IAIpB,SAAS,CAAC,GAAG,EAAE,kBAAkB;IAA7C,YAAsB,GAAG,EAAE,kBAAkB,EAAI;IAEjD,QAAQ,SAGP;IA2HK,IAAI,kBAuBT;IAgCK,QAAQ,kBAKb;CACF"}

package/dist/providers/flags_provider.js

@@ -0,0 +1,184 @@
+import { readFileSync } from 'node:fs';
+import { registerDurableWorkflows } from '../src/durable.js';
+import { browserSecret, registerBrowser } from '../src/http/browser.js';
+import { ControlPlane } from '../src/http/control_plane.js';
+import { registerEdgeTag } from '../src/http/edge_tag.js';
+import { createRuntime } from '../src/runtime.js';
+import { setRuntime } from '../src/services/accessor.js';
+/**
+ * Builds the flags runtime from `config/flags.ts` once the app has booted, publishes it to the
+ * container (`flags.manager`, `flags.runtime`) and to `services/main`, mounts the control-plane
+ * routes, and decides where background work runs:
+ *
+ * - `role: 'api'` — never runs background work.
+ * - `dispatcher: 'durable'` (or `auto` with the durable provider registered) — registers durable
+ *   workflows and schedules; the durable worker runs them.
+ * - `dispatcher: 'in-process'` (or `auto` without durable) — a timer in each web/worker process;
+ *   leases make concurrent replicas safe.
+ * - Ace commands never start the loop, except `node ace flags:work`.
+ */
+export default class FlagsProvider {
+    app;
+    #runtime;
+    #building;
+    constructor(app) {
+        this.app = app;
+    }
+    register() {
+        this.app.container.singleton('flags.runtime', () => this.#build());
+        this.app.container.singleton('flags.manager', async () => (await this.#build()).manager);
+    }
+    #config() {
+        const config = this.app.config.get('flags');
+        if (!config)
+            throw new Error('config/flags.ts is missing (node ace configure @adonis-agora/flags)');
+        return config;
+    }
+    #build() {
+        this.#building ??= (async () => {
+            const config = this.#config();
+            const container = this.app.container;
+            const logger = await container.make('logger');
+            const environment = this.app.getEnvironment();
+            const ownsState = config.topology !== 'tenant';
+            const lucid = ownsState && container.hasBinding('lucid.db');
+            const runtime = await createRuntime(config, {
+                app: this.app,
+                ...(this.#packageName() ? { appName: this.#packageName() } : {}),
+                async db(connection) {
+                    if (!lucid)
+                        throw new Error('@adonisjs/lucid is not configured');
+                    const db = (await container.make('lucid.db'));
+                    return db.connection(connection);
+                },
+                async redis(connection) {
+                    if (!container.hasBinding('redis'))
+                        throw new Error('@adonisjs/redis is not configured');
+                    const redis = (await container.make('redis'));
+                    return redis.connection(connection).ioConnection;
+                },
+                autoCreateSchema: config.autoCreateSchema ?? true,
+                partitionEvents: config.partitionEvents ?? false,
+            }, {
+                logger,
+                // Timers run in servers and tests; one-shot ace commands only read and write.
+                start: true,
+                runWorker: false,
+                // A held LISTEN connection keeps `db.manager.closeAll()` waiting: ace commands
+                // (migration:run, db:seed…) would never exit.
+                listen: environment !== 'console' && environment !== 'repl',
+                onApplied: () => { },
+            });
+            this.#runtime = runtime;
+            setRuntime(runtime);
+            if (ownsState &&
+                runtime.role !== 'api' &&
+                environment !== 'console' &&
+                environment !== 'repl') {
+                await this.#startBackground(runtime, logger);
+            }
+            const realtime = config.realtime;
+            if (realtime)
+                await this.#realtime(runtime, realtime, logger);
+            return runtime;
+        })();
+        return this.#building;
+    }
+    async #durableEngine() {
+        try {
+            const durable = (await import('@adonis-agora/durable'));
+            if (!this.app.container.hasBinding(durable.WorkflowEngine))
+                return undefined;
+            return (await this.app.container.make(durable.WorkflowEngine));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async #startBackground(runtime, logger) {
+        const dispatcher = runtime.config.dispatcher ?? 'auto';
+        if (dispatcher !== 'in-process') {
+            const engine = await this.#durableEngine();
+            if (engine && registerDurableWorkflows(engine, runtime)) {
+                logger.info('[flags] background work runs as durable workflows');
+                return;
+            }
+            if (dispatcher === 'durable') {
+                throw new Error('[flags] dispatcher "durable" needs @adonis-agora/durable with its provider registered (and a version with registerSchedules)');
+            }
+        }
+        runtime.worker?.start();
+    }
+    async #realtime(runtime, realtime, logger) {
+        const channel = (typeof realtime === 'object' && realtime.channel) || 'flags/ruleset';
+        try {
+            const transmit = (await import('@adonisjs/transmit/services/main')).default;
+            runtime.source.onChange((ruleset) => transmit.broadcast(channel, { version: ruleset.version }));
+        }
+        catch {
+            logger.warn('[flags] realtime is on but @adonisjs/transmit is not installed/configured');
+        }
+    }
+    async boot() {
+        await this.app.booted(async () => {
+            const runtime = await this.#build();
+            const config = this.#config();
+            // `@flag` in Edge views, when the app renders Edge at all.
+            await registerEdgeTag();
+            if (runtime.role === 'worker')
+                return;
+            const router = await this.app.container.make('router');
+            const secret = browserSecret(runtime, this.#appKey());
+            let controlPlane;
+            if (config.topology === 'control-plane') {
+                controlPlane = new ControlPlane(runtime, config.controlPlane, secret);
+                controlPlane.register(router);
+            }
+            if (config.browser) {
+                const logger = await this.app.container.make('logger');
+                runtime.browser = registerBrowser(router, runtime, {
+                    secret,
+                    controlPlane,
+                    logger,
+                });
+            }
+        });
+    }
+    /**
+     * The app's name from its package.json (`@acme/shop` → `shop`). AdonisJS 7's `appName` is always
+     * `adonisjs_app`, which would tag every app on a control-plane alike.
+     */
+    #packageName() {
+        try {
+            const raw = readFileSync(this.app.makePath('package.json'), 'utf8');
+            const name = JSON.parse(raw).name;
+            if (typeof name !== 'string' || !name)
+                return undefined;
+            return name.replace(/^@[^/]+\//, '');
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * The app key: `app.appKey` (AdonisJS 6), else the first key of the default encryptor
+     * (`config/encryption.ts`, AdonisJS 7), else `APP_KEY`.
+     */
+    #appKey() {
+        const legacy = this.app.config.get('app.appKey', undefined);
+        if (legacy)
+            return legacy;
+        const encryption = this.app.config.get('encryption', undefined);
+        const encryptor = encryption?.list?.[encryption.default ?? ''];
+        if (encryptor?.keys?.[0])
+            return encryptor.keys[0];
+        return process.env.APP_KEY;
+    }
+    async shutdown() {
+        await this.#runtime?.close();
+        setRuntime(undefined);
+        this.#runtime = undefined;
+        this.#building = undefined;
+    }
+}
+//# sourceMappingURL=flags_provider.js.map

package/dist/providers/flags_provider.js.map

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

package/dist/services/main.d.ts

@@ -0,0 +1,17 @@
+import type { FlagsManager } from '../src/manager.js';
+/**
+ * The flags manager, ready to use:
+ *
+ * ```ts
+ * import flags from '@adonis-agora/flags/services/main'
+ *
+ * if (await flags.for(user).enabled('new_player')) { … }
+ * await flags.track(user, 'purchase', { value: order.total, client: trx })
+ * ```
+ *
+ * Resolved from the container (`flags.manager`), so rebinding it in a test changes what app code
+ * gets. In HTTP handlers, `ctx.flags` (from the middleware) is the per-request scope.
+ */
+declare let flags: FlagsManager;
+export { flags as default };
+//# sourceMappingURL=main.d.ts.map

package/dist/services/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../services/main.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,QAAA,IAAI,KAAK,EAAE,YAAY,CAAC;AAMxB,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,CAAC"}

package/dist/services/main.js

@@ -0,0 +1,20 @@
+import app from '@adonisjs/core/services/app';
+/**
+ * The flags manager, ready to use:
+ *
+ * ```ts
+ * import flags from '@adonis-agora/flags/services/main'
+ *
+ * if (await flags.for(user).enabled('new_player')) { … }
+ * await flags.track(user, 'purchase', { value: order.total, client: trx })
+ * ```
+ *
+ * Resolved from the container (`flags.manager`), so rebinding it in a test changes what app code
+ * gets. In HTTP handlers, `ctx.flags` (from the middleware) is the per-request scope.
+ */
+let flags;
+await app.booted(async () => {
+    flags = await app.container.make('flags.manager');
+});
+export { flags as default };
+//# sourceMappingURL=main.js.map

package/dist/services/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../services/main.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,6BAA6B,CAAC;AAG9C;;;;;;;;;;;;GAYG;AACH,IAAI,KAAmB,CAAC;AAExB,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;IAC1B,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,CAAC"}