@auth-gate/core 0.10.0 → 0.12.0

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="icon.png" alt="AuthGate" width="120" height="120" />
+  <img src="https://raw.githubusercontent.com/f-starace/authgate/main/packages/core/icon.png" alt="AuthGate" width="120" height="120" />
 </p>
 
 # @auth-gate/core

package/dist/index.cjs

@@ -502,11 +502,11 @@ var AuthGateClient = class {
           Authorization: `Bearer ${this.config.apiKey}`,
           "Content-Type": "application/json"
         },
-        body: JSON.stringify({
+        body: JSON.stringify(__spreadValues({
           callback_url: callbackUrl,
           state: options == null ? void 0 : options.state,
           link_to: options == null ? void 0 : options.linkTo
-        })
+        }, (options == null ? void 0 : options.locale) && { locale: options.locale }))
       }
     );
     if (!response.ok) {
@@ -534,12 +534,12 @@ var AuthGateClient = class {
         Authorization: `Bearer ${this.config.apiKey}`,
         "Content-Type": "application/json"
       },
-      body: JSON.stringify({
+      body: JSON.stringify(__spreadValues({
         email: data.email,
         password: data.password,
         name: data.name,
         callback_url: data.callbackUrl
-      })
+      }, data.locale && { locale: data.locale }))
     });
   }
   /**
@@ -558,11 +558,11 @@ var AuthGateClient = class {
         Authorization: `Bearer ${this.config.apiKey}`,
         "Content-Type": "application/json"
       },
-      body: JSON.stringify({
+      body: JSON.stringify(__spreadValues({
         email: data.email,
         password: data.password,
         callback_url: data.callbackUrl
-      })
+      }, data.locale && { locale: data.locale }))
     });
   }
   /**
@@ -578,10 +578,10 @@ var AuthGateClient = class {
         Authorization: `Bearer ${this.config.apiKey}`,
         "Content-Type": "application/json"
       },
-      body: JSON.stringify({
+      body: JSON.stringify(__spreadValues({
         email: data.email,
         callback_url: data.callbackUrl
-      })
+      }, data.locale && { locale: data.locale }))
     });
   }
   /**
@@ -599,10 +599,10 @@ var AuthGateClient = class {
           Authorization: `Bearer ${this.config.apiKey}`,
           "Content-Type": "application/json"
         },
-        body: JSON.stringify({
+        body: JSON.stringify(__spreadValues({
           token: data.token,
           password: data.password
-        })
+        }, data.locale && { locale: data.locale }))
       }
     );
   }
@@ -622,10 +622,10 @@ var AuthGateClient = class {
         Authorization: `Bearer ${this.config.apiKey}`,
         "Content-Type": "application/json"
       },
-      body: JSON.stringify({
+      body: JSON.stringify(__spreadValues({
         email: data.email,
         callback_url: data.callbackUrl
-      })
+      }, data.locale && { locale: data.locale }))
     });
   }
   // ---------------------------------------------------------------------------
@@ -644,10 +644,10 @@ var AuthGateClient = class {
         Authorization: `Bearer ${this.config.apiKey}`,
         "Content-Type": "application/json"
       },
-      body: JSON.stringify({
+      body: JSON.stringify(__spreadValues({
         email: data.email,
         code: data.code
-      })
+      }, data.locale && { locale: data.locale }))
     });
   }
   // ---------------------------------------------------------------------------

package/dist/index.d.cts

@@ -260,6 +260,7 @@ declare class AuthGateClient {
     getOAuthUrl(provider: OAuthProvider, callbackUrl: string, options?: {
         state?: string;
         linkTo?: string;
+        locale?: string;
     }): Promise<string>;
     /**
      * Register a new user with email and password.
@@ -272,6 +273,7 @@ declare class AuthGateClient {
         password: string;
         name?: string;
         callbackUrl: string;
+        locale?: string;
     }): Promise<Response>;
     /**
      * Sign in an existing user with email and password.
@@ -286,6 +288,7 @@ declare class AuthGateClient {
         email: string;
         password: string;
         callbackUrl: string;
+        locale?: string;
     }): Promise<Response>;
     /**
      * Send a password reset email to the user.
@@ -296,6 +299,7 @@ declare class AuthGateClient {
     emailForgotPassword(data: {
         email: string;
         callbackUrl: string;
+        locale?: string;
     }): Promise<Response>;
     /**
      * Confirm a password reset with the token from the reset email.
@@ -306,6 +310,7 @@ declare class AuthGateClient {
     emailResetPassword(data: {
         token: string;
         password: string;
+        locale?: string;
     }): Promise<Response>;
     /**
      * Send a magic link email for passwordless authentication.
@@ -316,6 +321,7 @@ declare class AuthGateClient {
     magicLinkSend(data: {
         email: string;
         callbackUrl: string;
+        locale?: string;
     }): Promise<Response>;
     /**
      * Verify an email address using a one-time code.
@@ -326,6 +332,7 @@ declare class AuthGateClient {
     emailVerifyCode(data: {
         email: string;
         code: string;
+        locale?: string;
     }): Promise<Response>;
     /**
      * Send an SMS verification code to the user's phone number.
@@ -690,6 +697,10 @@ declare class ConfigurationError extends AuthGateError {
 
 /**
  * Connection details for the AuthGate API.
+ *
+ * Both fields are optional at the type level because they can be provided
+ * via environment variables (`AUTHGATE_URL`, `AUTHGATE_API_KEY`). The CLI
+ * auto-loads `.env` and `.env.local` before importing the config file.
  */
 type AuthGateConnection = {
     baseUrl?: string;
@@ -697,13 +708,57 @@ type AuthGateConnection = {
 };
 /**
  * Project-level config shape for `authgate.config.ts`.
- * Used by both `@auth-gate/rbac` and `@auth-gate/billing` CLIs.
+ *
+ * Used by both the `@auth-gate/rbac` and `@auth-gate/billing` CLIs to
+ * connect to the AuthGate API when syncing roles, permissions, plans, and
+ * features. The config file is auto-discovered in the project root.
  *
  * The CLI auto-loads `.env` and `.env.local` before importing this file,
- * so you can reference `process.env` or use a typed env module directly.
+ * so you can reference `process.env` directly.
+ */
+interface AuthGateProjectConfig {
+    /**
+     * Connection details for the AuthGate API.
+     *
+     * If omitted, the CLI falls back to `AUTHGATE_URL` and `AUTHGATE_API_KEY`
+     * environment variables.
+     */
+    connection?: AuthGateConnection;
+    /**
+     * Path to the RBAC config file (`authgate.rbac.ts`).
+     *
+     * Overrides auto-discovery. Useful in monorepos where the RBAC config
+     * lives in a different directory than the project root.
+     *
+     * @example `"./packages/api/authgate.rbac.ts"`
+     */
+    rbacConfig?: string;
+    /**
+     * Path to the Billing config file (`authgate.billing.ts`).
+     *
+     * Overrides auto-discovery. Useful in monorepos where the billing config
+     * lives in a different directory than the project root.
+     *
+     * @example `"./packages/api/authgate.billing.ts"`
+     */
+    billingConfig?: string;
+}
+/**
+ * Define your project-level AuthGate configuration.
  *
- * @example
+ * Create an `authgate.config.ts` file in your project root and export
+ * the result of this function as the default export. This gives you
+ * type safety and IDE autocomplete for the config.
+ *
+ * The CLI auto-loads `.env` and `.env.local` before importing the
+ * config, so `process.env` values are available.
+ *
+ * @param config - The project configuration object.
+ * @returns The same config object (identity function for type inference).
+ *
+ * @example Minimal setup (env vars provide connection details)
  * ```ts
+ * // authgate.config.ts
  * import { defineConfig } from "@auth-gate/core";
  *
  * export default defineConfig({
@@ -713,20 +768,33 @@ type AuthGateConnection = {
  *   },
  * });
  * ```
- */
-interface AuthGateProjectConfig {
-    /** Connection details for the AuthGate API. */
-    connection?: AuthGateConnection;
-    /** Path to the RBAC config file (overrides auto-discovery). */
-    rbacConfig?: string;
-    /** Path to the Billing config file (overrides auto-discovery). */
-    billingConfig?: string;
-}
-/**
- * Define your project-level AuthGate config. Use this in `authgate.config.ts`.
  *
- * Provides type safety and IDE autocomplete for the config file.
- * This is an identity function — it returns the config as-is.
+ * @example Monorepo with custom config paths
+ * ```ts
+ * // authgate.config.ts
+ * import { defineConfig } from "@auth-gate/core";
+ *
+ * export default defineConfig({
+ *   connection: {
+ *     baseUrl: process.env.AUTHGATE_URL,
+ *     apiKey: process.env.AUTHGATE_API_KEY,
+ *   },
+ *   rbacConfig: "./packages/api/authgate.rbac.ts",
+ *   billingConfig: "./packages/api/authgate.billing.ts",
+ * });
+ * ```
+ *
+ * @example Then sync with the CLI
+ * ```sh
+ * # Scaffold the config file
+ * npx @auth-gate/rbac init --config
+ *
+ * # Sync RBAC roles & permissions
+ * npx @auth-gate/rbac sync --apply
+ *
+ * # Sync billing plans & features
+ * npx @auth-gate/billing sync --apply
+ * ```
  */
 declare function defineConfig(config: AuthGateProjectConfig): AuthGateProjectConfig;
 

package/dist/index.d.ts

@@ -260,6 +260,7 @@ declare class AuthGateClient {
     getOAuthUrl(provider: OAuthProvider, callbackUrl: string, options?: {
         state?: string;
         linkTo?: string;
+        locale?: string;
     }): Promise<string>;
     /**
      * Register a new user with email and password.
@@ -272,6 +273,7 @@ declare class AuthGateClient {
         password: string;
         name?: string;
         callbackUrl: string;
+        locale?: string;
     }): Promise<Response>;
     /**
      * Sign in an existing user with email and password.
@@ -286,6 +288,7 @@ declare class AuthGateClient {
         email: string;
         password: string;
         callbackUrl: string;
+        locale?: string;
     }): Promise<Response>;
     /**
      * Send a password reset email to the user.
@@ -296,6 +299,7 @@ declare class AuthGateClient {
     emailForgotPassword(data: {
         email: string;
         callbackUrl: string;
+        locale?: string;
     }): Promise<Response>;
     /**
      * Confirm a password reset with the token from the reset email.
@@ -306,6 +310,7 @@ declare class AuthGateClient {
     emailResetPassword(data: {
         token: string;
         password: string;
+        locale?: string;
     }): Promise<Response>;
     /**
      * Send a magic link email for passwordless authentication.
@@ -316,6 +321,7 @@ declare class AuthGateClient {
     magicLinkSend(data: {
         email: string;
         callbackUrl: string;
+        locale?: string;
     }): Promise<Response>;
     /**
      * Verify an email address using a one-time code.
@@ -326,6 +332,7 @@ declare class AuthGateClient {
     emailVerifyCode(data: {
         email: string;
         code: string;
+        locale?: string;
     }): Promise<Response>;
     /**
      * Send an SMS verification code to the user's phone number.
@@ -690,6 +697,10 @@ declare class ConfigurationError extends AuthGateError {
 
 /**
  * Connection details for the AuthGate API.
+ *
+ * Both fields are optional at the type level because they can be provided
+ * via environment variables (`AUTHGATE_URL`, `AUTHGATE_API_KEY`). The CLI
+ * auto-loads `.env` and `.env.local` before importing the config file.
  */
 type AuthGateConnection = {
     baseUrl?: string;
@@ -697,13 +708,57 @@ type AuthGateConnection = {
 };
 /**
  * Project-level config shape for `authgate.config.ts`.
- * Used by both `@auth-gate/rbac` and `@auth-gate/billing` CLIs.
+ *
+ * Used by both the `@auth-gate/rbac` and `@auth-gate/billing` CLIs to
+ * connect to the AuthGate API when syncing roles, permissions, plans, and
+ * features. The config file is auto-discovered in the project root.
  *
  * The CLI auto-loads `.env` and `.env.local` before importing this file,
- * so you can reference `process.env` or use a typed env module directly.
+ * so you can reference `process.env` directly.
+ */
+interface AuthGateProjectConfig {
+    /**
+     * Connection details for the AuthGate API.
+     *
+     * If omitted, the CLI falls back to `AUTHGATE_URL` and `AUTHGATE_API_KEY`
+     * environment variables.
+     */
+    connection?: AuthGateConnection;
+    /**
+     * Path to the RBAC config file (`authgate.rbac.ts`).
+     *
+     * Overrides auto-discovery. Useful in monorepos where the RBAC config
+     * lives in a different directory than the project root.
+     *
+     * @example `"./packages/api/authgate.rbac.ts"`
+     */
+    rbacConfig?: string;
+    /**
+     * Path to the Billing config file (`authgate.billing.ts`).
+     *
+     * Overrides auto-discovery. Useful in monorepos where the billing config
+     * lives in a different directory than the project root.
+     *
+     * @example `"./packages/api/authgate.billing.ts"`
+     */
+    billingConfig?: string;
+}
+/**
+ * Define your project-level AuthGate configuration.
  *
- * @example
+ * Create an `authgate.config.ts` file in your project root and export
+ * the result of this function as the default export. This gives you
+ * type safety and IDE autocomplete for the config.
+ *
+ * The CLI auto-loads `.env` and `.env.local` before importing the
+ * config, so `process.env` values are available.
+ *
+ * @param config - The project configuration object.
+ * @returns The same config object (identity function for type inference).
+ *
+ * @example Minimal setup (env vars provide connection details)
  * ```ts
+ * // authgate.config.ts
  * import { defineConfig } from "@auth-gate/core";
  *
  * export default defineConfig({
@@ -713,20 +768,33 @@ type AuthGateConnection = {
  *   },
  * });
  * ```
- */
-interface AuthGateProjectConfig {
-    /** Connection details for the AuthGate API. */
-    connection?: AuthGateConnection;
-    /** Path to the RBAC config file (overrides auto-discovery). */
-    rbacConfig?: string;
-    /** Path to the Billing config file (overrides auto-discovery). */
-    billingConfig?: string;
-}
-/**
- * Define your project-level AuthGate config. Use this in `authgate.config.ts`.
  *
- * Provides type safety and IDE autocomplete for the config file.
- * This is an identity function — it returns the config as-is.
+ * @example Monorepo with custom config paths
+ * ```ts
+ * // authgate.config.ts
+ * import { defineConfig } from "@auth-gate/core";
+ *
+ * export default defineConfig({
+ *   connection: {
+ *     baseUrl: process.env.AUTHGATE_URL,
+ *     apiKey: process.env.AUTHGATE_API_KEY,
+ *   },
+ *   rbacConfig: "./packages/api/authgate.rbac.ts",
+ *   billingConfig: "./packages/api/authgate.billing.ts",
+ * });
+ * ```
+ *
+ * @example Then sync with the CLI
+ * ```sh
+ * # Scaffold the config file
+ * npx @auth-gate/rbac init --config
+ *
+ * # Sync RBAC roles & permissions
+ * npx @auth-gate/rbac sync --apply
+ *
+ * # Sync billing plans & features
+ * npx @auth-gate/billing sync --apply
+ * ```
  */
 declare function defineConfig(config: AuthGateProjectConfig): AuthGateProjectConfig;
 

package/dist/index.mjs

@@ -459,11 +459,11 @@ var AuthGateClient = class {
           Authorization: `Bearer ${this.config.apiKey}`,
           "Content-Type": "application/json"
         },
-        body: JSON.stringify({
+        body: JSON.stringify(__spreadValues({
           callback_url: callbackUrl,
           state: options == null ? void 0 : options.state,
           link_to: options == null ? void 0 : options.linkTo
-        })
+        }, (options == null ? void 0 : options.locale) && { locale: options.locale }))
       }
     );
     if (!response.ok) {
@@ -491,12 +491,12 @@ var AuthGateClient = class {
         Authorization: `Bearer ${this.config.apiKey}`,
         "Content-Type": "application/json"
       },
-      body: JSON.stringify({
+      body: JSON.stringify(__spreadValues({
         email: data.email,
         password: data.password,
         name: data.name,
         callback_url: data.callbackUrl
-      })
+      }, data.locale && { locale: data.locale }))
     });
   }
   /**
@@ -515,11 +515,11 @@ var AuthGateClient = class {
         Authorization: `Bearer ${this.config.apiKey}`,
         "Content-Type": "application/json"
       },
-      body: JSON.stringify({
+      body: JSON.stringify(__spreadValues({
         email: data.email,
         password: data.password,
         callback_url: data.callbackUrl
-      })
+      }, data.locale && { locale: data.locale }))
     });
   }
   /**
@@ -535,10 +535,10 @@ var AuthGateClient = class {
         Authorization: `Bearer ${this.config.apiKey}`,
         "Content-Type": "application/json"
       },
-      body: JSON.stringify({
+      body: JSON.stringify(__spreadValues({
         email: data.email,
         callback_url: data.callbackUrl
-      })
+      }, data.locale && { locale: data.locale }))
     });
   }
   /**
@@ -556,10 +556,10 @@ var AuthGateClient = class {
           Authorization: `Bearer ${this.config.apiKey}`,
           "Content-Type": "application/json"
         },
-        body: JSON.stringify({
+        body: JSON.stringify(__spreadValues({
           token: data.token,
           password: data.password
-        })
+        }, data.locale && { locale: data.locale }))
       }
     );
   }
@@ -579,10 +579,10 @@ var AuthGateClient = class {
         Authorization: `Bearer ${this.config.apiKey}`,
         "Content-Type": "application/json"
       },
-      body: JSON.stringify({
+      body: JSON.stringify(__spreadValues({
         email: data.email,
         callback_url: data.callbackUrl
-      })
+      }, data.locale && { locale: data.locale }))
     });
   }
   // ---------------------------------------------------------------------------
@@ -601,10 +601,10 @@ var AuthGateClient = class {
         Authorization: `Bearer ${this.config.apiKey}`,
         "Content-Type": "application/json"
       },
-      body: JSON.stringify({
+      body: JSON.stringify(__spreadValues({
         email: data.email,
         code: data.code
-      })
+      }, data.locale && { locale: data.locale }))
     });
   }
   // ---------------------------------------------------------------------------

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@auth-gate/core",
-  "version": "0.10.0",
+  "version": "0.12.0",
+  "description": "Core client library for AuthGate — the OAuth proxy that handles provider configuration, token exchange, and user normalization so you don't have to.",
   "type": "module",
   "exports": {
     ".": {