@savvy-web/github-action-builder 0.7.12 → 0.8.0

package/bin/github-action-builder.js

@@ -26,7 +26,7 @@ const rootCommand = Command.make("github-action-builder").pipe(Command.withSubco
 */
 const cli = Command.run(rootCommand, {
 	name: "github-action-builder",
-	version: "0.7.12"
+	version: "0.8.0"
 });
 /**
 * Combined layer: AppLayer + NodeContext for CLI.

package/cli/commands/init.js

@@ -20,7 +20,7 @@ const forceOption = Options.boolean("force").pipe(Options.withAlias("f"), Option
 * Get current package version (replaced at build time).
 */
 const getPackageVersion = () => {
-	return "0.7.12";
+	return "0.8.0";
 };
 /**
 * Generate package.json content.

package/errors.js

@@ -93,6 +93,45 @@ const MainEntryMissingBase = Data.TaggedError("MainEntryMissing");
 */
 var MainEntryMissing = class extends MainEntryMissingBase {};
 /**
+* Base class for WorkerEntryMissing error.
+*
+* @privateRemarks
+* This export is required for api-extractor documentation generation.
+* Effect's Data.TaggedError creates an anonymous base class that must be
+* explicitly exported to avoid "forgotten export" warnings. Do not delete.
+*
+* @public
+*/
+const WorkerEntryMissingBase = Data.TaggedError("WorkerEntryMissing");
+/**
+* Error when a worker entry source file is not found.
+*
+* @public
+*/
+var WorkerEntryMissing = class extends WorkerEntryMissingBase {};
+/**
+* Base class for WorkerEntryInvalidName error.
+*
+* @privateRemarks
+* This export is required for api-extractor documentation generation.
+* Effect's Data.TaggedError creates an anonymous base class that must be
+* explicitly exported to avoid "forgotten export" warnings. Do not delete.
+*
+* @public
+*/
+const WorkerEntryInvalidNameBase = Data.TaggedError("WorkerEntryInvalidName");
+/**
+* Error when a worker entry name is reserved or path-unsafe.
+*
+* @remarks
+* A worker name becomes both an rsbuild entry key and the emitted filename
+* (`dist/<name>.js`), so it must not collide with a lifecycle bundle
+* (`main`/`pre`/`post`) or contain path separators that would escape `dist/`.
+*
+* @public
+*/
+var WorkerEntryInvalidName = class extends WorkerEntryInvalidNameBase {};
+/**
 * Base class for EntryFileMissing error.
 *
 * @privateRemarks
@@ -281,4 +320,4 @@ const ActionYmlPathErrorBase = Data.TaggedError("ActionYmlPathError");
 var ActionYmlPathError = class extends ActionYmlPathErrorBase {};
 
 //#endregion
-export { ActionYmlMissing, ActionYmlMissingBase, ActionYmlPathError, ActionYmlPathErrorBase, ActionYmlSchemaError, ActionYmlSchemaErrorBase, ActionYmlSyntaxError, ActionYmlSyntaxErrorBase, BuildFailed, BuildFailedBase, BundleFailed, BundleFailedBase, CleanError, CleanErrorBase, ConfigInvalid, ConfigInvalidBase, ConfigLoadFailed, ConfigLoadFailedBase, ConfigNotFound, ConfigNotFoundBase, EntryFileMissing, EntryFileMissingBase, MainEntryMissing, MainEntryMissingBase, PersistLocalError, PersistLocalErrorBase, ValidationFailed, ValidationFailedBase, WriteError, WriteErrorBase };
+export { ActionYmlMissing, ActionYmlMissingBase, ActionYmlPathError, ActionYmlPathErrorBase, ActionYmlSchemaError, ActionYmlSchemaErrorBase, ActionYmlSyntaxError, ActionYmlSyntaxErrorBase, BuildFailed, BuildFailedBase, BundleFailed, BundleFailedBase, CleanError, CleanErrorBase, ConfigInvalid, ConfigInvalidBase, ConfigLoadFailed, ConfigLoadFailedBase, ConfigNotFound, ConfigNotFoundBase, EntryFileMissing, EntryFileMissingBase, MainEntryMissing, MainEntryMissingBase, PersistLocalError, PersistLocalErrorBase, ValidationFailed, ValidationFailedBase, WorkerEntryInvalidName, WorkerEntryInvalidNameBase, WorkerEntryMissing, WorkerEntryMissingBase, WriteError, WriteErrorBase };

package/index.d.ts

@@ -5,11 +5,14 @@ import { Context, Effect, Layer, Schema } from "effect";
  * Schema for entry point paths.
  *
  * @remarks
- * GitHub Actions support three entry points:
+ * GitHub Actions support three lifecycle entry points:
  * - `main`: The primary action entry point (required)
  * - `pre`: Runs before the main action (optional)
  * - `post`: Runs after the main action for cleanup (optional)
  *
+ * Additional non-lifecycle bundles can be declared via `workers` (name → source path),
+ * each emitted as `dist/<name>.js`.
+ *
  * @public
  */
 declare const EntriesSchema: Schema.Struct<{
@@ -17,7 +20,8 @@ declare const EntriesSchema: Schema.Struct<{
     default: () => string;
   }>; /** Path to the pre-action hook entry point. */
   pre: Schema.optional<typeof Schema.String>; /** Path to the post-action hook entry point. */
-  post: Schema.optional<typeof Schema.String>;
+  post: Schema.optional<typeof 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>>;
 }>;
 /**
  * Entry point paths configuration.
@@ -116,6 +120,7 @@ declare const ConfigInputSchema: 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>>;
   }>>;
   build: Schema.optional<Schema.Struct<{
     minify: Schema.optional<typeof Schema.Boolean>;
@@ -155,7 +160,8 @@ declare const ConfigSchema: Schema.Struct<{
       default: () => string;
     }>; /** Path to the pre-action hook entry point. */
     pre: Schema.optional<typeof Schema.String>; /** Path to the post-action hook entry point. */
-    post: Schema.optional<typeof Schema.String>;
+    post: Schema.optional<typeof 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>>;
   }>;
   build: Schema.Struct<{
     /** Enable minification to reduce bundle size. Defaults to true. */minify: Schema.optionalWith<typeof Schema.Boolean, {
@@ -373,6 +379,56 @@ declare class MainEntryMissing extends MainEntryMissingBase<{
    */
   readonly cwd: string;
 }> {}
+/**
+ * Base class for WorkerEntryMissing error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @public
+ */
+declare const WorkerEntryMissingBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "WorkerEntryMissing";
+} & Readonly<A>;
+/**
+ * Error when a worker entry source file is not found.
+ *
+ * @public
+ */
+declare class WorkerEntryMissing extends WorkerEntryMissingBase<{
+  /** The worker name (config key). */readonly workerName: string; /** The expected path for the worker entry. */
+  readonly expectedPath: string; /** The working directory that was searched. */
+  readonly cwd: string;
+}> {}
+/**
+ * Base class for WorkerEntryInvalidName error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @public
+ */
+declare const WorkerEntryInvalidNameBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "WorkerEntryInvalidName";
+} & Readonly<A>;
+/**
+ * Error when a worker entry name is reserved or path-unsafe.
+ *
+ * @remarks
+ * A worker name becomes both an rsbuild entry key and the emitted filename
+ * (`dist/<name>.js`), so it must not collide with a lifecycle bundle
+ * (`main`/`pre`/`post`) or contain path separators that would escape `dist/`.
+ *
+ * @public
+ */
+declare class WorkerEntryInvalidName extends WorkerEntryInvalidNameBase<{
+  /** The offending worker name (config key). */readonly workerName: string; /** Why the name was rejected. */
+  readonly reason: string;
+}> {}
 /**
  * Base class for EntryFileMissing error.
  *
@@ -529,7 +585,7 @@ declare class ValidationFailed extends ValidationFailedBase<{
  *
  * @public
  */
