@faable/auth-sdk 2.7.94 → 2.7.95

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.
@@ -840,6 +840,16 @@ export declare class FaableAuthApi extends GeneratedFaableAuthApi {
840
840
  } | undefined;
841
841
  login_flow?: string | null | undefined;
842
842
  default_audience?: string | null | undefined;
843
+ saml_sp?: {
844
+ enabled: boolean;
845
+ entity_id: string;
846
+ acs_url: string;
847
+ nameid_format?: "unspecified" | "emailAddress" | "persistent" | undefined;
848
+ attribute_mapping?: {
849
+ [key: string]: "name" | "picture" | "email" | "user_id" | "email_verified" | "given_name" | "family_name" | "nickname" | "phone_number";
850
+ } | undefined;
851
+ sign_response?: boolean | undefined;
852
+ } | null | undefined;
843
853
  account: string;
844
854
  metadata: {
845
855
  [key: string]: unknown;
@@ -907,6 +917,16 @@ export declare class FaableAuthApi extends GeneratedFaableAuthApi {
907
917
  } | undefined;
908
918
  login_flow?: string | null | undefined;
909
919
  default_audience?: string | null | undefined;
920
+ saml_sp?: {
921
+ enabled: boolean;
922
+ entity_id: string;
923
+ acs_url: string;
924
+ nameid_format?: "unspecified" | "emailAddress" | "persistent" | undefined;
925
+ attribute_mapping?: {
926
+ [key: string]: "name" | "picture" | "email" | "user_id" | "email_verified" | "given_name" | "family_name" | "nickname" | "phone_number";
927
+ } | undefined;
928
+ sign_response?: boolean | undefined;
929
+ } | null | undefined;
910
930
  account: string;
911
931
  metadata: {
912
932
  [key: string]: unknown;
@@ -977,6 +997,16 @@ export declare class FaableAuthApi extends GeneratedFaableAuthApi {
977
997
  } | undefined;
978
998
  login_flow?: string | null | undefined;
979
999
  default_audience?: string | null | undefined;
1000
+ saml_sp?: {
1001
+ enabled: boolean;
1002
+ entity_id: string;
1003
+ acs_url: string;
1004
+ nameid_format?: "unspecified" | "emailAddress" | "persistent" | undefined;
1005
+ attribute_mapping?: {
1006
+ [key: string]: "name" | "picture" | "email" | "user_id" | "email_verified" | "given_name" | "family_name" | "nickname" | "phone_number";
1007
+ } | undefined;
1008
+ sign_response?: boolean | undefined;
1009
+ } | null | undefined;
980
1010
  account: string;
981
1011
  metadata: {
982
1012
  [key: string]: unknown;
@@ -1046,6 +1076,16 @@ export declare class FaableAuthApi extends GeneratedFaableAuthApi {
1046
1076
  } | undefined;
1047
1077
  login_flow?: string | null | undefined;
1048
1078
  default_audience?: string | null | undefined;
1079
+ saml_sp?: {
1080
+ enabled: boolean;
1081
+ entity_id: string;
1082
+ acs_url: string;
1083
+ nameid_format?: "unspecified" | "emailAddress" | "persistent" | undefined;
1084
+ attribute_mapping?: {
1085
+ [key: string]: "name" | "picture" | "email" | "user_id" | "email_verified" | "given_name" | "family_name" | "nickname" | "phone_number";
1086
+ } | undefined;
1087
+ sign_response?: boolean | undefined;
1088
+ } | null | undefined;
1049
1089
  account: string;
1050
1090
  metadata: {
1051
1091
  [key: string]: unknown;
@@ -385,6 +385,33 @@ export declare abstract class GeneratedFaableAuthApi extends FaableApi {
385
385
  next_in_queue_kid: string;
386
386
  kids_active: string[];
387
387
  }>;
388
+ /**
389
+ * `GET /account/keys/saml` — operationId: `account/getSamlKeys`
390
+ *
391
+ * Get the SAML signing certificates
392
+ *
393
+ * The X.509 certificate this Account signs SAML assertions with, and the next one when a rotation is staged. Separate from the JWKS keys: rotating tokens never touches SAML. Created on first use.
394
+ *
395
+ * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
396
+ * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
397
+ * @throws {FaableApiError} `insufficient_scope` (403) — The token lacks a scope this operation requires. `message` names it.
398
+ * @throws {FaableApiError} `user_suspended` (403) — The user is suspended and cannot sign in or be modified.
399
+ * @throws {FaableApiError} `account_not_found` (404) — No Auth Account matches the request (domain, header or token).
400
+ * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
401
+ * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
402
+ */
403
+ accountGetSamlKeys(): Promise<{
404
+ current: {
405
+ id: string;
406
+ certificate: string;
407
+ not_after: string;
408
+ };
409
+ next?: {
410
+ id: string;
411
+ certificate: string;
412
+ not_after: string;
413
+ } | undefined;
414
+ }>;
388
415
  /**
389
416
  * `GET /account` — operationId: `account/list`
390
417
  *
@@ -667,6 +694,26 @@ export declare abstract class GeneratedFaableAuthApi extends FaableApi {
667
694
  next_in_queue_kid: string;
668
695
  kids_active: string[];
669
696
  }>;
697
+ /**
698
+ * `POST /account/keys/saml/rotate` — operationId: `account/rotateSamlKeys`
699
+ *
700
+ * Rotate the SAML signing certificate
701
+ *
702
+ * Two steps. The first call stages a new certificate: the IdP metadata publishes both and signing continues with the current one, so each Service Provider can be updated. The second call promotes it: assertions are signed with the new certificate and the old one is dropped.
703
+ *
704
+ * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
705
+ * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
706
+ * @throws {FaableApiError} `insufficient_scope` (403) — The token lacks a scope this operation requires. `message` names it.
707
+ * @throws {FaableApiError} `user_suspended` (403) — The user is suspended and cannot sign in or be modified.
708
+ * @throws {FaableApiError} `account_not_found` (404) — No Auth Account matches the request (domain, header or token).
709
+ * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
710
+ * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
711
+ */
712
+ accountRotateSamlKeys(): Promise<{
713
+ step: "staged" | "promoted";
714
+ current_id: string;
715
+ next_id?: string | undefined;
716
+ }>;
670
717
  /**
671
718
  * `GET /sdk-health/{account_id}` — operationId: `account/sdk-health`
672
719
  *
@@ -1459,6 +1506,16 @@ export declare abstract class GeneratedFaableAuthApi extends FaableApi {
1459
1506
  } | undefined;
1460
1507
  login_flow?: string | null | undefined;
1461
1508
  default_audience?: string | null | undefined;
1509
+ saml_sp?: {
1510
+ enabled: boolean;
1511
+ entity_id: string;
1512
+ acs_url: string;
1513
+ nameid_format?: "unspecified" | "emailAddress" | "persistent" | undefined;
1514
+ attribute_mapping?: {
1515
+ [key: string]: "name" | "picture" | "email" | "user_id" | "email_verified" | "given_name" | "family_name" | "nickname" | "phone_number";
1516
+ } | undefined;
1517
+ sign_response?: boolean | undefined;
1518
+ } | null | undefined;
1462
1519
  account: string;
1463
1520
  metadata: {
1464
1521
  [key: string]: unknown;
@@ -1542,6 +1599,16 @@ export declare abstract class GeneratedFaableAuthApi extends FaableApi {
1542
1599
  } | undefined;
1543
1600
  login_flow?: string | null | undefined;
1544
1601
  default_audience?: string | null | undefined;
1602
+ saml_sp?: {
1603
+ enabled: boolean;
1604
+ entity_id: string;
1605
+ acs_url: string;
1606
+ nameid_format?: "unspecified" | "emailAddress" | "persistent" | undefined;
1607
+ attribute_mapping?: {
1608
+ [key: string]: "name" | "picture" | "email" | "user_id" | "email_verified" | "given_name" | "family_name" | "nickname" | "phone_number";
1609
+ } | undefined;
1610
+ sign_response?: boolean | undefined;
1611
+ } | null | undefined;
1545
1612
  account: string;
1546
1613
  metadata: {
1547
1614
  [key: string]: unknown;
@@ -1626,6 +1693,16 @@ export declare abstract class GeneratedFaableAuthApi extends FaableApi {
1626
1693
  } | undefined;
1627
1694
  login_flow?: string | null | undefined;
1628
1695
  default_audience?: string | null | undefined;
1696
+ saml_sp?: {
1697
+ enabled: boolean;
1698
+ entity_id: string;
1699
+ acs_url: string;
1700
+ nameid_format?: "unspecified" | "emailAddress" | "persistent" | undefined;
1701
+ attribute_mapping?: {
1702
+ [key: string]: "name" | "picture" | "email" | "user_id" | "email_verified" | "given_name" | "family_name" | "nickname" | "phone_number";
1703
+ } | undefined;
1704
+ sign_response?: boolean | undefined;
1705
+ } | null | undefined;
1629
1706
  account: string;
1630
1707
  metadata: {
1631
1708
  [key: string]: unknown;
@@ -1711,6 +1788,16 @@ export declare abstract class GeneratedFaableAuthApi extends FaableApi {
1711
1788
  } | undefined;
1712
1789
  login_flow?: string | null | undefined;
1713
1790
  default_audience?: string | null | undefined;
1791
+ saml_sp?: {
1792
+ enabled: boolean;
1793
+ entity_id: string;
1794
+ acs_url: string;
1795
+ nameid_format?: "unspecified" | "emailAddress" | "persistent" | undefined;
1796
+ attribute_mapping?: {
1797
+ [key: string]: "name" | "picture" | "email" | "user_id" | "email_verified" | "given_name" | "family_name" | "nickname" | "phone_number";
1798
+ } | undefined;
1799
+ sign_response?: boolean | undefined;
1800
+ } | null | undefined;
1714
1801
  account: string;
1715
1802
  metadata: {
1716
1803
  [key: string]: unknown;
@@ -1778,6 +1865,16 @@ export declare abstract class GeneratedFaableAuthApi extends FaableApi {
1778
1865
  } | undefined;
1779
1866
  login_flow?: string | null | undefined;
1780
1867
  default_audience?: string | null | undefined;
1868
+ saml_sp?: {
1869
+ enabled: boolean;
1870
+ entity_id: string;
1871
+ acs_url: string;
1872
+ nameid_format?: "unspecified" | "emailAddress" | "persistent" | undefined;
1873
+ attribute_mapping?: {
1874
+ [key: string]: "name" | "picture" | "email" | "user_id" | "email_verified" | "given_name" | "family_name" | "nickname" | "phone_number";
1875
+ } | undefined;
1876
+ sign_response?: boolean | undefined;
1877
+ } | null | undefined;
1781
1878
  account: string;
1782
1879
  metadata: {
1783
1880
  [key: string]: unknown;
@@ -1848,6 +1945,16 @@ export declare abstract class GeneratedFaableAuthApi extends FaableApi {
1848
1945
  } | undefined;
1849
1946
  login_flow?: string | null | undefined;
1850
1947
  default_audience?: string | null | undefined;
1948
+ saml_sp?: {
1949
+ enabled: boolean;
1950
+ entity_id: string;
1951
+ acs_url: string;
1952
+ nameid_format?: "unspecified" | "emailAddress" | "persistent" | undefined;
1953
+ attribute_mapping?: {
1954
+ [key: string]: "name" | "picture" | "email" | "user_id" | "email_verified" | "given_name" | "family_name" | "nickname" | "phone_number";
1955
+ } | undefined;
1956
+ sign_response?: boolean | undefined;
1957
+ } | null | undefined;
1851
1958
  account: string;
1852
1959
  metadata: {
1853
1960
  [key: string]: unknown;
@@ -1934,6 +2041,16 @@ export declare abstract class GeneratedFaableAuthApi extends FaableApi {
1934
2041
  } | undefined;
1935
2042
  login_flow?: string | null | undefined;
1936
2043
  default_audience?: string | null | undefined;
2044
+ saml_sp?: {
2045
+ enabled: boolean;
2046
+ entity_id: string;
2047
+ acs_url: string;
2048
+ nameid_format?: "unspecified" | "emailAddress" | "persistent" | undefined;
2049
+ attribute_mapping?: {
2050
+ [key: string]: "name" | "picture" | "email" | "user_id" | "email_verified" | "given_name" | "family_name" | "nickname" | "phone_number";
2051
+ } | undefined;
2052
+ sign_response?: boolean | undefined;
2053
+ } | null | undefined;
1937
2054
  account: string;
1938
2055
  metadata: {
1939
2056
  [key: string]: unknown;
@@ -2018,6 +2135,16 @@ export declare abstract class GeneratedFaableAuthApi extends FaableApi {
2018
2135
  } | undefined;
2019
2136
  login_flow?: string | null | undefined;
2020
2137
  default_audience?: string | null | undefined;
2138
+ saml_sp?: {
2139
+ enabled: boolean;
2140
+ entity_id: string;
2141
+ acs_url: string;
2142
+ nameid_format?: "unspecified" | "emailAddress" | "persistent" | undefined;
2143
+ attribute_mapping?: {
2144
+ [key: string]: "name" | "picture" | "email" | "user_id" | "email_verified" | "given_name" | "family_name" | "nickname" | "phone_number";
2145
+ } | undefined;
2146
+ sign_response?: boolean | undefined;
2147
+ } | null | undefined;
2021
2148
  account: string;
2022
2149
  metadata: {
2023
2150
  [key: string]: unknown;
@@ -135,6 +135,24 @@ export class GeneratedFaableAuthApi extends FaableApi {
135
135
  accountGetKeys() {
136
136
  return this.fetcher.get(`/account/keys`);
137
137
  }
138
+ /**
139
+ * `GET /account/keys/saml` — operationId: `account/getSamlKeys`
140
+ *
141
+ * Get the SAML signing certificates
142
+ *
143
+ * The X.509 certificate this Account signs SAML assertions with, and the next one when a rotation is staged. Separate from the JWKS keys: rotating tokens never touches SAML. Created on first use.
144
+ *
145
+ * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
146
+ * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
147
+ * @throws {FaableApiError} `insufficient_scope` (403) — The token lacks a scope this operation requires. `message` names it.
148
+ * @throws {FaableApiError} `user_suspended` (403) — The user is suspended and cannot sign in or be modified.
149
+ * @throws {FaableApiError} `account_not_found` (404) — No Auth Account matches the request (domain, header or token).
150
+ * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
151
+ * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
152
+ */
153
+ accountGetSamlKeys() {
154
+ return this.fetcher.get(`/account/keys/saml`);
155
+ }
138
156
  /**
139
157
  * `GET /account` — operationId: `account/list`
140
158
  *
@@ -194,6 +212,24 @@ export class GeneratedFaableAuthApi extends FaableApi {
194
212
  accountRotateKeys(data) {
195
213
  return this.fetcher.post(`/account/keys/rotate`, data);
196
214
  }
215
+ /**
216
+ * `POST /account/keys/saml/rotate` — operationId: `account/rotateSamlKeys`
217
+ *
218
+ * Rotate the SAML signing certificate
219
+ *
220
+ * Two steps. The first call stages a new certificate: the IdP metadata publishes both and signing continues with the current one, so each Service Provider can be updated. The second call promotes it: assertions are signed with the new certificate and the old one is dropped.
221
+ *
222
+ * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
223
+ * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
224
+ * @throws {FaableApiError} `insufficient_scope` (403) — The token lacks a scope this operation requires. `message` names it.
225
+ * @throws {FaableApiError} `user_suspended` (403) — The user is suspended and cannot sign in or be modified.
226
+ * @throws {FaableApiError} `account_not_found` (404) — No Auth Account matches the request (domain, header or token).
227
+ * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
228
+ * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
229
+ */
230
+ accountRotateSamlKeys() {
231
+ return this.fetcher.post(`/account/keys/saml/rotate`, {});
232
+ }
197
233
  /**
198
234
  * `GET /sdk-health/{account_id}` — operationId: `account/sdk-health`
199
235
  *