@typespec/http-server-js 0.58.0-alpha.13-dev.7 → 0.58.0-alpha.13-dev.9

package/generated-defs/helpers/temporal/index.ts

@@ -0,0 +1,25 @@
+// 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: "temporal",
+    cursor: parent.cursor.enter("temporal"),
+    imports: [],
+    declarations: [],
+  };
+
+  // Child modules
+  await import("./native.js").then((m) => m.createModule(module));
+  await import("./polyfill.js").then((m) => m.createModule(module));
+
+  parent.declarations.push(module);
+
+  return module;
+}

package/generated-defs/helpers/temporal/native.ts

@@ -0,0 +1,132 @@
+// 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.",
+  "",
+  "// Due to the lack of generally-available global type definitions for Temporal, we use `any` throughout this module.",
+  "// When global.d.ts eventually has definitions for Temporal, we can unify this module with `polyfill.ts`.",
+  "",
+  "/**",
+  " * Parses an HTTP date string (e.g. `Wed, 21 Oct 2015 07:28:00 GMT`) into a `Temporal.Instant`.",
+  " * The date string must be in the format specified by RFC 7231.",
+  " *",
+  " * @param httpDate - The HTTP date string to parse.",
+  " * @throws {RangeError} If the date string is invalid or cannot be parsed.",
+  " * @returns The parsed `Temporal.Instant`.",
+  " */",
+  "export function parseHttpDate(httpDate: string): any {",
+  "  const timestamp = globalThis.Date.parse(httpDate);",
+  "",
+  "  if (isNaN(timestamp)) {",
+  "    throw new RangeError(`Invalid HTTP date: ${httpDate}`);",
+  "  }",
+  "",
+  "  return (globalThis as any).Temporal.Instant.fromEpochMilliseconds(timestamp);",
+  "}",
+  "",
+  "/**",
+  " * Formats a `Temporal.Instant` into an HTTP date string (e.g. `Wed, 21 Oct 2015 07:28:00 GMT`).",
+  " * The date string is formatted according to RFC 7231.",
+  " *",
+  " * @param instant - The `Temporal.Instant` to format.",
+  " * @returns The formatted HTTP date string.",
+  " */",
+  "export function formatHttpDate(instant: any) {",
+  "  const date = new Date(instant.epochMilliseconds);",
+  "  return date.toUTCString();",
+  "}",
+  "",
+  "/**",
+  " * Converts a `Temporal.Duration` to a number of seconds.",
+  " * This method will throw an Error if the duration contains any years, months, weeks, or days, as those require a reference",
+  " * point to calculate the total number of seconds.",
+  " *",
+  " * WARNING: If the total number of seconds is larger than the maximum safe integer in JavaScript, this method will",
+  " * lose precision. @see durationTotalSecondsBigInt for a BigInt alternative.",
+  " *",
+  " * @param duration - the duration to calculate the total number of seconds for",
+  " * @returns the total number of seconds in the duration",
+  " */",
+  "export function durationTotalSeconds(duration: any): number {",
+  "  if (",
+  "    duration.years !== 0 ||",
+  "    duration.months !== 0 ||",
+  "    duration.weeks !== 0 ||",
+  "    duration.days !== 0",
+  "  ) {",
+  "    throw new Error(",
+  "      \"Cannot calculate total seconds for a duration with years, months, weeks, or days.\",",
+  "    );",
+  "  }",
+  "",
+  "  return (",
+  "    duration.seconds +",
+  "    duration.minutes * 60 +",
+  "    duration.hours * 60 * 60 +",
+  "    duration.days * 24 * 60 * 60",
+  "  );",
+  "}",
+  "",
+  "/**",
+  " * Gets the total number of seconds in a duration.",
+  " *",
+  " * This method will throw an Error if the duration contains any years, months, weeks, or days, as those require a reference",
+  " * point to calculate the total number of seconds. It will also throw an error if any of the components are not integers.",
+  " *",
+  " * @param duration - the duration to calculate the total number of seconds for",
+  " * @returns the total number of seconds in the duration",
+  " */",
+  "export function durationTotalSecondsBigInt(duration: any): bigint {",
+  "  if (",
+  "    duration.years !== 0 ||",
+  "    duration.months !== 0 ||",
+  "    duration.weeks !== 0 ||",
+  "    duration.days !== 0",
+  "  ) {",
+  "    throw new Error(",
+  "      \"Cannot calculate total seconds for a duration with years, months, weeks, or days.\",",
+  "    );",
+  "  }",
+  "",
+  "  if (",
+  "    !Number.isInteger(duration.seconds) ||",
+  "    !Number.isInteger(duration.minutes) ||",
+  "    !Number.isInteger(duration.hours) ||",
+  "    !Number.isInteger(duration.days)",
+  "  ) {",
+  "    throw new Error(\"Duration components must be integers.\");",
+  "  }",
+  "",
+  "  return (",
+  "    BigInt(duration.seconds) +",
+  "    BigInt(duration.minutes) * 60n +",
+  "    BigInt(duration.hours) * 60n * 60n +",
+  "    BigInt(duration.days) * 24n * 60n * 60n",
+  "  );",
+  "}",
+  "",
+];
+
+export async function createModule(parent: Module): Promise<Module> {
+  if (module) return module;
+
+  module = {
+    name: "native",
+    cursor: parent.cursor.enter("native"),
+    imports: [],
+    declarations: [],
+  };
+
+  module.declarations.push(lines);
+
+  parent.declarations.push(module);
+
+  return module;
+}

