dsh-mobile 0.8.4 → 0.8.6

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;
@@ -1021,6 +1024,17 @@ interface PushRegistration extends PushRecipientKey {
   readonly enabled: boolean;
   readonly health: 'ready' | 'suspended' | 'repair-required';
 }
+interface PushCustomNotification {
+  readonly sessionId: string;
+  readonly title: string;
+  readonly body: string;
+  readonly category?: Exclude<PushCategory, 'test'>;
+  readonly expiresAt?: number;
+}
+interface PushCustomNotificationResult {
+  readonly queued: number;
+  readonly expiresAt: number;
+}
 interface PushTarget {
   readonly sessionId: string;
   readonly interaction: 'current' | 'resolved';
@@ -1069,6 +1083,7 @@ interface PushGatewayService {
   logout(owner: PushOwner): Promise<void>;
   /** Resolves only an owned, still-valid opaque reference. */
   test(owner: PushOwner, installationId: string): Promise<void>;
+  notifyCustom?(input: PushCustomNotification): Promise<PushCustomNotificationResult>;
   resolve(owner: PushOwner, reference: string): Promise<PushTarget | undefined>;
 }
 /** A graph-selection conflict with a bounded diagnostic safe for authenticated callers. */
@@ -1080,6 +1095,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 +1144,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 +1332,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.
@@ -1333,6 +1360,12 @@ export declare class MobileAccessGateway {
   private broadcastDeviceRevoked;
   private pollLegacyCustomChanges;
   private openExtensionEventStream;
+  /**
+   * Native background notifications need only Host task and revocation events.
+   * They use the paired session cookie but no mobile document view, because the
+   * App has no live WebView while this stream is serving a suspended page.
+   */
+  private openBackgroundEventStream;
   private readUpgradeResponse;
   /** Snapshot of rejected upgrade paths for the approval UI (newest first). */
   blockedUpgradePathReport(): BlockedUpgradePathEntry[];
@@ -1350,6 +1383,27 @@ export declare class MobileAccessGateway {
     readonly failed: number;
   };
 }
+type SendCustomPush = (input: PushCustomNotification) => Promise<PushCustomNotificationResult>;
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    /** Trusted Host-plugin API for explicit, consent-checked web-push notifications. */
+    mobilePush: MobilePushService;
+  }
+}
+/**
+ * Small Cordis service exposed to trusted Host plugins. The provider owns the
+ * runtime lifetime and all recipient, category, session, and expiry checks.
+ */
+export declare class MobilePushService extends Service {
+  private readonly send;
+  constructor(ctx: Context, send: SendCustomPush);
+  /**
+   * Queue a notification for enabled web-push recipients.
+   * @param input - Session, text, optional category and optional expiry.
+   * @returns The number of newly queued recipient deliveries and the applied expiry.
+   */
+  notify(input: PushCustomNotification): Promise<PushCustomNotificationResult>;
+}
 interface FrpArtifact {
   readonly platform: NodeJS.Platform;
   readonly arch: string;
@@ -2587,6 +2641,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;
 }
@@ -2775,5 +2833,5 @@ export declare const inject: string[];
 export declare function originGatewayConfig(template: ResolvedGatewayConfig, settings: OriginSettings, stateFile: string, instanceId: string, listenPort?: number, legacyInstanceId?: string): ResolvedGatewayConfig;
 /** Mount the resident control route and its optional authenticated LAN gateway. */
 export declare function apply(ctx: Context, config: PluginConfig): Promise<void>;
