@chainlink/cre-sdk 1.5.0-alpha.1 → 1.5.0-alpha.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@chainlink/cre-sdk",
-	"version": "1.5.0-alpha.1",
+	"version": "v1.5.0-alpha.2",
 	"type": "module",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -47,7 +47,7 @@
 		"compile:workflow": "bun scripts/run.ts compile-workflow",
 		"fix-imports": "bun scripts/run.ts fix-imports",
 		"format": "biome format --write ${BIOME_PATHS:-.}",
-		"full-checks": "bun generate:sdk && bun run build && bun typecheck && bun check && bun test && bun test:standard",
+		"full-checks": "bun generate:sdk && bun build && bun typecheck && bun check && bun test && bun test:standard",
 		"generate:chain-selectors": "bun scripts/run.ts generate-chain-selectors && BIOME_PATHS=\"src/generated\" bun check",
 		"generate:proto": "bunx @bufbuild/buf generate && BIOME_PATHS=\"src/generated\" bun check",
 		"generate:sdk": "bun generate:proto && bun generate:chain-selectors && bun scripts/run generate-sdks && BIOME_PATHS=\"src/generated src/generated-sdk src/sdk/test/generated\" bun check",
@@ -60,7 +60,7 @@
 	"dependencies": {
 		"@bufbuild/protobuf": "2.6.3",
 		"@bufbuild/protoc-gen-es": "2.6.3",
-		"@chainlink/cre-sdk-javy-plugin": "1.5.0-alpha.1",
+		"@chainlink/cre-sdk-javy-plugin": "v1.5.0-alpha.2",
 		"@standard-schema/spec": "1.0.0",
 		"viem": "2.34.0",
 		"zod": "3.25.76"
@@ -69,7 +69,7 @@
 		"@biomejs/biome": "2.3.14",
 		"@bufbuild/buf": "1.56.0",
 		"@types/bun": "1.3.8",
-		"chain-selectors": "https://github.com/smartcontractkit/chain-selectors.git#a86ae261a09f805ea37165f58b017b4538e2e3bb",
+		"chain-selectors": "https://github.com/smartcontractkit/chain-selectors.git#8b963095ae797a3024c8e55822cced7bf618176f",
 		"fast-glob": "3.3.3",
 		"ts-proto": "2.7.5",
 		"typescript": "5.9.3",

package/scripts/run.ts

@@ -1,7 +1,5 @@
 #!/usr/bin/env bun
 
-import { WorkflowRuntimeCompatibilityError } from './src/validate-workflow-runtime-compat'
-
 const availableScripts = [
 	'build-types',
 	'compile-to-js',
@@ -39,11 +37,7 @@ const main = async () => {
 			process.exit(1)
 		}
 	} catch (error) {
-		if (error instanceof WorkflowRuntimeCompatibilityError) {
-			console.error(`\n❌ ${error.message}`)
-		} else {
-			console.error(`Failed to run script ${scriptName}:`, error)
-		}
+		console.error(`Failed to load script ${scriptName}:`, error)
 		process.exit(1)
 	}
 }

package/scripts/src/build-types.ts

@@ -1,5 +1,5 @@
 import { glob } from 'fast-glob'
