@noy-db/s3 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vLannaAi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,41 @@
+# @noy-db/s3
+
+> AWS S3 adapter for [noy-db](https://github.com/vLannaAi/noy-db) — encrypted object storage with zero-knowledge cloud sync.
+
+[![npm](https://img.shields.io/npm/v/@noy-db/s3.svg)](https://www.npmjs.com/package/@noy-db/s3)
+
+## Install
+
+```bash
+pnpm add @noy-db/core @noy-db/s3 @aws-sdk/client-s3
+```
+
+`@aws-sdk/client-s3` is a peer dependency — install it in your app.
+
+## Usage
+
+```ts
+import { createNoydb } from '@noy-db/core'
+import { s3 } from '@noy-db/s3'
+import { S3Client } from '@aws-sdk/client-s3'
+
+const client = new S3Client({ region: 'ap-southeast-1' })
+
+const db = await createNoydb({
+  adapter: s3({ client, bucket: 'noydb-prod', prefix: 'tenant-a/' }),
+  userId: 'alice',
+  passphrase: process.env.NOYDB_PASSPHRASE!,
+})
+```
+
+Each record becomes an S3 object containing only a ciphertext envelope. S3 never sees plaintext — even with full bucket access, an attacker learns nothing without the user's passphrase.
+
+Best suited for:
+
+- Infrequent-access archival with strong privacy guarantees
+- Cold storage of audit trails and backups
+- Lower-cost alternative to DynamoDB for small teams
+
+## License
+
+MIT © vLannaAi — see the [noy-db repo](https://github.com/vLannaAi/noy-db) for full documentation.

package/dist/index.cjs

@@ -0,0 +1,175 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  s3: () => s3
+});
+module.exports = __toCommonJS(index_exports);
+var import_core = require("@noy-db/core");
+var import_client_s3 = require("@aws-sdk/client-s3");
+function s3(options) {
+  const { bucket, prefix = "" } = options;
+  const client = options.client ?? new import_client_s3.S3Client({
+    ...options.region ? { region: options.region } : {},
+    ...options.endpoint ? { endpoint: options.endpoint, forcePathStyle: true } : {}
+  });
+  function objectKey(compartment, collection, id) {
+    const parts = [compartment, collection, `${id}.json`];
+    return prefix ? `${prefix}/${parts.join("/")}` : parts.join("/");
+  }
+  function collPrefix(compartment, collection) {
+    const parts = [compartment, collection, ""];
+    return prefix ? `${prefix}/${parts.join("/")}` : parts.join("/");
+  }
+  function compPrefix(compartment) {
+    return prefix ? `${prefix}/${compartment}/` : `${compartment}/`;
+  }
+  return {
+    name: "s3",
+    async get(compartment, collection, id) {
+      try {
+        const result = await client.send(new import_client_s3.GetObjectCommand({
+          Bucket: bucket,
+          Key: objectKey(compartment, collection, id)
+        }));
+        if (!result.Body) return null;
+        const body = await result.Body.transformToString();
+        return JSON.parse(body);
+      } catch (err) {
+        if (err instanceof Error && (err.name === "NoSuchKey" || err.name === "NotFound")) {
+          return null;
+        }
+        throw err;
+      }
+    },
+    async put(compartment, collection, id, envelope, expectedVersion) {
+      if (expectedVersion !== void 0) {
+        const existing = await this.get(compartment, collection, id);
+        if (existing && existing._v !== expectedVersion) {
+          throw new import_core.ConflictError(existing._v, `Version conflict: expected ${expectedVersion}, found ${existing._v}`);
+        }
+      }
+      await client.send(new import_client_s3.PutObjectCommand({
+        Bucket: bucket,
+        Key: objectKey(compartment, collection, id),
+        Body: JSON.stringify(envelope),
+        ContentType: "application/json"
+      }));
+    },
+    async delete(compartment, collection, id) {
+      await client.send(new import_client_s3.DeleteObjectCommand({
+        Bucket: bucket,
+        Key: objectKey(compartment, collection, id)
+      }));
+    },
+    async list(compartment, collection) {
+      const pfx = collPrefix(compartment, collection);
+      const result = await client.send(new import_client_s3.ListObjectsV2Command({
+        Bucket: bucket,
+        Prefix: pfx
+      }));
+      return (result.Contents ?? []).map((obj) => obj.Key ?? "").filter((k) => k.endsWith(".json")).map((k) => k.slice(pfx.length, -5));
+    },
+    async loadAll(compartment) {
+      const pfx = compPrefix(compartment);
+      const listResult = await client.send(new import_client_s3.ListObjectsV2Command({
+        Bucket: bucket,
+        Prefix: pfx
+      }));
+      const snapshot = {};
+      for (const obj of listResult.Contents ?? []) {
+        const key = obj.Key ?? "";
+        if (!key.endsWith(".json")) continue;
+        const relativePath = key.slice(pfx.length);
+        const parts = relativePath.split("/");
+        if (parts.length !== 2) continue;
+        const collection = parts[0];
+        const id = parts[1].slice(0, -5);
+        if (collection.startsWith("_")) continue;
+        const getResult = await client.send(new import_client_s3.GetObjectCommand({
+          Bucket: bucket,
+          Key: key
+        }));
+        if (!getResult.Body) continue;
+        const body = await getResult.Body.transformToString();
+        if (!snapshot[collection]) snapshot[collection] = {};
+        snapshot[collection][id] = JSON.parse(body);
+      }
+      return snapshot;
+    },
+    async saveAll(compartment, data) {
+      for (const [collection, records] of Object.entries(data)) {
+        for (const [id, envelope] of Object.entries(records)) {
+          await this.put(compartment, collection, id, envelope);
+        }
+      }
+    },
+    async ping() {
+      try {
+        await client.send(new import_client_s3.HeadBucketCommand({ Bucket: bucket }));
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    /**
+     * Paginate over a collection using S3's native `ContinuationToken`.
+     *
+     * Each page does:
+     *   1. ListObjectsV2 with MaxKeys = limit and the previous token
+     *   2. GetObject for every key on the page (in parallel)
+     *
+     * The 2-step pattern is necessary because S3 list responses don't
+     * include object bodies. For very large collections this is N+1 — but
+     * the parallel GETs amortize well, and consumers willing to pay for
+     * stronger pagination should use a different adapter (Dynamo).
+     */
+    async listPage(compartment, collection, cursor, limit = 100) {
+      const pfx = collPrefix(compartment, collection);
+      const listResult = await client.send(new import_client_s3.ListObjectsV2Command({
+        Bucket: bucket,
+        Prefix: pfx,
+        MaxKeys: limit,
+        ...cursor ? { ContinuationToken: cursor } : {}
+      }));
+      const keys = (listResult.Contents ?? []).map((obj) => obj.Key ?? "").filter((k) => k.endsWith(".json"));
+      const items = await Promise.all(keys.map(async (key) => {
+        const id = key.slice(pfx.length, -5);
+        const getResult = await client.send(new import_client_s3.GetObjectCommand({
+          Bucket: bucket,
+          Key: key
+        }));
+        if (!getResult.Body) return null;
+        const body = await getResult.Body.transformToString();
+        return { id, envelope: JSON.parse(body) };
+      }));
+      return {
+        items: items.filter((x) => x !== null),
+        nextCursor: listResult.IsTruncated && listResult.NextContinuationToken ? listResult.NextContinuationToken : null
+      };
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  s3
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { NoydbAdapter, EncryptedEnvelope, CompartmentSnapshot } from '@noy-db/core'\nimport { ConflictError } from '@noy-db/core'\nimport {\n  S3Client as AwsS3Client,\n  GetObjectCommand,\n  PutObjectCommand,\n  DeleteObjectCommand,\n  ListObjectsV2Command,\n  HeadBucketCommand,\n} from '@aws-sdk/client-s3'\n\n/**\n * Minimal interface for an S3 client. Compatible with @aws-sdk/client-s3's\n * S3Client. Exposed so tests (and advanced consumers) can inject a mock or\n * a pre-configured client without going through the default constructor.\n */\nexport interface S3ClientLike {\n  send(command: unknown): Promise<unknown>\n}\n\nexport interface S3Options {\n  /** S3 bucket name. */\n  bucket: string\n  /** Key prefix within the bucket. Default: ''. */\n  prefix?: string\n  /** AWS region. Default: 'us-east-1'. */\n  region?: string\n  /** Custom endpoint (e.g., for MinIO or LocalStack). */\n  endpoint?: string\n  /**\n   * Pre-built S3 client. If provided, the adapter uses this client\n   * directly and ignores `region` / `endpoint`. Useful for tests and\n   * for apps that want to share a client across adapters.\n   */\n  client?: S3ClientLike\n}\n\n/**\n * Create an S3 adapter.\n * Key scheme: `{prefix}/{compartment}/{collection}/{id}.json`\n */\nexport function s3(options: S3Options): NoydbAdapter {\n  const { bucket, prefix = '' } = options\n\n  // Use the injected client if provided (tests, advanced consumers).\n  // The cast through `S3ClientLike` is safe because the AWS S3Client's\n  // `send()` method matches the structural shape — we only call `send`\n  // and inspect the documented response fields.\n  const client = (options.client ?? new AwsS3Client({\n    ...(options.region ? { region: options.region } : {}),\n    ...(options.endpoint ? { endpoint: options.endpoint, forcePathStyle: true } : {}),\n  })) as AwsS3Client\n\n  function objectKey(compartment: string, collection: string, id: string): string {\n    const parts = [compartment, collection, `${id}.json`]\n    return prefix ? `${prefix}/${parts.join('/')}` : parts.join('/')\n  }\n\n  function collPrefix(compartment: string, collection: string): string {\n    const parts = [compartment, collection, '']\n    return prefix ? `${prefix}/${parts.join('/')}` : parts.join('/')\n  }\n\n  function compPrefix(compartment: string): string {\n    return prefix ? `${prefix}/${compartment}/` : `${compartment}/`\n  }\n\n  return {\n    name: 's3',\n\n    async get(compartment, collection, id) {\n      try {\n        const result = await client.send(new GetObjectCommand({\n          Bucket: bucket,\n          Key: objectKey(compartment, collection, id),\n        }))\n\n        if (!result.Body) return null\n        const body = await result.Body.transformToString()\n        return JSON.parse(body) as EncryptedEnvelope\n      } catch (err: unknown) {\n        if (err instanceof Error && (err.name === 'NoSuchKey' || err.name === 'NotFound')) {\n          return null\n        }\n        throw err\n      }\n    },\n\n    async put(compartment, collection, id, envelope, expectedVersion) {\n      if (expectedVersion !== undefined) {\n        const existing = await this.get(compartment, collection, id)\n        if (existing && existing._v !== expectedVersion) {\n          throw new ConflictError(existing._v, `Version conflict: expected ${expectedVersion}, found ${existing._v}`)\n        }\n      }\n\n      await client.send(new PutObjectCommand({\n        Bucket: bucket,\n        Key: objectKey(compartment, collection, id),\n        Body: JSON.stringify(envelope),\n        ContentType: 'application/json',\n      }))\n    },\n\n    async delete(compartment, collection, id) {\n      await client.send(new DeleteObjectCommand({\n        Bucket: bucket,\n        Key: objectKey(compartment, collection, id),\n      }))\n    },\n\n    async list(compartment, collection) {\n      const pfx = collPrefix(compartment, collection)\n      const result = await client.send(new ListObjectsV2Command({\n        Bucket: bucket,\n        Prefix: pfx,\n      }))\n\n      return (result.Contents ?? [])\n        .map(obj => obj.Key ?? '')\n        .filter(k => k.endsWith('.json'))\n        .map(k => k.slice(pfx.length, -5))\n    },\n\n    async loadAll(compartment) {\n      const pfx = compPrefix(compartment)\n      const listResult = await client.send(new ListObjectsV2Command({\n        Bucket: bucket,\n        Prefix: pfx,\n      }))\n\n      const snapshot: CompartmentSnapshot = {}\n\n      for (const obj of listResult.Contents ?? []) {\n        const key = obj.Key ?? ''\n        if (!key.endsWith('.json')) continue\n\n        const relativePath = key.slice(pfx.length)\n        const parts = relativePath.split('/')\n        if (parts.length !== 2) continue\n\n        const collection = parts[0]!\n        const id = parts[1]!.slice(0, -5)\n        if (collection.startsWith('_')) continue\n\n        const getResult = await client.send(new GetObjectCommand({\n          Bucket: bucket,\n          Key: key,\n        }))\n\n        if (!getResult.Body) continue\n        const body = await getResult.Body.transformToString()\n\n        if (!snapshot[collection]) snapshot[collection] = {}\n        snapshot[collection][id] = JSON.parse(body) as EncryptedEnvelope\n      }\n\n      return snapshot\n    },\n\n    async saveAll(compartment, data) {\n      for (const [collection, records] of Object.entries(data)) {\n        for (const [id, envelope] of Object.entries(records)) {\n          await this.put(compartment, collection, id, envelope)\n        }\n      }\n    },\n\n    async ping() {\n      try {\n        await client.send(new HeadBucketCommand({ Bucket: bucket }))\n        return true\n      } catch {\n        return false\n      }\n    },\n\n    /**\n     * Paginate over a collection using S3's native `ContinuationToken`.\n     *\n     * Each page does:\n     *   1. ListObjectsV2 with MaxKeys = limit and the previous token\n     *   2. GetObject for every key on the page (in parallel)\n     *\n     * The 2-step pattern is necessary because S3 list responses don't\n     * include object bodies. For very large collections this is N+1 — but\n     * the parallel GETs amortize well, and consumers willing to pay for\n     * stronger pagination should use a different adapter (Dynamo).\n     */\n    async listPage(compartment, collection, cursor, limit = 100) {\n      const pfx = collPrefix(compartment, collection)\n      const listResult = await client.send(new ListObjectsV2Command({\n        Bucket: bucket,\n        Prefix: pfx,\n        MaxKeys: limit,\n        ...(cursor ? { ContinuationToken: cursor } : {}),\n      }))\n\n      const keys = (listResult.Contents ?? [])\n        .map(obj => obj.Key ?? '')\n        .filter(k => k.endsWith('.json'))\n\n      // Fetch every body in parallel — bounded by `limit` so we never\n      // fan out beyond the page size.\n      const items = await Promise.all(keys.map(async (key) => {\n        const id = key.slice(pfx.length, -5)\n        const getResult = await client.send(new GetObjectCommand({\n          Bucket: bucket,\n          Key: key,\n        }))\n        if (!getResult.Body) return null\n        const body = await getResult.Body.transformToString()\n        return { id, envelope: JSON.parse(body) as EncryptedEnvelope }\n      }))\n\n      return {\n        items: items.filter((x): x is { id: string; envelope: EncryptedEnvelope } => x !== null),\n        nextCursor: listResult.IsTruncated && listResult.NextContinuationToken\n          ? listResult.NextContinuationToken\n          : null,\n      }\n    },\n  }\n}\n"],"mappings":"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","names":["AwsS3Client"]}

package/dist/index.d.cts

@@ -0,0 +1,33 @@
+import { NoydbAdapter } from '@noy-db/core';
+
+/**
+ * Minimal interface for an S3 client. Compatible with @aws-sdk/client-s3's
+ * S3Client. Exposed so tests (and advanced consumers) can inject a mock or
+ * a pre-configured client without going through the default constructor.
+ */
+interface S3ClientLike {
+    send(command: unknown): Promise<unknown>;
+}
+interface S3Options {
+    /** S3 bucket name. */
+    bucket: string;
+    /** Key prefix within the bucket. Default: ''. */
+    prefix?: string;
+    /** AWS region. Default: 'us-east-1'. */
+    region?: string;
+    /** Custom endpoint (e.g., for MinIO or LocalStack). */
+    endpoint?: string;
+    /**
+     * Pre-built S3 client. If provided, the adapter uses this client
+     * directly and ignores `region` / `endpoint`. Useful for tests and
+     * for apps that want to share a client across adapters.
+     */
+    client?: S3ClientLike;
+}
+/**
+ * Create an S3 adapter.
+ * Key scheme: `{prefix}/{compartment}/{collection}/{id}.json`
+ */
+declare function s3(options: S3Options): NoydbAdapter;
+
+export { type S3ClientLike, type S3Options, s3 };

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import { NoydbAdapter } from '@noy-db/core';
+
+/**
+ * Minimal interface for an S3 client. Compatible with @aws-sdk/client-s3's
+ * S3Client. Exposed so tests (and advanced consumers) can inject a mock or
+ * a pre-configured client without going through the default constructor.
+ */
+interface S3ClientLike {
+    send(command: unknown): Promise<unknown>;
+}
+interface S3Options {
+    /** S3 bucket name. */
+    bucket: string;
+    /** Key prefix within the bucket. Default: ''. */
+    prefix?: string;
+    /** AWS region. Default: 'us-east-1'. */
+    region?: string;
+    /** Custom endpoint (e.g., for MinIO or LocalStack). */
+    endpoint?: string;
+    /**
+     * Pre-built S3 client. If provided, the adapter uses this client
+     * directly and ignores `region` / `endpoint`. Useful for tests and
+     * for apps that want to share a client across adapters.
+     */
+    client?: S3ClientLike;
+}
+/**
+ * Create an S3 adapter.
+ * Key scheme: `{prefix}/{compartment}/{collection}/{id}.json`
+ */
+declare function s3(options: S3Options): NoydbAdapter;
+
+export { type S3ClientLike, type S3Options, s3 };

package/dist/index.js

@@ -0,0 +1,157 @@
+// src/index.ts
+import { ConflictError } from "@noy-db/core";
+import {
+  S3Client as AwsS3Client,
+  GetObjectCommand,
+  PutObjectCommand,
+  DeleteObjectCommand,
+  ListObjectsV2Command,
+  HeadBucketCommand
+} from "@aws-sdk/client-s3";
+function s3(options) {
+  const { bucket, prefix = "" } = options;
+  const client = options.client ?? new AwsS3Client({
+    ...options.region ? { region: options.region } : {},
+    ...options.endpoint ? { endpoint: options.endpoint, forcePathStyle: true } : {}
+  });
+  function objectKey(compartment, collection, id) {
+    const parts = [compartment, collection, `${id}.json`];
+    return prefix ? `${prefix}/${parts.join("/")}` : parts.join("/");
+  }
+  function collPrefix(compartment, collection) {
+    const parts = [compartment, collection, ""];
+    return prefix ? `${prefix}/${parts.join("/")}` : parts.join("/");
+  }
+  function compPrefix(compartment) {
+    return prefix ? `${prefix}/${compartment}/` : `${compartment}/`;
+  }
+  return {
+    name: "s3",
+    async get(compartment, collection, id) {
+      try {
+        const result = await client.send(new GetObjectCommand({
+          Bucket: bucket,
+          Key: objectKey(compartment, collection, id)
+        }));
+        if (!result.Body) return null;
+        const body = await result.Body.transformToString();
+        return JSON.parse(body);
+      } catch (err) {
+        if (err instanceof Error && (err.name === "NoSuchKey" || err.name === "NotFound")) {
+          return null;
+        }
+        throw err;
+      }
+    },
+    async put(compartment, collection, id, envelope, expectedVersion) {
+      if (expectedVersion !== void 0) {
+        const existing = await this.get(compartment, collection, id);
+        if (existing && existing._v !== expectedVersion) {
+          throw new ConflictError(existing._v, `Version conflict: expected ${expectedVersion}, found ${existing._v}`);
+        }
+      }
+      await client.send(new PutObjectCommand({
+        Bucket: bucket,
+        Key: objectKey(compartment, collection, id),
+        Body: JSON.stringify(envelope),
+        ContentType: "application/json"
+      }));
+    },
+    async delete(compartment, collection, id) {
+      await client.send(new DeleteObjectCommand({
+        Bucket: bucket,
+        Key: objectKey(compartment, collection, id)
+      }));
+    },
+    async list(compartment, collection) {
+      const pfx = collPrefix(compartment, collection);
+      const result = await client.send(new ListObjectsV2Command({
+        Bucket: bucket,
+        Prefix: pfx
+      }));
+      return (result.Contents ?? []).map((obj) => obj.Key ?? "").filter((k) => k.endsWith(".json")).map((k) => k.slice(pfx.length, -5));
+    },
+    async loadAll(compartment) {
+      const pfx = compPrefix(compartment);
+      const listResult = await client.send(new ListObjectsV2Command({
+        Bucket: bucket,
+        Prefix: pfx
+      }));
+      const snapshot = {};
+      for (const obj of listResult.Contents ?? []) {
+        const key = obj.Key ?? "";
+        if (!key.endsWith(".json")) continue;
+        const relativePath = key.slice(pfx.length);
+        const parts = relativePath.split("/");
+        if (parts.length !== 2) continue;
+        const collection = parts[0];
+        const id = parts[1].slice(0, -5);
+        if (collection.startsWith("_")) continue;
+        const getResult = await client.send(new GetObjectCommand({
+          Bucket: bucket,
+          Key: key
+        }));
+        if (!getResult.Body) continue;
+        const body = await getResult.Body.transformToString();
+        if (!snapshot[collection]) snapshot[collection] = {};
+        snapshot[collection][id] = JSON.parse(body);
+      }
+      return snapshot;
+    },
+    async saveAll(compartment, data) {
+      for (const [collection, records] of Object.entries(data)) {
+        for (const [id, envelope] of Object.entries(records)) {
+          await this.put(compartment, collection, id, envelope);
+        }
+      }
+    },
+    async ping() {
+      try {
+        await client.send(new HeadBucketCommand({ Bucket: bucket }));
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    /**
+     * Paginate over a collection using S3's native `ContinuationToken`.
+     *
+     * Each page does:
+     *   1. ListObjectsV2 with MaxKeys = limit and the previous token
+     *   2. GetObject for every key on the page (in parallel)
+     *
+     * The 2-step pattern is necessary because S3 list responses don't
+     * include object bodies. For very large collections this is N+1 — but
+     * the parallel GETs amortize well, and consumers willing to pay for
+     * stronger pagination should use a different adapter (Dynamo).
+     */
+    async listPage(compartment, collection, cursor, limit = 100) {
+      const pfx = collPrefix(compartment, collection);
+      const listResult = await client.send(new ListObjectsV2Command({
+        Bucket: bucket,
+        Prefix: pfx,
+        MaxKeys: limit,
+        ...cursor ? { ContinuationToken: cursor } : {}
+      }));
+      const keys = (listResult.Contents ?? []).map((obj) => obj.Key ?? "").filter((k) => k.endsWith(".json"));
+      const items = await Promise.all(keys.map(async (key) => {
+        const id = key.slice(pfx.length, -5);
+        const getResult = await client.send(new GetObjectCommand({
+          Bucket: bucket,
+          Key: key
+        }));
+        if (!getResult.Body) return null;
+        const body = await getResult.Body.transformToString();
+        return { id, envelope: JSON.parse(body) };
+      }));
+      return {
+        items: items.filter((x) => x !== null),
+        nextCursor: listResult.IsTruncated && listResult.NextContinuationToken ? listResult.NextContinuationToken : null
+      };
+    }
+  };
+}
+export {
+  s3
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { NoydbAdapter, EncryptedEnvelope, CompartmentSnapshot } from '@noy-db/core'\nimport { ConflictError } from '@noy-db/core'\nimport {\n  S3Client as AwsS3Client,\n  GetObjectCommand,\n  PutObjectCommand,\n  DeleteObjectCommand,\n  ListObjectsV2Command,\n  HeadBucketCommand,\n} from '@aws-sdk/client-s3'\n\n/**\n * Minimal interface for an S3 client. Compatible with @aws-sdk/client-s3's\n * S3Client. Exposed so tests (and advanced consumers) can inject a mock or\n * a pre-configured client without going through the default constructor.\n */\nexport interface S3ClientLike {\n  send(command: unknown): Promise<unknown>\n}\n\nexport interface S3Options {\n  /** S3 bucket name. */\n  bucket: string\n  /** Key prefix within the bucket. Default: ''. */\n  prefix?: string\n  /** AWS region. Default: 'us-east-1'. */\n  region?: string\n  /** Custom endpoint (e.g., for MinIO or LocalStack). */\n  endpoint?: string\n  /**\n   * Pre-built S3 client. If provided, the adapter uses this client\n   * directly and ignores `region` / `endpoint`. Useful for tests and\n   * for apps that want to share a client across adapters.\n   */\n  client?: S3ClientLike\n}\n\n/**\n * Create an S3 adapter.\n * Key scheme: `{prefix}/{compartment}/{collection}/{id}.json`\n */\nexport function s3(options: S3Options): NoydbAdapter {\n  const { bucket, prefix = '' } = options\n\n  // Use the injected client if provided (tests, advanced consumers).\n  // The cast through `S3ClientLike` is safe because the AWS S3Client's\n  // `send()` method matches the structural shape — we only call `send`\n  // and inspect the documented response fields.\n  const client = (options.client ?? new AwsS3Client({\n    ...(options.region ? { region: options.region } : {}),\n    ...(options.endpoint ? { endpoint: options.endpoint, forcePathStyle: true } : {}),\n  })) as AwsS3Client\n\n  function objectKey(compartment: string, collection: string, id: string): string {\n    const parts = [compartment, collection, `${id}.json`]\n    return prefix ? `${prefix}/${parts.join('/')}` : parts.join('/')\n  }\n\n  function collPrefix(compartment: string, collection: string): string {\n    const parts = [compartment, collection, '']\n    return prefix ? `${prefix}/${parts.join('/')}` : parts.join('/')\n  }\n\n  function compPrefix(compartment: string): string {\n    return prefix ? `${prefix}/${compartment}/` : `${compartment}/`\n  }\n\n  return {\n    name: 's3',\n\n    async get(compartment, collection, id) {\n      try {\n        const result = await client.send(new GetObjectCommand({\n          Bucket: bucket,\n          Key: objectKey(compartment, collection, id),\n        }))\n\n        if (!result.Body) return null\n        const body = await result.Body.transformToString()\n        return JSON.parse(body) as EncryptedEnvelope\n      } catch (err: unknown) {\n        if (err instanceof Error && (err.name === 'NoSuchKey' || err.name === 'NotFound')) {\n          return null\n        }\n        throw err\n      }\n    },\n\n    async put(compartment, collection, id, envelope, expectedVersion) {\n      if (expectedVersion !== undefined) {\n        const existing = await this.get(compartment, collection, id)\n        if (existing && existing._v !== expectedVersion) {\n          throw new ConflictError(existing._v, `Version conflict: expected ${expectedVersion}, found ${existing._v}`)\n        }\n      }\n\n      await client.send(new PutObjectCommand({\n        Bucket: bucket,\n        Key: objectKey(compartment, collection, id),\n        Body: JSON.stringify(envelope),\n        ContentType: 'application/json',\n      }))\n    },\n\n    async delete(compartment, collection, id) {\n      await client.send(new DeleteObjectCommand({\n        Bucket: bucket,\n        Key: objectKey(compartment, collection, id),\n      }))\n    },\n\n    async list(compartment, collection) {\n      const pfx = collPrefix(compartment, collection)\n      const result = await client.send(new ListObjectsV2Command({\n        Bucket: bucket,\n        Prefix: pfx,\n      }))\n\n      return (result.Contents ?? [])\n        .map(obj => obj.Key ?? '')\n        .filter(k => k.endsWith('.json'))\n        .map(k => k.slice(pfx.length, -5))\n    },\n\n    async loadAll(compartment) {\n      const pfx = compPrefix(compartment)\n      const listResult = await client.send(new ListObjectsV2Command({\n        Bucket: bucket,\n        Prefix: pfx,\n      }))\n\n      const snapshot: CompartmentSnapshot = {}\n\n      for (const obj of listResult.Contents ?? []) {\n        const key = obj.Key ?? ''\n        if (!key.endsWith('.json')) continue\n\n        const relativePath = key.slice(pfx.length)\n        const parts = relativePath.split('/')\n        if (parts.length !== 2) continue\n\n        const collection = parts[0]!\n        const id = parts[1]!.slice(0, -5)\n        if (collection.startsWith('_')) continue\n\n        const getResult = await client.send(new GetObjectCommand({\n          Bucket: bucket,\n          Key: key,\n        }))\n\n        if (!getResult.Body) continue\n        const body = await getResult.Body.transformToString()\n\n        if (!snapshot[collection]) snapshot[collection] = {}\n        snapshot[collection][id] = JSON.parse(body) as EncryptedEnvelope\n      }\n\n      return snapshot\n    },\n\n    async saveAll(compartment, data) {\n      for (const [collection, records] of Object.entries(data)) {\n        for (const [id, envelope] of Object.entries(records)) {\n          await this.put(compartment, collection, id, envelope)\n        }\n      }\n    },\n\n    async ping() {\n      try {\n        await client.send(new HeadBucketCommand({ Bucket: bucket }))\n        return true\n      } catch {\n        return false\n      }\n    },\n\n    /**\n     * Paginate over a collection using S3's native `ContinuationToken`.\n     *\n     * Each page does:\n     *   1. ListObjectsV2 with MaxKeys = limit and the previous token\n     *   2. GetObject for every key on the page (in parallel)\n     *\n     * The 2-step pattern is necessary because S3 list responses don't\n     * include object bodies. For very large collections this is N+1 — but\n     * the parallel GETs amortize well, and consumers willing to pay for\n     * stronger pagination should use a different adapter (Dynamo).\n     */\n    async listPage(compartment, collection, cursor, limit = 100) {\n      const pfx = collPrefix(compartment, collection)\n      const listResult = await client.send(new ListObjectsV2Command({\n        Bucket: bucket,\n        Prefix: pfx,\n        MaxKeys: limit,\n        ...(cursor ? { ContinuationToken: cursor } : {}),\n      }))\n\n      const keys = (listResult.Contents ?? [])\n        .map(obj => obj.Key ?? '')\n        .filter(k => k.endsWith('.json'))\n\n      // Fetch every body in parallel — bounded by `limit` so we never\n      // fan out beyond the page size.\n      const items = await Promise.all(keys.map(async (key) => {\n        const id = key.slice(pfx.length, -5)\n        const getResult = await client.send(new GetObjectCommand({\n          Bucket: bucket,\n          Key: key,\n        }))\n        if (!getResult.Body) return null\n        const body = await getResult.Body.transformToString()\n        return { id, envelope: JSON.parse(body) as EncryptedEnvelope }\n      }))\n\n      return {\n        items: items.filter((x): x is { id: string; envelope: EncryptedEnvelope } => x !== null),\n        nextCursor: listResult.IsTruncated && listResult.NextContinuationToken\n          ? listResult.NextContinuationToken\n          : null,\n      }\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@noy-db/s3",
+  "version": "0.5.0",
+  "description": "AWS S3 adapter for noy-db — encrypted object storage with zero-knowledge cloud sync",
+  "license": "MIT",
+  "author": "vLannaAi <vicio@lanna.ai>",
+  "homepage": "https://github.com/vLannaAi/noy-db/tree/main/packages/s3#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vLannaAi/noy-db.git",
+    "directory": "packages/s3"
+  },
+  "bugs": {
+    "url": "https://github.com/vLannaAi/noy-db/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-s3": "^3.0.0",
+    "@noy-db/core": "^0.5.0"
+  },
+  "devDependencies": {
+    "@aws-sdk/client-s3": "^3.0.0",
+    "@noy-db/core": "0.5.0"
+  },
+  "keywords": [
+    "noy-db",
+    "adapter",
+    "s3",
+    "aws",
+    "object-storage",
+    "cloud",
+    "encryption",
+    "zero-knowledge"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit"
+  }
+}