@jsondrop/drupal 0.0.0-stage → 0.1.1

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Valentino Međimorec
+
+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

@@ -1,3 +1,79 @@
-# Temporary Holding Version
+# @jsondrop/drupal
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Drupal 11 core entity types and helpers for
+[`@jsondrop/core`](../core).
+
+```sh
+npm install @jsondrop/core @jsondrop/drupal
+```
+
+## Types
+
+Importing the package registers Drupal core's resource types with the
+client:
+
+- fixed types: `user--user`, `file--file`, `menu_link_content--menu_link_content`,
+  `path_alias--path_alias`, and the config entities (`node_type`,
+  `taxonomy_vocabulary`, `media_type`, `user_role`, `block_content_type`);
+- per-entity-type fallbacks: any `node--*` is a `Node`, `taxonomy_term--*` a
+  `Term`, `media--*` a `Media`, `block_content--*` a `BlockContent`,
+  `paragraph--*` a `Paragraph`, typed with the base fields.
+
+Add your bundles' fields by extending them:
+
+```ts
+import type { ToMany, ToOne } from '@jsondrop/core';
+import type { File, ImageMeta, MediaImage, Node, Term, TextField } from '@jsondrop/drupal';
+
+export interface Article extends Node<'article'> {
+  body: TextField | null;
+  field_image: ToOne<File<ImageMeta>>;
+  field_tags: ToMany<Term<'tags'>>;
+  field_hero: ToOne<MediaImage>;
+}
+
+declare module '@jsondrop/core' {
+  interface ResourceTypes {
+    'node--article': Article;
+  }
+}
+```
+
+Field value types: `TextField`, `PathField`, `LinkField`, `FileUri`,
+`ImageMeta`, `FileMeta`, `DateRangeField`, `AddressField`.
+Standard-profile media types: `MediaImage`, `MediaDocument`, `MediaAudio`,
+`MediaVideo`, `MediaRemoteVideo`.
+
+## Helpers
+
+| Helper | Needs | |
+|---|---|---|
+| `translatePath(client, path)` | decoupled_router | Resolves a path; NULL when not found |
+| `getResourceByPath(client, path, options)` | decoupled_router | Resolves a path and fetches its entity, with redirects |
+| `getMenu(client, menu)` / `getMenuItems` | jsonapi_menu_items | A menu as a sorted tree / flat list |
+| `buildMenuTree(items)` | | Nests links by `parent`; also takes core `menu_link_content` |
+| `getView(client, view, display, { filters, arguments, sort, page })` | jsonapi_views | A view display's results and count |
+| `image(client, field)` | | An image field as `{ url, alt, title, width, height }` |
+| `fileUrl(client, file)` | | Absolute file URL |
+| `imageStyleUrl(file, style)` | consumer_image_styles | An image style derivative's URL |
+
+### Users
+
+| Helper | Needs | |
+|---|---|---|
+| `getCurrentUser(client)` / `getCurrentUserId` | | The logged-in user (any auth), from the entry point's `me` link; NULL when anonymous |
+| `login(client, { name, pass })` | | Drupal session login (`/user/login`), server-side: returns the session cookie, CSRF and logout tokens |
+| `logout(client, session)` | | Ends the session with its logout token |
+| `isLoggedIn(client, cookie)` | | Whether a session is still valid |
+| `requestPasswordReset(client, { mail })` | | Mails a reset link; same answer for unknown accounts |
+
+For OAuth logins (simple_oauth) see `OAuthClient` in
+`@jsondrop/core`. Both are shown in
+[example 7](../../examples/07-user-login.ts).
+
+```ts
+const page = await getResourceByPath<Article>(drupal, '/blog/hello', {
+  query: { include: ['field_image', 'field_tags'] },
+});
+if (!page?.resource) notFound();
+```

package/dist/account.d.ts

