@jambudipa/spider 0.1.0

package/dist/lib/Resumability/Resumability.service.d.ts

@@ -0,0 +1,176 @@
+import { Effect } from 'effect';
+import { SpiderState, SpiderStateKey } from '../Scheduler/SpiderScheduler.service.js';
+import { HybridPersistenceConfig, PersistenceError, StateDelta, StateOperation, StorageBackend } from './types.js';
+/**
+ * Configuration for the ResumabilityService.
+ *
+ * Allows choosing between different persistence strategies and
+ * configuring their behavior based on use case requirements.
+ *
+ * @group Configuration
+ * @public
+ */
+export interface ResumabilityConfig {
+    /** Persistence strategy to use */
+    strategy: 'full-state' | 'delta' | 'hybrid' | 'auto';
+    /** Storage backend implementation */
+    backend: StorageBackend;
+    /** Configuration for hybrid strategy (only used when strategy is 'hybrid') */
+    hybridConfig?: HybridPersistenceConfig;
+}
+declare const ResumabilityService_base: Effect.Service.Class<ResumabilityService, "@jambudipa.io/ResumabilityService", {
+    readonly effect: Effect.Effect<{
+        /**
+         * Configure the resumability service with a specific strategy and backend.
+         *
+         * This method initializes the storage backend and creates the appropriate
+         * persistence strategy based on the configuration.
+         *
+         * @param config - Resumability configuration
+         * @returns Effect that completes when configuration is applied
+         */
+        configure: (config: ResumabilityConfig) => Effect.Effect<void, PersistenceError, never>;
+        /**
+         * Persist a state operation using the configured strategy.
+         *
+         * @param operation - State operation to persist
+         * @returns Effect that completes when operation is persisted
+         */
+        persistOperation: (operation: StateOperation) => Effect.Effect<undefined, PersistenceError, never>;
+        /**
+         * Restore spider state from persistent storage.
+         *
+         * @param key - State key identifying the session to restore
+         * @returns Effect containing the restored state, or null if not found
+         */
+        restore: (key: SpiderStateKey) => Effect.Effect<SpiderState | null, PersistenceError, never>;
+        /**
+         * Clean up old state data for a session.
+         *
+         * @param key - State key identifying the session to clean up
+         * @returns Effect that completes when cleanup is finished
+         */
+        cleanup: (key: SpiderStateKey) => Effect.Effect<undefined, PersistenceError, never>;
+        /**
+         * List all available sessions in storage.
+         *
+         * @returns Effect containing array of session keys
+         */
+        listSessions: () => Effect.Effect<SpiderStateKey[], PersistenceError, never>;
+        /**
+         * Get information about the current configuration.
+         *
+         * @returns Information about strategy and backend
+         */
+        getInfo: () => Effect.Effect<{
+            strategy: {
+                readonly name: string;
+                readonly description: string;
+                readonly capabilities: string[];
+            };
+            backend: {
+                name: string;
+                capabilities: import("./types.js").StorageCapabilities;
+            };
+        }, PersistenceError, never>;
+        /**
+         * Reconfigure the service with new settings.
+         *
+         * This will clean up the current backend and reinitialize with new config.
+         *
+         * @param config - New configuration
+         * @returns Effect that completes when reconfiguration is finished
+         */
+        reconfigure: (config: ResumabilityConfig) => Effect.Effect<void, PersistenceError, never>;
+    }, never, never>;
+}>;
+/**
+ * Service for resumable spider crawling with configurable persistence strategies.
+ *
+ * Provides a unified interface for different persistence approaches:
+ * - Full state: Simple, saves complete state on every change
+ * - Delta: Efficient, saves only incremental changes
+ * - Hybrid: Best of both worlds, deltas + periodic snapshots
+ * - Auto: Automatically chooses best strategy based on backend capabilities
+ *
+ * @example
+ * ```typescript
+ * // File-based full state persistence
+ * const resumabilityLayer = ResumabilityService.fromConfig({
+ *   strategy: 'full-state',
+ *   backend: new FileStorageBackend('./spider-state')
+ * });
+ *
+ * // Redis-based hybrid persistence
+ * const resumabilityLayer = ResumabilityService.fromConfig({
+ *   strategy: 'hybrid',
+ *   backend: new RedisStorageBackend(redisClient),
+ *   hybridConfig: {
+ *     snapshotInterval: 1000,
+ *     maxDeltasBeforeSnapshot: 500
+ *   }
+ * });
+ *
+ * // Auto-selected strategy based on backend
+ * const resumabilityLayer = ResumabilityService.fromConfig({
+ *   strategy: 'auto',
+ *   backend: new PostgresStorageBackend(pgClient)
+ * });
+ * ```
+ *
+ * @group Services
+ * @public
+ */
+export declare class ResumabilityService extends ResumabilityService_base {
+    /**
+     * Create a ResumabilityService layer from configuration.
+     *
+     * This is the primary way to create and configure the ResumabilityService.
+     *
+     * @param config - Resumability configuration
+     * @returns Effect layer providing the configured ResumabilityService
+     */
+    static fromConfig: (config: ResumabilityConfig) => Effect.Effect<ResumabilityService, PersistenceError, never>;
+}
+/**
+ * Utility function to create a state operation.
+ *
+ * @param delta - The delta operation
+ * @param resultingState - The complete state after applying the delta
+ * @param shouldSnapshot - Whether this operation should trigger a snapshot
+ * @returns StateOperation object
+ */
+export declare const createStateOperation: (delta: StateDelta, resultingState: SpiderState, shouldSnapshot?: boolean) => StateOperation;
+/**
+ * Factory functions for creating common resumability configurations.
+ */
+export declare const ResumabilityConfigs: {
+    /**
+     * Create a file-based configuration.
+     *
+     * @param baseDir - Directory to store state files
+     * @param strategy - Persistence strategy (defaults to 'auto')
+     * @returns ResumabilityConfig
+     */
+    file: (baseDir: string, strategy?: "full-state" | "delta" | "hybrid" | "auto") => ResumabilityConfig;
+    /**
+     * Create a Redis-based configuration.
+     *
+     * @param redisClient - Redis client instance
+     * @param strategy - Persistence strategy (defaults to 'hybrid')
+     * @param keyPrefix - Redis key prefix (defaults to 'spider')
+     * @returns ResumabilityConfig
+     */
+    redis: (redisClient: import("./backends/RedisStorageBackend.js").RedisClientInterface, strategy?: "full-state" | "delta" | "hybrid" | "auto", keyPrefix?: string) => ResumabilityConfig;
+    /**
+     * Create a PostgreSQL-based configuration.
+     *
+     * @param dbClient - Database client instance
+     * @param strategy - Persistence strategy (defaults to 'hybrid')
+     * @param config - PostgreSQL configuration
+     * @returns ResumabilityConfig
+     */
+    postgres: (dbClient: import("./backends/PostgresStorageBackend.js").DatabaseClientInterface, strategy?: "full-state" | "delta" | "hybrid" | "auto", config?: import("./backends/PostgresStorageBackend.js").PostgresStorageConfig) => ResumabilityConfig;
+};
+export {};
+//# sourceMappingURL=Resumability.service.d.ts.map

