@azure-tools/typespec-ts 0.11.0-alpha.20230413.3

package/test/integration/generated/arrays/itemTypes/src/arrayItemTypesClient.ts

@@ -0,0 +1,31 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+import { getClient, ClientOptions } from "@azure-rest/core-client";
+import { ArrayItemTypesClient } from "./clientDefinitions";
+
+/**
+ * Initialize a new instance of `ArrayItemTypesClient`
+ * @param options type: ClientOptions, the parameter for all optional parameters
+ */
+export default function createClient(
+  options: ClientOptions = {}
+): ArrayItemTypesClient {
+  const baseUrl = options.baseUrl ?? `http://localhost:3000`;
+  options.apiVersion = options.apiVersion ?? "1.0.0";
+  const userAgentInfo = `azsdk-js-array-itemtypes-rest/1.0.0`;
+  const userAgentPrefix =
+    options.userAgentOptions && options.userAgentOptions.userAgentPrefix
+      ? `${options.userAgentOptions.userAgentPrefix} ${userAgentInfo}`
+      : `${userAgentInfo}`;
+  options = {
+    ...options,
+    userAgentOptions: {
+      userAgentPrefix,
+    },
+  };
+
+  const client = getClient(baseUrl, options) as ArrayItemTypesClient;
+
+  return client;
+}

package/test/integration/generated/arrays/itemTypes/src/clientDefinitions.ts