@@ -0,0 +1,65 @@
+import { type JsonApiClient, type ResourceRequestOptions } from '@jsondrop/core';
+import type { User } from './entities.js';
+/**
+ * The current user, from Drupal core alone: an authenticated request to the
+ * JSON:API entry point carries `meta.links.me` with the user's UUID. Works
+ * with any auth (OAuth bearer token, session cookie). NULL when anonymous.
+ *
+ * Two requests: the entry point, then the user (with `options`).
+ */
+export declare function getCurrentUser<T = User>(client: JsonApiClient, options?: ResourceRequestOptions): Promise<T | null>;
+/** The current user's UUID, or NULL when anonymous (one request). */
+export declare function getCurrentUserId(client: JsonApiClient, options?: Pick<ResourceRequestOptions, 'auth' | 'headers' | 'fetchOptions' | 'signal'>): Promise<string | null>;
+/**
+ * Cookie session login through Drupal core's `/user/login?_format=json`,
+ * for sites without simple_oauth. Server-side only: it reads the session
+ * cookie from `Set-Cookie`, which browsers hide from scripts.
+ *
+ * Keep `cookie` in an httpOnly cookie of your app (never hand Drupal's own
+ * cookie to the browser) and send it with `sessionCookie(cookie)` as auth.
+ * Keep `logoutToken` too: logging out needs it.
+ */
+export interface SessionLogin {
+    /** The session cookie as a `Cookie` header value (`SSESS…=…`). */
+    cookie: string;
+    /** The user as Drupal reports them; fields the user cannot view are absent. */
+    user: {
+        uid?: string;
+        name?: string;
+        roles?: string[];
+    };
+    /** For requests that need Drupal's CSRF token (`X-CSRF-Token`), e.g. core REST writes. */
+    csrfToken: string;
+    /** Pass to {@link logout}. */
+    logoutToken: string;
+}
+/**
+ * Logs in with a username and password. Wrong credentials and blocked
+ * accounts throw a 400; too many attempts (flood control) a 403 or 429.
+ * The error's `message` is Drupal's explanation.
+ */
+export declare function login(client: JsonApiClient, credentials: {
+    name: string;
+    pass: string;
+}): Promise<SessionLogin>;
+/** Ends the Drupal session (`/user/logout`, with the logout token from {@link login}). */
+export declare function logout(client: JsonApiClient, session: Pick<SessionLogin, 'cookie' | 'logoutToken'>): Promise<void>;
+/** Whether the session is still logged in (`/user/login_status`). */
+export declare function isLoggedIn(client: JsonApiClient, cookie: string): Promise<boolean>;
+/**
+ * A CSRF token (`/session/token`), for the `X-CSRF-Token` header that
+ * Drupal requires on writes to core REST resources (webform_rest, for
+ * one) when a session cookie authenticates them. Requests with a bearer
+ * token, or anonymous ones, do not need it.
+ */
+export declare function getCsrfToken(client: JsonApiClient, cookie?: string): Promise<string>;
+/**
+ * Mails a password reset link (`/user/password`). Answers the same whether
+ * or not the account exists, so it does not reveal accounts.
+ */
+export declare function requestPasswordReset(client: JsonApiClient, account: {
+    name: string;
+} | {
+    mail: string;
+}): Promise<void>;
+//# sourceMappingURL=account.d.ts.map

package/dist/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../src/account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAChG,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAG7H;AAED,qEAAqE;AACrE,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,QAAQ,CAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKhL;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,IAAI,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACxD,0FAA0F;IAC1F,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAID;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAarH;AAED,0FAA0F;AAC1F,wBAAsB,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAOxH;AAED,qEAAqE;AACrE,wBAAsB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASxF;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO1F;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAO7H"}

package/dist/account.js