-type ValidationError = MainEntryMissing | EntryFileMissing | ActionYmlMissing | ActionYmlSyntaxError | ActionYmlSchemaError | ValidationFailed;
+type ValidationError = MainEntryMissing | WorkerEntryMissing | WorkerEntryInvalidName | EntryFileMissing | ActionYmlMissing | ActionYmlSyntaxError | ActionYmlSchemaError | ValidationFailed;
 /**
  * Base class for BundleFailed error.
  *
@@ -740,7 +796,7 @@ type LoadConfigOptions = typeof LoadConfigOptionsSchema.Type;
  * @public
  */
 declare const DetectedEntrySchema: Schema.Struct<{
-  /** Entry type (main, pre, or post). */type: Schema.Literal<["main", "pre", "post"]>; /** Absolute path to the entry file. */
+  /** Entry type: "main"|"pre"|"post" for lifecycle entries, or the worker name. */type: typeof Schema.String; /** Absolute path to the entry file. */
   path: typeof Schema.String; /** Output path for the bundled file. */
   output: typeof Schema.String;
 }>;
@@ -756,7 +812,7 @@ type DetectedEntry = typeof DetectedEntrySchema.Type;
 declare const DetectEntriesResultSchema: Schema.Struct<{
   /** Whether detection was successful. */success: typeof Schema.Boolean; /** Detected entries. */
   entries: Schema.Array$<Schema.Struct<{
-    /** Entry type (main, pre, or post). */type: Schema.Literal<["main", "pre", "post"]>; /** Absolute path to the entry file. */
+    /** Entry type: "main"|"pre"|"post" for lifecycle entries, or the worker name. */type: typeof Schema.String; /** Absolute path to the entry file. */
     path: typeof Schema.String; /** Output path for the bundled file. */
     output: typeof Schema.String;
   }>>;
@@ -829,7 +885,8 @@ interface ConfigService {
     main?: string;
     pre?: string;
     post?: string;
-  }) => Effect.Effect<DetectEntriesResult, MainEntryMissing>;
+    workers?: Record<string, string>;
+  }) => Effect.Effect<DetectEntriesResult, MainEntryMissing | WorkerEntryMissing | WorkerEntryInvalidName>;
 }
 /**
  * ConfigService tag for dependency injection.
@@ -950,7 +1007,7 @@ interface BuildService {
    * @param options - Build options
    * @returns Effect that resolves to build result
    */
