@adriangalilea/utils 0.0.10

package/README.md

@@ -0,0 +1,99 @@
+# ts-utils
+
+TypeScript utilities - logger, currency, offensive programming, file operations, environment management, and more.
+
+## Installation
+
+```bash
+# Using JSR (recommended)
+pnpm dlx jsr add @adriangalilea/utils
+
+# or with npm
+npx jsr add @adriangalilea/utils
+```
+
+## Usage
+
+### Logger
+
+Next.js-style logger with colored output and Unicode symbols:
+
+```typescript
+import { wait, error, warn, ready, info, success, event, trace, createLogger } from '@adriangalilea/utils'
+
+// Basic logging
+wait('Loading...')
+error('Something went wrong')
+warn('This is a warning')
+ready('Server is ready')
+info('Information message')
+success('Operation successful')
+event('Event occurred')
+trace('Trace message')
+
+// Warn once (won't repeat same message)
+warnOnce('This warning appears only once')
+
+// Timer functionality
+time('operation')
+// ... do something
+timeEnd('operation') // outputs: operation: 123ms
+
+// Create prefixed logger
+const apiLogger = createLogger('API')
+apiLogger.info('Request received')  // [API] Request received
+```
+
+### Currency
+
+Currency utilities with comprehensive crypto support (500+ symbols):
+
+```typescript
+import { currency, isCrypto, isStablecoin, isFiat, getSymbol, getOptimalDecimals } from '@adriangalilea/utils'
+
+// Check currency types
+isCrypto('BTC')  // true
+isCrypto('XBT')  // true (alternative for BTC)
+isCrypto('WBTC')  // true (wrapped tokens detected)
+isStablecoin('USDT')  // true
+isFiat('USD')  // true
+
+// Get currency symbols
+getSymbol('BTC')  // '₿'
+getSymbol('ETH')  // 'Ξ'
+getSymbol('USD')  // '$'
+
+// Get optimal decimal places based on value
+getOptimalDecimals(0.00001234, 'BTC')  // 10
+getOptimalDecimals(1234.56, 'USD')  // 2
+getOptimalDecimals(0.123, 'ETH')  // 6
+
+// Percentage calculations
+currency.percentageOf(25, 100)  // 25
+currency.percentageChange(100, 150)  // 50
+currency.percentageDiff(100, 150)  // 40
+
+// Basis points
+currency.basisPointsToPercent(100)  // 1
+currency.percentToBasisPoints(1)  // 100
+currency.formatBasisPoints(50)  // "50 bps"
+```
+
+## Features
+
+- **Logger**: Next.js-style colored console output with symbols
+- **Currency**: 
+  - 13,750+ crypto symbols from CoinGecko (auto-updatable)
+  - Alternative ticker support (XBT→BTC, wrapped tokens, etc.)
+  - Optimal decimal calculations
+  - Percentage and basis point utilities
+  - Fiat and stablecoin detection
+- **Offensive Programming**: Assert, must, check, panic utilities
+- **File Operations**: Read, write with automatic path resolution
+- **Directory Operations**: Create, list, walk directories
+- **KEV**: Redis-style environment variable management with monorepo support
+- **Project Discovery**: Find project/monorepo roots, detect JS/TS projects
+
+## License
+
+MIT

package/dist/browser.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Browser-safe exports for client-side usage.
+ * These utilities do not depend on Node.js APIs and can run in the browser.
+ *
+ * Usage in Next.js client components:
+ * import { log, format, currency } from '@adriangalilea/utils/browser'
+ */
+export { runtime } from './runtime.js';
+export type { RuntimeCapabilities } from './runtime.js';
+export * from './universal/log.js';
+export * from './universal/format.js';
+export * from './universal/currency/index.js';
+export * from './offensive.js';
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAGvD,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAG7C,cAAc,gBAAgB,CAAA"}

package/dist/browser.js

@@ -0,0 +1,18 @@
+/**
+ * Browser-safe exports for client-side usage.
+ * These utilities do not depend on Node.js APIs and can run in the browser.
+ *
+ * Usage in Next.js client components:
+ * import { log, format, currency } from '@adriangalilea/utils/browser'
+ */
+// Export runtime for environment detection
+export { runtime } from './runtime.js';
+// Universal utilities that work in browser
+export * from './universal/log.js';
+export * from './universal/format.js';
+export * from './universal/currency/index.js';
+// Offensive programming - adapted for browser (throws instead of process.exit)
+export * from './offensive.js';
+// Note: file, dir, path, project, and kev are NOT exported here
+// because they depend on Node.js file system APIs
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2CAA2C;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGtC,2CAA2C;AAC3C,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAE7C,+EAA+E;AAC/E,cAAc,gBAAgB,CAAA;AAE9B,gEAAgE;AAChE,kDAAkD"}

package/dist/currency/crypto-symbols-data.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generated on 2025-08-17T10:11:21.771Z
+ * 13,754 cryptocurrency symbols from CoinGecko API
+ *
+ * Run 'npm run update-crypto' to refresh this list
+ */
+export declare const cryptoSymbolsData: readonly string[];
+export declare const lastUpdated = "2025-08-17T10:11:21.771Z";
+export declare const symbolCount = 13754;
+//# sourceMappingURL=crypto-symbols-data.d.ts.map

package/dist/currency/crypto-symbols-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-symbols-data.d.ts","sourceRoot":"","sources":["../../src/currency/crypto-symbols-data.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EA27a9C,CAAA;AAED,eAAO,MAAM,WAAW,6BAA6B,CAAA;AACrD,eAAO,MAAM,WAAW,QAAQ,CAAA"}