@inixiative/json-rules 2.19.5 → 2.19.6

package/README.md

@@ -101,6 +101,8 @@ Supported comparison operators for aggregate rules: `equals`, `notEquals`, `less
 - `after`
 - `onOrBefore`
 - `onOrAfter`
+- `notBefore`
+- `notAfter`
 - `within`
 - `notWithin`
 - `between`
@@ -221,13 +223,18 @@ absolute date. Magnitudes are always **positive** — direction lives in the key
 Units are dayjs words: `day`, `week`, `isoWeek`, `month`, `quarter`, `year`,
 `hour`, `minute`, `second`.
 
-**Point expressions** — pair with `before` / `after` / `onOrBefore` / `onOrAfter`,
+**Point expressions** — pair with `before` / `after` / `onOrBefore` / `onOrAfter` /
+`notBefore` / `notAfter`,
 or as `between` endpoints:
 
 ```ts
 // "more than 30 days ago"
 { field: 'completedAt', dateOperator: DateOperator.before, value: { ago: { days: 30 } } }
 
+// "not since 30 days ago" — on/before the point OR never (notAfter is the null-carrying
+// complement of after; onOrBefore is positive and skips NULL). Takes a literal date too.
+{ field: 'lastLoginAt', dateOperator: DateOperator.notAfter, value: { ago: { days: 30 } } }
+
 // "within the next 2 months"
 { field: 'dueAt', dateOperator: DateOperator.after, value: { ahead: { months: 2 } } }
 
@@ -536,7 +543,7 @@ Without `{ map, model }`, or on an entry that doesn't declare it, the bare
 Date rules follow the same split. The positive operators answer non-match on both
 rails — a bare boundary is not something a NULL column satisfies, so `check()`
 reports the rule's ordinary non-match (honoring `error`) and the compilers keep the
-bare `<` / `BETWEEN`. The negative-flavored ones (`notWithin`, `notBetween`, `dayNotIn`) follow
+bare `<` / `BETWEEN`. The negative-flavored ones (`notBefore`, `notAfter`, `notWithin`, `notBetween`, `dayNotIn`) follow
 the negation ruling instead: a never-set date is not in the range, so a null column
 MATCHES, and the compilers carry the `IS NULL` arm. To match never-seen rows under a
 positive operator, ask for them:
@@ -545,6 +552,7 @@ positive operator, ask for them:
 | Rule | `check()` on `{ col: null }` | `toSql()` | `toPrisma()` |
 | --- | --- | --- | --- |
 | positive `dateOperator` (`before`, `between`, `dayIn`, …) | no match | `col < $1` (NULL never satisfies) | `{ col: { lt: … } }` |
+| `notAfter X` / `notBefore X` | matches | `(col <= $1 OR col IS NULL)` / `(col >= $1 OR col IS NULL)` | `{ OR: [{ col: { lte } }, { col: { equals: null } }] }` (nullable column) |
 | `notWithin { ago: { days: 30 } }` | matches | `(col NOT BETWEEN $1 AND $2 OR col IS NULL)` | `{ OR: [{ col: { NOT: { gte, lte } } }, { col: { equals: null } }] }` (nullable column) |
 | `notBetween` | matches | `(col NOT BETWEEN $1 AND $2 OR col IS NULL)` | `{ OR: [{ col: { NOT: … } }, { col: { equals: null } }] }` (nullable column, same field-map licensing as above) |
 | `dayNotIn` | matches | `(EXTRACT(DOW FROM col) <> ALL($1) OR col IS NULL)` | — (no Prisma output) |