@@ -0,0 +1,96 @@
+import { sessionCookie } from '@jsondrop/core';
+/**
+ * The current user, from Drupal core alone: an authenticated request to the
+ * JSON:API entry point carries `meta.links.me` with the user's UUID. Works
+ * with any auth (OAuth bearer token, session cookie). NULL when anonymous.
+ *
+ * Two requests: the entry point, then the user (with `options`).
+ */
+export async function getCurrentUser(client, options = {}) {
+    const id = await getCurrentUserId(client, options);
+    return id ? client.getResource('user--user', id, options) : null;
+}
+/** The current user's UUID, or NULL when anonymous (one request). */
+export async function getCurrentUserId(client, options = {}) {
+    const { auth, headers, fetchOptions, signal } = options;
+    const response = await client.request('GET', '', { auth, headers, fetchOptions, signal });
+    const me = response.meta.links?.me;
+    return me?.meta?.id ?? null;
+}
+const JSON_HEADERS = { 'Content-Type': 'application/json', Accept: 'application/json' };
+/**
+ * Logs in with a username and password. Wrong credentials and blocked
+ * accounts throw a 400; too many attempts (flood control) a 403 or 429.
+ * The error's `message` is Drupal's explanation.
+ */
+export async function login(client, credentials) {
+    const response = await client.post(client.siteUrl('/user/login'), credentials, {
+        auth: false,
+        query: { params: { _format: 'json' } },
+        headers: JSON_HEADERS,
+        parse: 'json',
+    });
+    const body = response.data ?? {};
+    const cookie = sessionCookieOf(response.headers);
+    if (!cookie) {
+        throw new Error('Drupal answered the login without a session cookie. Log in from the server, not the browser.');
+    }
+    return { cookie, user: body.current_user ?? {}, csrfToken: body.csrf_token ?? '', logoutToken: body.logout_token ?? '' };
+}
+/** Ends the Drupal session (`/user/logout`, with the logout token from {@link login}). */
+export async function logout(client, session) {
+    await client.post(client.siteUrl('/user/logout'), undefined, {
+        auth: sessionCookie(session.cookie),
+        query: { params: { _format: 'json', token: session.logoutToken } },
+        headers: JSON_HEADERS,
+        parse: 'json',
+    });
+}
+/** Whether the session is still logged in (`/user/login_status`). */
+export async function isLoggedIn(client, cookie) {
+    const response = await client.get(client.siteUrl('/user/login_status'), {
+        auth: sessionCookie(cookie),
+        query: { params: { _format: 'json' } },
+        headers: JSON_HEADERS,
+        parse: 'json',
+    });
+    // Drupal answers a bare `1` or `0`.
+    return Number(response.data) === 1;
+}
+/**
+ * A CSRF token (`/session/token`), for the `X-CSRF-Token` header that
+ * Drupal requires on writes to core REST resources (webform_rest, for
+ * one) when a session cookie authenticates them. Requests with a bearer
+ * token, or anonymous ones, do not need it.
+ */
+export async function getCsrfToken(client, cookie) {
+    const response = await client.get(client.siteUrl('/session/token'), {
+        auth: cookie ? sessionCookie(cookie) : false,
+        headers: { Accept: 'text/plain' },
+        parse: 'text',
+    });
+    return response.data.trim();
+}
+/**
+ * Mails a password reset link (`/user/password`). Answers the same whether
+ * or not the account exists, so it does not reveal accounts.
+ */
+export async function requestPasswordReset(client, account) {
+    await client.post(client.siteUrl('/user/password'), account, {
+        auth: false,
+        query: { params: { _format: 'json' } },
+        headers: JSON_HEADERS,
+        parse: 'json',
+    });
+}
+/** Drupal's session cookie(s) from a response, as a `Cookie` header value. */
+function sessionCookieOf(headers) {
+    const setCookies = typeof headers.getSetCookie === 'function'
+        ? headers.getSetCookie()
+        : (headers.get('set-cookie') ?? '').split(/,(?=\s*[^;,]+=)/);
+    const pairs = setCookies
+        .map((line) => line.split(';')[0]?.trim() ?? '')
+        .filter((pair) => /^S?SESS[^=]*=./.test(pair));
+    return pairs.length ? pairs.join('; ') : null;
+}
+//# sourceMappingURL=account.js.map

package/dist/account.js.map

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

package/dist/entities.d.ts

