@adonis-agora/flags 0.0.0-stage → 0.1.0

package/dist/commands/flags_set.js

@@ -0,0 +1,97 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { args, flags } from '@adonisjs/core/ace';
+import { cliActor, FlagsCommand } from './shared.js';
+/** Applies a `flags:set` value. Exported for tests. */
+export function applySetValue(admin, key, value, actor, options) {
+    if (value === 'on')
+        return admin.turnOn(key, actor, options);
+    if (value === 'off')
+        return admin.turnOff(key, actor, options);
+    if (value === 'kill')
+        return admin.setEnabled(key, false, actor, options);
+    if (value === 'unkill')
+        return admin.setEnabled(key, true, actor, options);
+    const percent = /^(\d+(?:\.\d+)?)%$/.exec(value);
+    if (percent)
+        return admin.setRollout(key, Number(percent[1]), actor, options);
+    return setVariantOrValue(admin, key, value, actor, options);
+}
+/** A variant by name; otherwise a value of the flag's type (`25` for a number flag, JSON for json). */
+async function setVariantOrValue(admin, key, value, actor, options) {
+    const definition = await admin.definition(key, options.environment);
+    if (Object.hasOwn(definition.variants, value))
+        return admin.setVariant(key, value, actor, options);
+    const type = admin.declarations[key]?.type ??
+        definition.declaration?.type ??
+        typeof Object.values(definition.variants)[0];
+    if (type === 'number') {
+        const number = Number(value);
+        if (value.trim() === '' || !Number.isFinite(number)) {
+            throw new Error(`"${value}" is not a number, and ${key} is a number flag`);
+        }
+        return admin.setValue(key, number, actor, options);
+    }
+    if (type === 'json' || type === 'object') {
+        let parsed;
+        try {
+            parsed = JSON.parse(value);
+        }
+        catch {
+            throw new Error(`"${value}" is not valid JSON, and ${key} is a JSON flag`);
+        }
+        return admin.setValue(key, parsed, actor, options);
+    }
+    if (type === 'string' &&
+        !definition.declaration?.variants &&
+        !admin.declarations[key]?.variants) {
+        return admin.setValue(key, value, actor, options);
+    }
+    const known = Object.keys(definition.variants).join(', ');
+    throw new Error(`${key} has no variant "${value}" (variants: ${known})`);
+}
+export default class FlagsSet extends FlagsCommand {
+    static commandName = 'flags:set';
+    static description = 'Change what a flag serves: on | off | kill | unkill | <n>% (rollout) | <variant> | <value>';
+    async run() {
+        const runtime = await this.runtime();
+        const result = await applySetValue(runtime.admin, this.key, this.value, cliActor(this.as), {
+            ...(this.env ? { environment: this.env } : {}),
+            ...(this.note ? { note: this.note } : {}),
+        });
+        if (result.status === 'applied')
+            this.logger.success(`${this.key} → ${this.value} (ruleset version ${result.version})`);
+        else
+            this.logger.warning(`approval required: change request ${result.request.id} is pending`);
+    }
+}
+__decorate([
+    args.string({ description: 'Flag key' }),
+    __metadata("design:type", String)
+], FlagsSet.prototype, "key", void 0);
+__decorate([
+    args.string({
+        description: 'on, off, kill, unkill, 25%, a variant name, or a value (number/string/JSON flags)',
+    }),
+    __metadata("design:type", String)
+], FlagsSet.prototype, "value", void 0);
+__decorate([
+    flags.string({ description: 'Environment (default: the configured one)' }),
+    __metadata("design:type", String)
+], FlagsSet.prototype, "env", void 0);
+__decorate([
+    flags.string({ description: 'Why (kept on the change request / audit)' }),
+    __metadata("design:type", String)
+], FlagsSet.prototype, "note", void 0);
+__decorate([
+    flags.string({ description: 'Act as this actor id instead of cli:<user>' }),
+    __metadata("design:type", String)
+], FlagsSet.prototype, "as", void 0);
+//# sourceMappingURL=flags_set.js.map

