@dtechph/wayfinding-core 0.1.0

package/README.md

@@ -0,0 +1,27 @@
+# `@dtechph/wayfinding-core`
+
+Core API client for the Duon Wayfinding SDK. Fetches CMS-configured malls via `GET /v1/sdk/malls` using `x-api-key`.
+
+## Install
+
+```bash
+npm install @dtechph/wayfinding-core
+```
+
+Requires GitHub Packages auth — see the [root README](../../README.md).
+
+## Usage
+
+```typescript
+import { DuonWayfinding } from "@dtechph/wayfinding-core";
+
+DuonWayfinding.initialize({
+  apiBaseUrl: "https://your-backend.example.com",
+  apiKey: "duon_sk_live_...",
+});
+
+const malls = await DuonWayfinding.fetchMalls();
+const url = DuonWayfinding.getViewerUrl(malls[0]);
+```
+
+For React Native / Expo UI components, use [`@dtechph/wayfinding-react-native`](../react-native).

package/dist/client.d.ts

@@ -0,0 +1,6 @@
+import type { DuonMall, DuonWayfindingConfig } from "./types";
+export declare const initialize: (next: DuonWayfindingConfig) => void;
+export declare const getConfig: () => DuonWayfindingConfig;
+export type FetchFn = typeof fetch;
+export declare const fetchMalls: (fetchImpl?: FetchFn) => Promise<DuonMall[]>;
+export declare const resetForTests: () => void;

package/dist/client.js

