firebase-rest-firestore 0.1.0

package/dist/esm/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Firestoreの認証トークンを取得する関数
+ */
+export declare function getFirestoreToken(): Promise<string>;
+/**
+ * Firestoreクライアントクラス
+ */
+export declare class FirestoreClient {
+    private token;
+    private tokenExpiry;
+    /**
+     * 認証トークンを取得（キャッシュあり）
+     */
+    private getToken;
+    /**
+     * Firestoreにドキュメントを作成
+     */
+    create(collectionName: string, data: Record<string, any>): Promise<Record<string, any> & {
+        id: string;
+    }>;
+    /**
+     * ドキュメントを取得
+     */
+    get(collectionName: string, documentId: string): Promise<(Record<string, any> & {
+        id: string;
+    }) | null>;
+    /**
+     * ドキュメントを更新
+     */
+    update(collectionName: string, documentId: string, data: Record<string, any>): Promise<Record<string, any> & {
+        id: string;
+    }>;
+    /**
+     * ドキュメントを削除
+     */
+    delete(collectionName: string, documentId: string): Promise<boolean>;
+    /**
+     * コレクションのドキュメントを検索
+     */
+    query(collectionName: string, options?: {
+        where?: Array<{
+            field: string;
+            op: string;
+            value: any;
+        }>;
+        orderBy?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<(Record<string, any> & {
+        id: string;
+    })[]>;
+}
+export declare const firestore: FirestoreClient;
+export declare function saveToFirestore(collectionName: string, data: Record<string, any>): Promise<{
+    documentId: string;
+    result: Record<string, any> & {
+        id: string;
+    };
+}>;

package/dist/esm/index.js

@@ -0,0 +1,349 @@
+import * as jose from "jose";
+// Firestore関連の定数
+const FIREBASE_PROJECT_ID = process.env.FIREBASE_PROJECT_ID;
+const FIREBASE_PRIVATE_KEY_ID = process.env.FIREBASE_PRIVATE_KEY_ID;
+const FIREBASE_PRIVATE_KEY = process.env.FIREBASE_PRIVATE_KEY?.replace(/\\n/g, "\n");
+const FIREBASE_CLIENT_EMAIL = process.env.FIREBASE_CLIENT_EMAIL;
+const FIREBASE_CLIENT_ID = process.env.FIREBASE_CLIENT_ID;
+const FIREBASE_CLIENT_CERT_URL = process.env.FIREBASE_CLIENT_CERT_URL;
+// サービスアカウント情報
+const serviceAccount = {
+    type: "service_account",
+    project_id: FIREBASE_PROJECT_ID,
+    private_key_id: FIREBASE_PRIVATE_KEY_ID,
+    private_key: FIREBASE_PRIVATE_KEY,
+    client_email: FIREBASE_CLIENT_EMAIL,
+    client_id: FIREBASE_CLIENT_ID,
+    auth_uri: "https://accounts.google.com/o/oauth2/auth",
+    token_uri: "https://oauth2.googleapis.com/token",
+    auth_provider_x509_cert_url: "https://www.googleapis.com/oauth2/v1/certs",
+    client_x509_cert_url: FIREBASE_CLIENT_CERT_URL,
+};
+// Firestoreのベースパス
+const getFirestoreBasePath = (collectionName) => {
+    const basePath = `https://firestore.googleapis.com/v1/projects/${FIREBASE_PROJECT_ID}/databases/(default)/documents`;
+    return collectionName ? `${basePath}/${collectionName}` : basePath;
+};
+/**
+ * JSの値をFirestore形式に変換する
+ */
+function convertToFirestoreValue(value) {
+    if (value instanceof Date) {
+        return { timestampValue: value.toISOString() };
+    }
+    else if (typeof value === "string") {
+        return { stringValue: value };
+    }
+    else if (typeof value === "number") {
+        return Number.isInteger(value)
+            ? { integerValue: value }
+            : { doubleValue: value };
+    }
+    else if (typeof value === "boolean") {
+        return { booleanValue: value };
+    }
+    else if (value === null || value === undefined) {
+        return { nullValue: null };
+    }
+    else if (Array.isArray(value)) {
+        return {
+            arrayValue: {
+                values: value.map(item => convertToFirestoreValue(item)),
+            },
+        };
+    }
+    else if (typeof value === "object") {
+        const fields = Object.entries(value).reduce((acc, [key, val]) => ({
+            ...acc,
+            [key]: convertToFirestoreValue(val),
+        }), {});
+        return { mapValue: { fields } };
+    }
+    // デフォルトは文字列化
+    return { stringValue: String(value) };
+}
+/**
+ * Firestore形式からJSの値に変換する
+ */
+function convertFromFirestoreValue(firestoreValue) {
+    if ("stringValue" in firestoreValue) {
+        return firestoreValue.stringValue;
+    }
+    else if ("integerValue" in firestoreValue) {
+        return Number(firestoreValue.integerValue);
+    }
+    else if ("doubleValue" in firestoreValue) {
+        return firestoreValue.doubleValue;
+    }
+    else if ("booleanValue" in firestoreValue) {
+        return firestoreValue.booleanValue;
+    }
+    else if ("nullValue" in firestoreValue) {
+        return null;
+    }
+    else if ("timestampValue" in firestoreValue) {
+        return new Date(firestoreValue.timestampValue);
+    }
+    else if ("mapValue" in firestoreValue && firestoreValue.mapValue.fields) {
+        return Object.entries(firestoreValue.mapValue.fields).reduce((acc, [key, val]) => ({
+            ...acc,
+            [key]: convertFromFirestoreValue(val),
+        }), {});
+    }
+    else if ("arrayValue" in firestoreValue &&
+        firestoreValue.arrayValue.values) {
+        return firestoreValue.arrayValue.values.map(convertFromFirestoreValue);
+    }
+    return null;
+}
+/**
+ * オブジェクトをFirestoreドキュメント形式に変換
+ */
+function convertToFirestoreDocument(data) {
+    return {
+        fields: Object.entries(data).reduce((acc, [key, value]) => ({
+            ...acc,
+            [key]: convertToFirestoreValue(value),
+        }), {}),
+    };
+}
+/**
+ * Firestoreドキュメントをオブジェクトに変換
+ */
+function convertFromFirestoreDocument(doc) {
+    if (!doc.fields)
+        return { id: getDocumentId(doc.name) };
+    const result = Object.entries(doc.fields).reduce((acc, [key, value]) => ({
+        ...acc,
+        [key]: convertFromFirestoreValue(value),
+    }), {});
+    return {
+        ...result,
+        id: getDocumentId(doc.name),
+    };
+}
+/**
+ * ドキュメントパスからIDを抽出
+ */
+function getDocumentId(path) {
+    if (!path)
+        return "";
+    const pathParts = path.split("/");
+    return pathParts[pathParts.length - 1];
+}
+// JWT（JSON Web Token）を作成する関数
+async function createJWT(serviceAccount) {
+    const now = Math.floor(Date.now() / 1000);
+    const payload = {
+        iss: serviceAccount.client_email,
+        sub: serviceAccount.client_email,
+        aud: "https://oauth2.googleapis.com/token",
+        iat: now,
+        exp: now + 3600, // 1時間後に期限切れ
+        scope: "https://www.googleapis.com/auth/datastore",
+    };
+    try {
+        // 秘密鍵をインポート
+        const privateKey = await jose.importPKCS8(serviceAccount.private_key, "RS256");
+        // JWTを作成
+        const token = await new jose.SignJWT(payload)
+            .setProtectedHeader({
+            alg: "RS256",
+            kid: serviceAccount.private_key_id,
+            typ: "JWT",
+        })
+            .sign(privateKey);
+        return token;
+    }
+    catch (error) {
+        console.error("JWT作成エラー:", error);
+        throw error;
+    }
+}
+/**
+ * Firestoreの認証トークンを取得する関数
+ */
+export async function getFirestoreToken() {
+    // トークンを取得するためのリクエスト
+    const response = await fetch("https://oauth2.googleapis.com/token", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            grant_type: "urn:ietf:params:oauth:grant-type:jwt-bearer",
+            assertion: await createJWT(serviceAccount),
+        }),
+    });
+    const data = (await response.json());
+    return data.access_token;
+}
+/**
+ * Firestoreクライアントクラス
+ */
+export class FirestoreClient {
+    constructor() {
+        this.token = null;
+        this.tokenExpiry = 0;
+    }
+    /**
+     * 認証トークンを取得（キャッシュあり）
+     */
+    async getToken() {
+        const now = Date.now();
+        // トークンが期限切れか未取得の場合は新しく取得
+        if (!this.token || now >= this.tokenExpiry) {
+            this.token = await getFirestoreToken();
+            // 50分後に期限切れとする（実際は1時間）
+            this.tokenExpiry = now + 50 * 60 * 1000;
+        }
+        return this.token;
+    }
+    /**
+     * Firestoreにドキュメントを作成
+     */
+    async create(collectionName, data) {
+        const url = getFirestoreBasePath(collectionName);
+        const firestoreData = convertToFirestoreDocument(data);
+        const token = await this.getToken();
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${token}`,
+            },
+            body: JSON.stringify(firestoreData),
+        });
+        if (!response.ok) {
+            throw new Error(`Firestore API error: ${response.statusText}`);
+        }
+        const result = (await response.json());
+        return convertFromFirestoreDocument(result);
+    }
+    /**
+     * ドキュメントを取得
+     */
+    async get(collectionName, documentId) {
+        const url = `${getFirestoreBasePath(collectionName)}/${documentId}`;
+        const token = await this.getToken();
+        const response = await fetch(url, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${token}`,
+            },
+        });
+        if (response.status === 404) {
+            return null;
+        }
+        if (!response.ok) {
+            throw new Error(`Firestore API error: ${response.statusText}`);
+        }
+        const result = (await response.json());
+        return convertFromFirestoreDocument(result);
+    }
+    /**
+     * ドキュメントを更新
+     */
+    async update(collectionName, documentId, data) {
+        const url = `${getFirestoreBasePath(collectionName)}/${documentId}`;
+        const firestoreData = convertToFirestoreDocument(data);
+        const token = await this.getToken();
+        const response = await fetch(url, {
+            method: "PATCH",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${token}`,
+            },
+            body: JSON.stringify(firestoreData),
+        });
+        if (!response.ok) {
+            throw new Error(`Firestore API error: ${response.statusText}`);
+        }
+        const result = (await response.json());
+        return convertFromFirestoreDocument(result);
+    }
+    /**
+     * ドキュメントを削除
+     */
+    async delete(collectionName, documentId) {
+        const url = `${getFirestoreBasePath(collectionName)}/${documentId}`;
+        const token = await this.getToken();
+        const response = await fetch(url, {
+            method: "DELETE",
+            headers: {
+                Authorization: `Bearer ${token}`,
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Firestore API error: ${response.statusText}`);
+        }
+        return true;
+    }
+    /**
+     * コレクションのドキュメントを検索
+     */
+    async query(collectionName, options = {}) {
+        const url = `${getFirestoreBasePath(collectionName)}:runQuery`;
+        // クエリ構築
+        const structuredQuery = {
+            from: [{ collectionId: collectionName }],
+        };
+        // フィルター条件
+        if (options.where && options.where.length > 0) {
+            structuredQuery.where = {
+                compositeFilter: {
+                    op: "AND",
+                    filters: options.where.map(condition => ({
+                        fieldFilter: {
+                            field: { fieldPath: condition.field },
+                            op: condition.op,
+                            value: convertToFirestoreValue(condition.value),
+                        },
+                    })),
+                },
+            };
+        }
+        // 並べ替え
+        if (options.orderBy) {
+            structuredQuery.orderBy = [
+                {
+                    field: { fieldPath: options.orderBy },
+                    direction: "ASCENDING",
+                },
+            ];
+        }
+        // 制限
+        if (options.limit) {
+            structuredQuery.limit = options.limit;
+        }
+        // オフセット
+        if (options.offset) {
+            structuredQuery.offset = options.offset;
+        }
+        const token = await this.getToken();
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${token}`,
+            },
+            body: JSON.stringify({
+                structuredQuery,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Firestore API error: ${response.statusText}`);
+        }
+        const results = (await response.json());
+        return results
+            .filter(item => item.document)
+            .map(item => convertFromFirestoreDocument(item.document));
+    }
+}
+// デフォルトのFirestoreクライアントインスタンス
+export const firestore = new FirestoreClient();
+// 後方互換性のための関数
+export async function saveToFirestore(collectionName, data) {
+    const result = await firestore.create(collectionName, data);
+    return { documentId: result.id, result };
+}

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,34 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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;
+// 型定義のエクスポート
+__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; } });
+// ユーティリティ関数のエクスポート
+var auth_1 = require("./utils/auth");
+Object.defineProperty(exports, "getFirestoreToken", { enumerable: true, get: function () { return auth_1.getFirestoreToken; } });
+var converter_1 = require("./utils/converter");
+Object.defineProperty(exports, "convertToFirestoreValue", { enumerable: true, get: function () { return converter_1.convertToFirestoreValue; } });
+Object.defineProperty(exports, "convertFromFirestoreValue", { enumerable: true, get: function () { return converter_1.convertFromFirestoreValue; } });
+Object.defineProperty(exports, "convertToFirestoreDocument", { enumerable: true, get: function () { return converter_1.convertToFirestoreDocument; } });
+Object.defineProperty(exports, "convertFromFirestoreDocument", { enumerable: true, get: function () { return converter_1.convertFromFirestoreDocument; } });
+var path_1 = require("./utils/path");
+Object.defineProperty(exports, "getFirestoreBasePath", { enumerable: true, get: function () { return path_1.getFirestoreBasePath; } });
+Object.defineProperty(exports, "getDocumentId", { enumerable: true, get: function () { return path_1.getDocumentId; } });

