ts-packages 1.0.0 → 2.0.0

package/packages/js-extensions/dist/types/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './config';
+export * from './helpers';

package/packages/js-extensions/node_modules/.bin/rimraf

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/dist/esm/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/dist/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/dist/esm/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/dist/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../rimraf/dist/esm/bin.mjs" "$@"
+else
+  exec node  "$basedir/../rimraf/dist/esm/bin.mjs" "$@"
+fi

package/packages/js-extensions/node_modules/.bin/tsc

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsc" "$@"
+fi

package/packages/js-extensions/node_modules/.bin/tsserver

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsserver" "$@"
+fi

package/packages/js-extensions/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@naman_deep_singh/js-extensions",
+  "version": "1.3.3",
+  "description": "Universal JavaScript prototype extensions for common development utilities",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "browser": "./dist/esm/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "pnpm run build:types && tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json",
+    "build:types": "tsc -p tsconfig.base.json --emitDeclarationOnly --outDir dist/types",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "javascript",
+    "utilities",
+    "extensions",
+    "prototype",
+    "string",
+    "array",
+    "object",
+    "universal"
+  ],
+  "author": "Naman Deep Singh",
+  "license": "ISC",
+  "packageManager": "pnpm@10.20.0",
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "rimraf": "^5.0.5"
+  }
+}

package/packages/js-extensions/src/array/array-extensions.ts

