@faable/auth-sdk 2.7.25 → 2.7.27

package/dist/api/generated-client.d.ts

@@ -2761,6 +2761,28 @@ export declare abstract class GeneratedFaableAuthApi extends FaableApi {
             updatedAt?: string | undefined;
         }>>;
     };
+    /**
+     * `POST /internal/mgmt-token` — operationId: `internal/mintMgmtToken`
+     *
+     * Mint a tenant management token for a user (internal)
+     *
+     * Internal, service-to-service. Issues a short-lived Management API token bound to `account_id`, acting for the platform user `user_id`. Only the platform's own client_credentials clients listed in `MGMT_TOKEN_MINTER_CLIENT_IDS` may call it; the caller is responsible for checking that the user may manage that tenant. The target is taken from the body, never from `x-faableauth-account`.
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The user is suspended and cannot sign in or be modified.
+     * @throws {FaableApiError} `insufficient_scope` (403) — The token lacks a scope this operation requires. `message` names it.
+     * @throws {FaableApiError} `account_not_found` (404) — No Auth Account matches the request (domain, header or token).
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist in this account.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
+     */
+    internalMintMgmtToken(data: OpBody<"internal/mintMgmtToken">): Promise<{
+        access_token: string;
+        token_type: "Bearer";
+        expires_in: number;
+    }>;
     /**
      * `GET /internal/usage/sms` — operationId: `internal/smsUsage`
      *

package/dist/api/generated-client.js

@@ -982,6 +982,26 @@ export class GeneratedFaableAuthApi extends FaableApi {
     identityList(params) {
         return this.paginator({ url: `/identity`, params });
     }
+    /**
+     * `POST /internal/mgmt-token` — operationId: `internal/mintMgmtToken`
+     *
+     * Mint a tenant management token for a user (internal)
+     *
+     * Internal, service-to-service. Issues a short-lived Management API token bound to `account_id`, acting for the platform user `user_id`. Only the platform's own client_credentials clients listed in `MGMT_TOKEN_MINTER_CLIENT_IDS` may call it; the caller is responsible for checking that the user may manage that tenant. The target is taken from the body, never from `x-faableauth-account`.
+     *
+     * @throws {FaableApiError} `validation_error` (400) — The body, query or path failed schema validation. `details.issues` lists each failing field.
+     * @throws {FaableApiError} `unauthorized` (401) — The request carries no valid credentials.
+     * @throws {FaableApiError} `forbidden` (403) — The credentials are valid but do not allow this operation.
+     * @throws {FaableApiError} `user_suspended` (403) — The user is suspended and cannot sign in or be modified.
+     * @throws {FaableApiError} `insufficient_scope` (403) — The token lacks a scope this operation requires. `message` names it.
+     * @throws {FaableApiError} `account_not_found` (404) — No Auth Account matches the request (domain, header or token).
+     * @throws {FaableApiError} `not_found` (404) — The resource does not exist in this account.
+     * @throws {FaableApiError} `too_many_requests` (429) — Rate limit exceeded. Honour the `Retry-After` header.
+     * @throws {FaableApiError} `internal_error` (500) — Unexpected server error. Retry later; the request id is logged.
+     */
+    internalMintMgmtToken(data) {
+        return this.fetcher.post(`/internal/mgmt-token`, data);
+    }
     /**
      * `GET /internal/usage/sms` — operationId: `internal/smsUsage`
      *

package/dist/api/types.d.ts

@@ -164,6 +164,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/internal/mgmt-token": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Mint a tenant management token for a user (internal)
+         * @description Internal, service-to-service. Issues a short-lived Management API token bound to `account_id`, acting for the platform user `user_id`. Only the platform's own client_credentials clients listed in `MGMT_TOKEN_MINTER_CLIENT_IDS` may call it; the caller is responsible for checking that the user may manage that tenant. The target is taken from the body, never from `x-faableauth-account`.
+         */
+        post: operations["internal/mintMgmtToken"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/recovery-channels/capabilities": {
         parameters: {
             query?: never;
@@ -7671,6 +7691,127 @@ export interface operations {
             };
         };
     };
