hola-server 1.0.11 → 3.0.0

package/dist/core/number.js

@@ -0,0 +1,99 @@
+/**
+ * Number manipulation and mathematical utility functions.
+ * @module core/number
+ */
+import { has_value } from './validate.js';
+import { is_object } from './obj.js';
+/** Parse string value to number, returns 0 if invalid. */
+export const parse_num = (str) => {
+    const value = parseFloat(String(str));
+    return value ? value : 0;
+};
+/** Parse string value to number with 2 decimal places. */
+export const to_fixed2 = (str) => {
+    const value = parse_num(str);
+    return value ? parseFloat(value.toFixed(2)) : 0;
+};
+/** Round number to 2 decimal places. */
+export const round_to_fixed2 = (num) => Math.round(num * 100) / 100;
+/** Generate range array. Example: range(3) = [0,1,2], range(1,5) = [1,2,3,4,5] */
+export const range = (start, end, step = 1) => {
+    if (end === undefined)
+        return Array.from({ length: start }, (_, key) => key);
+    return [...Array(Math.floor((end - start) / step) + 1)].map((_, i) => start + i * step);
+};
+/** Generate scale array with exponential growth. Example: scale(2,10) = [2,4,8] */
+export const scale = (start, end, ratio = 2) => {
+    const length = Math.floor(Math.log(end / start) / Math.log(ratio)) + 1;
+    return [...Array(length)].map((_, i) => start * Math.pow(ratio, i));
+};
+/** Create a space object representing a min-max range. */
+export const space = (min, max) => {
+    if (!has_value(min) || !has_value(max))
+        throw new Error("min and max not provided for space");
+    return { min, max };
+};
+/** Check if value is a space object (has min and max properties). */
+export const is_space = (value) => {
+    if (!is_object(value))
+        return false;
+    const obj = value;
+    return has_value(obj.min) && has_value(obj.max);
+};
+/** Check if value is an integer. */
+export const is_integer = (value) => /^-?[0-9]+$/.test(String(value));
+/** Check if object contains any space objects as property values. */
+export const contains_space = (obj) => {
+    for (const key in obj) {
+        if (is_space(obj[key]))
+            return true;
+    }
+    return false;
+};
+/** Generate random number between min and max. */
+export const random_number = (min, max) => {
+    const random = Math.random() * (max - min) + min;
+    return is_integer(min) && is_integer(max) ? Math.floor(random) : to_fixed2(random);
+};
+/** Generate Latin Hypercube Sampling ranges for a given range. */
+export const lhs_samples = (min, max, n) => {
+    const all_int = is_integer(min) && is_integer(max);
+    const interval = (max - min) / n;
+    const ranges = [];
+    for (let i = 0; i < n; i++) {
+        const start = i * interval + min;
+        const end = (i === n - 1) ? max : start + interval;
+        const min_val = Math.min(start, end);
+        const max_val = Math.max(start, end);
+        ranges.push(all_int
+            ? { min: Math.floor(min_val), max: Math.floor(max_val) }
+            : { min: to_fixed2(min_val), max: to_fixed2(max_val) });
+    }
+    return ranges;
+};
+/** Create random sample object from configuration with arrays or space objects. */
+export const random_sample = (obj) => {
+    const sample_obj = {};
+    for (const key in obj) {
+        const value = obj[key];
+        if (Array.isArray(value)) {
+            sample_obj[key] = value[Math.floor(random_number(0, value.length))];
+        }
+        else if (is_space(value)) {
+            sample_obj[key] = random_number(value.min, value.max);
+        }
+        else {
+            sample_obj[key] = value;
+        }
+    }
+    return sample_obj;
+};
+/** Extract numeric value from string containing numbers. */
+export const extract_number = (value) => {
+    const numbers = value.match(/([+\-0-9\\.]+)/g);
+    if (!numbers)
+        return 0;
+    const values = numbers.map(Number).filter((v) => has_value(v));
+    return values.length === 1 ? values[0] : 0;
+};
+//# sourceMappingURL=number.js.map

package/dist/core/number.js.map

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

