@intelex-ia/sdk 0.2.0 → 0.3.0

package/README.md

@@ -1,310 +1,310 @@
-# `@intelex-ia/sdk`
-
-SDK pra consumir a **Content API IntelexIA** em sites headless (Next.js, Astro etc.). Multiplataforma Fase 2b.
-
-> **O que você ganha:** `getArticles` / `getArticleBySlug` tipados, `mergePosts()` pra unir conteúdo antigo + novo do painel, `<ArticleJsonLd>` pra injetar schema JSON-LD, e `articleToMetadata` pra plugar no `generateMetadata` do Next.js App Router. Zero dependências (usa `fetch` global).
-
-## Instalação rápida (recomendado)
-
-Se você está começando agora, use o CLI — ele detecta a estrutura do seu projeto e configura tudo automaticamente:
-
-```bash
-npx @intelex-ia/cli init
-```
-
-Cria os arquivos no lugar certo (App Router ou Pages Router, com ou sem `src/`), configura `.env.local`, gera um `INTELEXIA.md` completo na raiz e instala o SDK pra você.
-
-## Instalação manual
-
-```bash
-npm install @intelex-ia/sdk
-# ou pnpm add @intelex-ia/sdk / yarn add @intelex-ia/sdk
-```
-
-## Configuração
-
-1. No painel da IntelexIA, **cadastre o site como "Headless (código)"** (vai pedir domain + URL e secret de revalidate).
-2. Abra o site na lista → seção **"Tokens de API (Content API)"** → **Gerar token**. Você recebe `itx_…` (mostrado uma única vez).
-3. Coloque em `.env.local`:
-
-```bash
-INTELEXIA_API_TOKEN=itx_seu_token_aqui
-INTELEXIA_API_URL=https://api.innovarticles.intelexia.com.br  # opcional, é o default
-INTELEXIA_REVALIDATE_SECRET=cole-o-mesmo-segredo-do-painel
-```
-
-## Três modos de integração
-
-Cada cliente tem uma situação diferente. Escolha o modo que faz sentido:
-
-| Modo | Quando usar | O que muda no `/blog` |
-|---|---|---|
-| **🔀 Additive (recomendado)** | Cliente já tem posts antigos e quer **adicionar** os do painel sem perder os antigos | `mergePosts()` une os dois feeds, dedupa por slug, ordena por data |
-| **🔁 Replace** | Cliente migrou tudo pro painel — só os novos contam | Substitui `getAllPosts()` por `client.getArticles()` |
-| **🆕 Isolated** | Cliente quer manter `/blog` antigo intacto e criar rota nova só pra IA | Cria `/blog/ia` separado, blog antigo zero alterado |
-
----
-
-### Modo 1: Additive (cliente existente — caso mais comum)
-
-```tsx
-// app/blog/page.tsx
-import { intelexia } from "@/lib/intelexia";
-import { mergePosts } from "@intelex-ia/sdk";
-import { posts as localPosts } from "@/lib/posts"; // seu array atual
-import Link from "next/link";
-
-export default async function BlogIndex() {
-  // 1) Busca os artigos do painel
-  const { items: remote } = await intelexia.getArticles({ limit: 50 });
-
-  // 2) Mistura com os seus posts antigos
-  const all = mergePosts({
-    local: localPosts,
-    remote,
-    mapLocal: (p) => ({
-      slug: p.slug,
-      title: p.title,
-      excerpt: p.excerpt,
-      publishedAt: p.date,
-      featuredImageUrl: null,
-      category: p.category,
-    }),
-    // Opcional — defaults sensatos:
-    // dedupe: "remote-wins"  (painel substitui local se slug colide)
-    // sortBy: "date-desc"    (mais recente primeiro)
-  });
-
-  return (
-    <ul>
-      {all.map((p) => (
-        <li key={p.slug}>
-          <Link href={`/blog/${p.slug}`}>{p.title}</Link>
-          <time>{new Date(p.publishedAt).toLocaleDateString("pt-BR")}</time>
-          {p.source === "remote" && <span className="badge-ia">✨ IA</span>}
-        </li>
-      ))}
-    </ul>
-  );
-}
-```
-
-Pro post individual, tenta o painel primeiro, cai pro local se 404:
-
-```tsx
-// app/blog/[slug]/page.tsx
-import { intelexia } from "@/lib/intelexia";
-import { IntelexiaApiError } from "@intelex-ia/sdk";
-import { ArticleJsonLd, articleToMetadata } from "@intelex-ia/sdk/react";
-import { getPostBySlug } from "@/lib/posts";
-import { notFound } from "next/navigation";
-
-export default async function PostPage({ params }: { params: Promise<{ slug: string }> }) {
-  const { slug } = await params;
-
-  // 1) Tenta painel
-  try {
-    const { article } = await intelexia.getArticleBySlug(slug);
-    return (
-      <article>
-        <ArticleJsonLd article={article} />
-        <h1>{article.title}</h1>
-        <div dangerouslySetInnerHTML={{ __html: article.contentHtml ?? "" }} />
-      </article>
-    );
-  } catch (err) {
-    if (!(err instanceof IntelexiaApiError) || err.status !== 404) throw err;
-  }
-
-  // 2) Fallback: post antigo local
-  const local = getPostBySlug(slug);
-  if (!local) notFound();
-  return (
-    <article>
-      <h1>{local.title}</h1>
-      {/* renderiza o local do jeito que você já fazia */}
-    </article>
-  );
-}
-```
-
-### Modo 2: Replace (migração completa)
-
-```tsx
-// app/blog/page.tsx
-import { intelexia } from "@/lib/intelexia";
-
-export default async function BlogIndex() {
-  const { items } = await intelexia.getArticles({ limit: 20 });
-  return (
-    <ul>
-      {items.map((a) => (
-        <li key={a.id}>
-          <Link href={`/blog/${a.slug}`}>{a.title}</Link>
-        </li>
-      ))}
-    </ul>
-  );
-}
-```
-
-Pro post individual, sem fallback:
-
-```tsx
-import { intelexia } from "@/lib/intelexia";
-import { IntelexiaApiError } from "@intelex-ia/sdk";
-import { ArticleJsonLd, articleToMetadata } from "@intelex-ia/sdk/react";
-import { notFound } from "next/navigation";
-
-async function fetchArticle(slug: string) {
-  try {
-    return await intelexia.getArticleBySlug(slug);
-  } catch (err) {
-    if (err instanceof IntelexiaApiError && err.status === 404) notFound();
-    throw err;
-  }
-}
-
-export async function generateMetadata({ params }: { params: Promise<{ slug: string }> }) {
-  const { slug } = await params;
-  const { article } = await fetchArticle(slug);
-  return articleToMetadata(article);
-}
-
-export default async function PostPage({ params }: { params: Promise<{ slug: string }> }) {
-  const { slug } = await params;
-  const { article } = await fetchArticle(slug);
-  return (
-    <article>
-      <ArticleJsonLd article={article} />
-      <h1>{article.title}</h1>
-      <div dangerouslySetInnerHTML={{ __html: article.contentHtml ?? "" }} />
-    </article>
-  );
-}
-```
-
-### Modo 3: Isolated (rota nova, blog antigo intacto)
-
-Cria `app/blog/ia/page.tsx` e `app/blog/ia/[slug]/page.tsx` com o mesmo código do modo Replace, mas em rota separada (`/blog/ia` em vez de `/blog`). Zero alteração no blog existente.
-
----
-
-## Cliente — `lib/intelexia.ts`
-
-```ts
-import { createClient } from "@intelex-ia/sdk";
-
-export const intelexia = createClient({
-  token: process.env.INTELEXIA_API_TOKEN!,
-  // ISR: revalida a cada 60s; o webhook revalidate invalida sob demanda
-  init: { next: { revalidate: 60, tags: ["intelexia-articles"] } },
-});
-```
-
-## Webhook de revalidate — `app/api/revalidate/route.ts`
-
-Quando um artigo publica/edita no painel, nosso worker faz `POST` no seu endpoint. Implemente assim:
-
-```ts
-import { NextResponse } from "next/server";
-import { revalidatePath, revalidateTag } from "next/cache";
-
-export async function POST(req: Request) {
-  const headerSecret = req.headers.get("x-revalidate-secret");
-  const body = (await req.json().catch(() => ({}))) as {
-    secret?: string;
-    slug?: string | null;
-    domain?: string;
-  };
-  const got = headerSecret ?? body.secret ?? "";
-  if (!process.env.INTELEXIA_REVALIDATE_SECRET || got !== process.env.INTELEXIA_REVALIDATE_SECRET) {
-    return NextResponse.json({ ok: false, error: "unauthorized" }, { status: 401 });
-  }
-
-  if (body.slug) revalidatePath(`/blog/${body.slug}`);
-  revalidatePath("/blog");
-  revalidateTag("intelexia-articles");
-
-  return NextResponse.json({ ok: true, revalidated: { slug: body.slug ?? null } });
-}
-```
-
-> O worker envia o secret tanto no header `x-revalidate-secret` quanto no body, tem timeout de 15s e é **fire-and-forget** (se seu endpoint falhar, o artigo continua publicado e a ISR atualiza pelo `revalidate: 60`).
-
-## API
-
-### `createClient(config)`
-
-| Opção    | Tipo                 | Default                                           |
-| -------- | -------------------- | ------------------------------------------------- |
-| `token`  | `string` (obrig.)    | —                                                 |
-| `apiUrl` | `string`             | `https://api.innovarticles.intelexia.com.br`      |
-| `fetch`  | `typeof fetch`       | `globalThis.fetch`                                |
-| `init`   | `RequestInit`        | `undefined` (passe `{ next: { revalidate: N } }`) |
-
-### `client.getArticles({ limit?, offset?, init? })`
-
-Resposta: `{ ok, mode, lifecycle, count, items: ArticleListItem[] }`.
-
-### `client.getArticleBySlug(slug, { init? })`
-
-Resposta: `{ ok, mode, lifecycle, article: Article }`. **404 → joga `IntelexiaApiError`** (use `try/catch` + `notFound()`).
-
-### `mergePosts({ local, remote, mapLocal, dedupe?, sortBy? })` 🆕 0.2.0
-
-| Opção      | Tipo                                              | Default          |
-| ---------- | ------------------------------------------------- | ---------------- |
-| `local`    | `readonly TLocal[]` (qualquer shape)              | —                |
-| `remote`   | `readonly ArticleListItem[]`                      | —                |
-| `mapLocal` | `(post: TLocal) => Omit<UnifiedPost,"source"> \| null` | —          |
-| `dedupe`   | `"remote-wins" \| "local-wins" \| "throw"`       | `"remote-wins"`  |
-| `sortBy`   | `"date-desc" \| "date-asc" \| "none"`             | `"date-desc"`    |
-
-Retorna `UnifiedPost[]` com `source: "local" | "remote"`. `mapLocal` retornando `null` filtra o post (útil pra esconder rascunhos). Slugs duplicados resolvidos pela estratégia `dedupe`. Veja exemplo no Modo Additive acima.
-
-### `mode: "full" | "plain"`
-
-- **`full`** (sites `active`/`paused`): inclui schema JSON-LD, metaTitle/Description, keyword(s), interlinking interno no `contentHtml`.
-- **`plain`** (site `cancelled`): só conteúdo cru — schema/meta/keywords vêm `null`, interlinking removido. O `ArticleJsonLd` e o `articleToMetadata` lidam graciosamente (omitem o que não tem).
-
-A decisão é **server-side e não-negociável** — o cliente não escolhe o modo.
-
-### Helpers `/react`
-
-- `<ArticleJsonLd article={article} />` — renderiza `<script type="application/ld+json">` com o `schemaJson`. No-op se ausente.
-- `articleToMetadata(article)` → objeto compatível com o `Metadata` do Next.js App Router (title, description, keywords, openGraph, twitter, customMetaTags como `other`).
-
-## Erros
-
-```ts
-import { IntelexiaApiError, MergeConflictError } from "@intelex-ia/sdk";
-
-try {
-  await intelexia.getArticleBySlug("post-inexistente");
-} catch (err) {
-  if (err instanceof IntelexiaApiError) {
-    console.error(err.status, err.message); // 404, "Artigo não encontrado."
-  }
-}
-
-try {
-  mergePosts({ local, remote, mapLocal, dedupe: "throw" });
-} catch (err) {
-  if (err instanceof MergeConflictError) {
-    console.error(`Conflito de slug: ${err.slug}`);
-  }
-}
-```
-
-## Compatibilidade
-
-- **Node** 18+ (fetch nativo), Edge Runtime, Browser.
-- **React** 18+ (peer dep opcional — só pros helpers `/react`).
-- **TypeScript:** tipos publicados no `dist`.
-- **Frameworks:** Next.js (App Router e Pages Router), Astro, Remix, SvelteKit, Vite, qualquer JS.
-
-## Changelog
-
-- **0.2.0** — adiciona `mergePosts()` + tipo `UnifiedPost` + `MergeConflictError` (3 modos de integração).
-- **0.1.0** — release inicial: `createClient`, `getArticles`, `getArticleBySlug`, `<ArticleJsonLd>`, `articleToMetadata`.
+# `@intelex-ia/sdk`
+
+SDK pra consumir a **Content API IntelexIA** em sites headless (Next.js, Astro etc.). Multiplataforma Fase 2b.
+
+> **O que você ganha:** `getArticles` / `getArticleBySlug` tipados, `mergePosts()` pra unir conteúdo antigo + novo do painel, `<ArticleJsonLd>` pra injetar schema JSON-LD, e `articleToMetadata` pra plugar no `generateMetadata` do Next.js App Router. Zero dependências (usa `fetch` global).
+
+## Instalação rápida (recomendado)
+
+Se você está começando agora, use o CLI — ele detecta a estrutura do seu projeto e configura tudo automaticamente:
+
+```bash
+npx @intelex-ia/cli init
+```
+
+Cria os arquivos no lugar certo (App Router ou Pages Router, com ou sem `src/`), configura `.env.local`, gera um `INTELEXIA.md` completo na raiz e instala o SDK pra você.
+
+## Instalação manual
+
+```bash
+npm install @intelex-ia/sdk
+# ou pnpm add @intelex-ia/sdk / yarn add @intelex-ia/sdk
+```
+
+## Configuração
+
+1. No painel da IntelexIA, **cadastre o site como "Headless (código)"** (vai pedir domain + URL e secret de revalidate).
+2. Abra o site na lista → seção **"Tokens de API (Content API)"** → **Gerar token**. Você recebe `itx_…` (mostrado uma única vez).
+3. Coloque em `.env.local`:
+
+```bash
+INTELEXIA_API_TOKEN=itx_seu_token_aqui
+INTELEXIA_API_URL=https://api.innovarticles.intelexia.com.br  # opcional, é o default
+INTELEXIA_REVALIDATE_SECRET=cole-o-mesmo-segredo-do-painel
+```
+
+## Três modos de integração
+
+Cada cliente tem uma situação diferente. Escolha o modo que faz sentido:
+
+| Modo | Quando usar | O que muda no `/blog` |
+|---|---|---|
+| **🔀 Additive (recomendado)** | Cliente já tem posts antigos e quer **adicionar** os do painel sem perder os antigos | `mergePosts()` une os dois feeds, dedupa por slug, ordena por data |
+| **🔁 Replace** | Cliente migrou tudo pro painel — só os novos contam | Substitui `getAllPosts()` por `client.getArticles()` |
+| **🆕 Isolated** | Cliente quer manter `/blog` antigo intacto e criar rota nova só pra IA | Cria `/blog/ia` separado, blog antigo zero alterado |
+
+---
+
+### Modo 1: Additive (cliente existente — caso mais comum)
+
+```tsx
+// app/blog/page.tsx
+import { intelexia } from "@/lib/intelexia";
+import { mergePosts } from "@intelex-ia/sdk";
+import { posts as localPosts } from "@/lib/posts"; // seu array atual
+import Link from "next/link";
+
+export default async function BlogIndex() {
+  // 1) Busca os artigos do painel
+  const { items: remote } = await intelexia.getArticles({ limit: 50 });
+
+  // 2) Mistura com os seus posts antigos
+  const all = mergePosts({
+    local: localPosts,
+    remote,
+    mapLocal: (p) => ({
+      slug: p.slug,
+      title: p.title,
+      excerpt: p.excerpt,
+      publishedAt: p.date,
+      featuredImageUrl: null,
+      category: p.category,
+    }),
+    // Opcional — defaults sensatos:
+    // dedupe: "remote-wins"  (painel substitui local se slug colide)
+    // sortBy: "date-desc"    (mais recente primeiro)
+  });
+
+  return (
+    <ul>
+      {all.map((p) => (
+        <li key={p.slug}>
+          <Link href={`/blog/${p.slug}`}>{p.title}</Link>
+          <time>{new Date(p.publishedAt).toLocaleDateString("pt-BR")}</time>
+          {p.source === "remote" && <span className="badge-ia">✨ IA</span>}
+        </li>
+      ))}
+    </ul>
+  );
+}
+```
+
+Pro post individual, tenta o painel primeiro, cai pro local se 404:
+
+```tsx
+// app/blog/[slug]/page.tsx
+import { intelexia } from "@/lib/intelexia";
+import { IntelexiaApiError } from "@intelex-ia/sdk";
+import { ArticleJsonLd, articleToMetadata } from "@intelex-ia/sdk/react";
+import { getPostBySlug } from "@/lib/posts";
+import { notFound } from "next/navigation";
+
+export default async function PostPage({ params }: { params: Promise<{ slug: string }> }) {
+  const { slug } = await params;
+
+  // 1) Tenta painel
+  try {
+    const { article } = await intelexia.getArticleBySlug(slug);
+    return (
+      <article>
+        <ArticleJsonLd article={article} />
+        <h1>{article.title}</h1>
+        <div dangerouslySetInnerHTML={{ __html: article.contentHtml ?? "" }} />
+      </article>
+    );
+  } catch (err) {
+    if (!(err instanceof IntelexiaApiError) || err.status !== 404) throw err;
+  }
+
+  // 2) Fallback: post antigo local
+  const local = getPostBySlug(slug);
+  if (!local) notFound();
+  return (
+    <article>
+      <h1>{local.title}</h1>
+      {/* renderiza o local do jeito que você já fazia */}
+    </article>
+  );
+}
+```
+
+### Modo 2: Replace (migração completa)
+
+```tsx
+// app/blog/page.tsx
+import { intelexia } from "@/lib/intelexia";
+
+export default async function BlogIndex() {
+  const { items } = await intelexia.getArticles({ limit: 20 });
+  return (
+    <ul>
+      {items.map((a) => (
+        <li key={a.id}>
+          <Link href={`/blog/${a.slug}`}>{a.title}</Link>
+        </li>
+      ))}
+    </ul>
+  );
+}
+```
+
+Pro post individual, sem fallback:
+
+```tsx
+import { intelexia } from "@/lib/intelexia";
+import { IntelexiaApiError } from "@intelex-ia/sdk";
+import { ArticleJsonLd, articleToMetadata } from "@intelex-ia/sdk/react";
+import { notFound } from "next/navigation";
+
+async function fetchArticle(slug: string) {
+  try {
+    return await intelexia.getArticleBySlug(slug);
+  } catch (err) {
+    if (err instanceof IntelexiaApiError && err.status === 404) notFound();
+    throw err;
+  }
+}
+
+export async function generateMetadata({ params }: { params: Promise<{ slug: string }> }) {
+  const { slug } = await params;
+  const { article } = await fetchArticle(slug);
+  return articleToMetadata(article);
+}
+
+export default async function PostPage({ params }: { params: Promise<{ slug: string }> }) {
+  const { slug } = await params;
+  const { article } = await fetchArticle(slug);
+  return (
+    <article>
+      <ArticleJsonLd article={article} />
+      <h1>{article.title}</h1>
+      <div dangerouslySetInnerHTML={{ __html: article.contentHtml ?? "" }} />
+    </article>
+  );
+}
+```
+
+### Modo 3: Isolated (rota nova, blog antigo intacto)
+
+Cria `app/blog/ia/page.tsx` e `app/blog/ia/[slug]/page.tsx` com o mesmo código do modo Replace, mas em rota separada (`/blog/ia` em vez de `/blog`). Zero alteração no blog existente.
+
+---
+
+## Cliente — `lib/intelexia.ts`
+
+```ts
+import { createClient } from "@intelex-ia/sdk";
+
+export const intelexia = createClient({
+  token: process.env.INTELEXIA_API_TOKEN!,
+  // ISR: revalida a cada 60s; o webhook revalidate invalida sob demanda
+  init: { next: { revalidate: 60, tags: ["intelexia-articles"] } },
+});
+```
+
+## Webhook de revalidate — `app/api/revalidate/route.ts`
+
+Quando um artigo publica/edita no painel, nosso worker faz `POST` no seu endpoint. Implemente assim:
+
+```ts
+import { NextResponse } from "next/server";
+import { revalidatePath, revalidateTag } from "next/cache";
+
+export async function POST(req: Request) {
+  const headerSecret = req.headers.get("x-revalidate-secret");
+  const body = (await req.json().catch(() => ({}))) as {
+    secret?: string;
+    slug?: string | null;
+    domain?: string;
+  };
+  const got = headerSecret ?? body.secret ?? "";
+  if (!process.env.INTELEXIA_REVALIDATE_SECRET || got !== process.env.INTELEXIA_REVALIDATE_SECRET) {
+    return NextResponse.json({ ok: false, error: "unauthorized" }, { status: 401 });
+  }
+
+  if (body.slug) revalidatePath(`/blog/${body.slug}`);
+  revalidatePath("/blog");
+  revalidateTag("intelexia-articles");
+
+  return NextResponse.json({ ok: true, revalidated: { slug: body.slug ?? null } });
+}
+```
+
+> O worker envia o secret tanto no header `x-revalidate-secret` quanto no body, tem timeout de 15s e é **fire-and-forget** (se seu endpoint falhar, o artigo continua publicado e a ISR atualiza pelo `revalidate: 60`).
+
+## API
+
+### `createClient(config)`
+
+| Opção    | Tipo                 | Default                                           |
+| -------- | -------------------- | ------------------------------------------------- |
+| `token`  | `string` (obrig.)    | —                                                 |
+| `apiUrl` | `string`             | `https://api.innovarticles.intelexia.com.br`      |
+| `fetch`  | `typeof fetch`       | `globalThis.fetch`                                |
+| `init`   | `RequestInit`        | `undefined` (passe `{ next: { revalidate: N } }`) |
+
+### `client.getArticles({ limit?, offset?, init? })`
+
+Resposta: `{ ok, mode, lifecycle, count, items: ArticleListItem[] }`.
+
+### `client.getArticleBySlug(slug, { init? })`
+
+Resposta: `{ ok, mode, lifecycle, article: Article }`. **404 → joga `IntelexiaApiError`** (use `try/catch` + `notFound()`).
+
+### `mergePosts({ local, remote, mapLocal, dedupe?, sortBy? })` 🆕 0.2.0
+
+| Opção      | Tipo                                              | Default          |
+| ---------- | ------------------------------------------------- | ---------------- |
+| `local`    | `readonly TLocal[]` (qualquer shape)              | —                |
+| `remote`   | `readonly ArticleListItem[]`                      | —                |
+| `mapLocal` | `(post: TLocal) => Omit<UnifiedPost,"source"> \| null` | —          |
+| `dedupe`   | `"remote-wins" \| "local-wins" \| "throw"`       | `"remote-wins"`  |
+| `sortBy`   | `"date-desc" \| "date-asc" \| "none"`             | `"date-desc"`    |
+
+Retorna `UnifiedPost[]` com `source: "local" | "remote"`. `mapLocal` retornando `null` filtra o post (útil pra esconder rascunhos). Slugs duplicados resolvidos pela estratégia `dedupe`. Veja exemplo no Modo Additive acima.
+
+### `mode: "full" | "plain"`
+
+- **`full`** (sites `active`/`paused`): inclui schema JSON-LD, metaTitle/Description, keyword(s), interlinking interno no `contentHtml`.
+- **`plain`** (site `cancelled`): só conteúdo cru — schema/meta/keywords vêm `null`, interlinking removido. O `ArticleJsonLd` e o `articleToMetadata` lidam graciosamente (omitem o que não tem).
+
+A decisão é **server-side e não-negociável** — o cliente não escolhe o modo.
+
+### Helpers `/react`
+
+- `<ArticleJsonLd article={article} />` — renderiza `<script type="application/ld+json">` com o `schemaJson`. No-op se ausente.
+- `articleToMetadata(article)` → objeto compatível com o `Metadata` do Next.js App Router (title, description, keywords, openGraph, twitter, customMetaTags como `other`).
+
+## Erros
+
+```ts
+import { IntelexiaApiError, MergeConflictError } from "@intelex-ia/sdk";
+
+try {
+  await intelexia.getArticleBySlug("post-inexistente");
+} catch (err) {
+  if (err instanceof IntelexiaApiError) {
+    console.error(err.status, err.message); // 404, "Artigo não encontrado."
+  }
+}
+
+try {
+  mergePosts({ local, remote, mapLocal, dedupe: "throw" });
+} catch (err) {
+  if (err instanceof MergeConflictError) {
+    console.error(`Conflito de slug: ${err.slug}`);
+  }
+}
+```
+
+## Compatibilidade
+
+- **Node** 18+ (fetch nativo), Edge Runtime, Browser.
+- **React** 18+ (peer dep opcional — só pros helpers `/react`).
+- **TypeScript:** tipos publicados no `dist`.
+- **Frameworks:** Next.js (App Router e Pages Router), Astro, Remix, SvelteKit, Vite, qualquer JS.
+
+## Changelog
+
+- **0.2.0** — adiciona `mergePosts()` + tipo `UnifiedPost` + `MergeConflictError` (3 modos de integração).
+- **0.1.0** — release inicial: `createClient`, `getArticles`, `getArticleBySlug`, `<ArticleJsonLd>`, `articleToMetadata`.