@@ -0,0 +1,205 @@
+import type { ResourceBase, ToMany, ToOne } from '@jsondrop/core';
+import type { DateTimeString, FileMeta, FileUri, ImageMeta, LinkField, PathField, TextField } from './fields.js';
+/**
+ * Drupal 11 core entity types, with the base fields JSON:API exposes.
+ *
+ * Bundle-specific fields are the project's: extend the generic types and
+ * register the bundle.
+ *
+ * ```ts
+ * interface Article extends Node<'article'> {
+ *   body: TextField | null;
+ *   field_image: ToOne<File<ImageMeta>>;
+ *   field_tags: ToMany<Term<'tags'>>;
+ * }
+ * declare module '@jsondrop/core' {
+ *   interface ResourceTypes { 'node--article': Article }
+ * }
+ * ```
+ *
+ * Fields hidden by access (an anonymous request sees no `mail`) or by
+ * JSON:API Extras are absent at runtime even where typed as required.
+ */
+/** Fields shared by revisionable, translatable content entities. */
+interface ContentEntity<TType extends string> extends ResourceBase<TType> {
+    langcode: string;
+    default_langcode?: boolean;
+    revision_translation_affected?: boolean | null;
+}
+export interface NodeType extends ResourceBase<'node_type--node_type'> {
+    drupal_internal__type: string;
+    name: string;
+    description: string | null;
+}
+export interface Vocabulary extends ResourceBase<'taxonomy_vocabulary--taxonomy_vocabulary'> {
+    drupal_internal__vid: string;
+    name: string;
+    description: string | null;
+}
+export interface MediaType extends ResourceBase<'media_type--media_type'> {
+    drupal_internal__id: string;
+    label: string;
+    description: string | null;
+}
+export interface Role extends ResourceBase<'user_role--user_role'> {
+    drupal_internal__id: string;
+    label: string;
+}
+export interface BlockContentType extends ResourceBase<'block_content_type--block_content_type'> {
+    drupal_internal__id: string;
+    label: string;
+}
+export interface User extends ContentEntity<'user--user'> {
+    drupal_internal__uid: number;
+    display_name: string;
+    name?: string;
+    mail?: string | null;
+    timezone?: string;
+    status?: boolean;
+    created?: DateTimeString;
+    changed?: DateTimeString;
+    access?: DateTimeString;
+    login?: DateTimeString | null;
+    preferred_langcode?: string;
+    roles?: ToMany<Role>;
+    user_picture?: ToOne<File<ImageMeta>>;
+}
+/**
+ * `file--file`. `TMeta` types the relationship meta it carries when reached
+ * through a field: {@link ImageMeta} for image fields.
+ */
+export interface File<TMeta extends object = Record<string, unknown>> extends ContentEntity<'file--file'> {
+    drupal_internal__fid: number;
+    filename: string;
+    uri: FileUri;
+    filemime: string;
+    filesize: number;
+    status: boolean;
+    created: DateTimeString;
+    changed: DateTimeString;
+    uid?: ToOne<User>;
+    relationshipMeta?: TMeta & Record<string, unknown>;
+}
+export interface Node<TBundle extends string = string> extends ContentEntity<`node--${TBundle}`> {
+    drupal_internal__nid: number;
+    drupal_internal__vid: number;
+    title: string;
+    status: boolean;
+    promote: boolean;
+    sticky: boolean;
+    created: DateTimeString;
+    changed: DateTimeString;
+    revision_timestamp?: DateTimeString;
+    revision_log?: string | null;
+    path?: PathField;
+    node_type?: ToOne<NodeType>;
+    uid?: ToOne<User>;
+    revision_uid?: ToOne<User>;
+}
+export interface Term<TVocabulary extends string = string> extends ContentEntity<`taxonomy_term--${TVocabulary}`> {
+    drupal_internal__tid: number;
+    drupal_internal__revision_id?: number;
+    name: string;
+    description: TextField | null;
+    weight: number;
+    status: boolean;
+    changed: DateTimeString;
+    path?: PathField;
+    vid?: ToOne<Vocabulary>;
+    /** Parents; a root term's parent is a stub with the id `virtual`. */
+    parent?: ToMany<Term<TVocabulary>>;
+    revision_user?: ToOne<User>;
+}
+export interface Media<TBundle extends string = string> extends ContentEntity<`media--${TBundle}`> {
+    drupal_internal__mid: number;
+    drupal_internal__vid: number;
+    name: string;
+    status: boolean;
+    created: DateTimeString;
+    changed: DateTimeString;
+    path?: PathField;
+    bundle?: ToOne<MediaType>;
+    thumbnail?: ToOne<File<ImageMeta>>;
+    uid?: ToOne<User>;
+    revision_user?: ToOne<User>;
+}
+export interface MediaImage extends Media<'image'> {
+    field_media_image: ToOne<File<ImageMeta>>;
+}
+export interface MediaDocument extends Media<'document'> {
+    field_media_document: ToOne<File<FileMeta>>;
+}
+export interface MediaAudio extends Media<'audio'> {
+    field_media_audio_file: ToOne<File<FileMeta>>;
+}
+export interface MediaVideo extends Media<'video'> {
+    field_media_video_file: ToOne<File<FileMeta>>;
+}
+export interface MediaRemoteVideo extends Media<'remote_video'> {
+    /** The oEmbed URL (YouTube, Vimeo). */
+    field_media_oembed_video: string;
+}
+export interface MenuLinkContent extends ContentEntity<'menu_link_content--menu_link_content'> {
+    drupal_internal__id: number;
+    title: string;
+    description: string | null;
+    menu_name: string;
+    link: LinkField;
+    enabled: boolean;
+    expanded: boolean;
+    external: boolean;
+    weight: number;
+    /** Parent plugin ID, `menu_link_content:{uuid}`, or null at the root. */
+    parent: string | null;
+    changed: DateTimeString;
+}
+export interface BlockContent<TBundle extends string = string> extends ContentEntity<`block_content--${TBundle}`> {
+    drupal_internal__id: number;
+    info: string;
+    status: boolean;
+    reusable: boolean;
+    changed: DateTimeString;
+    body?: TextField | null;
+    block_content_type?: ToOne<BlockContentType>;
+}
+export interface PathAlias extends ResourceBase<'path_alias--path_alias'> {
+    drupal_internal__id: number;
+    langcode: string;
+    /** System path, e.g. `/node/1`. */
+    path: string;
+    alias: string;
+    status: boolean;
+}
+/** `paragraph--{bundle}` (contrib paragraphs). */
+export interface Paragraph<TBundle extends string = string> extends ContentEntity<`paragraph--${TBundle}`> {
+    drupal_internal__id: number;
+    drupal_internal__revision_id: number;
+    status: boolean;
+    created: DateTimeString;
+    parent_id: string;
+    parent_type: string;
+    parent_field_name: string;
+    behavior_settings?: unknown;
+}
+declare module '@jsondrop/core' {
+    interface ResourceTypes {
+        'user--user': User;
+        'file--file': File;
+        'menu_link_content--menu_link_content': MenuLinkContent;
+        'path_alias--path_alias': PathAlias;
+        'node_type--node_type': NodeType;
+        'taxonomy_vocabulary--taxonomy_vocabulary': Vocabulary;
+        'media_type--media_type': MediaType;
+        'user_role--user_role': Role;
+        'block_content_type--block_content_type': BlockContentType;
+    }
+    interface EntityTypes {
+        node: Node;
+        taxonomy_term: Term;
+        media: Media;
+        block_content: BlockContent;
+        paragraph: Paragraph;
+    }
+}
+export {};
+//# sourceMappingURL=entities.d.ts.map

