@basmilius/worker 2.21.0

package/README.md

@@ -0,0 +1,19 @@
+<a href="https://bas.dev" target="_blank" rel="noopener">
+	<img src="https://bmcdn.nl/assets/branding/logo.svg" alt="Bas-logo" height="48"/>
+</a>
+
+---
+
+# `@basmilius/utils`
+
+Various utilities that are commonly used throughout personal Vue-related projects.
+
+## ⭐️ Prerequisites
+
+- Bun >= 1.2.11
+- Node >= 23
+
+## 🚀 Getting started
+
+1. Run `bun install` in the root of the project.
+2. Run `bun --cwd packages/utils build` to build the project.

package/dist/error.d.ts

@@ -0,0 +1,9 @@
+export declare class MissingParameterError extends Error {
+	constructor(param: string);
+}
+export declare class InvalidValueError extends Error {
+	constructor(param: string);
+}
+export declare class NotFoundError extends Error {
+	constructor(message: string);
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import type { Routes, Worker } from "./types";
+export { cloudflare } from "@cloudflare/vite-plugin";
+export { InvalidValueError, MissingParameterError, NotFoundError } from "./error";
+export { queryDate, queryInteger, queryPosition } from "./request";
+export { error, json } from "./response";
+export declare const createWorker: (routes: Routes) => Worker;

package/dist/index.js

@@ -0,0 +1,4 @@
+class s extends Error{constructor(e){super(`Missing required parameter ${e}.`)}}class i extends Error{constructor(e){super(`Invalid value for parameter ${e}.`)}}class u extends Error{constructor(e){super(e)}}function a(e,r,o,t){return c({code:e,error:r,error_description:o},{},t)}function c(e,r={},o=200){let t=new Date,n=new Date(t.getFullYear(),t.getMonth()+1,t.getDate());if(r=r||{},r["Access-Control-Allow-Origin"]="*",r["Content-Type"]="application/json",o===200)r["Cache-Control"]="public, max-age=2628000, immutable",r.Date=t.toISOString(),r.Expires=n.toISOString();return new Response(JSON.stringify(e),{headers:r,status:o})}import{cloudflare as v}from"@cloudflare/vite-plugin";import{DateTime as l}from"luxon";function p(e,r="date"){let{searchParams:o}=new URL(e.url);if(!o.has(r))throw new s(r);let t=l.fromFormat(o.get(r),"yyyy-MM-dd");if(!t.isValid)throw new i(r);return t}function f(e,r){let{searchParams:o}=new URL(e.url);if(!o.has(r))throw new s(r);let t=parseInt(o.get(r));if(isNaN(t))throw new i(r);return t}function m(e){let{searchParams:r}=new URL(e.url);if(!r.has("latitude")||!r.has("longitude"))throw new s("latitude or longitude");let o=parseFloat(r.get("latitude")),t=parseFloat(r.get("longitude"));if(isNaN(o)||isNaN(t))throw new i("latitude or longitude");return{latitude:o,longitude:t}}var h=(e)=>({async fetch(r){let{pathname:o}=new URL(r.url);if(!e[o])return a(404,"not_found","The requested endpoint could not be found.",404);let t=e[o];return t(r).catch((n)=>{if(n instanceof i)return a(406,"invalid_value",n.message,406);if(n instanceof s)return a(400,"missing_parameter",n.message,400);if(n instanceof u)return a(404,"not_found",n.message,404);return a(500,"internal_server_error","An unexpected error occurred.",500)})}});export{m as queryPosition,f as queryInteger,p as queryDate,c as json,a as error,h as createWorker,v as cloudflare,u as NotFoundError,s as MissingParameterError,i as InvalidValueError};
+
+//# debugId=E5477CA28CE6A9D264756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../src/error.ts", "../src/response.ts", "../src/index.ts", "../src/request.ts"],
+  "sourcesContent": [
+    "export class MissingParameterError extends Error {\n    constructor(param: string) {\n        super(`Missing required parameter ${param}.`);\n    }\n}\n\nexport class InvalidValueError extends Error {\n    constructor(param: string) {\n        super(`Invalid value for parameter ${param}.`);\n    }\n}\n\nexport class NotFoundError extends Error {\n    constructor(message: string) {\n        super(message);\n    }\n}\n",
+    "export function error(code: number, error: string, errorDescription: string, status: number): Response {\n    return json({\n        code,\n        error,\n        error_description: errorDescription\n    }, {}, status);\n}\n\nexport function json(json: object, headers: HeadersInit = {}, status: number = 200): Response {\n    const date = new Date();\n    const expires = new Date(date.getFullYear(), date.getMonth() + 1, date.getDate());\n\n    headers = headers || {};\n    headers['Access-Control-Allow-Origin'] = '*';\n    headers['Content-Type'] = 'application/json';\n\n    if (status === 200) {\n        headers['Cache-Control'] = 'public, max-age=2628000, immutable';\n        headers['Date'] = date.toISOString();\n        headers['Expires'] = expires.toISOString();\n    }\n\n    return new Response(JSON.stringify(json), {\n        headers,\n        status\n    });\n}\n",
+    "import { InvalidValueError, MissingParameterError, NotFoundError } from './error';\nimport type { Routes, Worker } from './types';\nimport { error } from './response';\n\nexport {\n    cloudflare\n} from '@cloudflare/vite-plugin';\n\nexport {\n    InvalidValueError,\n    MissingParameterError,\n    NotFoundError\n} from './error';\n\nexport {\n    queryDate,\n    queryInteger,\n    queryPosition\n} from './request';\n\nexport {\n    error,\n    json\n} from './response';\n\nexport const createWorker = (routes: Routes): Worker => ({\n    async fetch(req: Request): Promise<Response> {\n        const {pathname} = new URL(req.url);\n\n        if (!routes[pathname]) {\n            return error(404, 'not_found', 'The requested endpoint could not be found.', 404);\n        }\n\n        const route = routes[pathname];\n\n        return route(req).catch(err => {\n            if (err instanceof InvalidValueError) {\n                return error(406, 'invalid_value', err.message, 406);\n            }\n\n            if (err instanceof MissingParameterError) {\n                return error(400, 'missing_parameter', err.message, 400);\n            }\n\n            if (err instanceof NotFoundError) {\n                return error(404, 'not_found', err.message, 404);\n            }\n\n            return error(500, 'internal_server_error', 'An unexpected error occurred.', 500);\n        });\n    }\n});\n",
+    "import { DateTime } from 'luxon';\nimport { InvalidValueError, MissingParameterError } from './error';\nimport type { Coords } from './types';\n\nexport function queryDate(req: Request, name: string = 'date'): DateTime {\n    const {searchParams} = new URL(req.url);\n\n    if (!searchParams.has(name)) {\n        throw new MissingParameterError(name);\n    }\n\n    const date = DateTime.fromFormat(searchParams.get(name)!, 'yyyy-MM-dd');\n\n    if (!date.isValid) {\n        throw new InvalidValueError(name);\n    }\n\n    return date;\n}\n\nexport function queryInteger(req: Request, name: string): number {\n    const {searchParams} = new URL(req.url);\n\n    if (!searchParams.has(name)) {\n        throw new MissingParameterError(name);\n    }\n\n    const value = parseInt(searchParams.get(name)!);\n\n    if (isNaN(value)) {\n        throw new InvalidValueError(name);\n    }\n\n    return value;\n}\n\nexport function queryPosition(req: Request): Coords {\n    const {searchParams} = new URL(req.url);\n\n    if (!searchParams.has('latitude') || !searchParams.has('longitude')) {\n        throw new MissingParameterError('latitude or longitude');\n    }\n\n    const latitude = parseFloat(searchParams.get('latitude')!);\n    const longitude = parseFloat(searchParams.get('longitude')!);\n\n    if (isNaN(latitude) || isNaN(longitude)) {\n        throw new InvalidValueError('latitude or longitude');\n    }\n\n    return {\n        latitude,\n        longitude\n    };\n}\n"
+  ],
+  "mappings": "AAAO,MAAM,UAA8B,KAAM,CAC7C,WAAW,CAAC,EAAe,CACvB,MAAM,8BAA8B,IAAQ,EAEpD,CAEO,MAAM,UAA0B,KAAM,CACzC,WAAW,CAAC,EAAe,CACvB,MAAM,+BAA+B,IAAQ,EAErD,CAEO,MAAM,UAAsB,KAAM,CACrC,WAAW,CAAC,EAAiB,CACzB,MAAM,CAAO,EAErB,CChBO,SAAS,CAAK,CAAC,EAAc,EAAe,EAA0B,EAA0B,CACnG,OAAO,EAAK,CACR,OACA,QACA,kBAAmB,CACvB,EAAG,CAAC,EAAG,CAAM,EAGV,SAAS,CAAI,CAAC,EAAc,EAAuB,CAAC,EAAG,EAAiB,IAAe,CAC1F,IAAM,EAAO,IAAI,KACX,EAAU,IAAI,KAAK,EAAK,YAAY,EAAG,EAAK,SAAS,EAAI,EAAG,EAAK,QAAQ,CAAC,EAMhF,GAJA,EAAU,GAAW,CAAC,EACtB,EAAQ,+BAAiC,IACzC,EAAQ,gBAAkB,mBAEtB,IAAW,IACX,EAAQ,iBAAmB,qCAC3B,EAAQ,KAAU,EAAK,YAAY,EACnC,EAAQ,QAAa,EAAQ,YAAY,EAG7C,OAAO,IAAI,SAAS,KAAK,UAAU,CAAI,EAAG,CACtC,UACA,QACJ,CAAC,ECrBL,qBACI,gCCLJ,mBAAS,cAIF,SAAS,CAAS,CAAC,EAAc,EAAe,OAAkB,CACrE,IAAO,gBAAgB,IAAI,IAAI,EAAI,GAAG,EAEtC,GAAI,CAAC,EAAa,IAAI,CAAI,EACtB,MAAM,IAAI,EAAsB,CAAI,EAGxC,IAAM,EAAO,EAAS,WAAW,EAAa,IAAI,CAAI,EAAI,YAAY,EAEtE,GAAI,CAAC,EAAK,QACN,MAAM,IAAI,EAAkB,CAAI,EAGpC,OAAO,EAGJ,SAAS,CAAY,CAAC,EAAc,EAAsB,CAC7D,IAAO,gBAAgB,IAAI,IAAI,EAAI,GAAG,EAEtC,GAAI,CAAC,EAAa,IAAI,CAAI,EACtB,MAAM,IAAI,EAAsB,CAAI,EAGxC,IAAM,EAAQ,SAAS,EAAa,IAAI,CAAI,CAAE,EAE9C,GAAI,MAAM,CAAK,EACX,MAAM,IAAI,EAAkB,CAAI,EAGpC,OAAO,EAGJ,SAAS,CAAa,CAAC,EAAsB,CAChD,IAAO,gBAAgB,IAAI,IAAI,EAAI,GAAG,EAEtC,GAAI,CAAC,EAAa,IAAI,UAAU,GAAK,CAAC,EAAa,IAAI,WAAW,EAC9D,MAAM,IAAI,EAAsB,uBAAuB,EAG3D,IAAM,EAAW,WAAW,EAAa,IAAI,UAAU,CAAE,EACnD,EAAY,WAAW,EAAa,IAAI,WAAW,CAAE,EAE3D,GAAI,MAAM,CAAQ,GAAK,MAAM,CAAS,EAClC,MAAM,IAAI,EAAkB,uBAAuB,EAGvD,MAAO,CACH,WACA,WACJ,ED5BG,IAAM,EAAe,CAAC,KAA4B,MAC/C,MAAK,CAAC,EAAiC,CACzC,IAAO,YAAY,IAAI,IAAI,EAAI,GAAG,EAElC,GAAI,CAAC,EAAO,GACR,OAAO,EAAM,IAAK,YAAa,6CAA8C,GAAG,EAGpF,IAAM,EAAQ,EAAO,GAErB,OAAO,EAAM,CAAG,EAAE,MAAM,KAAO,CAC3B,GAAI,aAAe,EACf,OAAO,EAAM,IAAK,gBAAiB,EAAI,QAAS,GAAG,EAGvD,GAAI,aAAe,EACf,OAAO,EAAM,IAAK,oBAAqB,EAAI,QAAS,GAAG,EAG3D,GAAI,aAAe,EACf,OAAO,EAAM,IAAK,YAAa,EAAI,QAAS,GAAG,EAGnD,OAAO,EAAM,IAAK,wBAAyB,gCAAiC,GAAG,EAClF,EAET",
+  "debugId": "E5477CA28CE6A9D264756E2164756E21",
+  "names": []
+}

