@jsondrop/drupal 0.0.0-stage → 0.1.1

package/dist/files.js

@@ -0,0 +1,40 @@
+import { isStub } from '@jsondrop/core';
+/**
+ * Absolute URL of a file. Drupal 11 serves `uri.url` root-relative
+ * (`/sites/default/files/…`); this prefixes the site's origin.
+ */
+export function fileUrl(client, file) {
+    const url = file.uri.url;
+    return /^[a-z][a-z0-9+.-]*:/i.test(url) || url.startsWith('//') ? url : `${client.baseUrl}${url}`;
+}
+/**
+ * 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 function imageStyleUrl(file, style) {
+    return file.links?.[style]?.href ?? 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 function image(client, value) {
+    if (!value || typeof value !== 'object' || isStub(value)) {
+        return null;
+    }
+    const file = value;
+    if (!file.uri?.url) {
+        return null;
+    }
+    const meta = file.relationshipMeta ?? {};
+    return {
+        url: fileUrl(client, file),
+        alt: meta.alt ?? '',
+        title: meta.title || null,
+        width: meta.width ?? null,
+        height: meta.height ?? null,
+    };
+}
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAsB,MAAM,gBAAgB,CAAC;AAI5D;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,MAAqB,EAAE,IAAuB;IACpE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACzB,OAAO,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC;AACpG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAyB,EAAE,KAAa;IACpE,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;AAC3C,CAAC;AAUD;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,MAAqB,EAAE,KAAc;IACzD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,KAAwB,CAAC;IACtC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAuB,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC;IAC7D,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QAC1B,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;QACzB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;KAC5B,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './account.js';
+export * from './entities.js';
+export * from './fields.js';
+export * from './files.js';
+export * from './menu.js';
+export * from './router.js';
+export * from './views.js';
+//# 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":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from './account.js';
+export * from './entities.js';
+export * from './fields.js';
+export * from './files.js';
+export * from './menu.js';
+export * from './router.js';
+export * from './views.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/menu.d.ts

@@ -0,0 +1,48 @@
+import type { JsonApiClient, ResourceBase, ResourceRequestOptions } from '@jsondrop/core';
+/**
+ * A menu link from the jsonapi_menu_items module. Unlike core's
+ * `menu_link_content` resources, it covers every link in the menu (links
+ * defined by modules too) and comes with a resolved `url`.
+ */
+export interface MenuItem extends ResourceBase {
+    /** Plugin ID: `menu_link_content:{uuid}`, `standard.front_page`, … */
+    id: string;
+    title: string;
+    description: string | null;
+    url: string;
+    menu_name: string;
+    /** Parent plugin ID, or empty at the root. */
+    parent: string;
+    weight: number;
+    enabled: boolean;
+    expanded: boolean;
+    provider: string;
+    route?: {
+        name: string;
+        parameters: Record<string, string>;
+    };
+    options?: Record<string, unknown>;
+}
+export type MenuTreeItem<T> = T & {
+    children: MenuTreeItem<T>[];
+};
+/** A menu's enabled links, flat (jsonapi_menu_items module). */
+export declare function getMenuItems(client: JsonApiClient, menu: string, options?: ResourceRequestOptions): Promise<MenuItem[]>;
+/** A menu as a tree, sorted by weight then title (jsonapi_menu_items module). */
+export declare function getMenu(client: JsonApiClient, menu: string, options?: ResourceRequestOptions): Promise<MenuTreeItem<MenuItem>[]>;
+interface TreeInput {
+    id: string;
+    type?: string;
+    parent: string | null;
+    weight: number;
+    title: string;
+}
+/**
+ * Nests flat menu links by `parent`, sorted by weight then title. Takes
+ * jsonapi_menu_items links or core `menu_link_content` resources (whose
+ * `parent` names the plugin ID `menu_link_content:{uuid}`). A link whose
+ * parent is not in the list becomes a root.
+ */
+export declare function buildMenuTree<T extends TreeInput>(items: T[]): MenuTreeItem<T>[];
+export {};
+//# sourceMappingURL=menu.d.ts.map

package/dist/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../src/menu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE1F;;;;GAIG;AACH,MAAM,WAAW,QAAS,SAAQ,YAAY;IAC5C,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,CAAC;AAElE,gEAAgE;AAChE,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAG7H;AAED,iFAAiF;AACjF,wBAAsB,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAEtI;AAED,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAID;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,CAiBhF"}

package/dist/menu.js

