@latlng/sdk 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,385 @@
+import { LatLngWebSocketClient } from "./ws/socket.js";
+import type { ChannelDef, HookDef, HookInfo } from "./types/events.js";
+import { type CollectionStats, type CollectionInfo, type CompactionResult, type FieldEntry, type FieldMap, type FieldValue, type GeoObject, type LatLngObject, type SearchOptions, type SearchResults, type ServerInfo } from "./types/models.js";
+import type { DeleteMatchingOptions, FsetOptions, GetObjectOptions, JsetOptions, LatLngClientConfig, RenameOptions, SearchAreaRequest, SetHookRequest, SetObjectOptions, SetChannelRequest, TimeoutRequest, WebSocketConnectOptions } from "./types/requests.js";
+import type { ChannelsResponse, InfoResponse, WebhookQueueStatsResponse } from "./types/responses.js";
+/**
+ * High-level HTTP and WebSocket client for a `latlng` server.
+ */
+export declare class LatLngClient {
+    private readonly transport;
+    private readonly replicaRouter;
+    private readonly token?;
+    private readonly webSocketFactory?;
+    /**
+     * Creates a new client instance for a `latlng` deployment.
+     */
+    constructor(config: LatLngClientConfig);
+    /**
+     * Verifies that the configured leader is reachable and authenticated.
+     *
+     * @returns `{ ok: true, pong: true }` when the leader responds successfully.
+     */
+    ping(): Promise<{
+        ok: true;
+        pong: true;
+    }>;
+    /**
+     * Returns the server health response for the configured leader.
+     *
+     * @returns `{ ok: true }` when the leader reports healthy status.
+     */
+    healthz(): Promise<{
+        ok: true;
+    }>;
+    /**
+     * Returns the current server status for the configured leader.
+     *
+     * @returns Parsed server status object.
+     */
+    server(): Promise<ServerInfo>;
+    /**
+     * Returns the server info response, optionally scoped to a section.
+     *
+     * @param section Optional info section requested from the server.
+     * @returns Parsed info response.
+     */
+    info(section?: string): Promise<InfoResponse>;
+    /**
+     * Returns the current Prometheus text exposition metrics from the configured leader.
+     *
+     * @returns Metrics in Prometheus text exposition format.
+     */
+    metrics(): Promise<string>;
+    /**
+     * Lists visible collection names, optionally filtered by a match pattern.
+     *
+     * @param matchPattern Optional glob-like match pattern for collection names.
+     * @returns Visible collection names.
+     */
+    collections(matchPattern?: string): Promise<string[]>;
+    /**
+     * Creates an empty collection explicitly.
+     *
+     * @param collection Collection name.
+     * Returns `true` when the collection was created and `false` when it already existed.
+     * @returns Whether a new collection was created.
+     */
+    createCollection(collection: string): Promise<boolean>;
+    /**
+     * Returns collection metadata for a single collection, or `null` when it does not exist.
+     *
+     * @param collection Collection name.
+     * @returns Collection metadata or `null`.
+     */
+    getCollection(collection: string): Promise<CollectionInfo | null>;
+    /**
+     * Renames a collection.
+     *
+     * @param collection Source collection name.
+     * @param newName Target collection name.
+     * @param options Rename options.
+     * @returns Whether the rename was applied.
+     */
+    rename(collection: string, newName: string, options?: RenameOptions): Promise<boolean>;
+    /**
+     * Returns the geographic bounds for a collection.
+     *
+     * @param collection Collection name.
+     * @returns Bounding box for the collection.
+     */
+    bounds(collection: string): Promise<import("./index.js").BoundingBox>;
+    /**
+     * Returns collection statistics.
+     *
+     * @param collection Collection name.
+     * @returns Collection statistics array from the server.
+     */
+    stats(collection: string): Promise<CollectionStats[]>;
+    /**
+     * Stores or updates a single object in a collection.
+     *
+     * @param collection Collection name.
+     * @param id Object identifier.
+     * @param object Object payload.
+     * @param options Write options.
+     * @returns Whether the object was stored.
+     */
+    setObject(collection: string, id: string, object: GeoObject, options?: SetObjectOptions): Promise<boolean>;
+    /**
+     * Convenience wrapper for storing a point object.
+     *
+     * @param collection Collection name.
+     * @param id Object identifier.
+     * @param coordinates Point coordinates.
+     * @param options Write options.
+     * @returns Whether the point was stored.
+     */
+    setPoint(collection: string, id: string, coordinates: {
+        lat: number;
+        lon: number;
+        z?: number | null;
+    }, options?: SetObjectOptions): Promise<boolean>;
+    /**
+     * Fetches a single object by collection and ID.
+     *
+     * @param collection Collection name.
+     * @param id Object identifier.
+     * @param options Read options.
+     * Returns `null` when the object does not exist.
+     * @returns Parsed object or `null`.
+     */
+    get(collection: string, id: string, options?: GetObjectOptions): Promise<LatLngObject | null>;
+    /**
+     * Deletes a single object.
+     *
+     * @param collection Collection name.
+     * @param id Object identifier.
+     * @returns Whether an object was deleted.
+     */
+    delete(collection: string, id: string): Promise<boolean>;
+    /**
+     * Deletes objects matching the supplied ID pattern and returns the deleted count.
+     *
+     * @param collection Collection name.
+     * @param options Delete options.
+     * @returns Number of deleted objects.
+     */
+    deleteMatching(collection: string, options?: DeleteMatchingOptions): Promise<number>;
+    /**
+     * Updates one or more fields on an existing object.
+     *
+     * @param collection Collection name.
+     * @param id Object identifier.
+     * @param fields Field values to write.
+     * @param options Field update options.
+     * @returns Whether the fields were updated.
+     */
+    setFields(collection: string, id: string, fields: FieldMap | FieldEntry[], options?: FsetOptions): Promise<boolean>;
+    /**
+     * Fetches a single field value from an object.
+     *
+     * @param collection Collection name.
+     * @param id Object identifier.
+     * @param field Field name.
+     * @returns Field value or `null`.
+     */
+    getField(collection: string, id: string, field: string): Promise<FieldValue | null>;
+    /**
+     * Sets or replaces the TTL for an object.
+     *
+     * @param collection Collection name.
+     * @param id Object identifier.
+     * @param seconds TTL in seconds.
+     */
+    expire(collection: string, id: string, seconds: number): Promise<void>;
+    /**
+     * Removes any TTL from an object.
+     *
+     * @param collection Collection name.
+     * @param id Object identifier.
+     */
+    persist(collection: string, id: string): Promise<void>;
+    /**
+     * Returns the remaining TTL in seconds for an object, or `null` if no TTL is set.
+     *
+     * @param collection Collection name.
+     * @param id Object identifier.
+     * @returns Remaining TTL in seconds or `null`.
+     */
+    ttl(collection: string, id: string): Promise<number | null>;
+    /**
+     * Writes a JSON value at the given JSON path on an object.
+     *
+     * @param collection Collection name.
+     * @param id Object identifier.
+     * @param path JSON path.
+     * @param value JSON value string or raw payload, depending on `options.raw`.
+     * @param options JSON write options.
+     */
+    setJson(collection: string, id: string, path: string, value: string, options?: JsetOptions): Promise<void>;
+    /**
+     * Reads a JSON value from the given JSON path on an object.
+     *
+     * @param collection Collection name.
+     * @param id Object identifier.
+     * @param path JSON path.
+     * @returns Parsed JSON value.
+     */
+    getJson(collection: string, id: string, path: string): Promise<unknown>;
+    /**
+     * Deletes a JSON value at the given JSON path on an object.
+     *
+     * @param collection Collection name.
+     * @param id Object identifier.
+     * @param path JSON path.
+     * @returns Whether a JSON value was deleted.
+     */
+    deleteJson(collection: string, id: string, path: string): Promise<boolean>;
+    /**
+     * Runs a `NEARBY` search against a collection.
+     *
+     * @param collection Collection name.
+     * @param query Nearby query payload.
+     * @returns Search results.
+     */
+    nearby(collection: string, query: import("./types/models.js").NearbyQuery): Promise<SearchResults>;
+    /**
+     * Runs a `WITHIN` search against a collection.
+     *
+     * @param collection Collection name.
+     * @param request Area search request.
+     * @returns Search results.
+     */
+    within(collection: string, request: SearchAreaRequest): Promise<SearchResults>;
+    /**
+     * Runs an `INTERSECTS` search against a collection.
+     *
+     * @param collection Collection name.
+     * @param request Area search request.
+     * @returns Search results.
+     */
+    intersects(collection: string, request: SearchAreaRequest): Promise<SearchResults>;
+    /**
+     * Runs a `SCAN` query against a collection.
+     *
+     * @param collection Collection name.
+     * @param options Search options.
+     * @returns Search results.
+     */
+    scan(collection: string, options?: SearchOptions): Promise<SearchResults>;
+    /**
+     * Runs a text search query against a collection.
+     *
+     * @param collection Collection name.
+     * @param options Search options.
+     * @returns Search results.
+     */
+    search(collection: string, options?: SearchOptions): Promise<SearchResults>;
+    /**
+     * Creates or replaces a geofence channel definition.
+     *
+     * @param request Channel definition request.
+     * Returns the stored channel name.
+     * @returns Stored channel name.
+     */
+    setChannel(request: SetChannelRequest): Promise<string>;
+    /**
+     * Deletes a channel definition by name.
+     *
+     * @param name Channel name.
+     * @returns Whether a channel was deleted.
+     */
+    deleteChannel(name: string): Promise<boolean>;
+    /**
+     * Lists visible channel names, optionally filtered by a match pattern.
+     *
+     * @param matchPattern Optional glob-like match pattern for channel names.
+     * @returns Visible channel names.
+     */
+    channels(matchPattern?: string): Promise<ChannelsResponse>;
+    /**
+     * Returns a full channel definition by name, or `null` when it does not exist.
+     *
+     * @param name Channel name.
+     * @returns Full channel definition or `null`.
+     */
+    getChannel(name: string): Promise<ChannelDef | null>;
+    /**
+     * Creates or replaces a webhook hook definition.
+     *
+     * @param request Hook definition request.
+     */
+    setHook(request: SetHookRequest): Promise<void>;
+    /**
+     * Deletes a hook definition by name.
+     *
+     * @param name Hook name.
+     * @returns Whether a hook was deleted.
+     */
+    deleteHook(name: string): Promise<boolean>;
+    /**
+     * Lists visible hook summaries, optionally filtered by a match pattern.
+     *
+     * @param matchPattern Optional glob-like match pattern for hook names.
+     * @returns Visible hook summaries.
+     */
+    hooks(matchPattern?: string): Promise<HookInfo[]>;
+    /**
+     * Returns a full hook definition by name, or `null` when it does not exist.
+     *
+     * @param name Hook name.
+     * @returns Full hook definition or `null`.
+     */
+    getHook(name: string): Promise<HookDef | null>;
+    /**
+     * Reads a single runtime configuration value from the leader.
+     *
+     * @param name Config key.
+     * @returns Config value as a string.
+     */
+    configGet(name: string): Promise<string>;
+    /**
+     * Updates a runtime configuration value on the leader.
+     *
+     * @param name Config key.
+     * @param value Config value.
+     */
+    configSet(name: string, value: string): Promise<void>;
+    /**
+     * Persists the current runtime configuration to disk.
+     */
+    configRewrite(): Promise<void>;
+    /**
+     * Flushes all data from the database.
+     */
+    flushdb(): Promise<void>;
+    /**
+     * Runs garbage collection / maintenance on the leader.
+     */
+    gc(): Promise<void>;
+    /**
+     * Triggers AOF compaction and returns before/after statistics.
+     *
+     * @returns Compaction result statistics.
+     */
+    aofshrink(): Promise<CompactionResult>;
+    /**
+     * Returns webhook queue statistics from the leader.
+     *
+     * @returns Webhook queue statistics.
+     */
+    webhookQueue(): Promise<WebhookQueueStatsResponse>;
+    /**
+     * Enables or disables read-only mode on the leader.
+     *
+     * @param enabled Whether read-only mode should be enabled.
+     * @returns Effective read-only state.
+     */
+    readonly(enabled: boolean): Promise<boolean>;
+    /**
+     * Configures per-command server timeouts.
+     *
+     * @param request Timeout request payload.
+     * @returns Effective timeout in seconds, or `null` when unset.
+     */
+    timeout(request: TimeoutRequest): Promise<number | null>;
+    /**
+     * Drops a collection explicitly.
+     *
+     * @param collection Collection name.
+     * @returns Whether a collection was dropped.
+     */
+    dropCollection(collection: string): Promise<boolean>;
+    /**
+     * Opens a WebSocket client for subscriptions against the configured leader.
+     *
+     * @param options WebSocket connection options.
+     * @returns Connected WebSocket client.
+     */
+    connectWebSocket(options?: WebSocketConnectOptions): Promise<LatLngWebSocketClient>;
+    private requestWrite;
+    private requestLeader;
+    private requestRead;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/errors/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Base SDK error type.
+ */
+export declare class LatLngError extends Error {
+    /** Optional underlying cause. */
+    readonly cause?: unknown;
+    /**
+     * Creates a new SDK error.
+     *
+     * @param message Human-readable error message.
+     * @param options Additional error metadata.
+     */
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Error raised when an HTTP request exceeds the configured timeout.
+ */
+export declare class TimeoutError extends LatLngError {
+    /** Configured timeout in milliseconds. */
+    readonly timeoutMs: number;
+    /**
+     * Creates a timeout error.
+     *
+     * @param timeoutMs Timeout that was exceeded.
+     * @param options Additional error metadata.
+     */
+    constructor(timeoutMs: number, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Error raised for non-success HTTP responses.
+ */
+export declare class HttpError extends LatLngError {
+    /** HTTP status code returned by the server. */
+    readonly status: number;
+    /** Request URL that produced the error. */
+    readonly url: string;
+    /** Parsed response body, when available. */
+    readonly body?: unknown;
+    /**
+     * Creates an HTTP error wrapper.
+     *
+     * @param message Human-readable error message.
+     * @param options HTTP error metadata.
+     */
+    constructor(message: string, options: {
+        status: number;
+        url: string;
+        body?: unknown;
+        cause?: unknown;
+    });
+}
+/**
+ * HTTP error raised for authentication failures.
+ */
+export declare class AuthError extends HttpError {
+}
+/**
+ * HTTP error raised when the server is temporarily unavailable.
+ */
+export declare class ServerUnavailableError extends HttpError {
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,iCAAiC;IACjC,SAAgB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;;OAKG;gBACgB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKlE;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C,0CAA0C;IAC1C,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC;;;;;OAKG;gBACgB,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAIpE;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,WAAW;IACxC,+CAA+C;IAC/C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,2CAA2C;IAC3C,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,4CAA4C;IAC5C,SAAgB,IAAI,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAO5E;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,SAAS;CAAG;AAE3C;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,SAAS;CAAG"}

package/dist/http/routes.d.ts

@@ -0,0 +1,41 @@
+export declare function joinUrl(baseUrl: string, path: string): string;
+export declare function buildQuery(query: Record<string, string | number | boolean | null | undefined>): string;
+export declare const routes: {
+    ping: () => string;
+    healthz: () => string;
+    server: () => string;
+    info: (section?: string) => string;
+    metrics: () => string;
+    collections: (matchPattern?: string) => string;
+    collection: (collection: string) => string;
+    renameCollection: (collection: string) => string;
+    bounds: (collection: string) => string;
+    stats: (collection: string) => string;
+    object: (collection: string, id: string) => string;
+    objects: (collection: string, matchPattern?: string) => string;
+    fields: (collection: string, id: string) => string;
+    field: (collection: string, id: string, field: string) => string;
+    expire: (collection: string, id: string) => string;
+    ttl: (collection: string, id: string) => string;
+    jsonRoot: (collection: string, id: string) => string;
+    jsonPath: (collection: string, id: string, path: string) => string;
+    nearby: (collection: string) => string;
+    within: (collection: string) => string;
+    intersects: (collection: string) => string;
+    scan: (collection: string) => string;
+    search: (collection: string) => string;
+    channels: (matchPattern?: string) => string;
+    channel: (name: string) => string;
+    hooks: (matchPattern?: string) => string;
+    hook: (name: string) => string;
+    config: (name: string) => string;
+    flushdb: () => string;
+    gc: () => string;
+    aofshrink: () => string;
+    webhookQueue: () => string;
+    configRewrite: () => string;
+    readonly: () => string;
+    timeout: () => string;
+    ws: () => string;
+};
+//# sourceMappingURL=routes.d.ts.map

package/dist/http/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/http/routes.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,GAClE,MAAM,CAUR;AAED,eAAO,MAAM,MAAM;;;;qBAIA,MAAM;;iCAEM,MAAM;6BAEV,MAAM;mCAEA,MAAM;yBAEhB,MAAM;wBAEP,MAAM;yBAEL,MAAM,MAAM,MAAM;0BAEjB,MAAM,iBAAiB,MAAM;yBAI9B,MAAM,MAAM,MAAM;wBAEnB,MAAM,MAAM,MAAM,SAAS,MAAM;yBAEhC,MAAM,MAAM,MAAM;sBAErB,MAAM,MAAM,MAAM;2BAEb,MAAM,MAAM,MAAM;2BAElB,MAAM,MAAM,MAAM,QAAQ,MAAM;yBAElC,MAAM;yBAEN,MAAM;6BAEF,MAAM;uBAEZ,MAAM;yBAEJ,MAAM;8BAED,MAAM;oBAEhB,MAAM;2BACC,MAAM;iBAEhB,MAAM;mBACJ,MAAM;;;;;;;;;CAStB,CAAC"}

package/dist/http/transport.d.ts

@@ -0,0 +1,26 @@
+export interface HttpTransportConfig {
+    baseUrl: string;
+    token?: string;
+    timeoutMs?: number;
+    headers?: HeadersInit;
+    fetch?: typeof globalThis.fetch;
+}
+export interface RequestOptions<T> {
+    method?: "GET" | "POST" | "DELETE";
+    path: string;
+    body?: unknown;
+    baseUrl?: string;
+    parser?: (value: unknown) => T;
+}
+export declare class HttpTransport {
+    private readonly baseUrl;
+    private readonly token?;
+    private readonly timeoutMs;
+    private readonly headers?;
+    private readonly fetchImpl;
+    constructor(config: HttpTransportConfig);
+    request<T>(options: RequestOptions<T>): Promise<T>;
+    requestText(options: Omit<RequestOptions<string>, "parser">): Promise<string>;
+    private toHttpError;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/http/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/http/transport.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,CAAC;CAChC;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAEjC,MAAM,EAAE,mBAAmB;IAQjC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoClD,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAoC1F,OAAO,CAAC,WAAW;CAuBpB"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { LatLngClient } from "./client.js";
+export { AuthError, HttpError, LatLngError, 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";
+export { bounds, fieldEntries, geojson, hash, jsonField, numberField, point, stringObject, textField, } from "./types/models.js";
+export type { Area, BoundingBox, CollectionInfo, CollectionStats, CompactionResult, FieldEntry, FieldMap, FieldValue, GeoObject, LatLngObject, NearbyQuery, OutputFormat, SearchItem, SearchOptions, SearchResults, ServerInfo, SortOrder, WhereComparison, WhereExprFilter, WhereFilter, WhereInFilter, } from "./types/models.js";
+export { parseGeofenceEvent } from "./types/events.js";
+export type { ChannelDef, DetectType, GeofenceDef, GeofenceEvent, GeofenceQuery, HookDef, HookInfo, MutationCommand, RoamingInfo, } from "./types/events.js";
+export type { DeleteMatchingOptions, FsetOptions, GetObjectOptions, JsetOptions, LatLngClientConfig, NearbyRequest, ReadPreference, RenameOptions, SearchAreaRequest, SetChannelRequest, SetHookRequest, SetObjectOptions, TimeoutRequest, WebSocketConnectOptions, } from "./types/requests.js";
+export type { AofshrinkResponse, BoundsResponse, ChannelsResponse, CollectionInfoResponse, CollectionsResponse, ConfigValueResponse, CreateCollectionResponse, DeleteResponse, DropCollectionResponse, FieldResponse, GetObjectResponse, HooksResponse, InfoResponse, JsonValueResponse, MetricsResponse, OkResponse, PingResponse, ReadOnlyResponse, RenameResponse, SearchResponse, ServerResponse, SetObjectResponse, StatsResponse, TimeoutResponse, TtlResponse, UpdatedResponse, WebhookQueueStatsResponse, } from "./types/responses.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,sBAAsB,EACtB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EACL,MAAM,EACN,YAAY,EACZ,OAAO,EACP,IAAI,EACJ,SAAS,EACT,WAAW,EACX,KAAK,EACL,YAAY,EACZ,SAAS,GACV,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,IAAI,EACJ,WAAW,EACX,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,aAAa,EACb,aAAa,EACb,UAAU,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,OAAO,EACP,QAAQ,EACR,eAAe,EACf,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,qBAAqB,EACrB,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,WAAW,EACX,eAAe,EACf,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC"}