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

package/src/index.ts

@@ -0,0 +1,56 @@
+// Copyright (c) Microsoft Corporation
+// Licensed under the MIT license.
+
+import { EmitContext } from "@typespec/compiler";
+import { visitAllTypes } from "./common/namespace.js";
+import { createInitialContext } from "./ctx.js";
+import { JsEmitterOptions } from "./lib.js";
+import { writeModuleTree } from "./write.js";
+
+// #region features
+
+import path from "node:path";
+import { emitSerialization } from "./common/serialization/index.js";
+import { emitHttp } from "./http/index.js";
+
+// #endregion
+
+export { $lib } from "./lib.js";
+
+export async function $onEmit(context: EmitContext<JsEmitterOptions>) {
+  const jsCtx = await createInitialContext(context.program, context.options);
+
+  if (!jsCtx) return;
+
+  await emitHttp(jsCtx);
+
+  if (!context.options["omit-unreachable-types"]) {
+    // Visit everything in the service namespace to ensure we emit a full `models` module and not just the subparts that
+    // are reachable from the service impl.
+
+    visitAllTypes(jsCtx, jsCtx.service.type);
+  }
+
+  // Emit serialization code for all required types.
+  emitSerialization(jsCtx);
+
+  const srcGeneratedPath = path.join(context.emitterOutputDir, "src", "generated");
+
+  if (!context.program.compilerOptions.noEmit) {
+    try {
+      const stat = await context.program.host.stat(srcGeneratedPath);
+      if (stat.isDirectory()) {
+        await context.program.host.rm(srcGeneratedPath, {
+          recursive: true,
+        });
+      }
+    } catch {}
+
+    await writeModuleTree(
+      jsCtx,
+      context.emitterOutputDir,
+      jsCtx.rootModule,
+      !context.options["no-format"],
+    );
+  }
+}

package/src/lib.ts

@@ -0,0 +1,130 @@
+// Copyright (c) Microsoft Corporation
+// Licensed under the MIT license.
+
+import { JSONSchemaType, createTypeSpecLibrary, paramMessage } from "@typespec/compiler";
+
+export interface JsEmitterOptions {
+  express?: boolean;
+  "omit-unreachable-types": boolean;
+  "no-format": boolean;
+}
+
+const EmitterOptionsSchema: JSONSchemaType<JsEmitterOptions> = {
+  type: "object",
+  additionalProperties: false,
+  properties: {
+    express: { type: "boolean", nullable: true, default: false },
+    "omit-unreachable-types": {
+      type: "boolean",
+      default: false,
+    },
+    "no-format": {
+      type: "boolean",
+      default: false,
+    },
+  },
+  required: [],
+};
+
+export const $lib = createTypeSpecLibrary({
+  name: "@typespec/http-server-js",
+  requireImports: [],
+  emitter: {
+    options: EmitterOptionsSchema,
+  },
+  diagnostics: {
+    "unrecognized-intrinsic": {
+      severity: "warning",
+      messages: {
+        default: paramMessage`unrecognized intrinsic '${"intrinsic"}' is treated as 'unknown'`,
+      },
+    },
+    "unrecognized-scalar": {
+      severity: "warning",
+      messages: {
+        default: paramMessage`unrecognized scalar '${"scalar"}' is treated as 'unknown'`,
+      },
+    },
+    "unrecognized-encoding": {
+      severity: "error",
+      messages: {
+        default: paramMessage`unrecognized encoding '${"encoding"}' for type '${"type"}'`,
+      },
+    },
+    "http-emit-disabled": {
+      severity: "warning",
+      messages: {
+        default: "HTTP emit is disabled because the HTTP library returned errors.",
+      },
+    },
+    "no-services-in-program": {
+      severity: "warning",
+      messages: {
+        default: "No services found in program.",
+      },
+    },
+    "undifferentiable-route": {
+      severity: "error",
+      messages: {
+        default: "Shared route cannot be differentiated from other routes.",
+      },
+    },
+    "undifferentiable-scalar": {
+      severity: "error",
+      messages: {
+        default: paramMessage`Scalar type cannot be differentiated from other scalar type '${"competitor"}'.`,
+      },
+    },
+    "undifferentiable-model": {
+      severity: "error",
+      messages: {
+        default:
+          "Model type does not have enough unique properties to be differentiated from other models in some contexts.",
+      },
+    },
+    "unrepresentable-numeric-constant": {
+      severity: "error",
+      messages: {
+        default: "JavaScript cannot accurately represent this numeric constant.",
+      },
+    },
+    "undifferentiable-union-variant": {
+      severity: "error",
+      messages: {
+        default:
+          "Union variant cannot be differentiated from other variants of the union an an ambiguous context.",
+      },
+    },
+    "unspeakable-status-code": {
+      severity: "error",
+      messages: {
+        default: paramMessage`Status code property '${"name"}' is unspeakable and does not have an exact value. Provide an exact status code value or rename the property.`,
+      },
+    },
+    "name-conflict": {
+      severity: "error",
+      messages: {
+        default: paramMessage`Name ${"name"} conflicts with a prior declaration and must be unique.`,
+      },
+    },
+    "dynamic-request-content-type": {
+      severity: "error",
+      messages: {
+        default: "Operation has multiple possible content-type values and cannot be emitted.",
+      },
+    },
+    "openapi3-document-not-generated": {
+      severity: "warning",
+      messages: {
+        unable:
+          "@typespec/openapi3 is installed, but the OpenAPI 3 document could not be generated.",
+        versioned:
+          "An OpenAPI3 document could not be generated for this service because versioned services are not yet supported by the HTTP server emitter for JavaScript.",
+      },
+    },
+  },
+});
+
+const { reportDiagnostic } = $lib;
+
+export { reportDiagnostic };