@apifuse/provider-sdk 2.1.0-beta.18 → 2.1.0-beta.19

package/dist/cli/create.js

@@ -3,7 +3,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { cancel, intro, isCancel, note, outro, select, text, } from "@clack/prompts";
+import { cancel, intro, isCancel, note, outro, select, text } from "@clack/prompts";
 import { z } from "zod";
 import packageJson from "../../package.json";
 export const PROVIDER_NAME_REGEX = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
@@ -17,12 +17,7 @@ export const CATEGORY_OPTIONS = [
     "communication",
     "other",
 ];
-export const AUTH_MODE_OPTIONS = [
-    "none",
-    "platform-managed",
-    "credentials",
-    "oauth2",
-];
+export const AUTH_MODE_OPTIONS = ["none", "platform-managed", "credentials", "oauth2"];
 export const RUNTIME_OPTIONS = ["standard", "browser"];
 export const PRESET_OPTIONS = ["standalone", "monorepo"];
 const CREATE_CONFIG_SCHEMA = z.object({
@@ -64,9 +59,7 @@ export async function main() {
         return;
     }
     const parsed = parseArgs(normalizedArgs);
-    const config = parsed.configPath
-        ? await loadConfig(parsed.configPath)
-        : undefined;
+    const config = parsed.configPath ? await loadConfig(parsed.configPath) : undefined;
     const resolved = await resolveCreateOptions(parsed, config, process.cwd());
     const plan = await buildProviderCreatePlan(resolved, process.cwd());
     if (resolved.dryRun) {
@@ -174,9 +167,7 @@ async function resolveCreateOptions(parsed, config, cwd) {
         category: parsed.category ?? config?.category,
         authMode: parsed.authMode ?? config?.authMode,
         runtime: parsed.runtime ?? config?.runtime,
-        sdkSpecifier: parsed.sdkSpecifier ??
-            config?.sdkSpecifier ??
-            process.env.APIFUSE__SDK__SPECIFIER,
+        sdkSpecifier: parsed.sdkSpecifier ?? config?.sdkSpecifier ?? process.env.APIFUSE__SDK__SPECIFIER,
         dryRun: parsed.dryRun,
         json: parsed.json,
         yes: parsed.yes,
@@ -267,9 +258,7 @@ async function promptValue(prompt) {
     return result;
 }
 export async function buildProviderCreatePlan(options, cwd) {
-    const resolvedWorkspaceRoot = options.preset === "monorepo"
-        ? findApifuseInternalWorkspaceRoot(cwd)
-        : undefined;
+    const resolvedWorkspaceRoot = options.preset === "monorepo" ? findApifuseInternalWorkspaceRoot(cwd) : undefined;
     if (options.preset === "monorepo" && !resolvedWorkspaceRoot) {
         throw new Error("Monorepo preset is internal to the APIFuse repository. External bounty workspaces are one-provider repositories; use the standalone default create flow.");
     }
@@ -278,9 +267,7 @@ export async function buildProviderCreatePlan(options, cwd) {
     if (options.outputDir) {
         providerRoot = resolve(cwd, options.outputDir);
         installCwd =
-            options.preset === "monorepo" && resolvedWorkspaceRoot
-                ? resolvedWorkspaceRoot
-                : providerRoot;
+            options.preset === "monorepo" && resolvedWorkspaceRoot ? resolvedWorkspaceRoot : providerRoot;
     }
     else if (options.preset === "monorepo" && resolvedWorkspaceRoot) {
         providerRoot = resolve(resolvedWorkspaceRoot, "providers", options.name);
@@ -293,8 +280,7 @@ export async function buildProviderCreatePlan(options, cwd) {
     if (existsSync(providerRoot)) {
         throw new Error(`Target directory already exists: ${providerRoot}`);
     }
-    if (options.sdkSpecifier?.startsWith("workspace:") &&
-        !resolvedWorkspaceRoot) {
+    if (options.sdkSpecifier?.startsWith("workspace:") && !resolvedWorkspaceRoot) {
         throw new Error("workspace:* is only valid inside the APIFuse monorepo because public Provider SDK scaffolds must install from npm or an explicit tarball/file specifier.");
     }
     const sdkSpecifier = options.sdkSpecifier ??
@@ -434,7 +420,7 @@ export async function buildProviderCreatePlan(options, cwd) {
         validationCommands: [
             "bun run check",
             "bun run type-check",
-            "bun run submit-check",
+            "bun run submit-check -- --smoke",
             "bun run test",
         ],
         workspaceRoot: resolvedWorkspaceRoot,
@@ -715,9 +701,7 @@ async function runCommand(command, cwd, jsonMode) {
                 resolvePromise();
                 return;
             }
-            rejectPromise(new Error(`Command failed (${command}) in ${cwd}${stdout || stderr
-                ? `\n${[stdout, stderr].filter(Boolean).join("\n")}`
-                : ""}`));
+            rejectPromise(new Error(`Command failed (${command}) in ${cwd}${stdout || stderr ? `\n${[stdout, stderr].filter(Boolean).join("\n")}` : ""}`));
         });
     });
 }
@@ -751,7 +735,7 @@ function printResult(plan, jsonMode, dryRun) {
         console.log(`Validation: (cd ${plan.providerRoot} && ${command})`);
     }
     console.log(`Next local dev: ${plan.nextDevCommand}`);
-    console.log("Submission evidence: run `bun run submit-check`, save the generated report, and note `/health` plus `POST /v1/{operation}` smoke results.");
+    console.log("Submission evidence: run `bun run submit-check -- --smoke` to archive measured `/health` and `POST /v1/{operation}` results.");
     if (plan.files.some((file) => file.content.includes('runtime: "browser"'))) {
         console.log("Browser runtime: run `bunx playwright install chromium` locally or set `APIFUSE__CDP_POOL__URL` before browser-backed smoke tests.");
     }

package/dist/cli/templates/provider/README.md.tpl

@@ -8,7 +8,7 @@ Generated with `apifuse create`.
 bun run dev
 bun run check
 bun run test
-bun run submit-check
+bun run submit-check -- --smoke
 bunx apifuse perf . --operation <operation-id> --runs 3
 ```
 
@@ -35,15 +35,17 @@ review when `index.ts` remains a short composition root.
 Before posting bounty evidence, run:
 
 ```bash
-bun run submit-check
+bun run submit-check -- --smoke
 ```
 
 This writes `submission-report.md` with a review-readiness score, blockers,
 warnings, health coverage notes, fixture/schema evidence, and remediation. A
 score is not a payout guarantee; blockers must be fixed before maintainer
 review. The generated `ping` starter intentionally warns until you replace it
-with real upstream-backed Operations. The full public-only checklist is shipped
-in `node_modules/@apifuse/provider-sdk/SUBMISSION.md`.
+with real upstream-backed Operations. `APIFUSE__PROVIDER__*` env vars enable
+live upstream calls; without them, structured provider errors can still verify
+runtime routing. The full public-only checklist is shipped in
+`node_modules/@apifuse/provider-sdk/SUBMISSION.md`.
 
 
 ## Operation guide

package/package.json

@@ -1,5 +1,5 @@
 {
-	"version": "2.1.0-beta.18",
+	"version": "2.1.0-beta.19",
 	"name": "@apifuse/provider-sdk",
 	"private": false,
 	"type": "module",

package/src/cli/create.ts

@@ -4,15 +4,7 @@ import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
-import {
-	cancel,
-	intro,
-	isCancel,
-	note,
-	outro,
-	select,
-	text,
-} from "@clack/prompts";
+import { cancel, intro, isCancel, note, outro, select, text } from "@clack/prompts";
 import { z } from "zod";
 
 import packageJson from "../../package.json";
@@ -28,12 +20,7 @@ export const CATEGORY_OPTIONS = [
 	"communication",
 	"other",
 ] as const;
-export const AUTH_MODE_OPTIONS = [
-	"none",
-	"platform-managed",
-	"credentials",
-	"oauth2",
-] as const;
+export const AUTH_MODE_OPTIONS = ["none", "platform-managed", "credentials", "oauth2"] as const;
 export const RUNTIME_OPTIONS = ["standard", "browser"] as const;
 export const PRESET_OPTIONS = ["standalone", "monorepo"] as const;
 
@@ -95,9 +82,7 @@ export type ProviderCreatePlan = {
 	workspaceRoot?: string;
 };
 
-const TEMPLATE_DIR = fileURLToPath(
-	new URL("./templates/provider/", import.meta.url),
-);
+const TEMPLATE_DIR = fileURLToPath(new URL("./templates/provider/", import.meta.url));
 const HELP_TEXT = `Usage: apifuse create <provider-name> [options]
 Examples:
   apifuse create my-provider
@@ -126,9 +111,7 @@ export async function main() {
 	}
 
 	const parsed = parseArgs(normalizedArgs);
-	const config = parsed.configPath
-		? await loadConfig(parsed.configPath)
-		: undefined;
+	const config = parsed.configPath ? await loadConfig(parsed.configPath) : undefined;
 	const resolved = await resolveCreateOptions(parsed, config, process.cwd());
 	const plan = await buildProviderCreatePlan(resolved, process.cwd());
 
@@ -195,18 +178,10 @@ function parseArgs(argv: string[]): ParsedArgs {
 				parsed.displayName = ensureValue(flag, consumeValue());
 				break;
 			case "--category":
-				parsed.category = parseEnum(
-					"category",
-					consumeValue(),
-					CATEGORY_OPTIONS,
-				);
+				parsed.category = parseEnum("category", consumeValue(), CATEGORY_OPTIONS);
 				break;
 			case "--auth-mode":
-				parsed.authMode = parseEnum(
-					"auth mode",
-					consumeValue(),
-					AUTH_MODE_OPTIONS,
-				);
+				parsed.authMode = parseEnum("auth mode", consumeValue(), AUTH_MODE_OPTIONS);
 				break;
 			case "--runtime":
 				parsed.runtime = parseEnum("runtime", consumeValue(), RUNTIME_OPTIONS);
@@ -253,9 +228,7 @@ function parseEnum<T extends readonly string[]>(
 	const resolvedValue = ensureValue(`--${label}`, value);
 	const matchedValue = options.find((option) => option === resolvedValue);
 	if (!matchedValue) {
-		throw new Error(
-			`Invalid ${label}: ${resolvedValue}. Expected one of: ${options.join(", ")}`,
-		);
+		throw new Error(`Invalid ${label}: ${resolvedValue}. Expected one of: ${options.join(", ")}`);
 	}
 	return matchedValue;
 }
@@ -282,9 +255,7 @@ async function resolveCreateOptions(
 		authMode: parsed.authMode ?? config?.authMode,
 		runtime: parsed.runtime ?? config?.runtime,
 		sdkSpecifier:
-			parsed.sdkSpecifier ??
-			config?.sdkSpecifier ??
-			process.env.APIFUSE__SDK__SPECIFIER,
+			parsed.sdkSpecifier ?? config?.sdkSpecifier ?? process.env.APIFUSE__SDK__SPECIFIER,
 		dryRun: parsed.dryRun,
 		json: parsed.json,
 		yes: parsed.yes,
@@ -298,9 +269,7 @@ async function resolveCreateOptions(
 
 	if (partial.yes) {
 		if (!partial.name) {
-			throw new Error(
-				"--yes requires a provider name (positional or via config).",
-			);
+			throw new Error("--yes requires a provider name (positional or via config).");
 		}
 
 		return {
@@ -410,9 +379,7 @@ export async function buildProviderCreatePlan(
 	cwd: string,
 ): Promise<ProviderCreatePlan> {
 	const resolvedWorkspaceRoot =
-		options.preset === "monorepo"
-			? findApifuseInternalWorkspaceRoot(cwd)
-			: undefined;
+		options.preset === "monorepo" ? findApifuseInternalWorkspaceRoot(cwd) : undefined;
 	if (options.preset === "monorepo" && !resolvedWorkspaceRoot) {
 		throw new Error(
 			"Monorepo preset is internal to the APIFuse repository. External bounty workspaces are one-provider repositories; use the standalone default create flow.",
@@ -424,9 +391,7 @@ export async function buildProviderCreatePlan(
 	if (options.outputDir) {
 		providerRoot = resolve(cwd, options.outputDir);
 		installCwd =
-			options.preset === "monorepo" && resolvedWorkspaceRoot
-				? resolvedWorkspaceRoot
-				: providerRoot;
+			options.preset === "monorepo" && resolvedWorkspaceRoot ? resolvedWorkspaceRoot : providerRoot;
 	} else if (options.preset === "monorepo" && resolvedWorkspaceRoot) {
 		providerRoot = resolve(resolvedWorkspaceRoot, "providers", options.name);
 		installCwd = resolvedWorkspaceRoot;
@@ -439,10 +404,7 @@ export async function buildProviderCreatePlan(
 		throw new Error(`Target directory already exists: ${providerRoot}`);
 	}
 
-	if (
-		options.sdkSpecifier?.startsWith("workspace:") &&
-		!resolvedWorkspaceRoot
-	) {
+	if (options.sdkSpecifier?.startsWith("workspace:") && !resolvedWorkspaceRoot) {
 		throw new Error(
 			"workspace:* is only valid inside the APIFuse monorepo because public Provider SDK scaffolds must install from npm or an explicit tarball/file specifier.",
 		);
@@ -592,17 +554,14 @@ export async function buildProviderCreatePlan(
 		validationCommands: [
 			"bun run check",
 			"bun run type-check",
-			"bun run submit-check",
+			"bun run submit-check -- --smoke",
 			"bun run test",
 		],
 		workspaceRoot: resolvedWorkspaceRoot,
 	};
 }
 
-async function renderTemplate(
-	fileName: string,
-	values: Record<string, string>,
-): Promise<string> {
+async function renderTemplate(fileName: string, values: Record<string, string>): Promise<string> {
 	const templatePath = resolve(TEMPLATE_DIR, fileName);
 	const template = await readFile(templatePath, "utf8");
 	return template.replace(/\{\{([A-Z_]+)\}\}/g, (_match, key: string) => {
@@ -610,10 +569,7 @@ async function renderTemplate(
 	});
 }
 
-function renderPackageJson(input: {
-	packageName: string;
-	sdkSpecifier: string;
-}): string {
+function renderPackageJson(input: { packageName: string; sdkSpecifier: string }): string {
 	return `${JSON.stringify(
 		{
 			name: input.packageName,
@@ -625,8 +581,7 @@ function renderPackageJson(input: {
 				dev: "apifuse dev .",
 				check: "apifuse check . && bun run type-check",
 				"type-check": "tsc --noEmit",
-				"submit-check":
-					"apifuse submit-check . --markdown submission-report.md",
+				"submit-check": "apifuse submit-check . --markdown submission-report.md",
 				test: "apifuse test .",
 				record: "apifuse record .",
 				start: "bun start.ts",
@@ -665,10 +620,7 @@ function renderTsconfig(): string {
 	)}\n`;
 }
 
-function renderStarterLocaleCatalog(
-	displayName: string,
-	locale: "en" | "ko",
-): string {
+function renderStarterLocaleCatalog(displayName: string, locale: "en" | "ko"): string {
 	const catalog = {
 		meta: {
 			displayName,
@@ -870,9 +822,7 @@ function isApifuseInternalWorkspaceRoot(workspaceRoot: string): boolean {
 		return false;
 	}
 	try {
-		const packageJson = JSON.parse(
-			readFileSync(providerSdkPackageJsonPath, "utf8"),
-		);
+		const packageJson = JSON.parse(readFileSync(providerSdkPackageJsonPath, "utf8"));
 		return (
 			typeof packageJson === "object" &&
 			packageJson !== null &&
@@ -891,27 +841,17 @@ async function writePlan(plan: ProviderCreatePlan): Promise<void> {
 	}
 }
 
-async function installDependencies(
-	plan: ProviderCreatePlan,
-	jsonMode: boolean,
-): Promise<void> {
+async function installDependencies(plan: ProviderCreatePlan, jsonMode: boolean): Promise<void> {
 	await runCommand(plan.installCommand, plan.installCwd, jsonMode);
 }
 
-async function runBaselineValidation(
-	plan: ProviderCreatePlan,
-	jsonMode: boolean,
-): Promise<void> {
+async function runBaselineValidation(plan: ProviderCreatePlan, jsonMode: boolean): Promise<void> {
 	for (const command of plan.validationCommands) {
 		await runCommand(command, plan.providerRoot, jsonMode);
 	}
 }
 
-async function runCommand(
-	command: string,
-	cwd: string,
-	jsonMode: boolean,
-): Promise<void> {
+async function runCommand(command: string, cwd: string, jsonMode: boolean): Promise<void> {
 	const [binary, ...args] = command.split(" ");
 	if (!binary) {
 		throw new Error(`Cannot run empty command in ${cwd}`);
@@ -943,9 +883,7 @@ async function runCommand(
 			rejectPromise(
 				new Error(
 					`Command failed (${command}) in ${cwd}${
-						stdout || stderr
-							? `\n${[stdout, stderr].filter(Boolean).join("\n")}`
-							: ""
+						stdout || stderr ? `\n${[stdout, stderr].filter(Boolean).join("\n")}` : ""
 					}`,
 				),
 			);
@@ -953,11 +891,7 @@ async function runCommand(
 	});
 }
 
-function printResult(
-	plan: ProviderCreatePlan,
-	jsonMode: boolean,
-	dryRun: boolean,
-) {
+function printResult(plan: ProviderCreatePlan, jsonMode: boolean, dryRun: boolean) {
 	const payload = {
 		success: true,
 		dryRun,
@@ -974,9 +908,7 @@ function printResult(
 		},
 		validationCommands: plan.validationCommands,
 		nextDevCommand: plan.nextDevCommand,
-		files: plan.files.map(
-			(file) => relative(plan.providerRoot, file.path) || file.path,
-		),
+		files: plan.files.map((file) => relative(plan.providerRoot, file.path) || file.path),
 	};
 
 	if (jsonMode) {
@@ -992,7 +924,7 @@ function printResult(
 	}
 	console.log(`Next local dev: ${plan.nextDevCommand}`);
 	console.log(
-		"Submission evidence: run `bun run submit-check`, save the generated report, and note `/health` plus `POST /v1/{operation}` smoke results.",
+		"Submission evidence: run `bun run submit-check -- --smoke` to archive measured `/health` and `POST /v1/{operation}` results.",
 	);
 	if (plan.files.some((file) => file.content.includes('runtime: "browser"'))) {
 		console.log(

package/src/cli/templates/provider/README.md.tpl

@@ -8,7 +8,7 @@ Generated with `apifuse create`.
 bun run dev
 bun run check
 bun run test
-bun run submit-check
+bun run submit-check -- --smoke
 bunx apifuse perf . --operation <operation-id> --runs 3
 ```
 
@@ -35,15 +35,17 @@ review when `index.ts` remains a short composition root.
 Before posting bounty evidence, run:
 
 ```bash
-bun run submit-check
+bun run submit-check -- --smoke
 ```
 
 This writes `submission-report.md` with a review-readiness score, blockers,
 warnings, health coverage notes, fixture/schema evidence, and remediation. A
 score is not a payout guarantee; blockers must be fixed before maintainer
 review. The generated `ping` starter intentionally warns until you replace it
-with real upstream-backed Operations. The full public-only checklist is shipped
-in `node_modules/@apifuse/provider-sdk/SUBMISSION.md`.
+with real upstream-backed Operations. `APIFUSE__PROVIDER__*` env vars enable
+live upstream calls; without them, structured provider errors can still verify
+runtime routing. The full public-only checklist is shipped in
+`node_modules/@apifuse/provider-sdk/SUBMISSION.md`.
 
 
 ## Operation guide