@faiber/faiber-social 0.24.1 → 1.0.0

package/dist/operations.js

@@ -1,680 +1,1243 @@
 import { ServiceApi, urlEncoded } from "@faiber/sdk-core";
 export class SocialOperations extends ServiceApi {
     /**
-     * Performs the import modules operation for the api capability.
+     * Import legacy Modules social records within the current organization; dry_run defaults true. Returns counters and the explicit legacy reaction mapping; requires social:admin.
      * Calls `POST /api/v1/admin/import/modules` 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: social:admin.
+     * @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: social:admin; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiImportModulesPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/admin/import/modules`, data: data });
     }
     /**
-     * Performs the self identity operation for the api capability.
+     * Page actors by latest post time; q optionally filters an actor UUID. Invalid q is currently ignored; meta.total is current-page length.
+     * Calls `GET /api/v1/admin/social/actors` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:content:read; current trusted organization/actor context required.
+     */
+    adminActorsGet(params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/actors`, params });
+    }
+    /**
+     * Read actor activity counts and restriction rows in the organization; a UUID with no activity returns zero counts.
+     * Calls `GET /api/v1/admin/social/actors/{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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:content:read; current trusted organization/actor context required.
+     */
+    adminActorDetailGet(id, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/actors/${encodeURIComponent(id)}` });
+    }
+    /**
+     * Read organization-scoped counts by status and navigation grant events; includes deleted posts in status totals.
+     * Calls `GET /api/v1/admin/social/analytics` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:analytics:read; current trusted organization/actor context required.
+     */
+    adminAnalyticsGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/analytics` });
+    }
+    /**
+     * Page organization-scoped audit rows. status filters exact audit action, not a lifecycle state.
+     * Calls `GET /api/v1/admin/social/audit` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:audit:read; current trusted organization/actor context required.
+     */
+    adminAuditGet(params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/audit`, params });
+    }
+    /**
+     * Page organization-scoped bounties with exact status filter and newest-update ordering. Admin amount uses a JSON number.
+     * Calls `GET /api/v1/admin/social/bounties` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:funding:review; current trusted organization/actor context required.
+     */
+    adminBountiesGet(params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/bounties`, params });
+    }
+    /**
+     * Read a bounty UUID in the organization; missing records return404.
+     * Calls `GET /api/v1/admin/social/bounties/{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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:funding:review; current trusted organization/actor context required.
+     */
+    adminBountyDetailGet(id, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/bounties/${encodeURIComponent(id)}` });
+    }
+    /**
+     * List category capability policies ordered by category UUID and descending version, including draft/retired.
+     * Calls `GET /api/v1/admin/social/capability-policies` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:panel:view; current trusted organization/actor context required.
+     */
+    adminPoliciesGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/capability-policies` });
+    }
+    /**
+     * Create a new draft policy version for a category; authenticated operator required; returns201. Only seven supported config section names are accepted.
+     * Calls `POST /api/v1/admin/social/capability-policies` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:capabilities:manage; current trusted organization/actor context required.
+     */
+    adminCreatePolicyPost(data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/admin/social/capability-policies`, data: data });
+    }
+    /**
+     * Read an organization-scoped capability policy UUID; missing records return404.
+     * Calls `GET /api/v1/admin/social/capability-policies/{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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:panel:view; current trusted organization/actor context required.
+     */
+    adminPolicyDetailGet(id, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/capability-policies/${encodeURIComponent(id)}` });
+    }
+    /**
+     * Replace draft config for the matching category; non-draft, missing or mismatched category returns409.
+     * Calls `PATCH /api/v1/admin/social/capability-policies/{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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:capabilities:manage; current trusted organization/actor context required.
+     */
+    adminUpdatePolicyPatch(id, data, options) {
+        return this.client.request({ ...options, method: "PATCH", url: `/api/v1/admin/social/capability-policies/${encodeURIComponent(id)}`, data: data });
+    }
+    /**
+     * Publish a draft and retire the previously published category policy in one transaction. Authenticated operator required; non-draft returns409.
+     * Calls `POST /api/v1/admin/social/capability-policies/{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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:capabilities:manage; current trusted organization/actor context required.
+     */
+    adminPublishPolicyPost(id, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/admin/social/capability-policies/${encodeURIComponent(id)}/publish` });
+    }
+    /**
+     * List non-deleted categories, including hidden/archived status; no pagination.
+     * Calls `GET /api/v1/admin/social/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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:panel:view; current trusted organization/actor context required.
+     */
+    adminCategoriesGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/categories` });
+    }
+    /**
+     * Create a validated category; returns201. Localized name/description and metadata use backend JSON values.
+     * Calls `POST /api/v1/admin/social/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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:categories:manage; current trusted organization/actor context required.
+     */
+    adminCreateCategoryPost(data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/admin/social/categories`, data: data });
+    }
+    /**
+     * Soft-delete a category; returns204 without a response body.
+     * Calls `DELETE /api/v1/admin/social/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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:categories:manage; current trusted organization/actor context required.
+     */
+    adminArchiveCategoryDelete(id, options) {
+        return this.client.request({ ...options, method: "DELETE", url: `/api/v1/admin/social/categories/${encodeURIComponent(id)}` });
+    }
+    /**
+     * Read a non-deleted category UUID from the organization-scoped category list.
+     * Calls `GET /api/v1/admin/social/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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:panel:view; current trusted organization/actor context required.
+     */
+    adminCategoryDetailGet(id, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/categories/${encodeURIComponent(id)}` });
+    }
+    /**
+     * Patch a category using supplied fields; absent and null optional fields follow backend Option semantics.
+     * Calls `PATCH /api/v1/admin/social/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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:categories:manage; current trusted organization/actor context required.
+     */
+    adminUpdateCategoryPatch(id, data, options) {
+        return this.client.request({ ...options, method: "PATCH", url: `/api/v1/admin/social/categories/${encodeURIComponent(id)}`, data: data });
+    }
+    /**
+     * Page organization-scoped claims with exact status filtering.
+     * Calls `GET /api/v1/admin/social/claims` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:claims:manage; current trusted organization/actor context required.
+     */
+    adminClaimsGet(params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/claims`, params });
+    }
+    /**
+     * Read a claim UUID in the organization; missing records return404.
+     * Calls `GET /api/v1/admin/social/claims/{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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:claims:manage; current trusted organization/actor context required.
+     */
+    adminClaimDetailGet(id, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/claims/${encodeURIComponent(id)}` });
+    }
+    /**
+     * Resolve an author-selected and author-approved claim in a transaction, update post lifecycle and audit. Authenticated operator required; unmet selection prerequisites return409.
+     * Calls `POST /api/v1/admin/social/claims/{id}/approve` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:claims:manage; current trusted organization/actor context required.
+     */
+    adminApproveClaimPost(id, data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/admin/social/claims/${encodeURIComponent(id)}/approve`, data: data });
+    }
+    /**
+     * Reject a submitted/selected claim and audit the decision. Nonempty reason and authenticated operator required. Terminal claims return409; the claim row is locked while applying the decision.
+     * Calls `POST /api/v1/admin/social/claims/{id}/reject` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:claims:manage; current trusted organization/actor context required.
+     */
+    adminRejectClaimPost(id, data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/admin/social/claims/${encodeURIComponent(id)}/reject`, data: data });
+    }
+    /**
+     * Page comments including deleted records; status filters moderation_status. q/category_id are ignored.
+     * Calls `GET /api/v1/admin/social/comments` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:content:read; current trusted organization/actor context required.
+     */
+    adminCommentsGet(params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/comments`, params });
+    }
+    /**
+     * Read an organization-scoped comment UUID, including deleted rows; missing records return404.
+     * Calls `GET /api/v1/admin/social/comments/{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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:content:read; current trusted organization/actor context required.
+     */
+    adminCommentDetailGet(id, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/comments/${encodeURIComponent(id)}` });
+    }
+    /**
+     * Page organization-scoped durable integration events with exact status filter and newest-update ordering.
+     * Calls `GET /api/v1/admin/social/integrations` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:integrations:manage; current trusted organization/actor context required.
+     */
+    adminIntegrationsGet(params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/integrations`, params });
+    }
+    /**
+     * Read an organization-scoped durable event UUID, including its payload; missing returns404.
+     * Calls `GET /api/v1/admin/social/integrations/{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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:integrations:manage; current trusted organization/actor context required.
+     */
+    adminIntegrationDetailGet(id, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/integrations/${encodeURIComponent(id)}` });
+    }
+    /**
+     * Reset failed/dead_letter events to pending and audit a replay request. Authenticated operator and nonempty reason required; other statuses return409. Receipt is queued, not delivered; the outbox reset and audit insert commit in one transaction.
+     * Calls `POST /api/v1/admin/social/integrations/{id}/replay` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:integrations:manage; current trusted organization/actor context required.
+     */
+    adminReplayIntegrationPost(id, data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/admin/social/integrations/${encodeURIComponent(id)}/replay`, data: data });
+    }
+    /**
+     * Reveal decrypted coordinates with a mandatory nonempty operator reason and audit event. Response is no-store/no-cache; expire the result after60seconds.
+     * Calls `POST /api/v1/admin/social/locations/{post_id}/reveal` through the shared IDP-aware Faiber client.
+     * @param postId Backend path identifier `post_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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:location:reveal; current trusted organization/actor context required.
+     */
+    adminRevealLocationPost(postId, data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/admin/social/locations/${encodeURIComponent(postId)}/reveal`, data: data });
+    }
+    /**
+     * Page uploaded media. status filters exact content_type, not lifecycle status.
+     * Calls `GET /api/v1/admin/social/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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:content:read; current trusted organization/actor context required.
+     */
+    adminMediaGet(params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/media`, params });
+    }
+    /**
+     * Read pending non-deleted posts/comments and open/reviewing reports. Awaiting-funding posts are excluded; queue is unpaginated.
+     * Calls `GET /api/v1/admin/social/moderation/queue` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:moderation:review; current trusted organization/actor context required.
+     */
+    adminModerationQueueGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/moderation/queue` });
+    }
+    /**
+     * Read organization-scoped operator totals.
+     * Calls `GET /api/v1/admin/social/overview` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:panel:view; current trusted organization/actor context required.
+     */
+    adminOverviewGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/overview` });
+    }
+    /**
+     * Page non-deleted posts, filtering moderation status, category UUID and trimmed title/body search.
+     * Calls `GET /api/v1/admin/social/posts` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:content:read; current trusted organization/actor context required.
+     */
+    adminPostsGet(params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/posts`, params });
+    }
+    /**
+     * Read a post, metadata, report rows, activity counts and public capability projection. Missing or deleted post projection returns404.
+     * Calls `GET /api/v1/admin/social/posts/{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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:content:read; current trusted organization/actor context required.
+     */
+    adminPostDetailGet(id, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/posts/${encodeURIComponent(id)}` });
+    }
+    /**
+     * Page organization-scoped reports with exact status filtering.
+     * Calls `GET /api/v1/admin/social/reports` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:reports:manage; current trusted organization/actor context required.
+     */
+    adminReportsGet(params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/reports`, params });
+    }
+    /**
+     * Read a report UUID in the organization; missing records return404.
+     * Calls `GET /api/v1/admin/social/reports/{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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:reports:manage; current trusted organization/actor context required.
+     */
+    adminReportDetailGet(id, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/reports/${encodeURIComponent(id)}` });
+    }
+    /**
+     * Page organization-scoped restrictions with exact status filter.
+     * Calls `GET /api/v1/admin/social/restrictions` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:actors:restrict; current trusted organization/actor context required.
+     */
+    adminRestrictionsGet(params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/restrictions`, params });
+    }
+    /**
+     * Create an active restriction; authenticated operator, valid scope, nonempty reason and end later than start required; returns201.
+     * Calls `POST /api/v1/admin/social/restrictions` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:actors:restrict; current trusted organization/actor context required.
+     */
+    adminCreateRestrictionPost(data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/admin/social/restrictions`, data: data });
+    }
+    /**
+     * Revoke an active restriction with an authenticated operator and nonempty reason; non-active/missing returns409.
+     * Calls `POST /api/v1/admin/social/restrictions/{id}/revoke` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:actors:restrict; current trusted organization/actor context required.
+     */
+    adminRevokeRestrictionPost(id, data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/admin/social/restrictions/${encodeURIComponent(id)}/revoke`, data: data });
+    }
+    /**
+     * Read configuration-presence flags and capability contract version. This does not disclose secrets or prove they are valid.
+     * Calls `GET /api/v1/admin/social/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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:settings:manage; current trusted organization/actor context required.
+     */
+    adminSettingsGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/admin/social/settings` });
+    }
+    /**
+     * Read the middleware-derived current user UUID, roles and permissions.
      * Calls `GET /api/v1/auth/self` 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: session-derived or public bootstrap route.
+     * @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: middleware-derived IDP identity.
      */
     apiSelfIdentityGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/auth/self` });
     }
     /**
-     * Performs the list categories operation for the api capability.
+     * Remove the current actor block edge; idempotent204.
+     * Calls `DELETE /api/v1/block/{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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted server BFF_SERVICE_KEY bearer plus actor UUID.
+     */
+    discoveryUnblockDelete(id, options) {
+        return this.client.request({ ...options, method: "DELETE", url: `/api/v1/block/${encodeURIComponent(id)}` });
+    }
+    /**
+     * Block a user and remove user-follow edges in both directions; self-block400, success204. Current handler uses separate statements.
+     * Calls `PUT /api/v1/block/{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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted server BFF_SERVICE_KEY bearer plus actor UUID.
+     */
+    discoveryBlockPut(id, options) {
+        return this.client.request({ ...options, method: "PUT", url: `/api/v1/block/${encodeURIComponent(id)}` });
+    }
+    /**
+     * List organization-scoped, non-deleted categories ordered by sort_order and slug; hidden/archived categories are included.
      * Calls `GET /api/v1/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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiListCategoriesGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/categories` });
     }
     /**
-     * Performs the create category operation for the api capability.
+     * Create a category (201). Slug normalizes to lowercase ASCII letters/digits/hyphens/underscores, 1–100 bytes. Localized labels, description and metadata remain application JSON.
      * Calls `POST /api/v1/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: social:category: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: social:category:manage; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiCreateCategoryPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/categories`, data: data });
     }
     /**
-     * Performs the delete category operation for the api capability.
+     * Soft-delete the category; returns 204 with no body.
      * Calls `DELETE /api/v1/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: social:category: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: social:category:manage; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiDeleteCategoryDelete(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/categories/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the update category operation for the api capability.
+     * Patch supplied category fields. Null and absent Option fields leave stored values unchanged; slug/status validation matches creation.
      * Calls `PATCH /api/v1/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: social:category: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: social:category:manage; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiUpdateCategoryPatch(id, data, options) {
         return this.client.request({ ...options, method: "PATCH", url: `/api/v1/categories/${encodeURIComponent(id)}`, data: data });
     }
     /**
-     * Performs the category capability policy operation for the api capability.
+     * Read the published category policy projection (404 when absent), including configurable JSON sections and published_at.
      * Calls `GET /api/v1/categories/{id}/capability-policy` 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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiCategoryCapabilityPolicyGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/categories/${encodeURIComponent(id)}/capability-policy` });
     }
     /**
-     * Performs the claim detail operation for the api capability.
+     * Read a private claim for its claimant, post author or claims manager; returns mutual contact consent and nullable resolution. Nonparticipants return 403.
      * Calls `GET /api/v1/claims/{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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiClaimDetailGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/claims/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the set contact consent operation for the api capability.
+     * Set consent for a claim participant; mutual_consent reflects both participant grants. Requires an authenticated participant.
      * Calls `PUT /api/v1/claims/{id}/contact-consent` 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: social:claim:consent.
+     * @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: social:claim:consent; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiSetContactConsentPut(id, data, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/claims/${encodeURIComponent(id)}/contact-consent`, data: data });
     }
     /**
-     * Performs the select claim operation for the api capability.
+     * Select a submitted claim as the post author in a transaction and create pending resolution. Another selected claim returns 409; returns claim_id/post_id/status/author_approved.
      * Calls `POST /api/v1/claims/{id}/select` 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: social:claim:select_own.
+     * @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: social:claim:select_own; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiSelectClaimPost(id, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/claims/${encodeURIComponent(id)}/select` });
     }
     /**
-     * Performs the withdraw claim operation for the api capability.
+     * Withdraw only the current claimant submitted claim; other states or ownership return 409. Returns id/status.
      * Calls `POST /api/v1/claims/{id}/withdraw` 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: social:claim:update_own.
+     * @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: social:claim:update_own; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiWithdrawClaimPost(id, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/claims/${encodeURIComponent(id)}/withdraw` });
     }
     /**
-     * Performs the delete comment operation for the api capability.
+     * Soft-delete author-owned comment, or a moderator-authorized comment, and refresh counts; returns 204.
      * Calls `DELETE /api/v1/comments/{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: social:comment:delete_own.
+     * @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: social:comment:delete_own; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiDeleteCommentDelete(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/comments/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the update comment operation for the api capability.
+     * Update author-owned comment body (1–10000 trimmed characters). Category moderation can require review.
      * Calls `PATCH /api/v1/comments/{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: social:comment:update_own.
+     * @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: social:comment:update_own; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiUpdateCommentPatch(id, data, options) {
         return this.client.request({ ...options, method: "PATCH", url: `/api/v1/comments/${encodeURIComponent(id)}`, data: data });
     }
     /**
-     * Performs the remove comment reaction operation for the api capability.
+     * Remove current user comment reaction and refresh counts; returns 204.
      * Calls `DELETE /api/v1/comments/{id}/like` 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: social:reaction: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: social:reaction:write; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiRemoveCommentReactionDeleteApiV1CommentsIdLike(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/comments/${encodeURIComponent(id)}/like` });
     }
     /**
-     * Performs the like comment operation for the api capability.
+     * Set the current user comment reaction to like, returning the reaction record.
      * Calls `PUT /api/v1/comments/{id}/like` 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: social:reaction: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: social:reaction:write; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiLikeCommentPut(id, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/comments/${encodeURIComponent(id)}/like` });
     }
     /**
-     * Performs the remove comment reaction operation for the api capability.
+     * Remove current user comment reaction and refresh counts; returns 204.
      * Calls `DELETE /api/v1/comments/{id}/reaction` 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: social:reaction: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: social:reaction:write; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiRemoveCommentReactionDeleteApiV1CommentsIdReaction(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/comments/${encodeURIComponent(id)}/reaction` });
     }
     /**
-     * Performs the comment reactions operation for the api capability.
+     * Read comment reaction totals, counts by reaction type and nullable viewer_reaction after verifying target visibility.
      * Calls `GET /api/v1/comments/{id}/reaction` 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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiCommentReactionsGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/comments/${encodeURIComponent(id)}/reaction` });
     }
     /**
-     * Performs the set comment reaction operation for the api capability.
+     * Upsert current user comment reaction after visibility and restriction checks; type is one of like/love/care/haha/wow/sad/angry.
      * Calls `PUT /api/v1/comments/{id}/reaction` 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: social:reaction: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: social:reaction:write; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiSetCommentReactionPut(id, data, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/comments/${encodeURIComponent(id)}/reaction`, data: data });
     }
     /**
-     * Performs the list post comments operation for the api capability.
+     * Read published non-deleted comments oldest-first after checking parent visibility; no pagination query is consumed.
      * Calls `GET /api/v1/comments/post/{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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiListPostCommentsGetApiV1CommentsPostId(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/comments/post/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the create post comment operation for the api capability.
+     * Create a post comment (201), checking parent post and optional same-post non-deleted parent comment. Body is trimmed, 1–10000 characters; category moderation/restrictions apply.
      * Calls `POST /api/v1/comments/post/{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: social:comment:create.
+     * @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: social:comment:create; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiCreatePostCommentPostApiV1CommentsPostId(id, data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/comments/post/${encodeURIComponent(id)}`, data: data });
     }
     /**
-     * Performs the receive funding event operation for the api capability.
+     * Remove the current actor follow edge; returns204 even when no edge existed.
+     * Calls `DELETE /api/v1/follow/{kind}/{id}` through the shared IDP-aware Faiber client.
+     * @param kind Backend path identifier `kind`.
+     * @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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted server BFF_SERVICE_KEY bearer plus actor UUID.
+     */
+    discoveryUnfollowDelete(kind, id, options) {
+        return this.client.request({ ...options, method: "DELETE", url: `/api/v1/follow/${encodeURIComponent(kind)}/${encodeURIComponent(id)}` });
+    }
+    /**
+     * Read whether the current BFF actor follows or blocks a user/place target. kind is place or user.
+     * Calls `GET /api/v1/follow/{kind}/{id}` through the shared IDP-aware Faiber client.
+     * @param kind Backend path identifier `kind`.
+     * @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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted server BFF_SERVICE_KEY bearer plus actor UUID.
+     */
+    discoveryRelationshipGet(kind, id, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/follow/${encodeURIComponent(kind)}/${encodeURIComponent(id)}` });
+    }
+    /**
+     * Idempotently follow a user/place. Self-follow400 and blocked user403. Returns204; the migration 6 database trigger may enqueue an opted-in user-follow notification for a new edge.
+     * Calls `PUT /api/v1/follow/{kind}/{id}` through the shared IDP-aware Faiber client.
+     * @param kind Backend path identifier `kind`.
+     * @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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted server BFF_SERVICE_KEY bearer plus actor UUID.
+     */
+    discoveryFollowPut(kind, id, options) {
+        return this.client.request({ ...options, method: "PUT", url: `/api/v1/follow/${encodeURIComponent(kind)}/${encodeURIComponent(id)}` });
+    }
+    /**
+     * Apply a durable provider funding event after matching bounty unit/code/decimal amount. Event/reference are 1–255 trimmed characters. Duplicate external_event_id returns duplicate:true without status; new event returns duplicate:false/status. A funded result advances category moderation lifecycle transactionally.
      * Calls `POST /api/v1/integrations/funding-events` 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: social:integrations: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: social:integrations:write; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiReceiveFundingEventPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/integrations/funding-events`, data: data });
     }
     /**
-     * Performs the my analytics operation for the api capability.
+     * Read oldest50 undelivered notification events for the configured organization. No lease or claim is acquired; consumers must deduplicate.
+     * Calls `GET /api/v1/internal/notification-outbox` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted BFF actor plus exact social:integrations:write permission.
+     */
+    discoveryOutboxGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/internal/notification-outbox` });
+    }
+    /**
+     * Mark an organization-scoped notification as delivered; returns204 even for missing/already-acknowledged rows. Ack is not a downstream business-effect receipt.
+     * Calls `PUT /api/v1/internal/notification-outbox/{id}/ack` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted BFF actor plus exact social:integrations:write permission.
+     */
+    discoveryAckPut(id, options) {
+        return this.client.request({ ...options, method: "PUT", url: `/api/v1/internal/notification-outbox/${encodeURIComponent(id)}/ack` });
+    }
+    /**
+     * Record a unique organization/event UUID and queue place.updated notifications for followers who did not disable place notifications, in one transaction. Repeated ID has no new effect; returns204.
+     * Calls `POST /api/v1/internal/place-events` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted BFF actor plus exact social:integrations:write permission.
+     */
+    discoveryPlaceEventPost(data, options) {
+        return this.client.request({ ...options, method: "POST", url: `/api/v1/internal/place-events`, data: data });
+    }
+    /**
+     * Read current author analytics over inclusive YYYY-MM-DD from/to dates, at most 366 days; defaults to today and preceding 29 days. Returns totals/posts/trend.
      * Calls `GET /api/v1/me/analytics` 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: social:analytics:read_own.
+     * @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: social:analytics:read_own; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiMyAnalyticsGet(params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/me/analytics`, params });
     }
     /**
-     * Performs the my bookmarks operation for the api capability.
+     * List bookmarked post UUIDs for the authenticated organization/user; this is not a post projection.
      * Calls `GET /api/v1/me/bookmarks` 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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiMyBookmarksGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/me/bookmarks` });
     }
     /**
-     * Performs the my claims operation for the api capability.
+     * Page current claimant claims with required total/page/limit meta, message/evidence/status and mutual_contact_consent; defaults page=1/limit=30, limit 1–100.
      * Calls `GET /api/v1/me/claims` 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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiMyClaimsGet(params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/me/claims`, params });
     }
     /**
-     * Performs the clear feed location operation for the api capability.
+     * Clear the authenticated user location preference idempotently; returns 204.
      * Calls `DELETE /api/v1/me/feed-location` 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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiClearFeedLocationDelete(options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/me/feed-location` });
     }
     /**
-     * Performs the get feed location operation for the api capability.
+     * Read the authenticated user location preference, returning data:null when unset.
      * Calls `GET /api/v1/me/feed-location` 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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiGetFeedLocationGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/me/feed-location` });
     }
     /**
-     * Performs the set feed location operation for the api capability.
+     * Save current user location preference. Coordinates must be finite and within latitude ±90/longitude ±180; range_km must be >0 and <=500. Returns the saved non-null preference.
      * Calls `PUT /api/v1/me/feed-location` 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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiSetFeedLocationPut(data, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/me/feed-location`, data: data });
     }
     /**
-     * Performs the list my posts operation for the api capability.
+     * Read follow/comment/place/quest notification preferences, defaulting to enabled.
+     * Calls `GET /api/v1/me/notification-preferences` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted server BFF_SERVICE_KEY bearer plus actor UUID.
+     */
+    discoveryPreferencesGet(options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/me/notification-preferences` });
+    }
+    /**
+     * Update supplied boolean preferences; absent fields stay unchanged. Current handler writes supplied preferences separately.
+     * Calls `PUT /api/v1/me/notification-preferences` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted server BFF_SERVICE_KEY bearer plus actor UUID.
+     */
+    discoverySetPreferencesPut(data, options) {
+        return this.client.request({ ...options, method: "PUT", url: `/api/v1/me/notification-preferences`, data: data });
+    }
+    /**
+     * Page current actor posts using feed filters and required pagination meta. author_id is overwritten by the authenticated user UUID.
      * Calls `GET /api/v1/me/posts` 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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiListMyPostsGet(params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/me/posts`, params });
     }
     /**
-     * Performs the my post claims operation for the api capability.
+     * Page claims for a post owned by the current user; other actors return 403. Returns required total/page/limit meta and mutual_contact_consent.
      * Calls `GET /api/v1/me/posts/{id}/claims` 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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiMyPostClaimsGet(id, params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/me/posts/${encodeURIComponent(id)}/claims`, params });
     }
     /**
-     * Performs the get media operation for the api capability.
+     * Download organization media after uploader/parent visibility checks. Returns bytes with Content-Type and private,max-age=300; storage/configuration failures return 500.
      * 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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiGetMediaGet(id, options) {
-        return this.client.request({ ...options, method: "GET", url: `/api/v1/media/${encodeURIComponent(id)}` });
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/media/${encodeURIComponent(id)}`, responseType: "arraybuffer" });
     }
     /**
-     * Performs the upload media operation for the api capability.
+     * Upload the first multipart field as JPEG, PNG or WebP (1 byte–12 MiB); full multipart body limit 13 MiB. Returns 201 with UUID, authenticated media URL and content type. Storage must be configured.
      * Calls `POST /api/v1/media/uploads` 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: social:post:create.
+     * @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: social:post:create; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiUploadMediaPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/media/uploads`, data: data });
     }
     /**
-     * Performs the moderate operation for the api capability.
+     * Moderate a post/comment/report. Reject/hide require a nonblank reason; resolve/dismiss target reports. Awaiting-funding posts return 409. Returns target_type,target_id,status,action; audit stores previous_status separately. Requires either social:moderate or social:moderation:review.
      * Calls `POST /api/v1/moderation/actions` 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: session-derived or public bootstrap route.
+     * @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: social:moderate OR social:moderation:review; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiModeratePost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/moderation/actions`, data: data });
     }
     /**
-     * Performs the moderation audit operation for the api capability.
+     * Page organization moderation history with optional target_type/action filters; defaults page=1/limit=30 with page>=1 and limit 1–100. Requires either social:moderate or social:moderation:review.
      * Calls `GET /api/v1/moderation/audit` 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: session-derived or public bootstrap route.
+     * @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: social:moderate OR social:moderation:review; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiModerationAuditGet(params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/moderation/audit`, params });
     }
     /**
-     * Performs the moderation queue operation for the api capability.
+     * Read pending non-deleted posts/comments and open/reviewing reports; awaiting-funding posts are excluded. Requires either social:moderate or social:moderation:review.
      * Calls `GET /api/v1/moderation/queue` 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: session-derived or public bootstrap route.
+     * @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: social:moderate OR social:moderation:review; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiModerationQueueGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/moderation/queue` });
     }
     /**
-     * Performs the list posts operation for the api capability.
+     * Page visible organization posts with q title/body search, author/category UUID and validated kind filters. Defaults page=1/limit=30, page>=1 and limit 1–100. Saved location ranks nearby posts then posts without decryptable coordinates. Returns data plus required total/page/limit meta.
      * Calls `GET /api/v1/posts` 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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiListPostsGet(params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/posts`, params });
     }
     /**
-     * Performs the create post operation for the api capability.
+     * Create a post (201), or return the completed identical request_key replay (200). Body is trimmed, 1–50000 characters; creation title truncates to 500 characters. Media array entries must reference owned uploaded IDs. Category entitlements/restrictions and published capability policy apply. Reusing a key for changed content or an unconfirmed request returns 409; retry the same request key.
      * Calls `POST /api/v1/posts` 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: social:post:create.
+     * @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: social:post:create; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiCreatePostPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/posts`, data: data });
     }
     /**
-     * Performs the delete post operation for the api capability.
+     * Soft-delete an author-owned post, or a moderator-authorized post; returns 204.
      * Calls `DELETE /api/v1/posts/{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: social:post:delete_own.
+     * @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: social:post:delete_own; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiDeletePostDelete(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/posts/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the get post operation for the api capability.
+     * Read a non-deleted organization-scoped post visible to its author, moderators or readers of published non-private posts. Bidirectional user blocks hide it with 404.
      * Calls `GET /api/v1/posts/{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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiGetPostGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/posts/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the update post operation for the api capability.
+     * Update author-owned content; Option nulls leave fields unchanged. Body is 1–50000 characters and supplied title is 1–500. Existing/new category entitlement and media ownership are enforced. Rejected or moderated content returns to review; awaiting-funding lifecycle is preserved.
      * Calls `PATCH /api/v1/posts/{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: social:post:update_own.
+     * @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: social:post:update_own; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiUpdatePostPatch(id, data, options) {
         return this.client.request({ ...options, method: "PATCH", url: `/api/v1/posts/${encodeURIComponent(id)}`, data: data });
     }
     /**
-     * Performs the post analytics operation for the api capability.
+     * Read author-only post analytics over inclusive YYYY-MM-DD from/to dates. Defaults to today and preceding 29 days; from<=to and at most 366 days. Returns totals/posts/trend.
      * Calls `GET /api/v1/posts/{id}/analytics` 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: social:analytics:read_own.
+     * @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: social:analytics:read_own; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiPostAnalyticsGet(id, params, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/posts/${encodeURIComponent(id)}/analytics`, params });
     }
     /**
-     * Performs the unbookmark post operation for the api capability.
+     * Remove current user bookmark; returns 204.
      * Calls `DELETE /api/v1/posts/{id}/bookmark` 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: social:bookmark: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: social:bookmark:write; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiUnbookmarkPostDelete(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/posts/${encodeURIComponent(id)}/bookmark` });
     }
     /**
-     * Performs the bookmark post operation for the api capability.
+     * Idempotently bookmark a visible post for current user; returns 204.
      * Calls `PUT /api/v1/posts/{id}/bookmark` 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: social:bookmark: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: social:bookmark:write; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiBookmarkPostPut(id, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/posts/${encodeURIComponent(id)}/bookmark` });
     }
     /**
-     * Performs the cancel capability post operation for the api capability.
+     * Cancel an author-owned post unless already resolved/cancelled/expired (409); hide content and queue bounty refund where relevant. Returns post_id/lifecycle_status.
      * Calls `POST /api/v1/posts/{id}/cancel` 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: social:post:update_own.
+     * @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: social:post:update_own; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiCancelCapabilityPostPost(id, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/posts/${encodeURIComponent(id)}/cancel` });
     }
     /**
-     * Performs the post capabilities operation for the api capability.
+     * Read a visible post capability projection with nullable subject/location/bounty, linked actions and lifecycle. Exact coordinates are excluded.
      * Calls `GET /api/v1/posts/{id}/capabilities` 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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiPostCapabilitiesGet(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/posts/${encodeURIComponent(id)}/capabilities` });
     }
     /**
-     * Performs the create claim operation for the api capability.
+     * Submit one claim per user/post (201). Authors cannot claim own posts; lifecycle must be published and policy must enable claims. Message 1–5000 trimmed characters, evidence defaults null; conflicts return 409.
      * Calls `POST /api/v1/posts/{id}/claims` 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: social:claim:create.
+     * @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: social:claim:create; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiCreateClaimPost(id, data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/posts/${encodeURIComponent(id)}/claims`, data: data });
     }
     /**
-     * Performs the list post comments operation for the api capability.
+     * Read published non-deleted comments oldest-first after checking parent visibility; no pagination query is consumed.
      * Calls `GET /api/v1/posts/{id}/comments` 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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiListPostCommentsGetApiV1PostsIdComments(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/posts/${encodeURIComponent(id)}/comments` });
     }
     /**
-     * Performs the create post comment operation for the api capability.
+     * Create a post comment (201), checking parent post and optional same-post non-deleted parent comment. Body is trimmed, 1–10000 characters; category moderation/restrictions apply.
      * Calls `POST /api/v1/posts/{id}/comments` 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: social:comment:create.
+     * @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: social:comment:create; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiCreatePostCommentPostApiV1PostsIdComments(id, data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/posts/${encodeURIComponent(id)}/comments`, data: data });
     }
     /**
-     * Performs the remove post reaction operation for the api capability.
+     * Remove current user post reaction and refresh counts; returns 204.
      * Calls `DELETE /api/v1/posts/{id}/like` 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: social:reaction: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: social:reaction:write; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiRemovePostReactionDeleteApiV1PostsIdLike(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/posts/${encodeURIComponent(id)}/like` });
     }
     /**
-     * Performs the like post operation for the api capability.
+     * Set the current user post reaction to like, returning the reaction record.
      * Calls `PUT /api/v1/posts/{id}/like` 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: social:reaction: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: social:reaction:write; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiLikePostPut(id, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/posts/${encodeURIComponent(id)}/like` });
     }
     /**
-     * Performs the navigation access operation for the api capability.
+     * Request short-lived exact coordinates with optional reason. Requires authenticated user, navigation permission and location access policy; returns no-store coordinates expiring in 60 seconds.
      * Calls `POST /api/v1/posts/{id}/navigation-access` 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: social:location:navigate.
+     * @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: social:location:navigate; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiNavigationAccessPost(id, data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/posts/${encodeURIComponent(id)}/navigation-access`, data: data });
     }
     /**
-     * Performs the remove post reaction operation for the api capability.
+     * Remove current user post reaction and refresh counts; returns 204.
      * Calls `DELETE /api/v1/posts/{id}/reaction` 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: social:reaction: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: social:reaction:write; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiRemovePostReactionDeleteApiV1PostsIdReaction(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/posts/${encodeURIComponent(id)}/reaction` });
     }
     /**
-     * Performs the post reactions operation for the api capability.
+     * Read post reaction totals, counts by reaction type and nullable viewer_reaction after verifying visibility.
      * Calls `GET /api/v1/posts/{id}/reaction` 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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiPostReactionsGetApiV1PostsIdReaction(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/posts/${encodeURIComponent(id)}/reaction` });
     }
     /**
-     * Performs the set post reaction operation for the api capability.
+     * Upsert current user post reaction after visibility and restriction checks; type is one of like/love/care/haha/wow/sad/angry.
      * Calls `PUT /api/v1/posts/{id}/reaction` 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: social:reaction: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: social:reaction:write; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiSetPostReactionPut(id, data, options) {
         return this.client.request({ ...options, method: "PUT", url: `/api/v1/posts/${encodeURIComponent(id)}/reaction`, data: data });
     }
     /**
-     * Performs the resubmit post operation for the api capability.
+     * Resubmit author-owned content to the category moderation state; returns the updated post.
      * Calls `POST /api/v1/posts/{id}/resubmit` 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: social:post:update_own.
+     * @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: social:post:update_own; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiResubmitPostPost(id, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/posts/${encodeURIComponent(id)}/resubmit` });
     }
     /**
-     * Performs the record share event operation for the api capability.
+     * Record a visible post share with channel default system and optional idempotency_key; returns 204. Idempotency keys are scoped to organization/user across posts, truncate to 128 characters, and suppress duplicates; channel is trimmed to 1–32 characters.
      * Calls `POST /api/v1/posts/{id}/share-events` 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: social:share: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: social:share:write; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiRecordShareEventPost(id, data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/posts/${encodeURIComponent(id)}/share-events`, data: data });
     }
     /**
-     * Performs the record post view operation for the api capability.
+     * Record a visible post view when visible_ms>=1000; lower values return 400. counted is false for author views or a duplicate user/post/day view.
      * Calls `POST /api/v1/posts/{id}/views` 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: social:view: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: social:view:write; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiRecordPostViewPost(id, data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/posts/${encodeURIComponent(id)}/views`, data: data });
     }
     /**
-     * Performs the remove post reaction operation for the api capability.
+     * Download published media bytes after parent visibility and blocking checks. Response has private,no-cache. Unpublished media404, unavailable object storage500.
+     * Calls `GET /api/v1/public/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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: public projection.
+     */
+    discoveryMediaGet(id, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/public/media/${encodeURIComponent(id)}`, responseType: "arraybuffer" });
+    }
+    /**
+     * Public projection; runtime-configured organization/category, only public published non-deleted posts and non-expired24hour stories. Valid trusted actor enables following/liked/bookmarked and bidirectional blocking. Page1..10000/limit1..100; subject pair, comma-separated place references, author UUID and normalized text filters.
+     * Calls `GET /api/v1/public/posts` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: public; following=true requires a trusted BFF actor.
+     */
+    discoveryFeedGet(params, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/public/posts`, params });
+    }
+    /**
+     * Read the same public, unexpired and non-blocked post projection; hidden, private, wrong-category or blocked records return404.
+     * Calls `GET /api/v1/public/posts/{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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: public projection.
+     */
+    discoveryPostDetailGet(id, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/public/posts/${encodeURIComponent(id)}` });
+    }
+    /**
+     * Read at most100 published non-deleted comments, oldest first, after verifying parent post visibility and bidirectional actor blocks.
+     * Calls `GET /api/v1/public/posts/{id}/comments` 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 handler payload, status, and headers.
+     * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: public projection.
+     */
+    discoveryCommentsGet(id, options) {
+        return this.client.request({ ...options, method: "GET", url: `/api/v1/public/posts/${encodeURIComponent(id)}/comments` });
+    }
+    /**
+     * Remove current user post reaction and refresh counts; returns 204.
      * Calls `DELETE /api/v1/reactions/post/{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: social:reaction: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: social:reaction:write; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiRemovePostReactionDeleteApiV1ReactionsPostId(id, options) {
         return this.client.request({ ...options, method: "DELETE", url: `/api/v1/reactions/post/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the post reactions operation for the api capability.
+     * Read post reaction totals, counts by reaction type and nullable viewer_reaction after verifying visibility.
      * Calls `GET /api/v1/reactions/post/{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: social: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: social:read; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiPostReactionsGetApiV1ReactionsPostId(id, options) {
         return this.client.request({ ...options, method: "GET", url: `/api/v1/reactions/post/${encodeURIComponent(id)}` });
     }
     /**
-     * Performs the set post reaction operation for the api capability.
+     * Upsert current user post reaction after visibility and restriction checks; type is one of like/love/care/haha/wow/sad/angry.
      * Calls `POST /api/v1/reactions/post/{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: social:reaction: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: social:reaction:write; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiSetPostReactionPost(id, data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/reactions/post/${encodeURIComponent(id)}`, data: data });
     }
     /**
-     * Performs the create report operation for the api capability.
+     * Report a visible post/comment or another user (201). Self user reports return 400; reason is trimmed, 1–64 characters. Returns the complete report record with nullable resolution fields.
      * Calls `POST /api/v1/reports` 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: social:report:create.
+     * @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: social:report:create; authenticated IDP context via shared FaiberClient; trusted organization context.
      */
     apiCreateReportPost(data, options) {
         return this.client.request({ ...options, method: "POST", url: `/api/v1/reports`, data: data });
     }
     /**
-     * Performs the health operation for the main capability.
+     * Read process liveness and package version; this is not a dependency readiness probe.
      * Calls `GET /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: session-derived or public bootstrap route.
+     * @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 liveness route.
      */
     mainHealthGet(options) {
         return this.client.request({ ...options, method: "GET", url: `/health` });