@@ -0,0 +1,165 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+import {
+  Int32ValueGetParameters,
+  Int32ValuePutParameters,
+  Int64ValueGetParameters,
+  Int64ValuePutParameters,
+  BooleanValueGetParameters,
+  BooleanValuePutParameters,
+  StringValueGetParameters,
+  StringValuePutParameters,
+  Float32ValueGetParameters,
+  Float32ValuePutParameters,
+  DatetimeValueGetParameters,
+  DatetimeValuePutParameters,
+  DurationValueGetParameters,
+  DurationValuePutParameters,
+  UnknownValueGetParameters,
+  UnknownValuePutParameters,
+  ModelValueGetParameters,
+  ModelValuePutParameters,
+  NullableFloatValueGetParameters,
+  NullableFloatValuePutParameters,
+} from "./parameters";
+import {
+  Int32ValueGet200Response,
+  Int32ValuePut204Response,
+  Int64ValueGet200Response,
+  Int64ValuePut204Response,
+  BooleanValueGet200Response,
+  BooleanValuePut204Response,
+  StringValueGet200Response,
+  StringValuePut204Response,
+  Float32ValueGet200Response,
+  Float32ValuePut204Response,
+  DatetimeValueGet200Response,
+  DatetimeValuePut204Response,
+  DurationValueGet200Response,
+  DurationValuePut204Response,
+  UnknownValueGet200Response,
+  UnknownValuePut204Response,
+  ModelValueGet200Response,
+  ModelValuePut204Response,
+  NullableFloatValueGet200Response,
+  NullableFloatValuePut204Response,
+} from "./responses";
+import { Client, StreamableMethod } from "@azure-rest/core-client";
+
+export interface Int32ValueGet {
+  get(
+    options?: Int32ValueGetParameters
+  ): StreamableMethod<Int32ValueGet200Response>;
+  put(
+    options: Int32ValuePutParameters
+  ): StreamableMethod<Int32ValuePut204Response>;
+}
+
+export interface Int64ValueGet {
+  get(
+    options?: Int64ValueGetParameters
+  ): StreamableMethod<Int64ValueGet200Response>;
+  put(
+    options: Int64ValuePutParameters
+  ): StreamableMethod<Int64ValuePut204Response>;
+}
+
+export interface BooleanValueGet {
+  get(
+    options?: BooleanValueGetParameters
+  ): StreamableMethod<BooleanValueGet200Response>;
+  put(
+    options: BooleanValuePutParameters
+  ): StreamableMethod<BooleanValuePut204Response>;
+}
+
+export interface StringValueGet {
+  get(
+    options?: StringValueGetParameters
+  ): StreamableMethod<StringValueGet200Response>;
+  put(
+    options: StringValuePutParameters
+  ): StreamableMethod<StringValuePut204Response>;
+}
+
+export interface Float32ValueGet {
+  get(
+    options?: Float32ValueGetParameters
+  ): StreamableMethod<Float32ValueGet200Response>;
+  put(
+    options: Float32ValuePutParameters
+  ): StreamableMethod<Float32ValuePut204Response>;
+}
+
+export interface DatetimeValueGet {
+  get(
+    options?: DatetimeValueGetParameters
+  ): StreamableMethod<DatetimeValueGet200Response>;
+  put(
+    options: DatetimeValuePutParameters
+  ): StreamableMethod<DatetimeValuePut204Response>;
+}
+
+export interface DurationValueGet {
+  get(
+    options?: DurationValueGetParameters
+  ): StreamableMethod<DurationValueGet200Response>;
+  put(
+    options: DurationValuePutParameters
+  ): StreamableMethod<DurationValuePut204Response>;
+}
+
+export interface UnknownValueGet {
+  get(
+    options?: UnknownValueGetParameters
+  ): StreamableMethod<UnknownValueGet200Response>;
+  put(
+    options: UnknownValuePutParameters
+  ): StreamableMethod<UnknownValuePut204Response>;
+}
+
+export interface ModelValueGet {
+  get(
+    options?: ModelValueGetParameters
+  ): StreamableMethod<ModelValueGet200Response>;
+  put(
+    options: ModelValuePutParameters
+  ): StreamableMethod<ModelValuePut204Response>;
+}
+
+export interface NullableFloatValueGet {
+  get(
+    options?: NullableFloatValueGetParameters
+  ): StreamableMethod<NullableFloatValueGet200Response>;
+  put(
+    options: NullableFloatValuePutParameters
+  ): StreamableMethod<NullableFloatValuePut204Response>;
+}
+
+export interface Routes {
+  /** Resource for '/arrays/item-types/int32' has methods for the following verbs: get, put */
+  (path: "/arrays/item-types/int32"): Int32ValueGet;
+  /** Resource for '/arrays/item-types/int64' has methods for the following verbs: get, put */
+  (path: "/arrays/item-types/int64"): Int64ValueGet;
+  /** Resource for '/arrays/item-types/boolean' has methods for the following verbs: get, put */
+  (path: "/arrays/item-types/boolean"): BooleanValueGet;
+  /** Resource for '/arrays/item-types/string' has methods for the following verbs: get, put */
+  (path: "/arrays/item-types/string"): StringValueGet;
+  /** Resource for '/arrays/item-types/float32' has methods for the following verbs: get, put */
+  (path: "/arrays/item-types/float32"): Float32ValueGet;
+  /** Resource for '/arrays/item-types/datetime' has methods for the following verbs: get, put */
+  (path: "/arrays/item-types/datetime"): DatetimeValueGet;
+  /** Resource for '/arrays/item-types/duration' has methods for the following verbs: get, put */
+  (path: "/arrays/item-types/duration"): DurationValueGet;
+  /** Resource for '/arrays/item-types/unknown' has methods for the following verbs: get, put */
+  (path: "/arrays/item-types/unknown"): UnknownValueGet;
+  /** Resource for '/arrays/item-types/model' has methods for the following verbs: get, put */
+  (path: "/arrays/item-types/model"): ModelValueGet;
+  /** Resource for '/arrays/item-types/nullable-float' has methods for the following verbs: get, put */
+  (path: "/arrays/item-types/nullable-float"): NullableFloatValueGet;
+}
+
+export type ArrayItemTypesClient = Client & {
+  path: Routes;
+};

package/test/integration/generated/arrays/itemTypes/src/index.ts

