@starklabs/forge 1.3.25-builtin-configs.0 → 2.0.0

package/dist/crud/CrudController.js

@@ -0,0 +1,214 @@
+import { BadRequestError, ErrorCode } from "../errors/index.js";
+import { referenceOf } from "../data/references.js";
+import { isObjectId } from "../utils/ids.js";
+import { CrudSupport } from "./CrudSupport.js";
+const DEFAULT_MAX_BULK = 100;
+const MAX_BATCH_DELETE = 100;
+/** The eight database handlers: read, readAll, create, createBulk, update, remove, removeMultiple, removeAll. */
+export class CrudController {
+    services;
+    support;
+    constructor(services) {
+        this.services = services;
+        this.support = new CrudSupport(services);
+    }
+    read = async (req, res, ctx) => {
+        await this.services.actions.runBefore(ctx.route.actions?.before, ctx.actionContext(req, "read"));
+        const doc = await this.support.load(ctx, req);
+        const item = await this.support.present(ctx, doc);
+        const replaced = await this.services.actions.runAfter(ctx.route.actions?.after, { ...ctx.actionContext(req, "read"), item, result: item });
+        this.services.responses.success(res, { message: `${ctx.modelName} fetched successfully.`, data: replaced ?? item });
+    };
+    readAll = async (req, res, ctx) => {
+        await this.services.actions.runBefore(ctx.route.actions?.before, ctx.actionContext(req, "readAll"));
+        const repo = this.support.repo(ctx);
+        const page = this.services.pagination.parse(req, this.support.sortable(ctx));
+        const filter = this.services.access.scopeFilter(ctx.route, req.user);
+        const [docs, total] = await Promise.all([
+            repo.find(filter, { populate: this.support.populate(ctx), sort: page.sort, skip: page.skip, limit: page.limit }),
+            repo.count(filter),
+        ]);
+        const items = await this.support.presentMany(ctx, docs);
+        const replaced = await this.services.actions.runAfter(ctx.route.actions?.after, { ...ctx.actionContext(req, "readAll"), item: items, result: items });
+        this.services.responses.success(res, {
+            message: `${ctx.modelName} list fetched successfully.`,
+            data: replaced ?? items,
+            meta: this.services.pagination.meta(page, total),
+        });
+    };
+    create = async (req, res, ctx) => {
+        await this.services.actions.runBefore(ctx.route.actions?.before, ctx.actionContext(req, "create"));
+        let body = this.services.access.writableBody(ctx.parseBody(req.body), req.user);
+        const stored = ctx.route.files?.length ? await this.services.uploads.store(req, ctx.route.files) : {};
+        body = { ...body, ...stored };
+        try {
+            const encrypted = await this.services.transformer.encrypt(body, ctx.route.encryptedFields);
+            const hashed = await this.services.transformer.hash(encrypted, ctx.route.hashedFields);
+            const doc = await this.support.repo(ctx).create(this.withOwner(ctx, hashed, req));
+            const item = await this.support.present(ctx, doc);
+            const replaced = await this.services.actions.runAfter(ctx.route.actions?.after, { ...ctx.actionContext(req, "create", { body, files: stored }), item, result: item });
+            this.services.responses.created(res, { message: `${ctx.modelName} created successfully.`, data: replaced ?? item });
+        }
+        catch (error) {
+            await this.discardStored(ctx, stored);
+            throw error;
+        }
+    };
+    createBulk = async (req, res, ctx) => {
+        await this.services.actions.runBefore(ctx.route.actions?.before, ctx.actionContext(req, "createBulk"));
+        if (!Array.isArray(req.body) || req.body.length === 0) {
+            throw new BadRequestError({ message: "Send a non-empty JSON array.", code: ErrorCode.BAD_REQUEST });
+        }
+        const max = ctx.route.config?.maxBulkSize ?? DEFAULT_MAX_BULK;
+        if (req.body.length > max) {
+            throw new BadRequestError({ message: `You can create at most ${max} items at once.`, code: ErrorCode.BAD_REQUEST });
+        }
+        const rows = [];
+        for (const parsed of ctx.parseEach(req.body)) {
+            const writable = this.services.access.writableBody(parsed, req.user);
+            const encrypted = await this.services.transformer.encrypt(writable, ctx.route.encryptedFields);
+            const hashed = await this.services.transformer.hash(encrypted, ctx.route.hashedFields);
+            rows.push(this.withOwner(ctx, hashed, req));
+        }
+        const docs = await this.support.repo(ctx).createMany(rows);
+        const items = await this.support.presentMany(ctx, docs);
+        const replaced = await this.services.actions.runAfter(ctx.route.actions?.after, { ...ctx.actionContext(req, "createBulk"), item: items, result: items });
+        this.services.responses.created(res, { message: `${items.length} ${ctx.modelName} items created successfully.`, data: replaced ?? items });
+    };
+    update = async (req, res, ctx) => {
+        await this.services.actions.runBefore(ctx.route.actions?.before, ctx.actionContext(req, "update"));
+        const existing = await this.support.load(ctx, req);
+        let body = this.services.access.writableBody(ctx.parseBody(req.body), req.user);
+        const stored = ctx.route.files?.length ? await this.services.uploads.store(req, ctx.route.files) : {};
+        body = { ...body, ...stored };
+        try {
+            const encrypted = await this.services.transformer.encrypt(body, ctx.route.encryptedFields);
+            const hashed = await this.services.transformer.hash(encrypted, ctx.route.hashedFields);
+            const updated = await this.support.repo(ctx).updateById(existing._id, hashed);
+            if (!updated)
+                throw this.support.notFound(ctx);
+            // Files that were replaced are no longer referenced: remove them from storage.
+            const replacedFields = new Set(Object.keys(stored));
+            await this.services.uploads.discard(this.support.filesOf(ctx, existing).filter(({ file }) => replacedFields.size > 0 && this.isReplaced(existing, replacedFields, file.storageKey)));
+            const item = await this.support.present(ctx, updated);
+            const replaced = await this.services.actions.runAfter(ctx.route.actions?.after, { ...ctx.actionContext(req, "update", { body, files: stored }), item, result: item });
+            this.services.responses.success(res, { message: `${ctx.modelName} updated successfully.`, data: replaced ?? item });
+        }
+        catch (error) {
+            await this.discardStored(ctx, stored);
+            throw error;
+        }
+    };
+    remove = async (req, res, ctx) => {
+        await this.services.actions.runBefore(ctx.route.actions?.before, ctx.actionContext(req, "remove"));
+        const existing = await this.support.load(ctx, req);
+        const removed = await this.support.repo(ctx).deleteById(existing._id);
+        if (!removed)
+            throw this.support.notFound(ctx);
+        await this.services.uploads.discard(this.support.filesOf(ctx, removed));
+        const item = await this.support.present(ctx, removed);
+        const replaced = await this.services.actions.runAfter(ctx.route.actions?.after, { ...ctx.actionContext(req, "remove"), item, result: item });
+        this.services.responses.success(res, { message: `${ctx.modelName} deleted successfully.`, data: replaced ?? item });
+    };
+    removeMultiple = async (req, res, ctx) => {
+        await this.services.actions.runBefore(ctx.route.actions?.before, ctx.actionContext(req, "removeMultiple"));
+        const field = ctx.route.config?.targetField ?? "ids";
+        const ids = req.body?.[field];
+        if (!Array.isArray(ids) || ids.length === 0 || ids.length > MAX_BATCH_DELETE || !ids.every(isObjectId)) {
+            throw new BadRequestError({
+                message: `'${field}' must be an array of 1-${MAX_BATCH_DELETE} valid ids.`,
+                code: ErrorCode.INVALID_OBJECT_ID,
+            });
+        }
+        const repo = this.support.repo(ctx);
+        const filter = { ...this.services.access.scopeFilter(ctx.route, req.user), _id: { $in: [...new Set(ids)] } };
+        const docs = await this.documentsWithFiles(ctx, filter);
+        const deleted = await repo.deleteMany(filter);
+        await this.services.uploads.discard(docs.flatMap((doc) => this.support.filesOf(ctx, doc)));
+        const replaced = await this.services.actions.runAfter(ctx.route.actions?.after, { ...ctx.actionContext(req, "removeMultiple"), item: { deleted }, result: { deleted } });
+        this.services.responses.success(res, { message: `${deleted} ${ctx.modelName} items deleted.`, data: replaced ?? { deleted } });
+    };
+    removeAll = async (req, res, ctx) => {
+        await this.services.actions.runBefore(ctx.route.actions?.before, ctx.actionContext(req, "removeAll"));
+        const repo = this.support.repo(ctx);
+        const filter = this.services.access.scopeFilter(ctx.route, req.user);
+        const docs = await this.documentsWithFiles(ctx, filter);
+        const deleted = await repo.deleteMany(filter);
+        await this.services.uploads.discard(docs.flatMap((doc) => this.support.filesOf(ctx, doc)));
+        const replaced = await this.services.actions.runAfter(ctx.route.actions?.after, { ...ctx.actionContext(req, "removeAll"), item: { deleted }, result: { deleted } });
+        this.services.responses.success(res, { message: `${deleted} ${ctx.modelName} items deleted.`, data: replaced ?? { deleted } });
+    };
+    /** Startup check: `removeAll` on an open route would let anyone empty the collection. */
+    assertSafeRoute(route) {
+        if (route.handler === "removeAll" && (route.auth === "public" || route.auth === "authenticated")) {
+            return ["'removeAll' must use auth 'admin' or 'admin-or-owner' - otherwise any caller could wipe the whole collection."];
+        }
+        return [];
+    }
+    /**
+     * Startup check for `config.populate` and `config.populateSelect`. A name that is not a reference would only fail on
+     * the first request, as a generic 500 from Mongoose, and a `populateSelect` that lists what to leave out (or nothing)
+     * would return every field of the referenced documents, including fields added to their schema later.
+     */
+    assertPopulate(collection, route) {
+        const { populate, populateSelect } = route.config ?? {};
+        if (populate === undefined || populate === false)
+            return [];
+        const names = typeof populate === "string" ? populate.split(/\s+/).filter(Boolean) : [];
+        if (names.length === 0)
+            return ["'populate' must be the name of a field of the schema (or false)."];
+        const problems = [];
+        const schema = collection.schema ?? {};
+        for (const name of names) {
+            const [head = ""] = name.split(".");
+            if (!(head in schema)) {
+                problems.push(`'populate' names '${name}', which is not a field of the schema.`);
+                continue;
+            }
+            if (name.includes("."))
+                continue; // a path inside a subdocument: Mongoose resolves it
+            const reference = referenceOf(schema[head]);
+            if (!reference) {
+                problems.push(`'populate' names '${name}', which is not a reference. Declare it with a ref, for example { type: "ObjectId", ref: "User" }.`);
+            }
+            else if (typeof reference.ref === "string" && !this.services.data.has(reference.ref)) {
+                problems.push(`'populate' names '${name}', which refers to the model '${reference.ref}'. No collection or sign-in configuration declares a model with that name.`);
+            }
+        }
+        if (populateSelect !== undefined) {
+            const fieldNames = typeof populateSelect === "string" ? populateSelect.split(/\s+/).filter(Boolean) : [];
+            if (fieldNames.length === 0) {
+                problems.push("'populateSelect' must list the fields to return, for example \"_id name\". Empty, it would return every field.");
+            }
+            else if (fieldNames.some((f) => f.startsWith("-") || f.startsWith("+"))) {
+                problems.push("'populateSelect' lists the fields to return. A name that starts with '-' or '+' is not allowed, because leaving fields out would expose every field added later.");
+            }
+        }
+        return problems;
+    }
+    withOwner(ctx, data, req) {
+        // The owner always comes from the session, never from the request body.
+        return ctx.collection.schema && "owner" in ctx.collection.schema
+            ? { ...data, ...this.services.access.ownerStamp(req.user) }
+            : data;
+    }
+    /**
+     * The documents a batch delete is about to remove, loaded only when the collection stores files that must be
+     * removed with them. Without file fields nothing needs the documents, so `removeAll` no longer reads a whole
+     * collection into memory just to delete it.
+     */
+    async documentsWithFiles(ctx, filter) {
+        return this.support.fileFields(ctx).length > 0 ? [...(await this.support.repo(ctx).find(filter))] : [];
+    }
+    async discardStored(ctx, stored) {
+        const providers = new Map((ctx.route.files ?? []).map((f) => [f.schemaField, f.provider]));
+        await this.services.uploads.discard(Object.entries(stored).flatMap(([field, files]) => files.map((file) => ({ file, provider: providers.get(field) }))));
+    }
+    isReplaced(existing, replacedFields, storageKey) {
+        return [...replacedFields].some((field) => {
+            const list = existing[field];
+            return Array.isArray(list) && list.some((f) => f.storageKey === storageKey);
+        });
+    }
+}
+//# sourceMappingURL=CrudController.js.map

