@airdraft/content 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [0.1.5](https://github.com/aevrHQ/airdraft/compare/content@v0.1.4...content@v0.1.5) (2026-05-23)
+
+
+### Features
+
+* **auth:** implement server-side silent token refresh and extend refresh token TTL to 30 days ([2418571](https://github.com/aevrHQ/airdraft/commit/2418571ec2aa037995dc9b5eb94fb06f79c949b8))
+* **EntryDetail:** enhance component to support injected props and dynamic field resolution ([a65f19c](https://github.com/aevrHQ/airdraft/commit/a65f19c57c0f85ba6deb5d64b59592a82d614258))
+* **README:** add documentation for @airdraft/content functions and usage examples ([b43ab62](https://github.com/aevrHQ/airdraft/commit/b43ab621da781056a32de816547d2b1ba7421ed3))
+
+### [0.1.4](https://github.com/aevrHQ/airdraft/compare/content@v0.1.3...content@v0.1.4) (2026-05-23)
+
+
+### Bug Fixes
+
+* **build:** bump react-content peer dependencies ([9c33815](https://github.com/aevrHQ/airdraft/commit/9c338158eca40c418f5ad37e829b0a2f213a2e33))
+* move @airdraft/core to peerDependencies in all consumer-facing packages ([f7653ff](https://github.com/aevrHQ/airdraft/commit/f7653ffd7109cbe76f09df8766a70de1b24afdba))
+* **react-content:** entryCard children injection and sub-component auto-read ([a57cc48](https://github.com/aevrHQ/airdraft/commit/a57cc483b96986d5825e1c6d28a66c400bd57972))
+
 ### 0.1.3 (2026-05-23)
 
 

package/README.md

@@ -0,0 +1,143 @@
+# @airdraft/content
+
+Framework-agnostic pure functions for resolving and parsing Airdraft CMS content. No React required — safe to use in server actions, API routes, `generateMetadata`, middleware, or any non-React context.
+
+## Installation
+
+```bash
+npm install @airdraft/content
+```
+
+## Media / Image
+
+```ts
+import {
+  resolveMediaUrl,
+  resolveMediaUrls,
+  resolveImageDimensions,
+} from '@airdraft/content'
+```
+
+### `resolveMediaUrl(fieldName, data)`
+
+Resolves a single `media` or `image` field to a URL string.
+
+Resolution chain (first truthy wins):
+1. `data["{field}_media"].url` — managed media object URL
+2. `data["{field}_url"]` — raw URL stored alongside the key
+3. `data["{field}"]` as string — raw storage key, prefixed with `/` if relative
+
+```ts
+const url = resolveMediaUrl('cover', entry.data)
+// → 'https://cdn.example.com/covers/my-post.jpg' | undefined
+```
+
+Useful for `<meta property="og:image">`, `next/image` `src`, or any place you need the URL value rather than a rendered element.
+
+### `resolveMediaUrls(fieldName, data)`
+
+Resolves a `media` field with `multiple: true` to an array of URLs.
+
+Resolution chain:
+1. `data["{field}_medias"]` — injected `MediaItem[]` → extracts `.url` from each
+2. `data["{field}_urls"]` — injected `string[]`
+3. `data["{field}"]` — raw `string[]` or JSON-encoded `string[]`
+
+```ts
+const urls = resolveMediaUrls('gallery', entry.data)
+// → ['https://...', 'https://...']
+```
+
+### `resolveImageDimensions(fieldName, data)`
+
+Reads `width` and `height` from the `{field}_media` sidecar object. Returns `undefined` when the media object is absent or has no dimension data.
+
+```ts
+const dims = resolveImageDimensions('cover', entry.data)
+// → { width: 1200, height: 630 } | undefined
+```
+
+Combine with `resolveMediaUrl` to pass explicit dimensions to `next/image` and avoid layout shift:
+
+```tsx
+const url  = resolveMediaUrl('cover', entry.data)
+const dims = resolveImageDimensions('cover', entry.data)
+
+// In a Next.js page / generateMetadata:
+return {
+  openGraph: { images: [{ url, ...dims }] },
+}
+
+// Or in a component:
+<Image src={url} alt="cover" width={dims?.width ?? 800} height={dims?.height ?? 450} />
+```
+
+### `resolveImageUrl` (alias)
+
+Legacy alias for `resolveMediaUrl`. Prefer `resolveMediaUrl` for new `media`-typed fields.
+
+---
+
+## Body / Rich-text
+
+```ts
+import { parseMarkdown, parseText } from '@airdraft/content'
+```
+
+### `parseMarkdown(text)`
+
+Parses a Markdown string to an HTML string via `marked`. Safe for use with `dangerouslySetInnerHTML` — content is CMS-authored, not user-supplied.
+
+```ts
+const html = parseMarkdown(entry.data.body)
+// → '<h1>Hello</h1><p>World</p>'
+```
+
+### `parseText(text)`
+
+Splits a plain `text` field into paragraphs (split on `\n\n`). Returns `string[]`. Useful when you want to render paragraphs manually without dangerouslySetInnerHTML.
+
+```ts
+const paragraphs = parseText(entry.data.excerpt)
+// → ['First paragraph.', 'Second paragraph.']
+```
+
+---
+
+## Relations
+
+```ts
+import { resolveRelation, resolveRelations } from '@airdraft/content'
+```
+
+### `resolveRelation(fieldName, data)`
+
+Resolves the display label for a single `relation` field. Handles both expanded entry objects (returned when `expand=true`) and raw slug strings.
+
+Label priority: `name` → `title` → `label` → `slug`.
+
+```ts
+const label = resolveRelation('author', entry.data)
+// → 'Jane Doe' | 'jane-doe' | null
+```
+
+### `resolveRelations(fieldName, data)`
+
+Same as `resolveRelation` but for `relations` (multi-relation) fields. Returns `string[]`.
+
+```ts
+const labels = resolveRelations('authors', entry.data)
+// → ['Jane Doe', 'John Smith']
+```
+
+---
+
+## Notes
+
+- All functions are synchronous and have no side effects.
+- `resolveImageUrl` / `resolveMediaUrl` / `resolveMediaUrls` are used internally by `@airdraft/react-content` field components. Call them directly when you need the resolved value in logic rather than in JSX.
+- `parseMarkdown` uses `marked` under the hood. To customise rendering (syntax highlighting, custom link targets, etc.) use the `render` prop on `<BodyField>` from `@airdraft/react-content` instead.
+
+## Changelog
+
+See [CHANGELOG.md](./CHANGELOG.md).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@airdraft/content",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Airdraft framework-agnostic content rendering utilities — URL resolution, Markdown parsing, relation helpers",
   "type": "module",
   "main": "./dist/index.js",