package/generated-defs/helpers/temporal/polyfill.ts

@@ -0,0 +1,131 @@
+// 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 { Temporal } from \"temporal-polyfill\";",
+  "",
+  "/**",
+  " * Parses an HTTP date string (e.g. `Wed, 21 Oct 2015 07:28:00 GMT`) into a `Temporal.Instant`.",
+  " * The date string must be in the format specified by RFC 7231.",
+  " *",
+  " * @param httpDate - The HTTP date string to parse.",
+  " * @throws {RangeError} If the date string is invalid or cannot be parsed.",
+  " * @returns The parsed `Temporal.Instant`.",
+  " */",
+  "export function parseHttpDate(httpDate: string): Temporal.Instant {",
+  "  const timestamp = globalThis.Date.parse(httpDate);",
+  "",
+  "  if (isNaN(timestamp)) {",
+  "    throw new RangeError(`Invalid HTTP date: ${httpDate}`);",
+  "  }",
+  "",
+  "  return Temporal.Instant.fromEpochMilliseconds(timestamp);",
+  "}",
+  "",
+  "/**",
+  " * Formats a `Temporal.Instant` into an HTTP date string (e.g. `Wed, 21 Oct 2015 07:28:00 GMT`).",
+  " * The date string is formatted according to RFC 7231.",
+  " *",
+  " * @param instant - The `Temporal.Instant` to format.",
+  " * @returns The formatted HTTP date string.",
+  " */",
+  "export function formatHttpDate(instant: Temporal.Instant) {",
+  "  const date = new Date(instant.epochMilliseconds);",
+  "  return date.toUTCString();",
+  "}",
+  "",
+  "/**",
+  " * Converts a `Temporal.Duration` to a number of seconds.",
+  " * This method will throw an Error if the duration contains any years, months, weeks, or days, as those require a reference",
+  " * point to calculate the total number of seconds.",
+  " *",
+  " * WARNING: If the total number of seconds is larger than the maximum safe integer in JavaScript, this method will",
+  " * lose precision. @see durationTotalSecondsBigInt for a BigInt alternative.",
+  " *",
+  " * @param duration - the duration to calculate the total number of seconds for",
+  " * @returns the total number of seconds in the duration",
+  " */",
+  "export function durationTotalSeconds(duration: Temporal.Duration): number {",
+  "  if (",
+  "    duration.years !== 0 ||",
+  "    duration.months !== 0 ||",
+  "    duration.weeks !== 0 ||",
+  "    duration.days !== 0",
+  "  ) {",
+  "    throw new Error(",
+  "      \"Cannot calculate total seconds for a duration with years, months, weeks, or days.\",",
+  "    );",
+  "  }",
+  "",
+  "  return (",
+  "    duration.seconds +",
+  "    duration.minutes * 60 +",
+  "    duration.hours * 60 * 60 +",
+  "    duration.days * 24 * 60 * 60",
+  "  );",
+  "}",
+  "",
+  "/**",
+  " * Gets the total number of seconds in a duration.",
+  " *",
+  " * This method will throw an Error if the duration contains any years, months, weeks, or days, as those require a reference",
+  " * point to calculate the total number of seconds. It will also throw an error if any of the components are not integers.",
+  " *",
+  " * @param duration - the duration to calculate the total number of seconds for",
+  " * @returns the total number of seconds in the duration",
+  " */",
+  "export function durationTotalSecondsBigInt(duration: Temporal.Duration): bigint {",
+  "  if (",
+  "    duration.years !== 0 ||",
+  "    duration.months !== 0 ||",
+  "    duration.weeks !== 0 ||",
+  "    duration.days !== 0",
+  "  ) {",
+  "    throw new Error(",
+  "      \"Cannot calculate total seconds for a duration with years, months, weeks, or days.\",",
+  "    );",
+  "  }",
+  "",
+  "  if (",
+  "    !Number.isInteger(duration.seconds) ||",
+  "    !Number.isInteger(duration.minutes) ||",
+  "    !Number.isInteger(duration.hours) ||",
+  "    !Number.isInteger(duration.days)",
+  "  ) {",
+  "    throw new Error(\"Duration components must be integers.\");",
+  "  }",
+  "",
+  "  return (",
+  "    BigInt(duration.seconds) +",
+  "    BigInt(duration.minutes) * 60n +",
+  "    BigInt(duration.hours) * 60n * 60n +",
+  "    BigInt(duration.days) * 24n * 60n * 60n",
+  "  );",
+  "}",
+  "",
+];
+
+export async function createModule(parent: Module): Promise<Module> {
+  if (module) return module;
+
+  module = {
+    name: "polyfill",
+    cursor: parent.cursor.enter("polyfill"),
+    imports: [],
+    declarations: [],
+  };
+
+  module.declarations.push(lines);
+
+  parent.declarations.push(module);
+
+  return module;
+}

