[http-server-javascript] Merge JavaScript Server Generator to Main

docs/libraries/http-server-javascript/reference/emitter.md

@@ -0,0 +1,36 @@
+---
+title: "Emitter usage"
+toc_min_heading_level: 2
+toc_max_heading_level: 3
+---
+
+# Emitter
+
+## Usage
+
+1. Via the command line
+
+```bash
+tsp compile . --emit=@typespec/http-server-javascript
+```
+
+2. Via the config
+
+```yaml
+emit:
+  - "@typespec/http-server-javascript"
+```
+
+## Emitter options
+
+### `features`
+
+**Type:** `object`
+
+### `omit-unreachable-types`
+
+**Type:** `boolean`
+
+### `no-format`
+
+**Type:** `boolean`

docs/libraries/http-server-javascript/reference/index.mdx

@@ -0,0 +1,36 @@
+---
+title: Overview
+sidebar_position: 0
+toc_min_heading_level: 2
+toc_max_heading_level: 3
+---
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# Overview
+
+TypeSpec HTTP server code generator for JavaScript
+
+## Install
+
+<Tabs>
+<TabItem value="spec" label="In a spec" default>
+
+```bash
+npm install @typespec/http-server-javascript
+```
+
+</TabItem>
+<TabItem value="library" label="In a library" default>
+
+```bash
+npm install --save-peer @typespec/http-server-javascript
+```
+
+</TabItem>
+</Tabs>
+
+## Emitter usage
+
+[See documentation](./emitter.md)

packages/http-server-javascript/.gitignore

@@ -0,0 +1 @@
+src/helpers

packages/http-server-javascript/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

packages/http-server-javascript/README.md

@@ -0,0 +1,40 @@
+# @typespec/http-server-javascript
+
+TypeSpec HTTP server code generator for JavaScript
+
+## Install
+
+```bash
+npm install @typespec/http-server-javascript
+```
+
+## Emitter
+
+### Usage
+
+1. Via the command line
+
+```bash
+tsp compile . --emit=@typespec/http-server-javascript
+```
+
+2. Via the config
+
+```yaml
+emit:
+  - "@typespec/http-server-javascript"
+```
+
+### Emitter options
+
+#### `features`
+
+**Type:** `object`
+
+#### `omit-unreachable-types`
+
+**Type:** `boolean`
+
+#### `no-format`
+
+**Type:** `boolean`

packages/http-server-javascript/build-helpers.ts

@@ -0,0 +1,167 @@
+/* eslint-disable */
+
+import fs from "node:fs/promises";
+import { EOL } from "node:os";
+import path from "node:path";
+
+const HELPER_DECLARATION_PATH = path.resolve([".", "src", "helpers"].join(path.sep));
+const HELPER_SRC_PATH = path.resolve([".", "helpers"].join(path.sep));
+
+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 = [];
+  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;",
+      "",
+      "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(EOL);
+
+    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(EOL);
+
+    await fs.writeFile(targetPath, transformed);
+  }
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

packages/http-server-javascript/changelog.json

@@ -0,0 +1,4 @@
+{
+  "name": "@typespec/http-server-javascript",
+  "entries": []
+}