@azure-tools/typespec-ts 0.11.0

package/test/integration/generated/models/usage/src/clientDefinitions.ts

@@ -0,0 +1,41 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+import {
+  InputParameters,
+  OutputParameters,
+  InputAndOutputParameters,
+} from "./parameters";
+import {
+  Input204Response,
+  Output200Response,
+  InputAndOutput200Response,
+} from "./responses";
+import { Client, StreamableMethod } from "@azure-rest/core-client";
+
+export interface Input {
+  post(options: InputParameters): StreamableMethod<Input204Response>;
+}
+
+export interface Output {
+  get(options?: OutputParameters): StreamableMethod<Output200Response>;
+}
+
+export interface InputAndOutput {
+  post(
+    options: InputAndOutputParameters
+  ): StreamableMethod<InputAndOutput200Response>;
+}
+
+export interface Routes {
+  /** Resource for '/models/usage/input' has methods for the following verbs: post */
+  (path: "/models/usage/input"): Input;
+  /** Resource for '/models/usage/output' has methods for the following verbs: get */
+  (path: "/models/usage/output"): Output;
+  /** Resource for '/models/usage/input-output' has methods for the following verbs: post */
+  (path: "/models/usage/input-output"): InputAndOutput;
+}
+
+export type ModelsUsageClient = Client & {
+  path: Routes;
+};

package/test/integration/generated/models/usage/src/index.ts

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

package/test/integration/generated/models/usage/src/models.ts

@@ -0,0 +1,12 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+/** Record used in operation parameters */
+export interface InputRecord {
+  requiredProp: string;
+}
+
+/** Record used both as operation parameter and return type */
+export interface InputOutputRecord {
+  requiredProp: string;
+}

package/test/integration/generated/models/usage/src/modelsUsage.ts

