@faable/auth-sdk 2.5.2 → 2.5.4

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

@@ -2921,6 +2921,16 @@ export declare abstract class GeneratedFaableAuthApi extends FaableApi {
             updatedAt?: string | undefined;
         }>>;
     };
+    /**
+     * `POST /user/{user_id}/password-setup` — operationId: `user/passwordSetup`
+     *
+     * Send a password setup / reset email to the user
+     */
+    userPasswordSetup(user_id: string, data: OpBody<"user/passwordSetup">): Promise<{
+        status: "sent";
+        credential_id: string;
+        ticket_id: string;
+    }>;
     /**
      * `POST /user/{user_id}` — operationId: `user/update`
      *

package/dist/api/generated-client.js

@@ -717,6 +717,15 @@ export class GeneratedFaableAuthApi extends FaableApi {
     userList(params) {
         return this.paginator({ url: `/user`, params });
     }
+    /**
+     * `POST /user/{user_id}/password-setup` — operationId: `user/passwordSetup`
+     *
+     * Send a password setup / reset email to the user
+     */
+    userPasswordSetup(user_id, data) {
+        requireId("user_id", user_id);
+        return this.fetcher.post(`/user/${user_id}/password-setup`, data);
+    }
     /**
      * `POST /user/{user_id}` — operationId: `user/update`
      *

package/dist/api/types.d.ts

@@ -384,6 +384,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/user/{user_id}/password-setup": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Send a password setup / reset email to the user
+         * @description Ensures the user has a database credential (provisioning a password-less one when missing, e.g. for users created via the management API) and creates a `changepassword` ticket, sending the standard password reset email. The link lands on the tenant's auth domain. Idempotent on the credential; each call emits a fresh ticket.
+         */
+        post: operations["user/passwordSetup"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/identity": {
         parameters: {
             query?: never;
@@ -5295,6 +5315,40 @@ export interface operations {
             };
         };
     };
+    "user/passwordSetup": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                user_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Optional connection_name to disambiguate when the tenant has more than one database connection. Defaults to the tenant database connection. */
+                    connection?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Default Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @enum {string} */
+                        status: "sent";
+                        credential_id: string;
+                        ticket_id: string;
+                    };
+                };
+            };
+        };
+    };
     "identity/list": {
         parameters: {
             query?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faable/auth-sdk",
-  "version": "2.5.2",
+  "version": "2.5.4",
   "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": "1.30.1",
+    "version": "1.31.0",
     "license": {
       "name": "private",
       "url": "https://faable.com/docs/platform/privacy-policy"
@@ -9915,6 +9915,79 @@
         }
       }
     },
+    "/user/{user_id}/password-setup": {
+      "post": {
+        "operationId": "user/passwordSetup",
+        "summary": "Send a password setup / reset email to the user",
+        "tags": [
+          "user"
+        ],
+        "description": "Ensures the user has a database credential (provisioning a password-less one when missing, e.g. for users created via the management API) and creates a `changepassword` ticket, sending the standard password reset email. The link lands on the tenant's auth domain. Idempotent on the credential; each call emits a fresh ticket.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "connection": {
+                    "type": "string",
+                    "description": "Optional connection_name to disambiguate when the tenant has more than one database connection. Defaults to the tenant database connection."
+                  }
+                },
+                "additionalProperties": false
+              }
+            }
+          }
+        },
+        "parameters": [
+          {
+            "schema": {
+              "type": "string"
+            },
+            "in": "path",
+            "name": "user_id",
+            "required": true
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Default Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "status",
+                    "credential_id",
+                    "ticket_id"
+                  ],
+                  "properties": {
+                    "status": {
+                      "type": "string",
+                      "enum": [
+                        "sent"
+                      ]
+                    },
+                    "credential_id": {
+                      "type": "string"
+                    },
+                    "ticket_id": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/identity": {
       "get": {
         "operationId": "identity/list",