@latlng/sdk 0.1.2 → 0.2.0

package/README.md

@@ -287,6 +287,8 @@ The SDK exports typed error classes:
 | `LatLngError` | Base SDK error. |
 | `TimeoutError` | Request exceeded `timeoutMs`. |
 | `HttpError` | Non-success HTTP response with status and payload context. |
+| `BadRequestError` | `400` response: invalid geometry, coordinates, filter, or request field. Subclass of `HttpError`. |
+| `NotFoundError` | `404` response: missing collection, object, hook, or channel. Subclass of `HttpError`. `get()` and `getCollection()` return `null` instead of throwing. |
 | `AuthError` | Authentication or authorization failure. |
 | `ServerUnavailableError` | Server unavailable response. |
 

package/dist/client.d.ts

@@ -99,6 +99,10 @@ export declare class LatLngClient {
     /**
      * Stores or updates a single object in a collection.
      *
+     * The geometry is replaced and fields are merged: fields given here are
+     * added or overwritten, other existing fields are kept, and a numeric `0`
+     * deletes a field. Omitting `expireSeconds` clears any existing TTL.
+     *
      * @param collection Collection name.
      * @param id Object identifier.
      * @param object Object payload.
@@ -147,7 +151,8 @@ export declare class LatLngClient {
      */
     deleteMatching(collection: string, options?: DeleteMatchingOptions): Promise<number>;
     /**
-     * Updates one or more fields on an existing object.
+     * Updates one or more fields on an existing object, keeping its geometry
+     * and TTL. A numeric `0` deletes the field.
      *
      * @param collection Collection name.
      * @param id Object identifier.

package/dist/errors/index.d.ts

@@ -58,6 +58,18 @@ export declare class HttpError extends LatLngError {
  */
 export declare class AuthError extends HttpError {
 }
+/**
+ * HTTP error raised when the request is invalid (status 400), for example
+ * malformed geometry, an invalid filter, or an unknown request field.
+ */
+export declare class BadRequestError extends HttpError {
+}
+/**
+ * HTTP error raised when a collection, object, hook, or channel does not exist
+ * (status 404).
+ */
+export declare class NotFoundError extends HttpError {
+}
 /**
  * HTTP error raised when the server is temporarily unavailable.
  */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { LatLngClient } from "./client.js";
-export { AuthError, HttpError, LatLngError, ServerUnavailableError, TimeoutError, } from "./errors/index.js";
+export { AuthError, BadRequestError, HttpError, LatLngError, NotFoundError, ServerUnavailableError, TimeoutError, } from "./errors/index.js";
 export { LatLngWebSocketClient, type LatLngWebSocketConfig } from "./ws/socket.js";
 export { LatLngSubscription } from "./ws/subscriptions.js";
 export type { JsonPrimitive, JsonValue } from "./types/json.js";