bytekit 0.1.12

package/dist/utils/helpers/ObjectUtils.js

@@ -0,0 +1,297 @@
+/**
+ * Object manipulation utilities for everyday development tasks
+ */
+export class ObjectUtils {
+    /**
+     * Check if value is empty (null, undefined, empty string, empty array, empty object)
+     */
+    static isEmpty(value) {
+        if (value === null || value === undefined)
+            return true;
+        if (typeof value === "string")
+            return value.trim().length === 0;
+        if (Array.isArray(value))
+            return value.length === 0;
+        if (value instanceof Map || value instanceof Set)
+            return value.size === 0;
+        if (typeof value === "object") {
+            return Object.keys(value).length === 0;
+        }
+        return false;
+    }
+    /**
+     * Check if value is NOT empty
+     */
+    static isNotEmpty(value) {
+        return !this.isEmpty(value);
+    }
+    /**
+     * Deep clone an object
+     */
+    static deepClone(obj) {
+        if (obj === null || typeof obj !== "object")
+            return obj;
+        if (obj instanceof Date)
+            return new Date(obj.getTime());
+        if (obj instanceof Array) {
+            return obj.map((item) => this.deepClone(item));
+        }
+        if (obj instanceof Object) {
+            const cloned = {};
+            for (const key in obj) {
+                if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                    cloned[key] = this.deepClone(obj[key]);
+                }
+            }
+            return cloned;
+        }
+        return obj;
+    }
+    /**
+     * Shallow merge objects (right overwrites left)
+     */
+    static merge(...objects) {
+        return objects.reduce((acc, obj) => ({ ...acc, ...obj }), {});
+    }
+    /**
+     * Deep merge objects (recursive)
+     */
+    static deepMerge(...objects) {
+        return objects.reduce((acc, obj) => {
+            for (const key in obj) {
+                if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                    const accValue = acc[key];
+                    const objValue = obj[key];
+                    if (typeof accValue === "object" &&
+                        accValue !== null &&
+                        !Array.isArray(accValue) &&
+                        typeof objValue === "object" &&
+                        objValue !== null &&
+                        !Array.isArray(objValue)) {
+                        acc[key] = this.deepMerge(accValue, objValue);
+                    }
+                    else {
+                        acc[key] = objValue;
+                    }
+                }
+            }
+            return acc;
+        }, {});
+    }
+    /**
+     * Pick specific keys from object
+     */
+    static pick(obj, keys) {
+        const result = {};
+        for (const key of keys) {
+            if (key in obj) {
+                result[key] = obj[key];
+            }
+        }
+        return result;
+    }
+    /**
+     * Omit specific keys from object
+     */
+    static omit(obj, keys) {
+        const result = { ...obj };
+        for (const key of keys) {
+            delete result[key];
+        }
+        return result;
+    }
+    /**
+     * Get nested value using dot notation
+     */
+    static get(obj, path, defaultValue) {
+        const keys = path.split(".");
+        let value = obj;
+        for (const key of keys) {
+            if (value && typeof value === "object" && key in value) {
+                value = value[key];
+            }
+            else {
+                return defaultValue;
+            }
+        }
+        return value;
+    }
+    /**
+     * Set nested value using dot notation
+     */
+    static set(obj, path, value) {
+        const keys = path.split(".");
+        let current = obj;
+        for (let i = 0; i < keys.length - 1; i++) {
+            const key = keys[i];
+            if (!(key in current) || typeof current[key] !== "object") {
+                current[key] = {};
+            }
+            current = current[key];
+        }
+        current[keys[keys.length - 1]] = value;
+        return obj;
+    }
+    /**
+     * Flatten nested object
+     */
+    static flatten(obj, prefix = "") {
+        const result = {};
+        for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                const value = obj[key];
+                const newKey = prefix ? `${prefix}.${key}` : key;
+                if (value &&
+                    typeof value === "object" &&
+                    !Array.isArray(value) &&
+                    !(value instanceof Date)) {
+                    Object.assign(result, this.flatten(value, newKey));
+                }
+                else {
+                    result[newKey] = value;
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Unflatten object (reverse of flatten)
+     */
+    static unflatten(obj) {
+        const result = {};
+        for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                this.set(result, key, obj[key]);
+            }
+        }
+        return result;
+    }
+    /**
+     * Filter object by predicate
+     */
+    static filter(obj, predicate) {
+        const result = {};
+        for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key) &&
+                predicate(key, obj[key])) {
+                result[key] = obj[key];
+            }
+        }
+        return result;
+    }
+    /**
+     * Map object values
+     */
+    static mapValues(obj, mapper) {
+        const result = {};
+        for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                result[key] = mapper(obj[key], key);
+            }
+        }
+        return result;
+    }
+    /**
+     * Check if object has all keys
+     */
+    static hasKeys(obj, keys) {
+        return keys.every((key) => key in obj);
+    }
+    /**
+     * Check if object has any of the keys
+     */
+    static hasAnyKey(obj, keys) {
+        return keys.some((key) => key in obj);
+    }
+    /**
+     * Invert object keys and values
+     */
+    static invert(obj) {
+        const result = {};
+        for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                result[obj[key]] = key;
+            }
+        }
+        return result;
+    }
+    /**
+     * Group array of objects by key
+     */
+    static groupBy(arr, key) {
+        return arr.reduce((acc, item) => {
+            const groupKey = String(item[key]);
+            if (!acc[groupKey]) {
+                acc[groupKey] = [];
+            }
+            acc[groupKey].push(item);
+            return acc;
+        }, {});
+    }
+    /**
+     * Index array of objects by key
+     */
+    static indexBy(arr, key) {
+        return arr.reduce((acc, item) => {
+            acc[String(item[key])] = item;
+            return acc;
+        }, {});
+    }
+    /**
+     * Check if two objects are deeply equal
+     */
+    static deepEqual(a, b) {
+        if (a === b)
+            return true;
+        if (a === null || b === null)
+            return a === b;
+        if (typeof a !== "object" || typeof b !== "object")
+            return false;
+        const aKeys = Object.keys(a);
+        const bKeys = Object.keys(b);
+        if (aKeys.length !== bKeys.length)
+            return false;
+        for (const key of aKeys) {
+            if (!bKeys.includes(key))
+                return false;
+            if (!this.deepEqual(a[key], b[key])) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Get object size (number of keys)
+     */
+    static size(obj) {
+        return Object.keys(obj).length;
+    }
+    /**
+     * Convert object to array of [key, value] pairs
+     */
+    static entries(obj) {
+        return Object.entries(obj);
+    }
+    /**
+     * Convert array of [key, value] pairs to object
+     */
+    static fromEntries(entries) {
+        return Object.fromEntries(entries);
+    }
+    /**
+     * Assign properties from source to target (like Object.assign)
+     */
+    static assign(target, ...sources) {
+        return Object.assign(target, ...sources);
+    }
+    /**
+     * Create object from keys with same value
+     */
+    static fromKeys(keys, value) {
+        return keys.reduce((acc, key) => {
+            acc[key] = value;
+            return acc;
+        }, {});
+    }
+}
+//# sourceMappingURL=ObjectUtils.js.map

package/dist/utils/helpers/ObjectUtils.js.map

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

package/dist/utils/helpers/PaginationHelper.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Pagination helper for managing paginated data
+ * Supports offset-limit and cursor-based pagination
+ */
+export type PaginationMode = "offset" | "cursor";
+export interface PaginationState {
+    currentPage: number;
+    pageSize: number;
+    total: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+}
+export interface CursorPaginationState {
+    cursor?: string;
+    nextCursor?: string;
+    previousCursor?: string;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+}
+/**
+ * Pagination helper for managing paginated data
+ */
+export declare class PaginationHelper<T = unknown> {
+    private items;
+    private pageSize;
+    private mode;
+    private currentPage;
+    private currentCursor?;
+    private cursorMap;
+    constructor(items: T[], options?: {
+        pageSize?: number;
+        mode?: PaginationMode;
+    });
+    /**
+     * Get current page (offset mode)
+     */
+    getCurrentPage(): T[];
+    /**
+     * Get current page by cursor (cursor mode)
+     */
+    getCurrentPageByCursor(): T[];
+    /**
+     * Go to next page (offset mode)
+     */
+    next(): T[];
+    /**
+     * Go to next page by cursor (cursor mode)
+     */
+    nextByCursor(): T[];
+    /**
+     * Go to previous page (offset mode)
+     */
+    previous(): T[];
+    /**
+     * Go to previous page by cursor (cursor mode)
+     */
+    previousByCursor(): T[];
+    /**
+     * Go to specific page (offset mode)
+     */
+    goToPage(page: number): T[];
+    /**
+     * Go to specific cursor (cursor mode)
+     */
+    goToCursor(cursor: string): T[];
+    /**
+     * Check if has next page
+     */
+    hasNextPage(): boolean;
+    /**
+     * Check if has previous page
+     */
+    hasPreviousPage(): boolean;
+    /**
+     * Get total pages (offset mode)
+     */
+    getTotalPages(): number;
+    /**
+     * Get total items
+     */
+    getTotalItems(): number;
+    /**
+     * Get current page number (offset mode)
+     */
+    getCurrentPageNumber(): number;
+    /**
+     * Get pagination state (offset mode)
+     */
+    getState(): PaginationState;
+    /**
+     * Get cursor pagination state (cursor mode)
+     */
+    getCursorState(): CursorPaginationState;
+    /**
+     * Reset to first page
+     */
+    reset(): void;
+    /**
+     * Set page size
+     */
+    setPageSize(size: number): void;
+    /**
+     * Generate cursor from index
+     */
+    private generateCursor;
+    /**
+     * Decode cursor to index
+     */
+    private decodeCursor;
+    /**
+     * Get all items
+     */
+    getAllItems(): T[];
+    /**
+     * Update items
+     */
+    setItems(items: T[]): void;
+}
+/**
+ * Factory function for creating paginators
+ */
+export declare function createPaginator<T = unknown>(items: T[], options?: {
+    pageSize?: number;
+    mode?: PaginationMode;
+}): PaginationHelper<T>;
+//# sourceMappingURL=PaginationHelper.d.ts.map

package/dist/utils/helpers/PaginationHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaginationHelper.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/PaginationHelper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,gBAAgB,CAAC,CAAC,GAAG,OAAO;IACrC,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAkC;gBAG/C,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,cAAc,CAAA;KAAO;IAO9D;;OAEG;IACH,cAAc,IAAI,CAAC,EAAE;IAUrB;;OAEG;IACH,sBAAsB,IAAI,CAAC,EAAE;IAa7B;;OAEG;IACH,IAAI,IAAI,CAAC,EAAE;IAWX;;OAEG;IACH,YAAY,IAAI,CAAC,EAAE;IAkBnB;;OAEG;IACH,QAAQ,IAAI,CAAC,EAAE;IAWf;;OAEG;IACH,gBAAgB,IAAI,CAAC,EAAE;IAkBvB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE;IAW3B;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE;IAW/B;;OAEG;IACH,WAAW,IAAI,OAAO;IAWtB;;OAEG;IACH,eAAe,IAAI,OAAO;IAW1B;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;OAEG;IACH,QAAQ,IAAI,eAAe;IAW3B;;OAEG;IACH,cAAc,IAAI,qBAAqB;IAsBvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM/B;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,WAAW,IAAI,CAAC,EAAE;IAIlB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI;CAI7B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EACvC,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,cAAc,CAAA;CAAE,GACvD,gBAAgB,CAAC,CAAC,CAAC,CAErB"}

package/dist/utils/helpers/PaginationHelper.js

@@ -0,0 +1,259 @@
+/**
+ * Pagination helper for managing paginated data
+ * Supports offset-limit and cursor-based pagination
+ */
+/**
+ * Pagination helper for managing paginated data
+ */
+export class PaginationHelper {
+    items;
+    pageSize;
+    mode;
+    currentPage = 1;
+    currentCursor;
+    cursorMap = new Map();
+    constructor(items, options = {}) {
+        this.items = items;
+        this.pageSize = options.pageSize ?? 10;
+        this.mode = options.mode ?? "offset";
+    }
+    /**
+     * Get current page (offset mode)
+     */
+    getCurrentPage() {
+        if (this.mode === "cursor") {
+            throw new Error("Use getCurrentPageByCursor() in cursor mode");
+        }
+        const start = (this.currentPage - 1) * this.pageSize;
+        const end = start + this.pageSize;
+        return this.items.slice(start, end);
+    }
+    /**
+     * Get current page by cursor (cursor mode)
+     */
+    getCurrentPageByCursor() {
+        if (this.mode === "offset") {
+            throw new Error("Use getCurrentPage() in offset mode");
+        }
+        const cursorIndex = this.currentCursor
+            ? this.cursorMap.get(this.currentCursor) ?? 0
+            : 0;
+        const start = cursorIndex;
+        const end = start + this.pageSize;
+        return this.items.slice(start, end);
+    }
+    /**
+     * Go to next page (offset mode)
+     */
+    next() {
+        if (this.mode === "cursor") {
+            throw new Error("Use nextByCursor() in cursor mode");
+        }
+        if (this.hasNextPage()) {
+            this.currentPage++;
+        }
+        return this.getCurrentPage();
+    }
+    /**
+     * Go to next page by cursor (cursor mode)
+     */
+    nextByCursor() {
+        if (this.mode === "offset") {
+            throw new Error("Use next() in offset mode");
+        }
+        const currentIndex = this.currentCursor
+            ? this.cursorMap.get(this.currentCursor) ?? 0
+            : 0;
+        const nextIndex = currentIndex + this.pageSize;
+        if (nextIndex < this.items.length) {
+            this.currentCursor = this.generateCursor(nextIndex);
+            this.cursorMap.set(this.currentCursor, nextIndex);
+        }
+        return this.getCurrentPageByCursor();
+    }
+    /**
+     * Go to previous page (offset mode)
+     */
+    previous() {
+        if (this.mode === "cursor") {
+            throw new Error("Use previousByCursor() in cursor mode");
+        }
+        if (this.hasPreviousPage()) {
+            this.currentPage--;
+        }
+        return this.getCurrentPage();
+    }
+    /**
+     * Go to previous page by cursor (cursor mode)
+     */
+    previousByCursor() {
+        if (this.mode === "offset") {
+            throw new Error("Use previous() in offset mode");
+        }
+        const currentIndex = this.currentCursor
+            ? this.cursorMap.get(this.currentCursor) ?? 0
+            : 0;
+        const previousIndex = Math.max(0, currentIndex - this.pageSize);
+        if (previousIndex >= 0) {
+            this.currentCursor = this.generateCursor(previousIndex);
+            this.cursorMap.set(this.currentCursor, previousIndex);
+        }
+        return this.getCurrentPageByCursor();
+    }
+    /**
+     * Go to specific page (offset mode)
+     */
+    goToPage(page) {
+        if (this.mode === "cursor") {
+            throw new Error("Use goToCursor() in cursor mode");
+        }
+        if (page < 1)
+            page = 1;
+        if (page > this.getTotalPages())
+            page = this.getTotalPages();
+        this.currentPage = page;
+        return this.getCurrentPage();
+    }
+    /**
+     * Go to specific cursor (cursor mode)
+     */
+    goToCursor(cursor) {
+        if (this.mode === "offset") {
+            throw new Error("Use goToPage() in offset mode");
+        }
+        if (this.cursorMap.has(cursor)) {
+            this.currentCursor = cursor;
+        }
+        return this.getCurrentPageByCursor();
+    }
+    /**
+     * Check if has next page
+     */
+    hasNextPage() {
+        if (this.mode === "offset") {
+            return this.currentPage < this.getTotalPages();
+        }
+        const currentIndex = this.currentCursor
+            ? this.cursorMap.get(this.currentCursor) ?? 0
+            : 0;
+        return currentIndex + this.pageSize < this.items.length;
+    }
+    /**
+     * Check if has previous page
+     */
+    hasPreviousPage() {
+        if (this.mode === "offset") {
+            return this.currentPage > 1;
+        }
+        const currentIndex = this.currentCursor
+            ? this.cursorMap.get(this.currentCursor) ?? 0
+            : 0;
+        return currentIndex > 0;
+    }
+    /**
+     * Get total pages (offset mode)
+     */
+    getTotalPages() {
+        return Math.ceil(this.items.length / this.pageSize);
+    }
+    /**
+     * Get total items
+     */
+    getTotalItems() {
+        return this.items.length;
+    }
+    /**
+     * Get current page number (offset mode)
+     */
+    getCurrentPageNumber() {
+        return this.currentPage;
+    }
+    /**
+     * Get pagination state (offset mode)
+     */
+    getState() {
+        return {
+            currentPage: this.currentPage,
+            pageSize: this.pageSize,
+            total: this.items.length,
+            totalPages: this.getTotalPages(),
+            hasNextPage: this.hasNextPage(),
+            hasPreviousPage: this.hasPreviousPage(),
+        };
+    }
+    /**
+     * Get cursor pagination state (cursor mode)
+     */
+    getCursorState() {
+        const currentIndex = this.currentCursor
+            ? this.cursorMap.get(this.currentCursor) ?? 0
+            : 0;
+        const nextIndex = currentIndex + this.pageSize;
+        const previousIndex = Math.max(0, currentIndex - this.pageSize);
+        return {
+            cursor: this.currentCursor,
+            nextCursor: nextIndex < this.items.length
+                ? this.generateCursor(nextIndex)
+                : undefined,
+            previousCursor: previousIndex > 0
+                ? this.generateCursor(previousIndex)
+                : undefined,
+            hasNextPage: nextIndex < this.items.length,
+            hasPreviousPage: currentIndex > 0,
+        };
+    }
+    /**
+     * Reset to first page
+     */
+    reset() {
+        this.currentPage = 1;
+        this.currentCursor = undefined;
+        this.cursorMap.clear();
+    }
+    /**
+     * Set page size
+     */
+    setPageSize(size) {
+        if (size <= 0)
+            throw new Error("Page size must be greater than 0");
+        this.pageSize = size;
+        this.reset();
+    }
+    /**
+     * Generate cursor from index
+     */
+    generateCursor(index) {
+        return Buffer.from(index.toString()).toString("base64");
+    }
+    /**
+     * Decode cursor to index
+     */
+    decodeCursor(cursor) {
+        try {
+            return parseInt(Buffer.from(cursor, "base64").toString(), 10);
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * Get all items
+     */
+    getAllItems() {
+        return [...this.items];
+    }
+    /**
+     * Update items
+     */
+    setItems(items) {
+        this.items = items;
+        this.reset();
+    }
+}
+/**
+ * Factory function for creating paginators
+ */
+export function createPaginator(items, options) {
+    return new PaginationHelper(items, options);
+}
+//# sourceMappingURL=PaginationHelper.js.map