@workflow/next 4.0.1-beta.50 → 4.0.1-beta.52

package/dist/step-copy-utils.d.ts

@@ -0,0 +1,19 @@
+export declare const DEFERRED_STEP_COPY_DIR_NAME = "__workflow_step_files__";
+export declare const DEFERRED_STEP_SOURCE_METADATA_PREFIX = "WORKFLOW_STEP_SOURCE_B64:";
+export interface DeferredStepSourceMetadata {
+    relativeFilename: string;
+    absolutePath: string;
+}
+export declare function isDeferredStepCopyFilePath(filePath: string): boolean;
+export declare function createDeferredStepSourceMetadataComment(metadata: DeferredStepSourceMetadata): string;
+export declare function createDeferredStepCopyInlineSourceMapComment({ sourcePath, sourceContent, generatedContent, }: {
+    sourcePath: string;
+    sourceContent: string;
+    generatedContent?: string;
+}): string;
+export declare function parseInlineSourceMapComment(source: string): {
+    sourceWithoutMapComment: string;
+    sourceMap: string | null;
+};
+export declare function parseDeferredStepSourceMetadata(source: string): DeferredStepSourceMetadata | null;
+//# sourceMappingURL=step-copy-utils.d.ts.map

package/dist/step-copy-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-copy-utils.d.ts","sourceRoot":"","sources":["../src/step-copy-utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,4BAA4B,CAAC;AACrE,eAAO,MAAM,oCAAoC,8BAA8B,CAAC;AAIhF,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAUD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAKpE;AAED,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,0BAA0B,GACnC,MAAM,CAKR;AAiBD,wBAAgB,4CAA4C,CAAC,EAC3D,UAAU,EACV,aAAa,EACb,gBAAgB,GACjB,EAAE;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAiBT;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG;IAC3D,uBAAuB,EAAE,MAAM,CAAC;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAuBA;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,GACb,0BAA0B,GAAG,IAAI,CA8BnC"}

