@shisyamo4131/air-firebase-v2-client-adapter 2.1.1 → 2.1.3-dev.0

package/error.js

@@ -70,6 +70,11 @@ export const ERRORS = {
     message: "search string cannot be empty",
     userMessage: "検索文字列を入力してください",
   },
+  VALIDATION_FIELD_ERROR: {
+    code: "VALIDATION/FIELD_ERROR",
+    message: "validation failed",
+    userMessage: "入力内容に誤りがあります",
+  },
 
   // データベース操作エラー (DATABASE)
   DATABASE_DOCUMENT_NOT_FOUND: {

package/index.js

@@ -32,6 +32,7 @@ import { ClientAdapterError, ERRORS } from "./error.js";
 class ClientAdapter {
   static firestore = null;
   static auth = null;
+  static functions = null; // 2025-12-29 added
   static GeoPoint = null; // 2025-12-29 added
   static httpsCallable = null; // 2025-12-29 added
 
@@ -61,7 +62,7 @@ class ClientAdapter {
   get auth() {
     if (!ClientAdapter.auth) {
       throw new ClientAdapterError(
-        ERRORS.SYSTEM_AUTHENTICATION_NOT_INITIALIZED
+        ERRORS.SYSTEM_AUTHENTICATION_NOT_INITIALIZED,
       );
     }
     return ClientAdapter.auth;
@@ -80,13 +81,10 @@ class ClientAdapter {
 
   /**
    * Returns the Functions instance.
-   * - 2025-12-29 added
+   * - 2025-12-30 modified to return null if not initialized (instead of throwing error)
    */
   get functions() {
-    if (!ClientAdapter.functions) {
-      throw new ClientAdapterError(ERRORS.SYSTEM_FUNCTIONS_NOT_INITIALIZED);
-    }
-    return ClientAdapter.functions;
+    return ClientAdapter.functions; // ← null を返すように変更（エラーをスローしない）
   }
 
   /**
@@ -131,7 +129,7 @@ class ClientAdapter {
       const collectionPath = this.constructor.getCollectionPath(prefix);
       const colRef = collection(
         ClientAdapter.firestore,
-        collectionPath
+        collectionPath,
       ).withConverter(this.constructor.converter());
 
       return doc(colRef, docId);
@@ -173,7 +171,7 @@ class ClientAdapter {
       const docSnap = await transaction.get(docRef);
       if (!docSnap.exists()) {
         throw new ClientAdapterError(
-          ERRORS.BUSINESS_AUTONUMBER_DOCUMENT_NOT_FOUND
+          ERRORS.BUSINESS_AUTONUMBER_DOCUMENT_NOT_FOUND,
         );
       }
 
@@ -300,7 +298,7 @@ class ClientAdapter {
         const collectionPath = this.constructor.getCollectionPath(prefix);
         const colRef = collection(
           ClientAdapter.firestore,
-          collectionPath
+          collectionPath,
         ).withConverter(this.constructor.converter());
         const docRef = docId ? doc(colRef, docId) : doc(colRef);
 
@@ -334,9 +332,11 @@ class ClientAdapter {
     } catch (err) {
       if (err instanceof ClientAdapterError) {
         throw err;
+      } else if (err.name === "ValidationError") {
+        throw new ClientAdapterError(ERRORS.VALIDATION_FIELD_ERROR, err);
       } else {
         this._outputErrorConsole("create", err);
-        throw new ClientAdapterError(ERRORS.SYSTEM_UNKNOWN_ERROR);
+        throw new ClientAdapterError(ERRORS.SYSTEM_UNKNOWN_ERROR, err);
       }
     }
   }
@@ -363,7 +363,7 @@ class ClientAdapter {
       // Prepare document reference.
       const colRef = collection(
         ClientAdapter.firestore,
-        collectionPath
+        collectionPath,
       ).withConverter(this.constructor.converter());
       const docRef = doc(colRef, docId);
 
@@ -408,7 +408,7 @@ class ClientAdapter {
       // Prepare document reference.
       const colRef = collection(
         ClientAdapter.firestore,
-        collectionPath
+        collectionPath,
       ).withConverter(this.constructor.converter());
       const docRef = doc(colRef, docId);
 
@@ -450,7 +450,7 @@ class ClientAdapter {
         case "orderBy":
           if (!["asc", "desc"].includes(args[1] || "asc")) {
             throw new ClientAdapterError(
-              ERRORS.VALIDATION_INVALID_ORDERBY_DIRECTION
+              ERRORS.VALIDATION_INVALID_ORDERBY_DIRECTION,
             );
           }
           result.push(orderBy(args[0], args[1] || "asc"));
@@ -488,7 +488,7 @@ class ClientAdapter {
     // サロゲートペア文字（絵文字など）を除外
     const target = constraints.replace(
       /[\uD800-\uDBFF]|[\uDC00-\uDFFF]|~|\*|\[|\]|\s+/g,
-      ""
+      "",
     );
 
     // 1 文字・2 文字のトークンを生成
@@ -550,7 +550,7 @@ class ClientAdapter {
       const collectionPath = this.constructor.getCollectionPath(prefix);
       const colRef = collection(
         ClientAdapter.firestore,
-        collectionPath
+        collectionPath,
       ).withConverter(this.constructor.converter());
 
       const queryRef = query(colRef, ...queryConstraints);
@@ -604,7 +604,7 @@ class ClientAdapter {
       const collectionPath = this.constructor.getCollectionPath(prefix);
       const colRef = collection(
         ClientAdapter.firestore,
-        collectionPath
+        collectionPath,
       ).withConverter(this.constructor.converter());
 
       const querySnapshotArray = await Promise.all(
@@ -613,11 +613,11 @@ class ClientAdapter {
           return getDocs(q);
           /** transaction.get() が Query に対応した場合は以下を使用 */
           // return transaction ? transaction.get(q) : getDocs(q);
-        })
+        }),
       );
 
       return querySnapshotArray.flatMap((snapshot) =>
-        snapshot.docs.map((doc) => doc.data())
+        snapshot.docs.map((doc) => doc.data()),
       );
     } catch (err) {
       if (err instanceof ClientAdapterError) {
@@ -674,7 +674,7 @@ class ClientAdapter {
         const collectionPath = this.constructor.getCollectionPath(prefix);
         const colRef = collection(
           ClientAdapter.firestore,
-          collectionPath
+          collectionPath,
         ).withConverter(this.constructor.converter());
         const docRef = doc(colRef, this.docId);
 
@@ -694,9 +694,11 @@ class ClientAdapter {
     } catch (err) {
       if (err instanceof ClientAdapterError) {
         throw err;
+      } else if (err.name === "ValidationError") {
+        throw new ClientAdapterError(ERRORS.VALIDATION_FIELD_ERROR, err);
       } else {
         this._outputErrorConsole("update", err);
-        throw new ClientAdapterError(ERRORS.SYSTEM_UNKNOWN_ERROR);
+        throw new ClientAdapterError(ERRORS.SYSTEM_UNKNOWN_ERROR, err);
       }
     }
   }
@@ -832,7 +834,7 @@ class ClientAdapter {
           const sourceDocData = sourceDocSnap.data();
           const archiveColRef = collection(
             ClientAdapter.firestore,
-            `${collectionPath}_archive`
+            `${collectionPath}_archive`,
           );
           const archiveDocRef = doc(archiveColRef, this.docId);
           txn.set(archiveDocRef, sourceDocData);
@@ -911,7 +913,7 @@ class ClientAdapter {
       } else {
         return await runTransaction(
           ClientAdapter.firestore,
-          performTransaction
+          performTransaction,
         );
       }
     } catch (err) {
@@ -968,7 +970,7 @@ class ClientAdapter {
       // const colRef = collection(ClientAdapter.firestore, collectionPath);
       const colRef = collection(
         ClientAdapter.firestore,
-        collectionPath
+        collectionPath,
       ).withConverter(this.constructor.converter());
       const docRef = doc(colRef, docId);
       this.listener = onSnapshot(docRef, (docSnapshot) => {
@@ -1006,7 +1008,7 @@ class ClientAdapter {
       prefix = null,
       callback: deprecatedCallback = null,
     } = {},
-    callback = null
+    callback = null,
   ) {
     /**
      * [DEPRECATION NOTICE]
@@ -1015,13 +1017,13 @@ class ClientAdapter {
      */
     if (deprecatedCallback) {
       console.warn(
-        "[FireModel-subscribeDocs] The 'callback' parameter has been moved from the options object to a separate parameter. Please update your code accordingly."
+        "[FireModel-subscribeDocs] The 'callback' parameter has been moved from the options object to a separate parameter. Please update your code accordingly.",
       );
       if (!callback) {
         callback = deprecatedCallback;
       } else {
         console.warn(
-          "[FireModel-subscribeDocs] The 'callback' parameter was provided both in the options object and as a separate parameter. The separate parameter will take precedence."
+          "[FireModel-subscribeDocs] The 'callback' parameter was provided both in the options object and as a separate parameter. The separate parameter will take precedence.",
         );
       }
     }
@@ -1045,7 +1047,7 @@ class ClientAdapter {
       const collectionPath = this.constructor.getCollectionPath(prefix);
       const colRef = collection(
         ClientAdapter.firestore,
-        collectionPath
+        collectionPath,
       ).withConverter(this.constructor.converter());
       const queryRef = query(colRef, ...queryConstraints);
 
@@ -1053,7 +1055,7 @@ class ClientAdapter {
         snapshot.docChanges().forEach((change) => {
           const item = change.doc.data();
           const index = this.docs.findIndex(
-            ({ docId }) => docId === item.docId
+            ({ docId }) => docId === item.docId,
           );
           if (change.type === "added") this.docs.push(item);
           if (change.type === "modified") this.docs.splice(index, 1, item);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shisyamo4131/air-firebase-v2-client-adapter",
-  "version": "2.1.1",
+  "version": "2.1.3-dev.0",
   "description": "client adapter for FireModel",
   "type": "module",
   "main": "index.js",