@flytedesk/app-kit 0.2.0 → 0.3.0

package/dist/cli/flags-sync.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function main(argv: string[]): Promise<void>;

package/dist/cli/flags-sync.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * flags-sync — the CLI half of @flytedesk/app-kit/flags (DEC-39).
+ *
+ * A thin wrapper around the generalized sync engine in ./sync-engine.js — see that
+ * file's doc comment for the full subcommand reference (init/diff/apply/status) and
+ * how fragments/migrations/lock files work. This file only supplies the "flags"
+ * fragment name and the "flags-sync" bin name; trace-sync.ts/profile-sync.ts are the
+ * same wrapper for the trace/profile fragments.
+ */
+import { pathToFileURL } from "node:url";
+import { runSyncCli, SyncCliError } from "./sync-engine.js";
+export async function main(argv) {
+    return runSyncCli(argv, { name: "flags", binName: "flags-sync" });
+}
+const isMainModule = process.argv[1] !== undefined &&
+    import.meta.url === pathToFileURL(process.argv[1]).href;
+if (isMainModule) {
+    main(process.argv.slice(2)).catch((err) => {
+        if (!(err instanceof SyncCliError)) {
+            console.error(err);
+        }
+        process.exitCode = process.exitCode ?? 1;
+    });
+}
+//# sourceMappingURL=flags-sync.js.map

package/dist/cli/flags-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags-sync.js","sourceRoot":"","sources":["../../src/cli/flags-sync.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAc;IACvC,OAAO,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,YAAY,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;IAC7B,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAE1D,IAAI,YAAY,EAAE,CAAC;IACjB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACjD,IAAI,CAAC,CAAC,GAAG,YAAY,YAAY,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/sync-engine.js

@@ -3,12 +3,26 @@
  * (DEC-39, generalized to a second fragment for the profile module).
  *
  * This package never generates its own Prisma Client for any of its fragments.
