@atscript/db-client 0.1.103 → 0.1.104

package/dist/index.cjs

@@ -162,6 +162,38 @@ var Client = class {
 		});
 	}
 	/**
+	* `GET /geo` — distance-ranked geospatial search (tables with `@db.index.geo`).
+	*
+	* `point` is `[lng, lat]` (GeoJSON order). Rows come back ordered by distance
+	* ascending, each carrying a computed `$distance` (meters from `point`).
+	* `$maxDistance` / `$minDistance` (meters) and `$index` (geo index name) ride
+	* in `query.controls`; filter / `$select` / `$with` / `$skip` / `$limit`
+	* compose as usual.
+	*/
+	async geoSearch(point, query) {
+		return this._get("geo", {
+			...query,
+			controls: {
+				...query?.controls,
+				$center: point.join(",")
+			}
+		});
+	}
+	/**
+	* `GET /geo` with `$page` / `$size` — paginated distance-ranked search.
+	*/
+	async geoPages(point, query, page = 1, size = 10) {
+		return this._get("geo", {
+			...query,
+			controls: {
+				...query?.controls,
+				$center: point.join(","),
+				$page: page,
+				$size: size
+			}
+		});
+	}
+	/**
 	* `GET /one/:id` or `GET /one?k1=v1&k2=v2` — single record by primary key.
 	*
 	* Returns `null` on 404. Response narrows by the literal `$with` array in

package/dist/index.d.cts

@@ -68,6 +68,24 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
    * {@link query}.
    */
   pages<Q extends Uniquery$1<Own<T>, Nav<T>> = Uniquery$1<Own<T>, Nav<T>>>(query?: Q, page?: number, size?: number): Promise<PageResult<Response<T, Q>>>;
+  /**
+   * `GET /geo` — distance-ranked geospatial search (tables with `@db.index.geo`).
+   *
+   * `point` is `[lng, lat]` (GeoJSON order). Rows come back ordered by distance
+   * ascending, each carrying a computed `$distance` (meters from `point`).
+   * `$maxDistance` / `$minDistance` (meters) and `$index` (geo index name) ride
+   * in `query.controls`; filter / `$select` / `$with` / `$skip` / `$limit`
+   * compose as usual.
+   */
+  geoSearch<Q extends Uniquery$1<Own<T>, Nav<T>> = Uniquery$1<Own<T>, Nav<T>>>(point: [number, number], query?: Q): Promise<Array<Response<T, Q> & {
+    $distance: number;
+  }>>;
+  /**
+   * `GET /geo` with `$page` / `$size` — paginated distance-ranked search.
+   */
+  geoPages<Q extends Uniquery$1<Own<T>, Nav<T>> = Uniquery$1<Own<T>, Nav<T>>>(point: [number, number], query?: Q, page?: number, size?: number): Promise<PageResult<Response<T, Q> & {
+    $distance: number;
+  }>>;
   /**
    * `GET /one/:id` or `GET /one?k1=v1&k2=v2` — single record by primary key.
    *

package/dist/index.d.mts

@@ -68,6 +68,24 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
    * {@link query}.
    */
   pages<Q extends Uniquery$1<Own<T>, Nav<T>> = Uniquery$1<Own<T>, Nav<T>>>(query?: Q, page?: number, size?: number): Promise<PageResult<Response<T, Q>>>;
+  /**
+   * `GET /geo` — distance-ranked geospatial search (tables with `@db.index.geo`).
+   *
+   * `point` is `[lng, lat]` (GeoJSON order). Rows come back ordered by distance
+   * ascending, each carrying a computed `$distance` (meters from `point`).
+   * `$maxDistance` / `$minDistance` (meters) and `$index` (geo index name) ride
+   * in `query.controls`; filter / `$select` / `$with` / `$skip` / `$limit`
+   * compose as usual.
+   */
+  geoSearch<Q extends Uniquery$1<Own<T>, Nav<T>> = Uniquery$1<Own<T>, Nav<T>>>(point: [number, number], query?: Q): Promise<Array<Response<T, Q> & {
+    $distance: number;
+  }>>;
+  /**
+   * `GET /geo` with `$page` / `$size` — paginated distance-ranked search.
+   */
+  geoPages<Q extends Uniquery$1<Own<T>, Nav<T>> = Uniquery$1<Own<T>, Nav<T>>>(point: [number, number], query?: Q, page?: number, size?: number): Promise<PageResult<Response<T, Q> & {
+    $distance: number;
+  }>>;
   /**
    * `GET /one/:id` or `GET /one?k1=v1&k2=v2` — single record by primary key.
    *

package/dist/index.mjs

@@ -161,6 +161,38 @@ var Client = class {
 		});
 	}
 	/**
+	* `GET /geo` — distance-ranked geospatial search (tables with `@db.index.geo`).
+	*
+	* `point` is `[lng, lat]` (GeoJSON order). Rows come back ordered by distance
+	* ascending, each carrying a computed `$distance` (meters from `point`).
+	* `$maxDistance` / `$minDistance` (meters) and `$index` (geo index name) ride
+	* in `query.controls`; filter / `$select` / `$with` / `$skip` / `$limit`
+	* compose as usual.
+	*/
+	async geoSearch(point, query) {
+		return this._get("geo", {
+			...query,
+			controls: {
+				...query?.controls,
+				$center: point.join(",")
+			}
+		});
+	}
+	/**
+	* `GET /geo` with `$page` / `$size` — paginated distance-ranked search.
+	*/
+	async geoPages(point, query, page = 1, size = 10) {
+		return this._get("geo", {
+			...query,
+			controls: {
+				...query?.controls,
+				$center: point.join(","),
+				$page: page,
+				$size: size
+			}
+		});
+	}
+	/**
 	* `GET /one/:id` or `GET /one?k1=v1&k2=v2` — single record by primary key.
 	*
 	* Returns `null` on 404. Response narrows by the literal `$with` array in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-client",
-  "version": "0.1.103",
+  "version": "0.1.104",
   "description": "Browser-compatible HTTP client for @atscript/moost-db REST endpoints.",
   "keywords": [
     "atscript",
@@ -50,7 +50,7 @@
     "@atscript/typescript": "^0.1.75",
     "@uniqu/core": "^0.1.6",
     "unplugin-atscript": "^0.1.75",
-    "@atscript/db": "0.1.103"
+    "@atscript/db": "0.1.104"
   },
   "peerDependencies": {
     "@atscript/db": "^0.1.44",