@edium/halifax 1.0.0

package/dist/core/crudRouter.js

@@ -0,0 +1,391 @@
+import { AllowAllAuthStrategy } from '../auth/AuthStrategy.js';
+import { QueryBuilder } from '../classes/QueryBuilder.js';
+import { BadRequestError } from '../errors/BadRequestError.js';
+import { HttpError } from '../errors/HttpError.js';
+import { MethodNotAllowedError } from '../errors/MethodNotAllowedError.js';
+import { NotAcceptableError } from '../errors/NotAcceptableError.js';
+import { NotFoundError } from '../errors/NotFoundError.js';
+import { NotImplementedError } from '../errors/NotImplementedError.js';
+import { UnprocessableEntityError } from '../errors/UnprocessableEntityError.js';
+import { UnsupportedMediaTypeError } from '../errors/UnsupportedMediaTypeError.js';
+import { defaultCrudPermissions } from '../core/types.js';
+import { parseListOptions } from '../core/queryString.js';
+import { validateAdvancedQuery, validateId, isValidUuid } from '../core/validation.js';
+import { ServerError } from '../errors/ServerError.js';
+import { AuthorizationError } from '../errors/AuthorizationError.js';
+/**
+ * Parses and validates a raw `:id` route parameter.
+ * @param raw - The raw string value from `req.params.id`.
+ * @returns A parsed integer for numeric IDs, or the original string for UUIDs.
+ * @throws {@link BadRequestError} when the value is not a valid integer or UUID.
+ */
+function parseId(raw) {
+    validateId(raw);
+    if (typeof raw === 'string' && isValidUuid(raw))
+        return raw;
+    return typeof raw === 'string' ? parseInt(raw, 10) : raw;
+}
+/**
+ * Strips non-writable fields from a request body and rejects unknown fields with a 422.
+ * Only fields explicitly marked `writable: true` are allowed through; fields with
+ * `writable: false` or `writable` unset are silently dropped.
+ * @param resource - The resource definition that defines writable fields.
+ * @param data - The raw request body key-value map.
+ * @returns A new object containing only explicitly writable fields.
+ * @throws {@link UnprocessableEntityError} when the body contains keys not defined on the resource.
+ */
+function filterWritableFields(resource, data) {
+    const knownFields = new Set(resource.fields.map((f) => f.name));
+    const unknownFields = Object.keys(data).filter((key) => !knownFields.has(key));
+    if (unknownFields.length) {
+        throw new UnprocessableEntityError(`Unknown field(s): ${unknownFields.join(', ')}.`);
+    }
+    return Object.fromEntries(Object.entries(data).filter(([key]) => {
+        const field = resource.fields.find((f) => f.name === key);
+        return field?.writable === true;
+    }));
+}
+/** Maps HTTP status codes to machine-readable error code strings. */
+const statusCodeMap = {
+    400: 'BAD_REQUEST',
+    401: 'UNAUTHORIZED',
+    403: 'FORBIDDEN',
+    404: 'NOT_FOUND',
+    405: 'METHOD_NOT_ALLOWED',
+    406: 'NOT_ACCEPTABLE',
+    415: 'UNSUPPORTED_MEDIA_TYPE',
+    422: 'UNPROCESSABLE_ENTITY',
+    501: 'NOT_IMPLEMENTED'
+};
+/**
+ * Converts any thrown value to a structured `{ status, code, message, details }` object.
+ * {@link HttpError} subclasses preserve their status; all other errors become 500.
+ * @param error - The caught value to normalise (may be any type).
+ * @returns A plain object with `status`, `code`, `message`, and optional `details`.
+ */
+export function normalizeError(error) {
+    if (error instanceof HttpError) {
+        return {
+            status: error.status,
+            code: statusCodeMap[error.status] ?? 'INTERNAL_ERROR',
+            message: error.message,
+            details: error.details
+        };
+    }
+    if (error instanceof Error) {
+        return { status: 500, code: 'INTERNAL_ERROR', message: 'Internal server error' };
+    }
+    return { status: 500, code: 'INTERNAL_ERROR', message: 'Internal server error' };
+}
+/**
+ * Validates that all identifier-shaped values in a preview query are safe SQL identifiers.
+ * Field names and the table name are interpolated directly into SQL strings (not parameterized),
+ * so they must match `[a-zA-Z_][a-zA-Z0-9_.]*` to prevent unexpected SQL fragments.
+ * @param query - The query AST to inspect.
+ * @throws {@link BadRequestError} when any identifier contains disallowed characters.
+ */
+function assertSafePreviewIdentifiers(query) {
+    const safe = /^[a-zA-Z_][a-zA-Z0-9_.]*$/;
+    const check = (value, label) => {
+        if (!safe.test(value))
+            throw new BadRequestError(`Invalid ${label}: '${value}'.`);
+    };
+    if (query.tableName)
+        check(query.tableName, 'table name');
+    for (const f of query.fields ?? [])
+        check(f, 'field name');
+    for (const s of query.orderBy ?? [])
+        check(s.field, 'sort field');
+    const checkFilters = (filters) => {
+        for (const f of filters) {
+            if (f.field)
+                check(f.field, 'filter field');
+            if (f.children?.length)
+                checkFilters(f.children);
+        }
+    };
+    checkFilters(query.where ?? []);
+}
+/**
+ * Serialises a caught error and writes it as a JSON `{ errors: [...] }` response.
+ * @param error - The caught value to serialise.
+ * @param res - The response object to write to.
+ */
+async function sendError(error, res) {
+    const { status, code, message, details } = normalizeError(error);
+    const item = { code, message };
+    if (details !== undefined)
+        item['details'] = details;
+    await res.status(status).json({ errors: [item] });
+}
+/**
+ * Runs the auth strategy for `action` and throws {@link AuthorizationError} when not allowed.
+ * @param req - The incoming HTTP request.
+ * @param resource - The resource being accessed (used to look up required permissions).
+ * @param action - The CRUD action being performed.
+ * @param authStrategy - The active auth strategy.
+ */
+async function authorizeRequest(req, resource, action, authStrategy) {
+    const auth = await authStrategy.authenticate(req);
+    const requiredPermissions = resource.requiredPermissions?.[action] ?? [];
+    if (authStrategy.authorize) {
+        const allowed = await authStrategy.authorize({
+            auth,
+            action,
+            resource,
+            requiredPermissions,
+            req
+        });
+        if (!allowed)
+            throw new AuthorizationError();
+        return;
+    }
+    if (requiredPermissions.length) {
+        const permissions = new Set(auth.permissions ?? []);
+        const roles = new Set(auth.roles ?? []);
+        const allowed = requiredPermissions.every((permission) => permissions.has(permission) || roles.has(permission));
+        if (!allowed)
+            throw new AuthorizationError();
+    }
+}
+/**
+ * Reads a single header value by name (case-insensitive).
+ * @param req - The incoming HTTP request.
+ * @param name - Header name to look up (case-insensitive).
+ * @returns The header value as a string, or `undefined` when absent.
+ */
+function getHeaderValue(req, name) {
+    const raw = req.headers[name.toLowerCase()] ?? req.headers[name];
+    const value = Array.isArray(raw) ? raw[0] : raw;
+    return typeof value === 'string' ? value : undefined;
+}
+/**
+ * Throws {@link UnsupportedMediaTypeError} when a body-carrying request uses a non-JSON Content-Type.
+ * @param req - The incoming HTTP request to check.
+ */
+function checkContentType(req) {
+    if (!['POST', 'PATCH', 'PUT', 'DELETE'].includes(req.method.toUpperCase()))
+        return;
+    const contentType = getHeaderValue(req, 'content-type') ?? '';
+    if (contentType && !contentType.includes('application/json')) {
+        throw new UnsupportedMediaTypeError();
+    }
+}
+/**
+ * Throws {@link NotAcceptableError} when the client's Accept header excludes `application/json`.
+ * @param req - The incoming HTTP request to check.
+ */
+function checkAcceptHeader(req) {
+    const accept = getHeaderValue(req, 'accept') ?? '';
+    if (accept &&
+        !accept.includes('*/*') &&
+        !accept.includes('application/*') &&
+        !accept.includes('application/json')) {
+        throw new NotAcceptableError();
+    }
+}
+/**
+ * Wraps a route handler with Content-Type / Accept checks, error serialisation,
+ * and `X-Correlation-ID` echo-back.
+ * @param handler - The inner async route handler to wrap.
+ * @returns A new handler with pre/post-processing applied.
+ */
+function wrap(handler) {
+    return async (req, res) => {
+        const correlationId = getHeaderValue(req, 'x-correlation-id');
+        if (correlationId)
+            res.setHeader?.('X-Correlation-ID', correlationId);
+        try {
+            checkContentType(req);
+            checkAcceptHeader(req);
+            await handler(req, res);
+        }
+        catch (error) {
+            await sendError(error, res);
+        }
+    };
+}
+/**
+ * Registers all CRUD routes for every resource on the given HTTP server.
+ *
+ * Routes are controlled by `resource.permissions` merged with {@link defaultCrudPermissions}.
+ * A global query-builder preview endpoint is also registered at `previewQueryBuilderPath`.
+ *
+ * @param server - The HTTP server adapter to register routes on (e.g. {@link ExpressHttpServer}).
+ * @param resources - Resource definitions to wire up as CRUD endpoints.
+ * @param options - Auth strategy, query-builder path overrides, and preview path overrides.
+ */
+export function registerCrudApi(server, resources, options = {}) {
+    const authStrategy = options.authStrategy ?? new AllowAllAuthStrategy();
+    const queryBuilderPath = options.queryBuilderPath ?? 'query-builder';
+    const previewPath = options.previewQueryBuilderPath ?? '/query-builder/preview';
+    resources.forEach((resource) => {
+        const repository = resource.repository;
+        if (!repository)
+            throw new ServerError(`Resource '${resource.name}' does not define a repository.`);
+        const permissions = { ...defaultCrudPermissions, ...resource.permissions };
+        const basePath = `/${resource.routePrefix}`;
+        if (permissions.allowCreate) {
+            server.registerRoute('POST', basePath, wrap(async (req, res) => {
+                await authorizeRequest(req, resource, 'create', authStrategy);
+                const idempotencyKey = getHeaderValue(req, 'idempotency-key');
+                const createOptions = idempotencyKey ? { idempotencyKey } : undefined;
+                const items = (Array.isArray(req.body) ? req.body : [req.body]).map((item) => filterWritableFields(resource, item));
+                if (items.length === 1) {
+                    const result = await repository.createOne(items[0], createOptions);
+                    await res.status(201).json(result);
+                    return;
+                }
+                const results = await repository.createMany(items, createOptions);
+                await res.status(201).json(results);
+            }));
+        }
+        if (permissions.allowReadMany) {
+            server.registerRoute('GET', basePath, wrap(async (req, res) => {
+                await authorizeRequest(req, resource, 'readMany', authStrategy);
+                const listOptions = parseListOptions(req.query, resource);
+                const results = await repository.getMany(listOptions);
+                await res.status(200).json(results);
+            }));
+        }
+        if (permissions.allowReadManyWithQueryBuilder) {
+            server.registerRoute('POST', `${basePath}/${queryBuilderPath}`, wrap(async (req, res) => {
+                await authorizeRequest(req, resource, 'readManyWithQueryBuilder', authStrategy);
+                if (!repository.executeQueryBuilder)
+                    throw new NotImplementedError('This resource does not support the query builder.');
+                const body = (req.body ?? {});
+                const query = {
+                    ...body,
+                    tableName: resource.tableName
+                };
+                validateAdvancedQuery(resource, query);
+                const results = await repository.executeQueryBuilder(query);
+                await res.status(200).json(results);
+            }));
+        }
+        if (permissions.allowReadOne) {
+            server.registerRoute('GET', `${basePath}/:id`, wrap(async (req, res) => {
+                await authorizeRequest(req, resource, 'readOne', authStrategy);
+                const id = parseId(req.params['id']);
+                const listOptions = parseListOptions(req.query, resource);
+                const result = await repository.getOne(id, {
+                    fields: listOptions.fields,
+                    include: listOptions.include
+                });
+                if (!result)
+                    throw new NotFoundError();
+                await res.status(200).json(result);
+            }));
+        }
+        if (permissions.allowUpdateOne) {
+            server.registerRoute('PATCH', `${basePath}/:id`, wrap(async (req, res) => {
+                await authorizeRequest(req, resource, 'updateOne', authStrategy);
+                const id = parseId(req.params['id']);
+                const body = filterWritableFields(resource, req.body);
+                const result = await repository.updateOne(id, body);
+                if (!result)
+                    throw new NotFoundError();
+                await res.status(200).json(result);
+            }));
+        }
+        if (permissions.allowUpdateMany) {
+            server.registerRoute('PATCH', basePath, wrap(async (req, res) => {
+                await authorizeRequest(req, resource, 'updateMany', authStrategy);
+                if (!repository.updateMany)
+                    throw new NotImplementedError('This resource does not support updateMany.');
+                const { update, ...queryBody } = (req.body ?? {});
+                const filteredUpdate = filterWritableFields(resource, (update ?? {}));
+                if (!Object.keys(filteredUpdate).length)
+                    throw new UnprocessableEntityError('updateMany requires at least one writable field in the update payload.');
+                const query = {
+                    ...queryBody,
+                    tableName: resource.tableName
+                };
+                validateAdvancedQuery(resource, query);
+                if (!query.where?.length)
+                    throw new UnprocessableEntityError('updateMany requires at least one WHERE filter to prevent unintended bulk updates.');
+                const result = await repository.updateMany(query, filteredUpdate);
+                await res.status(200).json(result);
+            }));
+        }
+        if (permissions.allowUpsertOne) {
+            server.registerRoute('PUT', `${basePath}/:id`, wrap(async (req, res) => {
+                await authorizeRequest(req, resource, 'upsertOne', authStrategy);
+                if (!repository.upsertOne)
+                    throw new NotImplementedError('This resource does not support upsert.');
+                const id = parseId(req.params['id']);
+                const body = filterWritableFields(resource, req.body);
+                const result = await repository.upsertOne(id, body);
+                await res.status(200).json(result);
+            }));
+        }
+        if (permissions.allowDeleteOne) {
+            server.registerRoute('DELETE', `${basePath}/:id`, wrap(async (req, res) => {
+                await authorizeRequest(req, resource, 'deleteOne', authStrategy);
+                const id = parseId(req.params['id']);
+                const deleted = await repository.deleteOne(id);
+                if (!deleted)
+                    throw new NotFoundError();
+                await res.status(200).json({ deleted: true });
+            }));
+        }
+        if (permissions.allowDeleteMany) {
+            server.registerRoute('DELETE', basePath, wrap(async (req, res) => {
+                await authorizeRequest(req, resource, 'deleteMany', authStrategy);
+                if (!repository.deleteMany)
+                    throw new NotImplementedError('This resource does not support deleteMany.');
+                const body = (req.body ?? {});
+                const query = {
+                    ...body,
+                    tableName: resource.tableName
+                };
+                validateAdvancedQuery(resource, query);
+                if (!query.where?.length)
+                    throw new UnprocessableEntityError('deleteMany requires at least one WHERE filter to prevent unintended bulk deletes.');
+                const result = await repository.deleteMany(query);
+                await res.status(200).json(result);
+            }));
+        }
+        // 405 fallbacks — only registered when at least one method exists for the path
+        const baseMethods = [
+            ...(permissions.allowReadMany ? ['GET'] : []),
+            ...(permissions.allowCreate ? ['POST'] : []),
+            ...(permissions.allowUpdateMany ? ['PATCH'] : []),
+            ...(permissions.allowDeleteMany ? ['DELETE'] : [])
+        ];
+        if (baseMethods.length) {
+            server.registerRoute('*', basePath, async (req, res) => {
+                res.setHeader?.('Allow', baseMethods.join(', '));
+                await sendError(new MethodNotAllowedError(), res);
+            });
+        }
+        const idMethods = [
+            ...(permissions.allowReadOne ? ['GET'] : []),
+            ...(permissions.allowUpdateOne ? ['PATCH'] : []),
+            ...(permissions.allowUpsertOne ? ['PUT'] : []),
+            ...(permissions.allowDeleteOne ? ['DELETE'] : [])
+        ];
+        if (idMethods.length) {
+            server.registerRoute('*', `${basePath}/:id`, async (req, res) => {
+                res.setHeader?.('Allow', idMethods.join(', '));
+                await sendError(new MethodNotAllowedError(), res);
+            });
+        }
+        if (permissions.allowReadManyWithQueryBuilder) {
+            server.registerRoute('*', `${basePath}/${queryBuilderPath}`, async (req, res) => {
+                res.setHeader?.('Allow', 'POST');
+                await sendError(new MethodNotAllowedError(), res);
+            });
+        }
+    });
+    server.registerRoute('POST', previewPath, wrap(async (req, res) => {
+        await authStrategy.authenticate(req);
+        const query = req.body;
+        assertSafePreviewIdentifiers(query);
+        await res.status(200).json({
+            count: QueryBuilder.buildCountQuery(query),
+            select: QueryBuilder.buildSelectQuery(query)
+        });
+    }));
+}
+//# sourceMappingURL=crudRouter.js.map

