@syncular/server 0.0.4-26 → 0.0.4-33

package/dist/blobs/adapters/s3.js

@@ -1,219 +0,0 @@
-/**
- * S3-compatible blob storage adapter.
- *
- * Works with AWS S3, Cloudflare R2, MinIO, and other S3-compatible services.
- * Requires @aws-sdk/client-s3 and @aws-sdk/s3-request-presigner as peer dependencies.
- */
-/**
- * Create an S3-compatible blob storage adapter.
- *
- * @example
- * ```typescript
- * import { S3Client, PutObjectCommand, GetObjectCommand, HeadObjectCommand, DeleteObjectCommand } from '@aws-sdk/client-s3';
- * import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
- *
- * const adapter = createS3BlobStorageAdapter({
- *   client: new S3Client({ region: 'us-east-1' }),
- *   bucket: 'my-bucket',
- *   keyPrefix: 'blobs/',
- *   commands: { PutObjectCommand, GetObjectCommand, HeadObjectCommand, DeleteObjectCommand },
- *   getSignedUrl,
- * });
- * ```
- */
-export function createS3BlobStorageAdapter(options) {
-    const { client, bucket, keyPrefix = '', commands, getSignedUrl, requireChecksum = true, } = options;
-    function getKey(hash) {
-        // Remove "sha256:" prefix and use hex as key
-        const hex = hash.startsWith('sha256:') ? hash.slice(7) : hash;
-        return `${keyPrefix}${hex}`;
-    }
-    return {
-        name: 's3',
-        async signUpload(opts) {
-            const key = getKey(opts.hash);
-            // Extract hex hash for checksum (S3 expects base64-encoded SHA-256)
-            const hexHash = opts.hash.startsWith('sha256:')
-                ? opts.hash.slice(7)
-                : opts.hash;
-            // Convert hex to base64 for S3 checksum header
-            const checksumBase64 = hexToBase64(hexHash);
-            const commandInput = {
-                Bucket: bucket,
-                Key: key,
-                ContentLength: opts.size,
-                ContentType: opts.mimeType,
-            };
-            if (requireChecksum) {
-                commandInput.ChecksumSHA256 = checksumBase64;
-            }
-            const command = new commands.PutObjectCommand(commandInput);
-            const url = await getSignedUrl(client, command, {
-                expiresIn: opts.expiresIn,
-            });
-            const headers = {
-                'Content-Type': opts.mimeType,
-                'Content-Length': String(opts.size),
-            };
-            if (requireChecksum) {
-                headers['x-amz-checksum-sha256'] = checksumBase64;
-            }
-            return {
-                url,
-                method: 'PUT',
-                headers,
-            };
-        },
-        async signDownload(opts) {
-            const key = getKey(opts.hash);
-            const command = new commands.GetObjectCommand({
-                Bucket: bucket,
-                Key: key,
-            });
-            return getSignedUrl(client, command, { expiresIn: opts.expiresIn });
-        },
-        async exists(hash) {
-            const key = getKey(hash);
-            try {
-                const command = new commands.HeadObjectCommand({
-                    Bucket: bucket,
-                    Key: key,
-                });
-                await client.send(command);
-                return true;
-            }
-            catch (err) {
-                // Check for NotFound error
-                if (isNotFoundError(err)) {
-                    return false;
-                }
-                throw err;
-            }
-        },
-        async delete(hash) {
-            const key = getKey(hash);
-            const command = new commands.DeleteObjectCommand({
-                Bucket: bucket,
-                Key: key,
-            });
-            await client.send(command);
-        },
-        async getMetadata(hash) {
-            const key = getKey(hash);
-            try {
-                const command = new commands.HeadObjectCommand({
-                    Bucket: bucket,
-                    Key: key,
-                });
-                const response = (await client.send(command));
-                return {
-                    size: response.ContentLength ?? 0,
-                    mimeType: response.ContentType,
-                };
-            }
-            catch (err) {
-                if (isNotFoundError(err)) {
-                    return null;
-                }
-                throw err;
-            }
-        },
-        async put(hash, data) {
-            const key = getKey(hash);
-            const command = new commands.PutObjectCommand({
-                Bucket: bucket,
-                Key: key,
-                Body: data,
-                ContentLength: data.length,
-                ContentType: 'application/octet-stream',
-            });
-            await client.send(command);
-        },
-        async get(hash) {
-            const key = getKey(hash);
-            try {
-                const command = new commands.GetObjectCommand({
-                    Bucket: bucket,
-                    Key: key,
-                });
-                const response = (await client.send(command));
-                if (!response.Body)
-                    return null;
-                return response.Body.transformToByteArray();
-            }
-            catch (err) {
-                if (isNotFoundError(err)) {
-                    return null;
-                }
-                throw err;
-            }
-        },
-        async getStream(hash) {
-            const key = getKey(hash);
-            try {
-                const command = new commands.GetObjectCommand({
-                    Bucket: bucket,
-                    Key: key,
-                });
-                const response = (await client.send(command));
-                if (!response.Body)
-                    return null;
-                return response.Body.transformToWebStream();
-            }
-            catch (err) {
-                if (isNotFoundError(err)) {
-                    return null;
-                }
-                throw err;
-            }
-        },
-    };
-}
-function isNotFoundError(err) {
-    if (typeof err !== 'object' || err === null)
-        return false;
-    const e = err;
-    return (e.name === 'NotFound' ||
-        e.name === 'NoSuchKey' ||
-        e.$metadata?.httpStatusCode === 404);
-}
-function hexToBase64(hex) {
-    const bytes = new Uint8Array(hex.length / 2);
-    for (let i = 0; i < bytes.length; i++) {
-        bytes[i] = Number.parseInt(hex.slice(i * 2, i * 2 + 2), 16);
-    }
-    // Use Buffer if available (Node/Bun), otherwise manual base64
-    if (typeof Buffer !== 'undefined') {
-        return Buffer.from(bytes).toString('base64');
-    }
-    // Manual base64 encoding
-    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
-    let result = '';
-    const len = bytes.length;
-    const remainder = len % 3;
-    for (let i = 0; i < len - remainder; i += 3) {
-        const a = bytes[i];
-        const b = bytes[i + 1];
-        const c = bytes[i + 2];
-        result +=
-            chars.charAt((a >> 2) & 0x3f) +
-                chars.charAt(((a << 4) | (b >> 4)) & 0x3f) +
-                chars.charAt(((b << 2) | (c >> 6)) & 0x3f) +
-                chars.charAt(c & 0x3f);
-    }
-    if (remainder === 1) {
-        const a = bytes[len - 1];
-        result += `${chars.charAt((a >> 2) & 0x3f) + chars.charAt((a << 4) & 0x3f)}==`;
-    }
-    else if (remainder === 2) {
-        const a = bytes[len - 2];
-        const b = bytes[len - 1];
-        result +=
-            chars.charAt((a >> 2) & 0x3f) +
-                chars.charAt(((a << 4) | (b >> 4)) & 0x3f) +
-                chars.charAt((b << 2) & 0x3f) +
-                '=';
-    }
-    return result;
-}
-//# sourceMappingURL=s3.js.map

