@twinfinity/twin 6.0.1 → 6.0.2

package/dist/TwinClient.js

@@ -1,12 +1,15 @@
 import { HttpMethod } from '@twinfinity/authentication';
 import { readT8ClientModelWithFactories, readT8ClientModelWithGeometry, readT8GIModelWithFactories, T8EntityType, T8GIMeshDescriptor, T8GIStyle, T8GIRegion, T8Product, T8Project, T8Unit } from '@twinfinity/t8-client-model';
-import { TwinValidationError, TwinConflictError, TwinNotFoundError, ProcessorNotFoundError, AssetValidationError, AssetForbiddenError, AssetConflictError, AssetNotFoundError, AssetBatchError, TwinFileValidationError, TwinFileConflictError, TwinFileNotFoundError } from './errors';
+import { TwinValidationError, TwinConflictError, TwinNotFoundError, ProcessorNotFoundError, AssetValidationError, AssetForbiddenError, AssetConflictError, AssetNotFoundError, AssetAttachmentConflictError, AssetAttachmentNotFoundError, AssetBatchError, TwinFileValidationError, TwinFileConflictError, TwinFileNotFoundError, AssetCategoryValidationError, AssetCategoryConflictError, AssetCategoryNotFoundError, AssetCategoryForbiddenError, AssetTypeValidationError, AssetTypeConflictError, AssetTypeNotFoundError, AssetTypeForbiddenError, AssetCatalogTooLargeError, isAssetCatalogTooLargeErrorBody, TwinUnauthenticatedError, readErrorBody } from './errors';
 export class TwinClient {
     _httpClient;
     _baseUrl;
+    _assetTypeCatalogUrl;
     constructor(baseUrl, _httpClient) {
         this._httpClient = _httpClient;
-        this._baseUrl = `${baseUrl}/_ps/twins`;
+        const base = String(baseUrl).replace(/\/+$/, '');
+        this._baseUrl = `${base}/_ps/twins`;
+        this._assetTypeCatalogUrl = `${base}/_ps/asset-type-catalog`;
     }
     async listTwins(relatedTo, page = undefined, limit = 100, signal) {
         const params = new URLSearchParams();
@@ -18,14 +21,14 @@ export class TwinClient {
             params.set('limit', limit.toString());
         const url = params.toString() ? `${this._baseUrl}?${params}` : this._baseUrl;
         const response = await this._httpClient.fetch(HttpMethod.Get, url, {
-            headers: { 'Content-Type': 'application/json' },
+            headers: { Accept: 'application/json' },
             signal
         });
         if (response.ok) {
             return (await response.json());
         }
         if (response.status === 400) {
-            const errorBody = await response.json();
+            const errorBody = await readErrorBody(response);
             throw new TwinValidationError(`Twin listing validation failed: ${errorBody.detail}`, errorBody);
         }
         const errorText = await response.text();
@@ -50,7 +53,7 @@ export class TwinClient {
         const twinId = typeof twin === 'string' ? twin : twin.id;
         const specifiedVersion = typeof twin === 'string' ? undefined : twin.version;
         const response = await this._httpClient.fetch(HttpMethod.Get, `${this._baseUrl}/${twinId}${specifiedVersion !== undefined ? `/versions/${specifiedVersion}` : ''}`, {
-            headers: { 'Content-Type': 'application/json' },
+            headers: { Accept: 'application/json' },
             signal
         });
         if (response.ok) {
@@ -72,14 +75,14 @@ export class TwinClient {
             params.set('includeDeleted', 'true');
         const url = `${this._baseUrl}/${id}/versions${params.toString() ? `?${params}` : ''}`;
         const response = await this._httpClient.fetch(HttpMethod.Get, url, {
-            headers: { 'Content-Type': 'application/json' },
+            headers: { Accept: 'application/json' },
             signal
         });
         if (response.ok) {
             return (await response.json());
         }
         if (response.status === 400) {
-            const errorBody = await response.json();
+            const errorBody = await readErrorBody(response);
             throw new TwinValidationError(`Twin listing validation failed: ${errorBody.detail}`, errorBody);
         }
         const errorText = await response.text();
@@ -243,7 +246,7 @@ export class TwinClient {
             return (await response.json());
         }
         if (response.status === 400) {
-            const errorBody = await response.json();
+            const errorBody = await readErrorBody(response);
             throw new TwinValidationError(`Twin validation failed: ${errorBody.detail}`, errorBody);
         }
         if (response.status === 409) {
@@ -295,7 +298,7 @@ export class TwinClient {
         throw new Error(`Failed to restore twin: ${response.status} ${response.statusText} - ${errorText}`);
     }
     async getTwinVersionContent(twinId, twinVersion, signal) {
-        const response = await this._httpClient.fetch(HttpMethod.Get, `${this._baseUrl}/${twinId}/versions/${twinVersion}/contents`, { headers: { 'Content-Type': 'application/json' }, signal });
+        const response = await this._httpClient.fetch(HttpMethod.Get, `${this._baseUrl}/${twinId}/versions/${twinVersion}/contents`, { headers: { Accept: 'application/json' }, signal });
         if (response.ok) {
             return (await response.json());
         }
@@ -307,7 +310,7 @@ export class TwinClient {
     }
     async getTwinContent(twinId, signal) {
         const response = await this._httpClient.fetch(HttpMethod.Get, `${this._baseUrl}/${twinId}/contents`, {
-            headers: { 'Content-Type': 'application/json' },
+            headers: { Accept: 'application/json' },
             signal
         });
         if (response.ok) {
@@ -321,7 +324,7 @@ export class TwinClient {
     }
     async getTwinDiagnostics(twinId, signal) {
         const response = await this._httpClient.fetch(HttpMethod.Get, `${this._baseUrl}/${twinId}/diagnostics`, {
-            headers: { 'Content-Type': 'application/json' },
+            headers: { Accept: 'application/json' },
             signal
         });
         if (response.ok) {
@@ -334,7 +337,7 @@ export class TwinClient {
         throw new Error(`Failed to get twin diagnostics: ${response.status} ${response.statusText} - ${errorText}`);
     }
     async getTwinVersionDiagnostics(twinId, twinVersion, signal) {
-        const response = await this._httpClient.fetch(HttpMethod.Get, `${this._baseUrl}/${twinId}/versions/${twinVersion}/diagnostics`, { headers: { 'Content-Type': 'application/json' }, signal });
+        const response = await this._httpClient.fetch(HttpMethod.Get, `${this._baseUrl}/${twinId}/versions/${twinVersion}/diagnostics`, { headers: { Accept: 'application/json' }, signal });
         if (response.ok) {
             return (await response.json());
         }
@@ -347,14 +350,14 @@ export class TwinClient {
     async getTwinVersionEvents(twinId, twinVersion, offset = 0, limit = 100, signal) {
         const url = `${this._baseUrl}/${twinId}/versions/${twinVersion}/events?offset=${offset}&limit=${limit}`;
         const response = await this._httpClient.fetch(HttpMethod.Get, url, {
-            headers: { 'Content-Type': 'application/json' },
+            headers: { Accept: 'application/json' },
             signal
         });
         if (response.ok) {
             return (await response.json());
         }
         if (response.status === 400) {
-            const errorBody = await response.json();
+            const errorBody = await readErrorBody(response);
             throw new TwinValidationError(`Twin events validation failed: ${errorBody.detail}`, errorBody);
         }
         if (response.status === 404) {
@@ -366,14 +369,14 @@ export class TwinClient {
     async getProcessorEvents(twinId, twinVersion, processorId, offset = 0, limit = 100, signal) {
         const url = `${this._baseUrl}/${twinId}/versions/${twinVersion}/processors/${processorId}/events?offset=${offset}&limit=${limit}`;
         const response = await this._httpClient.fetch(HttpMethod.Get, url, {
-            headers: { 'Content-Type': 'application/json' },
+            headers: { Accept: 'application/json' },
             signal
         });
         if (response.ok) {
             return (await response.json());
         }
         if (response.status === 400) {
-            const errorBody = await response.json();
+            const errorBody = await readErrorBody(response);
             throw new TwinValidationError(`Processor events validation failed: ${errorBody.detail}`, errorBody);
         }
         if (response.status === 404) {
@@ -386,14 +389,14 @@ export class TwinClient {
         const includeDeleted = options?.includeDeleted ?? false;
         const params = `offset=${offset}&limit=${limit}${includeDeleted ? '&includeDeleted=true' : ''}`;
         const response = await this._httpClient.fetch(HttpMethod.Get, `${this._baseUrl}/${twinId}/assets?${params}`, {
-            headers: { 'Content-Type': 'application/json' },
+            headers: { Accept: 'application/json' },
             signal
         });
         if (response.ok) {
             return (await response.json());
         }
         if (response.status === 400) {
-            const errorBody = await response.json();
+            const errorBody = await readErrorBody(response);
             throw new AssetValidationError(`Asset listing validation failed: ${errorBody.detail}`, errorBody);
         }
         if (response.status === 404) {
@@ -404,7 +407,7 @@ export class TwinClient {
     }
     async getAsset(twinId, assetId, signal) {
         const response = await this._httpClient.fetch(HttpMethod.Get, `${this._baseUrl}/${twinId}/assets/${assetId}`, {
-            headers: { 'Content-Type': 'application/json' },
+            headers: { Accept: 'application/json' },
             signal
         });
         if (response.ok) {
@@ -426,7 +429,7 @@ export class TwinClient {
             return (await response.json());
         }
         if (response.status === 400) {
-            const errorBody = await response.json();
+            const errorBody = await readErrorBody(response);
             throw new AssetValidationError(`Asset validation failed: ${errorBody.detail}`, errorBody);
         }
         const errorText = await response.text();
@@ -446,7 +449,7 @@ export class TwinClient {
             throw new AssetConflictError('Asset has been modified by another user', conflictedAsset);
         }
         if (response.status === 400) {
-            const errorBody = await response.json();
+            const errorBody = await readErrorBody(response);
             throw new AssetValidationError(`Asset validation failed: ${errorBody.detail}`, errorBody);
         }
         const errorText = await response.text();
@@ -499,7 +502,7 @@ export class TwinClient {
             return (await response.json());
         }
         if (response.status === 400) {
-            const errorBody = await response.json();
+            const errorBody = await readErrorBody(response);
             throw new AssetValidationError(`Asset batch validation failed: ${errorBody.detail}`, errorBody);
         }
         if (response.status === 403) {
@@ -523,12 +526,163 @@ export class TwinClient {
             return (await response.json());
         }
         if (response.status === 400) {
-            const errorBody = await response.json();
+            const errorBody = await readErrorBody(response);
             throw new AssetValidationError(`Asset batch-get validation failed: ${errorBody.detail}`, errorBody);
         }
         const errorText = await response.text();
         throw new Error(`Failed to batch-get assets: ${response.status} ${response.statusText} - ${errorText}`);
     }
+    // ────────── Asset attachments ──────────
+    async listAssetAttachments(twinId, assetId, options, signal) {
+        const params = new URLSearchParams();
+        if (options?.includeDeleted)
+            params.set('includeDeleted', 'true');
+        if (options?.offset !== undefined)
+            params.set('offset', String(options.offset));
+        if (options?.limit !== undefined)
+            params.set('limit', String(options.limit));
+        if (options?.page)
+            params.set('page', options.page);
+        const url = `${this._baseUrl}/${twinId}/assets/${assetId}/attachments${params.toString() ? `?${params}` : ''}`;
+        const response = await this._httpClient.fetch(HttpMethod.Get, url, {
+            headers: { Accept: 'application/json' },
+            signal
+        });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 404)
+            throw new AssetNotFoundError(`Asset ${assetId} not found`);
+        if (response.status === 400) {
+            const errorBody = await readErrorBody(response);
+            throw new AssetValidationError(`Attachment listing failed: ${errorBody.detail}`, errorBody);
+        }
+        const errorText = await response.text();
+        throw new Error(`Failed to list attachments: ${response.status} ${response.statusText} - ${errorText}`);
+    }
+    async getAssetAttachmentBlob(twinId, assetId, attachmentId, signal) {
+        const response = await this._httpClient.fetch(HttpMethod.Get, `${this._baseUrl}/${twinId}/assets/${assetId}/attachments/${attachmentId}`, { signal });
+        if (response.ok)
+            return response;
+        if (response.status === 404)
+            throw new AssetAttachmentNotFoundError(`Attachment ${attachmentId} not found`);
+        const errorText = await response.text();
+        throw new Error(`Failed to fetch attachment blob: ${response.status} ${response.statusText} - ${errorText}`);
+    }
+    async createAssetAttachmentUploadSession(twinId, assetId, attachmentId, body, signal) {
+        const response = await this._httpClient.fetch(HttpMethod.Post, `${this._baseUrl}/${twinId}/assets/${assetId}/attachments/${attachmentId}/createAttachmentUploadSession`, {
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+            signal
+        });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 409) {
+            const conflicted = (await response.json());
+            throw new AssetAttachmentConflictError(`Attachment ${attachmentId} already exists; pick a new id for retries`, conflicted);
+        }
+        if (response.status === 404)
+            throw new AssetNotFoundError(`Asset ${assetId} not found`);
+        if (response.status === 400) {
+            const errorBody = await readErrorBody(response);
+            throw new AssetValidationError(`Upload session creation failed: ${errorBody.detail}`, errorBody);
+        }
+        const errorText = await response.text();
+        throw new Error(`Failed to create upload session: ${response.status} ${response.statusText} - ${errorText}`);
+    }
+    async uploadAssetAttachmentFile(session, file, signal) {
+        // The token is encoded as a query param on the upload URL; we lift it
+        // out for the caller so they can poll uploadStatus without re-parsing.
+        const tokenMatch = session.uploadUrl.match(/token=([^&]+)/);
+        if (!tokenMatch) {
+            throw new Error(`Upload session URL is missing a token query parameter: ${session.uploadUrl}`);
+        }
+        const token = tokenMatch[1];
+        const chunkSize = Math.max(1, session.maxChunkSize || file.size);
+        const total = file.size;
+        let offset = 0;
+        // Even an empty file needs at least one PUT so the upload session
+        // gets a finalize signal. uploadChunks() in the integration tests
+        // unconditionally PUTs at least one chunk too.
+        do {
+            const end = Math.min(offset + chunkSize, total);
+            const chunk = file.slice(offset, end);
+            const lastByte = Math.max(0, end - 1);
+            const response = await this._httpClient.fetch(HttpMethod.Put, session.uploadUrl, {
+                headers: { 'Content-Range': `bytes ${offset}-${lastByte}/${total}` },
+                body: chunk,
+                signal
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Upload chunk failed at offset ${offset}: ${response.status} ${response.statusText} - ${errorText}`);
+            }
+            offset = end;
+        } while (offset < total);
+        return { token };
+    }
+    async getAssetAttachmentUploadStatus(twinId, assetId, token, signal) {
+        const response = await this._httpClient.fetch(HttpMethod.Get, `${this._baseUrl}/${twinId}/assets/${assetId}/attachments/uploadStatus/${encodeURIComponent(token)}`, { headers: { Accept: 'application/json' }, signal });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 404)
+            return { status: 'NotFound' };
+        const errorText = await response.text();
+        throw new Error(`Failed to get upload status: ${response.status} ${response.statusText} - ${errorText}`);
+    }
+    async putAssetAttachment(twinId, assetId, attachmentId, body, signal) {
+        const response = await this._httpClient.fetch(HttpMethod.Put, `${this._baseUrl}/${twinId}/assets/${assetId}/attachments/${attachmentId}`, {
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+            signal
+        });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 409) {
+            const conflicted = (await response.json());
+            throw new AssetAttachmentConflictError('Attachment has been modified by another user', conflicted);
+        }
+        if (response.status === 404)
+            throw new AssetAttachmentNotFoundError(`Attachment ${attachmentId} not found`);
+        if (response.status === 400) {
+            const errorBody = await readErrorBody(response);
+            throw new AssetValidationError(`Attachment update failed: ${errorBody.detail}`, errorBody);
+        }
+        const errorText = await response.text();
+        throw new Error(`Failed to update attachment: ${response.status} ${response.statusText} - ${errorText}`);
+    }
+    async deleteAssetAttachment(twinId, assetId, attachmentId, etag, signal) {
+        const response = await this._httpClient.fetch(HttpMethod.Delete, `${this._baseUrl}/${twinId}/assets/${assetId}/attachments/${attachmentId}`, {
+            headers: { 'If-Match': etag },
+            signal
+        });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 409) {
+            const conflicted = (await response.json());
+            throw new AssetAttachmentConflictError('Attachment has been modified by another user', conflicted);
+        }
+        if (response.status === 404)
+            throw new AssetAttachmentNotFoundError(`Attachment ${attachmentId} not found`);
+        const errorText = await response.text();
+        throw new Error(`Failed to delete attachment: ${response.status} ${response.statusText} - ${errorText}`);
+    }
+    async restoreAssetAttachment(twinId, assetId, attachmentId, etag, signal) {
+        const response = await this._httpClient.fetch(HttpMethod.Put, `${this._baseUrl}/${twinId}/assets/${assetId}/attachments/${attachmentId}/restore`, {
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ etag }),
+            signal
+        });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 409) {
+            const conflicted = (await response.json());
+            throw new AssetAttachmentConflictError('Attachment has been modified by another user', conflicted);
+        }
+        if (response.status === 404)
+            throw new AssetAttachmentNotFoundError(`Attachment ${attachmentId} not found`);
+        const errorText = await response.text();
+        throw new Error(`Failed to restore attachment: ${response.status} ${response.statusText} - ${errorText}`);
+    }
     async listTwinFiles(twinId, options = {}, signal) {
         const { includeDeleted = false, checkedIn = false, version, page = undefined, limit = 100 } = options;
         if (version !== undefined && !checkedIn) {
@@ -549,14 +703,14 @@ export class TwinClient {
             ? `${this._baseUrl}/${twinId}/files?${params}`
             : `${this._baseUrl}/${twinId}/files`;
         const response = await this._httpClient.fetch(HttpMethod.Get, url, {
-            headers: { 'Content-Type': 'application/json' },
+            headers: { Accept: 'application/json' },
             signal
         });
         if (response.ok) {
             return (await response.json());
         }
         if (response.status === 400) {
-            const errorBody = await response.json();
+            const errorBody = await readErrorBody(response);
             throw new TwinFileValidationError(`Twin file listing validation failed: ${errorBody.detail}`, errorBody);
         }
         const errorText = await response.text();
@@ -564,7 +718,7 @@ export class TwinClient {
     }
     async getTwinFile(twinId, fileId, signal) {
         const response = await this._httpClient.fetch(HttpMethod.Get, `${this._baseUrl}/${twinId}/files/${fileId}`, {
-            headers: { 'Content-Type': 'application/json' },
+            headers: { Accept: 'application/json' },
             signal
         });
         if (response.ok) {
@@ -590,7 +744,7 @@ export class TwinClient {
             return (await response.json());
         }
         if (response.status === 400) {
-            const errorBody = await response.json();
+            const errorBody = await readErrorBody(response);
             throw new TwinFileValidationError(`Twin file validation failed`, errorBody);
         }
         if (response.status === 409) {
@@ -681,7 +835,7 @@ export class TwinClient {
             return (await response.json());
         }
         if (response.status === 400) {
-            const errorBody = await response.json();
+            const errorBody = await readErrorBody(response);
             throw new TwinFileValidationError(`Twin file version listing validation failed: ${errorBody.detail}`, errorBody);
         }
         const errorText = await response.text();
@@ -712,5 +866,297 @@ export class TwinClient {
             signal
         });
     }
+    // ---------- Asset categories ----------
+    async getMyPermissions(signal) {
+        const url = `${this._baseUrl}/permissions/me`;
+        const response = await this._httpClient.fetch(HttpMethod.Get, url, {
+            headers: { Accept: 'application/json' },
+            signal
+        });
+        if (response.ok) {
+            return (await response.json());
+        }
+        // 401: no valid auth context. Throw so consumers can redirect to
+        // login / refresh tokens rather than mistake an expired session for
+        // "logged-in user with no grants."
+        if (response.status === 401) {
+            throw new TwinUnauthenticatedError('Not authenticated');
+        }
+        // 403: authenticated but no Twin-service capabilities. Surface as an
+        // empty array so consumers can treat it like a logged-in user with
+        // zero grants.
+        if (response.status === 403) {
+            return { permissions: [] };
+        }
+        throw new Error(`Failed to fetch permissions: ${response.status} ${response.statusText}`);
+    }
+    async getAssetTypeMetaSchema(signal) {
+        const url = `${this._assetTypeCatalogUrl}/meta-schema`;
+        const response = await this._httpClient.fetch(HttpMethod.Get, url, {
+            headers: { Accept: 'application/schema+json, application/json' },
+            signal
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to fetch meta-schema: ${response.status} ${response.statusText}`);
+        }
+        return (await response.json());
+    }
+    async listAssetCategories(options, signal) {
+        const params = new URLSearchParams();
+        if (options?.page !== undefined)
+            params.set('page', options.page);
+        if (options?.limit !== undefined)
+            params.set('limit', options.limit.toString());
+        if (options?.includeDeleted)
+            params.set('includeDeleted', 'true');
+        const url = params.toString()
+            ? `${this._assetTypeCatalogUrl}/categories?${params}`
+            : `${this._assetTypeCatalogUrl}/categories`;
+        const response = await this._httpClient.fetch(HttpMethod.Get, url, {
+            headers: { Accept: 'application/json' },
+            signal
+        });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 403)
+            throw new AssetCategoryForbiddenError('Asset category listing forbidden');
+        if (response.status === 400) {
+            const errorBody = await readErrorBody(response);
+            throw new AssetCategoryValidationError(`Asset category listing failed: ${errorBody.detail}`, errorBody);
+        }
+        throw new Error(`Failed to list asset categories: ${response.status} ${response.statusText}`);
+    }
+    async getAssetCategory(categoryId, signal) {
+        const response = await this._httpClient.fetch(HttpMethod.Get, `${this._assetTypeCatalogUrl}/categories/${categoryId}`, {
+            headers: { Accept: 'application/json' },
+            signal
+        });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 403)
+            throw new AssetCategoryForbiddenError(`Asset category ${categoryId} read forbidden`);
+        if (response.status === 404)
+            throw new AssetCategoryNotFoundError(`Asset category ${categoryId} not found`);
+        throw new Error(`Failed to get asset category: ${response.status} ${response.statusText}`);
+    }
+    async putAssetCategory(categoryId, body, signal) {
+        const response = await this._httpClient.fetch(HttpMethod.Put, `${this._assetTypeCatalogUrl}/categories/${categoryId}`, {
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+            signal
+        });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 403)
+            throw new AssetCategoryForbiddenError('Asset category upsert forbidden');
+        if (response.status === 409) {
+            const current = (await response.json());
+            throw new AssetCategoryConflictError('Asset category was modified by another user', current);
+        }
+        if (response.status === 400) {
+            const errorBody = await readErrorBody(response);
+            throw new AssetCategoryValidationError(`Asset category validation failed: ${errorBody.detail}`, errorBody);
+        }
+        const errorText = await response.text();
+        throw new Error(`Failed to upsert asset category: ${response.status} ${response.statusText} - ${errorText}`);
+    }
+    async deleteAssetCategory(categoryId, etag, signal) {
+        return this._categoryDeleteOrRestore(categoryId, etag, /*isRestore*/ false, signal);
+    }
+    async restoreAssetCategory(categoryId, etag, signal) {
+        return this._categoryDeleteOrRestore(categoryId, etag, /*isRestore*/ true, signal);
+    }
+    async _categoryDeleteOrRestore(categoryId, etag, isRestore, signal) {
+        const url = isRestore
+            ? `${this._assetTypeCatalogUrl}/categories/${categoryId}/restore`
+            : `${this._assetTypeCatalogUrl}/categories/${categoryId}`;
+        const method = isRestore ? HttpMethod.Put : HttpMethod.Delete;
+        const response = await this._httpClient.fetch(method, url, {
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ etag }),
+            signal
+        });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 403) {
+            const op = isRestore ? 'restore' : 'delete';
+            throw new AssetCategoryForbiddenError(`Asset category ${op} forbidden`);
+        }
+        if (response.status === 409) {
+            const current = (await response.json());
+            throw new AssetCategoryConflictError('Asset category was modified by another user', current);
+        }
+        if (response.status === 404)
+            throw new AssetCategoryNotFoundError(`Asset category ${categoryId} not found`);
+        const errorText = await response.text();
+        const op = isRestore ? 'restore' : 'delete';
+        throw new Error(`Failed to ${op} asset category: ${response.status} ${response.statusText} - ${errorText}`);
+    }
+    async listAssetCategoryVersions(categoryId, options, signal) {
+        const params = new URLSearchParams();
+        if (options?.page !== undefined)
+            params.set('page', options.page);
+        if (options?.limit !== undefined)
+            params.set('limit', options.limit.toString());
+        if (options?.includeDeleted)
+            params.set('includeDeleted', 'true');
+        const baseUrl = `${this._assetTypeCatalogUrl}/categories/${categoryId}/versions`;
+        const url = params.toString() ? `${baseUrl}?${params}` : baseUrl;
+        const response = await this._httpClient.fetch(HttpMethod.Get, url, {
+            headers: { Accept: 'application/json' },
+            signal
+        });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 403)
+            throw new AssetCategoryForbiddenError('Asset category version listing forbidden');
+        if (response.status === 400) {
+            const errorBody = await readErrorBody(response);
+            throw new AssetCategoryValidationError(`Asset category version listing failed: ${errorBody.detail}`, errorBody);
+        }
+        if (response.status === 404)
+            throw new AssetCategoryNotFoundError(`Asset category ${categoryId} not found`);
+        throw new Error(`Failed to list asset category versions: ${response.status} ${response.statusText}`);
+    }
+    // ---------- Asset types ----------
+    async listAssetTypes(categoryId, options, signal) {
+        const params = new URLSearchParams();
+        if (options?.page !== undefined)
+            params.set('page', options.page);
+        if (options?.limit !== undefined)
+            params.set('limit', options.limit.toString());
+        if (options?.includeDeleted)
+            params.set('includeDeleted', 'true');
+        const baseUrl = `${this._assetTypeCatalogUrl}/categories/${categoryId}/types`;
+        const url = params.toString() ? `${baseUrl}?${params}` : baseUrl;
+        const response = await this._httpClient.fetch(HttpMethod.Get, url, {
+            headers: { Accept: 'application/json' },
+            signal
+        });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 403)
+            throw new AssetTypeForbiddenError('Asset type listing forbidden');
+        if (response.status === 400) {
+            const errorBody = await readErrorBody(response);
+            throw new AssetTypeValidationError(`Asset type listing failed: ${errorBody.detail}`, errorBody);
+        }
+        throw new Error(`Failed to list asset types: ${response.status} ${response.statusText}`);
+    }
+    async getAssetType(categoryId, typeId, signal) {
+        const response = await this._httpClient.fetch(HttpMethod.Get, `${this._assetTypeCatalogUrl}/categories/${categoryId}/types/${typeId}`, { headers: { Accept: 'application/json' }, signal });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 403)
+            throw new AssetTypeForbiddenError(`Asset type ${typeId} read forbidden`);
+        if (response.status === 404)
+            throw new AssetTypeNotFoundError(`Asset type ${typeId} not found`);
+        throw new Error(`Failed to get asset type: ${response.status} ${response.statusText}`);
+    }
+    async listAssetTypeVersions(categoryId, typeId, options, signal) {
+        const params = new URLSearchParams();
+        if (options?.page !== undefined)
+            params.set('page', options.page);
+        if (options?.limit !== undefined)
+            params.set('limit', options.limit.toString());
+        if (options?.includeDeleted)
+            params.set('includeDeleted', 'true');
+        const baseUrl = `${this._assetTypeCatalogUrl}/categories/${categoryId}/types/${typeId}/versions`;
+        const url = params.toString() ? `${baseUrl}?${params}` : baseUrl;
+        const response = await this._httpClient.fetch(HttpMethod.Get, url, {
+            headers: { Accept: 'application/json' },
+            signal
+        });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 403)
+            throw new AssetTypeForbiddenError('Asset type version listing forbidden');
+        if (response.status === 400) {
+            const errorBody = await readErrorBody(response);
+            throw new AssetTypeValidationError(`Asset type version listing failed: ${errorBody.detail}`, errorBody);
+        }
+        if (response.status === 404)
+            throw new AssetTypeNotFoundError(`Asset type ${typeId} not found`);
+        throw new Error(`Failed to list asset type versions: ${response.status} ${response.statusText}`);
+    }
+    async putAssetType(categoryId, typeId, body, signal) {
+        const response = await this._httpClient.fetch(HttpMethod.Put, `${this._assetTypeCatalogUrl}/categories/${categoryId}/types/${typeId}`, {
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+            signal
+        });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 403)
+            throw new AssetTypeForbiddenError('Asset type upsert forbidden');
+        if (response.status === 409) {
+            const current = (await response.json());
+            throw new AssetTypeConflictError('Asset type was modified by another user', current);
+        }
+        if (response.status === 400) {
+            const errorBody = await readErrorBody(response);
+            throw new AssetTypeValidationError(`Asset type validation failed: ${errorBody.detail}`, errorBody);
+        }
+        const errorText = await response.text();
+        throw new Error(`Failed to upsert asset type: ${response.status} ${response.statusText} - ${errorText}`);
+    }
+    async deleteAssetType(categoryId, typeId, etag, signal) {
+        return this._typeDeleteOrRestore(categoryId, typeId, etag, /*isRestore*/ false, signal);
+    }
+    async restoreAssetType(categoryId, typeId, etag, signal) {
+        return this._typeDeleteOrRestore(categoryId, typeId, etag, /*isRestore*/ true, signal);
+    }
+    async _typeDeleteOrRestore(categoryId, typeId, etag, isRestore, signal) {
+        const url = isRestore
+            ? `${this._assetTypeCatalogUrl}/categories/${categoryId}/types/${typeId}/restore`
+            : `${this._assetTypeCatalogUrl}/categories/${categoryId}/types/${typeId}`;
+        const method = isRestore ? HttpMethod.Put : HttpMethod.Delete;
+        const response = await this._httpClient.fetch(method, url, {
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ etag }),
+            signal
+        });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 403) {
+            const op = isRestore ? 'restore' : 'delete';
+            throw new AssetTypeForbiddenError(`Asset type ${op} forbidden`);
+        }
+        if (response.status === 409) {
+            const current = (await response.json());
+            throw new AssetTypeConflictError('Asset type was modified by another user', current);
+        }
+        if (response.status === 404)
+            throw new AssetTypeNotFoundError(`Asset type ${typeId} not found`);
+        const errorText = await response.text();
+        const op = isRestore ? 'restore' : 'delete';
+        throw new Error(`Failed to ${op} asset type: ${response.status} ${response.statusText} - ${errorText}`);
+    }
+    async getAssetTypeCatalog(signal) {
+        const response = await this._httpClient.fetch(HttpMethod.Get, this._assetTypeCatalogUrl, {
+            headers: { Accept: 'application/json' },
+            signal
+        });
+        if (response.ok)
+            return (await response.json());
+        if (response.status === 403)
+            throw new AssetCategoryForbiddenError('Asset type catalog read forbidden');
+        if (response.status === 400) {
+            // The server emits a single structured 400 here today —
+            // `cause: 'CatalogTooLarge'` — to flag a tenant whose catalog
+            // overflows the per-customer cap. Surface as a typed error so
+            // picker UIs can render "use search" instead of crashing on
+            // missing rows. Any other 400 (malformed CatalogTooLarge body,
+            // future cause) falls through to the generic error below so the
+            // caller still sees the raw response.
+            const errorBody = await readErrorBody(response);
+            if (isAssetCatalogTooLargeErrorBody(errorBody)) {
+                throw new AssetCatalogTooLargeError(`Asset type catalog too large: ${errorBody.detail}`, errorBody);
+            }
+            throw new Error(`Failed to get asset-type catalog: ${response.status} ${response.statusText} - ${errorBody.detail}`);
+        }
+        const errorText = await response.text();
+        throw new Error(`Failed to get asset-type catalog: ${response.status} ${response.statusText} - ${errorText}`);
+    }
 }
 //# sourceMappingURL=TwinClient.js.map