@void/edge 0.22.0 → 0.23.0

package/dist/index.d.mts

@@ -179,6 +179,8 @@ type StaticEdgeEnv = Readonly<{
   ASSETS: EdgeAssetFetcher;
 }>;
 type StaticEdgeConfig = Readonly<{
+  /** Optional native Worker self-metadata used to identify the served version. */
+  versionMetadataBinding?: string;
   assetConfig?: AssetConfig$1;
   headerRules?: ReadonlyArray<HeaderRule$1>;
   redirectRules?: ReadonlyArray<RedirectRule$1>;
@@ -259,4 +261,16 @@ export declare function getContentType(path: string): string;
  */
 export declare function resolveAssetContentType(stored: string | null | undefined, path: string): string | undefined;
 //#endregion
-export type { AssetConfig, ClearSiteDataMember, CompiledPattern, EdgeAssetFetcher, HeaderRule, HeaderRulePolicy, ProjectZeroTrustRouting, RedirectRule, ResolvedAsset, RoutingRuleResult, StaticEdgeConfig, StaticEdgeEnv, StaticEdgeHandler };
+//#region src/limits.d.ts
+/** Shared between the SDK, edge admission and Pages clients. */
+type UsageLimitData = {
+  code: "usage_limit";
+  resource: "ai" | "sandbox" | "requests" | "execution";
+  reason: "monthly_quota" | "rate_limit" | "concurrency" | "runtime_budget" | "cpu";
+  message: string;
+  retryAt?: string;
+};
+export declare function readUsageLimit(value: unknown): UsageLimitData | null;
+export declare function usageLimitResponse(limit: UsageLimitData): Response;
+//#endregion
+export type { AssetConfig, ClearSiteDataMember, CompiledPattern, EdgeAssetFetcher, HeaderRule, HeaderRulePolicy, ProjectZeroTrustRouting, RedirectRule, ResolvedAsset, RoutingRuleResult, StaticEdgeConfig, StaticEdgeEnv, StaticEdgeHandler, UsageLimitData };

package/dist/index.mjs

@@ -410,7 +410,14 @@ function mergeQueryIntoLocation(destination, requestSearch) {
 function createStaticEdgeHandler(config) {
 	return { async fetch(request, env) {
 		const originalUrl = new URL(request.url);
-		if (request.method === "GET" && originalUrl.pathname === "/__void/ready") return Response.json({ ready: true });
+		if (request.method === "GET" && originalUrl.pathname === "/__void/ready") {
+			if (!config.versionMetadataBinding) return Response.json({ ready: true });
+			const metadata = config.versionMetadataBinding ? env[config.versionMetadataBinding] : void 0;
+			return Response.json({
+				ready: true,
+				...config.versionMetadataBinding ? { versionId: metadata?.id } : {}
+			}, { headers: { "cache-control": "no-store" } });
+		}
 		let effectiveUrl = new URL(originalUrl);
 		let effectiveRequest = request;
 		const route = applyRoutingRules(effectiveUrl.pathname, config.redirectRules, effectiveUrl.hostname);
@@ -678,4 +685,37 @@ function resolveAssetContentType(stored, path) {
 	return stored;
 }
 //#endregion
-export { applyHeaderRules, applyRoutingRules, compilePattern, createStaticEdgeHandler, getContentType, matchLiteralPattern, matchPattern, matchPatternCaptures, matchSegmentPattern, mergeQueryIntoLocation, parseClearSiteData, resolveAssetContentType, resolveStaticPath, safeDecodePathname, sanitizeClearSiteData, substituteParams };
+//#region src/limits.ts
+function readUsageLimit(value) {
+	if (!value || typeof value !== "object") return null;
+	const v = value;
+	if (v.code !== "usage_limit" || typeof v.message !== "string" || ![
+		"ai",
+		"sandbox",
+		"requests",
+		"execution"
+	].includes(String(v.resource)) || ![
+		"monthly_quota",
+		"rate_limit",
+		"concurrency",
+		"runtime_budget",
+		"cpu"
+	].includes(String(v.reason))) return null;
+	return {
+		code: "usage_limit",
+		resource: v.resource,
+		reason: v.reason,
+		message: v.message,
+		...typeof v.retryAt === "string" && Number.isFinite(Date.parse(v.retryAt)) ? { retryAt: v.retryAt } : {}
+	};
+}
+function usageLimitResponse(limit) {
+	const headers = new Headers({ "Cache-Control": "no-store" });
+	if (limit.retryAt && Number.isFinite(Date.parse(limit.retryAt))) headers.set("Retry-After", String(Math.max(0, Math.ceil((Date.parse(limit.retryAt) - Date.now()) / 1e3))));
+	return Response.json(limit, {
+		status: 429,
+		headers
+	});
+}
+//#endregion
+export { applyHeaderRules, applyRoutingRules, compilePattern, createStaticEdgeHandler, getContentType, matchLiteralPattern, matchPattern, matchPatternCaptures, matchSegmentPattern, mergeQueryIntoLocation, parseClearSiteData, readUsageLimit, resolveAssetContentType, resolveStaticPath, safeDecodePathname, sanitizeClearSiteData, substituteParams, usageLimitResponse };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@void/edge",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/voidzero-dev/void.git",
@@ -20,7 +20,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@void/deploy-core": "0.22.0"
+    "@void/deploy-core": "0.23.0"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^4.20260702.1",