@apifuse/provider-sdk 2.2.0-beta.2 → 2.2.0-beta.21

package/src/server/index.ts

@@ -1,30 +1,52 @@
-export { createServerApp, type ServeOptions, serve } from "./serve";
+export {
+	createServerApp,
+	ERROR_OBSERVABILITY_HEADER,
+	type ErrorObservabilityDetails,
+	type ProviderServerCloseOptions,
+	type ProviderServerHandle,
+	type ProviderServerLogEvent,
+	type ProviderServerLogger,
+	type ProviderServerOperationExecutor,
+	type ProviderServerOperationExecutorInput,
+	type ProviderServerOptions,
+	type ProviderServerStatefulForwardEnvelope,
+	type ServeOptions,
+	serve,
+} from "./serve.js";
 export {
 	computeSelfTestPlanDigest,
 	createSelfTestApp,
+	createSelfTestAuthFlowInvoke,
 	createSelfTestInvoke,
 	DEFAULT_SELF_TEST_REQUEST_BUDGET_MS,
 	isSelfTestReadOnlyOperation,
 	PROVIDER_RUNTIME_SELF_TEST_REQUEST_BUDGET_MS_ENV,
 	resolveSelfTestPort,
+	SELF_TEST_AUTH_FLOW_MULTI_TURN_SKIP_REASON,
+	SELF_TEST_AUTH_FLOW_REJECTED_SKIP_REASON,
 	SELF_TEST_HEALTHZ_PATH,
 	SELF_TEST_PATH,
 	SELF_TEST_SCHEMA_VERSION,
 	type SelfTestAppOptions,
+	type SelfTestAuthFlowInvoke,
+	type SelfTestAuthFlowRoute,
 	type SelfTestCaseResult,
 	type SelfTestCaseStatus,
 	type SelfTestOperationInvoke,
 	type SelfTestRequest,
 	SelfTestRequestSchema,
 	type SelfTestResponse,
-} from "./self-test";
-export { resolveHealthCheckInputDateTokens } from "./self-test-input-tokens";
+} from "./self-test.js";
+export {
+	type InputDateTokenCalendar,
+	resolveHealthCheckInputDateTokens,
+} from "./self-test-input-tokens.js";
 export {
 	collectSelfTestSensitiveValues,
 	redactSelfTestText,
 	SELF_TEST_MAX_TEXT_LENGTH,
 	SELF_TEST_REDACTED_PLACEHOLDER,
-} from "./self-test-redaction";
+} from "./self-test-redaction.js";
 export {
 	DEFAULT_SELF_TEST_PORT,
 	deriveSelfTestToken,
@@ -34,7 +56,7 @@ export {
 	resolveSelfTestMasterSecrets,
 	type SelfTestMasterSecrets,
 	verifySelfTestAuthorization,
-} from "./self-test-token";
+} from "./self-test-token.js";
 export type {
 	AuthFlowRequest,
 	AuthFlowResponse,
@@ -45,7 +67,7 @@ export type {
 	OperationRequest,
 	OperationResponse,
 	OperationSuccessResponse,
-} from "./types";
+} from "./types.js";
 export {
 	AuthFlowRequestSchema,
 	AuthFlowSuccessResponseSchema,
@@ -55,4 +77,4 @@ export {
 	OperationErrorResponseSchema,
 	OperationRequestSchema,
 	OperationSuccessResponseSchema,
-} from "./types";
+} from "./types.js";

package/src/server/self-test-input-tokens.ts

@@ -1,46 +1,61 @@
 /**
- * Relative-KST date token resolution for health-check case inputs, ported from
- * the monorepo health-monitor (`apps/health-monitor/src/lib/health-check-input.ts`)
- * so provider self-tests resolve durable probe inputs identically.
+ * Relative date-token resolution for health-check case inputs and fixture
+ * requests. The calendar defaults to KST; callers that need UTC must opt in
+ * explicitly so UTC and KST do not silently disagree from 15:00–23:59 UTC.
  *
- * Supported token: `+<days>d` or `+<days>d:YYYYMMDD` (1..365 days ahead, KST).
+ * Supported token: `+<days>d` or `+<days>d:YYYYMMDD` (1..365 days ahead).
  */
