agentic-qe 3.2.3 → 3.3.1

package/v3/dist/sync/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Cloud Sync Module
+ *
+ * Exports all cloud sync functionality for AQE learning data.
+ *
+ * @example
+ * ```typescript
+ * import { syncToCloud, createSyncAgent } from '@agentic-qe/v3/sync';
+ *
+ * // Quick sync
+ * const report = await syncToCloud({ environment: 'devpod' });
+ *
+ * // Advanced usage
+ * const agent = createSyncAgent({
+ *   environment: 'devpod',
+ *   verbose: true,
+ *   sync: {
+ *     mode: 'incremental',
+ *     batchSize: 500,
+ *   },
+ * });
+ * await agent.initialize();
+ * const report = await agent.syncAll();
+ * await agent.close();
+ * ```
+ */
+export type { SyncConfig, LocalDataSources, CloudConfig, SyncSettings, SyncMode, ConflictResolution, SyncSource, SyncResult, SyncReport, DataReader, CloudWriter, UpsertOptions, TunnelConnection, EmbeddingGenerator, } from './interfaces.js';
+export { DEFAULT_SYNC_CONFIG, TYPE_MAPPING } from './interfaces.js';
+export { SQLiteReader, createSQLiteReader, type SQLiteReaderConfig, type SQLiteRecord, } from './readers/sqlite-reader.js';
+export { JSONReader, createJSONReader, type JSONReaderConfig, type JSONRecord, } from './readers/json-reader.js';
+export type { TunnelManager } from './cloud/tunnel-manager.js';
+export { IAPTunnelManager, DirectConnectionManager, createTunnelManager, createConnectionManager, } from './cloud/tunnel-manager.js';
+export { PostgresWriter, createPostgresWriter, type PostgresWriterConfig, } from './cloud/postgres-writer.js';
+export { CloudSyncAgent, createSyncAgent, syncToCloud, syncIncrementalToCloud, type SyncAgentConfig, type SourceStatus, type VerifyResult, type VerifyTableResult, } from './sync-agent.js';
+//# sourceMappingURL=index.d.ts.map

package/v3/dist/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,UAAU,GAChB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,KAAK,oBAAoB,GAC1B,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,cAAc,EACd,eAAe,EACf,WAAW,EACX,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC"}

package/v3/dist/sync/index.js

@@ -0,0 +1,35 @@
+/**
+ * Cloud Sync Module
+ *
+ * Exports all cloud sync functionality for AQE learning data.
+ *
+ * @example
+ * ```typescript
+ * import { syncToCloud, createSyncAgent } from '@agentic-qe/v3/sync';
+ *
+ * // Quick sync
+ * const report = await syncToCloud({ environment: 'devpod' });
+ *
+ * // Advanced usage
+ * const agent = createSyncAgent({
+ *   environment: 'devpod',
+ *   verbose: true,
+ *   sync: {
+ *     mode: 'incremental',
+ *     batchSize: 500,
+ *   },
+ * });
+ * await agent.initialize();
+ * const report = await agent.syncAll();
+ * await agent.close();
+ * ```
+ */
+export { DEFAULT_SYNC_CONFIG, TYPE_MAPPING } from './interfaces.js';
+// Readers
+export { SQLiteReader, createSQLiteReader, } from './readers/sqlite-reader.js';
+export { JSONReader, createJSONReader, } from './readers/json-reader.js';
+export { IAPTunnelManager, DirectConnectionManager, createTunnelManager, createConnectionManager, } from './cloud/tunnel-manager.js';
+export { PostgresWriter, createPostgresWriter, } from './cloud/postgres-writer.js';
+// Sync agent
+export { CloudSyncAgent, createSyncAgent, syncToCloud, syncIncrementalToCloud, } from './sync-agent.js';
+//# sourceMappingURL=index.js.map

package/v3/dist/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAoBH,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpE,UAAU;AACV,OAAO,EACL,YAAY,EACZ,kBAAkB,GAGnB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,UAAU,EACV,gBAAgB,GAGjB,MAAM,0BAA0B,CAAC;AAIlC,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,cAAc,EACd,oBAAoB,GAErB,MAAM,4BAA4B,CAAC;AAEpC,aAAa;AACb,OAAO,EACL,cAAc,EACd,eAAe,EACf,WAAW,EACX,sBAAsB,GAKvB,MAAM,iBAAiB,CAAC"}