@@ -0,0 +1,35 @@
+/** A menu's enabled links, flat (jsonapi_menu_items module). */
+export async function getMenuItems(client, menu, options) {
+    const response = await client.get(`/menu_items/${encodeURIComponent(menu)}`, options);
+    return response.data ?? [];
+}
+/** A menu as a tree, sorted by weight then title (jsonapi_menu_items module). */
+export async function getMenu(client, menu, options) {
+    return buildMenuTree(await getMenuItems(client, menu, options));
+}
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * Nests flat menu links by `parent`, sorted by weight then title. Takes
+ * jsonapi_menu_items links or core `menu_link_content` resources (whose
+ * `parent` names the plugin ID `menu_link_content:{uuid}`). A link whose
+ * parent is not in the list becomes a root.
+ */
+export function buildMenuTree(items) {
+    const pluginId = (item) => (item.type === 'menu_link_content--menu_link_content' && UUID.test(item.id) ? `menu_link_content:${item.id}` : item.id);
+    const nodes = new Map();
+    for (const item of items) {
+        nodes.set(pluginId(item), { ...item, children: [] });
+    }
+    const roots = [];
+    for (const node of nodes.values()) {
+        const parent = node.parent ? nodes.get(node.parent) : undefined;
+        (parent && parent !== node ? parent.children : roots).push(node);
+    }
+    const sort = (list) => {
+        list.sort((a, b) => a.weight - b.weight || a.title.localeCompare(b.title));
+        list.forEach((node) => sort(node.children));
+    };
+    sort(roots);
+    return roots;
+}
+//# sourceMappingURL=menu.js.map

package/dist/menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../src/menu.ts"],"names":[],"mappings":"AA0BA,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAqB,EAAE,IAAY,EAAE,OAAgC;IACtG,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAa,eAAe,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAClG,OAAO,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAqB,EAAE,IAAY,EAAE,OAAgC;IACjG,OAAO,aAAa,CAAC,MAAM,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AAClE,CAAC;AAUD,MAAM,IAAI,GAAG,iEAAiE,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAsB,KAAU;IAC3D,MAAM,QAAQ,GAAG,CAAC,IAAO,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,sCAAsC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,qBAAqB,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtJ,MAAM,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IACjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChE,CAAC,MAAM,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,IAAuB,EAAE,EAAE;QACvC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3E,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC;IACF,IAAI,CAAC,KAAK,CAAC,CAAC;IACZ,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,56 @@
+import { type JsonApiClient, type Resource, type ResourceRequestOptions } from '@jsondrop/core';
+/** What decoupled_router answers for a path. */
+export interface TranslatedPath {
+    /** Absolute URL the path resolves to. */
+    resolved: string;
+    isHomePath: boolean;
+    entity?: {
+        canonical: string;
+        type: string;
+        bundle: string;
+        /** Drupal's numeric ID, as a string. */
+        id: string;
+        uuid: string;
+    };
+    label?: string;
+    /** Present when the path is an entity JSON:API exposes. */
+    jsonapi?: {
+        individual: string;
+        resourceName: string;
+        pathPrefix: string;
+        basePath: string;
+        entryPoint: string;
+    };
+    /** Redirects (redirect module) that led here, oldest first. */
+    redirect?: Array<{
+        from: string;
+        to: string;
+        status: string;
+    }>;
+    [key: string]: unknown;
+}
+export interface ResolvedPath<T> {
+    route: TranslatedPath;
+    /** The entity at the path; NULL when the path is not a JSON:API entity. */
+    resource: T | null;
+}
+type PathOptions = Pick<ResourceRequestOptions, 'locale' | 'auth' | 'headers' | 'fetchOptions' | 'signal'>;
+/**
+ * Resolves a site path (`/about-us`, `/node/1`) with the decoupled_router
+ * module. NULL when nothing is there; a 403 (unpublished, no access) throws.
+ */
+export declare function translatePath(client: JsonApiClient, path: string, options?: PathOptions): Promise<TranslatedPath | null>;
+/**
+ * Resolves a path and fetches the entity there, in two requests. The entity
+ * is fetched from the URL decoupled_router gives, which respects resource
+ * paths renamed with JSON:API Extras and the path's language.
+ *
+ * ```ts
+ * const page = await getResourceByPath<Node>(drupal, params.slug, { query: { include: ['uid'] } });
+ * if (!page) notFound();
+ * if (page.route.redirect?.length) redirect(page.route.redirect.at(-1)!.to);
+ * ```
+ */
+export declare function getResourceByPath<T = Resource>(client: JsonApiClient, path: string, options?: ResourceRequestOptions): Promise<ResolvedPath<T> | null>;
+export {};
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,KAAK,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEhH,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,wCAAwC;QACxC,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,OAAO,CAAC,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,KAAK,EAAE,cAAc,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC;CACpB;AAED,KAAK,WAAW,GAAG,IAAI,CAAC,sBAAsB,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,QAAQ,CAAC,CAAC;AAE3G;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAgBlI;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAUhK"}

