chaingrow-blog 0.2.2 → 0.7.0

package/dist/types-DvkCm1rh.d.cts

@@ -0,0 +1,114 @@
+/** Inline formatting marks. Unknown marks should be dropped. */
+type Mark = {
+    type: 'bold';
+} | {
+    type: 'italic';
+} | {
+    type: 'strike';
+} | {
+    type: 'code';
+} | {
+    type: 'link';
+    href: string;
+};
+/** A text run within a block's content. */
+type Inline = {
+    text: string;
+    marks?: Mark[];
+};
+/** A list item. Content is a Block[] so items can contain paragraphs
+ *  and/or nested lists (the only shapes TipTap actually emits inside
+ *  list items). */
+type ListItem = {
+    content: Block[];
+};
+/**
+ * Structured blog block. Maps one-to-one with TipTap/ProseMirror
+ * nodes — see `@chaingrow/contracts` for the canonical shape.
+ *
+ * Note: this is a MAJOR breaking change vs SDK v0.2.x. Consumers with
+ * custom `components` override maps must update keys from
+ * `list`/`quote`/`code`/`image_placeholder` to
+ * `bulletList`/`orderedList`/`blockquote`/`codeBlock`/`image`/`divider`.
+ */
+type Block = {
+    type: 'heading';
+    level: 1 | 2 | 3;
+    content: Inline[];
+} | {
+    type: 'paragraph';
+    content: Inline[];
+} | {
+    type: 'bulletList';
+    items: ListItem[];
+} | {
+    type: 'orderedList';
+    items: ListItem[];
+} | {
+    type: 'blockquote';
+    content: Inline[];
+} | {
+    type: 'codeBlock';
+    language?: string;
+    code: string;
+} | {
+    type: 'image';
+    src: string;
+    alt: string;
+    caption?: string;
+    width?: number;
+    height?: number;
+    mediaId?: string;
+} | {
+    type: 'divider';
+};
+type BlockType = Block['type'];
+type FaqItem = {
+    question: string;
+    answer: string;
+};
+type SocialPost = {
+    provider: string;
+    content: string;
+    social_title: string | null;
+};
+/** An image or video attached to a blog. The SDK distributes them
+ *  deterministically across the body — see `<BlogRenderer>`. */
+type EmbeddedMedia = {
+    id: string;
+    blog_id: string | null;
+    media_url: string;
+    media_type: 'IMAGE' | 'VIDEO';
+    model_name: string;
+    prompt: string;
+    created_at: string;
+};
+type Blog = {
+    id: string;
+    slug: string;
+    language: string;
+    title: string;
+    description: string | null;
+    blocks: Block[];
+    faq: FaqItem[];
+    og_image: string | null;
+    image_url: string | null;
+    video_url: string | null;
+    video_prompt: string | null;
+    structured_data: Record<string, unknown> | null;
+    published_at: string;
+    social_posts: SocialPost[];
+    /** Images and videos attached to this blog, in the order they were linked.
+     *  `<BlogRenderer>` distributes these across `blocks` at positions
+     *  `floor(i * blocks.length / generatedMedia.length)` — first at the
+     *  top of the body, the rest spread evenly. */
+    generatedMedia?: EmbeddedMedia[];
+};
+type WebhookEvent = 'blog.created' | 'blog.updated' | 'blog.published' | 'blog.unpublished' | 'blog.deleted';
+type WebhookPayload = {
+    event: WebhookEvent;
+    timestamp: string;
+    blog: Blog & Record<string, unknown>;
+};
+
+export type { Blog as B, EmbeddedMedia as E, FaqItem as F, Inline as I, ListItem as L, Mark as M, SocialPost as S, WebhookEvent as W, Block as a, BlockType as b, WebhookPayload as c };

package/dist/types-DvkCm1rh.d.ts

