@ecosy/core 0.1.0 → 0.2.0

package/README.md

@@ -1,234 +1,76 @@
 # @ecosy/core
 
-Lightweight utilities, pub/sub subscriber, and types for TypeScript applications.
+A modular, tree-shakable collection of essential utilities, serialization primitives, and event-driven patterns for modern TypeScript applications.
 
 ## Installation
 
 ```bash
-npm install @ecosy/core
-# or
 yarn add @ecosy/core
 ```
 
-## Modules
+## Features
+
+### Subpath Imports
 
 | Entry point | Description |
 |--|--|
-| `@ecosy/core` | Re-exports utilities + subscriber |
+| `@ecosy/core` | Re-exports all modules |
 | `@ecosy/core/types` | TypeScript type utilities |
 | `@ecosy/core/utilities` | Runtime utility functions |
 | `@ecosy/core/subscriber` | Pub/sub event emitter with state |
+| `@ecosy/core/http` | HTTP client with interceptors and upload |
+| `@ecosy/core/logger` | Structured logger with log levels |
+| `@ecosy/core/syhemo` | System health monitor |
+| `@ecosy/core/serialize` | Serialization engine (JSON, URL, queryString) |
+| `@ecosy/core/slugify` | Unicode-safe string slugifier |
+| `@ecosy/core/searchify` | Diacritic-insensitive fuzzy search |
 
----
-
-## Types
-
-```ts
-import type {
-  primitive,
-  LiteralObject,
-  LiteralFunction,
-  Objectable,
-  Freezable,
-  PartialLiteral,
-  ToString,
-  Promisable,
-  AtomicObject,
-} from "@ecosy/core/types";
-```
-
-| Type | Description |
-|--|--|
-| `primitive` | `string \| number \| boolean \| bigint \| symbol \| undefined \| null` |
-| `LiteralObject` | Plain object type (`Record<PropertyKey, unknown> \| object`) |
-| `LiteralFunction<R, A>` | Generic function type `(...args: A) => R` |
-| `Objectable` | `LiteralObject \| Array \| LiteralFunction` |
-| `Freezable<T>` | Recursively readonly version of `T` |
-| `PartialLiteral<T>` | Deep partial that respects built-in types (Map, Set, Promise, etc.) |
-| `ToString<T>` | Converts type to its string literal representation |
-| `Promisable<V>` | `V \| Promise<V>` |
-| `AtomicObject<K, V>` | `{ [K]: V }` |
-
----
-
-## Utilities
-
-```ts
-import {
-  clone,
-  freeze,
-  isEqual,
-  isFunction,
-  isObject,
-  isLiteralObject,
-  isComplexObject,
-  isObjectable,
-  hasOwnProperty,
-  merge,
-  toString,
-  ucfirst,
-} from "@ecosy/core/utilities";
-```
-
-### `clone<T>(data: T): T`
-
-Deep clones a value. Handles circular references, Date, RegExp, Map, Set, ArrayBuffer, TypedArrays, arrays, and plain objects. Skips non-cloneable types (Error, Promise, WeakMap, DOM nodes, etc.).
-
-```ts
-const original = { a: 1, b: { c: [2, 3] } };
-const cloned = clone(original);
-cloned.b.c.push(4);
-original.b.c.length; // 3 — unaffected
-```
-
-### `freeze<T>(data: T): Freezable<T>`
-
-Deep freezes a value by cloning first, then recursively calling `Object.freeze`.
-
-```ts
-const frozen = freeze({ a: { b: 1 } });
-frozen.a.b = 2; // throws in strict mode
-```
-
-### `isEqual(a: unknown, b: unknown): boolean`
+### Types
 
-Deep structural equality check. Supports primitives, arrays, plain objects, Date, RegExp, Map, Set, ArrayBuffer, and TypedArrays.
+Deep utility types for TypeScript — `Freezable<T>`, `PartialLiteral<T>`, `Promisable<V>`, `ToString<T>`, and more.
 
-```ts
-isEqual({ a: [1, 2] }, { a: [1, 2] }); // true
-isEqual(new Date(0), new Date(0));      // true
-```
-
-### `merge<T>(source, target, cloneDeep?): T`
-
-Deep merges `target` into `source`. Prototype-polluting keys (`__proto__`, `constructor`, `prototype`) are rejected.
-
-```ts
-merge({ a: 1, b: { c: 2 } }, { b: { d: 3 } });
-// { a: 1, b: { c: 2, d: 3 } }
-```
-
-### `isFunction(value): value is LiteralFunction`
-
-Checks if a value is a function (sync, async, or generator).
+### Utilities
 
-### `isObject(value): value is object`
+- **`clone`** — Deep clone with circular reference handling
+- **`freeze`** — Deep freeze via clone + `Object.freeze`
+- **`isEqual`** — Structural deep equality (Date, Map, Set, TypedArrays)
+- **`merge`** — Deep merge with prototype pollution protection
+- **`flatten`** / **`flattenToArray`** — Object flattening
+- **`get`** — Safe deep path resolution (`"a.b[0].c"`)
+- **`defer`** / **`deferAsync`** — rAF + setTimeout scheduling with cancel
+- Type guards: `isFunction`, `isObject`, `isLiteralObject`, `isComplexObject`, `isObjectable`, `hasOwnProperty`
 
-Checks if a value is a non-null object.
+### Subscriber
 
-### `isLiteralObject(value): value is LiteralObject`
+Pub/sub event emitter with built-in state management, async once, and typed wiring.
 
-Checks if a value is a plain object (`{}` or `Object.create(null)`).
+### Http
 
-### `isComplexObject<T>(value): value is T`
+Configurable HTTP client with request/response interceptors, auth token injection, URL interpolation via Serialize, and XHR-based upload with progress tracking.
 
-Checks if a value is a non-array object (e.g., class instance).
+### Serialize
 
-### `isObjectable(value): value is Objectable`
-
-Checks if a value is an object, array, or function.
-
-### `hasOwnProperty(obj, key): boolean`
-
-Type-safe `Object.prototype.hasOwnProperty.call()`.
-
-### `toString(value): string`
-
-Returns the internal `[[Class]]` tag via `Object.prototype.toString`.
-
-```ts
-toString([]);   // "[object Array]"
-toString(null); // "[object Null]"
-```
+Centralized serialization engine:
+- **`Serialize.Primitive`** — Type guards and deep normalization (BigInt, Date, undefined stripping)
+- **`Serialize.JSON`** — Safe stringify/parse that never throws
+- **`Serialize.URL`** — Robust encode/decode with `:param` URL building
+- **`Serialize.queryString`** — Advanced parse/stringify (bracket, index, comma formats)
 
-### `ucfirst<T>(str: T): Capitalize<T>`
+### Slugify & Searchify
 
-Capitalizes the first character of a string.
+- **`slugify`** — Unicode-safe slug generation with custom transformer map
+- **`searchify`** — Diacritic-insensitive fuzzy search using sliding window algorithm
 
