vinext 1.3.1 → 1.4.0

package/dist/server/skip-cache-proof.d.ts

@@ -1,60 +0,0 @@
-import { ArtifactCompatibilityEnvelope, ArtifactCompatibilityEvaluationOptions } from "./artifact-compatibility.js";
-import { StaticLayoutArtifactReuseDecision } from "./cache-proof.js";
-import { ClientReuseManifestEntry, ClientReuseManifestEntryRejection, ClientReuseManifestParseResult, ClientReuseManifestRejection, ClientReuseManifestSkipDisposition, ClientReuseManifestTraceFields } from "./client-reuse-manifest.js";
-import { createStaticLayoutClientReuseArtifactCompatibility, createStaticLayoutClientReusePayloadHash, createStaticLayoutClientReuseRouteId } from "./static-layout-client-reuse-proof.js";
-//#region src/server/skip-cache-proof.d.ts
-export type SkipCacheInvalidationProof = Readonly<{
-  kind: "invalidated";
-  invalidationEpoch: string | null;
-}> | Readonly<{
-  kind: "unknown";
-}> | Readonly<{
-  kind: "valid";
-}>;
-type SkipCacheArtifactProof = Readonly<{
-  compatibility: ArtifactCompatibilityEnvelope;
-  invalidation: SkipCacheInvalidationProof;
-  payloadHash: string | null;
-}>;
-type SkipCacheCrossCheckAcceptanceCode = "SKIP_CACHE_CROSS_CHECK_PASSED";
-type SkipCacheCrossCheckVerified = Readonly<{
-  code: SkipCacheCrossCheckAcceptanceCode;
-  entryId: string;
-  fields: ClientReuseManifestTraceFields;
-  kind: "verified";
-  skipDisposition: ClientReuseManifestSkipDisposition;
-}>;
-type SkipCacheCrossCheckRejected = Readonly<{
-  kind: "rejected";
-  rejection: ClientReuseManifestEntryRejection;
-  skipDisposition: ClientReuseManifestSkipDisposition;
-}>;
-type SkipCacheCrossCheckResult = SkipCacheCrossCheckRejected | SkipCacheCrossCheckVerified;
-type CrossCheckClientReuseManifestEntryWithCacheInput = Readonly<{
-  artifact: SkipCacheArtifactProof;
-  cacheDecision: StaticLayoutArtifactReuseDecision | null;
-  entry: ClientReuseManifestEntry;
-}> & ArtifactCompatibilityEvaluationOptions;
-type ClientReuseSkipTransportPlan = Readonly<{
-  entryRejections: readonly ClientReuseManifestEntryRejection[];
-  kind: "renderAndSend";
-  manifestRejection?: ClientReuseManifestRejection;
-  skipDisposition: ClientReuseManifestSkipDisposition;
-  skipIneligibleEntryIds: readonly string[];
-  skippedEntryIds: readonly string[];
-}> | Readonly<{
-  entryRejections: readonly ClientReuseManifestEntryRejection[];
-  kind: "skip";
-  skipDisposition: ClientReuseManifestSkipDisposition;
-  skipIneligibleEntryIds: readonly string[];
-  skippedEntryIds: readonly string[];
-}>;
-type CreateClientReuseSkipTransportPlanInput = Readonly<{
-  manifest: ClientReuseManifestParseResult;
-  maxWireEntriesToVerify?: number;
-  verifyEntry: (entry: ClientReuseManifestEntry) => SkipCacheCrossCheckResult;
-}>;
-export declare function crossCheckClientReuseManifestEntryWithCache(input: CrossCheckClientReuseManifestEntryWithCacheInput): SkipCacheCrossCheckResult;
-export declare function createClientReuseSkipTransportPlan(input: CreateClientReuseSkipTransportPlanInput): ClientReuseSkipTransportPlan;
-//#endregion
-export { createStaticLayoutClientReuseArtifactCompatibility, createStaticLayoutClientReusePayloadHash, createStaticLayoutClientReuseRouteId };

package/dist/server/skip-cache-proof.js