package/dist/core/obj.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Object manipulation utility functions.
+ * @module core/obj
+ */
+/** Create a new object by copying specified attributes from source object. */
+export declare const copy_obj: <T extends Record<string, unknown>>(obj: T, attrs: (keyof T)[]) => Partial<T>;
+/** Check if a value is a plain object (not null, not array). */
+export declare const is_object: (obj: unknown) => obj is Record<string, unknown>;
+//# sourceMappingURL=obj.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"obj.d.ts","sourceRoot":"","sources":["../../src/core/obj.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,KAAG,OAAO,CAAC,CAAC,CAIjG,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,SAAS,GAAI,KAAK,OAAO,KAAG,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAErE,CAAC"}

package/dist/core/obj.js

@@ -0,0 +1,15 @@
+/**
+ * Object manipulation utility functions.
+ * @module core/obj
+ */
+/** Create a new object by copying specified attributes from source object. */
+export const copy_obj = (obj, attrs) => {
+    const copied = {};
+    attrs.forEach((attr) => { copied[attr] = obj[attr]; });
+    return copied;
+};
+/** Check if a value is a plain object (not null, not array). */
+export const is_object = (obj) => {
+    return typeof obj === 'object' && obj !== null && !Array.isArray(obj);
+};
+//# sourceMappingURL=obj.js.map

package/dist/core/obj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"obj.js","sourceRoot":"","sources":["../../src/core/obj.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAoC,GAAM,EAAE,KAAkB,EAAc,EAAE;IAClG,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAY,EAAkC,EAAE;IACtE,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAC1E,CAAC,CAAC"}

package/dist/core/random.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Random generation utility functions.
+ * @module core/random
+ */
+/** Generate random 6-digit code. */
+export declare const random_code: () => number;
+//# sourceMappingURL=random.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/core/random.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oCAAoC;AACpC,eAAO,MAAM,WAAW,QAAO,MAA6C,CAAC"}

package/dist/core/random.js

@@ -0,0 +1,7 @@
+/**
+ * Random generation utility functions.
+ * @module core/random
+ */
+/** Generate random 6-digit code. */
+export const random_code = () => Math.floor(Math.random() * 1000000);
+//# sourceMappingURL=random.js.map

package/dist/core/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../../src/core/random.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oCAAoC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC"}

package/dist/core/role.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Role-based access control utility functions.
+ * @module core/role
+ */
+/** Session user data value types. */
+type SessionValue = string | number | boolean | null | undefined | SessionValue[] | {
+    [key: string]: SessionValue;
+};
+interface SessionUser {
+    role: string;
+    [key: string]: SessionValue;
+}
+interface SessionCookie {
+    session_id?: {
+        value: string;
+    };
+    [key: string]: SessionValue | {
+        value: string;
+    } | undefined;
+}
+interface MetaWithRoles {
+    mode: string;
+    roles?: string[];
+}
+/** Set the session store reference for role checking. */
+export declare const set_session_store: (store: Map<string, {
+    user?: SessionUser;
+}>) => void;
+/** Validate role name exists in settings configuration. */
+export declare const validate_meta_role: (role_name: string) => boolean;
+/** Check if role has root/admin privileges. */
+export declare const is_root_role: (role_name: string | null) => boolean;
+/** Get user object from session. */
+export declare const get_session_user: (cookie: SessionCookie) => SessionUser | null;
+/** Check if current user has root privileges. */
+export declare const is_root_user: (cookie: SessionCookie) => boolean;
+/** Get user's role permissions for a meta entity. Returns [mode, view] permissions. */
+export declare const get_user_role_right: (cookie: SessionCookie, meta: MetaWithRoles) => [string, string];
+/** Check if user has required mode permission on meta. */
+export declare const check_user_role: (cookie: SessionCookie, meta: MetaWithRoles, mode: string, view: string) => boolean;
+export {};
+//# sourceMappingURL=role.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../../src/core/role.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,qCAAqC;AACrC,KAAK,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAE,CAAC;AAEpH,UAAU,WAAW;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC;CAC/B;AAED,UAAU,aAAa;IACnB,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CAC/D;AAED,UAAU,aAAa;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAKD,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,GAAI,OAAO,GAAG,CAAC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC,KAAG,IAE9E,CAAC;AAQF,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,GAAI,WAAW,MAAM,KAAG,OAItD,CAAC;AAKF,+CAA+C;AAC/C,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,GAAG,IAAI,KAAG,OAIvD,CAAC;AAYF,oCAAoC;AACpC,eAAO,MAAM,gBAAgB,GAAI,QAAQ,aAAa,KAAG,WAAW,GAAG,IAMtE,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,YAAY,GAAI,QAAQ,aAAa,KAAG,OAAsD,CAAC;AAE5G,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,GAAI,QAAQ,aAAa,EAAE,MAAM,aAAa,KAAG,CAAC,MAAM,EAAE,MAAM,CAiB/F,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,eAAe,GAAI,QAAQ,aAAa,EAAE,MAAM,aAAa,EAAE,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,OAGxG,CAAC"}