package/dist/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Firestoreクライアントの設定インターフェース
+ */
+export interface FirestoreConfig {
+    projectId: string;
+    privateKey: string;
+    clientEmail: string;
+}
+/**
+ * Firestoreの値型定義
+ */
+export type FirestoreFieldValue = {
+    stringValue: string;
+} | {
+    integerValue: number;
+} | {
+    doubleValue: number;
+} | {
+    booleanValue: boolean;
+} | {
+    nullValue: null;
+} | {
+    timestampValue: string;
+} | {
+    mapValue: {
+        fields: Record<string, FirestoreFieldValue>;
+    };
+} | {
+    arrayValue: {
+        values: FirestoreFieldValue[];
+    };
+};
+/**
+ * Firestoreドキュメント型
+ */
+export interface FirestoreDocument {
+    name?: string;
+    fields: Record<string, FirestoreFieldValue>;
+    createTime?: string;
+    updateTime?: string;
+}
+/**
+ * Firestoreレスポンス型
+ */
+export interface FirestoreResponse {
+    name: string;
+    fields?: Record<string, FirestoreFieldValue>;
+    createTime?: string;
+    updateTime?: string;
+}
+/**
+ * クエリオプション型
+ */
+export interface QueryOptions {
+    where?: Array<{
+        field: string;
+        op: string;
+        value: any;
+    }>;
+    orderBy?: string;
+    limit?: number;
+    offset?: number;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/auth.d.ts

@@ -0,0 +1,13 @@
+import { FirestoreConfig } from "../types";
+/**
+ * JWT（JSON Web Token）を作成する関数
+ * @param config Firestore設定
+ * @returns JWT文字列
+ */
+export declare function createJWT(config: FirestoreConfig): Promise<string>;
+/**
+ * Firestoreの認証トークンを取得する関数
+ * @param config Firestore設定
+ * @returns アクセストークン
+ */
+export declare function getFirestoreToken(config: FirestoreConfig): Promise<string>;

package/dist/utils/auth.js

@@ -0,0 +1,90 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createJWT = createJWT;
+exports.getFirestoreToken = getFirestoreToken;
+const jose = __importStar(require("jose"));
+/**
+ * JWT（JSON Web Token）を作成する関数
+ * @param config Firestore設定
+ * @returns JWT文字列
+ */
+async function createJWT(config) {
+    const now = Math.floor(Date.now() / 1000);
+    const payload = {
+        iss: config.clientEmail,
+        sub: config.clientEmail,
+        aud: "https://oauth2.googleapis.com/token",
+        iat: now,
+        exp: now + 3600, // 1時間後に期限切れ
+        scope: "https://www.googleapis.com/auth/datastore",
+    };
+    try {
+        // 秘密鍵をインポート
+        const privateKey = await jose.importPKCS8(config.privateKey, "RS256");
+        // JWTを作成
+        const token = await new jose.SignJWT(payload)
+            .setProtectedHeader({
+            alg: "RS256",
+            typ: "JWT",
+        })
+            .sign(privateKey);
+        return token;
+    }
+    catch (error) {
+        console.error("Error creating JWT:", error);
+        throw error;
+    }
+}
+/**
+ * Firestoreの認証トークンを取得する関数
+ * @param config Firestore設定
+ * @returns アクセストークン
+ */
+async function getFirestoreToken(config) {
+    // トークンを取得するためのリクエスト
+    const response = await fetch("https://oauth2.googleapis.com/token", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            grant_type: "urn:ietf:params:oauth:grant-type:jwt-bearer",
+            assertion: await createJWT(config),
+        }),
+    });
+    const data = (await response.json());
+    return data.access_token;
+}

package/dist/utils/converter.d.ts

@@ -0,0 +1,27 @@
+import { FirestoreDocument, FirestoreFieldValue, FirestoreResponse } from "../types";
+/**
+ * JSの値をFirestore形式に変換する
+ * @param value 変換する値
+ * @returns Firestore形式の値
+ */
+export declare function convertToFirestoreValue(value: any): FirestoreFieldValue;
+/**
+ * Firestore形式からJSの値に変換する
+ * @param firestoreValue Firestore形式の値
+ * @returns JS形式の値
+ */
+export declare function convertFromFirestoreValue(firestoreValue: FirestoreFieldValue): any;
+/**
+ * オブジェクトをFirestoreドキュメント形式に変換
+ * @param data 変換するオブジェクト
+ * @returns Firestoreドキュメント
+ */
+export declare function convertToFirestoreDocument(data: Record<string, any>): FirestoreDocument;
+/**
+ * Firestoreドキュメントをオブジェクトに変換
+ * @param doc Firestoreレスポンス
+ * @returns 変換されたオブジェクト（idプロパティ付き）
+ */
+export declare function convertFromFirestoreDocument(doc: FirestoreResponse): Record<string, any> & {
+    id: string;
+};