Interface Uploader

Abstract upload backend. Implementors own server selection, rail authorization signing (NIP-98 for NIP-96, kind 24242 for Blossom), the HTTP upload, and integrity-hash reporting. The service translates wire envelopes into these calls and back. A concrete reference implementation ships as createHttpUploader.

interface Uploader {
    cancel?(uploadId: string): void;
    status?(uploadId: string): Promise<UploadStatus | undefined>;
    upload(request: UploadRequest, ctx: UploaderContext): Promise<UploadResult>;
}

Index

Methods

cancel? status? upload

Methods

`Optional`cancel

cancel?(uploadId: string): void
Optional: abort an in-flight upload (called on window teardown).
Parameters
- uploadId: string
Returns void
- Defined in packages/services/src/upload-service.ts:155

`Optional`status

status?(uploadId: string): Promise<UploadStatus | undefined>
Optional: resolve the latest status for an upload the service is not tracking.
Parameters
- uploadId: string
Returns Promise<UploadStatus | undefined>
- Defined in packages/services/src/upload-service.ts:153

upload

upload(request: UploadRequest, ctx: UploaderContext): Promise<UploadResult>
Upload request.data, streaming progress through ctx.onStatus.
Parameters
- request: UploadRequest
- ctx: UploaderContext
Returns Promise<UploadResult>
- Defined in packages/services/src/upload-service.ts:151