@flytedesk/app-kit 0.1.3 → 0.2.0

package/dist/cli/trace-sync.js

@@ -2,372 +2,22 @@
 /**
  * trace-sync — the CLI half of @flytedesk/app-kit/trace (DEC-39).
  *
- * This package never generates its own Prisma Client. Instead this CLI copies
- * prisma/fragments/trace.prisma into the *consumer's* own multi-file Prisma
- * schema folder, applies the raw SQL migration directly against the consumer's
- * configured datasource, and tracks what's been applied in a lock file
- * (`.app-kit-trace.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.
- *
- * Subcommands:
- *   trace-sync init    copy fragment + migration in, run `prisma validate` and
- *                       `prisma db execute`, write the lock file.
- *   trace-sync diff     read-only: compare this package's bundled fragment
- *                       version / migration manifest against the consumer's lock
- *                       file and report what's pending. Never applies anything.
- *   trace-sync apply    apply pending migrations + refresh the fragment copy,
- *                       update the lock file. Does not re-run `prisma validate`
- *                       against a fresh init — use `init` for first install.
- *   trace-sync status   read-only report: fragment version, applied migrations,
- *                       and whether the consumer's copy of the fragment has been
- *                       hand-edited (checksum mismatch).
- *
- * This is a real, runnable CLI — it shells out to the consumer's local `prisma`
- * via `npx` and touches the consumer's real filesystem — not a stub.
- */
-import { createHash } from "node:crypto";
-import spawn from "cross-spawn";
-import { copyFileSync, cpSync, existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
-import path from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
-// ---------------------------------------------------------------------------
-// Package-relative paths
-// ---------------------------------------------------------------------------
-/** Root of the installed @flytedesk/app-kit package (two levels up from
- *  dist/cli/trace-sync.js — this file, once built). */
-const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
-const fragmentSrcPath = path.join(packageRoot, "prisma", "fragments", "trace.prisma");
-const fragmentMetaPath = path.join(packageRoot, "prisma", "fragments", "trace.meta.json");
-const migrationsSrcDir = path.join(packageRoot, "prisma", "migrations");
-const manifestSrcPath = path.join(migrationsSrcDir, "manifest.json");
-const LOCK_FILE_NAME = ".app-kit-trace.lock.json";
-class TraceSyncError extends Error {
-}
-function fail(message) {
-    console.error(`trace-sync: ${message}`);
-    process.exitCode = 1;
-    throw new TraceSyncError(message);
-}
-function readJson(filePath) {
-    return JSON.parse(readFileSync(filePath, "utf8"));
-}
-function sha256(content) {
-    return `sha256:${createHash("sha256").update(content).digest("hex")}`;
-}
-function sha256File(filePath) {
-    return sha256(readFileSync(filePath));
-}
-function readFragmentMeta() {
-    return readJson(fragmentMetaPath);
-}
-function readManifest() {
-    return readJson(manifestSrcPath);
-}
-function lockFilePath(consumerRoot) {
-    return path.join(consumerRoot, LOCK_FILE_NAME);
-}
-function readLockFile(consumerRoot) {
-    const p = lockFilePath(consumerRoot);
-    if (!existsSync(p))
-        return null;
-    return readJson(p);
-}
-function writeLockFile(consumerRoot, lock) {
-    writeFileSync(lockFilePath(consumerRoot), `${JSON.stringify(lock, null, 2)}\n`, "utf8");
-}
-// ---------------------------------------------------------------------------
-// Locating the consumer's Prisma schema folder via their prisma.config.ts
-// ---------------------------------------------------------------------------
-const CONSUMER_CONFIG_CANDIDATES = [
-    "prisma.config.ts",
-    "prisma.config.mts",
-    "prisma.config.js",
-    "prisma.config.mjs",
-];
-function findConsumerConfigFile(consumerRoot) {
-    for (const candidate of CONSUMER_CONFIG_CANDIDATES) {
-        const p = path.join(consumerRoot, candidate);
-        if (existsSync(p))
-            return p;
-    }
-    fail(`could not find a prisma.config.{ts,mts,js,mjs} in ${consumerRoot}. ` +
-        `trace-sync reads this file to find your Prisma schema folder — it does not assume a path.`);
-}
-/**
- * Best-effort read of the consumer's `schema` setting out of their
- * prisma.config.ts default export. Supports the shapes Prisma's config API has
- * used: a bare string path (file or folder), or `{ path: string }`. Relies on
- * Node's native TypeScript type-stripping (unflagged as of the Node 24 baseline
- * this package requires) to import a .ts file directly — if the consumer's
- * config uses syntax that isn't erasable (enums, namespaces, parameter
- * properties, etc.) this import will fail, and that failure is surfaced as-is
- * rather than swallowed.
+ * 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 "trace"
+ * fragment name and the "trace-sync" bin name; profile-sync.ts is the same wrapper
+ * for the profile fragment.
  */
-async function loadConsumerSchemaPath(consumerRoot) {
-    const configFile = findConsumerConfigFile(consumerRoot);
-    let mod;
-    try {
-        mod = await import(pathToFileURL(configFile).href);
-    }
-    catch (err) {
-        fail(`failed to load ${configFile}: ${err.message}\n` +
-            `If this config file uses TypeScript syntax that Node can't type-strip natively ` +
-            `(enums, namespaces, decorators, ...), trace-sync can't import it directly.`);
-    }
-    const config = mod.default ?? mod;
-    const schema = config?.schema;
-    let schemaPath;
-    if (typeof schema === "string") {
-        schemaPath = schema;
-    }
-    else if (schema &&
-        typeof schema === "object" &&
-        typeof schema.path === "string") {
-        schemaPath = schema.path;
-    }
-    if (!schemaPath) {
-        fail(`could not find a "schema" path in ${configFile}'s default export. ` +
-            `Expected \`defineConfig({ schema: "prisma/schema" })\` (or a { path } object).`);
-    }
-    return path.resolve(path.dirname(configFile), schemaPath);
-}
-/** Resolve the folder trace.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"). */
-function resolveSchemaFolder(schemaPath) {
-    if (schemaPath.endsWith(".prisma")) {
-        return path.dirname(schemaPath);
-    }
-    return 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. */
-function resolvePrismaRoot(schemaFolder) {
-    return path.basename(schemaFolder) === "schema"
-        ? path.dirname(schemaFolder)
-        : schemaFolder;
-}
-// ---------------------------------------------------------------------------
-// Shelling out to the consumer's local `prisma`
-// ---------------------------------------------------------------------------
-function runPrisma(args, cwd) {
-    // On Windows, npx resolves to npx.cmd, a shell script — node:child_process's
-    // spawnSync can't exec it directly (EINVAL) without shell:true, and shell:true
-    // 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" });
-    if (result.error) {
-        fail(`failed to run "npx prisma ${args.join(" ")}": ${result.error.message}`);
-    }
-    if (result.status !== 0) {
-        fail(`"npx prisma ${args.join(" ")}" exited with code ${result.status}`);
-    }
-}
-// ---------------------------------------------------------------------------
-// File copying
-// ---------------------------------------------------------------------------
-function copyFragment(schemaFolder) {
-    mkdirSync(schemaFolder, { recursive: true });
-    copyFileSync(fragmentSrcPath, path.join(schemaFolder, "trace.prisma"));
-}
-function copyMigration(migrationId, migrationsDestDir) {
-    const srcDir = path.join(migrationsSrcDir, migrationId);
-    const destDir = path.join(migrationsDestDir, migrationId);
-    mkdirSync(destDir, { recursive: true });
-    cpSync(srcDir, destDir, { recursive: true });
-}
-// ---------------------------------------------------------------------------
-// Subcommands
-// ---------------------------------------------------------------------------
-async function cmdInit(consumerRoot) {
-    const schemaPath = await loadConsumerSchemaPath(consumerRoot);
-    const schemaFolder = resolveSchemaFolder(schemaPath);
-    const prismaRoot = resolvePrismaRoot(schemaFolder);
-    const migrationsDestDir = path.join(prismaRoot, "migrations");
-    console.log(`trace-sync: copying trace.prisma into ${schemaFolder}`);
-    copyFragment(schemaFolder);
-    console.log(`trace-sync: running "npx prisma validate" against ${consumerRoot}`);
-    runPrisma(["validate"], consumerRoot);
-    const manifest = readManifest();
-    const appliedMigrations = [];
-    for (const entry of manifest) {
-        console.log(`trace-sync: copying migration ${entry.id} into ${migrationsDestDir}`);
-        copyMigration(entry.id, migrationsDestDir);
-        const migrationSqlPath = path.join(migrationsDestDir, entry.id, "migration.sql");
-        console.log(`trace-sync: applying ${entry.id} via "npx prisma db execute"`);
-        runPrisma(
-        // Prisma ORM v7's `db execute` no longer accepts `--schema` at all — the
-        // datasource URL comes only from the consumer's prisma.config.ts now (same
-        // "config file, not CLI flags" migration documented on flytedesk-id's own
-        // prisma.config.ts). Passing --schema here is a hard CLI usage error
-        // ("unknown or unexpected option: --schema") against a real Prisma 7 install,
-        // confirmed while building examples/hello-world.
-        ["db", "execute", "--file", migrationSqlPath], consumerRoot);
-        appliedMigrations.push(entry.id);
-    }
-    const meta = readFragmentMeta();
-    writeLockFile(consumerRoot, {
-        fragmentVersion: meta.fragmentVersion,
-        fragmentChecksum: sha256File(fragmentSrcPath),
-        appliedMigrations,
-        lastSyncedAt: new Date().toISOString(),
-    });
-    console.log(`trace-sync: wrote ${lockFilePath(consumerRoot)}`);
-    console.log("trace-sync: init complete.");
-}
-function computePending(consumerRoot) {
-    const lock = readLockFile(consumerRoot);
-    if (!lock) {
-        fail(`no ${LOCK_FILE_NAME} found at ${consumerRoot}. Run "trace-sync init" first.`);
-    }
-    const meta = readFragmentMeta();
-    const manifest = readManifest();
-    const applied = new Set(lock.appliedMigrations);
-    const pendingMigrations = manifest.filter((entry) => !applied.has(entry.id));
-    return {
-        fragmentVersionCurrent: meta.fragmentVersion,
-        fragmentVersionInstalled: lock.fragmentVersion,
-        fragmentVersionChanged: meta.fragmentVersion !== lock.fragmentVersion,
-        pendingMigrations,
-    };
-}
-function cmdDiff(consumerRoot) {
-    const report = computePending(consumerRoot);
-    if (report.fragmentVersionChanged) {
-        console.log(`fragment version: ${report.fragmentVersionInstalled} -> ${report.fragmentVersionCurrent} (changed)`);
-    }
-    else {
-        console.log(`fragment version: ${report.fragmentVersionCurrent} (up to date)`);
-    }
-    if (report.pendingMigrations.length === 0) {
-        console.log("migrations: up to date, nothing pending.");
-        return;
-    }
-    console.log(`migrations: ${report.pendingMigrations.length} pending:`);
-    for (const entry of report.pendingMigrations) {
-        console.log(`  - ${entry.id} (introduced in fragment ${entry.introducedInFragmentVersion})`);
-    }
-    console.log('trace-sync diff is read-only. Run "trace-sync apply" to apply these.');
-}
-async function cmdApply(consumerRoot) {
-    const report = computePending(consumerRoot);
-    const schemaPath = await loadConsumerSchemaPath(consumerRoot);
-    const schemaFolder = resolveSchemaFolder(schemaPath);
-    const prismaRoot = resolvePrismaRoot(schemaFolder);
-    const migrationsDestDir = path.join(prismaRoot, "migrations");
-    console.log(`trace-sync: refreshing trace.prisma in ${schemaFolder}`);
-    copyFragment(schemaFolder);
-    const lock = readLockFile(consumerRoot);
-    if (!lock) {
-        fail(`no ${LOCK_FILE_NAME} found at ${consumerRoot}. Run "trace-sync init" first.`);
-    }
-    const appliedMigrations = [...lock.appliedMigrations];
-    if (report.pendingMigrations.length === 0) {
-        console.log("trace-sync: no pending migrations to apply.");
-    }
-    for (const entry of report.pendingMigrations) {
-        console.log(`trace-sync: copying migration ${entry.id} into ${migrationsDestDir}`);
-        copyMigration(entry.id, migrationsDestDir);
-        const migrationSqlPath = path.join(migrationsDestDir, entry.id, "migration.sql");
-        console.log(`trace-sync: applying ${entry.id} via "npx prisma db execute"`);
-        runPrisma(
-        // Prisma ORM v7's `db execute` no longer accepts `--schema` at all — the
-        // datasource URL comes only from the consumer's prisma.config.ts now (same
-        // "config file, not CLI flags" migration documented on flytedesk-id's own
-        // prisma.config.ts). Passing --schema here is a hard CLI usage error
-        // ("unknown or unexpected option: --schema") against a real Prisma 7 install,
-        // confirmed while building examples/hello-world.
-        ["db", "execute", "--file", migrationSqlPath], consumerRoot);
-        appliedMigrations.push(entry.id);
-    }
-    const meta = readFragmentMeta();
-    writeLockFile(consumerRoot, {
-        fragmentVersion: meta.fragmentVersion,
-        fragmentChecksum: sha256File(fragmentSrcPath),
-        appliedMigrations,
-        lastSyncedAt: new Date().toISOString(),
-    });
-    console.log(`trace-sync: wrote ${lockFilePath(consumerRoot)}`);
-    console.log("trace-sync: apply complete.");
-}
-async function cmdStatus(consumerRoot) {
-    const lock = readLockFile(consumerRoot);
-    if (!lock) {
-        console.log(`no ${LOCK_FILE_NAME} found at ${consumerRoot}. Not yet initialized — run "trace-sync init".`);
-        return;
-    }
-    console.log(`fragment version (installed):  ${lock.fragmentVersion}`);
-    console.log(`fragment version (package):    ${readFragmentMeta().fragmentVersion}`);
-    console.log(`last synced:                   ${lock.lastSyncedAt}`);
-    console.log(`applied migrations (${lock.appliedMigrations.length}):`);
-    for (const id of lock.appliedMigrations) {
-        console.log(`  - ${id}`);
-    }
-    try {
-        const schemaPath = await loadConsumerSchemaPath(consumerRoot);
-        const schemaFolder = resolveSchemaFolder(schemaPath);
-        const copiedFragmentPath = path.join(schemaFolder, "trace.prisma");
-        if (!existsSync(copiedFragmentPath)) {
-            console.log(`fragment copy:                 MISSING at ${copiedFragmentPath}`);
-            return;
-        }
-        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 ` +
-                `(or is out of sync with the lock file)`);
-        }
-    }
-    catch (err) {
-        console.log(`fragment copy:                 could not verify (${err.message})`);
-    }
-}
-// ---------------------------------------------------------------------------
-// Entry point
-// ---------------------------------------------------------------------------
-const SUBCOMMANDS = ["init", "diff", "apply", "status"];
-function isSubcommand(value) {
-    return SUBCOMMANDS.includes(value);
-}
+import { pathToFileURL } from "node:url";
+import { runSyncCli, SyncCliError } from "./sync-engine.js";
 export async function main(argv) {
-    const [subcommand, ...rest] = argv;
-    if (!isSubcommand(subcommand)) {
-        console.error(`usage: trace-sync <${SUBCOMMANDS.join("|")}>`);
-        process.exitCode = 1;
-        return;
-    }
-    // Reserved for a future --cwd override; today trace-sync always operates on
-    // the directory it's invoked from, which is how `npx trace-sync ...` /
-    // an npm script in the consumer's own package.json will run it.
-    void rest;
-    const consumerRoot = process.cwd();
-    switch (subcommand) {
-        case "init":
-            await cmdInit(consumerRoot);
-            break;
-        case "diff":
-            cmdDiff(consumerRoot);
-            break;
-        case "apply":
-            await cmdApply(consumerRoot);
-            break;
-        case "status":
-            await cmdStatus(consumerRoot);
-            break;
-    }
+    return runSyncCli(argv, { name: "trace", binName: "trace-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 TraceSyncError)) {
+        if (!(err instanceof SyncCliError)) {
             console.error(err);
         }
         process.exitCode = process.exitCode ?? 1;

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

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

@@ -0,0 +1,36 @@
+/**
+ * Generic self-service "edit my own profile fields" module (title/phone/timezone/
+ * bio) — DEC-39, DEC-52. Ships a Prisma schema fragment + a raw SQL migration + a
+ * `profile-sync` CLI (all generalized from @flytedesk/app-kit/trace's DEC-39
+ * machinery — see prisma/fragments/profile.prisma and src/cli/profile-sync.ts) plus
+ * a real Fastify plugin with GET/PATCH routes, so flytedesk-id (and other flytedesk
+ * apps after it) don't each hand-roll their own GET/PATCH /me route + migration for
+ * this.
+ *
+ * Usage:
+ *
+ *   import Fastify from "fastify";
+ *   import { flytedeskAuth } from "@flytedesk/app-kit/auth";
+ *   import { appKitProfile } from "@flytedesk/app-kit/profile";
+ *
+ *   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(appKitProfile, {
+ *     store: {
+ *       findByUserId: (userId) => prisma.appKitUserProfile.findUnique({ where: { userId } }),
+ *       upsert: (userId, patch) =>
+ *         prisma.appKitUserProfile.upsert({
+ *           where: { userId },
+ *           create: { userId, ...patch },
+ *           update: patch,
+ *         }),
+ *     },
+ *   });
+ *
+ *   // GET  /profile  -> { userId, title, phone, timezone, bio, updatedAt }
+ *   // PATCH /profile  { title?, phone?, timezone?, bio? } -> same shape
+ */
+export { appKitProfile } from "./plugin.js";
+export type { AppKitProfileOptions, ProfileFields, ProfilePatch, ProfileResponseBody, ProfileRow, ProfileStore, } from "./types.js";

package/dist/profile/index.js

@@ -0,0 +1,36 @@
+/**
+ * Generic self-service "edit my own profile fields" module (title/phone/timezone/
+ * bio) — DEC-39, DEC-52. Ships a Prisma schema fragment + a raw SQL migration + a
+ * `profile-sync` CLI (all generalized from @flytedesk/app-kit/trace's DEC-39
+ * machinery — see prisma/fragments/profile.prisma and src/cli/profile-sync.ts) plus
+ * a real Fastify plugin with GET/PATCH routes, so flytedesk-id (and other flytedesk
+ * apps after it) don't each hand-roll their own GET/PATCH /me route + migration for
+ * this.
+ *
+ * Usage:
+ *
+ *   import Fastify from "fastify";
+ *   import { flytedeskAuth } from "@flytedesk/app-kit/auth";
+ *   import { appKitProfile } from "@flytedesk/app-kit/profile";
+ *
+ *   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(appKitProfile, {
+ *     store: {
+ *       findByUserId: (userId) => prisma.appKitUserProfile.findUnique({ where: { userId } }),
+ *       upsert: (userId, patch) =>
+ *         prisma.appKitUserProfile.upsert({
+ *           where: { userId },
+ *           create: { userId, ...patch },
+ *           update: patch,
+ *         }),
+ *     },
+ *   });
+ *
+ *   // GET  /profile  -> { userId, title, phone, timezone, bio, updatedAt }
+ *   // PATCH /profile  { title?, phone?, timezone?, bio? } -> same shape
+ */
+export { appKitProfile } from "./plugin.js";
+//# sourceMappingURL=index.js.map

package/dist/profile/index.js.map

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

package/dist/profile/plugin.d.ts

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

package/dist/profile/plugin.js

@@ -0,0 +1,111 @@
+import fp from "fastify-plugin";
+const DEFAULT_ROUTE_PREFIX = "/profile";
+const PATCHABLE_FIELDS = ["title", "phone", "timezone", "bio"];
+function assertRequiredOptions(options) {
+    if (!options.store) {
+        throw new Error('@flytedesk/app-kit/profile: missing required option "store"');
+    }
+    if (typeof options.store.findByUserId !== "function" ||
+        typeof options.store.upsert !== "function") {
+        throw new Error('@flytedesk/app-kit/profile: options.store must implement findByUserId(userId) and upsert(userId, patch)');
+    }
+}
+function toResponseBody(userId, row) {
+    if (!row) {
+        return { userId, title: null, phone: null, timezone: null, bio: null, updatedAt: null };
+    }
+    return {
+        userId: row.userId,
+        title: row.title,
+        phone: row.phone,
+        timezone: row.timezone,
+        bio: row.bio,
+        updatedAt: row.updatedAt.toISOString(),
+    };
+}
+/**
+ * Parses/validates a PATCH request body into a ProfilePatch, or returns an error
+ * message. Unknown keys are silently ignored (a permissive PATCH — only the four
+ * known fields are ever read or written); every *known* key present in the body
+ * must be a string, or the whole request is rejected with 400 rather than silently
+ * dropping the bad field.
+ */
+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 = {};
+    for (const field of PATCHABLE_FIELDS) {
+        if (!(field in input))
+            continue;
+        const value = input[field];
+        if (typeof value !== "string") {
+            return { error: `"${field}" must be a string` };
+        }
+        patch[field] = value;
+    }
+    return patch;
+}
+/**
+ * Not exported: this plugin's own minimal 401 check on `request.authUser`, kept
+ * local (rather than importing ../auth/guards.js's requireAuth) so this module has
+ * no hard dependency on the auth module's internals beyond the `authUser`
+ * decoration contract it documents (declare module "fastify" in ../auth/plugin.ts)
+ * — any consumer populating request.authUser some other way (not necessarily via
+ * @flytedesk/app-kit/auth) still works. Mirrors requireAuth's shape in
+ * ../auth/guards.ts: returns whether the request may proceed, and the route
+ * handler reads `request.authUser!` afterward, same as that module's own
+ * requirePermission does.
+ */
+function requireAuthUser(request, reply) {
+    if (!request.authUser) {
+        reply.code(401).send({ error: "Authentication required", code: "unauthenticated" });
+        return false;
+    }
+    return true;
+}
+const appKitProfilePlugin = async (fastify, options) => {
+    assertRequiredOptions(options);
+    // request.authUser is decorated by @flytedesk/app-kit/auth's flytedeskAuth plugin
+    // (see ../auth/plugin.ts's `declare module "fastify"` block) or by whatever the
+    // consuming app uses in its place. Both GET and PATCH below resolve "the current
+    // user" from request.authUser.id, so this plugin is unusable without it — rather
+    // than silently reading `undefined` and letting every request 401 in a confusing
+    // way, fail loudly and immediately at registration time if the decorator was never
+    // installed. This means: register @flytedesk/app-kit/auth (or your own equivalent)
+    // BEFORE this plugin.
+    if (!fastify.hasRequestDecorator("authUser")) {
+        throw new Error('@flytedesk/app-kit/profile: 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;
+    /** GET {routePrefix} — the caller's own profile. Never 404s: a user with no row
+     *  yet still gets a 200 with every field null (see ProfileStore.findByUserId). */
+    fastify.get(routePrefix, async (request, reply) => {
+        if (!requireAuthUser(request, reply))
+            return;
+        const row = await store.findByUserId(request.authUser.id);
+        return toResponseBody(request.authUser.id, row);
+    });
+    /** PATCH {routePrefix} — upserts whatever subset of {title, phone, timezone, bio}
+     *  is present in the body, scoped to the caller's own row (request.authUser.id is
+     *  the only id this handler ever reads or writes — never a caller-supplied one). */
+    fastify.patch(routePrefix, 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 row = await store.upsert(request.authUser.id, parsed);
+        return toResponseBody(request.authUser.id, row);
+    });
+};
+export const appKitProfile = fp(appKitProfilePlugin, {
+    name: "@flytedesk/app-kit/profile",
+});
+//# sourceMappingURL=plugin.js.map

package/dist/profile/plugin.js.map

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