@demiurgejs/core 0.2.0-beta.2 → 0.2.0-beta.4

package/dist/config/vite.d.ts

@@ -0,0 +1,12 @@
+import type { InlineConfig, PluginOption } from "vite";
+import { type DemiurgeVitePluginOptions } from "../vite/plugin";
+import type { DemiurgeConfig, ResolvedDemiurgeConfig } from "./types";
+export type ReactPluginLoader = () => Promise<(...args: never[]) => PluginOption>;
+export type CreateDemiurgeViteConfigOptions = {
+    config: ResolvedDemiurgeConfig;
+    loadReactPlugin?: ReactPluginLoader;
+    overrides?: InlineConfig;
+};
+export declare function createDemiurgeViteConfig(options: CreateDemiurgeViteConfigOptions): Promise<InlineConfig>;
+export declare function toPluginOptions(config: DemiurgeConfig): DemiurgeVitePluginOptions;
+//# sourceMappingURL=vite.d.ts.map

package/dist/config/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../src/config/vite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAc,MAAM,MAAM,CAAC;AACnE,OAAO,EAAY,KAAK,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAGtE,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,YAAY,CAAC,CAAC;AAElF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,MAAM,EAAE,sBAAsB,CAAC;IAC/B,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,SAAS,CAAC,EAAE,YAAY,CAAC;CAC1B,CAAC;AAIF,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,YAAY,CAAC,CAwCvB;AAID,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,GACrB,yBAAyB,CAgC3B"}

package/dist/data/cache.d.ts

