@squidcloud/client
Version:
A typescript implementation of the Squid client
416 lines (415 loc) • 19.5 kB
TypeScript
/** Set of constants for HTTP status codes. */
export declare const HttpStatus: {
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.2.1
*
* This interim response indicates that everything so far is OK and that the client should continue with the request
* or ignore it if it is already finished.
*/
readonly CONTINUE: 100;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.2.2
*
* This code is sent in response to an Upgrade request header by the client, and indicates the protocol the server is
* switching too.
*/
readonly SWITCHING_PROTOCOLS: 101;
/**
* Official Documentation: https://tools.ietf.org/html/rfc2518#section-10.1
*
* This code indicates that the server has received and is processing the request, but no response is available yet.
*/
readonly PROCESSING: 102;
/**
* Official Documentation: https://www.rfc-editor.org/rfc/rfc8297#page-3
*
* This code indicates to the client that the server is likely to send a final response with the header fields
* included in the informational response.
*/
readonly EARLY_HINTS: 103;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.3.1
*
* The request has succeeded. The meaning of a success varies depending on the HTTP method:
* GET: The resource has been fetched and is transmitted in the message body.
* HEAD: The entity headers are in the message body.
* POST: The resource describing the result of the action is transmitted in the message body.
* TRACE: The message body contains the request message as received by the server
*/
readonly OK: 200;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.3.2
*
* The request has succeeded and a new resource has been created as a result of it. This is typically the response
* sent after a PUT request.
*/
readonly CREATED: 201;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.3.3
*
* The request has been received but not yet acted upon. It is non-committal, meaning that there is no way in HTTP to
* later send an asynchronous response indicating the outcome of processing the request. It is intended for cases
* where another process or server handles the request, or for batch processing.
*/
readonly ACCEPTED: 202;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.3.4
*
* This response code means returned meta-information set is not exact set as available from the origin server, but
* collected from a local or a third party copy. Except this condition, 200 OK response should be preferred instead
* of this response.
*/
readonly NON_AUTHORITATIVE_INFORMATION: 203;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.3.5
*
* There is no content to send for this request, but the headers may be useful. The user-agent may update its cached
* headers for this resource with the new ones.
*/
readonly NO_CONTENT: 204;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.3.6
*
* This response code is sent after accomplishing request to tell user agent reset document view which sent this
* request.
*/
readonly RESET_CONTENT: 205;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7233#section-4.1
*
* This response code is used because of range header sent by the client to separate download into multiple streams.
*/
readonly PARTIAL_CONTENT: 206;
/**
* Official Documentation: https://tools.ietf.org/html/rfc2518#section-10.2
*
* A Multi-Status response conveys information about multiple resources in situations where multiple status codes
* might be appropriate.
*/
readonly MULTI_STATUS: 207;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.4.1
*
* The request has more than one possible responses. User-agent or user should choose one of them. There is no
* standardized way to choose one of the responses.
*/
readonly MULTIPLE_CHOICES: 300;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.4.2
*
* This response code means that URI of requested resource has been changed. Probably, new URI would be given in the
* response.
*/
readonly MOVED_PERMANENTLY: 301;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.4.3
*
* This response code means that URI of requested resource has been changed temporarily. New changes in the URI might
* be made in the future. Therefore, this same URI should be used by the client in future requests.
*/
readonly MOVED_TEMPORARILY: 302;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.4.4
*
* Server sent this response to directing client to get requested resource to another URI with an GET request.
*/
readonly SEE_OTHER: 303;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7232#section-4.1
*
* This is used for caching purposes. It is telling to client that response has not been modified. So, client can
* continue to use same cached version of response.
*/
readonly NOT_MODIFIED: 304;
/**
* @deprecated
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.4.6
*
* Was defined in a previous version of the HTTP specification to indicate that a requested response must be accessed
* by a proxy. It has been deprecated due to security concerns regarding in-band configuration of a proxy.
*/
readonly USE_PROXY: 305;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.4.7
*
* Server sent this response to directing client to get requested resource to another URI with same method that used
* prior request. This has the same semantic as the 302 Found HTTP response code, with the exception that the user
* agent must not change the HTTP method used: if a POST was used in the first request, a POST must be used in the
* second request.
*/
readonly TEMPORARY_REDIRECT: 307;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7538#section-3
*
* This means that the resource is now permanently located at another URI, specified by the Location: HTTP Response
* header. This has the same semantics as the 301 Moved Permanently HTTP response code, with the exception that the
* user agent must not change the HTTP method used: if a POST was used in the first request, a POST must be used in
* the second request.
*/
readonly PERMANENT_REDIRECT: 308;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.5.1
*
* This response means that server could not understand the request due to invalid syntax.
*/
readonly BAD_REQUEST: 400;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7235#section-3.1
*
* Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is,
* the client must authenticate itself to get the requested response.
*/
readonly UNAUTHORIZED: 401;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.5.2
*
* This response code is reserved for future use. Initial aim for creating this code was using it for digital payment
* systems however this is not used currently.
*/
readonly PAYMENT_REQUIRED: 402;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.5.3
*
* The client does not have access rights to the content, i.e. they are unauthorized, so server is rejecting to give
* proper response. Unlike 401, the client's identity is known to the server.
*/
readonly FORBIDDEN: 403;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.5.4
*
* The server can not find requested resource. In the browser, this means the URL is not recognized. In an API, this
* can also mean that the endpoint is valid but the resource itself does not exist. Servers may also send this
* response instead of 403 to hide the existence of a resource from an unauthorized client. This response code is
* probably the most famous one due to its frequent occurrence on the web.
*/
readonly NOT_FOUND: 404;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.5.5
*
* The request method is known by the server but has been disabled and cannot be used. For example, an API may forbid
* DELETE-ing a resource. The two mandatory methods, GET and HEAD, must never be disabled and should not return this
* error code.
*/
readonly METHOD_NOT_ALLOWED: 405;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.5.6
*
* This response is sent when the web server, after performing server-driven content negotiation, doesn't find any
* content following the criteria given by the user agent.
*/
readonly NOT_ACCEPTABLE: 406;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7235#section-3.2
*
* This is similar to 401 but authentication is needed to be done by a proxy.
*/
readonly PROXY_AUTHENTICATION_REQUIRED: 407;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.5.7
*
* This response is sent on an idle connection by some servers, even without any previous request by the client. It
* means that the server would like to shut down this unused connection. This response is used much more since some
* browsers, like Chrome, Firefox 27+, or IE9, use HTTP pre-connection mechanisms to speed up surfing. Also note that
* some servers merely shut down the connection without sending this message.
*/
readonly REQUEST_TIMEOUT: 408;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.5.8
*
* This response is sent when a request conflicts with the current state of the server.
*/
readonly CONFLICT: 409;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.5.9
*
* This response would be sent when the requested content has been permanently deleted from server, with no
* forwarding address. Clients are expected to remove their caches and links to the resource. The HTTP specification
* intends this status code to be used for "limited-time, promotional services". APIs should not feel compelled to
* indicate resources that have been deleted with this status code.
*/
readonly GONE: 410;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.5.10
*
* The server rejected the request because the Content-Length header field is not defined and the server requires it.
*/
readonly LENGTH_REQUIRED: 411;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7232#section-4.2
*
* The client has indicated preconditions in its headers which the server does not meet.
*/
readonly PRECONDITION_FAILED: 412;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.5.11
*
* Request entity is larger than limits defined by server; the server might close the connection or return a
* Retry-After header field.
*/
readonly REQUEST_TOO_LONG: 413;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.5.12
*
* The URI requested by the client is longer than the server is willing to interpret.
*/
readonly REQUEST_URI_TOO_LONG: 414;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.5.13
*
* The media format of the requested data is not supported by the server, so the server is rejecting the request.
*/
readonly UNSUPPORTED_MEDIA_TYPE: 415;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7233#section-4.4
*
* The range specified by the Range header field in the request can't be fulfilled; it's possible that the range is
* outside the size of the target URI's data.
*/
readonly REQUESTED_RANGE_NOT_SATISFIABLE: 416;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.5.14
*
* This response code means the expectation indicated by the Expect request header field can't be met by the server.
*/
readonly EXPECTATION_FAILED: 417;
/**
* Official Documentation: https://tools.ietf.org/html/rfc2324#section-2.3.2
*
* Any attempt to brew coffee with a teapot should result in the error code "418 I'm a teapot". The resulting entity
* body MAY be short and stout.
*/
readonly IM_A_TEAPOT: 418;
/**
* Official Documentation: https://tools.ietf.org/html/rfc2518#section-10.6
*
* The 507 (Insufficient Storage) status code means the method could not be performed on the resource because the
* server is unable to store the representation needed to successfully complete the request. This condition is
* considered to be temporary. If the request which received this status code was the result of a user action, the
* request MUST NOT be repeated until it is requested by a separate user action.
*/
readonly INSUFFICIENT_SPACE_ON_RESOURCE: 419;
/**
* @deprecated
* Official Documentation: https://tools.ietf.org/rfcdiff?difftype=--hwdiff&url2=draft-ietf-webdav-protocol-06.txt
*
* A deprecated response used by the Spring Framework when a method has failed.
*/
readonly METHOD_FAILURE: 420;
/**
* Official Documentation: https://datatracker.ietf.org/doc/html/rfc7540#section-9.1.2
*
* Defined in the specification of HTTP/2 to indicate that a server is not able to produce a response for the
* combination of scheme and authority that are included in the request URI.
*/
readonly MISDIRECTED_REQUEST: 421;
/**
* Official Documentation: https://tools.ietf.org/html/rfc2518#section-10.3
*
* The request was well-formed but was unable to be followed due to semantic errors.
*/
readonly UNPROCESSABLE_ENTITY: 422;
/**
* Official Documentation: https://tools.ietf.org/html/rfc2518#section-10.4
*
* The resource that is being accessed is locked.
*/
readonly LOCKED: 423;
/**
* Official Documentation: https://tools.ietf.org/html/rfc2518#section-10.5
*
* The request failed due to failure of a previous request.
*/
readonly FAILED_DEPENDENCY: 424;
/**
* Official Documentation: https://datatracker.ietf.org/doc/html/rfc7231#section-6.5.15
*
* The server refuses to perform the request using the current protocol but might be willing to do so after the
* client upgrades to a different protocol.
*/
readonly UPGRADE_REQUIRED: 426;
/**
* Official Documentation: https://tools.ietf.org/html/rfc6585#section-3
*
* The origin server requires the request to be conditional. Intended to prevent the 'lost update' problem, where a
* client GETs a resource's state, modifies it, and PUTs it back to the server, when meanwhile a third party has
* modified the state on the server, leading to a conflict.
*/
readonly PRECONDITION_REQUIRED: 428;
/**
* Official Documentation: https://tools.ietf.org/html/rfc6585#section-4
*
* The user has sent too many requests in a given amount of time ("rate limiting").
*/
readonly TOO_MANY_REQUESTS: 429;
/**
* Official Documentation: https://tools.ietf.org/html/rfc6585#section-5
*
* The server is unwilling to process the request because its header fields are too large. The request MAY be
* resubmitted after reducing the size of the request header fields.
*/
readonly REQUEST_HEADER_FIELDS_TOO_LARGE: 431;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7725
*
* The user-agent requested a resource that cannot legally be provided, such as a web page censored by a government.
*/
readonly UNAVAILABLE_FOR_LEGAL_REASONS: 451;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.6.1
*
* The server encountered an unexpected condition that prevented it from fulfilling the request.
*/
readonly INTERNAL_SERVER_ERROR: 500;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.6.2
*
* The request method is not supported by the server and cannot be handled. The only methods that servers are
* required to support (and therefore that must not return this code) are GET and HEAD.
*/
readonly NOT_IMPLEMENTED: 501;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.6.3
*
* This error response means that the server, while working as a gateway to get a response needed to handle the
* request, got an invalid response.
*/
readonly BAD_GATEWAY: 502;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.6.4
*
* The server is not ready to handle the request. Common causes are a server that is down for maintenance or that is
* overloaded. Note that together with this response, a user-friendly page explaining the problem should be sent.
* This responses should be used for temporary conditions and the Retry-After: HTTP header should, if possible,
* contain the estimated time before the recovery of the service. The webmaster must also take care about the
* caching-related headers that are sent along with this response, as these temporary condition responses should
* usually not be cached.
*/
readonly SERVICE_UNAVAILABLE: 503;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.6.5
*
* This error response is given when the server is acting as a gateway and cannot get a response in time.
*/
readonly GATEWAY_TIMEOUT: 504;
/**
* Official Documentation: https://tools.ietf.org/html/rfc7231#section-6.6.6
*
* The HTTP version used in the request is not supported by the server.
*/
readonly HTTP_VERSION_NOT_SUPPORTED: 505;
/**
* Official Documentation: https://tools.ietf.org/html/rfc2518#section-10.6
*
* The server has an internal configuration error: the chosen variant resource is configured to engage in transparent
* content negotiation itself, and is therefore not a proper end point in the negotiation process.
*/
readonly INSUFFICIENT_STORAGE: 507;
/**
* Official Documentation: https://tools.ietf.org/html/rfc6585#section-6
*
* The 511 status code indicates that the client needs to authenticate to gain network access.
*/
readonly NETWORK_AUTHENTICATION_REQUIRED: 511;
};
/** Union type of all defined HTTP status codes */
export type HttpStatusCode = (typeof HttpStatus)[keyof typeof HttpStatus];