@syncular/core 0.0.6-96 → 0.1.0

package/dist/utils/table-registry.js

@@ -0,0 +1,54 @@
+export function registerTableOrThrow(registeredTables, table, duplicateTableError) {
+    if (registeredTables.has(table))
+        throw new Error(duplicateTableError(table));
+    registeredTables.add(table);
+}
+export function createTableLookup(handlers, duplicateTableError) {
+    const byTable = new Map();
+    for (const handler of handlers) {
+        if (byTable.has(handler.table)) {
+            throw new Error(duplicateTableError(handler.table));
+        }
+        byTable.set(handler.table, handler);
+    }
+    return byTable;
+}
+export function assertKnownTableDependencies(handlers, byTable, unknownDependencyError) {
+    for (const handler of handlers) {
+        for (const dependency of handler.dependsOn ?? []) {
+            if (!byTable.has(dependency)) {
+                throw new Error(unknownDependencyError(handler.table, dependency));
+            }
+        }
+    }
+}
+export function topologicallySortTablesByDependencies(byTable, targetTable) {
+    const visited = new Set();
+    const visiting = new Set();
+    const sorted = [];
+    const visit = (table) => {
+        if (visited.has(table))
+            return;
+        if (visiting.has(table)) {
+            throw new Error(`Circular dependency detected involving table "${table}"`);
+        }
+        const handler = byTable.get(table);
+        if (!handler)
+            throw new Error(`Unknown table: ${table}`);
+        visiting.add(table);
+        for (const dependency of handler.dependsOn ?? [])
+            visit(dependency);
+        visiting.delete(table);
+        visited.add(table);
+        sorted.push(handler);
+    };
+    if (targetTable) {
+        visit(targetTable);
+    }
+    else {
+        for (const table of byTable.keys())
+            visit(table);
+    }
+    return sorted;
+}
+//# sourceMappingURL=table-registry.js.map

package/dist/utils/table-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-registry.js","sourceRoot":"","sources":["../../src/utils/table-registry.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,oBAAoB,CAClC,gBAA6B,EAC7B,KAAa,EACb,mBAA8C;IAE9C,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7E,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AACD,MAAM,UAAU,iBAAiB,CAC/B,QAAsB,EACtB,mBAA8C;IAE9C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAa,CAAC;IACrC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AACD,MAAM,UAAU,4BAA4B,CAC1C,QAAsB,EACtB,OAA+B,EAC/B,sBAAqE;IAErE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YACjD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AACD,MAAM,UAAU,qCAAqC,CACnD,OAA+B,EAC/B,WAAoB;IAEpB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE;QAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO;QAC/B,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,iDAAiD,KAAK,GAAG,CAC1D,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;QACzD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpB,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,SAAS,IAAI,EAAE;YAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QACpE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC,CAAC;IACF,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,WAAW,CAAC,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE;YAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/url.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeSyncBaseUrl(url: string): string;
+export declare function resolveUrlFromBase(baseUrl: string, path: string, origin?: string): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/utils/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAKA,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAYR"}

package/dist/utils/url.js