@@ -0,0 +1,174 @@
+// Array prototype extensions
+export function extendArray() {
+	Array.prototype.unique = function <T>(): T[] {
+		return [...new Set(this)]
+	}
+
+	Array.prototype.shuffle = function <T>(): T[] {
+		const arr = [...this]
+		for (let i = arr.length - 1; i > 0; i--) {
+			const j = Math.floor(Math.random() * (i + 1))
+			;[arr[i], arr[j]] = [arr[j], arr[i]]
+		}
+		return arr
+	}
+
+	Array.prototype.chunk = function <T>(size: number): T[][] {
+		if (!Number.isInteger(size) || size <= 0) {
+			throw new TypeError(`chunk: size must be a positive integer, got ${size}`)
+		}
+		const chunks: T[][] = []
+		for (let i = 0; i < this.length; i += size) {
+			chunks.push(this.slice(i, i + size))
+		}
+		return chunks
+	}
+
+	Array.prototype.groupBy = function <T>(
+		keyFn: (item: T) => string | number,
+	): Record<string | number, T[]> {
+		if (typeof keyFn !== 'function') {
+			throw new TypeError(
+				`groupBy: keyFn must be a function, got ${typeof keyFn}`,
+			)
+		}
+
+		return this.reduce(
+			(groups, item) => {
+				const key = keyFn(item)
+				if (!groups[key]) groups[key] = []
+				groups[key].push(item)
+				return groups
+			},
+			{} as Record<string | number, T[]>,
+		)
+	}
+
+	Array.prototype.sum = function (): number {
+		const numbers = this.filter((item) => typeof item === 'number')
+		if (numbers.length === 0) {
+			throw new TypeError('sum: array must contain at least one number')
+		}
+		return numbers.reduce((sum, num) => sum + num, 0)
+	}
+
+	Array.prototype.average = function (): number {
+		const numbers = this.filter((item) => typeof item === 'number')
+		if (numbers.length === 0) {
+			throw new TypeError('average: array must contain at least one number')
+		}
+		return numbers.reduce((sum, num) => sum + num, 0) / numbers.length
+	}
+
+	Array.prototype.compact = function <T>(): T[] {
+		return this.filter((item) => item != null && item !== '' && item !== false)
+	}
+
+	Array.prototype.pluck = function <T, K extends keyof T>(key: K): T[K][] {
+		if (
+			typeof key !== 'string' &&
+			typeof key !== 'number' &&
+			typeof key !== 'symbol'
+		) {
+			throw new TypeError(
+				`pluck: key must be a string, number, or symbol, got ${typeof key}`,
+			)
+		}
+
+		return this.map((item) =>
+			item && typeof item === 'object' ? item[key] : undefined,
+		).filter((val) => val !== undefined)
+	}
+
+	Array.prototype.findLast = function <T>(
+		predicate: (item: T) => boolean,
+	): T | undefined {
+		if (typeof predicate !== 'function') {
+			throw new TypeError(
+				`findLast: predicate must be a function, got ${typeof predicate}`,
+			)
+		}
+
+		for (let i = this.length - 1; i >= 0; i--) {
+			if (predicate(this[i])) return this[i]
+		}
+		return undefined
+	}
+
+	Array.prototype.partition = function <T>(
+		predicate: (item: T) => boolean,
+	): [T[], T[]] {
+		if (typeof predicate !== 'function') {
+			throw new TypeError(
+				`partition: predicate must be a function, got ${typeof predicate}`,
+			)
+		}
+
+		const truthy: T[] = []
+		const falsy: T[] = []
+		this.forEach((item) =>
+			predicate(item) ? truthy.push(item) : falsy.push(item),
+		)
+		return [truthy, falsy]
+	}
+
+	Array.prototype.flatten = function (depth = 1): any[] {
+		return depth > 0
+			? this.reduce(
+					(acc: any[], val) =>
+						acc.concat(Array.isArray(val) ? val.flatten(depth - 1) : val),
+					[],
+				)
+			: this.slice()
+	}
+
+	Array.prototype.deepFlatten = function (): any[] {
+		return this.reduce(
+			(acc: any[], val) =>
+				acc.concat(Array.isArray(val) ? val.deepFlatten() : val),
+			[],
+		)
+	}
+
+	Array.prototype.difference = function <T>(other: T[]): T[] {
+		if (!Array.isArray(other)) {
+			throw new TypeError(
+				`difference: other must be an array, got ${typeof other}`,
+			)
+		}
+
+		return this.filter((item) => !other.includes(item))
+	}
+
+	Array.prototype.intersection = function <T>(other: T[]): T[] {
+		if (!Array.isArray(other)) {
+			throw new TypeError(
+				`intersection: other must be an array, got ${typeof other}`,
+			)
+		}
+
+		return this.filter((item) => other.includes(item))
+	}
+
+	Array.prototype.union = function <T>(other: T[]): T[] {
+		if (!Array.isArray(other)) {
+			throw new TypeError(`union: other must be an array, got ${typeof other}`)
+		}
+
+		return [...new Set([...this, ...other])]
+	}
+
+	Array.prototype.sample = function <T>(): T | undefined {
+		return this.length > 0
+			? this[Math.floor(Math.random() * this.length)]
+			: undefined
+	}
+
+	Array.prototype.take = function <T>(count: number): T[] {
+		return this.slice(0, Math.max(0, count))
+	}
+
+	Array.prototype.drop = function <T>(count: number): T[] {
+		return this.slice(Math.max(0, count))
+	}
+}

package/packages/js-extensions/src/array/index.ts

@@ -0,0 +1 @@
+export { extendArray } from './array-extensions'

package/packages/js-extensions/src/core/index.ts

@@ -0,0 +1,3 @@
+// Re-export core utilities
+export * from './validation'
+export * from './performance'

package/packages/js-extensions/src/core/performance.ts

