@rangka/core 0.0.1

package/dist/api/meta-handler.js.map

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

package/dist/api/openapi-schema.d.ts

@@ -0,0 +1,25 @@
+import type { FieldConfig } from '@rangka/shared';
+import type { ResolvedModel } from '../schema/types.js';
+export interface JsonSchemaProperty {
+    type: string;
+    format?: string;
+    description?: string;
+    enum?: readonly string[];
+    items?: {
+        type: string;
+    };
+}
+export interface JsonSchemaObject {
+    type: 'object';
+    properties: Record<string, JsonSchemaProperty>;
+    required?: string[];
+}
+/** Map a Rangka field type to its JSON Schema equivalent. Returns null for relation/computed types. */
+export declare function fieldToJsonSchema(config: FieldConfig): JsonSchemaProperty | null;
+/** Build a full JSON Schema object for a model, including all serializable fields. */
+export declare function modelToSchemaComponent(model: ResolvedModel): JsonSchemaObject;
+/** Schema for creating a record — same as the full schema but without the `id` field. */
+export declare function modelToCreateSchema(model: ResolvedModel): JsonSchemaObject;
+/** Schema for updating a record — same as create (all fields optional, no `id`). */
+export declare function modelToUpdateSchema(model: ResolvedModel): JsonSchemaObject;
+//# sourceMappingURL=openapi-schema.d.ts.map

package/dist/api/openapi-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-schema.d.ts","sourceRoot":"","sources":["../../src/api/openapi-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,uGAAuG;AACvG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,kBAAkB,GAAG,IAAI,CAqChF;AAED,sFAAsF;AACtF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,CA0B7E;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,CAI1E;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,CAI1E"}

package/dist/api/openapi-schema.js

@@ -0,0 +1,77 @@
+/** Map a Rangka field type to its JSON Schema equivalent. Returns null for relation/computed types. */
+export function fieldToJsonSchema(config) {
+    switch (config.type) {
+        case 'string':
+        case 'text':
+        case 'code':
+        case 'sequence':
+        case 'dynamicLink':
+            return { type: 'string' };
+        case 'int':
+            return { type: 'integer' };
+        case 'decimal':
+        case 'money':
+            return { type: 'number' };
+        case 'boolean':
+            return { type: 'boolean' };
+        case 'date':
+            return { type: 'string', format: 'date' };
+        case 'datetime':
+            return { type: 'string', format: 'date-time' };
+        case 'enum':
+            return { type: 'string', enum: config.options };
+        case 'json':
+            return { type: 'object' };
+        case 'link':
+            return { type: 'string', description: `Reference to ${config.model}` };
+        case 'attachment':
+            return { type: 'string', format: 'uri' };
+        case 'attachments':
+            return { type: 'array', items: { type: 'string' } };
+        // Relation and computed types have no direct JSON representation
+        case 'hasMany':
+        case 'children':
+        case 'manyToMany':
+        case 'tree':
+        case 'computed':
+            return null;
+    }
+}
+/** Build a full JSON Schema object for a model, including all serializable fields. */
+export function modelToSchemaComponent(model) {
+    const properties = {
+        id: { type: 'string', description: 'Primary key' },
+    };
+    const required = [];
+    for (const field of model.fields) {
+        const fieldSchema = fieldToJsonSchema(field.config);
+        if (!fieldSchema)
+            continue;
+        const property = { ...fieldSchema };
+        if ('label' in field.config && field.config.label) {
+            property.description = field.config.label;
+        }
+        properties[field.name] = property;
+        if ('required' in field.config && field.config.required) {
+            required.push(field.name);
+        }
+    }
+    const schema = { type: 'object', properties };
+    if (required.length > 0) {
+        schema.required = required;
+    }
+    return schema;
+}
+/** Schema for creating a record — same as the full schema but without the `id` field. */
+export function modelToCreateSchema(model) {
+    const full = modelToSchemaComponent(model);
+    const { id: _, ...properties } = full.properties;
+    return { type: 'object', properties };
+}
+/** Schema for updating a record — same as create (all fields optional, no `id`). */
+export function modelToUpdateSchema(model) {
+    const full = modelToSchemaComponent(model);
+    const { id: _, ...properties } = full.properties;
+    return { type: 'object', properties };
+}
+//# sourceMappingURL=openapi-schema.js.map

