@savvy-web/github-action-builder 1.1.2 → 2.0.0

package/index.d.ts

@@ -16,15 +16,13 @@ import { Context, Effect, Layer, Schema } from "effect";
  */
 declare const EntriesSchema: Schema.Struct<{
   /** Path to the main action entry point. Defaults to "src/main.ts". */
-  main: Schema.optionalWith<typeof Schema.String, {
-    default: () => string;
-  }>;
+  readonly main: Schema.withDecodingDefaultType<Schema.String, never>;
   /** Path to the pre-action hook entry point. */
-  pre: Schema.optional<typeof Schema.String>;
+  readonly pre: Schema.optional<Schema.String>;
   /** Path to the post-action hook entry point. */
-  post: Schema.optional<typeof Schema.String>;
+  readonly post: Schema.optional<Schema.String>;
   /** Extra non-lifecycle worker bundles (name -\> source path), each emitted as dist/\{name\}.js. */
-  workers: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+  readonly workers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
 }>;
 /**
  * Entry point paths configuration.
@@ -43,21 +41,13 @@ type Entries = typeof EntriesSchema.Type;
  */
 declare const BuildOptionsSchema: Schema.Struct<{
   /** Enable minification to reduce bundle size. Defaults to true. */
-  minify: Schema.optionalWith<typeof Schema.Boolean, {
-    default: () => true;
-  }>;
+  readonly minify: Schema.withDecodingDefaultType<Schema.Boolean, never>;
   /** Generate source maps for debugging. Defaults to false. */
-  sourceMap: Schema.optionalWith<typeof Schema.Boolean, {
-    default: () => false;
-  }>;
+  readonly sourceMap: Schema.withDecodingDefaultType<Schema.Boolean, never>;
   /** Packages to exclude from the bundle (in addition to node: builtins). Defaults to []. */
-  externals: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
-    default: () => never[];
-  }>;
+  readonly externals: Schema.withDecodingDefaultType<Schema.$Array<Schema.String>, never>;
   /** Packages to exclude from the bundle and replace with a stub that throws if loaded at runtime. Use for optional transitive dependencies the action never exercises (e.g. native modules). Defaults to []. */
-  ignore: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
-    default: () => never[];
-  }>;
+  readonly ignore: Schema.withDecodingDefaultType<Schema.$Array<Schema.String>, never>;
   /**
    * Packages whose dynamic `import(...)` calls must stay native `import()` at runtime instead of
    * being compiled into an rspack context module. Use this for packages that resolve a module path
@@ -67,9 +57,7 @@ declare const BuildOptionsSchema: Schema.Struct<{
    * the package here injects a `webpackIgnore` comment into its dynamic imports so rspack leaves
    * them alone. Defaults to [].
    */