@@ -0,0 +1,92 @@
+// Performance optimization utilities
+export interface PerformanceConfig {
+	enableCaching?: boolean
+	maxCacheSize?: number
+	enableValidation?: boolean
+}
+
+const defaultConfig: PerformanceConfig = {
+	enableCaching: false,
+	maxCacheSize: 100,
+	enableValidation: true,
+}
+
+let config: PerformanceConfig = { ...defaultConfig }
+
+export function setPerformanceConfig(
+	newConfig: Partial<PerformanceConfig>,
+): void {
+	const oldMaxSize = config.maxCacheSize
+	config = { ...config, ...newConfig }
+
+	// Recreate cache if maxCacheSize changed
+	if (cache && oldMaxSize !== config.maxCacheSize) {
+		cache = new LRUCache(config.maxCacheSize)
+	}
+}
+
+export function getPerformanceConfig(): PerformanceConfig {
+	return { ...config }
+}
+
+// Simple LRU cache for expensive operations
+export class LRUCache<K, V> {
+	private cache = new Map<K, V>()
+	private maxSize: number
+
+	constructor(maxSize = 100) {
+		this.maxSize = maxSize
+	}
+
+	get(key: K): V | undefined {
+		const value = this.cache.get(key)
+		if (value !== undefined) {
+			// Move to end (most recently used)
+			this.cache.delete(key)
+			this.cache.set(key, value)
+		}
+		return value
+	}
+
+	set(key: K, value: V): void {
+		if (this.cache.has(key)) {
+			this.cache.delete(key)
+		} else if (this.cache.size >= this.maxSize) {
+			// Remove least recently used (first item)
+			const firstKey = this.cache.keys().next().value
+			if (firstKey !== undefined) {
+				this.cache.delete(firstKey)
+			}
+		}
+		this.cache.set(key, value)
+	}
+
+	clear(): void {
+		this.cache.clear()
+	}
+}
+
+let cache: LRUCache<string, any> | null = null
+
+function getOrCreateCache(): LRUCache<string, any> {
+	if (!cache) {
+		cache = new LRUCache(config.maxCacheSize)
+	}
+	return cache
+}
+
+export function withCache<T>(key: string, fn: () => T): T {
+	if (!config.enableCaching) {
+		return fn()
+	}
+
+	const currentCache = getOrCreateCache()
+	const cached = currentCache.get(key)
+	if (cached !== undefined) {
+		return cached as T
+	}
+
+	const result = fn()
+	currentCache.set(key, result)
+	return result
+}

package/packages/js-extensions/src/core/validation.ts

@@ -0,0 +1,42 @@
+// Validation utilities for extensions
+export function validateExtensionInput(
+	value: any,
+	type: string,
+	methodName: string,
+): void {
+	if (value == null) {
+		throw new TypeError(`Cannot call ${methodName} on ${value}`)
+	}
+
+	const actualType = typeof value
+	if (actualType !== type) {
+		throw new TypeError(
+			`${methodName} can only be called on ${type} values, got ${actualType}`,
+		)
+	}
+}
+
+export function validateArrayInput<T>(arr: T[], methodName: string): void {
+	if (!Array.isArray(arr)) {
+		throw new TypeError(`${methodName} can only be called on arrays`)
+	}
+}
+
+export function validateNumberRange(
+	num: number,
+	min: number,
+	max: number,
+	methodName: string,
+): void {
+	if (num < min || num > max) {
+		throw new RangeError(
+			`${methodName}: number must be between ${min} and ${max}, got ${num}`,
+		)
+	}
+}
+
+export function validatePositiveInteger(num: number, methodName: string): void {
+	if (!Number.isInteger(num) || num < 0) {
+		throw new TypeError(`${methodName}: expected positive integer, got ${num}`)
+	}
+}

package/packages/js-extensions/src/extensions/index.ts

@@ -0,0 +1,5 @@
+// Re-export all extensions
+export * from '../string'
+export * from '../array'
+export * from '../object'
+export * from '../number'

package/packages/js-extensions/src/index.ts