package/dist/lib/Resumability/Resumability.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Resumability.service.d.ts","sourceRoot":"","sources":["../../../src/lib/Resumability/Resumability.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EACL,WAAW,EACX,cAAc,EACf,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAEL,uBAAuB,EACvB,gBAAgB,EAEhB,UAAU,EACV,cAAc,EACd,cAAc,EACf,MAAM,YAAY,CAAC;AAOpB;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,QAAQ,EAAE,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrD,qCAAqC;IACrC,OAAO,EAAE,cAAc,CAAC;IACxB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,uBAAuB,CAAC;CACxC;;;QAgDO;;;;;;;;WAQG;4BACiB,kBAAkB;QAWtC;;;;;WAKG;sCAC2B,cAAc;QAe5C;;;;;WAKG;uBACY,cAAc;QAe7B;;;;;WAKG;uBACY,cAAc;QAe7B;;;;WAIG;;QAyBH;;;;WAIG;;;;;;;;;;;;QAsBH;;;;;;;WAOG;8BACmB,kBAAkB;;;AAhMhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,mBAAoB,SAAQ,wBA0KxC;IACC;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,GAAI,QAAQ,kBAAkB,iEAKQ;CACxD;AAuDD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,UAAU,EACjB,gBAAgB,WAAW,EAC3B,wBAAsB,KACrB,cAID,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B;;;;;;OAMG;oBAEQ,MAAM,aACL,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,KACnD,kBAAkB;IAQrB;;;;;;;OAOG;yBAEY,OAAO,mCAAmC,EAAE,oBAAoB,aACnE,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,yBAEnD,kBAAkB;IASrB;;;;;;;OAOG;yBAES,OAAO,sCAAsC,EAAE,uBAAuB,aACtE,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,WAC3C,OAAO,sCAAsC,EAAE,qBAAqB,KAC5E,kBAAkB;CAQtB,CAAC"}

