@syncular/server 0.0.6-95 → 0.1.0

package/dist/cloudflare/r2.d.ts

@@ -0,0 +1,180 @@
+/**
+ * R2 blob storage adapter using native R2Bucket binding.
+ *
+ * This adapter stores blobs in Cloudflare R2 using the native binding,
+ * without requiring the AWS SDK. Since R2 bindings don't support presigned URLs,
+ * this adapter generates signed tokens that allow uploads/downloads through
+ * the Worker's blob routes (similar to the database adapter).
+ */
+/**
+ * Options for signing an upload URL.
+ */
+export interface BlobSignUploadOptions {
+    /** SHA-256 hash (for naming and checksum validation) */
+    hash: string;
+    /** Optional tenant/partition namespace for storage lookups */
+    partitionId?: string;
+    /** Content size in bytes */
+    size: number;
+    /** MIME type */
+    mimeType: string;
+    /** URL expiration in seconds */
+    expiresIn: number;
+}
+/**
+ * Result of signing an upload URL.
+ */
+export interface BlobSignedUpload {
+    /** The URL to upload to */
+    url: string;
+    /** HTTP method */
+    method: 'PUT' | 'POST';
+    /** Required headers */
+    headers?: Record<string, string>;
+}
+/**
+ * Options for signing a download URL.
+ */
+export interface BlobSignDownloadOptions {
+    /** SHA-256 hash */
+    hash: string;
+    /** Optional tenant/partition namespace for storage lookups */
+    partitionId?: string;
+    /** URL expiration in seconds */
+    expiresIn: number;
+}
+/**
+ * Adapter for blob storage backends.
+ * Implements the same interface as @syncular/core BlobStorageAdapter.
+ */
+export interface BlobStorageAdapter {
+    /** Adapter name for logging/debugging */
+    readonly name: string;
+    /**
+     * Generate a presigned URL for uploading a blob.
+     */
+    signUpload(options: BlobSignUploadOptions): Promise<BlobSignedUpload>;
+    /**
+     * Generate a presigned URL for downloading a blob.
+     */
+    signDownload(options: BlobSignDownloadOptions): Promise<string>;
+    /**
+     * Check if a blob exists in storage.
+     */
+    exists(hash: string, options?: {
+        partitionId?: string;
+    }): Promise<boolean>;
+    /**
+     * Delete a blob (for garbage collection).
+     */
+    delete(hash: string, options?: {
+        partitionId?: string;
+    }): Promise<void>;
+    /**
+     * Get blob metadata from storage (optional).
+     */
+    getMetadata?(hash: string, options?: {
+        partitionId?: string;
+    }): Promise<{
+        size: number;
+        mimeType?: string;
+    } | null>;
+    /**
+     * Store blob data directly (for adapters that support direct storage).
+     */
+    put?(hash: string, data: Uint8Array, metadata?: Record<string, unknown>, options?: {
+        partitionId?: string;
+    }): Promise<void>;
+    /**
+     * Store blob data directly from a stream.
+     */
+    putStream?(hash: string, stream: ReadableStream<Uint8Array>, metadata?: Record<string, unknown>, options?: {
+        partitionId?: string;
+    }): Promise<void>;
+    /**
+     * Get blob data directly (for adapters that support direct retrieval).
+     */
+    get?(hash: string, options?: {
+        partitionId?: string;
+    }): Promise<Uint8Array | null>;
+    /**
+     * Get blob data directly as a stream.
+     */
+    getStream?(hash: string, options?: {
+        partitionId?: string;
+    }): Promise<ReadableStream<Uint8Array> | null>;
+}
+/**
+ * Token signer interface for creating/verifying upload/download tokens.
+ */
+export interface BlobTokenSigner {
+    /**
+     * Sign a token for blob upload/download authorization.
+     * @param payload The data to sign
+     * @param expiresIn Expiration time in seconds
+     * @returns A signed token string
+     */
+    sign(payload: {
+        hash: string;
+        partitionId: string;
+        action: 'upload';
+        size: number;
+        expiresAt: number;
+    } | {
+        hash: string;
+        partitionId: string;
+        action: 'download';
+        expiresAt: number;
+    }, expiresIn: number): Promise<string>;
+    /**
+     * Verify and decode a signed token.
+     * @returns The payload if valid, null if invalid/expired
+     */
+    verify(token: string): Promise<{
+        hash: string;
+        partitionId: string;
+        action: 'upload';
+        size: number;
+        expiresAt: number;
+    } | {
+        hash: string;
+        partitionId: string;
+        action: 'download';
+        expiresAt: number;
+    } | null>;
+}
+/**
+ * Create a simple HMAC-based token signer.
+ */
+export declare function createHmacTokenSigner(secret: string): BlobTokenSigner;
+export interface R2BlobStorageAdapterOptions {
+    /** R2 bucket binding */
+    bucket: R2Bucket;
+    /** Optional key prefix for all blobs */
+    keyPrefix?: string;
+    /** Base URL for the blob routes (e.g., "https://api.example.com/api/sync") */
+    baseUrl: string;
+    /** Token signer for authorization */
+    tokenSigner: BlobTokenSigner;
+}
+/**
+ * Create an R2 blob storage adapter using native R2Bucket binding.
+ *
+ * Since R2 bindings don't support presigned URLs, this adapter generates
+ * signed tokens and uses Worker-proxied uploads/downloads.
+ *
+ * @example
+ * ```typescript
+ * import { createR2BlobStorageAdapter, createHmacTokenSigner } from '@syncular/server/cloudflare/r2';
+ *
+ * type Env = { BLOBS: R2Bucket };
+ *
+ * const adapter = createR2BlobStorageAdapter({
+ *   bucket: env.BLOBS,
+ *   baseUrl: 'https://api.example.com/sync',
+ *   tokenSigner: createHmacTokenSigner(env.BLOB_SECRET),
+ * });
+ * ```
+ */
+export declare function createR2BlobStorageAdapter(options: R2BlobStorageAdapterOptions): BlobStorageAdapter;
+//# sourceMappingURL=r2.d.ts.map

