@bouko/ts 0.2.7 → 0.2.9

package/dist/definitions/math.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+export declare const RangeSchema: z.ZodObject<{
+    min: z.ZodNumber;
+    max: z.ZodNumber;
+}, z.core.$strip>;

package/dist/definitions/math.js

@@ -0,0 +1,5 @@
+import { z } from "zod";
+export const RangeSchema = z.object({
+    min: z.number().int(),
+    max: z.number().int()
+});

package/dist/index.d.ts

@@ -1,13 +1,14 @@
-import type { JsonMap, JsonValue } from "./types/generic";
-export * from "./types/generic";
-export * from "./types/work";
-export * from "./types/math";
-export * from "./utils/checkers";
-export * from "./utils/env";
-export * from "./utils/formatters";
-export * from "./utils/parsers";
-export * from "./utils/converters";
-export declare const safely: <T>(action: () => T) => T | undefined;
-export declare const safelyThru: <T>(arr: T[], action: (item: T) => void) => void;
-export declare const isJsonMap: (value: unknown) => value is JsonMap;
-export declare const isJsonValue: (value: unknown) => value is JsonValue;
+import type { JsonMap, JsonValue } from "./types/generic";
+export * from "./types/generic";
+export * from "./types/work";
+export * from "./types/math";
+export * from "./definitions/math";
+export * from "./utils/checkers";
+export * from "./utils/env";
+export * from "./utils/formatters";
+export * from "./utils/parsers";
+export * from "./utils/converters";
+export declare const safely: <T>(action: () => T) => T | undefined;
+export declare const safelyThru: <T>(arr: T[], action: (item: T) => void) => void;
+export declare const isJsonMap: (value: unknown) => value is JsonMap;
+export declare const isJsonValue: (value: unknown) => value is JsonValue;

package/dist/index.js

@@ -1,39 +1,40 @@
-export * from "./types/generic";
-export * from "./types/work";
-export * from "./types/math";
-export * from "./utils/checkers";
-export * from "./utils/env";
-export * from "./utils/formatters";
-export * from "./utils/parsers";
-export * from "./utils/converters";
-export const safely = (action) => {
-    try {
-        return action();
-    }
-    catch (err) {
-        return undefined;
-    }
-};
-export const safelyThru = (arr, action) => {
-    try {
-        arr.forEach(action);
-    }
-    catch {
-    }
-};
-export const isJsonMap = (value) => {
-    if (typeof value !== "object" ||
-        value === null ||
-        Array.isArray(value))
-        return false;
-    return Object.entries(value)
-        .every(([_, v]) => isJsonValue(v) ||
-        (Array.isArray(v) &&
-            v.every(isJsonValue)));
-};
-export const isJsonValue = (value) => (typeof value === "string" ||
-    typeof value === "number" ||
-    typeof value === "boolean" ||
-    value === null ||
-    value === undefined ||
-    isJsonMap(value));
+export * from "./types/generic";
+export * from "./types/work";
+export * from "./types/math";
+export * from "./definitions/math";
+export * from "./utils/checkers";
+export * from "./utils/env";
+export * from "./utils/formatters";
+export * from "./utils/parsers";
+export * from "./utils/converters";
+export const safely = (action) => {
+    try {
+        return action();
+    }
+    catch (err) {
+        return undefined;
+    }
+};
+export const safelyThru = (arr, action) => {
+    try {
+        arr.forEach(action);
+    }
+    catch {
+    }
+};
+export const isJsonMap = (value) => {
+    if (typeof value !== "object" ||
+        value === null ||
+        Array.isArray(value))
+        return false;
+    return Object.entries(value)
+        .every(([_, v]) => isJsonValue(v) ||
+        (Array.isArray(v) &&
+            v.every(isJsonValue)));
+};
+export const isJsonValue = (value) => (typeof value === "string" ||
+    typeof value === "number" ||
+    typeof value === "boolean" ||
+    value === null ||
+    value === undefined ||
+    isJsonMap(value));

package/dist/types/generic.d.ts