package/dist/lib/Resumability/backends/FileStorageBackend.d.ts

@@ -0,0 +1,47 @@
+import { Effect } from 'effect';
+import { PersistenceError, SpiderState, SpiderStateKey, StateDelta, StorageBackend, StorageCapabilities } from '../types.js';
+/**
+ * File system storage backend for spider state persistence.
+ *
+ * Stores state and deltas as JSON files in a directory structure.
+ * Good for development, testing, and single-machine deployments.
+ *
+ * Directory structure:
+ * ```
+ * baseDir/
+ *   sessions/
+ *     sessionId/
+ *       state.json        # Full state
+ *       snapshot.json     # Latest snapshot
+ *       deltas/
+ *         0001.json       # Delta files
+ *         0002.json
+ *         ...
+ * ```
+ *
+ * @group Backends
+ * @public
+ */
+export declare class FileStorageBackend implements StorageBackend {
+    private readonly baseDir;
+    readonly capabilities: StorageCapabilities;
+    readonly name = "FileStorageBackend";
+    constructor(baseDir: string);
+    initialize: () => Effect.Effect<void, PersistenceError>;
+    cleanup: () => Effect.Effect<void, PersistenceError>;
+    saveState: (key: SpiderStateKey, state: SpiderState) => Effect.Effect<void, PersistenceError, never>;
+    loadState: (key: SpiderStateKey) => Effect.Effect<SpiderState | null, PersistenceError, never>;
+    deleteState: (key: SpiderStateKey) => Effect.Effect<void, PersistenceError, never>;
+    saveDelta: (delta: StateDelta) => Effect.Effect<void, PersistenceError>;
+    saveDeltas: (deltas: StateDelta[]) => Effect.Effect<void, PersistenceError>;
+    loadDeltas: (key: SpiderStateKey, fromSequence?: number) => Effect.Effect<StateDelta[], PersistenceError>;
+    saveSnapshot: (key: SpiderStateKey, state: SpiderState, sequence: number) => Effect.Effect<void, PersistenceError>;
+    loadLatestSnapshot: (key: SpiderStateKey) => Effect.Effect<{
+        state: SpiderState;
+        sequence: number;
+    } | null, PersistenceError>;
+    compactDeltas: (key: SpiderStateKey, beforeSequence: number) => Effect.Effect<void, PersistenceError>;
+    listSessions: () => Effect.Effect<SpiderStateKey[], PersistenceError>;
+    private getSessionDir;
+}
+//# sourceMappingURL=FileStorageBackend.d.ts.map

package/dist/lib/Resumability/backends/FileStorageBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileStorageBackend.d.ts","sourceRoot":"","sources":["../../../../src/lib/Resumability/backends/FileStorageBackend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAGxC,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,UAAU,EACV,cAAc,EACd,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IAW3C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAVpC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAMxC;IAEF,QAAQ,CAAC,IAAI,wBAAwB;gBAER,OAAO,EAAE,MAAM;IAE5C,UAAU,QAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAuBpD;IAEF,OAAO,QAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CACvB;IAG5B,SAAS,GACP,KAAK,cAAc,EACnB,OAAO,WAAW,KACjB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC,CA2B7C;IAEF,SAAS,GACP,KAAK,cAAc,KAClB,MAAM,CAAC,MAAM,CAAC,WAAW,GAAG,IAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAyC3D;IAEF,WAAW,GACT,KAAK,cAAc,KAClB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAe7C;IAGF,SAAS,GAAI,OAAO,UAAU,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CA+BpE;IAEF,UAAU,GACR,QAAQ,UAAU,EAAE,KACnB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAQtC;IAEF,UAAU,GACR,KAAK,cAAc,EACnB,qBAAgB,KACf,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,gBAAgB,CAAC,CA+D9C;IAGF,YAAY,GACV,KAAK,cAAc,EACnB,OAAO,WAAW,EAClB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAmCtC;IAEF,kBAAkB,GAChB,KAAK,cAAc,KAClB,MAAM,CAAC,MAAM,CACd;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,EAC/C,gBAAgB,CACjB,CA4CC;IAGF,aAAa,GACX,KAAK,cAAc,EACnB,gBAAgB,MAAM,KACrB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CA6CtC;IAEF,YAAY,QAAO,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,gBAAgB,CAAC,CAmDlE;IAEF,OAAO,CAAC,aAAa,CAEnB;CACH"}

