@md-oss/common 0.1.0

package/LICENSE

@@ -0,0 +1,5 @@
+Copyright 2026 Mirasaki Development
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED “AS IS” AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,335 @@
+# @md-oss/common
+
+Constants, magic numbers, and utilities used commonly across projects.
+
+## Table of Contents
+
+- [Constants](#constants)
+- [Utilities](#utilities)
+- [API](#api)
+- [Schemas](#schemas)
+
+## Constants
+
+### Byte Sizes
+```typescript
+import { ByteMagic } from '@md-oss/common';
+
+console.log(ByteMagic.MEGABYTE); // 1048576
+console.log(ByteMagic.GIGABYTE); // 1073741824
+```
+
+### Discord Limits
+```typescript
+import { DiscordMagic } from '@md-oss/common';
+
+console.log(DiscordMagic.MESSAGE_CONTENT_MAX); // 2000
+console.log(DiscordMagic.EMBED_DESCRIPTION_MAX); // 4096
+console.log(DiscordMagic.FILE_SIZE_MAX); // 8388608 (8MB)
+```
+
+### Time Conversions
+```typescript
+import { TimeMagic } from '@md-oss/common';
+
+console.log(TimeMagic.SECOND); // 1000ms
+console.log(TimeMagic.MINUTES_PER_HOUR); // 60
+console.log(TimeMagic.MILLISECONDS_PER_DAY); // 86400000
+```
+
+## Utilities
+
+### Array Utilities
+```typescript
+import { ArrayUtils } from '@md-oss/common';
+
+// Chunk an array
+ArrayUtils.chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
+
+// Join with max items
+ArrayUtils.join(['a', 'b', 'c', 'd'], { maxItems: 2 });
+// "a, b, and 2 more..."
+
+// Type guards
+ArrayUtils.isStringArray(['a', 'b']); // true
+ArrayUtils.isNumberArray([1, 2, 3]); // true
+```
+
+### String Utilities
+```typescript
+import { StringUtils } from '@md-oss/common';
+
+// Case conversions
+StringUtils.camelCase('hello world'); // 'helloWorld'
+StringUtils.kebabCase('HelloWorld'); // 'hello-world'
+StringUtils.snakeCase('HelloWorld'); // 'hello_world'
+StringUtils.titleCase('hello world'); // 'Hello World'
+StringUtils.pascalCase('hello world'); // 'HelloWorld'
+
+// String manipulation
+StringUtils.truncate('hello world', 8); // 'hello...'
+StringUtils.pluralize('item', 2); // 'items'
+StringUtils.replaceTags('Hello {name}', { name: 'John' }); // 'Hello John'
+StringUtils.isUrl('https://example.com'); // true
+```
+
+### Number Utilities
+```typescript
+import { NumberUtils } from '@md-oss/common';
+
+// Type checks
+NumberUtils.isInt(42); // true
+NumberUtils.isFloat(42.5); // true
+
+// Statistics
+NumberUtils.calculateMean([1, 2, 3, 4]); // 2.5
+NumberUtils.calculateMedian([1, 2, 3, 4, 5]); // 3
+NumberUtils.calculateVariance([1, 2, 3, 4]); // 1.25
+NumberUtils.calculateStandardDeviation([1, 2, 3, 4]); // ~1.118
+
+// Constants
+NumberUtils.INT32_MAX; // 2147483647
+NumberUtils.INT64_MAX; // 9223372036854775807n
+```
+
+### Object Utilities
+```typescript
+import { ObjectUtils } from '@md-oss/common';
+
+// Type guards
+ObjectUtils.isObject({ a: 1 }); // true
+ObjectUtils.isEmptyObject({}); // true
+
+// Deep operations
+const cloned = ObjectUtils.deepClone({ a: { b: 1 } });
+const merged = ObjectUtils.deepMerge({ a: 1 }, { b: 2 }); // { a: 1, b: 2 }
+
+// Nested value access
+ObjectUtils.getNestedValue({ a: { b: { c: 1 } } }, 'a.b.c'); // 1
+ObjectUtils.getNestedValue({ user: { name: 'John' } }, 'user.name'); // 'John'
+```
+
+### Random Utilities
+```typescript
+import { RandomUtils } from '@md-oss/common';
+
+// Random numbers
+RandomUtils.randomInt(1, 10); // random int between 1-10
+RandomUtils.randomFloat(0, 1); // random float between 0-1
+RandomUtils.randomBoolean(); // true or false
+
+// Random selections
+RandomUtils.randomItem([1, 2, 3, 4, 5]); // random item
+RandomUtils.randomKey({ a: 1, b: 2 }); // 'a' or 'b'
+RandomUtils.randomValue({ a: 1, b: 2 }); // 1 or 2
+
+// Random strings
+RandomUtils.randomString(8, { useUppercase: true, useNumeric: true });
+// e.g., 'A3bF9xK1'
+```
+
+### Time Utilities
+```typescript
+import { TimeUtils } from '@md-oss/common';
+
+// Unix timestamps
+TimeUtils.unix(Date.now()); // current unix timestamp
+TimeUtils.unixNow(); // shorthand for unix(Date.now())
+
+// Human-readable durations
+TimeUtils.humanReadableMs(5000); // '5 seconds'
+TimeUtils.humanReadableMs(125000, 3); // '2 minutes and 5 seconds'
+
+// Async utilities
+await TimeUtils.sleep(1000); // sleep for 1 second
+
+// Performance tracking
+TimeUtils.hrTimeToMs([0, 123456789]); // convert hrtime to milliseconds
+TimeUtils.bigIntDurationToHumanReadable(startTime); // format duration
+```
+
+### Runtime Utilities
+```typescript
+import { RuntimeUtils } from '@md-oss/common';
+
+// Sleep utilities
+await RuntimeUtils.sleep(1000); // sleep for 1 second
+await RuntimeUtils.sleepUntil(() => someCondition);
+await RuntimeUtils.sleepUntilOrTimeout(() => someCondition, 5000);
+
+// Await with timeout
+const result = await RuntimeUtils.awaitOrTimeout(promise, 5000);
+
+// Safe timeout/interval (handles values > INT32_MAX)
+RuntimeUtils.safeSetTimeout(86400000, false, () => {
+  console.log('runs after 24 hours');
+});
+
+RuntimeUtils.safeSetInterval(1000, () => {
+  console.log('runs every second');
+});
+
+RuntimeUtils.safeSetAsyncInterval(1000, async () => {
+  await doAsyncWork();
+});
+```
+
+### MIME Type Utilities
+```typescript
+import { MimeTypeUtils } from '@md-oss/common';
+
+// Validation
+MimeTypeUtils.isAllowedMimeType('image/png', 'IMAGE'); // true
+MimeTypeUtils.isAllowedMimeType('application/pdf', 'SAFE'); // true
+
+// HTML input accept strings
+MimeTypeUtils.getInputAccept('IMAGE'); 
+// 'image/png,image/jpeg,image/webp,...'
+
+// Type resolution
+MimeTypeUtils.mimeTypeResolver('video/mp4'); // 'VIDEO'
+MimeTypeUtils.mimeTypeResolver('application/pdf'); // 'DOCUMENT'
+
+// Content disposition
+MimeTypeUtils.isInlineContentDisposition('image/png'); // true
+MimeTypeUtils.isInlineContentDisposition('application/zip'); // false
+```
+
+## API
+
+### Status Codes
+```typescript
+import { statusCodes, type StatusCode } from '@md-oss/common';
+
+// Use named status codes
+statusCodes.OK; // 200
+statusCodes.CREATED; // 201
+statusCodes.BAD_REQUEST; // 400
+statusCodes.UNAUTHORIZED; // 401
+statusCodes.NOT_FOUND; // 404
+statusCodes.INTERNAL_SERVER_ERROR; // 500
+```
+
+### API Errors
+```typescript
+import { APIError, isAPIError, parseError } from '@md-oss/common';
+
+// Create API errors
+const error = new APIError(404, {
+  code: 'NOT_FOUND',
+  message: 'Resource not found',
+  details: { id: '123' }
+});
+
+// Alternative constructor syntax
+const error2 = new APIError({
+  status: 400,
+  code: 'VALIDATION_ERROR',
+  message: 'Invalid input',
+  headers: { 'X-Custom': 'value' }
+});
+
+// Type guards
+if (isAPIError(error)) {
+  console.log(error.statusCode, error.body.code);
+}
+
+// Parse unknown errors into APIError
+try {
+  await someOperation();
+} catch (err) {
+  const apiError = parseError(err, 'OPERATION_FAILED', 'Operation failed');
+  throw apiError;
+}
+
+// Serialize to JSON
+const json = error.toJSON();
+```
+
+### Request/Response Types
+```typescript
+import type { 
+  MinimalRequest, 
+  MinimalResponse, 
+  MinimalNextFunction,
+  MinimalRequestHandler 
+} from '@md-oss/common';
+
+// Framework-agnostic request handler types
+const handler: MinimalRequestHandler = async (req, res, next) => {
+  const userIp = req.ip;
+  const params = req.params;
+  const query = req.query;
+  
+  res.status(200).json({ success: true });
+};
+```
+
+## Schemas
+
+### Zod Utilities
+```typescript
+import { 
+  isFieldRequired, 
+  requiredKeys, 
+  zodEnumFromObjectKeys,
+  paginationQuerySchema 
+} from '@md-oss/common';
+import { z } from 'zod';
+
+// Check if a field is required
+const schema = z.object({
+  name: z.string(),
+  age: z.number().optional(),
+});
+isFieldRequired(schema, 'name'); // true
+isFieldRequired(schema, 'age'); // false
+
+// Get all required keys
+const required = requiredKeys(schema);
+// ['name']
+
+// Create enum from object keys
+const roles = { ADMIN: 1, USER: 2, GUEST: 3 };
+const roleEnum = zodEnumFromObjectKeys(roles);
+// z.enum(['ADMIN', 'USER', 'GUEST'])
+
+// Pagination schema
+const paginationSchema = paginationQuerySchema({
+  min: 1,
+  max: 100,
+  defaultLimit: 25
+});
+
+// Parse pagination query
+const { limit, offset } = paginationSchema.parse({
+  limit: '50',
+  offset: '0'
+});
+```
+
+### Signed URL Schema
+```typescript
+import { signedUrlSchema, type SignedUrlSchema } from '@md-oss/common';
+
+// Validate signed URL parameters
+const params = signedUrlSchema.parse({
+  expires: 1640995200,
+  sig: 'abc123',
+  ref: 'user-123'
+});
+```
+
+### Pagination Type
+```typescript
+import type { Pagination } from '@md-oss/common';
+
+const pagination: Pagination = {
+  totalItems: 100,
+  currentPage: 1,
+  itemsPerPage: 25,
+  totalPages: 4,
+  limit: 25,
+  offset: 0
+};
+```

package/dist/api/errors.cjs

@@ -0,0 +1,2 @@
+"use strict";var u=Object.defineProperty;var o=(s,e)=>u(s,"name",{value:e,configurable:!0});const{NODE_ENV:d}=process.env;class t extends Error{static{o(this,"APIError")}ok=!1;statusCode;headers;body;constructor(e,i,b){super(),typeof e=="object"?(this.statusCode=e.status,this.headers=e.headers??{},this.body={code:e.code,message:e.message,details:e.details}):(this.statusCode=e,this.headers=b??{},this.body=i||{code:"INTERNAL_SERVER_ERROR",message:"An error occurred, but no additional information is available."}),this.message=`[${this.body.code}]: ${this.body.message}`}toJSON(){return{ok:this.ok,statusCode:this.statusCode,body:this.body,headers:this.headers}}}const n=o(s=>s instanceof t?!0:a(s)?(s=new t(s.statusCode,{code:s.body.code,message:s.body.message,details:s.body.details}),!0):!1,"isAPIError"),a=o(s=>typeof s=="object"&&s!==null&&"ok"in s&&s.ok===!1&&"statusCode"in s&&typeof s.statusCode=="number"&&"body"in s&&typeof s.body=="object"&&s.body!==null&&"code"in s.body&&typeof s.body.code=="string"&&"message"in s.body&&typeof s.body.message=="string","isAPIErrorResponse"),c=o((s,e,i)=>n(s)?new t(s.statusCode,{code:e,message:s.body.message,details:s.body.details}):a(s)?new t(s.statusCode,{code:e,message:s.body.message,details:s.body.details}):s instanceof Error?new t(500,{code:e,message:i,details:d==="production"?void 0:{message:s.message,stack:s.stack}}):new t(500,{code:e,message:i,details:d==="production"?void 0:JSON.stringify(s,null,2)}),"parseError");exports.APIError=t,exports.isAPIError=n,exports.isAPIErrorResponse=a,exports.parseError=c;
+//# sourceMappingURL=errors.cjs.map

package/dist/api/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","sources":["../../src/api/errors.ts"],"sourcesContent":["import type { StatusCode } from './status-codes';\n\nconst { NODE_ENV } = process.env;\n\ntype APIErrorResponse = {\n\tok: false;\n\tstatusCode: StatusCode;\n\tbody: {\n\t\tcode: string;\n\t\tmessage: string;\n\t\tdetails?: string | Record<string, unknown>;\n\t};\n\theaders?: HeadersInit;\n};\n\ntype HeadersInit = Record<string, string> | Array<[string, string]> | Headers;\n\nclass APIError extends Error {\n\treadonly ok = false;\n\treadonly statusCode: StatusCode;\n\treadonly headers: HeadersInit;\n\treadonly body: {\n\t\tcode: string;\n\t\tmessage: string;\n\t\tdetails?: string | Record<string, unknown>;\n\t};\n\n\tconstructor(body: {\n\t\tstatus: StatusCode;\n\t\tcode: string;\n\t\tmessage: string;\n\t\tdetails?: string | Record<string, unknown>;\n\t\theaders?: HeadersInit;\n\t});\n\tconstructor(\n\t\tstatusCode: StatusCode,\n\t\tbody: {\n\t\t\tcode: string;\n\t\t\tmessage: string;\n\t\t\tdetails?: string | Record<string, unknown>;\n\t\t},\n\t\theaders?: HeadersInit\n\t);\n\tconstructor(\n\t\tstatusCodeOrBody:\n\t\t\t| StatusCode\n\t\t\t| {\n\t\t\t\t\tstatus: StatusCode;\n\t\t\t\t\tcode: string;\n\t\t\t\t\tmessage: string;\n\t\t\t\t\tdetails?: string | Record<string, unknown>;\n\t\t\t\t\theaders?: HeadersInit;\n\t\t\t  },\n\t\tbody?: {\n\t\t\tcode: string;\n\t\t\tmessage: string;\n\t\t\tdetails?: string | Record<string, unknown>;\n\t\t},\n\t\theaders?: HeadersInit\n\t) {\n\t\tsuper();\n\n\t\tif (typeof statusCodeOrBody === 'object') {\n\t\t\t// Single argument signature\n\t\t\tthis.statusCode = statusCodeOrBody.status;\n\t\t\tthis.headers = statusCodeOrBody.headers ?? {};\n\t\t\tthis.body = {\n\t\t\t\tcode: statusCodeOrBody.code,\n\t\t\t\tmessage: statusCodeOrBody.message,\n\t\t\t\tdetails: statusCodeOrBody.details,\n\t\t\t};\n\t\t} else {\n\t\t\t// Multi-argument signature\n\t\t\tthis.statusCode = statusCodeOrBody;\n\t\t\tthis.headers = headers ?? {};\n\t\t\tthis.body = body || {\n\t\t\t\tcode: 'INTERNAL_SERVER_ERROR',\n\t\t\t\tmessage:\n\t\t\t\t\t'An error occurred, but no additional information is available.',\n\t\t\t};\n\t\t}\n\n\t\tthis.message = `[${this.body.code}]: ${this.body.message}`;\n\t}\n\n\ttoJSON(): APIErrorResponse {\n\t\treturn {\n\t\t\tok: this.ok,\n\t\t\tstatusCode: this.statusCode,\n\t\t\tbody: this.body,\n\t\t\theaders: this.headers,\n\t\t} satisfies APIErrorResponse;\n\t}\n}\n\n//\n// Start Guards\n//\n\ninterface APISuccessResponse<T> {\n\tok: true;\n\tcode: number;\n\tmessage: string | null;\n\tdata: T;\n}\n\nconst isAPIError = (r: unknown): r is APIError => {\n\tif (r instanceof APIError) {\n\t\treturn true;\n\t}\n\n\tif (isAPIErrorResponse(r)) {\n\t\tr = new APIError(r.statusCode, {\n\t\t\tcode: r.body.code,\n\t\t\tmessage: r.body.message,\n\t\t\tdetails: r.body.details,\n\t\t});\n\t\treturn true;\n\t}\n\n\treturn false;\n};\n\nconst isAPIErrorResponse = (r: unknown): r is APIErrorResponse => {\n\treturn (\n\t\ttypeof r === 'object' &&\n\t\tr !== null &&\n\t\t'ok' in r &&\n\t\tr.ok === false &&\n\t\t'statusCode' in r &&\n\t\ttypeof r.statusCode === 'number' &&\n\t\t'body' in r &&\n\t\ttypeof r.body === 'object' &&\n\t\tr.body !== null &&\n\t\t'code' in r.body &&\n\t\ttypeof r.body.code === 'string' &&\n\t\t'message' in r.body &&\n\t\ttypeof r.body.message === 'string'\n\t);\n};\n\n/**\n * Parses an unknown error into a standardized APIError. The provided code and message\n * will be used for the resulting APIError, while details from the original error\n * will be included when not in production mode.\n */\nconst parseError = (\n\terror: unknown,\n\tcode: string,\n\tmessage: string\n): APIError => {\n\tif (isAPIError(error)) {\n\t\treturn new APIError(error.statusCode, {\n\t\t\tcode,\n\t\t\tmessage: error.body.message,\n\t\t\tdetails: error.body.details,\n\t\t});\n\t}\n\n\tif (isAPIErrorResponse(error)) {\n\t\treturn new APIError(error.statusCode, {\n\t\t\tcode,\n\t\t\tmessage: error.body.message,\n\t\t\tdetails: error.body.details,\n\t\t});\n\t}\n\n\tif (error instanceof Error) {\n\t\treturn new APIError(500, {\n\t\t\tcode,\n\t\t\tmessage,\n\t\t\tdetails:\n\t\t\t\tNODE_ENV === 'production'\n\t\t\t\t\t? undefined\n\t\t\t\t\t: {\n\t\t\t\t\t\t\tmessage: error.message,\n\t\t\t\t\t\t\tstack: error.stack,\n\t\t\t\t\t\t},\n\t\t});\n\t}\n\n\treturn new APIError(500, {\n\t\tcode,\n\t\tmessage,\n\t\tdetails:\n\t\t\tNODE_ENV === 'production' ? undefined : JSON.stringify(error, null, 2),\n\t});\n};\n\nexport {\n\tAPIError,\n\ttype APIErrorResponse,\n\ttype APISuccessResponse,\n\tisAPIError,\n\tisAPIErrorResponse,\n\tparseError,\n};\n"],"names":["NODE_ENV","APIError","__name","statusCodeOrBody","body","headers","isAPIError","r","isAPIErrorResponse","parseError","error","code","message"],"mappings":"4FAEA,KAAM,CAAE,SAAAA,CAAA,EAAa,QAAQ,IAe7B,MAAMC,UAAiB,KAAM,OAAA,CAAAC,EAAA,iBACnB,GAAK,GACL,WACA,QACA,KAsBT,YACCC,EASAC,EAKAC,EACC,CACD,MAAA,EAEI,OAAOF,GAAqB,UAE/B,KAAK,WAAaA,EAAiB,OACnC,KAAK,QAAUA,EAAiB,SAAW,CAAA,EAC3C,KAAK,KAAO,CACX,KAAMA,EAAiB,KACvB,QAASA,EAAiB,QAC1B,QAASA,EAAiB,OAAA,IAI3B,KAAK,WAAaA,EAClB,KAAK,QAAUE,GAAW,CAAA,EAC1B,KAAK,KAAOD,GAAQ,CACnB,KAAM,wBACN,QACC,gEAAA,GAIH,KAAK,QAAU,IAAI,KAAK,KAAK,IAAI,MAAM,KAAK,KAAK,OAAO,EACzD,CAEA,QAA2B,CAC1B,MAAO,CACN,GAAI,KAAK,GACT,WAAY,KAAK,WACjB,KAAM,KAAK,KACX,QAAS,KAAK,OAAA,CAEhB,CACD,CAaA,MAAME,EAAaJ,EAACK,GACfA,aAAaN,EACT,GAGJO,EAAmBD,CAAC,GACvBA,EAAI,IAAIN,EAASM,EAAE,WAAY,CAC9B,KAAMA,EAAE,KAAK,KACb,QAASA,EAAE,KAAK,QAChB,QAASA,EAAE,KAAK,OAAA,CAChB,EACM,IAGD,GAdW,cAiBbC,EAAqBN,EAACK,GAE1B,OAAOA,GAAM,UACbA,IAAM,MACN,OAAQA,GACRA,EAAE,KAAO,IACT,eAAgBA,GAChB,OAAOA,EAAE,YAAe,UACxB,SAAUA,GACV,OAAOA,EAAE,MAAS,UAClBA,EAAE,OAAS,MACX,SAAUA,EAAE,MACZ,OAAOA,EAAE,KAAK,MAAS,UACvB,YAAaA,EAAE,MACf,OAAOA,EAAE,KAAK,SAAY,SAdD,sBAuBrBE,EAAaP,EAAA,CAClBQ,EACAC,EACAC,IAEIN,EAAWI,CAAK,EACZ,IAAIT,EAASS,EAAM,WAAY,CACrC,KAAAC,EACA,QAASD,EAAM,KAAK,QACpB,QAASA,EAAM,KAAK,OAAA,CACpB,EAGEF,EAAmBE,CAAK,EACpB,IAAIT,EAASS,EAAM,WAAY,CACrC,KAAAC,EACA,QAASD,EAAM,KAAK,QACpB,QAASA,EAAM,KAAK,OAAA,CACpB,EAGEA,aAAiB,MACb,IAAIT,EAAS,IAAK,CACxB,KAAAU,EACA,QAAAC,EACA,QACCZ,IAAa,aACV,OACA,CACA,QAASU,EAAM,QACf,MAAOA,EAAM,KAAA,CACd,CACH,EAGK,IAAIT,EAAS,IAAK,CACxB,KAAAU,EACA,QAAAC,EACA,QACCZ,IAAa,aAAe,OAAY,KAAK,UAAUU,EAAO,KAAM,CAAC,CAAA,CACtE,EAxCiB"}

package/dist/api/errors.d.cts

@@ -0,0 +1,53 @@
+import { StatusCode } from './status-codes.cjs';
+
+type APIErrorResponse = {
+    ok: false;
+    statusCode: StatusCode;
+    body: {
+        code: string;
+        message: string;
+        details?: string | Record<string, unknown>;
+    };
+    headers?: HeadersInit;
+};
+type HeadersInit = Record<string, string> | Array<[string, string]> | Headers;
+declare class APIError extends Error {
+    readonly ok = false;
+    readonly statusCode: StatusCode;
+    readonly headers: HeadersInit;
+    readonly body: {
+        code: string;
+        message: string;
+        details?: string | Record<string, unknown>;
+    };
+    constructor(body: {
+        status: StatusCode;
+        code: string;
+        message: string;
+        details?: string | Record<string, unknown>;
+        headers?: HeadersInit;
+    });
+    constructor(statusCode: StatusCode, body: {
+        code: string;
+        message: string;
+        details?: string | Record<string, unknown>;
+    }, headers?: HeadersInit);
+    toJSON(): APIErrorResponse;
+}
+interface APISuccessResponse<T> {
+    ok: true;
+    code: number;
+    message: string | null;
+    data: T;
+}
+declare const isAPIError: (r: unknown) => r is APIError;
+declare const isAPIErrorResponse: (r: unknown) => r is APIErrorResponse;
+/**
+ * Parses an unknown error into a standardized APIError. The provided code and message
+ * will be used for the resulting APIError, while details from the original error
+ * will be included when not in production mode.
+ */
+declare const parseError: (error: unknown, code: string, message: string) => APIError;
+
+export { APIError, isAPIError, isAPIErrorResponse, parseError };
+export type { APIErrorResponse, APISuccessResponse };

package/dist/api/errors.d.mts

@@ -0,0 +1,53 @@
+import { StatusCode } from './status-codes.mjs';
+
+type APIErrorResponse = {
+    ok: false;
+    statusCode: StatusCode;
+    body: {
+        code: string;
+        message: string;
+        details?: string | Record<string, unknown>;
+    };
+    headers?: HeadersInit;
+};
+type HeadersInit = Record<string, string> | Array<[string, string]> | Headers;
+declare class APIError extends Error {
+    readonly ok = false;
+    readonly statusCode: StatusCode;
+    readonly headers: HeadersInit;
+    readonly body: {
+        code: string;
+        message: string;
+        details?: string | Record<string, unknown>;
+    };
+    constructor(body: {
+        status: StatusCode;
+        code: string;
+        message: string;
+        details?: string | Record<string, unknown>;
+        headers?: HeadersInit;
+    });
+    constructor(statusCode: StatusCode, body: {
+        code: string;
+        message: string;
+        details?: string | Record<string, unknown>;
+    }, headers?: HeadersInit);
+    toJSON(): APIErrorResponse;
+}
+interface APISuccessResponse<T> {
+    ok: true;
+    code: number;
+    message: string | null;
+    data: T;
+}
+declare const isAPIError: (r: unknown) => r is APIError;
+declare const isAPIErrorResponse: (r: unknown) => r is APIErrorResponse;
+/**
+ * Parses an unknown error into a standardized APIError. The provided code and message
+ * will be used for the resulting APIError, while details from the original error
+ * will be included when not in production mode.
+ */
+declare const parseError: (error: unknown, code: string, message: string) => APIError;
+
+export { APIError, isAPIError, isAPIErrorResponse, parseError };
+export type { APIErrorResponse, APISuccessResponse };

package/dist/api/errors.mjs

@@ -0,0 +1,2 @@
+var u=Object.defineProperty;var o=(s,e)=>u(s,"name",{value:e,configurable:!0});const{NODE_ENV:d}=process.env;class t extends Error{static{o(this,"APIError")}ok=!1;statusCode;headers;body;constructor(e,i,b){super(),typeof e=="object"?(this.statusCode=e.status,this.headers=e.headers??{},this.body={code:e.code,message:e.message,details:e.details}):(this.statusCode=e,this.headers=b??{},this.body=i||{code:"INTERNAL_SERVER_ERROR",message:"An error occurred, but no additional information is available."}),this.message=`[${this.body.code}]: ${this.body.message}`}toJSON(){return{ok:this.ok,statusCode:this.statusCode,body:this.body,headers:this.headers}}}const n=o(s=>s instanceof t?!0:a(s)?(s=new t(s.statusCode,{code:s.body.code,message:s.body.message,details:s.body.details}),!0):!1,"isAPIError"),a=o(s=>typeof s=="object"&&s!==null&&"ok"in s&&s.ok===!1&&"statusCode"in s&&typeof s.statusCode=="number"&&"body"in s&&typeof s.body=="object"&&s.body!==null&&"code"in s.body&&typeof s.body.code=="string"&&"message"in s.body&&typeof s.body.message=="string","isAPIErrorResponse"),c=o((s,e,i)=>n(s)?new t(s.statusCode,{code:e,message:s.body.message,details:s.body.details}):a(s)?new t(s.statusCode,{code:e,message:s.body.message,details:s.body.details}):s instanceof Error?new t(500,{code:e,message:i,details:d==="production"?void 0:{message:s.message,stack:s.stack}}):new t(500,{code:e,message:i,details:d==="production"?void 0:JSON.stringify(s,null,2)}),"parseError");export{t as APIError,n as isAPIError,a as isAPIErrorResponse,c as parseError};
+//# sourceMappingURL=errors.mjs.map

package/dist/api/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","sources":["../../src/api/errors.ts"],"sourcesContent":["import type { StatusCode } from './status-codes';\n\nconst { NODE_ENV } = process.env;\n\ntype APIErrorResponse = {\n\tok: false;\n\tstatusCode: StatusCode;\n\tbody: {\n\t\tcode: string;\n\t\tmessage: string;\n\t\tdetails?: string | Record<string, unknown>;\n\t};\n\theaders?: HeadersInit;\n};\n\ntype HeadersInit = Record<string, string> | Array<[string, string]> | Headers;\n\nclass APIError extends Error {\n\treadonly ok = false;\n\treadonly statusCode: StatusCode;\n\treadonly headers: HeadersInit;\n\treadonly body: {\n\t\tcode: string;\n\t\tmessage: string;\n\t\tdetails?: string | Record<string, unknown>;\n\t};\n\n\tconstructor(body: {\n\t\tstatus: StatusCode;\n\t\tcode: string;\n\t\tmessage: string;\n\t\tdetails?: string | Record<string, unknown>;\n\t\theaders?: HeadersInit;\n\t});\n\tconstructor(\n\t\tstatusCode: StatusCode,\n\t\tbody: {\n\t\t\tcode: string;\n\t\t\tmessage: string;\n\t\t\tdetails?: string | Record<string, unknown>;\n\t\t},\n\t\theaders?: HeadersInit\n\t);\n\tconstructor(\n\t\tstatusCodeOrBody:\n\t\t\t| StatusCode\n\t\t\t| {\n\t\t\t\t\tstatus: StatusCode;\n\t\t\t\t\tcode: string;\n\t\t\t\t\tmessage: string;\n\t\t\t\t\tdetails?: string | Record<string, unknown>;\n\t\t\t\t\theaders?: HeadersInit;\n\t\t\t  },\n\t\tbody?: {\n\t\t\tcode: string;\n\t\t\tmessage: string;\n\t\t\tdetails?: string | Record<string, unknown>;\n\t\t},\n\t\theaders?: HeadersInit\n\t) {\n\t\tsuper();\n\n\t\tif (typeof statusCodeOrBody === 'object') {\n\t\t\t// Single argument signature\n\t\t\tthis.statusCode = statusCodeOrBody.status;\n\t\t\tthis.headers = statusCodeOrBody.headers ?? {};\n\t\t\tthis.body = {\n\t\t\t\tcode: statusCodeOrBody.code,\n\t\t\t\tmessage: statusCodeOrBody.message,\n\t\t\t\tdetails: statusCodeOrBody.details,\n\t\t\t};\n\t\t} else {\n\t\t\t// Multi-argument signature\n\t\t\tthis.statusCode = statusCodeOrBody;\n\t\t\tthis.headers = headers ?? {};\n\t\t\tthis.body = body || {\n\t\t\t\tcode: 'INTERNAL_SERVER_ERROR',\n\t\t\t\tmessage:\n\t\t\t\t\t'An error occurred, but no additional information is available.',\n\t\t\t};\n\t\t}\n\n\t\tthis.message = `[${this.body.code}]: ${this.body.message}`;\n\t}\n\n\ttoJSON(): APIErrorResponse {\n\t\treturn {\n\t\t\tok: this.ok,\n\t\t\tstatusCode: this.statusCode,\n\t\t\tbody: this.body,\n\t\t\theaders: this.headers,\n\t\t} satisfies APIErrorResponse;\n\t}\n}\n\n//\n// Start Guards\n//\n\ninterface APISuccessResponse<T> {\n\tok: true;\n\tcode: number;\n\tmessage: string | null;\n\tdata: T;\n}\n\nconst isAPIError = (r: unknown): r is APIError => {\n\tif (r instanceof APIError) {\n\t\treturn true;\n\t}\n\n\tif (isAPIErrorResponse(r)) {\n\t\tr = new APIError(r.statusCode, {\n\t\t\tcode: r.body.code,\n\t\t\tmessage: r.body.message,\n\t\t\tdetails: r.body.details,\n\t\t});\n\t\treturn true;\n\t}\n\n\treturn false;\n};\n\nconst isAPIErrorResponse = (r: unknown): r is APIErrorResponse => {\n\treturn (\n\t\ttypeof r === 'object' &&\n\t\tr !== null &&\n\t\t'ok' in r &&\n\t\tr.ok === false &&\n\t\t'statusCode' in r &&\n\t\ttypeof r.statusCode === 'number' &&\n\t\t'body' in r &&\n\t\ttypeof r.body === 'object' &&\n\t\tr.body !== null &&\n\t\t'code' in r.body &&\n\t\ttypeof r.body.code === 'string' &&\n\t\t'message' in r.body &&\n\t\ttypeof r.body.message === 'string'\n\t);\n};\n\n/**\n * Parses an unknown error into a standardized APIError. The provided code and message\n * will be used for the resulting APIError, while details from the original error\n * will be included when not in production mode.\n */\nconst parseError = (\n\terror: unknown,\n\tcode: string,\n\tmessage: string\n): APIError => {\n\tif (isAPIError(error)) {\n\t\treturn new APIError(error.statusCode, {\n\t\t\tcode,\n\t\t\tmessage: error.body.message,\n\t\t\tdetails: error.body.details,\n\t\t});\n\t}\n\n\tif (isAPIErrorResponse(error)) {\n\t\treturn new APIError(error.statusCode, {\n\t\t\tcode,\n\t\t\tmessage: error.body.message,\n\t\t\tdetails: error.body.details,\n\t\t});\n\t}\n\n\tif (error instanceof Error) {\n\t\treturn new APIError(500, {\n\t\t\tcode,\n\t\t\tmessage,\n\t\t\tdetails:\n\t\t\t\tNODE_ENV === 'production'\n\t\t\t\t\t? undefined\n\t\t\t\t\t: {\n\t\t\t\t\t\t\tmessage: error.message,\n\t\t\t\t\t\t\tstack: error.stack,\n\t\t\t\t\t\t},\n\t\t});\n\t}\n\n\treturn new APIError(500, {\n\t\tcode,\n\t\tmessage,\n\t\tdetails:\n\t\t\tNODE_ENV === 'production' ? undefined : JSON.stringify(error, null, 2),\n\t});\n};\n\nexport {\n\tAPIError,\n\ttype APIErrorResponse,\n\ttype APISuccessResponse,\n\tisAPIError,\n\tisAPIErrorResponse,\n\tparseError,\n};\n"],"names":["NODE_ENV","APIError","__name","statusCodeOrBody","body","headers","isAPIError","r","isAPIErrorResponse","parseError","error","code","message"],"mappings":"+EAEA,KAAM,CAAE,SAAAA,CAAA,EAAa,QAAQ,IAe7B,MAAMC,UAAiB,KAAM,CAf7B,MAe6B,CAAAC,EAAA,iBACnB,GAAK,GACL,WACA,QACA,KAsBT,YACCC,EASAC,EAKAC,EACC,CACD,MAAA,EAEI,OAAOF,GAAqB,UAE/B,KAAK,WAAaA,EAAiB,OACnC,KAAK,QAAUA,EAAiB,SAAW,CAAA,EAC3C,KAAK,KAAO,CACX,KAAMA,EAAiB,KACvB,QAASA,EAAiB,QAC1B,QAASA,EAAiB,OAAA,IAI3B,KAAK,WAAaA,EAClB,KAAK,QAAUE,GAAW,CAAA,EAC1B,KAAK,KAAOD,GAAQ,CACnB,KAAM,wBACN,QACC,gEAAA,GAIH,KAAK,QAAU,IAAI,KAAK,KAAK,IAAI,MAAM,KAAK,KAAK,OAAO,EACzD,CAEA,QAA2B,CAC1B,MAAO,CACN,GAAI,KAAK,GACT,WAAY,KAAK,WACjB,KAAM,KAAK,KACX,QAAS,KAAK,OAAA,CAEhB,CACD,CAaA,MAAME,EAAaJ,EAACK,GACfA,aAAaN,EACT,GAGJO,EAAmBD,CAAC,GACvBA,EAAI,IAAIN,EAASM,EAAE,WAAY,CAC9B,KAAMA,EAAE,KAAK,KACb,QAASA,EAAE,KAAK,QAChB,QAASA,EAAE,KAAK,OAAA,CAChB,EACM,IAGD,GAdW,cAiBbC,EAAqBN,EAACK,GAE1B,OAAOA,GAAM,UACbA,IAAM,MACN,OAAQA,GACRA,EAAE,KAAO,IACT,eAAgBA,GAChB,OAAOA,EAAE,YAAe,UACxB,SAAUA,GACV,OAAOA,EAAE,MAAS,UAClBA,EAAE,OAAS,MACX,SAAUA,EAAE,MACZ,OAAOA,EAAE,KAAK,MAAS,UACvB,YAAaA,EAAE,MACf,OAAOA,EAAE,KAAK,SAAY,SAdD,sBAuBrBE,EAAaP,EAAA,CAClBQ,EACAC,EACAC,IAEIN,EAAWI,CAAK,EACZ,IAAIT,EAASS,EAAM,WAAY,CACrC,KAAAC,EACA,QAASD,EAAM,KAAK,QACpB,QAASA,EAAM,KAAK,OAAA,CACpB,EAGEF,EAAmBE,CAAK,EACpB,IAAIT,EAASS,EAAM,WAAY,CACrC,KAAAC,EACA,QAASD,EAAM,KAAK,QACpB,QAASA,EAAM,KAAK,OAAA,CACpB,EAGEA,aAAiB,MACb,IAAIT,EAAS,IAAK,CACxB,KAAAU,EACA,QAAAC,EACA,QACCZ,IAAa,aACV,OACA,CACA,QAASU,EAAM,QACf,MAAOA,EAAM,KAAA,CACd,CACH,EAGK,IAAIT,EAAS,IAAK,CACxB,KAAAU,EACA,QAAAC,EACA,QACCZ,IAAa,aAAe,OAAY,KAAK,UAAUU,EAAO,KAAM,CAAC,CAAA,CACtE,EAxCiB"}

package/dist/api/index.cjs

@@ -0,0 +1,2 @@
+"use strict";var r=require("./errors.cjs"),s=require("./status-codes.cjs");exports.APIError=r.APIError,exports.isAPIError=r.isAPIError,exports.isAPIErrorResponse=r.isAPIErrorResponse,exports.parseError=r.parseError,exports.isStatusCodeText=s.isStatusCodeText,exports.resolveStatusCode=s.resolveStatusCode,exports.statusCodes=s.statusCodes;
+//# sourceMappingURL=index.cjs.map

package/dist/api/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/api/index.d.cts

@@ -0,0 +1,4 @@
+export { APIError, APIErrorResponse, APISuccessResponse, isAPIError, isAPIErrorResponse, parseError } from './errors.cjs';
+export { MinimalNextFunction, MinimalRequest, MinimalRequestHandler, MinimalResponse, Params, ParamsDictionary, ParamsFlatDictionary } from './requests.cjs';
+export { StatusCode, StatusCodeText, isStatusCodeText, resolveStatusCode, statusCodes } from './status-codes.cjs';
+import 'qs';

package/dist/api/index.d.mts

@@ -0,0 +1,4 @@
+export { APIError, APIErrorResponse, APISuccessResponse, isAPIError, isAPIErrorResponse, parseError } from './errors.mjs';
+export { MinimalNextFunction, MinimalRequest, MinimalRequestHandler, MinimalResponse, Params, ParamsDictionary, ParamsFlatDictionary } from './requests.mjs';
+export { StatusCode, StatusCodeText, isStatusCodeText, resolveStatusCode, statusCodes } from './status-codes.mjs';
+import 'qs';

package/dist/api/index.mjs

@@ -0,0 +1,2 @@
+import{APIError as s,isAPIError as e,isAPIErrorResponse as t,parseError as a}from"./errors.mjs";import{isStatusCodeText as E,resolveStatusCode as d,statusCodes as i}from"./status-codes.mjs";export{s as APIError,e as isAPIError,t as isAPIErrorResponse,E as isStatusCodeText,a as parseError,d as resolveStatusCode,i as statusCodes};
+//# sourceMappingURL=index.mjs.map

package/dist/api/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/api/requests.d.cts

@@ -0,0 +1,36 @@
+import { ParsedQs } from 'qs';
+
+interface ParamsDictionary {
+    [key: string]: string | string[];
+    [key: number]: string;
+}
+interface ParamsFlatDictionary {
+    [key: string | number]: string;
+}
+type Params = Record<string, string | string[]> | ParamsDictionary | ParamsFlatDictionary;
+interface MinimalRequest {
+    protocol: string;
+    headers: Record<string, string | string[] | undefined>;
+    get(header: string): string | undefined;
+    originalUrl?: string;
+    params?: Params;
+    query?: string | ParsedQs | (string | ParsedQs)[] | undefined;
+    body?: Record<string, unknown>;
+    ip: string | undefined;
+    connection?: {
+        remoteAddress?: string;
+    };
+}
+interface MinimalResponse {
+    locals: Record<string, unknown>;
+    statusCode: number;
+    setHeader(name: string, value: string): void;
+    status(code: number): MinimalResponse;
+    send(...args: unknown[]): void;
+    json(data: unknown): void;
+    end(...args: unknown[]): void;
+}
+type MinimalNextFunction = (err?: unknown) => void;
+type MinimalRequestHandler = (req: MinimalRequest, res: MinimalResponse, next: MinimalNextFunction) => Promise<void> | void;
+
+export type { MinimalNextFunction, MinimalRequest, MinimalRequestHandler, MinimalResponse, Params, ParamsDictionary, ParamsFlatDictionary };

package/dist/api/requests.d.mts

@@ -0,0 +1,36 @@
+import { ParsedQs } from 'qs';
+
+interface ParamsDictionary {
+    [key: string]: string | string[];
+    [key: number]: string;
+}
+interface ParamsFlatDictionary {
+    [key: string | number]: string;
+}
+type Params = Record<string, string | string[]> | ParamsDictionary | ParamsFlatDictionary;
+interface MinimalRequest {
+    protocol: string;
+    headers: Record<string, string | string[] | undefined>;
+    get(header: string): string | undefined;
+    originalUrl?: string;
+    params?: Params;
+    query?: string | ParsedQs | (string | ParsedQs)[] | undefined;
+    body?: Record<string, unknown>;
+    ip: string | undefined;
+    connection?: {
+        remoteAddress?: string;
+    };
+}
+interface MinimalResponse {
+    locals: Record<string, unknown>;
+    statusCode: number;
+    setHeader(name: string, value: string): void;
+    status(code: number): MinimalResponse;
+    send(...args: unknown[]): void;
+    json(data: unknown): void;
+    end(...args: unknown[]): void;
+}
+type MinimalNextFunction = (err?: unknown) => void;
+type MinimalRequestHandler = (req: MinimalRequest, res: MinimalResponse, next: MinimalNextFunction) => Promise<void> | void;
+
+export type { MinimalNextFunction, MinimalRequest, MinimalRequestHandler, MinimalResponse, Params, ParamsDictionary, ParamsFlatDictionary };

package/dist/api/status-codes.cjs

@@ -0,0 +1,2 @@
+"use strict";var _=Object.defineProperty;var O=(E,R)=>_(E,"name",{value:R,configurable:!0});const T={CONTINUE:100,SWITCHING_PROTOCOLS:101,PROCESSING:102,EARLY_HINTS:103,OK:200,CREATED:201,ACCEPTED:202,NON_AUTHORITATIVE_INFORMATION:203,NO_CONTENT:204,RESET_CONTENT:205,PARTIAL_CONTENT:206,MULTI_STATUS:207,ALREADY_REPORTED:208,IM_USED:226,MULTIPLE_CHOICES:300,MOVED_PERMANENTLY:301,FOUND:302,SEE_OTHER:303,NOT_MODIFIED:304,USE_PROXY:305,UNUSED:306,TEMPORARY_REDIRECT:307,PERMANENT_REDIRECT:308,BAD_REQUEST:400,UNAUTHORIZED:401,PAYMENT_REQUIRED:402,FORBIDDEN:403,NOT_FOUND:404,METHOD_NOT_ALLOWED:405,NOT_ACCEPTABLE:406,PROXY_AUTHENTICATION_REQUIRED:407,REQUEST_TIMEOUT:408,CONFLICT:409,GONE:410,LENGTH_REQUIRED:411,PRECONDITION_FAILED:412,PAYLOAD_TOO_LARGE:413,URI_TOO_LONG:414,UNSUPPORTED_MEDIA_TYPE:415,RANGE_NOT_SATISFIABLE:416,EXPECTATION_FAILED:417,"I'M_A_TEAPOT":418,MISDIRECTED_REQUEST:421,UNPROCESSABLE_ENTITY:422,LOCKED:423,FAILED_DEPENDENCY:424,TOO_EARLY:425,UPGRADE_REQUIRED:426,PRECONDITION_REQUIRED:428,TOO_MANY_REQUESTS:429,REQUEST_HEADER_FIELDS_TOO_LARGE:431,UNAVAILABLE_FOR_LEGAL_REASONS:451,INTERNAL_SERVER_ERROR:500,NOT_IMPLEMENTED:501,BAD_GATEWAY:502,SERVICE_UNAVAILABLE:503,GATEWAY_TIMEOUT:504,HTTP_VERSION_NOT_SUPPORTED:505,VARIANT_ALSO_NEGOTIATES:506,INSUFFICIENT_STORAGE:507,LOOP_DETECTED:508,NOT_EXTENDED:510,NETWORK_AUTHENTICATION_REQUIRED:511},N=O(E=>typeof E=="string"&&E in T,"isStatusCodeText"),A=O(E=>typeof E=="number"?E:T[E]??T.INTERNAL_SERVER_ERROR,"resolveStatusCode");exports.isStatusCodeText=N,exports.resolveStatusCode=A,exports.statusCodes=T;
+//# sourceMappingURL=status-codes.cjs.map

package/dist/api/status-codes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-codes.cjs","sources":["../../src/api/status-codes.ts"],"sourcesContent":["const statusCodes = {\n\t// 1xx Informational\n\tCONTINUE: 100,\n\tSWITCHING_PROTOCOLS: 101,\n\tPROCESSING: 102,\n\tEARLY_HINTS: 103,\n\n\t// 2xx Success\n\tOK: 200,\n\tCREATED: 201,\n\tACCEPTED: 202,\n\tNON_AUTHORITATIVE_INFORMATION: 203,\n\tNO_CONTENT: 204,\n\tRESET_CONTENT: 205,\n\tPARTIAL_CONTENT: 206,\n\tMULTI_STATUS: 207,\n\tALREADY_REPORTED: 208,\n\tIM_USED: 226,\n\n\t// 3xx Redirection\n\tMULTIPLE_CHOICES: 300,\n\tMOVED_PERMANENTLY: 301,\n\tFOUND: 302,\n\tSEE_OTHER: 303,\n\tNOT_MODIFIED: 304,\n\tUSE_PROXY: 305,\n\tUNUSED: 306,\n\tTEMPORARY_REDIRECT: 307,\n\tPERMANENT_REDIRECT: 308,\n\n\t// 4xx Client Errors\n\tBAD_REQUEST: 400,\n\tUNAUTHORIZED: 401,\n\tPAYMENT_REQUIRED: 402,\n\tFORBIDDEN: 403,\n\tNOT_FOUND: 404,\n\tMETHOD_NOT_ALLOWED: 405,\n\tNOT_ACCEPTABLE: 406,\n\tPROXY_AUTHENTICATION_REQUIRED: 407,\n\tREQUEST_TIMEOUT: 408,\n\tCONFLICT: 409,\n\tGONE: 410,\n\tLENGTH_REQUIRED: 411,\n\tPRECONDITION_FAILED: 412,\n\tPAYLOAD_TOO_LARGE: 413,\n\tURI_TOO_LONG: 414,\n\tUNSUPPORTED_MEDIA_TYPE: 415,\n\tRANGE_NOT_SATISFIABLE: 416,\n\tEXPECTATION_FAILED: 417,\n\t\"I'M_A_TEAPOT\": 418,\n\tMISDIRECTED_REQUEST: 421,\n\tUNPROCESSABLE_ENTITY: 422,\n\tLOCKED: 423,\n\tFAILED_DEPENDENCY: 424,\n\tTOO_EARLY: 425,\n\tUPGRADE_REQUIRED: 426,\n\tPRECONDITION_REQUIRED: 428,\n\tTOO_MANY_REQUESTS: 429,\n\tREQUEST_HEADER_FIELDS_TOO_LARGE: 431,\n\tUNAVAILABLE_FOR_LEGAL_REASONS: 451,\n\n\t// 5xx Server Errors\n\tINTERNAL_SERVER_ERROR: 500,\n\tNOT_IMPLEMENTED: 501,\n\tBAD_GATEWAY: 502,\n\tSERVICE_UNAVAILABLE: 503,\n\tGATEWAY_TIMEOUT: 504,\n\tHTTP_VERSION_NOT_SUPPORTED: 505,\n\tVARIANT_ALSO_NEGOTIATES: 506,\n\tINSUFFICIENT_STORAGE: 507,\n\tLOOP_DETECTED: 508,\n\tNOT_EXTENDED: 510,\n\tNETWORK_AUTHENTICATION_REQUIRED: 511,\n} as const;\n\ntype StatusCodeText = keyof typeof statusCodes;\ntype StatusCode = (typeof statusCodes)[StatusCodeText];\n\nconst isStatusCodeText = (value: unknown): value is StatusCodeText => {\n\treturn typeof value === 'string' && value in statusCodes;\n};\n\nconst resolveStatusCode = (status: StatusCodeText | StatusCode): StatusCode => {\n\tif (typeof status === 'number') {\n\t\treturn status;\n\t}\n\n\treturn statusCodes[status] ?? statusCodes.INTERNAL_SERVER_ERROR;\n};\n\nexport {\n\tstatusCodes,\n\ttype StatusCode,\n\ttype StatusCodeText,\n\tisStatusCodeText,\n\tresolveStatusCode,\n};\n"],"names":["statusCodes","isStatusCodeText","__name","value","resolveStatusCode","status"],"mappings":"4FAAA,MAAMA,EAAc,CAEnB,SAAU,IACV,oBAAqB,IACrB,WAAY,IACZ,YAAa,IAGb,GAAI,IACJ,QAAS,IACT,SAAU,IACV,8BAA+B,IAC/B,WAAY,IACZ,cAAe,IACf,gBAAiB,IACjB,aAAc,IACd,iBAAkB,IAClB,QAAS,IAGT,iBAAkB,IAClB,kBAAmB,IACnB,MAAO,IACP,UAAW,IACX,aAAc,IACd,UAAW,IACX,OAAQ,IACR,mBAAoB,IACpB,mBAAoB,IAGpB,YAAa,IACb,aAAc,IACd,iBAAkB,IAClB,UAAW,IACX,UAAW,IACX,mBAAoB,IACpB,eAAgB,IAChB,8BAA+B,IAC/B,gBAAiB,IACjB,SAAU,IACV,KAAM,IACN,gBAAiB,IACjB,oBAAqB,IACrB,kBAAmB,IACnB,aAAc,IACd,uBAAwB,IACxB,sBAAuB,IACvB,mBAAoB,IACpB,eAAgB,IAChB,oBAAqB,IACrB,qBAAsB,IACtB,OAAQ,IACR,kBAAmB,IACnB,UAAW,IACX,iBAAkB,IAClB,sBAAuB,IACvB,kBAAmB,IACnB,gCAAiC,IACjC,8BAA+B,IAG/B,sBAAuB,IACvB,gBAAiB,IACjB,YAAa,IACb,oBAAqB,IACrB,gBAAiB,IACjB,2BAA4B,IAC5B,wBAAyB,IACzB,qBAAsB,IACtB,cAAe,IACf,aAAc,IACd,gCAAiC,GAClC,EAKMC,EAAmBC,EAACC,GAClB,OAAOA,GAAU,UAAYA,KAASH,EADrB,oBAInBI,EAAoBF,EAACG,GACtB,OAAOA,GAAW,SACdA,EAGDL,EAAYK,CAAM,GAAKL,EAAY,sBALjB"}