dsh-mobile 0.6.4 → 0.6.5

package/lib/index.d.mts

@@ -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;