@kidus.dev/flowdb 1.0.0

package/dist/tools/print_colored.d.ts

@@ -0,0 +1,47 @@
+export declare enum PrintColor {
+    red = 31,
+    green = 32,
+    yellow = 33,
+    blue = 34,
+    magenta = 35,
+    white = 37,
+    black = 30,
+    grey = 90,
+    lightGrey = 97,
+    lightRed = 91,
+    lightGreen = 92,
+    lightYellow = 93,
+    lightBlue = 94,
+    lightMagenta = 95,
+    lightCyan = 96,
+    lightWhite = 97
+}
+export declare class Output {
+    text: string;
+    color?: PrintColor;
+    isBold: boolean;
+    constructor(text: string, color?: PrintColor, isBold?: boolean);
+}
+export default class PrintColored {
+    outputs: Output[];
+    chain(text: string, color?: PrintColor, isBold?: boolean): this;
+    chainln(text: string, color?: PrintColor, isBold?: boolean): this;
+    printit(): void;
+    getIt(): string;
+    throwIt(): never;
+    red(text: string): this;
+    redBold(text: string): this;
+    green(text: string): this;
+    greenBold(text: string): this;
+    yellow(text: string): this;
+    yellowBold(text: string): this;
+    blue(text: string): this;
+    blueBold(text: string): this;
+    magenta(text: string): this;
+    magentaBold(text: string): this;
+    white(text: string): this;
+    whiteBold(text: string): this;
+    black(text: string): this;
+    blackBold(text: string): this;
+}
+//# sourceMappingURL=print_colored.d.ts.map

package/dist/tools/print_colored.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print_colored.d.ts","sourceRoot":"","sources":["../../src/tools/print_colored.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IACpB,GAAG,KAAK;IACR,KAAK,KAAK;IACV,MAAM,KAAK;IACX,IAAI,KAAK;IACT,OAAO,KAAK;IACZ,KAAK,KAAK;IACV,KAAK,KAAK;IACV,IAAI,KAAK;IACT,SAAS,KAAK;IACd,QAAQ,KAAK;IACb,UAAU,KAAK;IACf,WAAW,KAAK;IAChB,SAAS,KAAK;IACd,YAAY,KAAK;IACjB,SAAS,KAAK;IACd,UAAU,KAAK;CAChB;AAED,qBAAa,MAAM;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;gBAEJ,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,MAAM,GAAE,OAAe;CAKtE;AAED,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAM;IAEvB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAK/D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAKjE,OAAO,IAAI,IAAI;IAWf,KAAK,IAAI,MAAM;IAWf,OAAO,IAAI,KAAK;IAMhB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKvB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKzB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK5B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKzB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKzB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAI9B"}

package/dist/tools/print_colored.js