-const RELATIVE_KST_DATE_TOKEN = /^\+(\d{1,3})d(?::(YYYYMMDD))?$/i;
+const RELATIVE_DATE_TOKEN = /^\+(\d{1,3})d(?::(YYYYMMDD))?$/i;
 
-function dateFromKstDaysAhead(
+export type InputDateTokenCalendar = "KST" | "UTC";
+
+function dateFromDaysAhead(
 	daysAhead: number,
 	now = new Date(),
 	format: "YYYY-MM-DD" | "YYYYMMDD" = "YYYY-MM-DD",
+	calendar: InputDateTokenCalendar = "KST",
 ): string {
-	const kstNow = new Date(now.getTime() + 9 * 60 * 60 * 1000);
+	const calendarNow = new Date(now.getTime() + (calendar === "KST" ? 9 * 60 * 60 * 1000 : 0));
 	const date = new Date(
-		Date.UTC(kstNow.getUTCFullYear(), kstNow.getUTCMonth(), kstNow.getUTCDate() + daysAhead),
+		Date.UTC(
+			calendarNow.getUTCFullYear(),
+			calendarNow.getUTCMonth(),
+			calendarNow.getUTCDate() + daysAhead,
+		),
 	);
 	const isoDate = date.toISOString().slice(0, 10);
 	return format === "YYYYMMDD" ? isoDate.replace(/-/g, "") : isoDate;
 }
 
-export function resolveHealthCheckInputDateTokens(value: unknown, now = new Date()): unknown {
+export function resolveHealthCheckInputDateTokens(
+	value: unknown,
+	now = new Date(),
+	calendar: InputDateTokenCalendar = "KST",
+): unknown {
 	if (typeof value === "string") {
-		const relative = value.match(RELATIVE_KST_DATE_TOKEN);
+		const relative = value.match(RELATIVE_DATE_TOKEN);
 		if (!relative) return value;
 		const daysAhead = Number(relative[1]);
 		if (!Number.isInteger(daysAhead) || daysAhead < 1 || daysAhead > 365) {
 			return value;
 		}
 		const format = relative[2]?.toUpperCase() === "YYYYMMDD" ? "YYYYMMDD" : "YYYY-MM-DD";
-		return dateFromKstDaysAhead(daysAhead, now, format);
+		return dateFromDaysAhead(daysAhead, now, format, calendar);
 	}
 	if (Array.isArray(value)) {
-		return value.map((entry) => resolveHealthCheckInputDateTokens(entry, now));
+		const resolved = value.map((entry) => resolveHealthCheckInputDateTokens(entry, now, calendar));
+		return resolved.some((entry, index) => entry !== value[index]) ? resolved : value;
 	}
 	if (value && typeof value === "object") {
-		return Object.fromEntries(
+		const resolved = Object.fromEntries(
 			Object.entries(value).map(([key, entry]) => [
 				key,
-				resolveHealthCheckInputDateTokens(entry, now),
+				resolveHealthCheckInputDateTokens(entry, now, calendar),
 			]),
 		);
+		return Object.entries(resolved).some(([key, entry]) => entry !== Reflect.get(value, key))
+			? resolved
+			: value;
 	}
 	return value;
 }

package/src/server/self-test-redaction.ts

@@ -1,8 +1,8 @@
-import type { ProviderDefinition } from "../types";
+import type { ProviderDefinition } from "../types.js";
 import {
 	PROVIDER_RUNTIME_SELF_TEST_MASTER_SECRET_ENV,
 	PROVIDER_RUNTIME_SELF_TEST_MASTER_SECRET_PREVIOUS_ENV,
-} from "./self-test-token";
+} from "./self-test-token.js";
 
 export const SELF_TEST_REDACTED_PLACEHOLDER = "[REDACTED]";