package/dist/lib/Resumability/backends/PostgresStorageBackend.d.ts

@@ -0,0 +1,95 @@
+import { Effect } from 'effect';
+import { SpiderState, SpiderStateKey } from '../../Scheduler/SpiderScheduler.service.js';
+import { PersistenceError, StateDelta, StorageBackend, StorageCapabilities } from '../types.js';
+/**
+ * Database client interface for dependency injection.
+ *
+ * This allows users to provide their own database client implementation
+ * (pg, node-postgres, prisma, drizzle, etc.) without tight coupling.
+ *
+ * @group Backends
+ * @public
+ */
+export interface DatabaseClientInterface {
+    query<T = unknown>(sql: string, params?: unknown[]): Promise<{
+        rows: T[];
+        rowCount: number;
+    }>;
+    transaction?<T>(callback: (client: DatabaseClientInterface) => Promise<T>): Promise<T>;
+}
+/**
+ * Configuration for PostgreSQL storage backend.
+ */
+export interface PostgresStorageConfig {
+    /** Table prefix for spider tables */
+    tablePrefix?: string;
+    /** Schema name (defaults to 'public') */
+    schema?: string;
+    /** Whether to auto-create tables */
+    autoCreateTables?: boolean;
+}
+/**
+ * PostgreSQL storage backend for spider state persistence.
+ *
+ * Uses PostgreSQL for robust, ACID-compliant state persistence with
+ * excellent support for concurrent access and complex queries.
+ *
+ * Database schema:
+ * ```sql
+ * CREATE TABLE spider_sessions (
+ *   id VARCHAR(255) PRIMARY KEY,
+ *   name VARCHAR(255) NOT NULL,
+ *   created_at TIMESTAMP NOT NULL,
+ *   state_data JSONB,
+ *   updated_at TIMESTAMP DEFAULT NOW()
+ * );
+ *
+ * CREATE TABLE spider_deltas (
+ *   id SERIAL PRIMARY KEY,
+ *   session_id VARCHAR(255) NOT NULL REFERENCES spider_sessions(id),
+ *   sequence_number BIGINT NOT NULL,
+ *   operation_type VARCHAR(50) NOT NULL,
+ *   operation_data JSONB NOT NULL,
+ *   created_at TIMESTAMP DEFAULT NOW(),
+ *   UNIQUE(session_id, sequence_number)
+ * );
+ *
+ * CREATE TABLE spider_snapshots (
+ *   id SERIAL PRIMARY KEY,
+ *   session_id VARCHAR(255) NOT NULL REFERENCES spider_sessions(id),
+ *   sequence_number BIGINT NOT NULL,
+ *   state_data JSONB NOT NULL,
+ *   created_at TIMESTAMP DEFAULT NOW()
+ * );
+ * ```
+ *
+ * @group Backends
+ * @public
+ */
+export declare class PostgresStorageBackend implements StorageBackend {
+    private readonly db;
+    readonly capabilities: StorageCapabilities;
+    readonly name = "PostgresStorageBackend";
+    private readonly tablePrefix;
+    private readonly schema;
+    private readonly autoCreateTables;
+    constructor(db: DatabaseClientInterface, config?: PostgresStorageConfig);
+    initialize: () => Effect.Effect<void, PersistenceError>;
+    cleanup: () => Effect.Effect<void, PersistenceError>;
+    saveState: (key: SpiderStateKey, state: SpiderState) => Effect.Effect<void, PersistenceError>;
+    loadState: (key: SpiderStateKey) => Effect.Effect<SpiderState | null, PersistenceError>;
+    deleteState: (key: SpiderStateKey) => Effect.Effect<void, PersistenceError>;
+    saveDelta: (delta: StateDelta) => Effect.Effect<void, PersistenceError>;
+    saveDeltas: (deltas: StateDelta[]) => Effect.Effect<void, PersistenceError>;
+    loadDeltas: (key: SpiderStateKey, fromSequence?: number) => Effect.Effect<StateDelta[], PersistenceError>;
+    saveSnapshot: (key: SpiderStateKey, state: SpiderState, sequence: number) => Effect.Effect<void, PersistenceError>;
+    loadLatestSnapshot: (key: SpiderStateKey) => Effect.Effect<{
+        state: SpiderState;
+        sequence: number;
+    } | null, PersistenceError>;
+    compactDeltas: (key: SpiderStateKey, beforeSequence: number) => Effect.Effect<void, PersistenceError>;
+    listSessions: () => Effect.Effect<SpiderStateKey[], PersistenceError>;
+    private createTables;
+    private getTableName;
+}
+//# sourceMappingURL=PostgresStorageBackend.d.ts.map

