@kdtlabs/utils 0.0.9 → 0.0.11

package/dist/zod/index.js

@@ -0,0 +1,4 @@
+import{isDirectory,isFile,isHexString,isNumberString,isReadable,isStrictHexString,isTrueLike,isValidDate,isWritable,isWritableDirectory}from"../chunk-rn7vfxhm.js";import{z}from"zod";var PROTOCOL_PATTERNS={file:/^file$/u,ftp:/^ftps?$/u,http:/^https?$/u,ssh:/^ssh$/u,ws:/^wss?$/u};function url(...protocols){let patterns=protocols.flat().map((p)=>PROTOCOL_PATTERNS[p]),combined=new RegExp(`^(?:${patterns.map((r)=>r.source.slice(1,-1)).join("|")})$`);return z.url({protocol:combined})}var hexString=(length)=>z.string().refine((val)=>isHexString(val,length),{error:length?`Invalid hex string (expected ${length} bytes)`:"Invalid hex string"}),strictHexString=(length)=>z.string().refine((val)=>isStrictHexString(val,length),{error:length?`Invalid strict hex string (expected 0x prefix, ${length} bytes)`:"Invalid strict hex string (expected 0x prefix)"}),numberString=()=>z.string().refine((val)=>isNumberString(val),{error:"Invalid number string"}),validDate=()=>z.custom((val)=>isValidDate(val),{error:"Invalid date"}),trueLike=(options)=>z.unknown().transform((val)=>isTrueLike(val,options)),filePath=()=>z.string().refine((val)=>isFile(val),{error:"Path is not a file"}),directoryPath=()=>z.string().refine((val)=>isDirectory(val),{error:"Path is not a directory"}),readable=()=>z.string().refine((val)=>isReadable(val),{error:"Path is not readable"}),writable=()=>z.string().refine((val)=>isWritable(val),{error:"Path is not writable"}),writableDirectory=()=>z.string().refine((val)=>isWritableDirectory(val),{error:"Path is not a writable directory"});export{writableDirectory,writable,validDate,url,trueLike,strictHexString,readable,numberString,hexString,filePath,directoryPath,PROTOCOL_PATTERNS};
+
+//# debugId=CA2A82F81B89B66B64756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/zod/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/zod/schemas.ts"],
+  "sourcesContent": [
+    "import type { IsTrueLikeOptions } from '../core'\nimport { z } from 'zod'\nimport { isTrueLike } from '../core'\nimport { isNumberString } from '../numbers'\nimport { isHexString, isStrictHexString } from '../strings'\nimport { isDirectory, isFile, isReadable, isWritable, isWritableDirectory } from '../system'\nimport { isValidDate } from '../times'\n\nexport const PROTOCOL_PATTERNS = <const>{\n    file: /^file$/u,\n    ftp: /^ftps?$/u,\n    http: /^https?$/u,\n    ssh: /^ssh$/u,\n    ws: /^wss?$/u,\n}\n\nexport type Protocol = keyof typeof PROTOCOL_PATTERNS\n\nexport function url(...protocols: Array<Protocol | Protocol[]>) {\n    const flat = protocols.flat()\n    const patterns = flat.map((p) => PROTOCOL_PATTERNS[p])\n    const combined = new RegExp(`^(?:${patterns.map((r) => r.source.slice(1, -1)).join('|')})$`)\n\n    return z.url({ protocol: combined })\n}\n\nexport const hexString = (length?: number) => (\n    z.string().refine((val) => isHexString(val, length), {\n        error: length ? `Invalid hex string (expected ${length} bytes)` : 'Invalid hex string',\n    })\n)\n\nexport const strictHexString = (length?: number) => (\n    z.string().refine((val) => isStrictHexString(val, length), {\n        error: length ? `Invalid strict hex string (expected 0x prefix, ${length} bytes)` : 'Invalid strict hex string (expected 0x prefix)',\n    })\n)\n\nexport const numberString = () => (\n    z.string().refine((val) => isNumberString(val), {\n        error: 'Invalid number string',\n    })\n)\n\nexport const validDate = () => (\n    z.custom<Date>((val) => isValidDate(val), { error: 'Invalid date' })\n)\n\nexport const trueLike = (options?: IsTrueLikeOptions) => z.unknown().transform((val) => isTrueLike(val, options))\n\nexport const filePath = () => z.string().refine((val) => isFile(val), {\n    error: 'Path is not a file',\n})\n\nexport const directoryPath = () => (\n    z.string().refine((val) => isDirectory(val), {\n        error: 'Path is not a directory',\n    })\n)\n\nexport const readable = () => (\n    z.string().refine((val) => isReadable(val), {\n        error: 'Path is not readable',\n    })\n)\n\nexport const writable = () => (\n    z.string().refine((val) => isWritable(val), {\n        error: 'Path is not writable',\n    })\n)\n\nexport const writableDirectory = () => (\n    z.string().refine((val) => isWritableDirectory(val), {\n        error: 'Path is not a writable directory',\n    })\n)\n"
+  ],
+  "mappings": "mKACA,mBAOO,IAAM,kBAA2B,CACpC,KAAM,UACN,IAAK,WACL,KAAM,YACN,IAAK,SACL,GAAI,SACR,EAIO,SAAS,GAAG,IAAI,UAAyC,CAE5D,IAAM,SADO,UAAU,KAAK,EACN,IAAI,CAAC,IAAM,kBAAkB,EAAE,EAC/C,SAAW,IAAI,OAAO,OAAO,SAAS,IAAI,CAAC,IAAM,EAAE,OAAO,MAAM,EAAG,EAAE,CAAC,EAAE,KAAK,GAAG,KAAK,EAE3F,OAAO,EAAE,IAAI,CAAE,SAAU,QAAS,CAAC,EAGhC,IAAM,UAAY,CAAC,SACtB,EAAE,OAAO,EAAE,OAAO,CAAC,MAAQ,YAAY,IAAK,MAAM,EAAG,CACjD,MAAO,OAAS,gCAAgC,gBAAkB,oBACtE,CAAC,EAGQ,gBAAkB,CAAC,SAC5B,EAAE,OAAO,EAAE,OAAO,CAAC,MAAQ,kBAAkB,IAAK,MAAM,EAAG,CACvD,MAAO,OAAS,kDAAkD,gBAAkB,gDACxF,CAAC,EAGQ,aAAe,IACxB,EAAE,OAAO,EAAE,OAAO,CAAC,MAAQ,eAAe,GAAG,EAAG,CAC5C,MAAO,uBACX,CAAC,EAGQ,UAAY,IACrB,EAAE,OAAa,CAAC,MAAQ,YAAY,GAAG,EAAG,CAAE,MAAO,cAAe,CAAC,EAG1D,SAAW,CAAC,UAAgC,EAAE,QAAQ,EAAE,UAAU,CAAC,MAAQ,WAAW,IAAK,OAAO,CAAC,EAEnG,SAAW,IAAM,EAAE,OAAO,EAAE,OAAO,CAAC,MAAQ,OAAO,GAAG,EAAG,CAClE,MAAO,oBACX,CAAC,EAEY,cAAgB,IACzB,EAAE,OAAO,EAAE,OAAO,CAAC,MAAQ,YAAY,GAAG,EAAG,CACzC,MAAO,yBACX,CAAC,EAGQ,SAAW,IACpB,EAAE,OAAO,EAAE,OAAO,CAAC,MAAQ,WAAW,GAAG,EAAG,CACxC,MAAO,sBACX,CAAC,EAGQ,SAAW,IACpB,EAAE,OAAO,EAAE,OAAO,CAAC,MAAQ,WAAW,GAAG,EAAG,CACxC,MAAO,sBACX,CAAC,EAGQ,kBAAoB,IAC7B,EAAE,OAAO,EAAE,OAAO,CAAC,MAAQ,oBAAoB,GAAG,EAAG,CACjD,MAAO,kCACX,CAAC",
+  "debugId": "CA2A82F81B89B66B64756E2164756E21",
+  "names": []
+}

