s3db.js 11.3.2 → 12.0.1

package/dist/s3db.d.ts

@@ -319,6 +319,20 @@ declare module 's3db.js' {
     maxResults?: number;
   }
 
+  /** Geo Plugin resource config */
+  export interface GeoResourceConfig {
+    latField: string;
+    lonField: string;
+    precision?: number;
+    addGeohash?: boolean;
+  }
+
+  /** Geo Plugin config */
+  export interface GeoPluginConfig extends PluginConfig {
+    resources?: Record<string, GeoResourceConfig>;
+    verbose?: boolean;
+  }
+
   /** Metrics Plugin config */
   export interface MetricsPluginConfig extends PluginConfig {
     trackLatency?: boolean;
@@ -709,6 +723,8 @@ declare module 's3db.js' {
     get(id: string): Promise<any>;
     exists(id: string): Promise<boolean>;
     update(id: string, attributes: any): Promise<any>;
+    patch(id: string, fields: any, options?: { partition?: string; partitionValues?: Record<string, any> }): Promise<any>;
+    replace(id: string, fullData: any, options?: { partition?: string; partitionValues?: Record<string, any> }): Promise<any>;
     upsert(data: any): Promise<any>;
     delete(id: string): Promise<void>;
     deleteMany(ids: string[]): Promise<void>;
@@ -827,7 +843,13 @@ declare module 's3db.js' {
     }): Promise<any>;
     getObject(key: string): Promise<any>;
     headObject(key: string): Promise<any>;
-    copyObject(options: { from: string; to: string }): Promise<any>;
+    copyObject(options: {
+      from: string;
+      to: string;
+      metadata?: Record<string, any>;
+      metadataDirective?: 'COPY' | 'REPLACE';
+      contentType?: string;
+    }): Promise<any>;
     exists(key: string): Promise<boolean>;
     deleteObject(key: string): Promise<any>;
     deleteObjects(keys: string[]): Promise<{ deleted: any[]; notFound: any[] }>;
@@ -1016,6 +1038,16 @@ declare module 's3db.js' {
     getIndexStats(): any;
   }
 
+  /** Geo Plugin */
+  export class GeoPlugin extends Plugin {
+    constructor(config?: GeoPluginConfig);
+    encodeGeohash(latitude: number, longitude: number, precision?: number): string;
+    decodeGeohash(geohash: string): { latitude: number; longitude: number; error: { latitude: number; longitude: number } };
+    calculateDistance(lat1: number, lon1: number, lat2: number, lon2: number): number;
+    getNeighbors(geohash: string): string[];
+    getStats(): any;
+  }
+
   /** Metrics Plugin */
   export class MetricsPlugin extends Plugin {
     constructor(config?: MetricsPluginConfig);
@@ -1254,6 +1286,33 @@ declare module 's3db.js' {
   }
 
   /** Resource extensions added by EventualConsistencyPlugin */
+  export interface GeoResourceExtensions {
+    /** Find locations within radius of a point */
+    findNearby(options: {
+      lat: number;
+      lon: number;
+      radius?: number;
+      limit?: number;
+    }): Promise<Array<any & { _distance: number }>>;
+
+    /** Find locations within bounding box */
+    findInBounds(options: {
+      north: number;
+      south: number;
+      east: number;
+      west: number;
+      limit?: number;
+    }): Promise<any[]>;
+
+    /** Get distance between two records */
+    getDistance(id1: string, id2: string): Promise<{
+      distance: number;
+      unit: string;
+      from: string;
+      to: string;
+    }>;
+  }
+
   export interface EventualConsistencyResourceExtensions {
     /** Set field value (replaces current value) */
     set(id: string, field: string, value: number): Promise<number>;
@@ -1264,6 +1323,12 @@ declare module 's3db.js' {
     /** Decrement field value */
     sub(id: string, field: string, amount: number): Promise<number>;
 
+    /** Increment field value by 1 (shorthand for add(id, field, 1)) */
+    increment(id: string, field: string): Promise<number>;
+
+    /** Decrement field value by 1 (shorthand for sub(id, field, 1)) */
+    decrement(id: string, field: string): Promise<number>;
+
     /** Manually trigger consolidation */
     consolidate(id: string, field: string): Promise<number>;