@@ -11,6 +11,8 @@ type MaybePromise<T> = T | Promise<T>;
 export type CacheRequest<TResult> = {
     fn: () => MaybePromise<TResult>;
     key: CacheKey;
+    locale?: "neutral";
+    notFoundTtl?: CacheDuration;
     scope?: CacheScope;
     staleWhileRevalidate?: CacheDuration;
     tags?: readonly CacheTag[];
@@ -19,6 +21,8 @@ export type CacheRequest<TResult> = {
 export type QueryDefinition<TArgs extends readonly unknown[], TResult> = {
     fn: (...args: TArgs) => MaybePromise<TResult>;
     key: (...args: TArgs) => CacheKey;
+    locale?: "neutral";
+    notFoundTtl?: CacheDuration;
     scope?: CacheScope;
     staleWhileRevalidate?: CacheDuration;
     tags?: (...args: TArgs) => readonly CacheTag[];
@@ -37,6 +41,7 @@ export type CacheNamespace = {
 };
 export type CacheStoreEntry = {
     expiresAt: number | null;
+    negative?: boolean;
     staleUntil: number | null;
     tags: readonly string[];
     value: unknown;
@@ -81,6 +86,11 @@ export type MemoryCacheStoreOptions = {
     now?: () => number;
 };
 export declare function query<TArgs extends readonly unknown[], TResult>(definition: QueryDefinition<TArgs, TResult>): Query<TArgs, TResult>;
+export declare class CacheNotFoundError extends Error {
+    constructor(message?: string);
+}
+export declare function cacheNotFound(message?: string): never;
+export declare function isCacheNotFoundError(error: unknown): error is CacheNotFoundError;
 export declare function tag(id: string): CacheTag;
 export declare function defineTags<TTags extends Record<string, (...args: never[]) => CacheTag>>(tags: TTags): TTags;
 export declare function createCache(options: CreateCacheOptions): Cache;

package/dist/data/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/data/cache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/data/cache.ts"],"names":[],"mappings":"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"}

package/dist/data/idempotency.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../../src/data/idempotency.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,QAAQ,EACd,MAAM,SAAS,CAAC;AAEjB,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC,MAAM,MAAM,kBAAkB,CAAC,OAAO,IAAI;IACxC,EAAE,EAAE,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAChC,GAAG,EAAE,QAAQ,CAAC;IACd,GAAG,CAAC,EAAE,aAAa,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,OAAO,IAAI;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,CAAC,OAAO,EACX,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,KACjC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;CAC1C,CAAC;AAQF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,CAAC;AAKF,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,6BAAkC,GAC1C,gBAAgB,CAwElB;AAwBD,wBAAgB,qBAAqB,CAAC,OAAO,EAC3C,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,uCAGrC"}
+{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../../src/data/idempotency.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,QAAQ,EACd,MAAM,SAAS,CAAC;AAEjB,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC,MAAM,MAAM,kBAAkB,CAAC,OAAO,IAAI;IACxC,EAAE,EAAE,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAChC,GAAG,EAAE,QAAQ,CAAC;IACd,GAAG,CAAC,EAAE,aAAa,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,OAAO,IAAI;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,CAAC,OAAO,EACX,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,KACjC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;CAC1C,CAAC;AAQF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,CAAC;AAKF,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,6BAAkC,GAC1C,gBAAgB,CA0ElB;AA8BD,wBAAgB,qBAAqB,CAAC,OAAO,EAC3C,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,uCAGrC"}

package/dist/data/index.d.ts

@@ -1,5 +1,7 @@
-export { createCache, createInvalidation, createMemoryCache, createMemoryCacheStore, defineTags, parseCacheDuration, query, serializeCacheKey, serializeCacheNamespace, serializeCacheTag, tag, } from "./cache";
+export { cacheNotFound, CacheNotFoundError, createCache, createInvalidation, createMemoryCache, createMemoryCacheStore, defineTags, isCacheNotFoundError, parseCacheDuration, query, serializeCacheKey, serializeCacheNamespace, serializeCacheTag, tag, } from "./cache";
 export { createMemoryIdempotencyStore, runIdempotentMutation, } from "./idempotency";
+export { createTieredCacheStore } from "./tiered";
 export type { Cache, CacheDuration, CacheKey, CacheKeyPart, CacheRequest, CacheScope, CacheNamespace, CacheStore, CacheStoreEntry, CacheTag, CreateCacheOptions, Invalidation, InvalidationResult, Query, QueryDefinition, MemoryCacheOptions, MemoryCacheStoreOptions, } from "./cache";
+export type { TieredCacheStoreOptions } from "./tiered";
 export type { IdempotencyRequest, IdempotencyResult, IdempotencyStore, MemoryIdempotencyStoreOptions, } from "./idempotency";
 //# sourceMappingURL=index.d.ts.map

package/dist/data/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,EACV,kBAAkB,EAClB,KAAK,EACL,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,GAAG,GACJ,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,KAAK,EACL,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,cAAc,EACd,UAAU,EACV,eAAe,EACf,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,KAAK,EACL,eAAe,EACf,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,6BAA6B,GAC9B,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,EACL,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,GAAG,GACJ,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,YAAY,EACV,KAAK,EACL,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,cAAc,EACd,UAAU,EACV,eAAe,EACf,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,KAAK,EACL,eAAe,EACf,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACxD,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,6BAA6B,GAC9B,MAAM,eAAe,CAAC"}

package/dist/data/testing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/data/testing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,SAAS,CAAC;AAE3D,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC,MAAM,MAAM,iBAAiB,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;AAE/D,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,iBAAiB,iBA8E/B;AAED,wBAAsB,+BAA+B,CACnD,WAAW,EAAE,iBAAiB,iBAwF/B"}
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/data/testing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,SAAS,CAAC;AAE3D,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC,MAAM,MAAM,iBAAiB,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;AAE/D,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,iBAAiB,iBA2G/B;AAED,wBAAsB,+BAA+B,CACnD,WAAW,EAAE,iBAAiB,iBAwF/B"}

package/dist/data/testing.js

@@ -1,134 +1,156 @@
-async function d(i) {
-  const e = await i(), s = `demiurge-contract:${Date.now()}:${Math.random()}`, t = `${s}:alpha`, l = `${s}:beta`, o = `${s}:gamma`, n = `${s}:tag:alpha`, u = `${s}:tag:beta`, r = Date.now() + 6e4, h = {
-    expiresAt: r,
-    staleUntil: r + 5e3,
-    tags: [n],
+async function m(i) {
+  const e = await i(), s = `demiurge-contract:${Date.now()}:${Math.random()}`, a = `${s}:alpha`, o = `${s}:beta`, u = `${s}:gamma`, r = `${s}:delta`, l = `${s}:tag:alpha`, g = `${s}:tag:beta`, c = `${s}:tag:delta`, n = Date.now() + 6e4, h = {
+    expiresAt: n,
+    staleUntil: n + 5e3,
+    tags: [l],
     value: { id: "alpha", revision: 1 }
   };
   try {
-    a(
-      await e.get(t) === void 0,
+    t(
+      await e.get(a) === void 0,
       "get() must return undefined for a missing key"
-    ), await e.set(t, h), w(await e.get(t), h, "set() then get()");
-    const c = {
+    ), await e.set(a, h), d(await e.get(a), h, "set() then get()");
+    const f = {
       ...h,
       value: { id: "alpha", revision: 2 }
     };
-    await e.set(t, c), w(
-      await e.get(t),
-      c,
+    await e.set(a, f), d(
+      await e.get(a),
+      f,
       "set() must replace an existing key"
-    ), await e.set(l, {
-      expiresAt: r + 1e4,
-      staleUntil: r + 15e3,
-      tags: [u],
+    ), await e.set(o, {
+      expiresAt: n + 1e4,
+      staleUntil: n + 15e3,
+      tags: [g],
       value: "beta"
-    }), await e.set(o, {
-      expiresAt: r + 2e4,
-      staleUntil: r + 25e3,
-      tags: [n, u],
+    }), await e.set(u, {
+      expiresAt: n + 2e4,
+      staleUntil: n + 25e3,
+      tags: [l, g],
       value: ["gamma"]
-    }), a(
-      await e.invalidateTags([n]) === 2,
+    }), t(
+      await e.invalidateTags([l]) === 2,
       "invalidateTags() must return the number of entries deleted, counting each entry once"
-    ), a(
-      await e.get(t) === void 0 && await e.get(o) === void 0,
+    ), t(
+      await e.get(a) === void 0 && await e.get(u) === void 0,
       "invalidateTags() must delete every entry carrying a matching tag"
-    ), a(
-      (await e.get(l))?.value === "beta",
+    ), t(
+      (await e.get(o))?.value === "beta",
       "invalidateTags() must preserve entries with no matching tag"
-    ), a(
-      await e.delete(l) === !0,
+    ), t(
+      await e.delete(o) === !0,
       "delete() must report an existing key"
-    ), a(
-      await e.delete(l) === !1,
+    ), t(
+      await e.delete(o) === !1,
       "delete() must report a missing key"
     );
+    const w = {
+      expiresAt: n,
+      negative: !0,
+      staleUntil: n,
+      tags: [c],
+      value: "not found"
+    };
+    await e.set(r, w), d(
+      await e.get(r),
+      w,
+      "set() then get() for a negative entry"
+    ), t(
+      await e.invalidateTags([c]) === 1,
+      "invalidateTags() must delete a negative entry carrying a matching tag"
+    ), t(
+      await e.get(r) === void 0,
+      "invalidateTags() must remove a negative entry the same as a positive one"
+    );
   } finally {
     await Promise.all([
-      e.delete(t),
-      e.delete(l),
-      e.delete(o)
+      e.delete(a),
+      e.delete(o),
+      e.delete(u),
+      e.delete(r)
     ]);
   }
 }
-async function m(i) {
-  const e = await i(), s = `demiurge-refresh-contract:${Date.now()}:${Math.random()}`, t = `${s}:entry`, l = `${s}:tag`, o = `${s}:first`, n = `${s}:second`, u = Date.now() + 6e4;
-  a(
+async function v(i) {
+  const e = await i(), s = `demiurge-refresh-contract:${Date.now()}:${Math.random()}`, a = `${s}:entry`, o = `${s}:tag`, u = `${s}:first`, r = `${s}:second`, l = Date.now() + 6e4;
+  t(
     !!(e.acquireRefreshLease && e.publishRefresh && e.releaseRefreshLease),
     "SWR support requires acquireRefreshLease(), publishRefresh(), and releaseRefreshLease()"
   );
-  const r = e.acquireRefreshLease, h = e.publishRefresh, c = e.releaseRefreshLease, f = {
+  const g = e.acquireRefreshLease, c = e.publishRefresh, n = e.releaseRefreshLease, h = {
     expiresAt: Date.now() - 1,
     staleUntil: Date.now() + 12e4,
-    tags: [l],
+    tags: [o],
     value: "original"
-  }, g = {
-    ...f,
+  }, f = {
+    ...h,
     expiresAt: Date.now() + 6e4,
     value: "refreshed"
   };
   try {
-    await e.set(t, f), a(
-      await r(t, o, u),
+    await e.set(a, h), t(
+      await g(a, u, l),
       "acquireRefreshLease() must acquire an unowned key"
-    ), a(
-      !await r(t, n, u),
+    ), t(
+      !await g(a, r, l),
       "acquireRefreshLease() must exclude a second owner"
-    ), a(
-      !await h(t, n, g),
+    ), t(
+      !await c(a, r, f),
       "publishRefresh() must reject a non-owner token"
-    ), await c(t, n), a(
-      !await r(t, n, u),
+    ), await n(a, r), t(
+      !await g(a, r, l),
       "releaseRefreshLease() must not release another owner's lease"
-    ), a(
-      await h(t, o, g),
+    ), t(
+      await c(a, u, f),
       "publishRefresh() must atomically publish for the current owner"
-    ), w(
-      await e.get(t),
-      g,
+    ), d(
+      await e.get(a),
+      f,
       "publishRefresh() for the current owner"
-    ), a(
-      await r(t, n, u),
+    ), t(
+      await g(a, r, l),
       "successful publication must release the refresh lease"
-    ), a(await e.delete(t), "delete() must remove the refreshed entry"), a(
-      !await h(t, n, f),
+    ), t(await e.delete(a), "delete() must remove the refreshed entry"), t(
+      !await c(a, r, h),
       "delete() must cancel an in-flight refresh lease"
-    ), await e.set(t, f), a(
-      await r(t, o, u),
+    ), await e.set(a, h), t(
+      await g(a, u, l),
       "a lease must be reusable after deletion"
-    ), a(
-      await e.invalidateTags([l]) === 1,
+    ), t(
+      await e.invalidateTags([o]) === 1,
       "invalidateTags() must remove the leased entry"
-    ), a(
-      !await h(t, o, g),
+    ), t(
+      !await c(a, u, f),
       "tag invalidation must cancel an in-flight refresh lease"
     );
   } finally {
-    await e.delete(t);
+    await e.delete(a);
   }
 }
-function w(i, e, s) {
-  a(!!i, `${s} must preserve the entry`), a(
+function d(i, e, s) {
+  t(!!i, `${s} must preserve the entry`), t(
     i?.expiresAt === e.expiresAt,
     `${s} must preserve expiresAt`
-  ), a(
+  ), t(
+    !!i?.negative == !!e.negative,
+    `${s} must preserve the negative flag`
+  ), t(
     i?.staleUntil === e.staleUntil,
     `${s} must preserve staleUntil`
-  ), a(
+  ), t(
     JSON.stringify(i?.tags) === JSON.stringify(e.tags),
     `${s} must preserve tags`
-  ), a(
+  ), t(
     JSON.stringify(i?.value) === JSON.stringify(e.value),
     `${s} must preserve JSON-compatible values`
   );
 }
-function a(i, e) {
+function t(i, e) {
   if (!i)
     throw new Error(`Cache store contract failed: ${e}.`);
 }
 export {
-  d as verifyCacheStoreContract,
-  m as verifyCacheStoreRefreshContract
+  m as verifyCacheStoreContract,
+  v as verifyCacheStoreRefreshContract
 };
 //# sourceMappingURL=testing.js.map

package/dist/data/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","sources":["../../src/data/testing.ts"],"sourcesContent":["import type { CacheStore, CacheStoreEntry } from \"./cache\";\n\ntype MaybePromise<T> = T | Promise<T>;\n\nexport type CacheStoreFactory = () => MaybePromise<CacheStore>;\n\nexport async function verifyCacheStoreContract(\n  createStore: CacheStoreFactory,\n) {\n  const store = await createStore();\n  const prefix = `demiurge-contract:${Date.now()}:${Math.random()}`;\n  const alphaKey = `${prefix}:alpha`;\n  const betaKey = `${prefix}:beta`;\n  const gammaKey = `${prefix}:gamma`;\n  const alphaTag = `${prefix}:tag:alpha`;\n  const betaTag = `${prefix}:tag:beta`;\n  const future = Date.now() + 60_000;\n  const alpha = {\n    expiresAt: future,\n    staleUntil: future + 5_000,\n    tags: [alphaTag],\n    value: { id: \"alpha\", revision: 1 },\n  } satisfies CacheStoreEntry;\n\n  try {\n    assert(\n      await store.get(alphaKey) === undefined,\n      \"get() must return undefined for a missing key\",\n    );\n\n    await store.set(alphaKey, alpha);\n    assertEntry(await store.get(alphaKey), alpha, \"set() then get()\");\n\n    const updatedAlpha = {\n      ...alpha,\n      value: { id: \"alpha\", revision: 2 },\n    } satisfies CacheStoreEntry;\n    await store.set(alphaKey, updatedAlpha);\n    assertEntry(\n      await store.get(alphaKey),\n      updatedAlpha,\n      \"set() must replace an existing key\",\n    );\n\n    await store.set(betaKey, {\n      expiresAt: future + 10_000,\n      staleUntil: future + 15_000,\n      tags: [betaTag],\n      value: \"beta\",\n    });\n    await store.set(gammaKey, {\n      expiresAt: future + 20_000,\n      staleUntil: future + 25_000,\n      tags: [alphaTag, betaTag],\n      value: [\"gamma\"],\n    });\n\n    assert(\n      await store.invalidateTags([alphaTag]) === 2,\n      \"invalidateTags() must return the number of entries deleted, counting each entry once\",\n    );\n    assert(\n      await store.get(alphaKey) === undefined &&\n        await store.get(gammaKey) === undefined,\n      \"invalidateTags() must delete every entry carrying a matching tag\",\n    );\n    assert(\n      (await store.get(betaKey))?.value === \"beta\",\n      \"invalidateTags() must preserve entries with no matching tag\",\n    );\n    assert(\n      await store.delete(betaKey) === true,\n      \"delete() must report an existing key\",\n    );\n    assert(\n      await store.delete(betaKey) === false,\n      \"delete() must report a missing key\",\n    );\n  } finally {\n    await Promise.all([\n      store.delete(alphaKey),\n      store.delete(betaKey),\n      store.delete(gammaKey),\n    ]);\n  }\n}\n\nexport async function verifyCacheStoreRefreshContract(\n  createStore: CacheStoreFactory,\n) {\n  const store = await createStore();\n  const prefix = `demiurge-refresh-contract:${Date.now()}:${Math.random()}`;\n  const key = `${prefix}:entry`;\n  const tag = `${prefix}:tag`;\n  const firstToken = `${prefix}:first`;\n  const secondToken = `${prefix}:second`;\n  const leaseExpiresAt = Date.now() + 60_000;\n\n  assert(\n    Boolean(\n      store.acquireRefreshLease &&\n        store.publishRefresh &&\n        store.releaseRefreshLease,\n    ),\n    \"SWR support requires acquireRefreshLease(), publishRefresh(), and releaseRefreshLease()\",\n  );\n\n  const acquireRefreshLease = store.acquireRefreshLease!;\n  const publishRefresh = store.publishRefresh!;\n  const releaseRefreshLease = store.releaseRefreshLease!;\n  const original = {\n    expiresAt: Date.now() - 1,\n    staleUntil: Date.now() + 120_000,\n    tags: [tag],\n    value: \"original\",\n  } satisfies CacheStoreEntry;\n  const refreshed = {\n    ...original,\n    expiresAt: Date.now() + 60_000,\n    value: \"refreshed\",\n  } satisfies CacheStoreEntry;\n\n  try {\n    await store.set(key, original);\n    assert(\n      await acquireRefreshLease(key, firstToken, leaseExpiresAt),\n      \"acquireRefreshLease() must acquire an unowned key\",\n    );\n    assert(\n      !await acquireRefreshLease(key, secondToken, leaseExpiresAt),\n      \"acquireRefreshLease() must exclude a second owner\",\n    );\n    assert(\n      !await publishRefresh(key, secondToken, refreshed),\n      \"publishRefresh() must reject a non-owner token\",\n    );\n    await releaseRefreshLease(key, secondToken);\n    assert(\n      !await acquireRefreshLease(key, secondToken, leaseExpiresAt),\n      \"releaseRefreshLease() must not release another owner's lease\",\n    );\n    assert(\n      await publishRefresh(key, firstToken, refreshed),\n      \"publishRefresh() must atomically publish for the current owner\",\n    );\n    assertEntry(\n      await store.get(key),\n      refreshed,\n      \"publishRefresh() for the current owner\",\n    );\n    assert(\n      await acquireRefreshLease(key, secondToken, leaseExpiresAt),\n      \"successful publication must release the refresh lease\",\n    );\n    assert(await store.delete(key), \"delete() must remove the refreshed entry\");\n    assert(\n      !await publishRefresh(key, secondToken, original),\n      \"delete() must cancel an in-flight refresh lease\",\n    );\n\n    await store.set(key, original);\n    assert(\n      await acquireRefreshLease(key, firstToken, leaseExpiresAt),\n      \"a lease must be reusable after deletion\",\n    );\n    assert(\n      await store.invalidateTags([tag]) === 1,\n      \"invalidateTags() must remove the leased entry\",\n    );\n    assert(\n      !await publishRefresh(key, firstToken, refreshed),\n      \"tag invalidation must cancel an in-flight refresh lease\",\n    );\n  } finally {\n    await store.delete(key);\n  }\n}\n\nfunction assertEntry(\n  actual: CacheStoreEntry | undefined,\n  expected: CacheStoreEntry,\n  operation: string,\n) {\n  assert(Boolean(actual), `${operation} must preserve the entry`);\n  assert(\n    actual?.expiresAt === expected.expiresAt,\n    `${operation} must preserve expiresAt`,\n  );\n  assert(\n    actual?.staleUntil === expected.staleUntil,\n    `${operation} must preserve staleUntil`,\n  );\n  assert(\n    JSON.stringify(actual?.tags) === JSON.stringify(expected.tags),\n    `${operation} must preserve tags`,\n  );\n  assert(\n    JSON.stringify(actual?.value) === JSON.stringify(expected.value),\n    `${operation} must preserve JSON-compatible values`,\n  );\n}\n\nfunction assert(condition: boolean, requirement: string): asserts condition {\n  if (!condition) {\n    throw new Error(`Cache store contract failed: ${requirement}.`);\n  }\n}\n"],"names":["verifyCacheStoreContract","createStore","store","prefix","alphaKey","betaKey","gammaKey","alphaTag","betaTag","future","alpha","assert","assertEntry","updatedAlpha","verifyCacheStoreRefreshContract","key","tag","firstToken","secondToken","leaseExpiresAt","acquireRefreshLease","publishRefresh","releaseRefreshLease","original","refreshed","actual","expected","operation","condition","requirement"],"mappings":"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"}
+{"version":3,"file":"testing.js","sources":["../../src/data/testing.ts"],"sourcesContent":["import type { CacheStore, CacheStoreEntry } from \"./cache\";\n\ntype MaybePromise<T> = T | Promise<T>;\n\nexport type CacheStoreFactory = () => MaybePromise<CacheStore>;\n\nexport async function verifyCacheStoreContract(\n  createStore: CacheStoreFactory,\n) {\n  const store = await createStore();\n  const prefix = `demiurge-contract:${Date.now()}:${Math.random()}`;\n  const alphaKey = `${prefix}:alpha`;\n  const betaKey = `${prefix}:beta`;\n  const gammaKey = `${prefix}:gamma`;\n  const deltaKey = `${prefix}:delta`;\n  const alphaTag = `${prefix}:tag:alpha`;\n  const betaTag = `${prefix}:tag:beta`;\n  const deltaTag = `${prefix}:tag:delta`;\n  const future = Date.now() + 60_000;\n  const alpha = {\n    expiresAt: future,\n    staleUntil: future + 5_000,\n    tags: [alphaTag],\n    value: { id: \"alpha\", revision: 1 },\n  } satisfies CacheStoreEntry;\n\n  try {\n    assert(\n      await store.get(alphaKey) === undefined,\n      \"get() must return undefined for a missing key\",\n    );\n\n    await store.set(alphaKey, alpha);\n    assertEntry(await store.get(alphaKey), alpha, \"set() then get()\");\n\n    const updatedAlpha = {\n      ...alpha,\n      value: { id: \"alpha\", revision: 2 },\n    } satisfies CacheStoreEntry;\n    await store.set(alphaKey, updatedAlpha);\n    assertEntry(\n      await store.get(alphaKey),\n      updatedAlpha,\n      \"set() must replace an existing key\",\n    );\n\n    await store.set(betaKey, {\n      expiresAt: future + 10_000,\n      staleUntil: future + 15_000,\n      tags: [betaTag],\n      value: \"beta\",\n    });\n    await store.set(gammaKey, {\n      expiresAt: future + 20_000,\n      staleUntil: future + 25_000,\n      tags: [alphaTag, betaTag],\n      value: [\"gamma\"],\n    });\n\n    assert(\n      await store.invalidateTags([alphaTag]) === 2,\n      \"invalidateTags() must return the number of entries deleted, counting each entry once\",\n    );\n    assert(\n      await store.get(alphaKey) === undefined &&\n        await store.get(gammaKey) === undefined,\n      \"invalidateTags() must delete every entry carrying a matching tag\",\n    );\n    assert(\n      (await store.get(betaKey))?.value === \"beta\",\n      \"invalidateTags() must preserve entries with no matching tag\",\n    );\n    assert(\n      await store.delete(betaKey) === true,\n      \"delete() must report an existing key\",\n    );\n    assert(\n      await store.delete(betaKey) === false,\n      \"delete() must report a missing key\",\n    );\n\n    // A negative entry (a loader's `cacheNotFound()` result) round-trips\n    // like any other entry, and tag invalidation clears it the same way it\n    // clears a positive result.\n    const delta = {\n      expiresAt: future,\n      negative: true,\n      staleUntil: future,\n      tags: [deltaTag],\n      value: \"not found\",\n    } satisfies CacheStoreEntry;\n\n    await store.set(deltaKey, delta);\n    assertEntry(\n      await store.get(deltaKey),\n      delta,\n      \"set() then get() for a negative entry\",\n    );\n    assert(\n      await store.invalidateTags([deltaTag]) === 1,\n      \"invalidateTags() must delete a negative entry carrying a matching tag\",\n    );\n    assert(\n      await store.get(deltaKey) === undefined,\n      \"invalidateTags() must remove a negative entry the same as a positive one\",\n    );\n  } finally {\n    await Promise.all([\n      store.delete(alphaKey),\n      store.delete(betaKey),\n      store.delete(gammaKey),\n      store.delete(deltaKey),\n    ]);\n  }\n}\n\nexport async function verifyCacheStoreRefreshContract(\n  createStore: CacheStoreFactory,\n) {\n  const store = await createStore();\n  const prefix = `demiurge-refresh-contract:${Date.now()}:${Math.random()}`;\n  const key = `${prefix}:entry`;\n  const tag = `${prefix}:tag`;\n  const firstToken = `${prefix}:first`;\n  const secondToken = `${prefix}:second`;\n  const leaseExpiresAt = Date.now() + 60_000;\n\n  assert(\n    Boolean(\n      store.acquireRefreshLease &&\n        store.publishRefresh &&\n        store.releaseRefreshLease,\n    ),\n    \"SWR support requires acquireRefreshLease(), publishRefresh(), and releaseRefreshLease()\",\n  );\n\n  const acquireRefreshLease = store.acquireRefreshLease!;\n  const publishRefresh = store.publishRefresh!;\n  const releaseRefreshLease = store.releaseRefreshLease!;\n  const original = {\n    expiresAt: Date.now() - 1,\n    staleUntil: Date.now() + 120_000,\n    tags: [tag],\n    value: \"original\",\n  } satisfies CacheStoreEntry;\n  const refreshed = {\n    ...original,\n    expiresAt: Date.now() + 60_000,\n    value: \"refreshed\",\n  } satisfies CacheStoreEntry;\n\n  try {\n    await store.set(key, original);\n    assert(\n      await acquireRefreshLease(key, firstToken, leaseExpiresAt),\n      \"acquireRefreshLease() must acquire an unowned key\",\n    );\n    assert(\n      !await acquireRefreshLease(key, secondToken, leaseExpiresAt),\n      \"acquireRefreshLease() must exclude a second owner\",\n    );\n    assert(\n      !await publishRefresh(key, secondToken, refreshed),\n      \"publishRefresh() must reject a non-owner token\",\n    );\n    await releaseRefreshLease(key, secondToken);\n    assert(\n      !await acquireRefreshLease(key, secondToken, leaseExpiresAt),\n      \"releaseRefreshLease() must not release another owner's lease\",\n    );\n    assert(\n      await publishRefresh(key, firstToken, refreshed),\n      \"publishRefresh() must atomically publish for the current owner\",\n    );\n    assertEntry(\n      await store.get(key),\n      refreshed,\n      \"publishRefresh() for the current owner\",\n    );\n    assert(\n      await acquireRefreshLease(key, secondToken, leaseExpiresAt),\n      \"successful publication must release the refresh lease\",\n    );\n    assert(await store.delete(key), \"delete() must remove the refreshed entry\");\n    assert(\n      !await publishRefresh(key, secondToken, original),\n      \"delete() must cancel an in-flight refresh lease\",\n    );\n\n    await store.set(key, original);\n    assert(\n      await acquireRefreshLease(key, firstToken, leaseExpiresAt),\n      \"a lease must be reusable after deletion\",\n    );\n    assert(\n      await store.invalidateTags([tag]) === 1,\n      \"invalidateTags() must remove the leased entry\",\n    );\n    assert(\n      !await publishRefresh(key, firstToken, refreshed),\n      \"tag invalidation must cancel an in-flight refresh lease\",\n    );\n  } finally {\n    await store.delete(key);\n  }\n}\n\nfunction assertEntry(\n  actual: CacheStoreEntry | undefined,\n  expected: CacheStoreEntry,\n  operation: string,\n) {\n  assert(Boolean(actual), `${operation} must preserve the entry`);\n  assert(\n    actual?.expiresAt === expected.expiresAt,\n    `${operation} must preserve expiresAt`,\n  );\n  assert(\n    Boolean(actual?.negative) === Boolean(expected.negative),\n    `${operation} must preserve the negative flag`,\n  );\n  assert(\n    actual?.staleUntil === expected.staleUntil,\n    `${operation} must preserve staleUntil`,\n  );\n  assert(\n    JSON.stringify(actual?.tags) === JSON.stringify(expected.tags),\n    `${operation} must preserve tags`,\n  );\n  assert(\n    JSON.stringify(actual?.value) === JSON.stringify(expected.value),\n    `${operation} must preserve JSON-compatible values`,\n  );\n}\n\nfunction assert(condition: boolean, requirement: string): asserts condition {\n  if (!condition) {\n    throw new Error(`Cache store contract failed: ${requirement}.`);\n  }\n}\n"],"names":["verifyCacheStoreContract","createStore","store","prefix","alphaKey","betaKey","gammaKey","deltaKey","alphaTag","betaTag","deltaTag","future","alpha","assert","assertEntry","updatedAlpha","delta","verifyCacheStoreRefreshContract","key","tag","firstToken","secondToken","leaseExpiresAt","acquireRefreshLease","publishRefresh","releaseRefreshLease","original","refreshed","actual","expected","operation","condition","requirement"],"mappings":"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"}

package/dist/data/tiered.d.ts

@@ -0,0 +1,7 @@
+import type { CacheStore } from "./cache";
+export type TieredCacheStoreOptions = {
+    l1: CacheStore;
+    l2: CacheStore;
+};
+export declare function createTieredCacheStore(options: TieredCacheStoreOptions): CacheStore;
+//# sourceMappingURL=tiered.d.ts.map

package/dist/data/tiered.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiered.d.ts","sourceRoot":"","sources":["../../src/data/tiered.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,MAAM,uBAAuB,GAAG;IAGpC,EAAE,EAAE,UAAU,CAAC;IAKf,EAAE,EAAE,UAAU,CAAC;CAChB,CAAC;AAiBF,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,UAAU,CAqEZ"}

package/dist/deployment/testing.d.ts

@@ -0,0 +1,25 @@
+type MaybePromise<T> = T | Promise<T>;
+export type DeploymentCapability = "clientAddress" | "readiness" | "repeatedHeaders" | "requestUrl" | "securityHeaders" | "sharedCache" | "staticAssets" | "streaming";
+export type DeploymentClaims = Record<DeploymentCapability, boolean>;
+export type DeploymentReadinessHost = {
+    afterShutdown: () => MaybePromise<Response>;
+    ready: () => MaybePromise<Response>;
+    shutdown: () => MaybePromise<void>;
+};
+export type DeploymentSharedCacheHost = {
+    readFromPeer: (key: string) => MaybePromise<Response>;
+    writeFromOrigin: (key: string, value: string) => MaybePromise<Response>;
+};
+export type DeploymentContractProbes = {
+    clientAddress?: (forwardedFor: string) => MaybePromise<Response>;
+    readiness?: () => MaybePromise<DeploymentReadinessHost>;
+    repeatedHeaders?: () => MaybePromise<Response>;
+    requestUrl?: (pathname: string, search: string) => MaybePromise<Response>;
+    securityHeaders?: () => MaybePromise<Response>;
+    sharedCache?: () => MaybePromise<DeploymentSharedCacheHost>;
+    staticAssets?: () => MaybePromise<Response>;
+    streaming?: () => MaybePromise<Response>;
+};
+export declare function verifyDeploymentContract(claims: DeploymentClaims, probes: DeploymentContractProbes): Promise<void>;
+export {};
+//# sourceMappingURL=testing.d.ts.map

package/dist/deployment/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/deployment/testing.ts"],"names":[],"mappings":"AAcA,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC,MAAM,MAAM,oBAAoB,GAC5B,eAAe,GACf,WAAW,GACX,iBAAiB,GACjB,YAAY,GACZ,iBAAiB,GACjB,aAAa,GACb,cAAc,GACd,WAAW,CAAC;AAEhB,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;AAErE,MAAM,MAAM,uBAAuB,GAAG;IACpC,aAAa,EAAE,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC5C,KAAK,EAAE,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,YAAY,CAAC,QAAQ,CAAC,CAAC;IACtD,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,YAAY,CAAC,QAAQ,CAAC,CAAC;CACzE,CAAC;AAKF,MAAM,MAAM,wBAAwB,GAAG;IACrC,aAAa,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,YAAY,CAAC,QAAQ,CAAC,CAAC;IACjE,SAAS,CAAC,EAAE,MAAM,YAAY,CAAC,uBAAuB,CAAC,CAAC;IACxD,eAAe,CAAC,EAAE,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/C,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC1E,eAAe,CAAC,EAAE,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/C,WAAW,CAAC,EAAE,MAAM,YAAY,CAAC,yBAAyB,CAAC,CAAC;IAC5D,YAAY,CAAC,EAAE,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;CAC1C,CAAC;AAeF,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,wBAAwB,iBAmDjC"}

package/dist/deployment/testing.js

@@ -0,0 +1,171 @@
+const y = [
+  "clientAddress",
+  "readiness",
+  "repeatedHeaders",
+  "requestUrl",
+  "securityHeaders",
+  "sharedCache",
+  "staticAssets",
+  "streaming"
+], f = /'nonce-([^']+)'/;
+async function b(a, e) {
+  for (const t of y) {
+    const n = a[t], r = e[t];
+    s(
+      typeof n == "boolean",
+      `a deployment must declare capability "${t}" as a boolean`
+    ), s(
+      !n || !!r,
+      `capability "${t}" is declared true and needs a probe that proves it`
+    ), s(
+      n || !r,
+      `capability "${t}" has a probe but the deployment declares it false`
+    );
+  }
+  e.requestUrl && await m(e.requestUrl), e.clientAddress && await w(e.clientAddress), e.streaming && await p(e.streaming), e.repeatedHeaders && await g(e.repeatedHeaders), e.staticAssets && await $(e.staticAssets), e.securityHeaders && await S(e.securityHeaders), e.sharedCache && await C(e.sharedCache), e.readiness && await v(e.readiness);
+}
+async function m(a) {
+  const e = "/deployment-contract/request-url-probe", t = `?probe=${Date.now()}`, n = await a(e, t), r = await d(n, "the request-url probe");
+  s(
+    r.pathname === e,
+    `the deployment must report the client's request pathname, and it reported ${JSON.stringify(r.pathname)} instead of ${JSON.stringify(e)}`
+  ), s(
+    r.search === t,
+    `the deployment must report the client's request query string, and it reported ${JSON.stringify(r.search)} instead of ${JSON.stringify(t)}`
+  );
+}
+async function w(a) {
+  const e = `203.0.113.${1 + Math.floor(Math.random() * 200)}`, t = `198.51.100.${1 + Math.floor(Math.random() * 200)}`, n = await d(await a(e), "the client-address probe"), r = await d(await a(t), "the client-address probe");
+  s(
+    n.address === e,
+    `the deployment must translate the forwarded client address, and it reported ${JSON.stringify(n.address)} instead of ${JSON.stringify(e)}`
+  ), s(
+    r.address === t,
+    `the deployment must translate the forwarded client address, and it reported ${JSON.stringify(r.address)} instead of ${JSON.stringify(t)}`
+  );
+}
+async function p(a) {
+  const e = await a();
+  s(
+    !!e.body,
+    "a streaming response must expose a readable body stream"
+  );
+  const t = e.body.getReader(), n = new TextDecoder();
+  let r = 0, o = "";
+  for (; ; ) {
+    const c = await t.read();
+    if (c.done)
+      break;
+    r += 1, o += n.decode(c.value, { stream: !0 });
+  }
+  o += n.decode(), s(o.length > 0, "a streaming response must deliver a body"), s(
+    r > 1,
+    "a streaming response must deliver its body in more than one chunk"
+  );
+  const i = await a();
+  try {
+    await i.body?.cancel();
+  } catch (c) {
+    throw u(
+      `a streaming response body must accept cancellation, and it failed with ${h(c)}`
+    );
+  }
+}
+async function g(a) {
+  const e = await a(), t = typeof e.headers.getSetCookie == "function" ? e.headers.getSetCookie() : [];
+  s(
+    t.length >= 2,
+    `a deployment must forward every Set-Cookie header as a distinct value, and it reported ${t.length}`
+  );
+  const n = t.map((r) => r.split("=")[0]);
+  s(
+    new Set(n).size === n.length,
+    "a deployment must forward every declared cookie without dropping or duplicating one"
+  );
+}
+async function $(a) {
+  const e = await a();
+  s(e.ok, `a static asset request must succeed, and it returned ${e.status}`);
+  const t = (e.headers.get("cache-control") ?? "").toLowerCase();
+  s(
+    t.includes("immutable") && t.includes("max-age"),
+    `a fingerprinted static asset must carry an immutable, long-lived cache-control header, and it carried ${JSON.stringify(t)}`
+  );
+  const n = await e.text(), o = await (await a()).text();
+  s(
+    n === o,
+    "a repeated static asset request must return the same bytes"
+  );
+}
+async function S(a) {
+  const e = await a(), t = await a(), n = l(e), r = l(t);
+  s(
+    !!n,
+    "a security-headers response must declare a content-security-policy nonce source"
+  ), s(
+    !!r && r !== n,
+    "every response must carry a freshly generated nonce"
+  );
+  const o = await e.text();
+  s(
+    o.includes(`nonce="${n}"`),
+    "the rendered document must carry the nonce its header declares"
+  ), await t.body?.cancel(), s(
+    (e.headers.get("x-content-type-options") ?? "").toLowerCase() === "nosniff",
+    "a security-headers response must carry x-content-type-options nosniff"
+  );
+}
+async function C(a) {
+  const e = await a(), t = `deployment-contract-${Date.now()}-${Math.random().toString(36).slice(2)}`, n = `shared-cache-probe-${Math.random().toString(36).slice(2)}`, r = await e.writeFromOrigin(t, n);
+  s(
+    r.ok,
+    `writing to the shared cache must succeed, and it returned ${r.status}`
+  );
+  const o = await e.readFromPeer(t), i = await o.text();
+  s(
+    o.ok,
+    `reading the shared cache from a peer instance must succeed, and it returned ${o.status}`
+  ), s(
+    i === n,
+    `a value written to the shared cache must be visible from another instance, and it read ${JSON.stringify(i)} instead of ${JSON.stringify(n)}`
+  );
+}
+async function v(a) {
+  const e = await a(), t = await e.ready();
+  s(
+    t.ok,
+    `the readiness probe must succeed before shutdown, and it returned ${t.status}`
+  ), await e.shutdown(), await e.shutdown();
+  const n = await e.afterShutdown();
+  s(
+    !n.ok,
+    `the readiness probe must stop reporting ready once shutdown starts, and it returned ${n.status}`
+  );
+}
+async function d(a, e) {
+  try {
+    return await a.json();
+  } catch (t) {
+    throw u(
+      `${e} must return a JSON body, and it failed with ${h(t)}`
+    );
+  }
+}
+function l(a) {
+  const e = a.headers.get("content-security-policy") ?? "";
+  return f.exec(e)?.[1];
+}
+function h(a) {
+  return a instanceof Error ? a.message : String(a);
+}
+function s(a, e) {
+  if (!a)
+    throw u(e);
+}
+function u(a) {
+  return new Error(`Deployment contract failed: ${a}.`);
+}
+export {
+  b as verifyDeploymentContract
+};
+//# sourceMappingURL=testing.js.map