@twinfinity/twin 0.0.0-feature.31596

package/dist/TwinClient.d.ts

@@ -0,0 +1,823 @@
+import { TwinfinityHttpClient } from '@twinfinity/authentication';
+import { T8ClientEntityTypeDTO, T8ClientModelDTO, T8ClientProductConnectionsDTO, T8ClientProductDTO, T8ClientProjectConnectionsDTO, T8ClientProjectDTO, T8ClientUnitDTO, T8EntityType, T8GIMeshDescriptor, T8GIMeshDescriptorDTO, T8GIStyle, T8GIStyleDTO, T8GIRegion, T8GIRegionDTO, T8Product, T8ProductWithGeometry, T8Project, T8Unit } from '@twinfinity/t8-client-model';
+import type { T8ProjectWithGeometry } from '@twinfinity/t8-client-model';
+import type { PaginatedResponse, ListTwinItem, TwinGet, TwinPut, TwinVersionContentResponse, TwinProcessorEvent, TwinDiagnosticsResponse, AssetListItem, AssetGet, AssetPost, AssetPut, AssetBatchOperation, AssetBatchResponse, AssetBatchGetResponse, TwinFileGet, TwinFilePut, TwinFileDelete, TwinFileListOptions, TwinFileVersionListOptions, TwinContentResponse } from './types';
+import type { AssetCategoryGet, AssetCategoryPut, AssetCatalogResponse, AssetTypeGet, AssetTypePut } from './types/asset-types-api';
+import type { AttachmentGet, AttachmentPost, AssetAttachmentPut, ApiCreateUploadSessionResponse, UploadStatusGet } from './types/asset-attachment-api';
+import type { MyPermissions, MyTwinPermissions, TwinGroupGet, TwinGroupsGet, TwinPermissionsPut, TwinPrincipalPermissionsGet, AssetGroupGet, AssetGroupsGet, AssetPermissionsPut, AssetPrincipalPermissionsGet } from './types/twin-permissions-api';
+import { Twin } from './types/Twin';
+import { TwinGeometryInfo } from './types/TwinGeometryInfo';
+export interface ITwinClient {
+    /**
+     * Rooted twins base URL — typically `<host>/sites/<container>/_ps/twins`.
+     * Use this when constructing related URLs (e.g. twin content) that need
+     * to live in the same auth scope as the metadata calls.
+     */
+    readonly baseUrl: string;
+    /**
+     * @param options - `relatedTo` filters by container ID; `includeDeleted` includes soft-deleted twins
+     * (returned redacted, default false); `page`/`limit` control pagination.
+     * @throws {TwinValidationError} On invalid query parameters (400).
+     */
+    listTwins(options?: {
+        relatedTo?: string;
+        includeDeleted?: boolean;
+        page?: string;
+        limit?: number;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<ListTwinItem>>;
+    /**
+     * @deprecated Use the options-object form: `listTwins({ relatedTo, page, limit }, signal)`.
+     * The positional form has no `includeDeleted` parameter; that is only reachable via the options object.
+     */
+    listTwins(relatedTo?: string, page?: string, limit?: number, signal?: AbortSignal): Promise<PaginatedResponse<ListTwinItem>>;
+    /**
+     * Fetches all twins by auto-paginating through {@link listTwins}. Caps at 1000 pages.
+     * @param options - `relatedTo` filters by container ID; `includeDeleted` includes soft-deleted twins
+     * (returned redacted, default false).
+     */
+    listAllTwins(options?: {
+        relatedTo?: string;
+        includeDeleted?: boolean;
+    }, signal?: AbortSignal): Promise<ListTwinItem[]>;
+    /**
+     * @deprecated Use the options-object form: `listAllTwins({ relatedTo }, signal)`.
+     * The positional form has no `includeDeleted` parameter; that is only reachable via the options object.
+     */
+    listAllTwins(relatedTo?: string, signal?: AbortSignal): Promise<ListTwinItem[]>;
+    /**
+     * @param twin - Twin ID string, or `{id, version}` to fetch a specific version.
+     * @throws {TwinNotFoundError} When the twin or version does not exist (404).
+     */
+    getTwin(twin: string | {
+        id: string;
+        version: number;
+    }, signal?: AbortSignal): Promise<TwinGet>;
+    /**
+     * @throws {TwinValidationError} On invalid query parameters (400).
+     */
+    listTwinVersions(id: string, options?: {
+        includeDeleted?: boolean;
+        page?: string;
+        limit?: number;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<ListTwinItem>>;
+    downloadTwinContent(twinId: string, twinVersion: number, content: TwinContentResponse, signal?: AbortSignal): Promise<ArrayBuffer>;
+    /**
+     * Downloads and deserializes the T8 client model (t8cm + t8cm-ext) using default types.
+     * When no version is specified, searches versions newest-first for one containing t8cm content.
+     *
+     * @param twin - Twin ID string, or `{id, version}` to load a specific version.
+     * @throws {Error} When no version has t8cm content.
+     */
+    loadTwin(twin: string | {
+        id: string;
+        version: number;
+    }, signal?: AbortSignal): Promise<Twin<T8Project, T8Product<T8EntityType>, T8EntityType, T8Unit>>;
+    /**
+     * Downloads and deserializes the T8 client model using custom factory functions for domain-specific types.
+     * When no version is specified, searches versions newest-first for one containing t8cm content.
+     *
+     * @param twin - Twin ID string, or `{id, version}` to load a specific version.
+     * @throws {Error} When no version has t8cm content.
+     */
+    loadTwinWithFactories<TProject, TProduct, TEntityType, TUnit>(twin: string | {
+        id: string;
+        version: number;
+    }, projectFactory: (dto: T8ClientProjectDTO<TUnit>) => TProject, productFactory: (dto: T8ClientProductDTO<TUnit>) => TProduct, entityTypeFactory: (dto: T8ClientEntityTypeDTO<TUnit>) => TEntityType, unitFactory: (dto: T8ClientUnitDTO, dataModel: T8ClientModelDTO) => TUnit, connectProject: (dto: T8ClientProjectConnectionsDTO<TProduct>, project: TProject) => void, connectProduct: (dto: T8ClientProductConnectionsDTO<TProduct, TEntityType>, product: TProduct) => void, signal?: AbortSignal): Promise<Twin<TProject, TProduct, TEntityType, TUnit>>;
+    /**
+     * Downloads and deserializes geometry info (t8gi) using default types.
+     * When no version is specified, searches versions newest-first for one containing t8gi content.
+     *
+     * @param twin - Twin ID string, or `{id, version}` to load a specific version.
+     * @throws {Error} When no version has t8gi content.
+     */
+    loadGeometryInfo(twin: string | {
+        id: string;
+        version: number;
+    }, signal?: AbortSignal): Promise<TwinGeometryInfo<T8GIMeshDescriptor, T8GIStyle, T8GIRegion>>;
+    /**
+     * Downloads and deserializes geometry info (t8gi) using custom factory functions.
+     * When no version is specified, searches versions newest-first for one containing t8gi content.
+     *
+     * @param twin - Twin ID string, or `{id, version}` to load a specific version.
+     * @throws {Error} When no version has t8gi content.
+     */
+    loadGeometryInfoWithFactories<TMeshDescriptor, TStyle, TRegion>(twin: string | {
+        id: string;
+        version: number;
+    }, meshDescriptorFactory: (dto: T8GIMeshDescriptorDTO) => TMeshDescriptor, styleFactory: (dto: T8GIStyleDTO) => TStyle, regionFactory: (dto: T8GIRegionDTO) => TRegion, signal?: AbortSignal): Promise<TwinGeometryInfo<TMeshDescriptor, TStyle, TRegion>>;
+    /**
+     * Downloads and deserializes both the client model (t8cm) and geometry (t8gi/t8gd) into a combined result.
+     * When no version is specified, searches versions newest-first for one containing both t8cm and t8gi content.
+     *
+     * @param twin - Twin ID string, or `{id, version}` to load a specific version.
+     * @throws {Error} When no version has both t8cm and t8gi content.
+     */
+    loadTwinWithGeometry(twin: string | {
+        id: string;
+        version: number;
+    }, signal?: AbortSignal): Promise<Twin<T8ProjectWithGeometry, T8ProductWithGeometry, T8EntityType, T8Unit>>;
+    /**
+     * Creates a new twin or updates an existing one (upsert). Provide `etag` in the twin body to update.
+     *
+     * @throws {TwinValidationError} On invalid request body (400).
+     * @throws {TwinConflictError} On etag mismatch (409). The error's `currentTwin` contains the server's current state.
+     */
+    createOrUpdateTwin(twinId: string, twin: TwinPut, signal?: AbortSignal): Promise<TwinGet>;
+    /** Alias for {@link createOrUpdateTwin}. */
+    updateTwin(twinId: string, twin: TwinPut, signal?: AbortSignal): Promise<TwinGet>;
+    /**
+     * @throws {TwinNotFoundError} When the twin does not exist (404).
+     * @throws {TwinConflictError} On etag mismatch (409). The error's `currentTwin` contains the server's current state.
+     */
+    restoreTwin(twinId: string, etag: string, signal?: AbortSignal): Promise<TwinGet>;
+    /**
+     * @throws {TwinNotFoundError} When the twin or version does not exist (404).
+     */
+    getTwinVersionContent(twinId: string, twinVersion: number, signal?: AbortSignal): Promise<TwinVersionContentResponse>;
+    /**
+     * Returns content for the latest twin version.
+     * @throws {TwinNotFoundError} When the twin does not exist (404).
+     */
+    getTwinContent(twinId: string, signal?: AbortSignal): Promise<TwinVersionContentResponse>;
+    /** @throws {TwinNotFoundError} When the twin does not exist (404). */
+    getTwinDiagnostics(twinId: string, signal?: AbortSignal): Promise<TwinDiagnosticsResponse>;
+    /** @throws {TwinNotFoundError} When the twin or version does not exist (404). */
+    getTwinVersionDiagnostics(twinId: string, twinVersion: number, signal?: AbortSignal): Promise<TwinDiagnosticsResponse>;
+    /**
+     * @throws {TwinValidationError} On invalid query parameters (400).
+     * @throws {TwinNotFoundError} When the twin or version does not exist (404).
+     */
+    getTwinVersionEvents(twinId: string, twinVersion: number, offset?: number, limit?: number, signal?: AbortSignal): Promise<PaginatedResponse<TwinProcessorEvent>>;
+    /**
+     * @throws {TwinValidationError} On invalid query parameters (400).
+     * @throws {ProcessorNotFoundError} When the processor does not exist for this twin version (404).
+     */
+    getProcessorEvents(twinId: string, twinVersion: number, processorId: string, offset?: number, limit?: number, signal?: AbortSignal): Promise<PaginatedResponse<TwinProcessorEvent>>;
+    /**
+     * @throws {AssetValidationError} On invalid query parameters (400).
+     * @throws {AssetNotFoundError} When the twin does not exist (404).
+     */
+    listAssets(twinId: string, offset?: number, limit?: number, options?: {
+        includeDeleted?: boolean;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<AssetListItem>>;
+    /** @throws {AssetNotFoundError} When the asset does not exist (404). */
+    getAsset(twinId: string, assetId: string, signal?: AbortSignal): Promise<AssetGet>;
+    /** @throws {AssetValidationError} On invalid request body (400). The error's `errorBody` has structured detail. */
+    createAssets(twinId: string, assets: AssetPost[], signal?: AbortSignal): Promise<AssetGet[]>;
+    /**
+     * @throws {AssetValidationError} On invalid request body (400). The error's `errorBody` has structured detail.
+     * @throws {AssetConflictError} On etag mismatch (409). The error's `currentAsset` contains the server's current state.
+     */
+    updateAsset(twinId: string, assetId: string, asset: AssetPut, signal?: AbortSignal): Promise<AssetGet>;
+    /**
+     * @throws {AssetNotFoundError} When the asset does not exist (404).
+     * @throws {AssetConflictError} On etag mismatch (409). The error's `currentAsset` contains the server's current state.
+     */
+    deleteAsset(twinId: string, assetId: string, etag: string, signal?: AbortSignal): Promise<AssetGet>;
+    /**
+     * @throws {AssetNotFoundError} When the asset does not exist (404).
+     * @throws {AssetConflictError} On etag mismatch (409). The error's `currentAsset` contains the server's current state.
+     */
+    restoreAsset(twinId: string, assetId: string, etag: string, signal?: AbortSignal): Promise<AssetGet>;
+    /**
+     * Executes a batch of asset operations (upsert, delete, restore) atomically.
+     * All operations succeed or all are rolled back.
+     *
+     * @param operations - Array of batch operations (max 1000).
+     * @throws {AssetBatchError} When the batch rolled back. The error's `response` has per-item
+     * results with reverted statuses, and is thrown for any status the failing item carried --
+     * 400, 404 or 409.
+     * @throws {AssetValidationError} When the whole request was rejected before any item ran (400):
+     * an empty batch, duplicate ids, a body/URL twin mismatch, oversized metadata.
+     * @throws {AssetForbiddenError} On insufficient permissions (403).
+     */
+    batchAssets(twinId: string, operations: AssetBatchOperation[], signal?: AbortSignal): Promise<AssetBatchResponse>;
+    /**
+     * Retrieves multiple assets by ID in a single request.
+     *
+     * @param ids - Array of asset IDs (max 1000).
+     * @throws {AssetValidationError} On validation failure (400).
+     */
+    batchGetAssets(twinId: string, ids: string[], signal?: AbortSignal): Promise<AssetBatchGetResponse>;
+    /** Lists attachments for a single asset. */
+    listAssetAttachments(twinId: string, assetId: string, options?: {
+        includeDeleted?: boolean;
+        offset?: number;
+        limit?: number;
+        page?: string;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<AttachmentGet>>;
+    /**
+     * Downloads an attachment's blob as a `Response`. The caller decides
+     * whether to consume it as text, ArrayBuffer, or Blob.
+     * @throws {AssetAttachmentNotFoundError} When the attachment does not exist (404).
+     */
+    getAssetAttachmentBlob(twinId: string, assetId: string, attachmentId: string, signal?: AbortSignal): Promise<Response>;
+    /**
+     * Creates an upload session for a new attachment. The actual file bytes
+     * are uploaded out-of-band to {@link ApiCreateUploadSessionResponse.uploadUrl};
+     * use {@link uploadAssetAttachmentFile} for the canonical chunked-upload flow.
+     * The attachment row is materialized server-side when the blob lands.
+     * @throws {AssetAttachmentConflictError} When an attachment already exists
+     *  for the given id (409); retries must use a new attachmentId.
+     */
+    createAssetAttachmentUploadSession(twinId: string, assetId: string, attachmentId: string, body: AttachmentPost, signal?: AbortSignal): Promise<ApiCreateUploadSessionResponse>;
+    /**
+     * Uploads a `File` / `Blob` to an existing upload session in one or more
+     * chunks, then resolves the upload token so the caller can poll
+     * {@link getAssetAttachmentUploadStatus}.
+     */
+    uploadAssetAttachmentFile(session: ApiCreateUploadSessionResponse, file: Blob, signal?: AbortSignal): Promise<{
+        token: string;
+    }>;
+    /** Polls the in-memory upload-session cache for an attachment that's being uploaded. */
+    getAssetAttachmentUploadStatus(twinId: string, assetId: string, token: string, signal?: AbortSignal): Promise<UploadStatusGet>;
+    /**
+     * Updates an attachment's description / soft-delete flag. `documentId`
+     * is immutable — rebinding is rejected.
+     * @throws {AssetAttachmentConflictError} On etag mismatch (409). The
+     *  error's `currentAttachment` carries the server's current state.
+     * @throws {AssetAttachmentNotFoundError} When the attachment does not exist (404).
+     */
+    putAssetAttachment(twinId: string, assetId: string, attachmentId: string, body: AssetAttachmentPut, signal?: AbortSignal): Promise<AttachmentGet>;
+    /**
+     * Soft-deletes an attachment.
+     * @throws {AssetAttachmentConflictError} On etag mismatch (409).
+     * @throws {AssetAttachmentNotFoundError} When the attachment does not exist (404).
+     */
+    deleteAssetAttachment(twinId: string, assetId: string, attachmentId: string, etag: string, signal?: AbortSignal): Promise<AttachmentGet>;
+    /**
+     * Restores a soft-deleted attachment.
+     * @throws {AssetAttachmentConflictError} On etag mismatch (409).
+     * @throws {AssetAttachmentNotFoundError} When the attachment does not exist (404).
+     */
+    restoreAssetAttachment(twinId: string, assetId: string, attachmentId: string, etag: string, signal?: AbortSignal): Promise<AttachmentGet>;
+    /**
+     * @throws {TwinNotFoundError} When the twin does not exist (404).
+     * @throws {TwinConflictError} On etag mismatch (409). The error's `currentTwin` contains the server's current state.
+     */
+    deleteTwin(twinId: string, etag: string, signal?: AbortSignal): Promise<TwinGet>;
+    /** @throws {TwinFileValidationError} On invalid query parameters (400). */
+    listTwinFiles(twinId: string, options?: TwinFileListOptions, signal?: AbortSignal): Promise<PaginatedResponse<TwinFileGet>>;
+    /**
+     * @throws {TwinFileNotFoundError} When the file does not exist (404).
+     * @throws {TwinFileValidationError} On invalid request (400).
+     */
+    getTwinFile(twinId: string, fileId: string, signal?: AbortSignal): Promise<TwinFileGet>;
+    /**
+     * @throws {TwinFileValidationError} On invalid request body (400).
+     * @throws {TwinFileConflictError} On etag mismatch (409). The error's `currentTwinFile` contains the server's current state.
+     */
+    createOrUpdateTwinFile(twinId: string, fileId: string, twinFile: TwinFilePut, signal?: AbortSignal): Promise<TwinFileGet>;
+    /**
+     * @throws {TwinFileNotFoundError} When the file does not exist (404).
+     * @throws {TwinFileConflictError} On etag mismatch (409). The error's `currentTwinFile` contains the server's current state.
+     * @throws {TwinFileValidationError} On invalid request (400).
+     */
+    deleteTwinFile(twinId: string, fileId: string, deleteRequest: TwinFileDelete, signal?: AbortSignal): Promise<TwinFileGet>;
+    /**
+     * @throws {TwinFileNotFoundError} When the file does not exist (404).
+     * @throws {TwinFileConflictError} On etag mismatch (409). The error's `currentTwinFile` contains the server's current state.
+     * @throws {TwinFileValidationError} On invalid request (400).
+     */
+    restoreTwinFile(twinId: string, fileId: string, etag: string, signal?: AbortSignal): Promise<TwinFileGet>;
+    /** @throws {TwinFileNotFoundError} When the file does not exist (404). */
+    getTwinFileContent(twinId: string, fileId: string, signal?: AbortSignal): Promise<Blob>;
+    /** @throws {TwinFileNotFoundError} When the file or version does not exist (404). */
+    getTwinFileVersion(twinId: string, fileId: string, version: number, signal?: AbortSignal): Promise<TwinFileGet>;
+    /** @throws {TwinFileValidationError} On invalid query parameters (400). */
+    listTwinFileVersions(twinId: string, fileId: string, options?: TwinFileVersionListOptions, signal?: AbortSignal): Promise<PaginatedResponse<TwinFileGet>>;
+    /** @throws {TwinFileNotFoundError} When the file or version does not exist (404). */
+    getTwinFileVersionContent(twinId: string, fileId: string, version: number, signal?: AbortSignal): Promise<Blob>;
+    /**
+     * Returns the caller's named, customer-scoped capabilities against the
+     * Twin service — the asset-domain vocabulary `ViewAssets`, `EditAssets`,
+     * `DeleteAssets`, `EditAssetTypes` and `ManageAssetPermissions`.
+     * The admin app uses this to enable or disable
+     * buttons instead of letting the user click through to a 403.
+     *
+     * No client-side cache — every call hits the wire. Underlying scope
+     * grants don't shift within a session, so callers are expected to
+     * memoise the result themselves (e.g. via React Query / a once-on-mount
+     * fetch) rather than calling this on every render.
+     *
+     * Throws {@link TwinUnauthenticatedError} on 401 (no valid auth context;
+     * caller should redirect to login). Returns an empty `permissions` array
+     * on 403 (authenticated but no Twin-service capabilities). Unknown
+     * capability strings should be ignored — adding a new capability is a
+     * non-breaking change.
+     *
+     * A 503 throws rather than answering with an empty array: the Permission
+     * service gave no answer, so the capabilities are unknown rather than
+     * absent, and the call is safe to retry unchanged.
+     */
+    getMyPermissions(signal?: AbortSignal): Promise<MyPermissions>;
+    /**
+     * Returns the capabilities the caller holds on one specific twin. Open to every
+     * authenticated caller — an empty list is an honest answer rather than a refusal —
+     * so a UI can gate its controls on this before it knows anything about the caller.
+     *
+     * The answer mixes vocabularies: the twin's own `TwinScopedCapability` values, plus the
+     * asset-instance capabilities `ViewAssets`, `EditAssets` and `DeleteAssets`, which gate the
+     * assets hanging off this twin. The catalog capabilities and `ManageAssetPermissions` are not
+     * twin-bound and are absent here.
+     *
+     * Distinct from {@link getMyPermissions}, which answers the customer-scoped question over the
+     * whole asset domain. That one returns an empty list on 403; this route has no capability gate
+     * to refuse at, so a 403 here means something outside the Twin service refused, and is thrown.
+     *
+     * @throws {TwinNotFoundError} The twin does not exist, or the caller cannot see it — the
+     * surface does not distinguish the two.
+     * @throws {TwinUnauthenticatedError} No valid auth context (401).
+     * @throws {TwinTemporarilyUnavailableError} The request could not be completed (503);
+     * safe to retry unchanged.
+     */
+    getMyTwinPermissions(twinId: string, signal?: AbortSignal): Promise<MyTwinPermissions>;
+    /**
+     * Lists one page of the permission entries on every scope the twin owns. Each entry carries
+     * the etag of the scope it lives on, which is the value to send back when mutating that
+     * principal.
+     *
+     * `pagination.nextPage` is emitted unconditionally — it is non-null on the last page too — so
+     * it is not a termination signal. Page until a response comes back with fewer entries than the
+     * limit asked for, or use {@link listAllTwinPermissions}, which does that. On an access-review
+     * surface, stopping early under-reports who holds capabilities on the twin.
+     *
+     * @throws {TwinPermissionsForbiddenError} The caller may see the twin but does not hold
+     * `ManageTwinPermissions` on it (403).
+     * @throws {TwinNotFoundError} The twin does not exist or the caller cannot see it (404).
+     * @throws {TwinValidationError} The limit is out of range, or the pagination token is invalid
+     * or does not match the query it was issued for (400).
+     * @throws {TwinPermissionsConflictError} `ScopesNotProvisioned` — the twin owns no Twinfinity
+     * scope, so there is no permission state to read (409). Retrying will not help.
+     * @throws {TwinTemporarilyUnavailableError} The request could not be completed (503);
+     * safe to retry unchanged.
+     */
+    listTwinPermissions(twinId: string, options?: {
+        page?: string;
+        limit?: number;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<TwinPrincipalPermissionsGet>>;
+    /**
+     * Every permission entry on the twin, following the pagination to the end. The whole
+     * access-control list of one twin is a handful of entries, and reviewing it is the point of
+     * the surface, so this — rather than {@link listTwinPermissions} — is what most callers want.
+     *
+     * Throws whatever {@link listTwinPermissions} throws, from whichever page hit it.
+     */
+    listAllTwinPermissions(twinId: string, signal?: AbortSignal): Promise<TwinPrincipalPermissionsGet[]>;
+    /**
+     * Replaces the principal's capabilities on the twin, and returns the entry as stored
+     * along with the etag to chain the next write on. `permissions: []` revokes all four
+     * capabilities without removing an entry that carries bits outside this vocabulary.
+     *
+     * `body.etag` may be omitted only for a principal that holds nothing on the twin yet;
+     * see {@link TwinPermissionsPut}. Both etag refusals arrive as
+     * {@link TwinPermissionsConflictError}, carrying the current state to retry from.
+     *
+     * @throws {TwinValidationError} The target is immutable through this surface — the twin's own
+     * default groups and the seeded system principals, marked by
+     * {@link TwinPrincipalPermissionsGet.readOnly} (cause `SystemPrincipalImmutable`) — or the
+     * write asked for `ManageTwinPermissions` on the all-authenticated principal (cause
+     * `ManagePermissionsNotGrantableToAllAuthenticated`), which would make the whole tenant an
+     * administrator of the twin (400).
+     * @throws {TwinPrincipalNotFoundError} No principal carries this id (404).
+     * @throws {TwinNotFoundError} The twin does not exist or the caller cannot see it (404).
+     * @throws {TwinPermissionsForbiddenError} `ManageTwinPermissions` is required (403).
+     * @throws {TwinPermissionsConflictError} `EtagRequired`, `EtagMismatch` or
+     * `ScopesNotProvisioned` (409); the first two carry `currentState`.
+     * @throws {TwinTemporarilyUnavailableError} The request could not be completed (503);
+     * safe to retry unchanged.
+     */
+    setTwinPermissions(twinId: string, principalId: string, body: TwinPermissionsPut, signal?: AbortSignal): Promise<TwinPrincipalPermissionsGet>;
+    /**
+     * Removes the principal from the twin's access control list entirely — including any
+     * bits outside this capability vocabulary, which is what separates it from a
+     * {@link setTwinPermissions} call with an empty list.
+     *
+     * The etag is always required: a delete always replaces existing grants.
+     *
+     * @throws {TwinPrincipalNotFoundError} The principal holds nothing on the twin, so there is
+     * nothing to revoke and no entry to have read an etag from — whatever value was sent (404).
+     * @throws {TwinValidationError} The principal is immutable through this surface (400), decided
+     * before the etag is looked at.
+     * @throws {TwinNotFoundError} The twin does not exist or the caller cannot see it (404).
+     * @throws {TwinPermissionsForbiddenError} `ManageTwinPermissions` is required (403).
+     * @throws {TwinPermissionsConflictError} `EtagMismatch` or `ScopesNotProvisioned` (409).
+     * @throws {TwinTemporarilyUnavailableError} The request could not be completed (503);
+     * safe to retry unchanged.
+     */
+    deleteTwinPermissions(twinId: string, principalId: string, etag: string, signal?: AbortSignal): Promise<TwinPrincipalPermissionsGet>;
+    /**
+     * Returns the three default groups the twin owns — `TwinReaders`, `TwinContributors`,
+     * `TwinAdministrators` — under the ids to name in {@link setTwinPermissions}.
+     *
+     * Not a picker for the principals a twin can be granted to: that is every group in the
+     * tenant, which the Permission service lists. These are the groups the twin itself
+     * owns, whose membership confers its preset capability levels.
+     *
+     * @throws {TwinPermissionsForbiddenError} `ManageTwinPermissions` is required (403).
+     * @throws {TwinNotFoundError} The twin does not exist or the caller cannot see it (404).
+     * @throws {TwinPermissionsConflictError} `ScopesNotProvisioned` (409).
+     * @throws {TwinTemporarilyUnavailableError} The request could not be completed (503);
+     * safe to retry unchanged.
+     */
+    listTwinGroups(twinId: string, signal?: AbortSignal): Promise<TwinGroupsGet>;
+    /**
+     * Returns one of the twin's own default groups.
+     *
+     * @throws {TwinPrincipalNotFoundError} The twin does not own this group — thrown even when the
+     * group exists in the tenant and holds capabilities on this twin, since ownership, not
+     * existence, is what this route answers (404).
+     * @throws {TwinNotFoundError} The twin does not exist or the caller cannot see it (404).
+     * @throws {TwinPermissionsForbiddenError} `ManageTwinPermissions` is required (403).
+     * @throws {TwinPermissionsConflictError} `ScopesNotProvisioned` (409).
+     * @throws {TwinTemporarilyUnavailableError} The request could not be completed (503);
+     * safe to retry unchanged.
+     */
+    getTwinGroup(twinId: string, groupId: string, signal?: AbortSignal): Promise<TwinGroupGet>;
+    /**
+     * Lists one page of the principals holding capabilities on the customer-wide asset domain, with
+     * the capabilities each of them holds. The companion administration surface to
+     * {@link getMyPermissions}, which answers only for the caller.
+     *
+     * `pagination.nextPage` is emitted unconditionally — it is non-null on the last page too — so it
+     * is not a termination signal. Page until a response comes back with fewer entries than the
+     * limit asked for, or use {@link listAllAssetPermissions}, which does that. On an access-review
+     * surface, stopping early under-reports who holds capabilities.
+     *
+     * @throws {TwinPermissionsForbiddenError} The caller does not hold `ManageAssetPermissions`
+     * (403).
+     * @throws {TwinValidationError} The limit is out of range, or the pagination token is invalid
+     * (400).
+     * @throws {TwinUnauthenticatedError} No valid auth context (401).
+     * @throws {TwinTemporarilyUnavailableError} The request could not be completed (503);
+     * safe to retry unchanged.
+     */
+    listAssetPermissions(options?: {
+        page?: string;
+        limit?: number;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<AssetPrincipalPermissionsGet>>;
+    /** Every entry of {@link listAssetPermissions}, paged to exhaustion. */
+    listAllAssetPermissions(signal?: AbortSignal): Promise<AssetPrincipalPermissionsGet[]>;
+    /**
+     * Replaces what one principal holds on the asset domain. Capabilities absent from
+     * `body.permissions` are revoked, and an empty list revokes everything — leaving the principal
+     * with no listing entry at all, exactly as {@link deleteAssetPermissions} does.
+     *
+     * `body.etag` is required whenever the principal already holds capabilities, and may be omitted
+     * only to create the grants of one that holds none.
+     *
+     * @throws {TwinPrincipalNotFoundError} No group in the tenant carries this id (404).
+     * @throws {TwinValidationError} `SystemPrincipalImmutable` — a seeded default group, whose
+     * preset is conferred by membership rather than by writing here — or
+     * `ManagePermissionsNotGrantableToAllAuthenticated` (400).
+     * @throws {AssetPermissionsConflictError} `EtagRequired` or `EtagMismatch` (409), carrying the
+     * current state to retry from.
+     * @throws {TwinPermissionsForbiddenError} The caller does not hold `ManageAssetPermissions`
+     * (403).
+     * @throws {TwinUnauthenticatedError} No valid auth context (401).
+     * @throws {TwinTemporarilyUnavailableError} The request could not be completed (503);
+     * safe to retry unchanged.
+     */
+    setAssetPermissions(principalId: string, body: AssetPermissionsPut, signal?: AbortSignal): Promise<AssetPrincipalPermissionsGet>;
+    /**
+     * Removes the principal from the domain's access control list entirely, answering with it and
+     * an empty capability list.
+     *
+     * The answer carries the `etag` the revocation wrote: it belongs to the domain, not to the
+     * principal, so a revoked principal having no listing entry does not cost the caller one. Chain
+     * the next write on it exactly as with {@link setAssetPermissions}, without re-reading
+     * {@link listAssetPermissions}.
+     *
+     * The etag is always required — a revocation always replaces existing grants — and a request
+     * naming none is refused with a `400` rather than a conflict, before anything else is asked.
+     *
+     * @throws {TwinPrincipalNotFoundError} No group in the tenant carries this id, or it holds
+     * nothing here for a revocation to remove (404).
+     * @throws {TwinValidationError} `SystemPrincipalImmutable` or `EtagRequired` (400).
+     * @throws {AssetPermissionsConflictError} `EtagMismatch` (409).
+     * @throws {TwinPermissionsForbiddenError} The caller does not hold `ManageAssetPermissions`
+     * (403).
+     * @throws {TwinUnauthenticatedError} No valid auth context (401).
+     * @throws {TwinTemporarilyUnavailableError} The request could not be completed (503);
+     * safe to retry unchanged.
+     */
+    deleteAssetPermissions(principalId: string, etag: string, signal?: AbortSignal): Promise<AssetPrincipalPermissionsGet>;
+    /**
+     * Returns the asset domain's default groups — `AssetsReaders`, `AssetsContributors`,
+     * `AssetsAdministrators` — under the ids whose membership confers their preset capabilities.
+     *
+     * A group whose seeding has not completed for this customer is omitted rather than listed under
+     * a placeholder title, so a short list is a state to poll rather than an error.
+     *
+     * @throws {TwinPermissionsForbiddenError} The caller does not hold `ManageAssetPermissions`
+     * (403).
+     * @throws {TwinUnauthenticatedError} No valid auth context (401).
+     * @throws {TwinTemporarilyUnavailableError} The titles could not be resolved (503); safe to
+     * retry unchanged.
+     */
+    listAssetGroups(signal?: AbortSignal): Promise<AssetGroupsGet>;
+    /**
+     * Returns one default group by its stable name, case-insensitively.
+     *
+     * @throws {TwinPrincipalNotFoundError} The name is one of the three but its group has not been
+     * seeded for this customer yet — safe to retry (404).
+     * @throws {TwinNotFoundError} The name is not one of the three; retrying will not help (404).
+     * @throws {TwinPermissionsForbiddenError} The caller does not hold `ManageAssetPermissions`
+     * (403).
+     * @throws {TwinUnauthenticatedError} No valid auth context (401).
+     * @throws {TwinTemporarilyUnavailableError} The title could not be resolved (503); safe to
+     * retry unchanged.
+     */
+    getAssetGroup(name: string, signal?: AbortSignal): Promise<AssetGroupGet>;
+    /**
+     * Returns the Twinfinity meta-schema document — the JSON Schema describing
+     * valid asset-type metadata schemas. The bytes the backend itself
+     * validates against, served verbatim. Power-user tools (Monaco-backed
+     * JSON editors, schema-aware tooling) fetch this at runtime so their
+     * in-editor diagnostics line up with what the server will accept,
+     * decoupled from the FE bundle's build time.
+     */
+    getAssetTypeMetaSchema(signal?: AbortSignal): Promise<Record<string, unknown>>;
+    /**
+     * @throws {AssetCategoryValidationError} On invalid query parameters (400).
+     */
+    listAssetCategories(options?: {
+        page?: string;
+        limit?: number;
+        includeDeleted?: boolean;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<AssetCategoryGet>>;
+    /** @throws {AssetCategoryNotFoundError} When the category does not exist (404). */
+    getAssetCategory(categoryId: string, signal?: AbortSignal): Promise<AssetCategoryGet>;
+    /**
+     * Upserts an asset category. Provide an empty/missing etag for first writes
+     * and the existing etag to update.
+     *
+     * @throws {AssetCategoryValidationError} On invalid request body (400).
+     * @throws {AssetCategoryConflictError} On etag mismatch (409). The error's `currentCategory` contains the server's current state.
+     */
+    putAssetCategory(categoryId: string, body: AssetCategoryPut, signal?: AbortSignal): Promise<AssetCategoryGet>;
+    /**
+     * Returns every version of a single asset category, newest first. Mirrors
+     * `listAssetTypeVersions` and `twin.get_twin_versions`.
+     *
+     * @throws {AssetCategoryNotFoundError} When the category's header row does not exist (404).
+     */
+    listAssetCategoryVersions(categoryId: string, options?: {
+        page?: string;
+        limit?: number;
+        includeDeleted?: boolean;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<AssetCategoryGet>>;
+    /**
+     * Soft-deletes a category. Inserts a new asset_category_versions row with
+     * `is_deleted=true`; the previous version is retained as an audit trail.
+     *
+     * @throws {AssetCategoryNotFoundError} When the category does not exist (404).
+     * @throws {AssetCategoryConflictError} On etag mismatch (409).
+     */
+    deleteAssetCategory(categoryId: string, etag: string, signal?: AbortSignal): Promise<AssetCategoryGet>;
+    /**
+     * Restores a soft-deleted category. Inserts a new asset_category_versions
+     * row with `is_deleted=false`; mirrors twin restore.
+     *
+     * @throws {AssetCategoryNotFoundError} When the category does not exist (404).
+     * @throws {AssetCategoryConflictError} On etag mismatch (409).
+     */
+    restoreAssetCategory(categoryId: string, etag: string, signal?: AbortSignal): Promise<AssetCategoryGet>;
+    /** @throws {AssetTypeValidationError} On invalid query parameters (400). */
+    listAssetTypes(categoryId: string, options?: {
+        page?: string;
+        limit?: number;
+        includeDeleted?: boolean;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<AssetTypeGet>>;
+    /** @throws {AssetTypeNotFoundError} When the category or type does not exist (404). */
+    getAssetType(categoryId: string, typeId: string, signal?: AbortSignal): Promise<AssetTypeGet>;
+    /**
+     * Returns every version of a single asset type, newest first. Mirrors
+     * `twin.get_twin_versions`.
+     *
+     * @throws {AssetTypeNotFoundError} When the type's header row does not exist (404).
+     */
+    listAssetTypeVersions(categoryId: string, typeId: string, options?: {
+        page?: string;
+        limit?: number;
+        includeDeleted?: boolean;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<AssetTypeGet>>;
+    /**
+     * Upserts an asset type. The metadata schema is validated against the
+     * Twinfinity meta-schema at the API boundary; invalid schemas surface as
+     * a 400 with `cause: MetadataSchemaInvalid`.
+     *
+     * @throws {AssetTypeValidationError} On invalid request body (400). The error's `errorBody` carries the structured cause.
+     * @throws {AssetTypeConflictError} On etag mismatch (409). The error's `currentType` contains the server's current state.
+     */
+    putAssetType(categoryId: string, typeId: string, body: AssetTypePut, signal?: AbortSignal): Promise<AssetTypeGet>;
+    /**
+     * Soft-deletes a type. Inserts a new asset_type_versions row with
+     * `is_deleted=true`; the previous version is retained as an audit trail.
+     *
+     * @throws {AssetTypeNotFoundError} When the type does not exist (404).
+     * @throws {AssetTypeConflictError} On etag mismatch (409).
+     */
+    deleteAssetType(categoryId: string, typeId: string, etag: string, signal?: AbortSignal): Promise<AssetTypeGet>;
+    /**
+     * Restores a soft-deleted type. Inserts a new asset_type_versions row with
+     * `is_deleted=false`; mirrors twin restore.
+     *
+     * @throws {AssetTypeNotFoundError} When the type does not exist (404).
+     * @throws {AssetTypeConflictError} On etag mismatch (409).
+     */
+    restoreAssetType(categoryId: string, typeId: string, etag: string, signal?: AbortSignal): Promise<AssetTypeGet>;
+    /**
+     * Returns the customer's asset-type catalog: categories nested with
+     * their latest non-deleted types and full metadata schemas inline. One
+     * round-trip is enough to populate a picker dropdown and render any
+     * per-type metadata form.
+     */
+    getAssetTypeCatalog(signal?: AbortSignal): Promise<AssetCatalogResponse>;
+}
+export declare class TwinClient implements ITwinClient {
+    private readonly _httpClient;
+    private readonly _baseUrl;
+    private readonly _assetTypeCatalogUrl;
+    constructor(baseUrl: string | URL, _httpClient: TwinfinityHttpClient);
+    /**
+     * Rooted twins base URL — typically `<host>/sites/<container>/_ps/twins`.
+     * Exposed so callers that want to build content URLs in the same auth
+     * scope as the metadata calls can derive them from here. The bare
+     * `<host>/_ps/twins/...` variant is not necessarily an authorized route
+     * on all deployments.
+     */
+    get baseUrl(): string;
+    listTwins(options?: {
+        relatedTo?: string;
+        includeDeleted?: boolean;
+        page?: string;
+        limit?: number;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<ListTwinItem>>;
+    /**
+     * @deprecated Use the options-object form: `listTwins({ relatedTo, page, limit }, signal)`.
+     * The positional form has no `includeDeleted` parameter; that is only reachable via the options object.
+     */
+    listTwins(relatedTo?: string, page?: string, limit?: number, signal?: AbortSignal): Promise<PaginatedResponse<ListTwinItem>>;
+    listAllTwins(options?: {
+        relatedTo?: string;
+        includeDeleted?: boolean;
+    }, signal?: AbortSignal): Promise<ListTwinItem[]>;
+    /**
+     * @deprecated Use the options-object form: `listAllTwins({ relatedTo }, signal)`.
+     * The positional form has no `includeDeleted` parameter; that is only reachable via the options object.
+     */
+    listAllTwins(relatedTo?: string, signal?: AbortSignal): Promise<ListTwinItem[]>;
+    getTwin(twin: string | {
+        id: string;
+        version: number;
+    }, signal?: AbortSignal): Promise<TwinGet>;
+    listTwinVersions(id: string, options?: {
+        includeDeleted?: boolean;
+        page: string | undefined;
+        limit?: number;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<ListTwinItem>>;
+    downloadTwinContent(twinId: string, twinVersion: number, content: TwinContentResponse, signal?: AbortSignal): Promise<ArrayBuffer>;
+    private loadTwinVersion;
+    loadTwin(twin: string | {
+        id: string;
+        version: number;
+    }, signal?: AbortSignal): Promise<Twin<T8Project, T8Product<T8EntityType>, T8EntityType, T8Unit>>;
+    loadTwinWithFactories<TProject, TProduct, TEntityType, TUnit>(twin: string | {
+        id: string;
+        version: number;
+    }, projectFactory: (dto: T8ClientProjectDTO<TUnit>) => TProject, productFactory: (dto: T8ClientProductDTO<TUnit>) => TProduct, entityTypeFactory: (dto: T8ClientEntityTypeDTO<TUnit>) => TEntityType, unitFactory: (dto: T8ClientUnitDTO, dataModel: T8ClientModelDTO) => TUnit, connectProject: (dto: T8ClientProjectConnectionsDTO<TProduct>, project: TProject) => void, connectProduct: (dto: T8ClientProductConnectionsDTO<TProduct, TEntityType>, product: TProduct) => void, signal?: AbortSignal): Promise<Twin<TProject, TProduct, TEntityType, TUnit>>;
+    private loadGeometryInfoVersion;
+    loadGeometryInfo(twin: string | {
+        id: string;
+        version: number;
+    }, signal?: AbortSignal): Promise<TwinGeometryInfo<T8GIMeshDescriptor, T8GIStyle, T8GIRegion>>;
+    loadGeometryInfoWithFactories<TMeshDescriptor, TStyle, TRegion>(twin: string | {
+        id: string;
+        version: number;
+    }, meshDescriptorFactory: (dto: T8GIMeshDescriptorDTO) => TMeshDescriptor, styleFactory: (dto: T8GIStyleDTO) => TStyle, regionFactory: (dto: T8GIRegionDTO) => TRegion, signal?: AbortSignal): Promise<TwinGeometryInfo<TMeshDescriptor, TStyle, TRegion>>;
+    private loadTwinWithGeometryVersion;
+    loadTwinWithGeometry(twin: string | {
+        id: string;
+        version: number;
+    }, signal?: AbortSignal): Promise<Twin<T8ProjectWithGeometry, T8ProductWithGeometry, T8EntityType, T8Unit>>;
+    createOrUpdateTwin(twinId: string, twin: TwinPut, signal?: AbortSignal): Promise<TwinGet>;
+    updateTwin(twinId: string, twin: TwinPut, signal?: AbortSignal): Promise<TwinGet>;
+    deleteTwin(twinId: string, etag: string, signal?: AbortSignal): Promise<TwinGet>;
+    restoreTwin(twinId: string, etag: string, signal?: AbortSignal): Promise<TwinGet>;
+    getTwinVersionContent(twinId: string, twinVersion: number, signal?: AbortSignal): Promise<TwinVersionContentResponse>;
+    getTwinContent(twinId: string, signal?: AbortSignal): Promise<TwinVersionContentResponse>;
+    getTwinDiagnostics(twinId: string, signal?: AbortSignal): Promise<TwinDiagnosticsResponse>;
+    getTwinVersionDiagnostics(twinId: string, twinVersion: number, signal?: AbortSignal): Promise<TwinDiagnosticsResponse>;
+    getTwinVersionEvents(twinId: string, twinVersion: number, offset?: number, limit?: number, signal?: AbortSignal): Promise<PaginatedResponse<TwinProcessorEvent>>;
+    getProcessorEvents(twinId: string, twinVersion: number, processorId: string, offset?: number, limit?: number, signal?: AbortSignal): Promise<PaginatedResponse<TwinProcessorEvent>>;
+    listAssets(twinId: string, offset?: number, limit?: number, options?: {
+        includeDeleted?: boolean;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<AssetListItem>>;
+    getAsset(twinId: string, assetId: string, signal?: AbortSignal): Promise<AssetGet>;
+    createAssets(twinId: string, assets: AssetPost[], signal?: AbortSignal): Promise<AssetGet[]>;
+    updateAsset(twinId: string, assetId: string, asset: AssetPut, signal?: AbortSignal): Promise<AssetGet>;
+    deleteAsset(twinId: string, assetId: string, etag: string, signal?: AbortSignal): Promise<AssetGet>;
+    restoreAsset(twinId: string, assetId: string, etag: string): Promise<AssetGet>;
+    batchAssets(twinId: string, operations: AssetBatchOperation[], signal?: AbortSignal): Promise<AssetBatchResponse>;
+    batchGetAssets(twinId: string, ids: string[], signal?: AbortSignal): Promise<AssetBatchGetResponse>;
+    listAssetAttachments(twinId: string, assetId: string, options?: {
+        includeDeleted?: boolean;
+        offset?: number;
+        limit?: number;
+        page?: string;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<AttachmentGet>>;
+    getAssetAttachmentBlob(twinId: string, assetId: string, attachmentId: string, signal?: AbortSignal): Promise<Response>;
+    createAssetAttachmentUploadSession(twinId: string, assetId: string, attachmentId: string, body: AttachmentPost, signal?: AbortSignal): Promise<ApiCreateUploadSessionResponse>;
+    uploadAssetAttachmentFile(session: ApiCreateUploadSessionResponse, file: Blob, signal?: AbortSignal): Promise<{
+        token: string;
+    }>;
+    getAssetAttachmentUploadStatus(twinId: string, assetId: string, token: string, signal?: AbortSignal): Promise<UploadStatusGet>;
+    putAssetAttachment(twinId: string, assetId: string, attachmentId: string, body: AssetAttachmentPut, signal?: AbortSignal): Promise<AttachmentGet>;
+    deleteAssetAttachment(twinId: string, assetId: string, attachmentId: string, etag: string, signal?: AbortSignal): Promise<AttachmentGet>;
+    restoreAssetAttachment(twinId: string, assetId: string, attachmentId: string, etag: string, signal?: AbortSignal): Promise<AttachmentGet>;
+    listTwinFiles(twinId: string, options?: TwinFileListOptions, signal?: AbortSignal): Promise<PaginatedResponse<TwinFileGet>>;
+    getTwinFile(twinId: string, fileId: string, signal?: AbortSignal): Promise<TwinFileGet>;
+    createOrUpdateTwinFile(twinId: string, fileId: string, twinFile: TwinFilePut, signal?: AbortSignal): Promise<TwinFileGet>;
+    deleteTwinFile(twinId: string, fileId: string, deleteRequest: TwinFileDelete, signal?: AbortSignal): Promise<TwinFileGet>;
+    restoreTwinFile(twinId: string, fileId: string, etag: string, signal?: AbortSignal): Promise<TwinFileGet>;
+    getTwinFileContent(twinId: string, fileId: string, signal?: AbortSignal): Promise<Blob>;
+    getTwinFileVersion(twinId: string, fileId: string, version: number, signal?: AbortSignal): Promise<TwinFileGet>;
+    listTwinFileVersions(twinId: string, fileId: string, options?: TwinFileVersionListOptions, signal?: AbortSignal): Promise<PaginatedResponse<TwinFileGet>>;
+    getTwinFileVersionContent(twinId: string, fileId: string, version: number, signal?: AbortSignal): Promise<Blob>;
+    createOrUpdateTwinRaw(twinId: string, twin: unknown, signal?: AbortSignal): Promise<Response>;
+    createOrUpdateTwinFileRaw(twinId: string, fileId: string, twinFile: unknown, signal?: AbortSignal): Promise<Response>;
+    getMyPermissions(signal?: AbortSignal): Promise<MyPermissions>;
+    getMyTwinPermissions(twinId: string, signal?: AbortSignal): Promise<MyTwinPermissions>;
+    listTwinPermissions(twinId: string, options?: {
+        page?: string;
+        limit?: number;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<TwinPrincipalPermissionsGet>>;
+    listAllTwinPermissions(twinId: string, signal?: AbortSignal): Promise<TwinPrincipalPermissionsGet[]>;
+    setTwinPermissions(twinId: string, principalId: string, body: TwinPermissionsPut, signal?: AbortSignal): Promise<TwinPrincipalPermissionsGet>;
+    deleteTwinPermissions(twinId: string, principalId: string, etag: string, signal?: AbortSignal): Promise<TwinPrincipalPermissionsGet>;
+    listTwinGroups(twinId: string, signal?: AbortSignal): Promise<TwinGroupsGet>;
+    getTwinGroup(twinId: string, groupId: string, signal?: AbortSignal): Promise<TwinGroupGet>;
+    listAssetPermissions(options?: {
+        page?: string;
+        limit?: number;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<AssetPrincipalPermissionsGet>>;
+    listAllAssetPermissions(signal?: AbortSignal): Promise<AssetPrincipalPermissionsGet[]>;
+    setAssetPermissions(principalId: string, body: AssetPermissionsPut, signal?: AbortSignal): Promise<AssetPrincipalPermissionsGet>;
+    deleteAssetPermissions(principalId: string, etag: string, signal?: AbortSignal): Promise<AssetPrincipalPermissionsGet>;
+    listAssetGroups(signal?: AbortSignal): Promise<AssetGroupsGet>;
+    getAssetGroup(name: string, signal?: AbortSignal): Promise<AssetGroupGet>;
+    /**
+     * Maps a refusal from the customer-wide asset permission surface onto the typed error its
+     * status and cause name. The twin-scoped counterpart of this cannot be reused: its 404s are
+     * about a twin, and this surface has none — a 404 naming no principal means the *name* was
+     * unknown, not that a resource was missing.
+     *
+     * A 404 is dispatched on `item.kind`, which is what separates "that group has not been seeded
+     * for this customer yet", which is worth retrying, from "no such group name", which is not.
+     */
+    private _failAssetPermissionsRequest;
+    /**
+     * Maps a refusal from the twin-scoped permission surface onto the typed error its status
+     * and cause name. Shared by all six methods because the surface answers them uniformly:
+     * the status is decided by the request's shape and the caller's grants, not by the route.
+     *
+     * A 404 is dispatched on `item.kind`, which is the only thing separating "no such twin, or
+     * none you may see" from "the principal you named is not there" — the two arrive on the
+     * same status from the same route.
+     */
+    private _failTwinPermissionsRequest;
+    getAssetTypeMetaSchema(signal?: AbortSignal): Promise<Record<string, unknown>>;
+    listAssetCategories(options?: {
+        page?: string;
+        limit?: number;
+        includeDeleted?: boolean;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<AssetCategoryGet>>;
+    getAssetCategory(categoryId: string, signal?: AbortSignal): Promise<AssetCategoryGet>;
+    putAssetCategory(categoryId: string, body: AssetCategoryPut, signal?: AbortSignal): Promise<AssetCategoryGet>;
+    deleteAssetCategory(categoryId: string, etag: string, signal?: AbortSignal): Promise<AssetCategoryGet>;
+    restoreAssetCategory(categoryId: string, etag: string, signal?: AbortSignal): Promise<AssetCategoryGet>;
+    private _categoryDeleteOrRestore;
+    listAssetCategoryVersions(categoryId: string, options?: {
+        page?: string;
+        limit?: number;
+        includeDeleted?: boolean;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<AssetCategoryGet>>;
+    listAssetTypes(categoryId: string, options?: {
+        page?: string;
+        limit?: number;
+        includeDeleted?: boolean;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<AssetTypeGet>>;
+    getAssetType(categoryId: string, typeId: string, signal?: AbortSignal): Promise<AssetTypeGet>;
+    listAssetTypeVersions(categoryId: string, typeId: string, options?: {
+        page?: string;
+        limit?: number;
+        includeDeleted?: boolean;
+    }, signal?: AbortSignal): Promise<PaginatedResponse<AssetTypeGet>>;
+    putAssetType(categoryId: string, typeId: string, body: AssetTypePut, signal?: AbortSignal): Promise<AssetTypeGet>;
+    deleteAssetType(categoryId: string, typeId: string, etag: string, signal?: AbortSignal): Promise<AssetTypeGet>;
+    restoreAssetType(categoryId: string, typeId: string, etag: string, signal?: AbortSignal): Promise<AssetTypeGet>;
+    private _typeDeleteOrRestore;
+    getAssetTypeCatalog(signal?: AbortSignal): Promise<AssetCatalogResponse>;
+}
+//# sourceMappingURL=TwinClient.d.ts.map