dsh-mobile 0.6.3 → 0.6.5

package/lib/index.d.mts

@@ -465,8 +465,8 @@ export declare class JsonMobileAccessControlStore implements MobileAccessControl
   private readonly file;
   private readonly initiallyEnabled;
   constructor(file: string, initiallyEnabled: boolean);
-  /** Avoid writing an absent already-disabled state without changing recovery of existing files. */
-  disableIfPresent(): Promise<void>;
+  /** Disable an existing preference, returning the state only after private-file preparation completes. */
+  disableIfPresent(): Promise<MobileAccessControlState>;
   load(): Promise<MobileAccessControlState>;
   save(state: MobileAccessControlState): Promise<void>;
 }
@@ -1150,6 +1150,85 @@ export declare class FrpComponentManager {
   private enqueue;
 }
 //#endregion
+//#region src/cpolar-component.d.ts
+/** Pinned cpolar components fetched only after an explicit user action. */
+interface CpolarArtifact {
+  readonly version: string;
+  readonly platform: NodeJS.Platform;
+  readonly arch: string;
+  readonly downloadUrl: string;
+  readonly downloadBytes: number;
+  readonly downloadSha256: string;
+  readonly executableName: string;
+  readonly executableBytes: number;
+  readonly executableSha256: string;
+  /** Windows ships an MSI inside a zip; Linux ships the binary in a tarball. */
+  readonly archiveKind: 'msi-zip' | 'tar.gz';
+}
+/** Pinned official cpolar release metadata for supported desktop targets. */
+export declare const CPOLAR_COMPONENT_RELEASES: Readonly<Record<string, CpolarArtifact>>;
+/**
+ * Canonical release metadata. New code should select from
+ * {@link CPOLAR_COMPONENT_RELEASES} by platform and architecture; this alias
+ * preserves the original Windows x64 entry for existing callers.
+ */
+export declare const CPOLAR_COMPONENT_RELEASE: CpolarArtifact;
+/** Public, credential-free description of the managed cpolar component. */
+interface CpolarComponentStatus {
+  readonly supported: boolean;
+  readonly installed: boolean;
+  readonly configured: boolean;
+  readonly version: string;
+  readonly downloadBytes: number;
+  readonly installedBytes: number;
+  readonly sourceUrl: string;
+  readonly downloadPage: string;
+  readonly signupUrl: string;
+  readonly dashboardUrl: string;
+  readonly termsUrl: string;
+  readonly storagePath: string;
+  readonly errorCode?: string;
+}
+interface CpolarComponentManagerOptions {
+  readonly stateDirectory: string;
+  readonly platform?: NodeJS.Platform;
+  readonly arch?: string;
+  readonly fetchArtifact?: (url: string, signal: AbortSignal) => Promise<Uint8Array>;
+  readonly extractArtifact?: (archive: string, destination: string) => Promise<void>;
+}
+/** Owns the optional cpolar binary and account configuration inside DSH Mobile state. */
+export declare class CpolarComponentManager {
+  readonly executable: string;
+  readonly configFile: string;
+  readonly componentRoot: string;
+  readonly componentStorage: string;
+  readonly stateRoot: string;
+  readonly logRoot: string;
+  private readonly stagingRoot;
+  private readonly stateDirectory;
+  private readonly platform;
+  private readonly arch;
+  private readonly release;
+  private readonly fetchArtifact;
+  private readonly extractArtifact;
+  private installed;
+  private configured;
+  private errorCode;
+  private queue;
+  constructor(options: CpolarComponentManagerOptions);
+  /** Inspect the managed binary and configuration without using global cpolar state. */
+  initialize(): Promise<void>;
+  /** Return a safe status that never includes the account token. */
+  status(): CpolarComponentStatus;
+  /** Download and verify cpolar, reading archive data without running installer actions. */
+  install(): Promise<CpolarComponentStatus>;
+  /** Store only the cpolar token in a private, self-update-disabled configuration. */
+  configure(authtoken: unknown): Promise<CpolarComponentStatus>;
+  /** Remove every cpolar file owned by DSH Mobile without touching global state. */
+  purge(): Promise<CpolarComponentStatus>;
+  private enqueue;
+}
+//#endregion
 //#region src/frp-template.d.ts
 /** Loopback-only HTTP vhost port used between Caddy and frps. */
 export declare const FRP_VHOST_HTTP_PORT = 7080;
@@ -1612,7 +1691,12 @@ interface RemoteProviderStatus {
 }
 /** Lifecycle shared by selectable remote providers. */
 interface RemoteProviderController {
-  initialize(): Promise<void>;
+  /**
+   * Initialize from the current startup preparation, without retaining a permission-success cache.
+   * @param initialState - Fresh state prepared by this controller's own store; omission reads that store.
+   * @returns Completion of the normal provider initialization and optional startup.
+   */
+  initialize(initialState?: MobileAccessControlState): Promise<void>;
   gateway(): MobileAccessGateway | undefined;
   status(): RemoteProviderStatus;
   setEnabled(enabled: boolean): Promise<RemoteProviderStatus>;
@@ -1720,7 +1804,7 @@ export declare class FrpController implements RemoteProviderController {
   private ingressCertificateTimer;
   constructor(options: FrpControllerOptions);
   /** Restore the remembered FRP switch without changing LAN or other providers. */
-  initialize(): Promise<void>;
+  initialize(initialState?: MobileAccessControlState): Promise<void>;
   /** Return the active FRP-backed DSH gateway. */
   gateway(): MobileAccessGateway | undefined;
   /** Return state safe for the desktop control UI. */
@@ -2085,7 +2169,7 @@ export declare class CloudflaredController implements RemoteProviderController {
   private startupRounds;
   constructor(options: CloudflaredControllerOptions);
   /** Restore the remembered cloudflared switch independently from LAN and other providers. */
-  initialize(): Promise<void>;
+  initialize(initialState?: MobileAccessControlState): Promise<void>;
   /** Return the active cloudflared-backed DSH gateway. */
   gateway(): MobileAccessGateway | undefined;
   /** Return state safe for the desktop control UI. */