package/v3/dist/sync/interfaces.d.ts

@@ -0,0 +1,245 @@
+/**
+ * Cloud Sync Interfaces
+ *
+ * Defines the contracts for syncing local AQE learning data to cloud PostgreSQL.
+ * Consolidates data from 6+ local sources into unified cloud storage.
+ */
+/**
+ * Sync configuration for connecting local sources to cloud
+ */
+export interface SyncConfig {
+    /** All local data sources (fragmented across system) */
+    local: LocalDataSources;
+    /** Cloud PostgreSQL configuration */
+    cloud: CloudConfig;
+    /** Sync behavior settings */
+    sync: SyncSettings;
+    /** Environment identifier */
+    environment: string;
+}
+/**
+ * Local data source paths
+ */
+export interface LocalDataSources {
+    /** PRIMARY - V3 active runtime database */
+    v3MemoryDb: string;
+    /** HISTORICAL - Root v2 memory database */
+    rootMemoryDb: string;
+    /** CLAUDE-FLOW - JSON memory store */
+    claudeFlowMemory: string;
+    /** CLAUDE-FLOW - Daemon state */
+    claudeFlowDaemon: string;
+    /** CLAUDE-FLOW - Metrics directory */
+    claudeFlowMetrics: string;
+    /** Q-LEARNING - Intelligence patterns */
+    intelligenceJson: string;
+    /** LEGACY - Swarm memory database */
+    swarmMemoryDb?: string;
+    /** LEGACY - V2 patterns database */
+    v2PatternsDb?: string;
+}
+/**
+ * Cloud PostgreSQL configuration
+ */
+export interface CloudConfig {
+    /** GCP project ID */
+    project: string;
+    /** GCP zone */
+    zone: string;
+    /** Cloud SQL instance name */
+    instance: string;
+    /** Database name */
+    database: string;
+    /** Database user */
+    user: string;
+    /** IAP tunnel port */
+    tunnelPort: number;
+    /** Connection string (computed from above or direct) */
+    connectionString?: string;
+}
+/**
+ * Sync behavior settings
+ */
+export interface SyncSettings {
+    /** Sync mode */
+    mode: SyncMode;
+    /** Sync interval (e.g., '5m', '1h') */
+    interval: string;
+    /** Batch size for records */
+    batchSize: number;
+    /** Source priority (higher = sync first) */
+    sourcePriority: Record<string, number>;
+    /** Sources to sync */
+    sources: SyncSource[];
+    /** Enable dry run (no writes) */
+    dryRun?: boolean;
+    /** Conflict resolution strategy */
+    conflictResolution: ConflictResolution;
+}
+/**
+ * Sync modes
+ */
+export type SyncMode = 'full' | 'incremental' | 'bidirectional' | 'append';
+/**
+ * Conflict resolution strategies
+ */
+export type ConflictResolution = 'local-wins' | 'cloud-wins' | 'newer-wins' | 'higher-confidence' | 'merge';
+/**
+ * Individual sync source configuration
+ */
+export interface SyncSource {
+    /** Source name (for logging) */
+    name: string;
+    /** Source type */
+    type: 'sqlite' | 'json';
+    /** File path */
+    path: string;
+    /** Target cloud table */
+    targetTable: string;
+    /** Priority level */
+    priority: 'high' | 'medium' | 'low';
+    /** Sync mode for this source */
+    mode: SyncMode;
+    /** Custom transform function name */
+    transform?: string;
+    /** Source-specific query (for SQLite) */
+    query?: string;
+    /** JSON path (for JSON sources) */
+    jsonPath?: string;
+    /** Whether this source is enabled */
+    enabled?: boolean;
+}
+/**
+ * Sync result
+ */
+export interface SyncResult {
+    /** Whether sync was successful */
+    success: boolean;
+    /** Table that was synced */
+    table: string;
+    /** Source that was synced */
+    source: string;
+    /** Number of records synced */
+    recordsSynced: number;
+    /** Number of conflicts resolved */
+    conflictsResolved: number;
+    /** Number of records skipped */
+    recordsSkipped: number;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Error message if failed */
+    error?: string;
+    /** Warnings */
+    warnings?: string[];
+}
+/**
+ * Full sync report
+ */
+export interface SyncReport {
+    /** Sync ID */
+    syncId: string;
+    /** Start time */
+    startedAt: Date;
+    /** End time */
+    completedAt?: Date;
+    /** Overall status */
+    status: 'running' | 'completed' | 'failed' | 'partial';
+    /** Environment that was synced */
+    environment: string;
+    /** Sync mode used */
+    mode: SyncMode;
+    /** Results per table */
+    results: SyncResult[];
+    /** Total records synced */
+    totalRecordsSynced: number;
+    /** Total conflicts resolved */
+    totalConflictsResolved: number;
+    /** Total duration */
+    totalDurationMs: number;
+    /** Errors encountered */
+    errors: string[];
+}
+/**
+ * Data reader interface for local sources
+ */
+export interface DataReader<T = unknown> {
+    /** Reader name */
+    readonly name: string;
+    /** Source type */
+    readonly type: 'sqlite' | 'json';
+    /** Initialize the reader */
+    initialize(): Promise<void>;
+    /** Read all records */
+    readAll(): Promise<T[]>;
+    /** Read records changed since timestamp */
+    readChanged(since: Date): Promise<T[]>;
+    /** Get record count */
+    count(): Promise<number>;
+    /** Close the reader */
+    close(): Promise<void>;
+}
+/**
+ * Cloud writer interface
+ */
+export interface CloudWriter {
+    /** Connect to cloud database */
+    connect(): Promise<void>;
+    /** Begin a transaction */
+    beginTransaction(): Promise<void>;
+    /** Commit transaction */
+    commit(): Promise<void>;
+    /** Rollback transaction */
+    rollback(): Promise<void>;
+    /** Upsert records to a table */
+    upsert<T>(table: string, records: T[], options?: UpsertOptions): Promise<number>;
+    /** Execute raw SQL */
+    execute(sql: string, params?: unknown[]): Promise<void>;
+    /** Query records */
+    query<T>(sql: string, params?: unknown[]): Promise<T[]>;
+    /** Close connection */
+    close(): Promise<void>;
+}
+/**
+ * Upsert options
+ */
+export interface UpsertOptions {
+    /** Conflict columns for ON CONFLICT */
+    conflictColumns?: string[];
+    /** Update columns on conflict */
+    updateColumns?: string[];
+    /** Skip if exists (no update) */
+    skipIfExists?: boolean;
+}
+/**
+ * Tunnel connection info
+ */
+export interface TunnelConnection {
+    /** Local host */
+    host: string;
+    /** Local port */
+    port: number;
+    /** Process ID */
+    pid?: number;
+    /** Started at */
+    startedAt: Date;
+}
+/**
+ * Embedding generator interface
+ */
+export interface EmbeddingGenerator {
+    /** Generate embedding for text */
+    generate(text: string): Promise<number[]>;
+    /** Generate embeddings for multiple texts */
+    generateBatch(texts: string[]): Promise<number[][]>;
+    /** Embedding dimension */
+    readonly dimension: number;
+}
+/**
+ * SQLite to PostgreSQL type mapping
+ */
+export declare const TYPE_MAPPING: Record<string, string>;
+/**
+ * Default sync configuration
+ */
+export declare const DEFAULT_SYNC_CONFIG: SyncConfig;
+//# sourceMappingURL=interfaces.d.ts.map