@@ -1,168 +0,0 @@
-import { ARTIFACT_COMPATIBILITY_PROOF_FIELDS, evaluateArtifactCompatibility } from "./artifact-compatibility.js";
-import { createClientReusePayloadHash } from "./client-reuse-manifest.js";
-import { createStaticLayoutClientReuseArtifactCompatibility, createStaticLayoutClientReusePayloadHash, createStaticLayoutClientReuseRouteId } from "./static-layout-client-reuse-proof.js";
-//#region src/server/skip-cache-proof.ts
-function createDisabledSkipDisposition() {
-	return {
-		code: "SKIP_MODEL_DISABLED",
-		enabled: false,
-		mode: "renderAndSend"
-	};
-}
-function createStaticLayoutSkipDisposition(skippedEntryIds) {
-	return {
-		code: "SKIP_STATIC_LAYOUT_VERIFIED",
-		enabled: true,
-		mode: "skipStaticLayout",
-		skippedEntryIds: [...skippedEntryIds]
-	};
-}
-function rejectSkipCacheCrossCheck(entry, code, fields = {}) {
-	return {
-		kind: "rejected",
-		rejection: {
-			code,
-			entryId: entry.id,
-			fields
-		},
-		skipDisposition: createDisabledSkipDisposition()
-	};
-}
-function collectArtifactCompatibilityProofMismatches(artifactCompatibility, proofCompatibility) {
-	const mismatchedFields = [];
-	for (const field of ARTIFACT_COMPATIBILITY_PROOF_FIELDS) if (artifactCompatibility[field] !== proofCompatibility[field]) mismatchedFields.push(field);
-	return mismatchedFields;
-}
-function isExactArtifactCompatibility(artifactCompatibility, entryCompatibility) {
-	return collectArtifactCompatibilityProofMismatches(artifactCompatibility, entryCompatibility).length === 0;
-}
-function assertNever(value) {
-	throw new Error(`Unhandled skip/cache proof state: ${String(value)}`);
-}
-function createRenderAndSendPlan(options) {
-	return {
-		kind: "renderAndSend",
-		entryRejections: options.entryRejections ?? [],
-		...options.manifestRejection ? { manifestRejection: options.manifestRejection } : {},
-		skipDisposition: createDisabledSkipDisposition(),
-		skipIneligibleEntryIds: options.skipIneligibleEntryIds ?? [],
-		skippedEntryIds: []
-	};
-}
-function createVerificationBudgetExceededRejection(totalWireEntries, maxWireEntriesToVerify) {
-	return {
-		code: "SKIP_VERIFICATION_BUDGET_EXCEEDED",
-		fields: {
-			totalWireEntries,
-			maxWireEntriesToVerify
-		}
-	};
-}
-function crossCheckInvalidationProof(entry, invalidation) {
-	switch (invalidation.kind) {
-		case "valid": return null;
-		case "unknown": return rejectSkipCacheCrossCheck(entry, "SKIP_CACHE_INVALIDATION_UNKNOWN");
-		case "invalidated": return rejectSkipCacheCrossCheck(entry, "SKIP_CACHE_INVALIDATED", { invalidationEpoch: invalidation.invalidationEpoch });
-		default: return assertNever(invalidation);
-	}
-}
-function crossCheckClientReuseManifestEntryWithCache(input) {
-	const { cacheDecision, entry } = input;
-	if (cacheDecision === null) return rejectSkipCacheCrossCheck(entry, "SKIP_CACHE_PROOF_MISSING");
-	if (cacheDecision.kind === "fallback") return rejectSkipCacheCrossCheck(entry, "SKIP_CACHE_PROOF_REJECTED", {
-		cacheProofCode: cacheDecision.fallback.code,
-		cacheProofMode: cacheDecision.fallback.mode,
-		cacheProofScope: cacheDecision.fallback.scope
-	});
-	const { proof } = cacheDecision;
-	if (entry.kind !== "layout" || proof.reuseClass !== "static-layout") return rejectSkipCacheCrossCheck(entry, "SKIP_CACHE_REUSE_CLASS_UNSUPPORTED", {
-		entryKind: entry.kind,
-		reuseClass: proof.reuseClass
-	});
-	if (entry.id !== proof.candidateOutput.layoutId) return rejectSkipCacheCrossCheck(entry, "SKIP_CACHE_ENTRY_ID_MISMATCH", {
-		cacheEntryId: proof.candidateOutput.layoutId,
-		manifestEntryId: entry.id
-	});
-	const artifactProofMismatches = collectArtifactCompatibilityProofMismatches(input.artifact.compatibility, proof.candidateArtifactCompatibility);
-	if (artifactProofMismatches.length > 0) return rejectSkipCacheCrossCheck(entry, "SKIP_CACHE_ARTIFACT_PROOF_MISMATCH", { mismatchedFields: artifactProofMismatches });
-	const artifactCompatibility = evaluateArtifactCompatibility(input.artifact.compatibility, entry.artifactCompatibility, { compatibilityMap: input.compatibilityMap });
-	if (artifactCompatibility.kind === "unknown") return rejectSkipCacheCrossCheck(entry, "SKIP_CACHE_ARTIFACT_COMPATIBILITY_UNKNOWN", {
-		compatibilityFallback: artifactCompatibility.fallback,
-		reason: artifactCompatibility.reason
-	});
-	if (artifactCompatibility.kind === "incompatible") return rejectSkipCacheCrossCheck(entry, "SKIP_CACHE_ARTIFACT_COMPATIBILITY_INCOMPATIBLE", {
-		compatibilityFallback: artifactCompatibility.fallback,
-		reason: artifactCompatibility.reason
-	});
-	if (entry.variantCacheKey !== proof.variant.cacheKey) return rejectSkipCacheCrossCheck(entry, "SKIP_CACHE_VARIANT_MISMATCH", {
-		cacheVariantCacheKeyHash: createClientReusePayloadHash(proof.variant.cacheKey),
-		entryVariantCacheKeyHash: createClientReusePayloadHash(entry.variantCacheKey)
-	});
-	if (input.artifact.payloadHash === null) return rejectSkipCacheCrossCheck(entry, "SKIP_CACHE_PAYLOAD_HASH_MISSING");
-	if (entry.payloadHash !== input.artifact.payloadHash) return rejectSkipCacheCrossCheck(entry, "SKIP_CACHE_PAYLOAD_HASH_MISMATCH", {
-		cachePayloadHash: input.artifact.payloadHash,
-		entryPayloadHash: entry.payloadHash
-	});
-	const invalidationRejection = crossCheckInvalidationProof(entry, input.artifact.invalidation);
-	if (invalidationRejection) return invalidationRejection;
-	const skipDisposition = isExactArtifactCompatibility(input.artifact.compatibility, entry.artifactCompatibility) ? createStaticLayoutSkipDisposition([entry.id]) : createDisabledSkipDisposition();
-	return {
-		kind: "verified",
-		code: "SKIP_CACHE_CROSS_CHECK_PASSED",
-		entryId: entry.id,
-		fields: {
-			entryKind: entry.kind,
-			reuseClass: proof.reuseClass,
-			variantCacheKeyHash: createClientReusePayloadHash(proof.variant.cacheKey)
-		},
-		skipDisposition
-	};
-}
-function createClientReuseSkipTransportPlan(input) {
-	const { manifest } = input;
-	if (manifest.kind === "absent") return createRenderAndSendPlan({});
-	if (manifest.kind === "rejected") return createRenderAndSendPlan({ manifestRejection: manifest.rejection });
-	const maxWireEntriesToVerify = input.maxWireEntriesToVerify ?? 8;
-	if (!Number.isSafeInteger(maxWireEntriesToVerify) || maxWireEntriesToVerify < 0) throw new RangeError("maxWireEntriesToVerify must be a non-negative safe integer");
-	const totalWireEntries = manifest.manifest.entries.length + manifest.entryRejections.length;
-	if (totalWireEntries > maxWireEntriesToVerify) return createRenderAndSendPlan({
-		entryRejections: manifest.entryRejections,
-		manifestRejection: createVerificationBudgetExceededRejection(totalWireEntries, maxWireEntriesToVerify)
-	});
-	const skippedEntryIds = [];
-	const skipIneligibleEntryIds = [];
-	const entryRejections = [...manifest.entryRejections];
-	for (const entry of manifest.manifest.entries) {
-		const verification = input.verifyEntry(entry);
-		if (verification.kind === "rejected") {
-			entryRejections.push(verification.rejection);
-			continue;
-		}
-		if (verification.entryId !== entry.id) {
-			entryRejections.push({
-				code: "SKIP_CACHE_ENTRY_ID_MISMATCH",
-				entryId: entry.id,
-				fields: {
-					verifierEntryId: verification.entryId,
-					manifestEntryId: entry.id
-				}
-			});
-			continue;
-		}
-		if (verification.skipDisposition.enabled) skippedEntryIds.push(entry.id);
-		else skipIneligibleEntryIds.push(entry.id);
-	}
-	if (skippedEntryIds.length === 0) return createRenderAndSendPlan({
-		entryRejections,
-		skipIneligibleEntryIds
-	});
-	return {
-		kind: "skip",
-		entryRejections,
-		skipDisposition: createStaticLayoutSkipDisposition(skippedEntryIds),
-		skipIneligibleEntryIds,
-		skippedEntryIds
-	};
-}
-//#endregion
-export { createClientReuseSkipTransportPlan, createStaticLayoutClientReuseArtifactCompatibility, createStaticLayoutClientReusePayloadHash, createStaticLayoutClientReuseRouteId, crossCheckClientReuseManifestEntryWithCache };