package/dist/autoria.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=autoria.test.d.ts.map

package/dist/autoria.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoria.test.d.ts","sourceRoot":"","sources":["../src/autoria.test.ts"],"names":[],"mappings":""}

package/dist/autoria.test.js

@@ -0,0 +1,85 @@
+import { describe, it, expect } from "vitest";
+import { autoriaDoArtigo, SELO_IA } from "./react.js";
+/**
+ * A autoria do artigo tem duas regras duras, e as duas vêm de fora da
+ * engenharia:
+ *
+ * 1. `author` só vale quando é `Organization`. Texto produzido com apoio de IA
+ *    e assinado por uma PESSOA é o que os Termos do Google proíbem desde
+ *    30/07/2026. O profissional aparece como REVISOR.
+ *
+ * 2. A autoria NUNCA some. Sem cadastro, assina a equipe da empresa — e o selo
+ *    de apoio de IA sai do mesmo jeito. Artigo no ar sem dizer quem assina foi
+ *    exatamente o defeito medido no siteIA em 21/10/2026.
+ */
+describe("autoriaDoArtigo", () => {
+    const comOrganization = {
+        schemaJson: {
+            "@graph": [
+                {
+                    "@type": "BlogPosting",
+                    author: { "@type": "Organization", name: "Equipe Editorial Parceria" },
+                    contributor: {
+                        "@type": "Person",
+                        name: "Mauro Roger Pinto",
+                        jobTitle: "Contador responsável técnico",
+                        identifier: "CRC-SC 020357/O-4",
+                    },
+                    dateModified: "2026-10-21",
+                    publisher: { "@type": "Organization", name: "Parceria Assessoria Contábil" },
+                },
+            ],
+        },
+    };
+    it("usa a Organization como autor e o contributor como revisor", () => {
+        const a = autoriaDoArtigo(comOrganization);
+        expect(a.autor).toBe("Equipe Editorial Parceria");
+        expect(a.revisor).toBe("Mauro Roger Pinto, Contador responsável técnico, CRC-SC 020357/O-4");
+        expect(a.revisadoEm).toBe("2026-10-21");
+        expect(a.temCadastro).toBe(true);
+    });
+    it("IGNORA author do tipo Person — e cai para a equipe da empresa", () => {
+        const a = autoriaDoArtigo({
+            schemaJson: {
+                "@type": "BlogPosting",
+                author: { "@type": "Person", name: "Fulano de Tal" },
+                publisher: { "@type": "Organization", name: "Contabilidade Acme" },
+            },
+        });
+        expect(a.autor).not.toContain("Fulano");
+        expect(a.autor).toBe("Equipe Editorial Contabilidade Acme");
+        expect(a.temCadastro).toBe(false);
+    });
+    it("sem autoria no schema, assina a equipe tirada do publisher", () => {
+        const a = autoriaDoArtigo({
+            schemaJson: { "@type": "BlogPosting", publisher: { "@type": "Organization", name: "Acme" } },
+        });
+        expect(a.autor).toBe("Equipe Editorial Acme");
+        expect(a.revisor).toBeNull();
+        expect(a.temCadastro).toBe(false);
+    });
+    it("a prop `empresa` vence o publisher do schema", () => {
+        const a = autoriaDoArtigo({ schemaJson: { publisher: { "@type": "Organization", name: "Nome Velho" } } }, { empresa: "Nome Novo" });
+        expect(a.autor).toBe("Equipe Editorial Nome Novo");
+    });
+    it("sem schema nenhum ainda assina — nunca devolve vazio", () => {
+        for (const vazio of [null, undefined, "", 0, [], "texto solto"]) {
+            const a = autoriaDoArtigo({ schemaJson: vazio });
+            expect(a.autor.length).toBeGreaterThan(0);
+            expect(a.temCadastro).toBe(false);
+        }
+    });
+    it("revisor sem cargo nem registro não gera pontuação solta", () => {
+        const a = autoriaDoArtigo({
+            schemaJson: {
+                author: { "@type": "Organization", name: "Equipe" },
+                contributor: { "@type": "Person", name: "Ana Souza" },
+            },
+        });
+        expect(a.revisor).toBe("Ana Souza");
+    });
+    it("o selo é o texto único do grupo", () => {
+        expect(SELO_IA).toBe("Apoio de IA · Revisão humana");
+    });
+});
+//# sourceMappingURL=autoria.test.js.map

