@faiber/faiber-social 0.24.1 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,561 +2,1022 @@ import { ServiceApi, type Identifier, type RequestOptions } from "@faiber/sdk-co
2
2
  import type * as T from "./operations.types.js";
3
3
  export declare class SocialOperations extends ServiceApi {
4
4
  /**
5
- * Performs the import modules operation for the api capability.
5
+ * Import legacy Modules social records within the current organization; dry_run defaults true. Returns counters and the explicit legacy reaction mapping; requires social:admin.
6
6
  * Calls `POST /api/v1/admin/import/modules` through the shared IDP-aware Faiber client.
7
7
  * @param data Typed JSON request body.
8
8
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
9
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
10
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:admin.
9
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
10
+ * @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.
11
11
  */
12
- apiImportModulesPost(data: T.ApiImportModulesPostInput, options?: RequestOptions<T.ApiImportModulesPostInput>): Promise<import("axios").AxiosResponse<import("./types.js").LegacyImportResponse, T.ApiImportModulesPostInput, {}>>;
12
+ apiImportModulesPost(data: T.ApiImportModulesPostInput, options?: RequestOptions<T.ApiImportModulesPostInput>): Promise<import("axios").AxiosResponse<import("./types.js").LegacyImportResponse, import("./types.js").LegacyImportInput, {}, any>>;
13
13
  /**
14
- * Performs the self identity operation for the api capability.
14
+ * Page actors by latest post time; q optionally filters an actor UUID. Invalid q is currently ignored; meta.total is current-page length.
15
+ * Calls `GET /api/v1/admin/social/actors` through the shared IDP-aware Faiber client.
16
+ * @param params Typed query parameters; omitted members retain backend defaults.
17
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
18
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
19
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:content:read; current trusted organization/actor context required.
20
+ */
21
+ adminActorsGet(params?: T.AdminActorsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminPage<import("./admin.types.js").SocialAdminActor>, unknown, {}, any>>;
22
+ /**
23
+ * Read actor activity counts and restriction rows in the organization; a UUID with no activity returns zero counts.
24
+ * Calls `GET /api/v1/admin/social/actors/{id}` through the shared IDP-aware Faiber client.
25
+ * @param id Backend path identifier `id`.
26
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
27
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
28
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:content:read; current trusted organization/actor context required.
29
+ */
30
+ adminActorDetailGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminActorDetail>, unknown, {}, any>>;
31
+ /**
32
+ * Read organization-scoped counts by status and navigation grant events; includes deleted posts in status totals.
33
+ * Calls `GET /api/v1/admin/social/analytics` through the shared IDP-aware Faiber client.
34
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
35
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
36
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:analytics:read; current trusted organization/actor context required.
37
+ */
38
+ adminAnalyticsGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminAnalytics>, unknown, {}, any>>;
39
+ /**
40
+ * Page organization-scoped audit rows. status filters exact audit action, not a lifecycle state.
41
+ * Calls `GET /api/v1/admin/social/audit` through the shared IDP-aware Faiber client.
42
+ * @param params Typed query parameters; omitted members retain backend defaults.
43
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
44
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
45
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:audit:read; current trusted organization/actor context required.
46
+ */
47
+ adminAuditGet(params?: T.AdminAuditGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminPage<import("./admin.types.js").SocialAdminAudit>, unknown, {}, any>>;
48
+ /**
49
+ * Page organization-scoped bounties with exact status filter and newest-update ordering. Admin amount uses a JSON number.
50
+ * Calls `GET /api/v1/admin/social/bounties` through the shared IDP-aware Faiber client.
51
+ * @param params Typed query parameters; omitted members retain backend defaults.
52
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
53
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
54
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:funding:review; current trusted organization/actor context required.
55
+ */
56
+ adminBountiesGet(params?: T.AdminBountiesGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminPage<import("./admin.types.js").SocialAdminBounty>, unknown, {}, any>>;
57
+ /**
58
+ * Read a bounty UUID in the organization; missing records return404.
59
+ * Calls `GET /api/v1/admin/social/bounties/{id}` through the shared IDP-aware Faiber client.
60
+ * @param id Backend path identifier `id`.
61
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
62
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
63
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:funding:review; current trusted organization/actor context required.
64
+ */
65
+ adminBountyDetailGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminBounty>, unknown, {}, any>>;
66
+ /**
67
+ * List category capability policies ordered by category UUID and descending version, including draft/retired.
68
+ * Calls `GET /api/v1/admin/social/capability-policies` through the shared IDP-aware Faiber client.
69
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
70
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
71
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:panel:view; current trusted organization/actor context required.
72
+ */
73
+ adminPoliciesGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminPolicy[]>, unknown, {}, any>>;
74
+ /**
75
+ * Create a new draft policy version for a category; authenticated operator required; returns201. Only seven supported config section names are accepted.
76
+ * Calls `POST /api/v1/admin/social/capability-policies` through the shared IDP-aware Faiber client.
77
+ * @param data Typed JSON request body.
78
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
79
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
80
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:capabilities:manage; current trusted organization/actor context required.
81
+ */
82
+ adminCreatePolicyPost(data: T.AdminCreatePolicyPostInput, options?: RequestOptions<T.AdminCreatePolicyPostInput>): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminPolicy>, import("./admin.types.js").SocialAdminPolicyInput, {}, any>>;
83
+ /**
84
+ * Read an organization-scoped capability policy UUID; missing records return404.
85
+ * Calls `GET /api/v1/admin/social/capability-policies/{id}` through the shared IDP-aware Faiber client.
86
+ * @param id Backend path identifier `id`.
87
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
88
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
89
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:panel:view; current trusted organization/actor context required.
90
+ */
91
+ adminPolicyDetailGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminPolicy>, unknown, {}, any>>;
92
+ /**
93
+ * Replace draft config for the matching category; non-draft, missing or mismatched category returns409.
94
+ * Calls `PATCH /api/v1/admin/social/capability-policies/{id}` through the shared IDP-aware Faiber client.
95
+ * @param id Backend path identifier `id`.
96
+ * @param data Typed JSON request body.
97
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
98
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
99
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:capabilities:manage; current trusted organization/actor context required.
100
+ */
101
+ adminUpdatePolicyPatch(id: Identifier, data: T.AdminUpdatePolicyPatchInput, options?: RequestOptions<T.AdminUpdatePolicyPatchInput>): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminPolicy>, import("./admin.types.js").SocialAdminPolicyInput, {}, any>>;
102
+ /**
103
+ * Publish a draft and retire the previously published category policy in one transaction. Authenticated operator required; non-draft returns409.
104
+ * Calls `POST /api/v1/admin/social/capability-policies/{id}/publish` through the shared IDP-aware Faiber client.
105
+ * @param id Backend path identifier `id`.
106
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
107
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
108
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:capabilities:manage; current trusted organization/actor context required.
109
+ */
110
+ adminPublishPolicyPost(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminPolicy>, unknown, {}, any>>;
111
+ /**
112
+ * List non-deleted categories, including hidden/archived status; no pagination.
113
+ * Calls `GET /api/v1/admin/social/categories` through the shared IDP-aware Faiber client.
114
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
115
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
116
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:panel:view; current trusted organization/actor context required.
117
+ */
118
+ adminCategoriesGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminCategory[]>, unknown, {}, any>>;
119
+ /**
120
+ * Create a validated category; returns201. Localized name/description and metadata use backend JSON values.
121
+ * Calls `POST /api/v1/admin/social/categories` through the shared IDP-aware Faiber client.
122
+ * @param data Typed JSON request body.
123
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
124
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
125
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:categories:manage; current trusted organization/actor context required.
126
+ */
127
+ adminCreateCategoryPost(data: T.AdminCreateCategoryPostInput, options?: RequestOptions<T.AdminCreateCategoryPostInput>): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminCategory>, import("./types.js").CreateCategoryInput, {}, any>>;
128
+ /**
129
+ * Soft-delete a category; returns204 without a response body.
130
+ * Calls `DELETE /api/v1/admin/social/categories/{id}` through the shared IDP-aware Faiber client.
131
+ * @param id Backend path identifier `id`.
132
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
133
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
134
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:categories:manage; current trusted organization/actor context required.
135
+ */
136
+ adminArchiveCategoryDelete(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
137
+ /**
138
+ * Read a non-deleted category UUID from the organization-scoped category list.
139
+ * Calls `GET /api/v1/admin/social/categories/{id}` through the shared IDP-aware Faiber client.
140
+ * @param id Backend path identifier `id`.
141
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
142
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
143
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:panel:view; current trusted organization/actor context required.
144
+ */
145
+ adminCategoryDetailGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminCategory>, unknown, {}, any>>;
146
+ /**
147
+ * Patch a category using supplied fields; absent and null optional fields follow backend Option semantics.
148
+ * Calls `PATCH /api/v1/admin/social/categories/{id}` through the shared IDP-aware Faiber client.
149
+ * @param id Backend path identifier `id`.
150
+ * @param data Typed JSON request body.
151
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
152
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
153
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:categories:manage; current trusted organization/actor context required.
154
+ */
155
+ adminUpdateCategoryPatch(id: Identifier, data: T.AdminUpdateCategoryPatchInput, options?: RequestOptions<T.AdminUpdateCategoryPatchInput>): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminCategory>, import("./types.js").UpdateCategoryInput, {}, any>>;
156
+ /**
157
+ * Page organization-scoped claims with exact status filtering.
158
+ * Calls `GET /api/v1/admin/social/claims` through the shared IDP-aware Faiber client.
159
+ * @param params Typed query parameters; omitted members retain backend defaults.
160
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
161
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
162
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:claims:manage; current trusted organization/actor context required.
163
+ */
164
+ adminClaimsGet(params?: T.AdminClaimsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminPage<import("./admin.types.js").SocialAdminClaim>, unknown, {}, any>>;
165
+ /**
166
+ * Read a claim UUID in the organization; missing records return404.
167
+ * Calls `GET /api/v1/admin/social/claims/{id}` through the shared IDP-aware Faiber client.
168
+ * @param id Backend path identifier `id`.
169
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
170
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
171
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:claims:manage; current trusted organization/actor context required.
172
+ */
173
+ adminClaimDetailGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminClaim>, unknown, {}, any>>;
174
+ /**
175
+ * Resolve an author-selected and author-approved claim in a transaction, update post lifecycle and audit. Authenticated operator required; unmet selection prerequisites return409.
176
+ * Calls `POST /api/v1/admin/social/claims/{id}/approve` through the shared IDP-aware Faiber client.
177
+ * @param id Backend path identifier `id`.
178
+ * @param data Typed JSON request body.
179
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
180
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
181
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:claims:manage; current trusted organization/actor context required.
182
+ */
183
+ adminApproveClaimPost(id: Identifier, data: T.AdminApproveClaimPostInput, options?: RequestOptions<T.AdminApproveClaimPostInput>): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminClaimDecision>, import("./admin.types.js").SocialAdminReasonInput, {}, any>>;
184
+ /**
185
+ * 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.
186
+ * Calls `POST /api/v1/admin/social/claims/{id}/reject` through the shared IDP-aware Faiber client.
187
+ * @param id Backend path identifier `id`.
188
+ * @param data Typed JSON request body.
189
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
190
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
191
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:claims:manage; current trusted organization/actor context required.
192
+ */
193
+ adminRejectClaimPost(id: Identifier, data: T.AdminRejectClaimPostInput, options?: RequestOptions<T.AdminRejectClaimPostInput>): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminClaimDecision>, import("./admin.types.js").SocialAdminReasonInput, {}, any>>;
194
+ /**
195
+ * Page comments including deleted records; status filters moderation_status. q/category_id are ignored.
196
+ * Calls `GET /api/v1/admin/social/comments` through the shared IDP-aware Faiber client.
197
+ * @param params Typed query parameters; omitted members retain backend defaults.
198
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
199
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
200
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:content:read; current trusted organization/actor context required.
201
+ */
202
+ adminCommentsGet(params?: T.AdminCommentsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminPage<import("./admin.types.js").SocialAdminComment>, unknown, {}, any>>;
203
+ /**
204
+ * Read an organization-scoped comment UUID, including deleted rows; missing records return404.
205
+ * Calls `GET /api/v1/admin/social/comments/{id}` through the shared IDP-aware Faiber client.
206
+ * @param id Backend path identifier `id`.
207
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
208
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
209
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:content:read; current trusted organization/actor context required.
210
+ */
211
+ adminCommentDetailGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminComment>, unknown, {}, any>>;
212
+ /**
213
+ * Page organization-scoped durable integration events with exact status filter and newest-update ordering.
214
+ * Calls `GET /api/v1/admin/social/integrations` through the shared IDP-aware Faiber client.
215
+ * @param params Typed query parameters; omitted members retain backend defaults.
216
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
217
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
218
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:integrations:manage; current trusted organization/actor context required.
219
+ */
220
+ adminIntegrationsGet(params?: T.AdminIntegrationsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminPage<import("./admin.types.js").SocialAdminIntegration>, unknown, {}, any>>;
221
+ /**
222
+ * Read an organization-scoped durable event UUID, including its payload; missing returns404.
223
+ * Calls `GET /api/v1/admin/social/integrations/{id}` through the shared IDP-aware Faiber client.
224
+ * @param id Backend path identifier `id`.
225
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
226
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
227
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:integrations:manage; current trusted organization/actor context required.
228
+ */
229
+ adminIntegrationDetailGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminIntegration>, unknown, {}, any>>;
230
+ /**
231
+ * 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.
232
+ * Calls `POST /api/v1/admin/social/integrations/{id}/replay` through the shared IDP-aware Faiber client.
233
+ * @param id Backend path identifier `id`.
234
+ * @param data Typed JSON request body.
235
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
236
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
237
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:integrations:manage; current trusted organization/actor context required.
238
+ */
239
+ adminReplayIntegrationPost(id: Identifier, data: T.AdminReplayIntegrationPostInput, options?: RequestOptions<T.AdminReplayIntegrationPostInput>): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminIntegrationPending>, import("./admin.types.js").SocialAdminReasonInput, {}, any>>;
240
+ /**
241
+ * Reveal decrypted coordinates with a mandatory nonempty operator reason and audit event. Response is no-store/no-cache; expire the result after60seconds.
242
+ * Calls `POST /api/v1/admin/social/locations/{post_id}/reveal` through the shared IDP-aware Faiber client.
243
+ * @param postId Backend path identifier `post_id`.
244
+ * @param data Typed JSON request body.
245
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
246
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
247
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:location:reveal; current trusted organization/actor context required.
248
+ */
249
+ adminRevealLocationPost(postId: Identifier, data: T.AdminRevealLocationPostInput, options?: RequestOptions<T.AdminRevealLocationPostInput>): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminLocation>, import("./admin.types.js").SocialAdminReasonInput, {}, any>>;
250
+ /**
251
+ * Page uploaded media. status filters exact content_type, not lifecycle status.
252
+ * Calls `GET /api/v1/admin/social/media` through the shared IDP-aware Faiber client.
253
+ * @param params Typed query parameters; omitted members retain backend defaults.
254
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
255
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
256
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:content:read; current trusted organization/actor context required.
257
+ */
258
+ adminMediaGet(params?: T.AdminMediaGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminPage<import("./admin.types.js").SocialAdminMedia>, unknown, {}, any>>;
259
+ /**
260
+ * Read pending non-deleted posts/comments and open/reviewing reports. Awaiting-funding posts are excluded; queue is unpaginated.
261
+ * Calls `GET /api/v1/admin/social/moderation/queue` through the shared IDP-aware Faiber client.
262
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
263
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
264
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:moderation:review; current trusted organization/actor context required.
265
+ */
266
+ adminModerationQueueGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminModerationQueue>, unknown, {}, any>>;
267
+ /**
268
+ * Read organization-scoped operator totals.
269
+ * Calls `GET /api/v1/admin/social/overview` through the shared IDP-aware Faiber client.
270
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
271
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
272
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:panel:view; current trusted organization/actor context required.
273
+ */
274
+ adminOverviewGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminOverview>, unknown, {}, any>>;
275
+ /**
276
+ * Page non-deleted posts, filtering moderation status, category UUID and trimmed title/body search.
277
+ * Calls `GET /api/v1/admin/social/posts` through the shared IDP-aware Faiber client.
278
+ * @param params Typed query parameters; omitted members retain backend defaults.
279
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
280
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
281
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:content:read; current trusted organization/actor context required.
282
+ */
283
+ adminPostsGet(params?: T.AdminPostsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminPage<import("./admin.types.js").SocialAdminPostSummary>, unknown, {}, any>>;
284
+ /**
285
+ * Read a post, metadata, report rows, activity counts and public capability projection. Missing or deleted post projection returns404.
286
+ * Calls `GET /api/v1/admin/social/posts/{id}` through the shared IDP-aware Faiber client.
287
+ * @param id Backend path identifier `id`.
288
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
289
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
290
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:content:read; current trusted organization/actor context required.
291
+ */
292
+ adminPostDetailGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminPostDetail>, unknown, {}, any>>;
293
+ /**
294
+ * Page organization-scoped reports with exact status filtering.
295
+ * Calls `GET /api/v1/admin/social/reports` through the shared IDP-aware Faiber client.
296
+ * @param params Typed query parameters; omitted members retain backend defaults.
297
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
298
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
299
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:reports:manage; current trusted organization/actor context required.
300
+ */
301
+ adminReportsGet(params?: T.AdminReportsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminPage<import("./admin.types.js").SocialAdminReport>, unknown, {}, any>>;
302
+ /**
303
+ * Read a report UUID in the organization; missing records return404.
304
+ * Calls `GET /api/v1/admin/social/reports/{id}` through the shared IDP-aware Faiber client.
305
+ * @param id Backend path identifier `id`.
306
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
307
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
308
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:reports:manage; current trusted organization/actor context required.
309
+ */
310
+ adminReportDetailGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminReport>, unknown, {}, any>>;
311
+ /**
312
+ * Page organization-scoped restrictions with exact status filter.
313
+ * Calls `GET /api/v1/admin/social/restrictions` through the shared IDP-aware Faiber client.
314
+ * @param params Typed query parameters; omitted members retain backend defaults.
315
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
316
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
317
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:actors:restrict; current trusted organization/actor context required.
318
+ */
319
+ adminRestrictionsGet(params?: T.AdminRestrictionsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminPage<import("./admin.types.js").SocialAdminRestriction>, unknown, {}, any>>;
320
+ /**
321
+ * Create an active restriction; authenticated operator, valid scope, nonempty reason and end later than start required; returns201.
322
+ * Calls `POST /api/v1/admin/social/restrictions` through the shared IDP-aware Faiber client.
323
+ * @param data Typed JSON request body.
324
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
325
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
326
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:actors:restrict; current trusted organization/actor context required.
327
+ */
328
+ adminCreateRestrictionPost(data: T.AdminCreateRestrictionPostInput, options?: RequestOptions<T.AdminCreateRestrictionPostInput>): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminRestrictionCreated>, import("./admin.types.js").SocialAdminCreateRestrictionInput, {}, any>>;
329
+ /**
330
+ * Revoke an active restriction with an authenticated operator and nonempty reason; non-active/missing returns409.
331
+ * Calls `POST /api/v1/admin/social/restrictions/{id}/revoke` through the shared IDP-aware Faiber client.
332
+ * @param id Backend path identifier `id`.
333
+ * @param data Typed JSON request body.
334
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
335
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
336
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:actors:restrict; current trusted organization/actor context required.
337
+ */
338
+ adminRevokeRestrictionPost(id: Identifier, data: T.AdminRevokeRestrictionPostInput, options?: RequestOptions<T.AdminRevokeRestrictionPostInput>): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminRestrictionRevoked>, import("./admin.types.js").SocialAdminReasonInput, {}, any>>;
339
+ /**
340
+ * Read configuration-presence flags and capability contract version. This does not disclose secrets or prove they are valid.
341
+ * Calls `GET /api/v1/admin/social/settings` through the shared IDP-aware Faiber client.
342
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
343
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
344
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:settings:manage; current trusted organization/actor context required.
345
+ */
346
+ adminSettingsGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./admin.types.js").SocialAdminResponse<import("./admin.types.js").SocialAdminSettings>, unknown, {}, any>>;
347
+ /**
348
+ * Read the middleware-derived current user UUID, roles and permissions.
15
349
  * Calls `GET /api/v1/auth/self` through the shared IDP-aware Faiber client.
16
350
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
17
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
18
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
351
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
352
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: middleware-derived IDP identity.
353
+ */
354
+ apiSelfIdentityGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialSessionIdentityResponse, unknown, {}, any>>;
355
+ /**
356
+ * Remove the current actor block edge; idempotent204.
357
+ * Calls `DELETE /api/v1/block/{id}` through the shared IDP-aware Faiber client.
358
+ * @param id Backend path identifier `id`.
359
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
360
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
361
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted server BFF_SERVICE_KEY bearer plus actor UUID.
19
362
  */
20
- apiSelfIdentityGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<T.ApiSelfIdentityGetResponse, unknown, {}>>;
363
+ discoveryUnblockDelete(id: string, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
21
364
  /**
22
- * Performs the list categories operation for the api capability.
365
+ * Block a user and remove user-follow edges in both directions; self-block400, success204. Current handler uses separate statements.
366
+ * Calls `PUT /api/v1/block/{id}` through the shared IDP-aware Faiber client.
367
+ * @param id Backend path identifier `id`.
368
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
369
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
370
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted server BFF_SERVICE_KEY bearer plus actor UUID.
371
+ */
372
+ discoveryBlockPut(id: string, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
373
+ /**
374
+ * List organization-scoped, non-deleted categories ordered by sort_order and slug; hidden/archived categories are included.
23
375
  * Calls `GET /api/v1/categories` through the shared IDP-aware Faiber client.
24
376
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
25
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
26
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
377
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
378
+ * @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.
27
379
  */
28
- apiListCategoriesGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialCategoryListResponse, unknown, {}>>;
380
+ apiListCategoriesGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialCategoryListResponse, unknown, {}, any>>;
29
381
  /**
30
- * Performs the create category operation for the api capability.
382
+ * Create a category (201). Slug normalizes to lowercase ASCII letters/digits/hyphens/underscores, 1–100 bytes. Localized labels, description and metadata remain application JSON.
31
383
  * Calls `POST /api/v1/categories` through the shared IDP-aware Faiber client.
32
384
  * @param data Typed JSON request body.
33
385
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
34
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
35
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:category:manage.
386
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
387
+ * @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.
36
388
  */
37
- apiCreateCategoryPost(data: T.ApiCreateCategoryPostInput, options?: RequestOptions<T.ApiCreateCategoryPostInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialCategoryResponse, T.ApiCreateCategoryPostInput, {}>>;
389
+ apiCreateCategoryPost(data: T.ApiCreateCategoryPostInput, options?: RequestOptions<T.ApiCreateCategoryPostInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialCategoryResponse, import("./types.js").CreateCategoryInput, {}, any>>;
38
390
  /**
39
- * Performs the delete category operation for the api capability.
391
+ * Soft-delete the category; returns 204 with no body.
40
392
  * Calls `DELETE /api/v1/categories/{id}` through the shared IDP-aware Faiber client.
41
393
  * @param id Backend path identifier `id`.
42
394
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
43
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
44
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:category:manage.
395
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
396
+ * @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.
45
397
  */
46
- apiDeleteCategoryDelete(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}>>;
398
+ apiDeleteCategoryDelete(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
47
399
  /**
48
- * Performs the update category operation for the api capability.
400
+ * Patch supplied category fields. Null and absent Option fields leave stored values unchanged; slug/status validation matches creation.
49
401
  * Calls `PATCH /api/v1/categories/{id}` through the shared IDP-aware Faiber client.
50
402
  * @param id Backend path identifier `id`.
51
403
  * @param data Typed JSON request body.
52
404
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
53
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
54
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:category:manage.
405
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
406
+ * @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.
55
407
  */
56
- apiUpdateCategoryPatch(id: Identifier, data: T.ApiUpdateCategoryPatchInput, options?: RequestOptions<T.ApiUpdateCategoryPatchInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialCategoryResponse, T.ApiUpdateCategoryPatchInput, {}>>;
408
+ apiUpdateCategoryPatch(id: Identifier, data: T.ApiUpdateCategoryPatchInput, options?: RequestOptions<T.ApiUpdateCategoryPatchInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialCategoryResponse, import("./types.js").UpdateCategoryInput, {}, any>>;
57
409
  /**
58
- * Performs the category capability policy operation for the api capability.
410
+ * Read the published category policy projection (404 when absent), including configurable JSON sections and published_at.
59
411
  * Calls `GET /api/v1/categories/{id}/capability-policy` through the shared IDP-aware Faiber client.
60
412
  * @param id Backend path identifier `id`.
61
413
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
62
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
63
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
414
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
415
+ * @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.
64
416
  */
65
- apiCategoryCapabilityPolicyGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.ApiCategoryCapabilityPolicyGetResponse, unknown, {}>>;
417
+ apiCategoryCapabilityPolicyGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./contracts.types.js").SocialCategoryCapabilityPolicyResponse, unknown, {}, any>>;
66
418
  /**
67
- * Performs the claim detail operation for the api capability.
419
+ * Read a private claim for its claimant, post author or claims manager; returns mutual contact consent and nullable resolution. Nonparticipants return 403.
68
420
  * Calls `GET /api/v1/claims/{id}` through the shared IDP-aware Faiber client.
69
421
  * @param id Backend path identifier `id`.
70
422
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
71
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
72
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
423
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
424
+ * @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.
73
425
  */
74
- apiClaimDetailGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.ApiClaimDetailGetResponse, unknown, {}>>;
426
+ apiClaimDetailGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./contracts.types.js").SocialClaimDetailResponse, unknown, {}, any>>;
75
427
  /**
76
- * Performs the set contact consent operation for the api capability.
428
+ * Set consent for a claim participant; mutual_consent reflects both participant grants. Requires an authenticated participant.
77
429
  * Calls `PUT /api/v1/claims/{id}/contact-consent` through the shared IDP-aware Faiber client.
78
430
  * @param id Backend path identifier `id`.
79
431
  * @param data Typed JSON request body.
80
432
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
81
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
82
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:claim:consent.
433
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
434
+ * @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.
83
435
  */
84
- apiSetContactConsentPut(id: Identifier, data: T.ApiSetContactConsentPutInput, options?: RequestOptions<T.ApiSetContactConsentPutInput>): Promise<import("axios").AxiosResponse<T.ApiSetContactConsentPutResponse, T.ApiSetContactConsentPutInput, {}>>;
436
+ apiSetContactConsentPut(id: Identifier, data: T.ApiSetContactConsentPutInput, options?: RequestOptions<T.ApiSetContactConsentPutInput>): Promise<import("axios").AxiosResponse<import("./contracts.types.js").SocialContactConsentResponse, import("./contracts.types.js").SocialContactConsentInput, {}, any>>;
85
437
  /**
86
- * Performs the select claim operation for the api capability.
438
+ * 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.
87
439
  * Calls `POST /api/v1/claims/{id}/select` through the shared IDP-aware Faiber client.
88
440
  * @param id Backend path identifier `id`.
89
441
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
90
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
91
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:claim:select_own.
442
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
443
+ * @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.
92
444
  */
93
- apiSelectClaimPost(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.ApiSelectClaimPostResponse, unknown, {}>>;
445
+ apiSelectClaimPost(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./contracts.types.js").SocialClaimSelectedResponse, unknown, {}, any>>;
94
446
  /**
95
- * Performs the withdraw claim operation for the api capability.
447
+ * Withdraw only the current claimant submitted claim; other states or ownership return 409. Returns id/status.
96
448
  * Calls `POST /api/v1/claims/{id}/withdraw` through the shared IDP-aware Faiber client.
97
449
  * @param id Backend path identifier `id`.
98
450
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
99
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
100
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:claim:update_own.
451
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
452
+ * @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.
101
453
  */
102
- apiWithdrawClaimPost(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.ApiWithdrawClaimPostResponse, unknown, {}>>;
454
+ apiWithdrawClaimPost(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./contracts.types.js").SocialClaimWithdrawnResponse, unknown, {}, any>>;
103
455
  /**
104
- * Performs the delete comment operation for the api capability.
456
+ * Soft-delete author-owned comment, or a moderator-authorized comment, and refresh counts; returns 204.
105
457
  * Calls `DELETE /api/v1/comments/{id}` through the shared IDP-aware Faiber client.
106
458
  * @param id Backend path identifier `id`.
107
459
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
108
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
109
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:comment:delete_own.
460
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
461
+ * @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.
110
462
  */
111
- apiDeleteCommentDelete(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}>>;
463
+ apiDeleteCommentDelete(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
112
464
  /**
113
- * Performs the update comment operation for the api capability.
465
+ * Update author-owned comment body (1–10000 trimmed characters). Category moderation can require review.
114
466
  * Calls `PATCH /api/v1/comments/{id}` through the shared IDP-aware Faiber client.
115
467
  * @param id Backend path identifier `id`.
116
468
  * @param data Typed JSON request body.
117
469
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
118
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
119
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:comment:update_own.
470
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
471
+ * @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.
120
472
  */
121
- apiUpdateCommentPatch(id: Identifier, data: T.ApiUpdateCommentPatchInput, options?: RequestOptions<T.ApiUpdateCommentPatchInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialCommentResponse, T.ApiUpdateCommentPatchInput, {}>>;
473
+ apiUpdateCommentPatch(id: Identifier, data: T.ApiUpdateCommentPatchInput, options?: RequestOptions<T.ApiUpdateCommentPatchInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialCommentResponse, import("./types.js").UpdateCommentInput, {}, any>>;
122
474
  /**
123
- * Performs the remove comment reaction operation for the api capability.
475
+ * Remove current user comment reaction and refresh counts; returns 204.
124
476
  * Calls `DELETE /api/v1/comments/{id}/like` through the shared IDP-aware Faiber client.
125
477
  * @param id Backend path identifier `id`.
126
478
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
127
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
128
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:reaction:write.
479
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
480
+ * @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.
129
481
  */
130
- apiRemoveCommentReactionDeleteApiV1CommentsIdLike(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}>>;
482
+ apiRemoveCommentReactionDeleteApiV1CommentsIdLike(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
131
483
  /**
132
- * Performs the like comment operation for the api capability.
484
+ * Set the current user comment reaction to like, returning the reaction record.
133
485
  * Calls `PUT /api/v1/comments/{id}/like` through the shared IDP-aware Faiber client.
134
486
  * @param id Backend path identifier `id`.
135
487
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
136
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
137
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:reaction:write.
488
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
489
+ * @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.
138
490
  */
139
- apiLikeCommentPut(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialReactionResponse, unknown, {}>>;
491
+ apiLikeCommentPut(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialReactionResponse, unknown, {}, any>>;
140
492
  /**
141
- * Performs the remove comment reaction operation for the api capability.
493
+ * Remove current user comment reaction and refresh counts; returns 204.
142
494
  * Calls `DELETE /api/v1/comments/{id}/reaction` through the shared IDP-aware Faiber client.
143
495
  * @param id Backend path identifier `id`.
144
496
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
145
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
146
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:reaction:write.
497
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
498
+ * @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.
147
499
  */
148
- apiRemoveCommentReactionDeleteApiV1CommentsIdReaction(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}>>;
500
+ apiRemoveCommentReactionDeleteApiV1CommentsIdReaction(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
149
501
  /**
150
- * Performs the comment reactions operation for the api capability.
502
+ * Read comment reaction totals, counts by reaction type and nullable viewer_reaction after verifying target visibility.
151
503
  * Calls `GET /api/v1/comments/{id}/reaction` through the shared IDP-aware Faiber client.
152
504
  * @param id Backend path identifier `id`.
153
505
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
154
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
155
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
506
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
507
+ * @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.
156
508
  */
157
- apiCommentReactionsGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").ReactionSummaryResponse, unknown, {}>>;
509
+ apiCommentReactionsGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").ReactionSummaryResponse, unknown, {}, any>>;
158
510
  /**
159
- * Performs the set comment reaction operation for the api capability.
511
+ * Upsert current user comment reaction after visibility and restriction checks; type is one of like/love/care/haha/wow/sad/angry.
160
512
  * Calls `PUT /api/v1/comments/{id}/reaction` through the shared IDP-aware Faiber client.
161
513
  * @param id Backend path identifier `id`.
162
514
  * @param data Typed JSON request body.
163
515
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
164
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
165
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:reaction:write.
516
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
517
+ * @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.
166
518
  */
167
- apiSetCommentReactionPut(id: Identifier, data: T.ApiSetCommentReactionPutInput, options?: RequestOptions<T.ApiSetCommentReactionPutInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialReactionResponse, T.ApiSetCommentReactionPutInput, {}>>;
519
+ apiSetCommentReactionPut(id: Identifier, data: T.ApiSetCommentReactionPutInput, options?: RequestOptions<T.ApiSetCommentReactionPutInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialReactionResponse, import("./types.js").SetReactionInput, {}, any>>;
168
520
  /**
169
- * Performs the list post comments operation for the api capability.
521
+ * Read published non-deleted comments oldest-first after checking parent visibility; no pagination query is consumed.
170
522
  * Calls `GET /api/v1/comments/post/{id}` through the shared IDP-aware Faiber client.
171
523
  * @param id Backend path identifier `id`.
172
524
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
173
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
174
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
525
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
526
+ * @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.
175
527
  */
176
- apiListPostCommentsGetApiV1CommentsPostId(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialCommentListResponse, unknown, {}>>;
528
+ apiListPostCommentsGetApiV1CommentsPostId(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialCommentListResponse, unknown, {}, any>>;
177
529
  /**
178
- * Performs the create post comment operation for the api capability.
530
+ * 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.
179
531
  * Calls `POST /api/v1/comments/post/{id}` through the shared IDP-aware Faiber client.
180
532
  * @param id Backend path identifier `id`.
181
533
  * @param data Typed JSON request body.
182
534
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
183
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
184
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:comment:create.
535
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
536
+ * @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.
185
537
  */
186
- apiCreatePostCommentPostApiV1CommentsPostId(id: Identifier, data: T.ApiCreatePostCommentPostApiV1CommentsPostIdInput, options?: RequestOptions<T.ApiCreatePostCommentPostApiV1CommentsPostIdInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialCommentResponse, T.ApiCreatePostCommentPostApiV1CommentsPostIdInput, {}>>;
538
+ apiCreatePostCommentPostApiV1CommentsPostId(id: Identifier, data: T.ApiCreatePostCommentPostApiV1CommentsPostIdInput, options?: RequestOptions<T.ApiCreatePostCommentPostApiV1CommentsPostIdInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialCommentResponse, import("./types.js").CreateCommentInput, {}, any>>;
187
539
  /**
188
- * Performs the receive funding event operation for the api capability.
540
+ * Remove the current actor follow edge; returns204 even when no edge existed.
541
+ * Calls `DELETE /api/v1/follow/{kind}/{id}` through the shared IDP-aware Faiber client.
542
+ * @param kind Backend path identifier `kind`.
543
+ * @param id Backend path identifier `id`.
544
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
545
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
546
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted server BFF_SERVICE_KEY bearer plus actor UUID.
547
+ */
548
+ discoveryUnfollowDelete(kind: import("./discovery.types.js").SocialFollowTargetKind, id: string, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
549
+ /**
550
+ * Read whether the current BFF actor follows or blocks a user/place target. kind is place or user.
551
+ * Calls `GET /api/v1/follow/{kind}/{id}` through the shared IDP-aware Faiber client.
552
+ * @param kind Backend path identifier `kind`.
553
+ * @param id Backend path identifier `id`.
554
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
555
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
556
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted server BFF_SERVICE_KEY bearer plus actor UUID.
557
+ */
558
+ discoveryRelationshipGet(kind: import("./discovery.types.js").SocialFollowTargetKind, id: string, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./discovery.types.js").SocialGraphResponse<import("./discovery.types.js").SocialRelationship>, unknown, {}, any>>;
559
+ /**
560
+ * 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.
561
+ * Calls `PUT /api/v1/follow/{kind}/{id}` through the shared IDP-aware Faiber client.
562
+ * @param kind Backend path identifier `kind`.
563
+ * @param id Backend path identifier `id`.
564
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
565
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
566
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted server BFF_SERVICE_KEY bearer plus actor UUID.
567
+ */
568
+ discoveryFollowPut(kind: import("./discovery.types.js").SocialFollowTargetKind, id: string, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
569
+ /**
570
+ * 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.
189
571
  * Calls `POST /api/v1/integrations/funding-events` through the shared IDP-aware Faiber client.
190
572
  * @param data Typed JSON request body.
191
573
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
192
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
193
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:integrations:write.
574
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
575
+ * @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.
576
+ */
577
+ apiReceiveFundingEventPost(data: T.ApiReceiveFundingEventPostInput, options?: RequestOptions<T.ApiReceiveFundingEventPostInput>): Promise<import("axios").AxiosResponse<import("./contracts.types.js").SocialFundingEventResponse, import("./contracts.types.js").SocialFundingEventInput, {}, any>>;
578
+ /**
579
+ * Read oldest50 undelivered notification events for the configured organization. No lease or claim is acquired; consumers must deduplicate.
580
+ * Calls `GET /api/v1/internal/notification-outbox` through the shared IDP-aware Faiber client.
581
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
582
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
583
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted BFF actor plus exact social:integrations:write permission.
584
+ */
585
+ discoveryOutboxGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./discovery.types.js").SocialGraphResponse<import("./discovery.types.js").SocialNotificationOutboxEvent[]>, unknown, {}, any>>;
586
+ /**
587
+ * Mark an organization-scoped notification as delivered; returns204 even for missing/already-acknowledged rows. Ack is not a downstream business-effect receipt.
588
+ * Calls `PUT /api/v1/internal/notification-outbox/{id}/ack` through the shared IDP-aware Faiber client.
589
+ * @param id Backend path identifier `id`.
590
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
591
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
592
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted BFF actor plus exact social:integrations:write permission.
593
+ */
594
+ discoveryAckPut(id: string, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
595
+ /**
596
+ * 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.
597
+ * Calls `POST /api/v1/internal/place-events` through the shared IDP-aware Faiber client.
598
+ * @param data Typed JSON request body.
599
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
600
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
601
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted BFF actor plus exact social:integrations:write permission.
194
602
  */
195
- apiReceiveFundingEventPost(data: T.ApiReceiveFundingEventPostInput, options?: RequestOptions<T.ApiReceiveFundingEventPostInput>): Promise<import("axios").AxiosResponse<T.ApiReceiveFundingEventPostResponse, T.ApiReceiveFundingEventPostInput, {}>>;
603
+ discoveryPlaceEventPost(data: T.DiscoveryPlaceEventPostInput, options?: RequestOptions<T.DiscoveryPlaceEventPostInput>): Promise<import("axios").AxiosResponse<void, import("./discovery.types.js").SocialPlaceEventInput, {}, any>>;
196
604
  /**
197
- * Performs the my analytics operation for the api capability.
605
+ * 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.
198
606
  * Calls `GET /api/v1/me/analytics` through the shared IDP-aware Faiber client.
199
607
  * @param params Typed query parameters; omitted members retain backend defaults.
200
608
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
201
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
202
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:analytics:read_own.
609
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
610
+ * @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.
203
611
  */
204
- apiMyAnalyticsGet(params?: T.ApiMyAnalyticsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").CreatorAnalyticsResponse, unknown, {}>>;
612
+ apiMyAnalyticsGet(params?: T.ApiMyAnalyticsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").CreatorAnalyticsResponse, unknown, {}, any>>;
205
613
  /**
206
- * Performs the my bookmarks operation for the api capability.
614
+ * List bookmarked post UUIDs for the authenticated organization/user; this is not a post projection.
207
615
  * Calls `GET /api/v1/me/bookmarks` through the shared IDP-aware Faiber client.
208
616
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
209
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
210
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
617
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
618
+ * @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.
211
619
  */
212
- apiMyBookmarksGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialBookmarksResponse, unknown, {}>>;
620
+ apiMyBookmarksGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialBookmarksResponse, unknown, {}, any>>;
213
621
  /**
214
- * Performs the my claims operation for the api capability.
622
+ * 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.
215
623
  * Calls `GET /api/v1/me/claims` through the shared IDP-aware Faiber client.
216
624
  * @param params Typed query parameters; omitted members retain backend defaults.
217
625
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
218
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
219
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
626
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
627
+ * @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.
220
628
  */
221
- apiMyClaimsGet(params?: T.ApiMyClaimsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.ApiMyClaimsGetResponse, unknown, {}>>;
629
+ apiMyClaimsGet(params?: T.ApiMyClaimsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./contracts.types.js").SocialClaimPageResponse, unknown, {}, any>>;
222
630
  /**
223
- * Performs the clear feed location operation for the api capability.
631
+ * Clear the authenticated user location preference idempotently; returns 204.
224
632
  * Calls `DELETE /api/v1/me/feed-location` through the shared IDP-aware Faiber client.
225
633
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
226
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
227
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
634
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
635
+ * @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.
228
636
  */
229
- apiClearFeedLocationDelete(options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}>>;
637
+ apiClearFeedLocationDelete(options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
230
638
  /**
231
- * Performs the get feed location operation for the api capability.
639
+ * Read the authenticated user location preference, returning data:null when unset.
232
640
  * Calls `GET /api/v1/me/feed-location` through the shared IDP-aware Faiber client.
233
641
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
234
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
235
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
642
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
643
+ * @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.
236
644
  */
237
- apiGetFeedLocationGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<T.ApiGetFeedLocationGetResponse, unknown, {}>>;
645
+ apiGetFeedLocationGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").FeedLocationPreferenceResponse, unknown, {}, any>>;
238
646
  /**
239
- * Performs the set feed location operation for the api capability.
647
+ * 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.
240
648
  * Calls `PUT /api/v1/me/feed-location` through the shared IDP-aware Faiber client.
241
649
  * @param data Typed JSON request body.
242
650
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
243
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
244
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
651
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
652
+ * @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.
245
653
  */
246
- apiSetFeedLocationPut(data: T.ApiSetFeedLocationPutInput, options?: RequestOptions<T.ApiSetFeedLocationPutInput>): Promise<import("axios").AxiosResponse<T.ApiSetFeedLocationPutResponse, T.ApiSetFeedLocationPutInput, {}>>;
654
+ apiSetFeedLocationPut(data: T.ApiSetFeedLocationPutInput, options?: RequestOptions<T.ApiSetFeedLocationPutInput>): Promise<import("axios").AxiosResponse<import("./types.js").SetFeedLocationResponse, import("./types.js").FeedLocationPreference, {}, any>>;
247
655
  /**
248
- * Performs the list my posts operation for the api capability.
656
+ * Read follow/comment/place/quest notification preferences, defaulting to enabled.
657
+ * Calls `GET /api/v1/me/notification-preferences` through the shared IDP-aware Faiber client.
658
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
659
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
660
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted server BFF_SERVICE_KEY bearer plus actor UUID.
661
+ */
662
+ discoveryPreferencesGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./discovery.types.js").SocialGraphResponse<import("./discovery.types.js").SocialNotificationPreferences>, unknown, {}, any>>;
663
+ /**
664
+ * Update supplied boolean preferences; absent fields stay unchanged. Current handler writes supplied preferences separately.
665
+ * Calls `PUT /api/v1/me/notification-preferences` through the shared IDP-aware Faiber client.
666
+ * @param data Typed JSON request body.
667
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
668
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
669
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: trusted server BFF_SERVICE_KEY bearer plus actor UUID.
670
+ */
671
+ discoverySetPreferencesPut(data: T.DiscoverySetPreferencesPutInput, options?: RequestOptions<T.DiscoverySetPreferencesPutInput>): Promise<import("axios").AxiosResponse<import("./discovery.types.js").SocialGraphResponse<import("./discovery.types.js").SocialNotificationPreferences>, Partial<import("./discovery.types.js").SocialNotificationPreferences>, {}, any>>;
672
+ /**
673
+ * Page current actor posts using feed filters and required pagination meta. author_id is overwritten by the authenticated user UUID.
249
674
  * Calls `GET /api/v1/me/posts` through the shared IDP-aware Faiber client.
250
675
  * @param params Typed query parameters; omitted members retain backend defaults.
251
676
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
252
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
253
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
677
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
678
+ * @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.
254
679
  */
255
- apiListMyPostsGet(params?: T.ApiListMyPostsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialPostListResponse, unknown, {}>>;
680
+ apiListMyPostsGet(params?: T.ApiListMyPostsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialPostListResponse, unknown, {}, any>>;
256
681
  /**
257
- * Performs the my post claims operation for the api capability.
682
+ * Page claims for a post owned by the current user; other actors return 403. Returns required total/page/limit meta and mutual_contact_consent.
258
683
  * Calls `GET /api/v1/me/posts/{id}/claims` through the shared IDP-aware Faiber client.
259
684
  * @param id Backend path identifier `id`.
260
685
  * @param params Typed query parameters; omitted members retain backend defaults.
261
686
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
262
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
263
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
687
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
688
+ * @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.
264
689
  */
265
- apiMyPostClaimsGet(id: Identifier, params?: T.ApiMyPostClaimsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.ApiMyPostClaimsGetResponse, unknown, {}>>;
690
+ apiMyPostClaimsGet(id: Identifier, params?: T.ApiMyPostClaimsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./contracts.types.js").SocialClaimPageResponse, unknown, {}, any>>;
266
691
  /**
267
- * Performs the get media operation for the api capability.
692
+ * Download organization media after uploader/parent visibility checks. Returns bytes with Content-Type and private,max-age=300; storage/configuration failures return 500.
268
693
  * Calls `GET /api/v1/media/{id}` through the shared IDP-aware Faiber client.
269
694
  * @param id Backend path identifier `id`.
270
695
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
271
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
272
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
696
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
697
+ * @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.
273
698
  */
274
- apiGetMediaGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}>>;
699
+ apiGetMediaGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialBinaryMediaResponse, unknown, {}, any>>;
275
700
  /**
276
- * Performs the upload media operation for the api capability.
701
+ * 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.
277
702
  * Calls `POST /api/v1/media/uploads` through the shared IDP-aware Faiber client.
278
703
  * @param data Typed multipart form.
279
704
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
280
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
281
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:post:create.
705
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
706
+ * @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.
282
707
  */
283
- apiUploadMediaPost(data: T.ApiUploadMediaPostInput, options?: RequestOptions<T.ApiUploadMediaPostInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialMediaResponse, FormData, {}>>;
708
+ apiUploadMediaPost(data: T.ApiUploadMediaPostInput, options?: RequestOptions<T.ApiUploadMediaPostInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialMediaResponse, FormData, {}, any>>;
284
709
  /**
285
- * Performs the moderate operation for the api capability.
710
+ * 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.
286
711
  * Calls `POST /api/v1/moderation/actions` through the shared IDP-aware Faiber client.
287
712
  * @param data Typed JSON request body.
288
713
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
289
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
290
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
714
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
715
+ * @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.
291
716
  */
292
- apiModeratePost(data: T.ApiModeratePostInput, options?: RequestOptions<T.ApiModeratePostInput>): Promise<import("axios").AxiosResponse<import("./types.js").ModerationActionResponse, T.ApiModeratePostInput, {}>>;
717
+ apiModeratePost(data: T.ApiModeratePostInput, options?: RequestOptions<T.ApiModeratePostInput>): Promise<import("axios").AxiosResponse<import("./types.js").ModerationActionResponse, import("./types.js").ModerateTargetInput, {}, any>>;
293
718
  /**
294
- * Performs the moderation audit operation for the api capability.
719
+ * 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.
295
720
  * Calls `GET /api/v1/moderation/audit` through the shared IDP-aware Faiber client.
296
721
  * @param params Typed query parameters; omitted members retain backend defaults.
297
722
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
298
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
299
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
723
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
724
+ * @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.
300
725
  */
301
- apiModerationAuditGet(params?: T.ApiModerationAuditGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").ModerationAuditResponse, unknown, {}>>;
726
+ apiModerationAuditGet(params?: T.ApiModerationAuditGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").ModerationAuditResponse, unknown, {}, any>>;
302
727
  /**
303
- * Performs the moderation queue operation for the api capability.
728
+ * Read pending non-deleted posts/comments and open/reviewing reports; awaiting-funding posts are excluded. Requires either social:moderate or social:moderation:review.
304
729
  * Calls `GET /api/v1/moderation/queue` through the shared IDP-aware Faiber client.
305
730
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
306
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
307
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
731
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
732
+ * @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.
308
733
  */
309
- apiModerationQueueGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").ModerationQueueResponse, unknown, {}>>;
734
+ apiModerationQueueGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").ModerationQueueResponse, unknown, {}, any>>;
310
735
  /**
311
- * Performs the list posts operation for the api capability.
736
+ * 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.
312
737
  * Calls `GET /api/v1/posts` through the shared IDP-aware Faiber client.
313
738
  * @param params Typed query parameters; omitted members retain backend defaults.
314
739
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
315
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
316
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
740
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
741
+ * @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.
317
742
  */
318
- apiListPostsGet(params?: T.ApiListPostsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialPostListResponse, unknown, {}>>;
743
+ apiListPostsGet(params?: T.ApiListPostsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialPostListResponse, unknown, {}, any>>;
319
744
  /**
320
- * Performs the create post operation for the api capability.
745
+ * 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.
321
746
  * Calls `POST /api/v1/posts` through the shared IDP-aware Faiber client.
322
747
  * @param data Typed JSON request body.
323
748
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
324
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
325
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:post:create.
749
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
750
+ * @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.
326
751
  */
327
- apiCreatePostPost(data: T.ApiCreatePostPostInput, options?: RequestOptions<T.ApiCreatePostPostInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialPostResponse, T.ApiCreatePostPostInput, {}>>;
752
+ apiCreatePostPost(data: T.ApiCreatePostPostInput, options?: RequestOptions<T.ApiCreatePostPostInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialPostResponse, import("./types.js").CreatePostInput, {}, any>>;
328
753
  /**
329
- * Performs the delete post operation for the api capability.
754
+ * Soft-delete an author-owned post, or a moderator-authorized post; returns 204.
330
755
  * Calls `DELETE /api/v1/posts/{id}` through the shared IDP-aware Faiber client.
331
756
  * @param id Backend path identifier `id`.
332
757
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
333
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
334
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:post:delete_own.
758
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
759
+ * @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.
335
760
  */
336
- apiDeletePostDelete(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}>>;
761
+ apiDeletePostDelete(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
337
762
  /**
338
- * Performs the get post operation for the api capability.
763
+ * 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.
339
764
  * Calls `GET /api/v1/posts/{id}` through the shared IDP-aware Faiber client.
340
765
  * @param id Backend path identifier `id`.
341
766
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
342
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
343
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
767
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
768
+ * @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.
344
769
  */
345
- apiGetPostGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialPostResponse, unknown, {}>>;
770
+ apiGetPostGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialPostResponse, unknown, {}, any>>;
346
771
  /**
347
- * Performs the update post operation for the api capability.
772
+ * 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.
348
773
  * Calls `PATCH /api/v1/posts/{id}` through the shared IDP-aware Faiber client.
349
774
  * @param id Backend path identifier `id`.
350
775
  * @param data Typed JSON request body.
351
776
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
352
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
353
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:post:update_own.
777
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
778
+ * @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.
354
779
  */
355
- apiUpdatePostPatch(id: Identifier, data: T.ApiUpdatePostPatchInput, options?: RequestOptions<T.ApiUpdatePostPatchInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialPostResponse, T.ApiUpdatePostPatchInput, {}>>;
780
+ apiUpdatePostPatch(id: Identifier, data: T.ApiUpdatePostPatchInput, options?: RequestOptions<T.ApiUpdatePostPatchInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialPostResponse, import("./types.js").UpdatePostInput, {}, any>>;
356
781
  /**
357
- * Performs the post analytics operation for the api capability.
782
+ * 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.
358
783
  * Calls `GET /api/v1/posts/{id}/analytics` through the shared IDP-aware Faiber client.
359
784
  * @param id Backend path identifier `id`.
360
785
  * @param params Typed query parameters; omitted members retain backend defaults.
361
786
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
362
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
363
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:analytics:read_own.
787
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
788
+ * @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.
364
789
  */
365
- apiPostAnalyticsGet(id: Identifier, params?: T.ApiPostAnalyticsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").CreatorAnalyticsResponse, unknown, {}>>;
790
+ apiPostAnalyticsGet(id: Identifier, params?: T.ApiPostAnalyticsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").CreatorAnalyticsResponse, unknown, {}, any>>;
366
791
  /**
367
- * Performs the unbookmark post operation for the api capability.
792
+ * Remove current user bookmark; returns 204.
368
793
  * Calls `DELETE /api/v1/posts/{id}/bookmark` through the shared IDP-aware Faiber client.
369
794
  * @param id Backend path identifier `id`.
370
795
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
371
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
372
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:bookmark:write.
796
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
797
+ * @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.
373
798
  */
374
- apiUnbookmarkPostDelete(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}>>;
799
+ apiUnbookmarkPostDelete(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
375
800
  /**
376
- * Performs the bookmark post operation for the api capability.
801
+ * Idempotently bookmark a visible post for current user; returns 204.
377
802
  * Calls `PUT /api/v1/posts/{id}/bookmark` through the shared IDP-aware Faiber client.
378
803
  * @param id Backend path identifier `id`.
379
804
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
380
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
381
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:bookmark:write.
805
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
806
+ * @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.
382
807
  */
383
- apiBookmarkPostPut(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}>>;
808
+ apiBookmarkPostPut(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
384
809
  /**
385
- * Performs the cancel capability post operation for the api capability.
810
+ * Cancel an author-owned post unless already resolved/cancelled/expired (409); hide content and queue bounty refund where relevant. Returns post_id/lifecycle_status.
386
811
  * Calls `POST /api/v1/posts/{id}/cancel` through the shared IDP-aware Faiber client.
387
812
  * @param id Backend path identifier `id`.
388
813
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
389
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
390
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:post:update_own.
814
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
815
+ * @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.
391
816
  */
392
- apiCancelCapabilityPostPost(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.ApiCancelCapabilityPostPostResponse, unknown, {}>>;
817
+ apiCancelCapabilityPostPost(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./contracts.types.js").SocialPostCancelledResponse, unknown, {}, any>>;
393
818
  /**
394
- * Performs the post capabilities operation for the api capability.
819
+ * Read a visible post capability projection with nullable subject/location/bounty, linked actions and lifecycle. Exact coordinates are excluded.
395
820
  * Calls `GET /api/v1/posts/{id}/capabilities` through the shared IDP-aware Faiber client.
396
821
  * @param id Backend path identifier `id`.
397
822
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
398
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
399
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
823
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
824
+ * @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.
400
825
  */
401
- apiPostCapabilitiesGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.ApiPostCapabilitiesGetResponse, unknown, {}>>;
826
+ apiPostCapabilitiesGet(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./contracts.types.js").SocialCapabilitiesResponse, unknown, {}, any>>;
402
827
  /**
403
- * Performs the create claim operation for the api capability.
828
+ * 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.
404
829
  * Calls `POST /api/v1/posts/{id}/claims` through the shared IDP-aware Faiber client.
405
830
  * @param id Backend path identifier `id`.
406
831
  * @param data Typed JSON request body.
407
832
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
408
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
409
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:claim:create.
833
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
834
+ * @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.
410
835
  */
411
- apiCreateClaimPost(id: Identifier, data: T.ApiCreateClaimPostInput, options?: RequestOptions<T.ApiCreateClaimPostInput>): Promise<import("axios").AxiosResponse<T.ApiCreateClaimPostResponse, T.ApiCreateClaimPostInput, {}>>;
836
+ apiCreateClaimPost(id: Identifier, data: T.ApiCreateClaimPostInput, options?: RequestOptions<T.ApiCreateClaimPostInput>): Promise<import("axios").AxiosResponse<import("./contracts.types.js").SocialClaimCreatedResponse, import("./contracts.types.js").SocialCreateClaimInput, {}, any>>;
412
837
  /**
413
- * Performs the list post comments operation for the api capability.
838
+ * Read published non-deleted comments oldest-first after checking parent visibility; no pagination query is consumed.
414
839
  * Calls `GET /api/v1/posts/{id}/comments` through the shared IDP-aware Faiber client.
415
840
  * @param id Backend path identifier `id`.
416
841
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
417
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
418
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
842
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
843
+ * @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.
419
844
  */
420
- apiListPostCommentsGetApiV1PostsIdComments(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialCommentListResponse, unknown, {}>>;
845
+ apiListPostCommentsGetApiV1PostsIdComments(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialCommentListResponse, unknown, {}, any>>;
421
846
  /**
422
- * Performs the create post comment operation for the api capability.
847
+ * 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.
423
848
  * Calls `POST /api/v1/posts/{id}/comments` through the shared IDP-aware Faiber client.
424
849
  * @param id Backend path identifier `id`.
425
850
  * @param data Typed JSON request body.
426
851
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
427
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
428
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:comment:create.
852
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
853
+ * @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.
429
854
  */
430
- apiCreatePostCommentPostApiV1PostsIdComments(id: Identifier, data: T.ApiCreatePostCommentPostApiV1PostsIdCommentsInput, options?: RequestOptions<T.ApiCreatePostCommentPostApiV1PostsIdCommentsInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialCommentResponse, T.ApiCreatePostCommentPostApiV1PostsIdCommentsInput, {}>>;
855
+ apiCreatePostCommentPostApiV1PostsIdComments(id: Identifier, data: T.ApiCreatePostCommentPostApiV1PostsIdCommentsInput, options?: RequestOptions<T.ApiCreatePostCommentPostApiV1PostsIdCommentsInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialCommentResponse, import("./types.js").CreateCommentInput, {}, any>>;
431
856
  /**
432
- * Performs the remove post reaction operation for the api capability.
857
+ * Remove current user post reaction and refresh counts; returns 204.
433
858
  * Calls `DELETE /api/v1/posts/{id}/like` through the shared IDP-aware Faiber client.
434
859
  * @param id Backend path identifier `id`.
435
860
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
436
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
437
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:reaction:write.
861
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
862
+ * @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.
438
863
  */
439
- apiRemovePostReactionDeleteApiV1PostsIdLike(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}>>;
864
+ apiRemovePostReactionDeleteApiV1PostsIdLike(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
440
865
  /**
441
- * Performs the like post operation for the api capability.
866
+ * Set the current user post reaction to like, returning the reaction record.
442
867
  * Calls `PUT /api/v1/posts/{id}/like` through the shared IDP-aware Faiber client.
443
868
  * @param id Backend path identifier `id`.
444
869
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
445
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
446
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:reaction:write.
870
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
871
+ * @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.
447
872
  */
448
- apiLikePostPut(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialReactionResponse, unknown, {}>>;
873
+ apiLikePostPut(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialReactionResponse, unknown, {}, any>>;
449
874
  /**
450
- * Performs the navigation access operation for the api capability.
875
+ * 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.
451
876
  * Calls `POST /api/v1/posts/{id}/navigation-access` through the shared IDP-aware Faiber client.
452
877
  * @param id Backend path identifier `id`.
453
878
  * @param data Typed JSON request body.
454
879
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
455
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
456
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:location:navigate.
880
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
881
+ * @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.
457
882
  */
458
- apiNavigationAccessPost(id: Identifier, data: T.ApiNavigationAccessPostInput, options?: RequestOptions<T.ApiNavigationAccessPostInput>): Promise<import("axios").AxiosResponse<T.ApiNavigationAccessPostResponse, T.ApiNavigationAccessPostInput, {}>>;
883
+ apiNavigationAccessPost(id: Identifier, data: T.ApiNavigationAccessPostInput, options?: RequestOptions<T.ApiNavigationAccessPostInput>): Promise<import("axios").AxiosResponse<import("./contracts.types.js").SocialNavigationAccessResponse, import("./contracts.types.js").SocialNavigationAccessInput, {}, any>>;
459
884
  /**
460
- * Performs the remove post reaction operation for the api capability.
885
+ * Remove current user post reaction and refresh counts; returns 204.
461
886
  * Calls `DELETE /api/v1/posts/{id}/reaction` through the shared IDP-aware Faiber client.
462
887
  * @param id Backend path identifier `id`.
463
888
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
464
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
465
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:reaction:write.
889
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
890
+ * @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.
466
891
  */
467
- apiRemovePostReactionDeleteApiV1PostsIdReaction(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}>>;
892
+ apiRemovePostReactionDeleteApiV1PostsIdReaction(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
468
893
  /**
469
- * Performs the post reactions operation for the api capability.
894
+ * Read post reaction totals, counts by reaction type and nullable viewer_reaction after verifying visibility.
470
895
  * Calls `GET /api/v1/posts/{id}/reaction` through the shared IDP-aware Faiber client.
471
896
  * @param id Backend path identifier `id`.
472
897
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
473
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
474
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
898
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
899
+ * @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.
475
900
  */
476
- apiPostReactionsGetApiV1PostsIdReaction(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").ReactionSummaryResponse, unknown, {}>>;
901
+ apiPostReactionsGetApiV1PostsIdReaction(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").ReactionSummaryResponse, unknown, {}, any>>;
477
902
  /**
478
- * Performs the set post reaction operation for the api capability.
903
+ * Upsert current user post reaction after visibility and restriction checks; type is one of like/love/care/haha/wow/sad/angry.
479
904
  * Calls `PUT /api/v1/posts/{id}/reaction` through the shared IDP-aware Faiber client.
480
905
  * @param id Backend path identifier `id`.
481
906
  * @param data Typed JSON request body.
482
907
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
483
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
484
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:reaction:write.
908
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
909
+ * @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.
485
910
  */
486
- apiSetPostReactionPut(id: Identifier, data: T.ApiSetPostReactionPutInput, options?: RequestOptions<T.ApiSetPostReactionPutInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialReactionResponse, T.ApiSetPostReactionPutInput, {}>>;
911
+ apiSetPostReactionPut(id: Identifier, data: T.ApiSetPostReactionPutInput, options?: RequestOptions<T.ApiSetPostReactionPutInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialReactionResponse, import("./types.js").SetReactionInput, {}, any>>;
487
912
  /**
488
- * Performs the resubmit post operation for the api capability.
913
+ * Resubmit author-owned content to the category moderation state; returns the updated post.
489
914
  * Calls `POST /api/v1/posts/{id}/resubmit` through the shared IDP-aware Faiber client.
490
915
  * @param id Backend path identifier `id`.
491
916
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
492
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
493
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:post:update_own.
917
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
918
+ * @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.
494
919
  */
495
- apiResubmitPostPost(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialPostResponse, unknown, {}>>;
920
+ apiResubmitPostPost(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialPostResponse, unknown, {}, any>>;
496
921
  /**
497
- * Performs the record share event operation for the api capability.
922
+ * 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.
498
923
  * Calls `POST /api/v1/posts/{id}/share-events` through the shared IDP-aware Faiber client.
499
924
  * @param id Backend path identifier `id`.
500
925
  * @param data Typed JSON request body.
501
926
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
502
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
503
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:share:write.
927
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
928
+ * @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.
504
929
  */
505
- apiRecordShareEventPost(id: Identifier, data: T.ApiRecordShareEventPostInput, options?: RequestOptions<T.ApiRecordShareEventPostInput>): Promise<import("axios").AxiosResponse<void, T.ApiRecordShareEventPostInput, {}>>;
930
+ apiRecordShareEventPost(id: Identifier, data: T.ApiRecordShareEventPostInput, options?: RequestOptions<T.ApiRecordShareEventPostInput>): Promise<import("axios").AxiosResponse<void, import("./types.js").ShareEventInput, {}, any>>;
506
931
  /**
507
- * Performs the record post view operation for the api capability.
932
+ * 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.
508
933
  * Calls `POST /api/v1/posts/{id}/views` through the shared IDP-aware Faiber client.
509
934
  * @param id Backend path identifier `id`.
510
935
  * @param data Typed JSON request body.
511
936
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
512
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
513
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:view:write.
937
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
938
+ * @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.
939
+ */
940
+ apiRecordPostViewPost(id: Identifier, data: T.ApiRecordPostViewPostInput, options?: RequestOptions<T.ApiRecordPostViewPostInput>): Promise<import("axios").AxiosResponse<import("./types.js").RecordViewResponse, import("./types.js").RecordViewInput, {}, any>>;
941
+ /**
942
+ * Download published media bytes after parent visibility and blocking checks. Response has private,no-cache. Unpublished media404, unavailable object storage500.
943
+ * Calls `GET /api/v1/public/media/{id}` through the shared IDP-aware Faiber client.
944
+ * @param id Backend path identifier `id`.
945
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
946
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
947
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: public projection.
948
+ */
949
+ discoveryMediaGet(id: string, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.DiscoveryMediaGetResponse, unknown, {}, any>>;
950
+ /**
951
+ * 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.
952
+ * Calls `GET /api/v1/public/posts` through the shared IDP-aware Faiber client.
953
+ * @param params Typed query parameters; omitted members retain backend defaults.
954
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
955
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
956
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: public; following=true requires a trusted BFF actor.
957
+ */
958
+ discoveryFeedGet(params?: T.DiscoveryFeedGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./discovery.types.js").SocialDiscoveryResponse<import("./discovery.types.js").SocialDiscoveryPost[]>, unknown, {}, any>>;
959
+ /**
960
+ * Read the same public, unexpired and non-blocked post projection; hidden, private, wrong-category or blocked records return404.
961
+ * Calls `GET /api/v1/public/posts/{id}` through the shared IDP-aware Faiber client.
962
+ * @param id Backend path identifier `id`.
963
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
964
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
965
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: public projection.
966
+ */
967
+ discoveryPostDetailGet(id: string, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./discovery.types.js").SocialDiscoveryResponse<import("./discovery.types.js").SocialDiscoveryPost>, unknown, {}, any>>;
968
+ /**
969
+ * Read at most100 published non-deleted comments, oldest first, after verifying parent post visibility and bidirectional actor blocks.
970
+ * Calls `GET /api/v1/public/posts/{id}/comments` through the shared IDP-aware Faiber client.
971
+ * @param id Backend path identifier `id`.
972
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
973
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
974
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: public projection.
514
975
  */
515
- apiRecordPostViewPost(id: Identifier, data: T.ApiRecordPostViewPostInput, options?: RequestOptions<T.ApiRecordPostViewPostInput>): Promise<import("axios").AxiosResponse<import("./types.js").RecordViewResponse, T.ApiRecordPostViewPostInput, {}>>;
976
+ discoveryCommentsGet(id: string, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./discovery.types.js").SocialDiscoveryResponse<import("./discovery.types.js").SocialDiscoveryComment[]>, unknown, {}, any>>;
516
977
  /**
517
- * Performs the remove post reaction operation for the api capability.
978
+ * Remove current user post reaction and refresh counts; returns 204.
518
979
  * Calls `DELETE /api/v1/reactions/post/{id}` through the shared IDP-aware Faiber client.
519
980
  * @param id Backend path identifier `id`.
520
981
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
521
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
522
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:reaction:write.
982
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
983
+ * @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.
523
984
  */
524
- apiRemovePostReactionDeleteApiV1ReactionsPostId(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}>>;
985
+ apiRemovePostReactionDeleteApiV1ReactionsPostId(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<void, unknown, {}, any>>;
525
986
  /**
526
- * Performs the post reactions operation for the api capability.
987
+ * Read post reaction totals, counts by reaction type and nullable viewer_reaction after verifying visibility.
527
988
  * Calls `GET /api/v1/reactions/post/{id}` through the shared IDP-aware Faiber client.
528
989
  * @param id Backend path identifier `id`.
529
990
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
530
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
531
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:read.
991
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
992
+ * @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.
532
993
  */
533
- apiPostReactionsGetApiV1ReactionsPostId(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").ReactionSummaryResponse, unknown, {}>>;
994
+ apiPostReactionsGetApiV1ReactionsPostId(id: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").ReactionSummaryResponse, unknown, {}, any>>;
534
995
  /**
535
- * Performs the set post reaction operation for the api capability.
996
+ * Upsert current user post reaction after visibility and restriction checks; type is one of like/love/care/haha/wow/sad/angry.
536
997
  * Calls `POST /api/v1/reactions/post/{id}` through the shared IDP-aware Faiber client.
537
998
  * @param id Backend path identifier `id`.
538
999
  * @param data Typed JSON request body.
539
1000
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
540
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
541
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:reaction:write.
1001
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
1002
+ * @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.
542
1003
  */
543
- apiSetPostReactionPost(id: Identifier, data: T.ApiSetPostReactionPostInput, options?: RequestOptions<T.ApiSetPostReactionPostInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialReactionResponse, T.ApiSetPostReactionPostInput, {}>>;
1004
+ apiSetPostReactionPost(id: Identifier, data: T.ApiSetPostReactionPostInput, options?: RequestOptions<T.ApiSetPostReactionPostInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialReactionResponse, import("./types.js").SetReactionInput, {}, any>>;
544
1005
  /**
545
- * Performs the create report operation for the api capability.
1006
+ * 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.
546
1007
  * Calls `POST /api/v1/reports` through the shared IDP-aware Faiber client.
547
1008
  * @param data Typed JSON request body.
548
1009
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
549
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
550
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: social:report:create.
1010
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
1011
+ * @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.
551
1012
  */
552
- apiCreateReportPost(data: T.ApiCreateReportPostInput, options?: RequestOptions<T.ApiCreateReportPostInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialReportResponse, T.ApiCreateReportPostInput, {}>>;
1013
+ apiCreateReportPost(data: T.ApiCreateReportPostInput, options?: RequestOptions<T.ApiCreateReportPostInput>): Promise<import("axios").AxiosResponse<import("./types.js").SocialReportResponse, import("./types.js").CreateReportInput, {}, any>>;
553
1014
  /**
554
- * Performs the health operation for the main capability.
1015
+ * Read process liveness and package version; this is not a dependency readiness probe.
555
1016
  * Calls `GET /health` through the shared IDP-aware Faiber client.
556
1017
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
557
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
558
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
1018
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
1019
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: public liveness route.
559
1020
  */
560
- mainHealthGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<T.MainHealthGetResponse, unknown, {}>>;
1021
+ mainHealthGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./types.js").SocialHealthResponse, unknown, {}, any>>;
561
1022
  }
562
1023
  //# sourceMappingURL=operations.d.ts.map