@@ -0,0 +1,13 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+import ArrayItemTypesClient from "./arrayItemTypesClient";
+
+export * from "./arrayItemTypesClient";
+export * from "./parameters";
+export * from "./responses";
+export * from "./clientDefinitions";
+export * from "./models";
+export * from "./outputModels";
+
+export default ArrayItemTypesClient;

package/test/integration/generated/arrays/itemTypes/src/models.ts

@@ -0,0 +1,9 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+/** Array inner model */
+export interface InnerModel {
+  /** Required string property */
+  property: string;
+  children?: Array<InnerModel>;
+}

package/test/integration/generated/arrays/itemTypes/src/outputModels.ts

@@ -0,0 +1,9 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+/** Array inner model */
+export interface InnerModelOutput {
+  /** Required string property */
+  property: string;
+  children?: Array<InnerModelOutput>;
+}

package/test/integration/generated/arrays/itemTypes/src/parameters.ts

@@ -0,0 +1,86 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+import { RequestParameters } from "@azure-rest/core-client";
+import { InnerModel } from "./models";
+
+export type Int32ValueGetParameters = RequestParameters;
+
+export interface Int32ValuePutBodyParam {
+  body: number[];
+}
+
+export type Int32ValuePutParameters = Int32ValuePutBodyParam &
+  RequestParameters;
+export type Int64ValueGetParameters = RequestParameters;
+
+export interface Int64ValuePutBodyParam {
+  body: number[];
+}
+
+export type Int64ValuePutParameters = Int64ValuePutBodyParam &
+  RequestParameters;
+export type BooleanValueGetParameters = RequestParameters;
+
+export interface BooleanValuePutBodyParam {
+  body: boolean[];
+}
+
+export type BooleanValuePutParameters = BooleanValuePutBodyParam &
+  RequestParameters;
+export type StringValueGetParameters = RequestParameters;
+
+export interface StringValuePutBodyParam {
+  body: string[];
+}
+
+export type StringValuePutParameters = StringValuePutBodyParam &
+  RequestParameters;
+export type Float32ValueGetParameters = RequestParameters;
+
+export interface Float32ValuePutBodyParam {
+  body: number[];
+}
+
+export type Float32ValuePutParameters = Float32ValuePutBodyParam &
+  RequestParameters;
+export type DatetimeValueGetParameters = RequestParameters;
+
+export interface DatetimeValuePutBodyParam {
+  body: Date[] | string[];
+}
+
+export type DatetimeValuePutParameters = DatetimeValuePutBodyParam &
+  RequestParameters;
+export type DurationValueGetParameters = RequestParameters;
+
+export interface DurationValuePutBodyParam {
+  body: string[];
+}
+
+export type DurationValuePutParameters = DurationValuePutBodyParam &
+  RequestParameters;
+export type UnknownValueGetParameters = RequestParameters;
+
+export interface UnknownValuePutBodyParam {
+  body: unknown[];
+}
+
+export type UnknownValuePutParameters = UnknownValuePutBodyParam &
+  RequestParameters;
+export type ModelValueGetParameters = RequestParameters;
+
+export interface ModelValuePutBodyParam {
+  body: Array<InnerModel>;
+}
+
+export type ModelValuePutParameters = ModelValuePutBodyParam &
+  RequestParameters;
+export type NullableFloatValueGetParameters = RequestParameters;
+
+export interface NullableFloatValuePutBodyParam {
+  body: (number | null)[];
+}
+
+export type NullableFloatValuePutParameters = NullableFloatValuePutBodyParam &
+  RequestParameters;

package/test/integration/generated/arrays/itemTypes/src/responses.ts

