@bhushanpawar/sqldb 1.0.8 → 1.0.9

package/dist/search/location-normalizer.js

@@ -0,0 +1,308 @@
+"use strict";
+/**
+ * Location normalization for handling city name variations, aliases, and canonical forms
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INTERNATIONAL_CITY_ALIASES = exports.US_CITY_ALIASES = exports.LocationNormalizer = void 0;
+const geo_search_1 = require("../types/geo-search");
+class LocationNormalizer {
+    constructor(buckets = geo_search_1.MAJOR_CITY_BUCKETS, customMappings = []) {
+        this.normalizationMap = new Map();
+        this.aliasMap = new Map(); // alias -> canonical
+        this.buckets = buckets;
+        this.buildNormalizationMaps(customMappings);
+    }
+    /**
+     * Build normalization maps from buckets and custom mappings
+     */
+    buildNormalizationMaps(customMappings) {
+        // Add bucket-based normalizations
+        for (const bucket of this.buckets) {
+            const bucketName = bucket.name || bucket.locationName || bucket.id;
+            const normalized = {
+                original: bucketName,
+                canonical: bucketName,
+                coordinates: bucket.center,
+                bucketId: bucket.id,
+                aliases: bucket.aliases || [],
+            };
+            // Map canonical name
+            this.normalizationMap.set(this.normalizeString(bucketName), normalized);
+            // Map all aliases
+            if (bucket.aliases) {
+                for (const alias of bucket.aliases) {
+                    this.aliasMap.set(this.normalizeString(alias), bucketName);
+                }
+            }
+        }
+        // Add custom mappings (override bucket mappings if conflicts)
+        for (const mapping of customMappings) {
+            const key = this.normalizeString(mapping.original);
+            this.normalizationMap.set(key, mapping);
+            // Map canonical
+            this.aliasMap.set(key, mapping.canonical);
+            // Map aliases
+            if (mapping.aliases) {
+                for (const alias of mapping.aliases) {
+                    this.aliasMap.set(this.normalizeString(alias), mapping.canonical);
+                }
+            }
+        }
+    }
+    /**
+     * Normalize a location string to canonical form
+     */
+    normalize(location) {
+        if (!location || typeof location !== 'string') {
+            return null;
+        }
+        const normalized = this.normalizeString(location);
+        // Check direct match
+        const direct = this.normalizationMap.get(normalized);
+        if (direct) {
+            return direct;
+        }
+        // Check alias match
+        const canonical = this.aliasMap.get(normalized);
+        if (canonical) {
+            const canonicalNorm = this.normalizationMap.get(this.normalizeString(canonical));
+            if (canonicalNorm) {
+                return {
+                    ...canonicalNorm,
+                    original: location, // Preserve original input
+                };
+            }
+        }
+        // Try fuzzy matching for common misspellings
+        const fuzzyMatch = this.fuzzyMatch(normalized);
+        if (fuzzyMatch) {
+            return {
+                ...fuzzyMatch,
+                original: location,
+            };
+        }
+        // Return as-is if no normalization found
+        return {
+            original: location,
+            canonical: location,
+        };
+    }
+    /**
+     * Normalize string for comparison (lowercase, trim, remove special chars)
+     */
+    normalizeString(str) {
+        return str
+            .toLowerCase()
+            .trim()
+            .replace(/[^\w\s]/g, '') // Remove special characters
+            .replace(/\s+/g, ' '); // Normalize whitespace
+    }
+    /**
+     * Fuzzy match for common misspellings and variations
+     */
+    fuzzyMatch(normalized) {
+        const threshold = 0.8; // Similarity threshold
+        for (const [key, value] of this.normalizationMap.entries()) {
+            const similarity = this.stringSimilarity(normalized, key);
+            if (similarity >= threshold) {
+                return value;
+            }
+            // Also check aliases
+            if (value.aliases) {
+                for (const alias of value.aliases) {
+                    const aliasSim = this.stringSimilarity(normalized, this.normalizeString(alias));
+                    if (aliasSim >= threshold) {
+                        return value;
+                    }
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Calculate string similarity using Dice coefficient
+     */
+    stringSimilarity(str1, str2) {
+        if (str1 === str2)
+            return 1;
+        if (str1.length < 2 || str2.length < 2)
+            return 0;
+        const bigrams1 = this.getBigrams(str1);
+        const bigrams2 = this.getBigrams(str2);
+        const intersection = bigrams1.filter((bigram) => bigrams2.includes(bigram)).length;
+        const union = bigrams1.length + bigrams2.length;
+        return (2 * intersection) / union;
+    }
+    /**
+     * Get bigrams from string
+     */
+    getBigrams(str) {
+        const bigrams = [];
+        for (let i = 0; i < str.length - 1; i++) {
+            bigrams.push(str.substring(i, i + 2));
+        }
+        return bigrams;
+    }
+    /**
+     * Get coordinates for a location name
+     */
+    getCoordinates(location) {
+        const normalized = this.normalize(location);
+        return normalized?.coordinates || null;
+    }
+    /**
+     * Get bucket for a location name
+     */
+    getBucket(location) {
+        const normalized = this.normalize(location);
+        if (!normalized?.bucketId)
+            return null;
+        return this.buckets.find((b) => b.id === normalized.bucketId) || null;
+    }
+    /**
+     * Find all variations of a canonical location name
+     */
+    getVariations(canonical) {
+        const normalized = this.normalizeString(canonical);
+        const mapping = this.normalizationMap.get(normalized);
+        if (!mapping)
+            return [canonical];
+        const variations = new Set();
+        variations.add(mapping.canonical);
+        if (mapping.aliases) {
+            mapping.aliases.forEach((alias) => variations.add(alias));
+        }
+        return Array.from(variations);
+    }
+    /**
+     * Add a custom location mapping
+     */
+    addMapping(mapping) {
+        const key = this.normalizeString(mapping.original);
+        this.normalizationMap.set(key, mapping);
+        // Update alias map
+        this.aliasMap.set(key, mapping.canonical);
+        if (mapping.aliases) {
+            for (const alias of mapping.aliases) {
+                this.aliasMap.set(this.normalizeString(alias), mapping.canonical);
+            }
+        }
+    }
+    /**
+     * Batch add multiple mappings
+     */
+    addMappings(mappings) {
+        for (const mapping of mappings) {
+            this.addMapping(mapping);
+        }
+    }
+    /**
+     * Get all canonical locations
+     */
+    getAllCanonicalLocations() {
+        const canonical = new Set();
+        for (const mapping of this.normalizationMap.values()) {
+            canonical.add(mapping.canonical);
+        }
+        return Array.from(canonical).sort();
+    }
+    /**
+     * Check if a location is recognized
+     */
+    isRecognized(location) {
+        const normalized = this.normalize(location);
+        return normalized !== null && normalized.canonical !== location;
+    }
+    /**
+     * Get statistics about normalization coverage
+     */
+    getStats() {
+        return {
+            totalCanonical: this.normalizationMap.size,
+            totalAliases: this.aliasMap.size,
+            totalBuckets: this.buckets.length,
+        };
+    }
+}
+exports.LocationNormalizer = LocationNormalizer;
+/**
+ * Common location aliases for US cities
+ */
+exports.US_CITY_ALIASES = [
+    {
+        original: 'The Big Apple',
+        canonical: 'New York City',
+        aliases: ['Big Apple', 'NYC'],
+    },
+    {
+        original: 'Sin City',
+        canonical: 'Las Vegas',
+        aliases: ['Vegas', 'LV', 'Las Vegas'],
+    },
+    {
+        original: 'Motor City',
+        canonical: 'Detroit',
+        aliases: ['The D', 'Detroit', 'DTW'],
+    },
+    {
+        original: 'Music City',
+        canonical: 'Nashville',
+        aliases: ['Nash', 'Nashville', 'BNA'],
+    },
+    {
+        original: 'The Mile High City',
+        canonical: 'Denver',
+        aliases: ['Denver', 'DEN'],
+    },
+    {
+        original: 'The Emerald City',
+        canonical: 'Seattle',
+        aliases: ['Seattle', 'SEA'],
+    },
+    {
+        original: 'The City of Angels',
+        canonical: 'Los Angeles',
+        aliases: ['LA', 'Los Angeles', 'LAX'],
+    },
+    {
+        original: 'The Windy City',
+        canonical: 'Chicago',
+        aliases: ['Chicago', 'Chi-Town', 'ORD'],
+    },
+    {
+        original: 'Philly',
+        canonical: 'Philadelphia',
+        aliases: ['Philadelphia', 'PHL'],
+    },
+    {
+        original: 'ATX',
+        canonical: 'Austin',
+        aliases: ['Austin', 'ATX'],
+    },
+];
+/**
+ * Common location aliases for international cities
+ */
+exports.INTERNATIONAL_CITY_ALIASES = [
+    {
+        original: 'The Big Smoke',
+        canonical: 'London',
+        aliases: ['London', 'LDN'],
+    },
+    {
+        original: 'The City of Light',
+        canonical: 'Paris',
+        aliases: ['Paris', 'CDG'],
+    },
+    {
+        original: 'The Big Mango',
+        canonical: 'Bangkok',
+        aliases: ['Bangkok', 'BKK'],
+    },
+    {
+        original: 'The Big Durian',
+        canonical: 'Jakarta',
+        aliases: ['Jakarta', 'CGK'],
+    },
+];
+//# sourceMappingURL=location-normalizer.js.map

package/dist/search/location-normalizer.js.map

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

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

@@ -0,0 +1,146 @@
+/**
+ * Geospatial search types and configuration for SqlDB
+ * Enables location-based search with distance calculations, bucketing, and canonical location matching
+ */
+export interface GeoPoint {
+    lat: number;
+    lng: number;
+}
+export interface GeoBounds {
+    northEast: GeoPoint;
+    southWest: GeoPoint;
+}
+export interface GeoDistance {
+    value: number;
+    unit: 'km' | 'mi' | 'm';
+}
+export interface GeoBucket {
+    id: string;
+    name?: string;
+    center: GeoPoint;
+    radius: GeoDistance;
+    bounds?: GeoBounds;
+    aliases?: string[];
+    members?: string[];
+    locationName?: string;
+}
+export interface LocationNormalization {
+    /** Original location string from data */
+    original: string;
+    /** Normalized canonical name */
+    canonical: string;
+    /** Coordinates if available */
+    coordinates?: GeoPoint;
+    /** Bucket ID this location belongs to */
+    bucketId?: string;
+    /** Alternative spellings/names */
+    aliases?: string[];
+}
+export interface GeoSearchConfig {
+    /** Enable geospatial search */
+    enabled: boolean;
+    /** Field names containing latitude */
+    latitudeField: string;
+    /** Field names containing longitude */
+    longitudeField: string;
+    /** Optional field containing location name/city for normalization */
+    locationNameField?: string;
+    /** Default distance unit */
+    defaultUnit?: 'km' | 'mi' | 'm';
+    /** Maximum search radius allowed (prevents overly broad searches) */
+    maxRadius?: GeoDistance;
+    /** Geographic buckets for regional grouping */
+    buckets?: GeoBucket[];
+    /** Location normalization mappings */
+    locationMappings?: LocationNormalization[];
+    /** Enable automatic city name normalization */
+    autoNormalize?: boolean;
+    /** Common location aliases (e.g., "NYC" -> "New York City") */
+    commonAliases?: Record<string, string>;
+}
+export interface GeoSearchOptions {
+    /** Search center point */
+    center: GeoPoint;
+    /** Search radius */
+    radius: GeoDistance;
+    /** Sort by distance (default: true) */
+    sortByDistance?: boolean;
+    /** Include distance in results */
+    includeDistance?: boolean;
+    /** Filter by bucket ID */
+    bucketId?: string;
+    /** Location name to normalize and search */
+    locationName?: string;
+    /** Maximum number of results */
+    limit?: number;
+    /** Combined text search query */
+    textQuery?: string;
+    /**
+     * Maximum search range for cluster expansion
+     * If initial search yields few results, expand up to this distance
+     * Example: Initial radius 5km, maxRange 8km -> will search up to 8km if needed
+     */
+    maxRange?: GeoDistance;
+    /**
+     * Minimum results threshold to trigger expansion
+     * If results < minResults, expand search radius up to maxRange
+     * Default: 5
+     */
+    minResults?: number;
+    /** Boost results within certain distance ranges */
+    distanceBoost?: {
+        /** Distance threshold */
+        distance: GeoDistance;
+        /** Boost multiplier (e.g., 2.0 = 2x relevance) */
+        boost: number;
+    }[];
+}
+export interface GeoSearchResult<T = any> {
+    /** The matched document */
+    document: T;
+    /** Distance from search center */
+    distance?: GeoDistance;
+    /** Bucket this result belongs to */
+    bucket?: GeoBucket;
+    /** Text search score (if combined search) */
+    textScore?: number;
+    /** Combined relevance score */
+    relevanceScore: number;
+}
+export interface GeoIndexStats {
+    /** Total number of geo-indexed documents */
+    totalDocuments: number;
+    /** Number of documents in each bucket */
+    bucketCounts: Record<string, number>;
+    /** Geographic bounds of all indexed data */
+    bounds: GeoBounds;
+    /** Number of normalized locations */
+    normalizedLocations: number;
+    /** Index size in bytes */
+    indexSize: number;
+    /** Last index update timestamp */
+    lastUpdated: Date;
+}
+export interface GeoSearchTableConfig {
+    /** Latitude field name */
+    latitudeField: string;
+    /** Longitude field name */
+    longitudeField: string;
+    /** Optional location name field for normalization */
+    locationNameField?: string;
+    /** Table-specific geo buckets */
+    buckets?: GeoBucket[];
+    /** Location normalization for this table */
+    locationMappings?: LocationNormalization[];
+    /** Enable auto-normalization for this table */
+    autoNormalize?: boolean;
+    /** Default search radius for this table */
+    defaultRadius?: GeoDistance;
+    /** Combine with text search fields */
+    combineWithTextSearch?: boolean;
+}
+/**
+ * Pre-defined major city buckets for common use cases
+ */
+export declare const MAJOR_CITY_BUCKETS: GeoBucket[];
+//# sourceMappingURL=geo-search.d.ts.map

package/dist/types/geo-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo-search.d.ts","sourceRoot":"","sources":["../../src/types/geo-search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,GAAG,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC;IAEjB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IAEtB,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAC;IAEvB,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,4BAA4B;IAC5B,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,GAAG,CAAC;IAEhC,qEAAqE;IACrE,SAAS,CAAC,EAAE,WAAW,CAAC;IAExB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IAEtB,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAE3C,+CAA+C;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,MAAM,EAAE,QAAQ,CAAC;IAEjB,oBAAoB;IACpB,MAAM,EAAE,WAAW,CAAC;IAEpB,uCAAuC;IACvC,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,kCAAkC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC;IAEvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,mDAAmD;IACnD,aAAa,CAAC,EAAE;QACd,yBAAyB;QACzB,QAAQ,EAAE,WAAW,CAAC;QACtB,kDAAkD;QAClD,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;CACL;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG;IACtC,2BAA2B;IAC3B,QAAQ,EAAE,CAAC,CAAC;IAEZ,kCAAkC;IAClC,QAAQ,CAAC,EAAE,WAAW,CAAC;IAEvB,oCAAoC;IACpC,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IAEvB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,4CAA4C;IAC5C,MAAM,EAAE,SAAS,CAAC;IAElB,qCAAqC;IACrC,mBAAmB,EAAE,MAAM,CAAC;IAE5B,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAElB,kCAAkC;IAClC,WAAW,EAAE,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IAEtB,2BAA2B;IAC3B,cAAc,EAAE,MAAM,CAAC;IAEvB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,iCAAiC;IACjC,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IAEtB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAE3C,+CAA+C;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,WAAW,CAAC;IAE5B,sCAAsC;IACtC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,EA0GzC,CAAC"}

package/dist/types/geo-search.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * Geospatial search types and configuration for SqlDB
+ * Enables location-based search with distance calculations, bucketing, and canonical location matching
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAJOR_CITY_BUCKETS = void 0;
+/**
+ * Pre-defined major city buckets for common use cases
+ */
+exports.MAJOR_CITY_BUCKETS = [
+    {
+        id: 'nyc',
+        name: 'New York City',
+        center: { lat: 40.7128, lng: -74.006 },
+        radius: { value: 50, unit: 'km' },
+        aliases: ['NYC', 'New York', 'Manhattan', 'Brooklyn', 'Queens', 'Bronx', 'Staten Island'],
+    },
+    {
+        id: 'la',
+        name: 'Los Angeles',
+        center: { lat: 34.0522, lng: -118.2437 },
+        radius: { value: 50, unit: 'km' },
+        aliases: ['LA', 'Los Angeles', 'Hollywood', 'Santa Monica', 'Venice'],
+    },
+    {
+        id: 'chicago',
+        name: 'Chicago',
+        center: { lat: 41.8781, lng: -87.6298 },
+        radius: { value: 40, unit: 'km' },
+        aliases: ['Chicago', 'Chi-Town', 'The Windy City'],
+    },
+    {
+        id: 'houston',
+        name: 'Houston',
+        center: { lat: 29.7604, lng: -95.3698 },
+        radius: { value: 40, unit: 'km' },
+        aliases: ['Houston', 'H-Town'],
+    },
+    {
+        id: 'phoenix',
+        name: 'Phoenix',
+        center: { lat: 33.4484, lng: -112.074 },
+        radius: { value: 40, unit: 'km' },
+        aliases: ['Phoenix', 'PHX'],
+    },
+    {
+        id: 'sf',
+        name: 'San Francisco',
+        center: { lat: 37.7749, lng: -122.4194 },
+        radius: { value: 30, unit: 'km' },
+        aliases: ['SF', 'San Francisco', 'San Fran', 'The City'],
+    },
+    {
+        id: 'seattle',
+        name: 'Seattle',
+        center: { lat: 47.6062, lng: -122.3321 },
+        radius: { value: 35, unit: 'km' },
+        aliases: ['Seattle', 'SEA'],
+    },
+    {
+        id: 'miami',
+        name: 'Miami',
+        center: { lat: 25.7617, lng: -80.1918 },
+        radius: { value: 35, unit: 'km' },
+        aliases: ['Miami', 'MIA', 'Miami Beach'],
+    },
+    {
+        id: 'boston',
+        name: 'Boston',
+        center: { lat: 42.3601, lng: -71.0589 },
+        radius: { value: 30, unit: 'km' },
+        aliases: ['Boston', 'BOS'],
+    },
+    {
+        id: 'london',
+        name: 'London',
+        center: { lat: 51.5074, lng: -0.1278 },
+        radius: { value: 50, unit: 'km' },
+        aliases: ['London', 'LDN'],
+    },
+    {
+        id: 'paris',
+        name: 'Paris',
+        center: { lat: 48.8566, lng: 2.3522 },
+        radius: { value: 40, unit: 'km' },
+        aliases: ['Paris', 'PAR'],
+    },
+    {
+        id: 'tokyo',
+        name: 'Tokyo',
+        center: { lat: 35.6762, lng: 139.6503 },
+        radius: { value: 50, unit: 'km' },
+        aliases: ['Tokyo', 'TYO'],
+    },
+    {
+        id: 'mumbai',
+        name: 'Mumbai',
+        center: { lat: 19.076, lng: 72.8777 },
+        radius: { value: 40, unit: 'km' },
+        aliases: ['Mumbai', 'Bombay', 'BOM'],
+    },
+    {
+        id: 'delhi',
+        name: 'Delhi',
+        center: { lat: 28.6139, lng: 77.209 },
+        radius: { value: 40, unit: 'km' },
+        aliases: ['Delhi', 'New Delhi', 'DEL'],
+    },
+    {
+        id: 'bangalore',
+        name: 'Bangalore',
+        center: { lat: 12.9716, lng: 77.5946 },
+        radius: { value: 35, unit: 'km' },
+        aliases: ['Bangalore', 'Bengaluru', 'BLR'],
+    },
+];
+//# sourceMappingURL=geo-search.js.map

package/dist/types/geo-search.js.map

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

package/dist/types/query.d.ts

@@ -45,6 +45,23 @@ export interface TableOperations<T = any> {
     buildSearchIndex?(): Promise<import('../types/search').IndexStats>;
     rebuildSearchIndex?(): Promise<import('../types/search').IndexStats>;
     getSearchStats?(): Promise<import('../types/search').IndexStats | null>;
+    buildGeoBuckets?(options?: {
+        targetBucketSize?: number;
+        gridSizeKm?: number;
+        minBucketSize?: number;
+    }): Promise<{
+        totalBuckets: number;
+        buckets: import('../types/geo-search').GeoBucket[];
+        avgBucketSize: number;
+    }>;
+    getGeoBuckets?(): Promise<Array<{
+        id: string;
+        center: import('../types/geo-search').GeoPoint;
+        radius: import('../types/geo-search').GeoDistance;
+        count: number;
+        locationName?: string;
+        bounds?: any;
+    }>>;
 }
 export interface QueryResult {
     sql: string;

package/dist/types/query.d.ts.map

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