@uncaged/workflow-util (0.3.14)
Published 2026-05-13 06:10:30 +00:00 by xiaoju
Installation
@uncaged:registry=https://git.shazhou.work/api/packages/uncaged/npm/npm install @uncaged/workflow-util@0.3.14"@uncaged/workflow-util": "0.3.14"About this package
@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-protocol—Resultand shared types used by helpers
Usage
import { createLogger, getDefaultWorkflowStorageRoot, generateUlid } from "@uncaged/workflow-util";
const log = createLogger();
log("4KNMR2PX", "example");
Dependencies
Dependencies
| ID | Version |
|---|---|
| @uncaged/workflow-protocol | 0.3.11 |
Development Dependencies
| ID | Version |
|---|---|
| typescript | ^5.8.3 |