@@ -1,15 +1,15 @@
-/**
- * Type definitions for common data structures.
- *
- * - `StringMap`: Map of string keys to string values.
- * - `JsonMap`: Object of primitives, arrays, or nested maps.
- * - `JsonValue`: Union type representing a valid JSON value.
- *
- * They are intended to facilitate type-safe handling
- * of generic objects (ex. forms).
-**/
-export declare type StringMap = Record<string, string>;
-export declare type JsonMap = {
-    [key: string]: JsonValue | JsonValue[];
-};
-export declare type JsonValue = string | number | boolean | null | undefined | JsonMap | JsonValue[];
+/**
+ * Type definitions for common data structures.
+ *
+ * - `StringMap`: Map of string keys to string values.
+ * - `JsonMap`: Object of primitives, arrays, or nested maps.
+ * - `JsonValue`: Union type representing a valid JSON value.
+ *
+ * They are intended to facilitate type-safe handling
+ * of generic objects (ex. forms).
+**/
+export type StringMap = Record<string, string>;
+export type JsonMap = {
+    [key: string]: JsonValue | JsonValue[];
+};
+export type JsonValue = string | number | boolean | null | undefined | JsonMap | JsonValue[];

package/dist/types/generic.js

@@ -1,12 +1,12 @@
-/**
- * Type definitions for common data structures.
- *
- * - `StringMap`: Map of string keys to string values.
- * - `JsonMap`: Object of primitives, arrays, or nested maps.
- * - `JsonValue`: Union type representing a valid JSON value.
- *
- * They are intended to facilitate type-safe handling
- * of generic objects (ex. forms).
-**/
-export {};
-// clean
+/**
+ * Type definitions for common data structures.
+ *
+ * - `StringMap`: Map of string keys to string values.
+ * - `JsonMap`: Object of primitives, arrays, or nested maps.
+ * - `JsonValue`: Union type representing a valid JSON value.
+ *
+ * They are intended to facilitate type-safe handling
+ * of generic objects (ex. forms).
+**/
+export {};
+// clean

package/dist/types/math.d.ts

@@ -1,12 +1,12 @@
-/**
- * Type definitions for math/numbers.
- *
- * - `Range`: Object with `min` and `max` properties.
- *
- * They are intended to facilitate math utilities
- * such as clamping, normalization, etc.
-**/
-export declare type Range = {
-    min: number;
-    max: number;
-};
+/**
+ * Type definitions for math/numbers.
+ *
+ * - `Range`: Object with `min` and `max` properties.
+ *
+ * They are intended to facilitate math utilities
+ * such as clamping, normalization, etc.
+**/
+export type Range = {
+    min: number;
+    max: number;
+};

package/dist/types/math.js

@@ -1,10 +1,10 @@
-/**
- * Type definitions for math/numbers.
- *
- * - `Range`: Object with `min` and `max` properties.
- *
- * They are intended to facilitate math utilities
- * such as clamping, normalization, etc.
-**/
-export {};
-// clean
+/**
+ * Type definitions for math/numbers.
+ *
+ * - `Range`: Object with `min` and `max` properties.
+ *
+ * They are intended to facilitate math utilities
+ * such as clamping, normalization, etc.
+**/
+export {};
+// clean

package/dist/types/work.d.ts

@@ -1,3 +1,3 @@
-export declare type Job = {
-    job_id: string;
-};
+export type Job = {
+    job_id: string;
+};

package/dist/types/work.js

@@ -1 +1 @@
-export {};
+export {};

package/dist/utils/checkers.d.ts

@@ -1,2 +1,2 @@
-export declare const isNum: (x: string) => boolean;
-export declare const isBool: (x: string) => boolean;
+export declare const isNum: (x: string) => boolean;
+export declare const isBool: (x: string) => boolean;

package/dist/utils/checkers.js

@@ -1,5 +1,5 @@
-export const isNum = (x) => !isNaN(Number(x));
-export const isBool = (x) => {
-    const lower = x.trim().toLowerCase();
-    return lower === "true" || lower === "false";
-};
+export const isNum = (x) => !isNaN(Number(x));
+export const isBool = (x) => {
+    const lower = x.trim().toLowerCase();
+    return lower === "true" || lower === "false";
+};