- * Instead, this engine copies a package fragment (prisma/fragments/<fragment>.prisma)
- * into the *consumer's* own multi-file Prisma schema folder, applies that fragment's
- * raw SQL migrations directly against the consumer's configured datasource, and
- * tracks what's been applied in a lock file (`.app-kit-<fragment>.lock.json`) written
- * at the consumer project root. The consumer's own `prisma generate` then produces
- * one client that includes these models alongside their own.
+ * Instead, this engine installs a package fragment (prisma/fragments/<fragment>.prisma)
+ * into the *consumer's* own Prisma schema, applies that fragment's raw SQL migrations
+ * directly against the consumer's configured datasource, and tracks what's been
+ * applied in a lock file (`.app-kit-<fragment>.lock.json`) written at the consumer
+ * project root. The consumer's own `prisma generate` then produces one client that
+ * includes these models alongside their own.
+ *
+ * A consumer's `prisma.config.ts` `schema` setting points at one of two real layouts
+ * (see classifySchemaLayout below), and this engine handles both:
+ *   - A multi-file schema FOLDER (`schema: "prisma/schema"`, no `.prisma` suffix):
+ *     the fragment is copied as a sibling file, `prisma/schema/<fragment>.prisma`.
+ *   - A flat single-file schema.prisma (`schema: "prisma/schema.prisma"`), which is
+ *     what both real consumers (flytedesk-id, media-planner) actually use: the
+ *     fragment's model(s) are merged directly into that one file, inside a
+ *     delimited, app-kit-owned marker region (see mergeIntoFlatSchema) rather than
+ *     copied as a sibling file — a sibling file next to a flat schema.prisma is never
+ *     read by Prisma, since `schema` names that one file, not a folder. An earlier
+ *     version of this engine always did the sibling-file copy regardless of layout,
+ *     which is why the CLI had never successfully run against a real consumer
+ *     (flytedesk-id's /profile integration had to be pasted in by hand).
  *
  * Both bin commands are thin wrappers around `runSyncCli` (see src/cli/trace-sync.ts
  * and src/cli/profile-sync.ts) — everything fragment-specific is passed in as a
@@ -53,6 +67,9 @@ function sha256(content) {
 function sha256File(filePath) {
     return sha256(readFileSync(filePath));
 }
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 // ---------------------------------------------------------------------------
 // Engine: bound to one SyncFragment + the consumer root it's operating on
 // ---------------------------------------------------------------------------
@@ -155,19 +172,31 @@ class SyncEngine {
         }
         return path.resolve(path.dirname(configFile), schemaPath);
     }
-    /** Resolve the folder <fragment>.prisma gets copied into, from the config's
-     *  schema path (which may point at the folder itself, or at a single schema file
-     *  inside it, e.g. "prisma/schema.prisma"). */
-    resolveSchemaFolder(schemaPath) {
+    /**
+     * Classifies the consumer's schema layout from their prisma.config.ts `schema`
+     * path: a path ending in `.prisma` names one specific file — Prisma reads only
+     * that file, so this is the flat single-file layout, and the fragment must be
+     * merged into it directly (mergeIntoFlatSchema). Anything else names a folder —
+     * the multi-file layout — and the fragment is copied in as a sibling file
+     * (copyFragment), same as before.
+     */
+    classifySchemaLayout(schemaPath) {
         if (schemaPath.endsWith(".prisma")) {
-            return path.dirname(schemaPath);
+            return {
+                kind: "flat-file",
+                file: schemaPath,
+                prismaRoot: path.dirname(schemaPath),
+            };
         }
-        return schemaPath;
+        return {
+            kind: "folder",
+            folder: schemaPath,
+            prismaRoot: this.resolvePrismaRoot(schemaPath),
+        };
     }
     /** The conventional "prisma root" a schema folder sits under, used to locate (or
      *  create) the sibling `migrations/` directory. For the common multi-file layout
-     *  `prisma/schema/*.prisma`, that's `prisma/`; for a flat `prisma/schema.prisma`
-     *  layout, `resolveSchemaFolder` already returned `prisma/`, so this is a no-op. */
+     *  `prisma/schema/*.prisma`, that's `prisma/`. */
     resolvePrismaRoot(schemaFolder) {
         return path.basename(schemaFolder) === "schema"
             ? path.dirname(schemaFolder)
@@ -182,7 +211,10 @@ class SyncEngine {
         // with an argument array is an unescaped-concatenation footgun (path arguments
         // here can contain spaces). cross-spawn resolves and correctly quotes .cmd/.bat
         // executables on Windows without going through a shell at all.
-        const result = spawn.sync("npx", ["prisma", ...args], { cwd, stdio: "inherit" });
+        const result = spawn.sync("npx", ["prisma", ...args], {
+            cwd,
+            stdio: "inherit",
+        });
         if (result.error) {
             this.fail(`failed to run "npx prisma ${args.join(" ")}": ${result.error.message}`);
         }
@@ -204,16 +236,119 @@ class SyncEngine {
         cpSync(srcDir, destDir, { recursive: true });
     }
     // -------------------------------------------------------------------------
+    // Flat single-file schema.prisma support
+    // -------------------------------------------------------------------------
+    /**
+     * The portion of a fragment's .prisma source that gets merged into a consumer's
+     * flat schema.prisma — everything from the first `model` declaration onward,
+     * trimmed. Deliberately drops the fragment file's own leading design-rationale
+     * doc comment (see prisma/fragments/profile.prisma / trace.prisma's file
+     * headers): that comment describes the *fragment file itself* ("this file is
+     * copied by <bin> init...", "matching the raw SQL in prisma/migrations/...")
+     * which reads oddly once inlined into someone else's schema.prisma, whereas the
+     * marker region's own header (markerStart) already identifies the block as
+     * app-kit-owned and names which command manages it.
+     */
+    extractFragmentBody(fragmentSource) {
+        const lines = fragmentSource.split(/\r?\n/);
+        const firstModelLine = lines.findIndex((line) => /^model\s+\w+\s*\{/.test(line));
+        const body = firstModelLine === -1
+            ? fragmentSource
+            : lines.slice(firstModelLine).join("\n");
+        return body.trim();
+    }
+    markerStart() {
+        return `// --- @flytedesk/app-kit:${this.fragment.name} start (managed by ${this.fragment.binName} — do not hand-edit this region) ---`;
+    }
+    markerEnd() {
+        return `// --- @flytedesk/app-kit:${this.fragment.name} end ---`;
+    }
+    /**
+     * Extracts the current content of THIS fragment's own marker region from a flat
+     * schema.prisma's full text, or null if the region isn't present yet. Matching on
+     * this fragment's own name means two different fragments merged into the same
+     * flat file never see or touch each other's regions.
+     *
+     * Exact inverse of the `${start}\n${body}\n${end}` block mergeIntoFlatSchema
+     * writes, so a round trip (write, then extract) returns the same body
+     * byte-for-byte — this is what makes both mergeIntoFlatSchema's own
+     * no-op-if-unchanged check and cmdStatus's checksum comparison correct.
+     */
+    extractInstalledRegion(schemaContent) {
+        const re = new RegExp(`${escapeRegExp(this.markerStart())}\\n([\\s\\S]*?)\\n${escapeRegExp(this.markerEnd())}`);
+        const match = schemaContent.match(re);
+        return match ? match[1] : null;
+    }
+    /**
+     * Merges this fragment's model(s) into a consumer's flat single-file
+     * prisma/schema.prisma, inside a delimited, app-kit-owned marker region — the
+     * flat-file counterpart to copyFragment's sibling-file copy for the multi-file
+     * folder layout.
+     *
+     * Idempotent: running this twice with the same fragment content is a no-op (the
+     * installed region already matches, so the file isn't rewritten at all). Multiple
+     * fragments merged into the same file coexist as separate regions — this only
+     * ever reads or replaces text between ITS OWN start/end marker pair; everything
+     * else in the file (the consumer's own models, datasource/generator blocks,
+     * `schemas = [...]`, other fragments' regions) is left byte-for-byte untouched.
+     */
+    mergeIntoFlatSchema(schemaFilePath) {
+        if (!existsSync(schemaFilePath)) {
+            this.fail(`schema file not found at ${schemaFilePath} (expected a flat single-file prisma/schema.prisma)`);
+        }
+        const original = readFileSync(schemaFilePath, "utf8");
+        const body = this.extractFragmentBody(readFileSync(this.fragmentSrcPath, "utf8"));
+        const existingRegion = this.extractInstalledRegion(original);
+        if (existingRegion === body) {
+            return;
+        }
+        let updated;
+        if (existingRegion !== null) {
+            const re = new RegExp(`${escapeRegExp(this.markerStart())}\\n[\\s\\S]*?\\n${escapeRegExp(this.markerEnd())}`);
+            updated = original.replace(re, `${this.markerStart()}\n${body}\n${this.markerEnd()}`);
+        }
+        else {
+            updated = `${original.replace(/\s*$/, "")}\n\n${this.markerStart()}\n${body}\n${this.markerEnd()}\n`;
+        }
+        writeFileSync(schemaFilePath, updated, "utf8");
+    }
+    /** Installs the fragment for either layout — the one call site cmdInit/cmdApply
+     *  both use, so they can never disagree about which path a given layout takes. */
+    installFragment(layout) {
+        const bin = this.fragment.binName;
+        if (layout.kind === "folder") {
+            console.log(`${bin}: copying ${this.fragment.name}.prisma into ${layout.folder}`);
+            this.copyFragment(layout.folder);
+        }
+        else {
+            console.log(`${bin}: merging ${this.fragment.name} model(s) into ${layout.file} (managed region)`);
+            this.mergeIntoFlatSchema(layout.file);
+        }
+    }
+    /**
+     * What gets recorded as `fragmentChecksum` in the lock file, and what cmdStatus
+     * recomputes from the consumer's tree to detect hand-edits — computed the same
+     * way installFragment actually wrote it, per layout: the exact fragment file
+     * bytes for the folder/sibling-copy case, or the extracted marker-region body for
+     * the flat-file/merge case (NOT the whole fragment source file, since the
+     * installed region deliberately excludes the fragment file's leading doc
+     * comment — see extractFragmentBody).
+     */
+    computeFragmentChecksum(layout) {
+        if (layout.kind === "folder") {
+            return sha256File(this.fragmentSrcPath);
+        }
+        return sha256(this.extractFragmentBody(readFileSync(this.fragmentSrcPath, "utf8")));
+    }
+    // -------------------------------------------------------------------------
     // Subcommands
     // -------------------------------------------------------------------------
     async cmdInit(consumerRoot) {
         const bin = this.fragment.binName;
         const schemaPath = await this.loadConsumerSchemaPath(consumerRoot);
-        const schemaFolder = this.resolveSchemaFolder(schemaPath);
-        const prismaRoot = this.resolvePrismaRoot(schemaFolder);
-        const migrationsDestDir = path.join(prismaRoot, "migrations");
-        console.log(`${bin}: copying ${this.fragment.name}.prisma into ${schemaFolder}`);
-        this.copyFragment(schemaFolder);
+        const layout = this.classifySchemaLayout(schemaPath);
+        const migrationsDestDir = path.join(layout.prismaRoot, "migrations");
+        this.installFragment(layout);
         console.log(`${bin}: running "npx prisma validate" against ${consumerRoot}`);
         this.runPrisma(["validate"], consumerRoot);
         const manifest = this.readManifest();
@@ -236,7 +371,7 @@ class SyncEngine {
         const meta = this.readFragmentMeta();
         this.writeLockFile(consumerRoot, {
             fragmentVersion: meta.fragmentVersion,
-            fragmentChecksum: sha256File(this.fragmentSrcPath),
+            fragmentChecksum: this.computeFragmentChecksum(layout),
             appliedMigrations,
             lastSyncedAt: new Date().toISOString(),
         });
@@ -281,11 +416,9 @@ class SyncEngine {
         const bin = this.fragment.binName;
         const report = this.computePending(consumerRoot);
         const schemaPath = await this.loadConsumerSchemaPath(consumerRoot);
-        const schemaFolder = this.resolveSchemaFolder(schemaPath);
-        const prismaRoot = this.resolvePrismaRoot(schemaFolder);
-        const migrationsDestDir = path.join(prismaRoot, "migrations");
-        console.log(`${bin}: refreshing ${this.fragment.name}.prisma in ${schemaFolder}`);
-        this.copyFragment(schemaFolder);
+        const layout = this.classifySchemaLayout(schemaPath);
+        const migrationsDestDir = path.join(layout.prismaRoot, "migrations");
+        this.installFragment(layout);
         const lock = this.readLockFile(consumerRoot);
         if (!lock) {
             this.fail(`no ${this.lockFileName} found at ${consumerRoot}. Run "${bin} init" first.`);
@@ -308,7 +441,7 @@ class SyncEngine {
         const meta = this.readFragmentMeta();
         this.writeLockFile(consumerRoot, {
             fragmentVersion: meta.fragmentVersion,
-            fragmentChecksum: sha256File(this.fragmentSrcPath),
+            fragmentChecksum: this.computeFragmentChecksum(layout),
             appliedMigrations,
             lastSyncedAt: new Date().toISOString(),
         });
@@ -330,18 +463,36 @@ class SyncEngine {
         }
         try {
             const schemaPath = await this.loadConsumerSchemaPath(consumerRoot);
-            const schemaFolder = this.resolveSchemaFolder(schemaPath);
-            const copiedFragmentPath = path.join(schemaFolder, `${this.fragment.name}.prisma`);
-            if (!existsSync(copiedFragmentPath)) {
-                console.log(`fragment copy:                 MISSING at ${copiedFragmentPath}`);
-                return;
+            const layout = this.classifySchemaLayout(schemaPath);
+            let installedChecksum;
+            let location;
+            if (layout.kind === "folder") {
+                const copiedFragmentPath = path.join(layout.folder, `${this.fragment.name}.prisma`);
+                if (!existsSync(copiedFragmentPath)) {
+                    console.log(`fragment copy:                 MISSING at ${copiedFragmentPath}`);
+                    return;
+                }
+                installedChecksum = sha256File(copiedFragmentPath);
+                location = copiedFragmentPath;
+            }
+            else {
+                if (!existsSync(layout.file)) {
+                    console.log(`fragment copy:                 MISSING — ${layout.file} does not exist`);
+                    return;
+                }
+                const region = this.extractInstalledRegion(readFileSync(layout.file, "utf8"));
+                if (region === null) {
+                    console.log(`fragment copy:                 MISSING — no managed region found in ${layout.file}`);
+                    return;
+                }
+                installedChecksum = sha256(region);
+                location = `${layout.file} (managed region)`;
             }
-            const installedChecksum = sha256File(copiedFragmentPath);
             if (installedChecksum === lock.fragmentChecksum) {
                 console.log("fragment copy:                 unmodified");
             }
             else {
-                console.log(`fragment copy:                 CHECKSUM MISMATCH — ${copiedFragmentPath} has been hand-edited ` +
+                console.log(`fragment copy:                 CHECKSUM MISMATCH — ${location} has been hand-edited ` +
                     `(or is out of sync with the lock file)`);
             }
         }

package/dist/cli/sync-engine.js.map

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

package/dist/flags/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Generic project-scoped feature-flag module (enabled/disabled, percentage
+ * rollout, role targeting, per-user overrides) — DEC-39. Ships a Prisma schema
+ * fragment + a raw SQL migration + a `flags-sync` CLI (all generalized from
+ * @flytedesk/app-kit/trace's and @flytedesk/app-kit/profile's DEC-39 machinery —
+ * see prisma/fragments/flags.prisma and src/cli/flags-sync.ts) plus a real Fastify
+ * plugin with GET/PATCH routes, ported from media-planner's own `flags.ts` so other
+ * flytedesk apps don't each hand-roll their own flag-admin routes + migration for
+ * this. The one genuinely app-specific piece of the original — resolving a flag key
+ * to its label/description/owner/project from media-planner's own hardcoded
+ * `FLAG_ROADMAP` — is generalized into a required `describeFlag` callback.
+ *
+ * Usage:
+ *
+ *   import Fastify from "fastify";
+ *   import { flytedeskAuth } from "@flytedesk/app-kit/auth";
+ *   import { appKitFlags } from "@flytedesk/app-kit/flags";
+ *
+ *   const app = Fastify();
+ *   await app.register(flytedeskAuth, { ...authOptions });
+ *   // Must come after flytedeskAuth (or whatever else decorates request.authUser)
+ *   // — see plugin.ts's registration-time check.
+ *   await app.register(appKitFlags, {
+ *     store: {
+ *       list: () => prisma.appKitFeatureFlag.findMany(),
+ *       findByKey: (key) => prisma.appKitFeatureFlag.findUnique({ where: { key } }),
+ *       upsert: (key, patch) =>
+ *         prisma.appKitFeatureFlag.upsert({
+ *           where: { key },
+ *           create: { key, project: "unknown", ...patch },
+ *           update: patch,
+ *         }),
+ *     },
+ *     describeFlag: (key) => FLAG_ROADMAP.find((f) => f.key === key),
+ *     onChange: async (key, changes, actor) => {
+ *       await recordAudit({ actorId: actor.id, who: actor.name, action: "flag.update", target: key, ...  });
+ *     },
+ *   });
+ *
+ *   // GET   /flags       -> { rows, pager, sort, filter }
+ *   // GET   /flags/:key  -> single flag, or 404
+ *   // PATCH /flags/:key  { enabled?, rollout?, roles?, users? } -> updated flag
+ *
+ * No permission check is baked in — register your own `preHandler` on top of these
+ * routes for whatever RBAC category gates flag administration in your app (same
+ * boundary @flytedesk/app-kit/profile draws).
+ */
+export { appKitFlags } from "./plugin.js";
+export type { AppKitFlagsOptions, FlagFields, FlagListResponseBody, FlagMeta, FlagPager, FlagPatch, FlagResponseBody, FlagRow, FlagStore, } from "./types.js";

package/dist/flags/index.js

@@ -0,0 +1,49 @@
+/**
+ * Generic project-scoped feature-flag module (enabled/disabled, percentage
+ * rollout, role targeting, per-user overrides) — DEC-39. Ships a Prisma schema
+ * fragment + a raw SQL migration + a `flags-sync` CLI (all generalized from
+ * @flytedesk/app-kit/trace's and @flytedesk/app-kit/profile's DEC-39 machinery —
+ * see prisma/fragments/flags.prisma and src/cli/flags-sync.ts) plus a real Fastify
+ * plugin with GET/PATCH routes, ported from media-planner's own `flags.ts` so other
+ * flytedesk apps don't each hand-roll their own flag-admin routes + migration for
+ * this. The one genuinely app-specific piece of the original — resolving a flag key
+ * to its label/description/owner/project from media-planner's own hardcoded
+ * `FLAG_ROADMAP` — is generalized into a required `describeFlag` callback.
+ *
+ * Usage:
+ *
+ *   import Fastify from "fastify";
+ *   import { flytedeskAuth } from "@flytedesk/app-kit/auth";
+ *   import { appKitFlags } from "@flytedesk/app-kit/flags";
+ *
+ *   const app = Fastify();
+ *   await app.register(flytedeskAuth, { ...authOptions });
+ *   // Must come after flytedeskAuth (or whatever else decorates request.authUser)
+ *   // — see plugin.ts's registration-time check.
+ *   await app.register(appKitFlags, {
+ *     store: {
+ *       list: () => prisma.appKitFeatureFlag.findMany(),
+ *       findByKey: (key) => prisma.appKitFeatureFlag.findUnique({ where: { key } }),
+ *       upsert: (key, patch) =>
+ *         prisma.appKitFeatureFlag.upsert({
+ *           where: { key },
+ *           create: { key, project: "unknown", ...patch },
+ *           update: patch,
+ *         }),
+ *     },
+ *     describeFlag: (key) => FLAG_ROADMAP.find((f) => f.key === key),
+ *     onChange: async (key, changes, actor) => {
+ *       await recordAudit({ actorId: actor.id, who: actor.name, action: "flag.update", target: key, ...  });
+ *     },
+ *   });
+ *
+ *   // GET   /flags       -> { rows, pager, sort, filter }
+ *   // GET   /flags/:key  -> single flag, or 404
+ *   // PATCH /flags/:key  { enabled?, rollout?, roles?, users? } -> updated flag
+ *
+ * No permission check is baked in — register your own `preHandler` on top of these
+ * routes for whatever RBAC category gates flag administration in your app (same
+ * boundary @flytedesk/app-kit/profile draws).
+ */
+export { appKitFlags } from "./plugin.js";
+//# sourceMappingURL=index.js.map

package/dist/flags/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/flags/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/flags/plugin.d.ts

@@ -0,0 +1,3 @@
+import type { FastifyPluginAsync } from "fastify";
+import type { AppKitFlagsOptions } from "./types.js";
+export declare const appKitFlags: FastifyPluginAsync<AppKitFlagsOptions>;

package/dist/flags/plugin.js

@@ -0,0 +1,296 @@
+import fp from "fastify-plugin";
+const DEFAULT_ROUTE_PREFIX = "/flags";
+const DEFAULT_PAGE_SIZE = 25;
+const MAX_PAGE_SIZE = 200;
+function assertRequiredOptions(options) {
+    if (!options.store) {
+        throw new Error('@flytedesk/app-kit/flags: missing required option "store"');
+    }
+    if (typeof options.store.list !== "function" ||
+        typeof options.store.findByKey !== "function" ||
+        typeof options.store.upsert !== "function") {
+        throw new Error("@flytedesk/app-kit/flags: options.store must implement list(), findByKey(key), and upsert(key, patch)");
+    }
+    if (typeof options.describeFlag !== "function") {
+        throw new Error('@flytedesk/app-kit/flags: missing required option "describeFlag"');
+    }
+}
+function toFlagResponse(row, meta) {
+    return {
+        key: row.key,
+        project: meta.project,
+        label: meta.label,
+        description: meta.description,
+        enabled: row.enabled,
+        rollout: row.rollout,
+        roles: row.roles,
+        users: row.users,
+        owner: meta.owner,
+        updated: row.updatedAt.toISOString(),
+    };
+}
+/**
+ * Not exported: this plugin's own minimal 401 check on `request.authUser`, kept
+ * local rather than importing ../auth/guards.js's requireAuth — identical contract
+ * and identical implementation to src/profile/plugin.ts's own requireAuthUser (see
+ * that file's doc comment for the full rationale: no hard dependency on the auth
+ * module's internals beyond the `authUser` decoration contract, so any consumer
+ * populating request.authUser some other way still works).
+ */
+function requireAuthUser(request, reply) {
+    if (!request.authUser) {
+        reply
+            .code(401)
+            .send({ error: "Authentication required", code: "unauthenticated" });
+        return false;
+    }
+    return true;
+}
+function coercePositiveInt(value, fallback, max) {
+    const n = typeof value === "string"
+        ? Number(value)
+        : typeof value === "number"
+            ? value
+            : NaN;
+    if (!Number.isFinite(n) || !Number.isInteger(n) || n < 1)
+        return fallback;
+    return max != null ? Math.min(n, max) : n;
+}
+function parseListQuery(query) {
+    return {
+        page: coercePositiveInt(query.page, 1),
+        pageSize: coercePositiveInt(query.pageSize, DEFAULT_PAGE_SIZE, MAX_PAGE_SIZE),
+        sort: typeof query.sort === "string" ? query.sort : undefined,
+        dir: query.dir === "asc" ? "asc" : "desc",
+        q: typeof query.q === "string" ? query.q : "",
+    };
+}
+/** Repeated querystring keys (?project=a&project=b) arrive as arrays already —
+ *  Fastify's querystring parser gives us those natively, same as the reference's
+ *  own asArray relies on. */
+function asArray(value) {
+    if (value == null)
+        return [];
+    if (Array.isArray(value))
+        return value.filter((v) => typeof v === "string");
+    return typeof value === "string" ? [value] : [];
+}
+function buildPager(page, pageSize, total) {
+    const totalPages = Math.max(1, Math.ceil(total / pageSize));
+    const clampedPage = Math.min(Math.max(1, page), totalPages);
+    return {
+        page: clampedPage,
+        pageSize,
+        total,
+        totalPages,
+        from: total === 0 ? 0 : (clampedPage - 1) * pageSize + 1,
+        to: Math.min(total, clampedPage * pageSize),
+        hasPrev: clampedPage > 1,
+        hasNext: clampedPage < totalPages,
+    };
+}
+// ---------------------------------------------------------------------------
+// PATCH body validation — hand-written for the same no-new-dependency reason as
+// the list query parsing above. Same fields/constraints as the reference's zod
+// schema: enabled (boolean), rollout (integer 0-100), roles (string[]), users
+// (object of string -> boolean), all optional.
+// ---------------------------------------------------------------------------
+function parsePatchBody(body) {
+    if (typeof body !== "object" || body === null || Array.isArray(body)) {
+        return { error: "Request body must be a JSON object" };
+    }
+    const input = body;
+    const patch = {};
+    if ("enabled" in input) {
+        if (typeof input.enabled !== "boolean") {
+            return { error: '"enabled" must be a boolean' };
+        }
+        patch.enabled = input.enabled;
+    }
+    if ("rollout" in input) {
+        const rollout = input.rollout;
+        if (typeof rollout !== "number" ||
+            !Number.isInteger(rollout) ||
+            rollout < 0 ||
+            rollout > 100) {
+            return { error: '"rollout" must be an integer between 0 and 100' };
+        }
+        patch.rollout = rollout;
+    }
+    if ("roles" in input) {
+        const roles = input.roles;
+        if (!Array.isArray(roles) || roles.some((r) => typeof r !== "string")) {
+            return { error: '"roles" must be an array of strings' };
+        }
+        patch.roles = roles;
+    }
+    if ("users" in input) {
+        const users = input.users;
+        if (typeof users !== "object" ||
+            users === null ||
+            Array.isArray(users) ||
+            Object.values(users).some((v) => typeof v !== "boolean")) {
+            return {
+                error: '"users" must be an object mapping user ids to booleans',
+            };
+        }
+        patch.users = users;
+    }
+    return patch;
+}
+const appKitFlagsPlugin = async (fastify, options) => {
+    assertRequiredOptions(options);
+    // Same registration-time contract as src/profile/plugin.ts — see that file's
+    // matching check for the full rationale. Register @flytedesk/app-kit/auth (or
+    // your own equivalent) BEFORE this plugin.
+    if (!fastify.hasRequestDecorator("authUser")) {
+        throw new Error("@flytedesk/app-kit/flags: request.authUser is not decorated on this Fastify instance yet. " +
+            "This plugin resolves the caller from request.authUser and must be registered AFTER " +
+            "whatever populates it — @flytedesk/app-kit/auth's flytedeskAuth plugin, or the " +
+            "consuming app's own equivalent decorator.");
+    }
+    const routePrefix = options.routePrefix ?? DEFAULT_ROUTE_PREFIX;
+    const store = options.store;
+    const describeFlag = options.describeFlag;
+    /**
+     * GET {routePrefix} — search/filter/sort/paginate every flag that has metadata
+     * (ported from the reference GET /flags: same q/project/state filters, same
+     * project-then-arbitrary-column sort, same facet counts over the filtered set
+     * before pagination is applied). A flag with no `describeFlag` metadata is
+     * excluded entirely, matching the reference's `.filter((x) => x.meta)`.
+     *
+     * No permission check baked in here — media-planner's own `flags.manage` is its
+     * own RBAC category, entirely the consumer's concern via their own `preHandler`
+     * on this route (same boundary /profile draws around authorization).
+     */
+    fastify.get(routePrefix, async (request, reply) => {
+        if (!requireAuthUser(request, reply))
+            return;
+        const query = request.query;
+        const parsedQuery = parseListQuery(query);
+        const projectFilter = asArray(query.project);
+        const stateFilter = asArray(query.state);
+        const rows = await store.list();
+        let joined = rows
+            .map((row) => ({ row, meta: describeFlag(row.key) }))
+            .filter((x) => x.meta !== undefined);
+        if (parsedQuery.q) {
+            const term = parsedQuery.q.toLowerCase();
+            joined = joined.filter((x) => x.row.key.toLowerCase().includes(term) ||
+                x.meta.label.toLowerCase().includes(term) ||
+                x.meta.description.toLowerCase().includes(term) ||
+                x.meta.owner.toLowerCase().includes(term));
+        }
+        if (projectFilter.length) {
+            joined = joined.filter((x) => projectFilter.includes(x.meta.project));
+        }
+        if (stateFilter.length) {
+            joined = joined.filter((x) => stateFilter.includes(x.row.enabled ? "on" : "off"));
+        }
+        const projectFacets = {};
+        const stateFacets = {};
+        for (const x of joined) {
+            projectFacets[x.meta.project] = (projectFacets[x.meta.project] ?? 0) + 1;
+            const stateKey = x.row.enabled ? "on" : "off";
+            stateFacets[stateKey] = (stateFacets[stateKey] ?? 0) + 1;
+        }
+        const sortKey = parsedQuery.sort ?? "project";
+        joined.sort((a, b) => {
+            const av = sortKey === "project"
+                ? a.meta.project
+                : a.row[sortKey];
+            const bv = sortKey === "project"
+                ? b.meta.project
+                : b.row[sortKey];
+            const cmp = String(av).localeCompare(String(bv));
+            return parsedQuery.dir === "asc" ? cmp : -cmp;
+        });
+        const total = joined.length;
+        const page = Math.min(Math.max(1, parsedQuery.page), Math.max(1, Math.ceil(total / parsedQuery.pageSize)));
+        const paged = joined.slice((page - 1) * parsedQuery.pageSize, page * parsedQuery.pageSize);
+        const body = {
+            rows: paged.map((x) => toFlagResponse(x.row, x.meta)),
+            pager: buildPager(page, parsedQuery.pageSize, total),
+            sort: { key: sortKey, dir: parsedQuery.dir },
+            filter: {
+                applied: { project: projectFilter, state: stateFilter },
+                q: parsedQuery.q,
+                facets: { project: projectFacets, state: stateFacets },
+            },
+        };
+        return body;
+    });
+    /**
+     * GET {routePrefix}/:key — single flag lookup. Not present in the reference
+     * flags.ts, but a natural, trivial addition given FlagStore already exposes
+     * findByKey — completing the CRUD surface the store interface implies, not scope
+     * creep. 404s when the key has no store row OR no describeFlag metadata, so this
+     * agrees with the list endpoint about what counts as "a flag" rather than
+     * exposing a key here that the list silently hides.
+     */
+    fastify.get(`${routePrefix}/:key`, async (request, reply) => {
+        if (!requireAuthUser(request, reply))
+            return;
+        const meta = describeFlag(request.params.key);
+        if (!meta) {
+            return reply.code(404).send({ error: "Not found", code: "not_found" });
+        }
+        const row = await store.findByKey(request.params.key);
+        if (!row) {
+            return reply.code(404).send({ error: "Not found", code: "not_found" });
+        }
+        return toFlagResponse(row, meta);
+    });
+    /**
+     * PATCH {routePrefix}/:key — partial update of enabled/rollout/roles/users
+     * (ported from the reference PATCH /flags/:flagKey: same validation, same
+     * only-write-what-changed semantics). Requires the same describeFlag metadata as
+     * GET/:key (a deliberate generalization beyond the reference, which never
+     * consulted FLAG_ROADMAP for PATCH at all — see FlagMeta's doc comment on why: a
+     * uniform "no metadata means it isn't a flag through this API" contract across
+     * every route is more predictable for a package with multiple consumers than
+     * replicating that one route's inconsistency).
+     *
+     * Always calls `options.onChange` after a successful update, even when the patch
+     * changed nothing — mirrors the reference's own unconditional `recordAudit` call
+     * (whose `detail` falls back to "No change" rather than being skipped).
+     */
+    fastify.patch(`${routePrefix}/:key`, async (request, reply) => {
+        if (!requireAuthUser(request, reply))
+            return;
+        const parsed = parsePatchBody(request.body);
+        if ("error" in parsed) {
+            return reply
+                .code(400)
+                .send({ error: parsed.error, code: "invalid_body" });
+        }
+        const meta = describeFlag(request.params.key);
+        const existing = meta ? await store.findByKey(request.params.key) : null;
+        if (!meta || !existing) {
+            return reply.code(404).send({ error: "Not found", code: "not_found" });
+        }
+        const changes = {};
+        if (parsed.enabled !== undefined && parsed.enabled !== existing.enabled) {
+            changes.enabled = parsed.enabled;
+        }
+        if (parsed.rollout !== undefined && parsed.rollout !== existing.rollout) {
+            changes.rollout = parsed.rollout;
+        }
+        if (parsed.roles !== undefined) {
+            changes.roles = parsed.roles;
+        }
+        if (parsed.users !== undefined) {
+            changes.users = parsed.users;
+        }
+        const updated = await store.upsert(existing.key, changes);
+        await options.onChange?.(existing.key, changes, {
+            id: request.authUser.id,
+            name: request.authUser.name,
+        });
+        return toFlagResponse(updated, meta);
+    });
+};
+export const appKitFlags = fp(appKitFlagsPlugin, {
+    name: "@flytedesk/app-kit/flags",
+});
+//# sourceMappingURL=plugin.js.map

package/dist/flags/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/flags/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAWhC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AACtC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B,SAAS,qBAAqB,CAAC,OAA2B;IACxD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IACD,IACE,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU;QACxC,OAAO,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,UAAU;QAC7C,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,UAAU,EAC1C,CAAC;QACD,MAAM,IAAI,KAAK,CACb,uGAAuG,CACxG,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,GAAY,EAAE,IAAc;IAClD,OAAO;QACL,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE;KACrC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,eAAe,CACtB,OAAuB,EACvB,KAAmB;IAEnB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtB,KAAK;aACF,IAAI,CAAC,GAAG,CAAC;aACT,IAAI,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACvE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAmBD,SAAS,iBAAiB,CACxB,KAAc,EACd,QAAgB,EAChB,GAAY;IAEZ,MAAM,CAAC,GACL,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QACf,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,GAAG,CAAC;IACZ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1E,OAAO,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,cAAc,CAAC,KAA8B;IACpD,OAAO;QACL,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACtC,QAAQ,EAAE,iBAAiB,CACzB,KAAK,CAAC,QAAQ,EACd,iBAAiB,EACjB,aAAa,CACd;QACD,IAAI,EAAE,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAC7D,GAAG,EAAE,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM;QACzC,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;KAC9C,CAAC;AACJ,CAAC;AAED;;6BAE6B;AAC7B,SAAS,OAAO,CAAC,KAAc;IAC7B,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACtB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IACjE,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,QAAgB,EAAE,KAAa;IAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;IAC5D,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,QAAQ;QACR,KAAK;QACL,UAAU;QACV,IAAI,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC;QACxD,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,QAAQ,CAAC;QAC3C,OAAO,EAAE,WAAW,GAAG,CAAC;QACxB,OAAO,EAAE,WAAW,GAAG,UAAU;KAClC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,gFAAgF;AAChF,+EAA+E;AAC/E,8EAA8E;AAC9E,+CAA+C;AAC/C,8EAA8E;AAE9E,SAAS,cAAc,CAAC,IAAa;IACnC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,OAAO,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;IACzD,CAAC;IACD,MAAM,KAAK,GAAG,IAA+B,CAAC;IAC9C,MAAM,KAAK,GAAc,EAAE,CAAC;IAE5B,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACvC,OAAO,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC;QAClD,CAAC;QACD,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAChC,CAAC;IACD,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC9B,IACE,OAAO,OAAO,KAAK,QAAQ;YAC3B,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC;YAC1B,OAAO,GAAG,CAAC;YACX,OAAO,GAAG,GAAG,EACb,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,gDAAgD,EAAE,CAAC;QACrE,CAAC;QACD,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;YACtE,OAAO,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;QAC1D,CAAC;QACD,KAAK,CAAC,KAAK,GAAG,KAAiB,CAAC;IAClC,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1B,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,KAAgC,CAAC,CAAC,IAAI,CAClD,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,SAAS,CAC9B,EACD,CAAC;YACD,OAAO;gBACL,KAAK,EAAE,wDAAwD;aAChE,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,KAAK,GAAG,KAAgC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,iBAAiB,GAA2C,KAAK,EACrE,OAAO,EACP,OAAO,EACP,EAAE;IACF,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE/B,6EAA6E;IAC7E,8EAA8E;IAC9E,2CAA2C;IAC3C,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,4FAA4F;YAC1F,qFAAqF;YACrF,iFAAiF;YACjF,2CAA2C,CAC9C,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,oBAAoB,CAAC;IAChE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAE1C;;;;;;;;;;OAUG;IACH,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAChD,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC;YAAE,OAAO;QAE7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAgC,CAAC;QACvD,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEzC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,MAAM,GAAG,IAAI;aACd,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;aACpD,MAAM,CACL,CAAC,CAAC,EAAyC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CACnE,CAAC;QAEJ,IAAI,WAAW,CAAC,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACzC,MAAM,GAAG,MAAM,CAAC,MAAM,CACpB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACtC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACzC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAC/C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAC5C,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3B,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CACnD,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GAA2B,EAAE,CAAC;QACjD,MAAM,WAAW,GAA2B,EAAE,CAAC;QAC/C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACzE,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;YAC9C,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,IAAI,SAAS,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACnB,MAAM,EAAE,GACN,OAAO,KAAK,SAAS;gBACnB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO;gBAChB,CAAC,CAAE,CAAC,CAAC,GAA0C,CAAC,OAAO,CAAC,CAAC;YAC7D,MAAM,EAAE,GACN,OAAO,KAAK,SAAS;gBACnB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO;gBAChB,CAAC,CAAE,CAAC,CAAC,GAA0C,CAAC,OAAO,CAAC,CAAC;YAC7D,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;YACjD,OAAO,WAAW,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CACnB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,EAC7B,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,CACrD,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CACxB,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,QAAQ,EACjC,IAAI,GAAG,WAAW,CAAC,QAAQ,CAC5B,CAAC;QAEF,MAAM,IAAI,GAAyB;YACjC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YACrD,KAAK,EAAE,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC;YACpD,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE;YAC5C,MAAM,EAAE;gBACN,OAAO,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE;gBACvD,CAAC,EAAE,WAAW,CAAC,CAAC;gBAChB,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE;aACvD;SACF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH;;;;;;;OAOG;IACH,OAAO,CAAC,GAAG,CACT,GAAG,WAAW,OAAO,EACrB,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC;YAAE,OAAO;QAE7C,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CACF,CAAC;IAEF;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,KAAK,CACX,GAAG,WAAW,OAAO,EACrB,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC;YAAE,OAAO;QAE7C,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YACtB,OAAO,KAAK;iBACT,IAAI,CAAC,GAAG,CAAC;iBACT,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACzE,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;YACxE,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QACnC,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;YACxE,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QACnC,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC/B,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC/B,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE1D,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE;YAC9C,EAAE,EAAE,OAAO,CAAC,QAAS,CAAC,EAAE;YACxB,IAAI,EAAE,OAAO,CAAC,QAAS,CAAC,IAAI;SAC7B,CAAC,CAAC;QAEH,OAAO,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC,iBAAiB,EAAE;IAC/C,IAAI,EAAE,0BAA0B;CACjC,CAAC,CAAC"}

package/dist/flags/types.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Hand-written row/option types for @flytedesk/app-kit/flags.
+ *
+ * Field names here mirror prisma/fragments/flags.prisma's camelCase model fields
+ * (key/project/enabled/rollout/roles/users/updatedAt) — a consumer's generated
+ * PrismaClient, once they've run `flags-sync init` and their own `prisma generate`,
+ * satisfies FlagStore directly via `prisma.appKitFeatureFlag.findMany` /
+ * `.findUnique` / `.upsert`.
+ */
+export interface FlagRow {
+    key: string;
+    /** The row's own project column (mirrors media-planner's FeatureFlag.project
+     *  exactly). NOT what list/GET responses display as `project`, or what the
+     *  `project` list filter matches against — see FlagMeta.project below and
+     *  plugin.ts's doc comment on why. */
+    project: string;
+    enabled: boolean;
+    rollout: number;
+    /** Opaque role ids from whatever IdP/RBAC system the consumer uses — this
+     *  package has no opinion on what they mean, same as media-planner's own
+     *  FeatureFlag.roles. */
+    roles: string[];
+    /** Per-user override bag, keyed by whatever user id the consumer uses, each
+     *  value a hard on/off override that supersedes `enabled`/`rollout`/`roles` for
+     *  that one user. Evaluating overrides against a specific caller is the
+     *  consumer's own concern (same boundary media-planner draws) — this plugin only
+     *  ever reads/writes the bag as a whole, never evaluates it. */
+    users: Record<string, boolean>;
+    updatedAt: Date;
+}
+/** The fields a PATCH may write — all optional, only the ones present in the
+ *  request body (and that actually differ from the current row) are written. */
+export type FlagFields = Pick<FlagRow, "enabled" | "rollout" | "roles" | "users">;
+export type FlagPatch = Partial<FlagFields>;
+/**
+ * Flag metadata a consumer resolves from its own source of truth (media-planner's
+ * own reference implementation used a hardcoded `FLAG_ROADMAP` array) — the one
+ * genuinely app-specific piece of the reference `flags.ts` this module generalizes
+ * away via `AppKitFlagsOptions.describeFlag`. `project` here (NOT `FlagRow.project`)
+ * is what every route actually filters/sorts/displays as "the flag's project" —
+ * ported faithfully from the reference, which reads `meta.project` everywhere and
+ * never reads the DB row's own `project` column.
+ */
+export interface FlagMeta {
+    label: string;
+    description: string;
+    owner: string;
+    project: string;
+}
+/**
+ * Minimal persistence seam this plugin needs — deliberately NOT a dependency on
+ * `@prisma/client`, mirroring every other app-kit module's *Store interface (see
+ * src/profile/types.ts's ProfileStore, src/trace/types.ts's TracePrismaClient). A
+ * consumer's generated PrismaClient trivially satisfies this shape:
+ *
+ *   const store: FlagStore = {
+ *     list: () => prisma.appKitFeatureFlag.findMany(),
+ *     findByKey: (key) => prisma.appKitFeatureFlag.findUnique({ where: { key } }),
+ *     upsert: (key, patch) =>
+ *       prisma.appKitFeatureFlag.upsert({
+ *         where: { key },
+ *         create: { key, project: "unknown", ...patch },
+ *         update: patch,
+ *       }),
+ *   };
+ *
+ * A hand-rolled adapter can back it with anything else (raw SQL, a different ORM,
+ * an in-memory store for tests — see src/flags/plugin.test.ts).
+ */
+export interface FlagStore {
+    list(): Promise<FlagRow[]>;
+    /** Must return `null`, not throw/404, when no row exists for `key`. */
+    findByKey(key: string): Promise<FlagRow | null>;
+    /** Upserts the row for `key`, writing only the fields present in `patch` (fields
+     *  absent from `patch` are left unchanged on an existing row). This plugin only
+     *  ever calls this on a key it already confirmed exists via findByKey first (see
+     *  plugin.ts's PATCH handler) — the "upsert" naming matches ProfileStore's for
+     *  interface-shape consistency across app-kit's *Store seams, not because this
+     *  plugin ever creates a flag through it. */
+    upsert(key: string, patch: FlagPatch): Promise<FlagRow>;
+}
+export interface AppKitFlagsOptions {
+    /** The persistence seam — see FlagStore above. Required. */
+    store: FlagStore;
+    /**
+     * Resolves a flag key to its display metadata, or `undefined` if the key isn't
+     * known to the consumer's own catalog (e.g. media-planner's FLAG_ROADMAP). A flag
+     * with no metadata is treated as if it doesn't exist through this API at all —
+     * excluded from GET {routePrefix} (matching the reference's `.filter((x) =>
+     * x.meta)`), and 404s from GET/PATCH {routePrefix}/:key — so every route agrees
+     * on the same set of "real" flags rather than list hiding a key that :key would
+     * still happily serve. Required.
+     */
+    describeFlag: (key: string) => FlagMeta | undefined;
+    /**
+     * Fired after every successful PATCH, whether or not the patch actually changed
+     * anything (mirrors the reference's own unconditional `recordAudit` call, whose
+     * `detail` falls back to "No change" rather than skipping the call) — so a
+     * consumer replicating its own audit trail doesn't have to separately guess
+     * whether "nothing changed" is worth recording. `changes` contains only the
+     * fields that differed from the row's previous value, matching what was actually
+     * written. Not baked into a specific audit/trace mechanism (no dependency on
+     * @flytedesk/app-kit/trace or any other) — the consumer wires this to whatever
+     * they already use, same boundary `/profile` never needed to draw because it had
+     * no audit trail to begin with.
+     */
+    onChange?: (key: string, changes: FlagPatch, actor: {
+        id: string;
+        name: string;
+    }) => void | Promise<void>;
+    /** Base path the GET/PATCH routes are mounted under. Default "/flags". */
+    routePrefix?: string;
+}
+/** What GET `{routePrefix}` returns for one flag, GET `{routePrefix}/:key`, and
+ *  PATCH `{routePrefix}/:key` all share. */
+export interface FlagResponseBody {
+    key: string;
+    project: string;
+    label: string;
+    description: string;
+    enabled: boolean;
+    rollout: number;
+    roles: string[];
+    users: Record<string, boolean>;
+    owner: string;
+    /** ISO 8601. */
+    updated: string;
+}
+export interface FlagPager {
+    page: number;
+    pageSize: number;
+    total: number;
+    totalPages: number;
+    from: number;
+    to: number;
+    hasPrev: boolean;
+    hasNext: boolean;
+}
+/** What GET `{routePrefix}` returns — search/filter/sort/pagination/facets, same
+ *  shape as the reference `GET /flags`. */
+export interface FlagListResponseBody {
+    rows: FlagResponseBody[];
+    pager: FlagPager;
+    sort: {
+        key: string;
+        dir: "asc" | "desc";
+    };
+    filter: {
+        applied: {
+            project: string[];
+            state: string[];
+        };
+        q: string;
+        facets: {
+            project: Record<string, number>;
+            state: Record<string, number>;
+        };
+    };
+}

package/dist/flags/types.js

@@ -0,0 +1,11 @@
+/**
+ * Hand-written row/option types for @flytedesk/app-kit/flags.
+ *
+ * Field names here mirror prisma/fragments/flags.prisma's camelCase model fields
+ * (key/project/enabled/rollout/roles/users/updatedAt) — a consumer's generated
+ * PrismaClient, once they've run `flags-sync init` and their own `prisma generate`,
+ * satisfies FlagStore directly via `prisma.appKitFeatureFlag.findMany` /
+ * `.findUnique` / `.upsert`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/flags/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/flags/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flytedesk/app-kit",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Shared platform kit for flytedesk apps: flytedesk-id auth (BFF/OIDC client) and a Postgres-native trace/audit layer.",
   "type": "module",
   "license": "UNLICENSED",
@@ -29,7 +29,8 @@
   ],
   "bin": {
     "trace-sync": "./dist/cli/trace-sync.js",
-    "profile-sync": "./dist/cli/profile-sync.js"
+    "profile-sync": "./dist/cli/profile-sync.js",
+    "flags-sync": "./dist/cli/flags-sync.js"
   },
   "exports": {
     "./auth": {
@@ -47,6 +48,10 @@
     "./profile": {
       "types": "./dist/profile/index.d.ts",
       "import": "./dist/profile/index.js"
+    },
+    "./flags": {
+      "types": "./dist/flags/index.d.ts",
+      "import": "./dist/flags/index.js"
     }
   },
   "scripts": {

package/prisma/fragments/flags.meta.json

@@ -0,0 +1,4 @@
+{
+  "fragmentVersion": "1.0.0",
+  "minCliVersion": "1.0.0"
+}

package/prisma/fragments/flags.prisma

@@ -0,0 +1,52 @@
+// @flytedesk/app-kit/flags — canonical Prisma model fragment (DEC-39, ported to a
+// third fragment for the feature-flags module).
+//
+// This fragment is NOT built into a Prisma Client by this package. It is installed
+// into the *consumer's* own Prisma schema by `flags-sync init` (see
+// src/cli/flags-sync.ts, a thin wrapper around the generalized
+// src/cli/sync-engine.ts, same as trace-sync/profile-sync), and the consumer
+// generates their own client against their own schema + this fragment merged in.
+//
+// What this models: a generic project-scoped feature flag — enabled/disabled, a
+// percentage rollout, role-based targeting, and a per-user override bag. Ported
+// from media-planner's own `FeatureFlag` model (apps/api/prisma/schema.prisma) and
+// its `GET/PATCH /flags` routes (apps/api/src/routes/flags.ts), generalizing the one
+// genuinely app-specific piece: media-planner resolves flag metadata (label,
+// description, owner, project) from its own hardcoded `FLAG_ROADMAP` — this
+// fragment's row has no such columns at all, and @flytedesk/app-kit/flags's plugin
+// (see src/flags/plugin.ts) instead takes a required `describeFlag` callback so any
+// consumer can supply its own metadata source.
+//
+// Design constraints (deliberate, same reasoning as trace.prisma/profile.prisma):
+//   - No `@relation`/FK attributes anywhere. A package that ships models into a
+//     consumer's schema cannot see the consumer's own models to point a relation at.
+//   - No Prisma `enum`. Nothing here needs one today, but the same schema-global-
+//     collision reasoning applies if one ever would: it stays a plain `String`/`Int`
+//     column instead.
+//   - `String @id` on `key`: a flag's key is already a natural, stable, unique
+//     identifier (matches media-planner's own `FeatureFlag.key String @id`) — no
+//     separate surrogate key earns its keep here.
+//   - `roles String[]` and `users Json`: mirrors media-planner's own columns
+//     exactly (role ids are opaque strings from whatever IdP/RBAC system the
+//     consumer uses — this package has no opinion on what they mean; `users` is a
+//     free-form per-user override bag, `Json` because its shape is consumer-defined).
+//
+// Table name is prefixed `app_kit_` via `@@map` so it can't collide with a
+// consumer's own tables (media-planner's own table is unprefixed `FeatureFlag` —
+// this fragment intentionally does NOT reuse that name, since a consumer migrating
+// onto this fragment keeps their own table and migrates data across on their own
+// schedule, same as `/profile` did for flytedesk-id). Column names are snake_case
+// via `@map`, matching the raw SQL in
+// prisma/migrations/0003_app_kit_flags_init/migration.sql exactly.
+
+model AppKitFeatureFlag {
+  key       String   @id
+  project   String
+  enabled   Boolean  @default(true)
+  rollout   Int      @default(100)
+  roles     String[] @default([])
+  users     Json     @default("{}")
+  updatedAt DateTime @default(now()) @updatedAt @map("updated_at")
+
+  @@map("app_kit_feature_flag")
+}

package/prisma/migrations/0003_app_kit_flags_init/migration.sql

@@ -0,0 +1,16 @@
+-- @flytedesk/app-kit/flags :: 0003_app_kit_flags_init
+--
+-- Hand-written raw SQL (this package does not run `prisma migrate dev` against its
+-- own schema — see DEC-39, and 0001_app_kit_trace_init's migration.sql for the same
+-- note). Column names, types, and defaults match prisma/fragments/flags.prisma
+-- exactly: TEXT for the String @id/String columns, BOOLEAN/INTEGER for their Prisma
+-- counterparts, TEXT[] for String[], JSONB for Json, TIMESTAMPTZ for DateTime.
+CREATE TABLE app_kit_feature_flag (
+  key        TEXT PRIMARY KEY,
+  project    TEXT NOT NULL,
+  enabled    BOOLEAN NOT NULL DEFAULT true,
+  rollout    INTEGER NOT NULL DEFAULT 100,
+  roles      TEXT[] NOT NULL DEFAULT '{}',
+  users      JSONB NOT NULL DEFAULT '{}',
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+);

package/prisma/migrations/manifest.json

@@ -12,5 +12,12 @@
     "file": "0002_app_kit_profile_init/migration.sql",
     "checksum": "sha256:62d688a2db89c77f12c61a3c98be5cfe84a6e06f8a4dda9d24b0f9acd5511b32",
     "introducedInFragmentVersion": "1.0.0"
+  },
+  {
+    "id": "0003_app_kit_flags_init",
+    "fragment": "flags",
+    "file": "0003_app_kit_flags_init/migration.sql",
+    "checksum": "sha256:55a781c3118fdaf7c4aa9405a8867cecfd8c4b9de0a6e14ef90fc364c63f7d39",
+    "introducedInFragmentVersion": "1.0.0"
   }
 ]