package/dist/step-copy-utils.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFERRED_STEP_SOURCE_METADATA_PREFIX = exports.DEFERRED_STEP_COPY_DIR_NAME = void 0;
+exports.isDeferredStepCopyFilePath = isDeferredStepCopyFilePath;
+exports.createDeferredStepSourceMetadataComment = createDeferredStepSourceMetadataComment;
+exports.createDeferredStepCopyInlineSourceMapComment = createDeferredStepCopyInlineSourceMapComment;
+exports.parseInlineSourceMapComment = parseInlineSourceMapComment;
+exports.parseDeferredStepSourceMetadata = parseDeferredStepSourceMetadata;
+exports.DEFERRED_STEP_COPY_DIR_NAME = '__workflow_step_files__';
+exports.DEFERRED_STEP_SOURCE_METADATA_PREFIX = 'WORKFLOW_STEP_SOURCE_B64:';
+const INLINE_SOURCE_MAP_PATTERN = /(?:^|\r?\n)\s*\/\/[#@]\s*sourceMappingURL=data:application\/json(?:;charset=[^;,]+)?;base64,([A-Za-z0-9+/=]+)\s*$/;
+function escapeRegExp(input) {
+    return input.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function normalizePath(filePath) {
+    return filePath.replace(/\\/g, '/');
+}
+function isDeferredStepCopyFilePath(filePath) {
+    const normalizedPath = normalizePath(filePath);
+    return normalizedPath.includes(`/.well-known/workflow/v1/step/${exports.DEFERRED_STEP_COPY_DIR_NAME}/`);
+}
+function createDeferredStepSourceMetadataComment(metadata) {
+    const encoded = Buffer.from(JSON.stringify(metadata), 'utf-8').toString('base64');
+    return `// ${exports.DEFERRED_STEP_SOURCE_METADATA_PREFIX}${encoded}`;
+}
+function getLineCount(source) {
+    if (source.length === 0) {
+        return 1;
+    }
+    const lineBreakMatches = source.match(/\r\n|\r|\n/g);
+    return (lineBreakMatches?.length ?? 0) + 1;
+}
+function createIdentityLineMappings(lineCount) {
+    if (lineCount <= 1) {
+        return 'AAAA';
+    }
+    return `AAAA${';AACA'.repeat(lineCount - 1)}`;
+}
+function createDeferredStepCopyInlineSourceMapComment({ sourcePath, sourceContent, generatedContent, }) {
+    const normalizedSourcePath = normalizePath(sourcePath);
+    const sourceMap = {
+        version: 3,
+        file: normalizedSourcePath.split('/').pop() ?? normalizedSourcePath,
+        sources: [normalizedSourcePath],
+        sourcesContent: [sourceContent],
+        names: [],
+        mappings: createIdentityLineMappings(getLineCount(generatedContent ?? sourceContent)),
+    };
+    const encodedSourceMap = Buffer.from(JSON.stringify(sourceMap), 'utf-8').toString('base64');
+    return `//# sourceMappingURL=data:application/json;base64,${encodedSourceMap}`;
+}
+function parseInlineSourceMapComment(source) {
+    const mapMatch = source.match(INLINE_SOURCE_MAP_PATTERN);
+    if (!mapMatch?.[1]) {
+        return {
+            sourceWithoutMapComment: source,
+            sourceMap: null,
+        };
+    }
+    const sourceWithoutMapComment = source.replace(INLINE_SOURCE_MAP_PATTERN, '');
+    try {
+        const decodedMap = Buffer.from(mapMatch[1], 'base64').toString('utf-8');
+        JSON.parse(decodedMap);
+        return {
+            sourceWithoutMapComment,
+            sourceMap: decodedMap,
+        };
+    }
+    catch {
+        return {
+            sourceWithoutMapComment,
+            sourceMap: null,
+        };
+    }
+}
+function parseDeferredStepSourceMetadata(source) {
+    const pattern = new RegExp(`^\\s*//\\s*${escapeRegExp(exports.DEFERRED_STEP_SOURCE_METADATA_PREFIX)}([A-Za-z0-9+/=]+)\\s*$`, 'm');
+    const match = source.match(pattern);
+    const encoded = match?.[1];
+    if (!encoded) {
+        return null;
+    }
+    try {
+        const decoded = Buffer.from(encoded, 'base64').toString('utf-8');
+        const parsed = JSON.parse(decoded);
+        if (typeof parsed.relativeFilename !== 'string' ||
+            parsed.relativeFilename.length === 0 ||
+            typeof parsed.absolutePath !== 'string' ||
+            parsed.absolutePath.length === 0) {
+            return null;
+        }
+        return {
+            relativeFilename: parsed.relativeFilename,
+            absolutePath: normalizePath(parsed.absolutePath),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=step-copy-utils.js.map

package/dist/step-copy-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-copy-utils.js","sourceRoot":"","sources":["../src/step-copy-utils.ts"],"names":[],"mappings":"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"}

package/docs/api-reference/index.mdx

@@ -1,6 +1,10 @@
 ---
 title: "workflow/next"
 description: Next.js integration for automatic bundling and runtime configuration.
+type: overview
+summary: Explore the Next.js integration for automatic workflow bundling and runtime support.
+related:
+  - /docs/getting-started/next
 ---
 
 Next.js integration for Workflow DevKit that automatically configures bundling and runtime support.

package/docs/api-reference/with-workflow.mdx

@@ -1,6 +1,10 @@
 ---
 title: withWorkflow
 description: Configure webpack/turbopack to transform workflow directives in Next.js.
+type: reference
+summary: Wrap your Next.js config with withWorkflow to enable workflow directive transformation.
+prerequisites:
+  - /docs/getting-started/next
 ---
 
 Configures webpack/turbopack loaders to transform workflow code (`"use step"`/`"use workflow"` directives)

package/docs/next.mdx

@@ -1,6 +1,13 @@
 ---
 title: Next.js
 description: This guide will walk through setting up your first workflow in a Next.js app. Along the way, you'll learn more about the concepts that are fundamental to using the development kit in your own projects.
+type: guide
+summary: Set up Workflow DevKit in a Next.js app.
+prerequisites:
+  - /docs/getting-started
+related:
+  - /docs/api-reference/workflow-next
+  - /docs/deploying/world/vercel-world
 ---
 
 <Steps>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workflow/next",
-  "version": "4.0.1-beta.50",
+  "version": "4.0.1-beta.52",
   "description": "Next.js integration for Workflow DevKit",
   "type": "commonjs",
   "main": "dist/index.js",
@@ -29,9 +29,9 @@
     "@swc/core": "1.15.3",
     "semver": "7.7.3",
     "watchpack": "2.4.4",
-    "@workflow/builders": "4.0.1-beta.45",
-    "@workflow/core": "4.1.0-beta.54",
-    "@workflow/swc-plugin": "4.1.0-beta.17"
+    "@workflow/builders": "4.0.1-beta.47",
+    "@workflow/core": "4.1.0-beta.56",
+    "@workflow/swc-plugin": "4.1.0-beta.18"
   },
   "devDependencies": {
     "@types/node": "22.19.0",

package/dist/swc-cache.d.ts

@@ -1,8 +0,0 @@
-/**
- * Checks if the SWC plugin build has changed and invalidates the Next.js cache if needed.
- * Also registers an exit handler to write the current build hash for future comparisons.
- *
- * @param distDir - The Next.js dist directory (e.g., '.next')
- */
-export declare function maybeInvalidateCacheOnSwcChange(distDir: string): void;
-//# sourceMappingURL=swc-cache.d.ts.map

package/dist/swc-cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"swc-cache.d.ts","sourceRoot":"","sources":["../src/swc-cache.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAyCrE"}

package/dist/swc-cache.js

@@ -1,53 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.maybeInvalidateCacheOnSwcChange = maybeInvalidateCacheOnSwcChange;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-/**
- * Checks if the SWC plugin build has changed and invalidates the Next.js cache if needed.
- * Also registers an exit handler to write the current build hash for future comparisons.
- *
- * @param distDir - The Next.js dist directory (e.g., '.next')
- */
-function maybeInvalidateCacheOnSwcChange(distDir) {
-    const cacheDir = path_1.default.join(distDir, 'cache');
-    const devCacheDir = path_1.default.join(distDir, 'dev', 'cache');
-    const workflowJsonPath = path_1.default.join(cacheDir, 'workflow.json');
-    const swcPluginBuildHash = require('@workflow/swc-plugin/build-hash.json')
-        .buildHash;
-    let shouldInvalidateCache = false;
-    try {
-        const existing = JSON.parse(fs_1.default.readFileSync(workflowJsonPath, 'utf-8'));
-        if (existing.swcPluginBuildHash !== swcPluginBuildHash) {
-            shouldInvalidateCache = true;
-        }
-    }
-    catch {
-        // File doesn't exist or is invalid
-        shouldInvalidateCache = true;
-    }
-    if (shouldInvalidateCache) {
-        console.log('workflow transform upgraded, invalidating Next.js cache');
-        // Delete cache directories
-        const cacheDirs = [cacheDir, devCacheDir];
-        for (const dir of cacheDirs) {
-            if (fs_1.default.existsSync(dir)) {
-                fs_1.default.rmSync(dir, { recursive: true, force: true });
-            }
-        }
-    }
-    // Write workflow.json lazily on process exit
-    process.on('exit', () => {
-        try {
-            fs_1.default.mkdirSync(cacheDir, { recursive: true });
-            fs_1.default.writeFileSync(workflowJsonPath, JSON.stringify({ swcPluginBuildHash }, null, 2));
-        }
-        catch {
-            // Ignore errors on exit
-        }
-    });
-}
-//# sourceMappingURL=swc-cache.js.map

package/dist/swc-cache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"swc-cache.js","sourceRoot":"","sources":["../src/swc-cache.ts"],"names":[],"mappings":";;;;;AASA,0EAyCC;AAlDD,4CAAoB;AACpB,gDAAwB;AAExB;;;;;GAKG;AACH,SAAgB,+BAA+B,CAAC,OAAe;IAC7D,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,gBAAgB,GAAG,cAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC9D,MAAM,kBAAkB,GAAG,OAAO,CAAC,sCAAsC,CAAC;SACvE,SAAmB,CAAC;IAEvB,IAAI,qBAAqB,GAAG,KAAK,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC;QACxE,IAAI,QAAQ,CAAC,kBAAkB,KAAK,kBAAkB,EAAE,CAAC;YACvD,qBAAqB,GAAG,IAAI,CAAC;QAC/B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;QACnC,qBAAqB,GAAG,IAAI,CAAC;IAC/B,CAAC;IAED,IAAI,qBAAqB,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;QACvE,2BAA2B;QAC3B,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC1C,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,IAAI,YAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,YAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAED,6CAA6C;IAC7C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACtB,IAAI,CAAC;YACH,YAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,YAAE,CAAC,aAAa,CACd,gBAAgB,EAChB,IAAI,CAAC,SAAS,CAAC,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAChD,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}