@terminalfour/terminalfour-js 1.0.0-rc.1

package/dist/cjs/element-resolver.js

@@ -0,0 +1,391 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ElementResolver = void 0;
+const utils_js_1 = require("./utils.js");
+/** Checks if a value is a SectionContentLinkInput */
+function isSectionContentLinkInput(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        'sectionId' in value);
+}
+/** Checks if a value is a FileInput object (has a `file` property) */
+function isFileInput(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        'file' in value);
+}
+/** Checks if a value is a MediaElementUpload */
+function isMediaElementUpload(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        'file' in value &&
+        'name' in value &&
+        'category' in value);
+}
+/**
+ * Resolves developer-friendly field values to T4 API element format.
+ * Handles list lookups, date conversion, repeater building, etc.
+ */
+class ElementResolver {
+    constructor(httpClient, _defaultLanguage, typeRegistry, mediaCreateFn) {
+        this.listCache = new utils_js_1.TtlMap();
+        this.httpClient = httpClient;
+        this.typeRegistry = typeRegistry;
+        this.mediaCreateFn = mediaCreateFn ?? null;
+    }
+    /**
+     * Resolves a single field value based on its element type.
+     * Uses the TypeRegistry to look up type names instead of hardcoded IDs.
+     */
+    async resolveValue(value, element, language, allElements, context) {
+        const typeName = await this.typeRegistry.getNameById(element.type);
+        switch (typeName) {
+            case 'Plain Text':
+                return value;
+            case 'HTML':
+                return this.revertHtmlSsLinks(value, language, context);
+            case 'Image':
+            case 'File':
+                return this.resolveFileUpload(value, element);
+            case 'Date':
+                return this.resolveDate(value);
+            case 'Check Box':
+            case 'Multiple Select':
+                return this.resolveCheckbox(value, element.listId, language, element.alias || element.name);
+            case 'Select Box':
+                return this.resolveSingleList(value, element.listId, language, element.alias || element.name);
+            case 'Radio Button':
+                return this.resolveSingleList(value, element.listId, language, element.alias || element.name);
+            case 'Cascading List':
+                return this.resolveCascadingList(value, element.listId, language, element.alias || element.name);
+            case 'Media':
+                if (isMediaElementUpload(value)) {
+                    if (!this.mediaCreateFn) {
+                        throw new Error('Inline media upload is not available. Pass a media ID instead.');
+                    }
+                    const mediaId = await this.mediaCreateFn(value);
+                    return String(mediaId);
+                }
+                return String(value);
+            case 'Decimal Number':
+                return value;
+            case 'Whole Number':
+                return value;
+            case 'Section/Content Link':
+                return this.resolveSectionContentLink(value, language, context);
+            case 'Multi-select List':
+                return this.resolveMultiSelect(value, element.listId, language, element.alias || element.name);
+            case 'Content Owner':
+                return String(value);
+            case 'Group Select':
+                return this.resolveGroupSelect(value);
+            case 'Keyword Selector':
+                return this.resolveKeywordSelector(value, element.listId, language);
+            case 'Repeater':
+                return value; // handled separately in buildElements
+            default:
+                return value;
+        }
+    }
+    // ── List fetching ──
+    async getList(listId, language) {
+        const cached = this.listCache.get(listId);
+        if (cached)
+            return cached;
+        const list = await this.httpClient.request({
+            method: 'GET',
+            path: `/list/${listId}/${language}?override=false`,
+        });
+        this.listCache.set(listId, list);
+        return list;
+    }
+    async resolveItemName(name, listId, language, elementName, allowFreeText = false) {
+        // Already in listId:itemId format
+        if (/^\d+:\d+$/.test(name))
+            return name;
+        const list = await this.getList(listId, language);
+        const item = list.items.find((i) => i.name.toLowerCase() === name.toLowerCase());
+        if (!item) {
+            // Keyword selectors allow free text values that aren't in the list
+            if (allowFreeText)
+                return name;
+            const validNames = list.items.map((i) => `"${i.name}"`).join(', ');
+            const fieldContext = elementName ? ` for field "${elementName}"` : '';
+            throw new Error(`Invalid list value "${name}"${fieldContext}. Valid options are: ${validNames}`);
+        }
+        return `${list.id}:${item.id}`;
+    }
+    // ── Type resolvers ──
+    resolveDate(value) {
+        if (value instanceof Date)
+            return value.getTime();
+        if (typeof value === 'number')
+            return value;
+        if (typeof value === 'string')
+            return new Date(value).getTime();
+        return 0;
+    }
+    /** Select Box, Radio Button — single list value: "listId:itemId" */
+    async resolveSingleList(value, listId, language, elementName) {
+        return this.resolveItemName(String(value), listId, language, elementName);
+    }
+    /** Checkbox, Multiple Select — "listId:id1,id2" */
+    async resolveCheckbox(value, listId, language, elementName) {
+        const items = Array.isArray(value) ? value : [value];
+        const list = await this.getList(listId, language);
+        const ids = [];
+        for (const item of items) {
+            const str = String(item);
+            const found = list.items.find((i) => i.name.toLowerCase() === str.toLowerCase());
+            if (!found) {
+                const validNames = list.items.map((i) => `"${i.name}"`).join(', ');
+                const fieldContext = elementName ? ` for field "${elementName}"` : '';
+                throw new Error(`Invalid list value "${str}"${fieldContext}. Valid options are: ${validNames}`);
+            }
+            ids.push(found.id);
+        }
+        return ids.length > 0 ? `${list.id}:${ids.join(',')}` : '';
+    }
+    /** Multi-Select — "listId:id1;listId:id2" */
+    async resolveMultiSelect(value, listId, language, elementName) {
+        const items = Array.isArray(value) ? value : [value];
+        const list = await this.getList(listId, language);
+        const parts = [];
+        for (const item of items) {
+            const str = String(item);
+            const found = list.items.find((i) => i.name.toLowerCase() === str.toLowerCase());
+            if (!found) {
+                const validNames = list.items.map((i) => `"${i.name}"`).join(', ');
+                const fieldContext = elementName ? ` for field "${elementName}"` : '';
+                throw new Error(`Invalid list value "${str}"${fieldContext}. Valid options are: ${validNames}`);
+            }
+            parts.push(`${list.id}:${found.id}`);
+        }
+        return parts.join(';');
+    }
+    /** Cascading List — "listId1:itemId1, listId2:itemId2" */
+    async resolveCascadingList(value, listId, language, elementName) {
+        const items = Array.isArray(value) ? value : [value];
+        const parts = [];
+        let currentListId = listId;
+        for (const item of items) {
+            const str = String(item);
+            if (/^\d+:\d+$/.test(str)) {
+                parts.push(str);
+                const list = await this.getList(currentListId, language);
+                const matched = list.items.find((i) => `${list.id}:${i.id}` === str);
+                if (matched && matched.sublist)
+                    currentListId = matched.sublist;
+                continue;
+            }
+            const list = await this.getList(currentListId, language);
+            const found = list.items.find((i) => i.name.toLowerCase() === str.toLowerCase());
+            if (!found) {
+                const validNames = list.items.map((i) => `"${i.name}"`).join(', ');
+                const fieldContext = elementName ? ` for field "${elementName}"` : '';
+                throw new Error(`Invalid cascading list value "${str}"${fieldContext}. Valid options at this level are: ${validNames}`);
+            }
+            parts.push(`${list.id}:${found.id}`);
+            if (found.sublist)
+                currentListId = found.sublist;
+        }
+        return parts.join(', ');
+    }
+    /** Group Select — comma-separated group IDs */
+    resolveGroupSelect(value) {
+        if (Array.isArray(value))
+            return value.join(',');
+        return String(value);
+    }
+    /** Keyword Selector — OR items comma-separated, AND groups with && */
+    async resolveKeywordSelector(value, listId, language) {
+        // If it's a plain string, pass through (already formatted or simple free text)
+        if (typeof value === 'string')
+            return value;
+        const input = value;
+        if (!input?.or)
+            return String(value);
+        const parts = [];
+        for (const item of input.or) {
+            if (typeof item === 'string') {
+                // Single OR item — resolve from list or pass as free text
+                parts.push(await this.resolveItemName(item, listId, language, undefined, true));
+            }
+            else if (item && typeof item === 'object' && 'and' in item) {
+                // AND group — resolve each item and join with &&
+                const andParts = [];
+                for (const andItem of item.and) {
+                    andParts.push(await this.resolveItemName(andItem, listId, language, undefined, true));
+                }
+                parts.push(andParts.join('&&'));
+            }
+        }
+        return parts.join(',');
+    }
+    /** File/Image — upload file via POST /upload/ and return element value */
+    async resolveFileUpload(value, element) {
+        // If already in the API format (has code property), pass through
+        if (value && typeof value === 'object' && 'code' in value) {
+            return value;
+        }
+        // If it's just a file path string, wrap it as FileInput
+        if (typeof value === 'string' && !value.startsWith('{')) {
+            value = { file: value };
+        }
+        if (!isFileInput(value))
+            return value;
+        const filename = (0, utils_js_1.deriveFilename)(value);
+        const blob = await (0, utils_js_1.resolveFileToBlob)(value.file);
+        const formData = new FormData();
+        formData.append('file', blob, filename);
+        formData.append('filename', filename);
+        formData.append('elementID', String(element.id));
+        const response = await this.httpClient.request({
+            method: 'POST',
+            path: '/upload/',
+            multipart: true,
+            formData,
+        });
+        return {
+            existingFile: false,
+            code: response.code,
+            preferredFilename: response.name,
+        };
+    }
+    /** Section/Content Link — create SS record and return T4 tag */
+    async resolveSectionContentLink(value, language, context) {
+        // Already a T4 tag string — pass through
+        if (typeof value === 'string')
+            return value;
+        if (!isSectionContentLinkInput(value) || !context)
+            return String(value ?? '');
+        const toSectionId = value.sectionId;
+        const toContentId = value.contentId ?? 0;
+        // Get the target section's path and name
+        const targetSection = await this.httpClient.request({
+            method: 'GET',
+            path: `/hierarchy/${toSectionId}/${language}`,
+        });
+        // Build link text: use provided, or content name, or section name
+        let linkText = value.linkText;
+        if (!linkText) {
+            if (toContentId) {
+                // Fetch content name
+                const content = await this.httpClient.request({
+                    method: 'GET',
+                    path: `/content/${toSectionId}/${toContentId}/${language}`,
+                });
+                linkText = content.name;
+            }
+            else {
+                linkText = targetSection.name;
+            }
+        }
+        // Build path — append content name for content links
+        let path = targetSection.path || targetSection.name;
+        if (toContentId && linkText) {
+            path = `${path} » ${linkText}`;
+        }
+        // Create the SS record
+        const sslResponse = await this.httpClient.request({
+            method: 'PUT',
+            path: '/ssl',
+            body: {
+                useDefaultLinkText: false,
+                fromSection: context.fromSectionId,
+                toSection: toSectionId,
+                fromContent: context.fromContentId,
+                toContent: toContentId,
+                linkText,
+                language,
+                toLanguage: language,
+                attributes: null,
+                path,
+                active: true,
+            },
+        });
+        return `<t4 sslink_id="${sslResponse.id}" type="sslink" />`;
+    }
+    /**
+     * Reverts friendly anchor elements in HTML back to T4 SS link tags.
+     * - Existing links (data-t4-sslink="39") → `<t4 type="sslink" sslink_id="39"/>`
+     * - New links (no data-t4-sslink or data-t4-sslink="new") → creates SS record via PUT /ssl, then inserts the tag
+     */
+    async revertHtmlSsLinks(value, language, context) {
+        if (typeof value !== 'string')
+            return value;
+        // Quick check — if no data-section-id attribute, pass through unchanged
+        if (!value.includes('data-section-id'))
+            return value;
+        const regex = new RegExp(ElementResolver.SSLINK_ANCHOR_REGEX.source, ElementResolver.SSLINK_ANCHOR_REGEX.flags);
+        const matches = [];
+        let match;
+        while ((match = regex.exec(value)) !== null) {
+            const full = match[0];
+            const innerText = match[2];
+            const sectionId = parseInt(match[1], 10);
+            // Extract data-t4-sslink, data-content-id, and data-linktext from the tag
+            const sslIdMatch = full.match(/data-t4-sslink="([^"]*)"/);
+            const contentMatch = full.match(/data-content-id="(\d+)"/);
+            const linkTextMatch = full.match(/data-linktext="([^"]*)"/);
+            // data-linktext takes priority (even if empty string) over inner text
+            const linkText = linkTextMatch !== null ? linkTextMatch[1] : innerText;
+            matches.push({
+                full,
+                sslId: sslIdMatch ? sslIdMatch[1] : '',
+                linkText,
+                sectionId,
+                contentId: contentMatch ? parseInt(contentMatch[1], 10) : 0,
+            });
+        }
+        if (matches.length === 0)
+            return value;
+        // Process each match
+        let result = value;
+        for (const { full, sslId, linkText, sectionId, contentId } of matches) {
+            let t4Tag;
+            if (sslId && sslId !== 'new' && /^\d+$/.test(sslId)) {
+                // Existing SS link — just revert to T4 tag with the known ID
+                t4Tag = `<t4 type="sslink" sslink_id="${sslId}"/>`;
+            }
+            else if (context && sectionId) {
+                // New SS link — create the SS record
+                const targetSection = await this.httpClient.request({
+                    method: 'GET',
+                    path: `/hierarchy/${sectionId}/${language}`,
+                });
+                const path = contentId && linkText
+                    ? `${targetSection.path || targetSection.name} &raquo; ${linkText}`
+                    : targetSection.path || targetSection.name;
+                const sslResponse = await this.httpClient.request({
+                    method: 'PUT',
+                    path: '/ssl',
+                    body: {
+                        useDefaultLinkText: false,
+                        fromSection: context.fromSectionId,
+                        toSection: sectionId,
+                        fromContent: context.fromContentId,
+                        toContent: contentId,
+                        linkText,
+                        language,
+                        toLanguage: language,
+                        attributes: null,
+                        path,
+                        active: true,
+                    },
+                });
+                t4Tag = `<t4 type="sslink" sslink_id="${sslResponse.id}"/>`;
+            }
+            else {
+                // No context to create — leave as-is (shouldn't happen in normal flow)
+                continue;
+            }
+            result = result.replace(full, t4Tag);
+        }
+        return result;
+    }
+}
+exports.ElementResolver = ElementResolver;
+/** Regex to match anchor tags that are SS link markers (have data-section-id attribute) */
+ElementResolver.SSLINK_ANCHOR_REGEX = /<a\s+[^>]*data-section-id="(\d+)"[^>]*>([^<]*)<\/a>/gi;
+//# sourceMappingURL=element-resolver.js.map