@@ -0,0 +1,63 @@
+import { DuonAuthError, DuonConfigError, DuonForbiddenError, DuonNetworkError, } from "./errors";
+import { mapApiMall } from "./mall";
+let config = null;
+const normalizeBaseUrl = (url) => url.replace(/\/$/, "");
+export const initialize = (next) => {
+    if (!next.apiBaseUrl?.trim()) {
+        throw new DuonConfigError("apiBaseUrl is required");
+    }
+    if (!next.apiKey?.trim()) {
+        throw new DuonConfigError("apiKey is required");
+    }
+    config = {
+        apiBaseUrl: normalizeBaseUrl(next.apiBaseUrl.trim()),
+        apiKey: next.apiKey.trim(),
+    };
+};
+export const getConfig = () => {
+    if (!config) {
+        throw new DuonConfigError("DuonWayfinding.initialize() must be called first");
+    }
+    return config;
+};
+export const fetchMalls = async (fetchImpl = fetch) => {
+    const { apiBaseUrl, apiKey } = getConfig();
+    const url = `${apiBaseUrl}/v1/sdk/malls`;
+    let response;
+    try {
+        response = await fetchImpl(url, {
+            method: "GET",
+            headers: {
+                Accept: "application/json",
+                "x-api-key": apiKey,
+            },
+        });
+    }
+    catch (err) {
+        throw new DuonNetworkError(err instanceof Error ? err.message : "Network request failed");
+    }
+    if (response.status === 401) {
+        throw new DuonAuthError();
+    }
+    if (response.status === 403) {
+        throw new DuonForbiddenError();
+    }
+    if (!response.ok) {
+        throw new DuonNetworkError(`Request failed with status ${response.status}`, response.status);
+    }
+    const body = (await response.json());
+    if (!body?.message || !Array.isArray(body.message)) {
+        throw new DuonNetworkError("Invalid malls response shape");
+    }
+    return body.message.map((item) => {
+        try {
+            return mapApiMall(item);
+        }
+        catch (err) {
+            throw new DuonConfigError(err instanceof Error ? err.message : "Invalid mall entry");
+        }
+    });
+};
+export const resetForTests = () => {
+    config = null;
+};

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+export declare class DuonError extends Error {
+    constructor(message: string);
+}
+export declare class DuonNetworkError extends DuonError {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+export declare class DuonAuthError extends DuonError {
+    constructor(message?: string);
+}
+export declare class DuonForbiddenError extends DuonError {
+    constructor(message?: string);
+}
+export declare class DuonConfigError extends DuonError {
+    constructor(message: string);
+}

package/dist/errors.js

@@ -0,0 +1,31 @@
+export class DuonError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "DuonError";
+    }
+}
+export class DuonNetworkError extends DuonError {
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = "DuonNetworkError";
+    }
+}
+export class DuonAuthError extends DuonError {
+    constructor(message = "Invalid or missing API key") {
+        super(message);
+        this.name = "DuonAuthError";
+    }
+}
+export class DuonForbiddenError extends DuonError {
+    constructor(message = "Insufficient scope") {
+        super(message);
+        this.name = "DuonForbiddenError";
+    }
+}
+export class DuonConfigError extends DuonError {
+    constructor(message) {
+        super(message);
+        this.name = "DuonConfigError";
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { fetchMalls, getConfig, initialize, resetForTests } from "./client";
+import { getViewerUrl } from "./mall";
+export { initialize, fetchMalls, getConfig, resetForTests, getViewerUrl };
+export type { DuonMall, DuonWayfindingConfig, MallMapType } from "./types";
+export { DuonError, DuonAuthError, DuonConfigError, DuonForbiddenError, DuonNetworkError, } from "./errors";
+export declare const DuonWayfinding: {
+    initialize: (next: import("./types").DuonWayfindingConfig) => void;
+    fetchMalls: (fetchImpl?: import("./client").FetchFn) => Promise<import("./types").DuonMall[]>;
+    getViewerUrl: (mall: import("./types").DuonMall) => string;
+};

package/dist/index.js

@@ -0,0 +1,9 @@
+import { fetchMalls, getConfig, initialize, resetForTests } from "./client";
+import { getViewerUrl } from "./mall";
+export { initialize, fetchMalls, getConfig, resetForTests, getViewerUrl };
+export { DuonError, DuonAuthError, DuonConfigError, DuonForbiddenError, DuonNetworkError, } from "./errors";
+export const DuonWayfinding = {
+    initialize,
+    fetchMalls,
+    getViewerUrl,
+};

package/dist/mall.d.ts

@@ -0,0 +1,4 @@
+import type { DuonMall, MallMapType, MallsApiResponse } from "./types";
+export declare const parseMapType: (value: string | undefined) => MallMapType;
+export declare const mapApiMall: (raw: MallsApiResponse["message"][number]) => DuonMall;
+export declare const getViewerUrl: (mall: DuonMall) => string;

package/dist/mall.js

@@ -0,0 +1,17 @@
+export const parseMapType = (value) => value === "kiosk" ? "kiosk" : "situm";
+export const mapApiMall = (raw) => {
+    const viewerUrl = raw.viewer_url ?? raw.map_embed_url ?? "";
+    if (!viewerUrl) {
+        throw new Error(`Mall "${raw.name}" is missing viewer_url`);
+    }
+    return {
+        buildingId: String(raw.building_id),
+        name: raw.name,
+        mapType: parseMapType(raw.map_type),
+        viewerUrl,
+        mapEmbedUrl: raw.map_embed_url,
+        latitude: raw.latitude,
+        longitude: raw.longitude,
+    };
+};
+export const getViewerUrl = (mall) => mall.viewerUrl;

package/dist/types.d.ts

@@ -0,0 +1,26 @@
+export type MallMapType = "situm" | "kiosk";
+export interface DuonMall {
+    buildingId: string;
+    name: string;
+    mapType: MallMapType;
+    viewerUrl: string;
+    mapEmbedUrl?: string;
+    latitude?: number;
+    longitude?: number;
+}
+export interface DuonWayfindingConfig {
+    apiBaseUrl: string;
+    apiKey: string;
+}
+export interface MallsApiResponse {
+    status: number;
+    message: Array<{
+        building_id: string;
+        name: string;
+        map_type: string;
+        viewer_url?: string;
+        map_embed_url?: string;
+        latitude?: number;
+        longitude?: number;
+    }>;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@dtechph/wayfinding-core",
+  "version": "0.1.0",
+  "description": "Duon Wayfinding SDK — core API client for CMS-driven mall maps",
+  "license": "UNLICENSED",
+  "author": "dtechph",
+  "homepage": "https://github.com/dtechph/DuonSDK/tree/main/packages/core#readme",
+  "bugs": {
+    "url": "https://github.com/dtechph/DuonSDK/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dtechph/DuonSDK.git",
+    "directory": "packages/core"
+  },
+  "keywords": [
+    "duon",
+    "wayfinding",
+    "indoor-maps",
+    "situm",
+    "sdk"
+  ],
+  "sideEffects": false,
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.2",
+    "vitest": "^3.2.4"
+  }
+}