@orkestrel/database 0.0.9 → 0.0.11

package/dist/src/core/index.d.cts

@@ -866,6 +866,28 @@ export declare type KeyFunction = () => Key;
  */
 export declare function matchesCondition(row: Row, condition: Condition): boolean;
 
+/**
+ * Match a query against a value as a case-insensitive ordered subsequence.
+ *
+ * @remarks
+ * Every query character must appear in order in the value, but the characters
+ * do not need to be contiguous. Query characters are literal, including
+ * whitespace. Matching applies JavaScript `toLowerCase()` to both inputs
+ * without locale-specific folding or Unicode normalization. An empty query
+ * matches every value.
+ *
+ * @param value - The text searched for the query's characters
+ * @param query - The characters that must all appear in order
+ * @returns Whether the case-folded query is a subsequence of the case-folded value
+ *
+ * @example
+ * ```ts
+ * matchesFuzzy('Database', 'dbe') // true
+ * matchesFuzzy('Database', 'abd') // false
+ * ```
+ */
+export declare function matchesFuzzy(value: string, query: string): boolean;
+
 export declare function matchesGlobPattern(value: string, pattern: string): boolean;
 
 export declare function matchesLikePattern(value: string, pattern: string): boolean;

package/dist/src/core/index.d.ts

@@ -866,6 +866,28 @@ export declare type KeyFunction = () => Key;
  */
 export declare function matchesCondition(row: Row, condition: Condition): boolean;
 
+/**
+ * Match a query against a value as a case-insensitive ordered subsequence.
+ *
+ * @remarks
+ * Every query character must appear in order in the value, but the characters
+ * do not need to be contiguous. Query characters are literal, including
+ * whitespace. Matching applies JavaScript `toLowerCase()` to both inputs
+ * without locale-specific folding or Unicode normalization. An empty query
+ * matches every value.
+ *
+ * @param value - The text searched for the query's characters
+ * @param query - The characters that must all appear in order
+ * @returns Whether the case-folded query is a subsequence of the case-folded value
+ *
+ * @example
+ * ```ts
+ * matchesFuzzy('Database', 'dbe') // true
+ * matchesFuzzy('Database', 'abd') // false
+ * ```
+ */
+export declare function matchesFuzzy(value: string, query: string): boolean;
+
 export declare function matchesGlobPattern(value: string, pattern: string): boolean;
 
 export declare function matchesLikePattern(value: string, pattern: string): boolean;

package/dist/src/core/index.js

@@ -384,6 +384,37 @@ function equalsValue(left, right) {
 	}
 }
 /**
+* Match a query against a value as a case-insensitive ordered subsequence.
+*
+* @remarks
+* Every query character must appear in order in the value, but the characters
+* do not need to be contiguous. Query characters are literal, including
+* whitespace. Matching applies JavaScript `toLowerCase()` to both inputs
+* without locale-specific folding or Unicode normalization. An empty query
+* matches every value.
+*
+* @param value - The text searched for the query's characters
+* @param query - The characters that must all appear in order
+* @returns Whether the case-folded query is a subsequence of the case-folded value
+*
+* @example
+* ```ts
+* matchesFuzzy('Database', 'dbe') // true
+* matchesFuzzy('Database', 'abd') // false
+* ```
+*/
+function matchesFuzzy(value, query) {
+	const folded = value.toLowerCase();
+	const wanted = query.toLowerCase();
+	let cursor = 0;
+	for (const char of wanted) {
+		const found = folded.indexOf(char, cursor);
+		if (found === -1) return false;
+		cursor = found + 1;
+	}
+	return true;
+}
+/**
 * Match a value against a wildcard pattern in LINEAR time — the shared, ReDoS-SAFE
 * engine behind {@link matchesLikePattern} and {@link matchesGlobPattern}.
 *
@@ -3020,23 +3051,25 @@ var Table = class {
 	#prepare(row) {
 		if (!isRecord(row)) throw new DatabaseError("VALIDATION", `Row for table '${this.#name}' is not a record`, { table: this.#name });
 		const prepared = { ...row };
-		if (prepared[this.#key] === void 0) if (this.#generate !== void 0) try {
-			prepared[this.#key] = this.#generate();
-		} catch (cause) {
-			throw new DatabaseError("VALIDATION", `Failed to generate primary column '${this.#key}' for table '${this.#name}'`, {
-				table: this.#name,
-				column: this.#key,
-				cause
-			});
-		}
-		else try {
-			prepared[this.#key] = crypto.randomUUID();
-		} catch (cause) {
-			throw new DatabaseError("DRIVER", `Host failed to generate primary column '${this.#key}' for table '${this.#name}'`, {
-				table: this.#name,
-				column: this.#key,
-				cause
-			});
+		if (prepared[this.#key] === void 0) {
+			if (this.#generate !== void 0) try {
+				prepared[this.#key] = this.#generate();
+			} catch (cause) {
+				throw new DatabaseError("VALIDATION", `Failed to generate primary column '${this.#key}' for table '${this.#name}'`, {
+					table: this.#name,
+					column: this.#key,
+					cause
+				});
+			}
+			else try {
+				prepared[this.#key] = crypto.randomUUID();
+			} catch (cause) {
+				throw new DatabaseError("DRIVER", `Host failed to generate primary column '${this.#key}' for table '${this.#name}'`, {
+					table: this.#name,
+					column: this.#key,
+					cause
+				});
+			}
 		}
 		return prepared;
 	}
@@ -3591,6 +3624,6 @@ function createMemoryDriver() {
 	return new MemoryDriver();
 }
 //#endregion
-export { DEFAULT_PRIMARY, Database, DatabaseError, MAX_PATTERN_LENGTH, MemoryDriver, applyQuery, auditDriver, bindRowKey, checkAbort, cloneDriverMetadata, cloneDriverSchema, cloneMigrationInput, compareValues, computeAggregate, conformDriver, createDatabase, createMemoryDriver, driverFindings, equalsValue, extractKey, filterRows, isColumnSchema, isDatabaseError, isDriverMetadata, isDriverSchema, isKey, isMigration, isMigrationInput, isMigrationStep, isTableSchema, matchesCondition, matchesGlobPattern, matchesLikePattern, matchesQuery, matchesWildcardPattern, migrateRows, normalizeDriverSchema, planMigration, projectMigrationSchema, shapeToColumnSchema, shapeToColumnStorage, sortRows, validatePage };
+export { DEFAULT_PRIMARY, Database, DatabaseError, MAX_PATTERN_LENGTH, MemoryDriver, applyQuery, auditDriver, bindRowKey, checkAbort, cloneDriverMetadata, cloneDriverSchema, cloneMigrationInput, compareValues, computeAggregate, conformDriver, createDatabase, createMemoryDriver, driverFindings, equalsValue, extractKey, filterRows, isColumnSchema, isDatabaseError, isDriverMetadata, isDriverSchema, isKey, isMigration, isMigrationInput, isMigrationStep, isTableSchema, matchesCondition, matchesFuzzy, matchesGlobPattern, matchesLikePattern, matchesQuery, matchesWildcardPattern, migrateRows, normalizeDriverSchema, planMigration, projectMigrationSchema, shapeToColumnSchema, shapeToColumnStorage, sortRows, validatePage };
 
 //# sourceMappingURL=index.js.map