@jango-blockchained/hoox-shared 1.0.8 → 1.1.0

package/dist/stores/service-store.js

@@ -15,6 +15,69 @@ var __export = (target, all) => {
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
+// src/operator-transport.ts
+function stripTrailingSlashes(url) {
+  return url.replace(/\/+$/, "");
+}
+function parseTransport(raw) {
+  if (!raw)
+    return null;
+  const v = raw.trim().toLowerCase();
+  if (VALID_TRANSPORTS.has(v)) {
+    return v;
+  }
+  return null;
+}
+function resolveOperatorTransportProfile(env = process.env, options = {}) {
+  const accessClientId = env.CF_ACCESS_CLIENT_ID?.trim() ?? "";
+  const accessClientSecret = env.CF_ACCESS_CLIENT_SECRET?.trim() ?? "";
+  const hasAccess = Boolean(accessClientId && accessClientSecret);
+  const explicit = parseTransport(env.HOOX_TRANSPORT) ?? parseTransport(options.configTransport);
+  const transport = explicit ?? (hasAccess ? "access" : "public");
+  const apiFromEnv = env.HOOX_API_URL?.trim();
+  const apiFromConfig = options.configApiUrl?.trim();
+  const tokenFromEnv = env.HOOX_API_TOKEN?.trim();
+  const tokenFromConfig = options.configApiToken?.trim();
+  return {
+    transport,
+    apiBase: stripTrailingSlashes(apiFromEnv || apiFromConfig || DEFAULT_API_BASE),
+    bearerToken: tokenFromEnv || tokenFromConfig || "",
+    accessClientId,
+    accessClientSecret
+  };
+}
+function buildOperatorAuthHeaders(profile) {
+  const headers = {};
+  if (profile.bearerToken) {
+    headers.Authorization = `Bearer ${profile.bearerToken}`;
+  }
+  const useAccessHeaders = profile.transport === "access" || Boolean(profile.accessClientId) && Boolean(profile.accessClientSecret);
+  if (useAccessHeaders && profile.accessClientId && profile.accessClientSecret) {
+    headers["CF-Access-Client-Id"] = profile.accessClientId;
+    headers["CF-Access-Client-Secret"] = profile.accessClientSecret;
+  }
+  return headers;
+}
+function hasOperatorClientCredentials(profile) {
+  if (profile.bearerToken)
+    return true;
+  return Boolean(profile.accessClientId && profile.accessClientSecret);
+}
+function operatorUrl(profile, path) {
+  const base = profile.apiBase.replace(/\/+$/, "");
+  const p = path.startsWith("/") ? path : `/${path}`;
+  return `${base}${p}`;
+}
+var DEFAULT_API_BASE = "http://localhost:8787", VALID_TRANSPORTS;
+var init_operator_transport = __esm(() => {
+  VALID_TRANSPORTS = new Set([
+    "public",
+    "access",
+    "mtls",
+    "tunnel"
+  ]);
+});
+
 // src/api-client.ts
 var exports_api_client = {};
 __export(exports_api_client, {
@@ -40,20 +103,25 @@ function isNetworkError(error) {
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function activeProfile(override) {
+  return override ?? resolveOperatorTransportProfile();
+}
 async function hooxFetch(path, options) {
+  const profile = options?.transport ?? (options?.transportEnv ? resolveOperatorTransportProfile(options.transportEnv) : activeProfile());
+  const { transport: _t, transportEnv: _e, ...fetchInit } = options ?? {};
   let lastError;
   for (let attempt = 0;attempt <= MAX_RETRIES; attempt++) {
     const controller = new AbortController;
     const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
     try {
-      const url = `${API_BASE}${path}`;
+      const url = operatorUrl(profile, path);
       const headers = {
         "Content-Type": "application/json",
-        ...API_TOKEN ? { Authorization: `Bearer ${API_TOKEN}` } : {},
-        ...options?.headers
+        ...buildOperatorAuthHeaders(profile),
+        ...fetchInit.headers
       };
       const response = await fetch(url, {
-        ...options,
+        ...fetchInit,
         headers,
         signal: controller.signal
       });
@@ -101,10 +169,9 @@ async function hooxFetch(path, options) {
     retryable: false
   });
 }
-var API_BASE, API_TOKEN, FETCH_TIMEOUT_MS = 5000, MAX_RETRIES = 3, BASE_RETRY_DELAY_MS = 1000, MAX_RETRY_DELAY_MS = 16000, WorkerAPIError;
+var FETCH_TIMEOUT_MS = 5000, MAX_RETRIES = 3, BASE_RETRY_DELAY_MS = 1000, MAX_RETRY_DELAY_MS = 16000, WorkerAPIError;
 var init_api_client = __esm(() => {
-  API_BASE = process.env.HOOX_API_URL || "http://localhost:8787";
-  API_TOKEN = process.env.HOOX_API_TOKEN || "";
+  init_operator_transport();
   WorkerAPIError = class WorkerAPIError extends Error {
     status;
     retryable;
@@ -122,17 +189,18 @@ var exports_sse = {};
 __export(exports_sse, {
   subscribeSSE: () => subscribeSSE
 });
-function subscribeSSE(path, callback, onStatus) {
+function subscribeSSE(path, callback, onStatus, options) {
   let aborted = false;
+  const profile = options?.transport ?? (options?.transportEnv ? resolveOperatorTransportProfile(options.transportEnv) : resolveOperatorTransportProfile());
   const run = async () => {
     let attempt = 0;
     while (!aborted && attempt < MAX_RECONNECT_ATTEMPTS) {
       try {
-        const url = `${API_BASE2}${path}`;
+        const url = operatorUrl(profile, path);
         const response = await fetch(url, {
           headers: {
             Accept: "text/event-stream",
-            ...API_TOKEN2 ? { Authorization: `Bearer ${API_TOKEN2}` } : {}
+            ...buildOperatorAuthHeaders(profile)
           }
         });
         if (!response.ok || !response.body) {
@@ -161,7 +229,7 @@ function subscribeSSE(path, callback, onStatus) {
             }
           }
         }
-      } catch (error) {
+      } catch {
         if (aborted)
           break;
         onStatus?.("reconnecting");
@@ -181,15 +249,21 @@ function subscribeSSE(path, callback, onStatus) {
     }
   };
 }
-var API_BASE2, API_TOKEN2, RECONNECT_BASE_MS = 1000, RECONNECT_MAX_MS = 16000, MAX_RECONNECT_ATTEMPTS = 10;
+var RECONNECT_BASE_MS = 1000, RECONNECT_MAX_MS = 16000, MAX_RECONNECT_ATTEMPTS = 10;
 var init_sse = __esm(() => {
-  API_BASE2 = process.env.HOOX_API_URL || "http://localhost:8787";
-  API_TOKEN2 = process.env.HOOX_API_TOKEN || "";
+  init_operator_transport();
 });
 
 // src/stores/service-store.ts
 import { create } from "zustand";
 import { immer } from "zustand/middleware/immer";
+function summarizeCliError(details) {
+  const raw = details.stderr.trim() || details.stdout.trim() || details.command || "Unknown CLI error";
+  const firstLine = raw.split(`
+`, 1)[0] ?? "";
+  const trimmed = firstLine.slice(0, 120).trimEnd();
+  return trimmed.length > 0 ? trimmed : details.command;
+}
 var BACKOFF_SEQUENCE = [1000, 2000, 4000, 8000, 16000];
 var MAX_RETRIES2 = 5;
 function ringPush(arr, item, max) {
@@ -210,6 +284,7 @@ var initialState = {
   selectedWorkerId: null,
   retryCount: 0,
   lastError: null,
+  lastErrorDetails: null,
   lastSuccessfulFetch: 0,
   reconnectDelay: 0,
   disconnectedAt: null
@@ -225,7 +300,7 @@ var useServiceStore = create()(immer((set, get) => ({
   fetchWorkers: async () => {
     const { hooxFetch: hooxFetch2 } = await Promise.resolve().then(() => (init_api_client(), exports_api_client));
     try {
-      const data = await hooxFetch2("/workers");
+      const data = await hooxFetch2("/v1/workers");
       set((state) => {
         state.workers = data;
         state.lastUpdated = Date.now();
@@ -234,27 +309,42 @@ var useServiceStore = create()(immer((set, get) => ({
           state.connectionStatus = "connected";
           state.retryCount = 0;
           state.lastError = null;
+          state.lastErrorDetails = null;
           state.reconnectDelay = 0;
           state.disconnectedAt = null;
         }
       });
     } catch (error) {
       const msg = error instanceof Error ? error.message : "Unknown fetch error";
+      get().addAlert({
+        id: crypto.randomUUID(),
+        type: "connection",
+        severity: "error",
+        message: msg,
+        timestamp: Date.now(),
+        acknowledged: false
+      });
       set((state) => {
+        state.lastError = msg;
+        state.disconnectedAt = state.disconnectedAt ?? Date.now();
         if (state.connectionStatus === "connected" || state.connectionStatus === "polling") {
           state.connectionStatus = "reconnecting";
           state.retryCount = state.retryCount + 1;
-          state.lastError = msg;
-          state.disconnectedAt = state.disconnectedAt ?? Date.now();
           if (state.retryCount >= MAX_RETRIES2) {
             state.connectionStatus = "offline";
             state.lastError = `Connection lost after ${MAX_RETRIES2} retries`;
           } else {
             state.reconnectDelay = getBackoffDelay(state.retryCount);
           }
-        }
-        if (state.connectionStatus === "reconnecting") {
-          state.lastError = msg;
+        } else if (state.connectionStatus === "reconnecting") {
+          state.retryCount = state.retryCount + 1;
+          if (state.retryCount >= MAX_RETRIES2) {
+            state.connectionStatus = "offline";
+            state.lastError = `Connection lost after ${MAX_RETRIES2} retries`;
+            state.reconnectDelay = 0;
+          } else {
+            state.reconnectDelay = getBackoffDelay(state.retryCount);
+          }
         }
       });
     }
@@ -262,18 +352,40 @@ var useServiceStore = create()(immer((set, get) => ({
   streamTrades: async () => {
     const { subscribeSSE: subscribeSSE2 } = await Promise.resolve().then(() => (init_sse(), exports_sse));
     try {
-      await subscribeSSE2("/trades/stream", (trade) => {
+      await subscribeSSE2("/v1/trades/stream", (trade) => {
         get().pushTrade(trade);
       });
-    } catch {}
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : "SSE trade stream failed";
+      get().addAlert({
+        id: crypto.randomUUID(),
+        type: "connection",
+        severity: "error",
+        message: msg,
+        timestamp: Date.now(),
+        acknowledged: false
+      });
+      get().handleConnectionFailure(msg);
+    }
   },
   streamLogs: async () => {
     const { subscribeSSE: subscribeSSE2 } = await Promise.resolve().then(() => (init_sse(), exports_sse));
     try {
-      await subscribeSSE2("/logs/stream", (log) => {
+      await subscribeSSE2("/v1/logs/stream", (log) => {
         get().pushLog(log);
       });
-    } catch {}
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : "SSE log stream failed";
+      get().addAlert({
+        id: crypto.randomUUID(),
+        type: "connection",
+        severity: "error",
+        message: msg,
+        timestamp: Date.now(),
+        acknowledged: false
+      });
+      get().handleConnectionFailure(msg);
+    }
   },
   addAlert: (alert) => set((state) => {
     state.alerts = ringPush(state.alerts, alert, MAX_ALERTS);
@@ -286,6 +398,7 @@ var useServiceStore = create()(immer((set, get) => ({
     if (status === "connected") {
       state.retryCount = 0;
       state.lastError = null;
+      state.lastErrorDetails = null;
       state.reconnectDelay = 0;
       state.disconnectedAt = null;
     }
@@ -315,11 +428,10 @@ var useServiceStore = create()(immer((set, get) => ({
     state.lastSuccessfulFetch = Date.now();
     state.retryCount = 0;
     state.lastError = null;
+    state.lastErrorDetails = null;
     state.reconnectDelay = 0;
     state.disconnectedAt = null;
-    if (state.connectionStatus === "reconnecting" || state.connectionStatus === "polling") {
-      state.connectionStatus = "connected";
-    }
+    state.connectionStatus = "connected";
   }),
   handleConnectionFailure: (errorMessage) => set((state) => {
     state.lastError = errorMessage;
@@ -342,6 +454,7 @@ var useServiceStore = create()(immer((set, get) => ({
   resetRetries: () => set((state) => {
     state.retryCount = 0;
     state.lastError = null;
+    state.lastErrorDetails = null;
     state.reconnectDelay = 0;
     state.disconnectedAt = null;
   }),
@@ -350,8 +463,30 @@ var useServiceStore = create()(immer((set, get) => ({
       state.connectionStatus = "polling";
       state.retryCount = 0;
       state.lastError = null;
+      state.lastErrorDetails = null;
       state.reconnectDelay = 0;
     }
+  }),
+  setLastErrorDetails: (details) => set((state) => {
+    state.lastErrorDetails = details;
+    state.lastError = details === null ? null : summarizeCliError(details);
+  }),
+  clearError: () => set((state) => {
+    state.lastError = null;
+    state.lastErrorDetails = null;
+  }),
+  addCliErrorAlert: (details) => set((state) => {
+    state.lastErrorDetails = details;
+    state.lastError = summarizeCliError(details);
+    const summary = summarizeCliError(details);
+    state.alerts = ringPush(state.alerts, {
+      id: crypto.randomUUID(),
+      type: "connection",
+      severity: "error",
+      message: `CLI failure: ${summary}`,
+      timestamp: Date.now(),
+      acknowledged: false
+    }, MAX_ALERTS);
   })
 })));
 export {

package/dist/test-utils.d.ts

@@ -0,0 +1,132 @@
+export interface MockKVNamespace<T = unknown> {
+    get: (key: string) => Promise<T | null>;
+    put: (key: string, value: string | ReadableStream, options?: unknown) => Promise<void>;
+    delete: (key: string) => Promise<void>;
+    list: (options?: {
+        prefix?: string;
+        limit?: number;
+    }) => Promise<{
+        keys: {
+            name: string;
+        }[];
+    }>;
+}
+export declare function createMockKV<T = unknown>(overrides?: Partial<MockKVNamespace<T>>): MockKVNamespace<T>;
+export interface MockR2Bucket {
+    put: (key: string, value: ReadableStream | ArrayBuffer, options?: unknown) => Promise<{
+        key: string;
+    }>;
+    get: (key: string) => Promise<{
+        body: ReadableStream;
+        key: string;
+        size: number;
+    } | null>;
+    delete: (key: string) => Promise<void>;
+    list: (options?: {
+        prefix?: string;
+        limit?: number;
+    }) => Promise<{
+        objects: {
+            key: string;
+        }[];
+    }>;
+}
+export declare function createMockR2(overrides?: Partial<MockR2Bucket>): MockR2Bucket;
+export interface MockD1PreparedStatement {
+    bind: (...params: unknown[]) => MockD1PreparedStatement;
+    run: () => Promise<{
+        success: boolean;
+        results?: unknown[];
+        error?: string;
+        meta?: unknown;
+    }>;
+    all: () => Promise<{
+        success: boolean;
+        results?: unknown[];
+        error?: string;
+    }>;
+    first: <T = unknown>() => Promise<T | null>;
+}
+export interface MockD1Database {
+    prepare: (sql: string) => MockD1PreparedStatement;
+    dump: () => Promise<ArrayBuffer>;
+    batch: (statements: unknown[]) => Promise<{
+        success: boolean;
+        results?: unknown[];
+        error?: string;
+    }[]>;
+    exec: (sql: string) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+export declare function createMockD1(overrides?: Partial<MockD1Database>): MockD1Database;
+export interface MockFetcher {
+    fetch: (request: Request | string, init?: RequestInit) => Promise<Response>;
+}
+export declare function createMockFetcher(response?: Response): MockFetcher;
+export interface MockAnalyticsEngine {
+    writeDataPoint: (data: {
+        blobs?: string[];
+        doubles?: number[];
+        indexes?: string[];
+    }) => void;
+}
+export declare function createMockAnalyticsEngine(): MockAnalyticsEngine;
+export interface MockAnalyticsEngineDataset {
+    writeDataPoint: (data: {
+        blobs?: string[];
+        doubles?: number[];
+        indexes?: string[];
+    }) => void;
+}
+export declare function createMockAnalyticsEngineDataset(): MockAnalyticsEngineDataset;
+export interface MockQueue {
+    send: (body: unknown, options?: {
+        delay?: number;
+    }) => Promise<void>;
+    sendBatch: (messages: {
+        body: unknown;
+    }[]) => Promise<void>;
+}
+export declare function createMockQueue(): MockQueue;
+export interface MockVectorizeIndex {
+    query: (vector: number[], options?: {
+        topK?: number;
+    }) => Promise<{
+        matches: {
+            id: string;
+            score: number;
+        }[];
+    }>;
+    upsert: (vectors: {
+        id: string;
+        values: number[];
+    }[]) => Promise<void>;
+    deleteByIds: (ids: string[]) => Promise<void>;
+    describe: () => Promise<{
+        dimension: number;
+        totalVectors?: number;
+    }>;
+}
+export declare function createMockVectorizeIndex(overrides?: Partial<MockVectorizeIndex>): MockVectorizeIndex;
+export interface MockAi {
+    run: (model: string, input: unknown) => Promise<unknown>;
+}
+export declare function createMockAi(overrides?: Partial<MockAi>): MockAi;
+export interface MockExecutionContext {
+    waitUntil: (promise: Promise<unknown>) => void;
+    passThroughOnException: () => void;
+}
+export declare function createMockExecutionContext(overrides?: Partial<MockExecutionContext>): MockExecutionContext;
+export interface MockSecretsStore {
+    get: (key: string) => Promise<string | null>;
+    put: (key: string, value: string) => Promise<void>;
+    delete: (key: string) => Promise<void>;
+}
+export declare function createMockSecretsStore(overrides?: Partial<MockSecretsStore>): MockSecretsStore;
+export interface ServiceBinding {
+    fetch: (request: Request | string, init?: RequestInit) => Promise<Response>;
+}
+export declare function createMockEnv<T extends Record<string, unknown>>(overrides: T): T;
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/test-utils.d.ts.map

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

package/dist/test-utils.js

@@ -0,0 +1,128 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// src/test-utils.ts
+function createMockKV(overrides) {
+  return {
+    get: async (_key) => null,
+    put: async (_key, _value, _options) => {},
+    delete: async (_key) => {},
+    list: async (_options) => ({
+      keys: []
+    }),
+    ...overrides
+  };
+}
+function createMockR2(overrides) {
+  return {
+    put: async (key, _value, _options) => ({
+      key
+    }),
+    get: async (_key) => null,
+    delete: async (_key) => {},
+    list: async (_options) => ({
+      objects: []
+    }),
+    ...overrides
+  };
+}
+function createMockPreparedStatement() {
+  return {
+    bind: (..._params) => createMockPreparedStatement(),
+    run: async () => ({ success: true }),
+    all: async () => ({ success: true, results: [] }),
+    first: async () => null
+  };
+}
+function createMockD1(overrides) {
+  return {
+    prepare: (_sql) => createMockPreparedStatement(),
+    dump: async () => new ArrayBuffer(0),
+    batch: async (_statements) => [],
+    exec: async (_sql) => ({ success: true }),
+    ...overrides
+  };
+}
+function createMockFetcher(response) {
+  const defaultResponse = response ?? new Response("OK", { status: 200 });
+  return {
+    fetch: async (_request, _init) => defaultResponse
+  };
+}
+function createMockAnalyticsEngine() {
+  return {
+    writeDataPoint: (_data) => {}
+  };
+}
+function createMockAnalyticsEngineDataset() {
+  return createMockAnalyticsEngine();
+}
+function createMockQueue() {
+  return {
+    send: async (_body, _options) => {},
+    sendBatch: async (_messages) => {}
+  };
+}
+function createMockVectorizeIndex(overrides) {
+  return {
+    query: async (_vector, _options) => ({
+      matches: []
+    }),
+    upsert: async (_vectors) => {},
+    deleteByIds: async (_ids) => {},
+    describe: async () => ({ dimension: 384, totalVectors: 0 }),
+    ...overrides
+  };
+}
+function createMockAi(overrides) {
+  return {
+    run: async (_model, _input) => ({}),
+    ...overrides
+  };
+}
+function createMockExecutionContext(overrides) {
+  return {
+    waitUntil: (_promise) => {},
+    passThroughOnException: () => {},
+    ...overrides
+  };
+}
+function createMockSecretsStore(overrides) {
+  return {
+    get: async (_key) => null,
+    put: async (_key, _value) => {},
+    delete: async (_key) => {},
+    ...overrides
+  };
+}
+function createMockEnv(overrides) {
+  return overrides;
+}
+export {
+  createMockVectorizeIndex,
+  createMockSecretsStore,
+  createMockR2,
+  createMockQueue,
+  createMockKV,
+  createMockFetcher,
+  createMockExecutionContext,
+  createMockEnv,
+  createMockD1,
+  createMockAnalyticsEngineDataset,
+  createMockAnalyticsEngine,
+  createMockAi
+};

package/dist/types/router.d.ts

@@ -3,20 +3,30 @@
  * Compatible with Cloudflare Workers edge runtime
  */
 export type RouteParams = Record<string, string>;
-export type Handler<TEnv = Record<string, unknown>> = (request: Request, env: TEnv, ctx: ExecutionContext, params?: RouteParams) => Promise<Response | void>;
-export interface RouteDefinition<TEnv = Record<string, unknown>> {
+/**
+ * Handler type for route handlers.
+ * TEnv is the environment type with bindings.
+ */
+export type Handler<TEnv = unknown> = (request: Request, env: TEnv, ctx: ExecutionContext, params?: RouteParams) => Promise<Response | void>;
+/**
+ * Middleware handler type - uses any to allow compatibility with
+ * stricter Env types that don't have index signatures.
+ * This enables InternalAuthEnv middleware to be used with any Env.
+ */
+export type MiddlewareHandler<TEnv = unknown> = (request: Request, env: TEnv, ctx: ExecutionContext) => Promise<Response | void>;
+export interface RouteDefinition<TEnv = unknown> {
     path: string;
     method: string;
     handler: Handler<TEnv>;
-    middleware?: Handler<TEnv>[];
+    middleware?: MiddlewareHandler<TEnv>[];
     params?: string[];
     regex?: RegExp;
 }
-export interface Router<TEnv = Record<string, unknown>> {
-    get(path: string, handler: Handler<TEnv>, middleware?: Handler<TEnv>[]): void;
-    post(path: string, handler: Handler<TEnv>, middleware?: Handler<TEnv>[]): void;
-    put(path: string, handler: Handler<TEnv>, middleware?: Handler<TEnv>[]): void;
-    delete(path: string, handler: Handler<TEnv>, middleware?: Handler<TEnv>[]): void;
+export interface Router<TEnv = unknown> {
+    get(path: string, handler: Handler<TEnv>, middleware?: MiddlewareHandler<TEnv>[]): void;
+    post(path: string, handler: Handler<TEnv>, middleware?: MiddlewareHandler<TEnv>[]): void;
+    put(path: string, handler: Handler<TEnv>, middleware?: MiddlewareHandler<TEnv>[]): void;
+    delete(path: string, handler: Handler<TEnv>, middleware?: MiddlewareHandler<TEnv>[]): void;
     handle(request: Request, env: TEnv, ctx: ExecutionContext): Promise<Response>;
 }
 //# sourceMappingURL=router.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/types/router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD,MAAM,MAAM,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CACpD,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,IAAI,EACT,GAAG,EAAE,gBAAgB,EACrB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;AAE9B,MAAM,WAAW,eAAe,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;IAC9E,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EACtB,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,GAC3B,IAAI,CAAC;IACR,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;IAC9E,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EACtB,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,GAC3B,IAAI,CAAC;IACR,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC/E"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/types/router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,OAAO,CAAC,IAAI,GAAG,OAAO,IAAI,CACpC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,IAAI,EACT,GAAG,EAAE,gBAAgB,EACrB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;AAE9B;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,IAAI,GAAG,OAAO,IAAI,CAC9C,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,IAAI,EACT,GAAG,EAAE,gBAAgB,KAClB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;AAE9B,MAAM,WAAW,eAAe,CAAC,IAAI,GAAG,OAAO;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,UAAU,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,MAAM,CAAC,IAAI,GAAG,OAAO;IACpC,GAAG,CACD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EACtB,UAAU,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,GACrC,IAAI,CAAC;IACR,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EACtB,UAAU,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,GACrC,IAAI,CAAC;IACR,GAAG,CACD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EACtB,UAAU,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,GACrC,IAAI,CAAC;IACR,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EACtB,UAAU,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,GACrC,IAAI,CAAC;IACR,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC/E"}