package/dist/blobs/adapters/s3.js.map

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

package/src/blobs/adapters/filesystem.test.ts

@@ -1,132 +0,0 @@
-import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
-import { mkdtemp, readdir, rm } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import type { BlobStorageAdapter } from '@syncular/core';
-import { createHmacTokenSigner } from './database';
-import { createFilesystemBlobStorageAdapter } from './filesystem';
-
-let basePath: string;
-let adapter: BlobStorageAdapter;
-
-beforeEach(async () => {
-  basePath = await mkdtemp(join(tmpdir(), 'syncular-blob-test-'));
-  adapter = createFilesystemBlobStorageAdapter({
-    basePath,
-    baseUrl: 'https://example.com/api/sync',
-    tokenSigner: createHmacTokenSigner('test-secret'),
-  });
-});
-
-afterEach(async () => {
-  await rm(basePath, { recursive: true, force: true });
-});
-
-const testHash =
-  'sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890';
-const testData = new TextEncoder().encode('hello world');
-
-describe('createFilesystemBlobStorageAdapter', () => {
-  test('put + get round-trip', async () => {
-    await adapter.put!(testHash, testData);
-    const result = await adapter.get!(testHash);
-    expect(result).toEqual(testData);
-  });
-
-  test('putStream + getStream round-trip', async () => {
-    const inputStream = new ReadableStream<Uint8Array>({
-      start(controller) {
-        controller.enqueue(testData);
-        controller.close();
-      },
-    });
-
-    await adapter.putStream!(testHash, inputStream);
-
-    const outputStream = await adapter.getStream!(testHash);
-    expect(outputStream).not.toBeNull();
-
-    const reader = outputStream!.getReader();
-    const chunks: Uint8Array[] = [];
-    while (true) {
-      const { done, value } = await reader.read();
-      if (done) break;
-      chunks.push(value);
-    }
-    const result = new Uint8Array(chunks.reduce((acc, c) => acc + c.length, 0));
-    let offset = 0;
-    for (const chunk of chunks) {
-      result.set(chunk, offset);
-      offset += chunk.length;
-    }
-    expect(result).toEqual(testData);
-  });
-
-  test('get returns null for missing blob', async () => {
-    const result = await adapter.get!(testHash);
-    expect(result).toBeNull();
-  });
-
-  test('getStream returns null for missing blob', async () => {
-    const result = await adapter.getStream!(testHash);
-    expect(result).toBeNull();
-  });
-
-  test('exists returns true after put', async () => {
-    expect(await adapter.exists(testHash)).toBe(false);
-    await adapter.put!(testHash, testData);
-    expect(await adapter.exists(testHash)).toBe(true);
-  });
-
-  test('delete removes the blob', async () => {
-    await adapter.put!(testHash, testData);
-    expect(await adapter.exists(testHash)).toBe(true);
-    await adapter.delete(testHash);
-    expect(await adapter.exists(testHash)).toBe(false);
-  });
-
-  test('delete is idempotent for missing blob', async () => {
-    await adapter.delete(testHash);
-  });
-
-  test('getMetadata returns size', async () => {
-    await adapter.put!(testHash, testData);
-    const meta = await adapter.getMetadata!(testHash);
-    expect(meta).toEqual({ size: testData.length });
-  });
-
-  test('getMetadata returns null for missing blob', async () => {
-    const meta = await adapter.getMetadata!(testHash);
-    expect(meta).toBeNull();
-  });
-
-  test('creates hash-based subdirectories', async () => {
-    await adapter.put!(testHash, testData);
-    // hex = abcdef..., so subdirs should be "ab/cd"
-    const firstLevel = await readdir(basePath);
-    expect(firstLevel).toContain('ab');
-    const secondLevel = await readdir(join(basePath, 'ab'));
-    expect(secondLevel).toContain('cd');
-  });
-
-  test('signUpload returns a token URL', async () => {
-    const result = await adapter.signUpload({
-      hash: testHash,
-      size: 100,
-      mimeType: 'application/octet-stream',
-      expiresIn: 60,
-    });
-    expect(result.url).toContain('/blobs/');
-    expect(result.url).toContain('token=');
-    expect(result.method).toBe('PUT');
-  });
-
-  test('signDownload returns a token URL', async () => {
-    const url = await adapter.signDownload({
-      hash: testHash,
-      expiresIn: 60,
-    });
-    expect(url).toContain('/blobs/');
-    expect(url).toContain('token=');
-  });
-});