@@ -0,0 +1,114 @@
+/** Inline formatting marks. Unknown marks should be dropped. */
+type Mark = {
+    type: 'bold';
+} | {
+    type: 'italic';
+} | {
+    type: 'strike';
+} | {
+    type: 'code';
+} | {
+    type: 'link';
+    href: string;
+};
+/** A text run within a block's content. */
+type Inline = {
+    text: string;
+    marks?: Mark[];
+};
+/** A list item. Content is a Block[] so items can contain paragraphs
+ *  and/or nested lists (the only shapes TipTap actually emits inside
+ *  list items). */
+type ListItem = {
+    content: Block[];
+};
+/**
+ * Structured blog block. Maps one-to-one with TipTap/ProseMirror
+ * nodes — see `@chaingrow/contracts` for the canonical shape.
+ *
+ * Note: this is a MAJOR breaking change vs SDK v0.2.x. Consumers with
+ * custom `components` override maps must update keys from
+ * `list`/`quote`/`code`/`image_placeholder` to
+ * `bulletList`/`orderedList`/`blockquote`/`codeBlock`/`image`/`divider`.
+ */
+type Block = {
+    type: 'heading';
+    level: 1 | 2 | 3;
+    content: Inline[];
+} | {
+    type: 'paragraph';
+    content: Inline[];
+} | {
+    type: 'bulletList';
+    items: ListItem[];
+} | {
+    type: 'orderedList';
+    items: ListItem[];
+} | {
+    type: 'blockquote';
+    content: Inline[];
+} | {
+    type: 'codeBlock';
+    language?: string;
+    code: string;
+} | {
+    type: 'image';
+    src: string;
+    alt: string;
+    caption?: string;
+    width?: number;
+    height?: number;
+    mediaId?: string;
+} | {
+    type: 'divider';
+};
+type BlockType = Block['type'];
+type FaqItem = {
+    question: string;
+    answer: string;
+};
+type SocialPost = {
+    provider: string;
+    content: string;
+    social_title: string | null;
+};
+/** An image or video attached to a blog. The SDK distributes them
+ *  deterministically across the body — see `<BlogRenderer>`. */
+type EmbeddedMedia = {
+    id: string;
+    blog_id: string | null;
+    media_url: string;
+    media_type: 'IMAGE' | 'VIDEO';
+    model_name: string;
+    prompt: string;
+    created_at: string;
+};
+type Blog = {
+    id: string;
+    slug: string;
+    language: string;
+    title: string;
+    description: string | null;
+    blocks: Block[];
+    faq: FaqItem[];
+    og_image: string | null;
+    image_url: string | null;
+    video_url: string | null;
+    video_prompt: string | null;
+    structured_data: Record<string, unknown> | null;
+    published_at: string;
+    social_posts: SocialPost[];
+    /** Images and videos attached to this blog, in the order they were linked.
+     *  `<BlogRenderer>` distributes these across `blocks` at positions
+     *  `floor(i * blocks.length / generatedMedia.length)` — first at the
+     *  top of the body, the rest spread evenly. */
+    generatedMedia?: EmbeddedMedia[];
+};
+type WebhookEvent = 'blog.created' | 'blog.updated' | 'blog.published' | 'blog.unpublished' | 'blog.deleted';
+type WebhookPayload = {
+    event: WebhookEvent;
+    timestamp: string;
+    blog: Blog & Record<string, unknown>;
+};
+
+export type { Blog as B, EmbeddedMedia as E, FaqItem as F, Inline as I, ListItem as L, Mark as M, SocialPost as S, WebhookEvent as W, Block as a, BlockType as b, WebhookPayload as c };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chaingrow-blog",
-  "version": "0.2.2",
+  "version": "0.7.0",
   "description": "Drop-in Next.js SDK for rendering blogs published from ChainGrow.",
   "license": "MIT",
   "author": "ChainGrow",

package/dist/chunk-OTLGKSYD.js

