@terminalfour/terminalfour-js 1.0.0-rc.1

package/dist/esm/handlebars.js

@@ -0,0 +1,300 @@
+import { DEFAULT_CACHE_TTL, getCacheEpoch } from './utils.js';
+/**
+ * A mutable Handlebars item (helper or partial).
+ * Modify `name` and/or `code`, then call `save()` to persist.
+ * All saves are automatically set to approved status.
+ */
+export class HandlebarsItem {
+    constructor(dto, httpClient, sectionId, language, codeElementName) {
+        this.id = dto.id;
+        this.name = dto.name;
+        this.lastModified = dto.lastModified ? new Date(dto.lastModified) : null;
+        // Extract the code field value from elements
+        this.code = this.extractCode(dto.elements, codeElementName) ?? '';
+        Object.defineProperty(this, '_httpClient', { value: httpClient, enumerable: false });
+        Object.defineProperty(this, '_sectionId', { value: sectionId, enumerable: false });
+        Object.defineProperty(this, '_language', { value: language, enumerable: false });
+        Object.defineProperty(this, '_codeElementName', { value: codeElementName, enumerable: false });
+        Object.defineProperty(this, '_rawDTO', { value: dto, enumerable: false, writable: true });
+    }
+    /**
+     * Persists changes to name and/or code back to the server.
+     * Always saves with approved status.
+     */
+    async save() {
+        // Update elements with current name and code
+        const elements = { ...this._rawDTO.elements };
+        for (const key of Object.keys(elements)) {
+            if (key.toLowerCase().startsWith('name#')) {
+                elements[key] = this.name;
+            }
+            else if (key.toLowerCase().startsWith(this._codeElementName + '#')) {
+                elements[key] = this.code;
+            }
+        }
+        const response = await this._httpClient.request({
+            method: 'POST',
+            path: `/content/${this._sectionId}/${this.id}/${this._language}`,
+            body: {
+                id: this.id,
+                contentTypeID: this._rawDTO.contentTypeID,
+                name: this.name,
+                language: this._language,
+                status: 0, // approved
+                elements,
+                channels: this._rawDTO.channels,
+                canPublishNow: true,
+                canSaveAndApprove: true,
+                publishDate: this._rawDTO.publishDate ?? null,
+                expiryDate: this._rawDTO.expiryDate ?? null,
+                reviewDate: this._rawDTO.reviewDate ?? null,
+                archiveSection: this._rawDTO.archiveSection ?? null,
+                owner: this._rawDTO.owner ?? { id: 0, type: 'USER' },
+                excludedMirrorSectionIds: [],
+                sectionIDs: [this._sectionId],
+                version: this._rawDTO.version,
+                lastModified: this._rawDTO.lastModified,
+            },
+        });
+        // Update internal state from response
+        this.id = response.id;
+        this.name = response.name;
+        this.lastModified = response.lastModified ? new Date(response.lastModified) : null;
+        this.code = this.extractCode(response.elements, this._codeElementName) ?? this.code;
+        this._rawDTO = response;
+    }
+    /** Extracts the code value from the raw elements map */
+    extractCode(elements, codeElementName) {
+        for (const [key, value] of Object.entries(elements)) {
+            if (key.toLowerCase().startsWith(codeElementName + '#')) {
+                return value ?? null;
+            }
+        }
+        return null;
+    }
+}
+/**
+ * Generic resource for managing Handlebars content items (helpers or partials).
+ * Both share the same pattern: content in a hidden section with name + code fields.
+ */
+export class HandlebarsContentResource {
+    constructor(httpClient, config) {
+        // Cached config values
+        this.sectionIdPromise = null;
+        this.sectionIdExpiresAt = 0;
+        this.sectionIdEpoch = -1;
+        this.contentTypeIdPromise = null;
+        this.contentTypeIdExpiresAt = 0;
+        this.contentTypeIdEpoch = -1;
+        this.httpClient = httpClient;
+        this.config = config;
+    }
+    /** Fetches and caches the section ID */
+    getSectionId() {
+        if (!this.sectionIdPromise || Date.now() > this.sectionIdExpiresAt || this.sectionIdEpoch < getCacheEpoch()) {
+            this.sectionIdExpiresAt = Date.now() + DEFAULT_CACHE_TTL;
+            this.sectionIdEpoch = getCacheEpoch();
+            this.sectionIdPromise = this.httpClient.request({
+                method: 'POST',
+                path: this.config.sectionIdConfigPath,
+                body: {},
+            }).then((res) => {
+                const opt = res.options.find((o) => o.name === this.config.sectionIdOptionName);
+                if (!opt)
+                    throw new Error(`Could not resolve ${this.config.displayName.toLowerCase()} section ID from config`);
+                return Number(opt.value);
+            });
+        }
+        return this.sectionIdPromise;
+    }
+    /** Fetches and caches the content type ID */
+    getContentTypeId() {
+        if (!this.contentTypeIdPromise || Date.now() > this.contentTypeIdExpiresAt || this.contentTypeIdEpoch < getCacheEpoch()) {
+            this.contentTypeIdExpiresAt = Date.now() + DEFAULT_CACHE_TTL;
+            this.contentTypeIdEpoch = getCacheEpoch();
+            this.contentTypeIdPromise = this.httpClient.request({
+                method: 'POST',
+                path: this.config.contentTypeIdConfigPath,
+                body: {},
+            }).then((res) => {
+                const opt = res.options.find((o) => o.name === this.config.contentTypeIdOptionName);
+                if (!opt)
+                    throw new Error(`Could not resolve ${this.config.displayName.toLowerCase()} content type ID from config`);
+                return Number(opt.value);
+            });
+        }
+        return this.contentTypeIdPromise;
+    }
+    /**
+     * Lists all items (summaries only: id, name, lastModified).
+     */
+    async list() {
+        const sectionId = await this.getSectionId();
+        const language = 'en';
+        const response = await this.httpClient.request({
+            method: 'GET',
+            path: `/hierarchy/${sectionId}/${language}/contents?showAll=false&removeNonTranslated=false`,
+        });
+        return (response.children ?? []).map((child) => ({
+            id: child.content.id,
+            name: child.content.name,
+            lastModified: child.content.lastModified ? new Date(child.content.lastModified) : null,
+        }));
+    }
+    /**
+     * Resolves a name or ID to a numeric content ID.
+     * If a string is passed, lists all items and finds by name.
+     * Throws if the name is not found or if multiple items share the same name.
+     */
+    async resolveId(nameOrId) {
+        if (typeof nameOrId === 'number')
+            return nameOrId;
+        const items = await this.list();
+        const matches = items.filter((item) => item.name === nameOrId);
+        if (matches.length === 0) {
+            const available = items.map((i) => `"${i.name}"`).join(', ');
+            throw new Error(`${this.config.displayName} "${nameOrId}" not found. Available: ${available}`);
+        }
+        if (matches.length > 1) {
+            throw new Error(`Multiple ${this.config.displayName.toLowerCase()}s found with name "${nameOrId}" (IDs: ${matches.map((m) => m.id).join(', ')}). Use an ID instead.`);
+        }
+        return matches[0].id;
+    }
+    /**
+     * Retrieves a single item by name or ID. Returns a mutable HandlebarsItem.
+     */
+    async get(nameOrId) {
+        const id = await this.resolveId(nameOrId);
+        const sectionId = await this.getSectionId();
+        const language = 'en';
+        const dto = await this.httpClient.request({
+            method: 'GET',
+            path: `/content/${sectionId}/${id}/${language}`,
+        });
+        return new HandlebarsItem(dto, this.httpClient, sectionId, language, this.config.codeElementName);
+    }
+    /**
+     * Creates a new item. Always created as approved.
+     * Throws if an item with the same name already exists.
+     * Returns a mutable HandlebarsItem.
+     */
+    async create(data) {
+        if (!data.name?.trim())
+            throw new Error(`${this.config.displayName} name is required`);
+        if (!data.code?.trim())
+            throw new Error(`${this.config.displayName} code is required`);
+        // Check for duplicate names
+        const existing = await this.list();
+        const duplicate = existing.find((item) => item.name === data.name);
+        if (duplicate) {
+            throw new Error(`A ${this.config.displayName.toLowerCase()} named "${data.name}" already exists (ID: ${duplicate.id})`);
+        }
+        const [sectionId, contentTypeId] = await Promise.all([
+            this.getSectionId(),
+            this.getContentTypeId(),
+        ]);
+        const language = 'en';
+        // Fetch the content type template to get element keys
+        const template = await this.httpClient.request({
+            method: 'GET',
+            path: `/content/type/${contentTypeId}/${sectionId}`,
+        });
+        const elements = {};
+        for (const el of template.contentType.contentTypeElements) {
+            const key = `${el.name}#${el.id}:${el.type}`;
+            if (el.name.toLowerCase() === 'name') {
+                elements[key] = data.name;
+            }
+            else if (el.name.toLowerCase() === this.config.codeElementName) {
+                elements[key] = data.code;
+            }
+        }
+        const contentId = -Math.floor(Math.random() * 1000000);
+        const dto = await this.httpClient.request({
+            method: 'POST',
+            path: `/content/${sectionId}/${language}`,
+            body: {
+                id: contentId,
+                contentTypeID: contentTypeId,
+                name: data.name,
+                language,
+                status: 0, // approved
+                elements,
+                channels: template.channels,
+                canPublishNow: true,
+                canSaveAndApprove: true,
+                publishDate: null,
+                expiryDate: null,
+                reviewDate: null,
+                archiveSection: null,
+                owner: { id: 0, type: 'USER' },
+                excludedMirrorSectionIds: [],
+            },
+        });
+        return new HandlebarsItem(dto, this.httpClient, sectionId, language, this.config.codeElementName);
+    }
+    /**
+     * Updates an item's name and/or code (immutable pattern).
+     * Accepts a name or ID. Fetches existing, merges changes, saves. Always approved.
+     */
+    async update(nameOrId, data) {
+        const item = await this.get(nameOrId);
+        if (data.name !== undefined)
+            item.name = data.name;
+        if (data.code !== undefined)
+            item.code = data.code;
+        await item.save();
+        return item;
+    }
+    /**
+     * Deletes an item by name or ID (soft delete — sets to inactive).
+     */
+    async delete(nameOrId) {
+        const id = await this.resolveId(nameOrId);
+        const sectionId = await this.getSectionId();
+        const language = 'en';
+        await this.httpClient.request({
+            method: 'DELETE',
+            path: `/content/${sectionId}/${id}/${language}`,
+        });
+    }
+    /**
+     * Permanently removes an item by name or ID.
+     */
+    async purge(nameOrId) {
+        const id = await this.resolveId(nameOrId);
+        const language = 'en';
+        await this.httpClient.request({
+            method: 'POST',
+            path: '/content/purge',
+            body: {
+                languageCode: language,
+                contentIds: [String(id)],
+            },
+        });
+    }
+}
+/**
+ * The `t4.handlebars` namespace — provides access to helpers and partials.
+ */
+export class Handlebars {
+    constructor(httpClient) {
+        this.helpers = new HandlebarsContentResource(httpClient, {
+            sectionIdConfigPath: '/config/handlebars.helpersSectionId',
+            sectionIdOptionName: 'handlebars.helpersSectionId',
+            contentTypeIdConfigPath: '/config/handlebars.helpersContentTypeId',
+            contentTypeIdOptionName: 'handlebars.helpersContentTypeId',
+            codeElementName: 'function code',
+            displayName: 'Helper',
+        });
+        this.partials = new HandlebarsContentResource(httpClient, {
+            sectionIdConfigPath: '/config/handlebars.partialsSectionId',
+            sectionIdOptionName: 'handlebars.partialsSectionId',
+            contentTypeIdConfigPath: '/config/handlebars.partialsContentTypeId',
+            contentTypeIdOptionName: 'handlebars.partialsContentTypeId',
+            codeElementName: 'code',
+            displayName: 'Partial',
+        });
+    }
+}
+//# sourceMappingURL=handlebars.js.map