@@ -0,0 +1,120 @@
+// Import types first
+import '../types/global-augmentations'
+
+import { extendArray } from './array'
+import { extendNumber } from './number'
+
+import { extendObject } from './object'
+// Import extension modules
+import { extendString } from './string'
+
+// Import core utilities
+import {
+	LRUCache,
+	getPerformanceConfig,
+	setPerformanceConfig,
+	withCache,
+} from './core/performance'
+
+// Import validation utilities
+import {
+	validateArrayInput,
+	validateExtensionInput,
+	validateNumberRange,
+	validatePositiveInteger,
+} from './core/validation'
+
+// Import utility functions
+import {
+	mergeConfigs,
+	validateConfig,
+	validatePerformanceSettings,
+} from './utils/config'
+
+import {
+	ensurePositiveInteger,
+	getPathSegments,
+	hasOwnProperty,
+	isValidArrayIndex,
+	safeClone,
+} from './utils/helpers'
+
+// Re-export types
+import { ExtensionOptions, PerformanceConfig } from './types/extension-types'
+export { ExtensionOptions, PerformanceConfig }
+
+// Export withCache for use in extensions
+export { withCache }
+
+// Import initialization functions
+import { extendAll, initExtensions } from './init/initializer'
+
+/**
+ * Initialize JavaScript prototype extensions
+ * @param options - Configure which extensions to enable (default: all enabled)
+ */
+export function initializeExtensions(options: ExtensionOptions = {}): void {
+	initExtensions(options)
+}
+
+/**
+ * Initialize all extensions (convenience function)
+ */
+export { extendAll }
+
+/**
+ * Initialize only specific extensions
+ */
+export const extend = {
+	string: extendString,
+	array: extendArray,
+	object: extendObject,
+	number: extendNumber,
+}
+
+// Export validation utilities
+export {
+	validateExtensionInput,
+	validateArrayInput,
+	validateNumberRange,
+	validatePositiveInteger,
+}
+
+// Export utility functions
+export {
+	validateConfig,
+	validatePerformanceSettings,
+	mergeConfigs,
+	isValidArrayIndex,
+	ensurePositiveInteger,
+	safeClone,
+	getPathSegments,
+	hasOwnProperty,
+}
+
+// Export performance utilities
+export { LRUCache, setPerformanceConfig, getPerformanceConfig }
+
+// Default export
+export default {
+	initializeExtensions,
+	extendAll,
+	extend,
+	LRUCache,
+	setPerformanceConfig,
+	getPerformanceConfig,
+	// Validation utilities
+	validateExtensionInput,
+	validateArrayInput,
+	validateNumberRange,
+	validatePositiveInteger,
+	// Utility functions
+	validateConfig,
+	validatePerformanceSettings,
+	mergeConfigs,
+	isValidArrayIndex,
+	ensurePositiveInteger,
+	safeClone,
+	getPathSegments,
+	hasOwnProperty,
+}

package/packages/js-extensions/src/init/index.ts

@@ -0,0 +1,3 @@
+// Re-export initialization logic
+export * from './initializer'
+export * from './options'

package/packages/js-extensions/src/init/initializer.ts

@@ -0,0 +1,32 @@
+// Extension initialization logic
+import { extendArray } from '../array'
+import { setPerformanceConfig } from '../core/performance'
+import { extendNumber } from '../number'
+import { extendObject } from '../object'
+import { extendString } from '../string'
+
+import type { ExtensionOptions } from '../types/extension-types'
+
+export function initExtensions(options: ExtensionOptions = {}): void {
+	const {
+		string = true,
+		array = true,
+		object = true,
+		number = true,
+		performance,
+	} = options
+
+	if (performance) {
+		// Set performance config if provided
+		setPerformanceConfig(performance)
+	}
+
+	if (string) extendString()
+	if (array) extendArray()
+	if (object) extendObject()
+	if (number) extendNumber()
+}
+
+export function extendAll(): void {
+	initExtensions()
+}

package/packages/js-extensions/src/init/options.ts

@@ -0,0 +1,32 @@
+// Extension options validation
+import type { ExtensionOptions } from '../types/extension-types'
+
+export function validateExtensionOptions(
+	options: Partial<ExtensionOptions>,
+): ExtensionOptions {
+	const validated: ExtensionOptions = {
+		string: options.string !== false,
+		array: options.array !== false,
+		object: options.object !== false,
+		number: options.number !== false,
+		performance: options.performance,
+	}
+
+	return validated
+}
+
+export function createExtensionOptions(
+	enableString = true,
+	enableArray = true,
+	enableObject = true,
+	enableNumber = true,
+	performanceConfig?: any,
+): ExtensionOptions {
+	return {
+		string: enableString,
+		array: enableArray,
+		object: enableObject,
+		number: enableNumber,
+		performance: performanceConfig,
+	}
+}

package/packages/js-extensions/src/number/index.ts

@@ -0,0 +1 @@
+export { extendNumber } from './number-extensions'