dsh-mobile 0.3.8 → 0.3.9

package/lib/index.d.mts

@@ -187,6 +187,12 @@ declare function parseCidr(source: string): ParsedCidr;
 declare function addressAllowed(address: string | undefined, cidrs: readonly ParsedCidr[]): boolean;
 /** Whether an IP literal is loopback and therefore eligible for HTTP-only development. */
 declare function isLoopbackAddress(address: string): boolean;
+/**
+ * Whether a dotted-quad IPv4 literal is globally routable and therefore usable
+ * as a public VPS / remote HTTPS endpoint. Rejects documentation addresses such
+ * as 203.0.113.10 alongside private, shared, and reserved space.
+ */
+declare function isGloballyRoutableIpv4(address: string): boolean;
 /** Parse a bare host or host:port authority without accepting URL components. */
 declare function parseAuthority(source: string): AuthoritySpec;
 /** Resolve an authority against the actual listener port. */
@@ -685,7 +691,15 @@ declare class FrpComponentManager {
 //#region src/frp-template.d.ts
 /** Loopback-only HTTP vhost port used between Caddy and frps. */
 declare const FRP_VHOST_HTTP_PORT = 7080;
-/** Build the only supported frps and Caddy configuration from validated user inputs. */
+/** Caddy snippet owned entirely by DSH Mobile; the main Caddyfile only imports it. */
+declare const FRP_CADDY_SNIPPET_PATH = "/etc/caddy/dsh-mobile-dsh.caddy";
+/** First line of the owned snippet; also the legacy whole-file marker. */
+declare const FRP_CADDY_SNIPPET_MARKER = "# Managed by DSH Mobile - snippet, safe to delete";
+/** Exact line the main Caddyfile must contain (uncommented) for the site to load. */
+declare const FRP_CADDY_IMPORT_LINE = "import /etc/caddy/dsh-mobile-dsh.caddy";
+/** Build the Caddy site for one public host (without markers or import wiring). */
+declare function createCaddySite(publicHost: string, certDir?: string): string;
+/** Build the only supported frps config and Caddy snippet from validated user inputs. */
 declare function createRestrictedFrpServerTemplate(serverPort: number, token: string, publicOrigin: string): string;
 //#endregion
 //#region src/frp-config.d.ts
@@ -717,6 +731,18 @@ declare function validateFrpToken(value: unknown): string;
 declare function validateFrpPublicOrigin(value: unknown): string;
 /** Parse FRP settings at the loopback request and filesystem boundaries. */
 declare function parseFrpSettings(value: unknown): FrpSettings;
+/**
+ * Merge a partial VPS request body with the saved configuration so a blank
+ * field keeps its saved value ("已保存时可留空"). Every merged field is still
+ * validated; with nothing saved and nothing supplied the result reports a
+ * missing configuration instead of silently deploying blanks.
+ */
+declare function mergeSavedFrpSettings(partial: Readonly<Record<string, unknown>>, saved: FrpSettings | undefined): FrpSettings;
+/** Merge a VPS target (address and control port) with the saved configuration. */
+declare function mergeSavedFrpTarget(partial: Readonly<Record<string, unknown>>, saved: FrpSettings | undefined): {
+  readonly serverAddress: string;
+  readonly serverPort: number;
+};
 /** Build the single-purpose frpc configuration for the current loopback gateway. */
 declare function createFrpcToml(settings: FrpSettings, localPort: number): string;
 /** Build the matching restricted frps and Caddy templates for one VPS. */
@@ -852,5 +878,5 @@ declare const inject: string[];
 /** Mount the resident control route and its optional authenticated LAN gateway. */
 declare function apply(ctx: Context, config: PluginConfig): Promise<void>;
 //#endregion
-export { AUTH_PREFIX, AccessController, type AccessControllerOptions, AccessError, type AuthoritySpec, BoundedRateLimiter, CSRF_COOKIE, CSRF_HEADER, Config, FRP_VHOST_HTTP_PORT as DEFAULT_VHOST_HTTP_PORT, FRP_VHOST_HTTP_PORT, DEVICE_COOKIE, type DeviceSnapshot, type DeviceStore, type DeviceSummary, type DisabledTlsConfig, EXTENSION_LIMITS, FRP_COMPONENT_RELEASES, FrpComponentManager, type FrpComponentStatus, FrpConfigStore, type FrpConfigurationStatus, FrpController, type FrpControllerOptions, type FrpSettings, type FrpState, type FrpStatus, JsonDeviceStore, JsonMobileAccessControlStore, JsonRemoteProviderStore, LOCAL_ADMIN_PREFIX, type LocalExtensionManifest, MemoryDeviceStore, type MobileAccessControlState, type MobileAccessControlStore, MobileAccessGateway, MobileAccessGatewayController, type MobileAccessService as MobileAccessRegistry, MobileAccessService, type MobileAccessRuntime, type MobileActionContext, type MobileExtensionClientEntry, type MobileExtensionDefinition, MobileExtensionError, type MobileExtensionManifest, type MobileExtensionStatus, type MobileHostAction, type MobileHostRoute, type MobileRouteRequest, type MobileRouteResponse, type PairingResult, type ParsedCidr, type PluginConfig, type ProvidedTlsConfig, type RemoteProvider, type RemoteProviderController, type RemoteProviderState, type RemoteProviderStatus, type RenewalResult, RequestTrustPolicy, type ResolvedGatewayConfig, SESSION_COOKIE, type SessionAuthorization, type StoredDevice, type TlsConfig, WS_PATHS, addressAllowed, apply, assertExtensionId, configuredRemoteProvider, createFrpServerTemplate, createFrpcToml, createMobileAccessService, createRestrictedFrpServerTemplate, inject, isLoopbackAddress, name, parseAuthority, parseCidr, parseControlFile, parseDeviceSnapshot, parseExtensionManifest, parseFrpSettings, parseGatewayConfig, parseMobileAccessControlState, parseRemoteProviderState, resolveAuthority, rewriteMobileIndex, validateFrpPublicOrigin, validateFrpServerAddress, validateFrpServerPort, validateFrpToken };
+export { AUTH_PREFIX, AccessController, type AccessControllerOptions, AccessError, type AuthoritySpec, BoundedRateLimiter, CSRF_COOKIE, CSRF_HEADER, Config, FRP_VHOST_HTTP_PORT as DEFAULT_VHOST_HTTP_PORT, FRP_VHOST_HTTP_PORT, DEVICE_COOKIE, type DeviceSnapshot, type DeviceStore, type DeviceSummary, type DisabledTlsConfig, EXTENSION_LIMITS, FRP_CADDY_IMPORT_LINE, FRP_CADDY_SNIPPET_MARKER, FRP_CADDY_SNIPPET_PATH, FRP_COMPONENT_RELEASES, FrpComponentManager, type FrpComponentStatus, FrpConfigStore, type FrpConfigurationStatus, FrpController, type FrpControllerOptions, type FrpSettings, type FrpState, type FrpStatus, JsonDeviceStore, JsonMobileAccessControlStore, JsonRemoteProviderStore, LOCAL_ADMIN_PREFIX, type LocalExtensionManifest, MemoryDeviceStore, type MobileAccessControlState, type MobileAccessControlStore, MobileAccessGateway, MobileAccessGatewayController, type MobileAccessService as MobileAccessRegistry, MobileAccessService, type MobileAccessRuntime, type MobileActionContext, type MobileExtensionClientEntry, type MobileExtensionDefinition, MobileExtensionError, type MobileExtensionManifest, type MobileExtensionStatus, type MobileHostAction, type MobileHostRoute, type MobileRouteRequest, type MobileRouteResponse, type PairingResult, type ParsedCidr, type PluginConfig, type ProvidedTlsConfig, type RemoteProvider, type RemoteProviderController, type RemoteProviderState, type RemoteProviderStatus, type RenewalResult, RequestTrustPolicy, type ResolvedGatewayConfig, SESSION_COOKIE, type SessionAuthorization, type StoredDevice, type TlsConfig, WS_PATHS, addressAllowed, apply, assertExtensionId, configuredRemoteProvider, createCaddySite, createFrpServerTemplate, createFrpcToml, createMobileAccessService, createRestrictedFrpServerTemplate, inject, isGloballyRoutableIpv4, isLoopbackAddress, mergeSavedFrpSettings, mergeSavedFrpTarget, name, parseAuthority, parseCidr, parseControlFile, parseDeviceSnapshot, parseExtensionManifest, parseFrpSettings, parseGatewayConfig, parseMobileAccessControlState, parseRemoteProviderState, resolveAuthority, rewriteMobileIndex, validateFrpPublicOrigin, validateFrpServerAddress, validateFrpServerPort, validateFrpToken };
 //# sourceMappingURL=index.d.mts.map