package/dist/crud/CrudController.js.map

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

package/dist/crud/CrudModule.d.ts

@@ -0,0 +1,15 @@
+import { FeatureModule, type HandlerFn } from "../core/FeatureModule.js";
+import type { Services } from "../core/Services.js";
+import type { Collection } from "../types/Collection.js";
+import type { Route } from "../types/Route.js";
+/** `type: "crud"` collections: database handlers and file handlers. */
+export declare class CrudModule extends FeatureModule {
+    readonly type = "crud";
+    private readonly crud;
+    private readonly files;
+    constructor(services: Services);
+    protected handlers(): Readonly<Record<string, HandlerFn>>;
+    prepare(collection: Collection): void;
+    protected validateRoute(collection: Collection, route: Route): string[];
+}
+//# sourceMappingURL=CrudModule.d.ts.map

package/dist/crud/CrudModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrudModule.d.ts","sourceRoot":"","sources":["../../src/crud/CrudModule.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C,uEAAuE;AACvE,qBAAa,UAAW,SAAQ,aAAa;IAC3C,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IAEvC,YAAY,QAAQ,EAAE,QAAQ,EAI7B;IAED,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAcxD;IAEQ,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAQ7C;IAED,UAAmB,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAO/E;CACF"}

package/dist/crud/CrudModule.js