@@ -0,0 +1,20 @@
+const ABSOLUTE_URL_SCHEME_REGEX = /^[a-zA-Z][a-zA-Z0-9+.-]*:/;
+const trimTrailingSlashes = (value) => value.replace(/\/+$/, '');
+export function normalizeSyncBaseUrl(url) {
+    const trimmed = trimTrailingSlashes(url.trim());
+    if (!trimmed.endsWith('/sync'))
+        return trimmed;
+    const baseUrl = trimmed.slice(0, -'/sync'.length);
+    return baseUrl.length > 0 ? baseUrl : '/';
+}
+export function resolveUrlFromBase(baseUrl, path, origin) {
+    const normalizedPath = path.replace(/^\/+/, '');
+    const normalizedBaseUrl = trimTrailingSlashes(baseUrl);
+    if (ABSOLUTE_URL_SCHEME_REGEX.test(baseUrl)) {
+        return new URL(normalizedPath, baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`).toString();
+    }
+    if (origin)
+        return new URL(`${normalizedBaseUrl}/${normalizedPath}`, origin).toString();
+    return `${normalizedBaseUrl}/${normalizedPath}`;
+}
+//# sourceMappingURL=url.js.map

package/dist/utils/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA,MAAM,yBAAyB,GAAG,2BAA2B,CAAC;AAE9D,MAAM,mBAAmB,GAAG,CAAC,KAAa,EAAU,EAAE,CACpD,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAE5B,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,IAAY,EACZ,MAAe;IAEf,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5C,OAAO,IAAI,GAAG,CACZ,cAAc,EACd,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAChD,CAAC,QAAQ,EAAE,CAAC;IACf,CAAC;IACD,IAAI,MAAM;QACR,OAAO,IAAI,GAAG,CAAC,GAAG,iBAAiB,IAAI,cAAc,EAAE,EAAE,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC9E,OAAO,GAAG,iBAAiB,IAAI,cAAc,EAAE,CAAC;AAClD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/core",
-  "version": "0.0.6-96",
+  "version": "0.1.0",
   "description": "Core protocol types and shared utilities for the Syncular sync framework",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -21,6 +21,7 @@
     "typescript"
   ],
   "private": false,
+  "sideEffects": false,
   "publishConfig": {
     "access": "public"
   },
@@ -33,25 +34,69 @@
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
       }
+    },
+    "./http": {
+      "bun": "./src/http/index.ts",
+      "browser": "./src/http/index.ts",
+      "import": {
+        "types": "./dist/http/index.d.ts",
+        "default": "./dist/http/index.js"
+      }
+    },
+    "./http/blob": {
+      "bun": "./src/http/blob.ts",
+      "browser": "./src/http/blob.ts",
+      "import": {
+        "types": "./dist/http/blob.d.ts",
+        "default": "./dist/http/blob.js"
+      }
+    },
+    "./sentry": {
+      "bun": "./src/sentry.ts",
+      "browser": "./src/sentry.ts",
+      "import": {
+        "types": "./dist/sentry.d.ts",
+        "default": "./dist/sentry.js"
+      }
     }
   },
   "scripts": {
+    "fixtures:protocol": "bun scripts/generate-protocol-fixtures.ts",
     "test": "bun test src/__tests__",
     "tsgo": "tsgo --noEmit",
     "build": "tsgo",
-    "release": "bunx syncular-publish"
+    "release": "syncular-publish",
+    "generate:http-types": "openapi-typescript ../server/openapi.json -o src/http/generated/api.ts"
   },
   "peerDependencies": {
     "kysely": "^0.28.0",
-    "zod": "^4.0.0"
+    "zod": "^4.0.0",
+    "openapi-fetch": "^0.17.0"
   },
   "devDependencies": {
-    "@syncular/config": "0.0.0",
+    "@syncular/config": "workspace:*",
     "kysely": "*",
-    "zod": "*"
+    "zod": "*",
+    "openapi-fetch": "^0.17.0",
+    "openapi-typescript": "^7.13.0"
   },
   "files": [
     "dist",
-    "src"
-  ]
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__/**",
+    "!dist/**/*.test.*",
+    "!dist/**/__tests__/**",
+    "!test/**",
+    "!tests/**"
+  ],
+  "dependencies": {
+    "fflate": "^0.8.2"
+  },
+  "peerDependenciesMeta": {
+    "openapi-fetch": {
+      "optional": true
+    }
+  }
 }

package/src/blobs.ts

@@ -56,6 +56,8 @@ export interface BlobTransport {
 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 */
@@ -82,10 +84,16 @@ export interface BlobSignedUpload {
 export interface BlobSignDownloadOptions {
   /** SHA-256 hash */
   hash: string;
+  /** Optional tenant/partition namespace for storage lookups */
+  partitionId?: string;
   /** URL expiration in seconds */
   expiresIn: number;
 }
 
+export interface BlobStoragePartitionOptions {
+  partitionId?: string;
+}
+
 /**
  * Adapter for blob storage backends (S3, R2, custom).
  * Implementations handle actual storage; the sync server orchestrates.
@@ -108,19 +116,20 @@ export interface BlobStorageAdapter {
   /**
    * Check if a blob exists in storage.
    */
-  exists(hash: string): Promise<boolean>;
+  exists(hash: string, options?: BlobStoragePartitionOptions): Promise<boolean>;
 
   /**
    * Delete a blob (for garbage collection).
    */
-  delete(hash: string): Promise<void>;
+  delete(hash: string, options?: BlobStoragePartitionOptions): Promise<void>;
 
   /**
    * Get blob metadata from storage (optional).
    * Used to verify uploads completed successfully.
    */
   getMetadata?(
-    hash: string
+    hash: string,
+    options?: BlobStoragePartitionOptions
   ): Promise<{ size: number; mimeType?: string } | null>;
 
   /**
@@ -130,7 +139,8 @@ export interface BlobStorageAdapter {
   put?(
     hash: string,
     data: Uint8Array,
-    metadata?: Record<string, unknown>
+    metadata?: Record<string, unknown>,
+    options?: BlobStoragePartitionOptions
   ): Promise<void>;
 
   /**
@@ -140,18 +150,25 @@ export interface BlobStorageAdapter {
   putStream?(
     hash: string,
     stream: ReadableStream<Uint8Array>,
-    metadata?: Record<string, unknown>
+    metadata?: Record<string, unknown>,
+    options?: BlobStoragePartitionOptions
   ): Promise<void>;
 
   /**
    * Get blob data directly (for adapters that support direct retrieval).
    */
-  get?(hash: string): Promise<Uint8Array | null>;
+  get?(
+    hash: string,
+    options?: BlobStoragePartitionOptions
+  ): Promise<Uint8Array | null>;
 
   /**
    * Get blob data directly as a stream (for adapters that support stream retrieval).
    */
-  getStream?(hash: string): Promise<ReadableStream<Uint8Array> | null>;
+  getStream?(
+    hash: string,
+    options?: BlobStoragePartitionOptions
+  ): Promise<ReadableStream<Uint8Array> | null>;
 }
 
 // ============================================================================

package/src/column-codecs.ts

@@ -88,6 +88,35 @@ export function toTableColumnCodecs(
   return out;
 }
 
+export function createTableColumnCodecsResolver(
+  codecSource: ColumnCodecSource | undefined,
+  options: { dialect?: ColumnCodecDialect } = {}
+): (table: string, row: Record<string, unknown>) => TableColumnCodecs {
+  const tableCaches = new Map<string, Map<string, TableColumnCodecs>>();
+
+  return (table, row) => {
+    if (!codecSource) return {};
+    const columns = Object.keys(row);
+    if (columns.length === 0) return {};
+
+    const cacheKey = columns.slice().sort().join('\u0000');
+    let perTableCache = tableCaches.get(table);
+    if (!perTableCache) {
+      perTableCache = new Map<string, TableColumnCodecs>();
+      tableCaches.set(table, perTableCache);
+    }
+
+    const cached = perTableCache.get(cacheKey);
+    if (cached) return cached;
+
+    const resolved = toTableColumnCodecs(table, codecSource, columns, {
+      dialect: options.dialect,
+    });
+    perTableCache.set(cacheKey, resolved);
+    return resolved;
+  };
+}
+
 export function applyCodecToDbValue(
   codec: AnyColumnCodec,
   value: unknown,
@@ -134,16 +163,15 @@ export function applyCodecsFromDbRow(
 ): Record<string, unknown> {
   if (!hasCodecs(tableCodecs)) return { ...row };
 
-  const transformed: Record<string, unknown> = { ...row };
+  let transformed: Record<string, unknown> | null = null;
   for (const [column, codec] of Object.entries(tableCodecs)) {
-    if (!(column in transformed)) continue;
-    transformed[column] = applyCodecFromDbValue(
-      codec,
-      transformed[column],
-      dialect
-    );
+    if (!(column in row)) continue;
+    const value = row[column];
+    if (value === null || value === undefined) continue;
+    transformed ??= { ...row };
+    transformed[column] = applyCodecFromDbValue(codec, value, dialect);
   }
-  return transformed;
+  return transformed ?? row;
 }
 
 function parseBooleanValue(value: unknown): boolean {