@wemap/core 14.6.0-beta.0 → 14.6.0-beta.2

package/dist/src/CoreConfig.d.ts

@@ -1,4 +1,5 @@
 import { BoundingBox } from '../../geo';
+import { PinpointManager } from './services/PinpointManager';
 import { SnippetParser } from './helpers/SnippetParser';
 import { Building } from './types/indoor';
 /**
@@ -143,6 +144,20 @@ export declare class CoreConfig {
      * @returns A `(bbox) => Promise<Building[]>` bound to this livemap.
      */
     createBuildingProvider(): (bbox: BoundingBox) => Promise<Building[]>;
+    /**
+     * Build a pinpoint manager bound to the initialized livemap.
+     *
+     * ```typescript
+     * await core.init({ emmid, token });
+     * const pinpoints = core.createPinpointManager();
+     * const { items } = await pinpoints.search({
+     *   query: 'café',
+     *   ...boundsToDelta(map.getBounds()),
+     *   level: map.getLevel() ?? undefined,
+     * });
+     * ```
+     */
+    createPinpointManager(): PinpointManager;
 }
 /**
  * Default instance of CoreConfig for convenience

package/dist/src/CoreConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoreConfig.d.ts","sourceRoot":"","sources":["../../src/CoreConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,GAAG,CAAC,EAAE,YAAY,GAAG,aAAa,CAAC;CACpC;AAED,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAEtD,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAU;IAChC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,GAAG,CAA8C;IAGzD;;;;OAIG;;IAKH,OAAO,CAAC,UAAU;IAIlB;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBnD;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,SAAS,IAAI,OAAO;IAI3B;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,gBAAgB,IAAI,aAAa;IAUxC,MAAM,CAAC,aAAa;;;;;;;;;;;;;;IAmBpB;;;;;;;;;;;;;;;OAeG;IACH,sBAAsB,IAAI,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;CAKrE;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,IAAI,YAAmB,CAAC"}
+{"version":3,"file":"CoreConfig.d.ts","sourceRoot":"","sources":["../../src/CoreConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,GAAG,CAAC,EAAE,YAAY,GAAG,aAAa,CAAC;CACpC;AAED,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAEtD,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAU;IAChC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,GAAG,CAA8C;IAGzD;;;;OAIG;;IAKH,OAAO,CAAC,UAAU;IAIlB;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBnD;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,SAAS,IAAI,OAAO;IAI3B;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,gBAAgB,IAAI,aAAa;IAUxC,MAAM,CAAC,aAAa;;;;;;;;;;;;;;IAmBpB;;;;;;;;;;;;;;;OAeG;IACH,sBAAsB,IAAI,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;IAMpE;;;;;;;;;;;;OAYG;IACH,qBAAqB,IAAI,eAAe;CAGzC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,IAAI,YAAmB,CAAC"}

package/dist/src/services/PinpointCache.d.ts

@@ -0,0 +1,35 @@
+import { BoundingBox } from '../../../geo';
+import { Pinpoint, PinpointSearchQuery } from '../types/pinpoint';
+/**
+ * In-memory pinpoint store with expanded-bbox viewport preload.
+ * One instance per livemap; shared by search and map click resolution.
+ *
+ * @internal Used by {@link PinpointManager} and `@wemap/map`.
+ */
+export declare class PinpointCache {
+    /** Minimum bbox size (meters) the cache is expanded to, to limit API calls. */
+    static MIN_BBOX_SIZE: number;
+    private static PAGE_SIZE;
+    private static instances;
+    private static refCounts;
+    private readonly service;
+    private readonly pinpoints;
+    private cachedBboxByLevel;
+    private constructor();
+    static forLivemap(baseUrl: string, emmid: string | number): PinpointCache;
+    /** Drop the shared cache when the last {@link PinpointManager} is released. */
+    static release(baseUrl: string, emmid: string | number): void;
+    upsert(items: readonly Pinpoint[]): void;
+    search(query: PinpointSearchQuery): Promise<import('../..').PinpointSearchResponse>;
+    getAll(): Promise<Pinpoint[]>;
+    getCachedById(id: number): Pinpoint | undefined;
+    getLoaded(): Pinpoint[];
+    getCachedBbox(): BoundingBox | null;
+    getById(id: number): Promise<Pinpoint | null>;
+    /**
+     * Preload pinpoints for the viewport when it leaves the cached area.
+     * Multi-page fetch within an expanded bbox; invisible to integrators.
+     */
+    preloadViewport(bbox: BoundingBox, level?: number | null): Promise<void>;
+}
+//# sourceMappingURL=PinpointCache.d.ts.map

package/dist/src/services/PinpointCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PinpointCache.d.ts","sourceRoot":"","sources":["../../../src/services/PinpointCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGvE;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,+EAA+E;IAC/E,MAAM,CAAC,aAAa,SAAQ;IAC5B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAO;IAE/B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAoC;IAC5D,OAAO,CAAC,MAAM,CAAC,SAAS,CAA6B;IAErD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,OAAO,CAAC,iBAAiB,CAAyC;IAElE,OAAO;IAIP,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa;IAazE,+EAA+E;IAC/E,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAY7D,MAAM,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,IAAI;IAMxC,MAAM,CAAC,KAAK,EAAE,mBAAmB;IAI3B,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAOnC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAI/C,SAAS,IAAI,QAAQ,EAAE;IAIvB,aAAa,IAAI,WAAW,GAAG,IAAI;IAU7B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAiBnD;;;OAGG;IACG,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAyC/E"}

package/dist/src/services/PinpointManager.d.ts

