@drzl/validation-core 3.10.0 → 3.12.0

package/dist/index.cjs

@@ -84441,6 +84441,7 @@ ${codeblock}`, options7);
 var index_exports2 = {};
 __export(index_exports2, {
   AFFIX_PROBE_TABLE: () => AFFIX_PROBE_TABLE,
+  CODEPOINT_LENGTH: () => CODEPOINT_LENGTH,
   COLUMN_FORMATS: () => COLUMN_FORMATS,
   DEFAULT_IMPORT_EXTENSION: () => DEFAULT_IMPORT_EXTENSION,
   DEFAULT_MODE_PREFIX: () => DEFAULT_MODE_PREFIX,
@@ -84472,6 +84473,7 @@ module.exports = __toCommonJS(index_exports2);
 // src/checks.ts
 var COMPARISON = /^\s*([A-Za-z_][A-Za-z0-9_]*)\s*(>=|<=|<>|!=|>|<|=)\s*(.+?)\s*$/;
 var IN_LIST = /^\s*([A-Za-z_][A-Za-z0-9_]*)\s+IN\s*\((.+)\)\s*$/i;
+var LENGTH_OF = /^\s*(?:length|char_length)\s*\(\s*([A-Za-z_][A-Za-z0-9_]*)\s*\)\s*(>=|<=|<>|!=|>|<|=)\s*(\d+)\s*$/i;
 function splitTopLevelAnd(expr) {
   const parts = [];
   let depth = 0;
@@ -84592,6 +84594,7 @@ function parseCheck(expression, name) {
     const checks = [];
     const sets = [];
     const rows = [];
+    const lengths = [];
     for (const part of parts) {
       const parsed = parseCheck(part, name);
       if (!parsed.ok)
@@ -84599,12 +84602,23 @@ function parseCheck(expression, name) {
       checks.push(...parsed.checks);
       if (parsed.sets) sets.push(...parsed.sets);
       if (parsed.rows) rows.push(...parsed.rows);
+      if (parsed.lengths) lengths.push(...parsed.lengths);
     }
     return {
       ok: true,
       checks,
       ...sets.length ? { sets } : {},
-      ...rows.length ? { rows } : {}
+      ...rows.length ? { rows } : {},
+      ...lengths.length ? { lengths } : {}
+    };
+  }
+  const lengthOf = expr.match(LENGTH_OF);
+  if (lengthOf) {
+    const op4 = lengthOf[2] === "!=" ? "<>" : lengthOf[2];
+    return {
+      ok: true,
+      checks: [],
+      lengths: [{ column: lengthOf[1], operator: op4, value: lengthOf[3], name }]
     };
   }
   const inList = expr.match(IN_LIST);
@@ -84825,6 +84839,7 @@ var COLUMN_FORMATS = {
   // probes, `1_000` and `0xDEAD_beef` through to `1__0`, `_1`, `0x` and `1e+`.
   numeric: "^\\s*([+-]?(0[xX][0-9a-fA-F](_?[0-9a-fA-F])*|0[oO][0-7](_?[0-7])*|0[bB][01](_?[01])*)|[+-]?(\\d(_?\\d)*(\\.(\\d(_?\\d)*)?)?|\\.\\d(_?\\d)*)([eE][+-]?\\d(_?\\d)*)?|[+-]?(NaN|Infinity))\\s*$"
 };
+var CODEPOINT_LENGTH = "[...v].length";
 function isIntegerColumn(c5) {
   if (typeof c5.integer === "boolean") return c5.integer;
   return c5.dbType === "INTEGER" || c5.min !== void 0 && c5.max !== void 0;
@@ -84867,6 +84882,7 @@ async function formatCode(code, filePath, fmt) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AFFIX_PROBE_TABLE,
+  CODEPOINT_LENGTH,
   COLUMN_FORMATS,
   DEFAULT_IMPORT_EXTENSION,
   DEFAULT_MODE_PREFIX,

package/dist/index.d.cts

@@ -230,12 +230,27 @@ interface RowCheck {
     operator: ColumnCheck['operator'];
     name?: string;
 }
+/**
+ * A constraint on a column's *character* count, from `CHECK (length(name) > 3)`.
+ *
+ * Kept apart from `ColumnCheck` because it is not a comparison of the value: it compares a count
+ * derived from it, and the count Postgres takes is code points rather than UTF-16 units. See
+ * `CODEPOINT_LENGTH` for why that distinction is load bearing.
+ */
+interface LengthCheck {
+    column: string;
+    operator: ColumnCheck['operator'];
+    /** Decimal, as text, matching how the other bounds are carried. */
+    value: string;
+    name?: string;
+}
 /** A check that was understood, or the reason it was not. */
 type ParsedCheck = {
     ok: true;
     checks: ColumnCheck[];
     sets?: ColumnSet[];
     rows?: RowCheck[];
+    lengths?: LengthCheck[];
 } | {
     ok: false;
     reason: string;
@@ -405,10 +420,32 @@ declare function isGeneratedColumn(c: Column, _primaryKeyColumns?: string[]): bo
  *   cidr      parses as `inet` and then demands zero host bits, which no regex can state
  */
 declare const COLUMN_FORMATS: Record<string, string>;
+/**
+ * Why a character limit is not `.max(n)`.
+ *
+ * Postgres and MySQL count `varchar(n)` in **characters**; every JavaScript validator counts
+ * `.length`, which is UTF-16 code units. They agree until the text leaves the basic plane, and
+ * then they do not: `varchar(10)` accepts ten emoji, and `.max(10)` refuses eight of them.
+ *
+ * Verified against Postgres through PGlite, for `varchar(10)`:
+ *
+ *   3 emoji   db accepts   .max(10) accepts
+ *   8 emoji   db accepts   .max(10) REFUSES
+ *  10 emoji   db accepts   .max(10) REFUSES
+ *  11 emoji   db refuses   .max(10) refuses
+ *
+ * `[...v].length` counts code points, which is what the database counts, and matches on all four.
+ * Refusing a user's emoji is the failure mode this avoids, and it is the same rule applied
+ * everywhere else here: never reject what the database accepts.
+ *
+ * `@sinclair/typebox` and ArkType cannot express it. Both state a length declaratively with no
+ * predicate to hook, so they keep the UTF-16 form and are documented as approximate.
+ */
+declare const CODEPOINT_LENGTH = "[...v].length";
 declare function isIntegerColumn(c: Column): boolean;
 declare function insertColumns(table: Table): Column[];
 declare function updateColumns(table: Table): Column[];
 declare function selectColumns(table: Table): Column[];
 declare function formatCode(code: string, filePath: string, fmt?: FormatOptions): Promise<any>;
 
-export { AFFIX_PROBE_TABLE, type AffixIssue, type AffixOptions, type AffixValue, COLUMN_FORMATS, type ColumnCheck, type ColumnSet, DEFAULT_IMPORT_EXTENSION, DEFAULT_MODE_PREFIX, DEFAULT_SCHEMA_SUFFIX, DEFAULT_TYPE_SUFFIX, type FormatOptions, IMPORT_EXTENSIONS, type ImportExtension, NAME_MODES, type NameMode, type ParsedCheck, type ResolvedAffix, type RowCheck, type Table, type TableCase, type ValidationGenerateOptions, type ValidationLibrary, type ValidationRenderer, applyTableCase, describeSet, formatCode, importSpecifier, insertColumns, isGeneratedColumn, isIntegerColumn, moduleFileName, moduleSpecifier, parseCheck, pascalCase, resolveAffix, resolveConfiguredImport, schemaName, selectColumns, typeName, updateColumns, validateAffix };
+export { AFFIX_PROBE_TABLE, type AffixIssue, type AffixOptions, type AffixValue, CODEPOINT_LENGTH, COLUMN_FORMATS, type ColumnCheck, type ColumnSet, DEFAULT_IMPORT_EXTENSION, DEFAULT_MODE_PREFIX, DEFAULT_SCHEMA_SUFFIX, DEFAULT_TYPE_SUFFIX, type FormatOptions, IMPORT_EXTENSIONS, type ImportExtension, type LengthCheck, NAME_MODES, type NameMode, type ParsedCheck, type ResolvedAffix, type RowCheck, type Table, type TableCase, type ValidationGenerateOptions, type ValidationLibrary, type ValidationRenderer, applyTableCase, describeSet, formatCode, importSpecifier, insertColumns, isGeneratedColumn, isIntegerColumn, moduleFileName, moduleSpecifier, parseCheck, pascalCase, resolveAffix, resolveConfiguredImport, schemaName, selectColumns, typeName, updateColumns, validateAffix };

package/dist/index.d.ts

@@ -230,12 +230,27 @@ interface RowCheck {
     operator: ColumnCheck['operator'];
     name?: string;
 }
+/**
+ * A constraint on a column's *character* count, from `CHECK (length(name) > 3)`.
+ *
+ * Kept apart from `ColumnCheck` because it is not a comparison of the value: it compares a count
+ * derived from it, and the count Postgres takes is code points rather than UTF-16 units. See
+ * `CODEPOINT_LENGTH` for why that distinction is load bearing.
+ */
+interface LengthCheck {
+    column: string;
+    operator: ColumnCheck['operator'];
+    /** Decimal, as text, matching how the other bounds are carried. */
+    value: string;
+    name?: string;
+}
 /** A check that was understood, or the reason it was not. */
 type ParsedCheck = {
     ok: true;
     checks: ColumnCheck[];
     sets?: ColumnSet[];
     rows?: RowCheck[];
+    lengths?: LengthCheck[];
 } | {
     ok: false;
     reason: string;
@@ -405,10 +420,32 @@ declare function isGeneratedColumn(c: Column, _primaryKeyColumns?: string[]): bo
  *   cidr      parses as `inet` and then demands zero host bits, which no regex can state
  */
 declare const COLUMN_FORMATS: Record<string, string>;
+/**
+ * Why a character limit is not `.max(n)`.
+ *
+ * Postgres and MySQL count `varchar(n)` in **characters**; every JavaScript validator counts
+ * `.length`, which is UTF-16 code units. They agree until the text leaves the basic plane, and
+ * then they do not: `varchar(10)` accepts ten emoji, and `.max(10)` refuses eight of them.
+ *
+ * Verified against Postgres through PGlite, for `varchar(10)`:
+ *
+ *   3 emoji   db accepts   .max(10) accepts
+ *   8 emoji   db accepts   .max(10) REFUSES
+ *  10 emoji   db accepts   .max(10) REFUSES
+ *  11 emoji   db refuses   .max(10) refuses
+ *
+ * `[...v].length` counts code points, which is what the database counts, and matches on all four.
+ * Refusing a user's emoji is the failure mode this avoids, and it is the same rule applied
+ * everywhere else here: never reject what the database accepts.
+ *
+ * `@sinclair/typebox` and ArkType cannot express it. Both state a length declaratively with no
+ * predicate to hook, so they keep the UTF-16 form and are documented as approximate.
+ */
+declare const CODEPOINT_LENGTH = "[...v].length";
 declare function isIntegerColumn(c: Column): boolean;
 declare function insertColumns(table: Table): Column[];
 declare function updateColumns(table: Table): Column[];
 declare function selectColumns(table: Table): Column[];
 declare function formatCode(code: string, filePath: string, fmt?: FormatOptions): Promise<any>;
 
-export { AFFIX_PROBE_TABLE, type AffixIssue, type AffixOptions, type AffixValue, COLUMN_FORMATS, type ColumnCheck, type ColumnSet, DEFAULT_IMPORT_EXTENSION, DEFAULT_MODE_PREFIX, DEFAULT_SCHEMA_SUFFIX, DEFAULT_TYPE_SUFFIX, type FormatOptions, IMPORT_EXTENSIONS, type ImportExtension, NAME_MODES, type NameMode, type ParsedCheck, type ResolvedAffix, type RowCheck, type Table, type TableCase, type ValidationGenerateOptions, type ValidationLibrary, type ValidationRenderer, applyTableCase, describeSet, formatCode, importSpecifier, insertColumns, isGeneratedColumn, isIntegerColumn, moduleFileName, moduleSpecifier, parseCheck, pascalCase, resolveAffix, resolveConfiguredImport, schemaName, selectColumns, typeName, updateColumns, validateAffix };
+export { AFFIX_PROBE_TABLE, type AffixIssue, type AffixOptions, type AffixValue, CODEPOINT_LENGTH, COLUMN_FORMATS, type ColumnCheck, type ColumnSet, DEFAULT_IMPORT_EXTENSION, DEFAULT_MODE_PREFIX, DEFAULT_SCHEMA_SUFFIX, DEFAULT_TYPE_SUFFIX, type FormatOptions, IMPORT_EXTENSIONS, type ImportExtension, type LengthCheck, NAME_MODES, type NameMode, type ParsedCheck, type ResolvedAffix, type RowCheck, type Table, type TableCase, type ValidationGenerateOptions, type ValidationLibrary, type ValidationRenderer, applyTableCase, describeSet, formatCode, importSpecifier, insertColumns, isGeneratedColumn, isIntegerColumn, moduleFileName, moduleSpecifier, parseCheck, pascalCase, resolveAffix, resolveConfiguredImport, schemaName, selectColumns, typeName, updateColumns, validateAffix };

package/dist/index.js

@@ -3,6 +3,7 @@ import "./chunk-ZZGILH5A.js";
 // src/checks.ts
 var COMPARISON = /^\s*([A-Za-z_][A-Za-z0-9_]*)\s*(>=|<=|<>|!=|>|<|=)\s*(.+?)\s*$/;
 var IN_LIST = /^\s*([A-Za-z_][A-Za-z0-9_]*)\s+IN\s*\((.+)\)\s*$/i;
+var LENGTH_OF = /^\s*(?:length|char_length)\s*\(\s*([A-Za-z_][A-Za-z0-9_]*)\s*\)\s*(>=|<=|<>|!=|>|<|=)\s*(\d+)\s*$/i;
 function splitTopLevelAnd(expr) {
   const parts = [];
   let depth = 0;
@@ -123,6 +124,7 @@ function parseCheck(expression, name) {
     const checks = [];
     const sets = [];
     const rows = [];
+    const lengths = [];
     for (const part of parts) {
       const parsed = parseCheck(part, name);
       if (!parsed.ok)
@@ -130,12 +132,23 @@ function parseCheck(expression, name) {
       checks.push(...parsed.checks);
       if (parsed.sets) sets.push(...parsed.sets);
       if (parsed.rows) rows.push(...parsed.rows);
+      if (parsed.lengths) lengths.push(...parsed.lengths);
     }
     return {
       ok: true,
       checks,
       ...sets.length ? { sets } : {},
-      ...rows.length ? { rows } : {}
+      ...rows.length ? { rows } : {},
+      ...lengths.length ? { lengths } : {}
+    };
+  }
+  const lengthOf = expr.match(LENGTH_OF);
+  if (lengthOf) {
+    const op2 = lengthOf[2] === "!=" ? "<>" : lengthOf[2];
+    return {
+      ok: true,
+      checks: [],
+      lengths: [{ column: lengthOf[1], operator: op2, value: lengthOf[3], name }]
     };
   }
   const inList = expr.match(IN_LIST);
@@ -356,6 +369,7 @@ var COLUMN_FORMATS = {
   // probes, `1_000` and `0xDEAD_beef` through to `1__0`, `_1`, `0x` and `1e+`.
   numeric: "^\\s*([+-]?(0[xX][0-9a-fA-F](_?[0-9a-fA-F])*|0[oO][0-7](_?[0-7])*|0[bB][01](_?[01])*)|[+-]?(\\d(_?\\d)*(\\.(\\d(_?\\d)*)?)?|\\.\\d(_?\\d)*)([eE][+-]?\\d(_?\\d)*)?|[+-]?(NaN|Infinity))\\s*$"
 };
+var CODEPOINT_LENGTH = "[...v].length";
 function isIntegerColumn(c) {
   if (typeof c.integer === "boolean") return c.integer;
   return c.dbType === "INTEGER" || c.min !== void 0 && c.max !== void 0;
@@ -397,6 +411,7 @@ async function formatCode(code, filePath, fmt) {
 }
 export {
   AFFIX_PROBE_TABLE,
+  CODEPOINT_LENGTH,
   COLUMN_FORMATS,
   DEFAULT_IMPORT_EXTENSION,
   DEFAULT_MODE_PREFIX,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drzl/validation-core",
-  "version": "3.10.0",
+  "version": "3.12.0",
   "private": false,
   "license": "Apache-2.0",
   "type": "module",