@glidecms/cms-sdk 2.2.0

package/dist/article-body.js

@@ -0,0 +1,313 @@
+import { createRequire } from 'node:module';
+import { randomUUID } from 'node:crypto';
+const require = createRequire(import.meta.url);
+let JSDOM;
+function getJSDOM() {
+    if (JSDOM)
+        return JSDOM;
+    try {
+        ({ JSDOM } = require('jsdom'));
+        return JSDOM;
+    }
+    catch (err) {
+        const cause = err instanceof Error ? `: ${err.message}` : '';
+        throw new Error(`The article body parser requires the optional peer dependency "jsdom". Install it with "npm install jsdom"${cause}`);
+    }
+}
+function shortId() {
+    return randomUUID().slice(0, 10);
+}
+/**
+ * Standard Glide image embed replacement string.
+ * Use with pattern replacements to convert image tags to Composer's format.
+ * Expects `$1` to be the image src URL.
+ *
+ * @example
+ * ```typescript
+ * const body = glideSdk.composer.articleBody.htmlToBodyJson(html, {
+ *   patternReplacements: [
+ *     { pattern: IMAGE_IN_PARAGRAPH_PATTERN, replacement: GLIDE_EXTERNAL_IMAGE_EMBED },
+ *     { pattern: IMAGE_IN_DIV_PATTERN, replacement: GLIDE_EXTERNAL_IMAGE_EMBED }
+ *   ]
+ * });
+ * ```
+ */
+export const GLIDE_EXTERNAL_IMAGE_EMBED = '<p class="fr-embedded"><span class="fr-img-caption gd-ember-wrapper fr-fic fr-dib --url" data-type="image/url"><span class="fr-img-wrap gd-ember-wrapper"><img class="fr-embedded gd-embedded" src="$1"></span></span></p>';
+/**
+ * Pattern to match `<p><img src="..."></p>` structures.
+ * Captures the image src URL in group `$1`.
+ *
+ * @example
+ * ```typescript
+ * { pattern: IMAGE_IN_PARAGRAPH_PATTERN, replacement: GLIDE_EXTERNAL_IMAGE_EMBED }
+ * ```
+ */
+export const IMAGE_IN_PARAGRAPH_PATTERN = /<p[^>]*>\s*<img[^>]*src="([^"]*)"[^>]*\/?>\s*<\/p>/gi;
+/**
+ * Pattern to match `<div>...<img src="...">...</div>` structures.
+ * Captures the image src URL in group `$1`.
+ *
+ * @example
+ * ```typescript
+ * { pattern: IMAGE_IN_DIV_PATTERN, replacement: GLIDE_EXTERNAL_IMAGE_EMBED }
+ * ```
+ */
+export const IMAGE_IN_DIV_PATTERN = /<div[^>]*>[\s\S]*?<img[^>]*src="([^"]*)"[^>]*\/?>[\s\S]*?<\/div>/gi;
+/**
+ * Pattern to match standalone `<img src="...">` tags.
+ * Captures the image src URL in group `$1`.
+ *
+ * @example
+ * ```typescript
+ * { pattern: STANDALONE_IMAGE_PATTERN, replacement: GLIDE_EXTERNAL_IMAGE_EMBED }
+ * ```
+ */
+export const STANDALONE_IMAGE_PATTERN = /<img[^>]*src="([^"]*)"[^>]*\/?>/gi;
+/**
+ * Predefined pattern replacements for common image structures.
+ * Handles `<p><img></p>`, `<div><img></div>`, and standalone `<img>` tags.
+ *
+ * @example
+ * ```typescript
+ * const body = glideSdk.composer.articleBody.htmlToBodyJson(html, {
+ *   patternReplacements: IMAGE_PATTERN_REPLACEMENTS
+ * });
+ * ```
+ */
+export const IMAGE_PATTERN_REPLACEMENTS = [
+    { pattern: IMAGE_IN_PARAGRAPH_PATTERN, replacement: GLIDE_EXTERNAL_IMAGE_EMBED },
+    { pattern: IMAGE_IN_DIV_PATTERN, replacement: GLIDE_EXTERNAL_IMAGE_EMBED },
+];
+/**
+ * Builds the Composer/Froala HTML shape for an inline taxonomy mention.
+ */
+export function taxonomyMention(input) {
+    const id = escapeAttribute(String(input.id));
+    const name = escapeHtml(input.name);
+    const nameAttr = escapeAttribute(input.name);
+    const slug = escapeAttribute(input.slug);
+    const href = escapeAttribute(input.href ?? `taxonomies/${input.id}`);
+    return `<span class="fr-deletable" contenteditable="false" data-type="mention/taxonomy"><a data-id="${id}" href="${href}" contenteditable="true" data-name="${nameAttr}" data-slug="${slug}">${name}</a></span>`;
+}
+/**
+ * Converts Composer article body JSON back to HTML for previews and rendering.
+ */
+export function renderArticleBody(bodyJson) {
+    const body = typeof bodyJson === 'string' ? parseBodyJson(bodyJson) : bodyJson;
+    return body.contentStructure
+        .map(node => renderContentNode(node, body.contentNodes))
+        .join('');
+}
+/**
+ * Converts an HTML string to Composer's content node structure JSON format.
+ *
+ * Parses HTML content and transforms it into the JSON structure required by
+ * Composer for article body content. The resulting JSON can be used directly
+ * in article create/update payloads.
+ *
+ * Supported tags: p, h1-h6, span, strong, b, em, i, code, pre, ul, ol, li, a, br, blockquote, table elements.
+ * Stripped tags: div, img, figure, figcaption, video, audio, iframe (require custom Composer handling).
+ *
+ * @param htmlString - The HTML string to convert (can include body tags or raw HTML)
+ * @param options - Optional configuration including pattern replacements
+ * @returns JSON string in Composer's content node format, ready for the article body field
+ *
+ * @example
+ * ```typescript
+ * import { parseArticleBody, IMAGE_PATTERN_REPLACEMENTS } from '@glidecms/glide-cms-sdk/article-body';
+ *
+ * // Basic usage
+ * const body = parseArticleBody('<p>Hello <strong>world</strong></p>');
+ *
+ * // With image pattern replacements
+ * const body = parseArticleBody(html, { patternReplacements: IMAGE_PATTERN_REPLACEMENTS });
+ *
+ * // Use in article creation
+ * await composer.article.create({ headline: 'My Article', body });
+ * ```
+ */
+export function parseArticleBody(htmlString, options) {
+    if (!htmlString || htmlString.trim() === '') {
+        return JSON.stringify({ contentStructure: [], contentNodes: {} });
+    }
+    const bodyMatch = htmlString.match(/<body\b[^>]*>([\s\S]*?)<\/body>/i);
+    let innerContent = bodyMatch ? bodyMatch[1] : htmlString;
+    if (options?.patternReplacements) {
+        innerContent = applyPatternReplacements(innerContent, options.patternReplacements);
+    }
+    const dom = new (getJSDOM())(innerContent);
+    const body = dom.window.document.body;
+    stripUnsupportedTags(body);
+    const contentStructure = [];
+    const contentNodes = {};
+    if (body) {
+        for (const child of body.childNodes) {
+            if (child.nodeType === 1) {
+                const element = child;
+                if (SUPPORTED_TAGS.has(element.nodeName)) {
+                    const node = traverseTree(element, contentNodes);
+                    node.parentId = 'froala-content-wrapper';
+                    contentStructure.push(node);
+                }
+            }
+        }
+    }
+    return JSON.stringify({ contentStructure, contentNodes });
+}
+/** @internal Resolve ArticleBodyInput to ParsedArticleBody, auto-parsing `{ html }` objects. */
+export function resolveBody(body) {
+    if (typeof body === 'string')
+        return body;
+    const { html, ...opts } = body;
+    return parseArticleBody(html, Object.keys(opts).length ? opts : undefined);
+}
+/** @deprecated Use `parseArticleBody()` instead. Will be removed in next major. */
+export class ArticleBodyProcessingService {
+    htmlToBodyJson(htmlString, options) {
+        return parseArticleBody(htmlString, options);
+    }
+}
+// --- Private helpers ---
+const SUPPORTED_TAGS = new Set([
+    'P', 'H1', 'H2', 'H3', 'H4', 'H5', 'H6', 'SPAN', 'STRONG', 'B', 'EM', 'I', 'U',
+    'CODE', 'PRE', 'UL', 'OL', 'LI', 'A', 'BR', 'BLOCKQUOTE',
+    'TABLE', 'THEAD', 'TBODY', 'TR', 'TH', 'TD', 'MG',
+]);
+const UNSUPPORTED_TAGS = new Set(['DIV', 'FIGURE', 'FIGCAPTION', 'VIDEO', 'AUDIO', 'FRAME']);
+const VOID_TAGS = new Set(['BR', 'IMG']);
+function parseBodyJson(bodyJson) {
+    if (!bodyJson.trim())
+        return { contentStructure: [], contentNodes: {} };
+    const parsed = JSON.parse(bodyJson);
+    if (!Array.isArray(parsed.contentStructure)) {
+        throw new Error('Invalid article body JSON: missing contentStructure array');
+    }
+    return {
+        contentStructure: parsed.contentStructure,
+        contentNodes: parsed.contentNodes ?? {},
+    };
+}
+function escapeHtml(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+function escapeAttribute(value) {
+    return escapeHtml(value).replace(/"/g, '&quot;').replace(/'/g, '&#39;');
+}
+function renderAttributes(attributes) {
+    return Object.entries(attributes)
+        .filter(([, value]) => value !== undefined && value !== null)
+        .map(([name, value]) => ` ${name}="${escapeAttribute(String(value))}"`)
+        .join('');
+}
+function renderImageNode(node, metadata) {
+    const src = metadata?.dataUrl ?? metadata?.dataId ?? node.attributes.src ?? '';
+    const alt = metadata?.alt ?? node.attributes.alt ?? metadata?.caption ?? '';
+    const attributes = {
+        ...node.attributes,
+        src,
+        alt,
+    };
+    return `<img${renderAttributes(attributes)}>`;
+}
+function renderContentNode(node, contentNodes) {
+    if (node.tagName === 'TEXT')
+        return escapeHtml(node.innerText);
+    if (node.tagName === 'MG')
+        return renderImageNode(node, contentNodes[node.id]);
+    const tagName = node.tagName.toLowerCase();
+    const metadata = contentNodes[node.id];
+    const attributes = { ...node.attributes };
+    if (node.tagName === 'A' && metadata?.dataUrl && !attributes.href) {
+        attributes.href = metadata.dataUrl;
+    }
+    const openingTag = `<${tagName}${renderAttributes(attributes)}>`;
+    if (VOID_TAGS.has(node.tagName))
+        return openingTag;
+    const children = node.childNodes
+        .map(child => renderContentNode(child, contentNodes))
+        .join('');
+    return `${openingTag}${children}</${tagName}>`;
+}
+function applyPatternReplacements(html, replacements) {
+    let result = html;
+    for (const { pattern, replacement } of replacements) {
+        result = result.replace(pattern, replacement);
+    }
+    return result;
+}
+function stripUnsupportedTags(container) {
+    const unsupported = container.querySelectorAll(Array.from(UNSUPPORTED_TAGS).join(','));
+    unsupported.forEach((el) => el.parentNode?.removeChild(el));
+}
+function traverseTree(element, contentNodes) {
+    const nodeId = element.id || shortId();
+    if (element.nodeName === 'MG') {
+        const src = element.getAttribute('src') || '';
+        const alt = element.getAttribute('alt') || '';
+        let caption = '';
+        const parent = element.parentElement;
+        if (parent) {
+            const captionEl = parent.querySelector('.fr-inner, .gd-image-caption');
+            if (captionEl)
+                caption = captionEl.textContent?.trim() || '';
+        }
+        contentNodes[nodeId] = {
+            id: nodeId, type: 'image/url', alignment: 'center', isInline: false,
+            dataId: src, dataUrl: src, caption, alt: alt || caption, credit: '', imageStyle: 'default',
+        };
+        return {
+            id: nodeId, tagName: 'MG',
+            attributes: { id: nodeId, class: 'fr-embedded gd-embedded fr-draggable', alignment: 'center', isInline: 'false' },
+            innerText: '', parentId: element.parentNode?.id || '', childNodes: [],
+        };
+    }
+    if (element.nodeName === 'A') {
+        const href = element.getAttribute('href') || '';
+        contentNodes[nodeId] = {
+            id: nodeId, type: 'content/link', dataUrl: href,
+            innerText: element.textContent || '', innerHTML: element.innerHTML || '',
+        };
+    }
+    if (element.nodeName === 'P' && element.classList.contains('fr-embedded')) {
+        const imgElement = element.querySelector('img');
+        if (imgElement) {
+            const node = {
+                id: nodeId, tagName: 'P', attributes: { class: 'fr-embedded', id: nodeId },
+                innerText: '', parentId: 'froala-content-wrapper', childNodes: [],
+            };
+            const imgNode = traverseTree(imgElement, contentNodes);
+            imgNode.parentId = nodeId;
+            node.childNodes.push(imgNode);
+            return node;
+        }
+    }
+    const node = {
+        id: nodeId, tagName: element.nodeName, attributes: {},
+        innerText: '', parentId: element.parentNode?.id || '', childNodes: [],
+    };
+    for (let i = 0; i < element.attributes.length; i++) {
+        const attr = element.attributes[i];
+        node.attributes[attr.name] = attr.value;
+    }
+    if (!node.attributes.id)
+        node.attributes.id = node.id;
+    for (const child of element.childNodes) {
+        if (child.nodeType === 1) {
+            const childEl = child;
+            if (SUPPORTED_TAGS.has(childEl.nodeName)) {
+                node.childNodes.push(traverseTree(childEl, contentNodes));
+            }
+        }
+        else if (child.nodeType === 3 && child.nodeValue) {
+            node.childNodes.push({
+                id: shortId(), tagName: 'TEXT', attributes: {},
+                innerText: child.nodeValue, parentId: node.id, childNodes: [],
+            });
+        }
+    }
+    return node;
+}
+//# sourceMappingURL=article-body.js.map

package/dist/article-body.js.map

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

package/dist/base-client.d.ts

@@ -0,0 +1,42 @@
+import type { HttpClient, HttpResponse } from './http-client.js';
+import type { RequestOpts } from './types/request-opts.js';
+import { Paginator } from './paginator.js';
+/**
+ * Base client for all CMS resource clients. Provides standard CRUD operations.
+ * Subclasses override methods to add typed query params and payloads.
+ *
+ * All methods accept an optional `RequestOpts` as the last argument
+ * for per-request signal, timeout control.
+ *
+ * Supports: signal, timeout on all methods. Retries: yes (5xx/network).
+ */
+export declare class BaseClient<TGet, TList = unknown, TCreate = unknown, TUpdate = unknown> {
+    protected readonly http: HttpClient;
+    protected readonly resource: string;
+    constructor(http: HttpClient, resource: string);
+    /**
+     * Fetch a single resource by ID.
+     * @throws {NotFoundError} If the resource does not exist (404).
+     * @throws {AuthError} On authentication failure (401).
+     */
+    get(id: number | string, opts?: RequestOpts): Promise<TGet>;
+    /** List resources. Override in subclasses with typed query params. */
+    list(_query?: unknown, opts?: RequestOpts): Promise<TList>;
+    /** Create a resource. Override in subclasses with typed payload. */
+    create(body: unknown, opts?: RequestOpts): Promise<TCreate>;
+    /** Full update (PUT). Override in subclasses with typed payload. */
+    update(id: number | string, body: unknown, opts?: RequestOpts): Promise<TUpdate>;
+    /** @internal Direct PATCH — use .update() instead (safe fetch-merge-put). */
+    protected partialUpdate(id: number | string, body: unknown, opts?: RequestOpts): Promise<TUpdate>;
+    /** Delete a resource by ID. */
+    delete(id: number | string, opts?: RequestOpts): Promise<unknown>;
+    protected buildPath(base: string, params?: unknown): string;
+    protected rawGet<R>(path: string, opts?: RequestOpts): Promise<HttpResponse<R>>;
+    protected rawPost<R>(path: string, body?: unknown, opts?: RequestOpts): Promise<HttpResponse<R>>;
+    /** Create a Paginator from a list method. Subclasses provide the extractor for their response shape. */
+    protected createPaginator<TItem, TQuery extends Record<string, unknown>>(query: TQuery | undefined, listFn: (q: TQuery, opts?: RequestOpts) => Promise<unknown>, extract: (res: unknown) => {
+        items: TItem[];
+        total?: number;
+    }, defaultSize: number, opts?: RequestOpts): Paginator<TItem>;
+}
+//# sourceMappingURL=base-client.d.ts.map

package/dist/base-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.d.ts","sourceRoot":"","sources":["../src/base-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;GAQG;AACH,qBAAa,UAAU,CACrB,IAAI,EACJ,KAAK,GAAG,OAAO,EACf,OAAO,GAAG,OAAO,EACjB,OAAO,GAAG,OAAO;IAGf,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU;IACnC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM;gBADhB,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM;IAGrC;;;;OAIG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,sEAAsE;IAChE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;IAIhE,oEAAoE;IAC9D,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjE,oEAAoE;IAC9D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAItF,6EAA6E;cAC7D,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvG,+BAA+B;IACzB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvE,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM;IAiB3D,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAI/E,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAIhG,wGAAwG;IACxG,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,EAC3D,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK;QAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAC7D,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,WAAW,GACjB,SAAS,CAAC,KAAK,CAAC;CAQpB"}

package/dist/base-client.js

@@ -0,0 +1,83 @@
+import { Paginator } from './paginator.js';
+/**
+ * Base client for all CMS resource clients. Provides standard CRUD operations.
+ * Subclasses override methods to add typed query params and payloads.
+ *
+ * All methods accept an optional `RequestOpts` as the last argument
+ * for per-request signal, timeout control.
+ *
+ * Supports: signal, timeout on all methods. Retries: yes (5xx/network).
+ */
+export class BaseClient {
+    http;
+    resource;
+    constructor(http, resource) {
+        this.http = http;
+        this.resource = resource;
+    }
+    /**
+     * Fetch a single resource by ID.
+     * @throws {NotFoundError} If the resource does not exist (404).
+     * @throws {AuthError} On authentication failure (401).
+     */
+    async get(id, opts) {
+        return (await this.http.get(`${this.resource}/${id}`, opts)).data;
+    }
+    /** List resources. Override in subclasses with typed query params. */
+    async list(_query, opts) {
+        return (await this.http.get(this.resource, opts)).data;
+    }
+    /** Create a resource. Override in subclasses with typed payload. */
+    async create(body, opts) {
+        return (await this.http.post(this.resource, body, opts)).data;
+    }
+    /** Full update (PUT). Override in subclasses with typed payload. */
+    async update(id, body, opts) {
+        return (await this.http.put(`${this.resource}/${id}`, body, opts)).data;
+    }
+    /** @internal Direct PATCH — use .update() instead (safe fetch-merge-put). */
+    async partialUpdate(id, body, opts) {
+        return (await this.http.patch(`${this.resource}/${id}`, body, opts)).data;
+    }
+    /** Delete a resource by ID. */
+    async delete(id, opts) {
+        return (await this.http.delete(`${this.resource}/${id}`, opts)).data;
+    }
+    buildPath(base, params) {
+        if (!params || typeof params !== 'object' || Object.keys(params).length === 0)
+            return base;
+        const sp = new URLSearchParams();
+        for (const [k, v] of Object.entries(params)) {
+            if (v === undefined || v === null)
+                continue;
+            if (Array.isArray(v)) {
+                if (v.length > 0)
+                    sp.append(k, v.join(','));
+            }
+            else if (typeof v === 'object') {
+                sp.append(k, JSON.stringify(v));
+            }
+            else {
+                sp.append(k, String(v));
+            }
+        }
+        const qs = sp.toString();
+        return qs ? `${base}?${qs}` : base;
+    }
+    rawGet(path, opts) {
+        return this.http.get(path, opts);
+    }
+    rawPost(path, body, opts) {
+        return this.http.post(path, body, opts);
+    }
+    /** Create a Paginator from a list method. Subclasses provide the extractor for their response shape. */
+    createPaginator(query, listFn, extract, defaultSize, opts) {
+        const size = query?.size ?? defaultSize;
+        return new Paginator(async (page, reqOpts) => {
+            const res = await listFn({ ...query, size, page }, reqOpts);
+            const { items, total } = extract(res);
+            return { items, total, page, pageSize: size, done: items.length < size || (total != null && (page + 1) * size >= total) };
+        }, 0, opts);
+    }
+}
+//# sourceMappingURL=base-client.js.map

package/dist/base-client.js.map

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

package/dist/clients/composer/article-type.d.ts

@@ -0,0 +1,11 @@
+import { BaseClient } from '../../base-client.js';
+import type { HttpClient } from '../../http-client.js';
+import type { RequestOpts } from '../../types/request-opts.js';
+import type { Paginator } from '../../paginator.js';
+import type { ArticleTypeGetByIdResponse, ArticleTypeListGetResponse, ArticleTypeQueryParameters, ArticleTypeCreatedResponse, ArticleTypeUpdateResponse } from '../../types/index.js';
+export declare class ArticleTypeClient extends BaseClient<ArticleTypeGetByIdResponse, ArticleTypeListGetResponse, ArticleTypeCreatedResponse, ArticleTypeUpdateResponse> {
+    constructor(http: HttpClient);
+    list(query?: ArticleTypeQueryParameters, opts?: RequestOpts): Promise<ArticleTypeListGetResponse>;
+    paginate(query?: Omit<ArticleTypeQueryParameters, 'page'>, opts?: RequestOpts): Paginator<any>;
+}
+//# sourceMappingURL=article-type.d.ts.map

package/dist/clients/composer/article-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-type.d.ts","sourceRoot":"","sources":["../../../src/clients/composer/article-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEtL,qBAAa,iBAAkB,SAAQ,UAAU,CAAC,0BAA0B,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,yBAAyB,CAAC;gBAClJ,IAAI,EAAE,UAAU;IAEb,IAAI,CAAC,KAAK,CAAC,EAAE,0BAA0B,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAKhH,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,CAAC;CAG/F"}

package/dist/clients/composer/article-type.js

@@ -0,0 +1,12 @@
+import { BaseClient } from '../../base-client.js';
+export class ArticleTypeClient extends BaseClient {
+    constructor(http) { super(http, 'article-types'); }
+    async list(query, opts) {
+        const path = this.buildPath(this.resource, query);
+        return (await this.rawGet(path, opts)).data;
+    }
+    paginate(query, opts) {
+        return this.createPaginator(query, (q, o) => this.list(q, o), (res) => ({ items: res.data ?? [], total: res.meta?.page?.total }), 25, opts);
+    }
+}
+//# sourceMappingURL=article-type.js.map

package/dist/clients/composer/article-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-type.js","sourceRoot":"","sources":["../../../src/clients/composer/article-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAMlD,MAAM,OAAO,iBAAkB,SAAQ,UAAyH;IAC9J,YAAY,IAAgB,IAAI,KAAK,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAEtD,KAAK,CAAC,IAAI,CAAC,KAAkC,EAAE,IAAkB;QACxE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAClD,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,CAA6B,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,CAAC;IAED,QAAQ,CAAC,KAAgD,EAAE,IAAkB;QAC3E,OAAO,IAAI,CAAC,eAAe,CAAC,KAAY,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,GAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IACjK,CAAC;CACF"}

package/dist/clients/composer/article.d.ts

@@ -0,0 +1,36 @@
+import { BaseClient } from '../../base-client.js';
+import type { HttpClient } from '../../http-client.js';
+import type { RequestOpts } from '../../types/request-opts.js';
+import type { Paginator } from '../../paginator.js';
+import type { ArticleGetByIdResponse, ArticleListGetResponse, ArticleListQueryParameters, ArticleCreatePayload, ArticleCreateResponse, ArticlePublishPayload, ArticlePublishResponse, ArticleUpdatePayload, ArticleUpdateResponse, ArticlePartialUpdatePayload, ArticleUnpublishResponse, ArticleScheduleResponse, ArticleUnscheduleResponse, ArticleRevisionGetResponse, ArticleGetWithBodyResponse, RelatedArticlesGetResponse, RelatedArticlesQueryParameters, ArticlePreviewDataPayload, ArticlePreviewDataResponse, ArticlePreviewUrlPayload, ArticlePreviewUrlResponse } from '../../types/index.js';
+import type { ArticleListItem } from '../../types/composer/article/response.js';
+import type { WorkflowModel } from '../../types/composer/workflow/model.js';
+export declare class ArticleClient extends BaseClient<ArticleGetByIdResponse, ArticleListGetResponse, ArticleCreateResponse, ArticleUpdateResponse> {
+    constructor(http: HttpClient);
+    create(body: ArticleCreatePayload, opts?: RequestOpts): Promise<ArticleCreateResponse>;
+    /** Safe update. Fetches the latest revision, merges changes, then saves via PUT. */
+    update(id: number | string, body: ArticleUpdatePayload, opts?: RequestOpts): Promise<ArticleUpdateResponse>;
+    list(query?: ArticleListQueryParameters, opts?: RequestOpts): Promise<ArticleListGetResponse>;
+    paginate(query?: Omit<ArticleListQueryParameters, 'page'>, opts?: RequestOpts): Paginator<ArticleListItem>;
+    publish(id: number, revisionId: number, payload: ArticlePublishPayload, opts?: RequestOpts): Promise<ArticlePublishResponse>;
+    /** @internal Direct PATCH for internal use by partialUpdateAndPublish. */
+    protected partialUpdate(id: number | string, body: ArticlePartialUpdatePayload, opts?: RequestOpts): Promise<ArticleUpdateResponse>;
+    unpublish(id: number, opts?: RequestOpts): Promise<ArticleUnpublishResponse>;
+    schedule(id: number, revisionId: number, opts?: RequestOpts): Promise<ArticleScheduleResponse>;
+    unschedule(id: number, opts?: RequestOpts): Promise<ArticleUnscheduleResponse>;
+    getRevisionById(versionId: number, opts?: RequestOpts): Promise<ArticleRevisionGetResponse>;
+    private getArticleWithLatestRevision;
+    private getLatestRevision;
+    getWithBody(id: number | string, opts?: RequestOpts): Promise<ArticleGetWithBodyResponse>;
+    getRelated(query: RelatedArticlesQueryParameters, opts?: RequestOpts): Promise<RelatedArticlesGetResponse>;
+    getPreviewData(payload: ArticlePreviewDataPayload, opts?: RequestOpts): Promise<ArticlePreviewDataResponse>;
+    getPreviewUrl(id: number, payload: ArticlePreviewUrlPayload, opts?: RequestOpts): Promise<ArticlePreviewUrlResponse>;
+    createAndPublish(payload: ArticleCreatePayload, activeWorkflow: WorkflowModel, opts?: RequestOpts): Promise<void>;
+    /** Safe update: fetch latest revision, merge changes, save via PUT, then publish. */
+    updateAndPublish(id: number, payload: ArticleUpdatePayload, activeWorkflow: WorkflowModel, opts?: RequestOpts): Promise<void>;
+    partialUpdateAndPublish(id: number, payload: ArticlePartialUpdatePayload, opts?: RequestOpts): Promise<void>;
+    partialUpdateAndPublish(id: number, payload: ArticlePartialUpdatePayload, activeWorkflow: WorkflowModel, opts?: RequestOpts): Promise<void>;
+    unpublishAndDelete(id: number, opts?: RequestOpts): Promise<void>;
+    private putRevision;
+}
+//# sourceMappingURL=article.d.ts.map

package/dist/clients/composer/article.d.ts.map

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