package/dist/utils/converters.d.ts

@@ -1,2 +1,14 @@
-export declare function bufferToBase64(uint8: Uint8Array): string;
-export declare function base64ToBuffer(base64: string): Uint8Array;
+export declare function bufferToBase64(uint8: Uint8Array): string;
+export declare function base64ToBuffer(base64: string): Uint8Array;
+export declare function base64ToFile(data: string, opts?: {
+    name?: string;
+    type?: string;
+}): File;
+export declare function base64ToFile(data: undefined, opts?: {
+    name?: string;
+    type?: string;
+}): undefined;
+export declare function base64ToFile(data: string | undefined, opts?: {
+    name?: string;
+    type?: string;
+}): File | undefined;

package/dist/utils/converters.js

@@ -1,17 +1,24 @@
-export function bufferToBase64(uint8) {
-    let binary = "";
-    const len = uint8.byteLength;
-    for (let i = 0; i < len; i++) {
-        binary += String.fromCharCode(uint8[i]);
-    }
-    return btoa(binary);
-}
-export function base64ToBuffer(base64) {
-    const binaryString = atob(base64); // decode base64 into binary string
-    const len = binaryString.length;
-    const bytes = new Uint8Array(len);
-    for (let i = 0; i < len; i++) {
-        bytes[i] = binaryString.charCodeAt(i);
-    }
-    return bytes;
-}
+export function bufferToBase64(uint8) {
+    let binary = "";
+    const len = uint8.byteLength;
+    for (let i = 0; i < len; i++) {
+        binary += String.fromCharCode(uint8[i]);
+    }
+    return btoa(binary);
+}
+export function base64ToBuffer(base64) {
+    const binaryString = atob(base64); // decode base64 into binary string
+    const len = binaryString.length;
+    const bytes = new Uint8Array(len);
+    for (let i = 0; i < len; i++) {
+        bytes[i] = binaryString.charCodeAt(i);
+    }
+    return bytes;
+}
+export function base64ToFile(data, opts = {}) {
+    if (!data)
+        return;
+    const { name, type } = opts;
+    const byteArray = Uint8Array.from(atob(data), c => c.charCodeAt(0));
+    return new File([byteArray], name || "file", { type });
+}

package/dist/utils/env.d.ts

@@ -1,5 +1,5 @@
-export declare function getEnv(key: string): string;
-export declare function getEnv(key: string, fallback: string): string;
-export declare function getEnv(key: string, fallback: number): number;
-export declare function getEnv(key: string, fallback: boolean): boolean;
-export declare function getEnv<T>(key: string): T;
+export declare function getEnv(key: string): string;
+export declare function getEnv(key: string, fallback: string): string;
+export declare function getEnv(key: string, fallback: number): number;
+export declare function getEnv(key: string, fallback: boolean): boolean;
+export declare function getEnv<T>(key: string): T;

package/dist/utils/env.js

@@ -1,23 +1,23 @@
-import { parseStr } from "./parsers";
-/**
- * Retrieves and parses an environment variable.
- *
- * @param key - The variable name
- * @param fallback - Backup if no value is found (optional)
- *
- * @returns {JsonValue} The value parsed based on whichever
- * primitive type the string matches.
- *
- * @throws {Error} If the variable is not found in the
- * environment and there is no fallback set.
-**/
-export function getEnv(key, fallback) {
-    const raw = process.env[key];
-    if (!raw || raw === "") {
-        if (fallback !== undefined)
-            return fallback;
-        throw new Error(`ENV Missing: '${key}'`);
-    }
-    return parseStr(raw);
-}
-// clean
+import { parseStr } from "./parsers";
+/**
+ * Retrieves and parses an environment variable.
+ *
+ * @param key - The variable name
+ * @param fallback - Backup if no value is found (optional)
+ *
+ * @returns {JsonValue} The value parsed based on whichever
+ * primitive type the string matches.
+ *
+ * @throws {Error} If the variable is not found in the
+ * environment and there is no fallback set.
+**/
+export function getEnv(key, fallback) {
+    const raw = process.env[key];
+    if (!raw || raw === "") {
+        if (fallback !== undefined)
+            return fallback;
+        throw new Error(`ENV Missing: '${key}'`);
+    }
+    return parseStr(raw);
+}
+// clean