@@ -0,0 +1,28 @@
+import { BoundingBox } from '../../../geo';
+import { Pinpoint, PinpointResolver, PinpointSearchQuery, PinpointSearchResponse } from '../types/pinpoint';
+/**
+ * Public façade for pinpoint retrieval/search operations bound to a livemap.
+ *
+ * Internally uses the shared pinpoint store so map preload, click resolution,
+ * and integrator searches all benefit from the same data.
+ */
+export declare class PinpointManager implements PinpointResolver {
+    private readonly cache;
+    private readonly baseUrl;
+    private readonly emmid;
+    constructor(baseUrl: string, emmid: string | number);
+    search(query: PinpointSearchQuery): Promise<PinpointSearchResponse>;
+    /**
+     * Fetch all pinpoints of the current livemap from API (paginated, no bounds).
+     */
+    getAll(): Promise<Pinpoint[]>;
+    getById(id: number): Promise<Pinpoint | null>;
+    preloadViewport(bbox: BoundingBox, level?: number | null): Promise<void>;
+    /** Already loaded pinpoints (search + preload + click fallback). */
+    getLoadedPinpoints(): Pinpoint[];
+    /** Cached preload bbox, or null when no preload happened yet. */
+    getCachedBbox(): BoundingBox | null;
+    /** Release the shared cache when this manager is no longer needed. */
+    release(): void;
+}
+//# sourceMappingURL=PinpointManager.d.ts.map

package/dist/src/services/PinpointManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PinpointManager.d.ts","sourceRoot":"","sources":["../../../src/services/PinpointManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAG3B;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;gBAE5B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAM7C,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAOzE;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAI7B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAI7C,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxE,oEAAoE;IACpE,kBAAkB,IAAI,QAAQ,EAAE;IAIhC,iEAAiE;IACjE,aAAa,IAAI,WAAW,GAAG,IAAI;IAInC,sEAAsE;IACtE,OAAO,IAAI,IAAI;CAGhB"}

package/dist/src/services/PinpointService.d.ts

@@ -0,0 +1,20 @@
+import { Pinpoint, PinpointSearchQuery, PinpointSearchResponse } from '../types/pinpoint';
+/**
+ * Fetches pinpoints from the Wemap API. Internal — use
+ * {@link CoreConfig.createPinpointManager} instead.
+ */
+export declare class PinpointService {
+    private static PAGE_SIZE;
+    private readonly http;
+    private readonly emmid;
+    constructor(baseUrl: string, emmid: string | number);
+    search(query: PinpointSearchQuery): Promise<PinpointSearchResponse>;
+    getById(id: number): Promise<Pinpoint>;
+    /**
+     * Fetch all pinpoints of the current livemap (paginated), without bounds.
+     */
+    getAll(): Promise<Pinpoint[]>;
+    /** @internal Exported for unit tests. */
+    buildSearchParams(query: PinpointSearchQuery): Record<string, string | number>;
+}
+//# sourceMappingURL=PinpointService.d.ts.map

package/dist/src/services/PinpointService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PinpointService.d.ts","sourceRoot":"","sources":["../../../src/services/PinpointService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAuB3B;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAO;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAK7C,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAenE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAM5C;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAsBnC,yCAAyC;IACzC,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CAkC/E"}

package/dist/src/types/pinpoint.d.ts

@@ -0,0 +1,49 @@
+/** Minimal read model for a Wemap pinpoint (not a full livemap `PinpointObject` port). */
+export interface Pinpoint {
+    id: number;
+    name: string;
+    description?: string;
+    latitude: number;
+    longitude: number;
+    level?: number | null;
+    altitude?: number | null;
+    tags?: string[];
+    category?: number;
+    image_url?: string;
+    address?: string;
+}
+/** Bounds params returned by {@link boundsToDelta}. */
+export interface PinpointBoundsParams {
+    center_latitude: number;
+    center_longitude: number;
+    latitude_delta: number;
+    longitude_delta: number;
+}
+/** Query for {@link CoreConfig.createPinpointManager}. Bounds are required. */
+export interface PinpointSearchQuery extends PinpointBoundsParams {
+    query?: string;
+    tags?: string | string[];
+    level?: number;
+    levels?: string;
+    limit?: number;
+    offset?: number;
+}
+/** Single-page pinpoint search response. */
+export interface PinpointSearchResponse {
+    count: number;
+    items: Pinpoint[];
+    next: string | null;
+    previous: string | null;
+    query: Record<string, unknown>;
+}
+/**
+ * Viewport preload and click resolution surface used by `@wemap/map`.
+ *
+ * @internal
+ */
+export interface PinpointResolver {
+    getById(id: number): Promise<Pinpoint | null>;
+    getLoadedPinpoints(): Pinpoint[];
+    preloadViewport(bounds: import('../../../geo').BoundingBox, level?: number | null): Promise<void>;
+}
+//# sourceMappingURL=pinpoint.d.ts.map

package/dist/src/types/pinpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinpoint.d.ts","sourceRoot":"","sources":["../../../src/types/pinpoint.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,uDAAuD;AACvD,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,+EAA+E;AAC/E,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,4CAA4C;AAC5C,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC9C,kBAAkB,IAAI,QAAQ,EAAE,CAAC;IACjC,eAAe,CACb,MAAM,EAAE,OAAO,YAAY,EAAE,WAAW,EACxC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wemap/core",
-  "version": "14.6.0-beta.0",
+  "version": "14.6.0-beta.2",
   "type": "module",
   "private": false,
   "publishConfig": {
@@ -18,7 +18,7 @@
     "dist"
   ],
   "dependencies": {
-    "@wemap/geo": "14.6.0-beta.0",
+    "@wemap/geo": "14.6.0-beta.2",
     "@types/geojson": "^7946.0.16"
   }
 }