package/dist/cloudflare/r2.d.ts.map

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

package/dist/cloudflare/r2.js

@@ -0,0 +1,258 @@
+/**
+ * R2 blob storage adapter using native R2Bucket binding.
+ *
+ * This adapter stores blobs in Cloudflare R2 using the native binding,
+ * without requiring the AWS SDK. Since R2 bindings don't support presigned URLs,
+ * this adapter generates signed tokens that allow uploads/downloads through
+ * the Worker's blob routes (similar to the database adapter).
+ */
+/**
+ * Create a simple HMAC-based token signer.
+ */
+export function createHmacTokenSigner(secret) {
+    const encoder = new TextEncoder();
+    async function hmacSign(data) {
+        const key = await crypto.subtle.importKey('raw', encoder.encode(secret), { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
+        const signature = await crypto.subtle.sign('HMAC', key, encoder.encode(data));
+        return bufferToHex(new Uint8Array(signature));
+    }
+    return {
+        async sign(payload, _expiresIn) {
+            const data = JSON.stringify(payload);
+            const dataB64 = btoa(data);
+            const sig = await hmacSign(dataB64);
+            return `${dataB64}.${sig}`;
+        },
+        async verify(token) {
+            const [dataB64, sig] = token.split('.');
+            if (!dataB64 || !sig)
+                return null;
+            const expectedSig = await hmacSign(dataB64);
+            if (sig !== expectedSig)
+                return null;
+            try {
+                const parsed = JSON.parse(atob(dataB64));
+                if (typeof parsed.hash !== 'string')
+                    return null;
+                if (typeof parsed.partitionId !== 'string')
+                    return null;
+                if (typeof parsed.expiresAt !== 'number')
+                    return null;
+                if (Date.now() > parsed.expiresAt)
+                    return null;
+                if (parsed.action === 'download') {
+                    return {
+                        hash: parsed.hash,
+                        partitionId: parsed.partitionId,
+                        action: 'download',
+                        expiresAt: parsed.expiresAt,
+                    };
+                }
+                if (parsed.action === 'upload' &&
+                    typeof parsed.size === 'number' &&
+                    Number.isFinite(parsed.size) &&
+                    parsed.size >= 0) {
+                    return {
+                        hash: parsed.hash,
+                        partitionId: parsed.partitionId,
+                        action: 'upload',
+                        size: parsed.size,
+                        expiresAt: parsed.expiresAt,
+                    };
+                }
+                return null;
+            }
+            catch {
+                return null;
+            }
+        },
+    };
+}
+function bufferToHex(buffer) {
+    return Array.from(buffer)
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+}
+/**
+ * Create an R2 blob storage adapter using native R2Bucket binding.
+ *
+ * Since R2 bindings don't support presigned URLs, this adapter generates
+ * signed tokens and uses Worker-proxied uploads/downloads.
+ *
+ * @example
+ * ```typescript
+ * import { createR2BlobStorageAdapter, createHmacTokenSigner } from '@syncular/server/cloudflare/r2';
+ *
+ * type Env = { BLOBS: R2Bucket };
+ *
+ * const adapter = createR2BlobStorageAdapter({
+ *   bucket: env.BLOBS,
+ *   baseUrl: 'https://api.example.com/sync',
+ *   tokenSigner: createHmacTokenSigner(env.BLOB_SECRET),
+ * });
+ * ```
+ */
+export function createR2BlobStorageAdapter(options) {
+    const { bucket, keyPrefix = '', baseUrl, tokenSigner } = options;
+    // Normalize base URL (remove trailing slash)
+    const normalizedBaseUrl = baseUrl.replace(/\/$/, '');
+    function getKey(hash, partitionId) {
+        // Remove "sha256:" prefix and use hex as key
+        const hex = hash.startsWith('sha256:') ? hash.slice(7) : hash;
+        const normalizedPartition = partitionId?.trim();
+        if (!normalizedPartition || normalizedPartition === 'default') {
+            return `${keyPrefix}${hex}`;
+        }
+        return `${keyPrefix}${encodeURIComponent(normalizedPartition)}/${hex}`;
+    }
+    function resolveMimeType(metadata) {
+        return typeof metadata?.mimeType === 'string'
+            ? metadata.mimeType
+            : 'application/octet-stream';
+    }
+    function resolveChecksum(hash, metadata) {
+        if (metadata?.disableChecksum === true) {
+            return undefined;
+        }
+        const explicitChecksum = metadata?.checksumSha256;
+        if (typeof explicitChecksum === 'string' &&
+            /^[0-9a-f]{64}$/i.test(explicitChecksum)) {
+            return explicitChecksum.toLowerCase();
+        }
+        return hash.startsWith('sha256:') ? hash.slice(7) : undefined;
+    }
+    function resolveContentLength(metadata) {
+        const candidates = [
+            metadata?.contentLength,
+            metadata?.byteLength,
+            metadata?.size,
+        ];
+        for (const candidate of candidates) {
+            if (typeof candidate !== 'number')
+                continue;
+            if (!Number.isFinite(candidate) || candidate < 0)
+                continue;
+            return candidate;
+        }
+        return undefined;
+    }
+    async function readAllBytesFromStream(stream) {
+        const body = await new Response(stream).arrayBuffer();
+        return new Uint8Array(body);
+    }
+    async function putStreamInternal(hash, stream, metadata, options) {
+        const key = getKey(hash, options?.partitionId);
+        const mimeType = resolveMimeType(metadata);
+        const checksum = resolveChecksum(hash, metadata);
+        const contentLength = resolveContentLength(metadata);
+        if (typeof contentLength === 'number' && contentLength >= 0) {
+            if (typeof FixedLengthStream !== 'undefined') {
+                const fixedLength = new FixedLengthStream(contentLength);
+                await Promise.all([
+                    stream.pipeTo(fixedLength.writable),
+                    bucket.put(key, fixedLength.readable, {
+                        httpMetadata: { contentType: mimeType },
+                        sha256: checksum,
+                    }),
+                ]);
+                return;
+            }
+            const bufferedBody = await readAllBytesFromStream(stream);
+            if (bufferedBody.byteLength !== contentLength) {
+                throw new Error(`Blob content length mismatch: expected ${contentLength}, got ${bufferedBody.byteLength}`);
+            }
+            await bucket.put(key, bufferedBody, {
+                httpMetadata: { contentType: mimeType },
+                sha256: checksum,
+            });
+            return;
+        }
+        const bufferedBody = await readAllBytesFromStream(stream);
+        await bucket.put(key, bufferedBody, {
+            httpMetadata: {
+                contentType: mimeType,
+            },
+            sha256: checksum,
+        });
+    }
+    async function getStreamInternal(hash, options) {
+        const key = getKey(hash, options?.partitionId);
+        const object = await bucket.get(key);
+        if (!object)
+            return null;
+        return object.body;
+    }
+    return {
+        name: 'r2',
+        async signUpload(opts) {
+            const partitionId = opts.partitionId ?? 'default';
+            const expiresAt = Date.now() + opts.expiresIn * 1000;
+            const token = await tokenSigner.sign({
+                hash: opts.hash,
+                partitionId,
+                action: 'upload',
+                size: opts.size,
+                expiresAt,
+            }, opts.expiresIn);
+            // URL points to server's blob upload endpoint
+            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) {
+            const partitionId = opts.partitionId ?? 'default';
+            const expiresAt = Date.now() + opts.expiresIn * 1000;
+            const token = await tokenSigner.sign({ hash: opts.hash, partitionId, action: 'download', expiresAt }, opts.expiresIn);
+            return `${normalizedBaseUrl}/blobs/${encodeURIComponent(opts.hash)}/download?token=${encodeURIComponent(token)}`;
+        },
+        async exists(hash, options) {
+            const key = getKey(hash, options?.partitionId);
+            const head = await bucket.head(key);
+            return head !== null;
+        },
+        async delete(hash, options) {
+            const key = getKey(hash, options?.partitionId);
+            await bucket.delete(key);
+        },
+        async getMetadata(hash, options) {
+            const key = getKey(hash, options?.partitionId);
+            const head = await bucket.head(key);
+            if (!head)
+                return null;
+            return {
+                size: head.size,
+                mimeType: head.httpMetadata?.contentType,
+            };
+        },
+        async put(hash, data, metadata, options) {
+            const key = getKey(hash, options?.partitionId);
+            const mimeType = resolveMimeType(metadata);
+            const checksum = resolveChecksum(hash, metadata);
+            await bucket.put(key, data, {
+                httpMetadata: {
+                    contentType: mimeType,
+                },
+                sha256: checksum,
+            });
+        },
+        async putStream(hash, stream, metadata, options) {
+            await putStreamInternal(hash, stream, metadata, options);
+        },
+        async get(hash, options) {
+            const stream = await getStreamInternal(hash, options);
+            if (!stream)
+                return null;
+            return readAllBytesFromStream(stream);
+        },
+        async getStream(hash, options) {
+            return getStreamInternal(hash, options);
+        },
+    };
+}
+//# sourceMappingURL=r2.js.map

package/dist/cloudflare/r2.js.map

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

package/dist/cloudflare/scope-cache.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Durable Object-backed scope cache for @syncular/server.
+ *
+ * This module provides two parts:
+ * 1) `createDurableObjectScopeCache()` - cache backend to pass to createSyncServer/createSyncRoutes
+ * 2) `ScopeCacheDurableObject` - Durable Object class that stores scope entries in DO storage
+ */
+type ScopeValues = Record<string, string | string[]>;
+interface ScopeCacheContext {
+    db: object;
+    auth: {
+        actorId: string;
+        partitionId?: string;
+    };
+    table: string;
+    cacheKey: string;
+}
+interface ScopeCacheSetContext extends ScopeCacheContext {
+    scopes: ScopeValues;
+}
+interface ScopeCacheBackend {
+    name: string;
+    get(args: ScopeCacheContext): Promise<ScopeValues | null>;
+    set(args: ScopeCacheSetContext): Promise<void>;
+    delete?(args: ScopeCacheContext): Promise<void>;
+}
+interface ScopeCacheLookup {
+    cacheKey: string;
+    partitionId: string;
+    actorId: string;
+    table: string;
+}
+/**
+ * Durable Object for scope cache entries.
+ *
+ * Bind this class in your Worker as a separate DO namespace.
+ */
+export declare class ScopeCacheDurableObject {
+    private readonly state;
+    constructor(state: DurableObjectState, _env: object);
+    fetch(request: Request): Promise<Response>;
+}
+export interface DurableObjectScopeCacheOptions {
+    namespace: DurableObjectNamespace;
+    ttlMs?: number;
+    path?: string;
+    getStubId?: (namespace: DurableObjectNamespace, lookup: ScopeCacheLookup) => DurableObjectId;
+}
+/**
+ * Create a scope cache backend that reads/writes through a Durable Object.
+ */
+export declare function createDurableObjectScopeCache(options: DurableObjectScopeCacheOptions): ScopeCacheBackend;
+export {};
+//# sourceMappingURL=scope-cache.d.ts.map

package/dist/cloudflare/scope-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-cache.d.ts","sourceRoot":"","sources":["../../src/cloudflare/scope-cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;AAErD,UAAU,iBAAiB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,oBAAqB,SAAQ,iBAAiB;IACtD,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC1D,GAAG,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAOD,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AA+HD;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAE3C,YAAY,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAElD;IAEK,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoD/C;CACF;AAED,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,sBAAsB,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,CACV,SAAS,EAAE,sBAAsB,EACjC,MAAM,EAAE,gBAAgB,KACrB,eAAe,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,8BAA8B,GACtC,iBAAiB,CAwFnB"}