@stoneforge/quarry 0.1.0

package/dist/sync/serialization.js

@@ -0,0 +1,306 @@
+/**
+ * Sync Serialization - JSONL format serialization and parsing
+ *
+ * Handles conversion between Element/Dependency objects and JSONL format.
+ * All timestamps are normalized to ISO 8601 format.
+ */
+import { ValidationError, ErrorCode, isElement, validateElement, isDependency, validateDependency } from '@stoneforge/core';
+import { getTypePriority } from './types.js';
+// ============================================================================
+// Element Serialization
+// ============================================================================
+/**
+ * Serialize an element to JSONL format
+ *
+ * @param element - Element to serialize
+ * @returns JSON string ready for JSONL file
+ */
+export function serializeElement(element) {
+    // Validate element before serializing
+    if (!isElement(element)) {
+        throw new ValidationError('Cannot serialize invalid element', ErrorCode.INVALID_INPUT, { element });
+    }
+    // Create serialized form with all fields inline
+    const serialized = {
+        ...element,
+        id: element.id,
+        type: element.type,
+        createdAt: element.createdAt,
+        updatedAt: element.updatedAt,
+        createdBy: element.createdBy,
+        tags: [...element.tags],
+        metadata: { ...element.metadata },
+    };
+    return JSON.stringify(serialized);
+}
+/**
+ * Parse a JSONL line into an element
+ *
+ * @param line - JSON string from JSONL file
+ * @returns Parsed element
+ * @throws ValidationError if parsing fails
+ */
+export function parseElement(line) {
+    if (!line || line.trim().length === 0) {
+        throw new ValidationError('Cannot parse empty line as element', ErrorCode.INVALID_INPUT, { line });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch (err) {
+        throw new ValidationError(`Invalid JSON in element line: ${err instanceof Error ? err.message : 'unknown error'}`, ErrorCode.INVALID_INPUT, { line: line.substring(0, 100) });
+    }
+    // Validate as element
+    return validateElement(parsed);
+}
+/**
+ * Try to parse a JSONL line into an element
+ *
+ * @param line - JSON string from JSONL file
+ * @returns Parsed element or null if invalid
+ */
+export function tryParseElement(line) {
+    try {
+        return parseElement(line);
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================================
+// Dependency Serialization
+// ============================================================================
+/**
+ * Serialize a dependency to JSONL format
+ *
+ * @param dependency - Dependency to serialize
+ * @returns JSON string ready for JSONL file
+ */
+export function serializeDependency(dependency) {
+    // Validate dependency before serializing
+    if (!isDependency(dependency)) {
+        throw new ValidationError('Cannot serialize invalid dependency', ErrorCode.INVALID_INPUT, { dependency });
+    }
+    const serialized = {
+        blockedId: dependency.blockedId,
+        blockerId: dependency.blockerId,
+        type: dependency.type,
+        createdAt: dependency.createdAt,
+        createdBy: dependency.createdBy,
+    };
+    // Only include metadata if non-empty
+    if (Object.keys(dependency.metadata).length > 0) {
+        serialized.metadata = { ...dependency.metadata };
+    }
+    return JSON.stringify(serialized);
+}
+/**
+ * Parse a JSONL line into a dependency
+ *
+ * @param line - JSON string from JSONL file
+ * @returns Parsed dependency
+ * @throws ValidationError if parsing fails
+ */
+export function parseDependency(line) {
+    if (!line || line.trim().length === 0) {
+        throw new ValidationError('Cannot parse empty line as dependency', ErrorCode.INVALID_INPUT, { line });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch (err) {
+        throw new ValidationError(`Invalid JSON in dependency line: ${err instanceof Error ? err.message : 'unknown error'}`, ErrorCode.INVALID_INPUT, { line: line.substring(0, 100) });
+    }
+    // Ensure metadata exists (defaults to empty object)
+    if (typeof parsed === 'object' && parsed !== null) {
+        const obj = parsed;
+        if (obj.metadata === undefined) {
+            obj.metadata = {};
+        }
+    }
+    // Validate as dependency
+    return validateDependency(parsed);
+}
+/**
+ * Try to parse a JSONL line into a dependency
+ *
+ * @param line - JSON string from JSONL file
+ * @returns Parsed dependency or null if invalid
+ */
+export function tryParseDependency(line) {
+    try {
+        return parseDependency(line);
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================================
+// Batch Serialization
+// ============================================================================
+/**
+ * Serialize multiple elements to JSONL content
+ *
+ * @param elements - Elements to serialize
+ * @returns JSONL content (multiple lines)
+ */
+export function serializeElements(elements) {
+    return elements.map(serializeElement).join('\n');
+}
+/**
+ * Serialize multiple dependencies to JSONL content
+ *
+ * @param dependencies - Dependencies to serialize
+ * @returns JSONL content (multiple lines)
+ */
+export function serializeDependencies(dependencies) {
+    return dependencies.map(serializeDependency).join('\n');
+}
+/**
+ * Parse JSONL content into elements
+ *
+ * @param content - JSONL content (multiple lines)
+ * @returns Array of parsed elements and any errors
+ */
+export function parseElements(content) {
+    const lines = content.split('\n').filter((line) => line.trim().length > 0);
+    const elements = [];
+    const errors = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        try {
+            elements.push(parseElement(line));
+        }
+        catch (err) {
+            errors.push({
+                line: i + 1,
+                message: err instanceof Error ? err.message : 'Unknown error',
+                content: line.substring(0, 100),
+            });
+        }
+    }
+    return { elements, errors };
+}
+/**
+ * Parse JSONL content into dependencies
+ *
+ * @param content - JSONL content (multiple lines)
+ * @returns Array of parsed dependencies and any errors
+ */
+export function parseDependencies(content) {
+    const lines = content.split('\n').filter((line) => line.trim().length > 0);
+    const dependencies = [];
+    const errors = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        try {
+            dependencies.push(parseDependency(line));
+        }
+        catch (err) {
+            errors.push({
+                line: i + 1,
+                message: err instanceof Error ? err.message : 'Unknown error',
+                content: line.substring(0, 100),
+            });
+        }
+    }
+    return { dependencies, errors };
+}
+// ============================================================================
+// Ordering
+// ============================================================================
+/**
+ * Sort elements for export ordering
+ *
+ * Order by:
+ * 1. Type (entities first for references)
+ * 2. Creation time
+ * 3. ID (for stability)
+ *
+ * @param elements - Elements to sort
+ * @returns Sorted elements (new array)
+ */
+export function sortElementsForExport(elements) {
+    return [...elements].sort((a, b) => {
+        // First by type priority
+        const typeDiff = getTypePriority(a.type) - getTypePriority(b.type);
+        if (typeDiff !== 0)
+            return typeDiff;
+        // Then by creation time
+        const timeDiff = a.createdAt.localeCompare(b.createdAt);
+        if (timeDiff !== 0)
+            return timeDiff;
+        // Finally by ID for stability
+        return a.id.localeCompare(b.id);
+    });
+}
+/**
+ * Sort dependencies for export ordering
+ *
+ * Order by:
+ * 1. Creation time
+ * 2. Blocked ID
+ * 3. Blocker ID
+ * 4. Type (for stability)
+ *
+ * @param dependencies - Dependencies to sort
+ * @returns Sorted dependencies (new array)
+ */
+export function sortDependenciesForExport(dependencies) {
+    return [...dependencies].sort((a, b) => {
+        // First by creation time
+        const timeDiff = a.createdAt.localeCompare(b.createdAt);
+        if (timeDiff !== 0)
+            return timeDiff;
+        // Then by blocked ID
+        const blockedDiff = a.blockedId.localeCompare(b.blockedId);
+        if (blockedDiff !== 0)
+            return blockedDiff;
+        // Then by blocker ID
+        const blockerDiff = a.blockerId.localeCompare(b.blockerId);
+        if (blockerDiff !== 0)
+            return blockerDiff;
+        // Finally by type for stability
+        return a.type.localeCompare(b.type);
+    });
+}
+// ============================================================================
+// Validation Helpers
+// ============================================================================
+/**
+ * Check if an object looks like a serialized element
+ * (less strict than isElement, for initial parsing)
+ */
+export function isSerializedElement(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const obj = value;
+    // Check required fields exist
+    return (typeof obj.id === 'string' &&
+        typeof obj.type === 'string' &&
+        typeof obj.createdAt === 'string' &&
+        typeof obj.updatedAt === 'string' &&
+        typeof obj.createdBy === 'string' &&
+        Array.isArray(obj.tags) &&
+        typeof obj.metadata === 'object' &&
+        obj.metadata !== null);
+}
+/**
+ * Check if an object looks like a serialized dependency
+ */
+export function isSerializedDependency(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const obj = value;
+    // Check required fields exist
+    return (typeof obj.blockedId === 'string' &&
+        typeof obj.blockerId === 'string' &&
+        typeof obj.type === 'string' &&
+        typeof obj.createdAt === 'string' &&
+        typeof obj.createdBy === 'string');
+}
+//# sourceMappingURL=serialization.js.map

package/dist/sync/serialization.js.map

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

package/dist/sync/service.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Sync Service - Full export and import implementation
+ *
+ * Implements the sync operations specified in api/sync.md:
+ * - Full and incremental export to JSONL
+ * - Import with merge strategy
+ * - Conflict resolution
+ */
+import type { StorageBackend } from '@stoneforge/storage';
+import type { ExportResult, ImportResult as SyncImportResult, ExportOptions as SyncExportOptions, ImportOptions as SyncImportOptions } from './types.js';
+/**
+ * Service for handling JSONL export and import operations
+ */
+export declare class SyncService {
+    private backend;
+    constructor(backend: StorageBackend);
+    /**
+     * Export elements to JSONL format
+     *
+     * @param options - Export configuration
+     * @returns Export result with file paths and counts
+     */
+    export(options: SyncExportOptions): Promise<ExportResult>;
+    /**
+     * Export synchronously (useful for CLI and testing)
+     */
+    exportSync(options: SyncExportOptions): ExportResult;
+    /**
+     * Export to string (for API and in-memory use)
+     */
+    exportToString(options?: {
+        includeEphemeral?: boolean;
+        includeDependencies?: boolean;
+    }): {
+        elements: string;
+        dependencies?: string;
+    };
+    /**
+     * Import elements from JSONL files
+     *
+     * @param options - Import configuration
+     * @returns Import result with counts and conflicts
+     */
+    import(options: SyncImportOptions): Promise<SyncImportResult>;
+    /**
+     * Import synchronously
+     */
+    importSync(options: SyncImportOptions): SyncImportResult;
+    /**
+     * Import from JSONL strings (for API and in-memory use)
+     */
+    importFromStrings(elementsContent: string, dependenciesContent: string, options?: Partial<SyncImportOptions>): SyncImportResult;
+    /**
+     * Get all elements from storage
+     */
+    private getAllElements;
+    /**
+     * Filter out tasks that are children of ephemeral workflows
+     */
+    private filterOutEphemeralTasks;
+    /**
+     * Get dirty elements data (for incremental export)
+     */
+    private getDirtyElementsData;
+    /**
+     * Get all dependencies from storage
+     */
+    private getAllDependencies;
+    /**
+     * Get a single element by ID
+     */
+    private getElement;
+    /**
+     * Convert database row to Element
+     */
+    private rowToElement;
+    /**
+     * Serialize elements to JSONL, skipping any that fail validation.
+     */
+    private serializeElementsSafe;
+    /**
+     * Insert an element into storage (within transaction)
+     */
+    private insertElement;
+    /**
+     * Update an element in storage (within transaction)
+     */
+    private updateElement;
+    /**
+     * Insert a dependency into storage (within transaction)
+     */
+    private insertDependency;
+    /**
+     * Delete a dependency from storage (within transaction)
+     */
+    private deleteDependency;
+}
+/**
+ * Create a new SyncService instance
+ */
+export declare function createSyncService(backend: StorageBackend): SyncService;
+//# sourceMappingURL=service.d.ts.map

package/dist/sync/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/sync/service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,IAAI,gBAAgB,EAChC,aAAa,IAAI,iBAAiB,EAClC,aAAa,IAAI,iBAAiB,EAInC,MAAM,YAAY,CAAC;AA+CpB;;GAEG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAM3C;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAsD/D;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,YAAY;IAsDpD;;OAEG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG;QACvF,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;IAsBD;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqBnE;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB;IAqBxD;;OAEG;IACH,iBAAiB,CACf,eAAe,EAAE,MAAM,EACvB,mBAAmB,EAAE,MAAM,EAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,gBAAgB;IAmInB;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA8B/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiB5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,aAAa;IA2BrB;;OAEG;IACH,OAAO,CAAC,aAAa;IA2BrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAYzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,WAAW,CAEtE"}