package/dist/core/role.js

@@ -0,0 +1,81 @@
+/**
+ * Role-based access control utility functions.
+ * @module core/role
+ */
+import { get_settings } from '../setting.js';
+// In-memory session store reference (imported from session module at runtime)
+let session_store = null;
+/** Set the session store reference for role checking. */
+export const set_session_store = (store) => {
+    session_store = store;
+};
+/** Find a role by name from settings. */
+const find_role = (role_name) => {
+    const settings = get_settings();
+    return settings.roles ? settings.roles.find((role) => role.name === role_name) : undefined;
+};
+/** Validate role name exists in settings configuration. */
+export const validate_meta_role = (role_name) => {
+    const settings = get_settings();
+    if (!settings.roles)
+        return false;
+    return find_role(role_name) !== undefined;
+};
+/** Check if role name exists in settings. */
+const is_valid_role = (role_name) => find_role(role_name) !== undefined;
+/** Check if role has root/admin privileges. */
+export const is_root_role = (role_name) => {
+    if (!role_name)
+        return true;
+    const role = find_role(role_name);
+    return role ? role.root === true : true;
+};
+/** Get user role from session cookie. */
+const get_session_user_role = (cookie) => {
+    if (!session_store)
+        return null;
+    const session_id = cookie?.session_id?.value;
+    if (!session_id)
+        return null;
+    const session = session_store.get(session_id);
+    const user = session?.user;
+    return user ? user.role : null;
+};
+/** Get user object from session. */
+export const get_session_user = (cookie) => {
+    if (!session_store)
+        return null;
+    const session_id = cookie?.session_id?.value;
+    if (!session_id)
+        return null;
+    const session = session_store.get(session_id);
+    return session?.user ?? null;
+};
+/** Check if current user has root privileges. */
+export const is_root_user = (cookie) => is_root_role(get_session_user_role(cookie));
+/** Get user's role permissions for a meta entity. Returns [mode, view] permissions. */
+export const get_user_role_right = (cookie, meta) => {
+    const settings = get_settings();
+    if (!settings.roles || !meta.roles)
+        return [meta.mode, "*"];
+    const user_role = get_session_user_role(cookie);
+    if (!user_role)
+        return ["", ""];
+    if (!is_valid_role(user_role))
+        return ["", ""];
+    for (const role of meta.roles) {
+        const role_settings = role.split(":");
+        const [role_name, role_mode] = role_settings;
+        const role_view = role_settings.length === 3 ? role_settings[2] : "*";
+        if (user_role === role_name) {
+            return role_mode === "*" ? [meta.mode, role_view] : [role_mode, role_view];
+        }
+    }
+    return ["", ""];
+};
+/** Check if user has required mode permission on meta. */
+export const check_user_role = (cookie, meta, mode, view) => {
+    const [role_mode, role_view] = get_user_role_right(cookie, meta);
+    return role_mode.includes(mode) && (role_view === "*" || role_view.includes(view));
+};
+//# sourceMappingURL=role.js.map

package/dist/core/role.js.map

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