package/dist/api/openapi-schema.js.map

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

package/dist/api/query-parser.d.ts

@@ -0,0 +1,81 @@
+import type { ResolvedField } from '../schema/types.js';
+export interface ParsedFilter {
+    field: string;
+    operator: string;
+    value: unknown;
+}
+export interface ParsedSort {
+    field: string;
+    direction: 'asc' | 'desc';
+}
+export interface ParsedPagination {
+    page: number;
+    limit: number;
+    offset: number;
+}
+export interface ParsedInclude {
+    relation: string;
+    nested?: ParsedInclude[];
+}
+export interface ParsedQuery {
+    filters: ParsedFilter[];
+    sort: ParsedSort[];
+    pagination: ParsedPagination;
+    includes: ParsedInclude[];
+    fields: string[];
+    search?: string;
+}
+/**
+ * Parses incoming query-string parameters into a structured, validated query object.
+ * Validates field names, operators, and types against the entity schema.
+ */
+export declare class QueryParser {
+    private readonly fieldMap;
+    private readonly relationNames;
+    constructor(fields: ResolvedField[], relationNames: string[]);
+    /** Parse all query sections at once. */
+    parse(query: Record<string, unknown>): ParsedQuery;
+    /**
+     * Parse filter conditions from `query.filter`.
+     * Expected shape: { filter: { fieldName: { operator: value } } }
+     */
+    parseFilters(query: Record<string, unknown>): ParsedFilter[];
+    /**
+     * Parse sort directives from `query.sort`.
+     * Expected format: "field1,-field2" (prefix with `-` for descending).
+     */
+    parseSort(query: Record<string, unknown>): ParsedSort[];
+    /** Parse page/limit from the query, applying defaults and bounds. */
+    parsePagination(query: Record<string, unknown>): ParsedPagination;
+    /**
+     * Parse relation includes from `query.include`.
+     * Supports dot notation for nested relations up to depth 2: "posts.comments"
+     */
+    parseIncludes(query: Record<string, unknown>): ParsedInclude[];
+    /**
+     * Parse sparse fieldsets from `query.fields`.
+     * Always ensures "id" is included.
+     */
+    parseFields(query: Record<string, unknown>): string[];
+    /** Look up a field config, throwing if the field is not recognized. */
+    private getFieldConfigOrThrow;
+    /** Validate that the operator is allowed for the field's type. */
+    private validateOperatorForType;
+    /** Coerce a raw query value to the appropriate JS type based on the operator and field config. */
+    private coerceValue;
+    /** Coerce a single string value to its typed representation (number, boolean, or string). */
+    private coerceSingleValue;
+    /** Parse and validate the page number, defaulting to 1 if invalid. */
+    private parsePageNumber;
+    /** Parse and validate the limit, clamping to [MIN_LIMIT, MAX_LIMIT]. */
+    private parseLimit;
+    /** Parse the search term from the query, trimming whitespace. */
+    parseSearch(query: Record<string, unknown>): string | undefined;
+}
+/** Thrown when a query string contains invalid field names, operators, or values. */
+export declare class QueryValidationError extends Error {
+    readonly statusCode = 400;
+    readonly code = "QUERY_VALIDATION_ERROR";
+    constructor(message: string);
+}
+//# sourceMappingURL=query-parser.d.ts.map