@@ -0,0 +1,49 @@
+import { ConfigurationError } from "../errors/index.js";
+import { FeatureModule } from "../core/FeatureModule.js";
+import { CrudController } from "./CrudController.js";
+import { FileController } from "./FileController.js";
+/** `type: "crud"` collections: database handlers and file handlers. */
+export class CrudModule extends FeatureModule {
+    type = "crud";
+    crud;
+    files;
+    constructor(services) {
+        super(services);
+        this.crud = new CrudController(services);
+        this.files = new FileController(services);
+    }
+    handlers() {
+        return {
+            read: this.crud.read,
+            readAll: this.crud.readAll,
+            create: this.crud.create,
+            createBulk: this.crud.createBulk,
+            update: this.crud.update,
+            remove: this.crud.remove,
+            removeMultiple: this.crud.removeMultiple,
+            removeAll: this.crud.removeAll,
+            addFile: this.files.addFile,
+            updateFile: this.files.updateFile,
+            deleteFile: this.files.deleteFile,
+        };
+    }
+    prepare(collection) {
+        if (!collection.model || !collection.schema) {
+            throw new ConfigurationError({
+                message: `The '${collection.route}' crud collection needs both 'model' and 'schema'.`,
+            });
+        }
+        this.services.data.register({ name: collection.model, schema: collection.schema });
+        this.services.sanitizer.addSecrets(this.services.compiler.secretFieldsOf(collection.schema));
+    }
+    validateRoute(collection, route) {
+        const problems = [...this.crud.assertSafeRoute(route), ...this.crud.assertPopulate(collection, route)];
+        if (["updateFile", "deleteFile"].includes(route.handler) && route.files?.length !== 1) {
+            problems.push(`'${route.handler}' needs exactly one entry in 'files'.`);
+        }
+        if (route.handler === "addFile" && !route.files?.length)
+            problems.push("'addFile' needs at least one entry in 'files'.");
+        return problems;
+    }
+}
+//# sourceMappingURL=CrudModule.js.map

