hola-server 2.0.1 → 3.0.0

package/README.md

@@ -1,196 +1,382 @@
 # Hola Server
 
-A meta-programming framework for building Node.js RESTful APIs with MongoDB. Hola Server provides a declarative, metadata-driven approach to building CRUD APIs with built-in authentication, role-based access control, and file handling.
-
-## Features
-
-- **Meta-Driven CRUD**: Define entity schemas with metadata and get full CRUD APIs automatically
-- **Role-Based Access Control**: Fine-grained permissions per entity, operation, and view
-- **Type System**: Extensible type conversion and validation system
-- **File Handling**: Built-in GridFS integration for file uploads
-- **Session Management**: Express session with MongoDB store
-- **Entity Relationships**: Support for references with cascade/keep delete behavior
-- **Query Building**: Advanced search, filtering, and pagination
-- **Async Context**: Request-scoped context using AsyncLocalStorage
-- **Comprehensive Testing**: Full test suite with 111+ passing tests
-
-## Installation
+A meta-programming framework for building RESTful APIs with **Bun + Elysia + MongoDB**. Define entity schemas declaratively and get fully-featured CRUD APIs with built-in authentication, role-based access control, file handling, and vector search — all out of the box.
+
+## ✨ Features
+
+- **Meta-Driven CRUD** — Define entity schemas with metadata, get full RESTful APIs automatically
+- **Role-Based Access Control** — Fine-grained permissions per entity and operation (`admin:*`, `user:r`, `editor:cru`)
+- **JWT Authentication** — Access + refresh token flow with hybrid delivery (cookies & Authorization header)
+- **Type System** — 20+ built-in types with extensible validation and conversion
+- **Schema Validation** — Auto-generated TypeBox schemas for request body validation
+- **File Handling** — Built-in GridFS integration for file uploads and streaming
+- **Vector Search** — SQLite-based vector similarity search via `sqlite-vec` for AI applications
+- **Entity Relationships** — References with cascade/keep delete behavior and ref validation
+- **Lifecycle Hooks** — Before/after hooks for create, update, clone, delete, and read operations
+- **Query Building** — Advanced search, filtering, comparison operators, and pagination
+- **Environment Config** — Configuration loader with environment-specific files (dev/test/prod)
+- **Comprehensive Testing** — 25 test files covering core, database, entity, and cleanup
+
+## 📦 Tech Stack
+
+| Layer | Technology |
+|-------|-----------|
+| Runtime | [Bun](https://bun.sh) |
+| HTTP Framework | [Elysia](https://elysiajs.com) v1.2+ |
+| Database | [MongoDB](https://www.mongodb.com) 6.x |
+| File Storage | MongoDB GridFS |
+| Vector Search | [sqlite-vec](https://github.com/asg017/sqlite-vec) + better-sqlite3 |
+| Auth | [@elysiajs/jwt](https://www.npmjs.com/package/@elysiajs/jwt) |
+| Language | TypeScript 5.7+ |
+
+## 🚀 Quick Start
+
+### Installation
 
 ```bash
-npm install
+bun install
 ```
 
-## Quick Start
-
-### 1. Configure Settings
+### 1. Define an Entity
 
-```javascript
-const { init_settings } = require("hola-server");
-
-init_settings({
-  mongo: {
-    url: "mongodb://localhost/myapp",
-    pool: 10,
-  },
-  server: {
-    service_port: 8088,
-    client_web_url: ["http://localhost:3000"],
-    session: {
-      secret: "your-secret-key",
-      cookie_max_age: 86400000, // 1 day
-    },
-  },
-  roles: [{ name: "admin", root: true }, { name: "user" }],
-});
-```
+```typescript
+import { init_router } from "hola-server";
 
-### 2. Define Entity Metadata
+export const userRouter = init_router({
+  collection: "user",
+  primary_keys: ["email"],
+  ref_label: "name",
 
-```javascript
-const { EntityMeta } = require("hola-server");
+  creatable: true,
+  readable: true,
+  updatable: true,
+  deleteable: true,
 
-const user_meta = {
-  collection: "user",
-  mode: "crud",
   fields: [
     { name: "name", type: "string", required: true },
-    { name: "email", type: "string", required: true, primary: true },
+    { name: "email", type: "string", required: true },
     { name: "age", type: "uint" },
-    { name: "role", type: "obj", ref: "role" },
+    { name: "role", ref: "role" },
+    { name: "avatar", type: "file" },
   ],
-  roles: ["admin:crud:*", "user:r:*"],
-};
+
+  roles: ["admin:*", "user:r", "editor:cru"],
+});
 ```
 
-### 3. Create Router
+### 2. Start the Server
+
+```typescript
+import { Elysia } from "elysia";
+import { plugins, db, meta } from "hola-server";
+import { userRouter } from "./router/user.js";
+
+const app = new Elysia()
+  .use(plugins.holaCors({ origin: ["http://localhost:5173"] }))
+  .use(plugins.holaBody({ limit: "10mb" }))
+  .use(plugins.holaAuth({ secret: process.env.JWT_SECRET! }))
+  .use(plugins.holaError())
+  .use(userRouter)
+  .onStart(async () => {
+    await db.get_db();
+    meta.validate_all_metas();
+    console.log("✓ Server ready on port 3000");
+  })
+  .listen(3000);
+```
 
-```javascript
-const { init_router } = require("hola-server");
+## 📡 API Endpoints
+
+Each entity router automatically generates these endpoints:
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `GET` | `/{entity}` | Simple list with query params |
+| `POST` | `/{entity}/list` | List entities (full query: filter, sort, paginate) |
+| `GET` | `/{entity}/:id` | Get single entity by ID |
+| `POST` | `/{entity}` | Create entity |
+| `PUT` | `/{entity}/:id` | Update entity |
+| `DELETE` | `/{entity}/:id` | Delete entity |
+| `GET` | `/{entity}/meta` | Get entity metadata and permissions |
+| `GET` | `/{entity}/ref` | Get reference labels |
+| `POST` | `/{entity}/:id/clone` | Clone entity (if cloneable) |
+
+## 🏗 Entity Metadata
+
+### Field Definition
+
+```typescript
+interface FieldDefinition {
+  name: string;        // Field name
+  type?: string;       // Type for validation/conversion (default: "string")
+  required?: boolean;  // Required on create
+  default?: FieldValue;// Default value
+  ref?: string;        // Reference to another entity (collection name)
+  link?: string;       // Link to another entity
+  delete?: "keep" | "cascade"; // Ref delete behavior
+  create?: boolean;    // Include in create operation
+  list?: boolean;      // Include in list response
+  search?: boolean;    // Enable as search field
+  update?: boolean;    // Include in update operation
+  clone?: boolean;     // Include in clone operation
+  sys?: boolean;       // System field (auto-managed)
+  secure?: boolean;    // Exclude from client responses
+  view?: string;       // View-based visibility
+  role?: string | string[]; // Role-based field visibility
+}
+```
 
-const router = init_router(user_meta);
-module.exports = router;
+### Built-in Types
+
+| Category | Types |
+|----------|-------|
+| **String** | `string`, `lstr`, `text`, `enum`, `email`, `url`, `ip` |
+| **Numeric** | `number`, `int`, `uint`, `float`, `ufloat`, `decimal`, `percentage`, `currency` |
+| **Boolean** | `boolean` |
+| **Date/Time** | `date`, `datetime` |
+| **Security** | `password` (bcrypt hashed), `secret` (AES-256 encrypted) |
+| **Other** | `file`, `array`, `obj`, `json`, `log_category` |
+
+Custom types can be registered via `register_type()`.
+
+### Operation Flags
+
+```typescript
+{
+  creatable: true,   // Enable POST endpoint
+  readable: true,    // Enable GET endpoints
+  updatable: true,   // Enable PUT endpoint
+  deleteable: true,  // Enable DELETE endpoint
+  cloneable: true,   // Enable clone endpoint
+  importable: true,  // Enable bulk import
+}
 ```
 
-### 4. Start Server
+### Role Configuration
+
+Format: `role_name:permissions` or `role_name:permissions:view`
+
+```typescript
+roles: [
+  "admin:*",       // Admin can do everything
+  "user:r",        // User can only read
+  "editor:cru",    // Editor can create/read/update
+  "viewer:r:basic" // Viewer can read with "basic" view only
+]
+```
+
+### Lifecycle Hooks
+
+```typescript
+init_router({
+  collection: "order",
+  // ...fields and options...
+
+  before_create: async ({ entity, data }) => { /* validate before insert */ },
+  create: async ({ entity, data }) => { /* custom create logic */ },
+  after_create: async ({ entity, data }) => { /* post-create side effects */ },
 
-```javascript
-const { init_express_server } = require("hola-server");
+  before_update: async ({ id, entity, data }) => { /* pre-update checks */ },
+  update: async ({ id, entity, data }) => { /* custom update logic */ },
+  after_update: async ({ id, entity, data }) => { /* post-update actions */ },
 
-init_express_server(__dirname, "service_port", async () => {
-  console.log("Server started on port 8088");
+  before_delete: async ({ entity, ids }) => { /* pre-delete validation */ },
+  after_delete: async ({ entity, ids }) => { /* cleanup after delete */ },
+
+  after_read: async ({ id, entity, result }) => { /* transform read results */ },
+  list_query: async ({ entity, query }) => { /* modify list queries */ },
+
+  route: (router, meta) => { /* add custom routes */ },
 });
 ```
 
-## Entity Metadata
+## 🔌 Plugins
 
-### Field Types
+```typescript
+import { plugins } from "hola-server";
 
-- `string` - String with trim
-- `int` - Integer
-- `uint` - Unsigned integer
-- `float` - Float with 2 decimal places
-- `ufloat` - Unsigned float
-- `number` - Any number
-- `boolean` - Boolean
-- `password` - Encrypted password
-- `array` - Array type
-- `obj` - Object/Reference type
-- `file` - File upload
+// CORS with allowed origins
+app.use(plugins.holaCors({ origin: ["http://localhost:5173"] }));
 
-### Field Options
+// Request body parsing with size limit
+app.use(plugins.holaBody({ limit: "10mb" }));
 
-- `required` - Field is required
-- `primary` - Primary key (unique)
-- `searchable` - Searchable in queries
-- `invisible` - Hidden from responses
-- `sys` - System field
-- `ref` - Reference to another entity
-- `delete` - Cascade behavior: `cascade` or `keep`
+// JWT auth with access + refresh tokens
+app.use(plugins.holaAuth({
+  secret: "your-secret",
+  accessExpiry: "15m",     // default
+  refreshExpiry: "7d",     // default
+  excludeUrls: ["/health", /^\/public/],
+}));
 
-### CRUD Modes
+// Auth routes (POST /auth/refresh, POST /auth/logout)
+app.use(plugins.holaAuthRoutes());
 
-- `c` - Create
-- `r` - Read
-- `u` - Update
-- `d` - Delete
-- `o` - Clone
-- `crud` - All operations
+// Global error handling
+app.use(plugins.holaError());
+```
 
-### Role Configuration
+## 🗄 Database
 
-Format: `role_name:mode:view`
+```typescript
+import { db } from "hola-server";
 
-Example:
+// Direct MongoDB access
+const database = await db.get_db();
+const users = await database.collection("user").find({}).toArray();
 
-```javascript
-roles: [
-  "admin:crud:*", // Admin can do all operations on all views
-  "user:r:public", // User can only read public view
-  "editor:cru:edit", // Editor can create/read/update edit view
-];
+// Entity-level operations
+const entity = new db.Entity("user");
+await entity.create_entity(data, "*");
+await entity.read_entity(id, "*", "*");
+await entity.update_entity(id, updates, "*");
+await entity.delete_entity([id]);
+await entity.list_entity(queryParams, query, searchParams, role);
+```
+
+## 📁 File Storage (GridFS)
+
+```typescript
+import { db } from "hola-server";
+
+// Save file from buffer (FormData uploads)
+await db.save_file_from_buffer("avatars", "user_123.png", buffer);
+
+// Read file
+const fileBuffer = await db.read_file("avatars", "user_123.png");
+
+// Stream file
+const stream = await db.read_file_stream("avatars", "user_123.png");
+
+// Delete file
+await db.delete_file("avatars", "user_123.png");
 ```
 
-## API Endpoints
+## 🔍 Vector Search
 
-For an entity with `mode: 'crud'`:
+SQLite-based vector similarity search for AI/embedding applications:
 
-- `POST /{entity}/create` - Create entity
-- `POST /{entity}/query` - Query entities
-- `POST /{entity}/count` - Count entities
-- `POST /{entity}/update` - Update entity
-- `POST /{entity}/delete` - Delete entity
-- `POST /{entity}/clone` - Clone entity (if cloneable)
+```typescript
+import { VectorStore, initVectorStore } from "hola-server";
 
-## Core Utilities
+const store = await initVectorStore({
+  dbPath: "./data/vectors.db",
+  dimensions: 1536,
+  tableName: "embeddings",
+});
 
-### Database
+// Insert vectors with metadata
+await store.insert("doc_1", embedding, { category: "article" });
+await store.insertBatch(records);
 
-```javascript
-const { get_db } = require("hola-server");
+// Search similar vectors
+const results = await store.search(queryEmbedding, 10, { category: "article" });
+// => [{ id, distance, score, metadata }]
 
-const db = await get_db();
-const users = await db.collection("user").find({});
+// Manage vectors
+await store.delete("doc_1");
+await store.deleteByFilter({ category: "old" });
+const count = await store.count();
 ```
 
-### Entity Operations
+## ⚙️ Configuration
+
+### Environment-Based Config
 
-```javascript
-const { Entity } = require("hola-server");
+```typescript
+import { config } from "hola-server";
 
-const entity = new Entity(meta);
-await entity.create_entity(data);
-await entity.find_entity(query);
-await entity.update_entity(id, updates);
-await entity.delete_entity(id);
+const appConfig = await config.load_config(__dirname + "/config");
+// Loads config/dev.ts, config/test.ts, or config/prod.ts based on NODE_ENV
 ```
 
-### Logging
+### Settings
 
-```javascript
-const { log_info, log_error } = require("hola-server");
+```typescript
+import { init_settings } from "hola-server";
 
-log_info("user", "User logged in", { user_id });
-log_error("auth", "Login failed", { email });
+init_settings({
+  mongo: { url: "mongodb://localhost:27017/myapp", pool: 10 },
+  encrypt: { key: "my-encryption-key" },
+  roles: [{ name: "admin", root: true }, { name: "user" }],
+  server: {
+    service_port: 8088,
+    client_web_url: ["http://localhost:5173"],
+    keep_session: true,
+    check_user: true,
+    exclude_urls: ["/"],
+    session: { cookie_max_age: 86400000, secret: "session-secret" },
+    threshold: { max_download_size: 5000, body_limit: "10mb", default_list_limit: 1000 },
+    routes: ["router"],
+  },
+  axios: { retry: 3, retry_delay: 1000, proxy: null },
+  log: { col_log: "log", log_level: 0, save_db: true },
+});
 ```
 
-## Testing
+## 🧰 Core Utilities
+
+```typescript
+import { array, date, validate, encrypt, random, bash, file, obj, number, lhs } from "hola-server";
+
+// Array utilities
+array.unique([1, 2, 2, 3]); // [1, 2, 3]
+
+// Encryption
+const hashed = encrypt_pwd("password");
+const encrypted = encrypt_secret("api-key");
+const decrypted = decrypt_secret(encrypted);
+
+// And more: date formatting, validation, bash execution, file I/O, etc.
+```
+
+## 🧪 Testing
 
 ```bash
-npm test
+bun test
 ```
 
-## Project Structure
+25 test files covering:
+- **Core**: array, chart, date, encrypt, file, lhs, meta, number, obj, random, thread, type, validate
+- **Database**: connection, operations, entity class, GridFS
+- **Entity CRUD**: create, read, update, delete, clone, ref-filter
+
+## 📂 Project Structure
 
 ```
 hola-server/
-├── core/          # Core utilities (array, date, validate, etc.)
-├── db/            # Database layer (connection, entity, gridfs)
-├── http/          # HTTP layer (express, router, middleware)
-├── router/        # CRUD route handlers
-├── test/          # Test suite
-└── tool/          # Tools (i18n generation)
+├── src/
+│   ├── index.ts          # Public API entry point
+│   ├── setting.ts        # Application settings
+│   ├── config/           # Environment-based config loader
+│   ├── core/             # Core utilities (16 modules)
+│   │   ├── meta.ts       # Entity metadata & lifecycle hooks
+│   │   ├── type.ts       # Type system & validation
+│   │   ├── role.ts       # Role-based access control
+│   │   ├── encrypt.ts    # Password hashing & AES encryption
+│   │   └── ...           # array, bash, chart, date, file, etc.
+│   ├── db/               # Database layer
+│   │   ├── db.ts         # MongoDB connection & helpers
+│   │   ├── entity.ts     # Entity CRUD operations
+│   │   └── gridfs.ts     # GridFS file storage
+│   ├── meta/             # Meta programming
+│   │   ├── router.ts     # Auto RESTful route generation
+│   │   └── schema.ts     # TypeBox schema generation
+│   ├── plugins/          # Elysia plugins
+│   │   ├── auth.ts       # JWT authentication
+│   │   ├── cors.ts       # CORS configuration
+│   │   ├── body.ts       # Body parser
+│   │   └── error.ts      # Error handling
+│   ├── errors/           # Error classes (auth, http, validation)
+│   ├── http/             # HTTP status codes
+│   └── tool/             # Tools
+│       ├── gen_i18n.ts   # i18n key generation
+│       └── vector_store.ts # Vector similarity search
+├── test/                 # Test suite (25 test files)
+├── package.json
+└── tsconfig.json
 ```
 
-## License
+## 📄 License
 
 ISC

package/dist/config/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Configuration loader for environment-based settings.
+ * @module config
+ */
+export interface AppConfig {
+    /** Server port */
+    port: number;
+    /** JWT configuration */
+    jwt: {
+        secret: string;
+        accessExpiry: string;
+        refreshExpiry: string;
+    };
+    /** CORS configuration */
+    cors: {
+        origin: string[] | true;
+        credentials?: boolean;
+    };
+    /** Body parser configuration */
+    body: {
+        limit: string | number;
+    };
+    /** Database configuration */
+    db: {
+        url: string;
+    };
+}
+/**
+ * Load configuration from environment-specific file.
+ * Looks for config files in the specified directory based on NODE_ENV.
+ *
+ * @param config_dir Directory containing config files (dev.ts, test.ts, prod.ts)
+ * @returns Promise resolving to AppConfig
+ *
+ * @example
+ * ```typescript
+ * const config = await load_config(__dirname + '/config');
+ * ```
+ */
+export declare const load_config: (config_dir: string) => Promise<AppConfig>;
+/**
+ * Create a base config with common defaults.
+ * Use this as a starting point for environment configs.
+ */
+export declare const create_base_config: (overrides?: Partial<AppConfig>) => AppConfig;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACtB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,GAAG,EAAE;QACD,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,yBAAyB;IACzB,IAAI,EAAE;QACF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACxB,WAAW,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,gCAAgC;IAChC,IAAI,EAAE;QACF,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;KAC1B,CAAC;IACF,6BAA6B;IAC7B,EAAE,EAAE;QACA,GAAG,EAAE,MAAM,CAAC;KACf,CAAC;CACL;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,SAAS,CAUvE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,YAAW,OAAO,CAAC,SAAS,CAAM,KAAG,SAsBtE,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,55 @@
+/**
+ * Configuration loader for environment-based settings.
+ * @module config
+ */
+/**
+ * Load configuration from environment-specific file.
+ * Looks for config files in the specified directory based on NODE_ENV.
+ *
+ * @param config_dir Directory containing config files (dev.ts, test.ts, prod.ts)
+ * @returns Promise resolving to AppConfig
+ *
+ * @example
+ * ```typescript
+ * const config = await load_config(__dirname + '/config');
+ * ```
+ */
+export const load_config = async (config_dir) => {
+    const env = process.env.NODE_ENV || 'dev';
+    const config_path = `${config_dir}/${env}`;
+    try {
+        const module = await import(config_path);
+        return module.default;
+    }
+    catch (error) {
+        throw new Error(`Failed to load config for environment '${env}' from ${config_path}: ${error}`);
+    }
+};
+/**
+ * Create a base config with common defaults.
+ * Use this as a starting point for environment configs.
+ */
+export const create_base_config = (overrides = {}) => ({
+    port: 3000,
+    jwt: {
+        secret: 'change-this-in-production',
+        accessExpiry: '15m',
+        refreshExpiry: '7d',
+        ...overrides.jwt
+    },
+    cors: {
+        origin: ['http://localhost:5173'],
+        credentials: true,
+        ...overrides.cors
+    },
+    body: {
+        limit: '10mb',
+        ...overrides.body
+    },
+    db: {
+        url: 'mongodb://localhost:27017/hola',
+        ...overrides.db
+    },
+    ...overrides
+});
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,UAAkB,EAAsB,EAAE;IACxE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,KAAK,CAAC;IAC1C,MAAM,WAAW,GAAG,GAAG,UAAU,IAAI,GAAG,EAAE,CAAC;IAE3C,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC,OAAoB,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,0CAA0C,GAAG,UAAU,WAAW,KAAK,KAAK,EAAE,CAAC,CAAC;IACpG,CAAC;AACL,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,YAAgC,EAAE,EAAa,EAAE,CAAC,CAAC;IAClF,IAAI,EAAE,IAAI;IACV,GAAG,EAAE;QACD,MAAM,EAAE,2BAA2B;QACnC,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,IAAI;QACnB,GAAG,SAAS,CAAC,GAAG;KACnB;IACD,IAAI,EAAE;QACF,MAAM,EAAE,CAAC,uBAAuB,CAAC;QACjC,WAAW,EAAE,IAAI;QACjB,GAAG,SAAS,CAAC,IAAI;KACpB;IACD,IAAI,EAAE;QACF,KAAK,EAAE,MAAM;QACb,GAAG,SAAS,CAAC,IAAI;KACpB;IACD,EAAE,EAAE;QACA,GAAG,EAAE,gCAAgC;QACrC,GAAG,SAAS,CAAC,EAAE;KAClB;IACD,GAAG,SAAS;CACf,CAAC,CAAC"}

package/dist/core/array.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Array manipulation utility functions.
+ * @module core/array
+ */
+/** Shuffle array elements randomly in place. */
+export declare const shuffle: <T>(arr: T[]) => void;
+/** Remove elements from array by matching field value. */
+export declare const remove_element: <T, K extends keyof T>(array: T[], field: K, value: T[K]) => void;
+export declare const pop_n: <T>(array: T[], n: number) => T[] | undefined;
+export declare const shift_n: <T>(array: T[], n: number) => T[] | undefined;
+/** Calculate sum of number array. */
+export declare const sum: (arr: number[]) => number;
+/** Calculate average of number array. */
+export declare const avg: (arr: number[]) => number;
+/** Convert array of objects to key-value object. */
+export declare const map_array_to_obj: <T, K extends keyof T, V extends keyof T>(arr: T[], key_attr: K, value_attr: V) => Record<string, T[V]>;
+/** Sort array of objects by attribute. */
+export declare const sort_by_attr: <T extends Record<string, number>>(arr: T[], attr: keyof T, desc?: boolean) => T[];
+export declare const sort_desc: <T extends Record<string, number>>(arr: T[], attr: keyof T) => T[];
+export declare const sort_asc: <T extends Record<string, number>>(arr: T[], attr: keyof T) => T[];
+/** Sort array by predefined key sequence. */
+export declare const sort_by_key_seq: <T, K extends keyof T>(arr: T[], attr: K, keys: T[K][]) => T[];
+/** Create cartesian product of two object arrays. */
+export declare const combine: <T extends object, U extends object>(arr1: T[], arr2: U[]) => (T & U)[];
+/** Remove duplicate elements from array. */
+export declare const unique: <T>(array: T[]) => T[];
+//# sourceMappingURL=array.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/core/array.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,gDAAgD;AAChD,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,KAAK,CAAC,EAAE,KAAG,IAKrC,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAG,IAIxF,CAAC;AAaF,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,MAAM,KAAG,CAAC,EAAE,GAAG,SAAuC,CAAC;AAC/F,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,MAAM,KAAG,CAAC,EAAE,GAAG,SAAyC,CAAC;AAEnG,qCAAqC;AACrC,eAAO,MAAM,GAAG,GAAI,KAAK,MAAM,EAAE,KAAG,MAAiE,CAAC;AAEtG,yCAAyC;AACzC,eAAO,MAAM,GAAG,GAAI,KAAK,MAAM,EAAE,KAAG,MAAuE,CAAC;AAE5G,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,YAAY,CAAC,KAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAEnI,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,MAAM,CAAC,EAAE,OAAM,OAAe,KAAG,CAAC,EAGhH,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,MAAM,CAAC,KAAG,CAAC,EAAmC,CAAC;AAC3H,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,MAAM,CAAC,KAAG,CAAC,EAAoC,CAAC;AAE3H,6CAA6C;AAC7C,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAG,CAAC,EAGxF,CAAC;AAEF,qDAAqD;AACrD,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,KAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAEzF,CAAC;AAEF,4CAA4C;AAC5C,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,OAAO,CAAC,EAAE,KAAG,CAAC,EAMvC,CAAC"}