@shapio/client 0.4.1 → 0.5.1

package/dist/{index-D-BBgz21.d.ts → index-BWuxc5nS.d.ts}

@@ -1,5 +1,53 @@
 import { DEFAULT_SEO_KEYS, ResolveSeoContext, SEO_COMPONENT_ID, SEO_FIELD_IDS, SeoDefaults, SeoKeys, SeoLocaleDefaults, SeoLocaleDefaults as SeoLocaleDefaults$1, applyTitleTemplate, resolveSeo, seoDefaultsForLocale } from "@shapio/schema/seo";
 import { ChangeSummary, ClassifiedChange, DefinitionInput, ExportedDefinition, LocaleDefinition, LockFile, SchemaChange, SchemaDefinition, SyncDecision, ValidationIssue } from "@shapio/schema";
+//#region src/nextCache.d.ts
+/**
+ * Next.js data-cache support for delivery reads. Under Next (`process.env.NEXT_RUNTIME` is set) or when the
+ * client is given a `next` option, every delivery read passes `next: { tags }` to `fetch`, so a site can
+ * refresh exactly what changed with `revalidateTag`. The cache mode is only set when asked for, except that a
+ * read pinned to a publication snapshot is immutable and always `force-cache`, and a drafts-mode read is never
+ * cached or tagged (`no-store`). Elsewhere nothing is added.
+ */
+/** Next's `fetch` cache modes the client passes through. */
+type NextCacheMode = 'force-cache' | 'no-store';
+type NextCacheOptions = {
+  /** Next's `fetch` `cache` option. Unset: Next's own default, except pinned snapshot reads (`force-cache`). */
+  cache?: NextCacheMode;
+  /** Seconds a cached response stays fresh (`next.revalidate`); `false` keeps it until a tag is revalidated. */
+  revalidate?: number | false;
+};
+/** The last argument of every delivery read: overrides the client's `next` option; `false` adds nothing. */
+type DeliveryReadOptions = {
+  next?: NextCacheOptions | false;
+};
+/** What a delivery read adds to its `fetch` init. */
+type NextFetchInit = {
+  cache?: NextCacheMode;
+  next?: {
+    tags: string[];
+    revalidate?: number | false;
+  };
+};
+/**
+ * The cache tags delivery reads carry (`revalidateTag(shapioTags.entry('articles', id), { expire: 0 })`).
+ * Models are named by their route key: a collection's plural API ID, a singleton's API ID.
+ */
+declare const shapioTags: {
+  /** Every delivery read of the site; `shapio:site` when the client names no site. */
+  readonly site: (siteKey?: string) => string;
+  /** Every read of one model (lists, singletons and its entries). */
+  readonly model: (routeKey: string) => string;
+  /** Reads of one entry by its ID. */
+  readonly entry: (routeKey: string, entryId: string) => string;
+};
+/** What every delivery read needs to tag itself: the client's site, `next` option and drafts mode. */
+type DeliveryCacheContext = {
+  site: string | undefined;
+  next: NextCacheOptions | false | undefined;
+  /** Drafts mode (`drafts: true`): reads ask for drafts, which are never cached. */
+  drafts: boolean;
+};
+//#endregion
 //#region src/request.d.ts
 /** Fetch's `credentials` mode (spelled out: the DOM lib type is not available to Node consumers). */
 type FetchCredentials = 'omit' | 'same-origin' | 'include';
@@ -7,7 +55,7 @@ type RequestOptions = {
   method?: string;
   body?: unknown;
   signal?: AbortSignal;
-};
+} & NextFetchInit;
 type RequestFn = <T>(path: string, options?: RequestOptions) => Promise<T>;
 //#endregion
 //#region src/admin/contentTypes.d.ts
