@workflow/builders 5.0.0-beta.4 → 5.0.0-beta.5

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,cAAuB;IAC7B,KAAK,EAAE,cAAc;IACrB,QAAQ,EAAE,SAAS;IACnB,iBAAiB,EAAE,CAAC,EAAE,sCAAsC;IAC5D,mBAAmB,EAAE,CAAC,EAAE,mDAAmD;CAC5E,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,cAAuB;IAC7B,KAAK,EAAE,kBAAkB;IACzB,QAAQ,EAAE,SAAS;IACnB,iBAAiB,EAAE,CAAC,EAAE,sCAAsC;IAC5D,mBAAmB,EAAE,CAAC,EAAE,mDAAmD;CAC5E,CAAC","sourcesContent":["/**\n * Queue trigger configuration for workflow step execution.\n * Steps are queued to the __wkf_step_* topic.\n */\nexport const STEP_QUEUE_TRIGGER = {\n  type: 'queue/v2beta' as const,\n  topic: '__wkf_step_*',\n  consumer: 'default',\n  retryAfterSeconds: 5, // Delay between retries (default: 60)\n  initialDelaySeconds: 0, // Initial delay before first delivery (default: 0)\n};\n\n/**\n * Queue trigger configuration for workflow orchestration.\n * Workflows are queued to the __wkf_workflow_* topic.\n */\nexport const WORKFLOW_QUEUE_TRIGGER = {\n  type: 'queue/v2beta' as const,\n  topic: '__wkf_workflow_*',\n  consumer: 'default',\n  retryAfterSeconds: 5, // Delay between retries (default: 60)\n  initialDelaySeconds: 0, // Initial delay before first delivery (default: 0)\n};\n"]}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,cAAuB;IAC7B,KAAK,EAAE,kBAAkB;IACzB,QAAQ,EAAE,SAAS;IACnB,iBAAiB,EAAE,CAAC,EAAE,sCAAsC;IAC5D,mBAAmB,EAAE,CAAC,EAAE,mDAAmD;CAC5E,CAAC","sourcesContent":["/**\n * Queue trigger configuration for the workflow handler.\n * Handles both workflow orchestration and step execution on the same route.\n * Background steps are queued back to __wkf_workflow_* with a stepId.\n */\nexport const WORKFLOW_QUEUE_TRIGGER = {\n  type: 'queue/v2beta' as const,\n  topic: '__wkf_workflow_*',\n  consumer: 'default',\n  retryAfterSeconds: 5, // Delay between retries (default: 60)\n  initialDelaySeconds: 0, // Initial delay before first delivery (default: 0)\n};\n"]}

package/dist/discover-entries-esbuild-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discover-entries-esbuild-plugin.d.ts","sourceRoot":"","sources":["../src/discover-entries-esbuild-plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAUtC,eAAO,MAAM,SAAS,QAAuC,CAAC;AAwB9D,eAAO,MAAM,aAAa,0BAAiC,CAAC;AAK5D,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CA0B3E;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE;IACL,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACnC,EACD,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAiIR"}
+{"version":3,"file":"discover-entries-esbuild-plugin.d.ts","sourceRoot":"","sources":["../src/discover-entries-esbuild-plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AA2BtC,eAAO,MAAM,SAAS,QAAuC,CAAC;AAwB9D,eAAO,MAAM,aAAa,0BAAiC,CAAC;AAK5D,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CA0B3E;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE;IACL,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACnC,EACD,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAiIR"}

package/dist/discover-entries-esbuild-plugin.js

@@ -3,7 +3,22 @@ import { promisify } from 'node:util';
 import enhancedResolveOriginal from 'enhanced-resolve';
 import { applySwcTransform } from './apply-swc-transform.js';
 import { detectWorkflowPatterns, isGeneratedWorkflowFile, } from './transform-utils.js';
-const enhancedResolve = promisify(enhancedResolveOriginal);
+const enhancedResolve = promisify(enhancedResolveOriginal.create({
+    extensions: [
+        '.ts',
+        '.tsx',
+        '.mts',
+        '.cts',
+        '.js',
+        '.jsx',
+        '.mjs',
+        '.cjs',
+        '.json',
+        '.node',
+    ],
+    fullySpecified: false,
+    conditionNames: ['node', 'import', 'require'],
+}));
 export const jsTsRegex = /\.(ts|tsx|js|jsx|mjs|cjs|mts|cts)$/;
 /** Returns true if a manifest section has at least one entry. */
 function hasManifestEntries(section) {

package/dist/discover-entries-esbuild-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"discover-entries-esbuild-plugin.js","sourceRoot":"","sources":["../src/discover-entries-esbuild-plugin.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { promisify } from 'node:util';\nimport enhancedResolveOriginal from 'enhanced-resolve';\nimport type { Plugin } from 'esbuild';\nimport type { WorkflowManifest } from './apply-swc-transform.js';\nimport { applySwcTransform } from './apply-swc-transform.js';\nimport {\n  detectWorkflowPatterns,\n  isGeneratedWorkflowFile,\n} from './transform-utils.js';\n\nconst enhancedResolve = promisify(enhancedResolveOriginal);\n\nexport const jsTsRegex = /\\.(ts|tsx|js|jsx|mjs|cjs|mts|cts)$/;\n\n/** Returns true if a manifest section has at least one entry. */\nfunction hasManifestEntries(\n  section: WorkflowManifest[keyof WorkflowManifest]\n): boolean {\n  if (!section) return false;\n  return Object.values(section).some(\n    (entries) => Object.keys(entries).length > 0\n  );\n}\n\nfunction isGeneratedBuildArtifactPath(filePath: string): boolean {\n  const normalizedPath = filePath.replace(/\\\\/g, '/');\n  return (\n    normalizedPath.includes('/.output/') ||\n    normalizedPath.includes('/.next/') ||\n    normalizedPath.includes('/.nuxt/') ||\n    normalizedPath.includes('/.svelte-kit/') ||\n    normalizedPath.includes('/.vercel/')\n  );\n}\n\n// parent -> children relationship (a file can import multiple files)\nexport const importParents = new Map<string, Set<string>>();\n\n// check if a parent has a child in its import chain\n// e.g. if a dependency needs to be bundled because it has\n// a 'use workflow/'use step' directive in it\nexport function parentHasChild(parent: string, childToFind: string): boolean {\n  const visited = new Set<string>();\n  const queue: string[] = [parent];\n\n  while (queue.length > 0) {\n    const current = queue.shift()!;\n\n    if (visited.has(current)) {\n      continue;\n    }\n    visited.add(current);\n\n    const children = importParents.get(current);\n    if (!children) {\n      continue;\n    }\n\n    for (const child of children) {\n      if (child === childToFind) {\n        return true;\n      }\n      queue.push(child);\n    }\n  }\n\n  return false;\n}\n\nexport function createDiscoverEntriesPlugin(\n  state: {\n    discoveredSteps: Set<string>;\n    discoveredWorkflows: Set<string>;\n    discoveredSerdeFiles: Set<string>;\n  },\n  projectRoot?: string\n): Plugin {\n  return {\n    name: 'discover-entries-esbuild-plugin',\n    setup(build) {\n      // Track parent→child import relationships for ALL imports (not just\n      // those with file extensions) so that `parentHasChild()` can correctly\n      // identify transitive parents of serde/step files even when the\n      // dependency chain passes through bare specifier imports like\n      // `@workflow/core/runtime` or `workflow/runtime`.\n      build.onResolve({ filter: /.*/ }, async (args) => {\n        try {\n          const resolved = await enhancedResolve(args.resolveDir, args.path);\n\n          if (resolved) {\n            // Normalize path separators for cross-platform compatibility\n            const normalizedImporter = args.importer.replace(/\\\\/g, '/');\n            const normalizedResolved = resolved.replace(/\\\\/g, '/');\n            // A file can import multiple files, so we store a Set of children\n            let children = importParents.get(normalizedImporter);\n            if (!children) {\n              children = new Set<string>();\n              importParents.set(normalizedImporter, children);\n            }\n            children.add(normalizedResolved);\n          }\n        } catch (_) {}\n        return null;\n      });\n\n      // Handle TypeScript and JavaScript files\n      build.onLoad({ filter: jsTsRegex }, async (args) => {\n        try {\n          if (isGeneratedBuildArtifactPath(args.path)) {\n            return {\n              contents: '',\n              loader: 'js',\n            };\n          }\n\n          // Skip generated workflow route files to avoid re-processing them\n          if (isGeneratedWorkflowFile(args.path)) {\n            const source = await readFile(args.path, 'utf8');\n            return {\n              contents: source,\n              loader: args.path.endsWith('.jsx') ? 'jsx' : 'js',\n            };\n          }\n\n          // Determine the loader based on the output\n          let loader: 'js' | 'jsx' = 'js';\n          const isTypeScript =\n            args.path.endsWith('.ts') ||\n            args.path.endsWith('.tsx') ||\n            args.path.endsWith('.mts') ||\n            args.path.endsWith('.cts');\n          if (!isTypeScript && args.path.endsWith('.jsx')) {\n            loader = 'jsx';\n          }\n          const source = await readFile(args.path, 'utf8');\n\n          // Normalize path separators to forward slashes for cross-platform compatibility\n          // This is critical for Windows where paths contain backslashes\n          const normalizedPath = args.path.replace(/\\\\/g, '/');\n\n          const resolvedProjectRoot =\n            projectRoot || build.initialOptions.absWorkingDir || process.cwd();\n\n          // Two-phase discovery:\n          //  1. Fast regexp pre-scan filters out the vast majority of files.\n          //  2. For the small number that match, run the SWC plugin in 'detect'\n          //     mode to get an AST-level manifest. Detect mode walks the AST to\n          //     find directives and serde patterns but does NOT transform any\n          //     code, eliminating false positives where directive-like strings\n          //     appear inside template literals, regular strings, or comments.\n          //\n          // All files are transformed by SWC (TS→JS, decorators, etc.) since\n          // esbuild does not support all TypeScript syntax (e.g. legacy\n          // decorators, emitDecoratorMetadata). For regexp-matched files the\n          // 'detect' call handles both the syntax transform and the manifest\n          // in a single pass; for all other files a mode:false call is used.\n          const patterns = detectWorkflowPatterns(source);\n\n          let transformedCode: string;\n\n          if (patterns.hasDirective || patterns.hasSerde) {\n            const { code, workflowManifest } = await applySwcTransform(\n              normalizedPath,\n              source,\n              'detect',\n              normalizedPath,\n              resolvedProjectRoot\n            );\n            transformedCode = code;\n\n            if (hasManifestEntries(workflowManifest.workflows)) {\n              state.discoveredWorkflows.add(normalizedPath);\n            }\n            if (hasManifestEntries(workflowManifest.steps)) {\n              state.discoveredSteps.add(normalizedPath);\n            }\n\n            if (hasManifestEntries(workflowManifest.classes)) {\n              state.discoveredSerdeFiles.add(normalizedPath);\n            }\n          } else {\n            const { code } = await applySwcTransform(\n              normalizedPath,\n              source,\n              false,\n              normalizedPath,\n              resolvedProjectRoot\n            );\n            transformedCode = code;\n          }\n\n          return {\n            contents: transformedCode,\n            loader,\n          };\n        } catch (_) {\n          // ignore trace errors during discover phase\n          return {\n            contents: '',\n            loader: 'js',\n          };\n        }\n      });\n    },\n  };\n}\n"]}
+{"version":3,"file":"discover-entries-esbuild-plugin.js","sourceRoot":"","sources":["../src/discover-entries-esbuild-plugin.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { promisify } from 'node:util';\nimport enhancedResolveOriginal from 'enhanced-resolve';\nimport type { Plugin } from 'esbuild';\nimport type { WorkflowManifest } from './apply-swc-transform.js';\nimport { applySwcTransform } from './apply-swc-transform.js';\nimport {\n  detectWorkflowPatterns,\n  isGeneratedWorkflowFile,\n} from './transform-utils.js';\n\nconst enhancedResolve = promisify(\n  enhancedResolveOriginal.create({\n    extensions: [\n      '.ts',\n      '.tsx',\n      '.mts',\n      '.cts',\n      '.js',\n      '.jsx',\n      '.mjs',\n      '.cjs',\n      '.json',\n      '.node',\n    ],\n    fullySpecified: false,\n    conditionNames: ['node', 'import', 'require'],\n  })\n);\n\nexport const jsTsRegex = /\\.(ts|tsx|js|jsx|mjs|cjs|mts|cts)$/;\n\n/** Returns true if a manifest section has at least one entry. */\nfunction hasManifestEntries(\n  section: WorkflowManifest[keyof WorkflowManifest]\n): boolean {\n  if (!section) return false;\n  return Object.values(section).some(\n    (entries) => Object.keys(entries).length > 0\n  );\n}\n\nfunction isGeneratedBuildArtifactPath(filePath: string): boolean {\n  const normalizedPath = filePath.replace(/\\\\/g, '/');\n  return (\n    normalizedPath.includes('/.output/') ||\n    normalizedPath.includes('/.next/') ||\n    normalizedPath.includes('/.nuxt/') ||\n    normalizedPath.includes('/.svelte-kit/') ||\n    normalizedPath.includes('/.vercel/')\n  );\n}\n\n// parent -> children relationship (a file can import multiple files)\nexport const importParents = new Map<string, Set<string>>();\n\n// check if a parent has a child in its import chain\n// e.g. if a dependency needs to be bundled because it has\n// a 'use workflow/'use step' directive in it\nexport function parentHasChild(parent: string, childToFind: string): boolean {\n  const visited = new Set<string>();\n  const queue: string[] = [parent];\n\n  while (queue.length > 0) {\n    const current = queue.shift()!;\n\n    if (visited.has(current)) {\n      continue;\n    }\n    visited.add(current);\n\n    const children = importParents.get(current);\n    if (!children) {\n      continue;\n    }\n\n    for (const child of children) {\n      if (child === childToFind) {\n        return true;\n      }\n      queue.push(child);\n    }\n  }\n\n  return false;\n}\n\nexport function createDiscoverEntriesPlugin(\n  state: {\n    discoveredSteps: Set<string>;\n    discoveredWorkflows: Set<string>;\n    discoveredSerdeFiles: Set<string>;\n  },\n  projectRoot?: string\n): Plugin {\n  return {\n    name: 'discover-entries-esbuild-plugin',\n    setup(build) {\n      // Track parent→child import relationships for ALL imports (not just\n      // those with file extensions) so that `parentHasChild()` can correctly\n      // identify transitive parents of serde/step files even when the\n      // dependency chain passes through bare specifier imports like\n      // `@workflow/core/runtime` or `workflow/runtime`.\n      build.onResolve({ filter: /.*/ }, async (args) => {\n        try {\n          const resolved = await enhancedResolve(args.resolveDir, args.path);\n\n          if (resolved) {\n            // Normalize path separators for cross-platform compatibility\n            const normalizedImporter = args.importer.replace(/\\\\/g, '/');\n            const normalizedResolved = resolved.replace(/\\\\/g, '/');\n            // A file can import multiple files, so we store a Set of children\n            let children = importParents.get(normalizedImporter);\n            if (!children) {\n              children = new Set<string>();\n              importParents.set(normalizedImporter, children);\n            }\n            children.add(normalizedResolved);\n          }\n        } catch (_) {}\n        return null;\n      });\n\n      // Handle TypeScript and JavaScript files\n      build.onLoad({ filter: jsTsRegex }, async (args) => {\n        try {\n          if (isGeneratedBuildArtifactPath(args.path)) {\n            return {\n              contents: '',\n              loader: 'js',\n            };\n          }\n\n          // Skip generated workflow route files to avoid re-processing them\n          if (isGeneratedWorkflowFile(args.path)) {\n            const source = await readFile(args.path, 'utf8');\n            return {\n              contents: source,\n              loader: args.path.endsWith('.jsx') ? 'jsx' : 'js',\n            };\n          }\n\n          // Determine the loader based on the output\n          let loader: 'js' | 'jsx' = 'js';\n          const isTypeScript =\n            args.path.endsWith('.ts') ||\n            args.path.endsWith('.tsx') ||\n            args.path.endsWith('.mts') ||\n            args.path.endsWith('.cts');\n          if (!isTypeScript && args.path.endsWith('.jsx')) {\n            loader = 'jsx';\n          }\n          const source = await readFile(args.path, 'utf8');\n\n          // Normalize path separators to forward slashes for cross-platform compatibility\n          // This is critical for Windows where paths contain backslashes\n          const normalizedPath = args.path.replace(/\\\\/g, '/');\n\n          const resolvedProjectRoot =\n            projectRoot || build.initialOptions.absWorkingDir || process.cwd();\n\n          // Two-phase discovery:\n          //  1. Fast regexp pre-scan filters out the vast majority of files.\n          //  2. For the small number that match, run the SWC plugin in 'detect'\n          //     mode to get an AST-level manifest. Detect mode walks the AST to\n          //     find directives and serde patterns but does NOT transform any\n          //     code, eliminating false positives where directive-like strings\n          //     appear inside template literals, regular strings, or comments.\n          //\n          // All files are transformed by SWC (TS→JS, decorators, etc.) since\n          // esbuild does not support all TypeScript syntax (e.g. legacy\n          // decorators, emitDecoratorMetadata). For regexp-matched files the\n          // 'detect' call handles both the syntax transform and the manifest\n          // in a single pass; for all other files a mode:false call is used.\n          const patterns = detectWorkflowPatterns(source);\n\n          let transformedCode: string;\n\n          if (patterns.hasDirective || patterns.hasSerde) {\n            const { code, workflowManifest } = await applySwcTransform(\n              normalizedPath,\n              source,\n              'detect',\n              normalizedPath,\n              resolvedProjectRoot\n            );\n            transformedCode = code;\n\n            if (hasManifestEntries(workflowManifest.workflows)) {\n              state.discoveredWorkflows.add(normalizedPath);\n            }\n            if (hasManifestEntries(workflowManifest.steps)) {\n              state.discoveredSteps.add(normalizedPath);\n            }\n\n            if (hasManifestEntries(workflowManifest.classes)) {\n              state.discoveredSerdeFiles.add(normalizedPath);\n            }\n          } else {\n            const { code } = await applySwcTransform(\n              normalizedPath,\n              source,\n              false,\n              normalizedPath,\n              resolvedProjectRoot\n            );\n            transformedCode = code;\n          }\n\n          return {\n            contents: transformedCode,\n            loader,\n          };\n        } catch (_) {\n          // ignore trace errors during discover phase\n          return {\n            contents: '',\n            loader: 'js',\n          };\n        }\n      });\n    },\n  };\n}\n"]}

package/dist/external-package-warning.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=external-package-warning.test.d.ts.map

package/dist/external-package-warning.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-package-warning.test.d.ts","sourceRoot":"","sources":["../src/external-package-warning.test.ts"],"names":[],"mappings":""}

package/dist/external-package-warning.test.js

@@ -0,0 +1,219 @@
+import { mkdirSync, mkdtempSync, realpathSync, rmSync, writeFileSync, } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { BaseBuilder } from './base-builder.js';
+/**
+ * Minimal subclass to expose the protected `discoverEntries()` for testing.
+ */
+class TestBuilder extends BaseBuilder {
+    async build() {
+        // no-op
+    }
+    // Expose for tests
+    discoverEntriesPublic(inputs, outdir) {
+        return this.discoverEntries(inputs, outdir);
+    }
+}
+// Resolve symlinks in tmpdir to avoid macOS /var -> /private/var issues
+const realTmpdir = realpathSync(tmpdir());
+function writeFile(path, contents) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, contents, 'utf-8');
+}
+function createBuilder(workingDir, externalPackages) {
+    const config = {
+        buildTarget: 'standalone',
+        workingDir,
+        dirs: ['.'],
+        externalPackages,
+        stepsBundlePath: join(workingDir, 'steps.js'),
+        workflowsBundlePath: join(workingDir, 'workflows.js'),
+        webhookBundlePath: join(workingDir, 'webhook.js'),
+    };
+    return new TestBuilder(config);
+}
+describe('warnAboutExternalWorkflowPackages', () => {
+    let testRoot;
+    let warnSpy;
+    beforeEach(() => {
+        testRoot = mkdtempSync(join(realTmpdir, 'workflow-external-pkg-warning-'));
+        warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        warnSpy.mockRestore();
+        rmSync(testRoot, { recursive: true, force: true });
+    });
+    it('warns when an external package depends on @workflow/serde', async () => {
+        // Create a mock project with a node_modules package
+        const projectDir = join(testRoot, 'project');
+        // Create a minimal entry file for the project
+        writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');
+        // Create the external package with @workflow/serde dependency
+        writeFile(join(projectDir, 'node_modules', 'my-serde-pkg', 'package.json'), JSON.stringify({
+            name: 'my-serde-pkg',
+            version: '1.0.0',
+            main: 'index.js',
+            dependencies: {
+                '@workflow/serde': '^1.0.0',
+            },
+        }));
+        writeFile(join(projectDir, 'node_modules', 'my-serde-pkg', 'index.js'), 'export class Foo {}');
+        const builder = createBuilder(projectDir, ['my-serde-pkg']);
+        await builder.discoverEntriesPublic([join(projectDir, 'index.ts')], join(projectDir, 'out'));
+        expect(warnSpy).toHaveBeenCalled();
+        const warnMessage = warnSpy.mock.calls[0]?.[0];
+        expect(warnMessage).toContain('my-serde-pkg');
+        expect(warnMessage).toContain('serverExternalPackages');
+        expect(warnMessage).toContain('serialization classes');
+    });
+    it('warns when an external package source contains serde symbols', async () => {
+        const projectDir = join(testRoot, 'project');
+        writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');
+        // Package without @workflow/serde dep but with Symbol.for patterns in source
+        writeFile(join(projectDir, 'node_modules', 'my-symbol-pkg', 'package.json'), JSON.stringify({
+            name: 'my-symbol-pkg',
+            version: '1.0.0',
+            main: 'index.js',
+        }));
+        writeFile(join(projectDir, 'node_modules', 'my-symbol-pkg', 'index.js'), `export class Bar {
+  static [Symbol.for('workflow-serialize')](instance) { return {}; }
+  static [Symbol.for('workflow-deserialize')](data) { return new Bar(); }
+}`);
+        const builder = createBuilder(projectDir, ['my-symbol-pkg']);
+        await builder.discoverEntriesPublic([join(projectDir, 'index.ts')], join(projectDir, 'out'));
+        expect(warnSpy).toHaveBeenCalled();
+        const warnMessage = warnSpy.mock.calls[0]?.[0];
+        expect(warnMessage).toContain('my-symbol-pkg');
+        expect(warnMessage).toContain('serialization classes');
+    });
+    it('warns when an external package contains "use step" directives', async () => {
+        const projectDir = join(testRoot, 'project');
+        writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');
+        writeFile(join(projectDir, 'node_modules', 'my-step-pkg', 'package.json'), JSON.stringify({
+            name: 'my-step-pkg',
+            version: '1.0.0',
+            main: 'index.js',
+        }));
+        writeFile(join(projectDir, 'node_modules', 'my-step-pkg', 'index.js'), `export async function doWork() {
+  "use step";
+  return 42;
+}`);
+        const builder = createBuilder(projectDir, ['my-step-pkg']);
+        await builder.discoverEntriesPublic([join(projectDir, 'index.ts')], join(projectDir, 'out'));
+        expect(warnSpy).toHaveBeenCalled();
+        const warnMessage = warnSpy.mock.calls[0]?.[0];
+        expect(warnMessage).toContain('my-step-pkg');
+        expect(warnMessage).toContain('"use step" functions');
+    });
+    it('warns when an external package contains "use workflow" directives', async () => {
+        const projectDir = join(testRoot, 'project');
+        writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');
+        writeFile(join(projectDir, 'node_modules', 'my-workflow-pkg', 'package.json'), JSON.stringify({
+            name: 'my-workflow-pkg',
+            version: '1.0.0',
+            main: 'index.js',
+        }));
+        writeFile(join(projectDir, 'node_modules', 'my-workflow-pkg', 'index.js'), `export async function runJob() {
+  "use workflow";
+  return "done";
+}`);
+        const builder = createBuilder(projectDir, ['my-workflow-pkg']);
+        await builder.discoverEntriesPublic([join(projectDir, 'index.ts')], join(projectDir, 'out'));
+        expect(warnSpy).toHaveBeenCalled();
+        const warnMessage = warnSpy.mock.calls[0]?.[0];
+        expect(warnMessage).toContain('my-workflow-pkg');
+        expect(warnMessage).toContain('"use workflow" functions');
+    });
+    it('does not warn for packages without workflow patterns', async () => {
+        const projectDir = join(testRoot, 'project');
+        writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');
+        writeFile(join(projectDir, 'node_modules', 'plain-pkg', 'package.json'), JSON.stringify({
+            name: 'plain-pkg',
+            version: '1.0.0',
+            main: 'index.js',
+        }));
+        writeFile(join(projectDir, 'node_modules', 'plain-pkg', 'index.js'), 'export const hello = "world";');
+        const builder = createBuilder(projectDir, ['plain-pkg']);
+        await builder.discoverEntriesPublic([join(projectDir, 'index.ts')], join(projectDir, 'out'));
+        expect(warnSpy).not.toHaveBeenCalled();
+    });
+    it('does not warn for pseudo-packages (server-only, client-only)', async () => {
+        const projectDir = join(testRoot, 'project');
+        writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');
+        const builder = createBuilder(projectDir, ['server-only', 'client-only']);
+        await builder.discoverEntriesPublic([join(projectDir, 'index.ts')], join(projectDir, 'out'));
+        expect(warnSpy).not.toHaveBeenCalled();
+    });
+    it('does not warn when externalPackages is empty', async () => {
+        const projectDir = join(testRoot, 'project');
+        writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');
+        const builder = createBuilder(projectDir, []);
+        await builder.discoverEntriesPublic([join(projectDir, 'index.ts')], join(projectDir, 'out'));
+        expect(warnSpy).not.toHaveBeenCalled();
+    });
+    it('warns only once per package across multiple discoverEntries calls', async () => {
+        const projectDir = join(testRoot, 'project');
+        writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');
+        writeFile(join(projectDir, 'other.ts'), 'export const y = 2;');
+        writeFile(join(projectDir, 'node_modules', 'my-serde-pkg', 'package.json'), JSON.stringify({
+            name: 'my-serde-pkg',
+            version: '1.0.0',
+            main: 'index.js',
+            dependencies: { '@workflow/serde': '^1.0.0' },
+        }));
+        writeFile(join(projectDir, 'node_modules', 'my-serde-pkg', 'index.js'), 'export class Foo {}');
+        const builder = createBuilder(projectDir, ['my-serde-pkg']);
+        // Call discoverEntries twice with different inputs
+        await builder.discoverEntriesPublic([join(projectDir, 'index.ts')], join(projectDir, 'out'));
+        await builder.discoverEntriesPublic([join(projectDir, 'other.ts')], join(projectDir, 'out2'));
+        // Should only warn once
+        const warnCalls = warnSpy.mock.calls.filter((call) => call[0].includes('my-serde-pkg'));
+        expect(warnCalls).toHaveLength(1);
+    });
+    it('lists multiple detected issues in the warning message', async () => {
+        const projectDir = join(testRoot, 'project');
+        writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');
+        writeFile(join(projectDir, 'node_modules', 'multi-pkg', 'package.json'), JSON.stringify({
+            name: 'multi-pkg',
+            version: '1.0.0',
+            main: 'index.js',
+            dependencies: { '@workflow/serde': '^1.0.0' },
+        }));
+        writeFile(join(projectDir, 'node_modules', 'multi-pkg', 'index.js'), `export async function doWork() {
+  "use step";
+  return 42;
+}
+export class Foo {
+  static [Symbol.for('workflow-serialize')](instance) { return {}; }
+  static [Symbol.for('workflow-deserialize')](data) { return new Foo(); }
+}`);
+        const builder = createBuilder(projectDir, ['multi-pkg']);
+        await builder.discoverEntriesPublic([join(projectDir, 'index.ts')], join(projectDir, 'out'));
+        expect(warnSpy).toHaveBeenCalled();
+        const warnMessage = warnSpy.mock.calls[0]?.[0];
+        expect(warnMessage).toContain('"use step" functions');
+        expect(warnMessage).toContain('serialization classes');
+    });
+    it('warns via entry-file detection when package.json has no serde dep', async () => {
+        const projectDir = join(testRoot, 'project');
+        writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');
+        // Package without @workflow/serde in deps, but entry has "use step"
+        writeFile(join(projectDir, 'node_modules', 'no-serde-dep-pkg', 'package.json'), JSON.stringify({
+            name: 'no-serde-dep-pkg',
+            version: '1.0.0',
+            main: 'index.js',
+        }));
+        writeFile(join(projectDir, 'node_modules', 'no-serde-dep-pkg', 'index.js'), `export async function doWork() {
+  "use step";
+  return 42;
+}`);
+        const builder = createBuilder(projectDir, ['no-serde-dep-pkg']);
+        await builder.discoverEntriesPublic([join(projectDir, 'index.ts')], join(projectDir, 'out'));
+        expect(warnSpy).toHaveBeenCalled();
+        const warnMessage = warnSpy.mock.calls[0]?.[0];
+        expect(warnMessage).toContain('no-serde-dep-pkg');
+        expect(warnMessage).toContain('"use step" functions');
+    });
+});
+//# sourceMappingURL=external-package-warning.test.js.map