package/dist/core/thread.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Threading and async utility functions.
+ * @module core/thread
+ */
+/** Sleep for specified milliseconds using Bun's native sleep. */
+export declare const snooze: (ms: number) => Promise<void>;
+//# sourceMappingURL=thread.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/core/thread.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iEAAiE;AACjE,eAAO,MAAM,MAAM,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CAAkB,CAAC"}

package/dist/core/thread.js

@@ -0,0 +1,7 @@
+/**
+ * Threading and async utility functions.
+ * @module core/thread
+ */
+/** Sleep for specified milliseconds using Bun's native sleep. */
+export const snooze = (ms) => Bun.sleep(ms);
+//# sourceMappingURL=thread.js.map

package/dist/core/thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.js","sourceRoot":"","sources":["../../src/core/thread.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iEAAiE;AACjE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,EAAU,EAAiB,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC"}

package/dist/core/type.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Type conversion and validation system.
+ * @module core/type
+ */
+import type { FieldValue } from "./meta.js";
+export interface TypeResult<T = unknown> {
+    value?: T;
+    err?: string;
+}
+export interface TypeDefinition {
+    name: string;
+    convert: (value: unknown) => TypeResult;
+}
+export interface Field {
+    name: string;
+    type?: string;
+    default?: FieldValue;
+}
+/** Create success result. */
+export declare const ok: <T>(value: T) => TypeResult<T>;
+/** Create error result. */
+export declare const err: (type: string, value: unknown) => TypeResult;
+/** Check if value is an integer. */
+export declare const is_int: (value: unknown) => boolean;
+/** Create a regex validation type. */
+export declare const regex_type: (name: string, pattern: RegExp) => TypeDefinition;
+/** Create an integer enum validation type. */
+export declare const int_enum_type: (name: string, valid_values: number[]) => TypeDefinition;
+/** Create an integer range validation type. */
+export declare const int_range_type: (name: string, min: number, max: number) => TypeDefinition;
+/** Create a passthrough string type. */
+export declare const string_type: (name: string) => TypeDefinition;
+/** Register a custom type with conversion function. */
+export declare const register_type: (type: TypeDefinition) => void;
+/** Get registered type by name. */
+export declare const get_type: (name: string) => TypeDefinition;
+interface ConvertResult {
+    obj: Record<string, FieldValue>;
+    error_field_names: string[];
+}
+/** Convert object fields to their defined types. */
+export declare const convert_type: (obj: Record<string, unknown>, fields: Field[]) => ConvertResult;
+/** Convert object fields for update operation (preserves empty values). */
+export declare const convert_update_type: (obj: Record<string, unknown>, fields: Field[]) => ConvertResult;
+export {};
+//# sourceMappingURL=type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../src/core/type.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,UAAU,CAAC;CACzC;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAQD,6BAA6B;AAC7B,eAAO,MAAM,EAAE,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,UAAU,CAAC,CAAC,CAAgB,CAAC;AAE9D,2BAA2B;AAC3B,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,EAAE,OAAO,OAAO,KAAG,UAAmD,CAAC;AAWvG,oCAAoC;AACpC,eAAO,MAAM,MAAM,GAAI,OAAO,OAAO,KAAG,OAAgE,CAAC;AAEzG,sCAAsC;AACtC,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,KAAG,cAAuH,CAAC;AAEnL,8CAA8C;AAC9C,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,cAAc,MAAM,EAAE,KAAG,cAOnE,CAAC;AAEH,+CAA+C;AAC/C,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,cAOtE,CAAC;AAEH,wCAAwC;AACxC,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,cAAyE,CAAC;AAMrH,uDAAuD;AACvD,eAAO,MAAM,aAAa,GAAI,MAAM,cAAc,KAAG,IAEpD,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,cAIvC,CAAC;AAuNF,UAAU,aAAa;IACrB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AA+BD,oDAAoD;AACpD,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,KAAK,EAAE,KAAG,aAAmD,CAAC;AAEjI,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,KAAK,EAAE,KAAG,aAAkD,CAAC"}