@leancodepl/logger

js_corelibrary

Packages

CQRS Clients

@leancodepl/cqrs-client-base

Base types and interfaces for CQRS client implementations.

@leancodepl/axios-cqrs-client

CQRS client with Axios for HTTP communication and type-safe command/query handling.

@leancodepl/fetch-client

Fetch client for CQRS commands and queries.

@leancodepl/react-query-cqrs-client

TanStack Query CQRS client with hooks for queries, operations, and commands with built-in caching.

@leancodepl/rx-cqrs-client

RxJS-based CQRS client for reactive command and query operations with observable streams.

Binary data types and utilities

@leancodepl/api-binary

Binary data types and utilities for API communication.

@leancodepl/api-binary-blob

Blob utilities for converting between API binary format and JavaScript Blob objects.

Dates

@leancodepl/api-date

Core date and time type definitions for API communication.

@leancodepl/api-date-datefns

Date and time utilities using date-fns for converting between API date formats and JavaScript Date objects.

@leancodepl/api-date-dayjs

Date and time utilities using Day.js for converting between API date formats and Day.js objects.

@leancodepl/api-date-utils

Common utilities for parsing and handling API date formats, including time span parsing functionality.

Pipe Clients

@leancodepl/hook-pipe-client

React hooks for real-time data subscriptions using @leancodepl/pipe with WebSocket communication.

@leancodepl/rx-pipe-client

RxJS-based topic functions for real-time data subscriptions using @leancodepl/pipe with composable operators.

Authentication & Security

@leancodepl/login-manager

OAuth2 authentication management with token storage, refresh capabilities, and social login integrations.

@leancodepl/kratos

Headless React components library for building Ory Kratos authentication flows.

Development Tools

@leancodepl/linting

Complete linting and formatting setup for TypeScript and React projects with ESLint, Prettier, and Stylelint.

@leancodepl/eslint-config

ESLint configurations for TypeScript and React projects with import sorting and accessibility rules.

@leancodepl/prettier-config

Prettier configuration for consistent code formatting across projects.

@leancodepl/stylelint-config

Stylelint configuration for CSS and SCSS with property ordering and best practices enforcement.

@leancodepl/folder-structure-cruiser

Dependency cruiser configuration for enforcing folder structure rules and cross-feature import validation.

@leancodepl/resolve-eslint-flat-config

ESLint flat config resolver for merging configuration plugins.

@leancodepl/eslint-plugin

ESLint plugin for LeanCode projects.

@leancodepl/nx-plugins

Collection of Nx plugins for LeanCode projects.

UI & Styling

@leancodepl/styled-tools

TypeScript utilities for styled-components with type-safe theme access.

@leancodepl/image-uploader

React component for image uploads.

@leancodepl/antd-table-hooks

React hooks for managing Ant Design table state — sorting, pagination, and filters — with optional URL query parameter persistence via Zod schemas.

Feature Management

@leancodepl/feature-flags-react-client

React client for feature flag management using OpenFeature standard.

@leancodepl/openfeature-posthog-provider

OpenFeature provider that delegates feature flag evaluation to PostHog. Use PostHog feature flags through the OpenFeature standard API.

Analytics

@leancodepl/gtag

Type-safe Google Tag Manager data layer integration for web analytics and event tracking.

@leancodepl/cookie-consent

Cookie consent helper integrating vanilla-cookieconsent with Google Consent Mode.

Logging

@leancodepl/logger

Structured logger with middleware support and contextual messages. Use the base package for custom log handlers, or pick a preset:

• @leancodepl/logger – Core API: createLogger, withContext, withMiddleware, contextual message functions. All listed below can be also imported from the base package.
• @leancodepl/logger/cli – Colored console logger for CLI apps: createCliLogger with configurable log levels (error, warn, success, info, verbose, debug).
• @leancodepl/logger/json – JSON lines to stdout: createJsonLogger with the same level filtering as the CLI preset.
• @leancodepl/logger/nest – NestJS LoggerService adapter: createNestJsonLogger() for drop-in use in Nest apps with JSON output.

Translation & Internationalization

@leancodepl/intl

Command-line tool for managing FormatJS translations with POEditor integration.

@leancodepl/mail-translation

Command-line tool for processing MJML and plaintext email templates with optional internationalization support.

Utilities

@leancodepl/utils

Utility library for common development tasks including assertions, transformations, and React hooks.

@leancodepl/config

Utility for creating configuration getters that access Vite-injected values in development and environment variables in production.

@leancodepl/force-update

Library for implementing force update functionality in web applications.

@leancodepl/validation

Validation utilities for handling API responses and error management with custom error codes.

@leancodepl/vite-plugin-favicon

Vite plugin for generating favicons from source logos with automatic HTML injection and multiple format support.

@leancodepl/cyberware-contract

Type-safe contracts between host app and remote iframe app (e.g., Replit embed) with postMessage communication.

Development

Testing

Run tests for a specific package:

nx test [package-name]

Building

Build a specific package:

nx build [package-name]

Linting

Run linting for a specific package:

nx lint [package-name]

Publishing

1. Create a new branch, name it release/[version] e.g. release/1.2.3
2. Push that empty branch to the remote (required for the next step to work).
3. Run npx lerna version [version] e.g. npx lerna version 1.2.3. This command will automatically bump versions across all files and push the changes.
4. Create a new pull request for this branch.
5. Go to the Actions tab, and then Release workflow. Expand the Run workflow menu, from the Tags tab choose your new version and run the workflow.
6. After refreshing the page you should be able to see the workflow running. After it finishes successfully, go back to the previously created PR and merge it.

Local publishing

To test publishing against a local Verdaccio registry:

1. Start the local registry (in one terminal). Prefer the Nx target:

   npx nx local-registry

2. Publish all packages to it (in another terminal):

   npx nx local-publish --ver=1.0.0