@proseql/core 0.1.0

package/dist/types/crud-types.d.ts

@@ -0,0 +1,343 @@
+/**
+ * Core type definitions for CRUD operations with full type safety
+ */
+import type { Effect } from "effect";
+import type { TransactionError } from "../errors/crud-errors.js";
+import type { SmartCollection } from "./types.js";
+/**
+ * Base requirements for all entities in the database
+ */
+export interface BaseEntity {
+    id: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+/**
+ * Minimal entity type with just id field
+ */
+export interface MinimalEntity {
+    id: string;
+}
+/**
+ * Input type for create operations
+ * - ID is optional (will be auto-generated if not provided)
+ * - Timestamps are excluded (will be auto-generated)
+ */
+export type CreateInput<T> = Omit<T, "id" | "createdAt" | "updatedAt"> & {
+    id?: string;
+};
+/**
+ * Options for batch create operations
+ */
+export type CreateManyOptions = {
+    skipDuplicates?: boolean;
+    validateRelationships?: boolean;
+};
+/**
+ * Input type for update operations
+ * - ID and createdAt are immutable
+ * - All other fields are optional
+ */
+export type UpdateInput<T> = Partial<Omit<T, "id" | "createdAt">> & {
+    updatedAt?: string;
+};
+/**
+ * Type-safe update operators for different field types
+ */
+export type UpdateOperatorValue<T> = T extends number ? {
+    $increment?: number;
+    $decrement?: number;
+    $multiply?: number;
+    $set?: T;
+} : T extends string ? {
+    $set?: T;
+    $append?: string;
+    $prepend?: string;
+} : T extends unknown[] ? {
+    $append?: T extends (infer U)[] ? U | U[] : never;
+    $prepend?: T extends (infer U)[] ? U | U[] : never;
+    $remove?: T extends (infer U)[] ? U | ((item: U) => boolean) : never;
+    $set?: T;
+} : T extends boolean ? {
+    $set?: T;
+    $toggle?: boolean;
+} : {
+    $set?: T;
+};
+/**
+ * Primitive types that should not be treated as "nestable" objects for updates
+ */
+type UpdatePrimitive = string | number | boolean | bigint | symbol | undefined | null;
+/**
+ * Field update value that supports nested object deep merge.
+ * When T is an object type (not primitive, array, Date, etc.), this allows either:
+ * - Direct value T (replace entirely)
+ * - Standard update operators (UpdateOperatorValue<T>)
+ * - Nested object with update values on T's own fields (deep merge)
+ *
+ * The nested form is limited to 2 levels to avoid infinite recursion.
+ */
+type FieldUpdateValue<T> = T extends UpdatePrimitive ? T | UpdateOperatorValue<T> : T extends readonly unknown[] ? T | UpdateOperatorValue<T> : T extends Date ? T | UpdateOperatorValue<T> : T extends (...args: unknown[]) => unknown ? T | UpdateOperatorValue<T> : T extends object ? T | UpdateOperatorValue<T> | NestedFieldUpdateValue<T> : T | UpdateOperatorValue<T>;
+/**
+ * Nested field update value for second level (no further recursion).
+ * Allows specifying partial update values on the nested object's fields.
+ */
+type NestedFieldUpdateValue<T> = {
+    [K in keyof T]?: T[K] | UpdateOperatorValue<T[K]>;
+};
+/**
+ * Update input with support for operators and nested object deep merge.
+ *
+ * For nested objects, this allows:
+ * - `{ metadata: { views: 500 } }` - deep merge, preserves sibling fields
+ * - `{ metadata: { views: { $increment: 1 } } }` - operator at nested level
+ * - `{ metadata: { $set: { views: 0 } } }` - replace entire nested object
+ */
+export type UpdateWithOperators<T> = {
+    [K in keyof UpdateInput<T>]?: FieldUpdateValue<K extends keyof T ? T[K] : never>;
+};
+/**
+ * Options for delete operations
+ * - Soft delete is only available if entity has deletedAt field
+ */
+export type DeleteOptions<T> = T extends {
+    deletedAt?: string | null | undefined;
+} ? {
+    soft?: boolean;
+    returnDeleted?: boolean;
+} : {
+    returnDeleted?: boolean;
+};
+/**
+ * Options for batch delete operations
+ */
+export type DeleteManyOptions<T> = DeleteOptions<T> & {
+    limit?: number;
+};
+/**
+ * Input for upsert operations
+ * - Where clause must use unique fields
+ * - Create and update can have different shapes
+ */
+export type UpsertInput<T, UniqueFields extends keyof T = never> = {
+    where: [UniqueFields] extends [never] ? {
+        id: string;
+    } : Pick<T, UniqueFields> | {
+        id: string;
+    };
+    create: CreateInput<T>;
+    update: UpdateWithOperators<T>;
+};
+/**
+ * Internal input type for upsert operations.
+ * Allows any where clause since validation is done at runtime.
+ * Use this for internal implementation; UpsertInput provides compile-time safety.
+ */
+export type UpsertInternalInput<T> = {
+    where: Partial<T> | {
+        id: string;
+    };
+    create: CreateInput<T>;
+    update: UpdateWithOperators<T>;
+};
+/**
+ * Result type for upsert operations
+ * Includes metadata about whether entity was created or updated
+ */
+export type UpsertResult<T> = T & {
+    __action: "created" | "updated";
+};
+/**
+ * Result for batch operations that can partially fail
+ */
+export type BatchResult<T, E = never> = {
+    success: T[];
+    failed: Array<{
+        data: Partial<T>;
+        error: E;
+        index: number;
+    }>;
+    skipped?: Array<{
+        data: Partial<T>;
+        reason: string;
+        index: number;
+    }>;
+};
+/**
+ * Result for createMany operations
+ */
+export type CreateManyResult<T> = {
+    created: T[];
+    skipped?: Array<{
+        data: Partial<T>;
+        reason: string;
+    }>;
+};
+/**
+ * Result for updateMany operations
+ */
+export type UpdateManyResult<T> = {
+    count: number;
+    updated: T[];
+};
+/**
+ * Result for deleteMany operations
+ */
+export type DeleteManyResult<T> = {
+    count: number;
+    deleted: T[];
+};
+/**
+ * Result for upsertMany operations
+ */
+export type UpsertManyResult<T> = {
+    created: T[];
+    updated: T[];
+    unchanged: T[];
+};
+/**
+ * Result of validation operations
+ */
+export type ValidationResult<_T = unknown> = {
+    valid: boolean;
+    errors: Array<{
+        field: string;
+        message: string;
+        value?: unknown;
+        code?: string;
+    }>;
+    warnings?: Array<{
+        field: string;
+        message: string;
+    }>;
+};
+/**
+ * Foreign key validation configuration
+ */
+export type ForeignKeyValidation = {
+    field: string;
+    foreignKey: string;
+    targetCollection: string;
+    optional?: boolean;
+};
+/**
+ * Transaction context for multi-operation atomicity.
+ * Provides collection accessors, lifecycle methods, and introspection.
+ */
+export type TransactionContext<DB = Record<string, SmartCollection<unknown>>> = {
+    /** Finalize changes, trigger persistence for mutated collections, mark inactive */
+    readonly commit: () => Effect.Effect<void, TransactionError>;
+    /** Restore all snapshots, mark inactive, trigger no persistence. Always fails to short-circuit. */
+    readonly rollback: () => Effect.Effect<never, TransactionError>;
+    /** Whether the transaction is still open */
+    readonly isActive: boolean;
+    /** Which collections have been written to during the transaction */
+    readonly mutatedCollections: ReadonlySet<string>;
+} & {
+    /** Collection accessors — same interface as db.collectionName */
+    readonly [K in keyof DB]: DB[K];
+};
+/**
+ * Helper to make specific fields optional
+ */
+export type PartialBy<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * Helper to make specific fields required
+ */
+export type RequiredBy<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+/**
+ * Deep partial type that handles nested objects
+ */
+export type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+/**
+ * Extract the entity type from a collection
+ */
+export type ExtractEntity<T> = T extends {
+    query: () => AsyncIterable<infer E>;
+} ? E : never;
+/**
+ * Check if a type has a specific field
+ */
+export type HasField<T, K extends string> = K extends keyof T ? true : false;
+/**
+ * Type guard for checking if value is an update operator
+ */
+export declare function isUpdateOperator(value: unknown): value is Record<string, unknown>;
+/**
+ * Type guard for checking if entity has soft delete capability
+ */
+export declare function hasSoftDelete<T extends MinimalEntity>(entity: T): entity is T & {
+    deletedAt?: string;
+};
+/**
+ * Helper to create delete options for soft-deletable entities
+ */
+export declare function softDelete(returnDeleted?: boolean): SoftDeleteOptions;
+/**
+ * Helper to create delete options for hard delete
+ */
+export declare function hardDelete(returnDeleted?: boolean): HardDeleteOptions;
+/**
+ * Helper to create deleteMany options for soft-deletable entities
+ */
+export declare function softDeleteMany(options?: {
+    returnDeleted?: boolean;
+    limit?: number;
+}): SoftDeleteManyOptions;
+/**
+ * Helper to create deleteMany options for hard delete
+ */
+export declare function hardDeleteMany(options?: {
+    returnDeleted?: boolean;
+    limit?: number;
+}): HardDeleteManyOptions;
+/**
+ * Constraint for entities that support soft delete
+ */
+export type SoftDeletable = {
+    deletedAt?: string;
+};
+/**
+ * Check if a type is soft deletable at the type level
+ */
+export type IsSoftDeletable<T> = T extends SoftDeletable ? true : false;
+/**
+ * Extract entities that support soft delete
+ */
+export type ExtractSoftDeletable<T> = T extends SoftDeletable ? T : never;
+/**
+ * Extract entities that don't support soft delete
+ */
+export type ExtractNonSoftDeletable<T> = T extends SoftDeletable ? never : T;
+/**
+ * Explicit delete options for soft-deletable entities
+ */
+export type SoftDeleteOptions = {
+    soft?: boolean;
+    returnDeleted?: boolean;
+};
+/**
+ * Explicit delete options for non-soft-deletable entities
+ */
+export type HardDeleteOptions = {
+    returnDeleted?: boolean;
+};
+/**
+ * Explicit delete many options for soft-deletable entities
+ */
+export type SoftDeleteManyOptions = {
+    soft?: boolean;
+    returnDeleted?: boolean;
+    limit?: number;
+};
+/**
+ * Explicit delete many options for non-soft-deletable entities
+ */
+export type HardDeleteManyOptions = {
+    returnDeleted?: boolean;
+    limit?: number;
+};
+export {};
+//# sourceMappingURL=crud-types.d.ts.map

package/dist/types/crud-types.d.ts.map

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

package/dist/types/crud-types.js

@@ -0,0 +1,43 @@
+/**
+ * Core type definitions for CRUD operations with full type safety
+ */
+/**
+ * Type guard for checking if value is an update operator
+ */
+export function isUpdateOperator(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const keys = Object.keys(value);
+    return keys.some((key) => key.startsWith("$"));
+}
+/**
+ * Type guard for checking if entity has soft delete capability
+ */
+export function hasSoftDelete(entity) {
+    return "deletedAt" in entity;
+}
+/**
+ * Helper to create delete options for soft-deletable entities
+ */
+export function softDelete(returnDeleted = false) {
+    return { soft: true, returnDeleted };
+}
+/**
+ * Helper to create delete options for hard delete
+ */
+export function hardDelete(returnDeleted = false) {
+    return { returnDeleted };
+}
+/**
+ * Helper to create deleteMany options for soft-deletable entities
+ */
+export function softDeleteMany(options = {}) {
+    return { soft: true, ...options };
+}
+/**
+ * Helper to create deleteMany options for hard delete
+ */
+export function hardDeleteMany(options = {}) {
+    return options;
+}
+//# sourceMappingURL=crud-types.js.map

package/dist/types/crud-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud-types.js","sourceRoot":"","sources":["../../src/types/crud-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwWH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC/B,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC5B,MAAS;IAET,OAAO,WAAW,IAAI,MAAM,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,gBAAyB,KAAK;IACxD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,gBAAyB,KAAK;IACxD,OAAO,EAAE,aAAa,EAAE,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC7B,UAAuD,EAAE;IAEzD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC7B,UAAuD,EAAE;IAEzD,OAAO,OAAO,CAAC;AAChB,CAAC"}

package/dist/types/cursor-types.d.ts

@@ -0,0 +1,52 @@
+import type { Effect } from "effect";
+/**
+ * Configuration for cursor-based pagination.
+ *
+ * Cursor pagination anchors page boundaries to a specific record's sort key
+ * value rather than a numeric position, eliminating duplicates/skips when
+ * data changes between page fetches.
+ */
+export interface CursorConfig {
+    /** The field used as the cursor (sort key), e.g. "createdAt", "id" */
+    readonly key: string;
+    /** Fetch items after this cursor value (forward pagination) */
+    readonly after?: string;
+    /** Fetch items before this cursor value (backward pagination) */
+    readonly before?: string;
+    /** Maximum items per page (required, no default) */
+    readonly limit: number;
+}
+/**
+ * Metadata about page boundaries for cursor pagination.
+ */
+export interface CursorPageInfo {
+    /** Cursor of the first item in the page (null if empty) */
+    readonly startCursor: string | null;
+    /** Cursor of the last item in the page (null if empty) */
+    readonly endCursor: string | null;
+    /** Whether more items exist after this page */
+    readonly hasNextPage: boolean;
+    /** Whether more items exist before this page */
+    readonly hasPreviousPage: boolean;
+}
+/**
+ * Result of a cursor-paginated query.
+ *
+ * Contains the page items and metadata about page boundaries.
+ */
+export interface CursorPageResult<T> {
+    /** The items in this page */
+    readonly items: ReadonlyArray<T>;
+    /** Page boundary metadata */
+    readonly pageInfo: CursorPageInfo;
+}
+/**
+ * An Effect returning a CursorPageResult with a lazy `.runPromise` getter
+ * for non-Effect consumers.
+ *
+ * Accessing `.runPromise` runs the effect and returns a Promise.
+ */
+export type RunnableCursorPage<T, E> = Effect.Effect<CursorPageResult<T>, E, never> & {
+    readonly runPromise: Promise<CursorPageResult<T>>;
+};
+//# sourceMappingURL=cursor-types.d.ts.map

package/dist/types/cursor-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-types.d.ts","sourceRoot":"","sources":["../../src/types/cursor-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAMrC;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IAClC,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACjC,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,CACnD,gBAAgB,CAAC,CAAC,CAAC,EACnB,CAAC,EACD,KAAK,CACL,GAAG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;CAClD,CAAC"}

package/dist/types/cursor-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cursor-types.js.map

package/dist/types/cursor-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-types.js","sourceRoot":"","sources":["../../src/types/cursor-types.ts"],"names":[],"mappings":""}

package/dist/types/database-config-types.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Enhanced database configuration types that support persistence options.
+ * Extends the existing configuration to include optional file paths for collections.
+ */
+import type { Schema } from "effect";
+import type { Migration } from "../migrations/migration-types.js";
+import type { ComputedFieldsConfig } from "./computed-types.js";
+import type { HooksConfig } from "./hook-types.js";
+/**
+ * Configuration for a single collection, now with optional persistence support.
+ */
+export type CollectionConfig = {
+    /**
+     * Effect Schema for validating and encoding/decoding entities in this collection
+     */
+    readonly schema: Schema.Schema.All;
+    /**
+     * Optional file path for persisting this collection.
+     * If not provided, the collection will be in-memory only.
+     * Multiple collections can share the same file path.
+     */
+    readonly file?: string;
+    /**
+     * Relationship definitions for this collection
+     */
+    readonly relationships: Record<string, {
+        readonly type: "ref" | "inverse";
+        readonly target: string;
+        readonly foreignKey?: string;
+    }>;
+    /**
+     * Index definitions for this collection.
+     * Each entry can be a single field name (string) or an array of field names (compound index).
+     * Indexes accelerate equality queries on the specified fields.
+     */
+    readonly indexes?: ReadonlyArray<string | ReadonlyArray<string>>;
+    /**
+     * Lifecycle hooks for this collection.
+     * Hooks intercept CRUD operations for transformation, validation, or side effects.
+     * Before-hooks can transform data or reject operations.
+     * After-hooks and onChange run fire-and-forget after mutation.
+     */
+    readonly hooks?: HooksConfig<unknown>;
+    /**
+     * Schema version for this collection.
+     * When defined, the collection participates in schema migrations.
+     * The version number is stored in the persisted file as `_version`.
+     */
+    readonly version?: number;
+    /**
+     * Migration chain for this collection.
+     * Each migration transforms data from one version to the next.
+     * The chain must be contiguous: migrations[i].to === migrations[i].from + 1
+     * and the last migration's `to` must match the config `version`.
+     */
+    readonly migrations?: ReadonlyArray<Migration>;
+    /**
+     * Unique field constraints for this collection.
+     * Each entry can be a single field name (string) or an array of field names (compound unique constraint).
+     * Single strings are normalized to single-element arrays internally.
+     * Example: ["email", ["userId", "settingKey"]] means:
+     *   - "email" must be unique across all entities
+     *   - The combination of "userId" + "settingKey" must be unique
+     */
+    readonly uniqueFields?: ReadonlyArray<string | ReadonlyArray<string>>;
+    /**
+     * Computed field definitions for this collection.
+     * Computed fields are derived at query time from stored entity data.
+     * They are never persisted to disk - only materialized in the query pipeline.
+     *
+     * Each entry maps a field name to a derivation function.
+     * The function receives the entity (with populated relationships if applicable) and returns the computed value.
+     *
+     * @example
+     * ```ts
+     * computed: {
+     *   displayName: (book) => `${book.title} (${book.year})`,
+     *   isClassic: (book) => book.year < 1980,
+     * }
+     * ```
+     */
+    readonly computed?: ComputedFieldsConfig<unknown>;
+    /**
+     * Fields to include in the full-text search index for this collection.
+     * When specified, an inverted index is built and maintained for fast text search.
+     * Each entry should be the name of a string-typed field on the entity.
+     *
+     * Queries using `$search` will leverage this index when available for the queried fields.
+     * If not specified, `$search` queries will scan all entities (slower but still functional).
+     *
+     * @example
+     * ```ts
+     * searchIndex: ["title", "author", "description"]
+     * ```
+     */
+    readonly searchIndex?: ReadonlyArray<string>;
+    /**
+     * Name of an ID generator provided by a plugin.
+     * When specified and no `id` is provided during entity creation,
+     * the named generator is used to produce the ID.
+     *
+     * The generator must be registered by a plugin in the database options.
+     * At init time, validation ensures the named generator exists in the plugin registry.
+     *
+     * @example
+     * ```ts
+     * idGenerator: "snowflake"  // uses generator from a plugin
+     * ```
+     */
+    readonly idGenerator?: string;
+    /**
+     * When true, the collection uses an append-only persistence strategy.
+     * Each `create()` appends a single JSONL line to the file instead of rewriting it.
+     *
+     * Restrictions when append-only:
+     * - `update()`, `updateMany()`, `delete()`, `deleteMany()` fail with OperationError
+     * - The file should use a `.jsonl` extension
+     * - `flush()` writes a clean canonical JSONL file
+     *
+     * Useful for event logs and audit trails where data is only ever inserted.
+     *
+     * @example
+     * ```ts
+     * events: {
+     *   schema: EventSchema,
+     *   file: "./data/events.jsonl",
+     *   appendOnly: true,
+     *   relationships: {},
+     * }
+     * ```
+     */
+    readonly appendOnly?: boolean;
+};
+/**
+ * Complete database configuration type that preserves literal types
+ */
+export type DatabaseConfig = Record<string, CollectionConfig>;
+/**
+ * Reactive query configuration options for the database.
+ * Controls behavior of watch() and watchById() subscriptions.
+ */
+export interface ReactiveConfig {
+    /**
+     * Debounce interval in milliseconds for change event processing.
+     * When multiple mutations occur in rapid succession, they are coalesced
+     * into a single re-evaluation after the debounce interval settles.
+     * Default: 10ms (fast enough for interactive use, long enough to batch bursts).
+     */
+    readonly debounceMs?: number;
+}
+/**
+ * Database-level options that include reactive query configuration.
+ * Used by database factory functions to configure database-wide behavior.
+ */
+export interface DatabaseReactiveOptions {
+    /**
+     * Reactive query configuration.
+     * Controls debouncing and other behavior of watch() and watchById() methods.
+     */
+    readonly reactive?: ReactiveConfig;
+}
+/**
+ * Type guard to check if a collection configuration includes persistence
+ */
+export declare function isCollectionPersistent(config: CollectionConfig): config is CollectionConfig & {
+    file: string;
+};
+/**
+ * Extract only the persistent collections from a database configuration
+ */
+export type PersistentCollections<Config extends DatabaseConfig> = {
+    readonly [K in keyof Config]: Config[K] extends {
+        file: string;
+    } ? Config[K] : never;
+};
+/**
+ * Extract only the in-memory collections from a database configuration
+ */
+export type InMemoryCollections<Config extends DatabaseConfig> = {
+    readonly [K in keyof Config]: Config[K] extends {
+        file?: undefined;
+    } ? Config[K] : never;
+};
+/**
+ * Helper type to extract file paths from a database configuration
+ */
+export type ExtractFilePaths<Config extends DatabaseConfig> = {
+    readonly [K in keyof Config]: Config[K] extends {
+        file: infer F;
+    } ? F : never;
+}[keyof Config];
+/**
+ * Type for mapping file paths to the collections that use them
+ */
+export type FileToCollectionsMap<Config extends DatabaseConfig> = Map<ExtractFilePaths<Config> & string, Array<keyof Config & string>>;
+//# sourceMappingURL=database-config-types.d.ts.map

package/dist/types/database-config-types.d.ts.map

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

package/dist/types/database-config-types.js

@@ -0,0 +1,11 @@
+/**
+ * Enhanced database configuration types that support persistence options.
+ * Extends the existing configuration to include optional file paths for collections.
+ */
+/**
+ * Type guard to check if a collection configuration includes persistence
+ */
+export function isCollectionPersistent(config) {
+    return typeof config.file === "string" && config.file.length > 0;
+}
+//# sourceMappingURL=database-config-types.js.map