package/dist/esm/handlebars.js.map

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

package/dist/esm/http-client.d.ts

@@ -0,0 +1,21 @@
+import { HttpRequestOptions } from './types.js';
+/**
+ * Internal HTTP client that handles authentication, URL construction,
+ * content-type headers, JSON/multipart encoding, error wrapping,
+ * and concurrency limiting.
+ */
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly apiToken;
+    private readonly maxConcurrency;
+    private inFlight;
+    private waitQueue;
+    constructor(baseUrl: string, apiToken: string, concurrency?: number);
+    request<T>(options: HttpRequestOptions): Promise<T>;
+    /** Waits until a concurrency slot is available */
+    private acquireSlot;
+    /** Releases a concurrency slot and wakes the next waiter */
+    private releaseSlot;
+    private executeRequest;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/esm/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAOhD;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAyB;gBAE9B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IAM7D,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IASzD,kDAAkD;IAClD,OAAO,CAAC,WAAW;IAanB,4DAA4D;IAC5D,OAAO,CAAC,WAAW;YAML,cAAc;CA4E7B"}

package/dist/esm/http-client.js

@@ -0,0 +1,122 @@
+import { T4ApiError } from './errors.js';
+import { debugWarn } from './utils.js';
+/** Default maximum concurrent requests */
+const DEFAULT_CONCURRENCY = 10;
+/**
+ * Internal HTTP client that handles authentication, URL construction,
+ * content-type headers, JSON/multipart encoding, error wrapping,
+ * and concurrency limiting.
+ */
+export class HttpClient {
+    constructor(baseUrl, apiToken, concurrency) {
+        this.inFlight = 0;
+        this.waitQueue = [];
+        this.baseUrl = baseUrl;
+        this.apiToken = apiToken;
+        this.maxConcurrency = concurrency ?? DEFAULT_CONCURRENCY;
+    }
+    async request(options) {
+        await this.acquireSlot();
+        try {
+            return await this.executeRequest(options);
+        }
+        finally {
+            this.releaseSlot();
+        }
+    }
+    /** Waits until a concurrency slot is available */
+    acquireSlot() {
+        if (this.inFlight < this.maxConcurrency) {
+            this.inFlight++;
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            this.waitQueue.push(() => {
+                this.inFlight++;
+                resolve();
+            });
+        });
+    }
+    /** Releases a concurrency slot and wakes the next waiter */
+    releaseSlot() {
+        this.inFlight--;
+        const next = this.waitQueue.shift();
+        if (next)
+            next();
+    }
+    async executeRequest(options) {
+        const url = this.baseUrl + options.path;
+        const headers = {
+            Authorization: this.apiToken,
+            Accept: 'application/json',
+            ...options.headers,
+        };
+        let body;
+        if (options.multipart && options.formData) {
+            // Let the runtime set Content-Type with the correct boundary
+            body = options.formData;
+        }
+        else if (options.headers?.['Content-Type']?.includes('x-www-form-urlencoded') && typeof options.body === 'string') {
+            // Form-encoded body — pass through as-is, Content-Type already set in headers
+            body = options.body;
+        }
+        else {
+            headers['Content-Type'] = 'application/json;charset=UTF-8';
+            if (options.body !== undefined) {
+                body = JSON.stringify(options.body);
+            }
+        }
+        let response;
+        try {
+            // Debug logging when T4_DEBUG env var is set
+            if (typeof process !== 'undefined' && process.env?.T4_DEBUG === '1') {
+                console.log(`\n[DEBUG] ${options.method} ${url}`);
+                if (body && typeof body === 'string') {
+                    console.log('[DEBUG] Body:', body.substring(0, 3000));
+                }
+            }
+            response = await fetch(url, {
+                method: options.method,
+                headers,
+                body,
+            });
+        }
+        catch (error) {
+            throw new T4ApiError({
+                statusCode: 0,
+                statusText: 'Network Error',
+                responseBody: error instanceof Error ? error.message : String(error),
+                requestUrl: url,
+                requestMethod: options.method,
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+        if (!response.ok) {
+            let responseBody;
+            try {
+                responseBody = await response.json();
+            }
+            catch {
+                responseBody = await response.text().catch(() => null);
+            }
+            throw new T4ApiError({
+                statusCode: response.status,
+                statusText: response.statusText,
+                responseBody,
+                requestUrl: url,
+                requestMethod: options.method,
+            });
+        }
+        const text = await response.text();
+        if (!text)
+            return undefined;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            debugWarn(`Response from ${options.method} ${options.path} is not valid JSON, returning raw text`);
+            return text;
+        }
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/esm/http-client.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,37 @@
+export { T4Client } from './t4-client.js';
+export { T4ApiError } from './errors.js';
+export { ContentItem } from './models/content-item.js';
+export { SectionItem } from './models/section-item.js';
+export { MediaItem } from './models/media-item.js';
+export type { MediaFileInput } from './models/media-item.js';
+export { ContentType } from './resources/content-type-resource.js';
+export { Layout } from './resources/content-type-resource.js';
+export type { ListSummary, ListItemData } from './resources/list-resource.js';
+export { List } from './resources/list-resource.js';
+export type { GroupData, GroupMember } from './resources/group-resource.js';
+export { Group } from './resources/group-resource.js';
+export type { UserData } from './resources/user-resource.js';
+export type { AuthMethods, AuthMethodValue } from './resources/user-resource.js';
+export { User } from './resources/user-resource.js';
+export type { PageLayoutSummary } from './resources/page-layout-resource.js';
+export { PageLayout } from './resources/page-layout-resource.js';
+export type { MediaTypeLayout, MediaTypeData } from './resources/media-type-resource.js';
+export { MediaType, MediaTypeResource } from './resources/media-type-resource.js';
+export type { NavigationType, NavigationSummary, CreateNavigationData, UpdateNavigationData } from './resources/navigation-resource.js';
+export { NavigationResource, NavigationObject, NAVIGATION_TYPE_NAMES } from './resources/navigation-resource.js';
+export { ChannelResource, Channel } from './resources/channel-resource.js';
+export type { ChannelSummary, ChannelLanguage, Microsite } from './resources/channel-resource.js';
+export { Handlebars, HandlebarsItem, HandlebarsContentResource } from './handlebars.js';
+export type { HandlebarsItemSummary, HelperSummary, PartialSummary, Helper, Partial } from './handlebars.js';
+export { SectionRef } from './section-ref.js';
+export type { SectionTreeNode } from './section-ref.js';
+export { SiteStructure } from './site-structure.js';
+export { MediaCategoryRef } from './media-category-ref.js';
+export { MediaCategoryItem } from './models/media-category-item.js';
+export { MediaLibrary } from './media-library.js';
+export type { MediaCategoryNode } from './media-library.js';
+export type { MediaListItem } from './media-category-ref.js';
+export type { T4ClientConfig, LanguageOption, ContentDTO, ContentTypeData, ContentTypeFieldDef, HierarchyNode, GetTreeOptions, AddSectionData, Owner, DateInput, CreateContentData, UpdateContentData, } from './types.js';
+export type { SectionContentLinkInput, MediaElementUpload } from './element-resolver.js';
+export type { FileInput } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAClF,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AACxI,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AACjH,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC3E,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAClG,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACxF,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG7G,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,YAAY,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,cAAc,EACd,KAAK,EACL,SAAS,EACT,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGzF,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,26 @@
+// Main client
+export { T4Client } from './t4-client.js';
+// Error class
+export { T4ApiError } from './errors.js';
+// Models
+export { ContentItem } from './models/content-item.js';
+export { SectionItem } from './models/section-item.js';
+export { MediaItem } from './models/media-item.js';
+export { ContentType } from './resources/content-type-resource.js';
+export { Layout } from './resources/content-type-resource.js';
+export { List } from './resources/list-resource.js';
+export { Group } from './resources/group-resource.js';
+export { User } from './resources/user-resource.js';
+export { PageLayout } from './resources/page-layout-resource.js';
+export { MediaType, MediaTypeResource } from './resources/media-type-resource.js';
+export { NavigationResource, NavigationObject, NAVIGATION_TYPE_NAMES } from './resources/navigation-resource.js';
+export { ChannelResource, Channel } from './resources/channel-resource.js';
+export { Handlebars, HandlebarsItem, HandlebarsContentResource } from './handlebars.js';
+// Section reference
+export { SectionRef } from './section-ref.js';
+export { SiteStructure } from './site-structure.js';
+// Media category reference
+export { MediaCategoryRef } from './media-category-ref.js';
+export { MediaCategoryItem } from './models/media-category-item.js';
+export { MediaLibrary } from './media-library.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAE9D,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAEpD,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAGtD,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAEjE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAElF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AACjH,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAE3E,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAGxF,oBAAoB;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,2BAA2B;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/esm/media-category-ref.d.ts

@@ -0,0 +1,78 @@
+import { HttpClient } from './http-client.js';
+import { LanguageOption } from './types.js';
+import { MediaCategoryItem } from './models/media-category-item.js';
+/** A media item as returned from the category list endpoint */
+export interface MediaListItem {
+    id: number;
+    name: string;
+    description: string;
+    fileName: string;
+    fileSize: string;
+    mediaType: string;
+    language: string;
+    version: string;
+    status: string;
+    lastModified: Date | null;
+}
+/**
+ * A media category reference scoped to a specific category ID.
+ * Provides listing of media items within the category.
+ *
+ * Usage: `t4.mediaCategory(367).list()`
+ */
+export declare class MediaCategoryRef {
+    private readonly httpClient;
+    private readonly categoryId;
+    constructor(httpClient: HttpClient, categoryId: number);
+    /**
+     * Returns a mutable media category object. Modify properties and call save() to persist.
+     */
+    get(options?: LanguageOption): Promise<MediaCategoryItem>;
+    /**
+     * Lists direct child categories (one level below).
+     */
+    subcategories(options?: LanguageOption): Promise<Array<{
+        id: number;
+        name: string;
+        lastModified: Date | null;
+    }>>;
+    /**
+     * Updates this media category's name. Fetches the current category,
+     * merges the change, and PUTs the full body back.
+     * Returns the updated MediaCategoryItem.
+     */
+    update(data: {
+        name: string;
+    }, options?: LanguageOption): Promise<MediaCategoryItem>;
+    /**
+     * Deletes this media category.
+     */
+    delete(): Promise<void>;
+    /**
+     * Permanently removes this media category.
+     * Call delete() first to deactivate it, then purge() to remove it entirely.
+     */
+    purge(options?: LanguageOption): Promise<void>;
+    /**
+     * Moves this media category under a new parent category.
+     */
+    move(newParentId: number, options?: LanguageOption): Promise<void>;
+    /**
+     * Creates a child media category under this category.
+     * Returns the created child as a mutable MediaCategoryItem.
+     */
+    addCategory(data: {
+        name: string;
+    }, options?: LanguageOption): Promise<MediaCategoryItem>;
+    /**
+     * Lists all media items in this category.
+     * Fetches all items in a single request (up to 10000).
+     */
+    list(options?: LanguageOption): Promise<MediaListItem[]>;
+    /**
+     * Builds the DataTables form body for the list endpoint.
+     * Uses a minimal column definition and requests all items.
+     */
+    private buildListFormBody;
+}
+//# sourceMappingURL=media-category-ref.d.ts.map

package/dist/esm/media-category-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-category-ref.d.ts","sourceRoot":"","sources":["../../src/media-category-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAapE,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;CAC3B;AA4BD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM;IAKtD;;OAEG;IACG,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAS/D;;OAEG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAatH;;;;OAIG;IACG,MAAM,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwB1F;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7B;;;OAGG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpD;;OAEG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IASxE;;;OAGG;IACG,WAAW,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA2B/F;;;OAGG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA4B9D;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CAyB1B"}