package/dist/external-package-warning.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-package-warning.test.js","sourceRoot":"","sources":["../src/external-package-warning.test.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  mkdirSync,\n  mkdtempSync,\n  realpathSync,\n  rmSync,\n  writeFileSync,\n} from 'node:fs';\nimport { tmpdir } from 'node:os';\nimport { dirname, join } from 'node:path';\nimport { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';\nimport { BaseBuilder, type DiscoveredEntries } from './base-builder.js';\nimport type { StandaloneConfig } from './types.js';\n\n/**\n * Minimal subclass to expose the protected `discoverEntries()` for testing.\n */\nclass TestBuilder extends BaseBuilder {\n  async build(): Promise<void> {\n    // no-op\n  }\n\n  // Expose for tests\n  public discoverEntriesPublic(\n    inputs: string[],\n    outdir: string\n  ): Promise<DiscoveredEntries> {\n    return this.discoverEntries(inputs, outdir);\n  }\n}\n\n// Resolve symlinks in tmpdir to avoid macOS /var -> /private/var issues\nconst realTmpdir = realpathSync(tmpdir());\n\nfunction writeFile(path: string, contents: string): void {\n  mkdirSync(dirname(path), { recursive: true });\n  writeFileSync(path, contents, 'utf-8');\n}\n\nfunction createBuilder(\n  workingDir: string,\n  externalPackages: string[]\n): TestBuilder {\n  const config: StandaloneConfig = {\n    buildTarget: 'standalone',\n    workingDir,\n    dirs: ['.'],\n    externalPackages,\n    stepsBundlePath: join(workingDir, 'steps.js'),\n    workflowsBundlePath: join(workingDir, 'workflows.js'),\n    webhookBundlePath: join(workingDir, 'webhook.js'),\n  };\n  return new TestBuilder(config);\n}\n\ndescribe('warnAboutExternalWorkflowPackages', () => {\n  let testRoot: string;\n  let warnSpy: ReturnType<typeof vi.spyOn>;\n\n  beforeEach(() => {\n    testRoot = mkdtempSync(join(realTmpdir, 'workflow-external-pkg-warning-'));\n    warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});\n  });\n\n  afterEach(() => {\n    warnSpy.mockRestore();\n    rmSync(testRoot, { recursive: true, force: true });\n  });\n\n  it('warns when an external package depends on @workflow/serde', async () => {\n    // Create a mock project with a node_modules package\n    const projectDir = join(testRoot, 'project');\n\n    // Create a minimal entry file for the project\n    writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');\n\n    // Create the external package with @workflow/serde dependency\n    writeFile(\n      join(projectDir, 'node_modules', 'my-serde-pkg', 'package.json'),\n      JSON.stringify({\n        name: 'my-serde-pkg',\n        version: '1.0.0',\n        main: 'index.js',\n        dependencies: {\n          '@workflow/serde': '^1.0.0',\n        },\n      })\n    );\n    writeFile(\n      join(projectDir, 'node_modules', 'my-serde-pkg', 'index.js'),\n      'export class Foo {}'\n    );\n\n    const builder = createBuilder(projectDir, ['my-serde-pkg']);\n    await builder.discoverEntriesPublic(\n      [join(projectDir, 'index.ts')],\n      join(projectDir, 'out')\n    );\n\n    expect(warnSpy).toHaveBeenCalled();\n    const warnMessage = warnSpy.mock.calls[0]?.[0] as string;\n    expect(warnMessage).toContain('my-serde-pkg');\n    expect(warnMessage).toContain('serverExternalPackages');\n    expect(warnMessage).toContain('serialization classes');\n  });\n\n  it('warns when an external package source contains serde symbols', async () => {\n    const projectDir = join(testRoot, 'project');\n\n    writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');\n\n    // Package without @workflow/serde dep but with Symbol.for patterns in source\n    writeFile(\n      join(projectDir, 'node_modules', 'my-symbol-pkg', 'package.json'),\n      JSON.stringify({\n        name: 'my-symbol-pkg',\n        version: '1.0.0',\n        main: 'index.js',\n      })\n    );\n    writeFile(\n      join(projectDir, 'node_modules', 'my-symbol-pkg', 'index.js'),\n      `export class Bar {\n  static [Symbol.for('workflow-serialize')](instance) { return {}; }\n  static [Symbol.for('workflow-deserialize')](data) { return new Bar(); }\n}`\n    );\n\n    const builder = createBuilder(projectDir, ['my-symbol-pkg']);\n    await builder.discoverEntriesPublic(\n      [join(projectDir, 'index.ts')],\n      join(projectDir, 'out')\n    );\n\n    expect(warnSpy).toHaveBeenCalled();\n    const warnMessage = warnSpy.mock.calls[0]?.[0] as string;\n    expect(warnMessage).toContain('my-symbol-pkg');\n    expect(warnMessage).toContain('serialization classes');\n  });\n\n  it('warns when an external package contains \"use step\" directives', async () => {\n    const projectDir = join(testRoot, 'project');\n\n    writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');\n\n    writeFile(\n      join(projectDir, 'node_modules', 'my-step-pkg', 'package.json'),\n      JSON.stringify({\n        name: 'my-step-pkg',\n        version: '1.0.0',\n        main: 'index.js',\n      })\n    );\n    writeFile(\n      join(projectDir, 'node_modules', 'my-step-pkg', 'index.js'),\n      `export async function doWork() {\n  \"use step\";\n  return 42;\n}`\n    );\n\n    const builder = createBuilder(projectDir, ['my-step-pkg']);\n    await builder.discoverEntriesPublic(\n      [join(projectDir, 'index.ts')],\n      join(projectDir, 'out')\n    );\n\n    expect(warnSpy).toHaveBeenCalled();\n    const warnMessage = warnSpy.mock.calls[0]?.[0] as string;\n    expect(warnMessage).toContain('my-step-pkg');\n    expect(warnMessage).toContain('\"use step\" functions');\n  });\n\n  it('warns when an external package contains \"use workflow\" directives', async () => {\n    const projectDir = join(testRoot, 'project');\n\n    writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');\n\n    writeFile(\n      join(projectDir, 'node_modules', 'my-workflow-pkg', 'package.json'),\n      JSON.stringify({\n        name: 'my-workflow-pkg',\n        version: '1.0.0',\n        main: 'index.js',\n      })\n    );\n    writeFile(\n      join(projectDir, 'node_modules', 'my-workflow-pkg', 'index.js'),\n      `export async function runJob() {\n  \"use workflow\";\n  return \"done\";\n}`\n    );\n\n    const builder = createBuilder(projectDir, ['my-workflow-pkg']);\n    await builder.discoverEntriesPublic(\n      [join(projectDir, 'index.ts')],\n      join(projectDir, 'out')\n    );\n\n    expect(warnSpy).toHaveBeenCalled();\n    const warnMessage = warnSpy.mock.calls[0]?.[0] as string;\n    expect(warnMessage).toContain('my-workflow-pkg');\n    expect(warnMessage).toContain('\"use workflow\" functions');\n  });\n\n  it('does not warn for packages without workflow patterns', async () => {\n    const projectDir = join(testRoot, 'project');\n\n    writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');\n\n    writeFile(\n      join(projectDir, 'node_modules', 'plain-pkg', 'package.json'),\n      JSON.stringify({\n        name: 'plain-pkg',\n        version: '1.0.0',\n        main: 'index.js',\n      })\n    );\n    writeFile(\n      join(projectDir, 'node_modules', 'plain-pkg', 'index.js'),\n      'export const hello = \"world\";'\n    );\n\n    const builder = createBuilder(projectDir, ['plain-pkg']);\n    await builder.discoverEntriesPublic(\n      [join(projectDir, 'index.ts')],\n      join(projectDir, 'out')\n    );\n\n    expect(warnSpy).not.toHaveBeenCalled();\n  });\n\n  it('does not warn for pseudo-packages (server-only, client-only)', async () => {\n    const projectDir = join(testRoot, 'project');\n\n    writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');\n\n    const builder = createBuilder(projectDir, ['server-only', 'client-only']);\n    await builder.discoverEntriesPublic(\n      [join(projectDir, 'index.ts')],\n      join(projectDir, 'out')\n    );\n\n    expect(warnSpy).not.toHaveBeenCalled();\n  });\n\n  it('does not warn when externalPackages is empty', async () => {\n    const projectDir = join(testRoot, 'project');\n\n    writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');\n\n    const builder = createBuilder(projectDir, []);\n    await builder.discoverEntriesPublic(\n      [join(projectDir, 'index.ts')],\n      join(projectDir, 'out')\n    );\n\n    expect(warnSpy).not.toHaveBeenCalled();\n  });\n\n  it('warns only once per package across multiple discoverEntries calls', async () => {\n    const projectDir = join(testRoot, 'project');\n\n    writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');\n    writeFile(join(projectDir, 'other.ts'), 'export const y = 2;');\n\n    writeFile(\n      join(projectDir, 'node_modules', 'my-serde-pkg', 'package.json'),\n      JSON.stringify({\n        name: 'my-serde-pkg',\n        version: '1.0.0',\n        main: 'index.js',\n        dependencies: { '@workflow/serde': '^1.0.0' },\n      })\n    );\n    writeFile(\n      join(projectDir, 'node_modules', 'my-serde-pkg', 'index.js'),\n      'export class Foo {}'\n    );\n\n    const builder = createBuilder(projectDir, ['my-serde-pkg']);\n\n    // Call discoverEntries twice with different inputs\n    await builder.discoverEntriesPublic(\n      [join(projectDir, 'index.ts')],\n      join(projectDir, 'out')\n    );\n    await builder.discoverEntriesPublic(\n      [join(projectDir, 'other.ts')],\n      join(projectDir, 'out2')\n    );\n\n    // Should only warn once\n    const warnCalls = warnSpy.mock.calls.filter((call: unknown[]) =>\n      (call[0] as string).includes('my-serde-pkg')\n    );\n    expect(warnCalls).toHaveLength(1);\n  });\n\n  it('lists multiple detected issues in the warning message', async () => {\n    const projectDir = join(testRoot, 'project');\n\n    writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');\n\n    writeFile(\n      join(projectDir, 'node_modules', 'multi-pkg', 'package.json'),\n      JSON.stringify({\n        name: 'multi-pkg',\n        version: '1.0.0',\n        main: 'index.js',\n        dependencies: { '@workflow/serde': '^1.0.0' },\n      })\n    );\n    writeFile(\n      join(projectDir, 'node_modules', 'multi-pkg', 'index.js'),\n      `export async function doWork() {\n  \"use step\";\n  return 42;\n}\nexport class Foo {\n  static [Symbol.for('workflow-serialize')](instance) { return {}; }\n  static [Symbol.for('workflow-deserialize')](data) { return new Foo(); }\n}`\n    );\n\n    const builder = createBuilder(projectDir, ['multi-pkg']);\n    await builder.discoverEntriesPublic(\n      [join(projectDir, 'index.ts')],\n      join(projectDir, 'out')\n    );\n\n    expect(warnSpy).toHaveBeenCalled();\n    const warnMessage = warnSpy.mock.calls[0]?.[0] as string;\n    expect(warnMessage).toContain('\"use step\" functions');\n    expect(warnMessage).toContain('serialization classes');\n  });\n\n  it('warns via entry-file detection when package.json has no serde dep', async () => {\n    const projectDir = join(testRoot, 'project');\n\n    writeFile(join(projectDir, 'index.ts'), 'export const x = 1;');\n\n    // Package without @workflow/serde in deps, but entry has \"use step\"\n    writeFile(\n      join(projectDir, 'node_modules', 'no-serde-dep-pkg', 'package.json'),\n      JSON.stringify({\n        name: 'no-serde-dep-pkg',\n        version: '1.0.0',\n        main: 'index.js',\n      })\n    );\n    writeFile(\n      join(projectDir, 'node_modules', 'no-serde-dep-pkg', 'index.js'),\n      `export async function doWork() {\n  \"use step\";\n  return 42;\n}`\n    );\n\n    const builder = createBuilder(projectDir, ['no-serde-dep-pkg']);\n    await builder.discoverEntriesPublic(\n      [join(projectDir, 'index.ts')],\n      join(projectDir, 'out')\n    );\n\n    expect(warnSpy).toHaveBeenCalled();\n    const warnMessage = warnSpy.mock.calls[0]?.[0] as string;\n    expect(warnMessage).toContain('no-serde-dep-pkg');\n    expect(warnMessage).toContain('\"use step\" functions');\n  });\n});\n"]}

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { applySwcTransform } from './apply-swc-transform.js';
 export { BaseBuilder } from './base-builder.js';
 export { createBuildQueue } from './build-queue.js';
 export { createBaseBuilderConfig, type DecoratorOptions, type DecoratorOptionsWithConfigPath, getDecoratorOptionsForDirectory, getDecoratorOptionsForDirectoryWithConfigPath, } from './config-helpers.js';
