hola-server 1.0.11 → 3.0.0

package/dist/core/meta.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Meta programming core - Entity definition and validation.
+ * @module core/meta
+ */
+import { ObjectId } from "mongodb";
+import type { Elysia } from "elysia";
+import type { JwtPayload } from "../plugins/auth.js";
+/** Field value types for entity data. */
+export type FieldValue = string | number | boolean | null | undefined | Date | FieldValue[] | {
+    [key: string]: FieldValue;
+};
+/** Query/filter value types (includes ObjectId for MongoDB queries). */
+export type QueryValue = string | number | boolean | null | undefined | Date | RegExp | ObjectId | QueryValue[] | {
+    [key: string]: QueryValue;
+};
+/** Auth context type for route handlers (user from derive plugin) */
+export interface AuthContext {
+    user: JwtPayload | null;
+    params: Record<string, string>;
+    query: Record<string, string>;
+    body: unknown;
+}
+/** Router type alias - use AuthContext for handler typing */
+export type AuthRouter = Elysia<any>;
+export interface FieldDefinition {
+    name: string;
+    type?: string;
+    required?: boolean;
+    default?: FieldValue;
+    ref?: string;
+    link?: string;
+    delete?: "keep" | "cascade";
+    create?: boolean;
+    list?: boolean;
+    search?: boolean;
+    update?: boolean;
+    clone?: boolean;
+    sys?: boolean;
+    secure?: boolean;
+    view?: string;
+    role?: string | string[];
+}
+export interface MetaDefinition {
+    collection: string;
+    roles?: string[];
+    primary_keys: string[];
+    fields: FieldDefinition[];
+    creatable?: boolean;
+    readable?: boolean;
+    updatable?: boolean;
+    deleteable?: boolean;
+    cloneable?: boolean;
+    importable?: boolean;
+    exportable?: boolean;
+    ref_label?: string;
+    ref_filter?: Record<string, QueryValue>;
+    user_field?: string;
+    after_read?: AfterReadCallback;
+    list_query?: ListQueryCallback;
+    before_create?: BeforeCreateCallback;
+    before_clone?: BeforeCloneCallback;
+    before_update?: BeforeUpdateCallback;
+    before_delete?: BeforeDeleteCallback;
+    after_create?: AfterCreateCallback;
+    after_clone?: AfterCloneCallback;
+    after_update?: AfterUpdateCallback;
+    after_delete?: AfterDeleteCallback;
+    create?: CreateCallback;
+    clone?: CloneCallback;
+    update?: UpdateCallback;
+    batch_update?: BatchUpdateCallback;
+    after_batch_update?: AfterBatchUpdateCallback;
+    delete?: DeleteCallback;
+    route?: (router: AuthRouter, meta: EntityMeta) => void;
+}
+type EntityRef = any;
+/** Hook result type */
+export interface HookResult {
+    code: number;
+    err?: string | string[];
+}
+/** Context for create/after_create hooks */
+export interface CreateHookContext {
+    entity: EntityRef;
+    data: Record<string, FieldValue>;
+}
+/** Context for clone/before_clone/after_clone hooks */
+export interface CloneHookContext {
+    id: string;
+    entity: EntityRef;
+    data: Record<string, FieldValue>;
+}
+/** Context for update/before_update/after_update hooks */
+export interface UpdateHookContext {
+    id: string | null;
+    entity: EntityRef;
+    data: Record<string, FieldValue>;
+}
+/** Context for batch_update/after_batch_update hooks */
+export interface BatchUpdateHookContext {
+    ids: string[];
+    entity: EntityRef;
+    data: Record<string, FieldValue>;
+}
+/** Context for delete/before_delete/after_delete hooks */
+export interface DeleteHookContext {
+    entity: EntityRef;
+    ids: string[];
+}
+/** Context for after_read hook */
+export interface AfterReadHookContext {
+    id: string;
+    entity: EntityRef;
+    attrNames: string;
+    result: Record<string, FieldValue>;
+}
+/** Context for list_query hook */
+export interface ListQueryHookContext {
+    entity: EntityRef;
+    query: Record<string, QueryValue>;
+}
+export type BeforeCreateCallback = (ctx: CreateHookContext) => Promise<HookResult> | HookResult;
+export type AfterCreateCallback = (ctx: CreateHookContext) => Promise<HookResult> | HookResult;
+export type CreateCallback = (ctx: CreateHookContext) => Promise<HookResult> | HookResult;
+export type BeforeCloneCallback = (ctx: CloneHookContext) => Promise<HookResult> | HookResult;
+export type AfterCloneCallback = (ctx: CloneHookContext) => Promise<HookResult> | HookResult;
+export type CloneCallback = (ctx: CloneHookContext) => Promise<HookResult> | HookResult;
+export type BeforeUpdateCallback = (ctx: UpdateHookContext) => Promise<HookResult> | HookResult;
+export type AfterUpdateCallback = (ctx: UpdateHookContext) => Promise<HookResult> | HookResult;
+export type UpdateCallback = (ctx: UpdateHookContext) => Promise<HookResult> | HookResult;
+export type BatchUpdateCallback = (ctx: BatchUpdateHookContext) => Promise<HookResult> | HookResult;
+export type AfterBatchUpdateCallback = (ctx: BatchUpdateHookContext) => Promise<HookResult> | HookResult;
+export type BeforeDeleteCallback = (ctx: DeleteHookContext) => Promise<HookResult> | HookResult;
+export type AfterDeleteCallback = (ctx: DeleteHookContext) => Promise<HookResult> | HookResult;
+export type DeleteCallback = (ctx: DeleteHookContext) => Promise<HookResult> | HookResult;
+export type AfterReadCallback = (ctx: AfterReadHookContext) => Promise<HookResult> | HookResult;
+export type ListQueryCallback = (ctx: ListQueryHookContext) => Promise<HookResult> | HookResult;
+/** Union of all callback types for dynamic callback handling. */
+export type AnyCallback = BeforeCreateCallback | AfterCreateCallback | CreateCallback | BeforeCloneCallback | AfterCloneCallback | CloneCallback | BeforeUpdateCallback | AfterUpdateCallback | UpdateCallback | BatchUpdateCallback | AfterBatchUpdateCallback | BeforeDeleteCallback | AfterDeleteCallback | DeleteCallback | AfterReadCallback | ListQueryCallback;
+export declare const DELETE_MODE: Readonly<{
+    all: readonly ["keep", "cascade"];
+    keep: "keep";
+    cascade: "cascade";
+}>;
+/** Filter fields by user role permission. */
+export declare const filter_fields_by_role: (fields: FieldDefinition[], user_role: string | null) => FieldDefinition[];
+/** Validate all registered metas after loading. */
+export declare const validate_all_metas: () => void;
+/** Get entity meta by collection name. */
+export declare const get_entity_meta: (collection: string) => EntityMeta | undefined;
+/** Get all registered meta collection names. */
+export declare const get_all_metas: () => string[];
+/** Entity Meta wrapper class. Validates meta structure and sets default values. */
+export declare class EntityMeta {
+    meta: MetaDefinition;
+    collection: string;
+    roles?: string[];
+    primary_keys: string[];
+    user_field?: string;
+    ref_label?: string;
+    ref_filter?: Record<string, QueryValue>;
+    creatable: boolean;
+    readable: boolean;
+    updatable: boolean;
+    deleteable: boolean;
+    cloneable: boolean;
+    importable: boolean;
+    exportable: boolean;
+    editable: boolean;
+    mode: string;
+    fields: FieldDefinition[];
+    fields_map: Record<string, FieldDefinition>;
+    field_names: string[];
+    client_fields: FieldDefinition[];
+    property_fields: FieldDefinition[];
+    create_fields: FieldDefinition[];
+    update_fields: FieldDefinition[];
+    search_fields: FieldDefinition[];
+    clone_fields: FieldDefinition[];
+    list_fields: FieldDefinition[];
+    primary_key_fields: FieldDefinition[];
+    required_field_names: string[];
+    file_fields: FieldDefinition[];
+    upload_fields: {
+        name: string;
+    }[];
+    ref_fields: FieldDefinition[];
+    link_fields: FieldDefinition[];
+    ref_by_metas: EntityMeta[];
+    constructor(meta: MetaDefinition);
+    private _init_field_subsets;
+    validate_meta_info(): boolean;
+    private _validate_primary_keys;
+    /** Get mode for a specific user role. Returns entity mode if no roles defined, or role-specific mode. */
+    get_role_mode(user_role: string | null | undefined): string;
+    private _validate_field_exists;
+    private _validate_roles;
+}
+export {};
+//# sourceMappingURL=meta.d.ts.map

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

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

