@terminalfour/terminalfour-js 1.0.0-rc.1

package/dist/esm/resources/media-type-resource.js

@@ -0,0 +1,190 @@
+import { formatFileSize, parseFileSize } from '../utils.js';
+function mapFromDetail(raw) {
+    const layouts = (raw.formatters ?? []).map((f) => ({
+        name: f.mediaLayout,
+        default: f.isDefault,
+    }));
+    const defaultLayout = layouts.find((l) => l.default)?.name ?? '';
+    return {
+        id: raw.id,
+        name: raw.name,
+        extensions: raw.permittedExtensions
+            ? raw.permittedExtensions.split(',').map((s) => s.trim()).filter(Boolean)
+            : [],
+        binary: raw.isBinary,
+        parseForTags: raw.enableParseForTags,
+        maxSize: raw.maxSize > 0 ? formatFileSize(raw.maxSize) : null,
+        layouts,
+        defaultLayout,
+    };
+}
+function mapFromListItem(raw) {
+    const layouts = (raw.formats ?? []).map((f) => ({
+        name: f.mediaLayout,
+        default: f.default,
+    }));
+    const defaultLayout = layouts.find((l) => l.default)?.name ?? '';
+    return {
+        id: raw.id,
+        name: raw.name,
+        extensions: raw.permittedExtensionsFormatted ?? (raw.permittedExtensions
+            ? raw.permittedExtensions.split(',').map((s) => s.trim()).filter(Boolean)
+            : []),
+        binary: raw.binary,
+        parseForTags: raw.parseForTagsEnabled,
+        maxSize: raw.maxSize > 0 ? formatFileSize(raw.maxSize) : null,
+        layouts,
+        defaultLayout,
+    };
+}
+function validateMediaType(data) {
+    if (data.binary && data.parseForTags) {
+        throw new Error('parseForTags cannot be true when binary is true. Tag parsing is only applicable to non-binary (text) media types.');
+    }
+    if (data.layouts && data.layouts.length > 0) {
+        const hasDefault = data.layouts.some((l) => l.default);
+        if (!hasDefault) {
+            throw new Error('At least one layout must be set as default.');
+        }
+    }
+}
+/**
+ * A mutable media type object. Modify properties and call save() to persist.
+ */
+export class MediaType {
+    constructor(data, httpClient) {
+        this.id = data.id;
+        this.name = data.name;
+        this.extensions = data.extensions;
+        this.binary = data.binary;
+        this.parseForTags = data.parseForTags;
+        this.maxSize = data.maxSize;
+        this.layouts = data.layouts;
+        this.defaultLayout = data.defaultLayout;
+        Object.defineProperty(this, '_httpClient', { value: httpClient, enumerable: false });
+    }
+    /** Persists current property values to the server via PUT. */
+    async save() {
+        // Sync defaultLayout into the layouts array
+        if (this.defaultLayout) {
+            for (const layout of this.layouts) {
+                layout.default = layout.name === this.defaultLayout;
+            }
+        }
+        validateMediaType(this);
+        const body = {
+            id: this.id,
+            name: this.name,
+            permittedExtensions: this.extensions.join(','),
+            enableParseForTags: this.parseForTags,
+            maxSize: String(this.maxSize != null ? parseFileSize(this.maxSize) : 0),
+            formatters: this.layouts.map((l) => ({
+                isDefault: l.default,
+                mediaLayout: l.name,
+            })),
+            isBinary: this.binary,
+        };
+        await this._httpClient.request({
+            method: 'PUT',
+            path: `/mediaType/${this.id}`,
+            body,
+        });
+    }
+}
+/**
+ * Resource for media type operations.
+ * Accessible via `t4.mediaTypes`.
+ */
+export class MediaTypeResource {
+    constructor(httpClient) {
+        this.httpClient = httpClient;
+    }
+    /** Lists all media types. */
+    async list() {
+        const raw = await this.httpClient.request({
+            method: 'GET',
+            path: '/mediaType/',
+        });
+        return raw.map((r) => new MediaType(mapFromListItem(r), this.httpClient));
+    }
+    /** Gets a single media type by ID. Returns a mutable MediaType object. */
+    async get(id) {
+        const raw = await this.httpClient.request({
+            method: 'GET',
+            path: `/mediaType/${id}`,
+        });
+        return new MediaType(mapFromDetail(raw), this.httpClient);
+    }
+    /** Updates a media type's properties (immutable pattern). */
+    async update(id, data) {
+        const mt = await this.get(id);
+        if (data.name !== undefined)
+            mt.name = data.name;
+        if (data.extensions !== undefined)
+            mt.extensions = data.extensions;
+        if (data.binary !== undefined)
+            mt.binary = data.binary;
+        if (data.parseForTags !== undefined)
+            mt.parseForTags = data.parseForTags;
+        if (data.maxSize !== undefined)
+            mt.maxSize = data.maxSize != null ? (typeof data.maxSize === 'number' ? formatFileSize(data.maxSize) : data.maxSize) : null;
+        if (data.layouts !== undefined)
+            mt.layouts = data.layouts;
+        if (data.defaultLayout !== undefined)
+            mt.defaultLayout = data.defaultLayout;
+        await mt.save();
+        return mt;
+    }
+    /** Creates a new media type. */
+    async create(data) {
+        if (!data.name?.trim())
+            throw new Error('Media type name is required');
+        if (!data.extensions?.length)
+            throw new Error('At least one file extension is required');
+        if (!data.layouts?.length)
+            throw new Error('At least one layout is required');
+        // If defaultLayout is provided, sync it into the layouts array
+        if (data.defaultLayout) {
+            for (const layout of data.layouts) {
+                layout.default = layout.name === data.defaultLayout;
+            }
+        }
+        const parseForTags = data.parseForTags ?? false;
+        // Validate the explicit combination — throw if user passes conflicting values
+        if (data.binary && data.parseForTags) {
+            throw new Error('parseForTags cannot be true when binary is true. Tag parsing is only applicable to non-binary (text) media types.');
+        }
+        validateMediaType({ binary: data.binary, parseForTags, layouts: data.layouts });
+        const body = {
+            name: data.name,
+            permittedExtensions: data.extensions.join(','),
+            enableParseForTags: parseForTags,
+            maxSize: String(data.maxSize != null ? parseFileSize(data.maxSize) : 0),
+            formatters: data.layouts.map((l) => ({
+                isDefault: l.default,
+                mediaLayout: l.name,
+            })),
+            isBinary: data.binary,
+        };
+        await this.httpClient.request({
+            method: 'POST',
+            path: '/mediaType',
+            body,
+        });
+        // Re-fetch by name to get real ID (create returns id: 0)
+        const all = await this.httpClient.request({
+            method: 'GET',
+            path: '/mediaType/',
+        });
+        const created = all.find((t) => t.name === data.name);
+        if (!created)
+            throw new Error(`Created media type "${data.name}" but could not find it in the listing`);
+        // Fetch full detail by ID
+        const detail = await this.httpClient.request({
+            method: 'GET',
+            path: `/mediaType/${created.id}`,
+        });
+        return new MediaType(mapFromDetail(detail), this.httpClient);
+    }
+}
+//# sourceMappingURL=media-type-resource.js.map

package/dist/esm/resources/media-type-resource.js.map

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