-export { type AccessControllerOptions, type AuthoritySpec, type BlockedUpgradePathEntry, type CaddySiteOptions, type CertRenewalStatus, type ClientModuleEntry, type ClientModulePreferenceSelection, type ClientModulePreferenceView, type CloudflaredComponentStatus, type CloudflaredControllerOptions, type CloudflaredState, type CloudflaredStatus, type CloudflaredTunnelMode, type CloudflaredTunnelSettings, type CloudflaredTunnelStatus, FRP_VHOST_HTTP_PORT as DEFAULT_VHOST_HTTP_PORT, type DeviceProbeResult, type DeviceSnapshot, type DeviceStore, type DeviceSummary, type DisabledTlsConfig, type FrpAttachOptions, type FrpAttachPlan, type FrpAttachPlanLocal, type FrpAttachPlanStep, type FrpAttachStepId, type FrpAttachTemplate, type FrpAttachVpsParts, type FrpComponentStatus, type FrpConfigurationStatus, type FrpControllerOptions, type FrpEntryTls, type FrpIngressCertificate, type FrpIngressPaths, type FrpIngressSelfCheck, type FrpSettings, type FrpState, type FrpStatus, type HostExecutionConfig, type IrohArtifact, type IrohComponentManagerOptions, type IrohComponentStatus, type IrohControllerOptions, type IrohPairingDescriptor, type IrohState, type IrohStatus, type IrohTlsCertificate, type IrohTlsPaths, type LocalExtensionManifest, type MobileAccessControlState, type MobileAccessControlStore, type MobileAccessService as MobileAccessRegistry, type MobileAccessRuntime, type MobileActionContext, type MobileExtensionClientEntry, type MobileExtensionDefinition, type MobileExtensionManifest, type MobileExtensionStatus, type MobileHostAction, type MobileHostRoute, type MobileRouteRequest, type MobileRouteResponse, type MobileWorkerHostApi, type OriginConfigurationStatus, type OriginControllerOptions, type OriginSettings, type OriginState, type OriginStatus, type PairingDescriptorField, type PairingResult, type ParsedCidr, type PluginConfig, type ProvidedTlsConfig, type RemoteProvider, type RemoteProviderController, type RemoteProviderState, type RemoteProviderStatus, type RenewalResult, type ResolvedGatewayConfig, type ResolvedHostExecutionConfig, type ServerCertificateAuthority, type ServerCertificateFiles, type ServerCertificateTarget, type SessionAuthorization, type SessionEndReason, type StoredDevice, type TaskCompletionEvent, type TaskEventContext, type TaskEventSession, type TaskEventSink, type TaskEventWatcherOptions, type TaskTurnEvent, type TlsConfig };
+export { type AccessControllerOptions, type AuthoritySpec, type BlockedUpgradePathEntry, type CaddySiteOptions, type CertRenewalStatus, type ClientModuleEntry, type ClientModulePreferenceSelection, type ClientModulePreferenceView, type CloudflaredComponentStatus, type CloudflaredControllerOptions, type CloudflaredState, type CloudflaredStatus, type CloudflaredTunnelMode, type CloudflaredTunnelSettings, type CloudflaredTunnelStatus, FRP_VHOST_HTTP_PORT as DEFAULT_VHOST_HTTP_PORT, type DeviceProbeResult, type DeviceSnapshot, type DeviceStore, type DeviceSummary, type DisabledTlsConfig, type FrpAttachOptions, type FrpAttachPlan, type FrpAttachPlanLocal, type FrpAttachPlanStep, type FrpAttachStepId, type FrpAttachTemplate, type FrpAttachVpsParts, type FrpComponentStatus, type FrpConfigurationStatus, type FrpControllerOptions, type FrpEntryTls, type FrpIngressCertificate, type FrpIngressPaths, type FrpIngressSelfCheck, type FrpSettings, type FrpState, type FrpStatus, type HostExecutionConfig, type IrohArtifact, type IrohComponentManagerOptions, type IrohComponentStatus, type IrohControllerOptions, type IrohPairingDescriptor, type IrohState, type IrohStatus, type IrohTlsCertificate, type IrohTlsPaths, type LocalExtensionManifest, type MobileAccessControlState, type MobileAccessControlStore, type MobileAccessService as MobileAccessRegistry, type MobileAccessRuntime, type MobileActionContext, type MobileExtensionClientEntry, type MobileExtensionDefinition, type MobileExtensionManifest, type MobileExtensionStatus, type MobileHostAction, type MobileHostRoute, type MobileRouteRequest, type MobileRouteResponse, type MobileWorkerHostApi, type OriginConfigurationStatus, type OriginControllerOptions, type OriginSettings, type OriginState, type OriginStatus, type PairingDescriptorField, type PairingResult, type ParsedCidr, type PluginConfig, type ProvidedTlsConfig, type PushCustomNotification, type PushCustomNotificationResult, type RemoteProvider, type RemoteProviderController, type RemoteProviderState, type RemoteProviderStatus, type RenewalResult, type ResolvedGatewayConfig, type ResolvedHostExecutionConfig, type SendCustomPush, type ServerCertificateAuthority, type ServerCertificateFiles, type ServerCertificateTarget, type SessionAuthorization, type SessionEndReason, type StoredDevice, type TaskCompletionEvent, type TaskEventContext, type TaskEventSession, type TaskEventSink, type TaskEventWatcherOptions, type TaskTurnEvent, type TlsConfig };
 //# sourceMappingURL=index.d.mts.map