@@ -0,0 +1,31 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+import { getClient, ClientOptions } from "@azure-rest/core-client";
+import { ModelsUsageClient } from "./clientDefinitions";
+
+/**
+ * Initialize a new instance of `ModelsUsageClient`
+ * @param options type: ClientOptions, the parameter for all optional parameters
+ */
+export default function createClient(
+  options: ClientOptions = {}
+): ModelsUsageClient {
+  const baseUrl = options.baseUrl ?? `http://localhost:3000`;
+  options.apiVersion = options.apiVersion ?? "1.0.0";
+  const userAgentInfo = `azsdk-js-usage-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 ModelsUsageClient;
+
+  return client;
+}

package/test/integration/generated/models/usage/src/outputModels.ts

@@ -0,0 +1,12 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+/** Record used in operation return type */
+export interface OutputRecordOutput {
+  requiredProp: string;
+}
+
+/** Record used both as operation parameter and return type */
+export interface InputOutputRecordOutput {
+  requiredProp: string;
+}

package/test/integration/generated/models/usage/src/parameters.ts

@@ -0,0 +1,19 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+import { RequestParameters } from "@azure-rest/core-client";
+import { InputRecord, InputOutputRecord } from "./models";
+
+export interface InputBodyParam {
+  body: InputRecord;
+}
+
+export type InputParameters = InputBodyParam & RequestParameters;
+export type OutputParameters = RequestParameters;
+
+export interface InputAndOutputBodyParam {
+  body: InputOutputRecord;
+}
+
+export type InputAndOutputParameters = InputAndOutputBodyParam &
+  RequestParameters;

package/test/integration/generated/models/usage/src/responses.ts

@@ -0,0 +1,22 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+import { HttpResponse } from "@azure-rest/core-client";
+import { OutputRecordOutput, InputOutputRecordOutput } from "./outputModels";
+
+/** There is no content to send for this request, but the headers may be useful. */
+export interface Input204Response extends HttpResponse {
+  status: "204";
+}
+
+/** The request has succeeded. */
+export interface Output200Response extends HttpResponse {
+  status: "200";
+  body: OutputRecordOutput;
+}
+
+/** The request has succeeded. */
+export interface InputAndOutput200Response extends HttpResponse {
+  status: "200";
+  body: InputOutputRecordOutput;
+}

package/test/integration/generated/models/usage/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "module": "es6",
+    "lib": [],
+    "declaration": true,
+    "declarationMap": true,
+    "inlineSources": true,
+    "sourceMap": true,
+    "importHelpers": true,
+    "strict": true,
+    "alwaysStrict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "node",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "outDir": "./dist-esm",
+    "declarationDir": "./types"
+  },
+  "include": ["./src/**/*.ts"]
+}

package/test/integration/generated/models/usage/tspconfig.yaml

@@ -0,0 +1,11 @@
+emitters:
+  "../../../../../../../../../../../packages/typespec-ts/dist/src/index.js":
+    generateMetadata: true
+    generateTest: false
+    addCredentials: false
+    isCadlTest: true
+    azureSdkForJs: false
+    packageDetails:
+      name: "@msinternal/usage"
+      description: "Usage Test Service"
+      version: "1.0.0"

package/test/integration/generated/models/visibility/.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/models/visibility/README.md

@@ -0,0 +1,56 @@
+# ModelsVisibilityAutomatic REST client library for JavaScript
+
+Illustrates models with visibility properties.
+
+**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/visibility)
+
+## 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/visibility` package
+
+Install the ModelsVisibilityAutomatic REST client REST client library for JavaScript with `npm`:
+
+```bash
+npm install @msinternal/visibility
+```
+
+### Create and authenticate a `ModelsVisibilityAutomaticClient`
+
+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/models/visibility/api-extractor.json

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

package/test/integration/generated/models/visibility/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@msinternal/visibility",
+  "sdk-type": "client",
+  "author": "Microsoft Corporation",
+  "version": "1.0.0",
+  "description": "Visibility Test Service",
+  "keywords": ["node", "azure", "cloud", "typescript", "browser", "isomorphic"],
+  "license": "MIT",
+  "main": "dist/index.js",
+  "module": "./dist-esm/index.js",
+  "types": "./types/visibility.d.ts",
+  "repository": "github:Azure/azure-sdk-for-js",
+  "bugs": { "url": "https://github.com/Azure/azure-sdk-for-js/issues" },
+  "files": [
+    "dist/",
+    "dist-esm/",
+    "types/visibility.d.ts",
+    "README.md",
+    "LICENSE",
+    "review/*"
+  ],
+  "engines": { "node": ">=14.0.0" },
+  "scripts": {
+    "audit": "node ../../../common/scripts/rush-audit.js && rimraf node_modules package-lock.json && npm i --package-lock-only 2>&1 && npm audit",
+    "build:browser": "echo skipped.",
+    "build:node": "echo skipped.",
+    "build:samples": "echo skipped.",
+    "build:test": "echo skipped.",
+    "build:debug": "echo skipped.",
+    "check-format": "prettier --list-different --config ../../../.prettierrc.json --ignore-path ../../../.prettierignore \"src/**/*.ts\" \"*.{js,json}\" ",
+    "clean": "rimraf dist dist-browser dist-esm test-dist temp types *.tgz *.log",
+    "execute:samples": "echo skipped",
+    "extract-api": "rimraf review && mkdirp ./review && api-extractor run --local",
+    "format": "prettier --write --config ../../../.prettierrc.json --ignore-path ../../../.prettierignore \"src/**/*.ts\" \"*.{js,json}\" ",
+    "generate:client": "echo skipped",
+    "integration-test:browser": "echo skipped",
+    "integration-test:node": "echo skipped",
+    "integration-test": "echo skipped",
+    "lint:fix": "eslint package.json api-extractor.json src  --ext .ts --fix --fix-type [problem,suggestion]",
+    "lint": "eslint package.json api-extractor.json src  --ext .ts",
+    "pack": "npm pack 2>&1",
+    "test:browser": "echo skipped",
+    "test:node": "echo skipped",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "unit-test": "echo skipped",
+    "unit-test:node": "echo skipped",
+    "unit-test:browser": "echo skipped",
+    "build": "npm run clean && tsc && rollup -c 2>&1 && npm run minify && mkdirp ./review && npm run extract-api",
+    "minify": "uglifyjs -c -m --comments --source-map \"content='./dist/index.js.map'\" -o ./dist/index.min.js ./dist/index.js"
+  },
+  "sideEffects": false,
+  "autoPublish": false,
+  "dependencies": {
+    "@azure/core-auth": "^1.3.0",
+    "@azure-rest/core-client": "^1.1.0",
+    "@azure/core-rest-pipeline": "^1.8.0",
+    "@azure/logger": "^1.0.0",
+    "tslib": "^2.2.0"
+  },
+  "devDependencies": {
+    "@microsoft/api-extractor": "^7.31.1",
+    "autorest": "latest",
+    "@types/node": "^14.0.0",
+    "dotenv": "^16.0.0",
+    "eslint": "^8.0.0",
+    "mkdirp": "^2.1.2",
+    "prettier": "^2.5.1",
+    "rimraf": "^3.0.0",
+    "source-map-support": "^0.5.9",
+    "typescript": "~4.8.0",
+    "@rollup/plugin-commonjs": "^24.0.0",
+    "@rollup/plugin-json": "^6.0.0",
+    "@rollup/plugin-multi-entry": "^6.0.0",
+    "@rollup/plugin-node-resolve": "^13.1.3",
+    "rollup": "^2.66.1",
+    "rollup-plugin-sourcemaps": "^0.6.3",
+    "uglify-js": "^3.4.9"
+  },
+  "type": "module"
+}

