@vinaverse/server 0.0.0-stage → 0.1.0-alpha.1

package/dist/stores.cjs

@@ -0,0 +1,315 @@
+'use strict';
+
+// src/stores/dynamodb.ts
+var ABSENT_OR_EXPIRED = "attribute_not_exists(pk) OR expires_at < :now";
+function conditionFailed(error) {
+  return error?.name === "ConditionalCheckFailedException";
+}
+function dynamoNonceStore(options) {
+  const now = options.now ?? (() => Math.floor(Date.now() / 1e3));
+  return {
+    async claim(nonce, keepUntil) {
+      try {
+        await options.send("PutItem", {
+          TableName: options.table,
+          Item: {
+            pk: { S: `${options.prefix ?? ""}nonce#${nonce}` },
+            expires_at: { N: String(Math.ceil(keepUntil)) }
+          },
+          ConditionExpression: ABSENT_OR_EXPIRED,
+          ExpressionAttributeValues: { ":now": { N: String(now()) } }
+        });
+        return true;
+      } catch (error) {
+        if (conditionFailed(error)) return false;
+        throw error;
+      }
+    }
+  };
+}
+var FREE_OR_OWNED = `${ABSENT_OR_EXPIRED} OR (#state = :pending AND #owner = :owner)`;
+function dynamoIdempotencyStore(options) {
+  const now = options.now ?? (() => Math.floor(Date.now() / 1e3));
+  const pk = (key) => ({
+    S: `${options.prefix ?? ""}idempotency#${key}`
+  });
+  const owned = (owner) => ({
+    ExpressionAttributeNames: { "#state": "state", "#owner": "owner" },
+    ":pending": { S: "pending" },
+    ":owner": { S: owner }
+  });
+  return {
+    async start(key, fingerprint, pendingSeconds, owner) {
+      for (; ; ) {
+        try {
+          await options.send("PutItem", {
+            TableName: options.table,
+            Item: {
+              pk: pk(key),
+              fingerprint: { S: fingerprint },
+              state: { S: "pending" },
+              owner: { S: owner },
+              expires_at: { N: String(now() + Math.ceil(pendingSeconds)) }
+            },
+            ConditionExpression: ABSENT_OR_EXPIRED,
+            ExpressionAttributeValues: { ":now": { N: String(now()) } }
+          });
+          return null;
+        } catch (error) {
+          if (!conditionFailed(error)) throw error;
+        }
+        const held = await options.send("GetItem", {
+          TableName: options.table,
+          Key: { pk: pk(key) },
+          ConsistentRead: true
+        });
+        const item = held?.Item;
+        if (item && Number(item.expires_at?.N) >= now()) {
+          return {
+            fingerprint: item.fingerprint?.S ?? "",
+            state: item.state?.S === "done" ? "done" : "pending",
+            ...item.status?.N === void 0 ? {} : { status: Number(item.status.N) },
+            ...item.body?.S === void 0 ? {} : { body: item.body.S }
+          };
+        }
+      }
+    },
+    async finish(key, record, keepSeconds, owner) {
+      const { ExpressionAttributeNames, ...values } = owned(owner);
+      try {
+        await options.send("PutItem", {
+          TableName: options.table,
+          Item: {
+            pk: pk(key),
+            fingerprint: { S: record.fingerprint },
+            state: { S: "done" },
+            status: { N: String(record.status) },
+            body: { S: record.body },
+            expires_at: { N: String(now() + Math.ceil(keepSeconds)) }
+          },
+          ConditionExpression: FREE_OR_OWNED,
+          ExpressionAttributeNames,
+          ExpressionAttributeValues: {
+            ...values,
+            ":now": { N: String(now()) }
+          }
+        });
+        return true;
+      } catch (error) {
+        if (conditionFailed(error)) return false;
+        throw error;
+      }
+    },
+    async release(key, owner) {
+      const { ExpressionAttributeNames, ...values } = owned(owner);
+      try {
+        await options.send("DeleteItem", {
+          TableName: options.table,
+          Key: { pk: pk(key) },
+          ConditionExpression: "#state = :pending AND #owner = :owner",
+          ExpressionAttributeNames,
+          ExpressionAttributeValues: values
+        });
+      } catch (error) {
+        if (!conditionFailed(error)) throw error;
+      }
+    }
+  };
+}
+
+// src/stores/postgres.ts
+var PREFIX = /^[a-z_][a-z0-9_]{0,40}$/;
+function postgresTables(tablePrefix = "vinaverse_") {
+  const t = tables(tablePrefix);
+  return `
+CREATE TABLE IF NOT EXISTS ${t.nonces} (
+  nonce text PRIMARY KEY,
+  keep_until timestamptz NOT NULL
+);
+CREATE TABLE IF NOT EXISTS ${t.idempotency} (
+  key text PRIMARY KEY,
+  fingerprint text NOT NULL,
+  state text NOT NULL CHECK (state IN ('pending', 'done')),
+  owner text,
+  status integer,
+  body text,
+  keep_until timestamptz NOT NULL
+);`;
+}
+var POSTGRES_TABLES = postgresTables();
+function tables(prefix) {
+  if (!PREFIX.test(prefix)) {
+    throw new TypeError(
+      `tablePrefix must be lower-case letters, digits and _, starting with a letter or _, not ${JSON.stringify(prefix)}`
+    );
+  }
+  return { nonces: `${prefix}nonces`, idempotency: `${prefix}idempotency` };
+}
+function pruner(options, sql) {
+  const every = options.pruneEvery ?? 1e3;
+  let count = 0;
+  return async () => {
+    count = (count + 1) % every;
+    if (count === 0) await options.query(sql, []);
+  };
+}
+function postgresNonceStore(options) {
+  const { nonces } = tables(options.tablePrefix ?? "vinaverse_");
+  const claim = `INSERT INTO ${nonces} (nonce, keep_until) VALUES ($1, to_timestamp($2))
+ON CONFLICT (nonce) DO UPDATE SET keep_until = EXCLUDED.keep_until
+WHERE ${nonces}.keep_until < now()
+RETURNING nonce`;
+  const prune = pruner(
+    options,
+    `DELETE FROM ${nonces} WHERE keep_until < now()`
+  );
+  return {
+    async claim(nonce, keepUntil) {
+      await prune();
+      const { rows } = await options.query(claim, [nonce, keepUntil]);
+      return rows.length === 1;
+    }
+  };
+}
+function postgresIdempotencyStore(options) {
+  const { idempotency: t } = tables(options.tablePrefix ?? "vinaverse_");
+  const start = `INSERT INTO ${t} (key, fingerprint, state, owner, keep_until)
+VALUES ($1, $2, 'pending', $4, now() + make_interval(secs => $3))
+ON CONFLICT (key) DO UPDATE SET fingerprint = EXCLUDED.fingerprint, state = 'pending', owner = EXCLUDED.owner,
+  status = NULL, body = NULL, keep_until = EXCLUDED.keep_until
+WHERE ${t}.keep_until < now()
+RETURNING key`;
+  const held = `SELECT fingerprint, state, status, body FROM ${t}
+WHERE key = $1 AND keep_until >= now()`;
+  const finish = `INSERT INTO ${t} (key, fingerprint, state, owner, status, body, keep_until)
+VALUES ($1, $2, 'done', NULL, $3, $4, now() + make_interval(secs => $5))
+ON CONFLICT (key) DO UPDATE SET fingerprint = EXCLUDED.fingerprint, state = 'done', owner = NULL,
+  status = EXCLUDED.status, body = EXCLUDED.body, keep_until = EXCLUDED.keep_until
+WHERE ${t}.keep_until < now() OR (${t}.state = 'pending' AND ${t}.owner = $6)
+RETURNING key`;
+  const release = `DELETE FROM ${t} WHERE key = $1 AND state = 'pending' AND owner = $2`;
+  const prune = pruner(options, `DELETE FROM ${t} WHERE keep_until < now()`);
+  return {
+    async start(key, fingerprint, pendingSeconds, owner) {
+      await prune();
+      for (; ; ) {
+        const started = await options.query(start, [
+          key,
+          fingerprint,
+          pendingSeconds,
+          owner
+        ]);
+        if (started.rows.length === 1) return null;
+        const [row] = (await options.query(held, [key])).rows;
+        if (row) {
+          return {
+            fingerprint: String(row.fingerprint),
+            state: row.state === "done" ? "done" : "pending",
+            ...row.status === null || row.status === void 0 ? {} : { status: Number(row.status) },
+            ...row.body === null || row.body === void 0 ? {} : { body: String(row.body) }
+          };
+        }
+      }
+    },
+    async finish(key, record, keepSeconds, owner) {
+      const { rows } = await options.query(finish, [
+        key,
+        record.fingerprint,
+        record.status,
+        record.body,
+        keepSeconds,
+        owner
+      ]);
+      return rows.length === 1;
+    },
+    async release(key, owner) {
+      await options.query(release, [key, owner]);
+    }
+  };
+}
+
+// src/stores/redis.ts
+function redisNonceStore(options) {
+  const prefix = options.prefix ?? "vinaverse:";
+  return {
+    async claim(nonce, keepUntil) {
+      const reply = await options.command([
+        "SET",
+        `${prefix}nonce:${nonce}`,
+        "1",
+        "NX",
+        "EXAT",
+        String(Math.ceil(keepUntil))
+      ]);
+      return reply === "OK";
+    }
+  };
+}
+var RELEASE_IF_OWNED = `local held = redis.call('GET', KEYS[1])
+if held then
+  local r = cjson.decode(held)
+  if r.state == 'pending' and r.owner == ARGV[1] then return redis.call('DEL', KEYS[1]) end
+end
+return 0`;
+var FINISH_IF_OWNED = `local held = redis.call('GET', KEYS[1])
+if held then
+  local r = cjson.decode(held)
+  if r.state ~= 'pending' or r.owner ~= ARGV[1] then return 0 end
+end
+redis.call('SET', KEYS[1], ARGV[2], 'EX', ARGV[3])
+return 1`;
+function redisIdempotencyStore(options) {
+  const prefix = options.prefix ?? "vinaverse:";
+  const key = (k) => `${prefix}idempotency:${k}`;
+  return {
+    async start(k, fingerprint, pendingSeconds, owner) {
+      for (; ; ) {
+        const set = await options.command([
+          "SET",
+          key(k),
+          JSON.stringify({ fingerprint, state: "pending", owner }),
+          "NX",
+          "EX",
+          seconds(pendingSeconds)
+        ]);
+        if (set === "OK") return null;
+        const held = await options.command(["GET", key(k)]);
+        if (typeof held === "string") {
+          const { owner: _, ...record } = JSON.parse(
+            held
+          );
+          return record;
+        }
+      }
+    },
+    async finish(k, record, keepSeconds, owner) {
+      const stored = await options.command([
+        "EVAL",
+        FINISH_IF_OWNED,
+        "1",
+        key(k),
+        owner,
+        JSON.stringify({ ...record, state: "done" }),
+        seconds(keepSeconds)
+      ]);
+      return Number(stored) === 1;
+    },
+    async release(k, owner) {
+      await options.command(["EVAL", RELEASE_IF_OWNED, "1", key(k), owner]);
+    }
+  };
+}
+function seconds(value) {
+  return String(Math.max(1, Math.ceil(value)));
+}
+
+exports.POSTGRES_TABLES = POSTGRES_TABLES;
+exports.dynamoIdempotencyStore = dynamoIdempotencyStore;
+exports.dynamoNonceStore = dynamoNonceStore;
+exports.postgresIdempotencyStore = postgresIdempotencyStore;
+exports.postgresNonceStore = postgresNonceStore;
+exports.postgresTables = postgresTables;
+exports.redisIdempotencyStore = redisIdempotencyStore;
+exports.redisNonceStore = redisNonceStore;
+//# sourceMappingURL=stores.cjs.map
+//# sourceMappingURL=stores.cjs.map

