@shisyamo4131/air-firebase-v2-client-adapter 1.0.1 → 2.0.0

package/index.js

@@ -15,7 +15,6 @@ import {
   collectionGroup,
   onSnapshot,
   getFirestore,
-  increment as FieldValue_increment,
 } from "firebase/firestore";
 import { getAuth } from "firebase/auth";
 import { ClientAdapterError, ERRORS } from "./error.js";
@@ -69,6 +68,40 @@ class ClientAdapter {
     return ClientAdapter.firestore;
   }
 
+  /**
+   * 指定されたドキュメントIDからFirestoreのドキュメント参照を取得します。
+   * - コンバーターを適用したDocumentReferenceを返します。
+   * - このメソッドはFireModelクラスから静的に呼び出されることを想定しています。
+   *
+   * @param {Object} args - パラメータオブジェクト
+   * @param {string} args.docId - ドキュメントID（必須）
+   * @param {string|null} [args.prefix=null] - パスのプレフィックス（任意）
+   * @returns {DocumentReference} Firestoreのドキュメント参照
+   * @throws {Error} `docId` が指定されていない場合
+   */
+  getDocRef({ docId, prefix = null } = {}) {
+    if (!docId) {
+      throw new ClientAdapterError(ERRORS.VALIDATION_MISSING_DOC_ID);
+    }
+
+    try {
+      const collectionPath = this.constructor.getCollectionPath(prefix);
+      const colRef = collection(
+        ClientAdapter.firestore,
+        collectionPath
+      ).withConverter(this.constructor.converter());
+
+      return doc(colRef, docId);
+    } catch (err) {
+      if (err instanceof ClientAdapterError) {
+        throw err;
+      } else {
+        this._outputErrorConsole("getDocRef", err);
+        throw new ClientAdapterError(ERRORS.SYSTEM_UNKNOWN_ERROR);
+      }
+    }
+  }
+
   /**
    * Assigns an autonumber to the instance using a Firestore transaction.
    * - Retrieves the current autonumber doc from the `Autonumbers` collection.
@@ -991,6 +1024,15 @@ class ClientAdapter {
       }
     }
   }
+
+  /**
+   * Firestore トランザクションを実行します。
+   * @param {Function} updateFunction - トランザクション内で実行する関数
+   * @returns {Promise<any>} トランザクションの結果
+   */
+  async runTransaction(updateFunction) {
+    return await runTransaction(this.firestore, updateFunction);
+  }
 }
 
 export default ClientAdapter;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shisyamo4131/air-firebase-v2-client-adapter",
-  "version": "1.0.1",
+  "version": "2.0.0",
   "description": "client adapter for FireModel",
   "type": "module",
   "main": "index.js",
@@ -23,6 +23,12 @@
     "type": "git",
     "url": "https://github.com/shisyamo4131/air-firebase-v2-client-adapter.git"
   },
+  "scripts": {
+    "dev:publish": "npm version prerelease --preid=dev && npm publish --tag dev",
+    "release:patch": "npm version patch && npm publish",
+    "release:minor": "npm version minor && npm publish",
+    "release:major": "npm version major && npm publish"
+  },
   "publishConfig": {
     "access": "public"
   },