@pol-studios/powersync 1.0.0 → 1.0.2

package/dist/index-nae7nzib.d.ts

@@ -1,147 +0,0 @@
-import { S as SupabaseConnector, a as SupabaseConnectorOptions } from './supabase-connector-D14-kl5v.js';
-import { A as AbstractPowerSyncDatabase } from './types-afHtE1U_.js';
-
-/**
- * Conflict Types for @pol-studios/powersync
- *
- * Provides types for version-based conflict detection using AuditLog attribution.
- */
-/**
- * Represents a field-level conflict where both local and server changed the same field.
- */
-interface FieldConflict {
-    /** The field name that has conflicting changes */
-    field: string;
-    /** The local (pending) value */
-    localValue: unknown;
-    /** The current server value */
-    serverValue: unknown;
-    /** User who made the server change (from AuditLog.changeBy) */
-    changedBy: string | null;
-    /** When the server change occurred (from AuditLog.changeAt) */
-    changedAt: Date;
-}
-/**
- * Result of checking for conflicts between local changes and server state.
- */
-interface ConflictCheckResult {
-    /** Whether any field conflicts were detected */
-    hasConflict: boolean;
-    /** List of field-level conflicts */
-    conflicts: FieldConflict[];
-    /** Fields that can safely sync (no server changes) */
-    nonConflictingChanges: string[];
-    /** The table name */
-    table: string;
-    /** The record ID */
-    recordId: string;
-}
-/**
- * User's resolution choice for a conflict.
- */
-type ConflictResolution = {
-    action: 'overwrite';
-} | {
-    action: 'keep-server';
-} | {
-    action: 'partial';
-    fields: string[];
-};
-/**
- * Handler for conflict events in the connector.
- */
-interface ConflictHandler {
-    /**
-     * Called when a conflict is detected during upload.
-     *
-     * @param result - The conflict check result
-     * @returns Resolution to apply, or null to queue for UI resolution
-     */
-    onConflict: (result: ConflictCheckResult) => Promise<ConflictResolution | null>;
-}
-/**
- * Configuration for conflict detection behavior.
- */
-interface ConflictDetectionConfig {
-    /** Tables to skip conflict detection (opt-out). Default: [] */
-    skipTables?: string[];
-    /** Fields to ignore in conflict detection. Default: ['updatedAt', 'createdAt'] */
-    ignoredFields?: string[];
-    /** Whether to enable conflict detection. Default: true */
-    enabled?: boolean;
-}
-
-/**
- * Conflict-Aware Connector for @pol-studios/powersync
- *
- * Extends SupabaseConnector with version-based conflict detection.
- * Tables with a _version column automatically get conflict checking.
- */
-
-/**
- * Options for ConflictAwareConnector.
- */
-interface ConflictAwareConnectorOptions extends SupabaseConnectorOptions {
-    /** Handler for conflict resolution. If not provided, conflicts are logged. */
-    conflictHandler?: ConflictHandler;
-    /** Configuration for conflict detection behavior */
-    conflictDetection?: ConflictDetectionConfig;
-}
-/**
- * A PowerSync connector with built-in conflict detection.
- *
- * This connector extends SupabaseConnector to add version-based conflict
- * detection for tables with a `_version` column. When a conflict is detected,
- * it calls the provided conflict handler to determine how to proceed.
- *
- * @example
- * ```typescript
- * const connector = new ConflictAwareConnector({
- *   supabaseClient: supabase,
- *   powerSyncUrl: POWERSYNC_URL,
- *   conflictHandler: {
- *     onConflict: async (result) => {
- *       // Queue for UI resolution
- *       conflictContext.addConflict(result);
- *       return null; // Don't proceed with upload
- *     },
- *   },
- * });
- * ```
- */
-declare class ConflictAwareConnector extends SupabaseConnector {
-    private readonly conflictHandler?;
-    private readonly conflictConfig?;
-    private readonly supabaseClient;
-    private readonly schemaRouterFn;
-    private versionColumnCache;
-    constructor(options: ConflictAwareConnectorOptions);
-    /**
-     * Override uploadData to check for conflicts before uploading.
-     *
-     * For each CRUD entry in the transaction:
-     * 1. Check if table has _version column (cached)
-     * 2. If yes, compare local vs server version
-     * 3. On version mismatch, query AuditLog for field conflicts
-     * 4. If conflicts found, call handler to determine resolution
-     * 5. Apply resolution or skip entry based on handler response
-     */
-    uploadData(database: AbstractPowerSyncDatabase): Promise<void>;
-    /**
-     * Check if a table has a _version column (cached).
-     */
-    private checkVersionColumn;
-    /**
-     * Filter opData to only include specified fields.
-     */
-    private filterFields;
-    /**
-     * Process a single CRUD entry - delegates to parent's private method.
-     *
-     * Note: This is a workaround since processCrudEntry is private in parent.
-     * We replicate the logic here for now.
-     */
-    private processEntry;
-}
-
-export { ConflictAwareConnector as C, type FieldConflict as F, type ConflictAwareConnectorOptions as a, type ConflictCheckResult as b, type ConflictResolution as c, type ConflictHandler as d, type ConflictDetectionConfig as e };