@mstuercke/api-utils 0.0.1

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './rest';

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './rest';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC"}

package/dist/rest/RestApi.d.ts

@@ -0,0 +1,11 @@
+import { RestApiRequestHandler, RestApiRoute, RestPathParams, RestQueryParams, RestRequestBody, RestResponseBody } from './types';
+import { APIGatewayProxyEvent, APIGatewayProxyResult } from 'aws-lambda';
+export declare class RestApi {
+    private routes;
+    addRouteHandler<PathParams extends RestPathParams, QueryParams extends RestQueryParams, RequestBody extends RestRequestBody, ResponseBody extends RestResponseBody>(route: RestApiRoute<PathParams, QueryParams, RequestBody, ResponseBody>, requestHandler: RestApiRequestHandler<PathParams, QueryParams, RequestBody, ResponseBody>): this;
+    handleRequest(request: APIGatewayProxyEvent): Promise<APIGatewayProxyResult>;
+    private getMatchingRouteHandlers;
+    private getMatchingRouteHandler;
+    private extractPathParams;
+    private extractQueryParams;
+}

package/dist/rest/RestApi.js

@@ -0,0 +1,93 @@
+import { match } from 'path-to-regexp';
+const DEFAULT_RESPONSE_HEADERS = {
+    'Content-Type': 'application/json; charset=utf-8',
+    'Access-Control-Allow-Origin': '*',
+    'Access-Control-Allow-Methods': '*',
+    'Access-Control-Allow-Headers': '*',
+};
+export class RestApi {
+    routes = [];
+    addRouteHandler(route, requestHandler) {
+        this.routes = [...this.routes, { route, requestHandler }];
+        return this;
+    }
+    async handleRequest(request) {
+        try {
+            const url = new URL(`${request.headers['origin']}${request.path}`);
+            const routeHandler = this.getMatchingRouteHandler(url, request.httpMethod);
+            if (!routeHandler && request.httpMethod === 'OPTIONS') {
+                const allowedHttpMethods = this.getMatchingRouteHandlers(url).map(({ routeHandler }) => routeHandler.route.method);
+                return {
+                    statusCode: 200,
+                    body: '',
+                    headers: {
+                        ...DEFAULT_RESPONSE_HEADERS,
+                        'Access-Control-Allow-Methods': allowedHttpMethods.join(','),
+                    },
+                };
+            }
+            if (!routeHandler)
+                return {
+                    statusCode: 405,
+                    headers: DEFAULT_RESPONSE_HEADERS,
+                    body: `Method ${request.httpMethod} not allowed on ${request.path}`,
+                };
+            const { routeHandler: { requestHandler }, pathParams, queryParams } = routeHandler;
+            const responseBody = await requestHandler(pathParams, queryParams, request.body && JSON.parse(request.body));
+            return {
+                statusCode: responseBody.status,
+                body: responseBody.body ? JSON.stringify(responseBody.body) : '',
+                headers: {
+                    ...DEFAULT_RESPONSE_HEADERS,
+                    ...(responseBody.headers || {}),
+                },
+            };
+        }
+        catch (error) {
+            console.error(error);
+            return {
+                statusCode: 500,
+                headers: DEFAULT_RESPONSE_HEADERS,
+                body: JSON.stringify({ error }),
+            };
+        }
+    }
+    getMatchingRouteHandlers(url) {
+        return this.routes.reduce((matchingRouteHandlers, routeHandler) => {
+            const pathParams = this.extractPathParams(routeHandler, url);
+            const queryParams = this.extractQueryParams(url);
+            const matchingRouteHandler = {
+                routeHandler,
+                pathParams,
+                queryParams,
+            };
+            return pathParams
+                ? [...matchingRouteHandlers, matchingRouteHandler]
+                : matchingRouteHandlers;
+        }, []);
+    }
+    getMatchingRouteHandler(url, httpMethod) {
+        return this.getMatchingRouteHandlers(url)
+            .find(({ routeHandler }) => routeHandler.route.method === httpMethod);
+    }
+    extractPathParams(routeHandler, url) {
+        const matcher = match(routeHandler.route.path, { decode: decodeURIComponent });
+        return (matcher(url.pathname) || null)?.params;
+    }
+    extractQueryParams(url) {
+        const queryParams = {};
+        for (const [key, value] of url.searchParams.entries()) {
+            if (key in queryParams) {
+                const originalValue = queryParams[key];
+                queryParams[key] = Array.isArray(originalValue)
+                    ? [...originalValue, value]
+                    : [originalValue, value];
+            }
+            else {
+                queryParams[key] = value;
+            }
+        }
+        return queryParams;
+    }
+}
+//# sourceMappingURL=RestApi.js.map