@@ -1,74 +0,0 @@
-// src/client.ts
-function createClient(opts) {
-  const baseUrl = opts.apiUrl.replace(/\/$/, "");
-  const doFetch = opts.fetch ?? fetch;
-  const request = async (path, init) => {
-    const url = `${baseUrl}${path}`;
-    const method = init?.method ?? "GET";
-    const buildInit = () => ({
-      ...init,
-      headers: {
-        "X-API-Key": opts.apiKey,
-        Accept: "application/json",
-        ...init?.headers ?? {}
-      }
-    });
-    let res;
-    try {
-      res = await doFetch(url, buildInit());
-      if (res.status === 429) {
-        const waitSec = parseInt(res.headers.get("Retry-After") ?? "1", 10);
-        await new Promise(
-          (resolve) => setTimeout(resolve, Math.max(0, waitSec) * 1e3)
-        );
-        res = await doFetch(url, buildInit());
-      }
-    } catch (err) {
-      const cause = err instanceof Error ? err.cause : void 0;
-      const code = cause && typeof cause === "object" && "code" in cause ? String(cause.code) : void 0;
-      const detail = code ? `${code}${err instanceof Error && err.message ? ` (${err.message})` : ""}` : err instanceof Error ? err.message : String(err);
-      const e = new Error(
-        `chaingrow-blog: could not reach ${method} ${url} \u2014 ${detail}. Set CHAINGROW_API_URL to override the API host (default https://api.chaingrow.de).`
-      );
-      e.cause = err;
-      throw e;
-    }
-    if (res.status === 404) return null;
-    if (!res.ok) {
-      throw new Error(
-        `chaingrow-blog: ${method} ${url} failed (${res.status})`
-      );
-    }
-    return await res.json();
-  };
-  return {
-    async getBlog(slug, language) {
-      const qs = language ? `?language=${encodeURIComponent(language)}` : "";
-      return request(
-        `/api/v1/blogs/by-slug/${encodeURIComponent(slug)}${qs}`
-      );
-    },
-    async getBlogById(id) {
-      return request(`/api/v1/blogs/${encodeURIComponent(id)}`);
-    },
-    async listBlogs(listOpts = {}) {
-      const params = new URLSearchParams();
-      if (listOpts.status) params.set("status", listOpts.status);
-      const qs = params.toString();
-      const response = await request(
-        `/api/v1/blogs${qs ? `?${qs}` : ""}`
-      );
-      if (!response) return [];
-      const blogs = response.data ?? [];
-      if (listOpts.language) {
-        return blogs.filter((b) => b.language === listOpts.language);
-      }
-      return blogs;
-    }
-  };
-}
-
-export {
-  createClient
-};
-//# sourceMappingURL=chunk-OTLGKSYD.js.map

