refactor: extract path resolution and directory creation helpers (#81)

* feat: add type safety for builder configurations with discriminated unions

Improves type safety by creating discriminated union types for builder-specific
configurations, making it clear which configuration options are required for
each builder type.

Changes:
- Created BaseWorkflowConfig interface with common options
- Created StandaloneConfig, VercelBuildOutputConfig, and NextConfig types
- Made WorkflowConfig a discriminated union based on buildTarget
- Added documentation for each configuration type
- Exported new types from @workflow/builders

This enables better IntelliSense and type checking when constructing builder
configurations, preventing invalid configuration combinations at compile time.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* refactor: extract path resolution and directory creation helpers

Adds reusable helper methods to BaseBuilder for common path operations,
reducing code duplication and improving readability in builder subclasses.

Changes:
- Added resolvePath() helper in BaseBuilder
- Added ensureDirectory() helper in BaseBuilder
- Updated StandaloneBuilder (both in @workflow/builders and @workflow/cli)
  to use the new helpers
- Removed unnecessary imports from StandaloneBuilder

This simplifies path handling code from:
  const path = resolve(this.config.workingDir, this.config.somePath);
  await mkdir(dirname(path), { recursive: true });

To:
  const path = this.resolvePath(this.config.somePath);
  await this.ensureDirectory(path);

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
Signed-off-by: Nathan Rajlich <[email protected]>

---------

Signed-off-by: Nathan Rajlich <[email protected]>
Co-authored-by: Claude <[email protected]>

Author: pranaygp

.changeset/extract-path-helpers.md

@@ -0,0 +1,6 @@
+---
+"@workflow/builders": patch
+"@workflow/cli": patch
+---
+
+Extract path resolution and directory creation helpers

packages/builders/src/base-builder.ts

@@ -715,6 +715,20 @@ export const OPTIONS = handler;`;
     );
   }
 
+  /**
+   * Resolves a path relative to the working directory.
+   */
+  protected resolvePath(path: string): string {
+    return resolve(this.config.workingDir, path);
+  }
+
+  /**
+   * Ensures the directory for a file path exists, creating it if necessary.
+   */
+  protected async ensureDirectory(filePath: string): Promise<void> {
+    await mkdir(dirname(filePath), { recursive: true });
+  }
+
   private async createSwcGitignore(): Promise<void> {
     try {
       await writeFile(

packages/builders/src/index.ts

@@ -1,18 +1,18 @@
+export type { WorkflowManifest } from './apply-swc-transform.js';
+export { applySwcTransform } from './apply-swc-transform.js';
 export { BaseBuilder } from './base-builder.js';
+export { STEP_QUEUE_TRIGGER, WORKFLOW_QUEUE_TRIGGER } from './constants.js';
+export { createDiscoverEntriesPlugin } from './discover-entries-esbuild-plugin.js';
+export { createNodeModuleErrorPlugin } from './node-module-esbuild-plugin.js';
 export { StandaloneBuilder } from './standalone.js';
-export { VercelBuildOutputAPIBuilder } from './vercel-build-output-api.js';
+export { createSwcPlugin } from './swc-esbuild-plugin.js';
 export type {
-  WorkflowConfig,
   BuildTarget,
-  StandaloneConfig,
-  VercelBuildOutputConfig,
   NextConfig,
+  StandaloneConfig,
   SvelteKitConfig,
+  VercelBuildOutputConfig,
+  WorkflowConfig,
 } from './types.js';
-export { validBuildTargets, isValidBuildTarget } from './types.js';
-export type { WorkflowManifest } from './apply-swc-transform.js';
-export { applySwcTransform } from './apply-swc-transform.js';
-export { createDiscoverEntriesPlugin } from './discover-entries-esbuild-plugin.js';
-export { createNodeModuleErrorPlugin } from './node-module-esbuild-plugin.js';
-export { createSwcPlugin } from './swc-esbuild-plugin.js';
-export { STEP_QUEUE_TRIGGER, WORKFLOW_QUEUE_TRIGGER } from './constants.js';
+export { isValidBuildTarget, validBuildTargets } from './types.js';
+export { VercelBuildOutputAPIBuilder } from './vercel-build-output-api.js';

packages/builders/src/standalone.ts

@@ -1,5 +1,3 @@
-import { mkdir } from 'node:fs/promises';
-import { dirname, resolve } from 'node:path';
 import { BaseBuilder } from './base-builder.js';
 
 export class StandaloneBuilder extends BaseBuilder {
@@ -30,13 +28,8 @@ export class StandaloneBuilder extends BaseBuilder {
   }): Promise<void> {
     console.log('Creating steps bundle at', this.config.stepsBundlePath);
 
-    const stepsBundlePath = resolve(
-      this.config.workingDir,
-      this.config.stepsBundlePath
-    );
-
-    // Ensure directory exists
-    await mkdir(dirname(stepsBundlePath), { recursive: true });
+    const stepsBundlePath = this.resolvePath(this.config.stepsBundlePath);
+    await this.ensureDirectory(stepsBundlePath);
 
     await this.createStepsBundle({
       outfile: stepsBundlePath,
@@ -60,13 +53,10 @@ export class StandaloneBuilder extends BaseBuilder {
       this.config.workflowsBundlePath
     );
 
-    const workflowBundlePath = resolve(
-      this.config.workingDir,
+    const workflowBundlePath = this.resolvePath(
       this.config.workflowsBundlePath
     );
-
-    // Ensure directory exists
-    await mkdir(dirname(workflowBundlePath), { recursive: true });
+    await this.ensureDirectory(workflowBundlePath);
 
     await this.createWorkflowsBundle({
       outfile: workflowBundlePath,
@@ -79,13 +69,8 @@ export class StandaloneBuilder extends BaseBuilder {
   private async buildWebhookFunction(): Promise<void> {
     console.log('Creating webhook bundle at', this.config.webhookBundlePath);
 
-    const webhookBundlePath = resolve(
-      this.config.workingDir,
-      this.config.webhookBundlePath
-    );
-
-    // Ensure directory exists
-    await mkdir(dirname(webhookBundlePath), { recursive: true });
+    const webhookBundlePath = this.resolvePath(this.config.webhookBundlePath);
+    await this.ensureDirectory(webhookBundlePath);
 
     await this.createWebhookBundle({
       outfile: webhookBundlePath,

packages/cli/src/lib/builders/standalone.ts

@@ -1,5 +1,3 @@
-import { mkdir } from 'node:fs/promises';
-import { dirname, resolve } from 'node:path';
 import { BaseBuilder } from '@workflow/builders';
 
 export class StandaloneBuilder extends BaseBuilder {
@@ -30,13 +28,8 @@ export class StandaloneBuilder extends BaseBuilder {
   }): Promise<void> {
     console.log('Creating steps bundle at', this.config.stepsBundlePath);
 
-    const stepsBundlePath = resolve(
-      this.config.workingDir,
-      this.config.stepsBundlePath
-    );
-
-    // Ensure directory exists
-    await mkdir(dirname(stepsBundlePath), { recursive: true });
+    const stepsBundlePath = this.resolvePath(this.config.stepsBundlePath);
+    await this.ensureDirectory(stepsBundlePath);
 
     await this.createStepsBundle({
       outfile: stepsBundlePath,
@@ -60,13 +53,10 @@ export class StandaloneBuilder extends BaseBuilder {
       this.config.workflowsBundlePath
     );
 
-    const workflowBundlePath = resolve(
-      this.config.workingDir,
+    const workflowBundlePath = this.resolvePath(
       this.config.workflowsBundlePath
     );
-
-    // Ensure directory exists
-    await mkdir(dirname(workflowBundlePath), { recursive: true });
+    await this.ensureDirectory(workflowBundlePath);
 
     await this.createWorkflowsBundle({
       outfile: workflowBundlePath,
@@ -79,13 +69,8 @@ export class StandaloneBuilder extends BaseBuilder {
   private async buildWebhookFunction(): Promise<void> {
     console.log('Creating webhook bundle at', this.config.webhookBundlePath);
 
-    const webhookBundlePath = resolve(
-      this.config.workingDir,
-      this.config.webhookBundlePath
-    );
-
-    // Ensure directory exists
-    await mkdir(dirname(webhookBundlePath), { recursive: true });
+    const webhookBundlePath = this.resolvePath(this.config.webhookBundlePath);
+    await this.ensureDirectory(webhookBundlePath);
 
     await this.createWebhookBundle({
       outfile: webhookBundlePath,