package/dist/crud/CrudModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrudModule.js","sourceRoot":"","sources":["../../src/crud/CrudModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAkB,MAAM,0BAA0B,CAAC;AAIzE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,uEAAuE;AACvE,MAAM,OAAO,UAAW,SAAQ,aAAa;IAClC,IAAI,GAAG,MAAM,CAAC;IACN,IAAI,CAAiB;IACrB,KAAK,CAAiB;IAEvC,YAAY,QAAkB;QAC5B,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI,cAAc,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,IAAI,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAES,QAAQ;QAChB,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;YAC1B,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;YACxB,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;YAChC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;YACxB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;YACxB,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc;YACxC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;YAC9B,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;YAC3B,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU;YACjC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU;SAClC,CAAC;IACJ,CAAC;IAEQ,OAAO,CAAC,UAAsB;QACrC,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YAC5C,MAAM,IAAI,kBAAkB,CAAC;gBAC3B,OAAO,EAAE,QAAQ,UAAU,CAAC,KAAK,oDAAoD;aACtF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/F,CAAC;IAEkB,aAAa,CAAC,UAAsB,EAAE,KAAY;QACnE,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QACvG,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;YACtF,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,uCAAuC,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM;YAAE,QAAQ,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QACzH,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/crud/CrudSupport.d.ts