package/dist/zod/schemas.d.ts

@@ -0,0 +1,22 @@
+import type { IsTrueLikeOptions } from '../core';
+import { z } from 'zod';
+export declare const PROTOCOL_PATTERNS: {
+    readonly file: RegExp;
+    readonly ftp: RegExp;
+    readonly http: RegExp;
+    readonly ssh: RegExp;
+    readonly ws: RegExp;
+};
+export type Protocol = keyof typeof PROTOCOL_PATTERNS;
+export declare function url(...protocols: Array<Protocol | Protocol[]>): z.ZodURL;
+export declare const hexString: (length?: number) => z.ZodString;
+export declare const strictHexString: (length?: number) => z.ZodString & z.ZodType<`0x${string}`, string, z.core.$ZodTypeInternals<`0x${string}`, string>>;
+export declare const numberString: () => z.ZodString & z.ZodType<import("..").NumberString<true>, string, z.core.$ZodTypeInternals<import("..").NumberString<true>, string>>;
+export declare const validDate: () => z.ZodCustom<Date, Date>;
+export declare const trueLike: (options?: IsTrueLikeOptions) => z.ZodPipe<z.ZodUnknown, z.ZodTransform<boolean, unknown>>;
+export declare const filePath: () => z.ZodString;
+export declare const directoryPath: () => z.ZodString;
+export declare const readable: () => z.ZodString;
+export declare const writable: () => z.ZodString;
+export declare const writableDirectory: () => z.ZodString;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/zod/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/zod/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,eAAO,MAAM,iBAAiB;;;;;;CAM7B,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,iBAAiB,CAAA;AAErD,wBAAgB,GAAG,CAAC,GAAG,SAAS,EAAE,KAAK,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC,YAM7D;AAED,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,gBAIxC,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,oGAI9C,CAAA;AAED,eAAO,MAAM,YAAY,2IAIxB,CAAA;AAED,eAAO,MAAM,SAAS,+BAErB,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,UAAU,iBAAiB,8DAA6D,CAAA;AAEjH,eAAO,MAAM,QAAQ,mBAEnB,CAAA;AAEF,eAAO,MAAM,aAAa,mBAIzB,CAAA;AAED,eAAO,MAAM,QAAQ,mBAIpB,CAAA;AAED,eAAO,MAAM,QAAQ,mBAIpB,CAAA;AAED,eAAO,MAAM,iBAAiB,mBAI7B,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@kdtlabs/utils",
     "type": "module",
