@mathrunet/masamune_cloudflare_turso 3.2.14 → 3.4.1

package/CHANGELOG.md

@@ -1,4 +1,4 @@
-## 3.2.14 (2026-07-01)
+## 3.4.1 (2026-07-04)
 
 
 ### chore
@@ -58,6 +58,7 @@
 * Remove comments ([eb83a5f](https://github.com/mathrunet/node_masamune/commit/eb83a5f6fdc1d8c6a03ce691cf11e8d3fbfdb85e))
 * Scrutinize log output ([5eaa4a2](https://github.com/mathrunet/node_masamune/commit/5eaa4a2042f8b714b3f48e44cc44c8f86549212e))
 * Update @mathrunet/katana to version 3.9.1 ([d8e32a1](https://github.com/mathrunet/node_masamune/commit/d8e32a1f238ed3b29003bd83799fde57a054c063))
+* update @mathrunet/masamune dependency version to 3.10.4 across multiple packages ([f62e636](https://github.com/mathrunet/node_masamune/commit/f62e6367ddf48e513c523b8970b4fdc5b4e31152))
 * Update Masamune package to version 3.8.3 ([8e8155e](https://github.com/mathrunet/node_masamune/commit/8e8155e3380f05fb05abdb087c9bfff0b05c1795))
 * Update masamune package version ([f4998d6](https://github.com/mathrunet/node_masamune/commit/f4998d654dee28f2f12c5d2d8b9c861563825dbd))
 * Update Node.js engine to v22 and bump development dependencies across packages. ([d840a0f](https://github.com/mathrunet/node_masamune/commit/d840a0f503230f80edbdf01f9516841cff36798d))
@@ -106,6 +107,7 @@
 * Add PDF creation function. ([de349b3](https://github.com/mathrunet/node_masamune/commit/de349b382bacd325929b2c6fa8330dbe7fe12b98))
 * Add removeOnlyEmoji method to String prototype and update usage in ModelFieldValue class ([dccecf8](https://github.com/mathrunet/node_masamune/commit/dccecf844ad7602e5acedfb4653620ac80c017cb))
 * Add required type. ([d92208c](https://github.com/mathrunet/node_masamune/commit/d92208cdb1e7340d2b9258a6a090123f581bf5d9))
+* add scheduled workers support and enhance deployment functionality ([70ab4d6](https://github.com/mathrunet/node_masamune/commit/70ab4d6856badb8d86420acf757fc75823493aef))
 * add scheduler notification tests and update general test utilities and Firestore tests. ([710e462](https://github.com/mathrunet/node_masamune/commit/710e46287e7eb7fea6dd461e0d5354ce2f1bbfd2))
 * Add short video generation function using Gemini 2.5 Flash and FFmpeg, including tests, documentation, and updated ignore rules for temporary files. ([7e6cde2](https://github.com/mathrunet/node_masamune/commit/7e6cde28f7760c54058cb1e2073c6e97f552d39e))
 * Add SqlApiBase. ([ff6c5b2](https://github.com/mathrunet/node_masamune/commit/ff6c5b28905402f326904eb4052e86db82be4778))
@@ -152,6 +154,7 @@
 * Gmail stopped working, so I deleted it. ([c415079](https://github.com/mathrunet/node_masamune/commit/c4150799abeb996b0a08e3d9b7dccb232a2404f2))
 * Google Play Console data acquisition function implementation ([28ad81f](https://github.com/mathrunet/node_masamune/commit/28ad81ff6451c922ff16c40e52646571d2d39d60))
 * implement broad/detailed research and asset creation functions, alongside new documentation and tests ([0c1c05d](https://github.com/mathrunet/node_masamune/commit/0c1c05da72d25219080ac98809322b13667b047c))
+* implement Cloudflare KV integration with document-oriented model ([b9af783](https://github.com/mathrunet/node_masamune/commit/b9af7834275e36fdf48977f59dec22f41760bcb8))
 * implement Firebase function to generate short video metadata using Vertex AI, including tests and development documentation. ([2251993](https://github.com/mathrunet/node_masamune/commit/22519933c8b1f84fc7ae26a5754c6c02d96b5969))
 * Implement retry mechanism for Vertex AI API calls in ResearchMarket function and enhance error handling ([ac03efe](https://github.com/mathrunet/node_masamune/commit/ac03efe06d7958ad7ebc9a405cf31c351a3b4298))
 * Implementation of data retrieval API. ([df9ad88](https://github.com/mathrunet/node_masamune/commit/df9ad88da46ccb85cea4172ed8c0107ea2c431f7))
@@ -342,9 +345,17 @@
 
 ### refactor
 
+* enhance Google token functionality for Cloudflare Workers ([bb4b4bc](https://github.com/mathrunet/node_masamune/commit/bb4b4bc7bceec4064c5bcd01066d93b1b636b69f))
+* enhance media processing for Cloudflare Workers ([7d76e68](https://github.com/mathrunet/node_masamune/commit/7d76e68f93f89321492aa1716e778e5f4a869afc))
+* enhance notification functionality for Cloudflare Workers ([04c14c6](https://github.com/mathrunet/node_masamune/commit/04c14c62f0195ab36ccb4df21efebbd410259e84))
+* enhance SendGrid integration for Cloudflare Workers ([60f9976](https://github.com/mathrunet/node_masamune/commit/60f997643c223c74d9f2344d79e91d2337e4018f))
 * Remove debug log statements from FirestoreNullConverter ([b110a47](https://github.com/mathrunet/node_masamune/commit/b110a47faac178d79e4810221a0c89a943417f59))
 * Remove various cloud functions and tests, and add new tests for short video generation functionality. ([b5a2f34](https://github.com/mathrunet/node_masamune/commit/b5a2f34d474218c76cb25fdc1f6c0fe3b6c13413))
+* restructure database rules for improved clarity and consistency ([b541875](https://github.com/mathrunet/node_masamune/commit/b5418755495ef5340657e532466659e5f3c8cf82))
 * Save the interface to a separate file. ([141f8bd](https://github.com/mathrunet/node_masamune/commit/141f8bdf6b06538de2512e52b7fedb58366c4e8b))
+* update Android token functions for Cloudflare Workers integration ([f3d602e](https://github.com/mathrunet/node_masamune/commit/f3d602ec1ac846471217d150ffcf166771f8f247))
+* update Cloudflare purchase functions for improved handling ([f4d1a20](https://github.com/mathrunet/node_masamune/commit/f4d1a2038a15f162d1df6b3558fe8300e09a3d78))
+* update geocoding functionality for Cloudflare Workers ([1398cc6](https://github.com/mathrunet/node_masamune/commit/1398cc6fa73e0474a39c1bd7f1d718398b91367a))
 
 ### test
 
@@ -357,6 +368,7 @@
 * Creating tests. ([2a91c82](https://github.com/mathrunet/node_masamune/commit/2a91c824c4cf584fac10f9ac61d9bf4f103c5196))
 * Extend the timeout for the short video generation test. ([9e46c82](https://github.com/mathrunet/node_masamune/commit/9e46c828c791d933b32344842e63830782aa0fa5))
 * Fixes to pass tests. ([a656689](https://github.com/mathrunet/node_masamune/commit/a6566898613d76cd1027a319cda4f605044db151))
+* refactor media tests for Cloudflare integration ([7b1e581](https://github.com/mathrunet/node_masamune/commit/7b1e5816b297d68ba5c28599b5cfb7fa935a70f4))
 * Test code implementation. ([7f40834](https://github.com/mathrunet/node_masamune/commit/7f40834936b13a1b54b792b1c47f7c1ae2319502))
 
 

package/README.md

@@ -190,13 +190,15 @@ option.
 {
   "version": "1",
   "rules": {
-    "database/main": {
-      "read": "allow",
-      "write": "server"
-    },
-    "database/main/users/*": {
-      "read": "authenticated",
-      "write": { "type": "field", "field": "ownerId", "server": true }
+    "database": {
+      "main": {
+        "read": "allow",
+        "write": "server"
+      },
+      "main/users/*": {
+        "read": "authenticated",
+        "write": { "type": "field", "field": "ownerId", "server": true }
+      }
     }
   }
 }
@@ -213,9 +215,11 @@ Token authorization is evaluated against the database path:
 {
   "version": "1",
   "rules": {
-    "database/main": {
-      "read": "authenticated",
-      "write": "deny"
+    "database": {
+      "main": {
+        "read": "authenticated",
+        "write": "deny"
+      }
     }
   }
 }
@@ -231,9 +235,11 @@ Named path parameters can be compared with the authenticated user ID:
 {
   "version": "1",
   "rules": {
-    "database/{uid}": {
-      "read": { "type": "path", "param": "uid" },
-      "write": { "type": "path", "param": "uid" }
+    "database": {
+      "{uid}": {
+        "read": { "type": "path", "param": "uid" },
+        "write": { "type": "path", "param": "uid" }
+      }
     }
   }
 }
@@ -249,12 +255,14 @@ issuing only the direct Turso token that is safe for the requested scope:
 {
   "version": "1",
   "rules": {
-    "database/{uid}": {
-      "read": { "type": "path", "param": "uid" },
-      "write": {
-        "type": "path",
-        "param": "uid",
-        "server": true
+    "database": {
+      "{uid}": {
+        "read": { "type": "path", "param": "uid" },
+        "write": {
+          "type": "path",
+          "param": "uid",
+          "server": true
+        }
       }
     }
   }

package/dist/functions/turso.js

@@ -35,7 +35,8 @@ async function handleCrud(context, options, method) {
         const authentication = context.get("authentication");
         phase = "rules";
         const result = await engine.evaluate({
-            path: (0, rules_1.buildRulesPath)({
+            target: "database",
+            path: (0, rules_1.buildDatabaseRulesPath)({
                 database: crudRequest.database,
                 table: crudRequest.table,
                 indexKey: crudRequest.indexKey ?? "*",

package/dist/functions/turso.js.map

@@ -1 +1 @@
-{"version":3,"file":"turso.js","sourceRoot":"","sources":["../../src/functions/turso.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"turso.js","sourceRoot":"","sources":["../../src/functions/turso.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -11,5 +11,6 @@
 export * from "@mathrunet/masamune";
 export * from "@mathrunet/masamune_cloudflare";
 export * from "./functions";
+export * from "./lib/database_adapter";
 export type { RulesAccessRule, RulesConfig, RulesEntry, RulesOperation, RulesOperationAlias, RulesOperationKey, } from "./lib/types";
 export * from "./lib/types";

package/dist/index.js

@@ -27,5 +27,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("@mathrunet/masamune"), exports);
 __exportStar(require("@mathrunet/masamune_cloudflare"), exports);
 __exportStar(require("./functions"), exports);
+__exportStar(require("./lib/database_adapter"), exports);
 __exportStar(require("./lib/types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;GASG;AACH,sDAAoC;AACpC,iEAA+C;AAC/C,8CAA4B;AAS5B,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;GASG;AACH,sDAAoC;AACpC,iEAA+C;AAC/C,8CAA4B;AAC5B,yDAAuC;AASvC,8CAA4B"}

package/dist/lib/database_adapter.d.ts

@@ -0,0 +1,105 @@
+import { DatabaseAdapterBase, DatabaseDocument, DatabaseQueryResult, DatabaseWhereCondition } from "@mathrunet/masamune_cloudflare";
+import { TursoClient } from "./turso_client";
+import { TursoWorkersOptions } from "./types";
+/**
+ * [DatabaseAdapterBase] implementation for Turso.
+ *
+ * Maps Firestore-style document paths to SQL tables. Collection names in the path are joined with `__` to form the table name, and document IDs are stored in the `id` / `parent_id` columns.
+ *
+ * e.g. `user/{uid}` -> table `user` (id = uid), `user/{uid}/transaction/{tid}` -> table `user__transaction` (id = tid, parent_id = uid)
+ *
+ * Turso用の[DatabaseAdapterBase]の実装。
+ *
+ * FirestoreスタイルのドキュメントパスをSQLテーブルにマッピングします。パス内のコレクション名は`__`で連結されてテーブル名になり、ドキュメントIDは`id`/`parent_id`カラムに保存されます。
+ *
+ * 例: `user/{uid}` -> テーブル`user`（id = uid）、`user/{uid}/transaction/{tid}` -> テーブル`user__transaction`（id = tid、parent_id = uid）
+ */
+export declare class TursoDatabaseAdapter extends DatabaseAdapterBase {
+    /**
+     * [DatabaseAdapterBase] implementation for Turso.
+     *
+     * Turso用の[DatabaseAdapterBase]の実装。
+     *
+     * @param config.options
+     * Turso connection options (organization, group, platformApiToken, etc.).
+     *
+     * Tursoの接続オプション（organization、group、platformApiTokenなど）。
+     *
+     * @param config.database
+     * Logical database name (default: `main`).
+     *
+     * 論理データベース名（デフォルト: `main`）。
+     *
+     * @param config.client
+     * Directly injected Turso client. Used for testing or when the connection has already been resolved.
+     *
+     * 直接注入するTursoクライアント。テスト用、または接続が既に解決されている場合に使用します。
+     */
+    constructor({ options, database, client, }: {
+        options?: TursoWorkersOptions | undefined;
+        database?: string | undefined;
+        client?: TursoClient | undefined;
+    });
+    /**
+     * Turso connection options.
+     *
+     * Tursoの接続オプション。
+     */
+    readonly options: TursoWorkersOptions;
+    /**
+     * Logical database name.
+     *
+     * 論理データベース名。
+     */
+    readonly database: string;
+    private _client;
+    private client;
+    private resolveOptions;
+    getDocument(path: string): Promise<DatabaseDocument | null>;
+    saveDocument(path: string, data: {
+        [key: string]: any;
+    }, options?: {
+        merge?: boolean | undefined;
+    }): Promise<void>;
+    query(collectionPath: string, options?: {
+        wheres?: DatabaseWhereCondition[] | undefined;
+        limit?: number | undefined;
+        cursor?: string | null | undefined;
+    }): Promise<DatabaseQueryResult>;
+    private loadExistingRow;
+}
+/**
+ * Parse a document path into a table name, document ID and parent document ID.
+ *
+ * ドキュメントパスをテーブル名、ドキュメントID、親ドキュメントIDにパースします。
+ */
+export declare function parseDocumentPath(path: string): {
+    table: string;
+    id: string;
+    parentId: string;
+};
+/**
+ * Parse a collection path into a table name and parent document ID.
+ *
+ * コレクションパスをテーブル名と親ドキュメントIDにパースします。
+ */
+export declare function parseCollectionPath(path: string): {
+    table: string;
+    parentId: string;
+};
+/**
+ * Encode a field key into a column name.
+ *
+ * Keys starting with `@` (e.g. `@time`, `@uid`) are prefixed with `mf_at_` because they cannot be used as SQL identifiers.
+ *
+ * フィールドキーをカラム名にエンコードします。
+ *
+ * `@`で始まるキー（例: `@time`、`@uid`）はSQL識別子として使用できないため、`mf_at_`のプレフィックスが付けられます。
+ */
+export declare function encodeColumnName(key: string): string;
+/**
+ * Decode a column name back into a field key.
+ *
+ * カラム名をフィールドキーにデコードします。
+ */
+export declare function decodeColumnName(column: string): string;

package/dist/lib/database_adapter.js

@@ -0,0 +1,356 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TursoDatabaseAdapter = void 0;
+exports.parseDocumentPath = parseDocumentPath;
+exports.parseCollectionPath = parseCollectionPath;
+exports.encodeColumnName = encodeColumnName;
+exports.decodeColumnName = decodeColumnName;
+const masamune_cloudflare_1 = require("@mathrunet/masamune_cloudflare");
+const request_1 = require("./request");
+const schema_1 = require("./schema");
+const turso_client_1 = require("./turso_client");
+const reservedColumns = new Set(["id", "parent_id", "created_at", "updated_at"]);
+const atMarkColumnPrefix = "mf_at_";
+/**
+ * [DatabaseAdapterBase] implementation for Turso.
+ *
+ * Maps Firestore-style document paths to SQL tables. Collection names in the path are joined with `__` to form the table name, and document IDs are stored in the `id` / `parent_id` columns.
+ *
+ * e.g. `user/{uid}` -> table `user` (id = uid), `user/{uid}/transaction/{tid}` -> table `user__transaction` (id = tid, parent_id = uid)
+ *
+ * Turso用の[DatabaseAdapterBase]の実装。
+ *
+ * FirestoreスタイルのドキュメントパスをSQLテーブルにマッピングします。パス内のコレクション名は`__`で連結されてテーブル名になり、ドキュメントIDは`id`/`parent_id`カラムに保存されます。
+ *
+ * 例: `user/{uid}` -> テーブル`user`（id = uid）、`user/{uid}/transaction/{tid}` -> テーブル`user__transaction`（id = tid、parent_id = uid）
+ */
+class TursoDatabaseAdapter extends masamune_cloudflare_1.DatabaseAdapterBase {
+    /**
+     * [DatabaseAdapterBase] implementation for Turso.
+     *
+     * Turso用の[DatabaseAdapterBase]の実装。
+     *
+     * @param config.options
+     * Turso connection options (organization, group, platformApiToken, etc.).
+     *
+     * Tursoの接続オプション（organization、group、platformApiTokenなど）。
+     *
+     * @param config.database
+     * Logical database name (default: `main`).
+     *
+     * 論理データベース名（デフォルト: `main`）。
+     *
+     * @param config.client
+     * Directly injected Turso client. Used for testing or when the connection has already been resolved.
+     *
+     * 直接注入するTursoクライアント。テスト用、または接続が既に解決されている場合に使用します。
+     */
+    constructor({ options, database, client, }) {
+        super();
+        this.options = options ?? {};
+        this.database = database ?? "main";
+        this._client = client ?? null;
+    }
+    /**
+     * Turso connection options.
+     *
+     * Tursoの接続オプション。
+     */
+    options;
+    /**
+     * Logical database name.
+     *
+     * 論理データベース名。
+     */
+    database;
+    _client;
+    async client() {
+        if (this._client) {
+            return this._client;
+        }
+        const connection = await (0, turso_client_1.resolveDatabaseConnection)(this.database, this.resolveOptions());
+        this._client = (0, turso_client_1.createTursoClient)(connection);
+        return this._client;
+    }
+    // 接続時にオプションを解決します。オプションで指定されていない項目は
+    // `process.env`（nodejs_compatで注入されるWorkersシークレット）から補完します。
+    resolveOptions() {
+        const env = typeof process !== "undefined" ? process.env ?? {} : {};
+        return {
+            ...this.options,
+            organization: firstNonEmptyValue(this.options.organization, env["TURSO_ORGANIZATION"]),
+            group: firstNonEmptyValue(this.options.group, env["TURSO_GROUP"]),
+            platformApiToken: firstNonEmptyValue(this.options.platformApiToken, env["TURSO_PLATFORM_API_TOKEN"]),
+        };
+    }
+    async getDocument(path) {
+        const { table, id, parentId } = parseDocumentPath(path);
+        const client = await this.client();
+        let result;
+        try {
+            result = await client.execute({
+                sql: `SELECT * FROM ${(0, schema_1.quoteIdentifier)(table)} WHERE id = ? AND parent_id = ? LIMIT 1`,
+                args: [id, parentId],
+            });
+        }
+        catch (error) {
+            if (isMissingTableError(error)) {
+                return null;
+            }
+            throw error;
+        }
+        const row = result.rows[0];
+        if (row === undefined) {
+            return null;
+        }
+        return {
+            path: path,
+            data: decodeDocumentData((0, schema_1.decodeRow)(row, result.columns)),
+        };
+    }
+    async saveDocument(path, data, options) {
+        const { table, id, parentId } = parseDocumentPath(path);
+        const merge = options?.merge ?? false;
+        const client = await this.client();
+        const existing = await this.loadExistingRow(client, table, id, parentId);
+        const now = Date.now();
+        const row = merge && existing ? { ...existing } : {};
+        for (const [key, value] of Object.entries(data)) {
+            const column = encodeColumnName(key);
+            if (value instanceof masamune_cloudflare_1.DatabaseIncrement) {
+                const current = row[column] ?? existing?.[column];
+                const base = typeof current === "number" ? current : Number(current ?? 0);
+                row[column] = (Number.isFinite(base) ? base : 0) + value.value;
+            }
+            else {
+                row[column] = value;
+            }
+        }
+        delete row["id"];
+        delete row["parent_id"];
+        const createdAt = existing?.["created_at"];
+        row["id"] = id;
+        row["parent_id"] = parentId;
+        row["created_at"] = typeof createdAt === "number" ? createdAt : now;
+        row["updated_at"] = now;
+        await (0, schema_1.ensureTableSchema)({
+            client,
+            table,
+            value: row,
+            autoCreateTable: this.options.autoCreateTable ?? true,
+            autoMigrateAddColumns: this.options.autoMigrateAddColumns ?? true,
+        });
+        const keys = Object.keys(row);
+        const placeholders = keys.map(() => "?").join(", ");
+        await client.execute({
+            sql: `INSERT OR REPLACE INTO ${(0, schema_1.quoteIdentifier)(table)} ` +
+                `(${keys.map(schema_1.quoteIdentifier).join(", ")}) VALUES (${placeholders})`,
+            args: keys.map((key) => (0, schema_1.encodeSqlValue)(row[key])),
+        });
+    }
+    async query(collectionPath, options) {
+        const { table, parentId } = parseCollectionPath(collectionPath);
+        const client = await this.client();
+        const clauses = ["parent_id = ?"];
+        const args = [parentId];
+        for (const where of options?.wheres ?? []) {
+            const built = buildWhereCondition(where);
+            clauses.push(built.sql);
+            args.push(...built.args);
+        }
+        if (options?.cursor) {
+            clauses.push("id > ?");
+            args.push(options.cursor);
+        }
+        const limit = options?.limit && options.limit > 0 ? ` LIMIT ${options.limit}` : "";
+        let result;
+        try {
+            result = await client.execute({
+                sql: `SELECT * FROM ${(0, schema_1.quoteIdentifier)(table)} WHERE ${clauses.join(" AND ")} ORDER BY id ASC${limit}`,
+                args,
+            });
+        }
+        catch (error) {
+            if (isMissingTableError(error)) {
+                return { docs: [], cursor: null };
+            }
+            throw error;
+        }
+        const docs = result.rows.map((row) => {
+            const decoded = (0, schema_1.decodeRow)(row, result.columns);
+            const id = String(decoded["id"] ?? "");
+            return {
+                path: `${collectionPath}/${id}`,
+                data: decodeDocumentData(decoded),
+            };
+        });
+        const cursor = options?.limit && docs.length >= options.limit
+            ? String(docs[docs.length - 1].path.split("/").pop() ?? "")
+            : null;
+        return { docs, cursor };
+    }
+    async loadExistingRow(client, table, id, parentId) {
+        try {
+            const result = await client.execute({
+                sql: `SELECT * FROM ${(0, schema_1.quoteIdentifier)(table)} WHERE id = ? AND parent_id = ? LIMIT 1`,
+                args: [id, parentId],
+            });
+            const row = result.rows[0];
+            if (row === undefined) {
+                return null;
+            }
+            return (0, schema_1.decodeRow)(row, result.columns);
+        }
+        catch (error) {
+            if (isMissingTableError(error)) {
+                return null;
+            }
+            throw error;
+        }
+    }
+}
+exports.TursoDatabaseAdapter = TursoDatabaseAdapter;
+/**
+ * Parse a document path into a table name, document ID and parent document ID.
+ *
+ * ドキュメントパスをテーブル名、ドキュメントID、親ドキュメントIDにパースします。
+ */
+function parseDocumentPath(path) {
+    const segments = splitPath(path);
+    if (segments.length < 2 || segments.length % 2 !== 0) {
+        throw new request_1.HttpError(400, `Invalid document path: ${path}`);
+    }
+    const collections = [];
+    const documentIds = [];
+    for (let i = 0; i < segments.length; i += 2) {
+        collections.push(segments[i]);
+        documentIds.push(segments[i + 1]);
+    }
+    return {
+        table: collections.join("__"),
+        id: documentIds[documentIds.length - 1],
+        parentId: documentIds.length > 1 ? documentIds[documentIds.length - 2] : "",
+    };
+}
+/**
+ * Parse a collection path into a table name and parent document ID.
+ *
+ * コレクションパスをテーブル名と親ドキュメントIDにパースします。
+ */
+function parseCollectionPath(path) {
+    const segments = splitPath(path);
+    if (segments.length < 1 || segments.length % 2 !== 1) {
+        throw new request_1.HttpError(400, `Invalid collection path: ${path}`);
+    }
+    const collections = [];
+    let parentId = "";
+    for (let i = 0; i < segments.length; i += 2) {
+        collections.push(segments[i]);
+        if (i > 0) {
+            parentId = segments[i - 1];
+        }
+    }
+    return {
+        table: collections.join("__"),
+        parentId,
+    };
+}
+/**
+ * Encode a field key into a column name.
+ *
+ * Keys starting with `@` (e.g. `@time`, `@uid`) are prefixed with `mf_at_` because they cannot be used as SQL identifiers.
+ *
+ * フィールドキーをカラム名にエンコードします。
+ *
+ * `@`で始まるキー（例: `@time`、`@uid`）はSQL識別子として使用できないため、`mf_at_`のプレフィックスが付けられます。
+ */
+function encodeColumnName(key) {
+    if (key.startsWith("@")) {
+        return `${atMarkColumnPrefix}${key.substring(1)}`;
+    }
+    return key;
+}
+/**
+ * Decode a column name back into a field key.
+ *
+ * カラム名をフィールドキーにデコードします。
+ */
+function decodeColumnName(column) {
+    if (column.startsWith(atMarkColumnPrefix)) {
+        return `@${column.substring(atMarkColumnPrefix.length)}`;
+    }
+    return column;
+}
+function firstNonEmptyValue(...values) {
+    return values.find((value) => typeof value === "string" && value.length > 0);
+}
+function splitPath(path) {
+    return path.split("/").map((segment) => segment.trim()).filter((segment) => segment.length > 0);
+}
+function decodeDocumentData(row) {
+    const data = {};
+    for (const [column, value] of Object.entries(row)) {
+        if (reservedColumns.has(column)) {
+            continue;
+        }
+        data[decodeColumnName(column)] = decodeStoredValue(value);
+    }
+    return data;
+}
+function decodeStoredValue(value) {
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if ((trimmed.startsWith("{") && trimmed.endsWith("}")) ||
+            (trimmed.startsWith("[") && trimmed.endsWith("]"))) {
+            try {
+                return JSON.parse(trimmed);
+            }
+            catch {
+                return value;
+            }
+        }
+    }
+    return value;
+}
+function buildWhereCondition(condition) {
+    const column = (0, schema_1.quoteIdentifier)(encodeColumnName(condition.key));
+    switch (condition.type) {
+        case "equalTo":
+            return { sql: `${column} = ?`, args: [(0, schema_1.encodeSqlValue)(condition.value)] };
+        case "notEqualTo":
+            return { sql: `${column} != ?`, args: [(0, schema_1.encodeSqlValue)(condition.value)] };
+        case "lessThan":
+            return { sql: `${column} < ?`, args: [(0, schema_1.encodeSqlValue)(condition.value)] };
+        case "lessThanOrEqualTo":
+            return { sql: `${column} <= ?`, args: [(0, schema_1.encodeSqlValue)(condition.value)] };
+        case "greaterThan":
+            return { sql: `${column} > ?`, args: [(0, schema_1.encodeSqlValue)(condition.value)] };
+        case "greaterThanOrEqualTo":
+            return { sql: `${column} >= ?`, args: [(0, schema_1.encodeSqlValue)(condition.value)] };
+        case "whereIn":
+        case "whereNotIn": {
+            const values = condition.value;
+            if (!Array.isArray(values) || values.length === 0) {
+                throw new request_1.HttpError(400, `${condition.type} requires non-empty array.`);
+            }
+            return {
+                sql: `${column} ${condition.type === "whereNotIn" ? "NOT " : ""}IN (${values.map(() => "?").join(", ")})`,
+                args: values.map(schema_1.encodeSqlValue),
+            };
+        }
+        case "isNull":
+            return { sql: `${column} IS NULL`, args: [] };
+        case "isNotNull":
+            return { sql: `${column} IS NOT NULL`, args: [] };
+        case "arrayContains":
+        case "arrayContainsAny":
+            throw new request_1.HttpError(400, `${condition.type} is not supported by Turso SQL yet.`);
+        default:
+            throw new request_1.HttpError(400, `Unsupported where condition: ${condition.type}`);
+    }
+}
+function isMissingTableError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return message.includes("no such table");
+}
+//# sourceMappingURL=database_adapter.js.map