@typespec/http-server-js 0.58.0-alpha.10-dev.3

package/CHANGELOG.md

@@ -0,0 +1,69 @@
+# Changelog - @typespec/http-server-js
+
+## 0.58.0-alpha.9
+
+### Features
+
+- [#5906](https://github.com/microsoft/typespec/pull/5906) Implement basic project scaffolding.
+
+
+## 0.58.0-alpha.8
+
+### Bump dependencies
+
+- [#5690](https://github.com/microsoft/typespec/pull/5690) Upgrade dependencies
+
+
+## 0.58.0-alpha.7
+
+### Features
+
+- [#5514](https://github.com/microsoft/typespec/pull/5514) - Implemented new-style multipart request handling.
+- Fixed JSON serialization/deserialization in some cases where models that required serialization occurred within arrays.
+
+
+## 0.58.0-alpha.6
+
+### Bug Fixes
+
+- [#5253](https://github.com/microsoft/typespec/pull/5253) Added an additional check for the presence of a property before performing a bounds check on integer properties constrained to a range.
+- [#5253](https://github.com/microsoft/typespec/pull/5253) Fixed a null check in query parameter requiredness check by replacing it with a falseness check.
+- [#5188](https://github.com/microsoft/typespec/pull/5188) Added logic to handle "unspeakable" identifier names (#5185)
+
+
+## 0.58.0-alpha.5
+
+### Bump dependencies
+
+- [#4679](https://github.com/microsoft/typespec/pull/4679) Upgrade dependencies - October 2024
+
+### Features
+
+- [#4761](https://github.com/microsoft/typespec/pull/4761) Add `@cookie` decorator to specify cookie parameters
+
+
+## 0.58.0-alpha.4
+
+### Bump dependencies
+
+- [#4424](https://github.com/microsoft/typespec/pull/4424) Bump dependencies
+
+
+## 0.58.0-alpha.3
+
+No changes, version bump only.
+
+## 0.58.0-alpha.2
+
+### Bug Fixes
+
+- [#3933](https://github.com/microsoft/typespec/pull/3933) Fix some diagnostic not showing the right message
+- [#4101](https://github.com/microsoft/typespec/pull/4101) Fixed enum representation, an edge case with optional parameter joining, and a couple of type errors around query/header params.
+- [#4115](https://github.com/microsoft/typespec/pull/4115) Fixed a router bug where paths would sometimes fail to match after a parameter was bound.
+
+### Bump dependencies
+
+- [#3948](https://github.com/microsoft/typespec/pull/3948) Update dependencies
+
+
+

package/LICENSE

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation. All rights reserved.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

package/README.md

@@ -0,0 +1,183 @@
+# @typespec/http-server-js
+
+:warning: **This package is highly experimental and may be subject to breaking changes and bugs.** Please expect that your code may need to be updated as this package evolves, and please report any issues you encounter.
+
+TypeSpec HTTP server code generator for JavaScript and TypeScript.
+
+This package generates an implementation of an HTTP server layer for a TypeSpec API. It supports binding directly to a
+Node.js HTTP server or Express.js application.
+
+## Install
+
+```bash
+npm install @typespec/http-server-js
+```
+
+## Emitter
+
+### Usage
+
+1. Via the command line
+
+```bash
+tsp compile . --emit=@typespec/http-server-js
+```
+
+2. Via the config
+
+```yaml
+emit:
+  - "@typespec/http-server-js"
+```
+
+### Emitter options
+
+#### `express`
+
+**Type:** `boolean`
+
+If set to `true`, the emitter will generate a router that exposes an Express.js middleware function in addition to the
+ordinary Node.js HTTP server router.
+
+If this option is not set to `true`, the `expressMiddleware` property will not be present on the generated router.
+
+#### `omit-unreachable-types`
+
+**Type:** `boolean`
+
+By default, the emitter will create interfaces that represent all models in the service namespace. If this option is set
+to `true`, the emitter will only emit those types that are reachable from an HTTP operation.
+
+#### `no-format`
+
+**Type:** `boolean`
+
+If set to `true`, the emitter will not format the generated code using Prettier.
+
+## Functionality and generated code
+
+The emitter generates a few major components:
+
+### Router
+
+The highest-level component that your code interacts with directly is the router implementation.
+`@typespec/http-server-js` generates a static router that you can bind to an implementation of an HTTP server.
+
+The router is generated in the `http/router.js` module within the output directory. Each service will have its own
+router implementation named after the service. For example, given a service namespace named `Todo`, the router module
+will export a function `createTodoRouter`. This function creates an instance of a router that dispatches methods within
+the `Todo` service.
+
+```ts
+import { createTodoRouter } from "../tsp-output/@typespec/http-server-js/http/router.js";
+
+const router = createTodoRouter(users, todoItems, attachments);
+```
+
+As arguments, the `createTodoRouter` function expects implementations of the underlying service interfaces. These
+interfaces are explained further in the next section.
+
+Once the router is created, it is bound to an instance of the HTTP server. The router's `dispatch` method implements the
+Node.js event handler signature for the `request` event on a Node.js HTTP server.
+
+```ts
+const server = http.createServer();
+
+server.on("request", router.dispatch);
+
+server.listen(8080, () => {
+  console.log("Server listening on http://localhost:8080");
+});
+```
+
+Alternatively, the router can be used with Express.js instead of the Node.js HTTP server directly. If the `express`
+feature is enabled in the emitter options, the router will expose an `expressMiddleware` property that implements the
+Express.js middleware interface.
+
+```ts
+import express from "express";
+
+const app = express();
+
+app.use(router.expressMiddleware);
+
+app.listen(8080, () => {
+  console.log("Server listening on http://localhost:8080");
+});
+```
+
+### Service interfaces
+
+The emitter generates interfaces for each collection of service methods that exists in the service namespace.
+Implementations of these interfaces are required to instantiate the router. When the router processes an HTTP request,
+it will call the appropriate method on the service implementation after determining the route and method.
+
+For example, given the following TypeSpec namespace `Users` within the `Todo` service:
+
+```tsp
+namespace Users {
+  @route("/users")
+  @post
+  op create(
+    user: User,
+  ): WithStandardErrors<UserCreatedResponse | UserExistsResponse | InvalidUserResponse>;
+}
+```
+
+The emitter will generate a corresponding interface `Users` within the module `models/all/todo/index.js` in the output
+directory.
+
+```ts
+/** An interface representing the operations defined in the 'Todo.Users' namespace. */
+export interface Users<Context = unknown> {
+  create(
+    ctx: Context,
+    user: User,
+  ): Promise<
+    | UserCreatedResponse
+    | UserExistsResponse
+    | InvalidUserResponse
+    | Standard4XxResponse
+    | Standard5XxResponse
+  >;
+}
+```
+
+An object implementing this `Users` interface must be passed to the router when it is created. The `Context` type
+parameter represents the underlying protocol or framework-specific context that the service implementation may inspect.
+If you need to access the HTTP request or response objects directly in the implementation of the service methods, you
+must use the `HttpContext` type as the `Context` argument when implementing the service interface. Otherwise, it is safe
+to use the default `unknown` argument.
+
+```ts
+import { HttpContext } from "../tsp-output/@typespec/http-server-js/helpers/router.js";
+import { Users } from "../tsp-output/@typespec/http-server-js/models/all/todo/index.js";
+
+export const users: Users<HttpContext> = {
+  async create(ctx, user) {
+    // Implementation
+  },
+};
+```
+
+### Models
+
+The emitter generates TypeScript interfaces that represent the model types used in the service operations. This allows
+the service implementation to interact with the data structures carried over the HTTP protocol in a type-safe manner.
+
+### Operation functions
+
+While your code should never need to interact with these functions directly, the emitter generates a function per HTTP
+operation that handles the parsing and validation of the request contents. This allows the service implementation to be
+written in terms of ordinary TypeScript types and values rather than raw HTTP request and response objects. In general:
+
+- The Node.js HTTP server or Express.js application (your code) calls the router (generated code), which determines
+  which service operation function (generated code) to call based on the route, method, and other HTTP metadata in the
+  case of shared routes.
+- The operation function (generated code) deserializes the request body, query parameters, and headers into TypeScript
+  types, and may perform request validation.
+- The operation function (generated code) calls the service implementation (your code) with the deserialized request
+  data.
+- The service implementation (your code) returns a result or throws an error.
+- The operation function (generated code) responds to the HTTP request on your behalf, converting the result or error
+  into HTTP response data.

package/build-helpers.ts

@@ -0,0 +1,170 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+/* eslint no-console: "off" */
+
+import fs from "node:fs/promises";
+import path from "node:path";
+
+const HELPER_DECLARATION_PATH = path.resolve("generated-defs", "helpers");
+const HELPER_SRC_PATH = path.resolve("src", "helpers");
+
+console.log("Building JS server generator helpers.");
+
+async function* visitAllFiles(base: string): AsyncIterable<string> {
+  const contents = await fs.readdir(base, { withFileTypes: true });
+
+  for (const entry of contents) {
+    if (entry.isDirectory()) {
+      yield* visitAllFiles(path.join(base, entry.name));
+    } else if (entry.isFile()) {
+      yield path.join(base, entry.name);
+    }
+  }
+}
+
+async function main() {
+  const allFiles: string[] = [];
+  const indices = new Map<string, string[]>();
+
+  const ctxPath = path.resolve("src", "ctx.js");
+
+  await fs.rm(HELPER_DECLARATION_PATH, { recursive: true, force: true });
+
+  function addIndex(dir: string, file: string) {
+    const index = indices.get(dir);
+
+    if (index) {
+      index.push(file);
+    } else {
+      indices.set(dir, [file]);
+    }
+  }
+
+  for await (const file of visitAllFiles(HELPER_SRC_PATH)) {
+    allFiles.push(file);
+    addIndex(path.dirname(file), file);
+  }
+
+  for (const file of allFiles) {
+    if (!file.endsWith(".ts")) {
+      continue;
+    }
+
+    const relativePath = path.relative(HELPER_SRC_PATH, file);
+
+    console.log("Building helper:", relativePath);
+
+    const targetPath = path.resolve(HELPER_DECLARATION_PATH, relativePath);
+
+    const targetDir = path.dirname(targetPath);
+    const targetFileBase = path.basename(targetPath, ".ts");
+    const isIndex = targetFileBase === "index";
+    const targetBase = isIndex ? path.basename(targetDir) : targetFileBase;
+    await fs.mkdir(targetDir, { recursive: true });
+
+    const childModules = isIndex ? indices.get(path.dirname(file)) : [];
+
+    if (isIndex) {
+      indices.delete(path.dirname(file));
+    }
+
+    const contents = await fs.readFile(file, "utf-8");
+
+    let childModuleLines =
+      childModules
+        ?.filter((m) => path.basename(m, ".ts") !== "index")
+        .map((child) => {
+          const childBase = path.basename(child, ".ts");
+          return `  await import("./${childBase}.js").then((m) => m.createModule(module));`;
+        }) ?? [];
+
+    if (childModuleLines.length > 0) {
+      childModuleLines = ["      // Child modules", ...childModuleLines, ""];
+    }
+
+    const transformed = [
+      "// Copyright (c) Microsoft Corporation",
+      "// Licensed under the MIT license.",
+      "",
+      `import { Module } from "${path.relative(targetDir, ctxPath).replace(/\\/g, "/")}";`,
+      "",
+      "export let module: Module = undefined as any;",
+      "",
+      "// prettier-ignore",
+      "const lines = [",
+      ...contents.split(/\r?\n/).map((line) => "  " + JSON.stringify(line) + ","),
+      "];",
+      "",
+      "export async function createModule(parent: Module): Promise<Module> {",
+      "  if (module) return module;",
+      "",
+      "  module = {",
+      `    name: ${JSON.stringify(targetBase)},`,
+      `    cursor: parent.cursor.enter(${JSON.stringify(targetBase)}),`,
+      "    imports: [],",
+      "    declarations: [],",
+      "  };",
+      "",
+      ...childModuleLines,
+      "  module.declarations.push(lines);",
+      "",
+      "  parent.declarations.push(module);",
+      "",
+      "  return module;",
+      "}",
+      "",
+    ].join("\n");
+
+    await fs.writeFile(targetPath, transformed);
+  }
+
+  console.log("Building index files.");
+
+  for (const [dir, files] of indices.entries()) {
+    console.log("Building index:", dir);
+
+    const relativePath = path.relative(HELPER_SRC_PATH, dir);
+
+    const targetPath = path.resolve(HELPER_DECLARATION_PATH, relativePath, "index.ts");
+
+    const children = files.map((file) => {
+      return `  await import("./${path.basename(file, ".ts")}.js").then((m) => m.createModule(module));`;
+    });
+
+    const transformed = [
+      "// Copyright (c) Microsoft Corporation",
+      "// Licensed under the MIT license.",
+      "",
+      `import { Module } from "${path.relative(path.dirname(targetPath), ctxPath).replace(/\\/g, "/")}";`,
+      "",
+      "export let module: Module = undefined as any;",
+      "",
+      "export async function createModule(parent: Module): Promise<Module> {",
+      "  if (module) return module;",
+      "",
+      "  module = {",
+      `    name: ${JSON.stringify(path.basename(dir))},`,
+      `    cursor: parent.cursor.enter(${JSON.stringify(path.basename(dir))}),`,
+      "    imports: [],",
+      "    declarations: [],",
+      "  };",
+      "",
+      "  // Child modules",
+      ...children,
+      "",
+      "  parent.declarations.push(module);",
+      "",
+      "  return module;",
+      "}",
+      "",
+    ].join("\n");
+
+    await fs.writeFile(targetPath, transformed);
+  }
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/dist/generated-defs/helpers/header.d.ts

@@ -0,0 +1,4 @@
+import { Module } from "../../src/ctx.js";
+export declare let module: Module;
+export declare function createModule(parent: Module): Promise<Module>;
+//# sourceMappingURL=header.d.ts.map

package/dist/generated-defs/helpers/header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../../generated-defs/helpers/header.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,eAAO,IAAI,MAAM,EAAE,MAAyB,CAAC;AA8D7C,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAelE"}

package/dist/generated-defs/helpers/header.js

@@ -0,0 +1,76 @@
+// Copyright (c) Microsoft Corporation
+// Licensed under the MIT license.
+export let module = undefined;
+// prettier-ignore
+const lines = [
+    "// Copyright (c) Microsoft Corporation",
+    "// Licensed under the MIT license.",
+    "",
+    "export interface HeaderValueParameters {",
+    "  value: string;",
+    "  verbatim: string;",
+    "  params: { [k: string]: string };",
+    "}",
+    "",
+    "/**",
+    " * Parses a header value that may contain additional parameters (e.g. `text/html; charset=utf-8`).",
+    " * @param headerValueText - the text of the header value to parse",
+    " * @returns an object containing the value and a map of parameters",
+    " */",
+    "export function parseHeaderValueParameters<Header extends string | undefined>(",
+    "  headerValueText: Header,",
+    "): undefined extends Header ? HeaderValueParameters | undefined : HeaderValueParameters {",
+    "  if (headerValueText === undefined) {",
+    "    return undefined as any;",
+    "  }",
+    "",
+    "  const idx = headerValueText.indexOf(\";\");",
+    "  const [value, _paramsText] =",
+    "    idx === -1",
+    "      ? [headerValueText, \"\"]",
+    "      : [headerValueText.slice(0, idx), headerValueText.slice(idx + 1)];",
+    "",
+    "  let paramsText = _paramsText;",
+    "",
+    "  // Parameters are a sequence of key=value pairs separated by semicolons, but the value may be quoted in which case it",
+    "  // may contain semicolons. We use a regular expression to iteratively split the parameters into key=value pairs.",
+    "  const params: { [k: string]: string } = {};",
+    "",
+    "  let match;",
+    "",
+    "  // TODO: may need to support ext-parameter (e.g. \"filename*=UTF-8''%e2%82%ac%20rates\" => { filename: \"€ rates\" }).",
+    "  // By default we decoded everything as UTF-8, and non-UTF-8 agents are a dying breed, but we may need to support",
+    "  // this for completeness. If we do support it, we'll prefer an ext-parameter over a regular parameter. Currently, we'll",
+    "  // just treat them as separate keys and put the raw value in the parameter.",
+    "  //",
+    "  // https://datatracker.ietf.org/doc/html/rfc5987#section-3.2.1",
+    "  while ((match = paramsText.match(/\\s*([^=]+)=(?:\"([^\"]+)\"|([^;]+));?/))) {",
+    "    const [, key, quotedValue, unquotedValue] = match;",
+    "",
+    "    params[key.trim()] = quotedValue ?? unquotedValue;",
+    "",
+    "    paramsText = paramsText.slice(match[0].length);",
+    "  }",
+    "",
+    "  return {",
+    "    value: value.trim(),",
+    "    verbatim: headerValueText,",
+    "    params,",
+    "  };",
+    "}",
+    "",
+];
+export async function createModule(parent) {
+    if (module)
+        return module;
+    module = {
+        name: "header",
+        cursor: parent.cursor.enter("header"),
+        imports: [],
+        declarations: [],
+    };
+    module.declarations.push(lines);
+    parent.declarations.push(module);
+    return module;
+}
+//# sourceMappingURL=header.js.map

package/dist/generated-defs/helpers/header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.js","sourceRoot":"","sources":["../../../generated-defs/helpers/header.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,kCAAkC;AAIlC,MAAM,CAAC,IAAI,MAAM,GAAW,SAAgB,CAAC;AAE7C,kBAAkB;AAClB,MAAM,KAAK,GAAG;IACZ,wCAAwC;IACxC,oCAAoC;IACpC,EAAE;IACF,0CAA0C;IAC1C,kBAAkB;IAClB,qBAAqB;IACrB,oCAAoC;IACpC,GAAG;IACH,EAAE;IACF,KAAK;IACL,oGAAoG;IACpG,mEAAmE;IACnE,oEAAoE;IACpE,KAAK;IACL,gFAAgF;IAChF,4BAA4B;IAC5B,2FAA2F;IAC3F,wCAAwC;IACxC,8BAA8B;IAC9B,KAAK;IACL,EAAE;IACF,+CAA+C;IAC/C,gCAAgC;IAChC,gBAAgB;IAChB,iCAAiC;IACjC,0EAA0E;IAC1E,EAAE;IACF,iCAAiC;IACjC,EAAE;IACF,yHAAyH;IACzH,oHAAoH;IACpH,+CAA+C;IAC/C,EAAE;IACF,cAAc;IACd,EAAE;IACF,0HAA0H;IAC1H,oHAAoH;IACpH,2HAA2H;IAC3H,+EAA+E;IAC/E,MAAM;IACN,kEAAkE;IAClE,kFAAkF;IAClF,wDAAwD;IACxD,EAAE;IACF,wDAAwD;IACxD,EAAE;IACF,qDAAqD;IACrD,KAAK;IACL,EAAE;IACF,YAAY;IACZ,0BAA0B;IAC1B,gCAAgC;IAChC,aAAa;IACb,MAAM;IACN,GAAG;IACH,EAAE;CACH,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc;IAC/C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,GAAG;QACP,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;QACrC,OAAO,EAAE,EAAE;QACX,YAAY,EAAE,EAAE;KACjB,CAAC;IAEF,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEhC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/generated-defs/helpers/http.d.ts

@@ -0,0 +1,4 @@
+import { Module } from "../../src/ctx.js";
+export declare let module: Module;
+export declare function createModule(parent: Module): Promise<Module>;
+//# sourceMappingURL=http.d.ts.map

package/dist/generated-defs/helpers/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../generated-defs/helpers/http.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,eAAO,IAAI,MAAM,EAAE,MAAyB,CAAC;AAwH7C,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAelE"}

package/dist/generated-defs/helpers/http.js

@@ -0,0 +1,134 @@
+// Copyright (c) Microsoft Corporation
+// Licensed under the MIT license.
+export let module = undefined;
+// prettier-ignore
+const lines = [
+    "// Copyright (c) Microsoft Corporation.",
+    "// Licensed under the MIT License.",
+    "",
+    "import { HttpContext } from \"./router.js\";",
+    "",
+    "export const HTTP_RESPONDER = Symbol.for(\"@typespec/http-server-js.HttpResponder\");",
+    "",
+    "/**",
+    " * A type that can respond to an HTTP request.",
+    " */",
+    "export interface HttpResponder {",
+    "  /**",
+    "   * A function that handles an HTTP request and response.",
+    "   *",
+    "   * @param context - The HTTP context.",
+    "   */",
+    "  [HTTP_RESPONDER]: (context: HttpContext) => void;",
+    "}",
+    "",
+    "/**",
+    " * Determines if a value is an HttpResponder.",
+    " * @param value - The value to check.",
+    " * @returns `true` if the value is an HttpResponder, otherwise `false`.",
+    " */",
+    "export function isHttpResponder(value: unknown): value is HttpResponder {",
+    "  return (",
+    "    typeof value === \"object\" &&",
+    "    value !== null &&",
+    "    HTTP_RESPONDER in value &&",
+    "    typeof value[HTTP_RESPONDER] === \"function\"",
+    "  );",
+    "}",
+    "",
+    "/**",
+    " * An Error that can respond to an HTTP request if thrown from a route handler.",
+    " */",
+    "export class HttpResponderError extends Error implements HttpResponder {",
+    "  #statusCode: number;",
+    "",
+    "  constructor(statusCode: number, message: string) {",
+    "    super(message);",
+    "    this.#statusCode = statusCode;",
+    "  }",
+    "",
+    "  [HTTP_RESPONDER](ctx: HttpContext): void {",
+    "    ctx.response.statusCode = this.#statusCode;",
+    "    ctx.response.setHeader(\"Content-Type\", \"text/plain\");",
+    "    ctx.response.end(this.message);",
+    "  }",
+    "}",
+    "",
+    "/**",
+    " * The requested resource was not found.",
+    " */",
+    "export class NotFoundError extends HttpResponderError {",
+    "  constructor() {",
+    "    super(404, \"Not Found\");",
+    "  }",
+    "}",
+    "",
+    "/**",
+    " * The request was malformed.",
+    " */",
+    "export class BadRequestError extends HttpResponderError {",
+    "  constructor() {",
+    "    super(400, \"Bad Request\");",
+    "  }",
+    "}",
+    "",
+    "/**",
+    " * The request is missing required authentication credentials.",
+    " */",
+    "export class UnauthorizedError extends HttpResponderError {",
+    "  constructor() {",
+    "    super(401, \"Unauthorized\");",
+    "  }",
+    "}",
+    "",
+    "/**",
+    " * The request is missing required permissions.",
+    " */",
+    "export class ForbiddenError extends HttpResponderError {",
+    "  constructor() {",
+    "    super(403, \"Forbidden\");",
+    "  }",
+    "}",
+    "",
+    "/**",
+    " * The request conflicts with the current state of the server.",
+    " */",
+    "export class ConflictError extends HttpResponderError {",
+    "  constructor() {",
+    "    super(409, \"Conflict\");",
+    "  }",
+    "}",
+    "",
+    "/**",
+    " * The server encountered an unexpected condition that prevented it from fulfilling the request.",
+    " */",
+    "export class InternalServerError extends HttpResponderError {",
+    "  constructor() {",
+    "    super(500, \"Internal Server Error\");",
+    "  }",
+    "}",
+    "",
+    "/**",
+    " * The server does not support the functionality required to fulfill the request.",
+    " */",
+    "export class NotImplementedError extends HttpResponderError {",
+    "  constructor() {",
+    "    super(501, \"Not Implemented\");",
+    "  }",
+    "}",
+    "",
+];
+export async function createModule(parent) {
+    if (module)
+        return module;
+    module = {
+        name: "http",
+        cursor: parent.cursor.enter("http"),
+        imports: [],
+        declarations: [],
+    };
+    module.declarations.push(lines);
+    parent.declarations.push(module);
+    return module;
+}
+//# sourceMappingURL=http.js.map

package/dist/generated-defs/helpers/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../generated-defs/helpers/http.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,kCAAkC;AAIlC,MAAM,CAAC,IAAI,MAAM,GAAW,SAAgB,CAAC;AAE7C,kBAAkB;AAClB,MAAM,KAAK,GAAG;IACZ,yCAAyC;IACzC,oCAAoC;IACpC,EAAE;IACF,8CAA8C;IAC9C,EAAE;IACF,uFAAuF;IACvF,EAAE;IACF,KAAK;IACL,gDAAgD;IAChD,KAAK;IACL,kCAAkC;IAClC,OAAO;IACP,4DAA4D;IAC5D,MAAM;IACN,yCAAyC;IACzC,OAAO;IACP,qDAAqD;IACrD,GAAG;IACH,EAAE;IACF,KAAK;IACL,+CAA+C;IAC/C,uCAAuC;IACvC,yEAAyE;IACzE,KAAK;IACL,2EAA2E;IAC3E,YAAY;IACZ,oCAAoC;IACpC,uBAAuB;IACvB,gCAAgC;IAChC,mDAAmD;IACnD,MAAM;IACN,GAAG;IACH,EAAE;IACF,KAAK;IACL,iFAAiF;IACjF,KAAK;IACL,0EAA0E;IAC1E,wBAAwB;IACxB,EAAE;IACF,sDAAsD;IACtD,qBAAqB;IACrB,oCAAoC;IACpC,KAAK;IACL,EAAE;IACF,8CAA8C;IAC9C,iDAAiD;IACjD,+DAA+D;IAC/D,qCAAqC;IACrC,KAAK;IACL,GAAG;IACH,EAAE;IACF,KAAK;IACL,0CAA0C;IAC1C,KAAK;IACL,yDAAyD;IACzD,mBAAmB;IACnB,gCAAgC;IAChC,KAAK;IACL,GAAG;IACH,EAAE;IACF,KAAK;IACL,+BAA+B;IAC/B,KAAK;IACL,2DAA2D;IAC3D,mBAAmB;IACnB,kCAAkC;IAClC,KAAK;IACL,GAAG;IACH,EAAE;IACF,KAAK;IACL,gEAAgE;IAChE,KAAK;IACL,6DAA6D;IAC7D,mBAAmB;IACnB,mCAAmC;IACnC,KAAK;IACL,GAAG;IACH,EAAE;IACF,KAAK;IACL,iDAAiD;IACjD,KAAK;IACL,0DAA0D;IAC1D,mBAAmB;IACnB,gCAAgC;IAChC,KAAK;IACL,GAAG;IACH,EAAE;IACF,KAAK;IACL,gEAAgE;IAChE,KAAK;IACL,yDAAyD;IACzD,mBAAmB;IACnB,+BAA+B;IAC/B,KAAK;IACL,GAAG;IACH,EAAE;IACF,KAAK;IACL,kGAAkG;IAClG,KAAK;IACL,+DAA+D;IAC/D,mBAAmB;IACnB,4CAA4C;IAC5C,KAAK;IACL,GAAG;IACH,EAAE;IACF,KAAK;IACL,mFAAmF;IACnF,KAAK;IACL,+DAA+D;IAC/D,mBAAmB;IACnB,sCAAsC;IACtC,KAAK;IACL,GAAG;IACH,EAAE;CACH,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc;IAC/C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,GAAG;QACP,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QACnC,OAAO,EAAE,EAAE;QACX,YAAY,EAAE,EAAE;KACjB,CAAC;IAEF,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEhC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjC,OAAO,MAAM,CAAC;AAChB,CAAC"}