package/dist/rest/RestApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestApi.js","sourceRoot":"","sources":["../../src/rest/RestApi.ts"],"names":[],"mappings":"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"}

package/dist/rest/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './RestApi';

package/dist/rest/index.js

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './RestApi';
+//# sourceMappingURL=index.js.map

package/dist/rest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rest/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}

package/dist/rest/types/RestApiRequestHandler.d.ts

@@ -0,0 +1,10 @@
+import { RestPathParams } from './RestRequestParams';
+import { RestRequestBody } from './RestRequestBody';
+import { RestResponseBody } from './RestResponseBody';
+import { RestQueryParams } from './RestQueryParams';
+export type RestApiRequestHandler<PathParams extends RestPathParams, QueryParams extends RestQueryParams, RequestBody extends RestRequestBody, ResponseBody extends RestResponseBody> = (pathParams: PathParams, queryParams: QueryParams, body?: RequestBody | null) => Promise<ApiRouteResponse<ResponseBody>>;
+export interface ApiRouteResponse<ResponseBody> {
+    status: number;
+    headers?: Record<string, string>;
+    body?: ResponseBody;
+}

package/dist/rest/types/RestApiRequestHandler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RestApiRequestHandler.js.map

package/dist/rest/types/RestApiRequestHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestApiRequestHandler.js","sourceRoot":"","sources":["../../../src/rest/types/RestApiRequestHandler.ts"],"names":[],"mappings":""}

package/dist/rest/types/RestApiRoute.d.ts

@@ -0,0 +1,11 @@
+import { RestPathParams } from './RestRequestParams';
+import { RestRequestBody } from './RestRequestBody';
+import { RestResponseBody } from './RestResponseBody';
+import { RestQueryParams } from './RestQueryParams';
+export type RestHttpMethod = 'GET' | 'POST' | 'DELETE' | 'PATCH' | 'PUT' | 'OPTIONS';
+export type RestRoutePath = `/${string}`;
+export interface RestApiRoute<PathParams extends RestPathParams, QueryParams extends RestQueryParams, RequestBody extends RestRequestBody, ResponseBody extends RestResponseBody> {
+    method: RestHttpMethod;
+    path: RestRoutePath;
+    buildUrl: (pathParams: PathParams, queryParams: QueryParams) => RestRoutePath;
+}

package/dist/rest/types/RestApiRoute.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RestApiRoute.js.map

package/dist/rest/types/RestApiRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestApiRoute.js","sourceRoot":"","sources":["../../../src/rest/types/RestApiRoute.ts"],"names":[],"mappings":""}

package/dist/rest/types/RestApiRouteHandler.d.ts

@@ -0,0 +1,10 @@
+import { RestApiRoute } from './RestApiRoute';
+import { RestApiRequestHandler } from './RestApiRequestHandler';
+import { RestPathParams } from './RestRequestParams';
+import { RestQueryParams } from './RestQueryParams';
+import { RestRequestBody } from './RestRequestBody';
+import { RestResponseBody } from './RestResponseBody';
+export interface RestApiRouteHandler<PathParams extends RestPathParams, QueryParams extends RestQueryParams, RequestBody extends RestRequestBody, ResponseBody extends RestResponseBody> {
+    route: RestApiRoute<PathParams, QueryParams, RequestBody, ResponseBody>;
+    requestHandler: RestApiRequestHandler<PathParams, QueryParams, RequestBody, ResponseBody>;
+}

