@apifuse/provider-sdk 2.2.0-beta.54 → 2.2.0-beta.56

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @apifuse/provider-sdk Changelog
 
+## 2.2.0-beta.56
+
+- Release candidate for main commit 390167b3f51488be0beba25a1ea5eb425d3bf839.
+
+## 2.2.0-beta.55
+
+- Release candidate for main commit 1c495af089940a4c666e6baf58dc0dd577771a40.
+
 ## 2.2.0-beta.54
 
 - Release candidate for main commit 4dccd0cd9d3443cde4edebf98ffc6c11beecb9ea.

package/bin/apifuse-pack-types.ts

@@ -292,6 +292,115 @@ const NEGATIVE_CONTROLS = [
 			"",
 		].join("\n"),
 	},
+	{
+		filename: "negative-control-telemetry-header-vendor.ts",
+		expectedCode: "TS2322",
+		description: "gateway telemetry headers reject an unbranded vendor string",
+		source: [
+			'import type { TelemetryContributor } from "@apifuse/provider-sdk";',
+			"",
+			"const bad: TelemetryContributor<{}, { vendor: string }> = {",
+			'\tkey: "resolver",',
+			"\ttoLogPayload: () => ({}),",
+			'\ttoHeaderPayload: () => ({ vendor: "free-text" }),',
+			"};",
+			"",
+		].join("\n"),
+	},
+	{
+		filename: "negative-control-telemetry-header-host.ts",
+		expectedCode: "TS2322",
+		description: "gateway telemetry headers reject an unbranded host string",
+		source: [
+			'import type { TelemetryContributor } from "@apifuse/provider-sdk";',
+			"",
+			"const bad: TelemetryContributor<{}, { host: string }> = {",
+			'\tkey: "http",',
+			"\ttoLogPayload: () => ({}),",
+			'\ttoHeaderPayload: () => ({ host: "x.example" }),',
+			"};",
+			"",
+		].join("\n"),
+	},
+	{
+		filename: "negative-control-telemetry-tenant-vendor.ts",
+		expectedCode: "TS2322",
+		description: "tenant-neutral projections reject vendor identities",
+		source: [
+			'import type { TenantNeutral } from "@apifuse/provider-sdk";',
+			"",
+			'export const bad: TenantNeutral<{ vendorUsed: "smartproxy" }> = { vendorUsed: "smartproxy" };',
+			"",
+		].join("\n"),
+	},
+	{
+		filename: "negative-control-telemetry-header-any.ts",
+		expectedCode: "TS2322",
+		description: "gateway telemetry projections reject any-valued properties",
+		source: [
+			'import type { GatewayIngestible } from "@apifuse/provider-sdk";',
+			"",
+			'export const bad: GatewayIngestible<{ x: any }> = { x: "free-text" };',
+			"",
+		].join("\n"),
+	},
+	{
+		filename: "negative-control-telemetry-header-union-array.ts",
+		expectedCode: "TS2322",
+		description: "gateway telemetry projections reject arrays mixing numbers and strings",
+		source: [
+			'import type { TelemetryContributor } from "@apifuse/provider-sdk";',
+			"",
+			"const bad: TelemetryContributor<{}, { values: (number | string)[] }> = {",
+			'\tkey: "resolver",',
+			"\ttoLogPayload: () => ({}),",
+			'\ttoHeaderPayload: () => ({ values: [1, "free prose"] }),',
+			"};",
+			"",
+		].join("\n"),
+	},
+	{
+		filename: "negative-control-telemetry-opaque-identity.ts",
+		expectedCode: "TS2322",
+		description: "tenant opaque array brands are not accepted outside the cache keys property",
+		source: [
+			'import type { TenantNeutral } from "@apifuse/provider-sdk";',
+			"",
+			"type LocalOpaque = string[] & { readonly __tenantOpaqueCacheKeys: true };",
+			"declare const opaque: LocalOpaque;",
+			"export const bad: TenantNeutral<{ identity: LocalOpaque }> = { identity: opaque };",
+			"",
+		].join("\n"),
+	},
+	{
+		filename: "negative-control-telemetry-meta-vendor.ts",
+		expectedCode: "TS2322",
+		description: "success metadata rejects tenant-visible vendor identity keys",
+		source: [
+			'import { closedEnum, type ClosedEnum, type TenantNeutral } from "@apifuse/provider-sdk";',
+			"",
+			'type Meta = { cached: boolean; detail: { vendorUsed: ClosedEnum<"smartproxy"> } };',
+			'export const bad: TenantNeutral<Meta> = { cached: false, detail: { vendorUsed: closedEnum("smartproxy") } };',
+			"",
+		].join("\n"),
+	},
+	{
+		filename: "positive-control-proxy-telemetry-contributor.ts",
+		expectedCode: "",
+		description: "proxy telemetry contributor satisfies the public contributor contract",
+		source: [
+			'import { closedEnum, type ClosedEnum, type GatewayIngestible, type ProxyTelemetryHeaderPayload, type ProxyTelemetryLogPayload, type TelemetryContributor } from "@apifuse/provider-sdk";',
+			"",
+			"export const proxy: TelemetryContributor<ProxyTelemetryLogPayload, ProxyTelemetryHeaderPayload> = {",
+			'\tkey: "proxy",',
+			'\ttoLogPayload: () => ({ kind: "unresolved", vendors: [] }),',
+			'\ttoHeaderPayload: () => ({ kind: closedEnum("unresolved"), vendors: [] }),',
+			"};",
+			'type Values = { values: ClosedEnum<"a" | "b">[] };',
+			'export const values: GatewayIngestible<Values> = { values: [closedEnum("a"), closedEnum("b")] };',
+			"",
+		].join("\n"),
+	},
 ] as const;
 
 const tempRoot = mkdtempSync(join(tmpdir(), "apifuse-provider-sdk-pack-types-"));
