@syncular/core 0.0.1-60

package/dist/scopes/index.js

@@ -0,0 +1,67 @@
+/**
+ * @syncular/core - Scope types, patterns, and utilities
+ *
+ * Scope patterns define how data is partitioned for sync.
+ * Scopes are stored as JSONB on changes for flexible filtering.
+ * Patterns use `{placeholder}` syntax to extract or inject values.
+ */
+// ── Pattern parsing (internal helpers) ───────────────────────────────
+/**
+ * Extract the placeholder name from a pattern.
+ * Returns null if the pattern doesn't contain a valid placeholder.
+ */
+function extractPlaceholder(pattern) {
+    const match = pattern.match(/^(.*?)\{(\w+)\}(.*)$/);
+    if (!match)
+        return null;
+    return {
+        prefix: match[1],
+        placeholder: match[2],
+        suffix: match[3],
+    };
+}
+/**
+ * Extract the placeholder name from a pattern.
+ */
+function getPlaceholderName(pattern) {
+    const parsed = extractPlaceholder(pattern);
+    return parsed?.placeholder ?? null;
+}
+/**
+ * Normalize scope definitions to a pattern-to-column map.
+ *
+ * @example
+ * normalizeScopes(['user:{user_id}'])
+ * // → { 'user:{user_id}': 'user_id' }
+ */
+export function normalizeScopes(scopes) {
+    const result = {};
+    for (const scope of scopes) {
+        if (typeof scope === 'string') {
+            const placeholder = getPlaceholderName(scope);
+            if (!placeholder) {
+                throw new Error(`Scope pattern "${scope}" must contain a placeholder like {column_name}`);
+            }
+            result[scope] = placeholder;
+        }
+        else {
+            result[scope.pattern] = scope.column;
+        }
+    }
+    return result;
+}
+// ── Value operations (public) ────────────────────────────────────────
+/**
+ * Extract variable names from a scope pattern.
+ *
+ * @example
+ * extractScopeVars('project:{project_id}') // ['project_id']
+ * extractScopeVars('event_date:{year}:{month}') // ['year', 'month']
+ */
+export function extractScopeVars(pattern) {
+    const matches = pattern.match(/\{([^}]+)\}/g);
+    if (!matches)
+        return [];
+    return matches.map((m) => m.slice(1, -1));
+}
+//# sourceMappingURL=index.js.map

package/dist/scopes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scopes/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8CH,0IAAwE;AAExE;;;GAGG;AACH,SAAS,kBAAkB,CAAC,OAAe,EAIlC;IACP,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,CAAC,CAAE;QACjB,WAAW,EAAE,KAAK,CAAC,CAAC,CAAE;QACtB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAE;KAClB,CAAC;AAAA,CACH;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,OAAe,EAAiB;IAC1D,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,MAAM,EAAE,WAAW,IAAI,IAAI,CAAC;AAAA,CACpC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAyB,EACD;IACxB,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAC9C,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CACb,kBAAkB,KAAK,iDAAiD,CACzE,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAAA,CACf;AAED,4JAAwE;AAExE;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAqB,EAAY;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAAA,CAC3C"}

package/dist/transforms.d.ts