@@ -0,0 +1,119 @@
+export var PrintColor;
+(function (PrintColor) {
+    PrintColor[PrintColor["red"] = 31] = "red";
+    PrintColor[PrintColor["green"] = 32] = "green";
+    PrintColor[PrintColor["yellow"] = 33] = "yellow";
+    PrintColor[PrintColor["blue"] = 34] = "blue";
+    PrintColor[PrintColor["magenta"] = 35] = "magenta";
+    PrintColor[PrintColor["white"] = 37] = "white";
+    PrintColor[PrintColor["black"] = 30] = "black";
+    PrintColor[PrintColor["grey"] = 90] = "grey";
+    PrintColor[PrintColor["lightGrey"] = 97] = "lightGrey";
+    PrintColor[PrintColor["lightRed"] = 91] = "lightRed";
+    PrintColor[PrintColor["lightGreen"] = 92] = "lightGreen";
+    PrintColor[PrintColor["lightYellow"] = 93] = "lightYellow";
+    PrintColor[PrintColor["lightBlue"] = 94] = "lightBlue";
+    PrintColor[PrintColor["lightMagenta"] = 95] = "lightMagenta";
+    PrintColor[PrintColor["lightCyan"] = 96] = "lightCyan";
+    PrintColor[PrintColor["lightWhite"] = 97] = "lightWhite";
+})(PrintColor || (PrintColor = {}));
+export class Output {
+    text;
+    color;
+    isBold;
+    constructor(text, color, isBold = false) {
+        this.text = text;
+        this.color = color;
+        this.isBold = isBold;
+    }
+}
+export default class PrintColored {
+    outputs = [];
+    chain(text, color, isBold) {
+        this.outputs.push(new Output(text, color, isBold ?? false));
+        return this;
+    }
+    chainln(text, color, isBold) {
+        this.outputs.push(new Output(text + "\n", color, isBold ?? false));
+        return this;
+    }
+    printit() {
+        const text = this.outputs
+            .map((output) => {
+            const colorCode = output.color !== undefined ? output.color : 0;
+            return `\x1B[${output.isBold ? "1;" + colorCode : colorCode}m${output.text}\x1B[0m`;
+        })
+            .join(" ");
+        // eslint-disable-next-line no-console
+        console.log(text);
+    }
+    getIt() {
+        return this.outputs
+            .map((output) => {
+            if (output.color === undefined)
+                return output.text;
+            return `\x1B[${output.isBold ? "1;" + output.color : output.color}m${output.text}\x1B[0m`;
+        })
+            .join(" ");
+    }
+    throwIt() {
+        throw new Error(this.getIt());
+    }
+    // Optional chainers
+    red(text) {
+        this.outputs.push(new Output(text, PrintColor.red, false));
+        return this;
+    }
+    redBold(text) {
+        this.outputs.push(new Output(text, PrintColor.red, true));
+        return this;
+    }
+    green(text) {
+        this.outputs.push(new Output(text, PrintColor.green, false));
+        return this;
+    }
+    greenBold(text) {
+        this.outputs.push(new Output(text, PrintColor.green, true));
+        return this;
+    }
+    yellow(text) {
+        this.outputs.push(new Output(text, PrintColor.yellow, false));
+        return this;
+    }
+    yellowBold(text) {
+        this.outputs.push(new Output(text, PrintColor.yellow, true));
+        return this;
+    }
+    blue(text) {
+        this.outputs.push(new Output(text, PrintColor.blue, false));
+        return this;
+    }
+    blueBold(text) {
+        this.outputs.push(new Output(text, PrintColor.blue, true));
+        return this;
+    }
+    magenta(text) {
+        this.outputs.push(new Output(text, PrintColor.magenta, false));
+        return this;
+    }
+    magentaBold(text) {
+        this.outputs.push(new Output(text, PrintColor.magenta, true));
+        return this;
+    }
+    white(text) {
+        this.outputs.push(new Output(text, PrintColor.white, false));
+        return this;
+    }
+    whiteBold(text) {
+        this.outputs.push(new Output(text, PrintColor.white, true));
+        return this;
+    }
+    black(text) {
+        this.outputs.push(new Output(text, PrintColor.black, false));
+        return this;
+    }
+    blackBold(text) {
+        this.outputs.push(new Output(text, PrintColor.black, true));
+        return this;
+    }
+}

package/dist/tools/random.d.ts

@@ -0,0 +1,46 @@
+export default class Random {
+    private static _cuidCounter;
+    static nextInt(max: number): number;
+    static uuid(): string;
+    static cuid(): string;
+    static alpha(length: number, opts?: {
+        includeUppercase?: boolean;
+    }): string;
+    static alphaNumeric(length: number, opts?: {
+        includeUppercase?: boolean;
+    }): string;
+    static numeric(length: number): string;
+    static boolean(): boolean;
+    static pickOne<T>(values: T[]): T;
+    static shuffle<T>(values: T[]): T[];
+    static nextDouble(): number;
+    static date(args?: {
+        start?: Date;
+        end?: Date;
+    }): Date;
+    static fromCharset(length: number, charset: string): string;
+    static hexColor(opts?: {
+        withAlpha?: boolean;
+    }): string;
+    static pickMapValue<K, V>(map: Map<K, V> | {
+        [key: string]: V;
+    }, opts?: {
+        weights?: number[];
+    }): V;
+    static duration(args?: {
+        min?: number;
+        max?: number;
+    }): number;
+    static coin(probability: number): boolean;
+    static pickSome<T>(values: T[], args?: {
+        min?: number;
+        max?: number;
+    }): T[];
+    static pickMany<T>(values: T[], args?: {
+        count?: number;
+    }): T[];
+    static ipv4(): string;
+    static doubleInRange(min: number, max: number): number;
+    static intInRange(min: number, max: number): number;
+}
+//# sourceMappingURL=random.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/tools/random.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,MAAM;IACzB,OAAO,CAAC,MAAM,CAAC,YAAY,CAAK;IAEhC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAInC,MAAM,CAAC,IAAI,IAAI,MAAM;IA4BrB,MAAM,CAAC,IAAI,IAAI,MAAM;IAoBrB,MAAM,CAAC,KAAK,CACV,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAO,GACxC,MAAM;IAWT,MAAM,CAAC,YAAY,CACjB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAO,GACxC,MAAM;IAcT,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAStC,MAAM,CAAC,OAAO,IAAI,OAAO;IAIzB,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC;IAKjC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IASnC,MAAM,CAAC,UAAU,IAAI,MAAM;IAI3B,MAAM,CAAC,IAAI,CAAC,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,IAAI,CAAC;QAAC,GAAG,CAAC,EAAE,IAAI,CAAA;KAAO,GAAG,IAAI;IAY1D,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAS3D,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,MAAM;IAU3D,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EACtB,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAA;KAAE,EACrC,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,GAChC,CAAC;IA0BJ,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,MAAM;IAQlE,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAOzC,MAAM,CAAC,QAAQ,CAAC,CAAC,EACf,MAAM,EAAE,CAAC,EAAE,EACX,IAAI,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO,GACxC,CAAC,EAAE;IAgBN,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,CAAC,EAAE;IAanE,MAAM,CAAC,IAAI,IAAI,MAAM;IAIrB,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAKtD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;CAIpD"}

