@effected/config-file 0.2.0 → 0.3.0

package/ConfigCodec.js

@@ -10,7 +10,7 @@ import { Schema } from "effect";
 *
 * @public
 */
-var ConfigCodecError = class extends Schema.TaggedErrorClass()("ConfigCodecError", {
+var ConfigCodecError = class extends Schema.TaggedError()("ConfigCodecError", {
 	/** The codec that failed, e.g. `"json"`. */
 	codec: Schema.String,
 	/** Which direction failed. */

package/ConfigFile.js

@@ -13,7 +13,7 @@ import { Context, DateTime, Effect, FileSystem, Layer, Option, Path, PubSub, Sch
 *
 * @public
 */
-var ConfigFileNotFoundError = class extends Schema.TaggedErrorClass()("ConfigFileNotFoundError", { 
+var ConfigFileNotFoundError = class extends Schema.TaggedError()("ConfigFileNotFoundError", { 
 /** The names of the resolvers that were probed, in order. */
 searched: Schema.Array(Schema.String) }) {
 	get message() {
@@ -29,7 +29,7 @@ searched: Schema.Array(Schema.String) }) {
 *
 * @public
 */
-var ConfigFileReadError = class extends Schema.TaggedErrorClass()("ConfigFileReadError", {
+var ConfigFileReadError = class extends Schema.TaggedError()("ConfigFileReadError", {
 	/** The path that could not be read. */
 	path: Schema.String,
 	/** The underlying failure, preserved structurally. */
@@ -44,7 +44,7 @@ var ConfigFileReadError = class extends Schema.TaggedErrorClass()("ConfigFileRea
 *
 * @public
 */
-var ConfigFileWriteError = class extends Schema.TaggedErrorClass()("ConfigFileWriteError", {
+var ConfigFileWriteError = class extends Schema.TaggedError()("ConfigFileWriteError", {
 	/** The path that could not be written. */
 	path: Schema.String,
 	/** The underlying failure, preserved structurally. */
@@ -69,7 +69,7 @@ var ConfigFileWriteError = class extends Schema.TaggedErrorClass()("ConfigFileWr
 *
 * @public
 */
-var ConfigDefaultPathMissingError = class extends Schema.TaggedErrorClass()("ConfigDefaultPathMissingError", {}) {
+var ConfigDefaultPathMissingError = class extends Schema.TaggedError()("ConfigDefaultPathMissingError", {}) {
 	get message() {
 		return "No `defaultPath` configured: `save` and `update` require ConfigFileOptions.defaultPath";
 	}
@@ -87,7 +87,7 @@ var ConfigDefaultPathMissingError = class extends Schema.TaggedErrorClass()("Con
 *
 * @public
 */
-var ConfigValidationError = class extends Schema.TaggedErrorClass()("ConfigValidationError", {
+var ConfigValidationError = class extends Schema.TaggedError()("ConfigValidationError", {
 	/** The offending file, absent when `validate` was called on an in-memory value. */
 	path: Schema.Option(Schema.String),
 	/** The structured schema issue. Never a string. */

package/ConfigMigration.js

@@ -12,7 +12,7 @@ import { Effect, Schema } from "effect";
 *
 * @public
 */
-var ConfigMigrationError = class extends Schema.TaggedErrorClass()("ConfigMigrationError", {
+var ConfigMigrationError = class extends Schema.TaggedError()("ConfigMigrationError", {
 	/** The target version of the step that failed. `0` when reading the version failed. */
 	version: Schema.Number,
 	/** The name of the step that failed; empty when reading the version failed. */

package/EncryptedCodec.js

@@ -14,7 +14,7 @@ import { Duration, Effect, Exit, Schema } from "effect";
 *
 * @public
 */
-var ConfigEncryptionError = class extends Schema.TaggedErrorClass()("ConfigEncryptionError", {
+var ConfigEncryptionError = class extends Schema.TaggedError()("ConfigEncryptionError", {
 	/** Which cryptographic stage failed. */
 	phase: Schema.Literals([
 		"key-derivation",

package/README.md

@@ -98,6 +98,25 @@ export const SettingsLive = ConfigFile.layer(SettingsConfig, {
 });
 ```
 
+## Reading one known path
+
+Not every caller has a config file — some just have one path a caller already vouched for, such as a CLI's `--config` flag. `ConfigFile.read` is the one-shot escape from the service, the layer and the resolver chain: read, decode and validate a single path, with the schema and codec named per call rather than bound to a service class:
+
+```ts
+import { ConfigFile, JsonCodec } from "@effected/config-file";
+import { NodeFileSystem } from "@effect/platform-node";
+import { Effect, Schema } from "effect";
+
+class MyConfig extends Schema.Class<MyConfig>("MyConfig")({ port: Schema.Number }) {}
+
+const program = ConfigFile.read("./app.config.json", { schema: MyConfig, codec: JsonCodec });
+
+Effect.runPromise(program.pipe(Effect.provide(NodeFileSystem.layer))).then(console.log);
+// MyConfig { port: 3000 }
+```
+
+It is deliberately read-only and discovery-free — no resolver chain, no `save`/`update`. Reach for `ConfigFile.layer` the moment either is wanted.
+
 ## Errors
 
 Every failure is a tagged error you route on with `Effect.catchTag`. The tags exist so that recovery can differ:
@@ -166,6 +185,7 @@ export const secret = EncryptedCodec(migrating, EncryptedCodecKey.fromPassphrase
 ## Features
 
 - `ConfigFile.Service` / `ConfigFile.layer` / `ConfigFile.testLayer` — a per-schema service class and its layers. `testLayer` seeds files into a temp directory and wires the *real* implementation over them, so tests exercise the actual pipeline rather than a stub that can drift from it.
+- `ConfigFile.read` — the one-shot escape from the service: read, decode and validate one explicit path, schema and codec named per call, with no resolver chain and no write path.
 - `ConfigResolver` — `explicitPath`, `staticDir`, `upwardWalk`, `workspaceRoot`, `gitRoot` and `systemEtc`. A resolver's error channel is `never` by contract: every filesystem failure becomes `Option.none()`, so one unreadable tier never aborts the chain.
 - `MergeStrategy` — `firstMatch` and `layeredMerge`, combining discovered sources in priority order.
 - `JsonCodec`, `JsoncCodec`, `YamlCodec`, `TomlCodec` — JSON, JSONC, YAML and TOML in the box, exported free-standing so an unused format's engine is tree-shaken away.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@effected/config-file",
-	"version": "0.2.0",
+	"version": "0.3.0",
 	"private": false,
 	"description": "Composable config file loading for Effect: JSON, JSONC, YAML and TOML codecs, resolution strategies, and merge behaviors.",
 	"keywords": [
@@ -43,11 +43,11 @@
 		"./package.json": "./package.json"
 	},
 	"peerDependencies": {
-		"@effected/jsonc": "~0.5.1",
-		"@effected/toml": "~0.3.1",
-		"@effected/walker": "~0.3.3",
-		"@effected/yaml": "~0.6.0",
-		"effect": "4.0.0-beta.101"
+		"@effected/jsonc": "^0.6.0",
+		"@effected/toml": "^0.4.0",
+		"@effected/walker": "^0.4.0",
+		"@effected/yaml": "^0.7.0",
+		"effect": "4.0.0-beta.107"
 	},
 	"engines": {
 		"node": ">=24.11.0"