package/dist/core/crudRouter.js.map

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

package/dist/core/queryString.d.ts

@@ -0,0 +1,13 @@
+import type { ListOptions, ResourceDefinition } from '../core/types.js';
+/**
+ * Parses and validates the raw query-string from a GET request into typed {@link ListOptions}.
+ *
+ * Validates field names, sort fields, includes, and filter keys against the resource schema.
+ * Applies `defaultLimit` and `maxLimit` from the resource definition when set.
+ *
+ * @param query - The raw query-string object from the HTTP request.
+ * @param resource - The resource definition used for field and relation validation.
+ * @returns Typed list options ready to pass to `repository.getMany()`.
+ */
+export declare function parseListOptions(query: Record<string, unknown>, resource: ResourceDefinition): ListOptions;
+//# sourceMappingURL=queryString.d.ts.map

package/dist/core/queryString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryString.d.ts","sourceRoot":"","sources":["../../src/core/queryString.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAwCtE;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,EAAE,kBAAkB,GAC3B,WAAW,CAkDb"}

package/dist/core/queryString.js

@@ -0,0 +1,89 @@
+import { SqlOrder } from '../enums/SqlOrder.js';
+import { UnprocessableEntityError } from '../errors/UnprocessableEntityError.js';
+import { isValidInt32, validateFields, validateIncludes, validateQueryString, validateSelectableFields, validateSortableFields } from '../core/validation.js';
+/**
+ * Parses and validates a single integer query-string value.
+ * @param value - Raw query-string value (string, number, or array).
+ * @param property - Parameter name used in the error message (e.g. `'limit'`).
+ * @param min - Inclusive lower bound (default: `1`).
+ * @returns The parsed integer, or `undefined` when `value` is absent.
+ */
+function parseInteger(value, property, min = 1) {
+    if (value === undefined)
+        return undefined;
+    const parsed = Number(Array.isArray(value) ? value[0] : value);
+    if (isValidInt32(parsed, min))
+        return parsed;
+    throw new UnprocessableEntityError(`${property} must be a valid integer greater than or equal to ${min}.`);
+}
+/**
+ * Splits a comma-separated string (or array) into a trimmed, non-empty string array.
+ * @param value - Raw query-string value to parse.
+ * @returns Array of trimmed strings, or `undefined` when the input is blank or absent.
+ */
+function parseCsv(value) {
+    const raw = Array.isArray(value) ? value.join(',') : value;
+    if (typeof raw !== 'string' || !raw.trim())
+        return undefined;
+    return raw
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+/**
+ * Parses and validates the raw query-string from a GET request into typed {@link ListOptions}.
+ *
+ * Validates field names, sort fields, includes, and filter keys against the resource schema.
+ * Applies `defaultLimit` and `maxLimit` from the resource definition when set.
+ *
+ * @param query - The raw query-string object from the HTTP request.
+ * @param resource - The resource definition used for field and relation validation.
+ * @returns Typed list options ready to pass to `repository.getMany()`.
+ */
+export function parseListOptions(query, resource) {
+    validateQueryString(resource, query);
+    const fields = parseCsv(query.fields);
+    const include = parseCsv(query.include);
+    let limit = parseInteger(query.limit, 'limit');
+    const offset = parseInteger(query.offset, 'offset', 0);
+    const order = parseCsv(query.order);
+    if (!limit && resource.defaultLimit)
+        limit = resource.defaultLimit;
+    if (limit && resource.maxLimit && limit > resource.maxLimit)
+        limit = resource.maxLimit;
+    if (fields) {
+        validateFields(resource, fields);
+        validateSelectableFields(resource, fields);
+    }
+    if (include)
+        validateIncludes(resource, include);
+    if (fields && include) {
+        throw new UnprocessableEntityError('Cannot use both ?fields= and ?include= in the same request.');
+    }
+    const orderFields = order?.map((item) => (item.startsWith('-') ? item.substring(1) : item));
+    if (orderFields?.length) {
+        validateFields(resource, orderFields);
+        validateSortableFields(resource, orderFields);
+    }
+    const where = {};
+    const fieldNames = new Set(resource.fields.map((field) => field.name));
+    Object.entries(query).forEach(([key, value]) => {
+        if (!fieldNames.has(key))
+            return;
+        const normalized = Array.isArray(value) ? value : String(value).split(',');
+        where[key] = normalized.length === 1 ? normalized[0] : { in: normalized };
+    });
+    return {
+        fields,
+        include,
+        limit,
+        offset,
+        where,
+        orderBy: order?.map((item) => {
+            if (item.startsWith('-'))
+                return { field: item.substring(1), direction: SqlOrder.DESC.toLowerCase() };
+            return { field: item, direction: SqlOrder.ASC.toLowerCase() };
+        })
+    };
+}
+//# sourceMappingURL=queryString.js.map

package/dist/core/queryString.js.map

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