Files
united-workforce/packages/workflow-util
xingyue 1abc3b4cf4 chore: fix all biome lint errors across monorepo
- Fix import ordering (organizeImports) across multiple packages
- Replace forEach with for...of loops (noForEach)
- Replace non-null assertions with fallback values (noNonNullAssertion)
- Add biome-ignore comments for justified noExplicitAny usages
- Remove parameter properties, use explicit class properties (noParameterProperties)
- Fix string concatenation to template literals (useTemplate)
- Fix format issues (CSS, TypeScript)
- Add tailwindDirectives CSS parser config in biome.json
- Replace var with const (noVar)

Result: 0 errors, 12 warnings (all cognitive complexity, acceptable)
2026-05-23 18:39:02 +08:00
..

@uncaged/workflow-util

Shared utilities: encoding, IDs, logging, storage paths, and ref-field normalization.

What This Package Does

It provides filesystem-safe Base32 and ULID generation, the structured logger used across packages, helpers for the default workflow data directory and global CAS path, and utilities to merge/normalize refs on steps. It re-exports ok/err from protocol for convenience.

Key Exports

From src/index.ts:

  • Base32: CROCKFORD_BASE32_ALPHABET, decodeCrockfordBase32Bits, decodeCrockfordToUint64, encodeCrockfordBase32Bits, encodeUint64AsCrockford
  • Logger: createLogger
  • Refs: mergeRefsWithContentHash, normalizeRefsField
  • Result: ok, err (from @uncaged/workflow-protocol)
  • Paths: getDefaultWorkflowStorageRoot, getGlobalCasDir
  • ULID: generateUlid
  • Types: CreateLoggerOptions, LogFn, LoggerSink, Result

Dependencies

  • Workspace: @uncaged/workflow-protocolResult and shared types used by helpers

Usage

import { createLogger, getDefaultWorkflowStorageRoot, generateUlid } from "@uncaged/workflow-util";

const log = createLogger();
log("4KNMR2PX", "example");