package/dist/lib/Resumability/backends/PostgresStorageBackend.d.ts.map

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

package/dist/lib/Resumability/backends/RedisStorageBackend.d.ts

@@ -0,0 +1,92 @@
+import { Effect } from 'effect';
+import { SpiderState, SpiderStateKey } from '../../Scheduler/SpiderScheduler.service.js';
+import { PersistenceError, StateDelta, StorageBackend, StorageCapabilities } from '../types.js';
+/**
+ * Redis client interface for dependency injection.
+ *
+ * This allows users to provide their own Redis client implementation
+ * (node_redis, ioredis, etc.) without tight coupling.
+ *
+ * @group Backends
+ * @public
+ */
+export interface RedisClientInterface {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    del(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    hget(key: string, field: string): Promise<string | null>;
+    hset(key: string, field: string, value: string): Promise<void>;
+    hdel(key: string, field: string): Promise<void>;
+    hgetall(key: string): Promise<Record<string, string>>;
+    zadd(key: string, score: number, member: string): Promise<void>;
+    zrange(key: string, start: number, stop: number): Promise<string[]>;
+    zrangebyscore(key: string, min: number | string, max: number | string): Promise<string[]>;
+    zrem(key: string, member: string): Promise<void>;
+    zremrangebyscore(key: string, min: number | string, max: number | string): Promise<void>;
+    keys(pattern: string): Promise<string[]>;
+    pipeline?(): RedisPipeline;
+    multi?(): RedisMulti;
+}
+/**
+ * Redis pipeline interface for batch operations.
+ */
+export interface RedisPipeline {
+    zadd(key: string, score: number, member: string): RedisPipeline;
+    exec(): Promise<any[]>;
+}
+/**
+ * Redis multi/transaction interface.
+ */
+export interface RedisMulti {
+    zadd(key: string, score: number, member: string): RedisMulti;
+    exec(): Promise<any[]>;
+}
+/**
+ * Redis storage backend for spider state persistence.
+ *
+ * Uses Redis data structures for efficient storage:
+ * - Hashes for full state and snapshots
+ * - Sorted sets for deltas (ordered by sequence number)
+ * - TTL support for automatic cleanup
+ *
+ * Redis key structure:
+ * ```
+ * spider:state:{sessionId}           # Hash: full state
+ * spider:snapshot:{sessionId}        # Hash: latest snapshot + sequence
+ * spider:deltas:{sessionId}          # Sorted set: sequence -> delta JSON
+ * spider:sessions                    # Set: all session IDs
+ * ```
+ *
+ * @group Backends
+ * @public
+ */
+export declare class RedisStorageBackend implements StorageBackend {
+    private readonly redis;
+    private readonly keyPrefix;
+    readonly capabilities: StorageCapabilities;
+    readonly name = "RedisStorageBackend";
+    constructor(redis: RedisClientInterface, keyPrefix?: string);
+    initialize: () => Effect.Effect<void, PersistenceError>;
+    cleanup: () => Effect.Effect<void, PersistenceError>;
+    saveState: (key: SpiderStateKey, state: SpiderState) => Effect.Effect<void, PersistenceError>;
+    loadState: (key: SpiderStateKey) => Effect.Effect<SpiderState | null, PersistenceError>;
+    deleteState: (key: SpiderStateKey) => Effect.Effect<void, PersistenceError>;
+    saveDelta: (delta: StateDelta) => Effect.Effect<void, PersistenceError>;
+    saveDeltas: (deltas: StateDelta[]) => Effect.Effect<void, PersistenceError>;
+    loadDeltas: (key: SpiderStateKey, fromSequence?: number) => Effect.Effect<StateDelta[], PersistenceError>;
+    saveSnapshot: (key: SpiderStateKey, state: SpiderState, sequence: number) => Effect.Effect<void, PersistenceError>;
+    loadLatestSnapshot: (key: SpiderStateKey) => Effect.Effect<{
+        state: SpiderState;
+        sequence: number;
+    } | null, PersistenceError>;
+    compactDeltas: (key: SpiderStateKey, beforeSequence: number) => Effect.Effect<void, PersistenceError>;
+    listSessions: () => Effect.Effect<SpiderStateKey[], PersistenceError>;
+    private getStateKey;
+    private getSnapshotKey;
+    private getDeltasKey;
+    private getSessionsKey;
+    private addToSessionsList;
+    private removeFromSessionsList;
+}
+//# sourceMappingURL=RedisStorageBackend.d.ts.map

package/dist/lib/Resumability/backends/RedisStorageBackend.d.ts.map

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

package/dist/lib/Resumability/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Resumable spider crawling with configurable persistence strategies.
+ *
+ * This module provides a complete solution for resumable web crawling with
+ * support for different persistence strategies and storage backends.
+ *
+ * ## Key Features
+ *
+ * - **Multiple Strategies**: Full state, delta, hybrid, and auto-selection
+ * - **Multiple Backends**: File system, Redis, PostgreSQL with extensible interface
+ * - **Effect.js Native**: Full integration with Effect.js ecosystem
+ * - **Type Safe**: Complete TypeScript support with runtime validation
+ * - **Production Ready**: Handles concurrency, errors, and edge cases
+ *
+ * ## Quick Start
+ *
+ * ```typescript
+ * import { ResumabilityService, ResumabilityConfigs } from '@jambudipa.io/spider/resumability';
+ *
+ * // File-based resumability
+ * const resumabilityLayer = ResumabilityService.fromConfig(
+ *   ResumabilityConfigs.file('./spider-state', 'hybrid')
+ * );
+ *
+ * // Use with Spider
+ * const program = Effect.gen(function* () {
+ *   const spider = yield* Spider;
+ *   const resumability = yield* ResumabilityService;
+ *
+ *   // Configure resumable crawling...
+ * });
+ *
+ * Effect.runPromise(
+ *   program.pipe(
+ *     Effect.provide(Spider.Default),
+ *     Effect.provide(resumabilityLayer)
+ *   )
+ * );
+ * ```
+ *
+ * @group Resumability
+ * @public
+ */
+export type { StorageBackend, StorageCapabilities, PersistenceStrategy, StateOperation, HybridPersistenceConfig, } from './types.js';
+export { StateDelta, PersistenceError, DEFAULT_HYBRID_CONFIG, } from './types.js';
+export { FullStatePersistence, DeltaPersistence, HybridPersistence, } from './strategies.js';
+export { FileStorageBackend } from './backends/FileStorageBackend.js';
+export { RedisStorageBackend, type RedisClientInterface, type RedisPipeline, type RedisMulti, } from './backends/RedisStorageBackend.js';
+export { PostgresStorageBackend, type DatabaseClientInterface, type PostgresStorageConfig, } from './backends/PostgresStorageBackend.js';
+export { ResumabilityService, ResumabilityConfigs, createStateOperation, type ResumabilityConfig, } from './Resumability.service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/Resumability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/Resumability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAGH,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,sBAAsB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC3B,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC"}

package/dist/lib/Resumability/strategies.d.ts

@@ -0,0 +1,76 @@
+import { Effect } from 'effect';
+import { SpiderState, SpiderStateKey } from '../Scheduler/SpiderScheduler.service.js';
+import { HybridPersistenceConfig, PersistenceError, PersistenceStrategy, StateOperation, StorageBackend } from './types.js';
+/**
+ * Full state persistence strategy.
+ *
+ * Saves the complete spider state on every operation. Simple and reliable,
+ * but can be inefficient for large crawls with many URLs.
+ *
+ * @group Strategies
+ * @public
+ */
+export declare class FullStatePersistence implements PersistenceStrategy {
+    private readonly backend;
+    constructor(backend: StorageBackend);
+    persist: (operation: StateOperation) => Effect.Effect<void, PersistenceError>;
+    restore: (key: SpiderStateKey) => Effect.Effect<SpiderState | null, PersistenceError>;
+    cleanup: (key: SpiderStateKey) => Effect.Effect<void, PersistenceError>;
+    getInfo: () => {
+        name: string;
+        description: string;
+        capabilities: string[];
+    };
+}
+/**
+ * Delta persistence strategy.
+ *
+ * Saves only incremental changes (deltas) instead of the full state.
+ * Much more efficient for large crawls, but requires delta replay for restoration.
+ *
+ * @group Strategies
+ * @public
+ */
+export declare class DeltaPersistence implements PersistenceStrategy {
+    private readonly backend;
+    constructor(backend: StorageBackend);
+    persist: (operation: StateOperation) => Effect.Effect<void, PersistenceError>;
+    restore: (key: SpiderStateKey) => Effect.Effect<SpiderState | null, PersistenceError>;
+    cleanup: (key: SpiderStateKey) => Effect.Effect<void, PersistenceError>;
+    reconstructStateFromDeltas: (key: SpiderStateKey, deltas: ReadonlyArray<import("./types.js").StateDelta>) => Effect.Effect<SpiderState, PersistenceError>;
+    getInfo: () => {
+        name: string;
+        description: string;
+        capabilities: string[];
+    };
+}
+/**
+ * Hybrid persistence strategy.
+ *
+ * Combines delta and full state approaches for optimal performance.
+ * Saves deltas for efficiency, with periodic snapshots for fast recovery.
+ *
+ * @group Strategies
+ * @public
+ */
+export declare class HybridPersistence implements PersistenceStrategy {
+    private readonly backend;
+    private readonly config;
+    private operationCount;
+    private lastSnapshotSequence;
+    private pendingDeltas;
+    constructor(backend: StorageBackend, config?: HybridPersistenceConfig);
+    persist: (operation: StateOperation) => Effect.Effect<void, PersistenceError>;
+    private saveSnapshot;
+    private saveDelta;
+    private flushPendingDeltas;
+    restore: (key: SpiderStateKey) => Effect.Effect<SpiderState | null, PersistenceError>;
+    private applyDeltasToState;
+    cleanup: (key: SpiderStateKey) => Effect.Effect<void, PersistenceError>;
+    getInfo: () => {
+        name: string;
+        description: string;
+        capabilities: string[];
+    };
+}
+//# sourceMappingURL=strategies.d.ts.map

package/dist/lib/Resumability/strategies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.d.ts","sourceRoot":"","sources":["../../../src/lib/Resumability/strategies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EACL,WAAW,EACX,cAAc,EACf,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAEL,uBAAuB,EACvB,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,YAAW,mBAAmB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD,OAAO,GACL,WAAW,cAAc,KACxB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAiBtC;IAEF,OAAO,GACL,KAAK,cAAc,KAClB,MAAM,CAAC,MAAM,CAAC,WAAW,GAAG,IAAI,EAAE,gBAAgB,CAAC,CAcpD;IAEF,OAAO,GAAI,KAAK,cAAc,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAcpE;IAEF,OAAO;;;;MAKJ;CACJ;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD,OAAO,GACL,WAAW,cAAc,KACxB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CActC;IAEF,OAAO,GACL,KAAK,cAAc,KAClB,MAAM,CAAC,MAAM,CAAC,WAAW,GAAG,IAAI,EAAE,gBAAgB,CAAC,CAoBpD;IAEF,OAAO,GAAI,KAAK,cAAc,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAmBpE;IAEF,0BAA0B,GACxB,KAAK,cAAc,EACnB,QAAQ,aAAa,CAAC,OAAO,YAAY,EAAE,UAAU,CAAC,KACrD,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC,CA+D1C;IAEL,OAAO;;;;MAKJ;CACJ;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAMzD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,aAAa,CAAyC;gBAG3C,OAAO,EAAE,cAAc,EACvB,MAAM,GAAE,uBAA+C;IAG1E,OAAO,GACL,WAAW,cAAc,KACxB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CA+BtC;IAEF,OAAO,CAAC,YAAY,CAkClB;IAEF,OAAO,CAAC,SAAS,CAmBf;IAEF,OAAO,CAAC,kBAAkB,CAwBxB;IAEF,OAAO,GACL,KAAK,cAAc,KAClB,MAAM,CAAC,MAAM,CAAC,WAAW,GAAG,IAAI,EAAE,gBAAgB,CAAC,CAyCpD;IAEF,OAAO,CAAC,kBAAkB,CAwExB;IAEF,OAAO,GAAI,KAAK,cAAc,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAepE;IAEF,OAAO;;;;MAWJ;CACJ"}