package/dist/rest/types/RestApiRouteHandler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RestApiRouteHandler.js.map

package/dist/rest/types/RestApiRouteHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestApiRouteHandler.js","sourceRoot":"","sources":["../../../src/rest/types/RestApiRouteHandler.ts"],"names":[],"mappings":""}

package/dist/rest/types/RestQueryParams.d.ts

@@ -0,0 +1 @@
+export type RestQueryParams = object | null;

package/dist/rest/types/RestQueryParams.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RestQueryParams.js.map

package/dist/rest/types/RestQueryParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestQueryParams.js","sourceRoot":"","sources":["../../../src/rest/types/RestQueryParams.ts"],"names":[],"mappings":""}

package/dist/rest/types/RestRequestBody.d.ts

@@ -0,0 +1 @@
+export type RestRequestBody = (object | null);

package/dist/rest/types/RestRequestBody.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RestRequestBody.js.map

package/dist/rest/types/RestRequestBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestRequestBody.js","sourceRoot":"","sources":["../../../src/rest/types/RestRequestBody.ts"],"names":[],"mappings":""}

package/dist/rest/types/RestRequestParams.d.ts

@@ -0,0 +1 @@
+export type RestPathParams = object | null;

package/dist/rest/types/RestRequestParams.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RestRequestParams.js.map

package/dist/rest/types/RestRequestParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestRequestParams.js","sourceRoot":"","sources":["../../../src/rest/types/RestRequestParams.ts"],"names":[],"mappings":""}

package/dist/rest/types/RestResponseBody.d.ts

@@ -0,0 +1 @@
+export type RestResponseBody = object | object[] | null;

package/dist/rest/types/RestResponseBody.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RestResponseBody.js.map

package/dist/rest/types/RestResponseBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestResponseBody.js","sourceRoot":"","sources":["../../../src/rest/types/RestResponseBody.ts"],"names":[],"mappings":""}

package/dist/rest/types/index.d.ts

@@ -0,0 +1,7 @@
+export * from './RestApiRequestHandler';
+export * from './RestApiRoute';
+export * from './RestApiRouteHandler';
+export * from './RestQueryParams';
+export * from './RestRequestBody';
+export * from './RestRequestParams';
+export * from './RestResponseBody';

package/dist/rest/types/index.js

@@ -0,0 +1,8 @@
+export * from './RestApiRequestHandler';
+export * from './RestApiRoute';
+export * from './RestApiRouteHandler';
+export * from './RestQueryParams';
+export * from './RestRequestBody';
+export * from './RestRequestParams';
+export * from './RestResponseBody';
+//# sourceMappingURL=index.js.map

package/dist/rest/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rest/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA;AACvC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@mstuercke/api-utils",
+  "version": "0.0.1",
+  "main": "dist/index.js",
+  "type": "module",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts",
+    "README.md"
+  ],
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "bun build.ts",
+    "bump": "bump",
+    "prerelease": "bun run build",
+    "release": "bun run release.ts"
+  },
+  "dependencies": {
+    "path-to-regexp": "^6.2.1"
+  },
+  "peerDependencies": {
+    "@types/aws-lambda": "^8.0.0"
+  },
+  "devDependencies": {
+    "@mstuercke/bun-utils": "^0.0.2",
+    "@types/aws-lambda": "^8.10.123",
+    "@types/path-to-regexp": "^1.7.0",
+    "bump": "^0.2.5",
+    "bun-types": "^1.0.6",
+    "typescript": "^5.2.2"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  }
+}