package/src/blobs/adapters/filesystem.ts

@@ -1,189 +0,0 @@
-/**
- * Filesystem blob storage adapter.
- *
- * Stores blobs as files on disk with 2-level hash-based subdirectories.
- * Uploads/downloads go through the server's blob routes using signed tokens
- * (same pattern as the database adapter).
- */
-
-import {
-  mkdir,
-  open,
-  readFile,
-  rename,
-  stat,
-  unlink,
-  writeFile,
-} from 'node:fs/promises';
-import { dirname, join } from 'node:path';
-import type {
-  BlobSignDownloadOptions,
-  BlobSignedUpload,
-  BlobSignUploadOptions,
-  BlobStorageAdapter,
-} from '@syncular/core';
-import type { BlobTokenSigner } from './database';
-
-export interface FilesystemBlobStorageAdapterOptions {
-  /** Directory root for blob files */
-  basePath: string;
-  /** Server base URL for upload/download routes (e.g. "/api/sync") */
-  baseUrl: string;
-  /** Token signer for authorization */
-  tokenSigner: BlobTokenSigner;
-}
-
-/**
- * Resolve hash to a 2-level subdirectory path:
- * `{basePath}/{hex[0..2]}/{hex[2..4]}/{hex}`
- */
-function hashToFilePath(basePath: string, hash: string): string {
-  const hex = hash.startsWith('sha256:') ? hash.slice(7) : hash;
-  return join(basePath, hex.slice(0, 2), hex.slice(2, 4), hex);
-}
-
-function tmpPath(filePath: string): string {
-  return `${filePath}.${Date.now()}.tmp`;
-}
-
-/**
- * Create a filesystem blob storage adapter.
- *
- * @example
- * ```typescript
- * const adapter = createFilesystemBlobStorageAdapter({
- *   basePath: '/data/blobs',
- *   baseUrl: 'https://api.example.com/api/sync',
- *   tokenSigner: createHmacTokenSigner(process.env.BLOB_SECRET!),
- * });
- * ```
- */
-export function createFilesystemBlobStorageAdapter(
-  options: FilesystemBlobStorageAdapterOptions
-): BlobStorageAdapter {
-  const { basePath, tokenSigner } = options;
-  const normalizedBaseUrl = options.baseUrl.replace(/\/$/, '');
-
-  return {
-    name: 'filesystem',
-
-    async signUpload(opts: BlobSignUploadOptions): Promise<BlobSignedUpload> {
-      const expiresAt = Date.now() + opts.expiresIn * 1000;
-      const token = await tokenSigner.sign(
-        { hash: opts.hash, action: 'upload', expiresAt },
-        opts.expiresIn
-      );
-
-      const url = `${normalizedBaseUrl}/blobs/${encodeURIComponent(opts.hash)}/upload?token=${encodeURIComponent(token)}`;
-
-      return {
-        url,
-        method: 'PUT',
-        headers: {
-          'Content-Type': opts.mimeType,
-          'Content-Length': String(opts.size),
-        },
-      };
-    },
-
-    async signDownload(opts: BlobSignDownloadOptions): Promise<string> {
-      const expiresAt = Date.now() + opts.expiresIn * 1000;
-      const token = await tokenSigner.sign(
-        { hash: opts.hash, action: 'download', expiresAt },
-        opts.expiresIn
-      );
-
-      return `${normalizedBaseUrl}/blobs/${encodeURIComponent(opts.hash)}/download?token=${encodeURIComponent(token)}`;
-    },
-
-    async exists(hash: string): Promise<boolean> {
-      try {
-        await stat(hashToFilePath(basePath, hash));
-        return true;
-      } catch {
-        return false;
-      }
-    },
-
-    async delete(hash: string): Promise<void> {
-      try {
-        await unlink(hashToFilePath(basePath, hash));
-      } catch (err) {
-        if ((err as NodeJS.ErrnoException).code !== 'ENOENT') throw err;
-      }
-    },
-
-    async getMetadata(
-      hash: string
-    ): Promise<{ size: number; mimeType?: string } | null> {
-      try {
-        const s = await stat(hashToFilePath(basePath, hash));
-        return { size: s.size };
-      } catch {
-        return null;
-      }
-    },
-
-    async put(hash: string, data: Uint8Array): Promise<void> {
-      const filePath = hashToFilePath(basePath, hash);
-      const tmp = tmpPath(filePath);
-      await mkdir(dirname(filePath), { recursive: true });
-      await writeFile(tmp, data);
-      await rename(tmp, filePath);
-    },
-
-    async putStream(
-      hash: string,
-      stream: ReadableStream<Uint8Array>
-    ): Promise<void> {
-      const filePath = hashToFilePath(basePath, hash);
-      const tmp = tmpPath(filePath);
-      await mkdir(dirname(filePath), { recursive: true });
-
-      const fh = await open(tmp, 'w');
-      try {
-        const reader = stream.getReader();
-        while (true) {
-          const { done, value } = await reader.read();
-          if (done) break;
-          await fh.write(value);
-        }
-      } finally {
-        await fh.close();
-      }
-
-      await rename(tmp, filePath);
-    },
-
-    async get(hash: string): Promise<Uint8Array | null> {
-      try {
-        const buf = await readFile(hashToFilePath(basePath, hash));
-        return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
-      } catch (err) {
-        if ((err as NodeJS.ErrnoException).code === 'ENOENT') return null;
-        throw err;
-      }
-    },
-
-    async getStream(hash: string): Promise<ReadableStream<Uint8Array> | null> {
-      let data: Buffer;
-      try {
-        data = await readFile(hashToFilePath(basePath, hash));
-      } catch (err) {
-        if ((err as NodeJS.ErrnoException).code === 'ENOENT') return null;
-        throw err;
-      }
-      const bytes = new Uint8Array(
-        data.buffer,
-        data.byteOffset,
-        data.byteLength
-      );
-      return new ReadableStream<Uint8Array>({
-        start(controller) {
-          controller.enqueue(bytes);
-          controller.close();
-        },
-      });
-    },
-  };
-}