package/dist/autoria.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoria.test.js","sourceRoot":"","sources":["../src/autoria.test.ts"],"names":[],"mappings":"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"}

package/dist/react.d.ts

@@ -88,4 +88,62 @@ export interface ArticleMetadata {
  */
 export declare function articleToMetadata(article: ArticleMetadataInput): ArticleMetadata;
 export type { Article, CustomMetaTag } from "./types.js";
+/**
+ * Selo de transparência. Fecha a linha do revisor na ASSINATURA, no fim do
+ * artigo — nunca na barra do topo.
+ */
+export declare const SELO_IA = "Apoio de IA \u00B7 Revis\u00E3o humana";
+export interface AutoriaDoArtigo {
+    /** Quem assina. SEMPRE preenchido: cai para a equipe da empresa. */
+    autor: string;
+    /** "Nome, cargo, registro" do revisor, ou `null` quando não há cadastro. */
+    revisor: string | null;
+    /** ISO da revisão, quando o schema traz `dateModified`. */
+    revisadoEm: string | null;
+    /** `false` quando a autoria veio da queda, e não do schema. */
+    temCadastro: boolean;
+}
+/**
+ * Lê a autoria do `schemaJson` do artigo.
+ *
+ * ⚠️ `author` SÓ vale quando é `Organization`. Texto produzido com apoio de IA
+ * e assinado por uma PESSOA é o que os Termos do Google proíbem desde
+ * 30/07/2026 — então, quando o schema traz uma Person em `author`, ela é
+ * ignorada aqui. O profissional aparece como REVISOR, via `contributor`.
+ *
+ * NUNCA devolve vazio: sem autoria no schema, assina a equipe da empresa
+ * (`empresa`, ou o `publisher.name` do próprio schema). Artigo no ar sem dizer
+ * quem assina e sem declarar o apoio de IA não é uma saída aceitável — foi o
+ * que esta função existe para impedir.
+ */
+export declare function autoriaDoArtigo(article: {
+    schemaJson?: unknown | null;
+}, opts?: {
+    empresa?: string;
+}): AutoriaDoArtigo;
+export interface AuthorBarProps {
+    article: {
+        schemaJson?: unknown | null;
+    };
+    /** Nome do negócio, para a queda. Sem ele, usa o `publisher` do schema. */
+    empresa?: string;
+    /** Classe do contêiner. O estilo é do SITE — o SDK não traz CSS. */
+    className?: string;
+}
+/**
+ * Barra de autoria, logo abaixo do `<h1>`.
+ *
+ * SEMPRE renderiza (ver `autoriaDoArtigo`). Não traz CSS: o SDK não pode impor
+ * visual a sites que têm cada um o seu. As classes (`ia-autor` por padrão) são
+ * ganchos para o site vestir.
+ *
+ * O selo de IA NÃO vem aqui — ele fecha a linha do revisor em
+ * `<AuthorSignature>`, no fim do artigo.
+ */
+export declare function AuthorBar({ article, empresa, className, }: AuthorBarProps): ReactElement;
+/**
+ * Assinatura, no FIM do artigo. É aqui que o selo de IA fecha a linha do
+ * revisor — e aparece tanto com profissional cadastrado quanto sem.
+ */
+export declare function AuthorSignature({ article, empresa, className, }: AuthorBarProps): ReactElement;
 //# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EAAW,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzD,iEAAiE;AACjE,UAAU,kBAAkB;IAC1B,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,OAAO,GACR,EAAE;IACD,OAAO,EAAE,kBAAkB,CAAC;CAC7B,GAAG,YAAY,GAAG,IAAI,CAYtB;AAED,mEAAmE;AACnE,UAAU,oBAAoB;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAClC,cAAc,CAAC,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;CACzC;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE;QACV,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC5B,CAAC;IACF,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,qBAAqB,CAAC;QAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,oBAAoB,GAC5B,eAAe,CAiCjB;AAGD,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"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"}

package/dist/react.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
  * Renderiza um `<script type="application/ld+json">` com o schema JSON-LD do
  * artigo. Pode ser colocado em qualquer lugar do `<body>` — o Google lê tanto
@@ -81,4 +81,100 @@ export function articleToMetadata(article) {
         ...(Object.keys(other).length > 0 ? { other } : {}),
     };
 }
