@push.rocks/smartjmap 2.0.0 → 2.1.0

package/dist_ts/classes.jmapserver.d.ts

@@ -1,4 +1,10 @@
-import { type IJmapMailBackend, type TJmapPrincipal } from './interfaces.backend.js';
+import { type IJmapMailBackend, type TJmapPrincipal } from "./interfaces.backend.js";
+/**
+ * Semantic capability marker for the bounded streaming-upload server surface.
+ * Consumers must check this exact value before relying on streaming backend
+ * uploads, upload concurrency limits, Bearer-only challenges, or error mapping.
+ */
+export declare const JMAP_SERVER_STREAMING_API_VERSION: 1;
 /** Options for constructing a JmapServer. */
 export interface IJmapServerOptions {
     /** The storage backend; defaults to a fresh in-memory `MemoryMailBackend`. */
@@ -9,15 +15,29 @@ export interface IJmapServerOptions {
      * `addUser`/`addBearerToken`.
      */
     authenticate?: (request: Request) => Promise<TJmapPrincipal | null>;
+    /**
+     * WWW-Authenticate challenges advertised on a 401 response. Defaults to
+     * Bearer and Basic for the built-in registry. Custom authenticators should
+     * list only the schemes they actually accept.
+     */
+    authenticationChallenges?: string[];
     /**
      * Absolute base URL (e.g. `https://mail.example.com`) prefixed to the URLs
      * advertised in the session object. Defaults to relative URLs, which JMAP
      * clients resolve against the session resource URL.
      */
     baseUrl?: string;
+    /** Overrides for the limits advertised in the JMAP session and enforced by this server. */
+    limits?: Partial<IJmapServerLimits>;
+    /**
+     * Process-wide upload ceiling across authenticated principals. Must be at
+     * least the advertised per-principal maxConcurrentUpload value.
+     */
+    maxConcurrentUploadServer?: number;
+    /** Maps backend upload failures to an RFC 7807 response instead of a generic 500. */
+    mapUploadError?: (error: unknown) => IJmapUploadProblem | null | undefined;
 }
-/** The advertised — and enforced — RFC 8620 core limits. */
-export declare const JMAP_SERVER_LIMITS: {
+export interface IJmapServerLimits {
     maxSizeUpload: number;
     maxConcurrentUpload: number;
     maxSizeRequest: number;
@@ -25,7 +45,16 @@ export declare const JMAP_SERVER_LIMITS: {
     maxCallsInRequest: number;
     maxObjectsInGet: number;
     maxObjectsInSet: number;
-};
+}
+export interface IJmapUploadProblem {
+    status: number;
+    type?: string;
+    detail: string;
+    limit?: string;
+    retryAfterSeconds?: number;
+}
+/** The advertised — and enforced — RFC 8620 core limits. */
+export declare const JMAP_SERVER_LIMITS: IJmapServerLimits;
 /**
  * A JMAP server core (RFC 8620) with the RFC 8621 mail method surface,
  * dispatching all storage into a pluggable `IJmapMailBackend`.
@@ -45,12 +74,21 @@ export declare const JMAP_SERVER_LIMITS: {
 export declare class JmapServer {
     readonly backend: IJmapMailBackend;
     private options;
+    private readonly limits;
+    private readonly maxConcurrentUploadServer;
     private registry;
     private httpServer;
     private sockets;
     private eventStreams;
     private changeFeedUnsubscribe;
+    private cleanupErrors;
     private activeApiRequests;
+    private activeUploadRequests;
+    private activeUploadsByPrincipal;
+    private activeNodeRequests;
+    private nodeRequestControllers;
+    private stopping;
+    private authenticationChallenges;
     constructor(options?: IJmapServerOptions);
     /**
      * Registers Basic credentials in the default authenticator's registry.
@@ -105,6 +143,12 @@ export declare class JmapServer {
     private methodEmailSubmissionSet;
     /** Uses the client-provided envelope or derives it from the email's addresses. */
     private resolveEnvelope;
+    private cancelRequestBody;
+    private readRequestBodyBounded;
+    private createExactUploadBody;
+    private mappedUploadErrorResponse;
+    private requestBodyErrorResponse;
+    private handleStreamingUpload;
     private handleUpload;
     private handleDownload;
     private handleEventSource;
@@ -124,6 +168,7 @@ export declare class JmapServer {
      * against feed-driven pushes via the per-stream state tracking.
      */
     private pushAfterMutation;
+    private nodeRequestBody;
     private handleNodeRequest;
     private validateProperties;
     private projectObject;