package/dist/entities.d.ts.map

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

package/dist/entities.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entities.js.map

package/dist/entities.js.map

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

package/dist/fields.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Field value shapes, as Drupal 11's JSON:API normalizes core field types.
+ *
+ * Dates (`created`, `changed`, datetime fields) arrive as ISO 8601 strings.
+ */
+/** ISO 8601 date-time string, e.g. `2026-10-31T12:00:00+00:00`. */
+export type DateTimeString = string;
+/** `text_long`, `text_with_summary` (`summary` only on the latter). */
+export interface TextField {
+    value: string;
+    format: string | null;
+    /** The value rendered through its text format: safe HTML to output. */
+    processed: string;
+    summary?: string;
+}
+/** The `path` field (core path module). */
+export interface PathField {
+    alias: string | null;
+    pid: number | null;
+    langcode: string;
+}
+/** The `link` field type. */
+export interface LinkField {
+    /** `internal:/…`, `entity:node/1`, `route:<nolink>` or an external URL. */
+    uri: string;
+    title: string | null;
+    options: Record<string, unknown>;
+}
+/** The file field's `uri`: the stream URI and its (root-relative) URL. */
+export interface FileUri {
+    value: string;
+    url: string;
+}
+/**
+ * Relationship meta of an `image` field item, found on the file resource
+ * as `relationshipMeta`.
+ */
+export interface ImageMeta {
+    alt: string;
+    title: string;
+    width: number | null;
+    height: number | null;
+    drupal_internal__target_id: number;
+}
+/** Relationship meta of a `file` field item. */
+export interface FileMeta {
+    display: boolean | null;
+    description: string | null;
+    drupal_internal__target_id: number;
+}
+/** `datetime_range` / `daterange`. */
+export interface DateRangeField {
+    value: DateTimeString;
+    end_value: DateTimeString;
+}
+/** The `address` field (contrib address module, used by Commerce). */
+export interface AddressField {
+    country_code: string;
+    langcode?: string | null;
+    administrative_area?: string | null;
+    locality?: string | null;
+    dependent_locality?: string | null;
+    postal_code?: string | null;
+    sorting_code?: string | null;
+    address_line1?: string | null;
+    address_line2?: string | null;
+    address_line3?: string | null;
+    organization?: string | null;
+    given_name?: string | null;
+    additional_name?: string | null;
+    family_name?: string | null;
+}
+//# sourceMappingURL=fields.d.ts.map

