dsh-mobile 0.8.3 → 0.8.5

package/lib/index.d.mts

@@ -382,6 +382,8 @@ interface PluginConfig {
   upstreamTimeoutMs?: number;
   /** Authenticated /api response and established DSH plugin-event stream idle timeout; zero disables it. */
   upstreamApiTimeoutMs?: number;
+  /** Serve the two model-catalog RPCs from a narrow stale-while-revalidate cache. */
+  catalogCache?: boolean;
   rateLimitWindowMs?: number;
   maxPairingAttempts?: number;
   maxRateLimitKeys?: number;
@@ -426,6 +428,7 @@ interface ResolvedGatewayConfig {
   readonly maxBodyBytes: number;
   readonly upstreamTimeoutMs: number;
   readonly upstreamApiTimeoutMs: number;
+  readonly catalogCache: boolean;
   readonly rateLimitWindowMs: number;
   readonly maxPairingAttempts: number;
   readonly maxRateLimitKeys: number;
@@ -1080,6 +1083,7 @@ export declare class ClientModuleConflictError extends HttpError {
 export declare function rewriteMobileIndex(html: string, excludedClientModules?: readonly string[]): string;
 /** Authenticated TLS edge in front of the ordinary loopback-only DSH Web server. */
 export declare class MobileAccessGateway {
+  #private;
   readonly config: ResolvedGatewayConfig;
   private readonly extensions?;
   private readonly upstreamAuthenticatedUrl?;
@@ -1128,6 +1132,8 @@ export declare class MobileAccessGateway {
   private upstreamCookie;
   private upstreamCookieExpiresAt;
   private upstreamCookieTask;
+  /** The catalog SWR cache, or undefined when `catalogCache` is disabled. */
+  private get catalogCache();
   private upstreamAuthRequest;
   private nextOperationId;
   private closing;
@@ -1314,6 +1320,15 @@ export declare class MobileAccessGateway {
   private readUpstreamClientBundleWithRetry;
   private readUpstreamClientBundle;
   private allocateRequest;
+  /** Read one bounded request body verbatim; the caller owns replaying it upstream. */
+  private readRequestBody;
+  /** One gateway-owned catalog fill: its own socket, rpcId, deadline and byte cap. */
+  private catalogFill;
+  /**
+   * Serve one eligible catalog request from the SWR cache.
+   * @returns true when the response was committed here; false for the ordinary path.
+   */
+  private serveCatalogCache;
   /**
    * Proxy one request, retrying transient failures for plugin and asset GETs.
    * Only bodyless GETs can be replayed, before response headers reach the client.
@@ -2587,6 +2602,10 @@ interface IrohControllerOptions {
   readonly onStatus?: (status: IrohStatus) => void;
   readonly launchSidecar?: (executable: string, args: readonly string[]) => ChildProcessWithoutNullStreams;
   readonly resolveIdentity?: (executable: string, dataDir: string) => Promise<string>;
+  readonly onFailure?: (failure: {
+    readonly errorCode: string;
+    readonly diagnostic?: string;
+  }) => void;
   readonly readyTimeoutMs?: number;
   readonly pairingTimeoutMs?: number;
 }