package/dist/server/static-layout-client-reuse-proof.d.ts

@@ -1,14 +0,0 @@
-import { ArtifactCompatibilityEnvelope } from "./artifact-compatibility.js";
-//#region src/server/static-layout-client-reuse-proof.d.ts
-type StaticLayoutClientReuseProofInput = Readonly<{
-  artifactCompatibility: ArtifactCompatibilityEnvelope;
-  layoutId: string;
-  rootBoundaryId: string | null;
-  routeId: string;
-  variantCacheKey: string;
-}>;
-export declare function createStaticLayoutClientReuseRouteId(layoutId: string): string;
-export declare function createStaticLayoutClientReusePayloadHash(input: StaticLayoutClientReuseProofInput): string;
-export declare function createStaticLayoutClientReuseArtifactCompatibility(input: StaticLayoutClientReuseProofInput): ArtifactCompatibilityEnvelope;
-//#endregion
-export {};

package/dist/server/static-layout-client-reuse-proof.js

@@ -1,33 +0,0 @@
-import { ARTIFACT_COMPATIBILITY_PROOF_FIELDS } from "./artifact-compatibility.js";
-import { createClientReusePayloadHash } from "./client-reuse-manifest.js";
-//#region src/server/static-layout-client-reuse-proof.ts
-function createStaticLayoutClientReuseRouteId(layoutId) {
-	return `static-layout:${createClientReusePayloadHash(layoutId)}`;
-}
-function createCanonicalProofPairs(input) {
-	return ARTIFACT_COMPATIBILITY_PROOF_FIELDS.map((field) => [field, input.artifactCompatibility[field]]);
-}
-function createStaticLayoutClientReusePayloadHash(input) {
-	return createClientReusePayloadHash(JSON.stringify({
-		artifactCompatibilityPairs: createCanonicalProofPairs(input),
-		layoutId: input.layoutId,
-		rootBoundaryId: input.rootBoundaryId,
-		variantCacheKey: input.variantCacheKey
-	}));
-}
-function createStaticLayoutClientReuseArtifactCompatibility(input) {
-	return {
-		...input.artifactCompatibility,
-		graphVersion: `static-layout-graph:${createClientReusePayloadHash(JSON.stringify({
-			layoutId: input.layoutId,
-			rootBoundaryId: input.rootBoundaryId
-		}))}`,
-		renderEpoch: `static-layout:${createClientReusePayloadHash(JSON.stringify({
-			layoutId: input.layoutId,
-			rootBoundaryId: input.rootBoundaryId,
-			variantCacheKey: input.variantCacheKey
-		}))}`
-	};
-}
-//#endregion
-export { createStaticLayoutClientReuseArtifactCompatibility, createStaticLayoutClientReusePayloadHash, createStaticLayoutClientReuseRouteId };

package/dist/utils/sorted-array.d.ts

@@ -1,8 +0,0 @@
-//#region src/utils/sorted-array.d.ts
-type SortedStringPosition = Readonly<{
-  found: boolean;
-  index: number;
-}>;
-export declare function findSortedStringPosition(values: readonly string[], candidate: string): SortedStringPosition;
-//#endregion
-export {};

package/dist/utils/sorted-array.js

@@ -1,20 +0,0 @@
-//#region src/utils/sorted-array.ts
-function findSortedStringPosition(values, candidate) {
-	let lower = 0;
-	let upper = values.length;
-	while (lower < upper) {
-		const middle = lower + Math.floor((upper - lower) / 2);
-		if (values[middle] === candidate) return {
-			found: true,
-			index: middle
-		};
-		if (values[middle] < candidate) lower = middle + 1;
-		else upper = middle;
-	}
-	return {
-		found: false,
-		index: lower
-	};
-}
-//#endregion
-export { findSortedStringPosition };