package/dist/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../src/fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mEAAmE;AACnE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2CAA2C;AAC3C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,6BAA6B;AAC7B,MAAM,WAAW,SAAS;IACxB,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,0EAA0E;AAC1E,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0BAA0B,EAAE,MAAM,CAAC;CACpC;AAED,gDAAgD;AAChD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0BAA0B,EAAE,MAAM,CAAC;CACpC;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,EAAE,cAAc,CAAC;CAC3B;AAED,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B"}

package/dist/fields.js

@@ -0,0 +1,7 @@
+/**
+ * Field value shapes, as Drupal 11's JSON:API normalizes core field types.
+ *
+ * Dates (`created`, `changed`, datetime fields) arrive as ISO 8601 strings.
+ */
+export {};
+//# sourceMappingURL=fields.js.map

package/dist/fields.js.map

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

package/dist/files.d.ts

@@ -0,0 +1,27 @@
+import { type JsonApiClient } from '@jsondrop/core';
+import type { File } from './entities.js';
+/**
+ * Absolute URL of a file. Drupal 11 serves `uri.url` root-relative
+ * (`/sites/default/files/…`); this prefixes the site's origin.
+ */
+export declare function fileUrl(client: JsonApiClient, file: Pick<File, 'uri'>): string;
+/**
+ * URL of an image style derivative, as the consumer_image_styles module
+ * adds them to the file's links. NULL when the style is not enabled for
+ * the requesting consumer.
+ */
+export declare function imageStyleUrl(file: Pick<File, 'links'>, style: string): string | null;
+export interface Image {
+    url: string;
+    alt: string;
+    title: string | null;
+    width: number | null;
+    height: number | null;
+}
+/**
+ * An image field's value, ready for an `<img>`: absolute URL plus the alt
+ * text and dimensions from the relationship. NULL for an empty field or a
+ * file that was not included.
+ */
+export declare function image(client: JsonApiClient, value: unknown): Image | null;
+//# sourceMappingURL=files.d.ts.map

package/dist/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAG1C;;;GAGG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,CAG9E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAErF;AAED,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI,CAgBzE"}