package/dist/request.d.ts

@@ -0,0 +1,5 @@
+import { DateTime } from "luxon";
+import type { Coords } from "./types";
+export declare function queryDate(req: Request, name?: string): DateTime;
+export declare function queryInteger(req: Request, name: string): number;
+export declare function queryPosition(req: Request): Coords;

package/dist/response.d.ts

@@ -0,0 +1,2 @@
+export declare function error(code: number, error: string, errorDescription: string, status: number): Response;
+export declare function json(json: object, headers?: HeadersInit, status?: number): Response;

package/package.json

@@ -0,0 +1,57 @@
+{
+    "name": "@basmilius/worker",
+    "description": "Various utilities that are used in workers.",
+    "version": "2.21.0",
+    "type": "module",
+    "license": "MIT",
+    "funding": "https://github.com/sponsors/basmilius",
+    "author": {
+        "name": "Bas Milius",
+        "email": "bas@mili.us",
+        "url": "https://bas.dev"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/basmilius/packages.git",
+        "directory": "packages/worker"
+    },
+    "keywords": [
+        "cloudflare",
+        "worker",
+        "api"
+    ],
+    "files": [
+        "dist",
+        "src",
+        "CODEOWNERS",
+        "LICENSE"
+    ],
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    },
+    "scripts": {
+        "build": "bun -b build.ts"
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "typings": "./dist/index.d.ts",
+    "sideEffects": false,
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./*": "./*"
+    },
+    "dependencies": {
+        "luxon": "^3.7.2"
+    },
+    "devDependencies": {
+        "@basmilius/tools": "2.21.0",
+        "@cloudflare/vite-plugin": "^1.19.0",
+        "@types/bun": "^1.3.5",
+        "@types/cloudflare": "^3.0.0",
+        "@types/luxon": "^3.7.1"
+    }
+}

package/src/error.ts

@@ -0,0 +1,17 @@
+export class MissingParameterError extends Error {
+    constructor(param: string) {
+        super(`Missing required parameter ${param}.`);
+    }
+}
+
+export class InvalidValueError extends Error {
+    constructor(param: string) {
+        super(`Invalid value for parameter ${param}.`);
+    }
+}
+
+export class NotFoundError extends Error {
+    constructor(message: string) {
+        super(message);
+    }
+}

package/src/index.ts

@@ -0,0 +1,52 @@
+import { InvalidValueError, MissingParameterError, NotFoundError } from './error';
+import type { Routes, Worker } from './types';
+import { error } from './response';
+
+export {
+    cloudflare
+} from '@cloudflare/vite-plugin';
+
+export {
+    InvalidValueError,
+    MissingParameterError,
+    NotFoundError
+} from './error';
+
+export {
+    queryDate,
+    queryInteger,
+    queryPosition
+} from './request';
+
+export {
+    error,
+    json
+} from './response';
+
+export const createWorker = (routes: Routes): Worker => ({
+    async fetch(req: Request): Promise<Response> {
+        const {pathname} = new URL(req.url);
+
+        if (!routes[pathname]) {
+            return error(404, 'not_found', 'The requested endpoint could not be found.', 404);
+        }
+
+        const route = routes[pathname];
+
+        return route(req).catch(err => {
+            if (err instanceof InvalidValueError) {
+                return error(406, 'invalid_value', err.message, 406);
+            }
+
+            if (err instanceof MissingParameterError) {
+                return error(400, 'missing_parameter', err.message, 400);
+            }
+
+            if (err instanceof NotFoundError) {
+                return error(404, 'not_found', err.message, 404);
+            }
+
+            return error(500, 'internal_server_error', 'An unexpected error occurred.', 500);
+        });
+    }
+});

package/src/request.ts

@@ -0,0 +1,55 @@
+import { DateTime } from 'luxon';
+import { InvalidValueError, MissingParameterError } from './error';
+import type { Coords } from './types';
+
+export function queryDate(req: Request, name: string = 'date'): DateTime {
+    const {searchParams} = new URL(req.url);
+
+    if (!searchParams.has(name)) {
+        throw new MissingParameterError(name);
+    }
+
+    const date = DateTime.fromFormat(searchParams.get(name)!, 'yyyy-MM-dd');
+
+    if (!date.isValid) {
+        throw new InvalidValueError(name);
+    }
+
+    return date;
+}
+
+export function queryInteger(req: Request, name: string): number {
+    const {searchParams} = new URL(req.url);
+
+    if (!searchParams.has(name)) {
+        throw new MissingParameterError(name);
+    }
+
+    const value = parseInt(searchParams.get(name)!);
+
+    if (isNaN(value)) {
+        throw new InvalidValueError(name);
+    }
+
+    return value;
+}
+
+export function queryPosition(req: Request): Coords {
+    const {searchParams} = new URL(req.url);
+
+    if (!searchParams.has('latitude') || !searchParams.has('longitude')) {
+        throw new MissingParameterError('latitude or longitude');
+    }
+
+    const latitude = parseFloat(searchParams.get('latitude')!);
+    const longitude = parseFloat(searchParams.get('longitude')!);
+
+    if (isNaN(latitude) || isNaN(longitude)) {
+        throw new InvalidValueError('latitude or longitude');
+    }
+
+    return {
+        latitude,
+        longitude
+    };
+}

package/src/response.ts

@@ -0,0 +1,27 @@
+export function error(code: number, error: string, errorDescription: string, status: number): Response {
+    return json({
+        code,
+        error,
+        error_description: errorDescription
+    }, {}, status);
+}
+
+export function json(json: object, headers: HeadersInit = {}, status: number = 200): Response {
+    const date = new Date();
+    const expires = new Date(date.getFullYear(), date.getMonth() + 1, date.getDate());
+
+    headers = headers || {};
+    headers['Access-Control-Allow-Origin'] = '*';
+    headers['Content-Type'] = 'application/json';
+
+    if (status === 200) {
+        headers['Cache-Control'] = 'public, max-age=2628000, immutable';
+        headers['Date'] = date.toISOString();
+        headers['Expires'] = expires.toISOString();
+    }
+
+    return new Response(JSON.stringify(json), {
+        headers,
+        status
+    });
+}

package/src/types.ts

@@ -0,0 +1,11 @@
+export type Worker = {
+    fetch(req: Request): Promise<Response>;
+};
+
+export type Route = (req: Request) => Promise<Response>;
+export type Routes = Record<string, Route>;
+
+export type Coords = {
+    readonly latitude: number;
+    readonly longitude: number;
+};