firebase-rest-firestore 0.1.0 → 0.2.1

package/dist/client.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FirestoreClient = void 0;
+exports.WriteResult = exports.DocumentSnapshot = exports.QuerySnapshot = exports.Query = exports.DocumentReference = exports.CollectionReference = exports.FirestoreClient = void 0;
 exports.createFirestoreClient = createFirestoreClient;
 const auth_1 = require("./utils/auth");
 const converter_1 = require("./utils/converter");
@@ -16,7 +16,19 @@ class FirestoreClient {
     constructor(config) {
         this.token = null;
         this.tokenExpiry = 0;
+        this.configChecked = false;
         this.config = config;
+        // ビルド時にはチェックを行わない
+        // 実際の操作時に遅延チェックを行う
+    }
+    /**
+     * 設定パラメータをチェック
+     * @private
+     */
+    checkConfig() {
+        if (this.configChecked) {
+            return;
+        }
         // 必須パラメータのチェック
         const requiredParams = [
             "projectId",
@@ -27,11 +39,14 @@ class FirestoreClient {
         if (missingParams.length > 0) {
             throw new Error(`Missing required Firestore configuration parameters: ${missingParams.join(", ")}`);
         }
+        this.configChecked = true;
     }
     /**
      * 認証トークンを取得（キャッシュあり）
      */
     async getToken() {
+        // 操作前に設定をチェック
+        this.checkConfig();
         const now = Date.now();
         // トークンが期限切れか未取得の場合は新しく取得
         if (!this.token || now >= this.tokenExpiry) {
@@ -41,6 +56,30 @@ class FirestoreClient {
         }
         return this.token;
     }
+    /**
+     * コレクションリファレンスを取得
+     * @param path コレクションパス
+     * @returns CollectionReferenceインスタンス
+     */
+    collection(path) {
+        // 設定チェックは実際の操作時に行われる
+        return new CollectionReference(this, path);
+    }
+    /**
+     * ドキュメントリファレンスを取得
+     * @param path ドキュメントパス
+     * @returns DocumentReferenceインスタンス
+     */
+    doc(path) {
+        // 設定チェックは実際の操作時に行われる
+        const parts = path.split("/");
+        if (parts.length % 2 === 0) {
+            throw new Error("Invalid document path. Document path must point to a document, not a collection.");
+        }
+        const collectionPath = parts.slice(0, parts.length - 1).join("/");
+        const docId = parts[parts.length - 1];
+        return new DocumentReference(this, collectionPath, docId);
+    }
     /**
      * Firestoreにドキュメントを作成
      * @param collectionName コレクション名
@@ -48,6 +87,8 @@ class FirestoreClient {
      * @returns 作成されたドキュメント
      */
     async create(collectionName, data) {
+        // 操作前に設定をチェック
+        this.checkConfig();
         const url = (0, path_1.getFirestoreBasePath)(this.config.projectId, collectionName);
         const firestoreData = (0, converter_1.convertToFirestoreDocument)(data);
         const token = await this.getToken();
@@ -72,6 +113,8 @@ class FirestoreClient {
      * @returns 取得したドキュメント（存在しない場合はnull）
      */
     async get(collectionName, documentId) {
+        // 操作前に設定をチェック
+        this.checkConfig();
         const url = `${(0, path_1.getFirestoreBasePath)(this.config.projectId, collectionName)}/${documentId}`;
         const token = await this.getToken();
         const response = await fetch(url, {
@@ -97,6 +140,8 @@ class FirestoreClient {
      * @returns 更新されたドキュメント
      */
     async update(collectionName, documentId, data) {
+        // 操作前に設定をチェック
+        this.checkConfig();
         const url = `${(0, path_1.getFirestoreBasePath)(this.config.projectId, collectionName)}/${documentId}`;
         const firestoreData = (0, converter_1.convertToFirestoreDocument)(data);
         const token = await this.getToken();
@@ -121,6 +166,8 @@ class FirestoreClient {
      * @returns 削除成功時はtrue
      */
     async delete(collectionName, documentId) {
+        // 操作前に設定をチェック
+        this.checkConfig();
         const url = `${(0, path_1.getFirestoreBasePath)(this.config.projectId, collectionName)}/${documentId}`;
         const token = await this.getToken();
         const response = await fetch(url, {
@@ -141,6 +188,8 @@ class FirestoreClient {
      * @returns 検索結果のドキュメント配列
      */
     async query(collectionName, options = {}) {
+        // 操作前に設定をチェック
+        this.checkConfig();
         const url = `${(0, path_1.getFirestoreBasePath)(this.config.projectId, collectionName)}:runQuery`;
         // クエリ構築
         const structuredQuery = {
@@ -166,7 +215,7 @@ class FirestoreClient {
             structuredQuery.orderBy = [
                 {
                     field: { fieldPath: options.orderBy },
-                    direction: "ASCENDING",
+                    direction: options.orderDirection || "ASCENDING",
                 },
             ];
         }
@@ -199,6 +248,416 @@ class FirestoreClient {
     }
 }
 exports.FirestoreClient = FirestoreClient;
+/**
+ * コレクションリファレンスクラス
+ */
+class CollectionReference {
+    constructor(client, path) {
+        this.client = client;
+        this.path = path;
+        this._queryConstraints = {
+            where: [],
+        };
+    }
+    /**
+     * ドキュメントリファレンスを取得
+     * @param documentPath ドキュメントID（省略時は自動生成）
+     * @returns DocumentReferenceインスタンス
+     */
+    doc(documentPath) {
+        const docId = documentPath || this._generateId();
+        return new DocumentReference(this.client, this.path, docId);
+    }
+    /**
+     * ドキュメントを追加（IDは自動生成）
+     * @param data ドキュメントデータ
+     * @returns 作成されたドキュメントのリファレンス
+     */
+    async add(data) {
+        const result = await this.client.create(this.path, data);
+        const docId = result.id;
+        return new DocumentReference(this.client, this.path, docId);
+    }
+    /**
+     * フィルター条件を追加
+     * @param fieldPath フィールドパス
+     * @param opStr 演算子
+     * @param value 値
+     * @returns Queryインスタンス
+     */
+    where(fieldPath, opStr, value) {
+        const query = new Query(this.client, this.path, {
+            ...this._queryConstraints,
+        });
+        // 演算子の変換
+        let firestoreOp;
+        switch (opStr) {
+            case "==":
+                firestoreOp = "EQUAL";
+                break;
+            case "!=":
+                firestoreOp = "NOT_EQUAL";
+                break;
+            case "<":
+                firestoreOp = "LESS_THAN";
+                break;
+            case "<=":
+                firestoreOp = "LESS_THAN_OR_EQUAL";
+                break;
+            case ">":
+                firestoreOp = "GREATER_THAN";
+                break;
+            case ">=":
+                firestoreOp = "GREATER_THAN_OR_EQUAL";
+                break;
+            case "array-contains":
+                firestoreOp = "ARRAY_CONTAINS";
+                break;
+            case "in":
+                firestoreOp = "IN";
+                break;
+            case "array-contains-any":
+                firestoreOp = "ARRAY_CONTAINS_ANY";
+                break;
+            case "not-in":
+                firestoreOp = "NOT_IN";
+                break;
+            default:
+                firestoreOp = opStr;
+        }
+        query._queryConstraints.where.push({
+            field: fieldPath,
+            op: firestoreOp,
+            value,
+        });
+        return query;
+    }
+    /**
+     * 並べ替え条件を追加
+     * @param fieldPath フィールドパス
+     * @param directionStr 並べ替え方向（'asc'または'desc'）
+     * @returns Queryインスタンス
+     */
+    orderBy(fieldPath, directionStr = "asc") {
+        const query = new Query(this.client, this.path, {
+            ...this._queryConstraints,
+        });
+        query._queryConstraints.orderBy = fieldPath;
+        query._queryConstraints.orderDirection =
+            directionStr === "asc" ? "ASCENDING" : "DESCENDING";
+        return query;
+    }
+    /**
+     * 取得件数の制限を設定
+     * @param limit 最大件数
+     * @returns Queryインスタンス
+     */
+    limit(limit) {
+        const query = new Query(this.client, this.path, {
+            ...this._queryConstraints,
+        });
+        query._queryConstraints.limit = limit;
+        return query;
+    }
+    /**
+     * スキップ件数を設定
+     * @param offset スキップ件数
+     * @returns Queryインスタンス
+     */
+    offset(offset) {
+        const query = new Query(this.client, this.path, {
+            ...this._queryConstraints,
+        });
+        query._queryConstraints.offset = offset;
+        return query;
+    }
+    /**
+     * クエリを実行
+     * @returns QuerySnapshotインスタンス
+     */
+    async get() {
+        const results = await this.client.query(this.path, this._queryConstraints);
+        return new QuerySnapshot(results);
+    }
+    /**
+     * ランダムなIDを生成
+     * @returns ランダムなID
+     */
+    _generateId() {
+        // 20文字のランダムなIDを生成
+        const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+        let id = "";
+        for (let i = 0; i < 20; i++) {
+            id += chars.charAt(Math.floor(Math.random() * chars.length));
+        }
+        return id;
+    }
+}
+exports.CollectionReference = CollectionReference;
+/**
+ * ドキュメントリファレンスクラス
+ */
+class DocumentReference {
+    constructor(client, collectionPath, docId) {
+        this.client = client;
+        this.collectionPath = collectionPath;
+        this.docId = docId;
+    }
+    /**
+     * ドキュメントIDを取得
+     */
+    get id() {
+        return this.docId;
+    }
+    /**
+     * ドキュメントのパスを取得
+     */
+    get path() {
+        return `${this.collectionPath}/${this.docId}`;
+    }
+    /**
+     * サブコレクションを取得
+     * @param collectionPath サブコレクション名
+     * @returns CollectionReferenceインスタンス
+     */
+    collection(collectionPath) {
+        return new CollectionReference(this.client, `${this.path}/${collectionPath}`);
+    }
+    /**
+     * ドキュメントを取得
+     * @returns DocumentSnapshotインスタンス
+     */
+    async get() {
+        const data = await this.client.get(this.collectionPath, this.docId);
+        return new DocumentSnapshot(this.docId, data);
+    }
+    /**
+     * ドキュメントを作成または上書き
+     * @param data ドキュメントデータ
+     * @param options オプション（mergeは現在サポートされていません）
+     * @returns WriteResultインスタンス
+     */
+    async set(data, options) {
+        // 既存のドキュメントを取得
+        const existingDoc = await this.client.get(this.collectionPath, this.docId);
+        if (existingDoc) {
+            // 既存のドキュメントがある場合は更新
+            const mergedData = options?.merge ? { ...existingDoc, ...data } : data;
+            await this.client.update(this.collectionPath, this.docId, mergedData);
+        }
+        else {
+            // 新規作成
+            const newData = { ...data, id: this.docId };
+            await this.client.create(this.collectionPath, newData);
+        }
+        return new WriteResult();
+    }
+    /**
+     * ドキュメントを更新
+     * @param data 更新データ
+     * @returns WriteResultインスタンス
+     */
+    async update(data) {
+        await this.client.update(this.collectionPath, this.docId, data);
+        return new WriteResult();
+    }
+    /**
+     * ドキュメントを削除
+     * @returns WriteResultインスタンス
+     */
+    async delete() {
+        await this.client.delete(this.collectionPath, this.docId);
+        return new WriteResult();
+    }
+}
+exports.DocumentReference = DocumentReference;
+/**
+ * クエリクラス
+ */
+class Query {
+    constructor(client, collectionPath, constraints) {
+        this.client = client;
+        this.collectionPath = collectionPath;
+        this._queryConstraints = constraints;
+    }
+    /**
+     * フィルター条件を追加
+     * @param fieldPath フィールドパス
+     * @param opStr 演算子
+     * @param value 値
+     * @returns Queryインスタンス
+     */
+    where(fieldPath, opStr, value) {
+        const query = new Query(this.client, this.collectionPath, {
+            ...this._queryConstraints,
+        });
+        // 演算子の変換
+        let firestoreOp;
+        switch (opStr) {
+            case "==":
+                firestoreOp = "EQUAL";
+                break;
+            case "!=":
+                firestoreOp = "NOT_EQUAL";
+                break;
+            case "<":
+                firestoreOp = "LESS_THAN";
+                break;
+            case "<=":
+                firestoreOp = "LESS_THAN_OR_EQUAL";
+                break;
+            case ">":
+                firestoreOp = "GREATER_THAN";
+                break;
+            case ">=":
+                firestoreOp = "GREATER_THAN_OR_EQUAL";
+                break;
+            case "array-contains":
+                firestoreOp = "ARRAY_CONTAINS";
+                break;
+            case "in":
+                firestoreOp = "IN";
+                break;
+            case "array-contains-any":
+                firestoreOp = "ARRAY_CONTAINS_ANY";
+                break;
+            case "not-in":
+                firestoreOp = "NOT_IN";
+                break;
+            default:
+                firestoreOp = opStr;
+        }
+        query._queryConstraints.where.push({
+            field: fieldPath,
+            op: firestoreOp,
+            value,
+        });
+        return query;
+    }
+    /**
+     * 並べ替え条件を追加
+     * @param fieldPath フィールドパス
+     * @param directionStr 並べ替え方向（'asc'または'desc'）
+     * @returns Queryインスタンス
+     */
+    orderBy(fieldPath, directionStr = "asc") {
+        const query = new Query(this.client, this.collectionPath, {
+            ...this._queryConstraints,
+        });
+        query._queryConstraints.orderBy = fieldPath;
+        query._queryConstraints.orderDirection =
+            directionStr === "asc" ? "ASCENDING" : "DESCENDING";
+        return query;
+    }
+    /**
+     * 取得件数の制限を設定
+     * @param limit 最大件数
+     * @returns Queryインスタンス
+     */
+    limit(limit) {
+        const query = new Query(this.client, this.collectionPath, {
+            ...this._queryConstraints,
+        });
+        query._queryConstraints.limit = limit;
+        return query;
+    }
+    /**
+     * スキップ件数を設定
+     * @param offset スキップ件数
+     * @returns Queryインスタンス
+     */
+    offset(offset) {
+        const query = new Query(this.client, this.collectionPath, {
+            ...this._queryConstraints,
+        });
+        query._queryConstraints.offset = offset;
+        return query;
+    }
+    /**
+     * クエリを実行
+     * @returns QuerySnapshotインスタンス
+     */
+    async get() {
+        const results = await this.client.query(this.collectionPath, this._queryConstraints);
+        return new QuerySnapshot(results);
+    }
+}
+exports.Query = Query;
+/**
+ * クエリ結果クラス
+ */
+class QuerySnapshot {
+    constructor(results) {
+        this._docs = results.map(doc => {
+            const { id, ...data } = doc;
+            return new DocumentSnapshot(id, data);
+        });
+    }
+    /**
+     * 結果のドキュメント配列
+     */
+    get docs() {
+        return this._docs;
+    }
+    /**
+     * 結果が空かどうか
+     */
+    get empty() {
+        return this._docs.length === 0;
+    }
+    /**
+     * 結果の件数
+     */
+    get size() {
+        return this._docs.length;
+    }
+    /**
+     * 各ドキュメントに対してコールバックを実行
+     * @param callback 各ドキュメントに対して実行するコールバック関数
+     */
+    forEach(callback) {
+        this._docs.forEach(callback);
+    }
+}
+exports.QuerySnapshot = QuerySnapshot;
+/**
+ * ドキュメントスナップショットクラス
+ */
+class DocumentSnapshot {
+    constructor(id, data) {
+        this._id = id;
+        this._data = data;
+    }
+    /**
+     * ドキュメントID
+     */
+    get id() {
+        return this._id;
+    }
+    /**
+     * ドキュメントが存在するかどうか
+     */
+    get exists() {
+        return this._data !== null;
+    }
+    /**
+     * ドキュメントデータを取得
+     * @returns ドキュメントデータ（存在しない場合はundefined）
+     */
+    data() {
+        return this._data || undefined;
+    }
+}
+exports.DocumentSnapshot = DocumentSnapshot;
+/**
+ * 書き込み結果クラス
+ */
+class WriteResult {
+    constructor() {
+        this.writeTime = new Date();
+    }
+}
+exports.WriteResult = WriteResult;
 /**
  * 新しいFirestoreクライアントインスタンスを作成
  * @param config Firestore設定オブジェクト

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export * from "./types";
-import { FirestoreClient, createFirestoreClient } from "./client";
+import { FirestoreClient, createFirestoreClient, CollectionReference, DocumentReference, Query, QuerySnapshot, DocumentSnapshot, WriteResult } from "./client";
 export { getFirestoreToken } from "./utils/auth";
 export { convertToFirestoreValue, convertFromFirestoreValue, convertToFirestoreDocument, convertFromFirestoreDocument, } from "./utils/converter";
 export { getFirestoreBasePath, getDocumentId } from "./utils/path";
-export { FirestoreClient, createFirestoreClient };
+export { FirestoreClient, createFirestoreClient, CollectionReference, DocumentReference, Query, QuerySnapshot, DocumentSnapshot, WriteResult, };

package/dist/index.js

@@ -14,13 +14,19 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createFirestoreClient = exports.FirestoreClient = exports.getDocumentId = exports.getFirestoreBasePath = exports.convertFromFirestoreDocument = exports.convertToFirestoreDocument = exports.convertFromFirestoreValue = exports.convertToFirestoreValue = exports.getFirestoreToken = void 0;
+exports.WriteResult = exports.DocumentSnapshot = exports.QuerySnapshot = exports.Query = exports.DocumentReference = exports.CollectionReference = exports.createFirestoreClient = exports.FirestoreClient = exports.getDocumentId = exports.getFirestoreBasePath = exports.convertFromFirestoreDocument = exports.convertToFirestoreDocument = exports.convertFromFirestoreValue = exports.convertToFirestoreValue = exports.getFirestoreToken = void 0;
 // 型定義のエクスポート
 __exportStar(require("./types"), exports);
 // クライアントのエクスポート
 const client_1 = require("./client");
 Object.defineProperty(exports, "FirestoreClient", { enumerable: true, get: function () { return client_1.FirestoreClient; } });
 Object.defineProperty(exports, "createFirestoreClient", { enumerable: true, get: function () { return client_1.createFirestoreClient; } });
+Object.defineProperty(exports, "CollectionReference", { enumerable: true, get: function () { return client_1.CollectionReference; } });
+Object.defineProperty(exports, "DocumentReference", { enumerable: true, get: function () { return client_1.DocumentReference; } });
+Object.defineProperty(exports, "Query", { enumerable: true, get: function () { return client_1.Query; } });
+Object.defineProperty(exports, "QuerySnapshot", { enumerable: true, get: function () { return client_1.QuerySnapshot; } });
+Object.defineProperty(exports, "DocumentSnapshot", { enumerable: true, get: function () { return client_1.DocumentSnapshot; } });
+Object.defineProperty(exports, "WriteResult", { enumerable: true, get: function () { return client_1.WriteResult; } });
 // ユーティリティ関数のエクスポート
 var auth_1 = require("./utils/auth");
 Object.defineProperty(exports, "getFirestoreToken", { enumerable: true, get: function () { return auth_1.getFirestoreToken; } });

package/dist/types.d.ts

@@ -58,6 +58,7 @@ export interface QueryOptions {
         value: any;
     }>;
     orderBy?: string;
+    orderDirection?: string;
     limit?: number;
     offset?: number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-rest-firestore",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Firebase Firestore REST API client for Edge runtime environments",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",