@freelang/stdlib

Complete FreeLang Standard Library - Meta-package that aggregates all 40+ modules.

Installation

npm install @freelang/stdlib
# or
pnpm add @freelang/stdlib

Quick Start

import * as stdlib from '@freelang/stdlib';

// Access all modules
console.log(stdlib.modules());
console.log(stdlib.version());
console.log(stdlib.info());

// Use specific modules
const { fs, path, http } = stdlib;

Included Modules

Core (7)

• io - I/O operations
• fs - File system
• os - Operating system
• path - Path utilities
• env - Environment
• json - JSON handling
• math - Math functions

Collections (4)

• string - String utilities
• collection - Data structures
• datetime - Date/time
• regexp - Regular expressions

Network (5)

• url - URL parsing
• http - HTTP client
• tcp - TCP sockets
• ws - WebSockets
• grpc - gRPC services

Security (4)

• hash - Cryptographic hashing
• jwt - JWT tokens
• aes - AES encryption
• bcrypt - Password hashing

Utilities (6)

• atomic - Atomic operations
• mutex - Mutual exclusion
• promise - Promise utilities
• timer - Timers
• logger - Logging
• test - Testing

Infrastructure (4)

• sql - SQL operations
• orm - Object-relational mapping
• prometheus - Prometheus metrics
• swagger - OpenAPI/Swagger

Advanced (10)

• cache - Caching
• event - Event emitters
• stream - Stream processing
• validate - Data validation
• queue - Queues
• compress - Compression
• config - Configuration
• worker - Worker pools
• plugin - Plugin system
• email - Email sending

API Reference

modules(): string[]

Returns array of all available module names (40 modules).

version(): string

Returns the library version.

info(): LibraryInfo

Returns metadata about the library.

interface LibraryInfo {
  name: string;
  version: string;
  description: string;
  moduleCount: number;
}

Examples

Using File System Module

import * as stdlib from '@freelang/stdlib';

const { fs } = stdlib;
// Use fs module...

Using HTTP Module

import * as stdlib from '@freelang/stdlib';

const { http } = stdlib;
// Use http module...

Using All Utilities

import * as stdlib from '@freelang/stdlib';

const { logger, timer, promise } = stdlib;
// Use utilities...

Alternative: Install Individual Modules

If you only need specific modules, you can install them separately:

npm install @freelang/fs @freelang/http @freelang/logger

This reduces your bundle size while still giving you access to the modules you need.

Performance Note

Importing the complete stdlib meta-package includes all dependencies. For production applications with strict bundle size requirements, consider installing only the modules you need.

Contributing

See the main FreeLang Standard Library repository for contribution guidelines.

License

MIT