-import { copyFile, mkdir, readFile, writeFile } from 'fs/promises'
+import { copyFile, mkdir } from 'fs/promises'
 import { join } from 'path'
 
 const buildTypes = async () => {
@@ -28,36 +28,6 @@ const buildTypes = async () => {
 	}
 
 	console.log(`✅ Copied ${typeFiles.length} type definition file(s) to dist/sdk/types`)
-
-	// Prepend triple-slash references to dist/index.d.ts so consumers pick up
-	// global type augmentations (e.g. restricted-apis.d.ts) automatically.
-	// tsc strips these from the emitted .d.ts, so we add them back here.
-	const indexDts = join(packageRoot, 'dist/index.d.ts')
-	const sourceIndex = join(packageRoot, 'src/index.ts')
-	const sourceContent = await readFile(sourceIndex, 'utf-8')
-
-	const refsFromSource = sourceContent
-		.split('\n')
-		.filter((line) => line.startsWith('/// <reference types='))
-
-	// Add references for consumer-only type declarations that cannot be in src/index.ts
-	// because they would break the SDK's own scripts/tests (which legitimately use Node.js APIs).
-	const consumerOnlyRefs = ['/// <reference types="./sdk/types/restricted-node-modules" />']
-
-	const tripleSlashRefs = [...refsFromSource, ...consumerOnlyRefs].join('\n')
-
-	if (tripleSlashRefs) {
-		const indexContent = await readFile(indexDts, 'utf-8')
-		// Strip any existing triple-slash references from the top of the file
-		// so that re-running build-types is idempotent.
-		const withoutExistingRefs = indexContent
-			.split('\n')
-			.filter((line) => !line.trim().startsWith('/// <reference types='))
-			.join('\n')
-			.replace(/^\n+/, '') // trim leading blank lines left after stripping
-		await writeFile(indexDts, `${tripleSlashRefs}\n${withoutExistingRefs}`)
-		console.log('✅ Added triple-slash references to dist/index.d.ts')
-	}
 }
 
 export const main = buildTypes

package/scripts/src/compile-to-js.ts