-    "version": "0.0.9",
+    "version": "0.0.11",
     "description": "A comprehensive TypeScript utility library",
     "author": "Diep Dang <kdt310722@gmail.com>",
     "license": "MIT",
@@ -16,6 +16,10 @@
         ".": {
             "types": "./dist/index.d.ts",
             "default": "./dist/index.js"
+        },
+        "./zod": {
+            "types": "./dist/zod/index.d.ts",
+            "default": "./dist/zod/index.js"
         }
     },
     "main": "dist/index.js",
@@ -38,6 +42,14 @@
         "up": "taze -I --group --force --peer",
         "preinstall": "only-allow bun && ([ -d .git ] && simple-git-hooks || true)"
     },
+    "peerDependencies": {
+        "zod": "^4.0.0"
+    },
+    "peerDependenciesMeta": {
+        "zod": {
+            "optional": true
+        }
+    },
     "devDependencies": {
         "@commitlint/cli": "^20.5.0",
         "@commitlint/config-conventional": "^20.5.0",
@@ -52,7 +64,8 @@
         "rimraf": "^6.1.3",
         "simple-git-hooks": "^2.13.1",
         "taze": "^19.10.0",
-        "typescript": "^6.0.2"
+        "typescript": "^6.0.2",
+        "zod": "^4.3.6"
     },
     "simple-git-hooks": {
         "commit-msg": "bunx --no -- commitlint --edit ${1}",

package/src/errors/base-error.ts

@@ -1,3 +1,5 @@
+import { notUndefined } from '../core'
+
 export type BaseErrorCode = number | string
 
 export interface BaseErrorOptions extends ErrorOptions {
@@ -41,7 +43,9 @@ export class BaseError extends Error {
     }
 
     protected defineValue(key: string, value: unknown) {
-        Object.defineProperty(this, key, { configurable: false, enumerable: true, value, writable: false })
+        if (notUndefined(value)) {
+            Object.defineProperty(this, key, { configurable: false, enumerable: true, value, writable: false })
+        }
 
         return this
     }

package/src/errors/guards.ts

@@ -9,6 +9,8 @@ export const isBaseError = (value: unknown): value is BaseError => value instanc
 
 export const isAbortError = (error: unknown): error is DOMException => error instanceof DOMException && error.name === 'AbortError'
 
+export const isTimeoutError = (error: unknown): error is DOMException => error instanceof DOMException && error.name === 'TimeoutError'
+
 export const isErrorLike = (value: unknown): value is ErrorLike => isObject(value) && isKeysOf(value, 'name') && isString(value.name)
 
 export const isErrnoException = (value: unknown): value is NodeJS.ErrnoException => (

package/src/events/emitter.ts

@@ -55,7 +55,13 @@ export class Emitter<TEventMap = EventMap, TStrict extends boolean = false> {
         const fromRegular = this.#emitSnapshot(regularSnapshot, args)
         const fromOnce = this.#emitSnapshot(onceSnapshot, args)
 
-        return fromRegular || fromOnce
+        if (eventName === '*') {
+            return fromRegular || fromOnce
+        }
+
+        const fromWildcard = this.#emitWildcard(eventName, args)
+
+        return fromRegular || fromOnce || fromWildcard
     }
 
     public removeAllListeners<TEventName extends EventNames<TEventMap, TStrict>>(eventName?: TEventName): this {
@@ -114,4 +120,17 @@ export class Emitter<TEventMap = EventMap, TStrict extends boolean = false> {
 
         return true
     }
+
+    #emitWildcard(eventName: PropertyKey, args: any[]) {
+        const regularSnapshot = this.#takeSnapshot(this.eventListeners.get('*'))
+        const onceSnapshot = this.#takeSnapshot(this.onceListeners.get('*'))
+
+        this.onceListeners.delete('*')
+
+        const wildcardArgs = [eventName, ...args]
+        const fromRegular = this.#emitSnapshot(regularSnapshot, wildcardArgs)
+        const fromOnce = this.#emitSnapshot(onceSnapshot, wildcardArgs)
+
+        return fromRegular || fromOnce
+    }
 }

package/src/events/types.ts

@@ -1,10 +1,12 @@
 export type EventMap = Record<PropertyKey, any[]>
 
-export type EventNames<TEventMap, TStrict extends boolean> = TStrict extends true ? keyof TEventMap : keyof TEventMap | string
+export type EventNames<TEventMap, TStrict extends boolean> = TStrict extends true ? keyof TEventMap | '*' : keyof TEventMap | string
 
 export type ResolveEventArgs<TEventMap, TEventName> = TEventName extends keyof TEventMap ? TEventMap[TEventName] extends any[] ? TEventMap[TEventName] : any[] : any[]
 
-export type EventArgs<TEventMap, TEventName, TStrict extends boolean> = TStrict extends true ? TEventName extends keyof TEventMap ? ResolveEventArgs<TEventMap, TEventName> : never : ResolveEventArgs<TEventMap, TEventName>
+export type WildcardArgs<TEventMap, TStrict extends boolean> = [eventName: EventNames<TEventMap, TStrict>, ...args: any[]]
+
+export type EventArgs<TEventMap, TEventName, TStrict extends boolean> = TEventName extends '*' ? WildcardArgs<TEventMap, TStrict> : TStrict extends true ? TEventName extends keyof TEventMap ? ResolveEventArgs<TEventMap, TEventName> : never : ResolveEventArgs<TEventMap, TEventName>
 
 export type EventListener<TArgs = any[]> = (...args: TArgs extends any[] ? TArgs : any[]) => void
 

package/src/functions/compositions.ts

@@ -8,7 +8,7 @@ export function tap<T>(value: T, callback: (value: T) => void) {
 
 export const transform = <T, R>(value: T, callback: (value: T) => R) => callback(value)
 
-export function tryCatch<T>(fn: () => T, fallback: T | ((error: unknown) => T)) {
+export function tryCatch<T, R>(fn: () => T, fallback: R | ((error: unknown) => R)) {
     try {
         return fn()
     } catch (error) {

package/src/promises/compositions.ts

@@ -9,7 +9,7 @@ pTap.catch = (fn: (error: unknown) => Awaitable<unknown>) => async (error: unkno
     throw error
 }
 
-export async function tryCatchAsync<T>(fn: () => Awaitable<T>, fallback: (error: unknown) => Awaitable<T>) {
+export async function tryCatchAsync<T, R>(fn: () => Awaitable<T>, fallback: (error: unknown) => Awaitable<R>) {
     try {
         return await fn()
     } catch (error) {

package/src/zod/index.ts

@@ -0,0 +1 @@
+export * from './schemas'

package/src/zod/schemas.ts

@@ -0,0 +1,77 @@
+import type { IsTrueLikeOptions } from '../core'
+import { z } from 'zod'
+import { isTrueLike } from '../core'
+import { isNumberString } from '../numbers'
+import { isHexString, isStrictHexString } from '../strings'
+import { isDirectory, isFile, isReadable, isWritable, isWritableDirectory } from '../system'
+import { isValidDate } from '../times'
+
+export const PROTOCOL_PATTERNS = <const>{
+    file: /^file$/u,
+    ftp: /^ftps?$/u,
+    http: /^https?$/u,
+    ssh: /^ssh$/u,
+    ws: /^wss?$/u,
+}
+
+export type Protocol = keyof typeof PROTOCOL_PATTERNS
+
+export function url(...protocols: Array<Protocol | Protocol[]>) {
+    const flat = protocols.flat()
+    const patterns = flat.map((p) => PROTOCOL_PATTERNS[p])
+    const combined = new RegExp(`^(?:${patterns.map((r) => r.source.slice(1, -1)).join('|')})$`)
+
+    return z.url({ protocol: combined })
+}
+
+export const hexString = (length?: number) => (
+    z.string().refine((val) => isHexString(val, length), {
+        error: length ? `Invalid hex string (expected ${length} bytes)` : 'Invalid hex string',
+    })
+)
+
+export const strictHexString = (length?: number) => (
+    z.string().refine((val) => isStrictHexString(val, length), {
+        error: length ? `Invalid strict hex string (expected 0x prefix, ${length} bytes)` : 'Invalid strict hex string (expected 0x prefix)',
+    })
+)
+
+export const numberString = () => (
+    z.string().refine((val) => isNumberString(val), {
+        error: 'Invalid number string',
+    })
+)
+
+export const validDate = () => (
+    z.custom<Date>((val) => isValidDate(val), { error: 'Invalid date' })
+)
+
+export const trueLike = (options?: IsTrueLikeOptions) => z.unknown().transform((val) => isTrueLike(val, options))
+
+export const filePath = () => z.string().refine((val) => isFile(val), {
+    error: 'Path is not a file',
+})
+
+export const directoryPath = () => (
+    z.string().refine((val) => isDirectory(val), {
+        error: 'Path is not a directory',
+    })
+)
+
+export const readable = () => (
+    z.string().refine((val) => isReadable(val), {
+        error: 'Path is not readable',
+    })
+)
+
+export const writable = () => (
+    z.string().refine((val) => isWritable(val), {
+        error: 'Path is not writable',
+    })
+)
+
+export const writableDirectory = () => (
+    z.string().refine((val) => isWritableDirectory(val), {
+        error: 'Path is not a writable directory',
+    })
+)