package/generated-defs/package.json.ts

@@ -0,0 +1,38 @@
+// Copyright (c) Microsoft Corporation
+// Licensed under the MIT license.
+
+// prettier-ignore
+
+export const hsjsDependencies: Record<string, string> = {
+  "@types/express": "^5.0.1",
+  "@types/morgan": "^1.9.9",
+  "@types/node": "~22.13.11",
+  "@types/swagger-ui-express": "^4.1.8",
+  "@typespec/compiler": "workspace:^",
+  "@typespec/http": "workspace:^",
+  "@typespec/http-specs": "workspace:^",
+  "@typespec/internal-build-utils": "workspace:^",
+  "@typespec/openapi3": "workspace:^",
+  "@typespec/spector": "workspace:^",
+  "@typespec/tspd": "workspace:^",
+  "@vitest/coverage-v8": "^3.0.9",
+  "@vitest/ui": "^3.0.9",
+  "decimal.js": "^10.5.0",
+  "express": "^5.1.0",
+  "fs-extra": "^11.2.0",
+  "globby": "~14.1.0",
+  "inquirer": "^12.5.0",
+  "morgan": "^1.10.0",
+  "ora": "^8.1.1",
+  "p-limit": "^6.2.0",
+  "pathe": "^2.0.3",
+  "picocolors": "~1.1.1",
+  "swagger-ui-express": "^5.0.1",
+  "temporal-polyfill": "^0.3.0",
+  "tsx": "^4.19.3",
+  "typescript": "~5.8.2",
+  "vitest": "^3.0.9",
+  "yargs": "~17.7.2",
+  "prettier": "~3.5.3",
+  "yaml": "~2.7.0",
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typespec/http-server-js",
-  "version": "0.58.0-alpha.13-dev.7",
+  "version": "0.58.0-alpha.13-dev.9",
   "author": "Microsoft Corporation",
   "description": "TypeSpec HTTP server code generator for JavaScript",
   "homepage": "https://github.com/microsoft/typespec",
@@ -46,27 +46,35 @@
     "yaml": "~2.7.0"
   },
   "devDependencies": {
+    "@types/express": "^5.0.1",
+    "@types/morgan": "^1.9.9",
     "@types/node": "~22.13.11",
+    "@types/swagger-ui-express": "^4.1.8",
     "@typespec/compiler": "^1.0.0-rc.0",
     "@typespec/http": "^1.0.0-rc.0",
     "@typespec/http-specs": "^0.1.0-alpha.17 || >=0.1.0-alpha.18-dev <0.1.0-alpha.18",
     "@typespec/internal-build-utils": "^0.68.0 || >=0.69.0-dev <0.69.0",
     "@typespec/openapi3": "^1.0.0-rc.0",
     "@typespec/spector": "^0.1.0-alpha.11 || >=0.1.0-alpha.12-dev <0.1.0-alpha.12",
+    "@typespec/tspd": "^0.68.0 || >=0.69.0-dev <0.69.0",
     "@vitest/coverage-v8": "^3.0.9",
     "@vitest/ui": "^3.0.9",
+    "decimal.js": "^10.5.0",
+    "express": "^5.1.0",
     "fs-extra": "^11.2.0",
     "globby": "~14.1.0",
     "inquirer": "^12.5.0",
+    "morgan": "^1.10.0",
     "ora": "^8.1.1",
     "p-limit": "^6.2.0",
     "pathe": "^2.0.3",
     "picocolors": "~1.1.1",
+    "swagger-ui-express": "^5.0.1",
+    "temporal-polyfill": "^0.3.0",
     "tsx": "^4.19.3",
     "typescript": "~5.8.2",
     "vitest": "^3.0.9",
-    "yargs": "~17.7.2",
-    "@typespec/tspd": "^0.46.0"
+    "yargs": "~17.7.2"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",

package/src/common/declaration.ts

@@ -42,7 +42,7 @@ export function* emitDeclaration(
       break;
     }
     case "Scalar": {
-      yield emitScalar(ctx, type, module);
+      yield* emitScalar(ctx, type, module);
       break;
     }
     default: {