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

package/dist/src/util/scope.js

@@ -0,0 +1,111 @@
+import { NoTarget } from "@typespec/compiler";
+import { reportDiagnostic } from "../lib.js";
+import { UnreachableError } from "./error.js";
+const DEFAULT_DECLARATION_OPTIONS = {
+    source: NoTarget,
+    resolutionStrategy: "shadow",
+};
+const NO_PARENT = {
+    declare() {
+        throw new UnreachableError("Cannot declare in the no-parent scope");
+    },
+    isDeclared() {
+        return false;
+    },
+};
+/**
+ * Create a new scope.
+ *
+ * @param ctx - the JS emitter context.
+ * @param parent - an optional parent scope for this scope. It will consider declarations in the parent scope for some conflicts.
+ */
+export function createScope(ctx, parent = NO_PARENT) {
+    const ownDeclarations = new Set();
+    const self = {
+        declare(primaryName, options = {}) {
+            const { source: target, resolutionStrategy } = { ...DEFAULT_DECLARATION_OPTIONS, ...options };
+            if (!self.isDeclared(primaryName)) {
+                ownDeclarations.add(primaryName);
+                return primaryName;
+            }
+            // Apply resolution strategy
+            const resolutionStrategyName = typeof resolutionStrategy === "string" ? resolutionStrategy : resolutionStrategy.kind;
+            switch (resolutionStrategyName) {
+                case "none":
+                    // Report diagnostic and return the name as is.
+                    reportDiagnostic(ctx.program, {
+                        code: "name-conflict",
+                        format: {
+                            name: primaryName,
+                        },
+                        target,
+                    });
+                    return primaryName;
+                case "shadow":
+                    // Check to make sure this name isn't an own-declaration, and if not allow it, otherwise raise a diagnostic.
+                    if (!ownDeclarations.has(primaryName)) {
+                        ownDeclarations.add(primaryName);
+                        return primaryName;
+                    }
+                    else {
+                        reportDiagnostic(ctx.program, {
+                            code: "name-conflict",
+                            format: {
+                                name: primaryName,
+                            },
+                            target,
+                        });
+                        return primaryName;
+                    }
+                case "prefix": {
+                    const { prefix = "_", repeated = false, shadow = true, } = resolutionStrategy;
+                    let name = primaryName;
+                    const isDeclared = shadow ? (name) => ownDeclarations.has(name) : self.isDeclared;
+                    while (isDeclared(name)) {
+                        name = prefix + name;
+                        if (!repeated)
+                            break;
+                    }
+                    if (isDeclared(name)) {
+                        // We were not able to resolve the conflict with this strategy, so raise a diagnostic.
+                        reportDiagnostic(ctx.program, {
+                            code: "name-conflict",
+                            format: {
+                                name: name,
+                            },
+                            target,
+                        });
+                        return name;
+                    }
+                    ownDeclarations.add(name);
+                    return name;
+                }
+                case "alt-name": {
+                    const { altName } = resolutionStrategy;
+                    if (!self.isDeclared(altName)) {
+                        ownDeclarations.add(altName);
+                        return altName;
+                    }
+                    // We were not able to resolve the conflict with this strategy, so raise a diagnostic.
+                    reportDiagnostic(ctx.program, {
+                        code: "name-conflict",
+                        format: {
+                            name: altName,
+                        },
+                        target,
+                    });
+                    return altName;
+                }
+                default:
+                    throw new UnreachableError(`Unknown resolution strategy: ${resolutionStrategy}`, {
+                        resolutionStrategyName,
+                    });
+            }
+        },
+        isDeclared(name) {
+            return ownDeclarations.has(name) || parent.isDeclared(name);
+        },
+    };
+    return self;
+}
+//# sourceMappingURL=scope.js.map

package/dist/src/util/scope.js.map

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

package/dist/src/write.d.ts

@@ -0,0 +1,23 @@
+import { JsContext, Module } from "./ctx.js";
+import { OnceQueue } from "./util/once-queue.js";
+/**
+ * Writes the tree of modules to the output directory.
+ *
+ * @param ctx - The emitter context.
+ * @param baseOutputPath - The base output directory to write the module tree to.
+ * @param rootModule - The root module to begin emitting from.
+ * @param format - Whether to format the output using Prettier.
+ */
+export declare function writeModuleTree(ctx: JsContext, baseOutputPath: string, rootModule: Module, format: boolean): Promise<void>;
+/**
+ * Write a single module file to the output directory.
+ *
+ * @param ctx - The emitter context.
+ * @param baseOutputPath - The base output directory to write the module tree to.
+ * @param module - The module to write.
+ * @param queue - The queue of modules to write.
+ * @param format - Whether to format the output using Prettier.
+ * @param spit - The function used to write the file to disk (default: `ctx.program.host.writeFile`).
+ */
+export declare function writeModuleFile(ctx: JsContext, baseOutputPath: string, module: Module, queue: OnceQueue<Module>, format: boolean, spit?: (path: string, contents: string) => Promise<void>): Promise<void>;
+//# sourceMappingURL=write.d.ts.map

package/dist/src/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/write.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAY,MAAM,UAAU,CAAC;AAGvD,OAAO,EAAE,SAAS,EAAmB,MAAM,sBAAsB,CAAC;AAQlE;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,SAAS,EACd,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,SAAS,EACd,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EACxB,MAAM,EAAE,OAAO,EACf,IAAI,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAGrD,GACA,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/dist/src/write.js