@@ -2,7 +2,6 @@ import { existsSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs'
 import { mkdir } from 'node:fs/promises'
 import path from 'node:path'
 import { $ } from 'bun'
-import { assertWorkflowRuntimeCompatibility } from './validate-workflow-runtime-compat'
 import { wrapWorkflowCode } from './workflow-wrapper'
 
 export const main = async (tsFilePath?: string, outputFilePath?: string) => {
@@ -20,7 +19,6 @@ export const main = async (tsFilePath?: string, outputFilePath?: string) => {
 	}
 
 	const resolvedInput = path.resolve(inputPath)
-	assertWorkflowRuntimeCompatibility(resolvedInput)
 	console.info(`📁 Using input file: ${resolvedInput}`)
 
 	// If no explicit output path → same dir, swap extension to .js
@@ -56,13 +54,16 @@ export const main = async (tsFilePath?: string, outputFilePath?: string) => {
 			naming: path.basename(resolvedOutput),
 		})
 
-		if (!existsSync(resolvedOutput)) {
-			console.error(`❌ Expected file not found: ${resolvedOutput}`)
+		// The file Bun will emit before bundling
+		const builtFile = path.join(path.dirname(resolvedOutput), path.basename(resolvedOutput))
+
+		if (!existsSync(builtFile)) {
+			console.error(`❌ Expected file not found: ${builtFile}`)
 			process.exit(1)
 		}
 
 		// Bundle into the final file (overwrite)
-		await $`bun build ${resolvedOutput} --bundle --outfile=${resolvedOutput}`
+		await $`bun build ${builtFile} --bundle --outfile=${resolvedOutput}`
 
 		console.info(`✅ Built: ${resolvedOutput}`)
 		return resolvedOutput

package/scripts/src/compile-to-wasm.ts

@@ -1,38 +1,34 @@
-import { spawn } from 'node:child_process'
 import { existsSync } from 'node:fs'
 import { mkdir } from 'node:fs/promises'
 import path from 'node:path'
-
-function runBun(args: string[]): Promise<void> {
-	return new Promise((resolve, reject) => {
-		const child = spawn('bun', args, {
-			stdio: 'inherit',
-			env: process.env,
-		})
-		child.on('error', reject)
-		child.on('exit', (code) => {
-			if (code === 0) resolve()
-			else reject(new Error(`bun exited with code ${code ?? 'unknown'}`))
-		})
-	})
-}
+import { $ } from 'bun'
+import { parseCompileFlags } from '../../../cre-sdk-javy-plugin/scripts/parse-compile-flags'
 
 const isJsFile = (p: string) => ['.js', '.mjs', '.cjs'].includes(path.extname(p).toLowerCase())
 
-export const main = async (inputFile?: string, outputFile?: string) => {
+export const main = async (
+	inputFile?: string,
+	outputFile?: string,
+	creExportsPaths?: string[],
+	pluginPath?: string | null,
+) => {
 	const cliArgs = process.argv.slice(3)
+	const { creExports: cliCreExports, plugin: cliPlugin, rest: cliRest } = parseCompileFlags(cliArgs)
 
-	// Resolve input/output from params or CLI
-	const inputPath = inputFile ?? cliArgs[0]
-	const outputPathArg = outputFile ?? cliArgs[1]
+	const inputPath = inputFile ?? cliRest[0]
+	const outputPathArg = outputFile ?? cliRest[1]
+	const creExports = creExportsPaths ?? cliCreExports
+	const plugin = pluginPath !== undefined ? pluginPath : cliPlugin
+
+	if (plugin !== null && plugin !== undefined && creExports.length > 0) {
+		console.error('❌ Error: --plugin and --cre-exports are mutually exclusive.')
+		process.exit(1)
+	}
 
 	if (!inputPath) {
 		console.error(
 			'Usage: bun compile:js-to-wasm <path/to/input.(js|mjs|cjs)> [path/to/output.wasm]',
 		)
-		console.error('Examples:')
-		console.error('  bun compile:js-to-wasm ./build/workflows/test.js')
-		console.error('  bun compile:js-to-wasm ./build/workflows/test.mjs ./artifacts/test.wasm')
 		process.exit(1)
 	}
 
@@ -47,31 +43,34 @@ export const main = async (inputFile?: string, outputFile?: string) => {
 		process.exit(1)
 	}
 
-	// Default output = same dir, same basename, .wasm extension
 	const defaultOut = path.join(
 		path.dirname(resolvedInput),
 		path.basename(resolvedInput).replace(/\.(m|c)?js$/i, '.wasm'),
 	)
 	const resolvedOutput = outputPathArg ? path.resolve(outputPathArg) : defaultOut
 
-	// Ensure output directory exists
 	await mkdir(path.dirname(resolvedOutput), { recursive: true })
 
-	console.info(`🔨 Compiling to WASM`)
+	console.info('🔨 Compiling to WASM')
 	console.info(`📁 Input:  ${resolvedInput}`)
 	console.info(`🎯 Output: ${resolvedOutput}`)
 
-	// Prefer the sibling @chainlink/cre-sdk-javy-plugin install (same as monorepo layout).
-	// Bun's shell `$` template can throw EINVAL on some Linux/arm64 Docker setups; use spawn.
-	const scriptDir = import.meta.dir
-	const compilerPath = path.resolve(
-		scriptDir,
-		'../../../cre-sdk-javy-plugin/bin/compile-workflow.ts',
-	)
-	if (existsSync(compilerPath)) {
-		await runBun(['--bun', compilerPath, resolvedInput, resolvedOutput])
+	const compileArgs: string[] = []
+	if (plugin != null && plugin !== '') {
+		compileArgs.push('--plugin', path.resolve(plugin))
 	} else {
-		await runBun(['x', 'cre-compile-workflow', resolvedInput, resolvedOutput])
+		compileArgs.push(...creExports.flatMap((p) => ['--cre-exports', path.resolve(p)]))
+	}
+	compileArgs.push(resolvedInput, resolvedOutput)
+	try {
+		await $`bun cre-compile-workflow ${compileArgs}`
+	} catch {
+		const scriptDir = import.meta.dir
+		const compilerPath = path.resolve(
+			scriptDir,
+			'../../../cre-sdk-javy-plugin/bin/compile-workflow.ts',
+		)
+		await $`bun --bun ${compilerPath} ${compileArgs}`
 	}
 
 	console.info(`✅ Compiled: ${resolvedOutput}`)

package/scripts/src/compile-workflow.ts

@@ -1,23 +1,31 @@
 import { existsSync } from 'node:fs'
 import { mkdir } from 'node:fs/promises'
 import path from 'node:path'
+import { parseCompileFlags } from '../../../cre-sdk-javy-plugin/scripts/parse-compile-flags'
 import { main as compileToJs } from './compile-to-js'
 import { main as compileToWasm } from './compile-to-wasm'
 
-export const main = async (inputFile?: string, outputWasmFile?: string) => {
+export const main = async (
+	inputFile?: string,
+	outputWasmFile?: string,
+	creExportsPaths?: string[],
+	pluginPath?: string | null,
+) => {
 	const cliArgs = process.argv.slice(3)
+	const { creExports: cliCreExports, plugin: cliPlugin, rest: cliRest } = parseCompileFlags(cliArgs)
 
-	// Resolve input/output from params or CLI
-	const inputPath = inputFile ?? cliArgs[0]
-	const outputPathArg = outputWasmFile ?? cliArgs[1]
+	const inputPath = inputFile ?? cliRest[0]
+	const outputPathArg = outputWasmFile ?? cliRest[1]
+	const creExports = creExportsPaths ?? cliCreExports
+	const plugin = pluginPath !== undefined ? pluginPath : cliPlugin
+
+	if (plugin != null && plugin !== '' && creExports.length > 0) {
+		console.error('❌ Error: --plugin and --cre-exports are mutually exclusive.')
+		process.exit(1)
+	}
 
 	if (!inputPath) {
 		console.error('Usage: bun compile:workflow <path/to/workflow.ts> [path/to/output.wasm]')
-		console.error('Examples:')
-		console.error('  bun compile:workflow src/standard_tests/secrets/test.ts')
-		console.error(
-			'  bun compile:workflow src/standard_tests/secrets/test.ts .temp/standard_tests/secrets/test.wasm',
-		)
 		process.exit(1)
 	}
 
@@ -27,30 +35,33 @@ export const main = async (inputFile?: string, outputWasmFile?: string) => {
 		process.exit(1)
 	}
 
-	// Default final output = same dir, same basename, .wasm
 	const defaultWasmOut = path.join(
 		path.dirname(resolvedInput),
 		path.basename(resolvedInput).replace(/\.[^.]+$/, '.wasm'),
 	)
 	const resolvedWasmOutput = outputPathArg ? path.resolve(outputPathArg) : defaultWasmOut
-
-	// Put the intermediate JS next to the final wasm (so custom outputs stay together)
 	const resolvedJsOutput = resolvedWasmOutput.replace(/\.wasm$/i, '.js')
 
-	// Ensure directories exist (handles both intermediate JS dir and wasm dir)
 	await mkdir(path.dirname(resolvedJsOutput), { recursive: true })
 
-	console.info(`🚀 Compiling workflow`)
-	console.info(`📁 Input:   ${resolvedInput}\n`)
+	console.info('🚀 Compiling workflow')
+	console.info(`📁 Input:   ${resolvedInput}`)
+	console.info(`🧪 JS out:  ${resolvedJsOutput}`)
+	console.info(`🎯 WASM out:${resolvedWasmOutput}\n`)
 
-	// Step 1: TS/JS → JS (bundled)
 	console.info('📦 Step 1: Compiling JS...')
 	await compileToJs(resolvedInput, resolvedJsOutput)
 
-	// Step 2: JS → WASM
 	console.info('\n🔨 Step 2: Compiling to WASM...')
-	await compileToWasm(resolvedJsOutput, resolvedWasmOutput)
+	await compileToWasm(resolvedJsOutput, resolvedWasmOutput, creExports, plugin)
 
 	console.info(`\n✅ Workflow built: ${resolvedWasmOutput}`)
 	return resolvedWasmOutput
 }
+
+if (import.meta.main) {
+	main().catch((e) => {
+		console.error(e)
+		process.exit(1)
+	})
+}