@@ -0,0 +1,146 @@
+/**
+ * @syncular/core - Data transformation hooks
+ *
+ * Provides interfaces for field-level transformations (e.g., encryption/decryption)
+ * that can be applied during sync operations.
+ */
+/**
+ * Direction of the transformation.
+ * - 'toClient': Server → Client (e.g., decrypt for client)
+ * - 'toServer': Client → Server (e.g., encrypt for server)
+ */
+export type TransformDirection = 'toClient' | 'toServer';
+/**
+ * Context passed to transform functions.
+ */
+export interface TransformContext {
+    /** Direction of transformation */
+    direction: TransformDirection;
+    /** Scope name */
+    scope: string;
+    /** Table name */
+    table: string;
+    /** Row ID */
+    rowId: string;
+    /** User ID performing the operation */
+    userId: string;
+}
+/**
+ * A field transformer handles transformation of a single field.
+ *
+ * @example
+ * const secretNotesTransformer: FieldTransformer = {
+ *   field: 'secret_notes',
+ *   async transform(value, ctx) {
+ *     const key = await getUserEncryptionKey(ctx.userId);
+ *     return ctx.direction === 'toClient'
+ *       ? decrypt(value as string, key)
+ *       : encrypt(value as string, key);
+ *   }
+ * };
+ */
+export interface FieldTransformer {
+    /** Field name to transform */
+    field: string;
+    /**
+     * Transform the field value.
+     * @param value - Current field value
+     * @param ctx - Transform context
+     * @returns Transformed value
+     */
+    transform(value: unknown, ctx: TransformContext): Promise<unknown> | unknown;
+}
+/**
+ * Configuration for transforms on a scope.
+ */
+export interface ScopeTransformConfig {
+    /** Scope name this config applies to */
+    scope: string;
+    /** Field transformers for this scope */
+    fields?: FieldTransformer[];
+}
+/**
+ * Registry for managing data transforms.
+ *
+ * @example
+ * const transforms = new TransformRegistry();
+ *
+ * transforms.register({
+ *   scope: 'tasks',
+ *   fields: [{
+ *     field: 'secret_notes',
+ *     async transform(value, ctx) {
+ *       const key = await getUserEncryptionKey(ctx.userId);
+ *       return ctx.direction === 'toClient'
+ *         ? decrypt(value as string, key)
+ *         : encrypt(value as string, key);
+ *     }
+ *   }]
+ * });
+ *
+ * // Apply transforms to data
+ * const transformed = await transforms.apply(
+ *   [{ id: '1', secret_notes: 'encrypted...' }],
+ *   { direction: 'toClient', scope: 'tasks', ... }
+ * );
+ */
+export declare class TransformRegistry {
+    private configs;
+    /**
+     * Register transform config for a scope.
+     * @throws If config for this scope is already registered
+     */
+    register(config: ScopeTransformConfig): void;
+    /**
+     * Unregister transform config by scope.
+     * @returns true if config was found and removed
+     */
+    unregister(scope: string): boolean;
+    /**
+     * Get config for a scope.
+     */
+    get(scope: string): ScopeTransformConfig | undefined;
+    /**
+     * Check if any transforms are registered for a scope.
+     */
+    hasTransforms(scope: string): boolean;
+    /**
+     * Get all registered configs.
+     */
+    getAll(): ScopeTransformConfig[];
+    /**
+     * Apply transforms to a single row.
+     *
+     * @param row - Row data to transform
+     * @param ctx - Transform context (without rowId, will be extracted from row)
+     * @param rowIdField - Field name for row ID (default: 'id')
+     * @returns Transformed row
+     */
+    applyToRow<T extends Record<string, unknown>>(row: T, ctx: Omit<TransformContext, 'rowId'>, rowIdField?: string): Promise<T>;
+    /**
+     * Apply transforms to multiple rows.
+     *
+     * @param rows - Array of rows to transform
+     * @param ctx - Transform context (without rowId)
+     * @param rowIdField - Field name for row ID (default: 'id')
+     * @returns Transformed rows
+     */
+    apply<T extends Record<string, unknown>>(rows: T[], ctx: Omit<TransformContext, 'rowId'>, rowIdField?: string): Promise<T[]>;
+    /**
+     * Apply transforms to a mutation payload.
+     *
+     * @param payload - Mutation payload (may be partial row)
+     * @param ctx - Full transform context
+     * @returns Transformed payload
+     */
+    applyToPayload<T extends Record<string, unknown>>(payload: T | null, ctx: TransformContext): Promise<T | null>;
+    /**
+     * Clear all registered configs.
+     */
+    clear(): void;
+}
+/**
+ * Create a new transform registry.
+ */
+export declare function createTransformRegistry(): TransformRegistry;
+//# sourceMappingURL=transforms.d.ts.map