-  readonly build: (config: Config, options?: BuildRunnerOptions) => Effect.Effect<BuildResult, BuildError | MainEntryMissing>;
+  readonly build: (config: Config, options?: BuildRunnerOptions) => Effect.Effect<BuildResult, BuildError | MainEntryMissing | WorkerEntryMissing | WorkerEntryInvalidName>;
   /**
    * Bundle a single entry point.
    *
@@ -1563,5 +1620,5 @@ declare const PersistLocalLayer: Layer.Layer<PersistLocalService, never, never>;
  */
 declare const AppLayer: Layer.Layer<ConfigService | ValidationService | BuildService | PersistLocalService, 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, 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, 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 };
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -1,4 +1,4 @@
-import { ActionYmlMissing, ActionYmlMissingBase, ActionYmlPathError, ActionYmlPathErrorBase, ActionYmlSchemaError, ActionYmlSchemaErrorBase, ActionYmlSyntaxError, ActionYmlSyntaxErrorBase, BuildFailed, BuildFailedBase, BundleFailed, BundleFailedBase, CleanError, CleanErrorBase, ConfigInvalid, ConfigInvalidBase, ConfigLoadFailed, ConfigLoadFailedBase, ConfigNotFound, ConfigNotFoundBase, EntryFileMissing, EntryFileMissingBase, MainEntryMissing, MainEntryMissingBase, PersistLocalError, PersistLocalErrorBase, ValidationFailed, ValidationFailedBase, WriteError, WriteErrorBase } from "./errors.js";
+import { ActionYmlMissing, ActionYmlMissingBase, ActionYmlPathError, ActionYmlPathErrorBase, ActionYmlSchemaError, ActionYmlSchemaErrorBase, ActionYmlSyntaxError, ActionYmlSyntaxErrorBase, BuildFailed, BuildFailedBase, BundleFailed, BundleFailedBase, CleanError, CleanErrorBase, ConfigInvalid, ConfigInvalidBase, ConfigLoadFailed, ConfigLoadFailedBase, ConfigNotFound, ConfigNotFoundBase, EntryFileMissing, EntryFileMissingBase, MainEntryMissing, MainEntryMissingBase, PersistLocalError, PersistLocalErrorBase, ValidationFailed, ValidationFailedBase, WorkerEntryInvalidName, WorkerEntryInvalidNameBase, WorkerEntryMissing, WorkerEntryMissingBase, WriteError, WriteErrorBase } from "./errors.js";
 import { BuildResultSchema, BuildRunnerOptionsSchema, BuildService, BundleResultSchema, BundleStatsSchema } from "./services/build.js";
 import { BuildOptionsSchema, ConfigInputSchema, ConfigSchema, EntriesSchema, PersistLocalOptionsSchema, ValidationOptionsSchema, defineConfig } from "./schemas/config.js";
 import { ConfigService, DetectEntriesResultSchema, DetectedEntrySchema, LoadConfigOptionsSchema } from "./services/config.js";