+// ─────────────────────────────────────────────────────────────────────────────
+// AUTORIA
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Selo de transparência. Fecha a linha do revisor na ASSINATURA, no fim do
+ * artigo — nunca na barra do topo.
+ */
+export const SELO_IA = "Apoio de IA · Revisão humana";
+const ehNo = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+const texto = (v) => typeof v === "string" && v.trim() ? v.trim() : null;
+/**
+ * Lê a autoria do `schemaJson` do artigo.
+ *
+ * ⚠️ `author` SÓ vale quando é `Organization`. Texto produzido com apoio de IA
+ * e assinado por uma PESSOA é o que os Termos do Google proíbem desde
+ * 30/07/2026 — então, quando o schema traz uma Person em `author`, ela é
+ * ignorada aqui. O profissional aparece como REVISOR, via `contributor`.
+ *
+ * NUNCA devolve vazio: sem autoria no schema, assina a equipe da empresa
+ * (`empresa`, ou o `publisher.name` do próprio schema). Artigo no ar sem dizer
+ * quem assina e sem declarar o apoio de IA não é uma saída aceitável — foi o
+ * que esta função existe para impedir.
+ */
+export function autoriaDoArtigo(article, opts) {
+    const schema = article.schemaJson;
+    const nos = [];
+    if (ehNo(schema)) {
+        const grafo = schema["@graph"];
+        if (Array.isArray(grafo))
+            nos.push(...grafo.filter(ehNo));
+        else
+            nos.push(schema);
+    }
+    // Nome da empresa para a queda: o que veio por prop vence; senão, o
+    // `publisher` do schema, que é justamente a organização do cliente.
+    let empresa = texto(opts?.empresa);
+    if (!empresa) {
+        for (const no of nos) {
+            const pub = no.publisher;
+            if (ehNo(pub) && texto(pub.name)) {
+                empresa = texto(pub.name);
+                break;
+            }
+        }
+    }
+    for (const no of nos) {
+        const a = no.author;
+        if (!ehNo(a) || a["@type"] !== "Organization")
+            continue;
+        const autor = texto(a.name);
+        if (!autor)
+            continue;
+        const c = no.contributor;
+        const revisor = ehNo(c) && texto(c.name)
+            ? [texto(c.name), texto(c.jobTitle), texto(c.identifier)]
+                .filter(Boolean)
+                .join(", ")
+            : null;
+        return { autor, revisor, revisadoEm: texto(no.dateModified), temCadastro: true };
+    }
+    return {
+        autor: empresa ? `Equipe Editorial ${empresa}` : "Equipe Editorial",
+        revisor: null,
+        revisadoEm: null,
+        temCadastro: false,
+    };
+}
+/** Texto da linha de revisão, igual nos dois blocos. */
+function linhaDeRevisao(a, empresa) {
+    const quem = a.revisor
+        ? `Revisado por ${a.revisor}`
+        : `Revisado pela equipe ${empresa?.trim() || a.autor.replace(/^Equipe Editorial\s*/, "") || "editorial"}`;
+    return `${quem} · ${SELO_IA}`;
+}
+/**
+ * Barra de autoria, logo abaixo do `<h1>`.
+ *
+ * SEMPRE renderiza (ver `autoriaDoArtigo`). Não traz CSS: o SDK não pode impor
+ * visual a sites que têm cada um o seu. As classes (`ia-autor` por padrão) são
+ * ganchos para o site vestir.
+ *
+ * O selo de IA NÃO vem aqui — ele fecha a linha do revisor em
+ * `<AuthorSignature>`, no fim do artigo.
+ */
+export function AuthorBar({ article, empresa, className = "ia-autor", }) {
+    const a = autoriaDoArtigo(article, { empresa });
+    return (_jsxs("div", { className: className, children: [_jsxs("strong", { children: ["por ", a.autor] }), a.revisor ? _jsxs("span", { children: ["Revis\u00E3o: ", a.revisor] }) : null] }));
+}
+/**
+ * Assinatura, no FIM do artigo. É aqui que o selo de IA fecha a linha do
+ * revisor — e aparece tanto com profissional cadastrado quanto sem.
+ */
+export function AuthorSignature({ article, empresa, className = "ia-assinatura", }) {
+    const a = autoriaDoArtigo(article, { empresa });
+    return (_jsxs("section", { className: className, "aria-label": "Autoria", children: [_jsxs("p", { className: `${className}-nome`, children: ["Escrito por ", a.autor] }), _jsx("p", { className: `${className}-cargo`, children: linhaDeRevisao(a, empresa) })] }));
+}
 //# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,64 +1,64 @@
