@laioutr/app-hygraph 1.7.2 → 1.9.0

package/dist/module.json

@@ -1,6 +1,6 @@
 {
   "name": "@laioutr/app-hygraph",
-  "version": "1.7.2",
+  "version": "1.9.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.7.2";
+const version = "1.9.0";
 
 const module = defineNuxtModule({
   meta: {

package/dist/runtime/server/const/passthroughTokens.d.ts

@@ -1,3 +1,8 @@
 export declare const blogCollectionToken: any;
-export declare const blogTopicToken: any;
 export declare const blogPostsToken: any;
+/**
+ * Ids that the `blog/collection/posts` link should resolve via the topic
+ * relation (`topics_some`) instead of the blog-collection relation. Set by the
+ * "Blog Posts by Topic" query, which exposes a topic as a BlogCollection entity.
+ */
+export declare const blogPostsTopicSourceToken: any;

package/dist/runtime/server/const/passthroughTokens.js

@@ -1,4 +1,4 @@
 import { createPassthroughToken } from "#imports";
 export const blogCollectionToken = createPassthroughToken("hygraph/blog-collection");
-export const blogTopicToken = createPassthroughToken("hygraph/blog-topic");
 export const blogPostsToken = createPassthroughToken("hygraph/blog-posts");
+export const blogPostsTopicSourceToken = createPassthroughToken("hygraph/blog-posts-topic-source");

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

@@ -12617,6 +12617,8 @@ export type BlogTopicBySlugQuery = {
 };
 export type BlogTopicsQueryVariables = Exact<{
     locales: Array<Locale> | Locale;
+    first?: InputMaybe<Scalars['Int']['input']>;
+    where?: InputMaybe<TopicWhereInput>;
 }>;
 export type BlogTopicsQuery = {
     topics: Array<{

package/dist/runtime/server/orchestr/blog/blogCollectionPosts.link.js

@@ -1,20 +1,30 @@
 import { BlogCollectionPostsLink } from "@laioutr-core/canonical-types/blog";
-import { blogPostsToken } from "../../const/passthroughTokens.js";
+import { blogPostsToken, blogPostsTopicSourceToken } from "../../const/passthroughTokens.js";
 import { resolveHygraphLocales } from "../../hygraph-utils/locale.js";
 import { defineHygraph } from "../../middleware/defineHygraph.js";
-import { BLOGS_QUERY } from "../../queries/blog.js";
+import { BLOGS_BY_TOPIC_QUERY, BLOGS_QUERY } from "../../queries/blog.js";
 export default defineHygraph.linkHandler({
   implements: BlogCollectionPostsLink,
   run: async ({ context, entityIds, pagination, passthrough, clientEnv }) => {
     const locales = resolveHygraphLocales(clientEnv.locale);
+    const topicSourceIds = passthrough.get(blogPostsTopicSourceToken);
     const results = await Promise.all(
       entityIds.map(
-        (id) => context.hygraph.request(BLOGS_QUERY, {
-          skip: pagination.offset,
-          first: pagination.limit,
-          collectionId: id,
-          locales
-        })
+        (id) => (
+          // Ids exposed by the "Blog Posts by Topic" query are topic ids and must
+          // be filtered via the topic relation; all others are blog-collection ids.
+          topicSourceIds?.has(id) ? context.hygraph.request(BLOGS_BY_TOPIC_QUERY, {
+            skip: pagination.offset,
+            first: pagination.limit,
+            topicId: id,
+            locales
+          }) : context.hygraph.request(BLOGS_QUERY, {
+            skip: pagination.offset,
+            first: pagination.limit,
+            collectionId: id,
+            locales
+          })
+        )
       )
     );
     const allPosts = results.flatMap((r) => r.data.blogs);

package/dist/runtime/server/orchestr/blog/{blogTopicBySlug.query.js → blogPostsByTopic.query.js}

@@ -1,10 +1,10 @@
-import { BlogTopicBySlug, BlogTopicBySlugNotFoundError } from "../../../shared/tokens/blog-topic.js";
-import { blogTopicToken } from "../../const/passthroughTokens.js";
+import { BlogPostsByTopic } from "../../../shared/tokens/blog-topic.js";
+import { blogCollectionToken, blogPostsTopicSourceToken } from "../../const/passthroughTokens.js";
 import { resolveHygraphLocales } from "../../hygraph-utils/locale.js";
 import { defineHygraph } from "../../middleware/defineHygraph.js";
 import { BLOG_TOPIC_BY_SLUG_QUERY } from "../../queries/blog.js";
 export default defineHygraph.queryHandler({
-  implements: BlogTopicBySlug,
+  implements: BlogPostsByTopic,
   run: async ({ context, input, passthrough, clientEnv }) => {
     const result = await context.hygraph.request(BLOG_TOPIC_BY_SLUG_QUERY, {
       slug: input.slug,
@@ -12,9 +12,14 @@ export default defineHygraph.queryHandler({
     });
     const topic = result.data.topic;
     if (!topic) {
-      throw new BlogTopicBySlugNotFoundError(input.slug);
+      return {};
     }
-    passthrough.set(blogTopicToken, topic);
+    passthrough.set(blogCollectionToken, {
+      id: topic.id,
+      slug: topic.slug ?? input.slug,
+      title: topic.title ?? topic.slug ?? input.slug
+    });
+    passthrough.set(blogPostsTopicSourceToken, /* @__PURE__ */ new Set([topic.id]));
     return {
       id: topic.id
     };

package/dist/runtime/server/orchestr/blog/blogPostsByTopic.template.js

@@ -0,0 +1,21 @@
+import { BlogPostsByTopic } from "../../../shared/tokens/blog-topic.js";
+import { resolveHygraphLocales } from "../../hygraph-utils/locale.js";
+import { defineHygraph } from "../../middleware/defineHygraph.js";
+import { BLOG_TOPICS_QUERY } from "../../queries/blog.js";
+export default defineHygraph.queryTemplateProvider({
+  for: BlogPostsByTopic,
+  run: async ({ context, clientEnv, input }) => {
+    const term = input.term?.trim();
+    const result = await context.hygraph.request(BLOG_TOPICS_QUERY, {
+      locales: resolveHygraphLocales(clientEnv.locale),
+      // Hygraph caps a page at 100 items; load the full first page instead of
+      // the default 10 so every topic is available in the picker.
+      first: 100,
+      where: term ? { _search: term } : void 0
+    });
+    return result.data.topics.filter((topic) => Boolean(topic.slug && topic.title)).map((topic) => ({
+      input: { slug: topic.slug },
+      label: topic.title
+    }));
+  }
+});

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

@@ -4,4 +4,4 @@ export declare const BLOG_POST_BY_SLUG_QUERY = "\n  #graphql\n  \n  #graphql\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!]!) {\n    topics(locales: $locales) {\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";

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

@@ -120,8 +120,8 @@ export const BLOG_TOPICS_QUERY = (
   /* GraphQL */
   `
   #graphql
-  query BlogTopics($locales: [Locale!]!) {
-    topics(locales: $locales) {
+  query BlogTopics($locales: [Locale!]!, $first: Int, $where: TopicWhereInput) {
+    topics(locales: $locales, first: $first, where: $where) {
       slug
       title
     }

package/dist/runtime/shared/tokens/blog-topic.d.ts

@@ -1,22 +1,16 @@
 import z from 'zod/v4';
 /**
- * Local stand-ins for the blog-topic tokens that do not exist in
- * `@laioutr-core/canonical-types` yet (neither `entity/blog-topic` nor the
- * topic tokens on `/blog`). These mirror the published blog-collection
- * equivalents one-to-one, so they can be lifted into the package unchanged
- * once it grows a topic surface.
+ * Exposes a blog topic AS a `BlogCollection` entity, so it appears in the
+ * existing BlogCollection-typed Studio query fields (e.g. "Blog Post Collection
+ * With Posts") and reuses the `blog/collection/posts` link — no `BlogTopic`
+ * entity and no ui-app changes required.
+ *
+ * The handler resolves the topic by slug and fills the blog-collection
+ * passthrough with the topic; the shared posts link then filters by the topic
+ * relation for this id (see `blogPostsTopicSourceToken`).
  */
-export declare const BlogTopicBase: import("@laioutr-core/core-types/orchestr").EntityComponentToken<{
-    name: "base";
-} & {
-    readonly entityType: "BlogTopic";
-    readonly schema: z.ZodObject<{
-        slug: z.ZodString;
-        title: z.ZodString;
-    }, z.core.$strip>;
-}>;
-export declare const BlogTopicBySlug: import("@laioutr-core/core-types/orchestr").QueryToken<{
-    name: "blog/topic/by-slug";
+export declare const BlogPostsByTopic: import("@laioutr-core/core-types/orchestr").QueryToken<{
+    name: "blog/posts-by-topic";
 } & {
     entity: string;
     type: "single";
@@ -25,18 +19,3 @@ export declare const BlogTopicBySlug: import("@laioutr-core/core-types/orchestr"
         slug: z.ZodString;
     }, z.core.$strip>;
 }>;
-export declare class BlogTopicBySlugNotFoundError extends Error {
-    static code: string;
-    readonly code: string;
-    readonly slug: string;
-    constructor(slug: string);
-}
-export declare const BlogTopicPostsLink: import("@laioutr-core/core-types/orchestr").LinkToken<{
-    name: "blog/topic/posts";
-} & {
-    readonly label: "Blog topic posts";
-    readonly source: "BlogTopic";
-    readonly target: "BlogPost";
-    readonly type: "multi";
-    readonly defaultLimit: 12;
-}>;

package/dist/runtime/shared/tokens/blog-topic.js

@@ -1,32 +1,8 @@
 import z from "zod/v4";
-import { defineEntityComponentToken, defineLinkToken, defineQueryToken } from "@laioutr-core/core-types/orchestr";
-export const BlogTopicBase = defineEntityComponentToken("base", {
-  entityType: "BlogTopic",
-  schema: z.object({
-    slug: z.string(),
-    title: z.string()
-  })
-});
-export const BlogTopicBySlug = defineQueryToken("blog/topic/by-slug", {
-  entity: "BlogTopic",
+import { defineQueryToken } from "@laioutr-core/core-types/orchestr";
+export const BlogPostsByTopic = defineQueryToken("blog/posts-by-topic", {
+  entity: "BlogCollection",
   type: "single",
-  label: "Blog topic by slug",
+  label: "Blog Posts by Topic",
   input: z.object({ slug: z.string() })
 });
-export class BlogTopicBySlugNotFoundError extends Error {
-  static code = "BLOG_TOPIC_NOT_FOUND";
-  code = BlogTopicBySlugNotFoundError.code;
-  slug;
-  constructor(slug) {
-    super(`Blog Topic with slug ${slug} not found`);
-    this.name = "BlogTopicBySlugNotFoundError";
-    this.slug = slug;
-  }
-}
-export const BlogTopicPostsLink = defineLinkToken("blog/topic/posts", {
-  label: "Blog topic posts",
-  source: "BlogTopic",
-  target: "BlogPost",
-  type: "multi",
-  defaultLimit: 12
-});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laioutr/app-hygraph",
-  "version": "1.7.2",
+  "version": "1.9.0",
   "description": "Laioutr Hygraph App",
   "repository": "your-org/@laioutr/app-hygraph",
   "license": "MIT",
@@ -43,6 +43,17 @@
   "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"
@@ -92,15 +103,5 @@
   "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"
   }
-}
+}

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

@@ -1,22 +0,0 @@
-import { BlogTopicBase } from "../../../shared/tokens/blog-topic.js";
-import { blogTopicToken } from "../../const/passthroughTokens.js";
-import { defineHygraph } from "../../middleware/defineHygraph.js";
-export default defineHygraph.componentResolver({
-  entityType: "BlogTopic",
-  label: "Blog Topic",
-  provides: [BlogTopicBase],
-  resolve: async ({ passthrough, $entity }) => {
-    const topic = passthrough.require(blogTopicToken);
-    return {
-      entities: [
-        $entity({
-          id: topic.id,
-          base: {
-            slug: topic.slug,
-            title: topic.title
-          }
-        })
-      ]
-    };
-  }
-});

package/dist/runtime/server/orchestr/blog/blogTopicBySlug.template.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("nitropack").NitroAppPlugin;
-export default _default;

package/dist/runtime/server/orchestr/blog/blogTopicBySlug.template.js

@@ -1,16 +0,0 @@
-import { BlogTopicBySlug } from "../../../shared/tokens/blog-topic.js";
-import { resolveHygraphLocales } from "../../hygraph-utils/locale.js";
-import { defineHygraph } from "../../middleware/defineHygraph.js";
-import { BLOG_TOPICS_QUERY } from "../../queries/blog.js";
-export default defineHygraph.queryTemplateProvider({
-  for: BlogTopicBySlug,
-  run: async ({ context, clientEnv }) => {
-    const result = await context.hygraph.request(BLOG_TOPICS_QUERY, {
-      locales: resolveHygraphLocales(clientEnv.locale)
-    });
-    return result.data.topics.map((topic) => ({
-      input: { slug: topic.slug },
-      label: topic.title
-    }));
-  }
-});

package/dist/runtime/server/orchestr/blog/blogTopicPosts.link.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("nitropack").NitroAppPlugin;
-export default _default;

package/dist/runtime/server/orchestr/blog/blogTopicPosts.link.js

@@ -1,33 +0,0 @@
-import { BlogTopicPostsLink } from "../../../shared/tokens/blog-topic.js";
-import { blogPostsToken } from "../../const/passthroughTokens.js";
-import { resolveHygraphLocales } from "../../hygraph-utils/locale.js";
-import { defineHygraph } from "../../middleware/defineHygraph.js";
-import { BLOGS_BY_TOPIC_QUERY } from "../../queries/blog.js";
-export default defineHygraph.linkHandler({
-  implements: BlogTopicPostsLink,
-  run: async ({ context, entityIds, pagination, passthrough, clientEnv }) => {
-    const locales = resolveHygraphLocales(clientEnv.locale);
-    const results = await Promise.all(
-      entityIds.map(
-        (id) => context.hygraph.request(BLOGS_BY_TOPIC_QUERY, {
-          skip: pagination.offset,
-          first: pagination.limit,
-          topicId: id,
-          locales
-        })
-      )
-    );
-    const allPosts = results.flatMap((r) => r.data.blogs);
-    passthrough.set(blogPostsToken, allPosts);
-    return {
-      links: entityIds.map((id, i) => {
-        const data = results.at(i)?.data;
-        return {
-          sourceId: id,
-          targetIds: data?.blogs.map((blog) => blog.id) ?? [],
-          entityTotal: data?.blogsConnection.aggregate.count ?? data?.blogs.length ?? 0
-        };
-      })
-    };
-  }
-});