@stoneforge/quarry 0.1.0

package/dist/config/validation.js

@@ -0,0 +1,251 @@
+/**
+ * Configuration Validation
+ *
+ * Validates configuration values for correctness and consistency.
+ */
+import { ValidationError, ErrorCode } from '@stoneforge/core';
+import { isValidIdentityMode } from '../systems/identity.js';
+import { MIN_EXPORT_DEBOUNCE, MAX_EXPORT_DEBOUNCE, MIN_TIME_TOLERANCE, MAX_TIME_TOLERANCE, MAX_TTL, } from './defaults.js';
+import { validateDurationRange, formatDuration } from './duration.js';
+// ============================================================================
+// Field Validators
+// ============================================================================
+/**
+ * Validates an actor name
+ */
+export function isValidActor(value) {
+    if (typeof value !== 'string') {
+        return false;
+    }
+    // Actor must be non-empty and contain only valid identifier characters
+    return value.length > 0 && /^[a-zA-Z0-9_-]+$/.test(value);
+}
+/**
+ * Validates actor and throws if invalid
+ */
+export function validateActor(value) {
+    if (typeof value !== 'string') {
+        throw new ValidationError('Actor must be a string', ErrorCode.INVALID_INPUT, { field: 'actor', value, expected: 'string' });
+    }
+    if (value.length === 0) {
+        throw new ValidationError('Actor cannot be empty', ErrorCode.INVALID_INPUT, { field: 'actor', value });
+    }
+    if (!/^[a-zA-Z0-9_-]+$/.test(value)) {
+        throw new ValidationError('Actor must contain only alphanumeric characters, hyphens, and underscores', ErrorCode.INVALID_INPUT, { field: 'actor', value, expected: 'alphanumeric, hyphen, underscore' });
+    }
+    return value;
+}
+/**
+ * Validates a database filename
+ */
+export function isValidDatabase(value) {
+    if (typeof value !== 'string') {
+        return false;
+    }
+    // Must be non-empty, end with .db, and not contain path separators
+    return (value.length > 0 &&
+        value.endsWith('.db') &&
+        !value.includes('/') &&
+        !value.includes('\\'));
+}
+/**
+ * Validates database and throws if invalid
+ */
+export function validateDatabase(value) {
+    if (typeof value !== 'string') {
+        throw new ValidationError('Database must be a string', ErrorCode.INVALID_INPUT, { field: 'database', value, expected: 'string' });
+    }
+    if (value.length === 0) {
+        throw new ValidationError('Database cannot be empty', ErrorCode.INVALID_INPUT, { field: 'database', value });
+    }
+    if (!value.endsWith('.db')) {
+        throw new ValidationError('Database must end with .db extension', ErrorCode.INVALID_INPUT, { field: 'database', value, expected: '*.db' });
+    }
+    if (value.includes('/') || value.includes('\\')) {
+        throw new ValidationError('Database must be a filename, not a path', ErrorCode.INVALID_INPUT, { field: 'database', value });
+    }
+    return value;
+}
+/**
+ * Validates a JSONL filename
+ */
+export function isValidJsonlFilename(value) {
+    if (typeof value !== 'string') {
+        return false;
+    }
+    return (value.length > 0 &&
+        value.endsWith('.jsonl') &&
+        !value.includes('/') &&
+        !value.includes('\\'));
+}
+/**
+ * Validates JSONL filename and throws if invalid
+ */
+export function validateJsonlFilename(value, field) {
+    if (typeof value !== 'string') {
+        throw new ValidationError(`${field} must be a string`, ErrorCode.INVALID_INPUT, { field, value, expected: 'string' });
+    }
+    if (value.length === 0) {
+        throw new ValidationError(`${field} cannot be empty`, ErrorCode.INVALID_INPUT, { field, value });
+    }
+    if (!value.endsWith('.jsonl')) {
+        throw new ValidationError(`${field} must end with .jsonl extension`, ErrorCode.INVALID_INPUT, { field, value, expected: '*.jsonl' });
+    }
+    if (value.includes('/') || value.includes('\\')) {
+        throw new ValidationError(`${field} must be a filename, not a path`, ErrorCode.INVALID_INPUT, { field, value });
+    }
+    return value;
+}
+/**
+ * Validates playbook paths array
+ */
+export function isValidPlaybookPaths(value) {
+    if (!Array.isArray(value)) {
+        return false;
+    }
+    return value.every((p) => typeof p === 'string' && p.length > 0);
+}
+/**
+ * Validates playbook paths and throws if invalid
+ */
+export function validatePlaybookPaths(value) {
+    if (!Array.isArray(value)) {
+        throw new ValidationError('Playbook paths must be an array', ErrorCode.INVALID_INPUT, { field: 'playbooks.paths', value, expected: 'array of strings' });
+    }
+    for (let i = 0; i < value.length; i++) {
+        if (typeof value[i] !== 'string') {
+            throw new ValidationError(`Playbook path at index ${i} must be a string`, ErrorCode.INVALID_INPUT, { field: `playbooks.paths[${i}]`, value: value[i], expected: 'string' });
+        }
+        if (value[i].length === 0) {
+            throw new ValidationError(`Playbook path at index ${i} cannot be empty`, ErrorCode.INVALID_INPUT, { field: `playbooks.paths[${i}]`, value: value[i] });
+        }
+    }
+    return value;
+}
+// ============================================================================
+// Full Configuration Validation
+// ============================================================================
+/**
+ * Validates a complete configuration object
+ *
+ * @param config - Configuration to validate
+ * @returns Validated configuration
+ * @throws ValidationError if validation fails
+ */
+export function validateConfiguration(config) {
+    if (typeof config !== 'object' || config === null) {
+        throw new ValidationError('Configuration must be an object', ErrorCode.INVALID_INPUT, { value: config });
+    }
+    const obj = config;
+    // Validate actor (optional)
+    if (obj.actor !== undefined) {
+        validateActor(obj.actor);
+    }
+    // Validate database
+    if (typeof obj.database !== 'string') {
+        throw new ValidationError('Configuration must include database', ErrorCode.MISSING_REQUIRED_FIELD, { field: 'database' });
+    }
+    validateDatabase(obj.database);
+    // Validate sync
+    if (typeof obj.sync !== 'object' || obj.sync === null) {
+        throw new ValidationError('Configuration must include sync object', ErrorCode.MISSING_REQUIRED_FIELD, { field: 'sync' });
+    }
+    const sync = obj.sync;
+    if (typeof sync.autoExport !== 'boolean') {
+        throw new ValidationError('sync.autoExport must be a boolean', ErrorCode.INVALID_INPUT, { field: 'sync.autoExport', value: sync.autoExport, expected: 'boolean' });
+    }
+    if (typeof sync.exportDebounce !== 'number') {
+        throw new ValidationError('sync.exportDebounce must be a number', ErrorCode.INVALID_INPUT, { field: 'sync.exportDebounce', value: sync.exportDebounce, expected: 'number' });
+    }
+    validateDurationRange(sync.exportDebounce, MIN_EXPORT_DEBOUNCE, MAX_EXPORT_DEBOUNCE, 'sync.exportDebounce');
+    validateJsonlFilename(sync.elementsFile, 'sync.elementsFile');
+    validateJsonlFilename(sync.dependenciesFile, 'sync.dependenciesFile');
+    // Validate playbooks
+    if (typeof obj.playbooks !== 'object' || obj.playbooks === null) {
+        throw new ValidationError('Configuration must include playbooks object', ErrorCode.MISSING_REQUIRED_FIELD, { field: 'playbooks' });
+    }
+    const playbooks = obj.playbooks;
+    validatePlaybookPaths(playbooks.paths);
+    // Validate tombstone
+    if (typeof obj.tombstone !== 'object' || obj.tombstone === null) {
+        throw new ValidationError('Configuration must include tombstone object', ErrorCode.MISSING_REQUIRED_FIELD, { field: 'tombstone' });
+    }
+    const tombstone = obj.tombstone;
+    if (typeof tombstone.ttl !== 'number') {
+        throw new ValidationError('tombstone.ttl must be a number', ErrorCode.INVALID_INPUT, { field: 'tombstone.ttl', value: tombstone.ttl, expected: 'number' });
+    }
+    if (typeof tombstone.minTtl !== 'number') {
+        throw new ValidationError('tombstone.minTtl must be a number', ErrorCode.INVALID_INPUT, { field: 'tombstone.minTtl', value: tombstone.minTtl, expected: 'number' });
+    }
+    validateDurationRange(tombstone.ttl, tombstone.minTtl, MAX_TTL, 'tombstone.ttl');
+    validateDurationRange(tombstone.minTtl, 1, tombstone.ttl, 'tombstone.minTtl');
+    // Validate identity
+    if (typeof obj.identity !== 'object' || obj.identity === null) {
+        throw new ValidationError('Configuration must include identity object', ErrorCode.MISSING_REQUIRED_FIELD, { field: 'identity' });
+    }
+    const identity = obj.identity;
+    if (!isValidIdentityMode(identity.mode)) {
+        throw new ValidationError('identity.mode must be a valid identity mode', ErrorCode.INVALID_INPUT, { field: 'identity.mode', value: identity.mode, expected: ['soft', 'cryptographic', 'hybrid'] });
+    }
+    if (typeof identity.timeTolerance !== 'number') {
+        throw new ValidationError('identity.timeTolerance must be a number', ErrorCode.INVALID_INPUT, { field: 'identity.timeTolerance', value: identity.timeTolerance, expected: 'number' });
+    }
+    validateDurationRange(identity.timeTolerance, MIN_TIME_TOLERANCE, MAX_TIME_TOLERANCE, 'identity.timeTolerance');
+    return config;
+}
+/**
+ * Validates a configuration without throwing, returns result
+ */
+export function validateConfigurationSafe(config) {
+    const errors = [];
+    const warnings = [];
+    try {
+        validateConfiguration(config);
+        return { valid: true, errors, warnings };
+    }
+    catch (err) {
+        if (err instanceof ValidationError) {
+            errors.push(err.message);
+        }
+        else {
+            errors.push(String(err));
+        }
+        return { valid: false, errors, warnings };
+    }
+}
+/**
+ * Validates partial configuration for merging
+ */
+export function validatePartialConfiguration(config) {
+    if (config.actor !== undefined) {
+        validateActor(config.actor);
+    }
+    if (config.database !== undefined) {
+        validateDatabase(config.database);
+    }
+    if (config.sync?.exportDebounce !== undefined) {
+        validateDurationRange(config.sync.exportDebounce, MIN_EXPORT_DEBOUNCE, MAX_EXPORT_DEBOUNCE, 'sync.exportDebounce');
+    }
+    if (config.sync?.elementsFile !== undefined) {
+        validateJsonlFilename(config.sync.elementsFile, 'sync.elementsFile');
+    }
+    if (config.sync?.dependenciesFile !== undefined) {
+        validateJsonlFilename(config.sync.dependenciesFile, 'sync.dependenciesFile');
+    }
+    if (config.playbooks?.paths !== undefined) {
+        validatePlaybookPaths(config.playbooks.paths);
+    }
+    if (config.identity?.mode !== undefined && !isValidIdentityMode(config.identity.mode)) {
+        throw new ValidationError('identity.mode must be a valid identity mode', ErrorCode.INVALID_INPUT, { field: 'identity.mode', value: config.identity.mode, expected: ['soft', 'cryptographic', 'hybrid'] });
+    }
+    if (config.identity?.timeTolerance !== undefined) {
+        validateDurationRange(config.identity.timeTolerance, MIN_TIME_TOLERANCE, MAX_TIME_TOLERANCE, 'identity.timeTolerance');
+    }
+    // Cross-field validation for tombstone
+    if (config.tombstone?.ttl !== undefined && config.tombstone?.minTtl !== undefined) {
+        if (config.tombstone.ttl < config.tombstone.minTtl) {
+            throw new ValidationError(`tombstone.ttl (${formatDuration(config.tombstone.ttl)}) must be >= tombstone.minTtl (${formatDuration(config.tombstone.minTtl)})`, ErrorCode.INVALID_INPUT, { field: 'tombstone.ttl', value: config.tombstone.ttl, expected: `>= ${config.tombstone.minTtl}` });
+        }
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/config/validation.js.map

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

package/dist/http/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * HTTP Module - HTTP handlers for browser sync
+ *
+ * Provides framework-agnostic HTTP handlers that can be integrated
+ * with any HTTP server (Bun.serve, Express, Hono, etc.)
+ */
+export { SyncHttpHandlers, createSyncHttpHandlers, type SyncPullRequest, type SyncPullResponse, type SyncPushRequest, type SyncPushResponse, type SyncExchangeRequest, type SyncExchangeResponse, type HttpResponse, getHttpStatus, parseRequestBody, serializeResponse, SYNC_CONTENT_TYPES, } from './sync-handlers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,gBAAgB,EAChB,sBAAsB,EAEtB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EAEjB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

package/dist/http/index.js

@@ -0,0 +1,12 @@
+/**
+ * HTTP Module - HTTP handlers for browser sync
+ *
+ * Provides framework-agnostic HTTP handlers that can be integrated
+ * with any HTTP server (Bun.serve, Express, Hono, etc.)
+ */
+export { 
+// Handler class
+SyncHttpHandlers, createSyncHttpHandlers, 
+// Helpers
+getHttpStatus, parseRequestBody, serializeResponse, SYNC_CONTENT_TYPES, } from './sync-handlers.js';
+//# sourceMappingURL=index.js.map

package/dist/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO;AACL,gBAAgB;AAChB,gBAAgB,EAChB,sBAAsB;AAStB,UAAU;AACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

package/dist/http/sync-handlers.d.ts

@@ -0,0 +1,162 @@
+/**
+ * HTTP Sync Handlers - Browser sync support via HTTP endpoints
+ *
+ * Provides framework-agnostic handlers for browser sync operations.
+ * These can be integrated with any HTTP framework (Bun.serve, Express, Hono, etc.)
+ *
+ * Implements the browser sync protocol from api/sync.md:
+ * 1. Browser exports local changes
+ * 2. HTTP POST to server with JSONL
+ * 3. Server merges with its state
+ * 4. Server exports current state
+ * 5. HTTP response with JSONL
+ * 6. Browser imports and merges
+ */
+import type { StorageBackend } from '@stoneforge/storage';
+import type { ImportResult, SyncStatus } from '../sync/types.js';
+/**
+ * Request body for browser sync pull (export from server)
+ */
+export interface SyncPullRequest {
+    /** Include ephemeral elements in export */
+    includeEphemeral?: boolean;
+    /** Include dependencies in export */
+    includeDependencies?: boolean;
+}
+/**
+ * Response for browser sync pull
+ */
+export interface SyncPullResponse {
+    /** JSONL string of elements */
+    elements: string;
+    /** JSONL string of dependencies (if requested) */
+    dependencies?: string;
+    /** Element count */
+    elementCount: number;
+    /** Dependency count (if included) */
+    dependencyCount?: number;
+    /** Export timestamp */
+    exportedAt: string;
+}
+/**
+ * Request body for browser sync push (import to server)
+ */
+export interface SyncPushRequest {
+    /** JSONL string of elements to import */
+    elements: string;
+    /** JSONL string of dependencies to import */
+    dependencies?: string;
+    /** Dry run - validate without applying changes */
+    dryRun?: boolean;
+    /** Force - remote always wins conflicts */
+    force?: boolean;
+}
+/**
+ * Response for browser sync push
+ */
+export interface SyncPushResponse {
+    /** Import result with counts and conflicts */
+    result: ImportResult;
+    /** Server's current state after merge (for client to sync) */
+    serverState?: SyncPullResponse;
+}
+/**
+ * Request/Response for full bidirectional sync
+ */
+export interface SyncExchangeRequest {
+    /** Client's elements to import */
+    elements: string;
+    /** Client's dependencies to import */
+    dependencies?: string;
+    /** Force - remote always wins conflicts */
+    force?: boolean;
+}
+export interface SyncExchangeResponse {
+    /** Import result from processing client data */
+    importResult: ImportResult;
+    /** Server's current state (for client to import) */
+    serverElements: string;
+    /** Server's dependencies (for client to import) */
+    serverDependencies: string;
+    /** Counts for client reference */
+    serverElementCount: number;
+    serverDependencyCount: number;
+    /** Sync timestamp */
+    syncedAt: string;
+}
+/**
+ * HTTP response envelope
+ */
+export interface HttpResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+}
+/**
+ * HTTP handlers for browser sync operations
+ */
+export declare class SyncHttpHandlers {
+    private backend;
+    private syncService;
+    constructor(backend: StorageBackend);
+    /**
+     * Handle GET /api/sync/status
+     *
+     * Returns current sync status including dirty element count
+     */
+    getStatus(): HttpResponse<SyncStatus>;
+    /**
+     * Handle GET /api/sync/pull or POST /api/sync/pull
+     *
+     * Exports server state as JSONL for client to import
+     */
+    pull(request?: SyncPullRequest): HttpResponse<SyncPullResponse>;
+    /**
+     * Handle POST /api/sync/push
+     *
+     * Imports client JSONL data to server
+     */
+    push(request: SyncPushRequest): HttpResponse<SyncPushResponse>;
+    /**
+     * Handle POST /api/sync/exchange
+     *
+     * Bidirectional sync in a single request:
+     * 1. Import client data
+     * 2. Export server state
+     * 3. Return both results
+     */
+    exchange(request: SyncExchangeRequest): HttpResponse<SyncExchangeResponse>;
+    /**
+     * Handle errors and return appropriate HTTP response
+     */
+    private handleError;
+}
+/**
+ * Create sync HTTP handlers for a storage backend
+ */
+export declare function createSyncHttpHandlers(backend: StorageBackend): SyncHttpHandlers;
+/**
+ * Map response to HTTP status code
+ */
+export declare function getHttpStatus(response: HttpResponse<unknown>): number;
+/**
+ * Supported content types for sync endpoints
+ */
+export declare const SYNC_CONTENT_TYPES: {
+    readonly JSON: "application/json";
+    readonly JSONL: "application/jsonl";
+    readonly NDJSON: "application/x-ndjson";
+};
+/**
+ * Parse request body based on content type
+ */
+export declare function parseRequestBody<T>(body: string, _contentType?: string): T;
+/**
+ * Serialize response based on accept header
+ */
+export declare function serializeResponse<T>(response: HttpResponse<T>): string;
+//# sourceMappingURL=sync-handlers.d.ts.map

package/dist/http/sync-handlers.d.ts.map

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