-{
-  "name": "@intelex-ia/sdk",
-  "version": "0.2.0",
-  "description": "SDK pra consumir a Content API da IntelexIA em sites headless (Next.js, Astro, etc.). Multiplataforma Fase 2b.",
-  "license": "MIT",
-  "author": "intelex-ia",
-  "homepage": "https://github.com/intelex-ia/combo_automatico/tree/main/packages/sdk",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/intelex-ia/combo_automatico.git",
-    "directory": "packages/sdk"
-  },
-  "bugs": {
-    "url": "https://github.com/intelex-ia/combo_automatico/issues"
-  },
-  "keywords": [
-    "intelexia",
-    "content-api",
-    "headless",
-    "cms",
-    "next",
-    "nextjs",
-    "react",
-    "sdk"
-  ],
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./react": {
-      "types": "./dist/react.d.ts",
-      "default": "./dist/react.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "typecheck": "tsc --noEmit"
-  },
-  "peerDependencies": {
-    "react": ">=18"
-  },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@types/react": "^18.3.12",
-    "typescript": "^5.6.3"
-  },
-  "publishConfig": {
-    "access": "public",
-    "provenance": true
-  }
-}
+{
+  "name": "@intelex-ia/sdk",
+  "version": "0.3.0",
+  "description": "SDK pra consumir a Content API da IntelexIA em sites headless (Next.js, Astro, etc.). Multiplataforma Fase 2b.",
+  "license": "MIT",
+  "author": "intelex-ia",
+  "homepage": "https://github.com/intelex-ia/combo_automatico/tree/main/packages/sdk",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intelex-ia/combo_automatico.git",
+    "directory": "packages/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/intelex-ia/combo_automatico/issues"
+  },
+  "keywords": [
+    "intelexia",
+    "content-api",
+    "headless",
+    "cms",
+    "next",
+    "nextjs",
+    "react",
+    "sdk"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "default": "./dist/react.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.12",
+    "typescript": "^5.6.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}