package/v3/dist/sync/interfaces.d.ts.map

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

package/v3/dist/sync/interfaces.js

@@ -0,0 +1,160 @@
+/**
+ * Cloud Sync Interfaces
+ *
+ * Defines the contracts for syncing local AQE learning data to cloud PostgreSQL.
+ * Consolidates data from 6+ local sources into unified cloud storage.
+ */
+/**
+ * SQLite to PostgreSQL type mapping
+ */
+export const TYPE_MAPPING = {
+    'TEXT': 'TEXT',
+    'INTEGER': 'INTEGER',
+    'REAL': 'REAL',
+    'BLOB': 'BYTEA',
+    'NULL': 'NULL',
+};
+/**
+ * Default sync configuration
+ */
+export const DEFAULT_SYNC_CONFIG = {
+    local: {
+        // Paths are relative to project root (parent of v3/)
+        v3MemoryDb: '../v3/.agentic-qe/memory.db',
+        rootMemoryDb: '../.agentic-qe/memory.db',
+        claudeFlowMemory: '../.claude-flow/memory/store.json',
+        claudeFlowDaemon: '../.claude-flow/daemon-state.json',
+        claudeFlowMetrics: '../.claude-flow/metrics/',
+        intelligenceJson: '../v3/.ruvector/intelligence.json',
+        swarmMemoryDb: '../.swarm/memory.db',
+        v2PatternsDb: '../v2/data/ruvector-patterns.db',
+    },
+    cloud: {
+        project: process.env.GCP_PROJECT || 'ferrous-griffin-480616-s9',
+        zone: process.env.GCP_ZONE || 'us-central1-a',
+        instance: process.env.GCP_INSTANCE || 'ruvector-postgres',
+        database: process.env.GCP_DATABASE || 'aqe_learning',
+        user: process.env.GCP_USER || 'ruvector',
+        tunnelPort: parseInt(process.env.GCP_TUNNEL_PORT || '15432', 10),
+    },
+    sync: {
+        mode: 'incremental',
+        interval: '1h',
+        batchSize: 1000,
+        conflictResolution: 'newer-wins',
+        sourcePriority: {
+            v3Memory: 1,
+            claudeFlowMemory: 2,
+            rootMemory: 3,
+            intelligenceJson: 4,
+            legacy: 5,
+        },
+        sources: [
+            // V3 Memory - PRIMARY
+            {
+                name: 'v3-qe-patterns',
+                type: 'sqlite',
+                path: '../v3/.agentic-qe/memory.db',
+                targetTable: 'aqe.qe_patterns',
+                priority: 'high',
+                mode: 'incremental',
+                query: 'SELECT * FROM qe_patterns',
+                enabled: true,
+            },
+            {
+                name: 'v3-sona-patterns',
+                type: 'sqlite',
+                path: '../v3/.agentic-qe/memory.db',
+                targetTable: 'aqe.sona_patterns',
+                priority: 'high',
+                mode: 'incremental',
+                query: 'SELECT * FROM sona_patterns',
+                enabled: true,
+            },
+            {
+                name: 'v3-goap-actions',
+                type: 'sqlite',
+                path: '../v3/.agentic-qe/memory.db',
+                targetTable: 'aqe.goap_actions',
+                priority: 'high',
+                mode: 'incremental',
+                query: 'SELECT * FROM goap_actions',
+                enabled: true,
+            },
+            // Claude-Flow Memory
+            {
+                name: 'claude-flow-memory',
+                type: 'json',
+                path: '../.claude-flow/memory/store.json',
+                targetTable: 'aqe.claude_flow_memory',
+                priority: 'high',
+                mode: 'full',
+                enabled: true,
+            },
+            // Root Memory - HISTORICAL
+            {
+                name: 'root-memory-entries',
+                type: 'sqlite',
+                path: '../.agentic-qe/memory.db',
+                targetTable: 'aqe.memory_entries',
+                priority: 'medium',
+                mode: 'incremental',
+                query: 'SELECT * FROM memory_entries',
+                enabled: true,
+            },
+            {
+                name: 'root-learning-experiences',
+                type: 'sqlite',
+                path: '../.agentic-qe/memory.db',
+                targetTable: 'aqe.learning_experiences',
+                priority: 'medium',
+                mode: 'append',
+                query: 'SELECT * FROM learning_experiences',
+                enabled: true,
+            },
+            {
+                name: 'root-goap-actions',
+                type: 'sqlite',
+                path: '../.agentic-qe/memory.db',
+                targetTable: 'aqe.goap_actions',
+                priority: 'medium',
+                mode: 'incremental',
+                query: 'SELECT * FROM goap_actions',
+                enabled: true,
+            },
+            {
+                name: 'root-patterns',
+                type: 'sqlite',
+                path: '../.agentic-qe/memory.db',
+                targetTable: 'aqe.patterns',
+                priority: 'medium',
+                mode: 'incremental',
+                query: 'SELECT * FROM patterns',
+                enabled: true,
+            },
+            {
+                name: 'root-events',
+                type: 'sqlite',
+                path: '../.agentic-qe/memory.db',
+                targetTable: 'aqe.events',
+                priority: 'low',
+                mode: 'append',
+                query: 'SELECT * FROM events',
+                enabled: true,
+            },
+            // Intelligence JSON
+            {
+                name: 'intelligence-qlearning',
+                type: 'json',
+                path: '../v3/.ruvector/intelligence.json',
+                targetTable: 'aqe.qlearning_patterns',
+                priority: 'medium',
+                mode: 'full',
+                jsonPath: '$.qvalues',
+                enabled: true,
+            },
+        ],
+    },
+    environment: process.env.AQE_ENV || 'devpod',
+};
+//# sourceMappingURL=interfaces.js.map