-export { STEP_QUEUE_TRIGGER, WORKFLOW_QUEUE_TRIGGER } from './constants.js';
+export { WORKFLOW_QUEUE_TRIGGER } from './constants.js';
 export { createDiscoverEntriesPlugin } from './discover-entries-esbuild-plugin.js';
 export { clearModuleSpecifierCache, getImportPath, type ImportPathResult, type ModuleSpecifierResult, resolveModuleSpecifier, } from './module-specifier.js';
 export { createNodeModuleErrorPlugin } from './node-module-esbuild-plugin.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,KAAK,8BAA8B,EACnC,+BAA+B,EAC/B,6CAA6C,GAC9C,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EACL,yBAAyB,EACzB,eAAe,GAChB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,KAAK,8BAA8B,EACnC,+BAA+B,EAC/B,6CAA6C,GAC9C,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EACL,yBAAyB,EACzB,eAAe,GAChB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -2,7 +2,7 @@ export { applySwcTransform } from './apply-swc-transform.js';
 export { BaseBuilder } from './base-builder.js';
 export { createBuildQueue } from './build-queue.js';
 export { createBaseBuilderConfig, getDecoratorOptionsForDirectory, getDecoratorOptionsForDirectoryWithConfigPath, } from './config-helpers.js';
-export { STEP_QUEUE_TRIGGER, WORKFLOW_QUEUE_TRIGGER } from './constants.js';
+export { WORKFLOW_QUEUE_TRIGGER } from './constants.js';
 export { createDiscoverEntriesPlugin } from './discover-entries-esbuild-plugin.js';
 export { clearModuleSpecifierCache, getImportPath, resolveModuleSpecifier, } from './module-specifier.js';
 export { createNodeModuleErrorPlugin } from './node-module-esbuild-plugin.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,uBAAuB,EAGvB,+BAA+B,EAC/B,6CAA6C,GAC9C,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EACL,yBAAyB,EACzB,aAAa,EAGb,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EACL,yBAAyB,EACzB,eAAe,GAChB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GAGpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAElB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAU9B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["export type { WorkflowManifest } from './apply-swc-transform.js';\nexport { applySwcTransform } from './apply-swc-transform.js';\nexport { BaseBuilder } from './base-builder.js';\nexport { createBuildQueue } from './build-queue.js';\nexport {\n  createBaseBuilderConfig,\n  type DecoratorOptions,\n  type DecoratorOptionsWithConfigPath,\n  getDecoratorOptionsForDirectory,\n  getDecoratorOptionsForDirectoryWithConfigPath,\n} from './config-helpers.js';\nexport { STEP_QUEUE_TRIGGER, WORKFLOW_QUEUE_TRIGGER } from './constants.js';\nexport { createDiscoverEntriesPlugin } from './discover-entries-esbuild-plugin.js';\nexport {\n  clearModuleSpecifierCache,\n  getImportPath,\n  type ImportPathResult,\n  type ModuleSpecifierResult,\n  resolveModuleSpecifier,\n} from './module-specifier.js';\nexport { createNodeModuleErrorPlugin } from './node-module-esbuild-plugin.js';\nexport {\n  createPseudoPackagePlugin,\n  PSEUDO_PACKAGES,\n} from './pseudo-package-esbuild-plugin.js';\nexport { NORMALIZE_REQUEST_CODE } from './request-converter.js';\nexport {\n  analyzeSerdeCompliance,\n  extractClassEntries,\n  type SerdeCheckResult,\n  type SerdeClassCheckResult,\n} from './serde-checker.js';\nexport { StandaloneBuilder } from './standalone.js';\nexport { createSwcPlugin } from './swc-esbuild-plugin.js';\nexport {\n  detectWorkflowPatterns,\n  generatedWorkflowPathPattern,\n  isGeneratedWorkflowFile,\n  shouldTransformFile,\n  turbopackContentPattern,\n  useStepPattern,\n  useWorkflowPattern,\n  type WorkflowPatternMatch,\n  workflowSerdeImportPattern,\n  workflowSerdeSymbolPattern,\n} from './transform-utils.js';\nexport type {\n  AstroConfig,\n  BuildTarget,\n  NextConfig,\n  StandaloneConfig,\n  SvelteKitConfig,\n  VercelBuildOutputConfig,\n  WorkflowConfig,\n} from './types.js';\nexport { isValidBuildTarget, validBuildTargets } from './types.js';\nexport { VercelBuildOutputAPIBuilder } from './vercel-build-output-api.js';\nexport { resolveWorkflowAliasRelativePath } from './workflow-alias.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,uBAAuB,EAGvB,+BAA+B,EAC/B,6CAA6C,GAC9C,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EACL,yBAAyB,EACzB,aAAa,EAGb,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EACL,yBAAyB,EACzB,eAAe,GAChB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GAGpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAElB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAU9B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["export type { WorkflowManifest } from './apply-swc-transform.js';\nexport { applySwcTransform } from './apply-swc-transform.js';\nexport { BaseBuilder } from './base-builder.js';\nexport { createBuildQueue } from './build-queue.js';\nexport {\n  createBaseBuilderConfig,\n  type DecoratorOptions,\n  type DecoratorOptionsWithConfigPath,\n  getDecoratorOptionsForDirectory,\n  getDecoratorOptionsForDirectoryWithConfigPath,\n} from './config-helpers.js';\nexport { WORKFLOW_QUEUE_TRIGGER } from './constants.js';\nexport { createDiscoverEntriesPlugin } from './discover-entries-esbuild-plugin.js';\nexport {\n  clearModuleSpecifierCache,\n  getImportPath,\n  type ImportPathResult,\n  type ModuleSpecifierResult,\n  resolveModuleSpecifier,\n} from './module-specifier.js';\nexport { createNodeModuleErrorPlugin } from './node-module-esbuild-plugin.js';\nexport {\n  createPseudoPackagePlugin,\n  PSEUDO_PACKAGES,\n} from './pseudo-package-esbuild-plugin.js';\nexport { NORMALIZE_REQUEST_CODE } from './request-converter.js';\nexport {\n  analyzeSerdeCompliance,\n  extractClassEntries,\n  type SerdeCheckResult,\n  type SerdeClassCheckResult,\n} from './serde-checker.js';\nexport { StandaloneBuilder } from './standalone.js';\nexport { createSwcPlugin } from './swc-esbuild-plugin.js';\nexport {\n  detectWorkflowPatterns,\n  generatedWorkflowPathPattern,\n  isGeneratedWorkflowFile,\n  shouldTransformFile,\n  turbopackContentPattern,\n  useStepPattern,\n  useWorkflowPattern,\n  type WorkflowPatternMatch,\n  workflowSerdeImportPattern,\n  workflowSerdeSymbolPattern,\n} from './transform-utils.js';\nexport type {\n  AstroConfig,\n  BuildTarget,\n  NextConfig,\n  StandaloneConfig,\n  SvelteKitConfig,\n  VercelBuildOutputConfig,\n  WorkflowConfig,\n} from './types.js';\nexport { isValidBuildTarget, validBuildTargets } from './types.js';\nexport { VercelBuildOutputAPIBuilder } from './vercel-build-output-api.js';\nexport { resolveWorkflowAliasRelativePath } from './workflow-alias.js';\n"]}

