@flareone/common 0.1.0

package/dist/utils/index.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Utils
+ * mostly stuff i didn't want to re-implement for the 100th time.
+ */
+/**
+ * Generate a random UUID v4
+ */
+declare function uuid(): string;
+/**
+ * Generate a random string
+ */
+declare function randomString(length: number, charset?: string): string;
+/**
+ * Hash a string using SHA-256
+ */
+declare function sha256(data: string): Promise<string>;
+/**
+ * Hash a string using SHA-512
+ */
+declare function sha512(data: string): Promise<string>;
+/**
+ * Create HMAC signature
+ */
+declare function hmac(data: string, secret: string, algorithm?: 'SHA-256' | 'SHA-384' | 'SHA-512'): Promise<string>;
+/**
+ * Constant-time string comparison
+ */
+declare function constantTimeEqual(a: string, b: string): boolean;
+/**
+ * Base64 encode
+ */
+declare function base64Encode(data: string | ArrayBuffer): string;
+/**
+ * Base64 decode
+ */
+declare function base64Decode(data: string): string;
+/**
+ * Base64 URL-safe encode
+ */
+declare function base64UrlEncode(data: string | ArrayBuffer): string;
+/**
+ * Base64 URL-safe decode
+ */
+declare function base64UrlDecode(data: string): string;
+/**
+ * Hex encode
+ */
+declare function hexEncode(data: ArrayBuffer | Uint8Array): string;
+/**
+ * Hex decode
+ */
+declare function hexDecode(hex: string): Uint8Array;
+/**
+ * Convert string to camelCase
+ */
+declare function camelCase(str: string): string;
+/**
+ * Convert string to PascalCase
+ */
+declare function pascalCase(str: string): string;
+/**
+ * Convert string to snake_case
+ */
+declare function snakeCase(str: string): string;
+/**
+ * Convert string to kebab-case
+ */
+declare function kebabCase(str: string): string;
+/**
+ * Generate URL-friendly slug
+ */
+declare function slugify(str: string): string;
+/**
+ * Truncate string with ellipsis
+ */
+declare function truncate(str: string, length: number, suffix?: string): string;
+/**
+ * Deep clone an object
+ */
+declare function deepClone<T>(obj: T): T;
+/**
+ * Deep merge objects
+ */
+declare function deepMerge<T extends Record<string, unknown>>(target: T, ...sources: Partial<T>[]): T;
+/**
+ * Pick specific keys from an object
+ */
+declare function pick<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+/**
+ * Omit specific keys from an object
+ */
+declare function omit<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
+/**
+ * Get nested property value
+ */
+declare function get<T>(obj: unknown, path: string, defaultValue?: T): T | undefined;
+/**
+ * Set nested property value
+ */
+declare function set<T extends Record<string, unknown>>(obj: T, path: string, value: unknown): T;
+/**
+ * Split array into chunks
+ */
+declare function chunk<T>(arr: T[], size: number): T[][];
+/**
+ * Get unique values from array
+ */
+declare function unique<T>(arr: T[]): T[];
+/**
+ * Group array elements by key
+ */
+declare function groupBy<T, K extends string | number | symbol>(arr: T[], keyFn: (item: T) => K): Record<K, T[]>;
+/**
+ * Shuffle array (Fisher-Yates)
+ */
+declare function shuffle<T>(arr: T[]): T[];
+/**
+ * Sleep for specified milliseconds
+ */
+declare function sleep(ms: number): Promise<void>;
+/**
+ * Retry a function with exponential backoff
+ */
+declare function retry<T>(fn: () => Promise<T>, options?: {
+    maxAttempts?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    factor?: number;
+}): Promise<T>;
+/**
+ * Execute promises with concurrency limit
+ */
+declare function parallel<T>(tasks: (() => Promise<T>)[], concurrency: number): Promise<T[]>;
+/**
+ * Validate email format
+ */
+declare function isEmail(value: string): boolean;
+/**
+ * Validate URL format
+ */
+declare function isUrl(value: string): boolean;
+/**
+ * Validate UUID format
+ */
+declare function isUuid(value: string): boolean;
+/**
+ * Validate IPv4 address
+ */
+declare function isIpv4(value: string): boolean;
+/**
+ * Check if value is empty
+ */
+declare function isEmpty(value: unknown): boolean;
+
+export { base64Decode, base64Encode, base64UrlDecode, base64UrlEncode, camelCase, chunk, constantTimeEqual, deepClone, deepMerge, get, groupBy, hexDecode, hexEncode, hmac, isEmail, isEmpty, isIpv4, isUrl, isUuid, kebabCase, omit, parallel, pascalCase, pick, randomString, retry, set, sha256, sha512, shuffle, sleep, slugify, snakeCase, truncate, unique, uuid };

package/dist/utils/index.js

@@ -0,0 +1,4 @@
+export { base64Decode, base64Encode, base64UrlDecode, base64UrlEncode, camelCase, chunk, constantTimeEqual, deepClone, deepMerge, get, groupBy, hexDecode, hexEncode, hmac, isEmail, isEmpty, isIpv4, isUrl, isUuid, kebabCase, omit, parallel, pascalCase, pick, randomString, retry, set, sha256, sha512, shuffle, sleep, slugify, snakeCase, truncate, unique, uuid } from '../chunk-VDUV5SQH.js';
+import '../chunk-XUS63JTZ.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@flareone/common",
+  "version": "0.1.0",
+  "description": "Common utilities for Flareone framework",
+  "keywords": [
+    "cloudflare",
+    "workers",
+    "flareon",
+    "utilities",
+    "validation",
+    "pipes"
+  ],
+  "homepage": "https://flareone.dev",
+  "license": "MIT",
+  "author": "Flareone Contributors",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./pipes": {
+      "types": "./dist/pipes/index.d.ts",
+      "import": "./dist/pipes/index.js"
+    },
+    "./guards": {
+      "types": "./dist/guards/index.d.ts",
+      "import": "./dist/guards/index.js"
+    },
+    "./interceptors": {
+      "types": "./dist/interceptors/index.d.ts",
+      "import": "./dist/interceptors/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@flareone/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20250109.0",
+    "rimraf": "^6.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.7.0"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}