----
-
-## Subscriber
-
-A pub/sub event emitter with built-in state management.
-
-```ts
-import { Subscriber } from "@ecosy/core/subscriber";
-```
-
-### Basic usage
-
-```ts
-const sub = new Subscriber({ count: 0 });
-
-// Subscribe to state changes
-const unsub = sub.onStateChange((state) => {
-  console.log("Count:", state.count);
-});
-
-// Update state
-sub.setState({ count: 1 }); // logs "Count: 1"
-
-// Cleanup
-unsub();
-```
-
-### Custom channels
-
-```ts
-sub.subscribe("user:login", (user) => {
-  console.log("Logged in:", user.name);
-});
-
-sub.dispatch("user:login", { name: "Alice" });
-```
-
-### Async once
-
-```ts
-const payload = await sub.subscribeAsyncOnce("data:ready");
-```
-
-> [!WARNING]
-> If the channel is never dispatched and no `AbortSignal` is provided, the returned Promise will never resolve, causing a **memory leak**. Always pass an `AbortSignal` or ensure the channel will eventually be dispatched.
-
-```ts
-const controller = new AbortController();
-setTimeout(() => controller.abort(), 5000); // timeout after 5s
-
-try {
-  const payload = await sub.subscribeAsyncOnce("data:ready", undefined, controller.signal);
-} catch {
-  console.log("Timed out or cancelled");
-}
-```
-
-### Wiring events
-
-```ts
-const events = {
-  auth: {
-    login: "$auth:login",
-    logout: "$auth:logout",
-  },
-} as const;
-
-const wired = Subscriber.wire(sub, events);
-
-// Dispatch
-wired.auth.login({ user: "Alice" });
-
-// Listen
-wired.auth.onLogin((payload) => {
-  console.log(payload.user);
-});
-```
+## Documentation
 