package/dist/core/meta.js

@@ -0,0 +1,336 @@
+/**
+ * Meta programming core - Entity definition and validation.
+ * @module core/meta
+ */
+import { get_type } from "./type.js";
+import { validate_meta_role } from "./role.js";
+const meta_manager = {};
+const FIELD_ATTRS = ["name", "type", "required", "default", "ref", "link", "delete", "create", "list", "search", "update", "clone", "sys", "secure", "view", "role"];
+const LINK_FIELD_ATTRS = ["name", "link", "list"];
+const CALLBACK_NAMES = ["after_read", "list_query", "before_create", "before_clone", "before_update", "before_delete", "after_create", "after_clone", "after_update", "after_delete", "create", "clone", "update", "batch_update", "after_batch_update", "delete"];
+const OPERATION_FLAGS = ["creatable", "readable", "updatable", "deleteable", "cloneable", "importable", "exportable"];
+const MODE_MAP = { creatable: "c", readable: "rs", updatable: "u", deleteable: "db", cloneable: "o", importable: "i", exportable: "e" };
+const META_ATTRS = ["collection", "roles", "primary_keys", "fields", ...OPERATION_FLAGS, ...CALLBACK_NAMES, "ref_label", "ref_filter", "user_field", "route"];
+export const DELETE_MODE = Object.freeze({ all: ["keep", "cascade"], keep: "keep", cascade: "cascade" });
+/** Filter fields by user role permission. */
+export const filter_fields_by_role = (fields, user_role) => {
+    if (!user_role || user_role === "*")
+        return fields;
+    return fields.filter((field) => {
+        const fr = field.role;
+        if (Array.isArray(fr))
+            return fr.includes("*") || fr.some((r) => user_role.includes(r));
+        if (typeof fr === "string")
+            return fr === "*" || user_role.includes(fr);
+        return true; // No role restriction = visible to all
+    });
+};
+/** Convert fields array to name-keyed map. */
+const to_fields_map = (fields) => {
+    return fields.reduce((m, f) => {
+        m[f.name] = f;
+        return m;
+    }, {});
+};
+/** Format error message with meta context. */
+const meta_error = (collection, msg, field = null) => {
+    const prefix = field ? `meta:${collection},field:${field.name}` : `meta:${collection}`;
+    return new Error(`${prefix} ${msg}`);
+};
+/** Validate and normalize field definition. */
+const validate_field = (meta, field) => {
+    if (!field.name)
+        throw meta_error(meta.collection, `name attr required for field:${JSON.stringify(field)}`);
+    if (field.type)
+        get_type(field.type);
+    else if (!field.link)
+        field.type = "string";
+    if (meta.primary_keys.includes(field.name))
+        field.required = true;
+    // user_field is system-managed - users cannot create, update, or clone it
+    if (meta.user_field === field.name) {
+        if (field.create === true)
+            throw meta_error(meta.collection, `user_field cannot have create:true`, field);
+        if (field.update === true)
+            throw meta_error(meta.collection, `user_field cannot have update:true`, field);
+        if (field.clone === true)
+            throw meta_error(meta.collection, `user_field cannot have clone:true`, field);
+        // default to false if not specified
+        if (field.create === undefined)
+            field.create = false;
+        if (field.update === undefined)
+            field.update = false;
+        if (field.clone === undefined)
+            field.clone = false;
+        // search and list default to false, but can be explicitly enabled
+        if (field.search === undefined)
+            field.search = false;
+        if (field.list === undefined)
+            field.list = false;
+    }
+    // sys fields are system-managed - users cannot create, update, or clone them
+    if (field.sys === true) {
+        if (field.create === true)
+            throw meta_error(meta.collection, `sys field cannot have create:true`, field);
+        if (field.update === true)
+            throw meta_error(meta.collection, `sys field cannot have update:true`, field);
+        if (field.clone === true)
+            throw meta_error(meta.collection, `sys field cannot have clone:true`, field);
+        // default to false if not specified
+        if (field.create === undefined)
+            field.create = false;
+        if (field.update === undefined)
+            field.update = false;
+        if (field.clone === undefined)
+            field.clone = false;
+        // search and list default to false, but can be explicitly enabled
+        if (field.search === undefined)
+            field.search = false;
+        if (field.list === undefined)
+            field.list = false;
+    }
+    // secure fields (e.g., passwords) cannot be listed or searched
+    if (field.secure === true) {
+        if (field.list === true)
+            throw meta_error(meta.collection, `secure field cannot have list:true`, field);
+        if (field.search === true)
+            throw meta_error(meta.collection, `secure field cannot have search:true`, field);
+        // default to false if not specified
+        if (field.list === undefined)
+            field.list = false;
+        if (field.search === undefined)
+            field.search = false;
+    }
+    if (field.default !== undefined && field.type) {
+        const type = get_type(field.type);
+        const result = type.convert(field.default);
+        if (result.err)
+            throw meta_error(meta.collection, `invalid default value [${field.default}] for type [${field.type}]`, field);
+    }
+    if (field.ref && !field.link) {
+        const ref_meta = meta_manager[field.ref];
+        if (!ref_meta)
+            throw meta_error(meta.collection, `refers invalid meta:${field.ref}`, field);
+        if (!ref_meta.ref_label)
+            throw meta_error(meta.collection, `refers meta:${field.ref} without ref_label`, field);
+        const ref_by_collections = ref_meta.ref_by_metas.map((m) => m.collection);
+        if (!ref_by_collections.includes(meta.collection))
+            ref_meta.ref_by_metas.push(meta_manager[meta.collection]);
+    }
+    if (field.delete) {
+        if (!field.ref)
+            throw meta_error(meta.collection, `delete not allowed on non-ref field`, field);
+        if (!DELETE_MODE.all.includes(field.delete))
+            throw meta_error(meta.collection, `invalid delete:${field.delete}, valid:${JSON.stringify(DELETE_MODE.all)}`, field);
+    }
+    if (field.link) {
+        const invalid_keys = Object.keys(field).filter((k) => !LINK_FIELD_ATTRS.includes(k));
+        if (invalid_keys.length)
+            throw meta_error(meta.collection, `Link field only supports ${LINK_FIELD_ATTRS.join(",")}. Unsupported:${invalid_keys.join(",")}`);
+    }
+    const invalid_attrs = Object.keys(field).filter((k) => !FIELD_ATTRS.includes(k));
+    if (invalid_attrs.length)
+        throw meta_error(meta.collection, `Unsupported attribute [${invalid_attrs.join(",")}] for field:${JSON.stringify(field)}`);
+};
+/** Validate all fields in meta definition. */
+const validate_fields = (meta, fields) => {
+    const fields_map = to_fields_map(fields);
+    const seen_names = new Set();
+    for (const field of fields) {
+        validate_field(meta, field);
+        if (seen_names.has(field.name))
+            throw meta_error(meta.collection, `Duplicate field [${JSON.stringify(field)}]`);
+        seen_names.add(field.name);
+        if (field.link) {
+            const link_field = fields_map[field.link];
+            if (!link_field)
+                throw meta_error(meta.collection, `link field [${JSON.stringify(field)}] should link to field`);
+            if (!link_field.ref)
+                throw meta_error(meta.collection, `link field [${JSON.stringify(field)}] target [${JSON.stringify(link_field)}] must ref entity`);
+            const entity = get_entity_meta(link_field.ref);
+            if (!entity)
+                throw meta_error(meta.collection, `link target entity not found: ${link_field.ref}`);
+            const link_entity_field = entity.fields_map[field.name];
+            if (!link_entity_field)
+                throw meta_error(entity.collection, `link field [${JSON.stringify(field)}] should link to field`);
+            Object.assign(field, { type: link_entity_field.type, required: false, create: false, search: false, update: false, clone: false, delete: "cascade" });
+            if (link_entity_field.ref)
+                field.ref = link_entity_field.ref;
+        }
+    }
+    return true;
+};
+/** Validate all registered metas after loading. */
+export const validate_all_metas = () => {
+    Object.values(meta_manager).forEach((m) => m.validate_meta_info());
+};
+/** Set callback function on entity meta. */
+const set_callback = (entity_meta, cb_name, cb) => {
+    if (!cb)
+        return;
+    if (!(cb instanceof Function))
+        throw new Error(`callback [${cb_name}] for meta:${entity_meta.collection} isn't function`);
+    entity_meta[cb_name] = cb;
+};
+/** Get entity meta by collection name. */
+export const get_entity_meta = (collection) => meta_manager[collection];
+/** Get all registered meta collection names. */
+export const get_all_metas = () => Object.keys(meta_manager);
+/** Entity Meta wrapper class. Validates meta structure and sets default values. */
+export class EntityMeta {
+    meta;
+    collection;
+    roles;
+    primary_keys;
+    user_field;
+    ref_label;
+    ref_filter;
+    creatable;
+    readable;
+    updatable;
+    deleteable;
+    cloneable;
+    importable;
+    exportable;
+    editable;
+    mode;
+    fields;
+    fields_map;
+    field_names;
+    client_fields;
+    property_fields;
+    create_fields;
+    update_fields;
+    search_fields;
+    clone_fields;
+    list_fields;
+    primary_key_fields;
+    required_field_names;
+    file_fields;
+    upload_fields;
+    ref_fields;
+    link_fields;
+    ref_by_metas;
+    constructor(meta) {
+        this.meta = meta;
+        this.collection = meta.collection;
+        this.roles = meta.roles;
+        this.primary_keys = meta.primary_keys;
+        this.user_field = meta.user_field;
+        this.ref_label = meta.ref_label;
+        this.ref_filter = meta.ref_filter;
+        this.creatable = meta.creatable ?? false;
+        this.readable = meta.readable ?? false;
+        this.updatable = meta.updatable ?? false;
+        this.deleteable = meta.deleteable ?? false;
+        this.cloneable = meta.cloneable ?? false;
+        this.importable = meta.importable ?? false;
+        this.exportable = meta.exportable ?? false;
+        this.editable = this.creatable || this.updatable;
+        this.mode = OPERATION_FLAGS.filter((f) => this[f])
+            .map((f) => MODE_MAP[f])
+            .join("");
+        this.fields = meta.fields;
+        this.fields_map = to_fields_map(meta.fields);
+        this.field_names = this.fields.map((f) => f.name);
+        this._init_field_subsets(meta);
+        this.ref_fields = this.fields.filter((f) => f.ref);
+        this.link_fields = this.fields.filter((f) => f.link);
+        this.ref_by_metas = [];
+        CALLBACK_NAMES.forEach((cb) => set_callback(this, cb, meta[cb]));
+        if (meta_manager[meta.collection])
+            throw new Error(`Duplicate meta info:${this.collection}`);
+        meta_manager[meta.collection] = this;
+    }
+    _init_field_subsets(meta) {
+        // Sys fields are visible to client only if they explicitly opt-in with list: true or search: true
+        const client_visible = (f) => f.sys !== true || f.list === true || f.search === true;
+        const not_secure = (f) => f.secure !== true;
+        this.client_fields = this.fields.filter(client_visible);
+        // Property fields filter by list !== false to prevent client from reading hidden fields
+        this.property_fields = this.fields.filter((f) => f.list !== false && not_secure(f));
+        // Note: create_fields, update_fields, clone_fields do NOT filter by sys
+        // Sys fields have create/update/clone: false which prevents client input,
+        // but server-side hooks can still set these values
+        this.create_fields = this.fields.filter((f) => f.create !== false);
+        this.update_fields = this.fields.filter((f) => f.create !== false && f.update !== false);
+        this.search_fields = this.fields.filter((f) => f.search !== false);
+        this.clone_fields = this.fields.filter((f) => f.clone !== false);
+        this.list_fields = this.fields.filter((f) => f.list !== false && not_secure(f));
+        this.primary_key_fields = this.fields.filter((f) => meta.primary_keys.includes(f.name));
+        this.required_field_names = this.fields.filter((f) => f.required === true || this.primary_keys.includes(f.name)).map((f) => f.name);
+        this.file_fields = this.fields.filter((f) => f.type === "file");
+        this.upload_fields = this.file_fields.map((f) => ({ name: f.name }));
+    }
+    validate_meta_info() {
+        if (!this.collection)
+            throw new Error(`no collection defined for meta:${JSON.stringify(this.meta)}`);
+        const invalid_attrs = Object.keys(this.meta).filter((k) => !META_ATTRS.includes(k));
+        if (invalid_attrs.length)
+            throw meta_error(this.collection, `Unsupported attribute [${invalid_attrs.join(",")}]`);
+        this._validate_primary_keys();
+        this._validate_roles();
+        this._validate_field_exists("ref_label", this.ref_label);
+        this._validate_field_exists("user_field", this.user_field);
+        if (this.ref_filter && this.ref_filter.constructor !== Object) {
+            throw meta_error(this.collection, `ref_filter should be object`);
+        }
+        const result = validate_fields(this.meta, this.fields);
+        // Re-init field subsets after validation sets defaults for sys/secure fields
+        this._init_field_subsets(this.meta);
+        return result;
+    }
+    _validate_primary_keys() {
+        if (!this.primary_keys)
+            throw meta_error(this.collection, `no primary_keys defined`);
+        if (!Array.isArray(this.primary_keys))
+            throw meta_error(this.collection, `primary_keys should be array`);
+        for (const key of this.primary_keys) {
+            if (!this.field_names.includes(key))
+                throw meta_error(this.collection, `wrong primary_key ${key}`);
+        }
+    }
+    /** Get mode for a specific user role. Returns entity mode if no roles defined, or role-specific mode. */
+    get_role_mode(user_role) {
+        // No role control defined - return full entity mode
+        if (!this.roles)
+            return this.mode;
+        // User not authenticated - return empty mode
+        if (!user_role)
+            return "";
+        for (const role of this.roles) {
+            const [role_name, role_mode] = role.split(":");
+            if (role_name === user_role) {
+                return role_mode === "*" ? this.mode : role_mode;
+            }
+        }
+        return "";
+    }
+    _validate_field_exists(attr_name, value) {
+        if (value && !this.field_names.includes(value)) {
+            throw meta_error(this.collection, `${attr_name} [${value}] not found in fields`);
+        }
+    }
+    _validate_roles() {
+        if (!this.roles)
+            return;
+        if (!Array.isArray(this.roles))
+            throw meta_error(this.collection, `roles should be array`);
+        for (const role of this.roles) {
+            const parts = role.split(":");
+            if (parts.length < 2 || parts.length > 3) {
+                throw meta_error(this.collection, `wrong role config [${role}]. Use : to separate role name with mode.`);
+            }
+            const [role_name, role_mode] = parts;
+            if (!validate_meta_role(role_name))
+                throw meta_error(this.collection, `role [${role_name}] not defined in settings`);
+            if (role_mode !== "*") {
+                for (const mode of role_mode) {
+                    if (!this.mode.includes(mode))
+                        throw meta_error(this.collection, `role [${role_name}] mode [${mode}] doesn't match entity mode [${this.mode}]`);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=meta.js.map

package/dist/core/meta.js.map

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

package/dist/core/number.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Number manipulation and mathematical utility functions.
+ * @module core/number
+ */
+export interface Space {
+    min: number;
+    max: number;
+}
+/** Parse string value to number, returns 0 if invalid. */
+export declare const parse_num: (str: string | number) => number;
+/** Parse string value to number with 2 decimal places. */
+export declare const to_fixed2: (str: string | number) => number;
+/** Round number to 2 decimal places. */
+export declare const round_to_fixed2: (num: number) => number;
+/** Generate range array. Example: range(3) = [0,1,2], range(1,5) = [1,2,3,4,5] */
+export declare const range: (start: number, end?: number, step?: number) => number[];
+/** Generate scale array with exponential growth. Example: scale(2,10) = [2,4,8] */
+export declare const scale: (start: number, end: number, ratio?: number) => number[];
+/** Create a space object representing a min-max range. */
+export declare const space: (min: number, max: number) => Space;
+/** Check if value is a space object (has min and max properties). */
+export declare const is_space: (value: unknown) => value is Space;
+/** Check if value is an integer. */
+export declare const is_integer: (value: unknown) => boolean;
+/** Sample configuration value types. */
+export type SampleValue = string | number | boolean | Space | SampleValue[];
+/** Check if object contains any space objects as property values. */
+export declare const contains_space: (obj: Record<string, SampleValue>) => boolean;
+/** Generate random number between min and max. */
+export declare const random_number: (min: number, max: number) => number;
+/** Generate Latin Hypercube Sampling ranges for a given range. */
+export declare const lhs_samples: (min: number, max: number, n: number) => Space[];
+/** Create random sample object from configuration with arrays or space objects. */
+export declare const random_sample: (obj: Record<string, SampleValue>) => Record<string, string | number | boolean>;
+/** Extract numeric value from string containing numbers. */
+export declare const extract_number: (value: string) => number;
+//# sourceMappingURL=number.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../src/core/number.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,KAAK;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACf;AAED,0DAA0D;AAC1D,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,GAAG,MAAM,KAAG,MAGhD,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,GAAG,MAAM,KAAG,MAGhD,CAAC;AAEF,wCAAwC;AACxC,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,MAAqC,CAAC;AAEpF,kFAAkF;AAClF,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,EAAE,MAAM,MAAM,EAAE,OAAM,MAAU,KAAG,MAAM,EAG3E,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,EAAE,QAAO,MAAU,KAAG,MAAM,EAG3E,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,KAAK,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,KAGhD,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,KAIlD,CAAC;AAEF,oCAAoC;AACpC,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,OAA2C,CAAC;AAExF,wCAAwC;AACxC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,WAAW,EAAE,CAAC;AAE5E,qEAAqE;AACrE,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,KAAG,OAKjE,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,MAGxD,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,EAAE,GAAG,MAAM,KAAG,KAAK,EAiBtE,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAaxG,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAK9C,CAAC"}