CAPS Core

FsFlow.Caps.Core is the smallest shared capability package in the FsFlow CAPS story. It keeps the surface synchronous and explicit: clock, random, GUID, and environment-variable capabilities.

Capability types

• FsFlow.Caps.Core.IClock: Provides synchronous access to the current UTC clock.
• FsFlow.Caps.Core.IRandom: Provides synchronous random-number generation.
• FsFlow.Caps.Core.IGuid: Provides synchronous GUID generation.
• FsFlow.Caps.Core.IEnvironmentVariables: Provides synchronous environment-variable lookup.
• FsFlow.Caps.Core.EnvironmentVariableError: Describes a meaningful environment-variable failure.

Clock

• FsFlow.Caps.Core.Clock.now: Reads the current UTC timestamp from the environment.
• FsFlow.Caps.Core.Clock.live: Creates a live clock backed by UtcNow.
• FsFlow.Caps.Core.Clock.fromValue: Creates a deterministic clock that always returns the supplied instant.

Random

• FsFlow.Caps.Core.Random.nextInt: Reads a random integer from the environment.
• FsFlow.Caps.Core.Random.live: Creates a live random-number generator backed by Random.
• FsFlow.Caps.Core.Random.fromValue: Creates a deterministic random generator that always returns the supplied value.

GUID

• FsFlow.Caps.Core.Guid.newGuid: Reads a GUID from the environment.
• FsFlow.Caps.Core.Guid.live: Creates a live GUID generator backed by NewGuid.
• FsFlow.Caps.Core.Guid.fromValue: Creates a deterministic GUID generator that always returns the supplied value.

Environment variables

• FsFlow.Caps.Core.EnvironmentVariables.tryGet: Reads a raw environment-variable value from the environment.
• FsFlow.Caps.Core.EnvironmentVariables.live: Creates a live provider backed by the current process environment.
• FsFlow.Caps.Core.EnvironmentVariables.fromPairs: Creates a deterministic provider from a fixed set of name/value pairs.
• FsFlow.Caps.Core.EnvironmentVariable.tryGet: Reads a raw string environment variable without wrapping it in a result.
• FsFlow.Caps.Core.EnvironmentVariable.get: Reads a raw string environment variable from the environment.
• FsFlow.Caps.Core.EnvironmentVariable.getInt: Reads an integer environment variable from the environment.
• FsFlow.Caps.Core.EnvironmentVariable.getGuid: Reads a GUID environment variable from the environment.
• FsFlow.Caps.Core.EnvironmentVariable.getBool: Reads a boolean environment variable from the environment.
• FsFlow.Caps.Core.EnvironmentVariableErrors.describe: Formats a human-readable description for an error.