package/v3/dist/sync/interfaces.js.map

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

package/v3/dist/sync/readers/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Data Readers Index
+ *
+ * Exports all data reader implementations for cloud sync.
+ */
+export { SQLiteReader, createSQLiteReader, type SQLiteReaderConfig, type SQLiteRecord } from './sqlite-reader.js';
+export { JSONReader, createJSONReader, type JSONReaderConfig, type JSONRecord } from './json-reader.js';
+//# sourceMappingURL=index.d.ts.map

package/v3/dist/sync/readers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sync/readers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/v3/dist/sync/readers/index.js

@@ -0,0 +1,8 @@
+/**
+ * Data Readers Index
+ *
+ * Exports all data reader implementations for cloud sync.
+ */
+export { SQLiteReader, createSQLiteReader } from './sqlite-reader.js';
+export { JSONReader, createJSONReader } from './json-reader.js';
+//# sourceMappingURL=index.js.map

package/v3/dist/sync/readers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sync/readers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAA8C,MAAM,oBAAoB,CAAC;AAClH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAA0C,MAAM,kBAAkB,CAAC"}

package/v3/dist/sync/readers/json-reader.d.ts

@@ -0,0 +1,95 @@
+/**
+ * JSON Data Reader
+ *
+ * Reads data from local JSON files for cloud sync.
+ * Handles: store.json, intelligence.json, daemon-state.json, etc.
+ */
+import type { DataReader, SyncSource } from '../interfaces.js';
+/**
+ * JSON reader configuration
+ */
+export interface JSONReaderConfig {
+    /** Source configuration */
+    source: SyncSource;
+    /** Base directory for resolving paths */
+    baseDir: string;
+    /** Environment identifier */
+    environment: string;
+}
+/**
+ * Generic record type from JSON
+ */
+export interface JSONRecord {
+    [key: string]: unknown;
+}
+/**
+ * JSON data reader implementation
+ */
+export declare class JSONReader implements DataReader<JSONRecord> {
+    readonly name: string;
+    readonly type: "json";
+    private readonly config;
+    private readonly filePath;
+    private data;
+    private fileModTime;
+    constructor(config: JSONReaderConfig);
+    /**
+     * Initialize the reader
+     */
+    initialize(): Promise<void>;
+    /**
+     * Read all records
+     */
+    readAll(): Promise<JSONRecord[]>;
+    /**
+     * Read records changed since a timestamp
+     * For JSON files, we compare file modification time
+     */
+    readChanged(since: Date): Promise<JSONRecord[]>;
+    /**
+     * Get record count
+     */
+    count(): Promise<number>;
+    /**
+     * Close the reader
+     */
+    close(): Promise<void>;
+    /**
+     * Extract records from parsed JSON based on source type
+     */
+    private extractRecords;
+    /**
+     * Extract by JSON path (simplified implementation)
+     */
+    private extractByPath;
+    /**
+     * Extract records from Claude-Flow memory store
+     */
+    private extractClaudeFlowMemory;
+    /**
+     * Extract records from intelligence.json
+     */
+    private extractIntelligence;
+    /**
+     * Extract records from daemon-state.json
+     */
+    private extractDaemonState;
+    /**
+     * Transform a record for cloud sync
+     */
+    private transformRecord;
+    /**
+     * Get file info for debugging
+     */
+    getInfo(): {
+        path: string;
+        exists: boolean;
+        modTime: Date | null;
+        size: number;
+    };
+}
+/**
+ * Create a JSON reader
+ */
+export declare function createJSONReader(config: JSONReaderConfig): JSONReader;
+//# sourceMappingURL=json-reader.d.ts.map

package/v3/dist/sync/readers/json-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-reader.d.ts","sourceRoot":"","sources":["../../../src/sync/readers/json-reader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,MAAM,EAAE,UAAU,CAAC;IAEnB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAEhB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,UAAW,YAAW,UAAU,CAAC,UAAU,CAAC;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAEhC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,WAAW,CAAqB;gBAE5B,MAAM,EAAE,gBAAgB;IAMpC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAsBtC;;;OAGG;IACG,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAerD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAK9B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAoCtB;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA8B/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA+C3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;OAEG;IACH,OAAO,CAAC,eAAe;IA+BvB;;OAEG;IACH,OAAO,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;CAajF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAErE"}