package/dist/cjs/element-resolver.js.map

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

package/dist/cjs/errors.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Error class for T4 API errors.
+ * Thrown when the API returns a non-ok HTTP response or a network error occurs.
+ */
+export declare class T4ApiError extends Error {
+    readonly statusCode: number;
+    readonly statusText: string;
+    readonly responseBody: unknown;
+    readonly requestUrl: string;
+    readonly requestMethod: string;
+    constructor(params: {
+        statusCode: number;
+        statusText: string;
+        responseBody: unknown;
+        requestUrl: string;
+        requestMethod: string;
+        /** The original error that caused this API error (e.g. network failure). */
+        cause?: Error;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/cjs/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAEnB,MAAM,EAAE;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,OAAO,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,4EAA4E;QAC5E,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;CAUF"}

package/dist/cjs/errors.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.T4ApiError = void 0;
+/**
+ * Error class for T4 API errors.
+ * Thrown when the API returns a non-ok HTTP response or a network error occurs.
+ */
+class T4ApiError extends Error {
+    constructor(params) {
+        const message = `T4 API error: ${params.requestMethod} ${params.requestUrl} responded with ${params.statusCode} ${params.statusText}`;
+        super(message, params.cause ? { cause: params.cause } : undefined);
+        this.name = 'T4ApiError';
+        this.statusCode = params.statusCode;
+        this.statusText = params.statusText;
+        this.responseBody = params.responseBody;
+        this.requestUrl = params.requestUrl;
+        this.requestMethod = params.requestMethod;
+    }
+}
+exports.T4ApiError = T4ApiError;
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,UAAW,SAAQ,KAAK;IAOnC,YAAY,MAQX;QACC,MAAM,OAAO,GAAG,iBAAiB,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,UAAU,mBAAmB,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtI,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IAC5C,CAAC;CACF;AAzBD,gCAyBC"}

package/dist/cjs/handlebars.d.ts

@@ -0,0 +1,123 @@
+import { HttpClient } from './http-client.js';
+import { ContentDTO } from './types.js';
+/** Summary returned from list() */
+export interface HandlebarsItemSummary {
+    id: number;
+    name: string;
+    lastModified: Date | null;
+}
+/** Configuration for a handlebars content resource (helpers or partials) */
+interface HandlebarsResourceConfig {
+    /** Config endpoint path for the section ID (e.g. '/config/handlebars.helpersSectionId') */
+    sectionIdConfigPath: string;
+    /** Config option name for the section ID (e.g. 'handlebars.helpersSectionId') */
+    sectionIdOptionName: string;
+    /** Config endpoint path for the content type ID */
+    contentTypeIdConfigPath: string;
+    /** Config option name for the content type ID */
+    contentTypeIdOptionName: string;
+    /** The element name that holds the code (e.g. 'function code' or 'code') */
+    codeElementName: string;
+    /** Display name for error messages (e.g. 'Helper' or 'Partial') */
+    displayName: string;
+}
+/**
+ * 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 declare class HandlebarsItem {
+    readonly id: number;
+    name: string;
+    code: string;
+    readonly lastModified: Date | null;
+    private readonly _httpClient;
+    private readonly _sectionId;
+    private readonly _language;
+    private readonly _codeElementName;
+    private _rawDTO;
+    constructor(dto: ContentDTO, httpClient: HttpClient, sectionId: number, language: string, codeElementName: string);
+    /**
+     * Persists changes to name and/or code back to the server.
+     * Always saves with approved status.
+     */
+    save(): Promise<void>;
+    /** Extracts the code value from the raw elements map */
+    private extractCode;
+}
+/**
+ * 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 declare class HandlebarsContentResource {
+    private readonly httpClient;
+    private readonly config;
+    private sectionIdPromise;
+    private sectionIdExpiresAt;
+    private sectionIdEpoch;
+    private contentTypeIdPromise;
+    private contentTypeIdExpiresAt;
+    private contentTypeIdEpoch;
+    constructor(httpClient: HttpClient, config: HandlebarsResourceConfig);
+    /** Fetches and caches the section ID */
+    private getSectionId;
+    /** Fetches and caches the content type ID */
+    private getContentTypeId;
+    /**
+     * Lists all items (summaries only: id, name, lastModified).
+     */
+    list(): Promise<HandlebarsItemSummary[]>;
+    /**
+     * 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.
+     */
+    private resolveId;
+    /**
+     * Retrieves a single item by name or ID. Returns a mutable HandlebarsItem.
+     */
+    get(nameOrId: string | number): Promise<HandlebarsItem>;
+    /**
+     * Creates a new item. Always created as approved.
+     * Throws if an item with the same name already exists.
+     * Returns a mutable HandlebarsItem.
+     */
+    create(data: {
+        name: string;
+        code: string;
+    }): Promise<HandlebarsItem>;
+    /**
+     * Updates an item's name and/or code (immutable pattern).
+     * Accepts a name or ID. Fetches existing, merges changes, saves. Always approved.
+     */
+    update(nameOrId: string | number, data: {
+        name?: string;
+        code?: string;
+    }): Promise<HandlebarsItem>;
+    /**
+     * Deletes an item by name or ID (soft delete — sets to inactive).
+     */
+    delete(nameOrId: string | number): Promise<void>;
+    /**
+     * Permanently removes an item by name or ID.
+     */
+    purge(nameOrId: string | number): Promise<void>;
+}
+/** A mutable Handlebars Custom Helper (alias for HandlebarsItem) */
+export type Helper = HandlebarsItem;
+/** A mutable Handlebars Partial (alias for HandlebarsItem) */
+export type Partial = HandlebarsItem;
+/** Summary returned from helpers.list() */
+export type HelperSummary = HandlebarsItemSummary;
+/** Summary returned from partials.list() */
+export type PartialSummary = HandlebarsItemSummary;
+/**
+ * The `t4.handlebars` namespace — provides access to helpers and partials.
+ */
+export declare class Handlebars {
+    readonly helpers: HandlebarsContentResource;
+    readonly partials: HandlebarsContentResource;
+    constructor(httpClient: HttpClient);
+}
+export {};
+//# sourceMappingURL=handlebars.d.ts.map

package/dist/cjs/handlebars.d.ts.map

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