@trpc/server 10.0.0-alpha.4 → 10.0.0-alpha.42

package/README.md

@@ -1,3 +1,81 @@
+<p align="center">
+  <a href="https://trpc.io/"><img src="../../www/static/img/logo-text.svg" alt="tRPC" height="130"/></a>
+</p>
+
+<p align="center">
+  <strong>End-to-end typesafe APIs made easy</strong>
+</p>
+
+<p align="center">
+  <!-- TODO: replace with new version GIF -->
+  <img src="https://storage.googleapis.com/trpc/trpcgif.gif" alt="Demo" />
+</p>
+
 # `@trpc/server`
 
-https://trpc.io
+> Create tRPC routers and connect them to a server.
+
+## Documentation
+
+Full documentation for `@trpc/server` can be found [here](https://trpc.io/docs/router)
+
+## Installation
+
+```bash
+# npm
+npm install @trpc/server
+
+# Yarn
+yarn add @trpc/server
+
+# pnpm
+pnpm add @trpc/server
+```
+
+We also recommend installing `zod` to validate procedure inputs.
+
+## Basic Example
+
+```ts
+import { inferAsyncReturnType, initTRPC } from '@trpc/server';
+import {
+  CreateHTTPContextOptions,
+  createHTTPServer,
+} from '@trpc/server/adapters/standalone';
+import { z } from 'zod';
+
+// Initialize a context for the server
+function createContext(opts: CreateHTTPContextOptions) {
+  return {};
+}
+
+// Get the context type
+type Context = inferAsyncReturnType<typeof createContext>;
+
+// Initialize tRPC
+const t = initTRPC<{ ctx: Context }>()();
+
+// Create main router
+const appRouter = t.router({
+  // Greeting procedure
+  greeting: t.procedure
+    .input(
+      z.object({
+        name: z.string(),
+      }),
+    )
+    .query(({ input }) => `Hello, ${input.name}!`),
+});
+
+// Export the app router type to be imported on the client side
+export type AppRouter = typeof appRouter;
+
+// Create HTTP server
+const { listen } = createHTTPServer({
+  router: appRouter,
+  createContext,
+});
+
+// Listen on port 2022
+listen(2022);
+```

package/adapters/aws-lambda/dist/trpc-server-adapters-aws-lambda.cjs.d.ts

@@ -0,0 +1 @@
+export * from "../../../dist/declarations/src/adapters/aws-lambda/index";

package/adapters/aws-lambda/dist/trpc-server-adapters-aws-lambda.cjs.dev.js

@@ -0,0 +1,190 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+require('../../../dist/router-2f54c292.cjs.dev.js');
+require('events');
+var transformTRPCResponse = require('../../../dist/transformTRPCResponse-c654ea92.cjs.dev.js');
+require('http');
+require('url');
+require('../../../dist/nodeHTTPRequestHandler-36ddaba2.cjs.dev.js');
+var resolveHTTPResponse = require('../../../dist/resolveHTTPResponse-55b2c9bd.cjs.dev.js');
+require('../../../dist/codes-130e62df.cjs.dev.js');
+
+function isPayloadV1(event) {
+  return determinePayloadFormat(event) == '1.0';
+}
+function isPayloadV2(event) {
+  return determinePayloadFormat(event) == '2.0';
+}
+
+function determinePayloadFormat(event) {
+  // https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-lambda.html
+  // According to AWS support, version is is extracted from the version property in the event.
+  // If there is no version property, then the version is implied as 1.0
+  const unknownEvent = event;
+
+  if (typeof unknownEvent.version === 'undefined') {
+    return '1.0';
+  } else {
+    if (['1.0', '2.0'].includes(unknownEvent.version)) {
+      return unknownEvent.version;
+    } else {
+      return 'custom';
+    }
+  }
+}
+
+const UNKNOWN_PAYLOAD_FORMAT_VERSION_ERROR_MESSAGE = 'Custom payload format version not handled by this adapter. Please use either 1.0 or 2.0. More information here' + 'https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-lambda.html';
+
+function lambdaEventToHTTPRequest(event) {
+  const query = new URLSearchParams();
+
+  for (const [key, value] of Object.entries((_event$queryStringPar = event.queryStringParameters) !== null && _event$queryStringPar !== void 0 ? _event$queryStringPar : {})) {
+    var _event$queryStringPar;
+
+    if (typeof value !== 'undefined') {
+      query.append(key, value);
+    }
+  }
+
+  return {
+    method: getHTTPMethod(event),
+    query: query,
+    headers: event.headers,
+    body: event.body
+  };
+}
+
+function getHTTPMethod(event) {
+  if (isPayloadV1(event)) {
+    return event.httpMethod;
+  }
+
+  if (isPayloadV2(event)) {
+    return event.requestContext.http.method;
+  }
+
+  throw new transformTRPCResponse.TRPCError({
+    code: 'INTERNAL_SERVER_ERROR',
+    message: UNKNOWN_PAYLOAD_FORMAT_VERSION_ERROR_MESSAGE
+  });
+}
+
+function getPath(event) {
+  if (isPayloadV1(event)) {
+    const matches = event.resource.matchAll(/\{(.*?)\}/g);
+
+    for (const match of matches) {
+      const group = match[1];
+
+      if (group.includes('+') && event.pathParameters) {
+        return event.pathParameters[group.replace('+', '')] || '';
+      }
+    }
+
+    return event.path.slice(1);
+  }
+
+  if (isPayloadV2(event)) {
+    const matches = event.routeKey.matchAll(/\{(.*?)\}/g);
+
+    for (const match of matches) {
+      const group = match[1];
+
+      if (group.includes('+') && event.pathParameters) {
+        return event.pathParameters[group.replace('+', '')] || '';
+      }
+    }
+
+    return event.rawPath.slice(1);
+  }
+
+  throw new transformTRPCResponse.TRPCError({
+    code: 'INTERNAL_SERVER_ERROR',
+    message: UNKNOWN_PAYLOAD_FORMAT_VERSION_ERROR_MESSAGE
+  });
+}
+
+function transformHeaders(headers) {
+  const obj = {};
+
+  for (const [key, value] of Object.entries(headers)) {
+    if (typeof value === 'undefined') {
+      continue;
+    }
+
+    obj[key] = Array.isArray(value) ? value.join(',') : value;
+  }
+
+  return obj;
+}
+
+function tRPCOutputToAPIGatewayOutput(event, response) {
+  if (isPayloadV1(event)) {
+    var _response$body, _response$headers;
+
+    const resp = {
+      statusCode: response.status,
+      body: (_response$body = response.body) !== null && _response$body !== void 0 ? _response$body : '',
+      headers: transformHeaders((_response$headers = response.headers) !== null && _response$headers !== void 0 ? _response$headers : {})
+    };
+    return resp;
+  } else if (isPayloadV2(event)) {
+    var _response$body2, _response$headers2;
+
+    const resp = {
+      statusCode: response.status,
+      body: (_response$body2 = response.body) !== null && _response$body2 !== void 0 ? _response$body2 : undefined,
+      headers: transformHeaders((_response$headers2 = response.headers) !== null && _response$headers2 !== void 0 ? _response$headers2 : {})
+    };
+    return resp;
+  } else {
+    throw new transformTRPCResponse.TRPCError({
+      code: 'INTERNAL_SERVER_ERROR',
+      message: UNKNOWN_PAYLOAD_FORMAT_VERSION_ERROR_MESSAGE
+    });
+  }
+}
+/** Will check the createContext of the TRouter and get the parameter of event.
+ * @internal
+ **/
+
+
+function awsLambdaRequestHandler(opts) {
+  return async (event, context) => {
+    const req = lambdaEventToHTTPRequest(event);
+    const path = getPath(event);
+
+    const createContext = async function _createContext() {
+      var _opts$createContext;
+
+      return await ((_opts$createContext = opts.createContext) === null || _opts$createContext === void 0 ? void 0 : _opts$createContext.call(opts, {
+        event,
+        context
+      }));
+    };
+
+    const response = await resolveHTTPResponse.resolveHTTPResponse({
+      router: opts.router,
+      batching: opts.batching,
+      responseMeta: opts === null || opts === void 0 ? void 0 : opts.responseMeta,
+      createContext,
+      req,
+      path,
+      error: null,
+
+      onError(o) {
+        var _opts$onError;
+
+        opts === null || opts === void 0 ? void 0 : (_opts$onError = opts.onError) === null || _opts$onError === void 0 ? void 0 : _opts$onError.call(opts, { ...o,
+          req: event
+        });
+      }
+
+    });
+    return tRPCOutputToAPIGatewayOutput(event, response);
+  };
+}
+
+exports.awsLambdaRequestHandler = awsLambdaRequestHandler;

package/adapters/aws-lambda/dist/trpc-server-adapters-aws-lambda.cjs.js

@@ -0,0 +1,7 @@
+'use strict';
+
+if (process.env.NODE_ENV === "production") {
+  module.exports = require("./trpc-server-adapters-aws-lambda.cjs.prod.js");
+} else {
+  module.exports = require("./trpc-server-adapters-aws-lambda.cjs.dev.js");
+}

package/adapters/aws-lambda/dist/trpc-server-adapters-aws-lambda.cjs.prod.js

@@ -0,0 +1,190 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+require('../../../dist/router-459409c8.cjs.prod.js');
+require('events');
+var transformTRPCResponse = require('../../../dist/transformTRPCResponse-1e125b28.cjs.prod.js');
+require('http');
+require('url');
+require('../../../dist/nodeHTTPRequestHandler-91e7ca3d.cjs.prod.js');
+var resolveHTTPResponse = require('../../../dist/resolveHTTPResponse-02e61299.cjs.prod.js');
+require('../../../dist/codes-aff770a3.cjs.prod.js');
+
+function isPayloadV1(event) {
+  return determinePayloadFormat(event) == '1.0';
+}
+function isPayloadV2(event) {
+  return determinePayloadFormat(event) == '2.0';
+}
+
+function determinePayloadFormat(event) {
+  // https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-lambda.html
+  // According to AWS support, version is is extracted from the version property in the event.
+  // If there is no version property, then the version is implied as 1.0
+  const unknownEvent = event;
+
+  if (typeof unknownEvent.version === 'undefined') {
+    return '1.0';
+  } else {
+    if (['1.0', '2.0'].includes(unknownEvent.version)) {
+      return unknownEvent.version;
+    } else {
+      return 'custom';
+    }
+  }
+}
+
+const UNKNOWN_PAYLOAD_FORMAT_VERSION_ERROR_MESSAGE = 'Custom payload format version not handled by this adapter. Please use either 1.0 or 2.0. More information here' + 'https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-lambda.html';
+
+function lambdaEventToHTTPRequest(event) {
+  const query = new URLSearchParams();
+
+  for (const [key, value] of Object.entries((_event$queryStringPar = event.queryStringParameters) !== null && _event$queryStringPar !== void 0 ? _event$queryStringPar : {})) {
+    var _event$queryStringPar;
+
+    if (typeof value !== 'undefined') {
+      query.append(key, value);
+    }
+  }
+
+  return {
+    method: getHTTPMethod(event),
+    query: query,
+    headers: event.headers,
+    body: event.body
+  };
+}
+
+function getHTTPMethod(event) {
+  if (isPayloadV1(event)) {
+    return event.httpMethod;
+  }
+
+  if (isPayloadV2(event)) {
+    return event.requestContext.http.method;
+  }
+
+  throw new transformTRPCResponse.TRPCError({
+    code: 'INTERNAL_SERVER_ERROR',
+    message: UNKNOWN_PAYLOAD_FORMAT_VERSION_ERROR_MESSAGE
+  });
+}
+
+function getPath(event) {
+  if (isPayloadV1(event)) {
+    const matches = event.resource.matchAll(/\{(.*?)\}/g);
+
+    for (const match of matches) {
+      const group = match[1];
+
+      if (group.includes('+') && event.pathParameters) {
+        return event.pathParameters[group.replace('+', '')] || '';
+      }
+    }
+
+    return event.path.slice(1);
+  }
+
+  if (isPayloadV2(event)) {
+    const matches = event.routeKey.matchAll(/\{(.*?)\}/g);
+
+    for (const match of matches) {
+      const group = match[1];
+
+      if (group.includes('+') && event.pathParameters) {
+        return event.pathParameters[group.replace('+', '')] || '';
+      }
+    }
+
+    return event.rawPath.slice(1);
+  }
+
+  throw new transformTRPCResponse.TRPCError({
+    code: 'INTERNAL_SERVER_ERROR',
+    message: UNKNOWN_PAYLOAD_FORMAT_VERSION_ERROR_MESSAGE
+  });
+}
+
+function transformHeaders(headers) {
+  const obj = {};
+
+  for (const [key, value] of Object.entries(headers)) {
+    if (typeof value === 'undefined') {
+      continue;
+    }
+
+    obj[key] = Array.isArray(value) ? value.join(',') : value;
+  }
+
+  return obj;
+}
+
+function tRPCOutputToAPIGatewayOutput(event, response) {
+  if (isPayloadV1(event)) {
+    var _response$body, _response$headers;
+
+    const resp = {
+      statusCode: response.status,
+      body: (_response$body = response.body) !== null && _response$body !== void 0 ? _response$body : '',
+      headers: transformHeaders((_response$headers = response.headers) !== null && _response$headers !== void 0 ? _response$headers : {})
+    };
+    return resp;
+  } else if (isPayloadV2(event)) {
+    var _response$body2, _response$headers2;
+
+    const resp = {
+      statusCode: response.status,
+      body: (_response$body2 = response.body) !== null && _response$body2 !== void 0 ? _response$body2 : undefined,
+      headers: transformHeaders((_response$headers2 = response.headers) !== null && _response$headers2 !== void 0 ? _response$headers2 : {})
+    };
+    return resp;
+  } else {
+    throw new transformTRPCResponse.TRPCError({
+      code: 'INTERNAL_SERVER_ERROR',
+      message: UNKNOWN_PAYLOAD_FORMAT_VERSION_ERROR_MESSAGE
+    });
+  }
+}
+/** Will check the createContext of the TRouter and get the parameter of event.
+ * @internal
+ **/
+
+
+function awsLambdaRequestHandler(opts) {
+  return async (event, context) => {
+    const req = lambdaEventToHTTPRequest(event);
+    const path = getPath(event);
+
+    const createContext = async function _createContext() {
+      var _opts$createContext;
+
+      return await ((_opts$createContext = opts.createContext) === null || _opts$createContext === void 0 ? void 0 : _opts$createContext.call(opts, {
+        event,
+        context
+      }));
+    };
+
+    const response = await resolveHTTPResponse.resolveHTTPResponse({
+      router: opts.router,
+      batching: opts.batching,
+      responseMeta: opts === null || opts === void 0 ? void 0 : opts.responseMeta,
+      createContext,
+      req,
+      path,
+      error: null,
+
+      onError(o) {
+        var _opts$onError;
+
+        opts === null || opts === void 0 ? void 0 : (_opts$onError = opts.onError) === null || _opts$onError === void 0 ? void 0 : _opts$onError.call(opts, { ...o,
+          req: event
+        });
+      }
+
+    });
+    return tRPCOutputToAPIGatewayOutput(event, response);
+  };
+}
+
+exports.awsLambdaRequestHandler = awsLambdaRequestHandler;

package/adapters/aws-lambda/dist/trpc-server-adapters-aws-lambda.esm.js

@@ -0,0 +1,186 @@
+import '../../../dist/router-93491dae.esm.js';
+import 'events';
+import { T as TRPCError } from '../../../dist/transformTRPCResponse-45c225c3.esm.js';
+import 'http';
+import 'url';
+import '../../../dist/nodeHTTPRequestHandler-372a4a4f.esm.js';
+import { r as resolveHTTPResponse } from '../../../dist/resolveHTTPResponse-ddb56677.esm.js';
+import '../../../dist/codes-5678cc97.esm.js';
+
+function isPayloadV1(event) {
+  return determinePayloadFormat(event) == '1.0';
+}
+function isPayloadV2(event) {
+  return determinePayloadFormat(event) == '2.0';
+}
+
+function determinePayloadFormat(event) {
+  // https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-lambda.html
+  // According to AWS support, version is is extracted from the version property in the event.
+  // If there is no version property, then the version is implied as 1.0
+  const unknownEvent = event;
+
+  if (typeof unknownEvent.version === 'undefined') {
+    return '1.0';
+  } else {
+    if (['1.0', '2.0'].includes(unknownEvent.version)) {
+      return unknownEvent.version;
+    } else {
+      return 'custom';
+    }
+  }
+}
+
+const UNKNOWN_PAYLOAD_FORMAT_VERSION_ERROR_MESSAGE = 'Custom payload format version not handled by this adapter. Please use either 1.0 or 2.0. More information here' + 'https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-lambda.html';
+
+function lambdaEventToHTTPRequest(event) {
+  const query = new URLSearchParams();
+
+  for (const [key, value] of Object.entries((_event$queryStringPar = event.queryStringParameters) !== null && _event$queryStringPar !== void 0 ? _event$queryStringPar : {})) {
+    var _event$queryStringPar;
+
+    if (typeof value !== 'undefined') {
+      query.append(key, value);
+    }
+  }
+
+  return {
+    method: getHTTPMethod(event),
+    query: query,
+    headers: event.headers,
+    body: event.body
+  };
+}
+
+function getHTTPMethod(event) {
+  if (isPayloadV1(event)) {
+    return event.httpMethod;
+  }
+
+  if (isPayloadV2(event)) {
+    return event.requestContext.http.method;
+  }
+
+  throw new TRPCError({
+    code: 'INTERNAL_SERVER_ERROR',
+    message: UNKNOWN_PAYLOAD_FORMAT_VERSION_ERROR_MESSAGE
+  });
+}
+
+function getPath(event) {
+  if (isPayloadV1(event)) {
+    const matches = event.resource.matchAll(/\{(.*?)\}/g);
+
+    for (const match of matches) {
+      const group = match[1];
+
+      if (group.includes('+') && event.pathParameters) {
+        return event.pathParameters[group.replace('+', '')] || '';
+      }
+    }
+
+    return event.path.slice(1);
+  }
+
+  if (isPayloadV2(event)) {
+    const matches = event.routeKey.matchAll(/\{(.*?)\}/g);
+
+    for (const match of matches) {
+      const group = match[1];
+
+      if (group.includes('+') && event.pathParameters) {
+        return event.pathParameters[group.replace('+', '')] || '';
+      }
+    }
+
+    return event.rawPath.slice(1);
+  }
+
+  throw new TRPCError({
+    code: 'INTERNAL_SERVER_ERROR',
+    message: UNKNOWN_PAYLOAD_FORMAT_VERSION_ERROR_MESSAGE
+  });
+}
+
+function transformHeaders(headers) {
+  const obj = {};
+
+  for (const [key, value] of Object.entries(headers)) {
+    if (typeof value === 'undefined') {
+      continue;
+    }
+
+    obj[key] = Array.isArray(value) ? value.join(',') : value;
+  }
+
+  return obj;
+}
+
+function tRPCOutputToAPIGatewayOutput(event, response) {
+  if (isPayloadV1(event)) {
+    var _response$body, _response$headers;
+
+    const resp = {
+      statusCode: response.status,
+      body: (_response$body = response.body) !== null && _response$body !== void 0 ? _response$body : '',
+      headers: transformHeaders((_response$headers = response.headers) !== null && _response$headers !== void 0 ? _response$headers : {})
+    };
+    return resp;
+  } else if (isPayloadV2(event)) {
+    var _response$body2, _response$headers2;
+
+    const resp = {
+      statusCode: response.status,
+      body: (_response$body2 = response.body) !== null && _response$body2 !== void 0 ? _response$body2 : undefined,
+      headers: transformHeaders((_response$headers2 = response.headers) !== null && _response$headers2 !== void 0 ? _response$headers2 : {})
+    };
+    return resp;
+  } else {
+    throw new TRPCError({
+      code: 'INTERNAL_SERVER_ERROR',
+      message: UNKNOWN_PAYLOAD_FORMAT_VERSION_ERROR_MESSAGE
+    });
+  }
+}
+/** Will check the createContext of the TRouter and get the parameter of event.
+ * @internal
+ **/
+
+
+function awsLambdaRequestHandler(opts) {
+  return async (event, context) => {
+    const req = lambdaEventToHTTPRequest(event);
+    const path = getPath(event);
+
+    const createContext = async function _createContext() {
+      var _opts$createContext;
+
+      return await ((_opts$createContext = opts.createContext) === null || _opts$createContext === void 0 ? void 0 : _opts$createContext.call(opts, {
+        event,
+        context
+      }));
+    };
+
+    const response = await resolveHTTPResponse({
+      router: opts.router,
+      batching: opts.batching,
+      responseMeta: opts === null || opts === void 0 ? void 0 : opts.responseMeta,
+      createContext,
+      req,
+      path,
+      error: null,
+
+      onError(o) {
+        var _opts$onError;
+
+        opts === null || opts === void 0 ? void 0 : (_opts$onError = opts.onError) === null || _opts$onError === void 0 ? void 0 : _opts$onError.call(opts, { ...o,
+          req: event
+        });
+      }
+
+    });
+    return tRPCOutputToAPIGatewayOutput(event, response);
+  };
+}
+
+export { awsLambdaRequestHandler };

package/adapters/aws-lambda/index.d.ts

@@ -0,0 +1 @@
+export * from '../../dist/adapters/aws-lambda';

package/adapters/aws-lambda/index.js

@@ -0,0 +1 @@
+module.exports = require('../../dist/adapters/aws-lambda/index');

package/adapters/express/dist/trpc-server-adapters-express.cjs.dev.js

@@ -2,16 +2,17 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var nodeHTTPRequestHandler = require('../../../dist/nodeHTTPRequestHandler-b7ff366e.cjs.dev.js');
+var nodeHTTPRequestHandler = require('../../../dist/nodeHTTPRequestHandler-36ddaba2.cjs.dev.js');
 require('url');
-require('../../../dist/transformTRPCResponse-8248515e.cjs.dev.js');
-require('../../../dist/codes-33cef953.cjs.dev.js');
+require('../../../dist/resolveHTTPResponse-55b2c9bd.cjs.dev.js');
+require('../../../dist/transformTRPCResponse-c654ea92.cjs.dev.js');
+require('../../../dist/codes-130e62df.cjs.dev.js');
 
 /* eslint-disable @typescript-eslint/no-explicit-any */
 function createExpressMiddleware(opts) {
-  return (req, res) => {
-    const endpoint = req.path.substr(1);
-    nodeHTTPRequestHandler.nodeHTTPRequestHandler({ ...opts,
+  return async (req, res) => {
+    const endpoint = req.path.slice(1);
+    await nodeHTTPRequestHandler.nodeHTTPRequestHandler({ ...opts,
       req,
       res,
       path: endpoint