package/dist/stores.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/stores/dynamodb.ts","../src/stores/postgres.ts","../src/stores/redis.ts"],"names":[],"mappings":"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","file":"stores.cjs","sourcesContent":["// Nonces and idempotent answers in DynamoDB, shared by every Lambda instance.\n// One table with a string partition key `pk` and DynamoDB TTL on the number\n// attribute `expires_at` (DynamoDB deletes expired items lazily, so every\n// condition here also checks the time). Works with the AWS SDK v3 through one\n// function that sends a command by name:\n//   const commands = { PutItem: PutItemCommand, GetItem: GetItemCommand, DeleteItem: DeleteItemCommand };\n//   dynamoNonceStore({ table, send: (name, input) => client.send(new commands[name](input)) })\nimport type {\n  IdempotencyRecord,\n  IdempotencyStore,\n} from '../tools/idempotency.js';\nimport type { NonceStore } from '../tools/nonces.js';\n\nexport type DynamoCommand = 'PutItem' | 'GetItem' | 'DeleteItem';\n\nexport type DynamoSend = (\n  command: DynamoCommand,\n  input: Record<string, unknown>,\n) => Promise<{ Item?: Record<string, { S?: string; N?: string }> } | undefined>;\n\nexport interface DynamoStoreOptions {\n  table: string;\n  send: DynamoSend;\n  /** The clock, in Unix seconds; default the system clock. */\n  now?: () => number;\n  /** Prefix for every partition key, default none: one per environment or signing secret sharing a table. */\n  prefix?: string;\n}\n\nconst ABSENT_OR_EXPIRED = 'attribute_not_exists(pk) OR expires_at < :now';\n\nfunction conditionFailed(error: unknown): boolean {\n  return (\n    (error as { name?: string } | null)?.name ===\n    'ConditionalCheckFailedException'\n  );\n}\n\nexport function dynamoNonceStore(options: DynamoStoreOptions): NonceStore {\n  const now = options.now ?? (() => Math.floor(Date.now() / 1000));\n  return {\n    async claim(nonce, keepUntil) {\n      try {\n        await options.send('PutItem', {\n          TableName: options.table,\n          Item: {\n            pk: { S: `${options.prefix ?? ''}nonce#${nonce}` },\n            expires_at: { N: String(Math.ceil(keepUntil)) },\n          },\n          ConditionExpression: ABSENT_OR_EXPIRED,\n          ExpressionAttributeValues: { ':now': { N: String(now()) } },\n        });\n        return true;\n      } catch (error) {\n        if (conditionFailed(error)) return false;\n        throw error;\n      }\n    },\n  };\n}\n\n// An answer is stored only when the key is free or still this call's pending lease.\nconst FREE_OR_OWNED = `${ABSENT_OR_EXPIRED} OR (#state = :pending AND #owner = :owner)`;\n\nexport function dynamoIdempotencyStore(\n  options: DynamoStoreOptions,\n): IdempotencyStore {\n  const now = options.now ?? (() => Math.floor(Date.now() / 1000));\n  const pk = (key: string) => ({\n    S: `${options.prefix ?? ''}idempotency#${key}`,\n  });\n  const owned = (owner: string) => ({\n    ExpressionAttributeNames: { '#state': 'state', '#owner': 'owner' },\n    ':pending': { S: 'pending' },\n    ':owner': { S: owner },\n  });\n  return {\n    async start(key, fingerprint, pendingSeconds, owner) {\n      for (;;) {\n        try {\n          await options.send('PutItem', {\n            TableName: options.table,\n            Item: {\n              pk: pk(key),\n              fingerprint: { S: fingerprint },\n              state: { S: 'pending' },\n              owner: { S: owner },\n              expires_at: { N: String(now() + Math.ceil(pendingSeconds)) },\n            },\n            ConditionExpression: ABSENT_OR_EXPIRED,\n            ExpressionAttributeValues: { ':now': { N: String(now()) } },\n          });\n          return null;\n        } catch (error) {\n          if (!conditionFailed(error)) throw error;\n        }\n        const held = await options.send('GetItem', {\n          TableName: options.table,\n          Key: { pk: pk(key) },\n          ConsistentRead: true,\n        });\n        const item = held?.Item;\n        // Lapsed between the two calls: try to take it again.\n        if (item && Number(item.expires_at?.N) >= now()) {\n          return {\n            fingerprint: item.fingerprint?.S ?? '',\n            state: item.state?.S === 'done' ? 'done' : 'pending',\n            ...(item.status?.N === undefined\n              ? {}\n              : { status: Number(item.status.N) }),\n            ...(item.body?.S === undefined ? {} : { body: item.body.S }),\n          } satisfies IdempotencyRecord;\n        }\n      }\n    },\n    async finish(key, record, keepSeconds, owner) {\n      const { ExpressionAttributeNames, ...values } = owned(owner);\n      try {\n        await options.send('PutItem', {\n          TableName: options.table,\n          Item: {\n            pk: pk(key),\n            fingerprint: { S: record.fingerprint },\n            state: { S: 'done' },\n            status: { N: String(record.status) },\n            body: { S: record.body },\n            expires_at: { N: String(now() + Math.ceil(keepSeconds)) },\n          },\n          ConditionExpression: FREE_OR_OWNED,\n          ExpressionAttributeNames,\n          ExpressionAttributeValues: {\n            ...values,\n            ':now': { N: String(now()) },\n          },\n        });\n        return true;\n      } catch (error) {\n        if (conditionFailed(error)) return false;\n        throw error;\n      }\n    },\n    async release(key, owner) {\n      const { ExpressionAttributeNames, ...values } = owned(owner);\n      try {\n        await options.send('DeleteItem', {\n          TableName: options.table,\n          Key: { pk: pk(key) },\n          ConditionExpression: '#state = :pending AND #owner = :owner',\n          ExpressionAttributeNames,\n          ExpressionAttributeValues: values,\n        });\n      } catch (error) {\n        if (!conditionFailed(error)) throw error;\n      }\n    },\n  };\n}\n","// Nonces and idempotent answers in PostgreSQL, shared by every instance.\n// Works with any client through one function that runs a parameterised\n// statement and returns its rows: node-postgres `(sql, params) => pool.query(sql, params)`,\n// postgres.js `(sql, params) => sql.unsafe(text, params).then((rows) => ({ rows }))`.\n// Create the tables once (`POSTGRES_TABLES`, `postgresTables(prefix)`, or your\n// migrations); expired rows are reused in place and pruned now and then.\nimport type {\n  IdempotencyRecord,\n  IdempotencyStore,\n} from '../tools/idempotency.js';\nimport type { NonceStore } from '../tools/nonces.js';\n\nexport type PostgresQuery = (\n  sql: string,\n  params: readonly unknown[],\n) => Promise<{ rows: readonly Record<string, unknown>[] }>;\n\nexport interface PostgresStoreOptions {\n  query: PostgresQuery;\n  /** Prune expired rows on one call in this many; default 1000. */\n  pruneEvery?: number;\n  /**\n   * The tables' name prefix, default `vinaverse_` (`vinaverse_nonces`,\n   * `vinaverse_idempotency`): a separate prefix per environment or signing\n   * secret when they share a database. Lower-case letters, digits and `_`.\n   */\n  tablePrefix?: string;\n}\n\nconst PREFIX = /^[a-z_][a-z0-9_]{0,40}$/;\n\n/** The tables the stores use, under a prefix (default `vinaverse_`). */\nexport function postgresTables(tablePrefix = 'vinaverse_'): string {\n  const t = tables(tablePrefix);\n  return `\nCREATE TABLE IF NOT EXISTS ${t.nonces} (\n  nonce text PRIMARY KEY,\n  keep_until timestamptz NOT NULL\n);\nCREATE TABLE IF NOT EXISTS ${t.idempotency} (\n  key text PRIMARY KEY,\n  fingerprint text NOT NULL,\n  state text NOT NULL CHECK (state IN ('pending', 'done')),\n  owner text,\n  status integer,\n  body text,\n  keep_until timestamptz NOT NULL\n);`;\n}\n\n/** The tables the stores use, with the default prefix. */\nexport const POSTGRES_TABLES = postgresTables();\n\nfunction tables(prefix: string): { nonces: string; idempotency: string } {\n  if (!PREFIX.test(prefix)) {\n    throw new TypeError(\n      `tablePrefix must be lower-case letters, digits and _, starting with a letter or _, not ${JSON.stringify(prefix)}`,\n    );\n  }\n  return { nonces: `${prefix}nonces`, idempotency: `${prefix}idempotency` };\n}\n\nfunction pruner(\n  options: PostgresStoreOptions,\n  sql: string,\n): () => Promise<void> {\n  const every = options.pruneEvery ?? 1000;\n  let count = 0;\n  return async () => {\n    count = (count + 1) % every;\n    if (count === 0) await options.query(sql, []);\n  };\n}\n\nexport function postgresNonceStore(options: PostgresStoreOptions): NonceStore {\n  const { nonces } = tables(options.tablePrefix ?? 'vinaverse_');\n  const claim = `INSERT INTO ${nonces} (nonce, keep_until) VALUES ($1, to_timestamp($2))\nON CONFLICT (nonce) DO UPDATE SET keep_until = EXCLUDED.keep_until\nWHERE ${nonces}.keep_until < now()\nRETURNING nonce`;\n  const prune = pruner(\n    options,\n    `DELETE FROM ${nonces} WHERE keep_until < now()`,\n  );\n  return {\n    async claim(nonce, keepUntil) {\n      await prune();\n      const { rows } = await options.query(claim, [nonce, keepUntil]);\n      return rows.length === 1;\n    },\n  };\n}\n\nexport function postgresIdempotencyStore(\n  options: PostgresStoreOptions,\n): IdempotencyStore {\n  const { idempotency: t } = tables(options.tablePrefix ?? 'vinaverse_');\n  const start = `INSERT INTO ${t} (key, fingerprint, state, owner, keep_until)\nVALUES ($1, $2, 'pending', $4, now() + make_interval(secs => $3))\nON CONFLICT (key) DO UPDATE SET fingerprint = EXCLUDED.fingerprint, state = 'pending', owner = EXCLUDED.owner,\n  status = NULL, body = NULL, keep_until = EXCLUDED.keep_until\nWHERE ${t}.keep_until < now()\nRETURNING key`;\n  const held = `SELECT fingerprint, state, status, body FROM ${t}\nWHERE key = $1 AND keep_until >= now()`;\n  // Stored only when the key is free (absent or expired) or still this call's pending lease.\n  const finish = `INSERT INTO ${t} (key, fingerprint, state, owner, status, body, keep_until)\nVALUES ($1, $2, 'done', NULL, $3, $4, now() + make_interval(secs => $5))\nON CONFLICT (key) DO UPDATE SET fingerprint = EXCLUDED.fingerprint, state = 'done', owner = NULL,\n  status = EXCLUDED.status, body = EXCLUDED.body, keep_until = EXCLUDED.keep_until\nWHERE ${t}.keep_until < now() OR (${t}.state = 'pending' AND ${t}.owner = $6)\nRETURNING key`;\n  const release = `DELETE FROM ${t} WHERE key = $1 AND state = 'pending' AND owner = $2`;\n  const prune = pruner(options, `DELETE FROM ${t} WHERE keep_until < now()`);\n  return {\n    async start(key, fingerprint, pendingSeconds, owner) {\n      await prune();\n      for (;;) {\n        const started = await options.query(start, [\n          key,\n          fingerprint,\n          pendingSeconds,\n          owner,\n        ]);\n        if (started.rows.length === 1) return null;\n        const [row] = (await options.query(held, [key])).rows;\n        // Lapsed between the two statements: try to take it again.\n        if (row) {\n          return {\n            fingerprint: String(row.fingerprint),\n            state: row.state === 'done' ? 'done' : 'pending',\n            ...(row.status === null || row.status === undefined\n              ? {}\n              : { status: Number(row.status) }),\n            ...(row.body === null || row.body === undefined\n              ? {}\n              : { body: String(row.body) }),\n          } satisfies IdempotencyRecord;\n        }\n      }\n    },\n    async finish(key, record, keepSeconds, owner) {\n      const { rows } = await options.query(finish, [\n        key,\n        record.fingerprint,\n        record.status,\n        record.body,\n        keepSeconds,\n        owner,\n      ]);\n      return rows.length === 1;\n    },\n    async release(key, owner) {\n      await options.query(release, [key, owner]);\n    },\n  };\n}\n","// Nonces and idempotent answers in Redis, shared by every instance. Works with\n// any client through one function that sends a raw command:\n//   node-redis: (args) => client.sendCommand(args)\n//   ioredis:    (args) => client.call(args[0], ...args.slice(1))\nimport type {\n  IdempotencyRecord,\n  IdempotencyStore,\n} from '../tools/idempotency.js';\nimport type { NonceStore } from '../tools/nonces.js';\n\n/** Sends one Redis command (`['SET', key, value, 'NX', 'EX', '60']`) and returns its reply. */\nexport type RedisCommand = (args: string[]) => Promise<unknown>;\n\nexport interface RedisStoreOptions {\n  command: RedisCommand;\n  /** Prefix for every key; default `vinaverse:`. */\n  prefix?: string;\n}\n\nexport function redisNonceStore(options: RedisStoreOptions): NonceStore {\n  const prefix = options.prefix ?? 'vinaverse:';\n  return {\n    async claim(nonce, keepUntil) {\n      const reply = await options.command([\n        'SET',\n        `${prefix}nonce:${nonce}`,\n        '1',\n        'NX',\n        'EXAT',\n        String(Math.ceil(keepUntil)),\n      ]);\n      return reply === 'OK';\n    },\n  };\n}\n\n// Atomically, on the record a call holds: a pending record goes only when this\n// call's `owner` holds it; an answer is stored only when the key is free or\n// still this call's pending lease (never over another call's, after this\n// call's lease lapsed).\nconst RELEASE_IF_OWNED = `local held = redis.call('GET', KEYS[1])\nif held then\n  local r = cjson.decode(held)\n  if r.state == 'pending' and r.owner == ARGV[1] then return redis.call('DEL', KEYS[1]) end\nend\nreturn 0`;\nconst FINISH_IF_OWNED = `local held = redis.call('GET', KEYS[1])\nif held then\n  local r = cjson.decode(held)\n  if r.state ~= 'pending' or r.owner ~= ARGV[1] then return 0 end\nend\nredis.call('SET', KEYS[1], ARGV[2], 'EX', ARGV[3])\nreturn 1`;\n\nexport function redisIdempotencyStore(\n  options: RedisStoreOptions,\n): IdempotencyStore {\n  const prefix = options.prefix ?? 'vinaverse:';\n  const key = (k: string) => `${prefix}idempotency:${k}`;\n  return {\n    async start(k, fingerprint, pendingSeconds, owner) {\n      for (;;) {\n        const set = await options.command([\n          'SET',\n          key(k),\n          JSON.stringify({ fingerprint, state: 'pending', owner }),\n          'NX',\n          'EX',\n          seconds(pendingSeconds),\n        ]);\n        if (set === 'OK') return null;\n        const held = await options.command(['GET', key(k)]);\n        // Gone between the two commands (it lapsed): try to take it again.\n        if (typeof held === 'string') {\n          const { owner: _, ...record } = JSON.parse(\n            held,\n          ) as IdempotencyRecord & {\n            owner?: string;\n          };\n          return record;\n        }\n      }\n    },\n    async finish(k, record, keepSeconds, owner) {\n      const stored = await options.command([\n        'EVAL',\n        FINISH_IF_OWNED,\n        '1',\n        key(k),\n        owner,\n        JSON.stringify({ ...record, state: 'done' }),\n        seconds(keepSeconds),\n      ]);\n      return Number(stored) === 1;\n    },\n    async release(k, owner) {\n      await options.command(['EVAL', RELEASE_IF_OWNED, '1', key(k), owner]);\n    },\n  };\n}\n\nfunction seconds(value: number): string {\n  return String(Math.max(1, Math.ceil(value)));\n}\n"]}