package/dist/commands/flags_set.js.map

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

package/dist/commands/flags_types.d.ts

@@ -0,0 +1,18 @@
+import type { FlagDeclaration } from '../src/declare.js';
+import { FlagsCommand } from './shared.js';
+/**
+ * The `.d.ts` for console-created flags. Code-declared flags are left to `InferFlags` in
+ * `config/flags.ts` (their exact JSON types come from code). Exported for tests.
+ */
+export declare function renderFlagTypes(consoleFlags: Record<string, FlagDeclaration>, options: {
+    strict: boolean;
+}): string;
+export default class FlagsTypes extends FlagsCommand {
+    static commandName: string;
+    static description: string;
+    env?: string;
+    out?: string;
+    strict: boolean;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=flags_types.d.ts.map

package/dist/commands/flags_types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags_types.d.ts","sourceRoot":"","sources":["../../commands/flags_types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAc3C;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAC7C,OAAO,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GAC3B,MAAM,CA6BR;AAED,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,YAAY;IAClD,OAAgB,WAAW,SAAiB;IAC5C,OAAgB,WAAW,SAAoE;IAGvF,GAAG,CAAC,EAAE,MAAM,CAAC;IAGb,GAAG,CAAC,EAAE,MAAM,CAAC;IAMb,MAAM,EAAE,OAAO,CAAC;IAET,GAAG,kBAgBjB;CACF"}

package/dist/commands/flags_types.js

@@ -0,0 +1,94 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, isAbsolute, join } from 'node:path';
+import { flags } from '@adonisjs/core/ace';
+import { FlagsCommand } from './shared.js';
+/** The TypeScript type a declaration's values have. */
+function typeOf(declaration) {
+    if (declaration.type === 'boolean')
+        return 'boolean';
+    if (declaration.type === 'number')
+        return 'number';
+    if (declaration.type === 'string') {
+        return declaration.variants?.length
+            ? declaration.variants.map((v) => JSON.stringify(v)).join(' | ')
+            : 'string';
+    }
+    return 'JsonValue';
+}
+/**
+ * The `.d.ts` for console-created flags. Code-declared flags are left to `InferFlags` in
+ * `config/flags.ts` (their exact JSON types come from code). Exported for tests.
+ */
+export function renderFlagTypes(consoleFlags, options) {
+    const entries = Object.keys(consoleFlags)
+        .sort()
+        .map((key) => {
+        const declaration = consoleFlags[key];
+        const doc = declaration.description
+            ? `    /** ${declaration.description.replaceAll('*/', '* /')} */\n`
+            : '';
+        return `${doc}    ${JSON.stringify(key)}: ${typeOf(declaration)};`;
+    })
+        .join('\n');
+    return `// Generated by \`node ace flags:types\` from the flags created in the console. Do not edit:
+// regenerate after creating or changing a flag there.
+import type { JsonValue } from '@adonis-agora/flags';
+
+declare module '@adonis-agora/flags/types' {
+  interface FlagsList {
+${entries}
+  }${options.strict
+        ? `
+  /** Every flag is now typed: unknown keys are compile errors. */
+  interface FlagsSettings {
+    strictKeys: true;
+  }`
+        : ''}
+}
+`;
+}
+export default class FlagsTypes extends FlagsCommand {
+    static commandName = 'flags:types';
+    static description = 'Generate TypeScript types for the flags created in the console';
+    async run() {
+        const runtime = await this.runtime();
+        const environment = this.env ?? runtime.manager.environment;
+        const ruleset = await runtime.store.readRuleset(environment);
+        const code = runtime.manager.declarations;
+        const consoleFlags = {};
+        for (const [key, definition] of Object.entries(ruleset.flags)) {
+            if (definition.declaration && !code[key])
+                consoleFlags[key] = { ...definition.declaration };
+        }
+        const target = this.out ?? 'types/flags.d.ts';
+        const path = isAbsolute(target) ? target : join(this.app.appRoot.pathname, target);
+        await mkdir(dirname(path), { recursive: true });
+        await writeFile(path, renderFlagTypes(consoleFlags, { strict: this.strict }));
+        this.logger.success(`${Object.keys(consoleFlags).length} console flag(s) typed in ${target}${this.strict ? ' (strict keys)' : ''}`);
+    }
+}
+__decorate([
+    flags.string({ description: 'Environment to read (default: the configured one)' }),
+    __metadata("design:type", String)
+], FlagsTypes.prototype, "env", void 0);
+__decorate([
+    flags.string({ description: 'Output file (default: types/flags.d.ts)' }),
+    __metadata("design:type", String)
+], FlagsTypes.prototype, "out", void 0);
+__decorate([
+    flags.boolean({
+        description: 'Make unknown flag keys a compile error (default: true)',
+        default: true,
+    }),
+    __metadata("design:type", Boolean)
+], FlagsTypes.prototype, "strict", void 0);
+//# sourceMappingURL=flags_types.js.map