package/dist/module-specifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-specifier.d.ts","sourceRoot":"","sources":["../src/module-specifier.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAgQD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,qBAAqB,CA6BvB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AA0HD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,gBAAgB,CA6DlB"}
+{"version":3,"file":"module-specifier.d.ts","sourceRoot":"","sources":["../src/module-specifier.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAoTD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,qBAAqB,CA+BvB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AA0HD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,gBAAgB,CA6DlB"}

package/dist/module-specifier.js

@@ -67,24 +67,60 @@ function findPackageJson(filePath) {
  * @param pkg - Package info from findPackageJson
  * @returns The subpath (e.g., "/internal/builtins") or empty string for root export
  */
-function resolveExportSubpath(filePath, pkg) {
+function toPackageRelativePath(filePath, pkg) {
+    const normalizedFilePath = filePath.replace(/\\/g, '/');
+    const normalizedPkgDir = pkg.dir.replace(/\\/g, '/');
+    if (!normalizedFilePath.startsWith(normalizedPkgDir + '/')) {
+        return null;
+    }
+    return normalizedFilePath.substring(normalizedPkgDir.length + 1);
+}
+function getSourceFallbackExportTargets(relativePath) {
+    const fallbackTargets = new Set();
+    const extensionFallbacks = {
+        '.ts': ['.js'],
+        '.tsx': ['.js'],
+        '.mts': ['.mjs'],
+        '.cts': ['.cjs'],
+        '.jsx': ['.js'],
+    };
+    const extensionMatch = relativePath.match(/(\.[^./\\]+)$/);
+    const extension = extensionMatch?.[1]?.toLowerCase();
+    if (!extension) {
+        return [];
+    }
+    const pathWithoutExtension = relativePath.slice(0, -extension.length);
+    const extensionTargets = extensionFallbacks[extension] ?? [];
+    for (const fallbackExtension of extensionTargets) {
+        fallbackTargets.add(`${pathWithoutExtension}${fallbackExtension}`);
+    }
+    if (relativePath.startsWith('src/')) {
+        const distPathWithoutPrefix = relativePath.slice('src/'.length);
+        for (const fallbackExtension of extensionTargets) {
+            fallbackTargets.add(`dist/${distPathWithoutPrefix.slice(0, -extension.length)}${fallbackExtension}`);
+        }
+    }
+    return Array.from(fallbackTargets);
+}
+function resolveExportSubpath(filePath, pkg, options) {
     if (!pkg.exports || typeof pkg.exports !== 'object') {
         return '';
     }
-    // Get the relative path from package root to the file
-    const normalizedFilePath = filePath.replace(/\\/g, '/');
-    const normalizedPkgDir = pkg.dir.replace(/\\/g, '/');
-    const relativePath = normalizedFilePath.startsWith(normalizedPkgDir + '/')
-        ? './' + normalizedFilePath.substring(normalizedPkgDir.length + 1)
-        : null;
+    const relativePath = toPackageRelativePath(filePath, pkg);
     if (!relativePath) {
         return '';
     }
+    const comparableTargets = new Set([`./${relativePath}`]);
+    if (options?.allowSourceFallback) {
+        for (const fallbackTarget of getSourceFallbackExportTargets(relativePath)) {
+            comparableTargets.add(`./${fallbackTarget}`);
+        }
+    }
     // Search through exports to find a matching subpath
     for (const [subpath, target] of Object.entries(pkg.exports)) {
         const resolvedTarget = resolveExportTarget(target);
         if (resolvedTarget &&
-            normalizeExportPath(resolvedTarget) === relativePath) {
+            comparableTargets.has(normalizeExportPath(resolvedTarget))) {
             // Found a match - return the subpath without the leading "."
             // e.g., "./internal/builtins" -> "/internal/builtins"
             return subpath === '.' ? '' : subpath.substring(1);
@@ -255,7 +291,9 @@ export function resolveModuleSpecifier(filePath, projectRoot) {
         return { moduleSpecifier: undefined };
     }
     // Resolve the export subpath (e.g., "/internal/builtins" for "workflow/internal/builtins")
-    const subpath = resolveExportSubpath(filePath, pkg);
+    const subpath = resolveExportSubpath(filePath, pkg, {
+        allowSourceFallback: true,
+    });
     // Return the module specifier as "name/subpath@version" or "name@version"
     const specifier = subpath
         ? `${pkg.name}${subpath}@${pkg.version}`