package/dist/stores.d.cts

@@ -0,0 +1,52 @@
+import { a as IdempotencyStore, c as NonceStore } from './nonces-scwljZwl.cjs';
+
+type DynamoCommand = 'PutItem' | 'GetItem' | 'DeleteItem';
+type DynamoSend = (command: DynamoCommand, input: Record<string, unknown>) => Promise<{
+    Item?: Record<string, {
+        S?: string;
+        N?: string;
+    }>;
+} | undefined>;
+interface DynamoStoreOptions {
+    table: string;
+    send: DynamoSend;
+    /** The clock, in Unix seconds; default the system clock. */
+    now?: () => number;
+    /** Prefix for every partition key, default none: one per environment or signing secret sharing a table. */
+    prefix?: string;
+}
+declare function dynamoNonceStore(options: DynamoStoreOptions): NonceStore;
+declare function dynamoIdempotencyStore(options: DynamoStoreOptions): IdempotencyStore;
+
+type PostgresQuery = (sql: string, params: readonly unknown[]) => Promise<{
+    rows: readonly Record<string, unknown>[];
+}>;
+interface PostgresStoreOptions {
+    query: PostgresQuery;
+    /** Prune expired rows on one call in this many; default 1000. */
+    pruneEvery?: number;
+    /**
+     * The tables' name prefix, default `vinaverse_` (`vinaverse_nonces`,
+     * `vinaverse_idempotency`): a separate prefix per environment or signing
+     * secret when they share a database. Lower-case letters, digits and `_`.
+     */
+    tablePrefix?: string;
+}
+/** The tables the stores use, under a prefix (default `vinaverse_`). */
+declare function postgresTables(tablePrefix?: string): string;
+/** The tables the stores use, with the default prefix. */
+declare const POSTGRES_TABLES: string;
+declare function postgresNonceStore(options: PostgresStoreOptions): NonceStore;
+declare function postgresIdempotencyStore(options: PostgresStoreOptions): IdempotencyStore;
+
+/** Sends one Redis command (`['SET', key, value, 'NX', 'EX', '60']`) and returns its reply. */
+type RedisCommand = (args: string[]) => Promise<unknown>;
+interface RedisStoreOptions {
+    command: RedisCommand;
+    /** Prefix for every key; default `vinaverse:`. */
+    prefix?: string;
+}
+declare function redisNonceStore(options: RedisStoreOptions): NonceStore;
+declare function redisIdempotencyStore(options: RedisStoreOptions): IdempotencyStore;
+
+export { type DynamoCommand, type DynamoSend, type DynamoStoreOptions, POSTGRES_TABLES, type PostgresQuery, type PostgresStoreOptions, type RedisCommand, type RedisStoreOptions, dynamoIdempotencyStore, dynamoNonceStore, postgresIdempotencyStore, postgresNonceStore, postgresTables, redisIdempotencyStore, redisNonceStore };

