@gasboost/auth 0.5.0 → 0.6.0

package/README.md

@@ -258,6 +258,51 @@ User 検索
 Session 発行
 ```
 
+## Registration (without Session)
+
+`auth.registration` は、Session を発行せずに
+User と Account を登録するサーバー内部APIです。
+
+管理者によるユーザー登録など、
+登録対象ユーザーとしてサインインする必要がない場合に使用します。
+
+### Email / Password
+
+```ts
+const user = await auth.registration.email({
+  name: "Taro",
+  email: "taro@example.com",
+  password: temporaryPassword,
+});
+```
+
+### Apps Script
+
+```ts
+const user = await auth.registration.appsScript({
+  name: "Taro",
+});
+```
+
+Apps Script方式では
+`Session.getActiveUser().getEmail()` を使用するため、
+任意の他ユーザーを指定して登録することはできません。
+
+### Sign Upとの違い
+
+| API                              | User + Account | Session発行 |
+| -------------------------------- | -------------- | ----------- |
+| `auth.registration.email()`      | 作成           | なし        |
+| `auth.registration.appsScript()` | 作成           | なし        |
+| `auth.signUp.email()`            | 作成           | あり        |
+| `auth.signUp.appsScript()`       | 作成           | あり        |
+
+`isSignupEnabled: false` でも、
+認証方式自体が `enabled: true` ならRegistrationは利用できます。
+
+Registrationはメール送信やRole付与を行いません。
+呼び出し元で認証・認可を実施してください。
+
 ## Apps Script Sign Up
 
 Apps Script 認証では `Session.getActiveUser().getEmail()` を Identity として利用します。

package/dist/AppsScriptAuth.d.ts

@@ -1,4 +1,5 @@
 import { AppsScriptAuthPassword } from "./api/AppsScriptAuthPassword";
+import { AppsScriptAuthRegistration } from "./api/AppsScriptAuthRegistration";
 import { AppsScriptAuthSession } from "./api/AppsScriptAuthSession";
 import { AppsScriptAuthSignIn } from "./api/AppsScriptAuthSignIn";
 import { AppsScriptAuthSignOut } from "./api/AppsScriptAuthSignOut";
@@ -35,6 +36,7 @@ export declare class AppsScriptAuth<TEmailPassword extends EmailPasswordAuthOpti
     readonly session: AppsScriptAuthSession;
     readonly signOut: AppsScriptAuthSignOut;
     readonly password: AppsScriptAuthPasswordApi<TEmailPassword>;
+    readonly registration: AppsScriptAuthRegistration;
     constructor({ repository, session, runtime, emailPassword, appsScript, hooks, }: AppsScriptAuthConfig<TEmailPassword, THookResult>);
 }
 export {};

package/dist/AppsScriptAuth.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AppsScriptAuth = void 0;
 const AppsScriptAuthPassword_1 = require("./api/AppsScriptAuthPassword");
+const AppsScriptAuthRegistration_1 = require("./api/AppsScriptAuthRegistration");
 const AppsScriptAuthSession_1 = require("./api/AppsScriptAuthSession");
 const AppsScriptAuthSignIn_1 = require("./api/AppsScriptAuthSignIn");
 const AppsScriptAuthSignOut_1 = require("./api/AppsScriptAuthSignOut");
@@ -15,6 +16,7 @@ class AppsScriptAuth {
     session;
     signOut;
     password;
+    registration;
     constructor({ repository, session, runtime, emailPassword, appsScript, hooks, }) {
         const sessionStorage = (0, sessionStorageFactory_1.sessionStorageFactory)(session.storageType, {
             cacheService: runtime.cacheService,
@@ -61,6 +63,13 @@ class AppsScriptAuth {
                 emailPassword: emailPasswordConfig,
             })
             : undefined);
+        this.registration = new AppsScriptAuthRegistration_1.AppsScriptAuthRegistration({
+            emailPassword: emailPasswordConfig,
+            appsScript: appsScriptConfig,
+            repository,
+            utilities: runtime.utilities,
+            session: runtime.session,
+        });
     }
 }
 exports.AppsScriptAuth = AppsScriptAuth;

package/dist/api/AppsScriptAuthRegistration.d.ts

@@ -0,0 +1,19 @@
+import type { AppsScriptAuthenticationConfig } from "../authentication/AppsScriptAuthentication";
+import type { EmailPasswordAuthConfig } from "../authentication/EmailPasswordAuthentication";
+import type { User } from "../domain/User";
+import { type AppsScriptRegistrationInput } from "../registration/AppsScriptRegistration";
+import { type EmailPasswordRegistrationInput } from "../registration/EmailPasswordRegistration";
+import type { AppsScriptAuthRepository } from "../storage/AppsScriptAuthRepository";
+export declare class AppsScriptAuthRegistration {
+    private readonly emailPasswordRegistration?;
+    private readonly appsScriptRegistration?;
+    constructor({ emailPassword, appsScript, repository, utilities, session, }: {
+        emailPassword?: EmailPasswordAuthConfig;
+        appsScript?: AppsScriptAuthenticationConfig;
+        repository: AppsScriptAuthRepository;
+        utilities: GoogleAppsScript.Utilities.Utilities;
+        session: GoogleAppsScript.Base.Session;
+    });
+    email(input: EmailPasswordRegistrationInput): Promise<User>;
+    appsScript(input: AppsScriptRegistrationInput): Promise<User>;
+}

package/dist/api/AppsScriptAuthRegistration.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppsScriptAuthRegistration = void 0;
+const AppsScriptRegistration_1 = require("../registration/AppsScriptRegistration");
+const EmailPasswordRegistration_1 = require("../registration/EmailPasswordRegistration");
+class AppsScriptAuthRegistration {
+    emailPasswordRegistration;
+    appsScriptRegistration;
+    constructor({ emailPassword, appsScript, repository, utilities, session, }) {
+        if (emailPassword?.enabled) {
+            this.emailPasswordRegistration = new EmailPasswordRegistration_1.EmailPasswordRegistration(repository, utilities, emailPassword);
+        }
+        if (appsScript?.enabled) {
+            this.appsScriptRegistration = new AppsScriptRegistration_1.AppsScriptRegistration(utilities, session, repository);
+        }
+    }
+    async email(input) {
+        if (!this.emailPasswordRegistration) {
+            throw new Error("Email and password authentication is disabled");
+        }
+        return this.emailPasswordRegistration.register(input);
+    }
+    async appsScript(input) {
+        if (!this.appsScriptRegistration) {
+            throw new Error("Apps Script authentication is disabled");
+        }
+        return this.appsScriptRegistration.register(input);
+    }
+}
+exports.AppsScriptAuthRegistration = AppsScriptAuthRegistration;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gasboost/auth",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Modern authentication for Google Apps Script with email/password, Apps Script authentication, sessions, and password reset.",
   "keywords": [
     "google-apps-script",