@syncular/server 0.0.6-95 → 0.1.0

package/dist/relay/server-role/index.js

@@ -0,0 +1,193 @@
+/**
+ * @syncular/server/relay - Server Role
+ *
+ * Hono routes for serving local clients.
+ */
+import { createSyncTimer, createSyncularErrorResponse, isRecord, logSyncEvent, ScopeValuesSchema, SyncBootstrapStateSchema, SyncPullRequestSchema, SyncPushRequestSchema, } from '@syncular/core';
+import { recordClientCursor } from '@syncular/server';
+import { Hono } from 'hono';
+import { relayPull } from './pull';
+import { relayPushCommit } from './push';
+function clampInt(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+function relayError(c, status, code, message, details) {
+    return c.json(createSyncularErrorResponse(code, {
+        ...(message ? { message } : {}),
+        ...(details ? { details } : {}),
+    }), status);
+}
+function invalidRelayRequest(c, message, details) {
+    return relayError(c, 400, 'sync.invalid_request', message, details);
+}
+/**
+ * Create Hono routes for relay server-role endpoints.
+ *
+ * Provides:
+ * - POST /pull (commit stream + optional bootstrap snapshots)
+ * - POST /push (commit ingestion)
+ * - GET /realtime (WebSocket wake-up notifications)
+ */
+export function createRelayRoutes(options) {
+    const routes = new Hono();
+    const maxOperationsPerPush = options.maxOperationsPerPush ?? 200;
+    const maxSubscriptionsPerPull = options.maxSubscriptionsPerPull ?? 200;
+    const maxPullLimitCommits = options.maxPullLimitCommits ?? 100;
+    const authenticate = options.authenticate ?? (async () => ({ actorId: 'anonymous' }));
+    // POST /pull
+    routes.post('/pull', async (c) => {
+        const auth = await authenticate(c);
+        if (!auth)
+            return relayError(c, 401, 'sync.auth_required');
+        const rawBody = await c.req.json();
+        const timer = createSyncTimer();
+        if (!isRecord(rawBody)) {
+            return invalidRelayRequest(c, 'Invalid JSON body');
+        }
+        if (!rawBody.clientId || typeof rawBody.clientId !== 'string') {
+            return invalidRelayRequest(c, 'clientId is required');
+        }
+        if (!Array.isArray(rawBody.subscriptions)) {
+            return invalidRelayRequest(c, 'subscriptions array is required');
+        }
+        if (rawBody.subscriptions.length > maxSubscriptionsPerPull) {
+            return invalidRelayRequest(c, `Too many subscriptions (max ${maxSubscriptionsPerPull})`);
+        }
+        const subscriptions = [];
+        for (const subValue of rawBody.subscriptions) {
+            if (!isRecord(subValue)) {
+                return invalidRelayRequest(c, 'Invalid subscription entry');
+            }
+            const id = typeof subValue.id === 'string' ? subValue.id : null;
+            const table = typeof subValue.table === 'string' ? subValue.table : null;
+            if (!id || !table) {
+                return invalidRelayRequest(c, 'Subscription id/table required');
+            }
+            const scopesParsed = ScopeValuesSchema.safeParse(subValue.scopes);
+            if (!scopesParsed.success) {
+                return invalidRelayRequest(c, 'Invalid subscription scopes');
+            }
+            const rawParams = subValue.params;
+            if (rawParams !== undefined && !isRecord(rawParams)) {
+                return invalidRelayRequest(c, 'Invalid subscription params');
+            }
+            const cursor = typeof subValue.cursor === 'number' && Number.isInteger(subValue.cursor)
+                ? Math.max(-1, subValue.cursor)
+                : -1;
+            const rawBootstrapState = subValue.bootstrapState;
+            const bootstrapState = rawBootstrapState === undefined || rawBootstrapState === null
+                ? null
+                : (() => {
+                    const parsed = SyncBootstrapStateSchema.safeParse(rawBootstrapState);
+                    if (!parsed.success)
+                        return null;
+                    return parsed.data;
+                })();
+            if (rawBootstrapState !== undefined &&
+                rawBootstrapState !== null &&
+                bootstrapState === null) {
+                return invalidRelayRequest(c, 'Invalid subscription bootstrapState');
+            }
+            subscriptions.push({
+                id,
+                table,
+                scopes: scopesParsed.data,
+                params: rawParams,
+                cursor,
+                bootstrapState,
+                crdtStateVectors: [],
+            });
+        }
+        const request = {
+            clientId: rawBody.clientId,
+            schemaVersion: typeof rawBody.schemaVersion === 'number' &&
+                Number.isInteger(rawBody.schemaVersion)
+                ? rawBody.schemaVersion
+                : Number.NaN,
+            limitCommits: clampInt(typeof rawBody.limitCommits === 'number' &&
+                Number.isInteger(rawBody.limitCommits)
+                ? rawBody.limitCommits
+                : 50, 1, maxPullLimitCommits),
+            limitSnapshotRows: clampInt(typeof rawBody.limitSnapshotRows === 'number' &&
+                Number.isInteger(rawBody.limitSnapshotRows)
+                ? rawBody.limitSnapshotRows
+                : 1000, 1, 5000),
+            maxSnapshotPages: clampInt(typeof rawBody.maxSnapshotPages === 'number' &&
+                Number.isInteger(rawBody.maxSnapshotPages)
+                ? rawBody.maxSnapshotPages
+                : 4, 1, 10),
+            dedupeRows: typeof rawBody.dedupeRows === 'boolean'
+                ? rawBody.dedupeRows
+                : undefined,
+            subscriptions,
+        };
+        const validatedRequest = SyncPullRequestSchema.safeParse(request);
+        if (!validatedRequest.success) {
+            return invalidRelayRequest(c, 'Invalid pull request');
+        }
+        const pullResult = await relayPull({
+            db: options.db,
+            dialect: options.dialect,
+            handlers: options.handlers,
+            auth,
+            request: validatedRequest.data,
+        });
+        await recordClientCursor(options.db, options.dialect, {
+            clientId: validatedRequest.data.clientId,
+            actorId: auth.actorId,
+            cursor: pullResult.clientCursor,
+            effectiveScopes: pullResult.effectiveScopes,
+        });
+        // Notify realtime about updated scope values
+        options.realtime.updateClientScopeKeys(request.clientId, Object.keys(pullResult.effectiveScopes));
+        logSyncEvent({
+            event: 'relay.pull',
+            userId: auth.actorId,
+            durationMs: timer(),
+            subscriptionCount: pullResult.response.subscriptions.length,
+            clientCursor: pullResult.clientCursor,
+        });
+        return c.json(pullResult.response);
+    });
+    // POST /push
+    routes.post('/push', async (c) => {
+        const auth = await authenticate(c);
+        if (!auth)
+            return relayError(c, 401, 'sync.auth_required');
+        const rawBody = await c.req.json();
+        const parsed = SyncPushRequestSchema.safeParse(rawBody);
+        if (!parsed.success) {
+            return invalidRelayRequest(c, 'Invalid push request');
+        }
+        const body = parsed.data;
+        if (body.operations.length > maxOperationsPerPush) {
+            return relayError(c, 400, 'sync.too_many_operations', `Maximum ${maxOperationsPerPush} operations per push`);
+        }
+        const timer = createSyncTimer();
+        const pushed = await relayPushCommit({
+            db: options.db,
+            dialect: options.dialect,
+            handlers: options.handlers,
+            auth,
+            request: body,
+        });
+        logSyncEvent({
+            event: 'relay.push',
+            userId: auth.actorId,
+            durationMs: timer(),
+            operationCount: body.operations.length,
+            status: pushed.response.status,
+            commitSeq: pushed.response.commitSeq,
+        });
+        // Notify about the commit
+        if (pushed.response.ok === true &&
+            pushed.response.status === 'applied' &&
+            typeof pushed.response.commitSeq === 'number' &&
+            pushed.affectedTables.length > 0) {
+            await options.onCommit?.(pushed.response.commitSeq, pushed.affectedTables);
+        }
+        return c.json(pushed.response);
+    });
+    return routes;
+}
+//# sourceMappingURL=index.js.map

package/dist/relay/server-role/index.js.map

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

package/dist/relay/server-role/pull.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @syncular/server/relay - Server Role Pull Handler
+ *
+ * Handles pulls from local clients, serving changes stored locally
+ * on the relay.
+ */
+import type { SyncPullRequest } from '@syncular/core';
+import type { ServerHandlerCollection, ServerSyncDialect, SyncServerAuth } from '@syncular/server';
+import { type PullResult } from '@syncular/server';
+import type { Kysely } from 'kysely';
+import type { RelayDatabase } from '../schema';
+type RelayAuth = SyncServerAuth;
+/**
+ * Pull commits for a local client from the relay.
+ *
+ * This wraps the standard server pull with relay-specific logic:
+ * - Restricts scopes to those the relay subscribes to
+ */
+export declare function relayPull<DB extends RelayDatabase = RelayDatabase>(args: {
+    db: Kysely<DB>;
+    dialect: ServerSyncDialect;
+    handlers: ServerHandlerCollection<DB, RelayAuth>;
+    auth: RelayAuth;
+    request: SyncPullRequest;
+}): Promise<PullResult>;
+export {};
+//# sourceMappingURL=pull.d.ts.map

package/dist/relay/server-role/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../../src/relay/server-role/pull.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,KAAK,SAAS,GAAG,cAAc,CAAC;AAEhC;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,EAAE,SAAS,aAAa,GAAG,aAAa,EACxC,IAAI,EAAE;IACN,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,uBAAuB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IACjD,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,eAAe,CAAC;CAC1B,GAAG,OAAO,CAAC,UAAU,CAAC,CAStB"}

package/dist/relay/server-role/pull.js

@@ -0,0 +1,24 @@
+/**
+ * @syncular/server/relay - Server Role Pull Handler
+ *
+ * Handles pulls from local clients, serving changes stored locally
+ * on the relay.
+ */
+import { pull } from '@syncular/server';
+/**
+ * Pull commits for a local client from the relay.
+ *
+ * This wraps the standard server pull with relay-specific logic:
+ * - Restricts scopes to those the relay subscribes to
+ */
+export async function relayPull(args) {
+    // Use the standard pull - scope authorization is handled by handlers
+    return pull({
+        db: args.db,
+        dialect: args.dialect,
+        handlers: args.handlers,
+        auth: args.auth,
+        request: args.request,
+    });
+}
+//# sourceMappingURL=pull.js.map

package/dist/relay/server-role/pull.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.js","sourceRoot":"","sources":["../../../src/relay/server-role/pull.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAmB,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAMzD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAE7B,IAMD;IACC,qEAAqE;IACrE,OAAO,IAAI,CAAC;QACV,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC;AACL,CAAC"}

package/dist/relay/server-role/push.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @syncular/server/relay - Server Role Push Handler
+ *
+ * Handles pushes from local clients, storing them locally and
+ * queueing them for forwarding to the main server.
+ */
+import type { SyncPushRequest } from '@syncular/core';
+import type { ServerHandlerCollection, ServerSyncDialect, SyncServerAuth } from '@syncular/server';
+import { type PushCommitResult } from '@syncular/server';
+import { type Kysely } from 'kysely';
+import type { RelayDatabase } from '../schema';
+type RelayAuth = SyncServerAuth;
+/**
+ * Push a commit from a local client to the relay.
+ *
+ * This wraps the standard server pushCommit with relay-specific logic:
+ * 1. Validates that operations are within the relay's scope
+ * 2. Stores the commit locally
+ * 3. Enqueues the commit for forwarding to the main server
+ */
+export declare function relayPushCommit<DB extends RelayDatabase = RelayDatabase>(args: {
+    db: Kysely<DB>;
+    dialect: ServerSyncDialect;
+    handlers: ServerHandlerCollection<DB, RelayAuth>;
+    auth: RelayAuth;
+    request: SyncPushRequest;
+}): Promise<PushCommitResult>;
+export {};
+//# sourceMappingURL=push.d.ts.map

package/dist/relay/server-role/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../../src/relay/server-role/push.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,gBAAgB,EAAc,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,KAAK,MAAM,EAAO,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,KAAK,SAAS,GAAG,cAAc,CAAC;AAEhC;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,EAAE,SAAS,aAAa,GAAG,aAAa,EACxC,IAAI,EAAE;IACN,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,uBAAuB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IACjD,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,eAAe,CAAC;CAC1B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmC5B"}

package/dist/relay/server-role/push.js

@@ -0,0 +1,122 @@
+/**
+ * @syncular/server/relay - Server Role Push Handler
+ *
+ * Handles pushes from local clients, storing them locally and
+ * queueing them for forwarding to the main server.
+ */
+import { randomId } from '@syncular/core';
+import { pushCommit } from '@syncular/server';
+import { sql } from 'kysely';
+/**
+ * Push a commit from a local client to the relay.
+ *
+ * This wraps the standard server pushCommit with relay-specific logic:
+ * 1. Validates that operations are within the relay's scope
+ * 2. Stores the commit locally
+ * 3. Enqueues the commit for forwarding to the main server
+ */
+export async function relayPushCommit(args) {
+    const { request } = args;
+    return args.db.transaction().execute(async (trx) => {
+        // Use the standard pushCommit - scope authorization is handled by handlers
+        const result = await pushCommit({
+            db: trx,
+            dialect: args.dialect,
+            handlers: args.handlers,
+            auth: args.auth,
+            request,
+        });
+        // If the commit was applied, enqueue it for forwarding to main server
+        if (result.response.ok === true &&
+            result.response.status === 'applied' &&
+            typeof result.response.commitSeq === 'number') {
+            try {
+                await enqueueForForwarding(trx, {
+                    localCommitSeq: result.response.commitSeq,
+                    clientId: request.clientId,
+                    clientCommitId: request.clientCommitId,
+                    operations: request.operations,
+                    schemaVersion: request.schemaVersion,
+                });
+            }
+            catch (error) {
+                await rollbackLocalCommit(trx, result.response.commitSeq);
+                throw error;
+            }
+        }
+        return result;
+    });
+}
+/**
+ * Enqueue a locally-committed change for forwarding to the main server.
+ */
+async function enqueueForForwarding(db, args) {
+    const now = Date.now();
+    await sql `
+    insert into ${sql.table('relay_forward_outbox')} (
+      id,
+      local_commit_seq,
+      client_id,
+      client_commit_id,
+      operations_json,
+      schema_version,
+      status,
+      main_commit_seq,
+      error,
+      last_response_json,
+      created_at,
+      updated_at,
+      attempt_count
+    )
+    values (
+      ${randomId()},
+      ${args.localCommitSeq},
+      ${args.clientId},
+      ${args.clientCommitId},
+      ${JSON.stringify(args.operations)},
+      ${args.schemaVersion},
+      'pending',
+      ${null},
+      ${null},
+      ${null},
+      ${now},
+      ${now},
+      ${0}
+    )
+  `.execute(db);
+    // Also create a sequence map entry for this commit
+    await sql `
+    insert into ${sql.table('relay_sequence_map')} (
+      local_commit_seq,
+      main_commit_seq,
+      status,
+      created_at,
+      updated_at
+    )
+    values (${args.localCommitSeq}, ${null}, 'pending', ${now}, ${now})
+    on conflict (local_commit_seq) do nothing
+  `.execute(db);
+}
+async function rollbackLocalCommit(db, commitSeq) {
+    await sql `
+    delete from ${sql.table('relay_sequence_map')}
+    where ${sql.ref('local_commit_seq')} = ${commitSeq}
+  `.execute(db);
+    await sql `
+    delete from ${sql.table('relay_forward_outbox')}
+    where ${sql.ref('local_commit_seq')} = ${commitSeq}
+  `.execute(db);
+    await sql `
+    delete from ${sql.table('sync_table_commits')}
+    where ${sql.ref('commit_seq')} = ${commitSeq}
+  `.execute(db);
+    await sql `
+    delete from ${sql.table('sync_changes')}
+    where ${sql.ref('commit_seq')} = ${commitSeq}
+  `.execute(db);
+    await sql `
+    delete from ${sql.table('sync_commits')}
+    where ${sql.ref('commit_seq')} = ${commitSeq}
+  `.execute(db);
+}
+//# sourceMappingURL=push.js.map

package/dist/relay/server-role/push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../../../src/relay/server-role/push.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM1C,OAAO,EAAyB,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAe,GAAG,EAAE,MAAM,QAAQ,CAAC;AAK1C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAEnC,IAMD;IACC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEzB,OAAO,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACjD,2EAA2E;QAC3E,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;YAC9B,EAAE,EAAE,GAAG;YACP,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO;SACR,CAAC,CAAC;QAEH,sEAAsE;QACtE,IACE,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI;YAC3B,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS;YACpC,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,KAAK,QAAQ,EAC7C,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,oBAAoB,CAAC,GAAG,EAAE;oBAC9B,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS;oBACzC,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,cAAc,EAAE,OAAO,CAAC,cAAc;oBACtC,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;iBACrC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;gBAC1D,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,oBAAoB,CACjC,EAAc,EACd,IAMC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,MAAM,GAAG,CAAA;kBACO,GAAG,CAAC,KAAK,CAAC,sBAAsB,CAAC;;;;;;;;;;;;;;;;QAgB3C,QAAQ,EAAE;QACV,IAAI,CAAC,cAAc;QACnB,IAAI,CAAC,QAAQ;QACb,IAAI,CAAC,cAAc;QACnB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC;QAC/B,IAAI,CAAC,aAAa;;QAElB,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,GAAG;QACH,GAAG;QACH,CAAC;;GAEN,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEd,mDAAmD;IACnD,MAAM,GAAG,CAAA;kBACO,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC;;;;;;;cAOnC,IAAI,CAAC,cAAc,KAAK,IAAI,gBAAgB,GAAG,KAAK,GAAG;;GAElE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,EAAc,EACd,SAAiB;IAEjB,MAAM,GAAG,CAAA;kBACO,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC;YACrC,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,MAAM,SAAS;GACnD,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEd,MAAM,GAAG,CAAA;kBACO,GAAG,CAAC,KAAK,CAAC,sBAAsB,CAAC;YACvC,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,MAAM,SAAS;GACnD,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEd,MAAM,GAAG,CAAA;kBACO,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC;YACrC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,SAAS;GAC7C,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEd,MAAM,GAAG,CAAA;kBACO,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC;YAC/B,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,SAAS;GAC7C,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEd,MAAM,GAAG,CAAA;kBACO,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC;YAC/B,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,SAAS;GAC7C,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAChB,CAAC"}

package/dist/s3/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 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.
+ */
+import type { BlobStorageAdapter } from '@syncular/core';
+/**
+ * S3 client interface (minimal subset of @aws-sdk/client-s3).
+ * This allows users to pass in their own configured S3 client.
+ */
+export interface S3ClientLike {
+    send(command: unknown): Promise<unknown>;
+}
+/**
+ * Function to create presigned URLs.
+ * This should be getSignedUrl from @aws-sdk/s3-request-presigner.
+ */
+export type GetSignedUrlFn = (client: S3ClientLike, command: unknown, options: {
+    expiresIn: number;
+}) => Promise<string>;
+/**
+ * S3 command constructors.
+ * These should be imported from @aws-sdk/client-s3.
+ */
+export interface S3Commands {
+    PutObjectCommand: new (input: {
+        Bucket: string;
+        Key: string;
+        ContentLength?: number;
+        ContentType?: string;
+        ChecksumSHA256?: string;
+        Body?: Uint8Array | ReadableStream<Uint8Array>;
+    }) => unknown;
+    GetObjectCommand: new (input: {
+        Bucket: string;
+        Key: string;
+    }) => unknown;
+    HeadObjectCommand: new (input: {
+        Bucket: string;
+        Key: string;
+    }) => unknown;
+    DeleteObjectCommand: new (input: {
+        Bucket: string;
+        Key: string;
+    }) => unknown;
+}
+export interface S3BlobStorageAdapterOptions {
+    /** S3 client instance */
+    client: S3ClientLike;
+    /** S3 bucket name */
+    bucket: string;
+    /** Optional key prefix for all blobs */
+    keyPrefix?: string;
+    /** S3 command constructors */
+    commands: S3Commands;
+    /** getSignedUrl function from @aws-sdk/s3-request-presigner */
+    getSignedUrl: GetSignedUrlFn;
+    /**
+     * Whether to require SHA-256 checksum validation on upload.
+     * Supported by S3 and R2. Default: true.
+     */
+    requireChecksum?: boolean;
+}
+/**
+ * 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 declare function createS3BlobStorageAdapter(options: S3BlobStorageAdapterOptions): BlobStorageAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/s3/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/s3/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAIV,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AAExB;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,KAC3B,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,KAAK,KAAK,EAAE;QAC5B,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;KAChD,KAAK,OAAO,CAAC;IACd,gBAAgB,EAAE,KAAK,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;IAC1E,iBAAiB,EAAE,KAAK,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;IAC3E,mBAAmB,EAAE,KAAK,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;CAC9E;AAED,MAAM,WAAW,2BAA2B;IAC1C,yBAAyB;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,QAAQ,EAAE,UAAU,CAAC;IACrB,+DAA+D;IAC/D,YAAY,EAAE,cAAc,CAAC;IAC7B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,GACnC,kBAAkB,CA2MpB"}