@farcaster/snap-turso 1.0.0 → 1.0.2

package/dist/index.d.ts

@@ -1,8 +1,13 @@
-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;
+import { type SnapHandlerResult, type SnapContext } from "@farcaster/snap";
+export type DataStoreValue = string | number | boolean | null | DataStoreValue[] | {
+    [key: string]: DataStoreValue;
+};
+export type DataStore = {
+    get(key: string): Promise<DataStoreValue | null>;
+    set(key: string, value: DataStoreValue): Promise<void>;
+};
+export type SnapFunctionWithDataStore = (ctx: SnapContext & {
+    data: DataStore;
+}) => Promise<SnapHandlerResult>;
+export declare function createInMemoryDataStore(): DataStore;
+export declare function createTursoDataStore(): DataStore;

package/dist/index.js

@@ -1,15 +1,22 @@
 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) {
+export function createInMemoryDataStore() {
+    const data = new Map();
+    return {
+        async get(key) {
+            return data.get(key) ?? null;
+        },
+        async set(key, value) {
+            data.set(key, value);
+        },
+    };
+}
+export function createTursoDataStore() {
     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;
+        console.warn("missing Turso env vars -- using in-memory data store");
+        return createInMemoryDataStore();
     }
     const conn = connect({ url, authToken });
     let ensureTablePromise;
@@ -19,7 +26,7 @@ export function withTursoServerless(snapFn, _options) {
         }
         await ensureTablePromise;
     };
-    const store = {
+    return {
         async get(key) {
             await ensureTable();
             const stmt = await conn.prepare("SELECT value FROM snap_kv WHERE key = ?");
@@ -41,5 +48,4 @@ export function withTursoServerless(snapFn, _options) {
             await stmt.run([key, JSON.stringify(value)]);
         },
     };
-    return (ctx) => snapFn({ ...ctx, data: store });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farcaster/snap-turso",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Turso data store adapter for Farcaster Snaps",
   "repository": {
     "type": "git",
@@ -27,7 +27,7 @@
   "license": "MIT",
   "dependencies": {
     "@tursodatabase/serverless": "^0.2.0",
-    "@farcaster/snap": "1.8.0"
+    "@farcaster/snap": "1.13.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",

package/src/index.ts

@@ -1,29 +1,48 @@
 import { connect } from "@tursodatabase/serverless";
 import {
-  type DataStoreValue,
-  type SnapDataStore,
   type SnapFunction,
+  type SnapHandlerResult,
+  type SnapContext,
 } 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 {
+export type DataStoreValue =
+  | string
+  | number
+  | boolean
+  | null
+  | DataStoreValue[]
+  | { [key: string]: DataStoreValue };
+
+export type DataStore = {
+  get(key: string): Promise<DataStoreValue | null>;
+  set(key: string, value: DataStoreValue): Promise<void>;
+};
+
+export type SnapFunctionWithDataStore = (
+  ctx: SnapContext & { data: DataStore },
+) => Promise<SnapHandlerResult>;
+
+export function createInMemoryDataStore(): DataStore {
+  const data = new Map<string, DataStoreValue>();
+  return {
+    async get(key: string): Promise<DataStoreValue | null> {
+      return data.get(key) ?? null;
+    },
+    async set(key: string, value: DataStoreValue): Promise<void> {
+      data.set(key, value);
+    },
+  };
+}
+
+export function createTursoDataStore(): DataStore {
   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;
+    console.warn("missing Turso env vars -- using in-memory data store");
+    return createInMemoryDataStore();
   }
 
   const conn = connect({ url, authToken });
@@ -37,7 +56,7 @@ export function withTursoServerless(
     await ensureTablePromise;
   };
 
-  const store: SnapDataStore = {
+  return {
     async get(key: string): Promise<DataStoreValue | null> {
       await ensureTable();
       const stmt = await conn.prepare(
@@ -64,6 +83,4 @@ export function withTursoServerless(
       await stmt.run([key, JSON.stringify(value)]);
     },
   };
-
-  return (ctx) => snapFn({ ...ctx, data: store });
 }