@@ -0,0 +1,115 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+import { HttpResponse } from "@azure-rest/core-client";
+import { InnerModelOutput } from "./outputModels";
+
+/** The request has succeeded. */
+export interface Int32ValueGet200Response extends HttpResponse {
+  status: "200";
+  body: number[];
+}
+
+/** There is no content to send for this request, but the headers may be useful. */
+export interface Int32ValuePut204Response extends HttpResponse {
+  status: "204";
+}
+
+/** The request has succeeded. */
+export interface Int64ValueGet200Response extends HttpResponse {
+  status: "200";
+  body: number[];
+}
+
+/** There is no content to send for this request, but the headers may be useful. */
+export interface Int64ValuePut204Response extends HttpResponse {
+  status: "204";
+}
+
+/** The request has succeeded. */
+export interface BooleanValueGet200Response extends HttpResponse {
+  status: "200";
+  body: boolean[];
+}
+
+/** There is no content to send for this request, but the headers may be useful. */
+export interface BooleanValuePut204Response extends HttpResponse {
+  status: "204";
+}
+
+/** The request has succeeded. */
+export interface StringValueGet200Response extends HttpResponse {
+  status: "200";
+  body: string[];
+}
+
+/** There is no content to send for this request, but the headers may be useful. */
+export interface StringValuePut204Response extends HttpResponse {
+  status: "204";
+}
+
+/** The request has succeeded. */
+export interface Float32ValueGet200Response extends HttpResponse {
+  status: "200";
+  body: number[];
+}
+
+/** There is no content to send for this request, but the headers may be useful. */
+export interface Float32ValuePut204Response extends HttpResponse {
+  status: "204";
+}
+
+/** The request has succeeded. */
+export interface DatetimeValueGet200Response extends HttpResponse {
+  status: "200";
+  body: string[];
+}
+
+/** There is no content to send for this request, but the headers may be useful. */
+export interface DatetimeValuePut204Response extends HttpResponse {
+  status: "204";
+}
+
+/** The request has succeeded. */
+export interface DurationValueGet200Response extends HttpResponse {
+  status: "200";
+  body: string[];
+}
+
+/** There is no content to send for this request, but the headers may be useful. */
+export interface DurationValuePut204Response extends HttpResponse {
+  status: "204";
+}
+
+/** The request has succeeded. */
+export interface UnknownValueGet200Response extends HttpResponse {
+  status: "200";
+  body: any[];
+}
+
+/** There is no content to send for this request, but the headers may be useful. */
+export interface UnknownValuePut204Response extends HttpResponse {
+  status: "204";
+}
+
+/** The request has succeeded. */
+export interface ModelValueGet200Response extends HttpResponse {
+  status: "200";
+  body: Array<InnerModelOutput>;
+}
+
+/** There is no content to send for this request, but the headers may be useful. */
+export interface ModelValuePut204Response extends HttpResponse {
+  status: "204";
+}
+
+/** The request has succeeded. */
+export interface NullableFloatValueGet200Response extends HttpResponse {
+  status: "200";
+  body: (number | null)[];
+}
+
+/** There is no content to send for this request, but the headers may be useful. */
+export interface NullableFloatValuePut204Response extends HttpResponse {
+  status: "204";
+}

package/test/integration/generated/arrays/itemTypes/tspconfig.yaml

@@ -0,0 +1,15 @@
+emit:
+  - "@azure-tools/typespec-ts"
+options:
+  "@azure-tools/typespec-ts":
+    "emitter-output-dir": "{project-root}"
+    generateMetadata: false
+    generateTest: false
+    addCredentials: false
+    azureSdkForJs: false
+    isCadlTest: true
+    title: ArrayItemTypesClient
+    packageDetails:
+      name: "@msinternal/array-itemtypes"
+      description: "Array item-types Test Service"
+      version: "1.0.0"

package/test/integration/generated/authentication/apiKey/.eslintrc.json

@@ -0,0 +1,11 @@
+{
+  "plugins": ["@azure/azure-sdk"],
+  "extends": ["plugin:@azure/azure-sdk/azure-sdk-base"],
+  "rules": {
+    "@azure/azure-sdk/ts-modules-only-named": "warn",
+    "@azure/azure-sdk/ts-apiextractor-json-types": "warn",
+    "@azure/azure-sdk/ts-package-json-types": "warn",
+    "@azure/azure-sdk/ts-package-json-engine-is-present": "warn",
+    "tsdoc/syntax": "warn"
+  }
+}