package/dist/stores.d.ts

@@ -0,0 +1,52 @@
+import { a as IdempotencyStore, c as NonceStore } from './nonces-scwljZwl.js';
+
+type DynamoCommand = 'PutItem' | 'GetItem' | 'DeleteItem';
+type DynamoSend = (command: DynamoCommand, input: Record<string, unknown>) => Promise<{
+    Item?: Record<string, {
+        S?: string;
+        N?: string;
+    }>;
+} | undefined>;
+interface DynamoStoreOptions {
+    table: string;
+    send: DynamoSend;
+    /** The clock, in Unix seconds; default the system clock. */
+    now?: () => number;
+    /** Prefix for every partition key, default none: one per environment or signing secret sharing a table. */
+    prefix?: string;
+}
+declare function dynamoNonceStore(options: DynamoStoreOptions): NonceStore;
+declare function dynamoIdempotencyStore(options: DynamoStoreOptions): IdempotencyStore;
+
+type PostgresQuery = (sql: string, params: readonly unknown[]) => Promise<{
+    rows: readonly Record<string, unknown>[];
+}>;
+interface PostgresStoreOptions {
+    query: PostgresQuery;
+    /** Prune expired rows on one call in this many; default 1000. */
+    pruneEvery?: number;
+    /**
+     * The tables' name prefix, default `vinaverse_` (`vinaverse_nonces`,
+     * `vinaverse_idempotency`): a separate prefix per environment or signing
+     * secret when they share a database. Lower-case letters, digits and `_`.
+     */
+    tablePrefix?: string;
+}
+/** The tables the stores use, under a prefix (default `vinaverse_`). */
+declare function postgresTables(tablePrefix?: string): string;
+/** The tables the stores use, with the default prefix. */
+declare const POSTGRES_TABLES: string;
+declare function postgresNonceStore(options: PostgresStoreOptions): NonceStore;
+declare function postgresIdempotencyStore(options: PostgresStoreOptions): IdempotencyStore;
+
+/** Sends one Redis command (`['SET', key, value, 'NX', 'EX', '60']`) and returns its reply. */
+type RedisCommand = (args: string[]) => Promise<unknown>;
+interface RedisStoreOptions {
+    command: RedisCommand;
+    /** Prefix for every key; default `vinaverse:`. */
+    prefix?: string;
+}
+declare function redisNonceStore(options: RedisStoreOptions): NonceStore;
+declare function redisIdempotencyStore(options: RedisStoreOptions): IdempotencyStore;
+
+export { type DynamoCommand, type DynamoSend, type DynamoStoreOptions, POSTGRES_TABLES, type PostgresQuery, type PostgresStoreOptions, type RedisCommand, type RedisStoreOptions, dynamoIdempotencyStore, dynamoNonceStore, postgresIdempotencyStore, postgresNonceStore, postgresTables, redisIdempotencyStore, redisNonceStore };