----
+Full API reference and guides: **[docs.ecosy.io](https://docs.ecosy.io)**
 
-## Related packages
+## Related Packages
 
 | Package | Description |
 |--|--|
+| [`@ecosy/datekit`](https://github.com/material-atomic/ecosy-datekit) | Headless date utilities (Dateify, Dayify, Monthify, Yearify) |
+| [`@ecosy/mailer`](https://github.com/material-atomic/ecosy-mailer) | Email engine with template formatting, retry, and rate limiting |
 | [`@ecosy/store`](https://github.com/material-atomic/ecosy-store) | State management with slices and reducers |
 | [`@ecosy/react`](https://github.com/material-atomic/ecosy-react) | React hooks for `@ecosy/store` |
 

package/dist/http.d.ts

@@ -0,0 +1,176 @@
+import { type FileListLike } from "@ecosy/core/utilities";
+/** Default base URL for HTTP requests, sourced from `API_URL` env variable. */
+export declare const DEFAULT_BASE_URL: string;
+/** Authentication token storage key, sourced from `API_AUTH_TOKEN_KEY` env variable. */
+export declare const API_AUTH_TOKEN_KEY: string | undefined;
+/** Authentication header name, sourced from `API_AUTH_HEADER_KEY` env variable. */
+export declare const API_AUTH_HEADER_KEY: string | undefined;
+/** Authentication header type prefix (e.g. "Bearer"), sourced from `API_AUTH_HEADER_TYPE` env variable. */
+export declare const API_AUTH_HEADER_TYPE: string | undefined;
+/** Supported HTTP methods. */
+export declare enum HttpMethod {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    DELETE = "DELETE",
+    PATCH = "PATCH",
+    HEAD = "HEAD",
+    OPTIONS = "OPTIONS"
+}
+/** Accepted query parameter formats for HTTP requests. */
+export type HttpQuery = string | Record<string, string | number | boolean | undefined> | Array<[string, string | number | boolean | undefined]> | URLSearchParams;
+/** Configuration object for an HTTP request. */
+export interface HttpRequest<Body = unknown, Params = Record<string, unknown>, Query = HttpQuery, Headers = Record<string, string>> {
+    method: HttpMethod;
+    url: string;
+    headers?: Headers;
+    body?: Body;
+    query?: Query;
+    params?: Params;
+    signal?: AbortSignal;
+}
+/** Storage adapter interface for reading/writing auth tokens (e.g. `localStorage`). */
+export interface HttpStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string, options?: any): void;
+}
+/** Interceptor that can modify a request before it is sent. */
+export type HttpInterceptorRequest = (options: HttpRequest) => Promise<HttpRequest> | HttpRequest;
+/** Interceptor that can modify a `Response` after it is received. */
+export type HttpInterceptorResponse = (response: Response) => Promise<Response> | Response;
+/** Interceptor that transforms the parsed response data. */
+export type HttpInterceptorTransform = (data: any) => Promise<any> | any;
+/** Interceptor that handles errors from requests. */
+export type HttpInterceptorError = (error: unknown) => Promise<any> | any;
+/** Tuple type for registering interceptors by phase. */
+export type HttpInterceptorParameters = ["request", HttpInterceptorRequest] | ["response", HttpInterceptorResponse] | ["transform", HttpInterceptorTransform] | ["error", HttpInterceptorError];
+/** Normalized response returned by all `Http` methods. */
+export interface HttpResponse<T = unknown, E = unknown> {
+    success: boolean;
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    error: E | null;
+}
+/** Upload progress snapshot. */
+export interface HttpProgress {
+    loaded: number;
+    total: number;
+    percentage: number;
+}
+/** Options for file upload, including progress tracking. */
+export interface HttpUploadOptions extends Pick<HttpRequest, "headers" | "params" | "signal" | "query"> {
+    onProgress?: (progress: HttpProgress) => void;
+    name: string;
+    body?: Record<string, unknown>;
+}
+/** Options for creating an HTTP factory via {@link Http.createFactory}. */
+export interface HttpFactoryOptions {
+    baseURL?: string;
+    http?: Http;
+    storage?: HttpStorage | (() => Promise<HttpStorage> | HttpStorage);
+    endpoint?: Record<string, unknown> | (() => Record<string, unknown>);
+}
+/** A factory-generated endpoint descriptor with a key and an async `fn`. */
+export interface HttpFactory<T = unknown, Args extends any[] = [], E = unknown> {
+    key: string;
+    fn: (...args: Args) => Promise<HttpResponse<T, E>>;
+}
+/**
+ * HTTP client with interceptors, auth token management, file uploads,
+ * and a factory pattern for endpoint generation.
+ *
+ * @example
+ * ```ts
+ * const http = new Http("https://api.example.com");
+ *
+ * const { data } = await http.get<User[]>("/users");
+ * await http.post<User>("/users", { name: "Alice" });
+ * await http.upload<Media>("/upload", file, { name: "avatar" });
+ * ```
+ */
+export declare class Http {
+    private readonly baseURL;
+    static readonly method: typeof HttpMethod;
+    static authTokenKey: string;
+    static authHeaderKey: string;
+    static authHeaderType: string;
+    static authDetectToken: string[];
+    static extraHeaders: Record<string, string> | null;
+    static storage: HttpStorage | null;
+    private defaultHeaders;
+    readonly method: typeof HttpMethod;
+    private storage;
+    private static interceptors;
+    private interceptors;
+    constructor(baseURL?: string);
+    /** Register a global interceptor (applies to all `Http` instances). */
+    static on(...params: HttpInterceptorParameters): void;
+    /** Remove a global interceptor. */
+    static off(...params: HttpInterceptorParameters): void;
+    /** Set the storage adapter for this instance (used to read auth tokens). */
+    setStorage(storage: HttpStorage): void;
+    /** Type guard that checks whether a value is a valid {@link HttpQuery}. */
+    isValidQuery(query: unknown): query is HttpQuery;
+    getQuery<Params extends Record<string, unknown>>(options: HttpRequest<unknown, Params>): string;
+    /** Type guard that checks whether a body is a `FormData` instance. */
+    isFormData(body: unknown): body is FormData;
+    /** Merge additional default headers into this instance. */
+    addHeaders(headers: Record<string, string>): void;
+    /** Register an instance-level interceptor. */
+    on(...params: HttpInterceptorParameters): this;
+    /** Remove an instance-level interceptor. */
+    off(...params: HttpInterceptorParameters): this;
+    /** Read the auth token from storage and format it with the configured header type. */
+    getToken(): {
+        key: string;
+        value: string;
+    };
+    /** Build the final headers object, injecting auth token and Content-Type. */
+    getHeaders(headers?: Record<string, string>, isFormData?: boolean): {
+        [x: string]: string;
+    };
+    /** Build the full URL from base URL, path, query string, and path params. */
+    getURL(options: HttpRequest): string;
+    /** Serialize the request body (JSON or FormData). Returns `undefined` for bodyless methods. */
+    getBody(options: HttpRequest): string | FormData | undefined;
+    /** Execute a full HTTP request with all interceptors applied. */
+    request<T = unknown, E = unknown>(options: HttpRequest): Promise<HttpResponse<T, E>>;
+    /** Perform a GET request. */
+    get<T = unknown, Query = Record<string, unknown>, E = unknown>(url: string, query?: Query, options?: Pick<HttpRequest, "headers" | "params" | "signal">): Promise<HttpResponse<T, E>>;
+    /** Perform a POST request. */
+    post<T = unknown, Body = unknown, E = unknown>(url: string, body?: Body, options?: Pick<HttpRequest, "headers" | "params" | "signal" | "query">): Promise<HttpResponse<T, E>>;
+    /** Perform a PUT request. */
+    put<T = unknown, Body = unknown, E = unknown>(url: string, body?: Body, options?: Pick<HttpRequest, "headers" | "params" | "signal" | "query">): Promise<HttpResponse<T, E>>;
+    /** Perform a PATCH request. */
+    patch<T = unknown, Body = unknown, E = unknown>(url: string, body?: Body, options?: Pick<HttpRequest, "headers" | "params" | "signal" | "query">): Promise<HttpResponse<T, E>>;
+    /** Perform a DELETE request. */
+    delete<T = unknown, E = unknown>(url: string, options?: Pick<HttpRequest, "headers" | "params" | "signal" | "query">): Promise<HttpResponse<T, E>>;
+    /** Perform a HEAD request. */
+    head<T = unknown, E = unknown>(url: string, options?: Pick<HttpRequest, "headers" | "params" | "signal" | "query">): Promise<HttpResponse<T, E>>;
+    /** Perform an OPTIONS request. */
+    options<T = unknown, E = unknown>(url: string, options?: Pick<HttpRequest, "headers" | "params" | "signal" | "query">): Promise<HttpResponse<T, E>>;
+    /**
+     * Upload one or more files via POST.
+     * Falls back to `XMLHttpRequest` when `onProgress` is provided for progress tracking.
+     */
+    upload<T = unknown, E = unknown>(url: string, file: File | File[] | FileListLike, options?: HttpUploadOptions): Promise<HttpResponse<T, E>>;
+    /**
+     * Creates a factory function that generates typed endpoint descriptors.
+     * Each descriptor has a `key` and an async `fn` that performs the HTTP call.
+     *
+     * @example
+     * ```ts
+     * const api = Http.createFactory({
+     *   baseURL: "https://api.example.com",
+     *   endpoint: { users: { list: "/users", create: "/users" } },
+     * });
+     *
+     * const getUsers = api<User[]>("users.list");
+     * const { data } = await getUsers.fn();
+     * ```
+     */
+    static createFactory(options?: HttpFactoryOptions): <T, Args extends any[] = [], E = unknown>(key: string, method?: HttpMethod | "UPLOAD") => HttpFactory<T, Args, E>;
+}

package/dist/http.js

@@ -0,0 +1 @@
+"use strict";require("./utilities/clone.js");var t=require("./utilities/filelist.js"),e=require("./utilities/flatten.js"),s=require("./utilities/object-to-formdata.js"),r=require("./serialize.js");const o=process.env.API_URL||"/",n=process.env.API_AUTH_TOKEN_KEY,a=process.env.API_AUTH_HEADER_KEY,i=process.env.API_AUTH_HEADER_TYPE;var c;exports.HttpMethod=void 0,(c=exports.HttpMethod||(exports.HttpMethod={})).GET="GET",c.POST="POST",c.PUT="PUT",c.DELETE="DELETE",c.PATCH="PATCH",c.HEAD="HEAD",c.OPTIONS="OPTIONS";class p{constructor(t=o){this.baseURL=t,this.defaultHeaders={"Content-Type":"application/json"},this.method=p.method,this.storage=p.storage,this.interceptors={request:[],response:[],transform:[],error:[]}}static on(...t){const[e,s]=t,r=p.interceptors[e];r.includes(s)||r.push(s),p.interceptors[e]=r}static off(...t){const[e,s]=t,r=p.interceptors[e];p.interceptors[e]=r.filter(t=>t!==s)}setStorage(t){this.storage=t}isValidQuery(t){return"string"==typeof t||t instanceof URLSearchParams||(Array.isArray(t)?t.every(t=>Array.isArray(t)&&2===t.length&&"string"==typeof t[0]&&r.Serialize.Primitive.isPrimitive(t[1])):"object"==typeof t&&null!==t&&Object.values(t).every(t=>r.Serialize.Primitive.isPrimitive(t)))}getQuery(t){const{method:e,body:s,query:o}=t,n=e===exports.HttpMethod.GET&&this.isValidQuery(s)?s:o;return n&&"object"==typeof n?n instanceof URLSearchParams?n.toString():r.Serialize.queryString.stringify(n,{skipNull:!0,skipEmptyString:!0}):"string"==typeof n?n:""}isFormData(t){return t instanceof FormData}addHeaders(t){this.defaultHeaders=Object.assign(Object.assign({},this.defaultHeaders),t)}on(...t){const[e,s]=t,r=this.interceptors[e];return r.includes(s)||r.push(s),this.interceptors[e]=r,this}off(...t){const[e,s]=t,r=this.interceptors[e];return this.interceptors[e]=r.filter(t=>t!==s),this}getToken(){const t=n||p.authTokenKey,e=a||p.authHeaderKey,s=i||p.authHeaderType;if(!t||!e)return{key:e,value:""};let r="";this.storage&&(r=this.storage.getItem(t)||"");const o={key:e,value:""};return r&&(o.value=r,s&&(o.value=`${s} ${r}`)),o}getHeaders(t={},e){const s=this.getToken();s.key in t&&t[s.key]||(t[s.key]=s.value),e&&"Content-Type"in t?delete t["Content-Type"]:t["Content-Type"]=t["Content-Type"]||this.defaultHeaders["Content-Type"]||"application/json";const r=Object.assign(Object.assign(Object.assign({},this.defaultHeaders),t),p.extraHeaders||{});return p.extraHeaders=null,r}getURL(t){const{url:e,params:s={}}=t,o=this.getQuery(t);let n=e;if(e)if(e.match(/^https?:\/\//))n=e;else{n=`${this.baseURL.replace(/\/+$/,"")}/${e.replace(/^\/+/,"")}`}if(o){const t=n.includes("?")?"&":"?";n+=`${t}${o}`}return r.Serialize.interpolate(n,s)}getBody(t){const{method:e,body:s}=t;if(e!==exports.HttpMethod.GET&&e!==exports.HttpMethod.HEAD&&e!==exports.HttpMethod.OPTIONS&&e!==exports.HttpMethod.DELETE)return e!==exports.HttpMethod.POST&&e!==exports.HttpMethod.PUT&&e!==exports.HttpMethod.PATCH||!this.isFormData(s)?void 0!==s?JSON.stringify(s):void 0:s}async request(t){const{method:e=exports.HttpMethod.GET}=t;try{let s=Object.assign({},t);const r=[...p.interceptors.request,...this.interceptors.request];for(const t of r)s=await t(s);const o=this.getURL(s),n=this.getHeaders(s.headers||{});this.isFormData(s.body)&&"Content-Type"in n&&delete n["Content-Type"];const a=await fetch(o,{method:s.method||e,headers:n,body:this.getBody(s),signal:s.signal}),i=a.headers.get("Content-Type")||"";let c=null;c=i.includes("application/json")?await a.json():await a.text();const u=[...p.interceptors.transform,...this.interceptors.transform];let d=c;for(const t of u)d=await t(d);const l=[...p.interceptors.response,...this.interceptors.response];let h=a;for(const t of l)h=await t(h);const f={};h.headers.forEach((t,e)=>{f[e]=t});const T=h.ok;let y=null;if(!T){y=c.error||c;const t=[...p.interceptors.error,...this.interceptors.error];for(const e of t)y=await e(y)}return{data:d,success:T,error:T?null:y,status:h.status,statusText:h.statusText,headers:f}}catch(t){let e=t instanceof Error?t:new Error(String(t));const s=[...p.interceptors.error,...this.interceptors.error];for(const t of s)e=await t(e);return{data:null,status:0,statusText:"Error",headers:{},error:e,success:!1}}}get(t,e,s){return this.request(Object.assign(Object.assign({},s),{method:exports.HttpMethod.GET,url:t,query:e}))}post(t,e,s){return this.request(Object.assign(Object.assign({},s),{method:exports.HttpMethod.POST,url:t,body:e}))}put(t,e,s){return this.request(Object.assign(Object.assign({},s),{method:exports.HttpMethod.PUT,url:t,body:e}))}patch(t,e,s){return this.request(Object.assign(Object.assign({},s),{method:exports.HttpMethod.PATCH,url:t,body:e}))}delete(t,e){return this.request(Object.assign(Object.assign({},e),{method:exports.HttpMethod.DELETE,url:t}))}head(t,e){return this.request(Object.assign(Object.assign({},e),{method:exports.HttpMethod.HEAD,url:t}))}options(t,e){return this.request(Object.assign(Object.assign({},e),{method:exports.HttpMethod.OPTIONS,url:t}))}upload(r,o,n){const a=(null==n?void 0:n.body)?s.objectToFormData(n.body):new FormData;let i=(null==n?void 0:n.name)||"file";if(Array.isArray(o)?(i.endsWith("[]")&&(i=i.slice(0,-2)),o.forEach((t,e)=>{a.append(`${i}[${e}]`,t,t.name)})):t.isFileList(o)?(i.endsWith("[]")&&(i=i.slice(0,-2)),Array.from(o).forEach((t,e)=>{a.append(`${i}[${e}]`,t,t.name)})):a.append(i,o,o.name),null==n?void 0:n.body){const t=e.flatten(n.body);Object.entries(t).forEach(([t,e])=>{null!=e&&a.append(t,String(e))})}return(null==n?void 0:n.onProgress)&&"undefined"!=typeof XMLHttpRequest?new Promise(async t=>{try{let e=Object.assign(Object.assign({},n),{method:exports.HttpMethod.POST,url:r,body:a});const s=[...p.interceptors.request,...this.interceptors.request];for(const t of s)e=await t(e);const o=this.getURL(e),i=this.getHeaders(e.headers||{},!0),c=new XMLHttpRequest;c.upload.addEventListener("progress",t=>{var e;if(t.lengthComputable){const s=Math.round(t.loaded/t.total*100);null===(e=n.onProgress)||void 0===e||e.call(n,{loaded:t.loaded,total:t.total,percentage:s})}}),c.addEventListener("load",async()=>{try{const e=c.getResponseHeader("Content-Type")||"";let s=null;s=e.includes("application/json")?JSON.parse(c.responseText):c.responseText;const r=[...p.interceptors.transform,...this.interceptors.transform];let o=s;for(const t of r)o=await t(o);const n=[...p.interceptors.response,...this.interceptors.response];let a=new Response(c.responseText,{status:c.status,statusText:c.statusText,headers:i});for(const t of n)a=await t(a);const u={};a.headers.forEach((t,e)=>{u[e]=t});const d=a.ok;t({data:o,success:d,error:d?null:o,status:a.status,statusText:a.statusText,headers:u})}catch(e){const s=[...p.interceptors.error,...this.interceptors.error];for(const t of s)t(e);t({data:null,status:0,statusText:"Error",headers:{},error:e,success:!1})}}),c.addEventListener("error",e=>{const s=[...p.interceptors.error,...this.interceptors.error];for(const t of s)t(e);t({data:null,status:0,statusText:"Error",headers:{},error:e,success:!1})}),c.addEventListener("abort",()=>{t({data:null,status:0,statusText:"Aborted",headers:{},error:null,success:!1})}),c.open(e.method||exports.HttpMethod.POST,o,!0),Object.entries(i).forEach(([t,e])=>{"content-type"!==(null==t?void 0:t.toLowerCase())&&e&&c.setRequestHeader(t,e)}),c.send(e.body)}catch(e){const s=[...p.interceptors.error,...this.interceptors.error];for(const t of s)t(e);t({data:null,status:0,statusText:"Error",headers:{},error:e,success:!1})}}):this.request({method:exports.HttpMethod.POST,url:r,body:a,headers:null==n?void 0:n.headers,params:null==n?void 0:n.params,signal:null==n?void 0:n.signal,query:null==n?void 0:n.query})}static createFactory(t={}){const s=t.http||new p(t.baseURL);return function(r,o){const n=e.flatten("function"==typeof t.endpoint?t.endpoint():t.endpoint||{})[r];return{key:r,fn:async(...e)=>{const r="function"==typeof t.storage?await t.storage():t.storage;switch(r&&s.setStorage(r),o){case exports.HttpMethod.POST:return await s.post(n,...e);case exports.HttpMethod.PUT:return await s.put(n,...e);case exports.HttpMethod.PATCH:return await s.patch(n,...e);case exports.HttpMethod.DELETE:return await s.delete(n,...e);case exports.HttpMethod.HEAD:return await s.head(n,...e);case exports.HttpMethod.OPTIONS:return await s.options(n,...e);case"UPLOAD":return await s.upload(n,...e);default:return await s.get(n,...e)}}}}}}p.method=exports.HttpMethod,p.authTokenKey="access_token",p.authHeaderKey="Authorization",p.authHeaderType="Bearer",p.authDetectToken=["localStorage","sessionStorage","cookie"],p.extraHeaders=null,p.storage=null,p.interceptors={request:[],response:[],transform:[],error:[]},exports.API_AUTH_HEADER_KEY=a,exports.API_AUTH_HEADER_TYPE=i,exports.API_AUTH_TOKEN_KEY=n,exports.DEFAULT_BASE_URL=o,exports.Http=p;

package/dist/http.mjs

@@ -0,0 +1 @@
+import"./utilities/clone.mjs";import{isFileList as t}from"./utilities/filelist.mjs";import{flatten as e}from"./utilities/flatten.mjs";import{objectToFormData as s}from"./utilities/object-to-formdata.mjs";import{Serialize as r}from"./serialize.mjs";const o=process.env.API_URL||"/",n=process.env.API_AUTH_TOKEN_KEY,a=process.env.API_AUTH_HEADER_KEY,i=process.env.API_AUTH_HEADER_TYPE;var c;!function(t){t.GET="GET",t.POST="POST",t.PUT="PUT",t.DELETE="DELETE",t.PATCH="PATCH",t.HEAD="HEAD",t.OPTIONS="OPTIONS"}(c||(c={}));class u{constructor(t=o){this.baseURL=t,this.defaultHeaders={"Content-Type":"application/json"},this.method=u.method,this.storage=u.storage,this.interceptors={request:[],response:[],transform:[],error:[]}}static on(...t){const[e,s]=t,r=u.interceptors[e];r.includes(s)||r.push(s),u.interceptors[e]=r}static off(...t){const[e,s]=t,r=u.interceptors[e];u.interceptors[e]=r.filter(t=>t!==s)}setStorage(t){this.storage=t}isValidQuery(t){return"string"==typeof t||t instanceof URLSearchParams||(Array.isArray(t)?t.every(t=>Array.isArray(t)&&2===t.length&&"string"==typeof t[0]&&r.Primitive.isPrimitive(t[1])):"object"==typeof t&&null!==t&&Object.values(t).every(t=>r.Primitive.isPrimitive(t)))}getQuery(t){const{method:e,body:s,query:o}=t,n=e===c.GET&&this.isValidQuery(s)?s:o;return n&&"object"==typeof n?n instanceof URLSearchParams?n.toString():r.queryString.stringify(n,{skipNull:!0,skipEmptyString:!0}):"string"==typeof n?n:""}isFormData(t){return t instanceof FormData}addHeaders(t){this.defaultHeaders=Object.assign(Object.assign({},this.defaultHeaders),t)}on(...t){const[e,s]=t,r=this.interceptors[e];return r.includes(s)||r.push(s),this.interceptors[e]=r,this}off(...t){const[e,s]=t,r=this.interceptors[e];return this.interceptors[e]=r.filter(t=>t!==s),this}getToken(){const t=n||u.authTokenKey,e=a||u.authHeaderKey,s=i||u.authHeaderType;if(!t||!e)return{key:e,value:""};let r="";this.storage&&(r=this.storage.getItem(t)||"");const o={key:e,value:""};return r&&(o.value=r,s&&(o.value=`${s} ${r}`)),o}getHeaders(t={},e){const s=this.getToken();s.key in t&&t[s.key]||(t[s.key]=s.value),e&&"Content-Type"in t?delete t["Content-Type"]:t["Content-Type"]=t["Content-Type"]||this.defaultHeaders["Content-Type"]||"application/json";const r=Object.assign(Object.assign(Object.assign({},this.defaultHeaders),t),u.extraHeaders||{});return u.extraHeaders=null,r}getURL(t){const{url:e,params:s={}}=t,o=this.getQuery(t);let n=e;if(e)if(e.match(/^https?:\/\//))n=e;else{n=`${this.baseURL.replace(/\/+$/,"")}/${e.replace(/^\/+/,"")}`}if(o){const t=n.includes("?")?"&":"?";n+=`${t}${o}`}return r.interpolate(n,s)}getBody(t){const{method:e,body:s}=t;if(e!==c.GET&&e!==c.HEAD&&e!==c.OPTIONS&&e!==c.DELETE)return e!==c.POST&&e!==c.PUT&&e!==c.PATCH||!this.isFormData(s)?void 0!==s?JSON.stringify(s):void 0:s}async request(t){const{method:e=c.GET}=t;try{let s=Object.assign({},t);const r=[...u.interceptors.request,...this.interceptors.request];for(const t of r)s=await t(s);const o=this.getURL(s),n=this.getHeaders(s.headers||{});this.isFormData(s.body)&&"Content-Type"in n&&delete n["Content-Type"];const a=await fetch(o,{method:s.method||e,headers:n,body:this.getBody(s),signal:s.signal}),i=a.headers.get("Content-Type")||"";let c=null;c=i.includes("application/json")?await a.json():await a.text();const l=[...u.interceptors.transform,...this.interceptors.transform];let d=c;for(const t of l)d=await t(d);const p=[...u.interceptors.response,...this.interceptors.response];let h=a;for(const t of p)h=await t(h);const f={};h.headers.forEach((t,e)=>{f[e]=t});const y=h.ok;let g=null;if(!y){g=c.error||c;const t=[...u.interceptors.error,...this.interceptors.error];for(const e of t)g=await e(g)}return{data:d,success:y,error:y?null:g,status:h.status,statusText:h.statusText,headers:f}}catch(t){let e=t instanceof Error?t:new Error(String(t));const s=[...u.interceptors.error,...this.interceptors.error];for(const t of s)e=await t(e);return{data:null,status:0,statusText:"Error",headers:{},error:e,success:!1}}}get(t,e,s){return this.request(Object.assign(Object.assign({},s),{method:c.GET,url:t,query:e}))}post(t,e,s){return this.request(Object.assign(Object.assign({},s),{method:c.POST,url:t,body:e}))}put(t,e,s){return this.request(Object.assign(Object.assign({},s),{method:c.PUT,url:t,body:e}))}patch(t,e,s){return this.request(Object.assign(Object.assign({},s),{method:c.PATCH,url:t,body:e}))}delete(t,e){return this.request(Object.assign(Object.assign({},e),{method:c.DELETE,url:t}))}head(t,e){return this.request(Object.assign(Object.assign({},e),{method:c.HEAD,url:t}))}options(t,e){return this.request(Object.assign(Object.assign({},e),{method:c.OPTIONS,url:t}))}upload(r,o,n){const a=(null==n?void 0:n.body)?s(n.body):new FormData;let i=(null==n?void 0:n.name)||"file";if(Array.isArray(o)?(i.endsWith("[]")&&(i=i.slice(0,-2)),o.forEach((t,e)=>{a.append(`${i}[${e}]`,t,t.name)})):t(o)?(i.endsWith("[]")&&(i=i.slice(0,-2)),Array.from(o).forEach((t,e)=>{a.append(`${i}[${e}]`,t,t.name)})):a.append(i,o,o.name),null==n?void 0:n.body){const t=e(n.body);Object.entries(t).forEach(([t,e])=>{null!=e&&a.append(t,String(e))})}return(null==n?void 0:n.onProgress)&&"undefined"!=typeof XMLHttpRequest?new Promise(async t=>{try{let e=Object.assign(Object.assign({},n),{method:c.POST,url:r,body:a});const s=[...u.interceptors.request,...this.interceptors.request];for(const t of s)e=await t(e);const o=this.getURL(e),i=this.getHeaders(e.headers||{},!0),l=new XMLHttpRequest;l.upload.addEventListener("progress",t=>{var e;if(t.lengthComputable){const s=Math.round(t.loaded/t.total*100);null===(e=n.onProgress)||void 0===e||e.call(n,{loaded:t.loaded,total:t.total,percentage:s})}}),l.addEventListener("load",async()=>{try{const e=l.getResponseHeader("Content-Type")||"";let s=null;s=e.includes("application/json")?JSON.parse(l.responseText):l.responseText;const r=[...u.interceptors.transform,...this.interceptors.transform];let o=s;for(const t of r)o=await t(o);const n=[...u.interceptors.response,...this.interceptors.response];let a=new Response(l.responseText,{status:l.status,statusText:l.statusText,headers:i});for(const t of n)a=await t(a);const c={};a.headers.forEach((t,e)=>{c[e]=t});const d=a.ok;t({data:o,success:d,error:d?null:o,status:a.status,statusText:a.statusText,headers:c})}catch(e){const s=[...u.interceptors.error,...this.interceptors.error];for(const t of s)t(e);t({data:null,status:0,statusText:"Error",headers:{},error:e,success:!1})}}),l.addEventListener("error",e=>{const s=[...u.interceptors.error,...this.interceptors.error];for(const t of s)t(e);t({data:null,status:0,statusText:"Error",headers:{},error:e,success:!1})}),l.addEventListener("abort",()=>{t({data:null,status:0,statusText:"Aborted",headers:{},error:null,success:!1})}),l.open(e.method||c.POST,o,!0),Object.entries(i).forEach(([t,e])=>{"content-type"!==(null==t?void 0:t.toLowerCase())&&e&&l.setRequestHeader(t,e)}),l.send(e.body)}catch(e){const s=[...u.interceptors.error,...this.interceptors.error];for(const t of s)t(e);t({data:null,status:0,statusText:"Error",headers:{},error:e,success:!1})}}):this.request({method:c.POST,url:r,body:a,headers:null==n?void 0:n.headers,params:null==n?void 0:n.params,signal:null==n?void 0:n.signal,query:null==n?void 0:n.query})}static createFactory(t={}){const s=t.http||new u(t.baseURL);return function(r,o){const n=e("function"==typeof t.endpoint?t.endpoint():t.endpoint||{})[r];return{key:r,fn:async(...e)=>{const r="function"==typeof t.storage?await t.storage():t.storage;switch(r&&s.setStorage(r),o){case c.POST:return await s.post(n,...e);case c.PUT:return await s.put(n,...e);case c.PATCH:return await s.patch(n,...e);case c.DELETE:return await s.delete(n,...e);case c.HEAD:return await s.head(n,...e);case c.OPTIONS:return await s.options(n,...e);case"UPLOAD":return await s.upload(n,...e);default:return await s.get(n,...e)}}}}}}u.method=c,u.authTokenKey="access_token",u.authHeaderKey="Authorization",u.authHeaderType="Bearer",u.authDetectToken=["localStorage","sessionStorage","cookie"],u.extraHeaders=null,u.storage=null,u.interceptors={request:[],response:[],transform:[],error:[]};export{a as API_AUTH_HEADER_KEY,i as API_AUTH_HEADER_TYPE,n as API_AUTH_TOKEN_KEY,o as DEFAULT_BASE_URL,u as Http,c as HttpMethod};

package/dist/index.d.ts

@@ -1,4 +1,17 @@
+export * from "./http";
+export * from "./logger";
+export * from "./searchify";
+export * from "./serialize";
+export * from "./slugify";
 export * from "./subscriber";
+export * from "./syhemo";
 export * from "./utilities";
+export type * from "./http";
+export type * from "./logger";
+export type * from "./searchify";
+export type * from "./serialize";
+export type * from "./slugify";
 export type * from "./subscriber";
+export type * from "./syhemo";
 export type * from "./utilities";
+export type * from "./types";

package/dist/index.js

@@ -1 +1 @@
-"use strict";var e=require("./subscriber.js"),i=require("./utilities/clone.js"),r=require("./utilities/freeze.js"),s=require("./utilities/is-equal.js"),t=require("./utilities/is-function.js"),u=require("./utilities/object.js"),o=require("./utilities/merge.js"),c=require("./utilities/to-string.js"),l=require("./utilities/ucfirst.js");exports.Subscriber=e.Subscriber,exports.clone=i.clone,exports.freeze=r.freeze,exports.isEqual=s.isEqual,exports.isFunction=t.isFunction,exports.hasOwnProperty=u.hasOwnProperty,exports.isComplexObject=u.isComplexObject,exports.isLiteralObject=u.isLiteralObject,exports.isObject=u.isObject,exports.isObjectable=u.isObjectable,exports.merge=o.merge,exports.toString=c.toString,exports.ucfirst=l.ucfirst;
+"use strict";var e=require("./http.js"),t=require("./logger.js");require("./searchify.js");var r=require("./serialize.js"),s=require("./slugify.js"),i=require("./subscriber.js"),o=require("./syhemo.js"),u=require("./utilities/clone.js"),p=require("./utilities/defer.js"),l=require("./utilities/filelist.js"),a=require("./utilities/flatten.js"),x=require("./utilities/freeze.js"),c=require("./utilities/get.js"),j=require("./utilities/is-equal.js"),b=require("./utilities/is-function.js"),A=require("./utilities/object.js"),n=require("./utilities/merge.js"),q=require("./utilities/object-to-formdata.js"),E=require("./utilities/pascal-to-kebab.js"),f=require("./utilities/to-string.js"),_=require("./utilities/ucfirst.js");exports.API_AUTH_HEADER_KEY=e.API_AUTH_HEADER_KEY,exports.API_AUTH_HEADER_TYPE=e.API_AUTH_HEADER_TYPE,exports.API_AUTH_TOKEN_KEY=e.API_AUTH_TOKEN_KEY,exports.DEFAULT_BASE_URL=e.DEFAULT_BASE_URL,exports.Http=e.Http,Object.defineProperty(exports,"HttpMethod",{enumerable:!0,get:function(){return e.HttpMethod}}),exports.Logger=t.Logger,exports.Serialize=r.Serialize,exports.DEFAULT_TRANSFORMER=s.DEFAULT_TRANSFORMER,exports.slugify=s.slugify,exports.Subscriber=i.Subscriber,exports.Syhemo=o.Syhemo,exports.recordHttpRequest=o.recordHttpRequest,exports.clone=u.clone,exports.defer=p.defer,exports.deferAsync=p.deferAsync,exports.isFileList=l.isFileList,exports.escapeRegexKey=a.escapeRegexKey,exports.flatten=a.flatten,exports.flattenToArray=a.flattenToArray,exports.freeze=x.freeze,exports.get=c.get,exports.isEqual=j.isEqual,exports.isFunction=b.isFunction,exports.hasOwnProperty=A.hasOwnProperty,exports.isComplexObject=A.isComplexObject,exports.isLiteralObject=A.isLiteralObject,exports.isObject=A.isObject,exports.isObjectable=A.isObjectable,exports.merge=n.merge,exports.objectToFormData=q.objectToFormData,exports.pascalToKebab=E.pascalToKebab,exports.toString=f.toString,exports.ucfirst=_.ucfirst;

package/dist/index.mjs

@@ -1 +1 @@
-export{Subscriber}from"./subscriber.mjs";export{clone}from"./utilities/clone.mjs";export{freeze}from"./utilities/freeze.mjs";export{isEqual}from"./utilities/is-equal.mjs";export{isFunction}from"./utilities/is-function.mjs";export{hasOwnProperty,isComplexObject,isLiteralObject,isObject,isObjectable}from"./utilities/object.mjs";export{merge}from"./utilities/merge.mjs";export{toString}from"./utilities/to-string.mjs";export{ucfirst}from"./utilities/ucfirst.mjs";
+export{API_AUTH_HEADER_KEY,API_AUTH_HEADER_TYPE,API_AUTH_TOKEN_KEY,DEFAULT_BASE_URL,Http,HttpMethod}from"./http.mjs";export{Logger}from"./logger.mjs";import"./searchify.mjs";export{Serialize}from"./serialize.mjs";export{DEFAULT_TRANSFORMER,slugify}from"./slugify.mjs";export{Subscriber}from"./subscriber.mjs";export{Syhemo,recordHttpRequest}from"./syhemo.mjs";export{clone}from"./utilities/clone.mjs";export{defer,deferAsync}from"./utilities/defer.mjs";export{isFileList}from"./utilities/filelist.mjs";export{escapeRegexKey,flatten,flattenToArray}from"./utilities/flatten.mjs";export{freeze}from"./utilities/freeze.mjs";export{get}from"./utilities/get.mjs";export{isEqual}from"./utilities/is-equal.mjs";export{isFunction}from"./utilities/is-function.mjs";export{hasOwnProperty,isComplexObject,isLiteralObject,isObject,isObjectable}from"./utilities/object.mjs";export{merge}from"./utilities/merge.mjs";export{objectToFormData}from"./utilities/object-to-formdata.mjs";export{pascalToKebab}from"./utilities/pascal-to-kebab.mjs";export{toString}from"./utilities/to-string.mjs";export{ucfirst}from"./utilities/ucfirst.mjs";

package/dist/logger.d.ts

@@ -0,0 +1,66 @@
+/** Log severity level. */
+export type LogLevel = "LOG" | "WARN" | "ERROR" | "DEBUG" | "VERBOSE";
+/** A buffered log entry stored in the shared global log buffer. */
+export interface LogEntry {
+    /** Unix timestamp in milliseconds. */
+    timestamp: number;
+    /** Severity level of the log entry. */
+    level: LogLevel;
+    /** Logger context name (e.g. module or class name). */
+    context: string;
+    /** The logged message. */
+    message: string;
+}
+/**
+ * Isomorphic logger with color-coded output.
+ *
+ * - **Server (Node.js)**: Uses ANSI escape codes for terminal coloring.
+ * - **Browser**: Uses `%c` CSS formatting for DevTools console.
+ *
+ * All log entries are buffered in a shared `globalThis` store so that
+ * {@link Syhemo} can collect them for monitoring.
+ *
+ * @example
+ * ```ts
+ * const logger = new Logger("MyModule");
+ * logger.log("Server started on port 3000");
+ * logger.warn("Deprecated API used");
+ * logger.error("Connection failed", error);
+ * logger.debug("Payload:", data);
+ * ```
+ */
+export declare class Logger {
+    private readonly context;
+    /**
+     * @param context - Label shown in log output, e.g. `[MyModule]`.
+     *                  Defaults to `"@ecosy"`.
+     */
+    constructor(context?: string);
+    private format;
+    private formatServer;
+    private formatBrowser;
+    /** Log a message at the `LOG` level (green). */
+    log(message: string, ...args: unknown[]): void;
+    /** Log a message at the `WARN` level (yellow). */
+    warn(message: string, ...args: unknown[]): void;
+    /** Log a message at the `ERROR` level (red). */
+    error(message: string, ...args: unknown[]): void;
+    /** Log a message at the `DEBUG` level (magenta). */
+    debug(message: string, ...args: unknown[]): void;
+    /** Log a message at the `VERBOSE` level (cyan). */
+    verbose(message: string, ...args: unknown[]): void;
+    /**
+     * Returns a shallow copy of all buffered log entries (non-destructive).
+     * Used by {@link Syhemo} to collect logs for monitoring snapshots.
+     */
+    static getLogs(): LogEntry[];
+    /**
+     * Returns the current error, warn, and total log counts, then resets
+     * the counters to zero. Used by {@link Syhemo} for per-interval log rate tracking.
+     */
+    static drainCounts(): {
+        errors: number;
+        warns: number;
+        total: number;
+    };
+}

package/dist/logger.js

@@ -0,0 +1 @@
+"use strict";const o=()=>"undefined"==typeof window,t="",r="",e="",n="",s={LOG:"color:#22c55e;font-weight:bold",WARN:"color:#eab308;font-weight:bold",ERROR:"color:#ef4444;font-weight:bold",DEBUG:"color:#a855f7;font-weight:bold",VERBOSE:"color:#06b6d4;font-weight:bold"},c="color:inherit;font-weight:normal",a={LOG:"color:#22c55e",WARN:"color:#eab308",ERROR:"color:#ef4444",DEBUG:"color:#a855f7",VERBOSE:"color:#06b6d4"};function i(){return(new Date).toLocaleString("en-US",{month:"2-digit",day:"2-digit",year:"numeric",hour:"2-digit",minute:"2-digit",second:"2-digit",hour12:!0})}const f={LOG:"",WARN:e,ERROR:"",DEBUG:"",VERBOSE:""},l=Symbol.for("@ecosy:logger"),m=globalThis;m[l]||(m[l]={buffer:[],errors:0,warns:0,total:0});const R=m[l];exports.Logger=class{constructor(o="@ecosy"){this.context=o}format(t,r,...e){const n="ERROR"===t?console.error:"WARN"===t?console.warn:console.log;R.buffer.push({timestamp:Date.now(),level:t,context:this.context,message:r}),R.buffer.length>200&&R.buffer.shift(),R.total++,"ERROR"===t&&R.errors++,"WARN"===t&&R.warns++,o()?this.formatServer(n,t,r,...e):this.formatBrowser(n,t,r,...e)}formatServer(s,c,a,...l){const m=f[c],R=`${n}${i()}${t}`;s(`${`${m}${r}${c.padEnd(7)}${t}`} ${`${e}${o()&&"undefined"!=typeof process?process.pid:0}${t}`}  - ${R}     ${`${e}[${this.context}]${t}`} ${`${m}${a}${t}`}`,...l)}formatBrowser(o,t,r,...e){o(`%c${t.padEnd(7)}%c  - %c${i()}%c     %c[${this.context}]%c %c${r}`,s[t],c,"color:#9ca3af;font-weight:normal",c,"color:#eab308;font-weight:normal",c,a[t],...e)}log(o,...t){this.format("LOG",o,...t)}warn(o,...t){this.format("WARN",o,...t)}error(o,...t){this.format("ERROR",o,...t)}debug(o,...t){this.format("DEBUG",o,...t)}verbose(o,...t){this.format("VERBOSE",o,...t)}static getLogs(){return[...R.buffer]}static drainCounts(){const o={errors:R.errors,warns:R.warns,total:R.total};return R.errors=0,R.warns=0,R.total=0,o}};

package/dist/logger.mjs

@@ -0,0 +1 @@
+const o=()=>"undefined"==typeof window,t="",r="",e="",n="",s={LOG:"color:#22c55e;font-weight:bold",WARN:"color:#eab308;font-weight:bold",ERROR:"color:#ef4444;font-weight:bold",DEBUG:"color:#a855f7;font-weight:bold",VERBOSE:"color:#06b6d4;font-weight:bold"},c="color:inherit;font-weight:normal",a={LOG:"color:#22c55e",WARN:"color:#eab308",ERROR:"color:#ef4444",DEBUG:"color:#a855f7",VERBOSE:"color:#06b6d4"};function i(){return(new Date).toLocaleString("en-US",{month:"2-digit",day:"2-digit",year:"numeric",hour:"2-digit",minute:"2-digit",second:"2-digit",hour12:!0})}const f={LOG:"",WARN:e,ERROR:"",DEBUG:"",VERBOSE:""},l=Symbol.for("@ecosy:logger"),m=globalThis;m[l]||(m[l]={buffer:[],errors:0,warns:0,total:0});const R=m[l];class h{constructor(o="@ecosy"){this.context=o}format(t,r,...e){const n="ERROR"===t?console.error:"WARN"===t?console.warn:console.log;R.buffer.push({timestamp:Date.now(),level:t,context:this.context,message:r}),R.buffer.length>200&&R.buffer.shift(),R.total++,"ERROR"===t&&R.errors++,"WARN"===t&&R.warns++,o()?this.formatServer(n,t,r,...e):this.formatBrowser(n,t,r,...e)}formatServer(s,c,a,...l){const m=f[c],R=`${n}${i()}${t}`;s(`${`${m}${r}${c.padEnd(7)}${t}`} ${`${e}${o()&&"undefined"!=typeof process?process.pid:0}${t}`}  - ${R}     ${`${e}[${this.context}]${t}`} ${`${m}${a}${t}`}`,...l)}formatBrowser(o,t,r,...e){o(`%c${t.padEnd(7)}%c  - %c${i()}%c     %c[${this.context}]%c %c${r}`,s[t],c,"color:#9ca3af;font-weight:normal",c,"color:#eab308;font-weight:normal",c,a[t],...e)}log(o,...t){this.format("LOG",o,...t)}warn(o,...t){this.format("WARN",o,...t)}error(o,...t){this.format("ERROR",o,...t)}debug(o,...t){this.format("DEBUG",o,...t)}verbose(o,...t){this.format("VERBOSE",o,...t)}static getLogs(){return[...R.buffer]}static drainCounts(){const o={errors:R.errors,warns:R.warns,total:R.total};return R.errors=0,R.warns=0,R.total=0,o}}export{h as Logger};

package/dist/searchify.d.ts

@@ -0,0 +1,35 @@
+/** Position of a match within the original string. */
+export interface SearchPosition {
+    /** Start index in the original string. */
+    start: number;
+    /** Length of the matched substring. */
+    length: number;
+}
+/** Result of a {@link searchify} call. */
+export interface SearchResult {
+    /** Array of matched substrings from the original string. */
+    matches: string[];
+    /** Corresponding positions for each match. */
+    positions: SearchPosition[];
+}
+/**
+ * Performs a diacritic-insensitive fuzzy search by comparing slugified characters.
+ * Returns all matching substrings and their positions in the original string.
+ *
+ * Uses a **sliding window** algorithm with per-character slugification cache
+ * for optimal performance on repeated characters.
+ *
+ * @param original - The original string to search within.
+ * @param searchStr - The search term (will be slugified for comparison).
+ * @returns A {@link SearchResult} with matched substrings and their positions.
+ *
+ * @example
+ * ```ts
+ * searchify("Xin Chào Việt Nam", "viet");
+ * // { matches: ["Việt"], positions: [{ start: 9, length: 4 }] }
+ *
+ * searchify("Crème Brûlée", "brulee");
+ * // { matches: ["Brûlée"], positions: [{ start: 6, length: 6 }] }
+ * ```
+ */
+export default function searchify(original: string, searchStr: string): SearchResult;

package/dist/searchify.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("./slugify.js");const t={separator:"",silent:!0,transformer:Object.assign({},e.DEFAULT_TRANSFORMER)};exports.default=function(i,s){const n=e.slugify(s,t),r=n.length,o={matches:[],positions:[]};if(!r)return o;const l=new Map,g=[...i.split("")].map((i,s)=>{let n=l.get(i);return void 0===n&&(n=e.slugify(i,t),l.set(i,n)),{originIndex:s,slugified:n,char:i}}).filter((e,t,i)=>0===t||(" "!==e.char||" "!==i[t-1].char));if(g.length<r)return o;for(let e=0;e<g.length;){const t=g[e];if(""===t.slugified){e++;continue}let s="",l=e,u=!0;for(;s.length<r&&l<g.length;){const e=g[l];if(""!==e.slugified&&(s+=e.slugified,!n.startsWith(s))){u=!1;break}l++}if(u&&s===n){const s=g[l-1],n=i.substring(t.originIndex,s.originIndex+1);o.matches.push(n),o.positions.push({start:t.originIndex,length:n.length}),e=l}else e++}return o};