package/dist/router.js

@@ -0,0 +1,52 @@
+import { isJsonApiError } from '@jsondrop/core';
+/**
+ * Resolves a site path (`/about-us`, `/node/1`) with the decoupled_router
+ * module. NULL when nothing is there; a 403 (unpublished, no access) throws.
+ */
+export async function translatePath(client, path, options = {}) {
+    try {
+        const response = await client.get(client.siteUrl('/router/translate-path', undefined, options.locale), {
+            ...options,
+            query: { params: { path, _format: 'json' } },
+            headers: { Accept: 'application/json', ...headersObject(options.headers) },
+            parse: 'json',
+        });
+        return response.data;
+    }
+    catch (error) {
+        if (isJsonApiError(error) && error.status === 404) {
+            return null;
+        }
+        throw error;
+    }
+}
+/**
+ * Resolves a path and fetches the entity there, in two requests. The entity
+ * is fetched from the URL decoupled_router gives, which respects resource
+ * paths renamed with JSON:API Extras and the path's language.
+ *
+ * ```ts
+ * const page = await getResourceByPath<Node>(drupal, params.slug, { query: { include: ['uid'] } });
+ * if (!page) notFound();
+ * if (page.route.redirect?.length) redirect(page.route.redirect.at(-1)!.to);
+ * ```
+ */
+export async function getResourceByPath(client, path, options = {}) {
+    const route = await translatePath(client, path, options);
+    if (!route) {
+        return null;
+    }
+    if (!route.jsonapi?.individual) {
+        return { route, resource: null };
+    }
+    const response = await client.get(route.jsonapi.individual, options);
+    return { route, resource: response.data };
+}
+function headersObject(headers) {
+    const result = {};
+    new Headers(headers).forEach((value, name) => {
+        result[name] = value;
+    });
+    return result;
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAkE,MAAM,gBAAgB,CAAC;AAqChH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAqB,EAAE,IAAY,EAAE,UAAuB,EAAE;IAChG,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAiB,MAAM,CAAC,OAAO,CAAC,wBAAwB,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE;YACrH,GAAG,OAAO;YACV,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;YAC5C,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAC1E,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAClD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAe,MAAqB,EAAE,IAAY,EAAE,UAAkC,EAAE;IAC7H,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;QAC/B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACnC,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAI,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACxE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,aAAa,CAAC,OAAgC;IACrD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3C,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/views.d.ts

@@ -0,0 +1,29 @@
+import type { JsonApiClient, Links, Meta, Resource, ResourceRequestOptions } from '@jsondrop/core';
+export interface ViewOptions extends Omit<ResourceRequestOptions, 'query'> {
+    /** Exposed filters, by identifier. */
+    filters?: Record<string, string | string[]>;
+    /** Contextual filter values, in order. */
+    arguments?: string[];
+    /** Exposed sort. */
+    sort?: {
+        by: string;
+        order?: 'ASC' | 'DESC';
+    };
+    /** Zero-based page of the view's pager. */
+    page?: number;
+    /** Other parameters (`include` works). */
+    params?: Record<string, string | string[]>;
+}
+export interface ViewResult<T> {
+    data: T[];
+    /** Total result count, when the view has a pager. */
+    count: number | null;
+    meta: Meta;
+    links: Links;
+}
+/**
+ * Results of a view display (jsonapi_views module): the display's
+ * filters, sorts and pager, as JSON:API resources.
+ */
+export declare function getView<T = Resource>(client: JsonApiClient, view: string, display: string, options?: ViewOptions): Promise<ViewResult<T>>;
+//# sourceMappingURL=views.d.ts.map

package/dist/views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.d.ts","sourceRoot":"","sources":["../src/views.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEnG,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACxE,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC5C,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,oBAAoB;IACpB,IAAI,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAC;IAC9C,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,qDAAqD;IACrD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAsBnJ"}

package/dist/views.js

@@ -0,0 +1,32 @@
+/**
+ * Results of a view display (jsonapi_views module): the display's
+ * filters, sorts and pager, as JSON:API resources.
+ */
+export async function getView(client, view, display, options = {}) {
+    const { filters, arguments: args, sort, page, params, ...rest } = options;
+    const query = { ...params };
+    for (const [name, value] of Object.entries(filters ?? {})) {
+        if (Array.isArray(value))
+            query[`views-filter[${name}][]`] = value;
+        else
+            query[`views-filter[${name}]`] = value;
+    }
+    if (args?.length)
+        query['views-argument[]'] = args;
+    if (sort) {
+        query['views-sort[sort_by]'] = sort.by;
+        if (sort.order)
+            query['views-sort[sort_order]'] = sort.order;
+    }
+    if (page !== undefined)
+        query.page = String(page);
+    const response = await client.get(`/views/${encodeURIComponent(view)}/${encodeURIComponent(display)}`, { ...rest, query: { params: query } });
+    const count = response.meta.count;
+    return {
+        data: response.data ?? [],
+        count: count === undefined || count === null ? null : Number(count),
+        meta: response.meta,
+        links: response.links,
+    };
+}
+//# sourceMappingURL=views.js.map

package/dist/views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.js","sourceRoot":"","sources":["../src/views.ts"],"names":[],"mappings":"AAuBA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAe,MAAqB,EAAE,IAAY,EAAE,OAAe,EAAE,UAAuB,EAAE;IACzH,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAC1E,MAAM,KAAK,GAAsC,EAAE,GAAG,MAAM,EAAE,CAAC;IAC/D,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QAC1D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC;;YAC9D,KAAK,CAAC,gBAAgB,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC;IAC9C,CAAC;IACD,IAAI,IAAI,EAAE,MAAM;QAAE,KAAK,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;IACnD,IAAI,IAAI,EAAE,CAAC;QACT,KAAK,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,KAAK;YAAE,KAAK,CAAC,wBAAwB,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IAC/D,CAAC;IACD,IAAI,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAElD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAM,UAAU,kBAAkB,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IACnJ,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;IAClC,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE;QACzB,KAAK,EAAE,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QACnE,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;KACtB,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@jsondrop/drupal",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Drupal core entity types and helpers (decoupled_router, menus, views, images) for @jsondrop/core.",
+  "keywords": [
+    "drupal",
+    "jsonapi",
+    "decoupled",
+    "headless",
+    "typescript",
+    "decoupled_router"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Valentino Međimorec",
+    "url": "https://github.com/valicm"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/valicm/jsondrop.git",
+    "directory": "packages/drupal"
+  },
+  "homepage": "https://github.com/valicm/jsondrop/tree/main/packages/drupal#readme",
+  "bugs": {
+    "url": "https://github.com/valicm/jsondrop/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "@jsondrop/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "peerDependencies": {
+    "@jsondrop/core": "^0.1.1"
+  },
+  "devDependencies": {
+    "@jsondrop/core": "*"
+  },
+  "engines": {
+    "node": ">=20.19"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/account.ts

@@ -0,0 +1,125 @@
+import { sessionCookie, 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 async function getCurrentUser<T = User>(client: JsonApiClient, options: ResourceRequestOptions = {}): Promise<T | null> {
+  const id = await getCurrentUserId(client, options);
+  return id ? client.getResource('user--user', id, options) as Promise<T> : null;
+}
+
+/** The current user's UUID, or NULL when anonymous (one request). */
+export async function getCurrentUserId(client: JsonApiClient, options: Pick<ResourceRequestOptions, 'auth' | 'headers' | 'fetchOptions' | 'signal'> = {}): Promise<string | null> {
+  const { auth, headers, fetchOptions, signal } = options;
+  const response = await client.request('GET', '', { auth, headers, fetchOptions, signal });
+  const me = (response.meta.links as { me?: { meta?: { id?: string } } } | undefined)?.me;
+  return me?.meta?.id ?? 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;
+}
+
+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: JsonApiClient, credentials: { name: string; pass: string }): Promise<SessionLogin> {
+  const response = await client.post<{ current_user?: SessionLogin['user']; csrf_token?: string; logout_token?: string } | null>(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: JsonApiClient, session: Pick<SessionLogin, 'cookie' | 'logoutToken'>): Promise<void> {
+  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: JsonApiClient, cookie: string): Promise<boolean> {
+  const response = await client.get<number | string | null>(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: JsonApiClient, cookie?: string): Promise<string> {
+  const response = await client.get<string>(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: JsonApiClient, account: { name: string } | { mail: string }): Promise<void> {
+  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: Headers): string | null {
+  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;
+}