@preprio/toolkit 0.6.0-alpha.6 → 0.6.0-alpha.8

package/dist/graphql.cjs

@@ -20,12 +20,15 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/graphql.ts
 var graphql_exports = {};
 __export(graphql_exports, {
+  PREPR_ANY_ITEM_TAG: () => PREPR_ANY_ITEM_TAG,
   PREPR_DEFAULT_VARIANT: () => PREPR_DEFAULT_VARIANT,
   PreprError: () => PreprError,
   createPreprClient: () => createPreprClient,
   decisionsFrom: () => decisionsFrom,
   isPersonalizedResponse: () => isPersonalizedResponse,
   loadPreprSchema: () => loadPreprSchema,
+  preprCacheTags: () => preprCacheTags,
+  preprModelTag: () => preprModelTag,
   preprVariantProps: () => preprVariantProps,
   resolveVariants: () => resolveVariants,
   splitStack: () => splitStack,
@@ -34,6 +37,31 @@ __export(graphql_exports, {
 });
 module.exports = __toCommonJS(graphql_exports);
 
+// src/core/graphql/cache-tags.ts
+var MAX_TAGS = 128;
+var MAX_TAG_LENGTH = 256;
+var PREPR_ANY_ITEM_TAG = "prepr:any";
+var preprItemTag = (id) => `prepr:${id}`;
+var NOT_ALPHANUMERIC = /[^a-z0-9]/g;
+var preprModelTag = (model) => `prepr:model:${model.toLowerCase().replace(NOT_ALPHANUMERIC, "")}`;
+function preprCacheTags(data) {
+  const tags = /* @__PURE__ */ new Set();
+  const stack = [data];
+  while (stack.length > 0) {
+    const value = stack.pop();
+    if (typeof value !== "object" || value === null) continue;
+    const id = value._id;
+    if (typeof id === "string" && id !== "") {
+      const tag = preprItemTag(id);
+      if (tag.length > MAX_TAG_LENGTH) return [PREPR_ANY_ITEM_TAG];
+      tags.add(tag);
+      if (tags.size > MAX_TAGS) return [PREPR_ANY_ITEM_TAG];
+    }
+    for (const child of Object.values(value)) stack.push(child);
+  }
+  return [...tags];
+}
+
 // src/core/server.ts
 var PreprError = class extends Error {
   constructor(message, code, context, originalError) {
@@ -148,7 +176,10 @@ function decisionSelectionSet(set, typeName, path, ctx) {
         path,
         ctx
       );
-      if (pruned) {
+      if (!pruned) continue;
+      if (fragment.typeCondition.name.value === typeName) {
+        selections.push(...pruned.selections);
+      } else {
         selections.push(
           inlineFragment(fragment.typeCondition.name.value, [
             ...pruned.selections
@@ -158,13 +189,19 @@ function decisionSelectionSet(set, typeName, path, ctx) {
       continue;
     }
     if (selection.kind === "InlineFragment") {
+      const condition = selection.typeCondition?.name.value ?? typeName;
       const pruned = decisionSelectionSet(
         selection.selectionSet,
-        selection.typeCondition?.name.value ?? typeName,
+        condition,
         path,
         ctx
       );
-      if (pruned) selections.push({ ...selection, selectionSet: pruned });
+      if (!pruned) continue;
+      if (condition === typeName && !selection.directives?.length) {
+        selections.push(...pruned.selections);
+      } else {
+        selections.push({ ...selection, selectionSet: pruned });
+      }
       continue;
     }
     if (!selection.selectionSet) continue;
@@ -238,20 +275,58 @@ function toDecisionDocument(document2, schema, groupPaths, options) {
   const used = /* @__PURE__ */ new Set();
   collectVariables(pruned, used);
   collectVariables(operation.directives, used);
+  const shared = sharedContextFragment(schema);
   return {
     kind: "Document",
     definitions: [
+      ...shared ? [shared.definition] : [],
       {
         ...operation,
         name: operation.name && name(`${operation.name.value}Decision`),
         variableDefinitions: (operation.variableDefinitions ?? []).filter(
           (definition) => used.has(definition.variable.name.value)
         ),
-        selectionSet: pruned
+        selectionSet: shared ? shared.apply(pruned) : pruned
       }
     ]
   };
 }
+function sharedContextFragment(schema) {
+  const contextTypes = new Set(
+    Object.values(schema.types).flatMap(
+      (type) => type.hasContext ? [type.fields._context.type] : []
+    )
+  );
+  if (contextTypes.size !== 1) return null;
+  const [contextType] = contextTypes;
+  const fragmentName = "c";
+  const definition = {
+    kind: "FragmentDefinition",
+    name: name(fragmentName),
+    typeCondition: { kind: "NamedType", name: name(contextType) },
+    selectionSet: selectionSet(
+      ["kind", "group_id", "variant_id"].map(
+        (field) => ({ kind: "Field", name: name(field) })
+      )
+    )
+  };
+  const spread = {
+    kind: "FragmentSpread",
+    name: name(fragmentName)
+  };
+  const apply = (set) => selectionSet(
+    set.selections.map((selection) => {
+      if (selection.kind === "Field" && selection.alias?.value === PREPR_CONTEXT_ALIAS) {
+        return { ...selection, selectionSet: selectionSet([spread]) };
+      }
+      return "selectionSet" in selection && selection.selectionSet ? {
+        ...selection,
+        selectionSet: apply(selection.selectionSet)
+      } : selection;
+    })
+  );
+  return { definition, apply };
+}
 
 // src/core/variants/probe-document.ts
 function probeSelectionSet(set, fragments) {
@@ -825,6 +900,7 @@ function createVaryProbe(run, options) {
 }
 
 // src/core/graphql/client.ts
+var clientSchemas = /* @__PURE__ */ new WeakMap();
 function isParseableUrl(url) {
   try {
     new URL(url);
@@ -861,7 +937,7 @@ function createPreprClient(options) {
   ));
   const variantsDocuments = /* @__PURE__ */ new Map();
   const decisionDocuments = /* @__PURE__ */ new Map();
-  return {
+  const client = {
     async query(document2, variables, queryOptions = {}) {
       const { variants, ...rest } = queryOptions;
       if (!variants) return run(document2, variables, rest);
@@ -873,10 +949,10 @@ function createPreprClient(options) {
       return run(derived, variables, rest);
     },
     async decide(document2, variables, queryOptions = {}) {
-      const { from, topLevelOnly, ...rest } = queryOptions;
+      const { from, ...rest } = queryOptions;
       const paths = from === void 0 ? void 0 : personalizationPaths(from);
       if (paths && paths.size === 0) return /* @__PURE__ */ new Map();
-      const signature = paths ? [...paths].map(([path, types]) => `${path}:${[...types].sort().join(",")}`).sort().join("|") : topLevelOnly ? "top" : "*";
+      const signature = paths ? [...paths].map(([path, types]) => `${path}:${[...types].sort().join(",")}`).sort().join("|") : "*";
       let byPaths = decisionDocuments.get(document2);
       if (!byPaths) {
         byPaths = /* @__PURE__ */ new Map();
@@ -884,9 +960,7 @@ function createPreprClient(options) {
       }
       let derived = byPaths.get(signature);
       if (derived === void 0) {
-        derived = toDecisionDocument(document2, await loadSchema(), paths, {
-          topLevelOnly: !paths && topLevelOnly
-        });
+        derived = toDecisionDocument(document2, await loadSchema(), paths);
         byPaths.set(signature, derived);
       }
       if (!derived) return /* @__PURE__ */ new Map();
@@ -900,6 +974,8 @@ function createPreprClient(options) {
       (vary) => vary === null || SEGMENTS_VARY.test(vary)
     )
   };
+  clientSchemas.set(client, loadSchema);
+  return client;
 }
 
 // src/core/graphql/schema-loader.ts
@@ -927,12 +1003,15 @@ async function loadPreprSchema(url, options = {}) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  PREPR_ANY_ITEM_TAG,
   PREPR_DEFAULT_VARIANT,
   PreprError,
   createPreprClient,
   decisionsFrom,
   isPersonalizedResponse,
   loadPreprSchema,
+  preprCacheTags,
+  preprModelTag,
   preprVariantProps,
   resolveVariants,
   splitStack,

package/dist/graphql.d.cts

@@ -96,39 +96,6 @@ interface PreprVariantProps {
  */
 declare function preprVariantProps(item: unknown): PreprVariantProps;
 
-/**
- * The schema facts the query rewrites need, from `loadPreprSchema`. Pass it
- * along; its shape is not part of the public API.
- */
-type PreprSchema = PreprSchemaInfo;
-/**
- * Your query, asking for every personalization and A/B variant: what
- * `query(..., { variants: true })` sends, as a string for your own GraphQL
- * client. The result is the same for every visitor, so cache it like any
- * other content query, and render it with `resolveVariants` or `PreprStack`.
- *
- * A query without personalizable fields comes back unchanged (minified).
- */
-declare function toVariantsQuery(document: PreprDocument<unknown, unknown> | string, schema: PreprSchema): string;
-/**
- * The per-visitor decision query for the same query: send it with the
- * visitor's Prepr headers, never cached, and pass the response's `data` to
- * `decisionsFrom`.
- *
- * Pass the variants result as `from` whenever you have it: the query then
- * asks only about the lists that hold segment groups on this page, which is
- * a few hundred bytes instead of the whole page and markedly faster for a
- * visitor Prepr has not seen before. Without `from` it asks about every
- * personalizable list. `topLevelOnly` stops at the first personalizable list
- * on each path, for middleware that decides only the top of a stack.
- *
- * Null when there is nothing to decide: send no request then.
- */
-declare function toDecisionQuery(document: PreprDocument<unknown, unknown> | string, schema: PreprSchema, options?: {
-    from?: unknown;
-    topLevelOnly?: boolean;
-}): string | null;
-
 /**
  * A GraphQL document accepted by `query`: a plain string, graphql-codegen's
  * `TypedDocumentString` (`documentMode: 'string'`), or any `DocumentNode`,
@@ -222,11 +189,6 @@ interface PreprDecideOptions extends Omit<PreprQueryOptions, 'variants'> {
      * none, e.g. on pages with only A/B tests or no personalization.
      */
     from?: unknown;
-    /**
-     * @internal Ask only about the first personalizable list on each path,
-     * without `from`: what middleware needs for groups at the top of a stack.
-     */
-    topLevelOnly?: boolean;
 }
 interface PreprQueryResult<TResult> {
     data: TResult;
@@ -271,6 +233,74 @@ interface PreprClient {
     hasSegments<TVariables>(document: PreprDocument<unknown, TVariables>, variables?: TVariables): Promise<boolean>;
 }
 
+/**
+ * The schema facts the query rewrites need, from `loadPreprSchema`. Pass it
+ * along; its shape is not part of the public API.
+ */
+type PreprSchema = PreprSchemaInfo;
+/**
+ * Your query, asking for every personalization and A/B variant: what
+ * `query(..., { variants: true })` sends, as a string for your own GraphQL
+ * client. The result is the same for every visitor, so cache it like any
+ * other content query, and render it with `resolveVariants` or `PreprStack`.
+ *
+ * A query without personalizable fields comes back unchanged (minified).
+ */
+declare function toVariantsQuery(document: PreprDocument<unknown, unknown> | string, schema: PreprSchema): string;
+/**
+ * The per-visitor decision query for the same query: send it with the
+ * visitor's Prepr headers, never cached, and pass the response's `data` to
+ * `decisionsFrom`.
+ *
+ * Pass the variants result as `from` whenever you have it: the query then
+ * asks only about the lists that hold segment groups on this page, which is
+ * a few hundred bytes instead of the whole page and markedly faster for a
+ * visitor Prepr has not seen before. Without `from` it asks about every
+ * personalizable list. `topLevelOnly` stops at the first personalizable list
+ * on each path, for middleware that decides only the top of a stack.
+ *
+ * Null when there is nothing to decide: send no request then.
+ */
+declare function toDecisionQuery(document: PreprDocument<unknown, unknown> | string, schema: PreprSchema, options?: {
+    from?: unknown;
+    topLevelOnly?: boolean;
+}): string | null;
+
+/**
+ * Tag for pages showing more items than fit in Next.js's tag limits. Every
+ * webhook event revalidates it, so those pages refresh on any change.
+ */
+declare const PREPR_ANY_ITEM_TAG = "prepr:any";
+/**
+ * Cache tag for every page listing items of one model. `tagItems` adds it to
+ * list queries and to lookups that found nothing; add it yourself with
+ * `cacheTag()` for other pages that depend on which items exist.
+ * `createPreprWebhookRoute` revalidates it when an item of that model is
+ * published, unpublished or deleted.
+ *
+ * The name is compared case-insensitively and without spaces or
+ * punctuation, so the model's name in Prepr (`'Blog post'`, as webhooks send
+ * it) and its GraphQL type (`BlogPost`) give the same tag. A model whose API
+ * ID was renamed away from its name gets two different tags.
+ *
+ * @param model The model's singular name in Prepr or its GraphQL type name.
+ */
+declare const preprModelTag: (model: string) => string;
+/**
+ * Cache tags for every Prepr item in a query result: `prepr:<_id>` for each
+ * object with a string `_id`, at any depth. Pair it with `cacheTag()` inside
+ * `'use cache'`, and a publish webhook revalidates only the pages that show
+ * the changed item. Run the query with `variants: true` so the tags cover
+ * every variant's items, not only those of one visitor.
+ *
+ * Next.js accepts at most 128 tags of 256 characters per `cacheTag()` call.
+ * A result past either limit returns `[PREPR_ANY_ITEM_TAG]` instead, which
+ * every webhook event revalidates.
+ *
+ * @param data A parsed JSON query result, such as `query()`'s `data`.
+ */
+declare function preprCacheTags(data: unknown): string[];
+
 /**
  * Create a GraphQL client for the Prepr API.
  *
@@ -302,4 +332,4 @@ declare function loadPreprSchema(url: string, options?: {
     fetch?: typeof fetch;
 }): Promise<PreprSchemaInfo>;
 
-export { PREPR_DEFAULT_VARIANT, type PreprClient, type PreprClientOptions, type PreprDecideOptions, type PreprDecisions, type PreprDocument, PreprHeaders, type PreprQueryOptions, type PreprQueryResult, type PreprSchema, type PreprStackBlock, type PreprStegaMode, type PreprVariantProps, type ResolveVariantsOptions, createPreprClient, decisionsFrom, loadPreprSchema, preprVariantProps, resolveVariants, splitStack, toDecisionQuery, toVariantsQuery };
+export { PREPR_ANY_ITEM_TAG, PREPR_DEFAULT_VARIANT, type PreprClient, type PreprClientOptions, type PreprDecideOptions, type PreprDecisions, type PreprDocument, PreprHeaders, type PreprQueryOptions, type PreprQueryResult, type PreprSchema, type PreprStackBlock, type PreprStegaMode, type PreprVariantProps, type ResolveVariantsOptions, createPreprClient, decisionsFrom, loadPreprSchema, preprCacheTags, preprModelTag, preprVariantProps, resolveVariants, splitStack, toDecisionQuery, toVariantsQuery };

package/dist/graphql.d.ts

@@ -96,39 +96,6 @@ interface PreprVariantProps {
  */
 declare function preprVariantProps(item: unknown): PreprVariantProps;
 
-/**
- * The schema facts the query rewrites need, from `loadPreprSchema`. Pass it
- * along; its shape is not part of the public API.
- */
-type PreprSchema = PreprSchemaInfo;
-/**
- * Your query, asking for every personalization and A/B variant: what
- * `query(..., { variants: true })` sends, as a string for your own GraphQL
- * client. The result is the same for every visitor, so cache it like any
- * other content query, and render it with `resolveVariants` or `PreprStack`.
- *
- * A query without personalizable fields comes back unchanged (minified).
- */
-declare function toVariantsQuery(document: PreprDocument<unknown, unknown> | string, schema: PreprSchema): string;
-/**
- * The per-visitor decision query for the same query: send it with the
- * visitor's Prepr headers, never cached, and pass the response's `data` to
- * `decisionsFrom`.
- *
- * Pass the variants result as `from` whenever you have it: the query then
- * asks only about the lists that hold segment groups on this page, which is
- * a few hundred bytes instead of the whole page and markedly faster for a
- * visitor Prepr has not seen before. Without `from` it asks about every
- * personalizable list. `topLevelOnly` stops at the first personalizable list
- * on each path, for middleware that decides only the top of a stack.
- *
- * Null when there is nothing to decide: send no request then.
- */
-declare function toDecisionQuery(document: PreprDocument<unknown, unknown> | string, schema: PreprSchema, options?: {
-    from?: unknown;
-    topLevelOnly?: boolean;
-}): string | null;
-
 /**
  * A GraphQL document accepted by `query`: a plain string, graphql-codegen's
  * `TypedDocumentString` (`documentMode: 'string'`), or any `DocumentNode`,
@@ -222,11 +189,6 @@ interface PreprDecideOptions extends Omit<PreprQueryOptions, 'variants'> {
      * none, e.g. on pages with only A/B tests or no personalization.
      */
     from?: unknown;
-    /**
-     * @internal Ask only about the first personalizable list on each path,
-     * without `from`: what middleware needs for groups at the top of a stack.
-     */
-    topLevelOnly?: boolean;
 }
 interface PreprQueryResult<TResult> {
     data: TResult;
@@ -271,6 +233,74 @@ interface PreprClient {
     hasSegments<TVariables>(document: PreprDocument<unknown, TVariables>, variables?: TVariables): Promise<boolean>;
 }
 
+/**
+ * The schema facts the query rewrites need, from `loadPreprSchema`. Pass it
+ * along; its shape is not part of the public API.
+ */
+type PreprSchema = PreprSchemaInfo;
+/**
+ * Your query, asking for every personalization and A/B variant: what
+ * `query(..., { variants: true })` sends, as a string for your own GraphQL
+ * client. The result is the same for every visitor, so cache it like any
+ * other content query, and render it with `resolveVariants` or `PreprStack`.
+ *
+ * A query without personalizable fields comes back unchanged (minified).
+ */
+declare function toVariantsQuery(document: PreprDocument<unknown, unknown> | string, schema: PreprSchema): string;
+/**
+ * The per-visitor decision query for the same query: send it with the
+ * visitor's Prepr headers, never cached, and pass the response's `data` to
+ * `decisionsFrom`.
+ *
+ * Pass the variants result as `from` whenever you have it: the query then
+ * asks only about the lists that hold segment groups on this page, which is
+ * a few hundred bytes instead of the whole page and markedly faster for a
+ * visitor Prepr has not seen before. Without `from` it asks about every
+ * personalizable list. `topLevelOnly` stops at the first personalizable list
+ * on each path, for middleware that decides only the top of a stack.
+ *
+ * Null when there is nothing to decide: send no request then.
+ */
+declare function toDecisionQuery(document: PreprDocument<unknown, unknown> | string, schema: PreprSchema, options?: {
+    from?: unknown;
+    topLevelOnly?: boolean;
+}): string | null;
+
+/**
+ * Tag for pages showing more items than fit in Next.js's tag limits. Every
+ * webhook event revalidates it, so those pages refresh on any change.
+ */
+declare const PREPR_ANY_ITEM_TAG = "prepr:any";
+/**
+ * Cache tag for every page listing items of one model. `tagItems` adds it to
+ * list queries and to lookups that found nothing; add it yourself with
+ * `cacheTag()` for other pages that depend on which items exist.
+ * `createPreprWebhookRoute` revalidates it when an item of that model is
+ * published, unpublished or deleted.
+ *
+ * The name is compared case-insensitively and without spaces or
+ * punctuation, so the model's name in Prepr (`'Blog post'`, as webhooks send
+ * it) and its GraphQL type (`BlogPost`) give the same tag. A model whose API
+ * ID was renamed away from its name gets two different tags.
+ *
+ * @param model The model's singular name in Prepr or its GraphQL type name.
+ */
+declare const preprModelTag: (model: string) => string;
+/**
+ * Cache tags for every Prepr item in a query result: `prepr:<_id>` for each
+ * object with a string `_id`, at any depth. Pair it with `cacheTag()` inside
+ * `'use cache'`, and a publish webhook revalidates only the pages that show
+ * the changed item. Run the query with `variants: true` so the tags cover
+ * every variant's items, not only those of one visitor.
+ *
+ * Next.js accepts at most 128 tags of 256 characters per `cacheTag()` call.
+ * A result past either limit returns `[PREPR_ANY_ITEM_TAG]` instead, which
+ * every webhook event revalidates.
+ *
+ * @param data A parsed JSON query result, such as `query()`'s `data`.
+ */
+declare function preprCacheTags(data: unknown): string[];
+
 /**
  * Create a GraphQL client for the Prepr API.
  *
@@ -302,4 +332,4 @@ declare function loadPreprSchema(url: string, options?: {
     fetch?: typeof fetch;
 }): Promise<PreprSchemaInfo>;
 
-export { PREPR_DEFAULT_VARIANT, type PreprClient, type PreprClientOptions, type PreprDecideOptions, type PreprDecisions, type PreprDocument, PreprHeaders, type PreprQueryOptions, type PreprQueryResult, type PreprSchema, type PreprStackBlock, type PreprStegaMode, type PreprVariantProps, type ResolveVariantsOptions, createPreprClient, decisionsFrom, loadPreprSchema, preprVariantProps, resolveVariants, splitStack, toDecisionQuery, toVariantsQuery };
+export { PREPR_ANY_ITEM_TAG, PREPR_DEFAULT_VARIANT, type PreprClient, type PreprClientOptions, type PreprDecideOptions, type PreprDecisions, type PreprDocument, PreprHeaders, type PreprQueryOptions, type PreprQueryResult, type PreprSchema, type PreprStackBlock, type PreprStegaMode, type PreprVariantProps, type ResolveVariantsOptions, createPreprClient, decisionsFrom, loadPreprSchema, preprCacheTags, preprModelTag, preprVariantProps, resolveVariants, splitStack, toDecisionQuery, toVariantsQuery };

package/dist/graphql.js

@@ -21,12 +21,37 @@ import {
   toSchemaInfo,
   toVariantsDocument,
   toVariantsQuery
-} from "./chunk-W6AVX6FI.js";
+} from "./chunk-OY7OKO6Q.js";
 import {
   PreprError,
   validatePreprToken
-} from "./chunk-OQGEL4TV.js";
-import "./chunk-NSQOGI5K.js";
+} from "./chunk-T7ESBVBI.js";
+import "./chunk-ATPB7GEC.js";
+
+// src/core/graphql/cache-tags.ts
+var MAX_TAGS = 128;
+var MAX_TAG_LENGTH = 256;
+var PREPR_ANY_ITEM_TAG = "prepr:any";
+var preprItemTag = (id) => `prepr:${id}`;
+var NOT_ALPHANUMERIC = /[^a-z0-9]/g;
+var preprModelTag = (model) => `prepr:model:${model.toLowerCase().replace(NOT_ALPHANUMERIC, "")}`;
+function preprCacheTags(data) {
+  const tags = /* @__PURE__ */ new Set();
+  const stack = [data];
+  while (stack.length > 0) {
+    const value = stack.pop();
+    if (typeof value !== "object" || value === null) continue;
+    const id = value._id;
+    if (typeof id === "string" && id !== "") {
+      const tag = preprItemTag(id);
+      if (tag.length > MAX_TAG_LENGTH) return [PREPR_ANY_ITEM_TAG];
+      tags.add(tag);
+      if (tags.size > MAX_TAGS) return [PREPR_ANY_ITEM_TAG];
+    }
+    for (const child of Object.values(value)) stack.push(child);
+  }
+  return [...tags];
+}
 
 // src/core/variants/probe-document.ts
 function probeSelectionSet(set, fragments) {
@@ -304,6 +329,7 @@ function createVaryProbe(run, options) {
 }
 
 // src/core/graphql/client.ts
+var clientSchemas = /* @__PURE__ */ new WeakMap();
 function isParseableUrl(url) {
   try {
     new URL(url);
@@ -340,7 +366,7 @@ function createPreprClient(options) {
   ));
   const variantsDocuments = /* @__PURE__ */ new Map();
   const decisionDocuments = /* @__PURE__ */ new Map();
-  return {
+  const client = {
     async query(document, variables, queryOptions = {}) {
       const { variants, ...rest } = queryOptions;
       if (!variants) return run(document, variables, rest);
@@ -352,10 +378,10 @@ function createPreprClient(options) {
       return run(derived, variables, rest);
     },
     async decide(document, variables, queryOptions = {}) {
-      const { from, topLevelOnly, ...rest } = queryOptions;
+      const { from, ...rest } = queryOptions;
       const paths = from === void 0 ? void 0 : personalizationPaths(from);
       if (paths && paths.size === 0) return /* @__PURE__ */ new Map();
-      const signature = paths ? [...paths].map(([path, types]) => `${path}:${[...types].sort().join(",")}`).sort().join("|") : topLevelOnly ? "top" : "*";
+      const signature = paths ? [...paths].map(([path, types]) => `${path}:${[...types].sort().join(",")}`).sort().join("|") : "*";
       let byPaths = decisionDocuments.get(document);
       if (!byPaths) {
         byPaths = /* @__PURE__ */ new Map();
@@ -363,9 +389,7 @@ function createPreprClient(options) {
       }
       let derived = byPaths.get(signature);
       if (derived === void 0) {
-        derived = toDecisionDocument(document, await loadSchema(), paths, {
-          topLevelOnly: !paths && topLevelOnly
-        });
+        derived = toDecisionDocument(document, await loadSchema(), paths);
         byPaths.set(signature, derived);
       }
       if (!derived) return /* @__PURE__ */ new Map();
@@ -379,6 +403,8 @@ function createPreprClient(options) {
       (vary) => vary === null || SEGMENTS_VARY.test(vary)
     )
   };
+  clientSchemas.set(client, loadSchema);
+  return client;
 }
 
 // src/core/graphql/schema-loader.ts
@@ -405,12 +431,15 @@ async function loadPreprSchema(url, options = {}) {
   return schema;
 }
 export {
+  PREPR_ANY_ITEM_TAG,
   PREPR_DEFAULT_VARIANT,
   PreprError,
   createPreprClient,
   decisionsFrom,
   isPersonalizedResponse,
   loadPreprSchema,
+  preprCacheTags,
+  preprModelTag,
   preprVariantProps,
   resolveVariants,
   splitStack,

package/dist/index.cjs

@@ -45,7 +45,7 @@ __export(src_exports, {
 module.exports = __toCommonJS(src_exports);
 
 // src/version.ts
-var VERSION = "0.6.0-alpha.6";
+var VERSION = "0.6.0-alpha.8";
 
 // src/core/features.ts
 function isEnabled(config) {

package/dist/index.d.cts

@@ -7,7 +7,7 @@ export { P as PreprPixelConfig, l as loadTrackingPixel, s as setTrackingParam, t
  * Package version; must match package.json. Lives in its own leaf module so
  * core can import it without cycling through the barrel.
  */
-declare const VERSION = "0.6.0-alpha.6";
+declare const VERSION = "0.6.0-alpha.8";
 
 /**
  * Resolve a `PreprFeatures` bag to plain booleans, defaulting every omitted key

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export { P as PreprPixelConfig, l as loadTrackingPixel, s as setTrackingParam, t
  * Package version; must match package.json. Lives in its own leaf module so
  * core can import it without cycling through the barrel.
  */
-declare const VERSION = "0.6.0-alpha.6";
+declare const VERSION = "0.6.0-alpha.8";
 
 /**
  * Resolve a `PreprFeatures` bag to plain booleans, defaulting every omitted key

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   loadTrackingPixel,
   setTrackingParam,
   trackEvent
-} from "./chunk-Y7DWVOOY.js";
+} from "./chunk-2QGUP7VQ.js";
 import {
   isPersonalizedResponse
 } from "./chunk-3NCEVJJ3.js";
@@ -32,11 +32,11 @@ import {
   getPreprUUIDFromHeaders,
   getToolbarPropsFromHeaders,
   validatePreprToken
-} from "./chunk-OQGEL4TV.js";
+} from "./chunk-T7ESBVBI.js";
 import {
   VERSION,
   resolveFeatures
-} from "./chunk-NSQOGI5K.js";
+} from "./chunk-ATPB7GEC.js";
 
 // src/core/middleware.ts
 var UTM_PARAMS = [