hola-server 2.0.1 → 3.0.0

package/dist/index.js

@@ -0,0 +1,61 @@
+/**
+ * Hola Server - Main entry point and public API.
+ *
+ * @module hola-server
+ *
+ * @example
+ * ```typescript
+ * import { plugins, errors, db, meta, config } from 'hola-server';
+ *
+ * const app = new Elysia()
+ *     .use(plugins.holaCors({ origin: ['http://localhost:5173'] }))
+ *     .use(plugins.holaBody({ limit: '10mb' }))
+ *     .use(plugins.holaAuth({ secret: 'your-secret' }))
+ *     .use(plugins.holaError())
+ *     .use(userRouter)
+ *     .onStart(async () => {
+ *         await db.get_db();
+ *         meta.validate_all_metas();
+ *     })
+ *     .listen(3000);
+ * ```
+ */
+// Namespaced exports
+export * as plugins from "./plugins/index.js";
+export * as errors from "./errors/index.js";
+export * as db from "./db/index.js";
+export * as meta from "./meta/index.js";
+export * as config from "./config/index.js";
+// Commonly used items at top level for convenience
+export { EntityMeta, init_router, validate_all_metas, register_schema_type } from "./meta/index.js";
+export { Entity } from "./db/entity.js";
+export { get_db, init_db, close_db } from "./db/db.js";
+// Core Type System
+export { register_type, get_type, convert_type, convert_update_type, int_enum_type } from "./core/type.js";
+export { get_entity_meta, get_all_metas, DELETE_MODE } from "./core/meta.js";
+// Core Role System
+export { is_root_role, is_root_user, check_user_role, get_user_role_right, get_session_user, validate_meta_role } from "./core/role.js";
+// Core Utilities
+export { url } from "./core/url.js";
+export * as array from "./core/array.js";
+export * as bash from "./core/bash.js";
+export * as chart from "./core/chart.js";
+export * as date from "./core/date.js";
+export * as file from "./core/file.js";
+export * as lhs from "./core/lhs.js";
+export * as number from "./core/number.js";
+export * as obj from "./core/obj.js";
+export * as random from "./core/random.js";
+export * as thread from "./core/thread.js";
+export * as validate from "./core/validate.js";
+export { encrypt_pwd, md5, encrypt_secret, decrypt_secret } from "./core/encrypt.js";
+// HTTP utilities
+export * as code from "./http/code.js";
+// Settings
+export { init_settings, get_settings } from "./setting.js";
+// OID utilities
+export { oid_query, oid_queries } from "./db/db.js";
+// Tools
+export { gen_i18n } from "./tool/gen_i18n.js";
+export { VectorStore, getVectorStore, initVectorStore } from "./tool/vector_store.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,qBAAqB;AACrB,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,mDAAmD;AACnD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAIpG,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvD,mBAAmB;AACnB,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE3G,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7E,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAExI,iBAAiB;AACjB,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,QAAQ,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAErF,iBAAiB;AACjB,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AAEvC,WAAW;AACX,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG3D,gBAAgB;AAChB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEpD,QAAQ;AACR,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/meta/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Meta module index - exports EntityMeta, router, and schema utilities.
+ * @module meta
+ */
+export { EntityMeta, get_entity_meta, get_all_metas, validate_all_metas, DELETE_MODE } from '../core/meta.js';
+export type { MetaDefinition, FieldDefinition, AnyCallback, FieldValue, QueryValue } from '../core/meta.js';
+export { init_router } from './router.js';
+export { meta_to_schema, meta_to_openapi, register_schema_type } from './schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/meta/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/meta/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACH,UAAU,EACV,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,WAAW,EACd,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACR,cAAc,EACd,eAAe,EACf,WAAW,EACX,UAAU,EACV,UAAU,EACb,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/meta/index.js

@@ -0,0 +1,11 @@
+/**
+ * Meta module index - exports EntityMeta, router, and schema utilities.
+ * @module meta
+ */
+// EntityMeta and related types
+export { EntityMeta, get_entity_meta, get_all_metas, validate_all_metas, DELETE_MODE } from '../core/meta.js';
+// Router initialization
+export { init_router } from './router.js';
+// Schema generation
+export { meta_to_schema, meta_to_openapi, register_schema_type } from './schema.js';
+//# sourceMappingURL=index.js.map