package/dist/api/query-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-parser.d.ts","sourceRoot":"","sources":["../../src/api/query-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMxD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAmCD;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;gBAEhC,MAAM,EAAE,aAAa,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE;IAQ5D,wCAAwC;IACxC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW;IAWlD;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,EAAE;IA+B5D;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,EAAE;IAqBvD,qEAAqE;IACrE,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;IAQjE;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,EAAE;IA+B9D;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE;IAuBrD,uEAAuE;IACvE,OAAO,CAAC,qBAAqB;IAQ7B,kEAAkE;IAClE,OAAO,CAAC,uBAAuB;IAc/B,kGAAkG;IAClG,OAAO,CAAC,WAAW;IAcnB,6FAA6F;IAC7F,OAAO,CAAC,iBAAiB;IAYzB,sEAAsE;IACtE,OAAO,CAAC,eAAe;IAMvB,wEAAwE;IACxE,OAAO,CAAC,UAAU;IAOlB,iEAAiE;IACjE,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS;CAMhE;AAED,qFAAqF;AACrF,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAgB,UAAU,OAAO;IACjC,SAAgB,IAAI,4BAA4B;gBAEpC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/api/query-parser.js

@@ -0,0 +1,232 @@
+import { toBool, toInt, isNil } from '../helpers/coerce.js';
+// --- Type classification sets for operator validation ---
+const NUMERIC_TYPES = new Set(['int', 'decimal', 'money']);
+const DATE_TYPES = new Set(['date', 'datetime']);
+/** Types that support comparison operators (gt, gte, lt, lte) */
+const ORDERED_TYPES = new Set([...NUMERIC_TYPES, ...DATE_TYPES]);
+const COMPARISON_OPERATORS = new Set(['gt', 'gte', 'lt', 'lte']);
+const ALL_OPERATORS = new Set(['eq', 'neq', 'gt', 'gte', 'lt', 'lte', 'like', 'in', 'isnull']);
+// --- Pagination defaults ---
+const DEFAULT_PAGE = 1;
+const DEFAULT_LIMIT = 25;
+const MIN_LIMIT = 1;
+const MAX_LIMIT = 100;
+const MAX_INCLUDE_DEPTH = 2;
+// --- Helpers ---
+/** Split a comma-separated string into trimmed, non-empty parts. */
+function splitCommaSeparated(input) {
+    return input
+        .split(',')
+        .map((segment) => segment.trim())
+        .filter(Boolean);
+}
+/** Clamp a numeric value to a [min, max] range. */
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+/**
+ * Parses incoming query-string parameters into a structured, validated query object.
+ * Validates field names, operators, and types against the entity schema.
+ */
+export class QueryParser {
+    fieldMap;
+    relationNames;
+    constructor(fields, relationNames) {
+        this.fieldMap = new Map();
+        for (const resolved of fields) {
+            this.fieldMap.set(resolved.name, resolved.config);
+        }
+        this.relationNames = new Set(relationNames);
+    }
+    /** Parse all query sections at once. */
+    parse(query) {
+        return {
+            filters: this.parseFilters(query),
+            sort: this.parseSort(query),
+            pagination: this.parsePagination(query),
+            includes: this.parseIncludes(query),
+            fields: this.parseFields(query),
+            search: this.parseSearch(query),
+        };
+    }
+    /**
+     * Parse filter conditions from `query.filter`.
+     * Expected shape: { filter: { fieldName: { operator: value } } }
+     */
+    parseFilters(query) {
+        const filterParam = query['filter'];
+        if (!filterParam || typeof filterParam !== 'object')
+            return [];
+        const filters = [];
+        const filtersByField = filterParam;
+        for (const [fieldName, operatorMap] of Object.entries(filtersByField)) {
+            const fieldConfig = this.getFieldConfigOrThrow(fieldName);
+            if (!operatorMap || typeof operatorMap !== 'object')
+                continue;
+            const operatorEntries = operatorMap;
+            for (const [operator, rawValue] of Object.entries(operatorEntries)) {
+                if (!ALL_OPERATORS.has(operator)) {
+                    throw new QueryValidationError(`Unknown filter operator: ${operator}`);
+                }
+                this.validateOperatorForType(fieldName, operator, fieldConfig);
+                filters.push({
+                    field: fieldName,
+                    operator,
+                    value: this.coerceValue(operator, rawValue, fieldConfig),
+                });
+            }
+        }
+        return filters;
+    }
+    /**
+     * Parse sort directives from `query.sort`.
+     * Expected format: "field1,-field2" (prefix with `-` for descending).
+     */
+    parseSort(query) {
+        const sortParam = query['sort'];
+        if (!sortParam || typeof sortParam !== 'string')
+            return [];
+        const sortFields = splitCommaSeparated(sortParam);
+        const result = [];
+        for (const entry of sortFields) {
+            const isDescending = entry.startsWith('-');
+            const fieldName = isDescending ? entry.slice(1) : entry;
+            if (!this.fieldMap.has(fieldName)) {
+                throw new QueryValidationError(`Unknown sort field: ${fieldName}`);
+            }
+            result.push({ field: fieldName, direction: isDescending ? 'desc' : 'asc' });
+        }
+        return result;
+    }
+    /** Parse page/limit from the query, applying defaults and bounds. */
+    parsePagination(query) {
+        const page = this.parsePageNumber(query['page']);
+        const limit = this.parseLimit(query['limit']);
+        const offset = (page - 1) * limit;
+        return { page, limit, offset };
+    }
+    /**
+     * Parse relation includes from `query.include`.
+     * Supports dot notation for nested relations up to depth 2: "posts.comments"
+     */
+    parseIncludes(query) {
+        const includeParam = query['include'];
+        if (!includeParam || typeof includeParam !== 'string')
+            return [];
+        const includePaths = splitCommaSeparated(includeParam);
+        const result = [];
+        for (const path of includePaths) {
+            const segments = path.split('.');
+            if (segments.length > MAX_INCLUDE_DEPTH) {
+                throw new QueryValidationError(`Max include depth of ${MAX_INCLUDE_DEPTH} exceeded: ${path}`);
+            }
+            if (!this.relationNames.has(segments[0])) {
+                throw new QueryValidationError(`Unknown relation: ${segments[0]}`);
+            }
+            const parsed = { relation: segments[0] };
+            if (segments.length === 2) {
+                parsed.nested = [{ relation: segments[1] }];
+            }
+            result.push(parsed);
+        }
+        return result;
+    }
+    /**
+     * Parse sparse fieldsets from `query.fields`.
+     * Always ensures "id" is included.
+     */
+    parseFields(query) {
+        const fieldsParam = query['fields'];
+        if (!fieldsParam || typeof fieldsParam !== 'string')
+            return [];
+        const requestedFields = splitCommaSeparated(fieldsParam);
+        for (const fieldName of requestedFields) {
+            if (fieldName === 'id')
+                continue;
+            if (!this.fieldMap.has(fieldName)) {
+                throw new QueryValidationError(`Unknown field: ${fieldName}`);
+            }
+        }
+        // Ensure "id" is always present at the start
+        if (!requestedFields.includes('id')) {
+            requestedFields.unshift('id');
+        }
+        return requestedFields;
+    }
+    // --- Private helpers ---
+    /** Look up a field config, throwing if the field is not recognized. */
+    getFieldConfigOrThrow(fieldName) {
+        const config = this.fieldMap.get(fieldName);
+        if (!config) {
+            throw new QueryValidationError(`Unknown filter field: ${fieldName}`);
+        }
+        return config;
+    }
+    /** Validate that the operator is allowed for the field's type. */
+    validateOperatorForType(fieldName, operator, config) {
+        if (COMPARISON_OPERATORS.has(operator) && !ORDERED_TYPES.has(config.type)) {
+            throw new QueryValidationError(`Operator '${operator}' is not valid for ${config.type} field '${fieldName}'`);
+        }
+        if (operator === 'like' && config.type !== 'string' && config.type !== 'text') {
+            throw new QueryValidationError(`Operator 'like' is not valid for ${config.type} field '${fieldName}'`);
+        }
+    }
+    /** Coerce a raw query value to the appropriate JS type based on the operator and field config. */
+    coerceValue(operator, rawValue, config) {
+        const stringValue = String(rawValue);
+        if (operator === 'isnull') {
+            return toBool(rawValue);
+        }
+        if (operator === 'in') {
+            return stringValue.split(',').map((item) => this.coerceSingleValue(item.trim(), config));
+        }
+        return this.coerceSingleValue(stringValue, config);
+    }
+    /** Coerce a single string value to its typed representation (number, boolean, or string). */
+    coerceSingleValue(value, config) {
+        if (NUMERIC_TYPES.has(config.type)) {
+            const parsed = Number(value);
+            if (isNaN(parsed))
+                return value;
+            return parsed;
+        }
+        if (config.type === 'boolean') {
+            return toBool(value);
+        }
+        return value;
+    }
+    /** Parse and validate the page number, defaulting to 1 if invalid. */
+    parsePageNumber(raw) {
+        const parsed = toInt(raw, -1);
+        if (parsed < 1)
+            return DEFAULT_PAGE;
+        return parsed;
+    }
+    /** Parse and validate the limit, clamping to [MIN_LIMIT, MAX_LIMIT]. */
+    parseLimit(raw) {
+        if (isNil(raw) || raw === '')
+            return DEFAULT_LIMIT;
+        const parsed = toInt(raw, -1);
+        if (parsed < 0)
+            return DEFAULT_LIMIT;
+        return clamp(parsed, MIN_LIMIT, MAX_LIMIT);
+    }
+    /** Parse the search term from the query, trimming whitespace. */
+    parseSearch(query) {
+        const raw = query['search'];
+        if (!raw || typeof raw !== 'string')
+            return undefined;
+        const trimmed = raw.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    }
+}
+/** Thrown when a query string contains invalid field names, operators, or values. */
+export class QueryValidationError extends Error {
+    statusCode = 400;
+    code = 'QUERY_VALIDATION_ERROR';
+    constructor(message) {
+        super(message);
+        this.name = 'QueryValidationError';
+    }
+}
+//# sourceMappingURL=query-parser.js.map