@@ -0,0 +1,44 @@
+import type { Request } from "express";
+import { NotFoundError } from "../errors/index.js";
+import type { Doc, PopulateOption, Repository } from "../data/Repository.js";
+import type { RouteContext } from "../core/RouteContext.js";
+import type { Services } from "../core/Services.js";
+import type { StoredFile } from "../upload/UploadService.js";
+import type { UploadProvider } from "../types/upload.js";
+/** Small helpers shared by the CRUD and file controllers. */
+export declare class CrudSupport {
+    private readonly services;
+    constructor(services: Services);
+    repo(ctx: RouteContext): Repository;
+    /** The `:id` URL parameter, validated as an ObjectId. */
+    id(req: Request): string;
+    populate(ctx: RouteContext): PopulateOption | undefined;
+    /** Loads a document the caller is allowed to see, or throws 404 / 403. */
+    load(ctx: RouteContext, req: Request): Promise<Doc>;
+    notFound(ctx: RouteContext): NotFoundError;
+    /**
+     * Fields hashed by *any* route of the collection. They are write-only: a hash must not be
+     * returned by sibling routes (e.g. a list route) just because they do not declare it.
+     */
+    hashedFields(ctx: RouteContext): string[];
+    /** Decrypts requested fields and removes everything private. */
+    present(ctx: RouteContext, doc: Doc): Promise<Record<string, unknown>>;
+    presentMany(ctx: RouteContext, docs: readonly Doc[]): Promise<Record<string, unknown>[]>;
+    /**
+     * Fields clients may sort by. The order of a list reveals how the values compare, so a client may only
+     * sort by fields it could read anyway: secrets (`select: false`), fields hashed or encrypted by any route of
+     * the collection, and fields this route hides are all excluded.
+     */
+    sortable(ctx: RouteContext): string[];
+    /** Every file field a collection declares across all its routes. */
+    fileFields(ctx: RouteContext): Array<{
+        field: string;
+        provider: UploadProvider | undefined;
+    }>;
+    /** Stored files referenced by a document, ready for cleanup. */
+    filesOf(ctx: RouteContext, doc: Doc): Array<{
+        file: StoredFile;
+        provider: UploadProvider | undefined;
+    }>;
+}
+//# sourceMappingURL=CrudSupport.d.ts.map

package/dist/crud/CrudSupport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrudSupport.d.ts","sourceRoot":"","sources":["../../src/crud/CrudSupport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAkD,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnG,OAAO,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,6DAA6D;AAC7D,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAArC,YAA6B,QAAQ,EAAE,QAAQ,EAAI;IAEnD,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,UAAU,CAOlC;IAED,yDAAyD;IACzD,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAMvB;IAED,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,cAAc,GAAG,SAAS,CAKtD;IAED,0EAA0E;IACpE,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAKxD;IAED,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,aAAa,CAEzC;IAED;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,EAAE,CAExC;IAED,gEAAgE;IAC1D,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAO3E;IAEK,WAAW,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAE7F;IAED;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,EAAE,CASpC;IAED,oEAAoE;IACpE,UAAU,CAAC,GAAG,EAAE,YAAY,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;KAAE,CAAC,CAM5F;IAED,gEAAgE;IAChE,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;KAAE,CAAC,CAQtG;CACF"}