@@ -0,0 +1,62 @@
+// Copyright (c) Microsoft Corporation
+// Licensed under the MIT license.
+import { resolvePath } from "@typespec/compiler";
+import { isModule } from "./ctx.js";
+import { emitModuleBody } from "./common/namespace.js";
+import { createOnceQueue } from "./util/once-queue.js";
+import * as prettier from "prettier";
+import { EOL } from "os";
+import path from "path";
+import { bifilter } from "./util/iter.js";
+/**
+ * Writes the tree of modules to the output directory.
+ *
+ * @param ctx - The emitter context.
+ * @param baseOutputPath - The base output directory to write the module tree to.
+ * @param rootModule - The root module to begin emitting from.
+ * @param format - Whether to format the output using Prettier.
+ */
+export async function writeModuleTree(ctx, baseOutputPath, rootModule, format) {
+    const queue = createOnceQueue(rootModule);
+    while (!queue.isEmpty()) {
+        const module = queue.take();
+        await writeModuleFile(ctx, baseOutputPath, module, queue, format);
+    }
+}
+/**
+ * Write a single module file to the output directory.
+ *
+ * @param ctx - The emitter context.
+ * @param baseOutputPath - The base output directory to write the module tree to.
+ * @param module - The module to write.
+ * @param queue - The queue of modules to write.
+ * @param format - Whether to format the output using Prettier.
+ * @param spit - The function used to write the file to disk (default: `ctx.program.host.writeFile`).
+ */
+export async function writeModuleFile(ctx, baseOutputPath, module, queue, format, spit = async (name, contents) => {
+    await ctx.program.host.mkdirp(path.dirname(name));
+    await ctx.program.host.writeFile(name, contents);
+}) {
+    const moduleText = [
+        "// Generated by Microsoft TypeSpec",
+        "",
+        ...emitModuleBody(ctx, module, queue),
+    ];
+    const [declaredModules, declaredText] = bifilter(module.declarations, isModule);
+    if (declaredText.length === 0) {
+        // Early exit to avoid writing an empty module.
+        return;
+    }
+    const isIndex = module.cursor.path.length === 0 || declaredModules.length > 0;
+    const moduleRelativePath = module.cursor.path.length > 0
+        ? module.cursor.path.join("/") + (isIndex ? "/index.ts" : ".ts")
+        : "index.ts";
+    const modulePath = resolvePath(baseOutputPath, moduleRelativePath);
+    const text = format
+        ? await prettier.format(moduleText.join(EOL), {
+            parser: "typescript",
+        })
+        : moduleText.join(EOL);
+    await spit(modulePath, text);
+}
+//# sourceMappingURL=write.js.map

package/dist/src/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/write.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,kCAAkC;AAElC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAqB,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAa,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAc,EACd,cAAsB,EACtB,UAAkB,EAClB,MAAe;IAEf,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAE1C,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAG,CAAC;QAC7B,MAAM,eAAe,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAc,EACd,cAAsB,EACtB,MAAc,EACd,KAAwB,EACxB,MAAe,EACf,OAA0D,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IACjF,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC;IAED,MAAM,UAAU,GAAG;QACjB,oCAAoC;QACpC,EAAE;QACF,GAAG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC;KACtC,CAAC;IAEF,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAEhF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,+CAA+C;QAC/C,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;IAE9E,MAAM,kBAAkB,GACtB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAC3B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC;QAChE,CAAC,CAAC,UAAU,CAAC;IAEjB,MAAM,UAAU,GAAG,WAAW,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IAEnE,MAAM,IAAI,GAAG,MAAM;QACjB,CAAC,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YAC1C,MAAM,EAAE,YAAY;SACrB,CAAC;QACJ,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEzB,MAAM,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/generated-defs/helpers/header.ts

@@ -0,0 +1,83 @@
+// Copyright (c) Microsoft Corporation
+// Licensed under the MIT license.
+
+import { Module } from "../../src/ctx.js";
+
+export let module: Module = undefined as any;
+
+// 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: Module): Promise<Module> {
+  if (module) return module;
+
+  module = {
+    name: "header",
+    cursor: parent.cursor.enter("header"),
+    imports: [],
+    declarations: [],
+  };
+
+  module.declarations.push(lines);
+
+  parent.declarations.push(module);
+
+  return module;
+}

package/generated-defs/helpers/http.ts

@@ -0,0 +1,141 @@
+// Copyright (c) Microsoft Corporation
+// Licensed under the MIT license.
+
+import { Module } from "../../src/ctx.js";
+
+export let module: Module = undefined as any;
+
+// 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: Module): Promise<Module> {
+  if (module) return module;
+
+  module = {
+    name: "http",
+    cursor: parent.cursor.enter("http"),
+    imports: [],
+    declarations: [],
+  };
+
+  module.declarations.push(lines);
+
+  parent.declarations.push(module);
+
+  return module;
+}

package/generated-defs/helpers/index.ts

@@ -0,0 +1,27 @@
+// Copyright (c) Microsoft Corporation
+// Licensed under the MIT license.
+
+import { Module } from "../../src/ctx.js";
+
+export let module: Module = undefined as any;
+
+export async function createModule(parent: Module): Promise<Module> {
+  if (module) return module;
+
+  module = {
+    name: "helpers",
+    cursor: parent.cursor.enter("helpers"),
+    imports: [],
+    declarations: [],
+  };
+
+  // Child modules
+  await import("./header.js").then((m) => m.createModule(module));
+  await import("./http.js").then((m) => m.createModule(module));
+  await import("./multipart.js").then((m) => m.createModule(module));
+  await import("./router.js").then((m) => m.createModule(module));
+
+  parent.declarations.push(module);
+
+  return module;
+}