package/test/integration/generated/models/visibility/rollup.config.js

@@ -0,0 +1,118 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+import nodeResolve from "@rollup/plugin-node-resolve";
+import cjs from "@rollup/plugin-commonjs";
+import sourcemaps from "rollup-plugin-sourcemaps";
+import multiEntry from "@rollup/plugin-multi-entry";
+import json from "@rollup/plugin-json";
+
+import nodeBuiltins from "builtin-modules";
+
+// #region Warning Handler
+
+/**
+ * A function that can determine whether a rollup warning should be ignored. If
+ * the function returns `true`, then the warning will not be displayed.
+ */
+
+function ignoreNiseSinonEval(warning) {
+  return (
+    warning.code === "EVAL" &&
+    warning.id &&
+    (warning.id.includes("node_modules/nise") ||
+      warning.id.includes("node_modules/sinon")) === true
+  );
+}
+
+function ignoreChaiCircularDependency(warning) {
+  return (
+    warning.code === "CIRCULAR_DEPENDENCY" &&
+    warning.importer &&
+    warning.importer.includes("node_modules/chai") === true
+  );
+}
+
+const warningInhibitors = [ignoreChaiCircularDependency, ignoreNiseSinonEval];
+
+/**
+ * Construct a warning handler for the shared rollup configuration
+ * that ignores certain warnings that are not relevant to testing.
+ */
+function makeOnWarnForTesting() {
+  return (warning, warn) => {
+    // If every inhibitor returns false (i.e. no inhibitors), then show the warning
+    if (warningInhibitors.every((inhib) => !inhib(warning))) {
+      warn(warning);
+    }
+  };
+}
+
+// #endregion
+
+function makeBrowserTestConfig() {
+  const config = {
+    input: {
+      include: ["dist-esm/test/**/*.spec.js"],
+      exclude: ["dist-esm/test/**/node/**"],
+    },
+    output: {
+      file: `dist-test/index.browser.js`,
+      format: "umd",
+      sourcemap: true,
+    },
+    preserveSymlinks: false,
+    plugins: [
+      multiEntry({ exports: false }),
+      nodeResolve({
+        mainFields: ["module", "browser"],
+      }),
+      cjs(),
+      json(),
+      sourcemaps(),
+      //viz({ filename: "dist-test/browser-stats.html", sourcemap: true })
+    ],
+    onwarn: makeOnWarnForTesting(),
+    // Disable tree-shaking of test code.  In rollup-plugin-node-resolve@5.0.0,
+    // rollup started respecting the "sideEffects" field in package.json.  Since
+    // our package.json sets "sideEffects=false", this also applies to test
+    // code, which causes all tests to be removed by tree-shaking.
+    treeshake: false,
+  };
+
+  return config;
+}
+
+const defaultConfigurationOptions = {
+  disableBrowserBundle: false,
+};
+
+export function makeConfig(pkg, options) {
+  options = {
+    ...defaultConfigurationOptions,
+    ...(options || {}),
+  };
+
+  const baseConfig = {
+    // Use the package's module field if it has one
+    input: pkg["module"] || "dist-esm/src/index.js",
+    external: [
+      ...nodeBuiltins,
+      ...Object.keys(pkg.dependencies),
+      ...Object.keys(pkg.devDependencies),
+    ],
+    output: { file: "dist/index.js", format: "cjs", sourcemap: true },
+    preserveSymlinks: false,
+    plugins: [sourcemaps(), nodeResolve()],
+  };
+
+  const config = [baseConfig];
+
+  if (!options.disableBrowserBundle) {
+    config.push(makeBrowserTestConfig());
+  }
+
+  return config;
+}
+
+export default makeConfig(require("./package.json"));

package/test/integration/generated/models/visibility/src/clientDefinitions.ts

