From 8355bd2ae48954115d132dd42a40b1d3de1d9b2e Mon Sep 17 00:00:00 2001
From: Corentin Thomasset <corentin.thomasset74@gmail.com>
Date: Fri, 14 Apr 2023 01:20:47 +0200
Subject: [PATCH] feat(new-tool): http status codes

---
 components.d.ts                               |   1 +
 .../http-status-codes.constants.ts            | 432 ++++++++++++++++++
 .../http-status-codes.e2e.spec.ts             |  11 +
 .../http-status-codes/http-status-codes.vue   |  60 +++
 src/tools/http-status-codes/index.ts          |  19 +
 src/tools/index.ts                            |   2 +
 6 files changed, 525 insertions(+)
 create mode 100644 src/tools/http-status-codes/http-status-codes.constants.ts
 create mode 100644 src/tools/http-status-codes/http-status-codes.e2e.spec.ts
 create mode 100644 src/tools/http-status-codes/http-status-codes.vue
 create mode 100644 src/tools/http-status-codes/index.ts

diff --git a/components.d.ts b/components.d.ts
index e9290ef4..8c75790d 100644
--- a/components.d.ts
+++ b/components.d.ts
@@ -37,6 +37,7 @@ declare module '@vue/runtime-core' {
     NH1: typeof import('naive-ui')['NH1']
     NH2: typeof import('naive-ui')['NH2']
     NH3: typeof import('naive-ui')['NH3']
+    NH4: typeof import('naive-ui')['NH4']
     NIcon: typeof import('naive-ui')['NIcon']
     NImage: typeof import('naive-ui')['NImage']
     NInput: typeof import('naive-ui')['NInput']
diff --git a/src/tools/http-status-codes/http-status-codes.constants.ts b/src/tools/http-status-codes/http-status-codes.constants.ts
new file mode 100644
index 00000000..c64bda06
--- /dev/null
+++ b/src/tools/http-status-codes/http-status-codes.constants.ts
@@ -0,0 +1,432 @@
+export const codesByCategories: {
+  category: string;
+  codes: {
+    code: number;
+    name: string;
+    description: string;
+    type: 'HTTP' | 'WebDav';
+  }[];
+}[] = [
+  {
+    category: '1xx informational response',
+    codes: [
+      {
+        code: 100,
+        name: 'Continue',
+        description: 'Waiting for the client to emit the body of the request.',
+        type: 'HTTP',
+      },
+      {
+        code: 101,
+        name: 'Switching Protocols',
+        description: 'The server has agreed to change protocol.',
+        type: 'HTTP',
+      },
+      {
+        code: 102,
+        name: 'Processing',
+        description: 'The server is processing the request, but no response is available yet.',
+        type: 'WebDav',
+      },
+      {
+        code: 103,
+        name: 'Early Hints',
+        description: 'The server returns some response headers before final HTTP message.',
+        type: 'HTTP',
+      },
+    ],
+  },
+  {
+    category: '2xx success',
+    codes: [
+      {
+        code: 200,
+        name: 'OK',
+        description: 'Standard response for successful HTTP requests.',
+        type: 'HTTP',
+      },
+      {
+        code: 201,
+        name: 'Created',
+        description: 'The request has been fulfilled, resulting in the creation of a new resource.',
+        type: 'HTTP',
+      },
+      {
+        code: 202,
+        name: 'Accepted',
+        description: 'The request has been accepted for processing, but the processing has not been completed.',
+        type: 'HTTP',
+      },
+      {
+        code: 203,
+        name: 'Non-Authoritative Information',
+        description:
+          'The request is successful but the content of the original request has been modified by a transforming proxy.',
+        type: 'HTTP',
+      },
+      {
+        code: 204,
+        name: 'No Content',
+        description: 'The server successfully processed the request and is not returning any content.',
+        type: 'HTTP',
+      },
+      {
+        code: 205,
+        name: 'Reset Content',
+        description: 'The server indicates to reinitialize the document view which sent this request.',
+        type: 'HTTP',
+      },
+      {
+        code: 206,
+        name: 'Partial Content',
+        description: 'The server is delivering only part of the resource due to a range header sent by the client.',
+        type: 'HTTP',
+      },
+      {
+        code: 207,
+        name: 'Multi-Status',
+        description:
+          'The message body that follows is an XML message and can contain a number of separate response codes.',
+        type: 'WebDav',
+      },
+      {
+        code: 208,
+        name: 'Already Reported',
+        description:
+          'The members of a DAV binding have already been enumerated in a preceding part of the (multistatus) response.',
+        type: 'WebDav',
+      },
+      {
+        code: 226,
+        name: 'IM Used',
+        description:
+          'The server has fulfilled a request for the resource, and the response is a representation of the result.',
+        type: 'HTTP',
+      },
+    ],
+  },
+  {
+    category: '3xx redirection',
+    codes: [
+      {
+        code: 300,
+        name: 'Multiple Choices',
+        description: 'Indicates multiple options for the resource that the client may follow.',
+        type: 'HTTP',
+      },
+      {
+        code: 301,
+        name: 'Moved Permanently',
+        description: 'This and all future requests should be directed to the given URI.',
+        type: 'HTTP',
+      },
+      {
+        code: 302,
+        name: 'Found',
+        description: 'Redirect to another URL. This is an example of industry practice contradicting the standard.',
+        type: 'HTTP',
+      },
+      {
+        code: 303,
+        name: 'See Other',
+        description: 'The response to the request can be found under another URI using a GET method.',
+        type: 'HTTP',
+      },
+      {
+        code: 304,
+        name: 'Not Modified',
+        description:
+          'Indicates that the resource has not been modified since the version specified by the request headers.',
+        type: 'HTTP',
+      },
+      {
+        code: 305,
+        name: 'Use Proxy',
+        description:
+          'The requested resource is available only through a proxy, the address for which is provided in the response.',
+        type: 'HTTP',
+      },
+      {
+        code: 306,
+        name: 'Switch Proxy',
+        description: 'No longer used. Originally meant "Subsequent requests should use the specified proxy."',
+        type: 'HTTP',
+      },
+      {
+        code: 307,
+        name: 'Temporary Redirect',
+        description:
+          'In this case, the request should be repeated with another URI; however, future requests should still use the original URI.',
+        type: 'HTTP',
+      },
+      {
+        code: 308,
+        name: 'Permanent Redirect',
+        description: 'The request and all future requests should be repeated using another URI.',
+        type: 'HTTP',
+      },
+    ],
+  },
+  {
+    category: '4xx client error',
+    codes: [
+      {
+        code: 400,
+        name: 'Bad Request',
+        description: 'The server cannot or will not process the request due to an apparent client error.',
+        type: 'HTTP',
+      },
+      {
+        code: 401,
+        name: 'Unauthorized',
+        description:
+          'Similar to 403 Forbidden, but specifically for use when authentication is required and has failed or has not yet been provided.',
+        type: 'HTTP',
+      },
+      {
+        code: 402,
+        name: 'Payment Required',
+        description:
+          'Reserved for future use. The original intention was that this code might be used as part of some form of digital cash or micropayment scheme.',
+        type: 'HTTP',
+      },
+      {
+        code: 403,
+        name: 'Forbidden',
+        description:
+          'The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.',
+        type: 'HTTP',
+      },
+      {
+        code: 404,
+        name: 'Not Found',
+        description: 'The requested resource could not be found but may be available in the future.',
+        type: 'HTTP',
+      },
+      {
+        code: 405,
+        name: 'Method Not Allowed',
+        description: 'A request method is not supported for the requested resource.',
+        type: 'HTTP',
+      },
+      {
+        code: 406,
+        name: 'Not Acceptable',
+        description:
+          'The requested resource is capable of generating only content not acceptable according to the Accept headers sent in the request.',
+        type: 'HTTP',
+      },
+      {
+        code: 407,
+        name: 'Proxy Authentication Required',
+        description: 'The client must first authenticate itself with the proxy.',
+        type: 'HTTP',
+      },
+      {
+        code: 408,
+        name: 'Request Timeout',
+        description: 'The server timed out waiting for the request.',
+        type: 'HTTP',
+      },
+      {
+        code: 409,
+        name: 'Conflict',
+        description:
+          'Indicates that the request could not be processed because of conflict in the request, such as an edit conflict.',
+        type: 'HTTP',
+      },
+      {
+        code: 410,
+        name: 'Gone',
+        description: 'Indicates that the resource requested is no longer available and will not be available again.',
+        type: 'HTTP',
+      },
+      {
+        code: 411,
+        name: 'Length Required',
+        description:
+          'The request did not specify the length of its content, which is required by the requested resource.',
+        type: 'HTTP',
+      },
+      {
+        code: 412,
+        name: 'Precondition Failed',
+        description: 'The server does not meet one of the preconditions that the requester put on the request.',
+        type: 'HTTP',
+      },
+      {
+        code: 413,
+        name: 'Payload Too Large',
+        description: 'The request is larger than the server is willing or able to process.',
+        type: 'HTTP',
+      },
+      {
+        code: 414,
+        name: 'URI Too Long',
+        description: 'The URI provided was too long for the server to process.',
+        type: 'HTTP',
+      },
+      {
+        code: 415,
+        name: 'Unsupported Media Type',
+        description: 'The request entity has a media type which the server or resource does not support.',
+        type: 'HTTP',
+      },
+      {
+        code: 416,
+        name: 'Range Not Satisfiable',
+        description: 'The client has asked for a portion of the file, but the server cannot supply that portion.',
+        type: 'HTTP',
+      },
+      {
+        code: 417,
+        name: 'Expectation Failed',
+        description: 'The server cannot meet the requirements of the Expect request-header field.',
+        type: 'HTTP',
+      },
+      {
+        code: 418,
+        name: "I'm a teapot",
+        description: 'The server refuses the attempt to brew coffee with a teapot.',
+        type: 'HTTP',
+      },
+      {
+        code: 421,
+        name: 'Misdirected Request',
+        description: 'The request was directed at a server that is not able to produce a response.',
+        type: 'HTTP',
+      },
+      {
+        code: 422,
+        name: 'Unprocessable Entity',
+        description: 'The request was well-formed but was unable to be followed due to semantic errors.',
+        type: 'HTTP',
+      },
+      {
+        code: 423,
+        name: 'Locked',
+        description: 'The resource that is being accessed is locked.',
+        type: 'HTTP',
+      },
+      {
+        code: 424,
+        name: 'Failed Dependency',
+        description: 'The request failed due to failure of a previous request.',
+        type: 'HTTP',
+      },
+      {
+        code: 425,
+        name: 'Too Early',
+        description: 'Indicates that the server is unwilling to risk processing a request that might be replayed.',
+        type: 'HTTP',
+      },
+      {
+        code: 426,
+        name: 'Upgrade Required',
+        description: 'The client should switch to a different protocol such as TLS/1.0.',
+        type: 'HTTP',
+      },
+      {
+        code: 428,
+        name: 'Precondition Required',
+        description: 'The origin server requires the request to be conditional.',
+        type: 'HTTP',
+      },
+      {
+        code: 429,
+        name: 'Too Many Requests',
+        description: 'The user has sent too many requests in a given amount of time.',
+        type: 'HTTP',
+      },
+      {
+        code: 431,
+        name: 'Request Header Fields Too Large',
+        description:
+          'The server is unwilling to process the request because either an individual header field, or all the header fields collectively, are too large.',
+        type: 'HTTP',
+      },
+      {
+        code: 451,
+        name: 'Unavailable For Legal Reasons',
+        description:
+          'A server operator has received a legal demand to deny access to a resource or to a set of resources that includes the requested resource.',
+        type: 'HTTP',
+      },
+    ],
+  },
+  {
+    category: '5xx server error',
+    codes: [
+      {
+        code: 500,
+        name: 'Internal Server Error',
+        description:
+          'A generic error message, given when an unexpected condition was encountered and no more specific message is suitable.',
+        type: 'HTTP',
+      },
+      {
+        code: 501,
+        name: 'Not Implemented',
+        description:
+          'The server either does not recognize the request method, or it lacks the ability to fulfill the request.',
+        type: 'HTTP',
+      },
+      {
+        code: 502,
+        name: 'Bad Gateway',
+        description:
+          'The server was acting as a gateway or proxy and received an invalid response from the upstream server.',
+        type: 'HTTP',
+      },
+      {
+        code: 503,
+        name: 'Service Unavailable',
+        description: 'The server is currently unavailable (because it is overloaded or down for maintenance).',
+        type: 'HTTP',
+      },
+      {
+        code: 504,
+        name: 'Gateway Timeout',
+        description:
+          'The server was acting as a gateway or proxy and did not receive a timely response from the upstream server.',
+        type: 'HTTP',
+      },
+      {
+        code: 505,
+        name: 'HTTP Version Not Supported',
+        description: 'The server does not support the HTTP protocol version used in the request.',
+        type: 'HTTP',
+      },
+      {
+        code: 506,
+        name: 'Variant Also Negotiates',
+        description: 'Transparent content negotiation for the request results in a circular reference.',
+        type: 'HTTP',
+      },
+      {
+        code: 507,
+        name: 'Insufficient Storage',
+        description: 'The server is unable to store the representation needed to complete the request.',
+        type: 'HTTP',
+      },
+      {
+        code: 508,
+        name: 'Loop Detected',
+        description: 'The server detected an infinite loop while processing the request.',
+        type: 'HTTP',
+      },
+      {
+        code: 510,
+        name: 'Not Extended',
+        description: 'Further extensions to the request are required for the server to fulfill it.',
+        type: 'HTTP',
+      },
+      {
+        code: 511,
+        name: 'Network Authentication Required',
+        description: 'The client needs to authenticate to gain network access.',
+        type: 'HTTP',
+      },
+    ],
+  },
+];
diff --git a/src/tools/http-status-codes/http-status-codes.e2e.spec.ts b/src/tools/http-status-codes/http-status-codes.e2e.spec.ts
new file mode 100644
index 00000000..59979cd2
--- /dev/null
+++ b/src/tools/http-status-codes/http-status-codes.e2e.spec.ts
@@ -0,0 +1,11 @@
+import { test, expect } from '@playwright/test';
+
+test.describe('Tool - Http status codes', () => {
+  test.beforeEach(async ({ page }) => {
+    await page.goto('/http-status-codes');
+  });
+
+  test('Has correct title', async ({ page }) => {
+    await expect(page).toHaveTitle('HTTP status codes - IT Tools');
+  });
+});
diff --git a/src/tools/http-status-codes/http-status-codes.vue b/src/tools/http-status-codes/http-status-codes.vue
new file mode 100644
index 00000000..48bd77f7
--- /dev/null
+++ b/src/tools/http-status-codes/http-status-codes.vue
@@ -0,0 +1,60 @@
+<template>
+  <div>
+    <n-form-item :show-label="false">
+      <n-input
+        v-model:value="search"
+        placeholder="Search http status..."
+        size="large"
+        autofocus
+        mb-10
+        autocomplete="off"
+        autocorrect="off"
+        autocapitalize="off"
+      >
+        <template #prefix>
+          <n-icon :component="SearchRound" />
+        </template>
+      </n-input>
+    </n-form-item>
+
+    <div v-for="{ codes, category } of codesByCategoryFiltered" :key="category" mb-8>
+      <n-h2> {{ category }} </n-h2>
+
+      <n-space vertical :size="20">
+        <n-card v-for="{ code, description, name, type } of codes" :key="code">
+          <n-space align="center">
+            <n-text strong text-lg> {{ code }} {{ name }} </n-text>
+          </n-space>
+          <n-text depth="3">{{ description }} {{ type !== 'HTTP' ? `For ${type}.` : '' }}</n-text>
+        </n-card>
+      </n-space>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { useFuzzySearch } from '@/composable/fuzzySearch';
+import _ from 'lodash';
+import { SearchRound } from '@vicons/material';
+import { codesByCategories } from './http-status-codes.constants';
+
+const search = ref('');
+
+const { searchResult } = useFuzzySearch({
+  search,
+  data: codesByCategories.flatMap(({ codes, category }) => codes.map((code) => ({ ...code, category }))),
+  options: {
+    keys: [{ name: 'code', weight: 3 }, { name: 'name', weight: 2 }, 'description', 'category'],
+  },
+});
+
+const codesByCategoryFiltered = computed(() => {
+  if (!search.value) {
+    return codesByCategories;
+  }
+
+  return [{ category: 'Search results', codes: searchResult.value }];
+});
+</script>
+
+<style lang="less" scoped></style>
diff --git a/src/tools/http-status-codes/index.ts b/src/tools/http-status-codes/index.ts
new file mode 100644
index 00000000..43afae83
--- /dev/null
+++ b/src/tools/http-status-codes/index.ts
@@ -0,0 +1,19 @@
+import { HttpRound } from '@vicons/material';
+import { defineTool } from '../tool';
+
+import { codesByCategories } from './http-status-codes.constants';
+
+export const tool = defineTool({
+  name: 'HTTP status codes',
+  path: '/http-status-codes',
+  description: 'The list of all HTTP status codes their name and their meaning.',
+  keywords: [
+    'http',
+    'status',
+    'codes',
+    ...codesByCategories.flatMap(({ codes }) => codes.flatMap(({ code, name }) => [String(code), name])),
+  ],
+  component: () => import('./http-status-codes.vue'),
+  icon: HttpRound,
+  createdAt: new Date('2023-04-13'),
+});
diff --git a/src/tools/index.ts b/src/tools/index.ts
index 5cb0cdcb..ad6167e1 100644
--- a/src/tools/index.ts
+++ b/src/tools/index.ts
@@ -1,6 +1,7 @@
 import { tool as base64FileConverter } from './base64-file-converter';
 import { tool as base64StringConverter } from './base64-string-converter';
 import { tool as basicAuthGenerator } from './basic-auth-generator';
+import { tool as httpStatusCodes } from './http-status-codes';
 import { tool as yamlToJson } from './yaml-to-json-converter';
 import { tool as jsonToYaml } from './json-to-yaml-converter';
 import { tool as ipv6UlaGenerator } from './ipv6-ula-generator';
@@ -88,6 +89,7 @@ export const toolsByCategory: ToolCategory[] = [
       slugifyString,
       htmlWysiwygEditor,
       userAgentParser,
+      httpStatusCodes,
     ],
   },
   {