package/dist/chunk-OTLGKSYD.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import type { Blog } from './types';\n\nexport type ClientOptions = {\n  apiUrl: string;\n  apiKey: string;\n  fetch?: typeof fetch;\n};\n\nexport type ListBlogsOptions = {\n  status?: 'DRAFT' | 'PUBLISHED';\n  language?: string;\n};\n\nexport type ChaingrowClient = {\n  getBlog(slug: string, language?: string): Promise<Blog | null>;\n  getBlogById(id: string): Promise<Blog | null>;\n  listBlogs(opts?: ListBlogsOptions): Promise<Blog[]>;\n};\n\nexport function createClient(opts: ClientOptions): ChaingrowClient {\n  const baseUrl = opts.apiUrl.replace(/\\/$/, '');\n  const doFetch = opts.fetch ?? fetch;\n\n  const request = async <T>(\n    path: string,\n    init?: RequestInit,\n  ): Promise<T | null> => {\n    const url = `${baseUrl}${path}`;\n    const method = init?.method ?? 'GET';\n    const buildInit = (): RequestInit => ({\n      ...init,\n      headers: {\n        'X-API-Key': opts.apiKey,\n        Accept: 'application/json',\n        ...(init?.headers ?? {}),\n      },\n    });\n\n    let res: Response;\n    try {\n      res = await doFetch(url, buildInit());\n\n      // Transparent one-shot retry on 429, honoring Retry-After (seconds).\n      if (res.status === 429) {\n        const waitSec = parseInt(res.headers.get('Retry-After') ?? '1', 10);\n        await new Promise((resolve) =>\n          setTimeout(resolve, Math.max(0, waitSec) * 1000),\n        );\n        res = await doFetch(url, buildInit());\n      }\n    } catch (err) {\n      // `fetch failed` / DNS / connection errors land here. Node's default\n      // message buries the host in `err.cause`, which makes integration\n      // debugging miserable. Surface the URL and the override env var on\n      // the top-level message so it appears in the consumer's server log.\n      const cause = err instanceof Error ? err.cause : undefined;\n      const code =\n        cause && typeof cause === 'object' && 'code' in cause\n          ? String((cause as { code?: unknown }).code)\n          : undefined;\n      const detail = code\n        ? `${code}${err instanceof Error && err.message ? ` (${err.message})` : ''}`\n        : err instanceof Error\n          ? err.message\n          : String(err);\n      const e = new Error(\n        `chaingrow-blog: could not reach ${method} ${url} — ${detail}. ` +\n          `Set CHAINGROW_API_URL to override the API host (default https://api.chaingrow.de).`,\n      );\n      (e as Error & { cause?: unknown }).cause = err;\n      throw e;\n    }\n\n    if (res.status === 404) return null;\n    if (!res.ok) {\n      throw new Error(\n        `chaingrow-blog: ${method} ${url} failed (${res.status})`,\n      );\n    }\n    return (await res.json()) as T;\n  };\n\n  return {\n    async getBlog(slug, language) {\n      const qs = language ? `?language=${encodeURIComponent(language)}` : '';\n      return request<Blog>(\n        `/api/v1/blogs/by-slug/${encodeURIComponent(slug)}${qs}`,\n      );\n    },\n\n    async getBlogById(id) {\n      return request<Blog>(`/api/v1/blogs/${encodeURIComponent(id)}`);\n    },\n\n    async listBlogs(listOpts = {}) {\n      const params = new URLSearchParams();\n      if (listOpts.status) params.set('status', listOpts.status);\n      const qs = params.toString();\n      const response = await request<{ data: Blog[]; total: number }>(\n        `/api/v1/blogs${qs ? `?${qs}` : ''}`,\n      );\n      if (!response) return [];\n      const blogs = response.data ?? [];\n      if (listOpts.language) {\n        return blogs.filter((b) => b.language === listOpts.language);\n      }\n      return blogs;\n    },\n  };\n}\n"],"mappings":";AAmBO,SAAS,aAAa,MAAsC;AACjE,QAAM,UAAU,KAAK,OAAO,QAAQ,OAAO,EAAE;AAC7C,QAAM,UAAU,KAAK,SAAS;AAE9B,QAAM,UAAU,OACd,MACA,SACsB;AACtB,UAAM,MAAM,GAAG,OAAO,GAAG,IAAI;AAC7B,UAAM,SAAS,MAAM,UAAU;AAC/B,UAAM,YAAY,OAAoB;AAAA,MACpC,GAAG;AAAA,MACH,SAAS;AAAA,QACP,aAAa,KAAK;AAAA,QAClB,QAAQ;AAAA,QACR,GAAI,MAAM,WAAW,CAAC;AAAA,MACxB;AAAA,IACF;AAEA,QAAI;AACJ,QAAI;AACF,YAAM,MAAM,QAAQ,KAAK,UAAU,CAAC;AAGpC,UAAI,IAAI,WAAW,KAAK;AACtB,cAAM,UAAU,SAAS,IAAI,QAAQ,IAAI,aAAa,KAAK,KAAK,EAAE;AAClE,cAAM,IAAI;AAAA,UAAQ,CAAC,YACjB,WAAW,SAAS,KAAK,IAAI,GAAG,OAAO,IAAI,GAAI;AAAA,QACjD;AACA,cAAM,MAAM,QAAQ,KAAK,UAAU,CAAC;AAAA,MACtC;AAAA,IACF,SAAS,KAAK;AAKZ,YAAM,QAAQ,eAAe,QAAQ,IAAI,QAAQ;AACjD,YAAM,OACJ,SAAS,OAAO,UAAU,YAAY,UAAU,QAC5C,OAAQ,MAA6B,IAAI,IACzC;AACN,YAAM,SAAS,OACX,GAAG,IAAI,GAAG,eAAe,SAAS,IAAI,UAAU,KAAK,IAAI,OAAO,MAAM,EAAE,KACxE,eAAe,QACb,IAAI,UACJ,OAAO,GAAG;AAChB,YAAM,IAAI,IAAI;AAAA,QACZ,mCAAmC,MAAM,IAAI,GAAG,WAAM,MAAM;AAAA,MAE9D;AACA,MAAC,EAAkC,QAAQ;AAC3C,YAAM;AAAA,IACR;AAEA,QAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,IAAI;AAAA,QACR,mBAAmB,MAAM,IAAI,GAAG,YAAY,IAAI,MAAM;AAAA,MACxD;AAAA,IACF;AACA,WAAQ,MAAM,IAAI,KAAK;AAAA,EACzB;AAEA,SAAO;AAAA,IACL,MAAM,QAAQ,MAAM,UAAU;AAC5B,YAAM,KAAK,WAAW,aAAa,mBAAmB,QAAQ,CAAC,KAAK;AACpE,aAAO;AAAA,QACL,yBAAyB,mBAAmB,IAAI,CAAC,GAAG,EAAE;AAAA,MACxD;AAAA,IACF;AAAA,IAEA,MAAM,YAAY,IAAI;AACpB,aAAO,QAAc,iBAAiB,mBAAmB,EAAE,CAAC,EAAE;AAAA,IAChE;AAAA,IAEA,MAAM,UAAU,WAAW,CAAC,GAAG;AAC7B,YAAM,SAAS,IAAI,gBAAgB;AACnC,UAAI,SAAS,OAAQ,QAAO,IAAI,UAAU,SAAS,MAAM;AACzD,YAAM,KAAK,OAAO,SAAS;AAC3B,YAAM,WAAW,MAAM;AAAA,QACrB,gBAAgB,KAAK,IAAI,EAAE,KAAK,EAAE;AAAA,MACpC;AACA,UAAI,CAAC,SAAU,QAAO,CAAC;AACvB,YAAM,QAAQ,SAAS,QAAQ,CAAC;AAChC,UAAI,SAAS,UAAU;AACrB,eAAO,MAAM,OAAO,CAAC,MAAM,EAAE,aAAa,SAAS,QAAQ;AAAA,MAC7D;AACA,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}

package/dist/types-CoPD0ejB.d.cts

@@ -1,53 +0,0 @@
-type Block = {
-    type: 'heading';
-    level?: number;
-    content: string;
-} | {
-    type: 'paragraph';
-    content: string;
-} | {
-    type: 'list';
-    content: string;
-} | {
-    type: 'quote';
-    content: string;
-} | {
-    type: 'code';
-    content: string;
-} | {
-    type: 'image_placeholder';
-    content: string;
-};
-type FaqItem = {
-    question: string;
-    answer: string;
-};
-type SocialPost = {
-    provider: string;
-    content: string;
-    social_title: string | null;
-};
-type Blog = {
-    id: string;
-    slug: string;
-    language: string;
-    title: string;
-    description: string | null;
-    blocks: Block[];
-    faq: FaqItem[];
-    og_image: string | null;
-    image_url: string | null;
-    video_url: string | null;
-    video_prompt: string | null;
-    structured_data: Record<string, unknown> | null;
-    published_at: string;
-    social_posts: SocialPost[];
-};
-type WebhookEvent = 'blog.created' | 'blog.updated' | 'blog.published';
-type WebhookPayload = {
-    event: WebhookEvent;
-    timestamp: string;
-    blog: Blog & Record<string, unknown>;
-};
-
-export type { Blog as B, FaqItem as F, SocialPost as S, WebhookEvent as W, Block as a, WebhookPayload as b };

package/dist/types-CoPD0ejB.d.ts

@@ -1,53 +0,0 @@
-type Block = {
-    type: 'heading';
-    level?: number;
-    content: string;
-} | {
-    type: 'paragraph';
-    content: string;
-} | {
-    type: 'list';
-    content: string;
-} | {
-    type: 'quote';
-    content: string;
-} | {
-    type: 'code';
-    content: string;
-} | {
-    type: 'image_placeholder';
-    content: string;
-};
-type FaqItem = {
-    question: string;
-    answer: string;
-};
-type SocialPost = {
-    provider: string;
-    content: string;
-    social_title: string | null;
-};
-type Blog = {
-    id: string;
-    slug: string;
-    language: string;
-    title: string;
-    description: string | null;
-    blocks: Block[];
-    faq: FaqItem[];
-    og_image: string | null;
-    image_url: string | null;
-    video_url: string | null;
-    video_prompt: string | null;
-    structured_data: Record<string, unknown> | null;
-    published_at: string;
-    social_posts: SocialPost[];
-};
-type WebhookEvent = 'blog.created' | 'blog.updated' | 'blog.published';
-type WebhookPayload = {
-    event: WebhookEvent;
-    timestamp: string;
-    blog: Blog & Record<string, unknown>;
-};
-
-export type { Blog as B, FaqItem as F, SocialPost as S, WebhookEvent as W, Block as a, WebhookPayload as b };