@@ -213,6 +261,8 @@ type DeliveryGetQuery = Pick<DeliveryListQuery, 'locale' | 'fields' | 'populate'
 type DeliveryMeta = {
   locale: string;
   snapshot: number;
+  /** Drafts mode reads only (`publicationState=draft`); published responses carry no such member. */
+  publicationState?: 'draft';
 };
 type DeliveryPagination = {
   page: number;
@@ -1208,6 +1258,12 @@ type AdminUser = {
 };
 declare const CONTENT_ACTIONS: readonly ["read", "create", "update", "delete", "publish", "schemaManage"];
 type ContentAction = (typeof CONTENT_ACTIONS)[number];
+/**
+ * What a delivery role grants: `read`, and `readDrafts` (drafts mode: the token's site may read drafts with
+ * `publicationState=draft`). `readDrafts` always covers every model and is never granted to admin roles.
+ */
+declare const DELIVERY_ACTIONS: readonly ["read", "readDrafts"];
+type DeliveryAction = (typeof DELIVERY_ACTIONS)[number];
 /**
  * Network actions: about the whole instance. Only roles assigned on every site grant them, so a role held
  * on one site never reaches the network.
@@ -1220,7 +1276,7 @@ type SiteAction = (typeof SITE_ACTIONS)[number];
 /** Actions not scoped to a model: network actions and site actions. */
 declare const GLOBAL_ACTIONS: readonly ["schema.create", "users.manage", "roles.manage", "tokens.manage", "audit.read", "sites.manage", "media.read", "media.write", "media.manage", "publishing.manage", "webhooks.manage", "deployments.manage", "deployments.trigger", "changes.manage", "changes.ship", "site.settings"];
 type GlobalAction = (typeof GLOBAL_ACTIONS)[number];
-type PermissionAction = ContentAction | GlobalAction;
+type PermissionAction = ContentAction | DeliveryAction | GlobalAction;
 type RoleSummary = {
   id: string;
   key: string;
@@ -1791,8 +1847,22 @@ type ShapioClientOptions = {
    * ever reads its own site: naming another one is refused (403 `SITE_MISMATCH`).
    */
   site?: string;
+  /**
+   * Next.js data-cache options for delivery reads (`delivery.*`, `site.get`), e.g. `{ cache: 'force-cache' }`.
+   * Under Next the reads are tagged for `revalidateTag` whether or not this is set; the cache mode is only
+   * passed when asked for, and reads pinned to a snapshot are always `force-cache`. Set it outside Next to send
+   * the same fetch options; `false` sends none. A read's own `next` option overrides this one.
+   */
+  next?: NextCacheOptions | false;
+  /**
+   * Drafts mode, for a site's development server: every delivery read asks for drafts
+   * (`publicationState=draft`) instead of published content, and under Next is never cached or tagged. Needs
+   * a delivery token whose role grants Read drafts (the server refuses others with 403 `DRAFTS_FORBIDDEN`);
+   * never set it on a production build. Reads pinned to a `snapshot` are refused. `snapshots` is unaffected.
+   */
+  drafts?: boolean;
 };
-declare const createClient: ({ baseUrl, token, fetch, credentials, headers, site }: ShapioClientOptions) => {
+declare const createClient: ({ baseUrl, token, fetch, credentials, headers, site, next, drafts }: ShapioClientOptions) => {
   /**
    * Any Shapio route, e.g. the delivery API. Delivery paths use the model's route key: a collection's
    * plural API ID (`request('/api/content/articles')`, `/api/content/articles/<id>`), a singleton's API ID
@@ -1806,13 +1876,13 @@ declare const createClient: ({ baseUrl, token, fetch, credentials, headers, site
   };
   /** Published content (the delivery API), typed by the caller. */
   delivery: {
-    list: <T = Record<string, unknown>>(routeKey: string, query?: DeliveryListQuery) => Promise<DeliveryList<T>>;
-    singleton: <T = Record<string, unknown>>(apiKey: string, query?: DeliveryGetQuery) => Promise<DeliveryItem<T>>;
-    get: <T = Record<string, unknown>>(routeKey: string, id: string, query?: DeliveryGetQuery) => Promise<DeliveryItem<T>>;
+    list: <T = Record<string, unknown>>(routeKey: string, query?: DeliveryListQuery, options?: DeliveryReadOptions) => Promise<DeliveryList<T>>;
+    singleton: <T = Record<string, unknown>>(apiKey: string, query?: DeliveryGetQuery, options?: DeliveryReadOptions) => Promise<DeliveryItem<T>>;
+    get: <T = Record<string, unknown>>(routeKey: string, id: string, query?: DeliveryGetQuery, options?: DeliveryReadOptions) => Promise<DeliveryItem<T>>;
   };
   /** The site as delivery sees it: key, name and SEO defaults (`GET /api/site`). */
   site: {
-    get: () => Promise<DeliverySite>;
+    get: ({ next }?: DeliveryReadOptions) => Promise<DeliverySite>;
   };
   admin: {
     assist: {
@@ -2749,24 +2819,73 @@ type AdminApi = ReturnType<typeof createAdminApi>;
 declare const DELIVERY_PATH = "/api/content";
 /**
  * Published content, typed by the caller (`delivery.list<Article>('articles', { locale: 'fr', snapshot })`).
- * A collection is read with `list` (a page) and `get` (one entry); a singleton with `singleton`.
+ * A collection is read with `list` (a page) and `get` (one entry); a singleton with `singleton`. Each read
+ * takes Next.js cache options last and is tagged for `revalidateTag` (nextCache.ts): lists and singletons with
+ * the site and model tags, `get` with the entry's tag too. In drafts mode (`drafts: true`) every read asks for
+ * drafts (`publicationState=draft`), is never cached or tagged under Next, and refuses a pinned snapshot.
  */
-declare const createDeliveryApi: (request: RequestFn) => {
-  list: <T = Record<string, unknown>>(routeKey: string, query?: DeliveryListQuery) => Promise<DeliveryList<T>>;
-  singleton: <T = Record<string, unknown>>(apiKey: string, query?: DeliveryGetQuery) => Promise<DeliveryItem<T>>;
-  get: <T = Record<string, unknown>>(routeKey: string, id: string, query?: DeliveryGetQuery) => Promise<DeliveryItem<T>>;
+declare const createDeliveryApi: (request: RequestFn, cacheContext: DeliveryCacheContext) => {
+  list: <T = Record<string, unknown>>(routeKey: string, query?: DeliveryListQuery, options?: DeliveryReadOptions) => Promise<DeliveryList<T>>;
+  singleton: <T = Record<string, unknown>>(apiKey: string, query?: DeliveryGetQuery, options?: DeliveryReadOptions) => Promise<DeliveryItem<T>>;
+  get: <T = Record<string, unknown>>(routeKey: string, id: string, query?: DeliveryGetQuery, options?: DeliveryReadOptions) => Promise<DeliveryItem<T>>;
 };
 type DeliveryApi = ReturnType<typeof createDeliveryApi>;
 //#endregion
+//#region src/deliveryClient.d.ts
+type DeliveryClientOptions = {
+  /** The site key the reads are tagged with (`shapioTags.site`); the transport names the site itself. */
+  site?: string;
+  /** Next.js data-cache options, as `createClient`'s `next` option. */
+  next?: NextCacheOptions | false;
+  /** Drafts mode, as `createClient`'s `drafts` option. */
+  drafts?: boolean;
+};
+/**
+ * The read side of the client over any transport: published content (`delivery`), the site (`site`) and
+ * publication snapshots (`snapshots`). `createClient` builds it over HTTP; `@shapio/local` over the delivery
+ * API running in the same process. The transport receives exactly the paths the HTTP client sends.
+ */
+declare const createDeliveryClient: (request: RequestFn, { site, next, drafts }?: DeliveryClientOptions) => {
+  /** Published content (the delivery API; drafts in drafts mode), typed by the caller. */
+  delivery: {
+    list: <T = Record<string, unknown>>(routeKey: string, query?: DeliveryListQuery, options?: DeliveryReadOptions) => Promise<DeliveryList<T>>;
+    singleton: <T = Record<string, unknown>>(apiKey: string, query?: DeliveryGetQuery, options?: DeliveryReadOptions) => Promise<DeliveryItem<T>>;
+    get: <T = Record<string, unknown>>(routeKey: string, id: string, query?: DeliveryGetQuery, options?: DeliveryReadOptions) => Promise<DeliveryItem<T>>;
+  };
+  /** The site as delivery sees it: key, name and SEO defaults (`GET /api/site`). */
+  site: {
+    get: ({ next }?: DeliveryReadOptions) => Promise<DeliverySite>;
+  };
+  /** Publication snapshots and the diff between two (incremental builds). */
+  snapshots: {
+    current: () => Promise<CurrentSnapshot>;
+    changes: (query: SnapshotChangesQuery) => Promise<SnapshotChangesPage>;
+    allChanges: (query: Omit<SnapshotChangesQuery, "after">) => Promise<{
+      from: number;
+      to: number;
+      schemaVersions: {
+        from: number | null;
+        to: number | null;
+      };
+      items: SnapshotChange[];
+    }>;
+  };
+};
+type ShapioDeliveryClient = ReturnType<typeof createDeliveryClient>;
+//#endregion
 //#region src/site.d.ts
 /** Delivery reads name their site with `?site=`; everything else with the `Shapio-Site` header. */
 declare const SITE_QUERY_PARAMETER = "site";
 //#endregion
 //#region src/siteDelivery.d.ts
 declare const DELIVERY_SITE_PATH = "/api/site";
-/** The request's site as delivery sees it (key, name, SEO defaults), with the client's token and site. */
-declare const createSiteApi: (request: RequestFn) => {
-  get: () => Promise<DeliverySite>;
+/**
+ * The request's site as delivery sees it (key, name, SEO defaults), with the client's token and site. Under
+ * Next.js the read carries the site tag (nextCache.ts); in drafts mode it is `no-store` and untagged instead
+ * (the site has no draft state, so no `publicationState` is sent).
+ */
+declare const createSiteApi: (request: RequestFn, cacheContext: DeliveryCacheContext) => {
+  get: ({ next }?: DeliveryReadOptions) => Promise<DeliverySite>;
 };
 type SiteApi = ReturnType<typeof createSiteApi>;
 //#endregion
@@ -2933,5 +3052,5 @@ declare const codeChallengeOf: (codeVerifier: string) => Promise<string>;
 /** A fresh verifier (32 random bytes, 43 characters) and its S256 challenge. */
 declare const createPkcePair: () => Promise<AppPkcePair>;
 //#endregion
-export { HealthRule as $, ContentFilterValue as $a, JobQuery as $i, NetworkAction as $n, UnassignedEntry as $r, MediaAssetPage as $t, DELIVERY_SITE_PATH as A, SetSiteAppRolesInput as Aa, UpdateSchemaSettingsInput as Ai, AdminUserStatus as An, ChangeSetSummary as Ar, TranslateInput as At, SITES_PATHS as B, DeliveryGetQuery as Ba, DeploymentConnectionCreated as Bi, CreateRoleInput as Bn, ReviewEntryItem as Br, VersionResponse as Bt, WEBHOOK_EVENT_HEADER as C, FieldPrincipalUsage as Ca, SchemaChangeStatus as Ci, BUILT_IN_APP_ROLE_KEYS as Cn, ChangeSetItem as Cr, ContentOpsStatus as Ct, WebhookSignatureCheck as D, PrincipalUsageSummary as Da, SetDefaultLocaleResult as Di, AcceptInvitationInput as Dn, ChangeSetSchemaItem as Dr, SchemaDraftInput as Dt, WEBHOOK_TOLERANCE_SECONDS as E, ModelFieldUsage as Ea, SchemaSummaryItem as Ei, UpdateAppUserInput as En, ChangeSetReview as Er, RewriteInput as Et, AdminApi as F, UpdateSiteInput as Fa, CreateWebhookInput as Fi, AuditQuery as Fn, FieldDiff as Fr, ShapioClientOptions as Ft, ContentCount as G, DeliveryPagination as Ga, DeploymentRunTrigger as Gi, GlobalAction as Gn, SchemaDraft as Gr, SnapshotChangesQuery as Gt, ADMIN_PATHS as H, DeliveryList as Ha, DeploymentRun as Hi, CsrfResponse as Hn, ReviewSchemaItem as Hr, SnapshotChange as Ht, ASSIST_PATHS as I, DeliveryAsset as Ia, DEPLOYMENT_PROVIDERS as Ii, CONTENT_ACTIONS as In, NOT_RESTORABLE_REASONS as Ir, createClient as It, ContentHealthPage as J, AdminEntry as Ja, DeploymentSettings as Ji, InvitationLink as Jn, ShipPhase as Jr, SchemaExport as Jt, ContentCounts as K, RichTextMode as Ka, DeploymentSecretState as Ki, InspectInvitationResponse as Kn, SchemaOperation as Kr, SchemaApplyInput as Kt, buildUploadForm as L, DeliverySite as La, DEPLOYMENT_RUN_STATUSES as Li, ChangePasswordInput as Ln, NotRestorable as Lr, CheckStatus as Lt, SITE_QUERY_PARAMETER as M, SiteAppRoles as Ma, CreateDeploymentConnectionInput as Mi, AuditActorType as Mn, CreateChangeSetInput as Mr, ShapioApiError as Mt, DELIVERY_PATH as N, SiteRef as Na, CreatePreviewTokenInput as Ni, AuditEvent as Nn, FieldConsumer as Nr, ShapioErrorBody as Nt, WebhookSignatureInput as O, UsageSelection as Oa, UpdateDefinitionInput as Oi, AdminSession as On, ChangeSetSource as Or, SchemaDraftResult as Ot, DeliveryApi as P, SiteSummary as Pa, CreateScheduleInput as Pi, AuditPage as Pn, FieldConsumers as Pr, ShapioClient as Pt, HEALTH_RULES as Q, ContentFilterOperator as Qa, Job as Qi, NETWORK_ACTIONS as Qn, SnapshotSource as Qr, MediaAsset as Qt, resolveUploadUrl as R, SeoFields as Ra, DEPLOYMENT_TRIGGERS as Ri, ContentAction as Rn, NotRestorableReason as Rr, HealthResponse as Rt, AppUser as S, WebhookWithSecret as Sa, SchemaChangeJob as Si, AppUserQuery as Sn, ChangeSetError as Sr, ContentOpsSkip as St, WEBHOOK_TIMESTAMP_HEADER as T, FieldUsageResponse as Ta, SchemaSummary as Ti, UpdateAppRoleInput as Tn, ChangeSetQuery as Tr, LocaleMissingResult as Tt, CheckParams as U, DeliveryListQuery as Ua, DeploymentRunQuery as Ui, EmailDelivery as Un, SNAPSHOT_SOURCES as Ur, SnapshotChangeKind as Ut, SITE_HEADER as V, DeliveryItem as Va, DeploymentProvider as Vi, CreatedApiToken as Vn, ReviewIssue as Vr, CurrentSnapshot as Vt, CheckSeverity as W, DeliveryMeta as Wa, DeploymentRunStatus as Wi, GLOBAL_ACTIONS as Wn, ScheduleChangeSetInput as Wr, SnapshotChangesPage as Wt, ContentHealthSummary as X, AdminEntryPage as Xa, DeploymentTriggerPolicy as Xi, LoginInput as Xn, SnapshotPage as Xr, CreateMediaFolderInput as Xt, ContentHealthQuery as Y, AdminEntryListItem as Ya, DeploymentTimelineEvent as Yi, InviteUserInput as Yn, Snapshot as Yr, SchemaSyncResult as Yt, EntryPresence as Z, ContentFilter as Za, JOB_STATUSES as Zi, MeResponse as Zn, SnapshotQuery as Zr, CreateUploadInput as Zt, AppLoginInput as _, WebhookAttempt as _a, PlanImpact as _i, AdminAppUser as _n, RevisionSummary as _o, AddChangeSetEntryInput as _r, CONTENT_OPS_RULES as _t, SeoDefaults as a, Page as aa, ChangeScopeInput as ai, MediaUsage as an, EditorManifest as ao, RoleCondition as ar, PreflightRule as at, AppRegisterResult as b, WebhookEventBody as ba, PlanStepImpact as bi, AppRolePermission as bn, RequestOptions as bo, ChangeSetActor as br, ContentOpsRule as bt, applyTitleTemplate as c, PreviewTokenCreated as ca, CreateLocaleInput as ci, MediaVariantStatus as cn, EntryData as co, RoleSummary as cr, AltMissingResult as ct, AppPkcePair as d, ScheduleQuery as da, DefinitionListItem as di, MoveMediaAssetsResult as dn, EntryLocalesInput as do, SetupInput as dr, AltTextResult as dt, JobStatus as ea, UpdateChangeSetInput as ei, MediaAssetQuery as en, ContentIssue as eo, PasswordResetConfirmInput as er, ModelPresence as et, codeChallengeOf as f, ScheduleStatus as fa, DefinitionPayload as fi, ReplaceUploadInput as fn, EntryReferrer as fo, SetupStatusResponse as fr, AssistIssue as ft, AppChangePasswordInput as g, Webhook as ga, Locale as gi, APP_CONTENT_ACTIONS as gn, RevisionDetail as go, UpdateRoleInput as gr, AssistUsage as gt, AppAuthApi as h, UpdateWebhookInput as ha, DeleteLocaleResult as hi, UploadGrant as hn, ExtensionThemeList as ho, UpdateProfileInput as hr, AssistTextResult as ht, SEO_FIELD_IDS as i, PUBLICATION_ACTIONS as ia, ChangePlan as ii, MediaStorageDriver as in, CreateEntryInput as io, RoleAssignment as ir, PreflightResponse as it, SiteApi as j, Site as ja, ConnectionTestResult as ji, ApiToken as jn, ChangeSetTimelineEvent as jr, TranslateResult as jt, verifyWebhookSignature as k, CreateSiteInput as ka, UpdateLocaleInput as ki, AdminUser as kn, ChangeSetStatus as kr, SummarizeInput as kt, resolveSeo as l, PublicationAction as la, DefinitionCategory as li, MediaVisibility as ln, EntryLocaleState as lo, SITE_ACTIONS as lr, AltProposal as lt, APP_AUTH_PATHS as m, UpdateDeploymentConnectionInput as ma, DefinitionScope as mi, UpdateMediaFolderInput as mn, ExtensionTheme as mo, UpdateAdminUserInput as mr, AssistStatus as mt, ResolveSeoContext as n, OpenPreviewInput as na, ActiveDefinition as ni, MediaFocalPoint as nn, ContentPagination as no, PermissionAction as nr, PreflightInput as nt, SeoKeys as o, PreviewTarget as oa, ChangeScopeOutcome as oi, MediaUsagePage as on, EditorManifestItem as oo, RoleKind as or, PresenceHeartbeatInput as ot, createPkcePair as p, ScheduledPublication as pa, DefinitionRevision as pi, UpdateMediaAssetInput as pn, EntryStatus as po, SiteAction as pr, AssistProvider as pt, ContentHealthFinding as q, SeoMode as qa, DeploymentSecretsInput as qi, Invitation as qn, ShipChangeSetInput as qr, SchemaApplyResult as qt, SEO_COMPONENT_ID as r, OpenPreviewResult as ra, ChangeOutcome as ri, MediaFolder as rn, ContentSort as ro, Role as rr, PreflightLocale as rt, SeoLocaleDefaults$1 as s, PreviewToken as sa, CreateDefinitionInput as si, MediaVariant as sn, EntryAuthor as so, RolePermission as sr, PresencePerson as st, DEFAULT_SEO_KEYS as t, JobSummary as ta, Acknowledgement as ti, MediaAssetStatus as tn, ContentListQuery as to, PasswordResetRequestInput as tr, PreflightCheck as tt, seoDefaultsForLocale as u, SCHEDULE_STATUSES as ua, DefinitionDetail as ui, MoveMediaAssetsInput as un, EntryLocaleStatus as uo, SessionStarted as ur, AltTextInput as ut, AppOAuthProvider as v, WebhookDelivery as va, PlanPreview as vi, AppContentAction as vn, UpdateEntryInput as vo, CHANGE_SET_STATUSES as vr, ContentOpsInput as vt, WEBHOOK_SIGNATURE_HEADER as w, FieldUsageQuery as wa, SchemaSettings as wi, CreateAppRoleInput as wn, ChangeSetItemStatus as wr, ContentOpsWritten as wt, AppSession as x, WebhookEventType as xa, PlanUpdateInput as xi, AppUserPage as xn, ChangeSetEntryItem as xr, ContentOpsRun as xt, AppRegisterInput as y, WebhookDeliveryStatus as ya, PlanStep as yi, AppRole as yn, RequestFn as yo, ChangeSet as yr, ContentOpsResult as yt, toContentQueryString as z, SeoResolved as za, DeploymentConnection as zi, CreateApiTokenInput as zn, PutSchemaDraftInput as zr, ReadyResponse as zt };
-//# sourceMappingURL=index-D-BBgz21.d.ts.map
+export { ContentHealthSummary as $, AdminEntry as $a, DeploymentSettings as $i, InvitationLink as $n, ShipPhase as $r, CreateMediaFolderInput as $t, DELIVERY_SITE_PATH as A, FieldUsageResponse as Aa, SchemaSummary as Ai, AcceptInvitationInput as An, ChangeSetQuery as Ar, SchemaDraftInput as At, buildUploadForm as B, UpdateSiteInput as Ba, CreateWebhookInput as Bi, ChangePasswordInput as Bn, FieldDiff as Br, CheckStatus as Bt, WEBHOOK_EVENT_HEADER as C, WebhookDelivery as Ca, PlanPreview as Ci, AppRolePermission as Cn, UpdateEntryInput as Co, CHANGE_SET_STATUSES as Cr, ContentOpsRule as Ct, WebhookSignatureCheck as D, WebhookWithSecret as Da, SchemaChangeJob as Di, CreateAppRoleInput as Dn, NextCacheMode as Do, ChangeSetError as Dr, ContentOpsWritten as Dt, WEBHOOK_TOLERANCE_SECONDS as E, WebhookEventType as Ea, PlanUpdateInput as Ei, BUILT_IN_APP_ROLE_KEYS as En, DeliveryReadOptions as Eo, ChangeSetEntryItem as Er, ContentOpsStatus as Et, createDeliveryClient as F, SetSiteAppRolesInput as Fa, UpdateSchemaSettingsInput as Fi, AuditActorType as Fn, ChangeSetSummary as Fr, ShapioApiError as Ft, ADMIN_PATHS as G, DeliveryGetQuery as Ga, DeploymentConnectionCreated as Gi, CsrfResponse as Gn, ReviewEntryItem as Gr, SnapshotChange as Gt, toContentQueryString as H, DeliverySite as Ha, DEPLOYMENT_RUN_STATUSES as Hi, CreateApiTokenInput as Hn, NotRestorable as Hr, ReadyResponse as Ht, DELIVERY_PATH as I, Site as Ia, ConnectionTestResult as Ii, AuditEvent as In, ChangeSetTimelineEvent as Ir, ShapioErrorBody as It, ContentCount as J, DeliveryListQuery as Ja, DeploymentRunQuery as Ji, EmailDelivery as Jn, SNAPSHOT_SOURCES as Jr, SnapshotChangesQuery as Jt, CheckParams as K, DeliveryItem as Ka, DeploymentProvider as Ki, DELIVERY_ACTIONS as Kn, ReviewIssue as Kr, SnapshotChangeKind as Kt, DeliveryApi as L, SiteAppRoles as La, CreateDeploymentConnectionInput as Li, AuditPage as Ln, CreateChangeSetInput as Lr, ShapioClient as Lt, SITE_QUERY_PARAMETER as M, PrincipalUsageSummary as Ma, SetDefaultLocaleResult as Mi, AdminUser as Mn, ChangeSetSchemaItem as Mr, SummarizeInput as Mt, DeliveryClientOptions as N, UsageSelection as Na, UpdateDefinitionInput as Ni, AdminUserStatus as Nn, ChangeSetSource as Nr, TranslateInput as Nt, WebhookSignatureInput as O, FieldPrincipalUsage as Oa, SchemaChangeStatus as Oi, UpdateAppRoleInput as On, NextCacheOptions as Oo, ChangeSetItem as Or, LocaleMissingResult as Ot, ShapioDeliveryClient as P, CreateSiteInput as Pa, UpdateLocaleInput as Pi, ApiToken as Pn, ChangeSetStatus as Pr, TranslateResult as Pt, ContentHealthQuery as Q, SeoMode as Qa, DeploymentSecretsInput as Qi, Invitation as Qn, ShipChangeSetInput as Qr, SchemaSyncResult as Qt, AdminApi as R, SiteRef as Ra, CreatePreviewTokenInput as Ri, AuditQuery as Rn, FieldConsumer as Rr, ShapioClientOptions as Rt, AppUser as S, WebhookAttempt as Sa, PlanImpact as Si, AppRole as Sn, RevisionSummary as So, AddChangeSetEntryInput as Sr, ContentOpsResult as St, WEBHOOK_TIMESTAMP_HEADER as T, WebhookEventBody as Ta, PlanStepImpact as Ti, AppUserQuery as Tn, RequestOptions as To, ChangeSetActor as Tr, ContentOpsSkip as Tt, SITES_PATHS as U, SeoFields as Ua, DEPLOYMENT_TRIGGERS as Ui, CreateRoleInput as Un, NotRestorableReason as Ur, VersionResponse as Ut, resolveUploadUrl as V, DeliveryAsset as Va, DEPLOYMENT_PROVIDERS as Vi, ContentAction as Vn, NOT_RESTORABLE_REASONS as Vr, HealthResponse as Vt, SITE_HEADER as W, SeoResolved as Wa, DeploymentConnection as Wi, CreatedApiToken as Wn, PutSchemaDraftInput as Wr, CurrentSnapshot as Wt, ContentHealthFinding as X, DeliveryPagination as Xa, DeploymentRunTrigger as Xi, GlobalAction as Xn, SchemaDraft as Xr, SchemaApplyResult as Xt, ContentCounts as Y, DeliveryMeta as Ya, DeploymentRunStatus as Yi, GLOBAL_ACTIONS as Yn, ScheduleChangeSetInput as Yr, SchemaApplyInput as Yt, ContentHealthPage as Z, RichTextMode as Za, DeploymentSecretState as Zi, InspectInvitationResponse as Zn, SchemaOperation as Zr, SchemaExport as Zt, AppLoginInput as _, ScheduleStatus as _a, DefinitionPayload as _i, UpdateMediaFolderInput as _n, EntryReferrer as _o, SetupStatusResponse as _r, AssistStatus as _t, SeoDefaults as a, JobStatus as aa, UpdateChangeSetInput as ai, MediaFocalPoint as an, ContentIssue as ao, PasswordResetConfirmInput as ar, PreflightInput as at, AppRegisterResult as b, UpdateWebhookInput as ba, DeleteLocaleResult as bi, AdminAppUser as bn, ExtensionThemeList as bo, UpdateProfileInput as br, CONTENT_OPS_RULES as bt, applyTitleTemplate as c, OpenPreviewResult as ca, ChangeOutcome as ci, MediaUsage as cn, ContentSort as co, Role as cr, PreflightRule as ct, AppPkcePair as d, PreviewTarget as da, ChangeScopeOutcome as di, MediaVariantStatus as dn, EditorManifestItem as do, RoleKind as dr, AltMissingResult as dt, DeploymentTimelineEvent as ea, Snapshot as ei, CreateUploadInput as en, AdminEntryListItem as eo, InviteUserInput as er, EntryPresence as et, codeChallengeOf as f, PreviewToken as fa, CreateDefinitionInput as fi, MediaVisibility as fn, EntryAuthor as fo, RolePermission as fr, AltProposal as ft, AppChangePasswordInput as g, ScheduleQuery as ga, DefinitionListItem as gi, UpdateMediaAssetInput as gn, EntryLocalesInput as go, SetupInput as gr, AssistProvider as gt, AppAuthApi as h, SCHEDULE_STATUSES as ha, DefinitionDetail as hi, ReplaceUploadInput as hn, EntryLocaleStatus as ho, SessionStarted as hr, AssistIssue as ht, SEO_FIELD_IDS as i, JobQuery as ia, UnassignedEntry as ii, MediaAssetStatus as in, ContentFilterValue as io, NetworkAction as ir, PreflightCheck as it, SiteApi as j, ModelFieldUsage as ja, SchemaSummaryItem as ji, AdminSession as jn, ChangeSetReview as jr, SchemaDraftResult as jt, verifyWebhookSignature as k, FieldUsageQuery as ka, SchemaSettings as ki, UpdateAppUserInput as kn, shapioTags as ko, ChangeSetItemStatus as kr, RewriteInput as kt, resolveSeo as l, PUBLICATION_ACTIONS as la, ChangePlan as li, MediaUsagePage as ln, CreateEntryInput as lo, RoleAssignment as lr, PresenceHeartbeatInput as lt, APP_AUTH_PATHS as m, PublicationAction as ma, DefinitionCategory as mi, MoveMediaAssetsResult as mn, EntryLocaleState as mo, SITE_ACTIONS as mr, AltTextResult as mt, ResolveSeoContext as n, JOB_STATUSES as na, SnapshotQuery as ni, MediaAssetPage as nn, ContentFilter as no, MeResponse as nr, HealthRule as nt, SeoKeys as o, JobSummary as oa, Acknowledgement as oi, MediaFolder as on, ContentListQuery as oo, PasswordResetRequestInput as or, PreflightLocale as ot, createPkcePair as p, PreviewTokenCreated as pa, CreateLocaleInput as pi, MoveMediaAssetsInput as pn, EntryData as po, RoleSummary as pr, AltTextInput as pt, CheckSeverity as q, DeliveryList as qa, DeploymentRun as qi, DeliveryAction as qn, ReviewSchemaItem as qr, SnapshotChangesPage as qt, SEO_COMPONENT_ID as r, Job as ra, SnapshotSource as ri, MediaAssetQuery as rn, ContentFilterOperator as ro, NETWORK_ACTIONS as rr, ModelPresence as rt, SeoLocaleDefaults$1 as s, OpenPreviewInput as sa, ActiveDefinition as si, MediaStorageDriver as sn, ContentPagination as so, PermissionAction as sr, PreflightResponse as st, DEFAULT_SEO_KEYS as t, DeploymentTriggerPolicy as ta, SnapshotPage as ti, MediaAsset as tn, AdminEntryPage as to, LoginInput as tr, HEALTH_RULES as tt, seoDefaultsForLocale as u, Page as ua, ChangeScopeInput as ui, MediaVariant as un, EditorManifest as uo, RoleCondition as ur, PresencePerson as ut, AppOAuthProvider as v, ScheduledPublication as va, DefinitionRevision as vi, UploadGrant as vn, EntryStatus as vo, SiteAction as vr, AssistTextResult as vt, WEBHOOK_SIGNATURE_HEADER as w, WebhookDeliveryStatus as wa, PlanStep as wi, AppUserPage as wn, RequestFn as wo, ChangeSet as wr, ContentOpsRun as wt, AppSession as x, Webhook as xa, Locale as xi, AppContentAction as xn, RevisionDetail as xo, UpdateRoleInput as xr, ContentOpsInput as xt, AppRegisterInput as y, UpdateDeploymentConnectionInput as ya, DefinitionScope as yi, APP_CONTENT_ACTIONS as yn, ExtensionTheme as yo, UpdateAdminUserInput as yr, AssistUsage as yt, ASSIST_PATHS as z, SiteSummary as za, CreateScheduleInput as zi, CONTENT_ACTIONS as zn, FieldConsumers as zr, createClient as zt };
+//# sourceMappingURL=index-BWuxc5nS.d.ts.map

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { $ as HealthRule, $a as ContentFilterValue, $i as JobQuery, $n as NetworkAction, $r as UnassignedEntry, $t as MediaAssetPage, A as DELIVERY_SITE_PATH, Aa as SetSiteAppRolesInput, Ai as UpdateSchemaSettingsInput, An as AdminUserStatus, Ar as ChangeSetSummary, At as TranslateInput, B as SITES_PATHS, Ba as DeliveryGetQuery, Bi as DeploymentConnectionCreated, Bn as CreateRoleInput, Br as ReviewEntryItem, Bt as VersionResponse, C as WEBHOOK_EVENT_HEADER, Ca as FieldPrincipalUsage, Ci as SchemaChangeStatus, Cn as BUILT_IN_APP_ROLE_KEYS, Cr as ChangeSetItem, Ct as ContentOpsStatus, D as WebhookSignatureCheck, Da as PrincipalUsageSummary, Di as SetDefaultLocaleResult, Dn as AcceptInvitationInput, Dr as ChangeSetSchemaItem, Dt as SchemaDraftInput, E as WEBHOOK_TOLERANCE_SECONDS, Ea as ModelFieldUsage, Ei as SchemaSummaryItem, En as UpdateAppUserInput, Er as ChangeSetReview, Et as RewriteInput, F as AdminApi, Fa as UpdateSiteInput, Fi as CreateWebhookInput, Fn as AuditQuery, Fr as FieldDiff, Ft as ShapioClientOptions, G as ContentCount, Ga as DeliveryPagination, Gi as DeploymentRunTrigger, Gn as GlobalAction, Gr as SchemaDraft, Gt as SnapshotChangesQuery, H as ADMIN_PATHS, Ha as DeliveryList, Hi as DeploymentRun, Hn as CsrfResponse, Hr as ReviewSchemaItem, Ht as SnapshotChange, I as ASSIST_PATHS, Ia as DeliveryAsset, Ii as DEPLOYMENT_PROVIDERS, In as CONTENT_ACTIONS, Ir as NOT_RESTORABLE_REASONS, It as createClient, J as ContentHealthPage, Ja as AdminEntry, Ji as DeploymentSettings, Jn as InvitationLink, Jr as ShipPhase, Jt as SchemaExport, K as ContentCounts, Ka as RichTextMode, Ki as DeploymentSecretState, Kn as InspectInvitationResponse, Kr as SchemaOperation, Kt as SchemaApplyInput, L as buildUploadForm, La as DeliverySite, Li as DEPLOYMENT_RUN_STATUSES, Ln as ChangePasswordInput, Lr as NotRestorable, Lt as CheckStatus, M as SITE_QUERY_PARAMETER, Ma as SiteAppRoles, Mi as CreateDeploymentConnectionInput, Mn as AuditActorType, Mr as CreateChangeSetInput, Mt as ShapioApiError, N as DELIVERY_PATH, Na as SiteRef, Ni as CreatePreviewTokenInput, Nn as AuditEvent, Nr as FieldConsumer, Nt as ShapioErrorBody, O as WebhookSignatureInput, Oa as UsageSelection, Oi as UpdateDefinitionInput, On as AdminSession, Or as ChangeSetSource, Ot as SchemaDraftResult, P as DeliveryApi, Pa as SiteSummary, Pi as CreateScheduleInput, Pn as AuditPage, Pr as FieldConsumers, Pt as ShapioClient, Q as HEALTH_RULES, Qa as ContentFilterOperator, Qi as Job, Qn as NETWORK_ACTIONS, Qr as SnapshotSource, Qt as MediaAsset, R as resolveUploadUrl, Ra as SeoFields, Ri as DEPLOYMENT_TRIGGERS, Rn as ContentAction, Rr as NotRestorableReason, Rt as HealthResponse, S as AppUser, Sa as WebhookWithSecret, Si as SchemaChangeJob, Sn as AppUserQuery, Sr as ChangeSetError, St as ContentOpsSkip, T as WEBHOOK_TIMESTAMP_HEADER, Ta as FieldUsageResponse, Ti as SchemaSummary, Tn as UpdateAppRoleInput, Tr as ChangeSetQuery, Tt as LocaleMissingResult, U as CheckParams, Ua as DeliveryListQuery, Ui as DeploymentRunQuery, Un as EmailDelivery, Ur as SNAPSHOT_SOURCES, Ut as SnapshotChangeKind, V as SITE_HEADER, Va as DeliveryItem, Vi as DeploymentProvider, Vn as CreatedApiToken, Vr as ReviewIssue, Vt as CurrentSnapshot, W as CheckSeverity, Wa as DeliveryMeta, Wi as DeploymentRunStatus, Wn as GLOBAL_ACTIONS, Wr as ScheduleChangeSetInput, Wt as SnapshotChangesPage, X as ContentHealthSummary, Xa as AdminEntryPage, Xi as DeploymentTriggerPolicy, Xn as LoginInput, Xr as SnapshotPage, Xt as CreateMediaFolderInput, Y as ContentHealthQuery, Ya as AdminEntryListItem, Yi as DeploymentTimelineEvent, Yn as InviteUserInput, Yr as Snapshot, Yt as SchemaSyncResult, Z as EntryPresence, Za as ContentFilter, Zi as JOB_STATUSES, Zn as MeResponse, Zr as SnapshotQuery, Zt as CreateUploadInput, _ as AppLoginInput, _a as WebhookAttempt, _i as PlanImpact, _n as AdminAppUser, _o as RevisionSummary, _r as AddChangeSetEntryInput, _t as CONTENT_OPS_RULES, a as SeoDefaults, aa as Page, ai as ChangeScopeInput, an as MediaUsage, ao as EditorManifest, ar as RoleCondition, at as PreflightRule, b as AppRegisterResult, ba as WebhookEventBody, bi as PlanStepImpact, bn as AppRolePermission, bo as RequestOptions, br as ChangeSetActor, bt as ContentOpsRule, c as applyTitleTemplate, ca as PreviewTokenCreated, ci as CreateLocaleInput, cn as MediaVariantStatus, co as EntryData, cr as RoleSummary, ct as AltMissingResult, d as AppPkcePair, da as ScheduleQuery, di as DefinitionListItem, dn as MoveMediaAssetsResult, do as EntryLocalesInput, dr as SetupInput, dt as AltTextResult, ea as JobStatus, ei as UpdateChangeSetInput, en as MediaAssetQuery, eo as ContentIssue, er as PasswordResetConfirmInput, et as ModelPresence, f as codeChallengeOf, fa as ScheduleStatus, fi as DefinitionPayload, fn as ReplaceUploadInput, fo as EntryReferrer, fr as SetupStatusResponse, ft as AssistIssue, g as AppChangePasswordInput, ga as Webhook, gi as Locale, gn as APP_CONTENT_ACTIONS, go as RevisionDetail, gr as UpdateRoleInput, gt as AssistUsage, h as AppAuthApi, ha as UpdateWebhookInput, hi as DeleteLocaleResult, hn as UploadGrant, ho as ExtensionThemeList, hr as UpdateProfileInput, ht as AssistTextResult, i as SEO_FIELD_IDS, ia as PUBLICATION_ACTIONS, ii as ChangePlan, in as MediaStorageDriver, io as CreateEntryInput, ir as RoleAssignment, it as PreflightResponse, j as SiteApi, ja as Site, ji as ConnectionTestResult, jn as ApiToken, jr as ChangeSetTimelineEvent, jt as TranslateResult, k as verifyWebhookSignature, ka as CreateSiteInput, ki as UpdateLocaleInput, kn as AdminUser, kr as ChangeSetStatus, kt as SummarizeInput, l as resolveSeo, la as PublicationAction, li as DefinitionCategory, ln as MediaVisibility, lo as EntryLocaleState, lr as SITE_ACTIONS, lt as AltProposal, m as APP_AUTH_PATHS, ma as UpdateDeploymentConnectionInput, mi as DefinitionScope, mn as UpdateMediaFolderInput, mo as ExtensionTheme, mr as UpdateAdminUserInput, mt as AssistStatus, n as ResolveSeoContext, na as OpenPreviewInput, ni as ActiveDefinition, nn as MediaFocalPoint, no as ContentPagination, nr as PermissionAction, nt as PreflightInput, o as SeoKeys, oa as PreviewTarget, oi as ChangeScopeOutcome, on as MediaUsagePage, oo as EditorManifestItem, or as RoleKind, ot as PresenceHeartbeatInput, p as createPkcePair, pa as ScheduledPublication, pi as DefinitionRevision, pn as UpdateMediaAssetInput, po as EntryStatus, pr as SiteAction, pt as AssistProvider, q as ContentHealthFinding, qa as SeoMode, qi as DeploymentSecretsInput, qn as Invitation, qr as ShipChangeSetInput, qt as SchemaApplyResult, r as SEO_COMPONENT_ID, ra as OpenPreviewResult, ri as ChangeOutcome, rn as MediaFolder, ro as ContentSort, rr as Role, rt as PreflightLocale, s as SeoLocaleDefaults, sa as PreviewToken, si as CreateDefinitionInput, sn as MediaVariant, so as EntryAuthor, sr as RolePermission, st as PresencePerson, t as DEFAULT_SEO_KEYS, ta as JobSummary, ti as Acknowledgement, tn as MediaAssetStatus, to as ContentListQuery, tr as PasswordResetRequestInput, tt as PreflightCheck, u as seoDefaultsForLocale, ua as SCHEDULE_STATUSES, ui as DefinitionDetail, un as MoveMediaAssetsInput, uo as EntryLocaleStatus, ur as SessionStarted, ut as AltTextInput, v as AppOAuthProvider, va as WebhookDelivery, vi as PlanPreview, vn as AppContentAction, vo as UpdateEntryInput, vr as CHANGE_SET_STATUSES, vt as ContentOpsInput, w as WEBHOOK_SIGNATURE_HEADER, wa as FieldUsageQuery, wi as SchemaSettings, wn as CreateAppRoleInput, wr as ChangeSetItemStatus, wt as ContentOpsWritten, x as AppSession, xa as WebhookEventType, xi as PlanUpdateInput, xn as AppUserPage, xr as ChangeSetEntryItem, xt as ContentOpsRun, y as AppRegisterInput, ya as WebhookDeliveryStatus, yi as PlanStep, yn as AppRole, yo as RequestFn, yr as ChangeSet, yt as ContentOpsResult, z as toContentQueryString, za as SeoResolved, zi as DeploymentConnection, zn as CreateApiTokenInput, zr as PutSchemaDraftInput, zt as ReadyResponse } from "./index-D-BBgz21.js";
-export { ADMIN_PATHS, APP_AUTH_PATHS, APP_CONTENT_ACTIONS, ASSIST_PATHS, type AcceptInvitationInput, type Acknowledgement, type ActiveDefinition, type AddChangeSetEntryInput, type AdminApi, type AdminAppUser, type AdminEntry, type AdminEntryListItem, type AdminEntryPage, type AdminSession, type AdminUser, type AdminUserStatus, type AltMissingResult, type AltProposal, type AltTextInput, type AltTextResult, type ApiToken, type AppAuthApi, type AppChangePasswordInput, type AppContentAction, type AppLoginInput, type AppOAuthProvider, type AppPkcePair, type AppRegisterInput, type AppRegisterResult, type AppRole, type AppRolePermission, type AppSession, type AppUser, type AppUserPage, type AppUserQuery, type AssistIssue, type AssistProvider, type AssistStatus, type AssistTextResult, type AssistUsage, type AuditActorType, type AuditEvent, type AuditPage, type AuditQuery, BUILT_IN_APP_ROLE_KEYS, CHANGE_SET_STATUSES, CONTENT_ACTIONS, CONTENT_OPS_RULES, type ChangeOutcome, type ChangePasswordInput, type ChangePlan, type ChangeScopeInput, type ChangeScopeOutcome, type ChangeSet, type ChangeSetActor, type ChangeSetEntryItem, type ChangeSetError, type ChangeSetItem, type ChangeSetItemStatus, type ChangeSetQuery, type ChangeSetReview, type ChangeSetSchemaItem, type ChangeSetSource, type ChangeSetStatus, type ChangeSetSummary, type ChangeSetTimelineEvent, type CheckParams, type CheckSeverity, type CheckStatus, type ConnectionTestResult, type ContentAction, type ContentCount, type ContentCounts, type ContentFilter, type ContentFilterOperator, type ContentFilterValue, type ContentHealthFinding, type ContentHealthPage, type ContentHealthQuery, type ContentHealthSummary, type ContentIssue, type ContentListQuery, type ContentOpsInput, type ContentOpsResult, type ContentOpsRule, type ContentOpsRun, type ContentOpsSkip, type ContentOpsStatus, type ContentOpsWritten, type ContentPagination, type ContentSort, type CreateApiTokenInput, type CreateAppRoleInput, type CreateChangeSetInput, type CreateDefinitionInput, type CreateDeploymentConnectionInput, type CreateEntryInput, type CreateLocaleInput, type CreateMediaFolderInput, type CreatePreviewTokenInput, type CreateRoleInput, type CreateScheduleInput, type CreateSiteInput, type CreateUploadInput, type CreateWebhookInput, type CreatedApiToken, type CsrfResponse, type CurrentSnapshot, DEFAULT_SEO_KEYS, DELIVERY_PATH, DELIVERY_SITE_PATH, DEPLOYMENT_PROVIDERS, DEPLOYMENT_RUN_STATUSES, DEPLOYMENT_TRIGGERS, type DefinitionCategory, type DefinitionDetail, type DefinitionListItem, type DefinitionPayload, type DefinitionRevision, type DefinitionScope, type DeleteLocaleResult, type DeliveryApi, type DeliveryAsset, type DeliveryGetQuery, type DeliveryItem, type DeliveryList, type DeliveryListQuery, type DeliveryMeta, type DeliveryPagination, type DeliverySite, type DeploymentConnection, type DeploymentConnectionCreated, type DeploymentProvider, type DeploymentRun, type DeploymentRunQuery, type DeploymentRunStatus, type DeploymentRunTrigger, type DeploymentSecretState, type DeploymentSecretsInput, type DeploymentSettings, type DeploymentTimelineEvent, type DeploymentTriggerPolicy, type EditorManifest, type EditorManifestItem, type EmailDelivery, type EntryAuthor, type EntryData, type EntryLocaleState, type EntryLocaleStatus, type EntryLocalesInput, type EntryPresence, type EntryReferrer, type EntryStatus, type ExtensionTheme, type ExtensionThemeList, type FieldConsumer, type FieldConsumers, type FieldDiff, type FieldPrincipalUsage, type FieldUsageQuery, type FieldUsageResponse, GLOBAL_ACTIONS, type GlobalAction, HEALTH_RULES, type HealthResponse, type HealthRule, type InspectInvitationResponse, type Invitation, type InvitationLink, type InviteUserInput, JOB_STATUSES, type Job, type JobQuery, type JobStatus, type JobSummary, type Locale, type LocaleMissingResult, type LoginInput, type MeResponse, type MediaAsset, type MediaAssetPage, type MediaAssetQuery, type MediaAssetStatus, type MediaFocalPoint, type MediaFolder, type MediaStorageDriver, type MediaUsage, type MediaUsagePage, type MediaVariant, type MediaVariantStatus, type MediaVisibility, type ModelFieldUsage, type ModelPresence, type MoveMediaAssetsInput, type MoveMediaAssetsResult, NETWORK_ACTIONS, NOT_RESTORABLE_REASONS, type NetworkAction, type NotRestorable, type NotRestorableReason, type OpenPreviewInput, type OpenPreviewResult, PUBLICATION_ACTIONS, type Page, type PasswordResetConfirmInput, type PasswordResetRequestInput, type PermissionAction, type PlanImpact, type PlanPreview, type PlanStep, type PlanStepImpact, type PlanUpdateInput, type PreflightCheck, type PreflightInput, type PreflightLocale, type PreflightResponse, type PreflightRule, type PresenceHeartbeatInput, type PresencePerson, type PreviewTarget, type PreviewToken, type PreviewTokenCreated, type PrincipalUsageSummary, type PublicationAction, type PutSchemaDraftInput, type ReadyResponse, type ReplaceUploadInput, type RequestFn, type RequestOptions, type ResolveSeoContext, type ReviewEntryItem, type ReviewIssue, type ReviewSchemaItem, type RevisionDetail, type RevisionSummary, type RewriteInput, type RichTextMode, type Role, type RoleAssignment, type RoleCondition, type RoleKind, type RolePermission, type RoleSummary, SCHEDULE_STATUSES, SEO_COMPONENT_ID, SEO_FIELD_IDS, SITES_PATHS, SITE_ACTIONS, SITE_HEADER, SITE_QUERY_PARAMETER, SNAPSHOT_SOURCES, type ScheduleChangeSetInput, type ScheduleQuery, type ScheduleStatus, type ScheduledPublication, type SchemaApplyInput, type SchemaApplyResult, type SchemaChangeJob, type SchemaChangeStatus, type SchemaDraft, type SchemaDraftInput, type SchemaDraftResult, type SchemaExport, type SchemaOperation, type SchemaSettings, type SchemaSummary, type SchemaSummaryItem, type SchemaSyncResult, type SeoDefaults, type SeoFields, type SeoKeys, type SeoLocaleDefaults, type SeoMode, type SeoResolved, type SessionStarted, type SetDefaultLocaleResult, type SetSiteAppRolesInput, type SetupInput, type SetupStatusResponse, ShapioApiError, type ShapioClient, type ShapioClientOptions, type ShapioErrorBody, type ShipChangeSetInput, type ShipPhase, type Site, type SiteAction, type SiteApi, type SiteAppRoles, type SiteRef, type SiteSummary, type Snapshot, type SnapshotChange, type SnapshotChangeKind, type SnapshotChangesPage, type SnapshotChangesQuery, type SnapshotPage, type SnapshotQuery, type SnapshotSource, type SummarizeInput, type TranslateInput, type TranslateResult, type UnassignedEntry, type UpdateAdminUserInput, type UpdateAppRoleInput, type UpdateAppUserInput, type UpdateChangeSetInput, type UpdateDefinitionInput, type UpdateDeploymentConnectionInput, type UpdateEntryInput, type UpdateLocaleInput, type UpdateMediaAssetInput, type UpdateMediaFolderInput, type UpdateProfileInput, type UpdateRoleInput, type UpdateSchemaSettingsInput, type UpdateSiteInput, type UpdateWebhookInput, type UploadGrant, type UsageSelection, type VersionResponse, WEBHOOK_EVENT_HEADER, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_TIMESTAMP_HEADER, WEBHOOK_TOLERANCE_SECONDS, type Webhook, type WebhookAttempt, type WebhookDelivery, type WebhookDeliveryStatus, type WebhookEventBody, type WebhookEventType, type WebhookSignatureCheck, type WebhookSignatureInput, type WebhookWithSecret, applyTitleTemplate, buildUploadForm, codeChallengeOf, createClient, createPkcePair, resolveSeo, resolveUploadUrl, seoDefaultsForLocale, toContentQueryString, verifyWebhookSignature };
+import { $ as ContentHealthSummary, $a as AdminEntry, $i as DeploymentSettings, $n as InvitationLink, $r as ShipPhase, $t as CreateMediaFolderInput, A as DELIVERY_SITE_PATH, Aa as FieldUsageResponse, Ai as SchemaSummary, An as AcceptInvitationInput, Ar as ChangeSetQuery, At as SchemaDraftInput, B as buildUploadForm, Ba as UpdateSiteInput, Bi as CreateWebhookInput, Bn as ChangePasswordInput, Br as FieldDiff, Bt as CheckStatus, C as WEBHOOK_EVENT_HEADER, Ca as WebhookDelivery, Ci as PlanPreview, Cn as AppRolePermission, Co as UpdateEntryInput, Cr as CHANGE_SET_STATUSES, Ct as ContentOpsRule, D as WebhookSignatureCheck, Da as WebhookWithSecret, Di as SchemaChangeJob, Dn as CreateAppRoleInput, Do as NextCacheMode, Dr as ChangeSetError, Dt as ContentOpsWritten, E as WEBHOOK_TOLERANCE_SECONDS, Ea as WebhookEventType, Ei as PlanUpdateInput, En as BUILT_IN_APP_ROLE_KEYS, Eo as DeliveryReadOptions, Er as ChangeSetEntryItem, Et as ContentOpsStatus, F as createDeliveryClient, Fa as SetSiteAppRolesInput, Fi as UpdateSchemaSettingsInput, Fn as AuditActorType, Fr as ChangeSetSummary, Ft as ShapioApiError, G as ADMIN_PATHS, Ga as DeliveryGetQuery, Gi as DeploymentConnectionCreated, Gn as CsrfResponse, Gr as ReviewEntryItem, Gt as SnapshotChange, H as toContentQueryString, Ha as DeliverySite, Hi as DEPLOYMENT_RUN_STATUSES, Hn as CreateApiTokenInput, Hr as NotRestorable, Ht as ReadyResponse, I as DELIVERY_PATH, Ia as Site, Ii as ConnectionTestResult, In as AuditEvent, Ir as ChangeSetTimelineEvent, It as ShapioErrorBody, J as ContentCount, Ja as DeliveryListQuery, Ji as DeploymentRunQuery, Jn as EmailDelivery, Jr as SNAPSHOT_SOURCES, Jt as SnapshotChangesQuery, K as CheckParams, Ka as DeliveryItem, Ki as DeploymentProvider, Kn as DELIVERY_ACTIONS, Kr as ReviewIssue, Kt as SnapshotChangeKind, L as DeliveryApi, La as SiteAppRoles, Li as CreateDeploymentConnectionInput, Ln as AuditPage, Lr as CreateChangeSetInput, Lt as ShapioClient, M as SITE_QUERY_PARAMETER, Ma as PrincipalUsageSummary, Mi as SetDefaultLocaleResult, Mn as AdminUser, Mr as ChangeSetSchemaItem, Mt as SummarizeInput, N as DeliveryClientOptions, Na as UsageSelection, Ni as UpdateDefinitionInput, Nn as AdminUserStatus, Nr as ChangeSetSource, Nt as TranslateInput, O as WebhookSignatureInput, Oa as FieldPrincipalUsage, Oi as SchemaChangeStatus, On as UpdateAppRoleInput, Oo as NextCacheOptions, Or as ChangeSetItem, Ot as LocaleMissingResult, P as ShapioDeliveryClient, Pa as CreateSiteInput, Pi as UpdateLocaleInput, Pn as ApiToken, Pr as ChangeSetStatus, Pt as TranslateResult, Q as ContentHealthQuery, Qa as SeoMode, Qi as DeploymentSecretsInput, Qn as Invitation, Qr as ShipChangeSetInput, Qt as SchemaSyncResult, R as AdminApi, Ra as SiteRef, Ri as CreatePreviewTokenInput, Rn as AuditQuery, Rr as FieldConsumer, Rt as ShapioClientOptions, S as AppUser, Sa as WebhookAttempt, Si as PlanImpact, Sn as AppRole, So as RevisionSummary, Sr as AddChangeSetEntryInput, St as ContentOpsResult, T as WEBHOOK_TIMESTAMP_HEADER, Ta as WebhookEventBody, Ti as PlanStepImpact, Tn as AppUserQuery, To as RequestOptions, Tr as ChangeSetActor, Tt as ContentOpsSkip, U as SITES_PATHS, Ua as SeoFields, Ui as DEPLOYMENT_TRIGGERS, Un as CreateRoleInput, Ur as NotRestorableReason, Ut as VersionResponse, V as resolveUploadUrl, Va as DeliveryAsset, Vi as DEPLOYMENT_PROVIDERS, Vn as ContentAction, Vr as NOT_RESTORABLE_REASONS, Vt as HealthResponse, W as SITE_HEADER, Wa as SeoResolved, Wi as DeploymentConnection, Wn as CreatedApiToken, Wr as PutSchemaDraftInput, Wt as CurrentSnapshot, X as ContentHealthFinding, Xa as DeliveryPagination, Xi as DeploymentRunTrigger, Xn as GlobalAction, Xr as SchemaDraft, Xt as SchemaApplyResult, Y as ContentCounts, Ya as DeliveryMeta, Yi as DeploymentRunStatus, Yn as GLOBAL_ACTIONS, Yr as ScheduleChangeSetInput, Yt as SchemaApplyInput, Z as ContentHealthPage, Za as RichTextMode, Zi as DeploymentSecretState, Zn as InspectInvitationResponse, Zr as SchemaOperation, Zt as SchemaExport, _ as AppLoginInput, _a as ScheduleStatus, _i as DefinitionPayload, _n as UpdateMediaFolderInput, _o as EntryReferrer, _r as SetupStatusResponse, _t as AssistStatus, a as SeoDefaults, aa as JobStatus, ai as UpdateChangeSetInput, an as MediaFocalPoint, ao as ContentIssue, ar as PasswordResetConfirmInput, at as PreflightInput, b as AppRegisterResult, ba as UpdateWebhookInput, bi as DeleteLocaleResult, bn as AdminAppUser, bo as ExtensionThemeList, br as UpdateProfileInput, bt as CONTENT_OPS_RULES, c as applyTitleTemplate, ca as OpenPreviewResult, ci as ChangeOutcome, cn as MediaUsage, co as ContentSort, cr as Role, ct as PreflightRule, d as AppPkcePair, da as PreviewTarget, di as ChangeScopeOutcome, dn as MediaVariantStatus, do as EditorManifestItem, dr as RoleKind, dt as AltMissingResult, ea as DeploymentTimelineEvent, ei as Snapshot, en as CreateUploadInput, eo as AdminEntryListItem, er as InviteUserInput, et as EntryPresence, f as codeChallengeOf, fa as PreviewToken, fi as CreateDefinitionInput, fn as MediaVisibility, fo as EntryAuthor, fr as RolePermission, ft as AltProposal, g as AppChangePasswordInput, ga as ScheduleQuery, gi as DefinitionListItem, gn as UpdateMediaAssetInput, go as EntryLocalesInput, gr as SetupInput, gt as AssistProvider, h as AppAuthApi, ha as SCHEDULE_STATUSES, hi as DefinitionDetail, hn as ReplaceUploadInput, ho as EntryLocaleStatus, hr as SessionStarted, ht as AssistIssue, i as SEO_FIELD_IDS, ia as JobQuery, ii as UnassignedEntry, in as MediaAssetStatus, io as ContentFilterValue, ir as NetworkAction, it as PreflightCheck, j as SiteApi, ja as ModelFieldUsage, ji as SchemaSummaryItem, jn as AdminSession, jr as ChangeSetReview, jt as SchemaDraftResult, k as verifyWebhookSignature, ka as FieldUsageQuery, ki as SchemaSettings, kn as UpdateAppUserInput, ko as shapioTags, kr as ChangeSetItemStatus, kt as RewriteInput, l as resolveSeo, la as PUBLICATION_ACTIONS, li as ChangePlan, ln as MediaUsagePage, lo as CreateEntryInput, lr as RoleAssignment, lt as PresenceHeartbeatInput, m as APP_AUTH_PATHS, ma as PublicationAction, mi as DefinitionCategory, mn as MoveMediaAssetsResult, mo as EntryLocaleState, mr as SITE_ACTIONS, mt as AltTextResult, n as ResolveSeoContext, na as JOB_STATUSES, ni as SnapshotQuery, nn as MediaAssetPage, no as ContentFilter, nr as MeResponse, nt as HealthRule, o as SeoKeys, oa as JobSummary, oi as Acknowledgement, on as MediaFolder, oo as ContentListQuery, or as PasswordResetRequestInput, ot as PreflightLocale, p as createPkcePair, pa as PreviewTokenCreated, pi as CreateLocaleInput, pn as MoveMediaAssetsInput, po as EntryData, pr as RoleSummary, pt as AltTextInput, q as CheckSeverity, qa as DeliveryList, qi as DeploymentRun, qn as DeliveryAction, qr as ReviewSchemaItem, qt as SnapshotChangesPage, r as SEO_COMPONENT_ID, ra as Job, ri as SnapshotSource, rn as MediaAssetQuery, ro as ContentFilterOperator, rr as NETWORK_ACTIONS, rt as ModelPresence, s as SeoLocaleDefaults, sa as OpenPreviewInput, si as ActiveDefinition, sn as MediaStorageDriver, so as ContentPagination, sr as PermissionAction, st as PreflightResponse, t as DEFAULT_SEO_KEYS, ta as DeploymentTriggerPolicy, ti as SnapshotPage, tn as MediaAsset, to as AdminEntryPage, tr as LoginInput, tt as HEALTH_RULES, u as seoDefaultsForLocale, ua as Page, ui as ChangeScopeInput, un as MediaVariant, uo as EditorManifest, ur as RoleCondition, ut as PresencePerson, v as AppOAuthProvider, va as ScheduledPublication, vi as DefinitionRevision, vn as UploadGrant, vo as EntryStatus, vr as SiteAction, vt as AssistTextResult, w as WEBHOOK_SIGNATURE_HEADER, wa as WebhookDeliveryStatus, wi as PlanStep, wn as AppUserPage, wo as RequestFn, wr as ChangeSet, wt as ContentOpsRun, x as AppSession, xa as Webhook, xi as Locale, xn as AppContentAction, xo as RevisionDetail, xr as UpdateRoleInput, xt as ContentOpsInput, y as AppRegisterInput, ya as UpdateDeploymentConnectionInput, yi as DefinitionScope, yn as APP_CONTENT_ACTIONS, yo as ExtensionTheme, yr as UpdateAdminUserInput, yt as AssistUsage, z as ASSIST_PATHS, za as SiteSummary, zi as CreateScheduleInput, zn as CONTENT_ACTIONS, zr as FieldConsumers, zt as createClient } from "./index-BWuxc5nS.js";
+export { ADMIN_PATHS, APP_AUTH_PATHS, APP_CONTENT_ACTIONS, ASSIST_PATHS, type AcceptInvitationInput, type Acknowledgement, type ActiveDefinition, type AddChangeSetEntryInput, type AdminApi, type AdminAppUser, type AdminEntry, type AdminEntryListItem, type AdminEntryPage, type AdminSession, type AdminUser, type AdminUserStatus, type AltMissingResult, type AltProposal, type AltTextInput, type AltTextResult, type ApiToken, type AppAuthApi, type AppChangePasswordInput, type AppContentAction, type AppLoginInput, type AppOAuthProvider, type AppPkcePair, type AppRegisterInput, type AppRegisterResult, type AppRole, type AppRolePermission, type AppSession, type AppUser, type AppUserPage, type AppUserQuery, type AssistIssue, type AssistProvider, type AssistStatus, type AssistTextResult, type AssistUsage, type AuditActorType, type AuditEvent, type AuditPage, type AuditQuery, BUILT_IN_APP_ROLE_KEYS, CHANGE_SET_STATUSES, CONTENT_ACTIONS, CONTENT_OPS_RULES, type ChangeOutcome, type ChangePasswordInput, type ChangePlan, type ChangeScopeInput, type ChangeScopeOutcome, type ChangeSet, type ChangeSetActor, type ChangeSetEntryItem, type ChangeSetError, type ChangeSetItem, type ChangeSetItemStatus, type ChangeSetQuery, type ChangeSetReview, type ChangeSetSchemaItem, type ChangeSetSource, type ChangeSetStatus, type ChangeSetSummary, type ChangeSetTimelineEvent, type CheckParams, type CheckSeverity, type CheckStatus, type ConnectionTestResult, type ContentAction, type ContentCount, type ContentCounts, type ContentFilter, type ContentFilterOperator, type ContentFilterValue, type ContentHealthFinding, type ContentHealthPage, type ContentHealthQuery, type ContentHealthSummary, type ContentIssue, type ContentListQuery, type ContentOpsInput, type ContentOpsResult, type ContentOpsRule, type ContentOpsRun, type ContentOpsSkip, type ContentOpsStatus, type ContentOpsWritten, type ContentPagination, type ContentSort, type CreateApiTokenInput, type CreateAppRoleInput, type CreateChangeSetInput, type CreateDefinitionInput, type CreateDeploymentConnectionInput, type CreateEntryInput, type CreateLocaleInput, type CreateMediaFolderInput, type CreatePreviewTokenInput, type CreateRoleInput, type CreateScheduleInput, type CreateSiteInput, type CreateUploadInput, type CreateWebhookInput, type CreatedApiToken, type CsrfResponse, type CurrentSnapshot, DEFAULT_SEO_KEYS, DELIVERY_ACTIONS, DELIVERY_PATH, DELIVERY_SITE_PATH, DEPLOYMENT_PROVIDERS, DEPLOYMENT_RUN_STATUSES, DEPLOYMENT_TRIGGERS, type DefinitionCategory, type DefinitionDetail, type DefinitionListItem, type DefinitionPayload, type DefinitionRevision, type DefinitionScope, type DeleteLocaleResult, type DeliveryAction, type DeliveryApi, type DeliveryAsset, type DeliveryClientOptions, type DeliveryGetQuery, type DeliveryItem, type DeliveryList, type DeliveryListQuery, type DeliveryMeta, type DeliveryPagination, type DeliveryReadOptions, type DeliverySite, type DeploymentConnection, type DeploymentConnectionCreated, type DeploymentProvider, type DeploymentRun, type DeploymentRunQuery, type DeploymentRunStatus, type DeploymentRunTrigger, type DeploymentSecretState, type DeploymentSecretsInput, type DeploymentSettings, type DeploymentTimelineEvent, type DeploymentTriggerPolicy, type EditorManifest, type EditorManifestItem, type EmailDelivery, type EntryAuthor, type EntryData, type EntryLocaleState, type EntryLocaleStatus, type EntryLocalesInput, type EntryPresence, type EntryReferrer, type EntryStatus, type ExtensionTheme, type ExtensionThemeList, type FieldConsumer, type FieldConsumers, type FieldDiff, type FieldPrincipalUsage, type FieldUsageQuery, type FieldUsageResponse, GLOBAL_ACTIONS, type GlobalAction, HEALTH_RULES, type HealthResponse, type HealthRule, type InspectInvitationResponse, type Invitation, type InvitationLink, type InviteUserInput, JOB_STATUSES, type Job, type JobQuery, type JobStatus, type JobSummary, type Locale, type LocaleMissingResult, type LoginInput, type MeResponse, type MediaAsset, type MediaAssetPage, type MediaAssetQuery, type MediaAssetStatus, type MediaFocalPoint, type MediaFolder, type MediaStorageDriver, type MediaUsage, type MediaUsagePage, type MediaVariant, type MediaVariantStatus, type MediaVisibility, type ModelFieldUsage, type ModelPresence, type MoveMediaAssetsInput, type MoveMediaAssetsResult, NETWORK_ACTIONS, NOT_RESTORABLE_REASONS, type NetworkAction, type NextCacheMode, type NextCacheOptions, type NotRestorable, type NotRestorableReason, type OpenPreviewInput, type OpenPreviewResult, PUBLICATION_ACTIONS, type Page, type PasswordResetConfirmInput, type PasswordResetRequestInput, type PermissionAction, type PlanImpact, type PlanPreview, type PlanStep, type PlanStepImpact, type PlanUpdateInput, type PreflightCheck, type PreflightInput, type PreflightLocale, type PreflightResponse, type PreflightRule, type PresenceHeartbeatInput, type PresencePerson, type PreviewTarget, type PreviewToken, type PreviewTokenCreated, type PrincipalUsageSummary, type PublicationAction, type PutSchemaDraftInput, type ReadyResponse, type ReplaceUploadInput, type RequestFn, type RequestOptions, type ResolveSeoContext, type ReviewEntryItem, type ReviewIssue, type ReviewSchemaItem, type RevisionDetail, type RevisionSummary, type RewriteInput, type RichTextMode, type Role, type RoleAssignment, type RoleCondition, type RoleKind, type RolePermission, type RoleSummary, SCHEDULE_STATUSES, SEO_COMPONENT_ID, SEO_FIELD_IDS, SITES_PATHS, SITE_ACTIONS, SITE_HEADER, SITE_QUERY_PARAMETER, SNAPSHOT_SOURCES, type ScheduleChangeSetInput, type ScheduleQuery, type ScheduleStatus, type ScheduledPublication, type SchemaApplyInput, type SchemaApplyResult, type SchemaChangeJob, type SchemaChangeStatus, type SchemaDraft, type SchemaDraftInput, type SchemaDraftResult, type SchemaExport, type SchemaOperation, type SchemaSettings, type SchemaSummary, type SchemaSummaryItem, type SchemaSyncResult, type SeoDefaults, type SeoFields, type SeoKeys, type SeoLocaleDefaults, type SeoMode, type SeoResolved, type SessionStarted, type SetDefaultLocaleResult, type SetSiteAppRolesInput, type SetupInput, type SetupStatusResponse, ShapioApiError, type ShapioClient, type ShapioClientOptions, type ShapioDeliveryClient, type ShapioErrorBody, type ShipChangeSetInput, type ShipPhase, type Site, type SiteAction, type SiteApi, type SiteAppRoles, type SiteRef, type SiteSummary, type Snapshot, type SnapshotChange, type SnapshotChangeKind, type SnapshotChangesPage, type SnapshotChangesQuery, type SnapshotPage, type SnapshotQuery, type SnapshotSource, type SummarizeInput, type TranslateInput, type TranslateResult, type UnassignedEntry, type UpdateAdminUserInput, type UpdateAppRoleInput, type UpdateAppUserInput, type UpdateChangeSetInput, type UpdateDefinitionInput, type UpdateDeploymentConnectionInput, type UpdateEntryInput, type UpdateLocaleInput, type UpdateMediaAssetInput, type UpdateMediaFolderInput, type UpdateProfileInput, type UpdateRoleInput, type UpdateSchemaSettingsInput, type UpdateSiteInput, type UpdateWebhookInput, type UploadGrant, type UsageSelection, type VersionResponse, WEBHOOK_EVENT_HEADER, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_TIMESTAMP_HEADER, WEBHOOK_TOLERANCE_SECONDS, type Webhook, type WebhookAttempt, type WebhookDelivery, type WebhookDeliveryStatus, type WebhookEventBody, type WebhookEventType, type WebhookSignatureCheck, type WebhookSignatureInput, type WebhookWithSecret, applyTitleTemplate, buildUploadForm, codeChallengeOf, createClient, createDeliveryClient, createPkcePair, resolveSeo, resolveUploadUrl, seoDefaultsForLocale, shapioTags, toContentQueryString, verifyWebhookSignature };

package/dist/index.js

@@ -457,6 +457,11 @@ const CONTENT_ACTIONS = [
 	"schemaManage"
 ];
 /**
+* What a delivery role grants: `read`, and `readDrafts` (drafts mode: the token's site may read drafts with
+* `publicationState=draft`). `readDrafts` always covers every model and is never granted to admin roles.
+*/
+const DELIVERY_ACTIONS = ["read", "readDrafts"];
+/**
 * Network actions: about the whole instance. Only roles assigned on every site grant them, so a role held
 * on one site never reaches the network.
 */
@@ -799,34 +804,115 @@ const createAppAuthApi = (request, baseUrl) => ({
 	})
 });
 //#endregion
+//#region src/nextCache.ts
+const TAG_PREFIX = "shapio";
+/**
+* The cache tags delivery reads carry (`revalidateTag(shapioTags.entry('articles', id), { expire: 0 })`).
+* Models are named by their route key: a collection's plural API ID, a singleton's API ID.
+*/
+const shapioTags = {
+	/** Every delivery read of the site; `shapio:site` when the client names no site. */
+	site: (siteKey) => siteKey === void 0 ? `${TAG_PREFIX}:site` : `${TAG_PREFIX}:site:${siteKey}`,
+	/** Every read of one model (lists, singletons and its entries). */
+	model: (routeKey) => `${TAG_PREFIX}:${routeKey}`,
+	/** Reads of one entry by its ID. */
+	entry: (routeKey, entryId) => `${TAG_PREFIX}:${routeKey}:${entryId}`
+};
+/** Spelled out so bundlers that inline `process.env.NEXT_RUNTIME` see it; guarded for browsers. */
+const isNextRuntime = () => {
+	try {
+		return typeof process !== "undefined" && Boolean(process.env.NEXT_RUNTIME);
+	} catch {
+		return false;
+	}
+};
+/** The `cache` and `next` fetch options of one delivery read; empty outside Next unless asked for. */
+const nextFetchInit = ({ client, read, tags, pinned, drafts = false }) => {
+	if (drafts) return client !== void 0 && client !== false || read !== void 0 && read !== false || isNextRuntime() ? { cache: "no-store" } : {};
+	if (read === false || read === void 0 && client === false) return {};
+	const configured = client === false ? read : read === void 0 ? client : {
+		...client,
+		...read
+	};
+	if (configured === void 0 && !isNextRuntime()) return {};
+	if (pinned && read?.cache === void 0) return {
+		cache: "force-cache",
+		next: { tags }
+	};
+	const cache = configured?.cache;
+	const revalidate = configured?.revalidate;
+	return {
+		...cache === void 0 ? {} : { cache },
+		next: {
+			tags,
+			...revalidate === void 0 ? {} : { revalidate }
+		}
+	};
+};
+//#endregion
 //#region src/delivery.ts
 const DELIVERY_PATH = "/api/content";
 const routePath = (routeKey) => `${DELIVERY_PATH}/${encodeURIComponent(routeKey)}`;
-/** The content query string plus `snapshot`, `richText` and `seo`, which only delivery reads take. */
-const deliveryQueryString = ({ snapshot, richText, seo, ...query }) => {
+/**
+* The content query string plus `snapshot`, `richText` and `seo`, which only delivery reads take, and
+* `publicationState=draft` in drafts mode.
+*/
+const deliveryQueryString = ({ snapshot, richText, seo, ...query }, drafts) => {
 	const extra = [
 		...snapshot === void 0 ? [] : [`snapshot=${encodeURIComponent(String(snapshot))}`],
 		...richText === void 0 ? [] : [`richText=${encodeURIComponent(richText)}`],
-		...seo === void 0 ? [] : [`seo=${encodeURIComponent(seo)}`]
+		...seo === void 0 ? [] : [`seo=${encodeURIComponent(seo)}`],
+		...drafts ? ["publicationState=draft"] : []
 	];
 	const base = toContentQueryString(query);
 	if (extra.length === 0) return base;
 	return base ? `${base}&${extra.join("&")}` : `?${extra.join("&")}`;
 };
+/** Drafts cannot be pinned: the server refuses `snapshot` with drafts, and so does the client, before sending. */
+const draftsPinned = () => Promise.reject(/* @__PURE__ */ new Error("Drafts mode reads saved drafts, which have no publication snapshot: leave `snapshot` out when the client has `drafts: true`"));
 /**
 * Published content, typed by the caller (`delivery.list<Article>('articles', { locale: 'fr', snapshot })`).
-* A collection is read with `list` (a page) and `get` (one entry); a singleton with `singleton`.
+* A collection is read with `list` (a page) and `get` (one entry); a singleton with `singleton`. Each read
+* takes Next.js cache options last and is tagged for `revalidateTag` (nextCache.ts): lists and singletons with
+* the site and model tags, `get` with the entry's tag too. In drafts mode (`drafts: true`) every read asks for
+* drafts (`publicationState=draft`), is never cached or tagged under Next, and refuses a pinned snapshot.
 */
-const createDeliveryApi = (request) => ({
-	list: (routeKey, query = {}) => request(`${routePath(routeKey)}${deliveryQueryString(query)}`),
-	singleton: (apiKey, query = {}) => request(`${routePath(apiKey)}${deliveryQueryString(query)}`),
-	get: (routeKey, id, query = {}) => request(`${routePath(routeKey)}/${encodeURIComponent(id)}${deliveryQueryString(query)}`)
-});
+const createDeliveryApi = (request, cacheContext) => {
+	const { drafts } = cacheContext;
+	const fetchInit = (tags, query, { next }) => nextFetchInit({
+		client: cacheContext.next,
+		read: next,
+		tags,
+		pinned: query.snapshot !== void 0,
+		drafts
+	});
+	const read = (path, tags, query, options) => drafts && query.snapshot !== void 0 ? draftsPinned() : request(`${path}${deliveryQueryString(query, drafts)}`, fetchInit(tags, query, options));
+	const siteTag = shapioTags.site(cacheContext.site);
+	return {
+		list: (routeKey, query = {}, options = {}) => read(routePath(routeKey), [siteTag, shapioTags.model(routeKey)], query, options),
+		singleton: (apiKey, query = {}, options = {}) => read(routePath(apiKey), [siteTag, shapioTags.model(apiKey)], query, options),
+		get: (routeKey, id, query = {}, options = {}) => read(`${routePath(routeKey)}/${encodeURIComponent(id)}`, [
+			siteTag,
+			shapioTags.model(routeKey),
+			shapioTags.entry(routeKey, id)
+		], query, options)
+	};
+};
 //#endregion
 //#region src/siteDelivery.ts
 const DELIVERY_SITE_PATH = "/api/site";
-/** The request's site as delivery sees it (key, name, SEO defaults), with the client's token and site. */
-const createSiteApi = (request) => ({ get: () => request(DELIVERY_SITE_PATH) });
+/**
+* The request's site as delivery sees it (key, name, SEO defaults), with the client's token and site. Under
+* Next.js the read carries the site tag (nextCache.ts); in drafts mode it is `no-store` and untagged instead
+* (the site has no draft state, so no `publicationState` is sent).
+*/
+const createSiteApi = (request, cacheContext) => ({ get: ({ next } = {}) => request(DELIVERY_SITE_PATH, nextFetchInit({
+	client: cacheContext.next,
+	read: next,
+	tags: [shapioTags.site(cacheContext.site)],
+	pinned: false,
+	drafts: cacheContext.drafts
+})) });
 //#endregion
 //#region src/snapshots.ts
 const SNAPSHOT_PATHS = {
@@ -862,6 +948,28 @@ const createSnapshotsApi = (request) => {
 	};
 };
 //#endregion
+//#region src/deliveryClient.ts
+/**
+* The read side of the client over any transport: published content (`delivery`), the site (`site`) and
+* publication snapshots (`snapshots`). `createClient` builds it over HTTP; `@shapio/local` over the delivery
+* API running in the same process. The transport receives exactly the paths the HTTP client sends.
+*/
+const createDeliveryClient = (request, { site, next, drafts = false } = {}) => {
+	const cacheContext = {
+		site,
+		next,
+		drafts
+	};
+	return {
+		/** Published content (the delivery API; drafts in drafts mode), typed by the caller. */
+		delivery: createDeliveryApi(request, cacheContext),
+		/** The site as delivery sees it: key, name and SEO defaults (`GET /api/site`). */
+		site: createSiteApi(request, cacheContext),
+		/** Publication snapshots and the diff between two (incremental builds). */
+		snapshots: createSnapshotsApi(request)
+	};
+};
+//#endregion
 //#region src/site.ts
 /** Delivery reads name their site with `?site=`; everything else with the `Shapio-Site` header. */
 const SITE_QUERY_PARAMETER = "site";
@@ -913,7 +1021,7 @@ const parseBody = async (response) => {
 /** Builds the JSON request function every endpoint group uses. Non-2xx responses throw ShapioApiError. */
 const createRequest = ({ baseUrl, token, fetch, credentials, headers, site }) => {
 	const origin = baseUrl.replace(/\/+$/, "");
-	return async (requestPath, { method = "GET", body, signal } = {}) => {
+	return async (requestPath, { method = "GET", body, signal, cache, next } = {}) => {
 		const { path, headers: siteHeaders } = applySite(site, method, requestPath);
 		const requestHeaders = {
 			accept: "application/json",
@@ -922,13 +1030,16 @@ const createRequest = ({ baseUrl, token, fetch, credentials, headers, site }) =>
 		};
 		if (token) requestHeaders.authorization = `Bearer ${token}`;
 		if (body !== void 0) requestHeaders["content-type"] = "application/json";
-		const response = await fetch(`${origin}${path}`, {
+		const init = {
 			method,
 			headers: requestHeaders,
 			...body !== void 0 ? { body: JSON.stringify(body) } : {},
 			...signal ? { signal } : {},
-			...credentials ? { credentials } : {}
-		});
+			...credentials ? { credentials } : {},
+			...cache ? { cache } : {},
+			...next ? { next } : {}
+		};
+		const response = await fetch(`${origin}${path}`, init);
 		const parsed = await parseBody(response);
 		if (!response.ok) throw new ShapioApiError(response.status, parsed);
 		return parsed;
@@ -936,7 +1047,7 @@ const createRequest = ({ baseUrl, token, fetch, credentials, headers, site }) =>
 };
 //#endregion
 //#region src/client.ts
-const createClient = ({ baseUrl, token, fetch = globalThis.fetch, credentials, headers, site }) => {
+const createClient = ({ baseUrl, token, fetch = globalThis.fetch, credentials, headers, site, next, drafts }) => {
 	const request = createRequest({
 		baseUrl,
 		token,
@@ -945,6 +1056,11 @@ const createClient = ({ baseUrl, token, fetch = globalThis.fetch, credentials, h
 		headers,
 		site
 	});
+	const reads = createDeliveryClient(request, {
+		site,
+		next,
+		...drafts !== void 0 ? { drafts } : {}
+	});
 	return {
 		/**
 		* Any Shapio route, e.g. the delivery API. Delivery paths use the model's route key: a collection's
@@ -958,12 +1074,12 @@ const createClient = ({ baseUrl, token, fetch = globalThis.fetch, credentials, h
 			version: (signal) => request("/api/version", signal ? { signal } : {})
 		},
 		/** Published content (the delivery API), typed by the caller. */
-		delivery: createDeliveryApi(request),
+		delivery: reads.delivery,
 		/** The site as delivery sees it: key, name and SEO defaults (`GET /api/site`). */
-		site: createSiteApi(request),
+		site: reads.site,
 		admin: createAdminApi(request),
 		/** Publication snapshots and the diff between two (incremental builds). */
-		snapshots: createSnapshotsApi(request),
+		snapshots: reads.snapshots,
 		/** End users of your sites and apps: sign-up, sign-in, tokens, OAuth. */
 		appAuth: createAppAuthApi(request, baseUrl)
 	};
@@ -1030,6 +1146,6 @@ const createPkcePair = async () => {
 	};
 };
 //#endregion
-export { ADMIN_PATHS, APP_AUTH_PATHS, APP_CONTENT_ACTIONS, ASSIST_PATHS, BUILT_IN_APP_ROLE_KEYS, CHANGE_SET_STATUSES, CONTENT_ACTIONS, CONTENT_OPS_RULES, DEFAULT_SEO_KEYS, DELIVERY_PATH, DELIVERY_SITE_PATH, DEPLOYMENT_PROVIDERS, DEPLOYMENT_RUN_STATUSES, DEPLOYMENT_TRIGGERS, GLOBAL_ACTIONS, HEALTH_RULES, JOB_STATUSES, NETWORK_ACTIONS, NOT_RESTORABLE_REASONS, PUBLICATION_ACTIONS, SCHEDULE_STATUSES, SEO_COMPONENT_ID, SEO_FIELD_IDS, SITES_PATHS, SITE_ACTIONS, SITE_HEADER, SITE_QUERY_PARAMETER, SNAPSHOT_SOURCES, ShapioApiError, WEBHOOK_EVENT_HEADER, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_TIMESTAMP_HEADER, WEBHOOK_TOLERANCE_SECONDS, applyTitleTemplate, buildUploadForm, codeChallengeOf, createClient, createPkcePair, resolveSeo, resolveUploadUrl, seoDefaultsForLocale, toContentQueryString, verifyWebhookSignature };
+export { ADMIN_PATHS, APP_AUTH_PATHS, APP_CONTENT_ACTIONS, ASSIST_PATHS, BUILT_IN_APP_ROLE_KEYS, CHANGE_SET_STATUSES, CONTENT_ACTIONS, CONTENT_OPS_RULES, DEFAULT_SEO_KEYS, DELIVERY_ACTIONS, DELIVERY_PATH, DELIVERY_SITE_PATH, DEPLOYMENT_PROVIDERS, DEPLOYMENT_RUN_STATUSES, DEPLOYMENT_TRIGGERS, GLOBAL_ACTIONS, HEALTH_RULES, JOB_STATUSES, NETWORK_ACTIONS, NOT_RESTORABLE_REASONS, PUBLICATION_ACTIONS, SCHEDULE_STATUSES, SEO_COMPONENT_ID, SEO_FIELD_IDS, SITES_PATHS, SITE_ACTIONS, SITE_HEADER, SITE_QUERY_PARAMETER, SNAPSHOT_SOURCES, ShapioApiError, WEBHOOK_EVENT_HEADER, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_TIMESTAMP_HEADER, WEBHOOK_TOLERANCE_SECONDS, applyTitleTemplate, buildUploadForm, codeChallengeOf, createClient, createDeliveryClient, createPkcePair, resolveSeo, resolveUploadUrl, seoDefaultsForLocale, shapioTags, toContentQueryString, verifyWebhookSignature };
 
 //# sourceMappingURL=index.js.map