package/dist/tools/random.js

@@ -0,0 +1,214 @@
+export default class Random {
+    static _cuidCounter = 0;
+    static nextInt(max) {
+        return Math.floor(Math.random() * max);
+    }
+    static uuid() {
+        function fourDigits() {
+            return Random.nextInt(0x10000).toString(16).padStart(4, "0");
+        }
+        function twoDigits() {
+            return Random.nextInt(0x100).toString(16).padStart(2, "0");
+        }
+        return (fourDigits() +
+            fourDigits() +
+            "-" +
+            fourDigits() +
+            "-" +
+            "4" +
+            twoDigits() +
+            twoDigits() +
+            "-" +
+            (8 + Random.nextInt(4)).toString(16) +
+            twoDigits() +
+            twoDigits() +
+            "-" +
+            fourDigits() +
+            fourDigits() +
+            fourDigits());
+    }
+    static cuid() {
+        const ts = Date.now().toString(36).padStart(8, "0");
+        Random._cuidCounter = (Random._cuidCounter + 1) % 1679616;
+        const count = Random._cuidCounter.toString(36).padStart(4, "0");
+        const randomPart = Random.nextInt(1679616).toString(36).padStart(4, "0");
+        let fingerprint = "0000";
+        try {
+            fingerprint = ((typeof process !== "undefined" && process.pid ? process.pid : 0) ^
+                Math.floor(Math.random() * 1000000))
+                .toString(36)
+                .padStart(4, "0");
+        }
+        catch {
+            // fallback
+            fingerprint = Random.nextInt(0x10000).toString(36).padStart(4, "0");
+        }
+        return `c${ts}${count}${randomPart}${fingerprint}`;
+    }
+    static alpha(length, opts = {}) {
+        const lowercase = "abcdefghijklmnopqrstuvwxyz";
+        const uppercase = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+        const chars = opts.includeUppercase ? lowercase + uppercase : lowercase;
+        let out = "";
+        for (let i = 0; i < length; ++i) {
+            out += chars[Random.nextInt(chars.length)];
+        }
+        return out;
+    }
+    static alphaNumeric(length, opts = {}) {
+        const lowercase = "abcdefghijklmnopqrstuvwxyz";
+        const uppercase = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+        const numbers = "0123456789";
+        const chars = opts.includeUppercase
+            ? lowercase + uppercase + numbers
+            : lowercase + numbers;
+        let out = "";
+        for (let i = 0; i < length; ++i) {
+            out += chars[Random.nextInt(chars.length)];
+        }
+        return out;
+    }
+    static numeric(length) {
+        const numbers = "0123456789";
+        let out = "";
+        for (let i = 0; i < length; ++i) {
+            out += numbers[Random.nextInt(numbers.length)];
+        }
+        return out;
+    }
+    static boolean() {
+        return Math.random() < 0.5;
+    }
+    static pickOne(values) {
+        if (!values.length)
+            throw new Error("List cannot be empty");
+        return values[Random.nextInt(values.length)];
+    }
+    static shuffle(values) {
+        const list = values.slice();
+        for (let i = list.length - 1; i > 0; --i) {
+            const j = Random.nextInt(i + 1);
+            [list[i], list[j]] = [list[j], list[i]];
+        }
+        return list;
+    }
+    static nextDouble() {
+        return Math.random();
+    }
+    static date(args = {}) {
+        const from = args.start || new Date(1970, 0, 1);
+        const to = args.end || new Date();
+        if (from > to)
+            throw new Error("start must be before end");
+        const fromMs = from.getTime();
+        const toMs = to.getTime();
+        const ms = fromMs + Math.floor(Math.random() * (toMs - fromMs + 1));
+        return new Date(ms);
+    }
+    static fromCharset(length, charset) {
+        if (!charset.length)
+            throw new Error("charset cannot be empty");
+        let out = "";
+        for (let i = 0; i < length; ++i) {
+            out += charset[Random.nextInt(charset.length)];
+        }
+        return out;
+    }
+    static hexColor(opts = {}) {
+        const withAlpha = opts.withAlpha || false;
+        const value = withAlpha
+            ? Random.nextInt(0x100000000)
+            : Random.nextInt(0x1000000);
+        return withAlpha
+            ? `#${value.toString(16).padStart(8, "0").toUpperCase()}`
+            : `#${value.toString(16).padStart(6, "0").toUpperCase()}`;
+    }
+    static pickMapValue(map, opts = {}) {
+        // Support both Map and object
+        let values;
+        if (map instanceof Map) {
+            values = Array.from(map.values());
+        }
+        else {
+            values = Object.values(map);
+        }
+        if (!values.length)
+            throw new Error("Map cannot be empty");
+        if (!opts.weights) {
+            return Random.pickOne(values);
+        }
+        const weights = opts.weights;
+        if (weights.length !== values.length) {
+            throw new Error("Weights length must match Map value count.");
+        }
+        let sum = weights.reduce((a, b) => a + b, 0);
+        let r = Math.random() * sum;
+        for (let i = 0; i < values.length; ++i) {
+            if (!weights[i])
+                continue;
+            if (r < weights[i])
+                return values[i];
+            r -= weights[i];
+        }
+        return values[values.length - 1];
+    }
+    static duration(args = {}) {
+        // Returns random milliseconds between min (inclusive) and max (inclusive)
+        const min = args.min ?? 0;
+        const max = args.max ?? 60000;
+        if (min > max)
+            throw new Error("min must be < max");
+        return min + Random.nextInt(max - min + 1);
+    }
+    static coin(probability) {
+        if (probability < 0.0 || probability > 1.0) {
+            throw new Error("probability must be from 0.0 to 1.0");
+        }
+        return Math.random() < probability;
+    }
+    static pickSome(values, args = {}) {
+        if (!values.length)
+            throw new Error("List cannot be empty");
+        let lower = args.min ?? 0;
+        let upper = args.max ?? values.length;
+        if (lower < 0)
+            lower = 0;
+        if (upper > values.length)
+            upper = values.length;
+        if (lower > upper)
+            throw new Error("min must be <= max");
+        const count = lower + Random.nextInt(upper - lower + 1);
+        const list = values.slice();
+        for (let i = list.length - 1; i > 0; --i) {
+            const j = Random.nextInt(i + 1);
+            [list[i], list[j]] = [list[j], list[i]];
+        }
+        return list.slice(0, count);
+    }
+    static pickMany(values, args = {}) {
+        const count = args.count ?? values.length;
+        if (count < 0)
+            throw new Error("count must be >= 0");
+        if (count > values.length)
+            throw new Error("count must be <= values.length");
+        const list = values.slice();
+        for (let i = list.length - 1; i > 0; --i) {
+            const j = Random.nextInt(i + 1);
+            [list[i], list[j]] = [list[j], list[i]];
+        }
+        return list.slice(0, count);
+    }
+    static ipv4() {
+        return Array.from({ length: 4 }, () => Random.nextInt(256)).join(".");
+    }
+    static doubleInRange(min, max) {
+        if (min >= max)
+            throw new Error("min must be less than max");
+        return min + Math.random() * (max - min);
+    }
+    static intInRange(min, max) {
+        if (min >= max)
+            throw new Error("min must be less than max");
+        return min + Random.nextInt(max - min);
+    }
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@kidus.dev/flowdb",
+  "version": "1.0.0",
+  "description": "A lightweight, pluggable local database for TypeScript and JavaScript projects.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "module": "dist/index.js",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "node dist/test/index.js"
+  },
+  "keywords": [
+    "database",
+    "local",
+    "typescript",
+    "storage",
+    "embedded"
+  ],
+  "author": "Kidus Abrham <kidusabrham.dev@gmail.com>",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  }
+}