SoulFire TypeScript SDK 2.10.3
    Preparing search index...

    Variable DownloadServiceConst

    DownloadService: GenService<
        {
            download: {
                input: typeof DownloadRequestSchema;
                methodKind: "unary";
                output: typeof DownloadResponseSchema;
            };
        },
    > = ...

    Service for downloading content from remote URLs through the SoulFire server. This service acts as a proxy, allowing clients to fetch remote resources using the server's network connection and optionally through a configured proxy.

    Use cases include:

    • Downloading resources that may be blocked from the client's network
    • Fetching content through a specific proxy for anonymity or geo-unlocking
    • Centralizing external API calls through the server

    The service uses a Reactor Netty HTTP client with:

    • 5-second response timeout
    • Automatic compression support
    • Default Accept, Accept-Language, and User-Agent headers

    Authorization:

    • Requires a valid JWT token
    • Caller must have DOWNLOAD_URL permission for the specified instance

    Error handling:

    • Returns gRPC INTERNAL status on network errors, timeouts, or server failures
    • The error description contains details about the failure

    from service soulfire.v1.DownloadService