package/dist/meta/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/meta/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+BAA+B;AAC/B,OAAO,EACH,UAAU,EACV,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,WAAW,EACd,MAAM,iBAAiB,CAAC;AAUzB,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/meta/router.d.ts

@@ -0,0 +1,26 @@
+/**
+ * RESTful router initialization for EntityMeta.
+ * @module meta/router
+ */
+import { Elysia } from "elysia";
+import { MetaDefinition } from "../core/meta.js";
+/**
+ * Create RESTful router for an entity.
+ *
+ * Routes:
+ * - GET /           Simple list with optional params (attr_names, sort_by, desc, page, limit)
+ * - POST /list      List entities with full query options
+ * - GET /:id        Get single entity
+ * - POST /          Create entity
+ * - PUT /:id        Update entity
+ * - DELETE /:id     Delete entity
+ * - GET /meta       Get field metadata and permission mode
+ * - GET /ref        Get reference labels
+ * - POST /:id/clone Clone entity
+ *
+ * @param definition Meta definition for the entity
+ */
+export declare const init_router: (definition: MetaDefinition) => Elysia<any>;
+/** Re-export validate_all_metas for convenience. */
+export { validate_all_metas } from "../core/meta.js";
+//# sourceMappingURL=router.d.ts.map

package/dist/meta/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/meta/router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAc,cAAc,EAAiD,MAAM,iBAAiB,CAAC;AA8E5G;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW,GAAI,YAAY,cAAc,KAAG,MAAM,CAAC,GAAG,CAyNlE,CAAC;AAEF,oDAAoD;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/meta/router.js

