@syncular/server 0.1.2 → 0.2.0

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

@@ -1,193 +0,0 @@
-/**
- * @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.js';
-import { relayPushCommit } from './push.js';
-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

@@ -1 +0,0 @@
-{"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

@@ -1,27 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,24 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,29 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,122 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,83 +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.
- */
-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

@@ -1 +0,0 @@
-{"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"}