@@ -7,4 +7,4 @@ import { ActionYmlResultSchema, ValidateOptionsSchema, ValidationErrorSchema, Va
 import { AppLayer, BuildLayer, ConfigLayer, PersistLocalLayer, ValidationLayer } from "./layers/app.js";
 import { GitHubAction, GitHubActionBuildResultSchema } from "./github-action.js";
 
-export { ActionYmlMissing, ActionYmlMissingBase, ActionYmlPathError, ActionYmlPathErrorBase, ActionYmlResultSchema, ActionYmlSchemaError, ActionYmlSchemaErrorBase, ActionYmlSyntaxError, ActionYmlSyntaxErrorBase, AppLayer, BuildFailed, BuildFailedBase, BuildLayer, BuildOptionsSchema, BuildResultSchema, BuildRunnerOptionsSchema, BuildService, BundleFailed, BundleFailedBase, BundleResultSchema, BundleStatsSchema, CleanError, CleanErrorBase, ConfigInputSchema, ConfigInvalid, ConfigInvalidBase, ConfigLayer, ConfigLoadFailed, ConfigLoadFailedBase, ConfigNotFound, ConfigNotFoundBase, ConfigSchema, ConfigService, DetectEntriesResultSchema, DetectedEntrySchema, EntriesSchema, EntryFileMissing, EntryFileMissingBase, GitHubAction, GitHubActionBuildResultSchema, LoadConfigOptionsSchema, MainEntryMissing, MainEntryMissingBase, PersistLocalError, PersistLocalErrorBase, PersistLocalLayer, PersistLocalOptionsSchema, PersistLocalResultSchema, PersistLocalRunnerOptionsSchema, PersistLocalService, ValidateOptionsSchema, ValidationErrorSchema, ValidationFailed, ValidationFailedBase, ValidationLayer, ValidationOptionsSchema, ValidationResultSchema, ValidationService, ValidationWarningSchema, WriteError, WriteErrorBase, defineConfig };
+export { ActionYmlMissing, ActionYmlMissingBase, ActionYmlPathError, ActionYmlPathErrorBase, ActionYmlResultSchema, ActionYmlSchemaError, ActionYmlSchemaErrorBase, ActionYmlSyntaxError, ActionYmlSyntaxErrorBase, AppLayer, BuildFailed, BuildFailedBase, BuildLayer, BuildOptionsSchema, BuildResultSchema, BuildRunnerOptionsSchema, BuildService, BundleFailed, BundleFailedBase, BundleResultSchema, BundleStatsSchema, CleanError, CleanErrorBase, ConfigInputSchema, ConfigInvalid, ConfigInvalidBase, ConfigLayer, ConfigLoadFailed, ConfigLoadFailedBase, ConfigNotFound, ConfigNotFoundBase, ConfigSchema, ConfigService, DetectEntriesResultSchema, DetectedEntrySchema, EntriesSchema, EntryFileMissing, EntryFileMissingBase, GitHubAction, GitHubActionBuildResultSchema, LoadConfigOptionsSchema, MainEntryMissing, MainEntryMissingBase, PersistLocalError, PersistLocalErrorBase, PersistLocalLayer, PersistLocalOptionsSchema, PersistLocalResultSchema, PersistLocalRunnerOptionsSchema, PersistLocalService, ValidateOptionsSchema, ValidationErrorSchema, ValidationFailed, ValidationFailedBase, ValidationLayer, ValidationOptionsSchema, ValidationResultSchema, ValidationService, ValidationWarningSchema, WorkerEntryInvalidName, WorkerEntryInvalidNameBase, WorkerEntryMissing, WorkerEntryMissingBase, WriteError, WriteErrorBase, defineConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/github-action-builder",
-	"version": "0.7.12",
+	"version": "0.8.0",
 	"private": false,
 	"description": "A zero-config build tool for creating GitHub Actions from TypeScript. Bundles with rsbuild, validates action.yml against GitHub's schema, and outputs production-ready Node.js 24 actions.",
 	"keywords": [

package/schemas/config.js

@@ -14,11 +14,14 @@ import { Schema } from "effect";
 * Schema for entry point paths.
 *
 * @remarks
-* GitHub Actions support three entry points:
+* GitHub Actions support three lifecycle entry points:
 * - `main`: The primary action entry point (required)
 * - `pre`: Runs before the main action (optional)
 * - `post`: Runs after the main action for cleanup (optional)
 *
+* Additional non-lifecycle bundles can be declared via `workers` (name → source path),
+* each emitted as `dist/<name>.js`.
+*
 * @public
 */
 const EntriesSchema = Schema.Struct({
@@ -27,7 +30,12 @@ const EntriesSchema = Schema.Struct({
 	/** Path to the pre-action hook entry point. */
 	pre: Schema.optional(Schema.String),
 	/** Path to the post-action hook entry point. */
-	post: Schema.optional(Schema.String)
+	post: Schema.optional(Schema.String),
+	/** Extra non-lifecycle worker bundles (name -> source path), each emitted as dist/<name>.js. */
+	workers: Schema.optional(Schema.Record({
+		key: Schema.String,
+		value: Schema.String
+	}))
 });
 /**
 * Schema for build options.
@@ -95,7 +103,11 @@ const ConfigInputSchema = Schema.Struct({
 	entries: Schema.optional(Schema.Struct({
 		main: Schema.optional(Schema.String),
 		pre: Schema.optional(Schema.String),
-		post: Schema.optional(Schema.String)
+		post: Schema.optional(Schema.String),
+		workers: Schema.optional(Schema.Record({
+			key: Schema.String,
+			value: Schema.String
+		}))
 	})),
 	build: Schema.optional(Schema.Struct({
 		minify: Schema.optional(Schema.Boolean),

package/services/build-live.js

@@ -183,6 +183,7 @@ const BuildServiceLive = Layer.effect(BuildService, Effect.gen(function* () {
 			const entriesConfig = { main: config.entries.main };
 			if (config.entries.pre) entriesConfig.pre = config.entries.pre;
 			if (config.entries.post) entriesConfig.post = config.entries.post;
+			if (config.entries.workers) entriesConfig.workers = config.entries.workers;
 			const entriesResult = yield* configService.detectEntries(cwd, entriesConfig);
 			if (shouldClean) yield* cleanDirectory(resolve(cwd, "dist"));
 			const entryResults = [];

package/services/config-live.js

@@ -1,4 +1,4 @@
-import { ConfigInvalid, ConfigLoadFailed, ConfigNotFound, MainEntryMissing } from "../errors.js";
+import { ConfigInvalid, ConfigLoadFailed, ConfigNotFound, MainEntryMissing, WorkerEntryInvalidName, WorkerEntryMissing } from "../errors.js";
 import { defineConfig } from "../schemas/config.js";
 import { ConfigService } from "./config.js";
 import { Effect, Layer } from "effect";
@@ -21,6 +21,12 @@ const DEFAULT_ENTRIES = {
 	pre: "src/pre.ts",
 	post: "src/post.ts"
 };
+/** Lifecycle bundle names a worker entry must not reuse — they own `dist/main.js` etc. */
+const RESERVED_ENTRY_NAMES = /* @__PURE__ */ new Set([
+	"main",
+	"pre",
+	"post"
+]);
 /**
 * Find config file in the given directory.
 */
@@ -100,6 +106,27 @@ const ConfigServiceLive = Layer.succeed(ConfigService, {
 		if (preEntry) detected.push(preEntry);
 		const postEntry = detectOptionalEntry(cwd, "post", entries?.post);
 		if (postEntry) detected.push(postEntry);
+		for (const [name, workerPath] of Object.entries(entries?.workers ?? {})) {
+			if (RESERVED_ENTRY_NAMES.has(name)) return yield* Effect.fail(new WorkerEntryInvalidName({
+				workerName: name,
+				reason: `"${name}" is a reserved lifecycle bundle name (main/pre/post)`
+			}));
+			if (name.length === 0 || name.includes("/") || name.includes("\\") || name.includes("..")) return yield* Effect.fail(new WorkerEntryInvalidName({
+				workerName: name,
+				reason: "worker names must be non-empty and free of path separators"
+			}));
+			const absoluteWorkerPath = resolve(cwd, workerPath);
+			if (!existsSync(absoluteWorkerPath)) return yield* Effect.fail(new WorkerEntryMissing({
+				workerName: name,
+				expectedPath: workerPath,
+				cwd
+			}));
+			detected.push({
+				type: name,
+				path: absoluteWorkerPath,
+				output: `dist/${name}.js`
+			});
+		}
 		return {
 			success: true,
 			entries: detected

package/services/config.js

@@ -23,8 +23,8 @@ const EntryTypeSchema = Schema.Literal("main", "pre", "post");
 * @public
 */
 const DetectedEntrySchema = Schema.Struct({
-	/** Entry type (main, pre, or post). */
-	type: EntryTypeSchema,
+	/** Entry type: "main"|"pre"|"post" for lifecycle entries, or the worker name. */
+	type: Schema.String,
 	/** Absolute path to the entry file. */
 	path: Schema.String,
 	/** Output path for the bundled file. */

package/services/persist-local-live.js

@@ -101,7 +101,7 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
       - uses: ./.github/actions/local
 `;
 function formatPersistResult(result) {