package/dist/crud/CrudSupport.js

@@ -0,0 +1,98 @@
+import { BadRequestError, ConfigurationError, ErrorCode, NotFoundError } from "../errors/index.js";
+import { parseFieldSpec } from "../core/FieldTransformer.js";
+import { isObjectId } from "../utils/ids.js";
+/** Small helpers shared by the CRUD and file controllers. */
+export class CrudSupport {
+    services;
+    constructor(services) {
+        this.services = services;
+    }
+    repo(ctx) {
+        if (!ctx.repository) {
+            throw new ConfigurationError({
+                message: `The '${ctx.collection.route}' collection needs a 'model' and a 'schema'.`,
+            });
+        }
+        return ctx.repository;
+    }
+    /** The `:id` URL parameter, validated as an ObjectId. */
+    id(req) {
+        const id = req.params.id;
+        if (!isObjectId(id)) {
+            throw new BadRequestError({ message: "The id in the URL is not valid.", code: ErrorCode.INVALID_OBJECT_ID });
+        }
+        return id;
+    }
+    populate(ctx) {
+        const path = ctx.route.config?.populate;
+        if (!path)
+            return undefined;
+        // Only ids are returned by default so referenced documents never leak e-mails or other personal data.
+        return { path, select: ctx.route.config?.populateSelect ?? "_id" };
+    }
+    /** Loads a document the caller is allowed to see, or throws 404 / 403. */
+    async load(ctx, req) {
+        const doc = await this.repo(ctx).findById(this.id(req), { populate: this.populate(ctx) });
+        if (!doc)
+            throw this.notFound(ctx);
+        this.services.access.assertCanAccess(ctx.route, req.user, doc);
+        return doc;
+    }
+    notFound(ctx) {
+        return new NotFoundError({ message: `${ctx.modelName} not found.`, code: ErrorCode.RESOURCE_NOT_FOUND });
+    }
+    /**
+     * Fields hashed by *any* route of the collection. They are write-only: a hash must not be
+     * returned by sibling routes (e.g. a list route) just because they do not declare it.
+     */
+    hashedFields(ctx) {
+        return ctx.collection.routes.flatMap((r) => (r.hashedFields ?? []).map((f) => f.replace(/\?$/, "")));
+    }
+    /** Decrypts requested fields and removes everything private. */
+    async present(ctx, doc) {
+        const hiddenFields = [...(ctx.route.config?.hiddenFields ?? []), ...this.hashedFields(ctx)];
+        // A hidden field is never returned, so it is not decrypted either, even when the route lists it in `decryptedFields`.
+        const decryptable = (ctx.route.decryptedFields ?? []).filter((spec) => !hiddenFields.includes(parseFieldSpec(spec).name));
+        const plain = await this.services.transformer.decrypt(doc, decryptable);
+        const clean = this.services.sanitizer.one(doc, { hiddenFields });
+        return { ...clean, ...plain };
+    }
+    async presentMany(ctx, docs) {
+        return Promise.all(docs.map((doc) => this.present(ctx, doc)));
+    }
+    /**
+     * Fields clients may sort by. The order of a list reveals how the values compare, so a client may only
+     * sort by fields it could read anyway: secrets (`select: false`), fields hashed or encrypted by any route of
+     * the collection, and fields this route hides are all excluded.
+     */
+    sortable(ctx) {
+        const bare = (names) => (names ?? []).map((f) => f.replace(/\?$/, ""));
+        const schema = ctx.collection.schema;
+        const blocked = new Set([
+            ...(schema ? this.services.compiler.secretFieldsOf(schema) : []),
+            ...ctx.collection.routes.flatMap((r) => [...bare(r.encryptedFields), ...bare(r.hashedFields)]),
+            ...bare(ctx.route.config?.hiddenFields),
+        ]);
+        return Object.keys(schema ?? {}).filter((f) => !blocked.has(f));
+    }
+    /** Every file field a collection declares across all its routes. */
+    fileFields(ctx) {
+        const seen = new Map();
+        for (const route of ctx.collection.routes) {
+            for (const file of route.files ?? [])
+                seen.set(file.schemaField, file.provider);
+        }
+        return [...seen].map(([field, provider]) => ({ field, provider }));
+    }
+    /** Stored files referenced by a document, ready for cleanup. */
+    filesOf(ctx, doc) {
+        return this.fileFields(ctx).flatMap(({ field, provider }) => {
+            const value = doc[field];
+            const list = Array.isArray(value) ? value : [];
+            return list
+                .filter((f) => typeof f === "object" && f !== null && typeof f.storageKey === "string" && f.storageKey !== "")
+                .map((file) => ({ file, provider }));
+        });
+    }
+}
+//# sourceMappingURL=CrudSupport.js.map