@@ -0,0 +1,258 @@
+/**
+ * RESTful router initialization for EntityMeta.
+ * @module meta/router
+ */
+import { Elysia } from "elysia";
+import { EntityMeta, filter_fields_by_role } from "../core/meta.js";
+import { meta_to_schema } from "./schema.js";
+import { Entity } from "../db/entity.js";
+import { NotFoundError, NoRightsError } from "../errors/index.js";
+import { SUCCESS } from "../http/code.js";
+import { get_settings } from "../setting.js";
+import { has_value } from "../core/validate.js";
+/** Check if user has read rights for meta. */
+const check_read_rights = (user, meta) => {
+    if (!meta.readable)
+        throw new NoRightsError("entity not readable");
+    const settings = get_settings();
+    if (settings.server.check_user && !user)
+        throw new NoRightsError("no user found");
+    // Check role-based permission if roles are defined
+    if (meta.roles && user) {
+        const mode = meta.get_role_mode(user.role);
+        if (!mode.includes("r"))
+            throw new NoRightsError("role has no read rights");
+    }
+};
+/** Check if user has create rights for meta. */
+const check_create_rights = (user, meta) => {
+    if (!meta.creatable)
+        throw new NoRightsError("entity not creatable");
+    const settings = get_settings();
+    if (settings.server.check_user && !user)
+        throw new NoRightsError("no user found");
+    // Check role-based permission if roles are defined
+    if (meta.roles && user) {
+        const mode = meta.get_role_mode(user.role);
+        if (!mode.includes("c"))
+            throw new NoRightsError("role has no create rights");
+    }
+};
+/** Check if user has update rights for meta. */
+const check_update_rights = (user, meta) => {
+    if (!meta.updatable)
+        throw new NoRightsError("entity not updatable");
+    const settings = get_settings();
+    if (settings.server.check_user && !user)
+        throw new NoRightsError("no user found");
+    // Check role-based permission if roles are defined
+    if (meta.roles && user) {
+        const mode = meta.get_role_mode(user.role);
+        if (!mode.includes("u"))
+            throw new NoRightsError("role has no update rights");
+    }
+};
+/** Check if user has delete rights for meta. */
+const check_delete_rights = (user, meta) => {
+    if (!meta.deleteable)
+        throw new NoRightsError("entity not deleteable");
+    const settings = get_settings();
+    if (settings.server.check_user && !user)
+        throw new NoRightsError("no user found");
+    // Check role-based permission if roles are defined
+    if (meta.roles && user) {
+        const mode = meta.get_role_mode(user.role);
+        if (!mode.includes("d"))
+            throw new NoRightsError("role has no delete rights");
+    }
+};
+/** Check if user has clone rights for meta. */
+const check_clone_rights = (user, meta) => {
+    if (!meta.cloneable)
+        throw new NoRightsError("entity not cloneable");
+    const settings = get_settings();
+    if (settings.server.check_user && !user)
+        throw new NoRightsError("no user found");
+    // Check role-based permission if roles are defined (clone requires create permission)
+    if (meta.roles && user) {
+        const mode = meta.get_role_mode(user.role);
+        if (!mode.includes("o"))
+            throw new NoRightsError("role has no clone rights");
+    }
+};
+/**
+ * Create RESTful router for an entity.
+ *
+ * Routes:
+ * - GET /           Simple list with optional params (attr_names, sort_by, desc, page, limit)
+ * - POST /list      List entities with full query options
+ * - GET /:id        Get single entity
+ * - POST /          Create entity
+ * - PUT /:id        Update entity
+ * - DELETE /:id     Delete entity
+ * - GET /meta       Get field metadata and permission mode
+ * - GET /ref        Get reference labels
+ * - POST /:id/clone Clone entity
+ *
+ * @param definition Meta definition for the entity
+ */
+export const init_router = (definition) => {
+    const meta = new EntityMeta(definition);
+    const entity = new Entity(meta.collection);
+    const schema = meta_to_schema(meta);
+    const router = new Elysia({ prefix: `/${meta.collection}` });
+    // POST /list - List entities
+    if (meta.readable) {
+        router.post("/list", async ({ user, body }) => {
+            check_read_rights(user, meta);
+            const body_data = body;
+            const filter = {};
+            // Apply user field filter if defined
+            if (meta.user_field && user?.sub) {
+                filter[meta.user_field] = user.sub;
+            }
+            const user_role = user?.role || "*";
+            const result = await entity.list_entity(body_data, filter, body_data, user_role);
+            return { ...result };
+        }, { body: schema.query });
+    }
+    // GET / - Simple list with optional parameters and sensible defaults
+    if (meta.readable) {
+        router.get("/", async ({ user, query }) => {
+            check_read_rights(user, meta);
+            const settings = get_settings();
+            const query_data = query;
+            const filter = {};
+            // Apply user field filter if defined
+            if (meta.user_field && user?.sub) {
+                filter[meta.user_field] = user.sub;
+            }
+            // Provide sensible defaults for optional parameters
+            const list_field_names = meta.list_fields.map((f) => f.name).join(",");
+            const primary_key = meta.primary_keys?.[0] || "_id";
+            const default_limit = settings.server.threshold.default_list_limit || 100;
+            const params = {
+                attr_names: query_data.attr_names || list_field_names,
+                sort_by: query_data.sort_by || primary_key,
+                desc: query_data.desc || "true",
+                page: Number(query_data.page) || 1,
+                limit: Number(query_data.limit) || default_limit,
+            };
+            const user_role = user?.role || "*";
+            const result = await entity.list_entity(params, filter, query_data, user_role);
+            return { ...result };
+        });
+    }
+    // GET /meta - Get field metadata and mode
+    if (meta.readable) {
+        router.get("/meta", async ({ user }) => {
+            check_read_rights(user, meta);
+            // Get mode based on user's role
+            const role_mode = meta.get_role_mode(user?.role);
+            // Filter to fields visible in at least one UI context
+            const user_role = user?.role || "*";
+            const visible_fields = filter_fields_by_role(meta.client_fields, user_role).filter((f) => f.create !== false || f.update !== false || f.search !== false || f.list !== false);
+            return { code: SUCCESS, data: { mode: role_mode, fields: visible_fields } };
+        });
+    }
+    // GET /ref - Get reference labels
+    if (meta.readable && meta.ref_label) {
+        router.get("/ref", async ({ user, query }) => {
+            check_read_rights(user, meta);
+            const list = await entity.get_filtered_ref_labels(query.ref_by_entity || "", query.query, user?.sub);
+            const items = list.map((obj) => ({ title: obj[meta.ref_label], value: String(obj._id) }));
+            return { code: SUCCESS, data: items };
+        }, { query: schema.ref_query });
+    }
+    // GET /:id - Get single entity
+    if (meta.readable) {
+        router.get("/:id", async ({ user, params }) => {
+            check_read_rights(user, meta);
+            const user_role = user?.role || "*";
+            const list_field_names = meta.list_fields.map((f) => f.name).join(",");
+            const result = await entity.read_entity(params.id, list_field_names, user_role);
+            if (!result.data)
+                throw new NotFoundError();
+            return { code: SUCCESS, data: result.data };
+        }, { params: schema.id_param });
+    }
+    // GET /:id/property - Get specific properties
+    if (meta.readable) {
+        router.get("/:id/property", async ({ user, params, query }) => {
+            check_read_rights(user, meta);
+            const user_role = user?.role || "*";
+            const attr_names = query.fields || "*";
+            const result = await entity.read_property(params.id, attr_names, user_role);
+            if (!result.data)
+                throw new NotFoundError();
+            return { code: SUCCESS, data: result.data };
+        }, { params: schema.id_param, query: schema.property_query });
+    }
+    // POST / - Create entity
+    // Note: No Elysia schema validation here - Entity layer handles validation after before_hook
+    // This allows hooks to set default values for required fields
+    if (meta.creatable) {
+        router.post("/", async ({ user, body }) => {
+            check_create_rights(user, meta);
+            const data = body;
+            // Apply default values for create operation
+            for (const field of meta.create_fields) {
+                if (!has_value(data[field.name]) && field.default !== undefined) {
+                    data[field.name] = field.default;
+                }
+            }
+            // Set user field if defined
+            if (meta.user_field && user?.sub) {
+                data[meta.user_field] = user.sub;
+            }
+            // Pass user context for hooks to access
+            data._user = user;
+            const user_role = user?.role || "*";
+            const result = await entity.create_entity(data, user_role);
+            return result;
+        });
+    }
+    // PUT /:id - Update entity
+    if (meta.updatable) {
+        router.put("/:id", async ({ user, params, body }) => {
+            check_update_rights(user, meta);
+            const data = body;
+            const user_role = user?.role || "*";
+            const result = await entity.update_entity(params.id, data, user_role);
+            return result;
+        }, { params: schema.id_param, body: schema.update });
+    }
+    // DELETE /:id - Delete entity
+    if (meta.deleteable) {
+        router.delete("/:id", async ({ user, params }) => {
+            check_delete_rights(user, meta);
+            const result = await entity.delete_entity([params.id]);
+            return result;
+        }, { params: schema.id_param });
+    }
+    // POST /:id/clone - Clone entity
+    // Note: No Elysia body schema validation here - Entity layer handles validation after before_hook
+    if (meta.cloneable) {
+        router.post("/:id/clone", async ({ user, params, body }) => {
+            check_clone_rights(user, meta);
+            const data = body;
+            // Set user field if defined (cloned entity belongs to the cloning user)
+            if (meta.user_field && user?.sub) {
+                data[meta.user_field] = user.sub;
+            }
+            // Pass user context for hooks to access
+            data._user = user;
+            const user_role = user?.role || "*";
+            const result = await entity.clone_entity(params.id, data, user_role);
+            return result;
+        }, { params: schema.id_param });
+    }
+    // Custom route callback
+    if (definition.route) {
+        definition.route(router, meta);
+    }
+    return router;
+};
+/** Re-export validate_all_metas for convenience. */
+export { validate_all_metas } from "../core/meta.js";
+//# sourceMappingURL=router.js.map

