@intelex-ia/sdk 0.1.0 → 0.3.0

package/README.md

@@ -1,207 +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, um `<ArticleJsonLd>` pra injetar o schema JSON-LD, e um `articleToMetadata` pra plugar no `generateMetadata` do Next.js App Router. Zero dependências (usa `fetch` global).
-
-## Instalação
-
-```bash
-pnpm add @intelex-ia/sdk
-# ou
-npm install @intelex-ia/sdk
-```
-
-> **Enquanto não publicamos no npm**, instale via tarball/git URL (peça pro time IntelexIA).
-
-## Configuração
-
-1. No painel da IntelexIA, **cadastre o site como "Headless (código)"** (vai pedir só domain + opcional revalidate URL/secret).
-2. Abra o site na lista → seção **"Tokens de API (Content API)"** → **Gerar token**. Você recebe `itx_…` (mostrado uma única vez).
-3. Coloque o token em `.env.local`:
-
-```bash
-INTELEXIA_TOKEN=itx_seu_token_aqui
-INTELEXIA_API_URL=https://api.innovarticles.intelexia.com.br  # opcional, é o default
-```
-
-## Uso (Next.js App Router)
-
-### Cliente — `lib/intelexia.ts`
-
-```ts
-import { createClient } from "@intelex-ia/sdk";
-
-export const intelexia = createClient({
-  token: process.env.INTELEXIA_TOKEN!,
-  // ISR: revalida a cada 60s (ou use webhook revalidate pra invalidar
-  // sob demanda — ver mais abaixo).
-  init: { next: { revalidate: 60, tags: ["intelexia-articles"] } },
-});
-```
-
-### Listagem — `app/blog/page.tsx` (Server Component)
-
-```tsx
-import { intelexia } from "@/lib/intelexia";
-import Link from "next/link";
-
-export default async function BlogIndex() {
-  const { items } = await intelexia.getArticles({ limit: 20 });
-  return (
-    <main>
-      <h1>Blog</h1>
-      <ul>
-        {items.map((a) => (
-          <li key={a.id}>
-            <Link href={`/blog/${a.slug}`}>{a.title}</Link>
-            {a.publishedAt && (
-              <time>{new Date(a.publishedAt).toLocaleDateString("pt-BR")}</time>
-            )}
-          </li>
-        ))}
-      </ul>
-    </main>
-  );
-}
-```
-
-### Post — `app/blog/[slug]/page.tsx` (com SEO completo)
-
-```tsx
-import { intelexia } from "@/lib/intelexia";
-import { ArticleJsonLd, articleToMetadata } from "@intelex-ia/sdk/react";
-import { IntelexiaApiError } from "@intelex-ia/sdk";
-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); // → title, description, OG, Twitter, keywords
-}
-
-export default async function PostPage({
-  params,
-}: {
-  params: Promise<{ slug: string }>;
-}) {
-  const { slug } = await params;
-  const { article } = await fetchArticle(slug);
-  return (
-    <article>
-      {/* Schema JSON-LD (Article/Breadcrumb/FAQ/HowTo/Org/Person) */}
-      <ArticleJsonLd article={article} />
-
-      <h1>{article.title}</h1>
-      {article.featuredImageUrl && (
-        <img src={article.featuredImageUrl} alt={article.title ?? ""} />
-      )}
-      <div
-        dangerouslySetInnerHTML={{ __html: article.contentHtml ?? "" }}
-      />
-    </article>
-  );
-}
-```
-
-### Webhook de revalidate — `app/api/revalidate/route.ts`
-
-Quando um artigo publica no painel, o worker IntelexIA faz um `POST` no seu endpoint de revalidate (configurado no cadastro do site). Implemente assim:
-
-```ts
-import { NextResponse } from "next/server";
-import { revalidatePath, revalidateTag } from "next/cache";
-
-export async function POST(req: Request) {
-  // Autentica com o secret cadastrado no painel (header X ou body)
-  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 });
-  }
-
-  // Revalida a página do post (se veio slug) e o índice do blog.
-  if (body.slug) revalidatePath(`/blog/${body.slug}`);
-  revalidatePath("/blog");
-  revalidateTag("intelexia-articles");
-
-  return NextResponse.json({ ok: true, revalidated: { slug: body.slug ?? null } });
-}
-```
-
-E no `.env.local`:
-
-```bash
-INTELEXIA_REVALIDATE_SECRET=cole-o-mesmo-segredo-do-painel
-```
-
-> O worker envia o secret tanto em `x-revalidate-secret` quanto no body (`{ secret, slug, domain }`), tem timeout de 15s e é **fire-and-forget** (se o 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()`).
-
-### `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 } 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."
-  }
-}
-```
-
-## Compatibilidade
-
-- Node 18+ (fetch nativo), Edge Runtime, Browser.
-- React 18+ (peer dep opcional — só pros helpers `/react`).
-- TypeScript: tipos publicados no `dist`.
+# `@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/index.d.ts

@@ -6,4 +6,5 @@
  */
 export { createClient, IntelexiaApiError, type ClientConfig, type ArticlesListResponse, type ArticleResponse, type IntelexiaClient, } from "./client.js";
 export type { Lifecycle, Mode, Article, ArticleListItem, CustomMetaTag, ErrorResponse, } from "./types.js";
+export { mergePosts, MergeConflictError, type UnifiedPost, type MergePostsOptions, } from "./merge.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,SAAS,EACT,IAAI,EACJ,OAAO,EACP,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,SAAS,EACT,IAAI,EACJ,OAAO,EACP,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AAIpB,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -5,4 +5,7 @@
  * `@intelex-ia/sdk/react`.
  */
 export { createClient, IntelexiaApiError, } from "./client.js";
+// Merge helpers (0.2.0+) — pro caso real "cliente já tem posts antigos
+// e quer adicionar os do painel sem perder os antigos".
+export { mergePosts, MergeConflictError, } from "./merge.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,YAAY,EACZ,iBAAiB,GAKlB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,YAAY,EACZ,iBAAiB,GAKlB,MAAM,aAAa,CAAC;AAWrB,uEAAuE;AACvE,wDAAwD;AACxD,OAAO,EACL,UAAU,EACV,kBAAkB,GAGnB,MAAM,YAAY,CAAC"}