@vasanthcambium/marketplace-auth 0.1.0

package/README.md

@@ -0,0 +1,84 @@
+# @cmbmwifi/marketplace-auth
+
+Auth library for [MarketApps Platform](https://developers.apps.cloud.cambiumnetworks.com/api/docs) apps. One install gives you the BFF helper, browser fetch wrapper, and React hooks.
+
+```bash
+npm install @cmbmwifi/marketplace-auth
+```
+
+## Three subpath exports, one package
+
+```ts
+// In your BFF (Node)
+import { createApp, expressMiddleware } from '@cmbmwifi/marketplace-auth/server';
+
+// In your SPA (Browser, no React)
+import { createBridge } from '@cmbmwifi/marketplace-auth/browser';
+
+// In your SPA (React)
+import { AppProvider, useNBI } from '@cmbmwifi/marketplace-auth/react';
+```
+
+The browser bundle never imports server code; the server bundle never imports DOM-only code. Tree-shaking is automatic.
+
+## Server (BFF)
+
+```ts
+import express from 'express';
+import { createApp, expressMiddleware } from '@cmbmwifi/marketplace-auth/server';
+
+const cn = createApp({
+  appId: 'my-app',
+  region: 'us-east-1',
+  authServiceUrl: 'https://auth.cloud.cambiumnetworks.com',
+  appCredentials: {
+    clientId:     process.env.CN_APP_CLIENT_ID!,
+    clientSecret: process.env.CN_APP_CLIENT_SECRET!,
+  },
+});
+
+const server = express();
+server.use(expressMiddleware(cn));   // installs /launch + /api/* + /healthz + /logout
+server.listen(5174);
+```
+
+Hono adapter: `import { honoMiddleware } from '@cmbmwifi/marketplace-auth/server'`.
+
+## Browser
+
+```ts
+import { createBridge } from '@cmbmwifi/marketplace-auth/browser';
+
+const cn = createBridge({ baseUrl: '/' });
+
+interface DeviceList { devices: { id: string; name: string }[] }
+
+const data = await cn.fetch<DeviceList>('/api/v2/devices');
+```
+
+## React
+
+```tsx
+import { AppProvider, useNBI } from '@cmbmwifi/marketplace-auth/react';
+
+function Devices() {
+  const { data, error, isLoading } = useNBI<DeviceList>('/api/v2/devices');
+  if (isLoading) return <Spinner />;
+  if (error)     return <ErrorBanner error={error} />;
+  return <DeviceTable rows={data!.devices} />;
+}
+
+export default function App() {
+  return (
+    <AppProvider config={{ baseUrl: '/' }}>
+      <Devices />
+    </AppProvider>
+  );
+}
+```
+
+Full documentation: [https://developers.apps.cloud.cambiumnetworks.com/api/docs/reference/sdk](https://developers.apps.cloud.cambiumnetworks.com/api/docs/reference/sdk)
+
+## License
+
+Apache-2.0 © Cambium Networks, Ltd.

package/dist/browser/client.d.ts

@@ -0,0 +1,3 @@
+import type { Bridge, BridgeConfig } from './types.js';
+export declare function createBridge(config?: BridgeConfig): Bridge;
+//# sourceMappingURL=client.d.ts.map

package/dist/browser/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/browser/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAEnE,wBAAgB,YAAY,CAAC,MAAM,GAAE,YAAiB,GAAG,MAAM,CAkE9D"}

package/dist/browser/client.js

@@ -0,0 +1,74 @@
+import { BridgeHttpError, SessionExpiredError } from '../shared/errors.js';
+export function createBridge(config = {}) {
+    const baseUrl = (config.baseUrl ?? '/').replace(/\/$/, '');
+    const refreshOn401 = config.refreshOn401 ?? true;
+    const retryDelayMs = config.retryDelayMs ?? 250;
+    const expiredCbs = new Set();
+    let cachedSession = null;
+    void warmSession();
+    async function warmSession() {
+        try {
+            const res = await fetch(`${baseUrl}/api/v2/me`, { credentials: 'same-origin' });
+            if (res.ok)
+                cachedSession = await res.json().catch(() => null);
+        }
+        catch { /* swallow */ }
+    }
+    async function rawFetch(input, init) {
+        const url = typeof input === 'string' ? `${baseUrl}${input}` : input;
+        const headers = {};
+        // Headers is iterable as [name, value] pairs.
+        new Headers(init?.headers).forEach((v, k) => { headers[k] = v; });
+        if (init?.body && !(init.body instanceof FormData) && !headers['content-type']) {
+            headers['content-type'] = 'application/json';
+        }
+        return fetch(url, {
+            ...init,
+            headers,
+            credentials: init?.credentials ?? 'same-origin',
+        });
+    }
+    return {
+        async fetch(input, init) {
+            let res = await rawFetch(input, init);
+            const method = (init?.method ?? 'GET').toUpperCase();
+            const isIdempotent = ['GET', 'HEAD', 'OPTIONS', 'PUT', 'DELETE'].includes(method);
+            if (res.status === 401 && refreshOn401 && isIdempotent) {
+                await delay(retryDelayMs);
+                res = await rawFetch(input, init);
+            }
+            if (res.status === 401) {
+                expiredCbs.forEach((cb) => { try {
+                    cb();
+                }
+                catch { /* ignore */ } });
+                throw new SessionExpiredError();
+            }
+            if (!res.ok) {
+                let body;
+                try {
+                    body = await res.clone().json();
+                }
+                catch {
+                    body = await res.text();
+                }
+                throw new BridgeHttpError(res.status, res.statusText, body);
+            }
+            if (init?.parseJson === false)
+                return res;
+            const ct = res.headers.get('content-type') ?? '';
+            if (!ct.includes('json'))
+                return res;
+            return res.json();
+        },
+        session() { return cachedSession; },
+        onSessionExpired(cb) {
+            expiredCbs.add(cb);
+            return () => expiredCbs.delete(cb);
+        },
+    };
+}
+function delay(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=client.js.map

package/dist/browser/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/browser/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI3E,MAAM,UAAU,YAAY,CAAC,SAAuB,EAAE;IACpD,MAAM,OAAO,GAAS,CAAC,MAAM,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACjE,MAAM,YAAY,GAAI,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC;IAClD,MAAM,YAAY,GAAI,MAAM,CAAC,YAAY,IAAI,GAAG,CAAC;IACjD,MAAM,UAAU,GAAM,IAAI,GAAG,EAAc,CAAC;IAC5C,IAAI,aAAa,GAAmB,IAAI,CAAC;IAEzC,KAAK,WAAW,EAAE,CAAC;IAEnB,KAAK,UAAU,WAAW;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,YAAY,EAAE,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;YAChF,IAAI,GAAG,CAAC,EAAE;gBAAE,aAAa,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACjE,CAAC;QAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,UAAU,QAAQ,CAAC,KAAmB,EAAE,IAA4B;QACvE,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACrE,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,8CAA8C;QAC9C,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,IAAI,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,YAAY,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YAC/E,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAC/C,CAAC;QACD,OAAO,KAAK,CAAC,GAAG,EAAE;YAChB,GAAG,IAAI;YACP,OAAO;YACP,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,aAAa;SAChD,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,KAAK,CAAC,KAAK,CAAc,KAAmB,EAAE,IAAiB;YAC7D,IAAI,GAAG,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAEtC,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YACrD,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAClF,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,YAAY,IAAI,YAAY,EAAE,CAAC;gBACvD,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;gBAC1B,GAAG,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACpC,CAAC;YAED,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACvB,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC;oBAAC,EAAE,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrE,MAAM,IAAI,mBAAmB,EAAE,CAAC;YAClC,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,IAAI,IAAa,CAAC;gBAClB,IAAI,CAAC;oBAAC,IAAI,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC;oBAAC,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAAC,CAAC;gBAC3E,MAAM,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC9D,CAAC;YAED,IAAI,IAAI,EAAE,SAAS,KAAK,KAAK;gBAAE,OAAO,GAAmB,CAAC;YAC1D,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;YACjD,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,OAAO,GAAmB,CAAC;YACrD,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;QAClC,CAAC;QAED,OAAO,KAAK,OAAO,aAAa,CAAC,CAAC,CAAC;QAEnC,gBAAgB,CAAC,EAAE;YACjB,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnB,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/browser/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @cmbmwifi/marketplace-auth/browser — Browser fetch wrapper.
+ *
+ *   import { createBridge } from '@cmbmwifi/marketplace-auth/browser';
+ *
+ * Talks to your BFF same-origin. Never directly to the cnMaestro NBI.
+ */
+export { createBridge } from './client.js';
+export type { Bridge, BridgeConfig, BridgeInit } from './types.js';
+export type { Session } from '../shared/types.js';
+export { BridgeHttpError, SessionExpiredError } from '../shared/errors.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACnE,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/browser/index.js

@@ -0,0 +1,10 @@
+/**
+ * @cmbmwifi/marketplace-auth/browser — Browser fetch wrapper.
+ *
+ *   import { createBridge } from '@cmbmwifi/marketplace-auth/browser';
+ *
+ * Talks to your BFF same-origin. Never directly to the cnMaestro NBI.
+ */
+export { createBridge } from './client.js';
+export { BridgeHttpError, SessionExpiredError } from '../shared/errors.js';
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/browser/types.d.ts

@@ -0,0 +1,19 @@
+import type { Session } from '../shared/types.js';
+export interface BridgeConfig {
+    /** Base URL for the BFF. Default '/'. */
+    baseUrl?: string;
+    /** Retry once on 401 after a delay (the BFF will refresh transparently). Default true. */
+    refreshOn401?: boolean;
+    /** Delay before the retry, in ms. Default 250. */
+    retryDelayMs?: number;
+}
+export interface BridgeInit extends RequestInit {
+    /** Parse the response as JSON. Default true. */
+    parseJson?: boolean;
+}
+export interface Bridge {
+    fetch<T = unknown>(input: string | URL, init?: BridgeInit): Promise<T>;
+    session(): Session | null;
+    onSessionExpired(cb: () => void): () => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/browser/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0FAA0F;IAC1F,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvE,OAAO,IAAI,OAAO,GAAG,IAAI,CAAC;IAC1B,gBAAgB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC9C"}

package/dist/browser/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/browser/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/browser/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @cmbmwifi/marketplace-auth — root barrel.
+ *
+ * Most consumers import from a specific subpath instead so they get only the
+ * code they need (and the type system enforces the right environment):
+ *
+ *   import { createApp } from '@cmbmwifi/marketplace-auth/server';
+ *   import { createBridge } from '@cmbmwifi/marketplace-auth/browser';
+ *   import { AppProvider, useNBI } from '@cmbmwifi/marketplace-auth/react';
+ *
+ * The root export here re-exports only the SHARED public types so both halves
+ * can talk about the same Session, ApiRoute, etc.
+ */
+export type { ApiRoute, Permission, Region, Session, UserRole, } from './shared/types.js';
+export { AuthError, NonceVerificationError, TokenExchangeError, SessionNotFoundError, UpstreamError, BridgeHttpError, SessionExpiredError, } from './shared/errors.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;;;;;;;;;;;;GAYG;AACH,YAAY,EACV,QAAQ,EACR,UAAU,EACV,MAAM,EACN,OAAO,EACP,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { AuthError, NonceVerificationError, TokenExchangeError, SessionNotFoundError, UpstreamError, BridgeHttpError, SessionExpiredError, } from './shared/errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqBA,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}

package/dist/react/AppProvider.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from 'react';
+import type { Bridge, BridgeConfig } from '../browser/types.js';
+export interface AppProviderProps {
+    config: BridgeConfig;
+    children: ReactNode;
+}
+export declare function AppProvider({ config, children }: AppProviderProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function useBridge(): Bridge;
+//# sourceMappingURL=AppProvider.d.ts.map

package/dist/react/AppProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppProvider.d.ts","sourceRoot":"","sources":["../../src/react/AppProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA2D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEhG,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIhE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,gBAAgB,kDA0BjE;AAED,wBAAgB,SAAS,IAAI,MAAM,CAIlC"}

package/dist/react/AppProvider.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useMemo, useState } from 'react';
+import { createBridge } from '../browser/client.js';
+const BridgeCtx = createContext(null);
+export function AppProvider({ config, children }) {
+    const bridge = useMemo(() => createBridge(config), []); // eslint-disable-line react-hooks/exhaustive-deps
+    const [launched, setLaunched] = useState(false);
+    useEffect(() => {
+        const url = new URL(window.location.href);
+        const token = url.searchParams.get('token') ?? url.searchParams.get('nonce');
+        if (!token) {
+            setLaunched(true);
+            return;
+        }
+        void fetch(`${(config.baseUrl ?? '/').replace(/\/$/, '')}/launch?token=${encodeURIComponent(token)}`, {
+            credentials: 'same-origin',
+            redirect: 'follow',
+        })
+            .then(() => {
+            url.searchParams.delete('token');
+            url.searchParams.delete('nonce');
+            window.history.replaceState({}, '', url.toString());
+        })
+            .finally(() => setLaunched(true));
+    }, [config.baseUrl]);
+    if (!launched)
+        return null;
+    return _jsx(BridgeCtx.Provider, { value: bridge, children: children });
+}
+export function useBridge() {
+    const v = useContext(BridgeCtx);
+    if (!v)
+        throw new Error('useBridge must be called inside <AppProvider>');
+    return v;
+}
+//# sourceMappingURL=AppProvider.js.map

package/dist/react/AppProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppProvider.js","sourceRoot":"","sources":["../../src/react/AppProvider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,MAAM,SAAS,GAAG,aAAa,CAAgB,IAAI,CAAC,CAAC;AAOrD,MAAM,UAAU,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAoB;IAChE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,kDAAkD;IAC1G,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEhD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7E,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QACD,KAAK,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE;YACpG,WAAW,EAAE,aAAa;YAC1B,QAAQ,EAAE,QAAQ;SACnB,CAAC;aACC,IAAI,CAAC,GAAG,EAAE;YACT,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACjC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACjC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAErB,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,OAAO,KAAC,SAAS,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM,YAAG,QAAQ,GAAsB,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IAChC,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACzE,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @cmbmwifi/marketplace-auth/react — React hooks layered on the browser fetch wrapper.
+ *
+ *   import { AppProvider, useNBI } from '@cmbmwifi/marketplace-auth/react';
+ */
+export { AppProvider, useBridge } from './AppProvider.js';
+export { useSession } from './useSession.js';
+export { useNBI } from './useNBI.js';
+export { useNBIMutation } from './useNBIMutation.js';
+export { useAccount, useUser } from './useAccount.js';
+export type { AppProviderProps } from './AppProvider.js';
+export { BridgeHttpError, SessionExpiredError } from '../shared/errors.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEtD,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,12 @@
+/**
+ * @cmbmwifi/marketplace-auth/react — React hooks layered on the browser fetch wrapper.
+ *
+ *   import { AppProvider, useNBI } from '@cmbmwifi/marketplace-auth/react';
+ */
+export { AppProvider, useBridge } from './AppProvider.js';
+export { useSession } from './useSession.js';
+export { useNBI } from './useNBI.js';
+export { useNBIMutation } from './useNBIMutation.js';
+export { useAccount, useUser } from './useAccount.js';
+export { BridgeHttpError, SessionExpiredError } from '../shared/errors.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/react/useAccount.d.ts

@@ -0,0 +1,9 @@
+export declare function useAccount(): {
+    cambiumId: string | null;
+    accountName: string | null;
+};
+export declare function useUser(): {
+    email: string | null;
+    role: string | null;
+};
+//# sourceMappingURL=useAccount.d.ts.map

package/dist/react/useAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAccount.d.ts","sourceRoot":"","sources":["../../src/react/useAccount.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,IAAI;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAMrF;AAED,wBAAgB,OAAO,IAAI;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAMvE"}

package/dist/react/useAccount.js

@@ -0,0 +1,16 @@
+import { useSession } from './useSession.js';
+export function useAccount() {
+    const { session } = useSession();
+    return {
+        cambiumId: session?.accountCid ?? null,
+        accountName: null, // Reserved for v0.2 once /healthz exposes it.
+    };
+}
+export function useUser() {
+    const { session } = useSession();
+    return {
+        email: null, // Reserved for v0.2.
+        role: session?.userRole ?? null,
+    };
+}
+//# sourceMappingURL=useAccount.js.map

package/dist/react/useAccount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAccount.js","sourceRoot":"","sources":["../../src/react/useAccount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,UAAU,UAAU;IACxB,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC;IACjC,OAAO;QACL,SAAS,EAAI,OAAO,EAAE,UAAU,IAAI,IAAI;QACxC,WAAW,EAAE,IAAI,EAAa,8CAA8C;KAC7E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC;IACjC,OAAO;QACL,KAAK,EAAE,IAAI,EAAmB,qBAAqB;QACnD,IAAI,EAAG,OAAO,EAAE,QAAQ,IAAI,IAAI;KACjC,CAAC;AACJ,CAAC"}

package/dist/react/useNBI.d.ts

@@ -0,0 +1,10 @@
+import { type SWRConfiguration, type SWRResponse } from 'swr';
+export interface UseNBIResult<T> extends SWRResponse<T, Error> {
+    isLoading: boolean;
+}
+/**
+ * Read from the cnMaestro NBI through your BFF. SWR-backed.
+ * Pass `null` as the path to skip the fetch.
+ */
+export declare function useNBI<T = unknown>(path: string | null, options?: SWRConfiguration<T, Error>): UseNBIResult<T>;
+//# sourceMappingURL=useNBI.d.ts.map

package/dist/react/useNBI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNBI.d.ts","sourceRoot":"","sources":["../../src/react/useNBI.ts"],"names":[],"mappings":"AAAA,OAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAGtE,MAAM,WAAW,YAAY,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC;IAC5D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,GAAG,OAAO,EAChC,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,EAAE,KAAK,CAAC,GACnC,YAAY,CAAC,CAAC,CAAC,CAWjB"}

package/dist/react/useNBI.js

@@ -0,0 +1,15 @@
+import useSWR from 'swr';
+import { useBridge } from './AppProvider.js';
+/**
+ * Read from the cnMaestro NBI through your BFF. SWR-backed.
+ * Pass `null` as the path to skip the fetch.
+ */
+export function useNBI(path, options) {
+    const bridge = useBridge();
+    const swr = useSWR(path, (key) => bridge.fetch(key), options);
+    return {
+        ...swr,
+        isLoading: !swr.data && !swr.error && path !== null,
+    };
+}
+//# sourceMappingURL=useNBI.js.map

package/dist/react/useNBI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNBI.js","sourceRoot":"","sources":["../../src/react/useNBI.ts"],"names":[],"mappings":"AAAA,OAAO,MAAmD,MAAM,KAAK,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAM7C;;;GAGG;AACH,MAAM,UAAU,MAAM,CACpB,IAAmB,EACnB,OAAoC;IAEpC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,MAAM,CAChB,IAAI,EACJ,CAAC,GAAW,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAI,GAAG,CAAC,EACrC,OAAO,CACR,CAAC;IACF,OAAO;QACL,GAAG,GAAG;QACN,SAAS,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,KAAK,IAAI;KACpD,CAAC;AACJ,CAAC"}

package/dist/react/useNBIMutation.d.ts

@@ -0,0 +1,15 @@
+type Method = 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export interface UseNBIMutationResult<TResponse, TBody> {
+    trigger: (body?: TBody) => Promise<TResponse>;
+    isPending: boolean;
+    error: Error | null;
+    reset: () => void;
+}
+export interface UseNBIMutationOptions<TResponse> {
+    onMutate?: () => Promise<void> | void;
+    onSuccess?: (data: TResponse) => Promise<void> | void;
+    onError?: (err: Error) => Promise<void> | void;
+}
+export declare function useNBIMutation<TResponse = unknown, TBody = unknown>(path: string, method?: Method, options?: UseNBIMutationOptions<TResponse>): UseNBIMutationResult<TResponse, TBody>;
+export {};
+//# sourceMappingURL=useNBIMutation.d.ts.map

package/dist/react/useNBIMutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNBIMutation.d.ts","sourceRoot":"","sources":["../../src/react/useNBIMutation.ts"],"names":[],"mappings":"AAGA,KAAK,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,oBAAoB,CAAC,SAAS,EAAE,KAAK;IACpD,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB,CAAC,SAAS;IAC9C,QAAQ,CAAC,EAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,OAAO,CAAC,EAAI,CAAC,GAAG,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClD;AAED,wBAAgB,cAAc,CAAC,SAAS,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EACjE,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAe,EACvB,OAAO,GAAE,qBAAqB,CAAC,SAAS,CAAM,GAC7C,oBAAoB,CAAC,SAAS,EAAE,KAAK,CAAC,CA6BxC"}

package/dist/react/useNBIMutation.js

@@ -0,0 +1,31 @@
+import { useCallback, useState } from 'react';
+import { useBridge } from './AppProvider.js';
+export function useNBIMutation(path, method = 'POST', options = {}) {
+    const bridge = useBridge();
+    const [isPending, setIsPending] = useState(false);
+    const [error, setError] = useState(null);
+    const trigger = useCallback(async (body) => {
+        setIsPending(true);
+        setError(null);
+        try {
+            await options.onMutate?.();
+            const init = { method };
+            if (body != null)
+                init.body = JSON.stringify(body);
+            const data = await bridge.fetch(path, init);
+            await options.onSuccess?.(data);
+            return data;
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            await options.onError?.(e);
+            throw e;
+        }
+        finally {
+            setIsPending(false);
+        }
+    }, [bridge, path, method, options]);
+    return { trigger, isPending, error, reset: () => setError(null) };
+}
+//# sourceMappingURL=useNBIMutation.js.map

package/dist/react/useNBIMutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNBIMutation.js","sourceRoot":"","sources":["../../src/react/useNBIMutation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAiB7C,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,SAAiB,MAAM,EACvB,UAA4C,EAAE;IAE9C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,EAAK,QAAQ,CAAC,GAAM,QAAQ,CAAe,IAAI,CAAC,CAAC;IAE7D,MAAM,OAAO,GAAG,WAAW,CACzB,KAAK,EAAE,IAAY,EAAsB,EAAE;QACzC,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAsC,EAAE,MAAM,EAAE,CAAC;YAC3D,IAAI,IAAI,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,CAAY,IAAI,EAAE,IAAI,CAAC,CAAC;YACvD,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9D,QAAQ,CAAC,CAAC,CAAC,CAAC;YACZ,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,CAAC,CAAC;QACV,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,EACD,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAChC,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;AACpE,CAAC"}

package/dist/react/useSession.d.ts

@@ -0,0 +1,8 @@
+import type { Session } from '../shared/types.js';
+export interface UseSessionResult {
+    session: Session | null;
+    isReady: boolean;
+    error: Error | null;
+}
+export declare function useSession(): UseSessionResult;
+//# sourceMappingURL=useSession.d.ts.map

package/dist/react/useSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSession.d.ts","sourceRoot":"","sources":["../../src/react/useSession.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGlD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,wBAAgB,UAAU,IAAI,gBAAgB,CAmB7C"}

package/dist/react/useSession.js

@@ -0,0 +1,22 @@
+import { useEffect, useState } from 'react';
+import { useBridge } from './AppProvider.js';
+export function useSession() {
+    const bridge = useBridge();
+    const [state, setState] = useState({
+        session: bridge.session(),
+        isReady: bridge.session() !== null,
+        error: null,
+    });
+    useEffect(() => {
+        if (state.session)
+            return;
+        let mounted = true;
+        bridge
+            .fetch('/api/v2/me')
+            .then((s) => mounted && setState({ session: s, isReady: true, error: null }))
+            .catch((err) => mounted && setState({ session: null, isReady: true, error: err }));
+        return () => { mounted = false; };
+    }, [bridge, state.session]);
+    return state;
+}
+//# sourceMappingURL=useSession.js.map

package/dist/react/useSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSession.js","sourceRoot":"","sources":["../../src/react/useSession.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAQ7C,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAmB;QACnD,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,IAAI;QAClC,KAAK,EAAI,IAAI;KACd,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,MAAM;aACH,KAAK,CAAU,YAAY,CAAC;aAC5B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,IAAI,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;aAC5E,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE,CAAC,OAAO,IAAI,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC5F,OAAO,GAAG,EAAE,GAAG,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAE5B,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/server/createApp.d.ts

@@ -0,0 +1,3 @@
+import type { App, AppConfig } from './types.js';
+export declare function createApp(config: AppConfig): App;
+//# sourceMappingURL=createApp.d.ts.map

package/dist/server/createApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createApp.d.ts","sourceRoot":"","sources":["../../src/server/createApp.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAA6C,MAAM,YAAY,CAAC;AAM5F,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,GAAG,CAqKhD"}