package/dist/meta/router.js.map

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

package/dist/meta/schema.d.ts

@@ -0,0 +1,41 @@
+/**
+ * TypeBox schema generation from EntityMeta.
+ * @module meta/schema
+ */
+import { TSchema } from "elysia";
+import type { EntityMeta } from "../core/meta.js";
+/** Register a custom schema type mapping. */
+export declare const register_schema_type: (name: string, schema_fn: () => TSchema) => void;
+/** Generate TypeBox schemas from EntityMeta (lazy evaluation for custom types). */
+export declare const meta_to_schema: (meta: EntityMeta) => {
+    readonly create: TSchema;
+    readonly update: TSchema;
+    query: import("@sinclair/typebox").TObject<{
+        page: import("@sinclair/typebox").TNumber;
+        limit: import("@sinclair/typebox").TNumber;
+        sort_by: import("@sinclair/typebox").TString;
+        desc: import("@sinclair/typebox").TString;
+        attr_names: import("@sinclair/typebox").TString;
+        search: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    ref_query: import("@sinclair/typebox").TObject<{
+        ref_by_entity: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        query: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    property_query: import("@sinclair/typebox").TObject<{
+        fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    id_param: import("@sinclair/typebox").TObject<{
+        id: import("@sinclair/typebox").TString;
+    }>;
+};
+/** Generate OpenAPI-compatible schema documentation from EntityMeta. */
+export declare const meta_to_openapi: (meta: EntityMeta) => {
+    collection: string;
+    fields: {
+        name: string;
+        type: string;
+        required: boolean;
+    }[];
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/meta/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/meta/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,iBAAiB,CAAC;AAKnE,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,EAAE,WAAW,MAAM,OAAO,KAAG,IAE7E,CAAC;AAsCF,mFAAmF;AACnF,eAAO,MAAM,cAAc,GAAI,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CAyB9C,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,eAAe,GAAI,MAAM,UAAU;;;;;;;CAA0J,CAAC"}

package/dist/meta/schema.js

@@ -0,0 +1,69 @@
+/**
+ * TypeBox schema generation from EntityMeta.
+ * @module meta/schema
+ */
+import { t } from "elysia";
+/** Custom schema type registry for project-specific types. */
+const custom_schema_types = {};
+/** Register a custom schema type mapping. */
+export const register_schema_type = (name, schema_fn) => {
+    custom_schema_types[name] = schema_fn;
+};
+/** Get schema for a field type (checks custom types first, then built-in, then defaults to string). */
+const get_schema_for_type = (type_name) => {
+    const type_map = { string: () => t.String(), text: () => t.String(), number: () => t.Numeric(), int: () => t.Numeric(), float: () => t.Numeric(), boolean: () => t.Boolean(), date: () => t.String({ format: "date-time" }), datetime: () => t.String({ format: "date-time" }), array: () => t.Array(t.Unknown()), object: () => t.Object({}), file: () => t.Any(), json: () => t.Any() };
+    // Check custom types first, then built-in types, then default to string
+    const schema_fn = custom_schema_types[type_name] ?? type_map[type_name];
+    return schema_fn?.() ?? t.String();
+};
+/** Map field type to TypeBox schema. */
+const field_to_schema = (field) => {
+    const base = get_schema_for_type(field.type ?? "string");
+    return field.required ? base : t.Optional(base);
+};
+/** Build create schema for entity. */
+const build_create_schema = (meta) => {
+    const create_fields = {};
+    // Exclude user_field from request validation - it's auto-populated from session
+    const user_field = meta.user_field;
+    for (const field of meta.create_fields) {
+        if (field.name === user_field)
+            continue;
+        create_fields[field.name] = field_to_schema(field);
+    }
+    return t.Object(create_fields);
+};
+/** Build update schema for entity. */
+const build_update_schema = (meta) => {
+    const update_fields = {};
+    for (const field of meta.update_fields) {
+        update_fields[field.name] = t.Optional(field_to_schema(field));
+    }
+    return t.Object(update_fields);
+};
+/** Generate TypeBox schemas from EntityMeta (lazy evaluation for custom types). */
+export const meta_to_schema = (meta) => {
+    // Query schema for list operations - allows additional properties for entity-specific search fields
+    const query_schema = t.Object({ page: t.Number({ minimum: 1 }), limit: t.Number({ minimum: 1, maximum: 1000 }), sort_by: t.String(), desc: t.String(), attr_names: t.String(), search: t.Optional(t.String()) }, { additionalProperties: true });
+    // Ref query schema for reference labels lookup
+    const ref_query_schema = t.Object({ ref_by_entity: t.Optional(t.String()), query: t.Optional(t.String()) });
+    // Property query schema for reading specific fields
+    const property_query_schema = t.Object({ fields: t.Optional(t.String()) });
+    const id_param = t.Object({ id: t.String() });
+    // Use getters for lazy evaluation - custom types are resolved when schema is accessed
+    return {
+        get create() {
+            return build_create_schema(meta);
+        },
+        get update() {
+            return build_update_schema(meta);
+        },
+        query: query_schema,
+        ref_query: ref_query_schema,
+        property_query: property_query_schema,
+        id_param,
+    };
+};
+/** Generate OpenAPI-compatible schema documentation from EntityMeta. */
+export const meta_to_openapi = (meta) => ({ collection: meta.collection, fields: meta.client_fields.map((f) => ({ name: f.name, type: f.type ?? "string", required: f.required ?? false })) });
+//# sourceMappingURL=schema.js.map

package/dist/meta/schema.js.map

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