import fs from "node:fs"; import { createRequire } from "node:module"; import path from "node:path"; import { fileURLToPath } from "node:url"; import vm from "node:vm"; import { describe, expect, it } from "vitest"; const require = createRequire(import.meta.url); const rootSdk = require("./root-alias.cjs") as Record; const rootAliasPath = fileURLToPath(new URL("./root-alias.cjs", import.meta.url)); const rootAliasSource = fs.readFileSync(rootAliasPath, "utf-8"); type EmptySchema = { safeParse: (value: unknown) => | { success: true; data?: unknown } | { success: false; error: { issues: Array<{ path: Array; message: string }> }; }; }; function loadRootAliasWithStubs(options?: { distExists?: boolean; monolithicExports?: Record; }) { let createJitiCalls = 0; let jitiLoadCalls = 0; const loadedSpecifiers: string[] = []; const monolithicExports = options?.monolithicExports ?? { slowHelper: () => "loaded", }; const wrapper = vm.runInNewContext( `(function (exports, require, module, __filename, __dirname) {${rootAliasSource}\n})`, {}, { filename: rootAliasPath }, ) as ( exports: Record, require: NodeJS.Require, module: { exports: Record }, __filename: string, __dirname: string, ) => void; const module = { exports: {} as Record }; const localRequire = ((id: string) => { if (id === "node:path") { return path; } if (id === "node:fs") { return { existsSync: () => options?.distExists ?? false, }; } if (id === "jiti") { return { createJiti() { createJitiCalls += 1; return (specifier: string) => { jitiLoadCalls += 1; loadedSpecifiers.push(specifier); return monolithicExports; }; }, }; } throw new Error(`unexpected require: ${id}`); }) as NodeJS.Require; wrapper(module.exports, localRequire, module, rootAliasPath, path.dirname(rootAliasPath)); return { moduleExports: module.exports, get createJitiCalls() { return createJitiCalls; }, get jitiLoadCalls() { return jitiLoadCalls; }, loadedSpecifiers, }; } describe("plugin-sdk root alias", () => { it("exposes the fast empty config schema helper", () => { const factory = rootSdk.emptyPluginConfigSchema as (() => EmptySchema) | undefined; expect(typeof factory).toBe("function"); if (!factory) { return; } const schema = factory(); expect(schema.safeParse(undefined)).toEqual({ success: true, data: undefined }); expect(schema.safeParse({})).toEqual({ success: true, data: {} }); const parsed = schema.safeParse({ invalid: true }); expect(parsed.success).toBe(false); }); it("does not load the monolithic sdk for fast helpers", () => { const lazyModule = loadRootAliasWithStubs(); const lazyRootSdk = lazyModule.moduleExports; const factory = lazyRootSdk.emptyPluginConfigSchema as (() => EmptySchema) | undefined; expect(lazyModule.createJitiCalls).toBe(0); expect(lazyModule.jitiLoadCalls).toBe(0); expect(typeof factory).toBe("function"); expect(factory?.().safeParse({})).toEqual({ success: true, data: {} }); expect(lazyModule.createJitiCalls).toBe(0); expect(lazyModule.jitiLoadCalls).toBe(0); }); it("loads legacy root exports on demand and preserves reflection", () => { const lazyModule = loadRootAliasWithStubs({ monolithicExports: { slowHelper: () => "loaded", }, }); const lazyRootSdk = lazyModule.moduleExports; expect(lazyModule.createJitiCalls).toBe(0); expect("slowHelper" in lazyRootSdk).toBe(true); expect(lazyModule.createJitiCalls).toBe(1); expect(lazyModule.jitiLoadCalls).toBe(1); expect((lazyRootSdk.slowHelper as () => string)()).toBe("loaded"); expect(Object.keys(lazyRootSdk)).toContain("slowHelper"); expect(Object.getOwnPropertyDescriptor(lazyRootSdk, "slowHelper")).toBeDefined(); }); it("loads legacy root exports through the merged root wrapper", { timeout: 240_000 }, () => { expect(typeof rootSdk.resolveControlCommandGate).toBe("function"); expect(typeof rootSdk.default).toBe("object"); expect(rootSdk.default).toBe(rootSdk); expect(rootSdk.__esModule).toBe(true); }); it("preserves reflection semantics for lazily resolved exports", { timeout: 240_000 }, () => { expect("resolveControlCommandGate" in rootSdk).toBe(true); const keys = Object.keys(rootSdk); expect(keys).toContain("resolveControlCommandGate"); const descriptor = Object.getOwnPropertyDescriptor(rootSdk, "resolveControlCommandGate"); expect(descriptor).toBeDefined(); }); });