@syncular/server-hono 0.0.1 → 0.0.2-127

package/src/blobs.ts

@@ -397,18 +397,22 @@ export function createBlobRoutes<DB extends SyncBlobsDb>(
           );
         }
 
-        // Store in database
+        // Store via the blob adapter (R2, database, etc.)
         const mimeType =
           c.req.header('Content-Type') ??
           metadata?.mimeType ??
           'application/octet-stream';
 
-        await storeBlobInDatabase(db, {
-          hash,
-          size: bodyBytes.length,
-          mimeType,
-          body: bodyBytes,
-        });
+        if (blobManager.adapter.put) {
+          await blobManager.adapter.put(hash, bodyBytes, { mimeType });
+        } else {
+          await storeBlobInDatabase(db, {
+            hash,
+            size: bodyBytes.length,
+            mimeType,
+            body: bodyBytes,
+          });
+        }
 
         return c.text('OK', 200);
       }
@@ -459,7 +463,26 @@ export function createBlobRoutes<DB extends SyncBlobsDb>(
           return c.json({ error: 'INVALID_TOKEN' }, 401);
         }
 
-        // Read from database
+        // Read via the blob adapter (R2, database, etc.)
+        if (blobManager.adapter.get) {
+          const data = await blobManager.adapter.get(hash);
+          if (!data) {
+            return c.json({ error: 'NOT_FOUND' }, 404);
+          }
+          const meta = blobManager.adapter.getMetadata
+            ? await blobManager.adapter.getMetadata(hash)
+            : null;
+          return new Response(data as BodyInit, {
+            status: 200,
+            headers: {
+              'Content-Type': meta?.mimeType ?? 'application/octet-stream',
+              'Content-Length': String(data.length),
+              'Cache-Control': 'private, max-age=31536000, immutable',
+            },
+          });
+        }
+
+        // Fallback: read from database directly
         const blob = await readBlobFromDatabase(db, hash);
         if (!blob) {
           return c.json({ error: 'NOT_FOUND' }, 404);

package/src/console/index.ts

@@ -8,6 +8,7 @@
 export type {
   ConsoleAuthResult,
   ConsoleEventEmitter,
+  CreateConsoleRoutesOptions,
 } from './routes';
 export {
   createConsoleEventEmitter,

package/src/console/routes.ts

@@ -24,6 +24,7 @@ import type {
 import {
   compactChanges,
   computePruneWatermarkCommitSeq,
+  notifyExternalDataChange,
   pruneSync,
   readSyncStats,
 } from '@syncular/server';
@@ -83,31 +84,6 @@ import {
   TimeseriesStatsResponseSchema,
 } from './schemas';
 
-// Re-export types for backwards compatibility
-export type {
-  ApiKeyType,
-  ConsoleApiKey,
-  ConsoleChange,
-  ConsoleClearEventsResult,
-  ConsoleClient,
-  ConsoleCommitDetail,
-  ConsoleCommitListItem,
-  ConsoleCompactResult,
-  ConsoleEvictResult,
-  ConsolePaginatedResponse,
-  ConsolePruneEventsResult,
-  ConsolePrunePreview,
-  ConsolePruneResult,
-  ConsoleRequestEvent,
-  ConsoleHandler,
-  LatencyPercentiles,
-  LatencyStatsResponse,
-  LiveEvent,
-  SyncStats,
-  TimeseriesBucket,
-  TimeseriesStatsResponse,
-};
-
 export interface ConsoleAuthResult {
   /** Identifier for the console user (for audit logging). */
   consoleUserId?: string;
@@ -1169,6 +1145,83 @@ export function createConsoleRoutes<DB extends SyncCoreDb>(
     }
   );
 
+  // -------------------------------------------------------------------------
+  // POST /notify-data-change
+  // -------------------------------------------------------------------------
+
+  const NotifyDataChangeRequestSchema = z.object({
+    tables: z.array(z.string().min(1)).min(1),
+    partitionId: z.string().optional(),
+  });
+
+  const NotifyDataChangeResponseSchema = z.object({
+    commitSeq: z.number(),
+    tables: z.array(z.string()),
+    deletedChunks: z.number(),
+  });
+
+  routes.post(
+    '/notify-data-change',
+    describeRoute({
+      tags: ['console'],
+      summary: 'Notify external data change',
+      description:
+        'Creates a synthetic commit to force re-bootstrap for affected tables. ' +
+        'Use after pipeline imports or direct DB writes to notify connected clients.',
+      responses: {
+        200: {
+          description: 'Notification result',
+          content: {
+            'application/json': {
+              schema: resolver(NotifyDataChangeResponseSchema),
+            },
+          },
+        },
+        400: {
+          description: 'Invalid request',
+          content: {
+            'application/json': { schema: resolver(ErrorResponseSchema) },
+          },
+        },
+        401: {
+          description: 'Unauthenticated',
+          content: {
+            'application/json': { schema: resolver(ErrorResponseSchema) },
+          },
+        },
+      },
+    }),
+    zValidator('json', NotifyDataChangeRequestSchema),
+    async (c) => {
+      const auth = await requireAuth(c);
+      if (!auth) return c.json({ error: 'UNAUTHENTICATED' }, 401);
+
+      const body = c.req.valid('json');
+
+      const result = await notifyExternalDataChange({
+        db: options.db,
+        dialect: options.dialect,
+        tables: body.tables,
+        partitionId: body.partitionId,
+      });
+
+      logSyncEvent({
+        event: 'console.notify_data_change',
+        consoleUserId: auth.consoleUserId,
+        tables: body.tables,
+        commitSeq: result.commitSeq,
+        deletedChunks: result.deletedChunks,
+      });
+
+      // Wake all WS clients so they pull immediately
+      if (options.wsConnectionManager) {
+        options.wsConnectionManager.notifyAllClients(result.commitSeq);
+      }
+
+      return c.json(result, 200);
+    }
+  );
+
   // -------------------------------------------------------------------------
   // DELETE /clients/:id
   // -------------------------------------------------------------------------

package/src/console/schemas.ts

@@ -146,17 +146,6 @@ export const ConsoleRequestEventSchema = z.object({
 
 export type ConsoleRequestEvent = z.infer<typeof ConsoleRequestEventSchema>;
 
-const ConsoleRequestEventFiltersSchema = z.object({
-  eventType: z.enum(['push', 'pull']).optional(),
-  actorId: z.string().optional(),
-  clientId: z.string().optional(),
-  outcome: z.string().optional(),
-});
-
-export type ConsoleRequestEventFilters = z.infer<
-  typeof ConsoleRequestEventFiltersSchema
->;
-
 export const ConsoleClearEventsResultSchema = z.object({
   deletedCount: z.number().int(),
 });
@@ -203,10 +192,6 @@ export const ConsoleApiKeyCreateRequestSchema = z.object({
   expiresInDays: z.number().int().positive().optional(),
 });
 
-export type ConsoleApiKeyCreateRequest = z.infer<
-  typeof ConsoleApiKeyCreateRequestSchema
->;
-
 export const ConsoleApiKeyCreateResponseSchema = z.object({
   key: ConsoleApiKeySchema,
   secretKey: z.string(),
@@ -220,10 +205,6 @@ export const ConsoleApiKeyRevokeResponseSchema = z.object({
   revoked: z.boolean(),
 });
 
-export type ConsoleApiKeyRevokeResponse = z.infer<
-  typeof ConsoleApiKeyRevokeResponseSchema
->;
-
 // ============================================================================
 // Pagination Schemas (Console-specific)
 // ============================================================================
@@ -233,10 +214,6 @@ export const ConsolePaginationQuerySchema = z.object({
   offset: z.coerce.number().int().min(0).default(0),
 });
 
-export type ConsolePaginationQuery = z.infer<
-  typeof ConsolePaginationQuerySchema
->;
-
 export const ConsolePaginatedResponseSchema = <T extends z.ZodTypeAny>(
   itemSchema: T
 ) =>
@@ -259,18 +236,12 @@ export type ConsolePaginatedResponse<T> = {
 // ============================================================================
 
 const TimeseriesIntervalSchema = z.enum(['minute', 'hour', 'day']);
-export type TimeseriesInterval = z.infer<typeof TimeseriesIntervalSchema>;
-
 const TimeseriesRangeSchema = z.enum(['1h', '6h', '24h', '7d', '30d']);
-export type TimeseriesRange = z.infer<typeof TimeseriesRangeSchema>;
-
 export const TimeseriesQuerySchema = z.object({
   interval: TimeseriesIntervalSchema.default('hour'),
   range: TimeseriesRangeSchema.default('24h'),
 });
 
-export type TimeseriesQuery = z.infer<typeof TimeseriesQuerySchema>;
-
 export const TimeseriesBucketSchema = z.object({
   timestamp: z.string(),
   pushCount: z.number().int(),
@@ -315,8 +286,6 @@ export const LatencyQuerySchema = z.object({
   range: TimeseriesRangeSchema.default('24h'),
 });
 
-export type LatencyQuery = z.infer<typeof LatencyQuerySchema>;
-
 // ============================================================================
 // Live Events Schemas (for WebSocket)
 // ============================================================================

package/src/create-server.ts

@@ -9,6 +9,7 @@
 import type {
   ServerSyncDialect,
   ServerTableHandler,
+  SnapshotChunkStorage,
   SyncCoreDb,
 } from '@syncular/server';
 import type { Context } from 'hono';
@@ -42,6 +43,9 @@ export interface SyncServerOptions<DB extends SyncCoreDb = SyncCoreDb> {
   /** Authentication function - returns actorId or null for unauthenticated */
   authenticate: (c: Context) => Promise<SyncAuthResult | null>;
 
+  /** Snapshot chunk storage (external body storage, e.g. R2/S3) */
+  chunkStorage?: SnapshotChunkStorage;
+
   /** Sync route configuration */
   sync?: SyncRoutesConfigWithRateLimit;
 
@@ -108,6 +112,7 @@ export function createSyncServer<DB extends SyncCoreDb = SyncCoreDb>(
     dialect,
     handlers,
     authenticate,
+    chunkStorage,
     sync,
     upgradeWebSocket,
     console: consoleConfig,
@@ -123,6 +128,7 @@ export function createSyncServer<DB extends SyncCoreDb = SyncCoreDb>(
     dialect,
     handlers,
     authenticate,
+    chunkStorage,
     sync: {
       ...sync,
       websocket: upgradeWebSocket

package/src/index.ts

@@ -9,13 +9,17 @@
 export * from './api-key-auth';
 
 // Blob routes
-export { createBlobRoutes } from './blobs';
+export { type CreateBlobRoutesOptions, createBlobRoutes } from './blobs';
 
 // Console
 export * from './console';
 
 // Simplified server factory
-export { createSyncServer } from './create-server';
+export {
+  createSyncServer,
+  type SyncServerOptions,
+  type SyncServerResult,
+} from './create-server';
 
 // OpenAPI utilities
 export * from './openapi';
@@ -27,7 +31,12 @@ export * from './proxy';
 export * from './rate-limit';
 
 // Route types and factory
-export { createSyncRoutes } from './routes';
+export {
+  type CreateSyncRoutesOptions,
+  createSyncRoutes,
+  getSyncRealtimeUnsubscribe,
+  getSyncWebSocketConnectionManager,
+} from './routes';
 
 // WebSocket helpers for realtime sync
 export * from './ws';

package/src/proxy/connection-manager.ts

@@ -27,7 +27,7 @@ export interface ProxyConnectionManagerConfig<
   /** Server sync dialect */
   dialect: ServerSyncDialect;
   /** Proxy table registry for oplog generation */
-  shapes: ProxyTableRegistry;
+  handlers: ProxyTableRegistry;
   /** Maximum concurrent connections (default: 100) */
   maxConnections?: number;
   /** Idle connection timeout in ms (default: 30000) */
@@ -285,7 +285,7 @@ export class ProxyConnectionManager<DB extends SyncCoreDb = SyncCoreDb> {
     const result: ExecuteProxyQueryResult = await executeProxyQuery({
       db,
       dialect: this.config.dialect,
-      shapes: this.config.shapes,
+      handlers: this.config.handlers,
       ctx: {
         actorId: state.actorId,
         clientId: state.clientId,

package/src/proxy/routes.ts

@@ -49,7 +49,7 @@ interface CreateProxyRoutesConfig<DB extends SyncCoreDb = SyncCoreDb> {
   /** Server sync dialect */
   dialect: ServerSyncDialect;
   /** Proxy table registry for oplog generation */
-  shapes: ProxyTableRegistry;
+  handlers: ProxyTableRegistry;
   /** Authenticate the request and return actor info */
   authenticate: (c: Context) => Promise<ProxyAuthResult | null>;
   /** WebSocket upgrade function from Hono */
@@ -75,7 +75,7 @@ interface CreateProxyRoutesConfig<DB extends SyncCoreDb = SyncCoreDb> {
  *
  * app.route('/proxy', createProxyRoutes({
  *   db,
- *   shapes: proxyTableRegistry,
+ *   handlers: proxyTableRegistry,
  *   authenticate: async (c) => {
  *     // Verify admin auth
  *     return { actorId: 'admin:123' };
@@ -94,7 +94,7 @@ export function createProxyRoutes<DB extends SyncCoreDb>(
   const manager = new ProxyConnectionManager({
     db: config.db,
     dialect: config.dialect,
-    shapes: config.shapes,
+    handlers: config.handlers,
     maxConnections: config.maxConnections,
     idleTimeoutMs: config.idleTimeoutMs,
   });