@@ -0,0 +1,40 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+import {
+  GetModelParameters,
+  HeadModelParameters,
+  PutModelParameters,
+  PatchModelParameters,
+  PostModelParameters,
+  DeleteModelParameters,
+} from "./parameters";
+import {
+  GetModel200Response,
+  HeadModel200Response,
+  PutModel204Response,
+  PatchModel204Response,
+  PostModel204Response,
+  DeleteModel204Response,
+} from "./responses";
+import { Client, StreamableMethod } from "@azure-rest/core-client";
+
+export interface GetModel {
+  get(options: GetModelParameters): StreamableMethod<GetModel200Response>;
+  head(options: HeadModelParameters): StreamableMethod<HeadModel200Response>;
+  put(options: PutModelParameters): StreamableMethod<PutModel204Response>;
+  patch(options: PatchModelParameters): StreamableMethod<PatchModel204Response>;
+  post(options: PostModelParameters): StreamableMethod<PostModel204Response>;
+  delete(
+    options: DeleteModelParameters
+  ): StreamableMethod<DeleteModel204Response>;
+}
+
+export interface Routes {
+  /** Resource for '/models/visibility/automatic' has methods for the following verbs: get, head, put, patch, post, delete */
+  (path: "/models/visibility/automatic"): GetModel;
+}
+
+export type ModelsVisibilityAutomaticClient = Client & {
+  path: Routes;
+};

package/test/integration/generated/models/visibility/src/index.ts

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

package/test/integration/generated/models/visibility/src/models.ts

@@ -0,0 +1,14 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+/** Output model with visibility properties. */
+export interface VisibilityModel {
+  /** Required int32, illustrating a query property. */
+  queryProp: number;
+  /** Required string[], illustrating a create property. */
+  createProp: string[];
+  /** Required int32[], illustrating a update property. */
+  updateProp: number[];
+  /** Required bool, illustrating a delete property. */
+  deleteProp: boolean;
+}

package/test/integration/generated/models/visibility/src/modelsVisibilityAutomatic.ts

@@ -0,0 +1,31 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+import { getClient, ClientOptions } from "@azure-rest/core-client";
+import { ModelsVisibilityAutomaticClient } from "./clientDefinitions";
+
+/**
+ * Initialize a new instance of `ModelsVisibilityAutomaticClient`
+ * @param options type: ClientOptions, the parameter for all optional parameters
+ */
+export default function createClient(
+  options: ClientOptions = {}
+): ModelsVisibilityAutomaticClient {
+  const baseUrl = options.baseUrl ?? `http://localhost:3000`;
+  options.apiVersion = options.apiVersion ?? "1.0.0";
+  const userAgentInfo = `azsdk-js-visibility-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 ModelsVisibilityAutomaticClient;
+
+  return client;
+}

package/test/integration/generated/models/visibility/src/outputModels.ts

@@ -0,0 +1,16 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+/** Output model with visibility properties. */
+export interface VisibilityModelOutput {
+  /** Required string, illustrating a readonly property. */
+  readonly readProp: string;
+  /** Required int32, illustrating a query property. */
+  queryProp: number;
+  /** Required string[], illustrating a create property. */
+  createProp: string[];
+  /** Required int32[], illustrating a update property. */
+  updateProp: number[];
+  /** Required bool, illustrating a delete property. */
+  deleteProp: boolean;
+}

package/test/integration/generated/models/visibility/src/parameters.ts

@@ -0,0 +1,41 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+import { RequestParameters } from "@azure-rest/core-client";
+import { VisibilityModel } from "./models";
+
+export interface GetModelBodyParam {
+  body: VisibilityModel;
+}
+
+export type GetModelParameters = GetModelBodyParam & RequestParameters;
+
+export interface HeadModelBodyParam {
+  body: VisibilityModel;
+}
+
+export type HeadModelParameters = HeadModelBodyParam & RequestParameters;
+
+export interface PutModelBodyParam {
+  body: VisibilityModel;
+}
+
+export type PutModelParameters = PutModelBodyParam & RequestParameters;
+
+export interface PatchModelBodyParam {
+  body: VisibilityModel;
+}
+
+export type PatchModelParameters = PatchModelBodyParam & RequestParameters;
+
+export interface PostModelBodyParam {
+  body: VisibilityModel;
+}
+
+export type PostModelParameters = PostModelBodyParam & RequestParameters;
+
+export interface DeleteModelBodyParam {
+  body: VisibilityModel;
+}
+
+export type DeleteModelParameters = DeleteModelBodyParam & RequestParameters;