@syncular/core 0.1.3 → 0.2.0

package/src/frames.ts

@@ -0,0 +1,47 @@
+/** Frame type registry for wire version 1 (SPEC.md §1.2). */
+export const FrameType = {
+  END: 0x00,
+  REQ_HEADER: 0x01,
+  PUSH_COMMIT: 0x02,
+  PULL_HEADER: 0x03,
+  SUBSCRIPTION: 0x04,
+  RESP_HEADER: 0x10,
+  PUSH_RESULT: 0x11,
+  SUB_START: 0x12,
+  COMMIT: 0x13,
+  SEGMENT_REF: 0x14,
+  SEGMENT_INLINE: 0x15,
+  SUB_END: 0x16,
+  LEASE: 0x19,
+  ERROR: 0x1f,
+} as const;
+
+export type FrameTypeName = keyof typeof FrameType;
+
+/** Known request frame types (excluding END). */
+export const REQUEST_FRAME_TYPES: ReadonlySet<number> = new Set([
+  FrameType.REQ_HEADER,
+  FrameType.PUSH_COMMIT,
+  FrameType.PULL_HEADER,
+  FrameType.SUBSCRIPTION,
+]);
+
+/** Known response frame types (excluding END). */
+export const RESPONSE_FRAME_TYPES: ReadonlySet<number> = new Set([
+  FrameType.RESP_HEADER,
+  FrameType.PUSH_RESULT,
+  FrameType.SUB_START,
+  FrameType.COMMIT,
+  FrameType.SEGMENT_REF,
+  FrameType.SEGMENT_INLINE,
+  FrameType.SUB_END,
+  FrameType.LEASE,
+  FrameType.ERROR,
+]);
+
+/** Every frame type with a defined layout in wire version 1. */
+export const KNOWN_FRAME_TYPES: ReadonlySet<number> = new Set([
+  FrameType.END,
+  ...REQUEST_FRAME_TYPES,
+  ...RESPONSE_FRAME_TYPES,
+]);

package/src/index.ts

@@ -1,46 +1,21 @@
 /**
- * @syncular/core - Shared types and utilities for sync infrastructure
+ * @syncular/core — reference SSP2 codec (SPEC.md is normative).
  *
- * This package contains:
- * - Protocol types (commit-log + subscriptions)
- * - Pure conflict detection and merge utilities
- * - Logging utilities
- * - Data transformation hooks (optional)
- * - Blob types for media/binary handling
- * - Zod schemas for runtime validation and OpenAPI
+ * Dependency-free: primitives (Conventions), envelope + framing (§1),
+ * schema-IR row codec (§2.4), SSG2 rows segments (§5.2), message codecs
+ * (§1.5/§1.6), realtime control messages (§8), the §11 canonical JSON
+ * debug rendering, and §11.2 canonical JSON for digests.
  */
-
-// Blob transport/storage types and utilities (protocol types come from ./schemas)
-export * from './blobs';
-// Column-level codecs shared by typegen and runtime paths
-export * from './column-codecs';
-// Conflict detection utilities
-export * from './conflict';
-// Database utilities
-export * from './database';
-// Database dialect descriptors
-export * from './dialect';
-// Public error response envelopes
-export * from './error-responses';
-// Kysely plugin for applying column codecs in generic queries
-export * from './kysely-column-codecs';
-// Logging utilities
-export * from './logger';
-// Proxy protocol types
-export * from './proxy';
-// Schemas (Zod)
-export * from './schemas';
-// Scope types, patterns, and utilities
-export * from './scopes';
-// Snapshot chunk encoding helpers
-export * from './snapshot-chunks';
-// Sync response pack encoding helpers
-export * from './sync-packs';
-// Telemetry abstraction
-export * from './telemetry';
-// Data transformation hooks
-export * from './transforms';
-// Transport and conflict types (protocol types come from ./schemas)
-export * from './types';
-// Shared runtime utilities
-export * from './utils';
+export * from './blob-ref';
+export * from './bytes';
+export * from './canonical-json';
+export * from './constants';
+export * from './crypto';
+export * from './errors';
+export * from './frames';
+export * from './message';
+export * from './realtime';
+export * from './render';
+export * from './row-codec';
+export * from './segment';
+export * from './stream';