@laioutr/app-hygraph 1.9.0 → 1.10.0

package/README.md

@@ -24,6 +24,10 @@ Other Laioutr apps that also talk to Hygraph can import the client, middleware,
 
 The module also includes a demo blog implementation with orchestr-handlers for blog content: query handlers and query template providers for blog collections and posts, link handlers for connecting posts to collections, and component resolvers for rendering both.
 
+### Content Preview
+
+When a request is marked as a preview (`clientEnv.isPreview`, set by Laioutr's content-preview gate), the connector reads Hygraph's **Draft** stage instead of **Published**, so editors see unpublished changes. This requires a [`previewToken`](#configuration) with Draft-stage permission; without one the connector fails soft and keeps serving published content.
+
 ## Configuration
 
 Add the module to your `nuxt.config.ts` and provide your Hygraph credentials:
@@ -44,6 +48,8 @@ export default defineNuxtConfig({
 | `contentApiUrl` | Hygraph Content API endpoint                                                                                                                                                                                                                                                                                   |
 | `imageBaseUrl`  | Hygraph image CDN base URL (used by [`@nuxt/image`](https://image.nuxt.com/providers/hygraph)). Region-specific; find yours by querying `{ assets(first: 1) { url } }` against your Content API and taking the domain + first path-segment, e.g. `https://eu-west-2.graphassets.com/cmh4jxx7w1fce07l80dils2d1` |
 | `token`         | Permanent auth token for the Content API                                                                                                                                                                                                                                                                       |
+| `previewToken`  | Optional. Separate PAT with Draft-stage read permission, used only for preview requests. Kept distinct from `token` so published reads keep a least-privileged credential. Without it the connector always serves published content, even for requests marked as preview.                                        |
+| `previewApiUrl` | Optional. Alternate Content API endpoint for preview (Draft) reads. Hygraph's Content API already serves both stages, so this is only needed if a project observes CDN staleness on drafts.                                                                                                                      |
 
 ## Exports
 
@@ -132,6 +138,7 @@ npx @laioutr/cli rc fetch -p <org-slug>/<project-slug> -s <secret-key>
 export HYGRAPH_CONTENT_API_URL=<your-content-api-url>
 export HYGRAPH_TOKEN=<your-token>
 export HYGRAPH_IMAGE_BASE_URL=<your-image-base-url>
+export HYGRAPH_PREVIEW_TOKEN=<your-draft-stage-token> # optional, enables preview/draft reads
 pnpm dev
 ```
 

package/dist/module.d.mts

@@ -7,6 +7,14 @@ interface ModuleOptions {
     contentApiUrl: string;
     imageBaseUrl: string;
     token: string;
+    /**
+     * Optional. PAT with Draft-stage read permission. Separate from `token` so published reads keep a
+     * least-privileged credential. Without it the connector always serves published content, even when
+     * a verified preview token marks the request as a preview.
+     */
+    previewToken?: string;
+    /** Optional. Hygraph's Content API serves both stages; only needed if a project observes CDN staleness on drafts. */
+    previewApiUrl?: string;
 }
 /**
  * The config the module adds to nuxt.runtimeConfig.public['@laioutr/app-hygraph']

package/dist/module.json

@@ -1,6 +1,6 @@
 {
   "name": "@laioutr/app-hygraph",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "configKey": "@laioutr/app-hygraph",
   "builder": {
     "@nuxt/module-builder": "1.0.1",

package/dist/module.mjs

@@ -3,7 +3,7 @@ import { defu } from 'defu';
 import { registerLaioutrApp } from '@laioutr-core/kit';
 
 const name = "@laioutr/app-hygraph";
-const version = "1.9.0";
+const version = "1.10.0";
 
 const module = defineNuxtModule({
   meta: {

package/dist/runtime/server/client/hygraph.d.ts

@@ -1,5 +1,7 @@
 import type { HygraphClientConfig, HygraphResponse } from '../types/hygraph.js';
 export type { HygraphResponse };
-export declare const hygraphClientFactory: (explicitConfig?: HygraphClientConfig) => {
+export declare const hygraphClientFactory: (explicitConfig?: HygraphClientConfig, options?: {
+    isPreview?: boolean;
+}) => {
     request: <TData = unknown>(query: string, variables?: unknown) => Promise<HygraphResponse<TData>>;
 };

package/dist/runtime/server/client/hygraph.js

@@ -1,13 +1,25 @@
 import { useRuntimeConfig } from "#imports";
-export const hygraphClientFactory = (explicitConfig) => {
+import { Stage } from "../generated/graphql.js";
+export const hygraphClientFactory = (explicitConfig, options) => {
   const config = explicitConfig ?? useRuntimeConfig()["@laioutr/app-hygraph"];
+  let isPreview = options?.isPreview ?? false;
+  const previewToken = config.previewToken?.trim();
+  if (isPreview && !previewToken) {
+    console.warn("[app-hygraph] preview requested but previewToken is not configured \u2014 serving published content.");
+    isPreview = false;
+  }
   const request = async (query, variables = null) => {
-    const res = await fetch(config.contentApiUrl, {
+    const res = await fetch(isPreview ? config.previewApiUrl ?? config.contentApiUrl : config.contentApiUrl, {
       method: "POST",
       headers: {
-        Authorization: `Bearer ${config.token}`
+        Authorization: `Bearer ${isPreview ? previewToken : config.token}`
       },
-      body: JSON.stringify({ query, variables })
+      // Every document in `queries/` declares `$stage: Stage = PUBLISHED`, so the variable can be
+      // injected unconditionally without the client knowing which operation it is sending.
+      body: JSON.stringify({
+        query,
+        variables: { ...variables, stage: isPreview ? Stage.Draft : Stage.Published }
+      })
     });
     return res.json();
   };

package/dist/runtime/server/generated/graphql.d.ts

@@ -5720,6 +5720,7 @@ export type Glossary = Entity & Node & {
     /** Get the other localizations for this document */
     localizations: Array<Glossary>;
     metaDescription?: Maybe<Scalars['String']['output']>;
+    metaKeywords?: Maybe<Scalars['String']['output']>;
     metaTitle?: Maybe<Scalars['String']['output']>;
     /** The time the document was published. Null on documents in draft stage. */
     publishedAt?: Maybe<Scalars['DateTime']['output']>;
@@ -5822,6 +5823,8 @@ export type GlossaryCreateInput = {
     localizations?: InputMaybe<GlossaryCreateLocalizationsInput>;
     /** metaDescription input for default locale (en) */
     metaDescription?: InputMaybe<Scalars['String']['input']>;
+    /** metaKeywords input for default locale (en) */
+    metaKeywords?: InputMaybe<Scalars['String']['input']>;
     /** metaTitle input for default locale (en) */
     metaTitle?: InputMaybe<Scalars['String']['input']>;
     slug: Scalars['String']['input'];
@@ -5833,6 +5836,7 @@ export type GlossaryCreateLocalizationDataInput = {
     content: Scalars['RichTextAST']['input'];
     createdAt?: InputMaybe<Scalars['DateTime']['input']>;
     metaDescription?: InputMaybe<Scalars['String']['input']>;
+    metaKeywords?: InputMaybe<Scalars['String']['input']>;
     metaTitle?: InputMaybe<Scalars['String']['input']>;
     title: Scalars['String']['input'];
     updatedAt?: InputMaybe<Scalars['DateTime']['input']>;
@@ -5975,6 +5979,8 @@ export declare enum GlossaryOrderByInput {
     IdDesc = "id_DESC",
     MetaDescriptionAsc = "metaDescription_ASC",
     MetaDescriptionDesc = "metaDescription_DESC",
+    MetaKeywordsAsc = "metaKeywords_ASC",
+    MetaKeywordsDesc = "metaKeywords_DESC",
     MetaTitleAsc = "metaTitle_ASC",
     MetaTitleDesc = "metaTitle_DESC",
     PublishedAtAsc = "publishedAt_ASC",
@@ -5993,6 +5999,8 @@ export type GlossaryUpdateInput = {
     localizations?: InputMaybe<GlossaryUpdateLocalizationsInput>;
     /** metaDescription input for default locale (en) */
     metaDescription?: InputMaybe<Scalars['String']['input']>;
+    /** metaKeywords input for default locale (en) */
+    metaKeywords?: InputMaybe<Scalars['String']['input']>;
     /** metaTitle input for default locale (en) */
     metaTitle?: InputMaybe<Scalars['String']['input']>;
     slug?: InputMaybe<Scalars['String']['input']>;
@@ -6002,6 +6010,7 @@ export type GlossaryUpdateInput = {
 export type GlossaryUpdateLocalizationDataInput = {
     content?: InputMaybe<Scalars['RichTextAST']['input']>;
     metaDescription?: InputMaybe<Scalars['String']['input']>;
+    metaKeywords?: InputMaybe<Scalars['String']['input']>;
     metaTitle?: InputMaybe<Scalars['String']['input']>;
     title?: InputMaybe<Scalars['String']['input']>;
 };
@@ -6041,6 +6050,8 @@ export type GlossaryUpdateManyInput = {
     localizations?: InputMaybe<GlossaryUpdateManyLocalizationsInput>;
     /** metaDescription input for default locale (en) */
     metaDescription?: InputMaybe<Scalars['String']['input']>;
+    /** metaKeywords input for default locale (en) */
+    metaKeywords?: InputMaybe<Scalars['String']['input']>;
     /** metaTitle input for default locale (en) */
     metaTitle?: InputMaybe<Scalars['String']['input']>;
     /** title input for default locale (en) */
@@ -6049,6 +6060,7 @@ export type GlossaryUpdateManyInput = {
 export type GlossaryUpdateManyLocalizationDataInput = {
     content?: InputMaybe<Scalars['RichTextAST']['input']>;
     metaDescription?: InputMaybe<Scalars['String']['input']>;
+    metaKeywords?: InputMaybe<Scalars['String']['input']>;
     metaTitle?: InputMaybe<Scalars['String']['input']>;
     title?: InputMaybe<Scalars['String']['input']>;
 };
@@ -6175,6 +6187,25 @@ export type GlossaryWhereInput = {
     metaDescription_not_starts_with?: InputMaybe<Scalars['String']['input']>;
     /** All values starting with the given string. */
     metaDescription_starts_with?: InputMaybe<Scalars['String']['input']>;
+    metaKeywords?: InputMaybe<Scalars['String']['input']>;
+    /** All values containing the given string. */
+    metaKeywords_contains?: InputMaybe<Scalars['String']['input']>;
+    /** All values ending with the given string. */
+    metaKeywords_ends_with?: InputMaybe<Scalars['String']['input']>;
+    /** All values that are contained in given list. */
+    metaKeywords_in?: InputMaybe<Array<InputMaybe<Scalars['String']['input']>>>;
+    /** Any other value that exists and is not equal to the given value. */
+    metaKeywords_not?: InputMaybe<Scalars['String']['input']>;
+    /** All values not containing the given string. */
+    metaKeywords_not_contains?: InputMaybe<Scalars['String']['input']>;
+    /** All values not ending with the given string */
+    metaKeywords_not_ends_with?: InputMaybe<Scalars['String']['input']>;
+    /** All values that are not contained in given list. */
+    metaKeywords_not_in?: InputMaybe<Array<InputMaybe<Scalars['String']['input']>>>;
+    /** All values not starting with the given string. */
+    metaKeywords_not_starts_with?: InputMaybe<Scalars['String']['input']>;
+    /** All values starting with the given string. */
+    metaKeywords_starts_with?: InputMaybe<Scalars['String']['input']>;
     metaTitle?: InputMaybe<Scalars['String']['input']>;
     /** All values containing the given string. */
     metaTitle_contains?: InputMaybe<Scalars['String']['input']>;
@@ -7621,6 +7652,7 @@ export declare enum Locale {
     De = "de",
     /** System locale */
     En = "en",
+    Es = "es",
     Fr = "fr"
 }
 /** Representing a geolocation point with latitude and longitude */
@@ -12629,7 +12661,7 @@ export type BlogTopicsQuery = {
 export type MediaLibraryListQueryVariables = Exact<{
     skip?: InputMaybe<Scalars['Int']['input']>;
     first?: InputMaybe<Scalars['Int']['input']>;
-    search?: InputMaybe<Scalars['String']['input']>;
+    where?: InputMaybe<AssetWhereInput>;
 }>;
 export type MediaLibraryListQuery = {
     assets: Array<{

package/dist/runtime/server/generated/graphql.js

@@ -215,6 +215,8 @@ export var GlossaryOrderByInput = /* @__PURE__ */ ((GlossaryOrderByInput2) => {
   GlossaryOrderByInput2["IdDesc"] = "id_DESC";
   GlossaryOrderByInput2["MetaDescriptionAsc"] = "metaDescription_ASC";
   GlossaryOrderByInput2["MetaDescriptionDesc"] = "metaDescription_DESC";
+  GlossaryOrderByInput2["MetaKeywordsAsc"] = "metaKeywords_ASC";
+  GlossaryOrderByInput2["MetaKeywordsDesc"] = "metaKeywords_DESC";
   GlossaryOrderByInput2["MetaTitleAsc"] = "metaTitle_ASC";
   GlossaryOrderByInput2["MetaTitleDesc"] = "metaTitle_DESC";
   GlossaryOrderByInput2["PublishedAtAsc"] = "publishedAt_ASC";
@@ -275,6 +277,7 @@ export var LearningResourceOrderByInput = /* @__PURE__ */ ((LearningResourceOrde
 export var Locale = /* @__PURE__ */ ((Locale2) => {
   Locale2["De"] = "de";
   Locale2["En"] = "en";
+  Locale2["Es"] = "es";
   Locale2["Fr"] = "fr";
   return Locale2;
 })(Locale || {});

package/dist/runtime/server/media-library/hygraph.js

@@ -11,7 +11,8 @@ export default defineMediaLibraryProvider({
     const result = await client.request(MEDIA_LIBRARY_LIST_QUERY, {
       skip: offset,
       first: limit,
-      search
+      // Only constrain by `_search` when a term is present; an empty filter lists all assets (browse).
+      where: search ? { _search: search } : {}
     });
     const items = result.data.assets.map(
       (asset) => ({

package/dist/runtime/server/middleware/defineHygraph.js

@@ -4,4 +4,6 @@ export const defineHygraph = defineOrchestr.meta({
   app: "@laioutr/app-hygraph",
   logoUrl: "/app-hygraph/logo.svg",
   label: "Hygraph"
-}).extendRequest(async () => ({ context: { hygraph: hygraphClientFactory() } }));
+}).extendRequest(async ({ clientEnv }) => ({
+  context: { hygraph: hygraphClientFactory(void 0, { isPreview: clientEnv.isPreview }) }
+}));

package/dist/runtime/server/orchestr/blog/blogCollection.resolver.js

@@ -1,10 +1,10 @@
-import { BlogCollectionBase } from "@laioutr-core/canonical-types/entity/blog-collection";
+import { BlogCollectionBase, BlogCollectionSeo } from "@laioutr-core/canonical-types/entity/blog-collection";
 import { blogCollectionToken } from "../../const/passthroughTokens.js";
 import { defineHygraph } from "../../middleware/defineHygraph.js";
 export default defineHygraph.componentResolver({
   entityType: "BlogCollection",
   label: "Blog Collection",
-  provides: [BlogCollectionBase],
+  provides: [BlogCollectionBase, BlogCollectionSeo],
   resolve: async ({ passthrough, $entity }) => {
     const collection = passthrough.require(blogCollectionToken);
     return {
@@ -14,6 +14,14 @@ export default defineHygraph.componentResolver({
           base: {
             slug: collection.slug,
             title: collection.title
+          },
+          // Resolve `seo` locally so BlogCollection seo requests stay in the
+          // Hygraph app. Without a Hygraph provider, the shared `BlogCollection`
+          // entity type routes seo to another app's resolver (e.g. Shopify's
+          // `nodes(ids:)` query), which rejects the Hygraph id as an invalid
+          // global id. Hygraph blog collections/topics only carry `title`.
+          seo: {
+            title: collection.title
           }
         })
       ]

package/dist/runtime/server/queries/blog.d.ts

@@ -1,7 +1,7 @@
-export declare const BLOGS_QUERY = "\n  #graphql\n  \n  #graphql\n  \n  #graphql\n  fragment Asset on Asset {\n    url\n    fileName\n    mimeType\n    width\n    height\n    handle\n  }\n\n  fragment Blog on Blog {\n    id\n    title\n    slug\n    content {\n      html\n    }\n    image {\n      ...Asset\n    }\n    publishedAt\n    metaTitle\n    metaDescription\n  }\n\n  query Blogs($skip: Int, $first: Int, $collectionId: ID, $locales: [Locale!]!) {\n    blogs(\n      skip: $skip\n      first: $first\n      orderBy: createdAt_DESC\n      where: { blogCollection: { id: $collectionId } }\n      locales: $locales\n    ) {\n      ...Blog\n    }\n    blogsConnection(where: { blogCollection: { id: $collectionId } }, locales: $locales) {\n      aggregate {\n        count\n      }\n    }\n  }\n";
-export declare const BLOGS_BY_TOPIC_QUERY = "\n  #graphql\n  \n  #graphql\n  \n  #graphql\n  fragment Asset on Asset {\n    url\n    fileName\n    mimeType\n    width\n    height\n    handle\n  }\n\n  fragment Blog on Blog {\n    id\n    title\n    slug\n    content {\n      html\n    }\n    image {\n      ...Asset\n    }\n    publishedAt\n    metaTitle\n    metaDescription\n  }\n\n  query BlogsByTopic($skip: Int, $first: Int, $topicId: ID, $locales: [Locale!]!) {\n    blogs(\n      skip: $skip\n      first: $first\n      orderBy: createdAt_DESC\n      where: { topics_some: { id: $topicId } }\n      locales: $locales\n    ) {\n      ...Blog\n    }\n    blogsConnection(where: { topics_some: { id: $topicId } }, locales: $locales) {\n      aggregate {\n        count\n      }\n    }\n  }\n";
-export declare const BLOG_POST_BY_SLUG_QUERY = "\n  #graphql\n  \n  #graphql\n  \n  #graphql\n  fragment Asset on Asset {\n    url\n    fileName\n    mimeType\n    width\n    height\n    handle\n  }\n\n  fragment Blog on Blog {\n    id\n    title\n    slug\n    content {\n      html\n    }\n    image {\n      ...Asset\n    }\n    publishedAt\n    metaTitle\n    metaDescription\n  }\n\n  query BlogPostBySlug($slug: String!, $locales: [Locale!]!) {\n    blog(where: { slug: $slug }, locales: $locales) {\n      ...Blog\n    }\n  }\n";
-export declare const BLOG_COLLECTION_BY_SLUG_QUERY = "\n  #graphql\n  query BlogCollectionBySlug($slug: String!, $locales: [Locale!]!) {\n    blogCollection(where: { slug: $slug }, locales: $locales) {\n      id\n      slug\n      title\n    }\n  }\n";
-export declare const BLOG_COLLECTIONS_QUERY = "\n  #graphql\n  query BlogCollections($locales: [Locale!]!) {\n    blogCollections(locales: $locales) {\n      slug\n      title\n    }\n  }\n";
-export declare const BLOG_TOPIC_BY_SLUG_QUERY = "\n  #graphql\n  query BlogTopicBySlug($slug: String!, $locales: [Locale!]!) {\n    topic(where: { slug: $slug }, locales: $locales) {\n      id\n      slug\n      title\n    }\n  }\n";
-export declare const BLOG_TOPICS_QUERY = "\n  #graphql\n  query BlogTopics($locales: [Locale!]!, $first: Int, $where: TopicWhereInput) {\n    topics(locales: $locales, first: $first, where: $where) {\n      slug\n      title\n    }\n  }\n";
+export declare const BLOGS_QUERY = "\n  #graphql\n  \n  #graphql\n  \n  #graphql\n  fragment Asset on Asset {\n    url\n    fileName\n    mimeType\n    width\n    height\n    handle\n  }\n\n  fragment Blog on Blog {\n    id\n    title\n    slug\n    content {\n      html\n    }\n    image {\n      ...Asset\n    }\n    publishedAt\n    metaTitle\n    metaDescription\n  }\n\n  query Blogs($skip: Int, $first: Int, $collectionId: ID, $locales: [Locale!]!, $stage: Stage = PUBLISHED) {\n    blogs(\n      skip: $skip\n      first: $first\n      orderBy: createdAt_DESC\n      where: { blogCollection: { id: $collectionId } }\n      locales: $locales\n      stage: $stage\n    ) {\n      ...Blog\n    }\n    blogsConnection(where: { blogCollection: { id: $collectionId } }, locales: $locales, stage: $stage) {\n      aggregate {\n        count\n      }\n    }\n  }\n";
+export declare const BLOGS_BY_TOPIC_QUERY = "\n  #graphql\n  \n  #graphql\n  \n  #graphql\n  fragment Asset on Asset {\n    url\n    fileName\n    mimeType\n    width\n    height\n    handle\n  }\n\n  fragment Blog on Blog {\n    id\n    title\n    slug\n    content {\n      html\n    }\n    image {\n      ...Asset\n    }\n    publishedAt\n    metaTitle\n    metaDescription\n  }\n\n  query BlogsByTopic($skip: Int, $first: Int, $topicId: ID, $locales: [Locale!]!, $stage: Stage = PUBLISHED) {\n    blogs(\n      skip: $skip\n      first: $first\n      orderBy: createdAt_DESC\n      where: { topics_some: { id: $topicId } }\n      locales: $locales\n      stage: $stage\n    ) {\n      ...Blog\n    }\n    blogsConnection(where: { topics_some: { id: $topicId } }, locales: $locales, stage: $stage) {\n      aggregate {\n        count\n      }\n    }\n  }\n";
+export declare const BLOG_POST_BY_SLUG_QUERY = "\n  #graphql\n  \n  #graphql\n  \n  #graphql\n  fragment Asset on Asset {\n    url\n    fileName\n    mimeType\n    width\n    height\n    handle\n  }\n\n  fragment Blog on Blog {\n    id\n    title\n    slug\n    content {\n      html\n    }\n    image {\n      ...Asset\n    }\n    publishedAt\n    metaTitle\n    metaDescription\n  }\n\n  query BlogPostBySlug($slug: String!, $locales: [Locale!]!, $stage: Stage = PUBLISHED) {\n    blog(where: { slug: $slug }, locales: $locales, stage: $stage) {\n      ...Blog\n    }\n  }\n";
+export declare const BLOG_COLLECTION_BY_SLUG_QUERY = "\n  #graphql\n  query BlogCollectionBySlug($slug: String!, $locales: [Locale!]!, $stage: Stage = PUBLISHED) {\n    blogCollection(where: { slug: $slug }, locales: $locales, stage: $stage) {\n      id\n      slug\n      title\n    }\n  }\n";
+export declare const BLOG_COLLECTIONS_QUERY = "\n  #graphql\n  query BlogCollections($locales: [Locale!]!, $stage: Stage = PUBLISHED) {\n    blogCollections(locales: $locales, stage: $stage) {\n      slug\n      title\n    }\n  }\n";
+export declare const BLOG_TOPIC_BY_SLUG_QUERY = "\n  #graphql\n  query BlogTopicBySlug($slug: String!, $locales: [Locale!]!, $stage: Stage = PUBLISHED) {\n    topic(where: { slug: $slug }, locales: $locales, stage: $stage) {\n      id\n      slug\n      title\n    }\n  }\n";
+export declare const BLOG_TOPICS_QUERY = "\n  #graphql\n  query BlogTopics($locales: [Locale!]!, $first: Int, $where: TopicWhereInput, $stage: Stage = PUBLISHED) {\n    topics(locales: $locales, first: $first, where: $where, stage: $stage) {\n      slug\n      title\n    }\n  }\n";

package/dist/runtime/server/queries/blog.js

@@ -25,17 +25,18 @@ export const BLOGS_QUERY = (
   `
   #graphql
   ${BlogFragment}
-  query Blogs($skip: Int, $first: Int, $collectionId: ID, $locales: [Locale!]!) {
+  query Blogs($skip: Int, $first: Int, $collectionId: ID, $locales: [Locale!]!, $stage: Stage = PUBLISHED) {
     blogs(
       skip: $skip
       first: $first
       orderBy: createdAt_DESC
       where: { blogCollection: { id: $collectionId } }
       locales: $locales
+      stage: $stage
     ) {
       ...Blog
     }
-    blogsConnection(where: { blogCollection: { id: $collectionId } }, locales: $locales) {
+    blogsConnection(where: { blogCollection: { id: $collectionId } }, locales: $locales, stage: $stage) {
       aggregate {
         count
       }
@@ -48,17 +49,18 @@ export const BLOGS_BY_TOPIC_QUERY = (
   `
   #graphql
   ${BlogFragment}
-  query BlogsByTopic($skip: Int, $first: Int, $topicId: ID, $locales: [Locale!]!) {
+  query BlogsByTopic($skip: Int, $first: Int, $topicId: ID, $locales: [Locale!]!, $stage: Stage = PUBLISHED) {
     blogs(
       skip: $skip
       first: $first
       orderBy: createdAt_DESC
       where: { topics_some: { id: $topicId } }
       locales: $locales
+      stage: $stage
     ) {
       ...Blog
     }
-    blogsConnection(where: { topics_some: { id: $topicId } }, locales: $locales) {
+    blogsConnection(where: { topics_some: { id: $topicId } }, locales: $locales, stage: $stage) {
       aggregate {
         count
       }
@@ -71,8 +73,8 @@ export const BLOG_POST_BY_SLUG_QUERY = (
   `
   #graphql
   ${BlogFragment}
-  query BlogPostBySlug($slug: String!, $locales: [Locale!]!) {
-    blog(where: { slug: $slug }, locales: $locales) {
+  query BlogPostBySlug($slug: String!, $locales: [Locale!]!, $stage: Stage = PUBLISHED) {
+    blog(where: { slug: $slug }, locales: $locales, stage: $stage) {
       ...Blog
     }
   }
@@ -82,8 +84,8 @@ export const BLOG_COLLECTION_BY_SLUG_QUERY = (
   /* GraphQL */
   `
   #graphql
-  query BlogCollectionBySlug($slug: String!, $locales: [Locale!]!) {
-    blogCollection(where: { slug: $slug }, locales: $locales) {
+  query BlogCollectionBySlug($slug: String!, $locales: [Locale!]!, $stage: Stage = PUBLISHED) {
+    blogCollection(where: { slug: $slug }, locales: $locales, stage: $stage) {
       id
       slug
       title
@@ -95,8 +97,8 @@ export const BLOG_COLLECTIONS_QUERY = (
   /* GraphQL */
   `
   #graphql
-  query BlogCollections($locales: [Locale!]!) {
-    blogCollections(locales: $locales) {
+  query BlogCollections($locales: [Locale!]!, $stage: Stage = PUBLISHED) {
+    blogCollections(locales: $locales, stage: $stage) {
       slug
       title
     }
@@ -107,8 +109,8 @@ export const BLOG_TOPIC_BY_SLUG_QUERY = (
   /* GraphQL */
   `
   #graphql
-  query BlogTopicBySlug($slug: String!, $locales: [Locale!]!) {
-    topic(where: { slug: $slug }, locales: $locales) {
+  query BlogTopicBySlug($slug: String!, $locales: [Locale!]!, $stage: Stage = PUBLISHED) {
+    topic(where: { slug: $slug }, locales: $locales, stage: $stage) {
       id
       slug
       title
@@ -120,8 +122,8 @@ export const BLOG_TOPICS_QUERY = (
   /* GraphQL */
   `
   #graphql
-  query BlogTopics($locales: [Locale!]!, $first: Int, $where: TopicWhereInput) {
-    topics(locales: $locales, first: $first, where: $where) {
+  query BlogTopics($locales: [Locale!]!, $first: Int, $where: TopicWhereInput, $stage: Stage = PUBLISHED) {
+    topics(locales: $locales, first: $first, where: $where, stage: $stage) {
       slug
       title
     }

package/dist/runtime/server/queries/mediaLibrary.d.ts

@@ -1 +1 @@
-export declare const MEDIA_LIBRARY_LIST_QUERY = "\n  #graphql\n  \n  #graphql\n  fragment Asset on Asset {\n    url\n    fileName\n    mimeType\n    width\n    height\n    handle\n  }\n\n  query MediaLibraryList($skip: Int, $first: Int, $search: String) {\n    assets(skip: $skip, first: $first, orderBy: createdAt_DESC, where: { _search: $search }) {\n      ...Asset\n    }\n  }\n";
+export declare const MEDIA_LIBRARY_LIST_QUERY = "\n  #graphql\n  \n  #graphql\n  fragment Asset on Asset {\n    url\n    fileName\n    mimeType\n    width\n    height\n    handle\n  }\n\n  query MediaLibraryList($skip: Int, $first: Int, $where: AssetWhereInput, $stage: Stage = PUBLISHED) {\n    assets(skip: $skip, first: $first, orderBy: createdAt_DESC, where: $where, stage: $stage) {\n      ...Asset\n    }\n  }\n";

package/dist/runtime/server/queries/mediaLibrary.js

@@ -4,8 +4,8 @@ export const MEDIA_LIBRARY_LIST_QUERY = (
   `
   #graphql
   ${AssetFragment}
-  query MediaLibraryList($skip: Int, $first: Int, $search: String) {
-    assets(skip: $skip, first: $first, orderBy: createdAt_DESC, where: { _search: $search }) {
+  query MediaLibraryList($skip: Int, $first: Int, $where: AssetWhereInput, $stage: Stage = PUBLISHED) {
+    assets(skip: $skip, first: $first, orderBy: createdAt_DESC, where: $where, stage: $stage) {
       ...Asset
     }
   }

package/dist/runtime/server/types/hygraph.d.ts

@@ -9,6 +9,14 @@ export interface HygraphAsset {
 export interface HygraphClientConfig {
     contentApiUrl: string;
     token: string;
+    /**
+     * Optional. PAT with Draft-stage read permission. Separate from `token` so published reads keep a
+     * least-privileged credential. Without it the connector always serves published content, even when
+     * a verified preview token marks the request as a preview.
+     */
+    previewToken?: string;
+    /** Optional. Hygraph's Content API serves both stages; only needed if a project observes CDN staleness on drafts. */
+    previewApiUrl?: string;
 }
 export interface HygraphResponse<TData> {
     data: TData;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laioutr/app-hygraph",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Laioutr Hygraph App",
   "repository": "your-org/@laioutr/app-hygraph",
   "license": "MIT",
@@ -43,17 +43,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "dev": "npm run dev:prepare && nuxi dev playground",
-    "dev:build": "nuxi build playground",
-    "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxi prepare playground",
-    "lint": "eslint .",
-    "prepack": "nuxt-module-build build",
-    "release": "npm run lint && npm run test && npm run prepack && changelogen --release && npm publish --access public && git push --follow-tags",
-    "test": "vitest run",
-    "test:types": "vue-tsc --noEmit && cd playground && vue-tsc --noEmit",
-    "test:watch": "vitest watch"
-  },
   "dependencies": {
     "@nuxt/kit": "3.16.2",
     "zod": "3.25.61"
@@ -87,9 +76,9 @@
   "peerDependencies": {
     "@graphql-codegen/cli": "^6.0.0",
     "@laioutr-core/canonical-types": ">=0.25.0",
-    "@laioutr-core/core-types": ">=0.33.1",
-    "@laioutr-core/frontend-core": ">=0.33.1",
-    "@laioutr-core/kit": ">=0.33.1",
+    "@laioutr-core/core-types": ">=0.35.0",
+    "@laioutr-core/frontend-core": ">=0.35.0",
+    "@laioutr-core/kit": ">=0.35.0",
     "graphql": "^16.0.0"
   },
   "peerDependenciesMeta": {
@@ -103,5 +92,15 @@
   "engines": {
     "node": ">=22.12.0",
     "pnpm": ">=10.15.0"
+  },
+  "scripts": {
+    "dev": "npm run dev:prepare && nuxi dev playground",
+    "dev:build": "nuxi build playground",
+    "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxi prepare playground",
+    "lint": "eslint .",
+    "release": "npm run lint && npm run test && npm run prepack && changelogen --release && npm publish --access public && git push --follow-tags",
+    "test": "vitest run",
+    "test:types": "vue-tsc --noEmit && cd playground && vue-tsc --noEmit",
+    "test:watch": "vitest watch"
   }
-}
+}