package/dist/api/query-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-parser.js","sourceRoot":"","sources":["../../src/api/query-parser.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAmC5D,2DAA2D;AAE3D,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AAC3D,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AACjD,iEAAiE;AACjE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,aAAa,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC;AAEjE,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AACjE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE/F,8BAA8B;AAE9B,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B,kBAAkB;AAElB,oEAAoE;AACpE,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;SAChC,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,mDAAmD;AACnD,SAAS,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,WAAW;IACL,QAAQ,CAA2B;IACnC,aAAa,CAAc;IAE5C,YAAY,MAAuB,EAAE,aAAuB;QAC1D,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,KAAK,MAAM,QAAQ,IAAI,MAAM,EAAE,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;IAC9C,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,KAA8B;QAClC,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YACjC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAC3B,UAAU,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;YACvC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;YACnC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;YAC/B,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;SAChC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,KAA8B;QACzC,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAE/D,MAAM,OAAO,GAAmB,EAAE,CAAC;QACnC,MAAM,cAAc,GAAG,WAAsC,CAAC;QAE9D,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YACtE,MAAM,WAAW,GAAG,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;YAE1D,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ;gBAAE,SAAS;YAC9D,MAAM,eAAe,GAAG,WAAsC,CAAC;YAE/D,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;gBACnE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACjC,MAAM,IAAI,oBAAoB,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;gBACzE,CAAC;gBAED,IAAI,CAAC,uBAAuB,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;gBAE/D,OAAO,CAAC,IAAI,CAAC;oBACX,KAAK,EAAE,SAAS;oBAChB,QAAQ;oBACR,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC;iBACzD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,KAA8B;QACtC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAE3D,MAAM,UAAU,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAClD,MAAM,MAAM,GAAiB,EAAE,CAAC;QAEhC,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM,YAAY,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAExD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,oBAAoB,CAAC,uBAAuB,SAAS,EAAE,CAAC,CAAC;YACrE,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,qEAAqE;IACrE,eAAe,CAAC,KAA8B;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;QAElC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,KAA8B;QAC1C,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAEjE,MAAM,YAAY,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC;QACvD,MAAM,MAAM,GAAoB,EAAE,CAAC;QAEnC,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAEjC,IAAI,QAAQ,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;gBACxC,MAAM,IAAI,oBAAoB,CAC5B,wBAAwB,iBAAiB,cAAc,IAAI,EAAE,CAC9D,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,oBAAoB,CAAC,qBAAqB,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACrE,CAAC;YAED,MAAM,MAAM,GAAkB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC9C,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,KAA8B;QACxC,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAE/D,MAAM,eAAe,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAEzD,KAAK,MAAM,SAAS,IAAI,eAAe,EAAE,CAAC;YACxC,IAAI,SAAS,KAAK,IAAI;gBAAE,SAAS;YACjC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,oBAAoB,CAAC,kBAAkB,SAAS,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QAED,6CAA6C;QAC7C,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,0BAA0B;IAE1B,uEAAuE;IAC/D,qBAAqB,CAAC,SAAiB;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,oBAAoB,CAAC,yBAAyB,SAAS,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,kEAAkE;IAC1D,uBAAuB,CAAC,SAAiB,EAAE,QAAgB,EAAE,MAAmB;QACtF,IAAI,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,oBAAoB,CAC5B,aAAa,QAAQ,sBAAsB,MAAM,CAAC,IAAI,WAAW,SAAS,GAAG,CAC9E,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC9E,MAAM,IAAI,oBAAoB,CAC5B,oCAAoC,MAAM,CAAC,IAAI,WAAW,SAAS,GAAG,CACvE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,kGAAkG;IAC1F,WAAW,CAAC,QAAgB,EAAE,QAAiB,EAAE,MAAmB;QAC1E,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAErC,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3F,CAAC;QAED,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;IAED,6FAA6F;IACrF,iBAAiB,CAAC,KAAa,EAAE,MAAmB;QAC1D,IAAI,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,KAAK,CAAC,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC;YAChC,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sEAAsE;IAC9D,eAAe,CAAC,GAAY;QAClC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,MAAM,GAAG,CAAC;YAAE,OAAO,YAAY,CAAC;QACpC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,wEAAwE;IAChE,UAAU,CAAC,GAAY;QAC7B,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,EAAE;YAAE,OAAO,aAAa,CAAC;QACnD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,MAAM,GAAG,CAAC;YAAE,OAAO,aAAa,CAAC;QACrC,OAAO,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,iEAAiE;IACjE,WAAW,CAAC,KAA8B;QACxC,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACtD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAClD,CAAC;CACF;AAED,qFAAqF;AACrF,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7B,UAAU,GAAG,GAAG,CAAC;IACjB,IAAI,GAAG,wBAAwB,CAAC;IAEhD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/dist/api/route-generator.d.ts