package/dist/crud/CrudSupport.js.map

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

package/dist/crud/FileController.d.ts

@@ -0,0 +1,18 @@
+import type { Request, Response } from "express";
+import type { RouteContext } from "../core/RouteContext.js";
+import type { Services } from "../core/Services.js";
+/** `addFile`, `updateFile` and `deleteFile`: manage the files attached to one document. */
+export declare class FileController {
+    private readonly services;
+    private readonly support;
+    constructor(services: Services);
+    addFile: (req: Request, res: Response, ctx: RouteContext) => Promise<void>;
+    updateFile: (req: Request, res: Response, ctx: RouteContext) => Promise<void>;
+    deleteFile: (req: Request, res: Response, ctx: RouteContext) => Promise<void>;
+    private respond;
+    private uploadsOf;
+    private fileId;
+    private list;
+    private fileNotFound;
+}
+//# sourceMappingURL=FileController.d.ts.map

package/dist/crud/FileController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileController.d.ts","sourceRoot":"","sources":["../../src/crud/FileController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAOpD,2FAA2F;AAC3F,qBAAa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IAEtC,YAA6B,QAAQ,EAAE,QAAQ,EAE9C;IAED,OAAO,QAAe,OAAO,OAAO,QAAQ,OAAO,YAAY,KAAG,OAAO,CAAC,IAAI,CAAC,CA6B7E;IAEF,UAAU,QAAe,OAAO,OAAO,QAAQ,OAAO,YAAY,KAAG,OAAO,CAAC,IAAI,CAAC,CAyBhF;IAEF,UAAU,QAAe,OAAO,OAAO,QAAQ,OAAO,YAAY,KAAG,OAAO,CAAC,IAAI,CAAC,CAiBhF;YAEY,OAAO;IAiBrB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,YAAY;CAGrB"}

package/dist/crud/FileController.js