package/dist/transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.d.ts","sourceRoot":"","sources":["../src/transforms.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,UAAU,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC9E;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAgD;IAE/D;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAO3C;IAED;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjC;IAED;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAEnD;IAED;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGpC;IAED;;OAEG;IACH,MAAM,IAAI,oBAAoB,EAAE,CAE/B;IAED;;;;;;;OAOG;IACG,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChD,GAAG,EAAE,CAAC,EACN,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,EACpC,UAAU,SAAO,GAChB,OAAO,CAAC,CAAC,CAAC,CA4BZ;IAED;;;;;;;OAOG;IACG,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3C,IAAI,EAAE,CAAC,EAAE,EACT,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,EACpC,UAAU,SAAO,GAChB,OAAO,CAAC,CAAC,EAAE,CAAC,CASd;IAED;;;;;;OAMG;IACG,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpD,OAAO,EAAE,CAAC,GAAG,IAAI,EACjB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CA4BnB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAEZ;CACF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D"}

package/dist/transforms.js

@@ -0,0 +1,155 @@
+/**
+ * @syncular/core - Data transformation hooks
+ *
+ * Provides interfaces for field-level transformations (e.g., encryption/decryption)
+ * that can be applied during sync operations.
+ */
+/**
+ * Registry for managing data transforms.
+ *
+ * @example
+ * const transforms = new TransformRegistry();
+ *
+ * transforms.register({
+ *   scope: 'tasks',
+ *   fields: [{
+ *     field: 'secret_notes',
+ *     async transform(value, ctx) {
+ *       const key = await getUserEncryptionKey(ctx.userId);
+ *       return ctx.direction === 'toClient'
+ *         ? decrypt(value as string, key)
+ *         : encrypt(value as string, key);
+ *     }
+ *   }]
+ * });
+ *
+ * // Apply transforms to data
+ * const transformed = await transforms.apply(
+ *   [{ id: '1', secret_notes: 'encrypted...' }],
+ *   { direction: 'toClient', scope: 'tasks', ... }
+ * );
+ */
+export class TransformRegistry {
+    configs = new Map();
+    /**
+     * Register transform config for a scope.
+     * @throws If config for this scope is already registered
+     */
+    register(config) {
+        if (this.configs.has(config.scope)) {
+            throw new Error(`Transform config for scope "${config.scope}" is already registered`);
+        }
+        this.configs.set(config.scope, config);
+    }
+    /**
+     * Unregister transform config by scope.
+     * @returns true if config was found and removed
+     */
+    unregister(scope) {
+        return this.configs.delete(scope);
+    }
+    /**
+     * Get config for a scope.
+     */
+    get(scope) {
+        return this.configs.get(scope);
+    }
+    /**
+     * Check if any transforms are registered for a scope.
+     */
+    hasTransforms(scope) {
+        const config = this.configs.get(scope);
+        return config !== undefined && (config.fields?.length ?? 0) > 0;
+    }
+    /**
+     * Get all registered configs.
+     */
+    getAll() {
+        return Array.from(this.configs.values());
+    }
+    /**
+     * Apply transforms to a single row.
+     *
+     * @param row - Row data to transform
+     * @param ctx - Transform context (without rowId, will be extracted from row)
+     * @param rowIdField - Field name for row ID (default: 'id')
+     * @returns Transformed row
+     */
+    async applyToRow(row, ctx, rowIdField = 'id') {
+        const config = this.configs.get(ctx.scope);
+        if (!config?.fields?.length) {
+            return row;
+        }
+        const rowId = String(row[rowIdField] ?? '');
+        const fullCtx = { ...ctx, rowId };
+        const result = { ...row };
+        for (const transformer of config.fields) {
+            if (transformer.field in result) {
+                try {
+                    result[transformer.field] = (await transformer.transform(result[transformer.field], fullCtx));
+                }
+                catch (err) {
+                    console.error(`[transforms] Error transforming field "${transformer.field}" for ${ctx.scope}:${rowId}:`, err);
+                    // Keep original value on error
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Apply transforms to multiple rows.
+     *
+     * @param rows - Array of rows to transform
+     * @param ctx - Transform context (without rowId)
+     * @param rowIdField - Field name for row ID (default: 'id')
+     * @returns Transformed rows
+     */
+    async apply(rows, ctx, rowIdField = 'id') {
+        const config = this.configs.get(ctx.scope);
+        if (!config?.fields?.length) {
+            return rows;
+        }
+        return Promise.all(rows.map((row) => this.applyToRow(row, ctx, rowIdField)));
+    }
+    /**
+     * Apply transforms to a mutation payload.
+     *
+     * @param payload - Mutation payload (may be partial row)
+     * @param ctx - Full transform context
+     * @returns Transformed payload
+     */
+    async applyToPayload(payload, ctx) {
+        if (!payload)
+            return null;
+        const config = this.configs.get(ctx.scope);
+        if (!config?.fields?.length) {
+            return payload;
+        }
+        const result = { ...payload };
+        for (const transformer of config.fields) {
+            if (transformer.field in result) {
+                try {
+                    result[transformer.field] = (await transformer.transform(result[transformer.field], ctx));
+                }
+                catch (err) {
+                    console.error(`[transforms] Error transforming field "${transformer.field}" for ${ctx.scope}:${ctx.rowId}:`, err);
+                    // Keep original value on error
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Clear all registered configs.
+     */
+    clear() {
+        this.configs.clear();
+    }
+}
+/**
+ * Create a new transform registry.
+ */
+export function createTransformRegistry() {
+    return new TransformRegistry();
+}
+//# sourceMappingURL=transforms.js.map

package/dist/transforms.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,129 @@
+/**
+ * @syncular/core - Shared types for sync infrastructure
+ *
+ * Non-protocol types: conflict detection, transport interfaces.
+ * Protocol types (SyncOp, SyncPushRequest, etc.) live in ./schemas/sync.ts
+ */
+import type { SyncCombinedRequest, SyncCombinedResponse } from './schemas/sync';
+/**
+ * Result of a conflict check - no conflict
+ */
+interface ConflictCheckResultOk {
+    hasConflict: false;
+}
+/**
+ * Result of a conflict check - conflict detected
+ */
+interface ConflictCheckResultConflict {
+    hasConflict: true;
+    /** Fields with conflicting changes */
+    conflictingFields: string[];
+    /** Current server row state */
+    serverRow: Record<string, unknown>;
+    /** Current server version */
+    serverVersion: number;
+}
+/**
+ * Union type for conflict check results
+ */
+export type ConflictCheckResult = ConflictCheckResultOk | ConflictCheckResultConflict;
+/**
+ * Result of a field-level merge - can merge
+ */
+export interface MergeResultOk {
+    canMerge: true;
+    /** Merged payload combining client and server changes */
+    mergedPayload: Record<string, unknown>;
+}
+/**
+ * Result of a field-level merge - cannot merge
+ */
+export interface MergeResultConflict {
+    canMerge: false;
+    /** Fields that cannot be auto-merged */
+    conflictingFields: string[];
+}
+/**
+ * Union type for merge results
+ */
+export type MergeResult = MergeResultOk | MergeResultConflict;
+/**
+ * Options for transport operations.
+ * Provides hooks for auth errors and cancellation support.
+ */
+export interface SyncTransportOptions {
+    /**
+     * Called when auth fails (401/403).
+     * Return true to retry the request after refreshing auth.
+     */
+    onAuthError?: () => Promise<boolean>;
+    /**
+     * Abort signal for cancellation support.
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Blob transport operations (optional extension to SyncTransport).
+ * When present, enables blob upload/download through the same transport.
+ */
+export interface SyncTransportBlobs {
+    /**
+     * Initiate a blob upload.
+     * Returns presigned URL info or indicates blob already exists (dedup).
+     */
+    initiateUpload(args: {
+        hash: string;
+        size: number;
+        mimeType: string;
+    }): Promise<{
+        exists: boolean;
+        uploadUrl?: string;
+        uploadMethod?: 'PUT' | 'POST';
+        uploadHeaders?: Record<string, string>;
+    }>;
+    /**
+     * Complete a blob upload.
+     * Call this after uploading to the presigned URL.
+     */
+    completeUpload(hash: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /**
+     * Get a presigned download URL.
+     */
+    getDownloadUrl(hash: string): Promise<{
+        url: string;
+        expiresAt: string;
+    }>;
+}
+/**
+ * Transport interface for sync operations.
+ */
+export interface SyncTransport {
+    /**
+     * Combined push+pull in a single round-trip.
+     */
+    sync(request: SyncCombinedRequest, options?: SyncTransportOptions): Promise<SyncCombinedResponse>;
+    /**
+     * Download an encoded bootstrap snapshot chunk.
+     */
+    fetchSnapshotChunk(request: {
+        chunkId: string;
+    }, options?: SyncTransportOptions): Promise<Uint8Array>;
+    /**
+     * Optional blob operations.
+     * When present, enables blob upload/download functionality.
+     */
+    blobs?: SyncTransportBlobs;
+}
+/**
+ * Transport error with additional context
+ */
+export declare class SyncTransportError extends Error {
+    readonly status?: number | undefined;
+    readonly code?: string | undefined;
+    constructor(message: string, status?: number | undefined, code?: string | undefined);
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAMhF;;GAEG;AACH,UAAU,qBAAqB;IAC7B,WAAW,EAAE,KAAK,CAAC;CACpB;AAED;;GAEG;AACH,UAAU,2BAA2B;IACnC,WAAW,EAAE,IAAI,CAAC;IAClB,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,qBAAqB,GACrB,2BAA2B,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,IAAI,CAAC;IACf,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,KAAK,CAAC;IAChB,wCAAwC;IACxC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,mBAAmB,CAAC;AAM9D;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC;QACV,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;QAC9B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACxC,CAAC,CAAC;IAEH;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEvE;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QACpC,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,CACF,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC;;OAEG;IACH,kBAAkB,CAChB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,EAC5B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB;;;OAGG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,MAAM,CAAC;aACP,IAAI,CAAC;IAHvB,YACE,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,oBAAQ,EACf,IAAI,CAAC,oBAAQ,EAI9B;CACF"}

package/dist/types.js

@@ -0,0 +1,20 @@
+/**
+ * @syncular/core - Shared types for sync infrastructure
+ *
+ * Non-protocol types: conflict detection, transport interfaces.
+ * Protocol types (SyncOp, SyncPushRequest, etc.) live in ./schemas/sync.ts
+ */
+/**
+ * Transport error with additional context
+ */
+export class SyncTransportError extends Error {
+    status;
+    code;
+    constructor(message, status, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = 'SyncTransportError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4IH;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGzB,MAAM;IACN,IAAI;IAHtB,YACE,OAAe,EACC,MAAe,EACf,IAAa,EAC7B;QACA,KAAK,CAAC,OAAO,CAAC,CAAC;sBAHC,MAAM;oBACN,IAAI;QAGpB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IAAA,CAClC;CACF"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@syncular/core",
+  "version": "0.0.1-60",
+  "description": "Core protocol types and shared utilities for the Syncular sync framework",
+  "license": "MIT",
+  "author": "Benjamin Kniffler",
+  "homepage": "https://syncular.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/syncular/syncular.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/syncular/syncular/issues"
+  },
+  "keywords": [
+    "sync",
+    "offline-first",
+    "realtime",
+    "database",
+    "typescript"
+  ],
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "test": "bun test src/__tests__",
+    "tsgo": "tsgo --noEmit",
+    "build": "rm -rf dist && tsgo",
+    "release": "bun pm pack --destination . && npm publish ./*.tgz --tag latest && rm -f ./*.tgz"
+  },
+  "peerDependencies": {
+    "kysely": "^0.28.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@syncular/config": "0.0.0",
+    "kysely": "*",
+    "zod": "*"
+  },
+  "files": [
+    "dist",
+    "src"
+  ]
+}