package/test/integration/generated/authentication/apiKey/README.md

@@ -0,0 +1,56 @@
+# AuthApiKey REST client library for JavaScript
+
+Illustrates clients generated with ApiKey authentication.
+
+**Please rely heavily on our [REST client docs](https://github.com/Azure/azure-sdk-for-js/blob/main/documentation/rest-clients.md) to use this library**
+
+Key links:
+
+- [Package (NPM)](https://www.npmjs.com/package/@msinternal/auth-apikey)
+
+## Getting started
+
+### Currently supported environments
+
+- LTS versions of Node.js
+
+### Prerequisites
+
+- You must have an [Azure subscription](https://azure.microsoft.com/free/) to use this package.
+
+### Install the `@msinternal/auth-apikey` package
+
+Install the AuthApiKey REST client REST client library for JavaScript with `npm`:
+
+```bash
+npm install @msinternal/auth-apikey
+```
+
+### Create and authenticate a `AuthApiKeyClient`
+
+To use an [Azure Active Directory (AAD) token credential](https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/identity/identity/samples/AzureIdentityExamples.md#authenticating-with-a-pre-fetched-access-token),
+provide an instance of the desired credential type obtained from the
+[@azure/identity](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity#credentials) library.
+
+To authenticate with AAD, you must first `npm` install [`@azure/identity`](https://www.npmjs.com/package/@azure/identity) 
+
+After setup, you can choose which type of [credential](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity#credentials) from `@azure/identity` to use.
+As an example, [DefaultAzureCredential](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity#defaultazurecredential)
+can be used to authenticate the client.
+
+Set the values of the client ID, tenant ID, and client secret of the AAD application as environment variables:
+AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET
+
+## Troubleshooting
+
+### Logging
+
+Enabling logging may help uncover useful information about failures. In order to see a log of HTTP requests and responses, set the `AZURE_LOG_LEVEL` environment variable to `info`. Alternatively, logging can be enabled at runtime by calling `setLogLevel` in the `@azure/logger`:
+
+```javascript
+const { setLogLevel } = require("@azure/logger");
+
+setLogLevel("info");
+```
+
+For more detailed instructions on how to enable logs, you can look at the [@azure/logger package docs](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/core/logger).

package/test/integration/generated/authentication/apiKey/api-extractor.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
+  "mainEntryPointFilePath": "./types/src/index.d.ts",
+  "docModel": { "enabled": true },
+  "apiReport": { "enabled": true, "reportFolder": "./review" },
+  "dtsRollup": {
+    "enabled": true,
+    "untrimmedFilePath": "",
+    "publicTrimmedFilePath": "./types/auth-apikey.d.ts"
+  },
+  "messages": {
+    "tsdocMessageReporting": { "default": { "logLevel": "none" } },
+    "extractorMessageReporting": {
+      "ae-missing-release-tag": { "logLevel": "none" },
+      "ae-unresolved-link": { "logLevel": "none" }
+    }
+  }
+}

package/test/integration/generated/authentication/apiKey/karma.conf.js

@@ -0,0 +1,133 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+// https://github.com/karma-runner/karma-chrome-launcher
+process.env.CHROME_BIN = require("puppeteer").executablePath();
+require("dotenv").config();
+const { relativeRecordingsPath } = require("@azure-tools/test-recorder");
+process.env.RECORDINGS_RELATIVE_PATH = relativeRecordingsPath();
+
+module.exports = function (config) {
+  config.set({
+    // base path that will be used to resolve all patterns (eg. files, exclude)
+    basePath: "./",
+
+    // frameworks to use
+    // available frameworks: https://npmjs.org/browse/keyword/karma-adapter
+    frameworks: ["source-map-support", "mocha"],
+
+    plugins: [
+      "karma-mocha",
+      "karma-mocha-reporter",
+      "karma-chrome-launcher",
+      "karma-firefox-launcher",
+      "karma-env-preprocessor",
+      "karma-coverage",
+      "karma-sourcemap-loader",
+      "karma-junit-reporter",
+      "karma-source-map-support",
+    ],
+
+    // list of files / patterns to load in the browser
+    files: [
+      "dist-test/index.browser.js",
+      {
+        pattern: "dist-test/index.browser.js.map",
+        type: "html",
+        included: false,
+        served: true,
+      },
+    ],
+
+    // list of files / patterns to exclude
+    exclude: [],
+
+    // preprocess matching files before serving them to the browser
+    // available preprocessors: https://npmjs.org/browse/keyword/karma-preprocessor
+    preprocessors: {
+      "**/*.js": ["sourcemap", "env"],
+      // IMPORTANT: COMMENT following line if you want to debug in your browsers!!
+      // Preprocess source file to calculate code coverage, however this will make source file unreadable
+      // "dist-test/index.js": ["coverage"]
+    },
+
+    envPreprocessor: [
+      "TEST_MODE",
+      "ENDPOINT",
+      "AZURE_CLIENT_SECRET",
+      "AZURE_CLIENT_ID",
+      "AZURE_TENANT_ID",
+      "SUBSCRIPTION_ID",
+      "RECORDINGS_RELATIVE_PATH",
+    ],
+
+    // test results reporter to use
+    // possible values: 'dots', 'progress'
+    // available reporters: https://npmjs.org/browse/keyword/karma-reporter
+    reporters: ["mocha", "coverage", "junit"],
+
+    coverageReporter: {
+      // specify a common output directory
+      dir: "coverage-browser/",
+      reporters: [
+        { type: "json", subdir: ".", file: "coverage.json" },
+        { type: "lcovonly", subdir: ".", file: "lcov.info" },
+        { type: "html", subdir: "html" },
+        { type: "cobertura", subdir: ".", file: "cobertura-coverage.xml" },
+      ],
+    },
+
+    junitReporter: {
+      outputDir: "", // results will be saved as $outputDir/$browserName.xml
+      outputFile: "test-results.browser.xml", // if included, results will be saved as $outputDir/$browserName/$outputFile
+      suite: "", // suite will become the package name attribute in xml testsuite element
+      useBrowserName: false, // add browser name to report and classes names
+      nameFormatter: undefined, // function (browser, result) to customize the name attribute in xml testcase element
+      classNameFormatter: undefined, // function (browser, result) to customize the classname attribute in xml testcase element
+      properties: {}, // key value pair of properties to add to the <properties> section of the report
+    },
+
+    // web server port
+    port: 9876,
+
+    // enable / disable colors in the output (reporters and logs)
+    colors: true,
+
+    // level of logging
+    // possible values: config.LOG_DISABLE || config.LOG_ERROR || config.LOG_WARN || config.LOG_INFO || config.LOG_DEBUG
+    logLevel: config.LOG_INFO,
+
+    // enable / disable watching file and executing tests whenever any file changes
+    autoWatch: false,
+
+    // --no-sandbox allows our tests to run in Linux without having to change the system.
+    // --disable-web-security allows us to authenticate from the browser without having to write tests using interactive auth, which would be far more complex.
+    browsers: ["ChromeHeadlessNoSandbox"],
+    customLaunchers: {
+      ChromeHeadlessNoSandbox: {
+        base: "ChromeHeadless",
+        flags: ["--no-sandbox", "--disable-web-security"],
+      },
+    },
+
+    // Continuous Integration mode
+    // if true, Karma captures browsers, runs the tests and exits
+    singleRun: false,
+
+    // Concurrency level
+    // how many browser should be started simultaneous
+    concurrency: 1,
+
+    browserNoActivityTimeout: 60000000,
+    browserDisconnectTimeout: 10000,
+    browserDisconnectTolerance: 3,
+
+    client: {
+      mocha: {
+        // change Karma's debug.html to the mocha web reporter
+        reporter: "html",
+        timeout: "600000",
+      },
+    },
+  });
+};