@@ -0,0 +1,161 @@
+import type { FastifyInstance } from 'fastify';
+import type { SchemaRegistry } from '../schema/registry.js';
+import type { DatabaseClient } from '../db/client.js';
+import type { PermissionRegistry } from '../auth/permission-registry.js';
+import type { HookRegistry } from '../hooks/registry.js';
+import type { ServiceRegistry } from '../services/registry.js';
+import type { EventBus } from '../events/bus.js';
+import type { ResolvedModel } from '../schema/types.js';
+import type { ScopeRegistry } from '../auth/scope-registry.js';
+import type { ModuleConfig, PageDefinition, WidgetDefinitionMeta } from '@rangka/shared';
+export interface RouteGeneratorOptions {
+    permissionRegistry?: PermissionRegistry;
+    hookRegistry?: HookRegistry;
+    serviceRegistry?: ServiceRegistry;
+    eventBus?: EventBus;
+    scopeRegistry?: ScopeRegistry;
+    config?: Record<string, unknown>;
+    pages?: Array<{
+        module: string;
+        page: PageDefinition;
+    }>;
+    modules?: ModuleConfig[];
+    widgets?: WidgetDefinitionMeta[];
+    adapterRegistry?: import('../plugins/adapter-registry.js').AdapterRegistry;
+    adapterCapabilities?: Record<string, import('../plugins/types.js').AdapterCapability[]>;
+}
+/**
+ * Registers all REST routes for every model in the schema registry,
+ * plus session and meta routes.
+ */
+export declare function generateRoutes(server: FastifyInstance, registry: SchemaRegistry, db: DatabaseClient, options?: RouteGeneratorOptions): void;
+/** Builds OpenAPI response schemas (200, 201, 400, 404, etc.) for a model's endpoints. */
+export declare function buildOpenApiResponseSchemas(model: ResolvedModel): {
+    list: {
+        200: {
+            description: string;
+            type: "object";
+            properties: {
+                data: {
+                    type: "array";
+                    items: import("./openapi-schema.js").JsonSchemaObject;
+                };
+                meta: {
+                    type: "object";
+                    properties: {
+                        total: {
+                            type: "integer";
+                        };
+                        page: {
+                            type: "integer";
+                        };
+                        limit: {
+                            type: "integer";
+                        };
+                        totalPages: {
+                            type: "integer";
+                        };
+                    };
+                };
+            };
+        };
+    };
+    get: {
+        200: {
+            description: string;
+            type: "object";
+            properties: {
+                data: import("./openapi-schema.js").JsonSchemaObject;
+            };
+        };
+        404: {
+            type: "object";
+            properties: {
+                error: {
+                    type: "object";
+                    properties: {
+                        code: {
+                            type: "string";
+                        };
+                        message: {
+                            type: "string";
+                        };
+                    };
+                };
+            };
+        };
+    };
+    create: {
+        201: {
+            description: string;
+            type: "object";
+            properties: {
+                data: import("./openapi-schema.js").JsonSchemaObject;
+            };
+        };
+        400: {
+            type: "object";
+            properties: {
+                error: {
+                    type: "object";
+                    properties: {
+                        code: {
+                            type: "string";
+                        };
+                        message: {
+                            type: "string";
+                        };
+                    };
+                };
+            };
+        };
+    };
+    update: {
+        200: {
+            description: string;
+            type: "object";
+            properties: {
+                data: import("./openapi-schema.js").JsonSchemaObject;
+            };
+        };
+        404: {
+            type: "object";
+            properties: {
+                error: {
+                    type: "object";
+                    properties: {
+                        code: {
+                            type: "string";
+                        };
+                        message: {
+                            type: "string";
+                        };
+                    };
+                };
+            };
+        };
+    };
+    delete: {
+        204: {
+            description: string;
+            type: "null";
+        };
+        404: {
+            type: "object";
+            properties: {
+                error: {
+                    type: "object";
+                    properties: {
+                        code: {
+                            type: "string";
+                        };
+                        message: {
+                            type: "string";
+                        };
+                    };
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=route-generator.d.ts.map

package/dist/api/route-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-generator.d.ts","sourceRoot":"","sources":["../../src/api/route-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAcxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAU/D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAIzF,MAAM,WAAW,qBAAqB;IACpC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,cAAc,CAAA;KAAE,CAAC,CAAC;IACxD,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACjC,eAAe,CAAC,EAAE,OAAO,gCAAgC,EAAE,eAAe,CAAC;IAC3E,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,qBAAqB,EAAE,iBAAiB,EAAE,CAAC,CAAC;CACzF;AAkCD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,cAAc,EACxB,EAAE,EAAE,cAAc,EAClB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CA2CN;AAuPD,0FAA0F;AAC1F,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkE/D"}