-  nativeDynamicImports: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
-    default: () => never[];
-  }>;
+  readonly nativeDynamicImports: Schema.withDecodingDefaultType<Schema.$Array<Schema.String>, never>;
 }>;
 /**
  * Build options for the bundler.
@@ -88,13 +76,11 @@ type BuildOptions = typeof BuildOptionsSchema.Type;
  */
 declare const ValidationOptionsSchema: Schema.Struct<{
   /** Require action.yml to exist and be valid. Defaults to true. */
-  requireActionYml: Schema.optionalWith<typeof Schema.Boolean, {
-    default: () => true;
-  }>;
+  readonly requireActionYml: Schema.withDecodingDefaultType<Schema.Boolean, never>;
   /** Maximum bundle size before warning/error (e.g., "5mb", "500kb"). */
-  maxBundleSize: Schema.optional<typeof Schema.String>;
+  readonly maxBundleSize: Schema.optional<Schema.String>;
   /** Treat warnings as errors. Auto-detects from CI when undefined. */
-  strict: Schema.optional<typeof Schema.Boolean>;
+  readonly strict: Schema.optional<Schema.Boolean>;
 }>;
 /**
  * Validation options for the build process.
@@ -113,17 +99,11 @@ type ValidationOptions = typeof ValidationOptionsSchema.Type;
  */
 declare const PersistLocalOptionsSchema: Schema.Struct<{
   /** Enable persisting build output locally. Defaults to true. */
-  enabled: Schema.optionalWith<typeof Schema.Boolean, {
-    default: () => true;
-  }>;
+  readonly enabled: Schema.withDecodingDefaultType<Schema.Boolean, never>;
   /** Path for the local action directory, relative to cwd. Defaults to ".github/actions/local". */
-  path: Schema.optionalWith<typeof Schema.String, {
-    default: () => string;
-  }>;
+  readonly path: Schema.withDecodingDefaultType<Schema.String, never>;
   /** Generate act boilerplate files (.actrc, act-test.yml) if they don't exist. Defaults to true. */
-  actTemplate: Schema.optionalWith<typeof Schema.Boolean, {
-    default: () => true;
-  }>;
+  readonly actTemplate: Schema.withDecodingDefaultType<Schema.Boolean, never>;
 }>;
 /**
  * Persist-local options for copying build output.
@@ -141,28 +121,28 @@ type PersistLocalOptions = typeof PersistLocalOptionsSchema.Type;
  * @public
  */
 declare const ConfigInputSchema: Schema.Struct<{
-  entries: Schema.optional<Schema.Struct<{
-    main: Schema.optional<typeof Schema.String>;
-    pre: Schema.optional<typeof Schema.String>;
-    post: Schema.optional<typeof Schema.String>;
-    workers: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+  readonly entries: Schema.optional<Schema.Struct<{
+    readonly main: Schema.optional<Schema.String>;
+    readonly pre: Schema.optional<Schema.String>;
+    readonly post: Schema.optional<Schema.String>;
+    readonly workers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
   }>>;
-  build: Schema.optional<Schema.Struct<{
-    minify: Schema.optional<typeof Schema.Boolean>;
-    sourceMap: Schema.optional<typeof Schema.Boolean>;
-    externals: Schema.optional<Schema.Array$<typeof Schema.String>>;
-    ignore: Schema.optional<Schema.Array$<typeof Schema.String>>;
-    nativeDynamicImports: Schema.optional<Schema.Array$<typeof Schema.String>>;
+  readonly build: Schema.optional<Schema.Struct<{
+    readonly minify: Schema.optional<Schema.Boolean>;
+    readonly sourceMap: Schema.optional<Schema.Boolean>;
+    readonly externals: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly ignore: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly nativeDynamicImports: Schema.optional<Schema.$Array<Schema.String>>;
   }>>;
-  validation: Schema.optional<Schema.Struct<{
-    requireActionYml: Schema.optional<typeof Schema.Boolean>;
-    maxBundleSize: Schema.optional<typeof Schema.String>;
-    strict: Schema.optional<typeof Schema.Boolean>;
+  readonly validation: Schema.optional<Schema.Struct<{
+    readonly requireActionYml: Schema.optional<Schema.Boolean>;
+    readonly maxBundleSize: Schema.optional<Schema.String>;
+    readonly strict: Schema.optional<Schema.Boolean>;
   }>>;
-  persistLocal: Schema.optional<Schema.Struct<{
-    enabled: Schema.optional<typeof Schema.Boolean>;
-    path: Schema.optional<typeof Schema.String>;
-    actTemplate: Schema.optional<typeof Schema.Boolean>;
+  readonly persistLocal: Schema.optional<Schema.Struct<{
+    readonly enabled: Schema.optional<Schema.Boolean>;
+    readonly path: Schema.optional<Schema.String>;
+    readonly actTemplate: Schema.optional<Schema.Boolean>;
   }>>;
 }>;
 /**
@@ -181,35 +161,25 @@ type ConfigInput = typeof ConfigInputSchema.Type;
  * @public
  */
 declare const ConfigSchema: Schema.Struct<{
-  entries: Schema.Struct<{
+  readonly entries: Schema.Struct<{
     /** Path to the main action entry point. Defaults to "src/main.ts". */
-    main: Schema.optionalWith<typeof Schema.String, {
-      default: () => string;
-    }>;
+    readonly main: Schema.withDecodingDefaultType<Schema.String, never>;
     /** Path to the pre-action hook entry point. */
-    pre: Schema.optional<typeof Schema.String>;
+    readonly pre: Schema.optional<Schema.String>;
     /** Path to the post-action hook entry point. */
-    post: Schema.optional<typeof Schema.String>;
+    readonly post: Schema.optional<Schema.String>;
     /** Extra non-lifecycle worker bundles (name -\> source path), each emitted as dist/\{name\}.js. */
-    workers: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+    readonly workers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
   }>;
-  build: Schema.Struct<{
+  readonly build: Schema.Struct<{
     /** Enable minification to reduce bundle size. Defaults to true. */
-    minify: Schema.optionalWith<typeof Schema.Boolean, {
-      default: () => true;
-    }>;
+    readonly minify: Schema.withDecodingDefaultType<Schema.Boolean, never>;
     /** Generate source maps for debugging. Defaults to false. */
-    sourceMap: Schema.optionalWith<typeof Schema.Boolean, {
-      default: () => false;
-    }>;
+    readonly sourceMap: Schema.withDecodingDefaultType<Schema.Boolean, never>;
     /** Packages to exclude from the bundle (in addition to node: builtins). Defaults to []. */
-    externals: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
-      default: () => never[];
-    }>;
+    readonly externals: Schema.withDecodingDefaultType<Schema.$Array<Schema.String>, never>;
     /** Packages to exclude from the bundle and replace with a stub that throws if loaded at runtime. Use for optional transitive dependencies the action never exercises (e.g. native modules). Defaults to []. */
-    ignore: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
-      default: () => never[];
-    }>;
+    readonly ignore: Schema.withDecodingDefaultType<Schema.$Array<Schema.String>, never>;
     /**
      * Packages whose dynamic `import(...)` calls must stay native `import()` at runtime instead of
      * being compiled into an rspack context module. Use this for packages that resolve a module path
@@ -219,33 +189,23 @@ declare const ConfigSchema: Schema.Struct<{
      * the package here injects a `webpackIgnore` comment into its dynamic imports so rspack leaves
      * them alone. Defaults to [].
      */
-    nativeDynamicImports: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
-      default: () => never[];
-    }>;
+    readonly nativeDynamicImports: Schema.withDecodingDefaultType<Schema.$Array<Schema.String>, never>;
   }>;
-  validation: Schema.Struct<{
+  readonly validation: Schema.Struct<{
     /** Require action.yml to exist and be valid. Defaults to true. */
-    requireActionYml: Schema.optionalWith<typeof Schema.Boolean, {
-      default: () => true;
-    }>;
+    readonly requireActionYml: Schema.withDecodingDefaultType<Schema.Boolean, never>;
     /** Maximum bundle size before warning/error (e.g., "5mb", "500kb"). */
-    maxBundleSize: Schema.optional<typeof Schema.String>;
+    readonly maxBundleSize: Schema.optional<Schema.String>;
     /** Treat warnings as errors. Auto-detects from CI when undefined. */
-    strict: Schema.optional<typeof Schema.Boolean>;
+    readonly strict: Schema.optional<Schema.Boolean>;
   }>;
-  persistLocal: Schema.Struct<{
+  readonly persistLocal: Schema.Struct<{
     /** Enable persisting build output locally. Defaults to true. */
-    enabled: Schema.optionalWith<typeof Schema.Boolean, {
-      default: () => true;
-    }>;
+    readonly enabled: Schema.withDecodingDefaultType<Schema.Boolean, never>;
     /** Path for the local action directory, relative to cwd. Defaults to ".github/actions/local". */
-    path: Schema.optionalWith<typeof Schema.String, {
-      default: () => string;
-    }>;
+    readonly path: Schema.withDecodingDefaultType<Schema.String, never>;
     /** Generate act boilerplate files (.actrc, act-test.yml) if they don't exist. Defaults to true. */
-    actTemplate: Schema.optionalWith<typeof Schema.Boolean, {
-      default: () => true;
-    }>;
+    readonly actTemplate: Schema.withDecodingDefaultType<Schema.Boolean, never>;
   }>;
 }>;
 /**
@@ -842,9 +802,9 @@ type AppError = ConfigError | ValidationError | BuildError | PersistError;
  */
 declare const LoadConfigOptionsSchema: Schema.Struct<{
   /** Working directory to search for config. Accepts string, Buffer, or URL. */
-  cwd: Schema.optional<Schema.transform<Schema.Union<[typeof Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>>, Schema.instanceOf<URL>]>, typeof Schema.String>>;
+  readonly cwd: Schema.optional<Schema.decodeTo<Schema.String, Schema.Union<readonly [Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>, unknown>, Schema.instanceOf<URL, unknown>]>, never, never>>;
   /** Explicit path to config file. Accepts string, Buffer, or URL. */
-  configPath: Schema.optional<Schema.transform<Schema.Union<[typeof Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>>, Schema.instanceOf<URL>]>, typeof Schema.String>>;
+  readonly configPath: Schema.optional<Schema.decodeTo<Schema.String, Schema.Union<readonly [Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>, unknown>, Schema.instanceOf<URL, unknown>]>, never, never>>;
 }>;
 /**
  * Options for loading configuration.
@@ -857,11 +817,11 @@ type LoadConfigOptions = typeof LoadConfigOptionsSchema.Type;
  */
 declare const DetectedEntrySchema: Schema.Struct<{
   /** Entry type: "main"|"pre"|"post" for lifecycle entries, or the worker name. */
-  type: typeof Schema.String;
+  readonly type: Schema.String;
   /** Absolute path to the entry file. */
-  path: typeof Schema.String;
+  readonly path: Schema.String;
   /** Output path for the bundled file. */
-  output: typeof Schema.String;
+  readonly output: Schema.String;
 }>;
 /**
  * Detected entry point information.
@@ -874,15 +834,15 @@ type DetectedEntry = typeof DetectedEntrySchema.Type;
  */
 declare const DetectEntriesResultSchema: Schema.Struct<{
   /** Whether detection was successful. */
-  success: typeof Schema.Boolean;
+  readonly success: Schema.Boolean;
   /** Detected entries. */
-  entries: Schema.Array$<Schema.Struct<{
+  readonly entries: Schema.$Array<Schema.Struct<{
     /** Entry type: "main"|"pre"|"post" for lifecycle entries, or the worker name. */
-    type: typeof Schema.String;
+    readonly type: Schema.String;
     /** Absolute path to the entry file. */
-    path: typeof Schema.String;
+    readonly path: Schema.String;
     /** Output path for the bundled file. */
-    output: typeof Schema.String;
+    readonly output: Schema.String;
   }>>;
 }>;
 /**
@@ -903,7 +863,7 @@ interface LoadConfigResult {
   usingDefaults: boolean;
 }
 /**
- * ConfigService interface for configuration management capabilities.
+ * Service shape for configuration management capabilities.
  *
  * @remarks
  * This service handles:
@@ -911,23 +871,12 @@ interface LoadConfigResult {
  * - Resolving partial configuration with defaults
  * - Detecting entry points in the project
  *
- * @example Using ConfigService with Effect
- * ```typescript
- * import { Effect } from "effect";
- * import { AppLayer, ConfigService } from "@savvy-web/github-action-builder";
- *
- * const program = Effect.gen(function* () {
- *   const configService = yield* ConfigService;
- *   const result = yield* configService.load({ cwd: process.cwd() });
- *   console.log("Loaded config:", result.config);
- * });
- *
- * Effect.runPromise(program.pipe(Effect.provide(AppLayer)));
- * ```
+ * Use this interface to type structural implementations (e.g. test mocks);
+ * use the {@link ConfigService} class as the service key.
  *
  * @public
  */
-interface ConfigService {
+interface ConfigServiceShape {
   /**
    * Load configuration from file or use defaults.
    *
@@ -956,12 +905,27 @@ interface ConfigService {
     workers?: Record<string, string>;
   }) => Effect.Effect<DetectEntriesResult, MainEntryMissing | WorkerEntryMissing | WorkerEntryInvalidName>;
 }
+declare const ConfigService_base: Context.ServiceClass<ConfigService, "ConfigService", ConfigServiceShape>;
 /**
- * ConfigService tag for dependency injection.
+ * ConfigService key for dependency injection.
+ *
+ * @example Using ConfigService with Effect
+ * ```typescript
+ * import { Effect } from "effect";
+ * import { AppLayer, ConfigService } from "@savvy-web/github-action-builder";
+ *
+ * const program = Effect.gen(function* () {
+ *   const configService = yield* ConfigService;
+ *   const result = yield* configService.load({ cwd: process.cwd() });
+ *   console.log("Loaded config:", result.config);
+ * });
+ *
+ * Effect.runPromise(program.pipe(Effect.provide(AppLayer)));
+ * ```
  *
  * @public
  */
-declare const ConfigService: Context.Tag<ConfigService, ConfigService>;
+declare class ConfigService extends ConfigService_base {}
 //#endregion
 //#region src/services/build.d.ts
 /**
@@ -970,9 +934,9 @@ declare const ConfigService: Context.Tag<ConfigService, ConfigService>;
  */
 declare const BuildRunnerOptionsSchema: Schema.Struct<{
   /** Working directory for the build. Accepts string, Buffer, or URL. */
-  cwd: Schema.optional<Schema.transform<Schema.Union<[typeof Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>>, Schema.instanceOf<URL>]>, typeof Schema.String>>;
+  readonly cwd: Schema.optional<Schema.decodeTo<Schema.String, Schema.Union<readonly [Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>, unknown>, Schema.instanceOf<URL, unknown>]>, never, never>>;
   /** Clean output directory before building. Defaults to true. */
-  clean: Schema.optional<typeof Schema.Boolean>;
+  readonly clean: Schema.optional<Schema.Boolean>;
 }>;
 /**
  * Options for the build process.
@@ -985,13 +949,13 @@ type BuildRunnerOptions = typeof BuildRunnerOptionsSchema.Type;
  */
 declare const BundleStatsSchema: Schema.Struct<{
   /** Entry type (main, pre, or post). */
-  entry: typeof Schema.String;
+  readonly entry: Schema.String;
   /** Bundle size in bytes. */
-  size: typeof Schema.Number;
+  readonly size: Schema.Number;
   /** Build duration in milliseconds. */
-  duration: typeof Schema.Number;
+  readonly duration: Schema.Number;
   /** Output path relative to working directory. */
-  outputPath: typeof Schema.String;
+  readonly outputPath: Schema.String;
 }>;
 /**
  * Statistics for a single bundled entry.
@@ -1004,20 +968,20 @@ type BundleStats = typeof BundleStatsSchema.Type;
  */
 declare const BundleResultSchema: Schema.Struct<{
   /** Whether bundling succeeded. */
-  success: typeof Schema.Boolean;
+  readonly success: Schema.Boolean;
   /** Bundle statistics if successful. */
-  stats: Schema.optional<Schema.Struct<{
+  readonly stats: Schema.optional<Schema.Struct<{
     /** Entry type (main, pre, or post). */
-    entry: typeof Schema.String;
+    readonly entry: Schema.String;
     /** Bundle size in bytes. */
-    size: typeof Schema.Number;
+    readonly size: Schema.Number;
     /** Build duration in milliseconds. */
-    duration: typeof Schema.Number;
+    readonly duration: Schema.Number;
     /** Output path relative to working directory. */
-    outputPath: typeof Schema.String;
+    readonly outputPath: Schema.String;
   }>>;
   /** Error message if failed. */
-  error: Schema.optional<typeof Schema.String>;
+  readonly error: Schema.optional<Schema.String>;
 }>;
 /**
  * Result of bundling a single entry.
@@ -1030,29 +994,29 @@ type BundleResult = typeof BundleResultSchema.Type;
  */
 declare const BuildResultSchema: Schema.Struct<{
   /** Whether the overall build succeeded. */
-  success: typeof Schema.Boolean;
+  readonly success: Schema.Boolean;
   /** Results for each entry that was built. */
-  entries: Schema.Array$<Schema.Struct<{
+  readonly entries: Schema.$Array<Schema.Struct<{
     /** Whether bundling succeeded. */
-    success: typeof Schema.Boolean;
+    readonly success: Schema.Boolean;
     /** Bundle statistics if successful. */
-    stats: Schema.optional<Schema.Struct<{
+    readonly stats: Schema.optional<Schema.Struct<{
       /** Entry type (main, pre, or post). */
-      entry: typeof Schema.String;
+      readonly entry: Schema.String;
       /** Bundle size in bytes. */
-      size: typeof Schema.Number;
+      readonly size: Schema.Number;
       /** Build duration in milliseconds. */
-      duration: typeof Schema.Number;
+      readonly duration: Schema.Number;
       /** Output path relative to working directory. */
-      outputPath: typeof Schema.String;
+      readonly outputPath: Schema.String;
     }>>;
     /** Error message if failed. */
-    error: Schema.optional<typeof Schema.String>;
+    readonly error: Schema.optional<Schema.String>;
   }>>;
   /** Total build duration in milliseconds. */
-  duration: typeof Schema.Number;
+  readonly duration: Schema.Number;
   /** Error message if build failed. */
-  error: Schema.optional<typeof Schema.String>;
+  readonly error: Schema.optional<Schema.String>;
 }>;
 /**
  * Result of the complete build process.
@@ -1060,7 +1024,7 @@ declare const BuildResultSchema: Schema.Struct<{
  */
 type BuildResult = typeof BuildResultSchema.Type;
 /**
- * BuildService interface for build and bundling capabilities.
+ * Service shape for build and bundling capabilities.
  *
  * @remarks
  * This service handles:
@@ -1069,29 +1033,12 @@ type BuildResult = typeof BuildResultSchema.Type;
  * - Collecting build statistics
  * - Formatting build results
  *
- * @example Using BuildService with Effect
- * ```typescript
- * import { Effect } from "effect";
- * import { AppLayer, BuildService, ConfigService } from "@savvy-web/github-action-builder";
- *
- * const program = Effect.gen(function* () {
- *   const configService = yield* ConfigService;
- *   const buildService = yield* BuildService;
- *
- *   const { config } = yield* configService.load();
- *   const result = yield* buildService.build(config);
- *
- *   if (result.success) {
- *     console.log("Build complete:", result.entries.length, "entries");
- *   }
- * });
- *
- * Effect.runPromise(program.pipe(Effect.provide(AppLayer)));
- * ```
+ * Use this interface to type structural implementations (e.g. test mocks);
+ * use the {@link BuildService} class as the service key.
  *
  * @public
  */
-interface BuildService {
+interface BuildServiceShape {
   /**
    * Build all entries from the configuration.
    *
@@ -1130,12 +1077,33 @@ interface BuildService {
    */
   readonly formatBytes: (bytes: number) => string;
 }
+declare const BuildService_base: Context.ServiceClass<BuildService, "BuildService", BuildServiceShape>;
 /**
- * BuildService tag for dependency injection.
+ * BuildService key for dependency injection.
+ *
+ * @example Using BuildService with Effect
+ * ```typescript
+ * import { Effect } from "effect";
+ * import { AppLayer, BuildService, ConfigService } from "@savvy-web/github-action-builder";
+ *
+ * const program = Effect.gen(function* () {
+ *   const configService = yield* ConfigService;
+ *   const buildService = yield* BuildService;
+ *
+ *   const { config } = yield* configService.load();
+ *   const result = yield* buildService.build(config);
+ *
+ *   if (result.success) {
+ *     console.log("Build complete:", result.entries.length, "entries");
+ *   }
+ * });
+ *
+ * Effect.runPromise(program.pipe(Effect.provide(AppLayer)));
+ * ```
  *
  * @public
  */
-declare const BuildService: Context.Tag<BuildService, BuildService>;
+declare class BuildService extends BuildService_base {}
 //#endregion
 //#region src/services/persist-local.d.ts
 /**
@@ -1144,7 +1112,7 @@ declare const BuildService: Context.Tag<BuildService, BuildService>;
  */
 declare const PersistLocalRunnerOptionsSchema: Schema.Struct<{
   /** Working directory. Accepts string. */
-  cwd: Schema.optional<typeof Schema.String>;
+  readonly cwd: Schema.optional<Schema.String>;
 }>;
 /**
  * Options for the persist operation.
@@ -1157,17 +1125,17 @@ type PersistLocalRunnerOptions = typeof PersistLocalRunnerOptionsSchema.Type;
  */
 declare const PersistLocalResultSchema: Schema.Struct<{
   /** Whether the operation completed successfully. */
-  success: typeof Schema.Boolean;
+  readonly success: Schema.Boolean;
   /** Number of files copied (changed or new). */
-  filesCopied: typeof Schema.Number;
+  readonly filesCopied: Schema.Number;
   /** Number of files skipped (unchanged). */
-  filesSkipped: typeof Schema.Number;
+  readonly filesSkipped: Schema.Number;
   /** Whether act template files were generated. */
-  actTemplateGenerated: typeof Schema.Boolean;
+  readonly actTemplateGenerated: Schema.Boolean;
   /** Output path where files were persisted. */
-  outputPath: typeof Schema.String;
+  readonly outputPath: Schema.String;
   /** Error message if failed. */
-  error: Schema.optional<typeof Schema.String>;
+  readonly error: Schema.optional<Schema.String>;
 }>;
 /**
  * Result of the persist-local operation.
@@ -1175,7 +1143,7 @@ declare const PersistLocalResultSchema: Schema.Struct<{
  */
 type PersistLocalResult = typeof PersistLocalResultSchema.Type;
 /**
- * PersistLocalService interface for copying build output locally.
+ * Service shape for copying build output locally.
  *
  * @remarks
  * This service handles:
@@ -1185,9 +1153,12 @@ type PersistLocalResult = typeof PersistLocalResultSchema.Type;
  * - Validating action.yml runs paths resolve in the destination
  * - Generating act boilerplate files
  *
+ * Use this interface to type structural implementations (e.g. test mocks);
+ * use the {@link PersistLocalService} class as the service key.
+ *
  * @public
  */
-interface PersistLocalService {
+interface PersistLocalServiceShape {
   /**
    * Persist build output to the local action directory.
    *
@@ -1204,12 +1175,13 @@ interface PersistLocalService {
    */
   readonly formatResult: (result: PersistLocalResult) => string;
 }
+declare const PersistLocalService_base: Context.ServiceClass<PersistLocalService, "PersistLocalService", PersistLocalServiceShape>;
 /**
- * PersistLocalService tag for dependency injection.
+ * PersistLocalService key for dependency injection.
  *
  * @public
  */
-declare const PersistLocalService: Context.Tag<PersistLocalService, PersistLocalService>;
+declare class PersistLocalService extends PersistLocalService_base {}
 //#endregion
 //#region src/services/validation.d.ts
 /**
@@ -1218,9 +1190,9 @@ declare const PersistLocalService: Context.Tag<PersistLocalService, PersistLocal
  */
 declare const ValidateOptionsSchema: Schema.Struct<{
   /** Working directory for file operations. Accepts string, Buffer, or URL. */
-  cwd: Schema.optional<Schema.transform<Schema.Union<[typeof Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>>, Schema.instanceOf<URL>]>, typeof Schema.String>>;
+  readonly cwd: Schema.optional<Schema.decodeTo<Schema.String, Schema.Union<readonly [Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>, unknown>, Schema.instanceOf<URL, unknown>]>, never, never>>;
   /** Force strict mode regardless of environment. Auto-detects from CI when undefined. */
-  strict: Schema.optional<typeof Schema.Boolean>;
+  readonly strict: Schema.optional<Schema.Boolean>;
 }>;
 /**
  * Options for validation.
@@ -1233,13 +1205,13 @@ type ValidateOptions = typeof ValidateOptionsSchema.Type;
  */
 declare const ValidationErrorSchema: Schema.Struct<{
   /** Error code for categorization. */
-  code: typeof Schema.String;
+  readonly code: Schema.String;
   /** Human-readable error message. */
-  message: typeof Schema.String;
+  readonly message: Schema.String;
   /** File path where error occurred. */
-  file: Schema.optional<typeof Schema.String>;
+  readonly file: Schema.optional<Schema.String>;
   /** Suggestion for fixing the error. */
-  suggestion: Schema.optional<typeof Schema.String>;
+  readonly suggestion: Schema.optional<Schema.String>;
 }>;
 /**
  * A validation error item.
@@ -1252,13 +1224,13 @@ type ValidationErrorItem = typeof ValidationErrorSchema.Type;
  */
 declare const ValidationWarningSchema: Schema.Struct<{
   /** Warning code for categorization. */
-  code: typeof Schema.String;
+  readonly code: Schema.String;
   /** Human-readable warning message. */
-  message: typeof Schema.String;
+  readonly message: Schema.String;
   /** File path where warning occurred. */
-  file: Schema.optional<typeof Schema.String>;
+  readonly file: Schema.optional<Schema.String>;
   /** Suggestion for addressing the warning. */
-  suggestion: Schema.optional<typeof Schema.String>;
+  readonly suggestion: Schema.optional<Schema.String>;
 }>;
 /**
  * A validation warning.
@@ -1271,28 +1243,28 @@ type ValidationWarning = typeof ValidationWarningSchema.Type;
  */
 declare const ValidationResultSchema: Schema.Struct<{
   /** Whether validation passed (no errors, or only warnings in non-strict mode). */
-  valid: typeof Schema.Boolean;
+  readonly valid: Schema.Boolean;
   /** Validation errors. */
-  errors: Schema.Array$<Schema.Struct<{
+  readonly errors: Schema.$Array<Schema.Struct<{
     /** Error code for categorization. */
-    code: typeof Schema.String;
+    readonly code: Schema.String;
     /** Human-readable error message. */
-    message: typeof Schema.String;
+    readonly message: Schema.String;
     /** File path where error occurred. */
-    file: Schema.optional<typeof Schema.String>;
+    readonly file: Schema.optional<Schema.String>;
     /** Suggestion for fixing the error. */
-    suggestion: Schema.optional<typeof Schema.String>;
+    readonly suggestion: Schema.optional<Schema.String>;
   }>>;
   /** Validation warnings. */
-  warnings: Schema.Array$<Schema.Struct<{
+  readonly warnings: Schema.$Array<Schema.Struct<{
     /** Warning code for categorization. */
-    code: typeof Schema.String;
+    readonly code: Schema.String;
     /** Human-readable warning message. */
-    message: typeof Schema.String;
+    readonly message: Schema.String;
     /** File path where warning occurred. */
-    file: Schema.optional<typeof Schema.String>;
+    readonly file: Schema.optional<Schema.String>;
     /** Suggestion for addressing the warning. */
-    suggestion: Schema.optional<typeof Schema.String>;
+    readonly suggestion: Schema.optional<Schema.String>;
   }>>;
 }>;
 /**
@@ -1306,30 +1278,30 @@ type ValidationResult = typeof ValidationResultSchema.Type;
  */
 declare const ActionYmlResultSchema: Schema.Struct<{
   /** Whether the action.yml is valid. */
-  valid: typeof Schema.Boolean;
+  readonly valid: Schema.Boolean;
   /** Parsed action.yml content if valid. */
-  content: Schema.optional<typeof Schema.Any>;
+  readonly content: Schema.optional<Schema.Any>;
   /** Validation errors. */
-  errors: Schema.Array$<Schema.Struct<{
+  readonly errors: Schema.$Array<Schema.Struct<{
     /** Error code for categorization. */
-    code: typeof Schema.String;
+    readonly code: Schema.String;
     /** Human-readable error message. */
-    message: typeof Schema.String;
+    readonly message: Schema.String;
     /** File path where error occurred. */
-    file: Schema.optional<typeof Schema.String>;
+    readonly file: Schema.optional<Schema.String>;
     /** Suggestion for fixing the error. */
-    suggestion: Schema.optional<typeof Schema.String>;
+    readonly suggestion: Schema.optional<Schema.String>;
   }>>;
   /** Validation warnings. */
-  warnings: Schema.Array$<Schema.Struct<{
+  readonly warnings: Schema.$Array<Schema.Struct<{
     /** Warning code for categorization. */
-    code: typeof Schema.String;
+    readonly code: Schema.String;
     /** Human-readable warning message. */
-    message: typeof Schema.String;
+    readonly message: Schema.String;
     /** File path where warning occurred. */
-    file: Schema.optional<typeof Schema.String>;
+    readonly file: Schema.optional<Schema.String>;
     /** Suggestion for addressing the warning. */
-    suggestion: Schema.optional<typeof Schema.String>;
+    readonly suggestion: Schema.optional<Schema.String>;
   }>>;
 }>;
 /**
@@ -1338,7 +1310,7 @@ declare const ActionYmlResultSchema: Schema.Struct<{
  */
 type ActionYmlResult = typeof ActionYmlResultSchema.Type;
 /**
- * ValidationService interface for validation capabilities.
+ * Service shape for validation capabilities.
  *
  * @remarks
  * This service handles:
@@ -1347,29 +1319,12 @@ type ActionYmlResult = typeof ActionYmlResultSchema.Type;
  * - Formatting validation results for display
  * - CI-aware strict mode handling
  *
- * @example Using ValidationService with Effect
- * ```typescript
- * import { Effect } from "effect";
- * import { AppLayer, ConfigService, ValidationService } from "@savvy-web/github-action-builder";
- *
- * const program = Effect.gen(function* () {
- *   const configService = yield* ConfigService;
- *   const validationService = yield* ValidationService;
- *
- *   const { config } = yield* configService.load();
- *   const result = yield* validationService.validate(config);
- *
- *   if (!result.valid) {
- *     console.error("Validation failed:", result.errors);
- *   }
- * });
- *
- * Effect.runPromise(program.pipe(Effect.provide(AppLayer)));
- * ```
+ * Use this interface to type structural implementations (e.g. test mocks);
+ * use the {@link ValidationService} class as the service key.
  *
  * @public
  */
-interface ValidationService {
+interface ValidationServiceShape {
   /**
    * Validate configuration and project structure.
    *
@@ -1406,12 +1361,33 @@ interface ValidationService {
    */
   readonly isStrict: (configStrict?: boolean) => Effect.Effect<boolean>;
 }
+declare const ValidationService_base: Context.ServiceClass<ValidationService, "ValidationService", ValidationServiceShape>;
 /**
- * ValidationService tag for dependency injection.
+ * ValidationService key for dependency injection.
+ *
+ * @example Using ValidationService with Effect
+ * ```typescript
+ * import { Effect } from "effect";
+ * import { AppLayer, ConfigService, ValidationService } from "@savvy-web/github-action-builder";
+ *
+ * const program = Effect.gen(function* () {
+ *   const configService = yield* ConfigService;
+ *   const validationService = yield* ValidationService;
+ *
+ *   const { config } = yield* configService.load();
+ *   const result = yield* validationService.validate(config);
+ *
+ *   if (!result.valid) {
+ *     console.error("Validation failed:", result.errors);
+ *   }
+ * });
+ *
+ * Effect.runPromise(program.pipe(Effect.provide(AppLayer)));
+ * ```
  *
  * @public
  */
-declare const ValidationService: Context.Tag<ValidationService, ValidationService>;
+declare class ValidationService extends ValidationService_base {}
 //#endregion
 //#region src/github-action.d.ts
 /**
@@ -1474,52 +1450,52 @@ interface GitHubActionOptions {
  */
 declare const GitHubActionBuildResultSchema: Schema.Struct<{
   /** Whether the build completed successfully. */
-  success: typeof Schema.Boolean;
+  readonly success: Schema.Boolean;
   /** Build result details if the build step ran. */
-  build: Schema.optional<Schema.Struct<{
-    success: typeof Schema.Boolean;
-    entries: Schema.Array$<Schema.Struct<{
-      success: typeof Schema.Boolean;
-      stats: Schema.optional<Schema.Struct<{
-        entry: typeof Schema.String;
-        size: typeof Schema.Number;
-        duration: typeof Schema.Number;
-        outputPath: typeof Schema.String;
+  readonly build: Schema.optional<Schema.Struct<{
+    readonly success: Schema.Boolean;
+    readonly entries: Schema.$Array<Schema.Struct<{
+      readonly success: Schema.Boolean;
+      readonly stats: Schema.optional<Schema.Struct<{
+        readonly entry: Schema.String;
+        readonly size: Schema.Number;
+        readonly duration: Schema.Number;
+        readonly outputPath: Schema.String;
       }>>;
-      error: Schema.optional<typeof Schema.String>;
+      readonly error: Schema.optional<Schema.String>;
     }>>;
-    duration: typeof Schema.Number;
-    error: Schema.optional<typeof Schema.String>;
+    readonly duration: Schema.Number;
+    readonly error: Schema.optional<Schema.String>;
   }>>;
   /** Validation result if validation was performed. */
-  validation: Schema.optional<Schema.Struct<{
-    valid: typeof Schema.Boolean;
-    errors: Schema.Array$<Schema.Struct<{
-      code: typeof Schema.String;
-      message: typeof Schema.String;
-      file: Schema.optional<typeof Schema.String>;
-      suggestion: Schema.optional<typeof Schema.String>;
+  readonly validation: Schema.optional<Schema.Struct<{
+    readonly valid: Schema.Boolean;
+    readonly errors: Schema.$Array<Schema.Struct<{
+      readonly code: Schema.String;
+      readonly message: Schema.String;
+      readonly file: Schema.optional<Schema.String>;
+      readonly suggestion: Schema.optional<Schema.String>;
     }>>;
-    warnings: Schema.Array$<Schema.Struct<{
-      code: typeof Schema.String;
-      message: typeof Schema.String;
-      file: Schema.optional<typeof Schema.String>;
-      suggestion: Schema.optional<typeof Schema.String>;
+    readonly warnings: Schema.$Array<Schema.Struct<{
+      readonly code: Schema.String;
+      readonly message: Schema.String;
+      readonly file: Schema.optional<Schema.String>;
+      readonly suggestion: Schema.optional<Schema.String>;
     }>>;
   }>>;
   /** Persist-local result if persist was performed. */
-  persistLocal: Schema.optional<Schema.Struct<{
-    success: typeof Schema.Boolean;
-    filesCopied: typeof Schema.Number;
-    filesSkipped: typeof Schema.Number;
-    actTemplateGenerated: typeof Schema.Boolean;
-    outputPath: typeof Schema.String;
-    error: Schema.optional<typeof Schema.String>;
+  readonly persistLocal: Schema.optional<Schema.Struct<{
+    readonly success: Schema.Boolean;
+    readonly filesCopied: Schema.Number;
+    readonly filesSkipped: Schema.Number;
+    readonly actTemplateGenerated: Schema.Boolean;
+    readonly outputPath: Schema.String;
+    readonly error: Schema.optional<Schema.String>;
   }>>;
   /** Error message if the build or validation failed. */
-  error: Schema.optional<typeof Schema.String>;
+  readonly error: Schema.optional<Schema.String>;
   /** Raw error object for programmatic inspection. */
-  cause: Schema.optional<typeof Schema.Unknown>;
+  readonly cause: Schema.optional<Schema.Unknown>;
 }>;
 /**
  * Result of a GitHubAction build operation.
@@ -1534,9 +1510,9 @@ type GitHubActionBuildResult = typeof GitHubActionBuildResultSchema.Type;
  * It handles configuration loading, validation, and bundling in a single workflow.
  *
  * For Effect consumers, use the services directly:
- * - {@link (ConfigService:interface)} for configuration
- * - {@link (ValidationService:interface)} for validation
- * - {@link (BuildService:interface)} for building
+ * - {@link ConfigService} for configuration
+ * - {@link ValidationService} for validation
+ * - {@link BuildService} for building
  *
  * @example Complete build workflow
  * ```typescript
@@ -1758,5 +1734,5 @@ declare const PersistLocalLayer: Layer.Layer<PersistLocalService, never, never>;
  */
 declare const AppLayer: Layer.Layer<BuildService | ConfigService | PersistLocalService | ValidationService, never, never>;
 //#endregion
-export { ActionYmlMissing, ActionYmlMissingBase, ActionYmlPathError, ActionYmlPathErrorBase, type ActionYmlResult, ActionYmlResultSchema, ActionYmlSchemaError, ActionYmlSchemaErrorBase, ActionYmlSyntaxError, ActionYmlSyntaxErrorBase, type AppError, AppLayer, type BuildError, BuildFailed, BuildFailedBase, BuildLayer, type BuildOptions, BuildOptionsSchema, type BuildResult, BuildResultSchema, type BuildRunnerOptions, BuildRunnerOptionsSchema, BuildService, BundleFailed, BundleFailedBase, type BundleResult, BundleResultSchema, type BundleStats, BundleStatsSchema, CleanError, CleanErrorBase, type Config, type ConfigError, type ConfigInput, ConfigInputSchema, ConfigInvalid, ConfigInvalidBase, ConfigLayer, ConfigLoadFailed, ConfigLoadFailedBase, ConfigNotFound, ConfigNotFoundBase, ConfigSchema, ConfigService, type DetectEntriesResult, DetectEntriesResultSchema, type DetectedEntry, DetectedEntrySchema, type Entries, EntriesSchema, EntryFileMissing, EntryFileMissingBase, GitHubAction, type GitHubActionBuildResult, GitHubActionBuildResultSchema, type GitHubActionOptions, type LoadConfigOptions, LoadConfigOptionsSchema, type LoadConfigResult, MainEntryMissing, MainEntryMissingBase, type PersistError, PersistLocalError, PersistLocalErrorBase, PersistLocalLayer, type PersistLocalOptions, PersistLocalOptionsSchema, type PersistLocalResult, PersistLocalResultSchema, type PersistLocalRunnerOptions, PersistLocalRunnerOptionsSchema, PersistLocalService, type ValidateOptions, ValidateOptionsSchema, type ValidationError, type ValidationErrorItem, ValidationErrorSchema, ValidationFailed, ValidationFailedBase, ValidationLayer, type ValidationOptions, ValidationOptionsSchema, type ValidationResult, ValidationResultSchema, ValidationService, type ValidationWarning, ValidationWarningSchema, WorkerEntryInvalidName, WorkerEntryInvalidNameBase, WorkerEntryMissing, WorkerEntryMissingBase, WriteError, WriteErrorBase, defineConfig };
+export { ActionYmlMissing, ActionYmlMissingBase, ActionYmlPathError, ActionYmlPathErrorBase, type ActionYmlResult, ActionYmlResultSchema, ActionYmlSchemaError, ActionYmlSchemaErrorBase, ActionYmlSyntaxError, ActionYmlSyntaxErrorBase, type AppError, AppLayer, type BuildError, BuildFailed, BuildFailedBase, BuildLayer, type BuildOptions, BuildOptionsSchema, type BuildResult, BuildResultSchema, type BuildRunnerOptions, BuildRunnerOptionsSchema, BuildService, type BuildServiceShape, BundleFailed, BundleFailedBase, type BundleResult, BundleResultSchema, type BundleStats, BundleStatsSchema, CleanError, CleanErrorBase, type Config, type ConfigError, type ConfigInput, ConfigInputSchema, ConfigInvalid, ConfigInvalidBase, ConfigLayer, ConfigLoadFailed, ConfigLoadFailedBase, ConfigNotFound, ConfigNotFoundBase, ConfigSchema, ConfigService, type ConfigServiceShape, type DetectEntriesResult, DetectEntriesResultSchema, type DetectedEntry, DetectedEntrySchema, type Entries, EntriesSchema, EntryFileMissing, EntryFileMissingBase, GitHubAction, type GitHubActionBuildResult, GitHubActionBuildResultSchema, type GitHubActionOptions, type LoadConfigOptions, LoadConfigOptionsSchema, type LoadConfigResult, MainEntryMissing, MainEntryMissingBase, type PersistError, PersistLocalError, PersistLocalErrorBase, PersistLocalLayer, type PersistLocalOptions, PersistLocalOptionsSchema, type PersistLocalResult, PersistLocalResultSchema, type PersistLocalRunnerOptions, PersistLocalRunnerOptionsSchema, PersistLocalService, type PersistLocalServiceShape, type ValidateOptions, ValidateOptionsSchema, type ValidationError, type ValidationErrorItem, ValidationErrorSchema, ValidationFailed, ValidationFailedBase, ValidationLayer, type ValidationOptions, ValidationOptionsSchema, type ValidationResult, ValidationResultSchema, ValidationService, type ValidationServiceShape, type ValidationWarning, ValidationWarningSchema, WorkerEntryInvalidName, WorkerEntryInvalidNameBase, WorkerEntryMissing, WorkerEntryMissingBase, WriteError, WriteErrorBase, defineConfig };
 //# sourceMappingURL=index.d.ts.map