@@ -0,0 +1,118 @@
+import { BadRequestError, ConflictError, ErrorCode, NotFoundError } from "../errors/index.js";
+import { idToString, isObjectId } from "../utils/ids.js";
+import { CrudSupport } from "./CrudSupport.js";
+/** `addFile`, `updateFile` and `deleteFile`: manage the files attached to one document. */
+export class FileController {
+    services;
+    support;
+    constructor(services) {
+        this.services = services;
+        this.support = new CrudSupport(services);
+    }
+    addFile = async (req, res, ctx) => {
+        await this.services.actions.runBefore(ctx.route.actions?.before, ctx.actionContext(req, "addFile"));
+        const uploads = this.uploadsOf(ctx);
+        const doc = await this.support.load(ctx, req);
+        const stored = await this.services.uploads.store(req, uploads, { requireAll: true });
+        try {
+            const changes = {};
+            for (const upload of uploads) {
+                const current = this.list(doc[upload.schemaField]);
+                const added = stored[upload.schemaField] ?? [];
+                const limit = upload.multiple ? this.services.config.upload.maxFiles : 1;
+                if (current.length + added.length > limit) {
+                    throw new ConflictError({
+                        message: upload.multiple
+                            ? `'${upload.schemaField}' can hold at most ${limit} files.`
+                            : `'${upload.schemaField}' already has a file.`,
+                        hint: upload.multiple ? "Delete a file first." : "Use the updateFile route to replace it.",
+                    });
+                }
+                changes[upload.schemaField] = [...current, ...added];
+            }
+            const updated = await this.support.repo(ctx).updateById(doc._id, changes);
+            if (!updated)
+                throw this.support.notFound(ctx);
+            await this.respond(req, res, ctx, "addFile", updated, "File added successfully.", stored);
+        }
+        catch (error) {
+            await this.services.uploads.discard(this.services.uploads.flatten(stored).map((file) => ({ file, provider: uploads[0]?.provider })));
+            throw error;
+        }
+    };
+    updateFile = async (req, res, ctx) => {
+        await this.services.actions.runBefore(ctx.route.actions?.before, ctx.actionContext(req, "updateFile"));
+        const [upload] = this.uploadsOf(ctx, 1);
+        const fileId = this.fileId(req, upload);
+        const doc = await this.support.load(ctx, req);
+        const current = this.list(doc[upload.schemaField]);
+        const index = current.findIndex((f) => idToString(f._id) === fileId);
+        if (index === -1)
+            throw this.fileNotFound(upload);
+        const stored = await this.services.uploads.store(req, [upload], { requireAll: true });
+        const replacement = stored[upload.schemaField]?.[0];
+        try {
+            const next = [...current];
+            next[index] = replacement;
+            const updated = await this.support.repo(ctx).updateById(doc._id, { [upload.schemaField]: next });
+            if (!updated)
+                throw this.support.notFound(ctx);
+            const old = current[index];
+            if (old?.storageKey)
+                await this.services.uploads.discard([{ file: old, provider: upload.provider }]);
+            await this.respond(req, res, ctx, "updateFile", updated, "File updated successfully.", stored);
+        }
+        catch (error) {
+            await this.services.uploads.discard(this.services.uploads.flatten(stored).map((file) => ({ file, provider: upload.provider })));
+            throw error;
+        }
+    };
+    deleteFile = async (req, res, ctx) => {
+        await this.services.actions.runBefore(ctx.route.actions?.before, ctx.actionContext(req, "deleteFile"));
+        const [upload] = this.uploadsOf(ctx, 1);
+        const fileId = this.fileId(req, upload);
+        const doc = await this.support.load(ctx, req);
+        const current = this.list(doc[upload.schemaField]);
+        const target = current.find((f) => idToString(f._id) === fileId);
+        if (!target)
+            throw this.fileNotFound(upload);
+        const updated = await this.support.repo(ctx).updateById(doc._id, {
+            [upload.schemaField]: current.filter((f) => f !== target),
+        });
+        if (!updated)
+            throw this.support.notFound(ctx);
+        if (target.storageKey)
+            await this.services.uploads.discard([{ file: target, provider: upload.provider }]);
+        await this.respond(req, res, ctx, "deleteFile", updated, "File deleted successfully.");
+    };
+    async respond(req, res, ctx, operation, doc, message, stored = {}) {
+        const item = await this.support.present(ctx, doc);
+        const replaced = await this.services.actions.runAfter(ctx.route.actions?.after, { ...ctx.actionContext(req, operation, { files: stored }), item, result: item });
+        this.services.responses.success(res, { message, data: replaced ?? item });
+    }
+    uploadsOf(ctx, exactly) {
+        const uploads = ctx.route.files ?? [];
+        if (uploads.length === 0 || (exactly !== undefined && uploads.length !== exactly)) {
+            throw new BadRequestError({
+                message: `${ctx.label} needs ${exactly === 1 ? "exactly one" : "at least one"} entry in 'files'.`,
+                code: ErrorCode.CONFIGURATION_ERROR,
+            });
+        }
+        return uploads;
+    }
+    fileId(req, upload) {
+        const key = upload.validationKey ?? "fileId";
+        const value = req.body?.[key];
+        if (!isObjectId(value)) {
+            throw new BadRequestError({ message: `'${key}' must be the id of a stored file.`, code: ErrorCode.INVALID_OBJECT_ID });
+        }
+        return value;
+    }
+    list(value) {
+        return Array.isArray(value) ? value : [];
+    }
+    fileNotFound(upload) {
+        return new NotFoundError({ message: `No such file in '${upload.schemaField}'.`, code: ErrorCode.FILE_NOT_FOUND });
+    }
+}
+//# sourceMappingURL=FileController.js.map