@prenta/client 0.6.0

package/CHANGELOG.md

@@ -0,0 +1,166 @@
+# @actuate-media/client
+
+## 0.6.0
+
+### Minor Changes
+
+- 5eea995: Product rename: ActuateCMS is now **Prenta**. Every package moves from the
+  `@actuate-media/*` scope to `@prenta/*` with simplified names (`@prenta/core`,
+  `@prenta/admin`, `create-prenta`), and version numbers continue from where the
+  old scope left off.
+
+  This is a clean break — no backwards-compat aliases:
+  - **npm packages**: `@actuate-media/cms-core` → `@prenta/core`,
+    `@actuate-media/cms-admin` → `@prenta/admin`, all other packages keep their
+    suffix under `@prenta/*`. `create-actuate-cms` → `create-prenta`
+    (`npm create prenta`), `create-actuate-astro` → `create-prenta-astro`.
+    CLI bins: `actuate`/`actuate-cms` → `prenta`/`prenta-cms`; `actuate-mcp` →
+    `prenta-mcp`.
+  - **Database**: migration `0012_rename_to_prenta` renames all 36 `actuate_*`
+    tables to `prenta_*` in place (plus prefixed constraints, indexes, and
+    sequences). Run `prisma migrate deploy` when upgrading.
+  - **Runtime identifiers**: `getActuateConfig` → `getPrentaConfig`,
+    `handleActuateAPI` → `handlePrentaAPI`, `ActuateClient` → `PrentaClient`,
+    `ActuateDB` → `PrentaDB`, config file `actuate.config.ts` →
+    `prenta.config.ts`, CSS scopes `.actuate-admin`/`.actuate-canvas` →
+    `.prenta-admin`/`.prenta-canvas`, preview protocol `actuate-preview:*` →
+    `prenta-preview:*`, webhook headers `X-Actuate-*` → `X-Prenta-*`, session
+    cookie `actuate_session` → `prenta_session`, env vars `ACTUATE_*` →
+    `PRENTA_*`, purge route `/api/actuate/purge` → `/api/prenta/purge`.
+  - **Sessions and webhooks**: all sessions reset on upgrade (cookie + JWT issuer
+    changed); webhook consumers must re-verify signatures against the new
+    `X-Prenta-*` headers.
+
+  The old `@actuate-media/*` packages are deprecated on npm and will receive no
+  further releases.
+
+## 0.5.3
+
+### Patch Changes
+
+- 041a228: Add the MIT `license` field to every published package (previously missing) and correct `repository.url` to `github.com/actuate-media/actuatecms` (13 packages carried the wrong org).
+
+## 0.5.2
+
+### Patch Changes
+
+- 854152d: Developer experience improvements from external-consumer feedback:
+  - Every published package now ships its `CHANGELOG.md` in the npm tarball, and packages that were missing a `README.md` (cli, cms-admin, cms-core, import, platform-vercel, all plugins, sections-react) now have one — so release notes and usage docs are visible on npmjs.com and in `node_modules`.
+  - New client-safe form validation entry point: `@actuate-media/cms-core/forms/client` exports `validateFormFieldClient()`, `validateFormValuesClient()`, visibility/conditional helpers, and the exact `FORM_EMAIL_RE` / `FORM_PHONE_RE` regexes the server enforces — zero Node dependencies, so public-site forms can mirror server rules without reimplementing them. The server validator now imports the same primitives, so client and server can never drift.
+
+## 0.5.1
+
+### Patch Changes
+
+- 29f32ba: Formally declare `@actuate-media/client` as a **read-only delivery SDK** (roadmap B3 decision). Added a package README and expanded the `ActuateClient` JSDoc to state the scope explicitly: the SDK covers `list`/`get`/`getGlobal`/`resolve`/`listMedia` for fetching published content and ships no write methods by design. Programmatic authoring is routed to MCP (`@actuate-media/mcp-server`) or the authenticated HTTP API. No runtime/API changes.
+
+## 0.5.0
+
+### Minor Changes
+
+- 01eef99: Add `SCHEDULED_UNPUBLISH` to the document status union and export a shared
+  `ActuateDocumentStatus` type. The server's `DocumentStatus` enum includes
+  `SCHEDULED_UNPUBLISH` (used by scheduled unpublish flows), but the client's
+  `ActuateDocument.status` / `ListQuery.status` unions omitted it — so a document
+  the API could legitimately return wasn't representable in a consumer's typed
+  `switch`/filter. The unions now match the server contract exactly.
+
+## 0.4.0
+
+### Minor Changes
+
+- ae1af8f: Authoring correctness fixes for the AI site-building workflow (roadmap WS-B/E quick wins).
+  - **cms-core**: `createDocument` now honors a requested `status` (`DRAFT` or
+    `PUBLISHED`) instead of always forcing `DRAFT`. Publishing on create is gated
+    to EDITOR/ADMIN, stamps `publishedAt`, and emits the `document.published`
+    webhook + sitemap notify. This fixes `POST /page-builder/create?publish=true`
+    (and `status: 'PUBLISHED'`), which previously created a draft silently.
+    Statuses other than `DRAFT`/`PUBLISHED` on create are rejected with guidance
+    to schedule/archive via update.
+  - **client**: `listMedia()` now returns the canonical
+    `{ docs, total, page, pageSize, totalPages }` (`MediaList`) envelope. The
+    server returns the asset array under `items`/`data` (never `docs`), so the
+    previous typing made `listMedia().docs` always `undefined`. Adds exported
+    `MediaAsset` and `MediaList` types and an optional `init` (signal/cache) arg.
+  - **mcp-server**: the `list_media` tool now normalizes the same `items`→`docs`
+    shape so its output matches `list_documents`.
+  - **create-actuate-cms**: generated `TextBlock`/`ImageTextBlock` now sanitize
+    author-supplied HTML with `sanitizeHtml` before `dangerouslySetInnerHTML`
+    (was an XSS vector on hostile content).
+
+## 0.3.0
+
+### Minor Changes
+
+- abc7924: Phase 5.5 #1: tag-based edge caching for public document reads.
+  - **`@actuate-media/client`**: `list`, `get`, `global`, `resolve`, and
+    `listMedia` now automatically attach per-resource cache tags
+    (`actuate:collection:<slug>`, `actuate:doc:<id>`,
+    `actuate:global:<slug>`, `actuate:path:<path>`) alongside the existing
+    wholesale `actuate` tag. New exported helpers `actuateTag(kind, slug)`
+    and `actuateTags(kind, ...)` return the canonical tag set so a
+    webhook handler can call `revalidateTag()` with the exact same
+    strings the SDK uses for reads. The `tags` field on `defaultCache`
+    remains opt-in; resource tags are merged on top of it and deduped.
+    `revalidate: false` (no-store) bypasses tag emission entirely.
+  - **`@actuate-media/cms-core`**: new top-level `cache?: CacheConfig`
+    field on `ActuateCMSConfig`. When `cache.publicReads.enabled` is true
+    the four read endpoints (`GET /collections/:slug`,
+    `GET /collections/:slug/:id`, `GET /globals/:slug`, `GET /resolve`)
+    emit `Cache-Control: public, s-maxage=<maxAge>, stale-while-revalidate=<swr>`
+    for unauthenticated and API-key requests. Session-cookie requests
+    always get `private, no-store`; preview-token resolve requests bypass
+    the cache. New `cache.onInvalidate` hook fires after every
+    create/update/delete and global update with the canonical tag set;
+    failures are swallowed so cache invalidation can never roll back a
+    successful write. The cache layer is off by default — existing
+    consumers see no behaviour change until they opt in. See
+    `docs/caching.md` for the full contract.
+
+## 0.2.2
+
+### Patch Changes
+
+- 4259d9a: Remove dead 404 catch from `resolvePagePath` in `@actuate-media/client/next`.
+
+  `resolvePagePath` used to wrap `client.resolve(path)` in its own try/catch that returned `null` on 404. As of `@actuate-media/client@0.2.1`, `client.resolve()` already handles 404 internally and returns `null`, making the wrapper's catch block dead code that misleads consumers into thinking `resolve()` still throws on 404. The helper is now a thin pass-through that delegates directly to `client.resolve()` — non-404 errors still propagate, which is what you want inside a Server Component (Next.js renders a 500).
+
+  Caught by Cursor Bugbot during review of PR #66. Regression test added.
+
+## 0.2.1
+
+### Patch Changes
+
+- 75e696d: Fix two correctness bugs in `@actuate-media/client` introduced in 0.1/0.2:
+  - `ActuateClient.resolve(path)` now returns `null` when the CMS responds with `404` for an unmatched path, matching the documented `Promise<ActuateDocument | null>` contract. It previously threw `ActuateError` for any missing route, forcing callers to wrap every `resolve()` in a try/catch.
+  - `ActuateClient.global(slug)` now correctly unwraps the single-level `{ data: <global> }` envelope that `GET /globals/:slug` returns. It previously looked for `data.data`, so every call returned `undefined`.
+
+  Regression tests added for both behaviors. No public API surface changes.
+
+## 0.2.0
+
+### Minor Changes
+
+- 866a861: Ship `@actuate-media/client` — the official type-safe HTTP client for
+  reading Actuate CMS content (Phase 1 of the roadmap).
+
+  The package exposes three sub-paths:
+  - `@actuate-media/client` — the core `ActuateClient` / `createClient`
+    factory. Pass your `actuate.config.ts` as a generic parameter and the
+    client surface auto-derives field types from your collection
+    definitions — no codegen step required.
+  - `@actuate-media/client/react` — dependency-free `useCollection`,
+    `useContent`, and `useGlobal` hooks for client components. Built-in
+    AbortController support cancels stale requests on key change.
+  - `@actuate-media/client/next` — `createNextClient()` that defaults to
+    Next.js fetch cache semantics (`revalidate` + `tags`) plus an
+    `actuateTag()` helper for `revalidateTag()` invalidation from webhook
+    handlers.
+
+  The runtime is < 5 KB gzipped with zero dependencies. React is an
+  optional peer dependency (only required if you import from `./react`).
+
+  Tests: 9 unit tests covering pagination, filters, auth headers, custom
+  headers, public/no-key mode, default+per-call cache, error envelopes.
+
+  Docs: `docs/client-sdk.md`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Actuate Media
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# @prenta/client
+
+Type-safe **read / delivery** client and React hooks for the
+[Prenta CMS](https://github.com/actuate-media/prenta) REST API.
+
+```bash
+npm install @prenta/client
+```
+
+## Scope: read-only by design
+
+This SDK is the **delivery** layer — it fetches **published** content into a
+frontend. It is intentionally **read-only** and ships **no**
+create/update/delete/publish or upload methods.
+
+| You want to…                       | Use                                                           |
+| ---------------------------------- | ------------------------------------------------------------- |
+| Render published content in a site | **This package** (`@prenta/client`)                           |
+| Create / edit / publish content    | **MCP** (`@prenta/mcp-server`) — for AI agents & tooling      |
+| Script writes from a backend / CI  | The authenticated **HTTP API** (`POST/PUT/DELETE /api/cms/…`) |
+
+Keeping authoring out of the delivery package is a deliberate decision: the
+delivery bundle stays small, its API key only needs the `read` scope, and the
+entire write surface stays auditable in one place (the CMS API + MCP server).
+If you need an authoring SDK, drive the documented HTTP endpoints — the same
+ones the [MCP server](https://github.com/actuate-media/prenta) calls.
+
+## Usage
+
+```ts
+import { PrentaClient } from '@prenta/client'
+import type prentaConfig from './prenta.config'
+
+const client = new PrentaClient<typeof prentaConfig>({
+  url: 'https://your-site.com',
+  apiKey: process.env.PRENTA_API_KEY, // read scope is sufficient
+})
+
+// List published posts (typed by your config)
+const { docs } = await client.list('posts', { status: 'PUBLISHED' })
+
+// Fetch a single document, a global, or resolve a public URL
+const post = await client.get('posts', id)
+const brand = await client.getGlobal('brand')
+const page = await client.resolve('/about')
+
+// Media assets come back as the canonical { docs, total, page, … } envelope
+const { docs: media } = await client.listMedia({ search: 'logo' })
+```
+
+React and Next.js entrypoints are available at `@prenta/client/react`
+and `@prenta/client/next` (the latter wires `next/cache` tags +
+`revalidate`).
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,147 @@
+import type { PrentaConfigLike, PrentaDocument, PrentaList, CollectionData, GlobalData, ListQuery, MediaList } from './types.js';
+export type { PrentaConfigLike, PrentaDocument, PrentaDocumentStatus, PrentaList, PrentaFieldDefinition, CollectionData, GlobalData, FieldToType, FieldsToData, ListQuery, MediaAsset, MediaList, } from './types.js';
+export interface PrentaClientOptions {
+    /** Base URL of the CMS (e.g. `https://maidpro.co`). `/api/cms` is appended automatically. */
+    url: string;
+    /** API key with at least `read` scope on the collections you want to query. */
+    apiKey?: string;
+    /** Override the global `fetch` implementation (e.g. in tests, or to bind a custom retry policy). */
+    fetchImpl?: typeof fetch;
+    /**
+     * Optional default cache settings forwarded to `fetch` as request init.
+     * Used by `next` integration to set `next: { revalidate, tags }`.
+     */
+    defaultCache?: {
+        revalidate?: number | false;
+        tags?: string[];
+    };
+    /** Additional headers attached to every request (e.g. a tenant header). */
+    headers?: Record<string, string>;
+}
+export declare class PrentaError extends Error {
+    readonly status: number;
+    readonly response: unknown;
+    constructor(message: string, status: number, response?: unknown);
+}
+/**
+ * Type-safe **read / delivery** client for the Prenta CMS REST API.
+ *
+ * Scope (deliberate): this SDK is **read-only**. It covers the public
+ * delivery surface — `list`, `get`, `getGlobal`, `resolve`, `listMedia`,
+ * plus the React/Next cache helpers — for fetching published content into a
+ * frontend. It intentionally ships **no** create/update/delete/publish or
+ * upload methods.
+ *
+ * **Authoring belongs to agents and tooling, not the delivery SDK.** To
+ * create or mutate content programmatically, drive the CMS over **MCP**
+ * (`@prenta/mcp-server`) or call the authenticated HTTP API directly
+ * (`POST/PUT/DELETE /api/cms/collections/:slug`, `/media/upload`, …). Keeping
+ * authoring out of this package keeps the delivery bundle small, its API key
+ * scoped to `read`, and the write surface auditable in one place.
+ *
+ * The class is generic over a config type so consumers get field-level
+ * autocomplete when they pass their `typeof prentaConfig` as the type
+ * parameter. Consumers who don't pass a config still get a working — but
+ * loosely-typed — client.
+ */
+export declare class PrentaClient<Config extends PrentaConfigLike = PrentaConfigLike> {
+    readonly url: string;
+    readonly apiKey?: string;
+    private readonly fetchImpl;
+    private readonly defaultCache?;
+    private readonly extraHeaders?;
+    constructor(opts: PrentaClientOptions);
+    private headers;
+    private request;
+    /**
+     * List documents in a collection. Returns `{ docs, total, page, pageSize, totalPages }`.
+     *
+     * @example
+     *   const { docs } = await client.list('posts', { status: 'PUBLISHED' })
+     */
+    list<Slug extends keyof NonNullable<Config['collections']> & string>(collection: Slug, query?: ListQuery, init?: {
+        signal?: AbortSignal;
+        cache?: PrentaClientOptions['defaultCache'];
+    }): Promise<PrentaList<CollectionData<Config, Slug>>>;
+    /** Fetch a single document by ID. */
+    get<Slug extends keyof NonNullable<Config['collections']> & string>(collection: Slug, id: string, init?: {
+        populate?: string;
+        signal?: AbortSignal;
+        cache?: PrentaClientOptions['defaultCache'];
+    }): Promise<PrentaDocument<CollectionData<Config, Slug>>>;
+    /** Resolve a public URL path (e.g. `/blog/my-post`) to its document. */
+    resolve(path: string, init?: {
+        signal?: AbortSignal;
+        cache?: PrentaClientOptions['defaultCache'];
+    }): Promise<PrentaDocument | null>;
+    /** Fetch a global by slug. */
+    global<Slug extends keyof NonNullable<Config['globals']> & string>(slug: Slug, init?: {
+        signal?: AbortSignal;
+        cache?: PrentaClientOptions['defaultCache'];
+    }): Promise<GlobalData<Config, Slug>>;
+    /**
+     * List media assets. Returns the canonical `{ docs, total, page, pageSize,
+     * totalPages }` envelope (same shape as {@link PrentaClient.list}).
+     *
+     * The `GET /media` endpoint returns the asset array under `items`/`data`
+     * (never `docs`), plus pagination fields. This method normalizes that into
+     * the standard list contract so callers can destructure `{ docs }` exactly
+     * like collection lists.
+     */
+    listMedia(query?: {
+        page?: number;
+        pageSize?: number;
+        search?: string;
+    }, init?: {
+        signal?: AbortSignal;
+        cache?: PrentaClientOptions['defaultCache'];
+    }): Promise<MediaList>;
+}
+/**
+ * Tag-helper for `next/cache` `revalidateTag` calls. Returns the canonical
+ * tag the SDK applies for a given collection, global, single document, or
+ * resolved path.
+ *
+ * The full tag taxonomy is documented in {@link prentaTags}.
+ */
+export declare function prentaTag(kind: 'collection' | 'global' | 'doc' | 'path', slug: string): string;
+/**
+ * Canonical cache-tag set the SDK emits on a given request. Exported so
+ * consumers can call `revalidateTag()` from a webhook handler with the
+ * exact same tags the SDK uses for reads.
+ *
+ * Tag taxonomy:
+ *
+ * - `prenta` — the always-on global tag (added on every request). A
+ *   single `revalidateTag('prenta')` blows away the entire CMS cache.
+ *   Use sparingly — most invalidations should be narrower.
+ * - `prenta:collection:<slug>` — list responses for `<slug>`. Invalidate
+ *   when any document in the collection is created, updated, or deleted.
+ * - `prenta:doc:<id>` — single-document responses. Invalidate when that
+ *   specific document is updated or deleted.
+ * - `prenta:global:<slug>` — global responses for `<slug>`. Invalidate
+ *   when the global is updated.
+ * - `prenta:path:<path>` — `resolve(path)` responses. Tagged on read but
+ *   the server does not currently invalidate these automatically; if you
+ *   move a document or change a slug, invalidate the affected path tag
+ *   from your own webhook handler.
+ *
+ * @example
+ *   // In a Next.js webhook handler:
+ *   import { prentaTags } from '@prenta/client'
+ *   import { revalidateTag } from 'next/cache'
+ *   for (const t of prentaTags('collection', event.collection)) {
+ *     revalidateTag(t)
+ *   }
+ */
+export declare function prentaTags(kind: 'collection', slug: string): string[];
+export declare function prentaTags(kind: 'doc', collectionSlug: string, id: string): string[];
+export declare function prentaTags(kind: 'global', slug: string): string[];
+export declare function prentaTags(kind: 'path', path: string): string[];
+export declare function prentaTags(kind: 'all'): string[];
+/**
+ * Convenience factory. Equivalent to `new PrentaClient(opts)` but reads
+ * nicely as `const cms = createClient<typeof config>({...})`.
+ */
+export declare function createClient<Config extends PrentaConfigLike = PrentaConfigLike>(opts: PrentaClientOptions): PrentaClient<Config>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,269 @@
+export class PrentaError extends Error {
+    status;
+    response;
+    constructor(message, status, response) {
+        super(message);
+        this.name = 'PrentaError';
+        this.status = status;
+        this.response = response;
+    }
+}
+/**
+ * Merge a per-call cache override with the client's default cache config
+ * and a set of canonical per-resource tags the SDK always wants on the
+ * request. Order matters for readability but not for behaviour — the
+ * fetch cache treats the tag list as a set.
+ *
+ * Returns `undefined` when there's nothing to merge so callers can keep
+ * `cache:` off the request init entirely on runtimes that don't
+ * understand Next.js fetch extensions.
+ */
+function mergeTags(perCall, client, resourceTags) {
+    // The per-call override wins on `revalidate` because callers
+    // legitimately need to bypass caching for one-off invalidation reads.
+    const revalidate = perCall?.revalidate ?? client?.revalidate;
+    // `revalidate: false` (= no-store) means "don't cache at all", so emitting
+    // tags would be misleading. Honour the bypass.
+    if (revalidate === false) {
+        return { revalidate: false };
+    }
+    // The wholesale `prenta` tag is always included so a single
+    // `revalidateTag('prenta')` from a panic-button webhook still
+    // invalidates every SDK-tagged response, regardless of whether the
+    // user opted into the Next.js entrypoint defaults.
+    const merged = new Set(['prenta']);
+    for (const t of resourceTags)
+        merged.add(t);
+    if (client?.tags)
+        for (const t of client.tags)
+            merged.add(t);
+    if (perCall?.tags)
+        for (const t of perCall.tags)
+            merged.add(t);
+    const out = {};
+    if (typeof revalidate === 'number')
+        out.revalidate = revalidate;
+    out.tags = Array.from(merged);
+    return out;
+}
+/**
+ * Type-safe **read / delivery** client for the Prenta CMS REST API.
+ *
+ * Scope (deliberate): this SDK is **read-only**. It covers the public
+ * delivery surface — `list`, `get`, `getGlobal`, `resolve`, `listMedia`,
+ * plus the React/Next cache helpers — for fetching published content into a
+ * frontend. It intentionally ships **no** create/update/delete/publish or
+ * upload methods.
+ *
+ * **Authoring belongs to agents and tooling, not the delivery SDK.** To
+ * create or mutate content programmatically, drive the CMS over **MCP**
+ * (`@prenta/mcp-server`) or call the authenticated HTTP API directly
+ * (`POST/PUT/DELETE /api/cms/collections/:slug`, `/media/upload`, …). Keeping
+ * authoring out of this package keeps the delivery bundle small, its API key
+ * scoped to `read`, and the write surface auditable in one place.
+ *
+ * The class is generic over a config type so consumers get field-level
+ * autocomplete when they pass their `typeof prentaConfig` as the type
+ * parameter. Consumers who don't pass a config still get a working — but
+ * loosely-typed — client.
+ */
+export class PrentaClient {
+    url;
+    apiKey;
+    fetchImpl;
+    defaultCache;
+    extraHeaders;
+    constructor(opts) {
+        if (!opts.url)
+            throw new Error('PrentaClient: `url` is required');
+        this.url = opts.url.replace(/\/+$/, '');
+        this.apiKey = opts.apiKey;
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+        this.defaultCache = opts.defaultCache;
+        this.extraHeaders = opts.headers;
+    }
+    headers(extra) {
+        return {
+            Accept: 'application/json',
+            ...(this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}),
+            ...this.extraHeaders,
+            ...extra,
+        };
+    }
+    async request(method, path, init) {
+        let target = `${this.url}/api/cms${path}`;
+        if (init?.query) {
+            const params = new URLSearchParams();
+            for (const [k, v] of Object.entries(init.query)) {
+                if (v !== undefined)
+                    params.set(k, String(v));
+            }
+            const q = params.toString();
+            if (q)
+                target += `?${q}`;
+        }
+        const fetchInit = {
+            method,
+            headers: this.headers(init?.body ? { 'Content-Type': 'application/json' } : undefined),
+            signal: init?.signal,
+        };
+        if (init?.body !== undefined) {
+            fetchInit.body = JSON.stringify(init.body);
+        }
+        const cache = init?.cache ?? this.defaultCache;
+        if (cache) {
+            if (cache.revalidate === false) {
+                ;
+                fetchInit.cache = 'no-store';
+            }
+            else if (typeof cache.revalidate === 'number' || cache.tags) {
+                // Next.js fetch extensions are ignored by other runtimes, which is
+                // safe — they're additive metadata.
+                fetchInit.next = {
+                    ...(typeof cache.revalidate === 'number' ? { revalidate: cache.revalidate } : {}),
+                    ...(cache.tags ? { tags: cache.tags } : {}),
+                };
+            }
+        }
+        const res = await this.fetchImpl(target, fetchInit);
+        const text = await res.text();
+        let parsed = null;
+        if (text) {
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                // non-JSON body — keep raw text for the error.
+            }
+        }
+        if (!res.ok) {
+            const msg = parsed?.error ?? `${method} ${path} failed: ${res.status}`;
+            throw new PrentaError(msg, res.status, parsed ?? text);
+        }
+        return parsed;
+    }
+    // ─── Collections ─────────────────────────────────────────────────────
+    /**
+     * List documents in a collection. Returns `{ docs, total, page, pageSize, totalPages }`.
+     *
+     * @example
+     *   const { docs } = await client.list('posts', { status: 'PUBLISHED' })
+     */
+    list(collection, query, init) {
+        const flatFilters = {};
+        if (query?.filters) {
+            for (const [k, v] of Object.entries(query.filters)) {
+                flatFilters[`filter.${k}`] = v;
+            }
+        }
+        return this.request('GET', `/collections/${encodeURIComponent(collection)}`, {
+            query: {
+                page: query?.page,
+                pageSize: query?.pageSize,
+                status: query?.status,
+                locale: query?.locale,
+                search: query?.search,
+                populate: query?.populate,
+                sort: query?.sort,
+                ...flatFilters,
+            },
+            signal: init?.signal,
+            cache: mergeTags(init?.cache, this.defaultCache, [`prenta:collection:${collection}`]),
+        }).then((r) => r.data);
+    }
+    /** Fetch a single document by ID. */
+    get(collection, id, init) {
+        return this.request('GET', `/collections/${encodeURIComponent(collection)}/${encodeURIComponent(id)}`, {
+            query: init?.populate ? { populate: init.populate } : undefined,
+            signal: init?.signal,
+            cache: mergeTags(init?.cache, this.defaultCache, [
+                `prenta:collection:${collection}`,
+                `prenta:doc:${id}`,
+            ]),
+        }).then((r) => r.data);
+    }
+    /** Resolve a public URL path (e.g. `/blog/my-post`) to its document. */
+    async resolve(path, init) {
+        try {
+            const response = await this.request('GET', '/resolve', {
+                query: { path },
+                signal: init?.signal,
+                cache: mergeTags(init?.cache, this.defaultCache, [`prenta:path:${path}`]),
+            });
+            return response.data;
+        }
+        catch (err) {
+            if (err instanceof PrentaError && err.status === 404)
+                return null;
+            throw err;
+        }
+    }
+    // ─── Globals ─────────────────────────────────────────────────────────
+    /** Fetch a global by slug. */
+    global(slug, init) {
+        return this.request('GET', `/globals/${encodeURIComponent(slug)}`, {
+            signal: init?.signal,
+            cache: mergeTags(init?.cache, this.defaultCache, [`prenta:global:${slug}`]),
+        }).then((r) => r.data);
+    }
+    // ─── Media ───────────────────────────────────────────────────────────
+    /**
+     * List media assets. Returns the canonical `{ docs, total, page, pageSize,
+     * totalPages }` envelope (same shape as {@link PrentaClient.list}).
+     *
+     * The `GET /media` endpoint returns the asset array under `items`/`data`
+     * (never `docs`), plus pagination fields. This method normalizes that into
+     * the standard list contract so callers can destructure `{ docs }` exactly
+     * like collection lists.
+     */
+    listMedia(query, init) {
+        return this.request('GET', '/media', {
+            query: query,
+            signal: init?.signal,
+            cache: mergeTags(init?.cache, this.defaultCache, ['prenta:collection:media']),
+        }).then((r) => {
+            const envelope = r.data ?? {};
+            const docs = envelope.items ?? envelope.data ?? [];
+            const total = envelope.total ?? docs.length;
+            const page = envelope.page ?? query?.page ?? 1;
+            const pageSize = envelope.pageSize ?? query?.pageSize ?? docs.length;
+            const totalPages = envelope.totalPages ?? (pageSize > 0 ? Math.ceil(total / pageSize) : 1);
+            return { docs, total, page, pageSize, totalPages };
+        });
+    }
+}
+/**
+ * Tag-helper for `next/cache` `revalidateTag` calls. Returns the canonical
+ * tag the SDK applies for a given collection, global, single document, or
+ * resolved path.
+ *
+ * The full tag taxonomy is documented in {@link prentaTags}.
+ */
+export function prentaTag(kind, slug) {
+    return `prenta:${kind}:${slug}`;
+}
+export function prentaTags(kind, slugOrPath, id) {
+    // Every tag set includes `prenta` so a wholesale invalidation always
+    // works as a last resort. Narrower tags are appended after.
+    const base = ['prenta'];
+    if (kind === 'all')
+        return base;
+    if (kind === 'doc') {
+        if (!slugOrPath || !id) {
+            throw new Error("prentaTags('doc', collectionSlug, id) requires both arguments");
+        }
+        return [...base, `prenta:collection:${slugOrPath}`, `prenta:doc:${id}`];
+    }
+    if (slugOrPath === undefined) {
+        throw new Error(`prentaTags('${kind}', slug) requires a slug`);
+    }
+    return [...base, `prenta:${kind}:${slugOrPath}`];
+}
+/**
+ * Convenience factory. Equivalent to `new PrentaClient(opts)` but reads
+ * nicely as `const cms = createClient<typeof config>({...})`.
+ */
+export function createClient(opts) {
+    return new PrentaClient(opts);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/next.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Next.js server helpers for the Prenta client SDK.
+ *
+ * These are thin wrappers around `PrentaClient` that default to
+ * Next-friendly cache semantics. Use them inside Server Components,
+ * Route Handlers, or `generateStaticParams` for tag-based revalidation
+ * to play nicely with Prenta webhooks.
+ *
+ * On non-Next runtimes (e.g. Hono, Bun, Cloudflare Workers) the same
+ * methods work — the `next` fetch options become inert metadata.
+ */
+import { PrentaClient } from './index.js';
+import type { PrentaClientOptions, PrentaDocument } from './index.js';
+import type { PrentaConfigLike, CollectionData, GlobalData } from './types.js';
+export interface NextPrentaClientOptions extends PrentaClientOptions {
+    /** Default revalidation seconds for every request. Pass `false` for `cache: 'no-store'`. */
+    revalidate?: number | false;
+    /**
+     * Default cache tags applied to every request. Use with
+     * `revalidateTag()` from `next/cache` to invalidate from webhooks.
+     * Defaults to `['prenta']` so a single `revalidateTag('prenta')`
+     * call invalidates the whole CMS layer.
+     */
+    tags?: string[];
+}
+/**
+ * Build an Prenta client preconfigured for Next.js fetch semantics.
+ *
+ * @example
+ *   // app/lib/cms.ts
+ *   import { createNextClient } from '@prenta/client/next'
+ *   import type config from '@/prenta.config'
+ *   export const cms = createNextClient<typeof config>({
+ *     url: process.env.PRENTA_URL!,
+ *     apiKey: process.env.PRENTA_API_KEY,
+ *     revalidate: 60,
+ *     tags: ['prenta'],
+ *   })
+ */
+export declare function createNextClient<Config extends PrentaConfigLike = PrentaConfigLike>(opts: NextPrentaClientOptions): PrentaClient<Config>;
+/**
+ * Quick-helper to fetch a single document by URL path inside a Server
+ * Component. Returns `null` when no document matches the path.
+ *
+ * @remarks Thin re-export of {@link PrentaClient.resolve} kept for
+ * Server-Component ergonomics (you can pass the client as the first arg
+ * without wrapping in a closure). `client.resolve()` already returns
+ * `null` on 404 as of `@prenta/client@0.2.1`, so this helper does
+ * not catch any additional errors — non-404 failures still throw, which
+ * is what you want inside Server Components (Next.js renders a 500).
+ */
+export declare function resolvePagePath<Config extends PrentaConfigLike>(client: PrentaClient<Config>, path: string): Promise<PrentaDocument | null>;
+export type { PrentaClientOptions, PrentaDocument, PrentaList } from './index.js';
+export { PrentaClient, PrentaError, prentaTag, prentaTags, createClient } from './index.js';
+export type CollectionDataOf<Config extends PrentaConfigLike, Slug extends keyof NonNullable<Config['collections']> & string> = CollectionData<Config, Slug>;
+export type GlobalDataOf<Config extends PrentaConfigLike, Slug extends keyof NonNullable<Config['globals']> & string> = GlobalData<Config, Slug>;
+export type { ListQuery, CollectionData, GlobalData } from './types.js';
+//# sourceMappingURL=next.d.ts.map

package/dist/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../src/next.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAAgB,MAAM,YAAY,CAAA;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAc,MAAM,YAAY,CAAA;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAa,MAAM,YAAY,CAAA;AAEzF,MAAM,WAAW,uBAAwB,SAAQ,mBAAmB;IAClE,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC3B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,SAAS,gBAAgB,GAAG,gBAAgB,EACjF,IAAI,EAAE,uBAAuB,GAC5B,YAAY,CAAC,MAAM,CAAC,CAUtB;AAOD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,SAAS,gBAAgB,EAC7D,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,EAC5B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAEhC;AAGD,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACjF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAG3F,MAAM,MAAM,gBAAgB,CAC1B,MAAM,SAAS,gBAAgB,EAC/B,IAAI,SAAS,MAAM,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,MAAM,IAC5D,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;AAEhC,MAAM,MAAM,YAAY,CACtB,MAAM,SAAS,gBAAgB,EAC/B,IAAI,SAAS,MAAM,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,MAAM,IACxD,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;AAE5B,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA"}

package/dist/next.js

@@ -0,0 +1,57 @@
+/**
+ * Next.js server helpers for the Prenta client SDK.
+ *
+ * These are thin wrappers around `PrentaClient` that default to
+ * Next-friendly cache semantics. Use them inside Server Components,
+ * Route Handlers, or `generateStaticParams` for tag-based revalidation
+ * to play nicely with Prenta webhooks.
+ *
+ * On non-Next runtimes (e.g. Hono, Bun, Cloudflare Workers) the same
+ * methods work — the `next` fetch options become inert metadata.
+ */
+import { createClient } from './index.js';
+/**
+ * Build an Prenta client preconfigured for Next.js fetch semantics.
+ *
+ * @example
+ *   // app/lib/cms.ts
+ *   import { createNextClient } from '@prenta/client/next'
+ *   import type config from '@/prenta.config'
+ *   export const cms = createNextClient<typeof config>({
+ *     url: process.env.PRENTA_URL!,
+ *     apiKey: process.env.PRENTA_API_KEY,
+ *     revalidate: 60,
+ *     tags: ['prenta'],
+ *   })
+ */
+export function createNextClient(opts) {
+    const { revalidate, tags, ...rest } = opts;
+    return createClient({
+        ...rest,
+        defaultCache: {
+            ...(typeof revalidate === 'number' ? { revalidate } : {}),
+            ...(revalidate === false ? { revalidate: false } : {}),
+            tags: tags ?? ['prenta'],
+        },
+    });
+}
+// Tag helpers (`prentaTag`, `prentaTags`) live in `./index.js` so they're
+// importable from runtimes that don't pull in this Next-specific entrypoint.
+// They are re-exported below for ergonomics — using
+// `@prenta/client/next` in app code keeps a single import surface.
+/**
+ * Quick-helper to fetch a single document by URL path inside a Server
+ * Component. Returns `null` when no document matches the path.
+ *
+ * @remarks Thin re-export of {@link PrentaClient.resolve} kept for
+ * Server-Component ergonomics (you can pass the client as the first arg
+ * without wrapping in a closure). `client.resolve()` already returns
+ * `null` on 404 as of `@prenta/client@0.2.1`, so this helper does
+ * not catch any additional errors — non-404 failures still throw, which
+ * is what you want inside Server Components (Next.js renders a 500).
+ */
+export function resolvePagePath(client, path) {
+    return client.resolve(path);
+}
+export { PrentaClient, PrentaError, prentaTag, prentaTags, createClient } from './index.js';
+//# sourceMappingURL=next.js.map

package/dist/next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.js","sourceRoot":"","sources":["../src/next.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAgB,YAAY,EAAE,MAAM,YAAY,CAAA;AAgBvD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAA6B;IAE7B,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;IAC1C,OAAO,YAAY,CAAS;QAC1B,GAAG,IAAI;QACP,YAAY,EAAE;YACZ,GAAG,CAAC,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC;SACzB;KACF,CAAC,CAAA;AACJ,CAAC;AAED,0EAA0E;AAC1E,6EAA6E;AAC7E,oDAAoD;AACpD,mEAAmE;AAEnE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA4B,EAC5B,IAAY;IAEZ,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AAC7B,CAAC;AAID,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/react.d.ts

@@ -0,0 +1,32 @@
+import type { PrentaClient, PrentaClientOptions, PrentaDocument, PrentaList } from './index.js';
+import type { PrentaConfigLike, CollectionData, GlobalData, ListQuery } from './types.js';
+export interface UseQueryResult<T> {
+    data: T | undefined;
+    error: Error | undefined;
+    isLoading: boolean;
+    /** Manually re-run the query. Useful for mutations + refetch flows. */
+    refetch: () => void;
+}
+interface BaseHookOptions {
+    /** Skip fetching when false. Lets consumers conditionally enable a hook. */
+    enabled?: boolean;
+}
+/**
+ * Lightweight client-side hook for a collection list. We deliberately keep
+ * this dependency-free (no SWR/React Query) so the SDK stays embeddable in
+ * any React app. Consumers who want richer caching can call the underlying
+ * client methods directly inside their preferred data-fetching library.
+ */
+export declare function useCollection<Config extends PrentaConfigLike, Slug extends keyof NonNullable<Config['collections']> & string>(client: PrentaClient<Config>, collection: Slug, query?: ListQuery, opts?: BaseHookOptions): UseQueryResult<PrentaList<CollectionData<Config, Slug>>>;
+/**
+ * Fetch a single document by ID. Pass `null`/`undefined` for the id to
+ * disable the hook (no fetch happens until a real id is supplied).
+ */
+export declare function useContent<Config extends PrentaConfigLike, Slug extends keyof NonNullable<Config['collections']> & string>(client: PrentaClient<Config>, collection: Slug, id: string | null | undefined, init?: {
+    populate?: string;
+} & BaseHookOptions): UseQueryResult<PrentaDocument<CollectionData<Config, Slug>>>;
+/** Fetch a global by slug. */
+export declare function useGlobal<Config extends PrentaConfigLike, Slug extends keyof NonNullable<Config['globals']> & string>(client: PrentaClient<Config>, slug: Slug, opts?: BaseHookOptions): UseQueryResult<GlobalData<Config, Slug>>;
+export { PrentaClient, createClient, PrentaError } from './index.js';
+export type { PrentaClientOptions };
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC/F,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEzF,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,GAAG,SAAS,CAAA;IACnB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,uEAAuE;IACvE,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,UAAU,eAAe;IACvB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,MAAM,SAAS,gBAAgB,EAC/B,IAAI,SAAS,MAAM,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,MAAM,EAE9D,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,EAC5B,UAAU,EAAE,IAAI,EAChB,KAAK,CAAC,EAAE,SAAS,EACjB,IAAI,CAAC,EAAE,eAAe,GACrB,cAAc,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CA2C1D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,SAAS,gBAAgB,EAC/B,IAAI,SAAS,MAAM,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,MAAM,EAE9D,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,EAC5B,UAAU,EAAE,IAAI,EAChB,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC7B,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,GAC7C,cAAc,CAAC,cAAc,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAqD9D;AAED,8BAA8B;AAC9B,wBAAgB,SAAS,CACvB,MAAM,SAAS,gBAAgB,EAC/B,IAAI,SAAS,MAAM,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,MAAM,EAE1D,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,EAC5B,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE,eAAe,GACrB,cAAc,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CA2C1C;AAGD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACpE,YAAY,EAAE,mBAAmB,EAAE,CAAA"}

package/dist/react.js

@@ -0,0 +1,156 @@
+'use client';
+import { useEffect, useRef, useState } from 'react';
+/**
+ * Lightweight client-side hook for a collection list. We deliberately keep
+ * this dependency-free (no SWR/React Query) so the SDK stays embeddable in
+ * any React app. Consumers who want richer caching can call the underlying
+ * client methods directly inside their preferred data-fetching library.
+ */
+export function useCollection(client, collection, query, opts) {
+    const [data, setData] = useState(undefined);
+    const [error, setError] = useState(undefined);
+    const [isLoading, setIsLoading] = useState(opts?.enabled !== false);
+    const versionRef = useRef(0);
+    const key = JSON.stringify({ collection, query, enabled: opts?.enabled ?? true });
+    const run = () => {
+        if (opts?.enabled === false) {
+            setIsLoading(false);
+            return;
+        }
+        const controller = new AbortController();
+        versionRef.current += 1;
+        const version = versionRef.current;
+        setIsLoading(true);
+        setError(undefined);
+        client
+            .list(collection, query, { signal: controller.signal })
+            .then((result) => {
+            if (version !== versionRef.current)
+                return;
+            setData(result);
+        })
+            .catch((err) => {
+            if (controller.signal.aborted)
+                return;
+            if (version !== versionRef.current)
+                return;
+            setError(err instanceof Error ? err : new Error(String(err)));
+        })
+            .finally(() => {
+            if (version !== versionRef.current)
+                return;
+            setIsLoading(false);
+        });
+        return () => controller.abort();
+    };
+    useEffect(() => {
+        const cleanup = run();
+        return cleanup;
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [key]);
+    return { data, error, isLoading, refetch: run };
+}
+/**
+ * Fetch a single document by ID. Pass `null`/`undefined` for the id to
+ * disable the hook (no fetch happens until a real id is supplied).
+ */
+export function useContent(client, collection, id, init) {
+    const [data, setData] = useState(undefined);
+    const [error, setError] = useState(undefined);
+    const [isLoading, setIsLoading] = useState(Boolean(id) && init?.enabled !== false);
+    const versionRef = useRef(0);
+    const key = JSON.stringify({
+        collection,
+        id,
+        populate: init?.populate,
+        enabled: init?.enabled ?? true,
+    });
+    const run = () => {
+        if (!id || init?.enabled === false) {
+            setIsLoading(false);
+            return;
+        }
+        const controller = new AbortController();
+        versionRef.current += 1;
+        const version = versionRef.current;
+        setIsLoading(true);
+        setError(undefined);
+        client
+            .get(collection, id, {
+            ...(init?.populate ? { populate: init.populate } : {}),
+            signal: controller.signal,
+        })
+            .then((doc) => {
+            if (version !== versionRef.current)
+                return;
+            setData(doc);
+        })
+            .catch((err) => {
+            if (controller.signal.aborted)
+                return;
+            if (version !== versionRef.current)
+                return;
+            setError(err instanceof Error ? err : new Error(String(err)));
+        })
+            .finally(() => {
+            if (version !== versionRef.current)
+                return;
+            setIsLoading(false);
+        });
+        return () => controller.abort();
+    };
+    useEffect(() => {
+        const cleanup = run();
+        return cleanup;
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [key]);
+    return { data, error, isLoading, refetch: run };
+}
+/** Fetch a global by slug. */
+export function useGlobal(client, slug, opts) {
+    const [data, setData] = useState(undefined);
+    const [error, setError] = useState(undefined);
+    const [isLoading, setIsLoading] = useState(opts?.enabled !== false);
+    const versionRef = useRef(0);
+    const key = JSON.stringify({ slug, enabled: opts?.enabled ?? true });
+    const run = () => {
+        if (opts?.enabled === false) {
+            setIsLoading(false);
+            return;
+        }
+        const controller = new AbortController();
+        versionRef.current += 1;
+        const version = versionRef.current;
+        setIsLoading(true);
+        setError(undefined);
+        client
+            .global(slug, { signal: controller.signal })
+            .then((result) => {
+            if (version !== versionRef.current)
+                return;
+            setData(result);
+        })
+            .catch((err) => {
+            if (controller.signal.aborted)
+                return;
+            if (version !== versionRef.current)
+                return;
+            setError(err instanceof Error ? err : new Error(String(err)));
+        })
+            .finally(() => {
+            if (version !== versionRef.current)
+                return;
+            setIsLoading(false);
+        });
+        return () => controller.abort();
+    };
+    useEffect(() => {
+        const cleanup = run();
+        return cleanup;
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [key]);
+    return { data, error, isLoading, refetch: run };
+}
+// Re-export the parent module so consumers can `import { useContent, createClient } from '@prenta/client/react'`.
+export { PrentaClient, createClient, PrentaError } from './index.js';
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Type system for the Prenta client SDK.
+ *
+ * The key trick: callers pass their `prenta.config.ts` as a generic type
+ * parameter to `createClient<typeof config>()`. The SDK then surfaces a
+ * typed `client.<collection>` accessor where every field's TS type is
+ * derived from the config. No codegen, no `prenta.types.d.ts` file —
+ * the user's source of truth is the config itself.
+ *
+ * If a consumer can't (or won't) pass their config, the client falls back
+ * to a generic `Record<string, unknown>` shape so calls still type-check.
+ */
+export interface PrentaFieldDefinition {
+    type: string;
+    required?: boolean;
+    defaultValue?: unknown;
+    options?: Array<{
+        value: string;
+        label?: string;
+    }> | readonly string[];
+    fields?: Record<string, PrentaFieldDefinition>;
+    relationTo?: string;
+}
+/** Map a single field's declared `type` to the corresponding TypeScript type. */
+export type FieldToType<F extends PrentaFieldDefinition> = F['type'] extends 'text' | 'richText' | 'slug' | 'url' | 'email' | 'color' | 'date' ? string : F['type'] extends 'number' ? number : F['type'] extends 'boolean' ? boolean : F['type'] extends 'json' ? unknown : F['type'] extends 'select' ? F extends {
+    options: ReadonlyArray<{
+        value: infer V;
+    }>;
+} ? V : F extends {
+    options: readonly string[];
+} ? F['options'][number] : string : F['type'] extends 'relationship' ? string : F['type'] extends 'media' ? {
+    id: string;
+    url: string;
+    alt?: string;
+} : F['type'] extends 'array' ? F extends {
+    fields: infer SF extends Record<string, PrentaFieldDefinition>;
+} ? Array<FieldsToData<SF>> : unknown[] : F['type'] extends 'blocks' ? Array<Record<string, unknown>> : unknown;
+/** Map a fields record to the `data` shape persisted for that collection. */
+export type FieldsToData<F extends Record<string, PrentaFieldDefinition>> = {
+    [K in keyof F]?: FieldToType<F[K]>;
+};
+/**
+ * Document lifecycle status. Mirrors the `DocumentStatus` enum in cms-core's
+ * Prisma schema — keep these in sync (an exhaustive `switch` on the client side
+ * must handle every value the server can return, including `SCHEDULED_UNPUBLISH`).
+ */
+export type PrentaDocumentStatus = 'DRAFT' | 'PUBLISHED' | 'ARCHIVED' | 'SCHEDULED' | 'SCHEDULED_UNPUBLISH';
+/** The wire shape of a single document returned by the CMS. */
+export interface PrentaDocument<TData = Record<string, unknown>> {
+    id: string;
+    collection: string;
+    status: PrentaDocumentStatus;
+    title?: string;
+    slug?: string;
+    locale?: string;
+    data: TData;
+    publishedAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    /** Page-builder collections additionally carry a `layout` + `pageSettings`. */
+    layout?: unknown;
+    pageSettings?: Record<string, unknown>;
+}
+/** Pagination envelope for list endpoints. */
+export interface PrentaList<TData = Record<string, unknown>> {
+    docs: Array<PrentaDocument<TData>>;
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+}
+/**
+ * A media asset as returned by `GET /media`. The server normalizes each row
+ * (see `normalizeMediaItem` in cms-core) into these stable fields. Extra
+ * provider/columns are passed through, so the index signature stays open.
+ */
+export interface MediaAsset {
+    id: string;
+    /** Original filename (also exposed as `filename`). */
+    name: string;
+    filename?: string;
+    /** MIME type (also exposed as `mimeType`). */
+    type: string;
+    mimeType?: string;
+    /** Human-readable size (e.g. "1.2 MB"); `sizeBytes` is the raw byte count. */
+    size: string;
+    sizeBytes: number;
+    /** Public URL of the asset. */
+    url: string;
+    width?: number | null;
+    height?: number | null;
+    dimensions?: string;
+    format?: string;
+    altTag: string;
+    title: string;
+    /** Documents that reference this asset. */
+    usedOn: Array<{
+        page: string;
+        path: string;
+    }>;
+    createdAt?: string;
+    updatedAt?: string;
+    [key: string]: unknown;
+}
+/**
+ * Pagination envelope for `GET /media`. Mirrors {@link PrentaList} (the
+ * `{ docs, total, page, pageSize, totalPages }` contract) so media lists are
+ * unwrapped the same way as collection lists.
+ */
+export interface MediaList {
+    docs: MediaAsset[];
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+}
+export interface PrentaConfigLike {
+    collections?: Record<string, {
+        fields: Record<string, PrentaFieldDefinition>;
+        type?: 'page' | 'post';
+    }>;
+    globals?: Record<string, {
+        fields: Record<string, PrentaFieldDefinition>;
+    }>;
+}
+/** Extract the data-shape for a given collection key from a config. */
+export type CollectionData<Config extends PrentaConfigLike, Slug extends keyof NonNullable<Config['collections']>> = FieldsToData<NonNullable<Config['collections']>[Slug]['fields']>;
+/** Extract the data-shape for a given global key from a config. */
+export type GlobalData<Config extends PrentaConfigLike, Slug extends keyof NonNullable<Config['globals']>> = FieldsToData<NonNullable<Config['globals']>[Slug]['fields']>;
+export interface ListQuery {
+    page?: number;
+    pageSize?: number;
+    status?: PrentaDocumentStatus;
+    locale?: string;
+    search?: string;
+    populate?: string;
+    /** Arbitrary filter columns the CMS allows (status, locale, folderId, …). */
+    filters?: Record<string, string | number | boolean>;
+    sort?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,14 @@
+/**
+ * Type system for the Prenta client SDK.
+ *
+ * The key trick: callers pass their `prenta.config.ts` as a generic type
+ * parameter to `createClient<typeof config>()`. The SDK then surfaces a
+ * typed `client.<collection>` accessor where every field's TS type is
+ * derived from the config. No codegen, no `prenta.types.d.ts` file —
+ * the user's source of truth is the config itself.
+ *
+ * If a consumer can't (or won't) pass their config, the client falls back
+ * to a generic `Record<string, unknown>` shape so calls still type-check.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@prenta/client",
+  "version": "0.6.0",
+  "license": "MIT",
+  "description": "Type-safe read/delivery client and React hooks for the Prenta CMS REST API (read-only; author content over MCP or the HTTP API).",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/actuate-media/prenta.git",
+    "directory": "packages/client"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "default": "./dist/react.js"
+    },
+    "./next": {
+      "types": "./dist/next.d.ts",
+      "import": "./dist/next.js",
+      "default": "./dist/next.js"
+    }
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "react": "^19.2.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.0"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "dev": "tsc --project tsconfig.json --watch --preserveWatchOutput",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist .turbo"
+  }
+}