@farcaster/snap-turso 0.0.0-canary-20260404123848

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { type SnapFunction } from "@farcaster/snap";
+/** Reserved for future options (e.g. custom table name). */
+export type WithTursoServerlessOptions = Record<string, never>;
+/**
+ * Wraps a SnapFunction and injects a Turso serverless-backed data store into the
+ * context.
+ */
+export declare function withTursoServerless(snapFn: SnapFunction, _options?: WithTursoServerlessOptions): SnapFunction;

package/dist/index.js

@@ -0,0 +1,45 @@
+import { connect } from "@tursodatabase/serverless";
+const TABLE_SQL = `CREATE TABLE IF NOT EXISTS snap_kv (key TEXT PRIMARY KEY, value TEXT NOT NULL)`;
+/**
+ * Wraps a SnapFunction and injects a Turso serverless-backed data store into the
+ * context.
+ */
+export function withTursoServerless(snapFn, _options) {
+    const url = process.env.TURSO_DATABASE_URL;
+    const authToken = process.env.TURSO_AUTH_TOKEN;
+    if (!url || !authToken) {
+        console.warn("missing env vars -- skipping Turso data store setup");
+        return snapFn;
+    }
+    const conn = connect({ url, authToken });
+    let ensureTablePromise;
+    const ensureTable = async () => {
+        if (!ensureTablePromise) {
+            ensureTablePromise = conn.execute(TABLE_SQL).then(() => undefined);
+        }
+        await ensureTablePromise;
+    };
+    const store = {
+        async get(key) {
+            await ensureTable();
+            const stmt = await conn.prepare("SELECT value FROM snap_kv WHERE key = ?");
+            const row = await stmt.get([key]);
+            if (row == null) {
+                return null;
+            }
+            const text = typeof row === "object" &&
+                row !== null &&
+                "value" in row &&
+                typeof row.value === "string"
+                ? row.value
+                : String(row);
+            return JSON.parse(text);
+        },
+        async set(key, value) {
+            await ensureTable();
+            const stmt = await conn.prepare("INSERT OR REPLACE INTO snap_kv (key, value) VALUES (?, ?)");
+            await stmt.run([key, JSON.stringify(value)]);
+        },
+    };
+    return (ctx) => snapFn({ ...ctx, data: store });
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@farcaster/snap-turso",
+  "version": "0.0.0-canary-20260404123848",
+  "description": "Turso data store adapter for Farcaster Snaps",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/farcasterxyz/snap.git",
+    "directory": "pkgs/turso"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@tursodatabase/serverless": "^0.2.0",
+    "@farcaster/snap": "0.0.0-canary-20260404123848"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "scripts": {
+    "build": "tsc && tsc-alias --resolve-full-paths --resolve-full-extension .js",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/index.ts

@@ -0,0 +1,69 @@
+import { connect } from "@tursodatabase/serverless";
+import {
+  type DataStoreValue,
+  type SnapDataStore,
+  type SnapFunction,
+} from "@farcaster/snap";
+
+/** Reserved for future options (e.g. custom table name). */
+export type WithTursoServerlessOptions = Record<string, never>;
+
+const TABLE_SQL = `CREATE TABLE IF NOT EXISTS snap_kv (key TEXT PRIMARY KEY, value TEXT NOT NULL)`;
+
+/**
+ * Wraps a SnapFunction and injects a Turso serverless-backed data store into the
+ * context.
+ */
+export function withTursoServerless(
+  snapFn: SnapFunction,
+  _options?: WithTursoServerlessOptions,
+): SnapFunction {
+  const url = process.env.TURSO_DATABASE_URL;
+  const authToken = process.env.TURSO_AUTH_TOKEN;
+
+  if (!url || !authToken) {
+    console.warn("missing env vars -- skipping Turso data store setup");
+    return snapFn;
+  }
+
+  const conn = connect({ url, authToken });
+
+  let ensureTablePromise: Promise<void> | undefined;
+
+  const ensureTable = async (): Promise<void> => {
+    if (!ensureTablePromise) {
+      ensureTablePromise = conn.execute(TABLE_SQL).then(() => undefined);
+    }
+    await ensureTablePromise;
+  };
+
+  const store: SnapDataStore = {
+    async get(key: string): Promise<DataStoreValue | null> {
+      await ensureTable();
+      const stmt = await conn.prepare(
+        "SELECT value FROM snap_kv WHERE key = ?",
+      );
+      const row = await stmt.get([key]);
+      if (row == null) {
+        return null;
+      }
+      const text =
+        typeof row === "object" &&
+        row !== null &&
+        "value" in row &&
+        typeof (row as { value: unknown }).value === "string"
+          ? (row as { value: string }).value
+          : String(row);
+      return JSON.parse(text) as DataStoreValue;
+    },
+    async set(key: string, value: DataStoreValue): Promise<void> {
+      await ensureTable();
+      const stmt = await conn.prepare(
+        "INSERT OR REPLACE INTO snap_kv (key, value) VALUES (?, ?)",
+      );
+      await stmt.run([key, JSON.stringify(value)]);
+    },
+  };
+
+  return (ctx) => snapFn({ ...ctx, data: store });
+}