package/dist/utils/formatters.d.ts

@@ -1,2 +1,2 @@
-export declare const shortenStr: (str: string) => string;
-export declare const shortenNum: (x: number) => string;
+export declare const shortenStr: (str: string) => string;
+export declare const shortenNum: (x: number) => string;

package/dist/utils/formatters.js

@@ -1,12 +1,12 @@
-export const shortenStr = (str) => {
-    if (str.length <= 6)
-        return str;
-    return `${str.slice(0, 3)}...${str.slice(-3)}`;
-};
-export const shortenNum = (x) => {
-    if (x < 1000)
-        return x.toString();
-    if (x < 1_000_000)
-        return `${Math.floor(x / 1000)}k`;
-    return `${Math.floor(x / 1_000_000)}m`;
-};
+export const shortenStr = (str) => {
+    if (str.length <= 6)
+        return str;
+    return `${str.slice(0, 3)}...${str.slice(-3)}`;
+};
+export const shortenNum = (x) => {
+    if (x < 1000)
+        return x.toString();
+    if (x < 1_000_000)
+        return `${Math.floor(x / 1000)}k`;
+    return `${Math.floor(x / 1_000_000)}m`;
+};

package/dist/utils/parsers.d.ts

@@ -1,11 +1,11 @@
-import { JsonValue } from "../types/generic";
-/**
- * Parses a string value into it's appropriate
- * type, or at least cleans up the string.
- *
- * @param {string} input - The text to parse.
- *
- * @returns {JsonValue} The value parsed based on whichever
- * primitive type the string matches.
-**/
-export declare const parseStr: (input: string) => JsonValue;
+import { JsonValue } from "../types/generic";
+/**
+ * Parses a string value into it's appropriate
+ * type, or at least cleans up the string.
+ *
+ * @param {string} input - The text to parse.
+ *
+ * @returns {JsonValue} The value parsed based on whichever
+ * primitive type the string matches.
+**/
+export declare const parseStr: (input: string) => JsonValue;

package/dist/utils/parsers.js

@@ -1,23 +1,23 @@
-/**
- * Parses a string value into it's appropriate
- * type, or at least cleans up the string.
- *
- * @param {string} input - The text to parse.
- *
- * @returns {JsonValue} The value parsed based on whichever
- * primitive type the string matches.
-**/
-export const parseStr = (input) => {
-    const trimmed = input.trim();
-    if (/^-?\d+(\.\d+)?$/.test(trimmed) && !isNaN(Number(trimmed)))
-        return Number(trimmed);
-    if (/^(true|false)$/i.test(trimmed))
-        return trimmed.toLowerCase() === "true";
-    try {
-        return JSON.parse(trimmed);
-    }
-    catch {
-        return trimmed;
-    }
-};
-// clean
+/**
+ * Parses a string value into it's appropriate
+ * type, or at least cleans up the string.
+ *
+ * @param {string} input - The text to parse.
+ *
+ * @returns {JsonValue} The value parsed based on whichever
+ * primitive type the string matches.
+**/
+export const parseStr = (input) => {
+    const trimmed = input.trim();
+    if (/^-?\d+(\.\d+)?$/.test(trimmed) && !isNaN(Number(trimmed)))
+        return Number(trimmed);
+    if (/^(true|false)$/i.test(trimmed))
+        return trimmed.toLowerCase() === "true";
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return trimmed;
+    }
+};
+// clean

package/package.json

@@ -1,7 +1,7 @@
 {
 
   "name": "@bouko/ts",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "license": "MIT",
@@ -19,8 +19,12 @@
     "build": "tsc"
   },
 
-  "dependencies": {},
+  "dependencies": {
+    "zod": "^4.1.5"
+  },
 
-  "devDependencies": {}
+  "devDependencies": {
+    "typescript": "^5.9.2"
+  }
 
 }