dsh-mobile 0.3.0 → 0.3.2

package/lib/index.d.mts

@@ -438,10 +438,16 @@ declare module '@deepseek-ai/cordis' {
 interface LocalExtensionManifest extends MobileExtensionManifest {}
 /** Public snapshot sent to the mobile browser. */
 interface MobileExtensionClientEntry extends MobileExtensionManifest {
+  readonly generation?: string;
   readonly scriptUrl?: string;
   readonly styleUrl?: string;
   readonly assetsUrl?: string;
 }
+interface LocalAssetSnapshot {
+  readonly body: Buffer;
+  readonly digest: string;
+  readonly name: string;
+}
 /** Small status summary used by the desktop mobile-access card. */
 interface MobileExtensionStatus {
   readonly loaded: number;
@@ -450,8 +456,9 @@ interface MobileExtensionStatus {
 interface ActiveLocalExtension {
   readonly manifest: LocalExtensionManifest;
   readonly directory: string;
-  readonly scriptFile?: string;
-  readonly styleFile?: string;
+  readonly scriptBody?: Buffer;
+  readonly styleBody?: Buffer;
+  readonly assets: ReadonlyMap<string, LocalAssetSnapshot>;
   readonly host: MobileExtensionDefinition;
   readonly controller: AbortController;
   readonly cleanups: readonly (() => void | Promise<void>)[];
@@ -465,42 +472,48 @@ declare function parseExtensionManifest(value: unknown): LocalExtensionManifest;
 declare class MobileAccessService extends Service {
   private readonly registered;
   private readonly local;
+  private readonly retired;
   private readonly failures;
+  private readonly contentListeners;
   private contentHash;
   private localRoot;
   private localContext;
   private localTimer;
   private localRefreshing;
+  private localRefreshAbort;
+  private localLifecycle;
   private localClosed;
   constructor(ctx: Context);
   /** Register a normal Cordis extension and return an idempotent disposer. */
   registerExtension(definition: MobileExtensionDefinition): () => void;
   /** Aggregate digest covering every registered and active local extension. */
   contentDigest(): string;
+  /** Subscribe to committed extension generation changes. */
+  onContentChanged(listener: () => void): () => void;
   private updateContentHash;
   /** Return the current client-facing manifest, deterministically sorted by id. */
   manifest(): readonly MobileExtensionClientEntry[];
   /** Return loaded and failed local extension counts without exposing host errors. */
   status(): MobileExtensionStatus;
   /** Locate one active extension. */
-  extension(id: string): MobileExtensionDefinition | ActiveLocalExtension | undefined;
+  extension(id: string, generation?: string): MobileExtensionDefinition | ActiveLocalExtension | undefined;
   /** Return the active local generation signal for gateway cancellation wiring. */
-  signal(id: string): AbortSignal | undefined;
+  signal(id: string, generation?: string): AbortSignal | undefined;
   /** Read a local client entry after validating that it remains inside its directory. */
-  readClientFile(id: string, kind: 'script' | 'style', signal?: AbortSignal): Promise<{
+  readClientFile(id: string, kind: 'script' | 'style', signal?: AbortSignal, generation?: string): Promise<{
     readonly body: Buffer;
     readonly digest: string;
   }>;
-  /** Read a local static asset after containment and size checks. */
-  readAsset(id: string, assetPath: string, signal?: AbortSignal): Promise<{
+  /** Read a generation-pinned static asset from its validated snapshot. */
+  readAsset(id: string, assetPath: string, signal?: AbortSignal, generation?: string): Promise<{
     readonly body: Buffer;
     readonly digest: string;
     readonly name: string;
   }>;
   /** Invoke one action after parsing its input and binding the request lifetime. */
-  invoke(id: string, actionName: string, input: unknown, context: MobileActionContext): Promise<unknown>;
+  invoke(id: string, actionName: string, input: unknown, context: MobileActionContext, generation?: string): Promise<unknown>;
   /** Match one route and invoke it with a generation-bound abort signal. */
-  route(id: string, method: string, pathname: string, request: MobileRouteRequest): Promise<MobileRouteResponse>;
+  route(id: string, method: string, pathname: string, request: MobileRouteRequest, generation?: string): Promise<MobileRouteResponse>;
   /** Start the local directory watcher; an absent directory is intentionally inert. */
   startLocal(root: string, context: Context): Promise<void>;
   /** Stop the watcher and abort every local host generation. */
@@ -508,6 +521,7 @@ declare class MobileAccessService extends Service {
   /** Refresh all local extensions atomically; failures keep the previous snapshot. */
   refreshLocal(): Promise<void>;
   private stageAndCommit;
+  private retire;
 }
 /** Construct the service in a Cordis plugin without importing DSH internals. */
 declare function createMobileAccessService(ctx: Context): MobileAccessService;
@@ -534,6 +548,11 @@ declare class MobileAccessGateway {
   private readonly activeRequests;
   private readonly activeWebSockets;
   private readonly mobileBootBatches;
+  private readonly extensionEventListeners;
+  private extensionEventRevision;
+  private extensionChangeTimer;
+  private extensionChangeTask;
+  private legacyCustomDigest;
   private upstreamCookie;
   private upstreamCookieExpiresAt;
   private upstreamCookieTask;
@@ -543,6 +562,7 @@ declare class MobileAccessGateway {
   private started;
   private closeTask;
   private readonly removeSessionListener;
+  private readonly removeExtensionContentListener;
   private readonly renewLimiter;
   constructor(config: ResolvedGatewayConfig, store: DeviceStore, extensions?: MobileAccessService | undefined, upstreamAuthenticatedUrl?: string | undefined);
   /** Initialize durable state, validate TLS, and bind the externally reachable listener. */
@@ -580,6 +600,9 @@ declare class MobileAccessGateway {
   private allocateRequest;
   private proxyHttp;
   private abortSessionResources;
+  private broadcastExtensionChange;
+  private pollLegacyCustomChanges;
+  private openExtensionEventStream;
   private readUpgradeResponse;
   private handleUpgrade;
   /** Loopback-only DSH WebServer route for opening pairing and managing devices. */