package/dist/commands/flags_types.js.map

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

package/dist/commands/flags_work.d.ts

@@ -0,0 +1,16 @@
+import type { CommandOptions } from '@adonisjs/core/types/ace';
+import { FlagsCommand } from './shared.js';
+/**
+ * The background loop outside web processes: relay events to sinks, run scheduled changes,
+ * recompute experiment results, maintain the event log. `--once` runs one pass and exits (cron
+ * jobs); without it the command stays up until SIGTERM.
+ */
+export default class FlagsWork extends FlagsCommand {
+    static commandName: string;
+    static description: string;
+    static options: CommandOptions;
+    once?: boolean;
+    sink?: string;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=flags_work.d.ts.map

package/dist/commands/flags_work.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags_work.d.ts","sourceRoot":"","sources":["../../commands/flags_work.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,YAAY;IACjD,OAAgB,WAAW,SAAgB;IAC3C,OAAgB,WAAW,SACgD;IAC3E,OAAgB,OAAO,EAAE,cAAc,CAAwC;IAGvE,IAAI,CAAC,EAAE,OAAO,CAAC;IAGf,IAAI,CAAC,EAAE,MAAM,CAAC;IAEP,GAAG,kBA2CjB;CACF"}

package/dist/commands/flags_work.js

@@ -0,0 +1,71 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { flags } from '@adonisjs/core/ace';
+import { FlagsCommand } from './shared.js';
+/**
+ * The background loop outside web processes: relay events to sinks, run scheduled changes,
+ * recompute experiment results, maintain the event log. `--once` runs one pass and exits (cron
+ * jobs); without it the command stays up until SIGTERM.
+ */
+export default class FlagsWork extends FlagsCommand {
+    static commandName = 'flags:work';
+    static description = 'Run the flags background work (relay, schedules, results, maintenance)';
+    static options = { startApp: true, staysAlive: true };
+    async run() {
+        const runtime = await this.runtime();
+        const worker = runtime.worker;
+        if (this.sink) {
+            if (!runtime.sinks.has(this.sink)) {
+                this.logger.error(`unknown sink "${this.sink}" (configured: ${[...runtime.sinks.keys()].join(', ') || 'none'})`);
+                this.exitCode = 1;
+                return;
+            }
+            let stopping = false;
+            const stop = () => {
+                stopping = true;
+            };
+            process.once('SIGTERM', stop);
+            process.once('SIGINT', stop);
+            do {
+                const result = await worker.relaySink(this.sink);
+                if (result)
+                    this.logger.info(`${this.sink}: delivered ${result.delivered}${result.busy ? ' (leased elsewhere)' : ''}`);
+                if (this.once)
+                    break;
+                await new Promise((resolve) => setTimeout(resolve, 5000));
+            } while (!stopping);
+            return;
+        }
+        if (this.once) {
+            await worker.runAll();
+            this.logger.success('flags: one pass done');
+            return;
+        }
+        this.logger.info('flags: worker running (Ctrl+C to stop)');
+        worker.start();
+        await new Promise((resolve) => {
+            const stop = async () => {
+                await worker.stop();
+                resolve();
+            };
+            process.once('SIGTERM', stop);
+            process.once('SIGINT', stop);
+        });
+    }
+}
+__decorate([
+    flags.boolean({ description: 'Run one pass and exit' }),
+    __metadata("design:type", Boolean)
+], FlagsWork.prototype, "once", void 0);
+__decorate([
+    flags.string({ description: 'Only relay to this sink' }),
+    __metadata("design:type", String)
+], FlagsWork.prototype, "sink", void 0);
+//# sourceMappingURL=flags_work.js.map

package/dist/commands/flags_work.js.map

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

package/dist/commands/main.d.ts

@@ -0,0 +1,15 @@
+import { ListLoader } from '@adonisjs/core/ace';
+import FlagsList from './flags_list.js';
+import { FlagsExport, FlagsForget, FlagsImport, FlagsPromote, FlagsReplay, FlagsRequests, FlagsResults, FlagsStale } from './flags_ops.js';
+import FlagsRefs from './flags_refs.js';
+import FlagsSet from './flags_set.js';
+import FlagsWork from './flags_work.js';
+/**
+ * The commands of `@adonis-agora/flags`, registered by `configure` with
+ * `rcFile.addCommand('@adonis-agora/flags/commands')`.
+ */
+declare const loader: ListLoader<typeof FlagsList | typeof FlagsExport | typeof FlagsImport | typeof FlagsPromote | typeof FlagsStale | typeof FlagsResults | typeof FlagsForget | typeof FlagsReplay | typeof FlagsRequests | typeof FlagsRefs | typeof FlagsSet | typeof FlagsWork>;
+export declare const getMetaData: () => Promise<import("@adonisjs/core/types/ace").CommandMetaData[]>;
+export declare const getCommand: (metaData: import("@adonisjs/core/types/ace").CommandMetaData) => Promise<typeof FlagsList | typeof FlagsExport | typeof FlagsImport | typeof FlagsPromote | typeof FlagsStale | typeof FlagsResults | typeof FlagsForget | typeof FlagsReplay | typeof FlagsRequests | typeof FlagsRefs | typeof FlagsSet | typeof FlagsWork | null>;
+export default loader;
+//# sourceMappingURL=main.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,SAAS,MAAM,iBAAiB,CAAC;AACxC,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,EACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,SAAS,MAAM,iBAAiB,CAAC;AACxC,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,OAAO,SAAS,MAAM,iBAAiB,CAAC;AAExC;;;GAGG;AACH,QAAA,MAAM,MAAM,iQAcV,CAAC;AAEH,eAAO,MAAM,WAAW,qEAAkC,CAAC;AAC3D,eAAO,MAAM,UAAU,uUAAiC,CAAC;eAE1C,MAAM"}

package/dist/commands/main.js

@@ -0,0 +1,30 @@
+import { ListLoader } from '@adonisjs/core/ace';
+import FlagsList from './flags_list.js';
+import { FlagsExport, FlagsForget, FlagsImport, FlagsPromote, FlagsReplay, FlagsRequests, FlagsResults, FlagsStale, } from './flags_ops.js';
+import FlagsRefs from './flags_refs.js';
+import FlagsSet from './flags_set.js';
+import FlagsTypes from './flags_types.js';
+import FlagsWork from './flags_work.js';
+/**
+ * The commands of `@adonis-agora/flags`, registered by `configure` with
+ * `rcFile.addCommand('@adonis-agora/flags/commands')`.
+ */
+const loader = new ListLoader([
+    FlagsList,
+    FlagsSet,
+    FlagsWork,
+    FlagsExport,
+    FlagsImport,
+    FlagsPromote,
+    FlagsStale,
+    FlagsResults,
+    FlagsRefs,
+    FlagsForget,
+    FlagsReplay,
+    FlagsRequests,
+    FlagsTypes,
+]);
+export const getMetaData = loader.getMetaData.bind(loader);
+export const getCommand = loader.getCommand.bind(loader);
+export default loader;
+//# sourceMappingURL=main.js.map

package/dist/commands/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,SAAS,MAAM,iBAAiB,CAAC;AACxC,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,SAAS,MAAM,iBAAiB,CAAC;AACxC,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAC1C,OAAO,SAAS,MAAM,iBAAiB,CAAC;AAExC;;;GAGG;AACH,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC;IAC5B,SAAS;IACT,QAAQ;IACR,SAAS;IACT,WAAW;IACX,WAAW;IACX,YAAY;IACZ,UAAU;IACV,YAAY;IACZ,SAAS;IACT,WAAW;IACX,WAAW;IACX,aAAa;IACb,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAe,MAAM,CAAC"}

package/dist/commands/shared.d.ts

@@ -0,0 +1,21 @@
+import type { FlagDefinition } from '@adonis-agora/flags-core';
+import { BaseCommand } from '@adonisjs/core/ace';
+import type { CommandOptions } from '@adonisjs/core/types/ace';
+import type { FlagsRuntime } from '../src/runtime.js';
+import type { Actor } from '../src/stores/store.js';
+/** Who a command acts as: `cli:<os user>`, unless `--as` says otherwise. */
+export declare function cliActor(as?: string): Actor;
+/** One line on what a flag serves. */
+export declare function describeServing(definition: FlagDefinition | undefined): string;
+/** Base for every flags command: boots the app and hands the runtime over. */
+export declare abstract class FlagsCommand extends BaseCommand {
+    static options: CommandOptions;
+    /**
+     * A refused change (unknown flag, invalid value, not allowed) is a message, not a stack trace.
+     * `@adonisjs/core` hands a command's error to this hook before printing it; returning `true`
+     * marks it handled. Programming errors keep their stack.
+     */
+    completed(): Promise<boolean>;
+    protected runtime(): Promise<FlagsRuntime>;
+}
+//# sourceMappingURL=shared.d.ts.map

package/dist/commands/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../commands/shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEpD,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAS3C;AAED,sCAAsC;AACtC,wBAAgB,eAAe,CAAC,UAAU,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,CAoB9E;AAED,8EAA8E;AAC9E,8BAAsB,YAAa,SAAQ,WAAW;IACpD,OAAgB,OAAO,EAAE,cAAc,CAAsB;IAE7D;;;;OAIG;IACY,SAAS,qBAavB;IAED,UAAgB,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,CAM/C;CACF"}

package/dist/commands/shared.js

@@ -0,0 +1,70 @@
+import { userInfo } from 'node:os';
+import { BaseCommand } from '@adonisjs/core/ace';
+/** Who a command acts as: `cli:<os user>`, unless `--as` says otherwise. */
+export function cliActor(as) {
+    if (as)
+        return { id: as };
+    let name = 'unknown';
+    try {
+        name = userInfo().username;
+    }
+    catch {
+        // containers without a passwd entry
+    }
+    return { id: `cli:${name}` };
+}
+/** One line on what a flag serves. */
+export function describeServing(definition) {
+    if (!definition)
+        return 'not configured (code default)';
+    if (!definition.enabled)
+        return `killed → ${definition.offVariant}`;
+    const parts = [];
+    const fallthrough = definition.fallthrough;
+    if ('variant' in fallthrough)
+        parts.push(`serves ${fallthrough.variant}`);
+    else {
+        const total = fallthrough.split.reduce((sum, arm) => sum + Math.max(0, arm.weight), 0) || 1;
+        parts.push(fallthrough.split
+            .filter((arm) => arm.weight > 0)
+            .map((arm) => `${arm.variant} ${Math.round((arm.weight / total) * 1000) / 10}%`)
+            .join(' / '));
+    }
+    if (definition.rules?.length)
+        parts.push(`${definition.rules.length} rule(s)`);
+    const overrides = Object.keys(definition.overrides ?? {}).length;
+    if (overrides)
+        parts.push(`${overrides} override(s)`);
+    if (definition.experiment)
+        parts.push('experiment');
+    return parts.join(', ');
+}
+/** Base for every flags command: boots the app and hands the runtime over. */
+export class FlagsCommand extends BaseCommand {
+    static options = { startApp: true };
+    /**
+     * A refused change (unknown flag, invalid value, not allowed) is a message, not a stack trace.
+     * `@adonisjs/core` hands a command's error to this hook before printing it; returning `true`
+     * marks it handled. Programming errors keep their stack.
+     */
+    async completed() {
+        const error = this.error;
+        if (error instanceof Error &&
+            !(error instanceof TypeError) &&
+            !(error instanceof ReferenceError) &&
+            !(error instanceof SyntaxError)) {
+            this.logger.error(error.message);
+            this.exitCode = 1;
+            return true;
+        }
+        return false;
+    }
+    async runtime() {
+        const runtime = (await this.app.container.make('flags.runtime'));
+        if (runtime.topology === 'tenant') {
+            throw new Error('this app is a tenant: run flags commands on the control-plane');
+        }
+        return runtime;
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/commands/shared.js.map

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

package/dist/configure.d.ts

@@ -0,0 +1,11 @@
+import type Configure from '@adonisjs/core/commands/configure';
+/**
+ * `node ace configure @adonis-agora/flags`:
+ *
+ * 1. registers the providers (flags and the console) and the commands in `adonisrc.ts`;
+ * 2. registers `ctx.flags` (router middleware) and the `flag` route guard (named middleware);
+ * 3. publishes `config/flags.ts`, `config/flags_dashboard.ts` (the console) and the optional migration;
+ * 4. adds `FLAGS_ENVIRONMENT` to the env validations.
+ */
+export declare function configure(command: Configure): Promise<void>;
+//# sourceMappingURL=configure.d.ts.map

package/dist/configure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAC;AAG/D;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBA4BjD"}

package/dist/configure.js

@@ -0,0 +1,32 @@
+import { stubsRoot } from './stubs/main.js';
+/**
+ * `node ace configure @adonis-agora/flags`:
+ *
+ * 1. registers the providers (flags and the console) and the commands in `adonisrc.ts`;
+ * 2. registers `ctx.flags` (router middleware) and the `flag` route guard (named middleware);
+ * 3. publishes `config/flags.ts`, `config/flags_dashboard.ts` (the console) and the optional migration;
+ * 4. adds `FLAGS_ENVIRONMENT` to the env validations.
+ */
+export async function configure(command) {
+    const codemods = await command.createCodemods();
+    // biome-ignore lint/suspicious/noExplicitAny: `updateRcFile` types its callback loosely.
+    await codemods.updateRcFile((rcFile) => {
+        rcFile.addProvider('@adonis-agora/flags/flags_provider');
+        rcFile.addProvider('@adonis-agora/flags/dashboard_provider');
+        rcFile.addCommand('@adonis-agora/flags/commands');
+    });
+    await codemods.registerMiddleware('router', [{ path: '@adonis-agora/flags/flags_middleware' }]);
+    await codemods.registerMiddleware('named', [
+        { name: 'flag', path: '@adonis-agora/flags/flag_middleware' },
+    ]);
+    const stubs = stubsRoot();
+    await codemods.makeUsingStub(stubs, 'config/flags.stub', {});
+    await codemods.makeUsingStub(stubs, 'config/flags_dashboard.stub', {});
+    await codemods.makeUsingStub(stubs, 'database/migrations/create_flags_tables.stub', {});
+    await codemods.defineEnvValidations({
+        leadingComment: 'Feature flags',
+        variables: { FLAGS_ENVIRONMENT: 'Env.schema.string.optional()' },
+    });
+    command.logger.info('With @adonisjs/shield, a central flags server or frontends reading flags (`browser`): exempt the token-authenticated flags API from CSRF in config/shield.ts — `exceptRoutes: (ctx) => flagsCsrfExceptions(ctx.request.url())`, imported from @adonis-agora/flags.');
+}
+//# sourceMappingURL=configure.js.map

package/dist/configure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.js","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAkB;IAChD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;IAEhD,yFAAyF;IACzF,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAW,EAAE,EAAE;QAC1C,MAAM,CAAC,WAAW,CAAC,oCAAoC,CAAC,CAAC;QACzD,MAAM,CAAC,WAAW,CAAC,wCAAwC,CAAC,CAAC;QAC7D,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,sCAAsC,EAAE,CAAC,CAAC,CAAC;IAChG,MAAM,QAAQ,CAAC,kBAAkB,CAAC,OAAO,EAAE;QACzC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qCAAqC,EAAE;KAC9D,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,6BAA6B,EAAE,EAAE,CAAC,CAAC;IACvE,MAAM,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,8CAA8C,EAAE,EAAE,CAAC,CAAC;IAExF,MAAM,QAAQ,CAAC,oBAAoB,CAAC;QAClC,cAAc,EAAE,eAAe;QAC/B,SAAS,EAAE,EAAE,iBAAiB,EAAE,8BAA8B,EAAE;KACjE,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,CAAC,IAAI,CACjB,oQAAoQ,CACrQ,CAAC;AACJ,CAAC"}

package/dist/providers/dashboard_provider.d.ts

@@ -0,0 +1,65 @@
+import type { ApplicationService } from '@adonisjs/core/types';
+/** Logged once at boot when `authorize` is omitted. Same wording in every Agora console. */
+export declare 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 declare 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 {
+    protected app: ApplicationService;
+    constructor(app: ApplicationService);
+    private warnedOnAuthorizeThrow;
+    private authorizeGuard;
+    private identity;
+    boot(): Promise<void>;
+    private registerRoutes;
+    /**
+     * 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).
+     */
+    private actorOf;
+    /** Mount the React SPA at `config.path` plus its hashed asset bundle. */
+    private registerSpaRoutes;
+    private warn;
+    /**
+     * 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.
+     */
+    private resolveGuard;
+    private warnAuthorizeThrow;
+    /**
+     * 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.
+     */
+    private enforce;
+    /** Answer a refused PAGE navigation with HTML: the built-in page or the host's own. */
+    private denyPage;
+}
+//# sourceMappingURL=dashboard_provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard_provider.d.ts","sourceRoot":"","sources":["../../providers/dashboard_provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAqB,MAAM,sBAAsB,CAAC;AA6ElF,4FAA4F;AAC5F,eAAO,MAAM,oBAAoB,qLACmJ,CAAC;AAErL,qEAAqE;AACrE,eAAO,MAAM,cAAc,sMAC0K,CAAC;AAItM;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,OAAO,OAAO,sBAAsB;IAC7B,SAAS,CAAC,GAAG,EAAE,kBAAkB;IAA7C,YAAsB,GAAG,EAAE,kBAAkB,EAAI;IAEjD,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,cAAc,CAInB;IAEH,OAAO,CAAC,QAAQ,CAAoC;IAE9C,IAAI,kBAgBT;IAED,OAAO,CAAC,cAAc;IAmFtB;;;OAGG;YACW,OAAO;IAuBrB,yEAAyE;IACzE,OAAO,CAAC,iBAAiB;YAiDX,IAAI;IASlB;;;OAGG;YACW,YAAY;YAaZ,kBAAkB;IAOhC;;;;OAIG;YACW,OAAO;IA+BrB,uFAAuF;YACzE,QAAQ;CAqBvB"}