@@ -513,6 +622,15 @@ function assertNegativeControlFails(consumerDir: string): void {
 			],
 			{ cwd: consumerDir, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] },
 		);
+		if (negativeControl.expectedCode === "") {
+			if (result.status !== 0) {
+				throw new Error(
+					`Positive control "${negativeControl.description}" failed to compile:\n${result.stdout}\n${result.stderr}`,
+				);
+			}
+			console.log(`Positive control accepted: ${negativeControl.description}`);
+			continue;
+		}
 		if (result.status === 0) {
 			throw new Error(
 				'Negative control "' +
@@ -528,6 +646,9 @@ function assertNegativeControlFails(consumerDir: string): void {
 				`Negative control "${negativeControl.description}" (${negativeControl.filename}) failed for an unexpected reason (wanted ${negativeControl.expectedCode}):\n${output}`,
 			);
 		}
+		console.log(
+			`Negative control rejected (${negativeControl.expectedCode}): ${negativeControl.description}`,
+		);
 	}
 }
 

package/dist/cli/migrate-operation-declaration.d.ts

@@ -1,4 +1,4 @@
-export type OperationDeclarationRefusalReason = "no_safety" | "safety_conflict" | "locale_key_conflict" | "connection_mode_conflict" | "execution_conflict" | "approval_conflict" | "non_literal" | "unsupported_member" | "factory_composed_operations" | "source_syntax" | "codemod_syntax" | "missing_english_locale" | "operation_id_unresolved" | "examples_conflict" | "invalid_locale_key" | "locale_todo_conflict";
+export type OperationDeclarationRefusalReason = "no_safety" | "safety_conflict" | "locale_key_conflict" | "connection_mode_conflict" | "execution_conflict" | "approval_conflict" | "non_literal" | "unsupported_member" | "factory_composed_operations" | "source_syntax" | "codemod_syntax" | "missing_english_locale" | "operation_id_unresolved" | "factory_operation_id_ambiguous" | "no_operations_discovered" | "examples_conflict" | "invalid_locale_key" | "locale_todo_conflict";
 export type OperationDeclarationRefusal = {
     readonly file: string;
     readonly operationKey: string;
@@ -51,6 +51,10 @@ export type OperationDeclarationRepositoryResult = {
     readonly status: "refused";
     readonly providerRoot: string;
     readonly refusals: readonly OperationDeclarationRefusal[];
+    /** Operations that were independently migratable before repository-atomic refusal. */
+    readonly operationCount: number;
+    readonly changedFiles: readonly string[];
+    readonly localeTodoCount: number;
 };
 /** Run the file transform repository-wide, committing writes only if every file is provable. */
 export declare function migrateOperationDeclarationRepository(providerRootInput: string, options?: {