@byline/core 6.9.0 → 6.10.0

package/dist/@types/search-types.d.ts

@@ -167,6 +167,24 @@ export interface SearchMatching {
 }
 /** Maximum UTF-16 length accepted for one full-text query. */
 export declare const MAX_SEARCH_QUERY_LENGTH = 1024;
+/** Maximum `ceil((end - start) / gap)` for one range-facet request. */
+export declare const MAX_RANGE_FACET_BUCKETS = 200;
+/** One numeric range-facet request over an integer `search.filters` field. */
+export interface SearchRangeFacetRequest {
+    field: string;
+    /** Inclusive lower edge of the first bucket. */
+    start: number;
+    /** Exclusive upper edge of the last bucket. */
+    end: number;
+    /** Bucket width; must be finite and greater than zero. */
+    gap: number;
+}
+/** One range bucket: `[start, end)` and its match count. */
+export interface SearchRangeFacetBucket {
+    start: number;
+    end: number;
+    count: number;
+}
 /**
  * A search request. Either collection-scoped (`collectionPath`) for
  * homogeneous results, or zone-scoped (`zone`) for heterogeneous
@@ -201,6 +219,8 @@ export interface SearchQuery {
     where?: QueryPredicate;
     /** Field names to compute facet buckets for (driver-capability gated). */
     facets?: string[];
+    /** Integer range aggregates; requires `capabilities.rangeFacets: true`. */
+    rangeFacets?: SearchRangeFacetRequest[];
     /** Restrict to a single content locale. */
     locale?: string;
     /**
@@ -254,6 +274,12 @@ export interface SearchResults {
      * driver supports them.
      */
     facets?: Record<string, SearchFacetBucket[]>;
+    /**
+     * Contiguous ascending buckets keyed by field, including zero counts.
+     * Cover exactly the requested `[start, end)`, truncating the final bucket.
+     * Counts respect the query, where, locale, status, and collection/zone scope.
+     */
+    rangeFacets?: Record<string, SearchRangeFacetBucket[]>;
 }
 /**
  * What a given driver can actually do. Lets consumers (the admin UI, the
@@ -266,6 +292,14 @@ export interface SearchResults {
 export interface SearchCapabilities {
     /** Faceted aggregation over indexed fields. */
     facets: boolean;
+    /** Integer range aggregation. Omission means false; unsupported requests must fail. */
+    rangeFacets?: boolean;
+    /**
+     * Applies `SearchQuery.where`. Omission means false. Advertise-only: the
+     * client still forwards `where` when absent. Providers may support a
+     * documented subset, but must reject unsupported fields or operators.
+     */
+    structuredFilters?: boolean;
     /** Fuzzy / typo-tolerant matching (e.g. `pg_trgm`). */
     typoTolerance: boolean;
     /** Vector / semantic / hybrid retrieval. */

package/dist/@types/search-types.js

@@ -7,3 +7,5 @@
  */
 /** Maximum UTF-16 length accepted for one full-text query. */
 export const MAX_SEARCH_QUERY_LENGTH = 1_024;
+/** Maximum `ceil((end - start) / gap)` for one range-facet request. */
+export const MAX_RANGE_FACET_BUCKETS = 200;

package/dist/@types/search-types.test.node.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+export {};

package/dist/@types/search-types.test.node.js

@@ -0,0 +1,21 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import { expect, it } from 'vitest';
+import { MAX_RANGE_FACET_BUCKETS } from '../index.js';
+it('exports the range-facet contract and bucket cap from the public core entry point', () => {
+    const request = { field: 'year', start: 2000, end: 2003, gap: 2 };
+    const buckets = [
+        { start: 2000, end: 2002, count: 0 },
+        { start: 2002, end: 2003, count: 1 },
+    ];
+    const query = { query: '', rangeFacets: [request] };
+    const result = { hits: [], total: 1, rangeFacets: { year: buckets } };
+    expect(MAX_RANGE_FACET_BUCKETS).toBe(200);
+    expect(query.rangeFacets).toEqual([request]);
+    expect(result.rangeFacets?.year).toEqual(buckets);
+});

package/package.json

@@ -2,7 +2,7 @@
   "name": "@byline/core",
   "private": false,
   "license": "MPL-2.0",
-  "version": "6.9.0",
+  "version": "6.10.0",
   "engines": {
     "node": ">=22.22.2"
   },
@@ -82,7 +82,7 @@
     "dist"
   ],
   "dependencies": {
-    "@byline/auth": "6.9.0",
+    "@byline/auth": "6.10.0",
     "dotenv": "^18.0.8",
     "pino": "^10.4.0",
     "sharp": "^0.35.5",
@@ -90,15 +90,15 @@
     "zod": "^4.6.7"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.5.15",
+    "@biomejs/biome": "2.6.2",
     "@types/node": "^26.6.5",
-    "chokidar": "^5.0.0",
+    "chokidar": "^6.0.0",
     "chokidar-cli": "^3.0.0",
     "npm-run-all": "^4.1.5",
-    "tsc-alias": "^1.9.7",
+    "tsc-alias": "^1.9.8",
     "tsx": "^4.23.15",
     "typescript": "^7.0.2",
-    "vitest": "^5.0.4"
+    "vitest": "^5.0.5"
   },
   "publishConfig": {
     "access": "public",