+    "internal/mintMgmtToken": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description The tenant the token will manage. */
+                    account_id: string;
+                    /** @description The platform (root) user the caller acts for. The caller has already checked that this user may manage the tenant. */
+                    user_id: string;
+                    /**
+                     * @description Lifetime in seconds.
+                     * @default 900
+                     */
+                    ttl?: number;
+                };
+            };
+        };
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        access_token: string;
+                        /** @enum {string} */
+                        token_type: "Bearer";
+                        expires_in: number;
+                    };
+                };
+            };
+            /** @description `validation_error` — The body, query or path failed schema validation. `details.issues` lists each failing field. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"] & {
+                        /** @enum {string} */
+                        error_code?: "validation_error";
+                    };
+                };
+            };
+            /** @description `unauthorized` — The request carries no valid credentials. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"] & {
+                        /** @enum {string} */
+                        error_code?: "unauthorized";
+                    };
+                };
+            };
+            /**
+             * @description `forbidden` — The credentials are valid but do not allow this operation.
+             *
+             *     `user_suspended` — The user is suspended and cannot sign in or be modified.
+             *
+             *     `insufficient_scope` — The token lacks a scope this operation requires. `message` names it.
+             */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"] & {
+                        /** @enum {string} */
+                        error_code?: "forbidden" | "user_suspended" | "insufficient_scope";
+                    };
+                };
+            };
+            /**
+             * @description `account_not_found` — No Auth Account matches the request (domain, header or token).
+             *
+             *     `not_found` — The resource does not exist in this account.
+             */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"] & {
+                        /** @enum {string} */
+                        error_code?: "account_not_found" | "not_found";
+                    };
+                };
+            };
+            /** @description `too_many_requests` — Rate limit exceeded. Honour the `Retry-After` header. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"] & {
+                        /** @enum {string} */
+                        error_code?: "too_many_requests";
+                    };
+                };
+            };
+            /** @description `internal_error` — Unexpected server error. Retry later; the request id is logged. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"] & {
+                        /** @enum {string} */
+                        error_code?: "internal_error";
+                    };
+                };
+            };
+        };
+    };
     "account/recoveryChannelsCapabilities": {
         parameters: {
             query?: never;

package/dist/version.js

@@ -9,13 +9,13 @@
 // login pages could not import the SDK at all. Same pattern as auth-js.
 //
 // The sentinels MUST stay byte-identical to the `from` values in `.releaserc`.
-export const version = "2.7.25";
+export const version = "2.7.27";
 // Short git SHA of the released commit. The version dates a build; this names
 // the exact tree, so a canonical log line or an audit entry leads straight to
 // `git show <sha>`. Deliberately NOT hex: an unreleased build (dev, a local
 // link) cannot be mistaken for a real commit — auth only records values that
 // look like a SHA, and this one never will.
-export const commit = "3899a15";
+export const commit = "ffc252f";
 // What this SDK writes in `x-faable-client`. Exported for a consumer that
 // builds a strategy on its own (outside `FaableAuthApi`) and still wants the
 // token request attributed — a bare `authClientCredentials` stamps only what

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faable/auth-sdk",
-  "version": "2.7.25",
+  "version": "2.7.27",
   "author": "Marc Pomar <marc@faable.com>",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/spec/openapi.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "@faablecloud/auth",
     "description": "Auth Platform made by Faable. Manage Users and Roles",
-    "version": "2.32.0",
+    "version": "2.33.0",
     "license": {
       "name": "private",
       "url": "https://faable.com/docs/platform/privacy-policy"
@@ -10917,6 +10917,240 @@
         }
       }
     },
+    "/internal/mgmt-token": {
+      "post": {
+        "operationId": "internal/mintMgmtToken",
+        "summary": "Mint a tenant management token for a user (internal)",
+        "tags": [
+          "account"
+        ],
+        "description": "Internal, service-to-service. Issues a short-lived Management API token bound to `account_id`, acting for the platform user `user_id`. Only the platform's own client_credentials clients listed in `MGMT_TOKEN_MINTER_CLIENT_IDS` may call it; the caller is responsible for checking that the user may manage that tenant. The target is taken from the body, never from `x-faableauth-account`.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": [
+                  "account_id",
+                  "user_id"
+                ],
+                "properties": {
+                  "account_id": {
+                    "type": "string",
+                    "pattern": "^account_[0-9a-f]{24}$",
+                    "description": "The tenant the token will manage."
+                  },
+                  "user_id": {
+                    "type": "string",
+                    "pattern": "^user_[0-9a-f]{24}$",
+                    "description": "The platform (root) user the caller acts for. The caller has already checked that this user may manage the tenant."
+                  },
+                  "ttl": {
+                    "type": "integer",
+                    "minimum": 60,
+                    "maximum": 900,
+                    "default": 900,
+                    "description": "Lifetime in seconds."
+                  }
+                },
+                "additionalProperties": false
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "x-internal": true,
+        "responses": {
+          "200": {
+            "description": "Default Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "access_token",
+                    "token_type",
+                    "expires_in"
+                  ],
+                  "properties": {
+                    "access_token": {
+                      "type": "string"
+                    },
+                    "token_type": {
+                      "type": "string",
+                      "enum": [
+                        "Bearer"
+                      ]
+                    },
+                    "expires_in": {
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "`validation_error` — The body, query or path failed schema validation. `details.issues` lists each failing field.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "allOf": [
+                    {
+                      "$ref": "#/components/schemas/ErrorResponse"
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "error_code": {
+                          "type": "string",
+                          "enum": [
+                            "validation_error"
+                          ]
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "`unauthorized` — The request carries no valid credentials.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "allOf": [
+                    {
+                      "$ref": "#/components/schemas/ErrorResponse"
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "error_code": {
+                          "type": "string",
+                          "enum": [
+                            "unauthorized"
+                          ]
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "`forbidden` — The credentials are valid but do not allow this operation.\n\n`user_suspended` — The user is suspended and cannot sign in or be modified.\n\n`insufficient_scope` — The token lacks a scope this operation requires. `message` names it.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "allOf": [
+                    {
+                      "$ref": "#/components/schemas/ErrorResponse"
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "error_code": {
+                          "type": "string",
+                          "enum": [
+                            "forbidden",
+                            "user_suspended",
+                            "insufficient_scope"
+                          ]
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "`account_not_found` — No Auth Account matches the request (domain, header or token).\n\n`not_found` — The resource does not exist in this account.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "allOf": [
+                    {
+                      "$ref": "#/components/schemas/ErrorResponse"
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "error_code": {
+                          "type": "string",
+                          "enum": [
+                            "account_not_found",
+                            "not_found"
+                          ]
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "`too_many_requests` — Rate limit exceeded. Honour the `Retry-After` header.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "allOf": [
+                    {
+                      "$ref": "#/components/schemas/ErrorResponse"
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "error_code": {
+                          "type": "string",
+                          "enum": [
+                            "too_many_requests"
+                          ]
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "`internal_error` — Unexpected server error. Retry later; the request id is logged.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "allOf": [
+                    {
+                      "$ref": "#/components/schemas/ErrorResponse"
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "error_code": {
+                          "type": "string",
+                          "enum": [
+                            "internal_error"
+                          ]
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/recovery-channels/capabilities": {
       "get": {
         "operationId": "account/recoveryChannelsCapabilities",