@faiber/faiber-drm 0.23.0 → 1.0.0

package/dist/operations.js

@@ -1,1084 +1,1090 @@
 import { ServiceApi, urlEncoded } from "@faiber/sdk-core";
+function wildcardPath(path) {
+    const parts = String(path).split("/");
+    if (parts.some(part => !part || part === "." || part === ".." || /[%?#\\]/.test(part)))
+        throw new TypeError("Wildcard paths require nonempty raw segments without dot traversal, percent escapes, query, fragment or backslash");
+    return parts.map(part => encodeURIComponent(part)).join("/");
+}
 export class DrmOperations extends ServiceApi {
     /**
-     * Performs the audit events operation for the router capability.
+     * Page audit events descending created_at; defaults page1,size50, clamps1..100; from/to inclusive timestamps.
      * Calls `GET /api/v1/audit-events` through the shared IDP-aware Faiber client.
      * @param params Typed query parameters; omitted members retain backend defaults.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:audit:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:audit:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerAuditEventsGet(params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/audit-events`, params });
     }
     /**
-     * Performs the list analyses operation for the router capability.
+     * Page composition analyses with search/status/time filters; defaults page1,size20 with size clamped1..100.
      * Calls `GET /api/v1/composition-analyses` through the shared IDP-aware Faiber client.
      * @param params Typed query parameters; omitted members retain backend defaults.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerListAnalysesGet(params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/composition-analyses`, params });
     }
     /**
-     * Performs the list composition categories operation for the router capability.
+     * List composition categories. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/composition-categories` through the shared IDP-aware Faiber client.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerListCompositionCategoriesGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/composition-categories` });
     }
     /**
-     * Performs the create composition category operation for the router capability.
+     * Create composition category. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `POST /api/v1/composition-categories` through the shared IDP-aware Faiber client.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerCreateCompositionCategoryPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/composition-categories`, data: data });
     }
     /**
-     * Performs the delete composition category operation for the router capability.
+     * Delete composition category. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `DELETE /api/v1/composition-categories/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerDeleteCompositionCategoryDelete(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/composition-categories/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the update composition category operation for the router capability.
+     * Update composition category. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `PATCH /api/v1/composition-categories/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerUpdateCompositionCategoryPatch(id, data, options) {
         return this.client.request({ ...options, method: "PATCH", url: `/api/v1/composition-categories/${encodeURIComponent(id)}`, data: data });
     }
     /**
-     * Performs the list compositions operation for the router capability.
+     * Page compositions by updated time descending; defaults page1,size20 (clamps1..100). uncategorized=true overrides category_id; category filter includes descendants; search matches name/description.
      * Calls `GET /api/v1/compositions` through the shared IDP-aware Faiber client.
      * @param params Typed query parameters; omitted members retain backend defaults.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerListCompositionsGet(params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/compositions`, params });
     }
     /**
-     * Performs the create composition operation for the router capability.
+     * Create composition. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `POST /api/v1/compositions` through the shared IDP-aware Faiber client.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerCreateCompositionPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/compositions`, data: data });
     }
     /**
-     * Performs the list manifests operation for the router capability.
+     * List manifests. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/compositions/{id}/manifests` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerListManifestsGetApiV1CompositionsIdManifests(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/compositions/${encodeURIComponent(id)}/manifests` });
     }
     /**
-     * Performs the create manifest version operation for the router capability.
+     * Store caller-supplied historical JSON document and increment composition manifest version. Existing explicit manifest ID returns200, otherwise201.
      * Calls `POST /api/v1/compositions/{id}/manifests` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerCreateManifestVersionPost(id, data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/compositions/${encodeURIComponent(id)}/manifests`, data: data });
     }
     /**
-     * Performs the publish operation for the router capability.
+     * Validate a nonempty, singly started, connected acyclic workflow and ready video references, then create versioned manifest201. Referenced unarchived items may come from other libraries; launches Knowledge sync/optional analysis.
      * Calls `POST /api/v1/compositions/{id}/publish` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerPublishPostApiV1CompositionsIdPublish(id, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/compositions/${encodeURIComponent(id)}/publish` });
     }
     /**
-     * Performs the get workflow operation for the router capability.
+     * Get workflow. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/compositions/{id}/workflow` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerGetWorkflowGetApiV1CompositionsIdWorkflow(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/compositions/${encodeURIComponent(id)}/workflow` });
     }
     /**
-     * Performs the save workflow operation for the router capability.
+     * Replace nodes and edges arrays and increment revision; returns400 if either is not an array. Node data remains editor-defined JSON.
      * Calls `PUT /api/v1/compositions/{id}/workflow` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerSaveWorkflowPutApiV1CompositionsIdWorkflow(id, data, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/compositions/${encodeURIComponent(id)}/workflow`, data: data });
     }
     /**
-     * Performs the dashboard operation for the router capability.
+     * Read global media/content/package counts and latest10 updated jobs.
      * Calls `GET /api/v1/dashboard/summary` through the shared IDP-aware Faiber client.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerDashboardGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/dashboard/summary` });
     }
     /**
-     * Performs the list jobs operation for the router capability.
+     * Page DRM jobs newest first; defaults page1,size30 (clamps1..100); status/media_id/from/to filters combine. Response flattens job and adds media_name/media_type.
      * Calls `GET /api/v1/drm/jobs` through the shared IDP-aware Faiber client.
      * @param params Typed query parameters; omitted members retain backend defaults.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:package:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:package:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerListJobsGet(params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/drm/jobs`, params });
     }
     /**
-     * Performs the create job operation for the router capability.
+     * Enqueue video packaging (audio/image400); deduplicate existing queued/processing/retrying job; full config defaults true/true/true/false; returns202.
      * Calls `POST /api/v1/drm/jobs` through the shared IDP-aware Faiber client.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:package:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:package:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerCreateJobPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/drm/jobs`, data: data });
     }
     /**
-     * Performs the cancel job operation for the router capability.
+     * Cancel active job and update package/media transactionally; finished job400; success204.
      * Calls `DELETE /api/v1/drm/jobs/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:package:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:package:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerCancelJobDelete(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/drm/jobs/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the retry job operation for the router capability.
+     * Retry failed/cancelled job, optionally replacing config (undefined omits body); other states400. Resets package/media and queue state transactionally.
      * Calls `POST /api/v1/drm/jobs/{id}/retry` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:package:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:package:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerRetryJobPost(id, data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/drm/jobs/${encodeURIComponent(id)}/retry`, data: data });
     }
     /**
-     * Performs the retry all failed operation for the router capability.
+     * Retry only newest failed job per media and skip any media with active work; returns count.
      * Calls `POST /api/v1/drm/jobs/actions/retry-failed` through the shared IDP-aware Faiber client.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:package:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:package:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerRetryAllFailedPost(options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/drm/jobs/actions/retry-failed` });
     }
     /**
-     * Performs the list external references operation for the router capability.
+     * List external references. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/external-references` through the shared IDP-aware Faiber client.
      * @param params Typed query parameters; omitted members retain backend defaults.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerListExternalReferencesGet(params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/external-references`, params });
     }
     /**
-     * Performs the upsert external reference operation for the router capability.
+     * Create external mapping or return existing identical mapping; conflicting internal target409; existing metadata is preserved.
      * Calls `POST /api/v1/external-references` through the shared IDP-aware Faiber client.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerUpsertExternalReferencePost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/external-references`, data: data });
     }
     /**
-     * Performs the list folders operation for the router capability.
+     * List folders. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/folders` through the shared IDP-aware Faiber client.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerListFoldersGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/folders` });
     }
     /**
-     * Performs the create folder operation for the router capability.
+     * Create folder. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `POST /api/v1/folders` through the shared IDP-aware Faiber client.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerCreateFolderPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/folders`, data: data });
     }
     /**
-     * Performs the delete folder operation for the router capability.
+     * Delete folder. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `DELETE /api/v1/folders/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerDeleteFolderDelete(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/folders/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the update folder operation for the router capability.
+     * Update folder. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `PATCH /api/v1/folders/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerUpdateFolderPatch(id, data, options) {
         return this.client.request({ ...options, method: "PATCH", url: `/api/v1/folders/${encodeURIComponent(id)}`, data: data });
     }
     /**
-     * Performs the list libraries operation for the router capability.
+     * List only public libraries ordered by name; direct get by ID can read private libraries with route permission.
      * Calls `GET /api/v1/libraries` through the shared IDP-aware Faiber client.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:library:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:library:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerListLibrariesGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/libraries` });
     }
     /**
-     * Performs the create library operation for the router capability.
+     * Create public/private library; defaults public/active; blank name400. Existing explicit ID200, new201.
      * Calls `POST /api/v1/libraries` through the shared IDP-aware Faiber client.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:library:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:library:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerCreateLibraryPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/libraries`, data: data });
     }
     /**
-     * Performs the delete library operation for the router capability.
+     * Permanently delete library, categories, items, compositions and linked external references transactionally; requires dedicated library delete permission; success204.
      * Calls `DELETE /api/v1/libraries/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:library:delete.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:library:delete (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerDeleteLibraryDelete(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/libraries/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the get library operation for the router capability.
+     * Get library. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/libraries/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:library:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:library:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerGetLibraryGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/libraries/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the update library operation for the router capability.
+     * Replace library name/description and optionally status/visibility; description omitted clears; visibility only public/private.
      * Calls `PATCH /api/v1/libraries/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:library:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:library:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerUpdateLibraryPatch(id, data, options) {
         return this.client.request({ ...options, method: "PATCH", url: `/api/v1/libraries/${encodeURIComponent(id)}`, data: data });
     }
     /**
-     * Performs the list categories operation for the router capability.
+     * List categories. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/libraries/{id}/categories` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:library:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:library:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerListCategoriesGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/libraries/${encodeURIComponent(id)}/categories` });
     }
     /**
-     * Performs the create category operation for the router capability.
+     * Create category; parent must be in the same library or mixed media scope. Returns201, or200 on an existing explicit generic category ID.
      * Calls `POST /api/v1/libraries/{id}/categories` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:library:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:library:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerCreateCategoryPostApiV1LibrariesIdCategories(id, data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/libraries/${encodeURIComponent(id)}/categories`, data: data });
     }
     /**
-     * Performs the list items operation for the router capability.
+     * List items. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/libraries/{id}/items` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:content:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:content:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerListItemsGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/libraries/${encodeURIComponent(id)}/items` });
     }
     /**
-     * Performs the create item operation for the router capability.
+     * Create reusable content; state must be Question/Task/Interactive/Game. Negative duration clamps0. rewards is accepted but stored as empty object. Explicit existing ID returns200, otherwise201.
      * Calls `POST /api/v1/libraries/{id}/items` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:content:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:content:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerCreateItemPost(id, data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/libraries/${encodeURIComponent(id)}/items`, data: data });
     }
     /**
-     * Performs the query items operation for the router capability.
+     * Page unarchived library items by title; page1,size30,size clamps1..100. category_id includes descendants unless direct=true. errors=true finds missing/failed media; search filters title.
      * Calls `GET /api/v1/libraries/{id}/items/query` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param params Typed query parameters; omitted members retain backend defaults.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:content:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:content:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerQueryItemsGet(id, params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/libraries/${encodeURIComponent(id)}/items/query`, params });
     }
     /**
-     * Performs the library stats operation for the router capability.
+     * Library stats. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/libraries/{id}/stats` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:library:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:library:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerLibraryStatsGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/libraries/${encodeURIComponent(id)}/stats` });
     }
     /**
-     * Performs the archive category operation for the router capability.
+     * Archive category descendants and contained content transactionally; returns204. Category must belong to path library.
      * Calls `DELETE /api/v1/libraries/{library_id}/categories/{id}` through the shared IDP-aware Faiber client.
      * @param libraryId Backend path identifier `library_id`.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:library:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:library:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerArchiveCategoryDelete(libraryId, id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/libraries/${encodeURIComponent(libraryId)}/categories/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the update category operation for the router capability.
+     * Replace title and parent; reject self-parent. Generic library route and mixed-media route enforce their respective parent scope.
      * Calls `PATCH /api/v1/libraries/{library_id}/categories/{id}` through the shared IDP-aware Faiber client.
      * @param libraryId Backend path identifier `library_id`.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:library:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:library:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerUpdateCategoryPatchApiV1LibrariesLibraryIdCategoriesId(libraryId, id, data, options) {
         return this.client.request({ ...options, method: "PATCH", url: `/api/v1/libraries/${encodeURIComponent(libraryId)}/categories/${encodeURIComponent(id)}`, data: data });
     }
     /**
-     * Performs the archive item operation for the router capability.
+     * Archive item. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `DELETE /api/v1/libraries/{library_id}/items/{id}` through the shared IDP-aware Faiber client.
      * @param libraryId Backend path identifier `library_id`.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:content:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:content:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerArchiveItemDelete(libraryId, id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/libraries/${encodeURIComponent(libraryId)}/items/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the get item operation for the router capability.
+     * Read item by UUID. The pinned handler ignores library_id when fetching; callers must select the intended library and deployment authorization remains authoritative.
      * Calls `GET /api/v1/libraries/{library_id}/items/{id}` through the shared IDP-aware Faiber client.
      * @param libraryId Backend path identifier `library_id`.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:content:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:content:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerGetItemGet(libraryId, id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/libraries/${encodeURIComponent(libraryId)}/items/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the update item operation for the router capability.
+     * Replace item fields, checking path library. Negative duration clamps0; rewards is stored as empty object. Omitted optional members clear/reset corresponding fields.
      * Calls `PUT /api/v1/libraries/{library_id}/items/{id}` through the shared IDP-aware Faiber client.
      * @param libraryId Backend path identifier `library_id`.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:content:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:content:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerUpdateItemPut(libraryId, id, data, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/libraries/${encodeURIComponent(libraryId)}/items/${encodeURIComponent(id)}`, data: data });
     }
     /**
-     * Performs the item attachments operation for the router capability.
+     * Item attachments. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/libraries/{library_id}/items/{id}/attachments` through the shared IDP-aware Faiber client.
      * @param libraryId Backend path identifier `library_id`.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:content:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:content:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerItemAttachmentsGet(libraryId, id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/libraries/${encodeURIComponent(libraryId)}/items/${encodeURIComponent(id)}/attachments` });
     }
     /**
-     * Performs the attach media operation for the router capability.
+     * Attach primary/hint media; is_current demotes prior current attachment in the slot and updates the item media pointer; position clamps0; existing link200, new201.
      * Calls `POST /api/v1/libraries/{library_id}/items/{id}/attachments` through the shared IDP-aware Faiber client.
      * @param libraryId Backend path identifier `library_id`.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:content:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:content:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerAttachMediaPost(libraryId, id, data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/libraries/${encodeURIComponent(libraryId)}/items/${encodeURIComponent(id)}/attachments`, data: data });
     }
     /**
-     * Performs the clear key license operation for the router capability.
+     * Read temporary ClearKey JWK document; package_id UUID required. Keep key material private and use authenticated shared transport.
      * Calls `GET /api/v1/licenses/clearkey` through the shared IDP-aware Faiber client.
      * @param params Typed query parameters; omitted members retain backend defaults.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:license:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:license:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerClearKeyLicenseGet(params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/licenses/clearkey`, params });
     }
     /**
-     * Performs the list media operation for the router capability.
+     * Search name, description and matching tags, with media_type/folder_id/tag_id AND filters. Defaults page=1,size=30; size clamps1..100; newest created first.
      * Calls `GET /api/v1/media` through the shared IDP-aware Faiber client.
      * @param params Typed query parameters; omitted members retain backend defaults.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerListMediaGet(params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/media`, params });
     }
     /**
-     * Performs the upload media operation for the router capability.
+     * Upload audio, video or image multipart file. Fields name/description/folder_id are text; tag_ids is JSON-encoded UUID array. Returns201; video queues packaging and optional transcription.
      * Calls `POST /api/v1/media` through the shared IDP-aware Faiber client.
      * @param data Typed multipart form.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerUploadMediaPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/media`, data: data });
     }
     /**
-     * Performs the delete media operation for the router capability.
+     * Delete metadata, original and package storage; attached content conflicts409; returns204.
      * Calls `DELETE /api/v1/media/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerDeleteMediaDelete(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/media/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the get media operation for the router capability.
+     * Get media. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/media/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerGetMediaGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/media/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the update media operation for the router capability.
+     * Patch supplied metadata and replace tag links when tag_ids is present. Plain Serde Option<Option<Uuid>> means folder_id:null is a no-op; description/duration null also preserve.
      * Calls `PATCH /api/v1/media/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerUpdateMediaPatch(id, data, options) {
         return this.client.request({ ...options, method: "PATCH", url: `/api/v1/media/${encodeURIComponent(id)}`, data: data });
     }
     /**
-     * Performs the list packages operation for the router capability.
+     * List packages. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/media/{id}/packages` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:package:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:package:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerListPackagesGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/media/${encodeURIComponent(id)}/packages` });
     }
     /**
-     * Performs the regenerate operation for the router capability.
+     * Enqueue/deduplicate video packaging; JSON null selects default config; send null rather than an absent JSON body. Returns202 raw job without media_name/media_type.
      * Calls `POST /api/v1/media/{id}/packages` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:package:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:package:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerRegeneratePost(id, data, options) {
-        return this.client.request({ ...options, method: "POST", url: `/api/v1/media/${encodeURIComponent(id)}/packages`, data: data });
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/media/${encodeURIComponent(id)}/packages`, data: data, headers: { "Content-Type": "application/json", ...options?.headers } });
     }
     /**
-     * Performs the playback operation for the router capability.
+     * Return a900-second signed original-object URL, independent of package readiness. Archived media404; status alone does not hide the original.
      * Calls `GET /api/v1/media/{id}/playback` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerPlaybackGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/media/${encodeURIComponent(id)}/playback` });
     }
     /**
-     * Performs the batch media operation for the router capability.
+     * Read deduplicated IDs in request order; at most the first50 unique IDs are used; missing IDs are omitted.
      * Calls `POST /api/v1/media/batch` through the shared IDP-aware Faiber client.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerBatchMediaPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/media/batch`, data: data });
     }
     /**
-     * Performs the drm statuses operation for the router capability.
+     * Read effective video package/job states for comma-separated UUID ids (required). Invalid UUIDs ignored; at most500 unique IDs; ready package takes precedence; non-video not_applicable.
      * Calls `GET /api/v1/media/drm-statuses` through the shared IDP-aware Faiber client.
      * @param params Typed query parameters; omitted members retain backend defaults.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerDrmStatusesGet(params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/media/drm-statuses`, params });
     }
     /**
-     * Performs the archive package operation for the router capability.
+     * Archive package. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `DELETE /api/v1/media/packages/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:package:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:package:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerArchivePackageDelete(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/media/packages/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the register existing media operation for the router capability.
+     * Register existing originals/ object (reject ..) after actual size verification; accepts audio/video/image. Existing ID returns200; new201; video queues DRM/transcription.
      * Calls `POST /api/v1/media/register` through the shared IDP-aware Faiber client.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerRegisterExistingMediaPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/media/register`, data: data });
     }
     /**
-     * Performs the list mixed media operation for the router capability.
+     * List mixed media. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/mixed-media` through the shared IDP-aware Faiber client.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerListMixedMediaGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/mixed-media` });
     }
     /**
-     * Performs the create mixed media operation for the router capability.
+     * Create composition and revision1 workflow. Requires existing library/category; nonempty name; transcription_language auto/fa/en; defaults auto; returns201.
      * Calls `POST /api/v1/mixed-media` through the shared IDP-aware Faiber client.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerCreateMixedMediaPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/mixed-media`, data: data });
     }
     /**
-     * Performs the delete mixed media operation for the router capability.
+     * Delete mixed media. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `DELETE /api/v1/mixed-media/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerDeleteMixedMediaDelete(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/mixed-media/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the get mixed media operation for the router capability.
+     * Get mixed media. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/mixed-media/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerGetMixedMediaGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/mixed-media/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the update mixed media operation for the router capability.
+     * Patch composition. category_id:null explicitly clears category; omitted category preserves. Plain nested-Option description:null preserves at this pin. Language auto/fa/en; status draft/published/inactive.
      * Calls `PATCH /api/v1/mixed-media/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerUpdateMixedMediaPatch(id, data, options) {
         return this.client.request({ ...options, method: "PATCH", url: `/api/v1/mixed-media/${encodeURIComponent(id)}`, data: data });
     }
     /**
-     * Performs the get analysis operation for the router capability.
+     * Return analysis or JSON null when no analysis/composition exists; errors other than not-found propagate.
      * Calls `GET /api/v1/mixed-media/{id}/analysis` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerGetAnalysisGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/mixed-media/${encodeURIComponent(id)}/analysis` });
     }
     /**
-     * Performs the start analysis operation for the router capability.
+     * Queue composition analysis; body may be omitted (undefined) or supply language/force. Language override persists and requires auto/fa/en. Returns existing active work unless force applies; model/settings errors400.
      * Calls `POST /api/v1/mixed-media/{id}/analysis` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerStartAnalysisPost(id, data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/mixed-media/${encodeURIComponent(id)}/analysis`, data: data });
     }
     /**
-     * Performs the create category operation for the router capability.
+     * Create category; parent must be in the same library or mixed media scope. Returns201, or200 on an existing explicit generic category ID.
      * Calls `POST /api/v1/mixed-media/{id}/categories` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerCreateCategoryPostApiV1MixedMediaIdCategories(id, data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/mixed-media/${encodeURIComponent(id)}/categories`, data: data });
     }
     /**
-     * Performs the get settings operation for the router capability.
+     * Read persisted settings. Knowledge settings read creates default row for an existing composition; absent composition404. Operations settings require drm:manage.
      * Calls `GET /api/v1/mixed-media/{id}/knowledge-sync` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerGetSettingsGetApiV1MixedMediaIdKnowledgeSync(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/mixed-media/${encodeURIComponent(id)}/knowledge-sync` });
     }
     /**
-     * Performs the sync now operation for the router capability.
+     * Synchronize published composition using Knowledge broker; x-organization-id UUID required unless server default configured. Returns settings; disabled/missing configuration can reject.
      * Calls `POST /api/v1/mixed-media/{id}/knowledge-sync` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerSyncNowPost(id, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/mixed-media/${encodeURIComponent(id)}/knowledge-sync` });
     }
     /**
-     * Performs the update settings operation for the router capability.
+     * Update operational or Knowledge settings. Operations package_concurrency1..16; enabled transcription requires speech and summary models. Knowledge enabled requires knowledge_base_id and organization context; starts immediate sync.
      * Calls `PUT /api/v1/mixed-media/{id}/knowledge-sync` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerUpdateSettingsPut(id, data, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/mixed-media/${encodeURIComponent(id)}/knowledge-sync`, data: data });
     }
     /**
-     * Performs the get manifest operation for the router capability.
+     * Get manifest. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/mixed-media/{id}/manifest` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerGetManifestGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/mixed-media/${encodeURIComponent(id)}/manifest` });
     }
     /**
-     * Performs the list manifests operation for the router capability.
+     * List manifests. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/mixed-media/{id}/manifests` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerListManifestsGetApiV1MixedMediaIdManifests(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/mixed-media/${encodeURIComponent(id)}/manifests` });
     }
     /**
-     * Performs the create part operation for the router capability.
+     * Create composition part; nonempty title, Question/Task/Interactive/Game state and nonnegative duration required; referenced media must exist. rewards is persisted empty; returns201.
      * Calls `POST /api/v1/mixed-media/{id}/parts` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerCreatePartPost(id, data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/mixed-media/${encodeURIComponent(id)}/parts`, data: data });
     }
     /**
-     * Performs the publish operation for the router capability.
+     * Validate a nonempty, singly started, connected acyclic workflow and ready video references, then create versioned manifest201. Referenced unarchived items may come from other libraries; launches Knowledge sync/optional analysis.
      * Calls `POST /api/v1/mixed-media/{id}/publish` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerPublishPostApiV1MixedMediaIdPublish(id, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/mixed-media/${encodeURIComponent(id)}/publish` });
     }
     /**
-     * Performs the resources operation for the router capability.
+     * Read unarchived categories and parts from the composition owning library, ordered by title.
      * Calls `GET /api/v1/mixed-media/{id}/resources` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerResourcesGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/mixed-media/${encodeURIComponent(id)}/resources` });
     }
     /**
-     * Performs the get workflow operation for the router capability.
+     * Get workflow. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/mixed-media/{id}/workflow` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerGetWorkflowGetApiV1MixedMediaIdWorkflow(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/mixed-media/${encodeURIComponent(id)}/workflow` });
     }
     /**
-     * Performs the save workflow operation for the router capability.
+     * Replace nodes and edges arrays and increment revision; returns400 if either is not an array. Node data remains editor-defined JSON.
      * Calls `PUT /api/v1/mixed-media/{id}/workflow` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerSaveWorkflowPutApiV1MixedMediaIdWorkflow(id, data, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/mixed-media/${encodeURIComponent(id)}/workflow`, data: data });
     }
     /**
-     * Performs the delete category operation for the router capability.
+     * Delete category. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `DELETE /api/v1/mixed-media/{mixed_id}/categories/{id}` through the shared IDP-aware Faiber client.
      * @param mixedId Backend path identifier `mixed_id`.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerDeleteCategoryDelete(mixedId, id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/mixed-media/${encodeURIComponent(mixedId)}/categories/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the update category operation for the router capability.
+     * Replace title and parent; reject self-parent. Generic library route and mixed-media route enforce their respective parent scope.
      * Calls `PATCH /api/v1/mixed-media/{mixed_id}/categories/{id}` through the shared IDP-aware Faiber client.
      * @param mixedId Backend path identifier `mixed_id`.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerUpdateCategoryPatchApiV1MixedMediaMixedIdCategoriesId(mixedId, id, data, options) {
         return this.client.request({ ...options, method: "PATCH", url: `/api/v1/mixed-media/${encodeURIComponent(mixedId)}/categories/${encodeURIComponent(id)}`, data: data });
     }
     /**
-     * Performs the delete part operation for the router capability.
+     * Delete part. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `DELETE /api/v1/mixed-media/{mixed_id}/parts/{id}` through the shared IDP-aware Faiber client.
      * @param mixedId Backend path identifier `mixed_id`.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerDeletePartDelete(mixedId, id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/mixed-media/${encodeURIComponent(mixedId)}/parts/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the get part operation for the router capability.
+     * Get part. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/mixed-media/{mixed_id}/parts/{id}` through the shared IDP-aware Faiber client.
      * @param mixedId Backend path identifier `mixed_id`.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerGetPartGet(mixedId, id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/mixed-media/${encodeURIComponent(mixedId)}/parts/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the update part operation for the router capability.
+     * Replace composition part within path parent; validates title/state/duration/media and stores rewards as empty object.
      * Calls `PUT /api/v1/mixed-media/{mixed_id}/parts/{id}` through the shared IDP-aware Faiber client.
      * @param mixedId Backend path identifier `mixed_id`.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:composition:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:composition:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerUpdatePartPut(mixedId, id, data, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/mixed-media/${encodeURIComponent(mixedId)}/parts/${encodeURIComponent(id)}`, data: data });
     }
     /**
-     * Performs the health operation for the router capability.
+     * Read dependency/tool/storage health including nullable tool versions and public_url; service marker remains ok even if dependencies are false.
      * Calls `GET /api/v1/operations/health` through the shared IDP-aware Faiber client.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerHealthGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/operations/health` });
     }
     /**
-     * Performs the knowledge catalog operation for the router capability.
+     * Proxy Knowledge platform catalog verbatim; requires x-organization-id UUID unless server default configured. Forwards Authorization or configured service credential. Upstream failures500.
      * Calls `GET /api/v1/operations/knowledge-catalog` through the shared IDP-aware Faiber client.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerKnowledgeCatalogGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/operations/knowledge-catalog` });
     }
     /**
-     * Performs the get settings operation for the router capability.
+     * Read persisted settings. Knowledge settings read creates default row for an existing composition; absent composition404. Operations settings require drm:manage.
      * Calls `GET /api/v1/operations/settings` through the shared IDP-aware Faiber client.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:manage.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:manage (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerGetSettingsGetApiV1OperationsSettings(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/operations/settings` });
     }
     /**
-     * Performs the update settings operation for the router capability.
+     * Update operational or Knowledge settings. Operations package_concurrency1..16; enabled transcription requires speech and summary models. Knowledge enabled requires knowledge_base_id and organization context; starts immediate sync.
      * Calls `PATCH /api/v1/operations/settings` through the shared IDP-aware Faiber client.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:manage.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:manage (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerUpdateSettingsPatch(data, options) {
         return this.client.request({ ...options, method: "PATCH", url: `/api/v1/operations/settings`, data: data });
     }
     /**
-     * Performs the transcription models operation for the router capability.
+     * Transcription models. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/operations/transcription-models` through the shared IDP-aware Faiber client.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:manage.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:manage (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerTranscriptionModelsGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/operations/transcription-models` });
     }
     /**
-     * Performs the legacy enqueue operation for the router capability.
+     * Legacy video enqueue; omitted download/transcode/package default false (unlike modern config); returns202 with job_id/status.
      * Calls `POST /api/v1/packages` through the shared IDP-aware Faiber client.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:package:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:package:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerLegacyEnqueuePost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/packages`, data: data });
     }
     /**
-     * Performs the legacy status operation for the router capability.
+     * Read newest job for media UUID; kind path member is ignored by pinned handler; response contains key/content_type/policy/status plus job_id/progress.
      * Calls `GET /api/v1/packages/{kind}/{media_id}` through the shared IDP-aware Faiber client.
      * @param kind Backend path identifier `kind`.
      * @param mediaId Backend path identifier `media_id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:package:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:package:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerLegacyStatusGet(kind, mediaId, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/packages/${encodeURIComponent(kind)}/${encodeURIComponent(mediaId)}` });
     }
     /**
-     * Performs the package file operation for the router capability.
+     * Download raw ready package bytes with optional Range header. Returns200 or206 with Content-Range/Accept-Ranges/Content-Type/cache metadata. Not-ready409; invalid path400; missing object404.
      * Calls `GET /api/v1/packages/{package_id}/files/{*path}` through the shared IDP-aware Faiber client.
      * @param packageId Backend path identifier `package_id`.
      * @param path Backend path identifier `*path`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:package:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:package:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerPackageFileGet(packageId, path, options) {
-        return this.client.request({ ...options, method: "GET", url: `/api/v1/packages/${encodeURIComponent(packageId)}/files/${encodeURIComponent(path)}` });
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/packages/${encodeURIComponent(packageId)}/files/${wildcardPath(path)}`, responseType: "arraybuffer" });
     }
     /**
-     * Performs the status operation for the router capability.
+     * Read public liveness marker; this does not inspect database or object storage.
      * Calls `GET /api/v1/status` through the shared IDP-aware Faiber client.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Public status; configured credentials still forwarded through FaiberClient.
      */
     routerStatusGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/status` });
     }
     /**
-     * Performs the list tags operation for the router capability.
+     * List tags. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/tags` through the shared IDP-aware Faiber client.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerListTagsGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/tags` });
     }
     /**
-     * Performs the create tag operation for the router capability.
+     * Create tag. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `POST /api/v1/tags` through the shared IDP-aware Faiber client.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerCreateTagPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/tags`, data: data });
     }
     /**
-     * Performs the delete tag operation for the router capability.
+     * Delete tag. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `DELETE /api/v1/tags/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerDeleteTagDelete(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/tags/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the create upload session operation for the router capability.
+     * Create24-hour resumable session for audio/video/image; total_bytes positive; default part10MiB clamped5..64MiB; existing media_id409; returns201 with sorted parts.
      * Calls `POST /api/v1/upload-sessions` through the shared IDP-aware Faiber client.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerCreateUploadSessionPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/upload-sessions`, data: data });
     }
     /**
-     * Performs the cancel upload operation for the router capability.
+     * Abort uploading storage session and mark cancelled; returns204, including sessions already completed/cancelled.
      * Calls `DELETE /api/v1/upload-sessions/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerCancelUploadDelete(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/upload-sessions/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the get upload session operation for the router capability.
+     * Get upload session. Returns the bare JSON payload with full Axios status/headers; missing records404 and validation400.
      * Calls `GET /api/v1/upload-sessions/{id}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:read.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:read (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerGetUploadSessionGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/upload-sessions/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the complete upload operation for the router capability.
+     * Complete multipart when uploaded sizes sum total_bytes, verify stored size and register media201; repeat completed session200. checksum_sha256 is stored client metadata, not independently verified.
      * Calls `POST /api/v1/upload-sessions/{id}/complete` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param data Typed JSON request body.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerCompleteUploadPost(id, data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/upload-sessions/${encodeURIComponent(id)}/complete`, data: data });
     }
     /**
-     * Performs the put upload part operation for the router capability.
+     * Send raw bytes (not JSON/multipart), part_number1..10000; nonempty body no larger than session part_size; expired/non-uploading409. Re-upload replaces stored part metadata.
      * Calls `PUT /api/v1/upload-sessions/{id}/parts/{part_number}` through the shared IDP-aware Faiber client.
      * @param id Backend path identifier `id`.
      * @param partNumber Backend path identifier `part_number`.
      * @param data Typed binary byte stream.
      * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
-     * @returns The complete Axios response, including the typed service envelope, status, and headers.
-     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: drm:media:write.
+     * @returns The complete Axios response, including the typed handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Local AuthContext requires drm:media:write (management/wildcard aliases accepted). Pinned IDP SDK extracts trusted x-user-* headers with dev-fallback and does not verify tokens; use an enforcing gateway. FaiberClient forwards configured Bearer/cookie credentials; deployed gateway authority remains unverified.
      */
     routerPutUploadPartPut(id, partNumber, data, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/upload-sessions/${encodeURIComponent(id)}/parts/${encodeURIComponent(partNumber)}`, data: data, headers: { "Content-Type": "application/octet-stream", ...options?.headers } });