@azure-tools/typespec-azure-resource-manager 0.32.0-dev.1 → 0.32.0-dev.10

package/lib/arm.foundations.tsp

@@ -22,8 +22,8 @@ model ArmResource {
   @doc("Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}")
   @visibility("read")
   id: string;
-  // The name property must be included by the resource type author!
 
+  // The name property must be included by the resource type author!
 
   @doc("The type of the resource. E.g. \"Microsoft.Compute/virtualMachines\" or \"Microsoft.Storage/storageAccounts\"")
   @visibility("read")
@@ -43,6 +43,7 @@ model TrackedResourceBase extends ArmResource {
   @doc("The geo-location where the resource lives")
   @visibility("read", "create")
   location: string;
+
   ...ArmTagsProperty;
 }
 
@@ -203,12 +204,16 @@ model ErrorDetail {
 @resourceBaseParametersOf(TResource)
 model BaseParameters<TResource extends ArmResource> {
   ...ApiVersionParameter;
+
   // unless tenant or extension
   ...SubscriptionIdParameter;
+
   //unless tenant, subscription, resourceGroup, or extension
   ...LocationParameter;
+
   // unless tenant, subscription, location, or extension
   ...ResourceGroupParameter;
+
   // unless tenant, subscription, location, or resourceGroup
   ...ResourceUriParameter;
 }
@@ -681,5 +686,5 @@ op checkNameAvailability<
 
   @doc("The CheckAvailability request")
   @body
-  body: TRequest
+  body: TRequest,
 ): TResponse | ErrorResponse;

package/lib/interfaces.tsp

@@ -26,7 +26,7 @@ interface Operations {
     @path
     @segment("providers")
     @doc("The provider namespace (this parameter will not show up in operations).")
-    provider: "Microsoft.ThisWillBeReplaced"
+    provider: "Microsoft.ThisWillBeReplaced",
   ): ArmResponse<OperationListResult> | ErrorResponse;
 }
 
@@ -41,7 +41,6 @@ interface Operations {
  * @template TBaseParameters The http parameters that are part of the request
  *
  */
-
 @deprecated("Use Azure.ResourceManager.TrackedResourceOperations instead")
 interface ResourceOperations<
   TResource extends ArmResource,
@@ -59,7 +58,6 @@ interface ResourceOperations<
  * @template TBaseParameters The http parameters that are part of the request
  *
  */
-
 interface TrackedResourceOperations<
   TResource extends ArmResource,
   TProperties extends TypeSpec.Reflection.Model,
@@ -143,7 +141,7 @@ interface ResourceCollectionOperations<
  */
 interface ResourceListBySubscription<TResource extends ArmResource> {
   /**
-   * List resources by subscription.
+   * @dev List resources by subscription.
    * @template TResource The ArmResource to list.
    */
   listBySubscription is ArmListBySubscription<TResource>;
@@ -163,7 +161,7 @@ interface ResourceListByParent<
   TParentFriendlyName extends valueof string = ""
 > {
   /**
-   * List resources by parent.
+   * @dev List resources by parent.
    * @template TResource The ArmResource to list.
    * @template TBaseParameters The http parameters that are part of the request
    * @template TParentName The name of the parent resource
@@ -184,7 +182,7 @@ interface ResourceListByParent<
  */
 interface ResourceRead<TResource extends ArmResource, TBaseParameters = BaseParameters<TResource>> {
   /**
-   * Retrieve a resource.
+   * @dev Retrieve a resource.
    * @template TResource The ArmResource to retrieve.
    * @template TBaseParameters The http parameters that are part of the request
    */
@@ -201,7 +199,7 @@ interface ResourceCreateSync<
   TBaseParameters = BaseParameters<TResource>
 > {
   /**
-   * Create or update a resource using the synchronous call pattern.
+   * @dev Create or update a resource using the synchronous call pattern.
    * @template TResource The ArmResource to create or update.
    * @template TBaseParameters The http parameters that are part of the request
    */
@@ -218,7 +216,7 @@ interface ResourceCreateAsync<
   TBaseParameters = BaseParameters<TResource>
 > {
   /**
-   * Create or update a resource using the asynchronous call pattern.
+   * @dev Create or update a resource using the asynchronous call pattern.
    * @template TResource The ArmResource to create or update.
    * @template TBaseParameters The http parameters that are part of the request
    */
@@ -226,7 +224,7 @@ interface ResourceCreateAsync<
 }
 
 /**
- * A composite interface for resources that include a long-running delete operation.
+ * @dev A composite interface for resources that include a long-running delete operation.
  * @template TResource The ArmResource that provides these operations
  * @template TBaseParameters The http parameters that are part of the request
  */
@@ -236,7 +234,7 @@ interface ResourceDeleteAsync<
   TBaseParameters = BaseParameters<TResource>
 > {
   /**
-   * Delete a resource using the asynchronous call pattern.
+   * @dev Delete a resource using the asynchronous call pattern.
    * @template TResource The ArmResource to delete.
    * @template TBaseParameters The http parameters that are part of the request
    */
@@ -244,7 +242,7 @@ interface ResourceDeleteAsync<
 }
 
 /**
- * A composite interface for resources that include a synchronous delete operation.
+ * @dev A composite interface for resources that include a synchronous delete operation.
  * @template TResource The ArmResource that provides these operations
  * @template TBaseParameters The http parameters that are part of the request
  */
@@ -254,7 +252,7 @@ interface ResourceDeleteSync<
   TBaseParameters = BaseParameters<TResource>
 > {
   /**
-   * Delete a resource using the synchronous call pattern.
+   * @dev Delete a resource using the synchronous call pattern.
    * @template TResource The ArmResource to delete.
    * @template TBaseParameters The http parameters that are part of the request
    */
@@ -262,7 +260,7 @@ interface ResourceDeleteSync<
 }
 
 /**
- * A composite interface for resources that include a long-running update operation.
+ * @dev A composite interface for resources that include a long-running update operation.
  * @template TResource The ArmResource that provides these operations
  * @template TProperties RP-specific property bag for the resource
  * @template TBaseParameters The http parameters that are part of the request
@@ -274,7 +272,7 @@ interface ResourceUpdateAsync<
   TBaseParameters = BaseParameters<TResource>
 > {
   /**
-   * Update a resource using the asynchronous call pattern.
+   * @dev Update a resource using the asynchronous call pattern.
    * @template TResource The ArmResource to update.
    * @template TProperties RP-specific property bag for the resource
    * @template TBaseParameters The http parameters that are part of the request
@@ -299,7 +297,7 @@ interface ResourceUpdateSync<
   TBaseParameters = BaseParameters<TResource>
 > {
   /**
-   * Update a resource using the synchronous call pattern.
+   * @dev Update a resource using the synchronous call pattern.
    * @template TResource The ArmResource to update.
    * @template TProperties RP-specific property bag for the resource
    * @template TBaseParameters The http parameters that are part of the request

package/lib/operations.tsp

@@ -14,12 +14,12 @@ namespace Azure.ResourceManager;
  */
 @autoRoute
 @doc("List {name} resources by subscription ID", TResource)
-@list(TResource)
+@listsResource(TResource)
 @segmentOf(TResource)
 @armResourceList(TResource)
 @get
 op ArmListBySubscription<TResource extends ArmResource>(
-  ...SubscriptionScope<TResource>
+  ...SubscriptionScope<TResource>,
 ): ArmResponse<ResourceListResult<TResource>> | ErrorResponse;
 
 /**
@@ -31,7 +31,7 @@ op ArmListBySubscription<TResource extends ArmResource>(
  */
 @get
 @autoRoute
-@list(TResource)
+@listsResource(TResource)
 @segmentOf(TResource)
 @armRenameListByOperation(TResource, TParentName, TParentFriendlyName) // This must come before @armResourceList!
 @armResourceList(TResource)
@@ -41,7 +41,7 @@ op ArmResourceListByParent<
   TParentName extends valueof string = "",
   TParentFriendlyName extends valueof string = ""
 >(
-  ...ResourceParentParameters<TResource, TBaseParameters>
+  ...ResourceParentParameters<TResource, TBaseParameters>,
 ): ArmResponse<ResourceListResult<TResource>> | ErrorResponse;
 
 /**
@@ -51,7 +51,7 @@ op ArmResourceListByParent<
  */
 @get
 @autoRoute
-@list(TResource)
+@listsResource(TResource)
 @segmentOf(TResource)
 @armRenameListByOperation(TResource) // This must come before @armResourceList!
 @armResourceList(TResource)
@@ -59,7 +59,7 @@ op ArmResourceListAtScope<
   TResource extends ArmResource,
   TBaseParameters = BaseParameters<TResource>
 >(
-  ...ResourceParentParameters<TResource, TBaseParameters>
+  ...ResourceParentParameters<TResource, TBaseParameters>,
 ): ArmResponse<ResourceListResult<TResource>> | ErrorResponse;
 
 /**
@@ -72,7 +72,7 @@ op ArmResourceListAtScope<
 @get
 @armResourceRead(TResource)
 op ArmResourceRead<TResource extends ArmResource, TBaseParameters = BaseParameters<TResource>>(
-  ...ResourceInstanceParameters<TResource, TBaseParameters>
+  ...ResourceInstanceParameters<TResource, TBaseParameters>,
 ): ArmResponse<TResource> | ErrorResponse;
 
 /**
@@ -99,7 +99,7 @@ op ArmResourceCreateOrUpdateAsync<
 
   @doc("Resource create parameters.")
   @body
-  resource: TResource
+  resource: TResource,
 ): ArmResponse<TResource> | ArmCreatedResponse<TResource> | ErrorResponse;
 
 /**
@@ -119,7 +119,7 @@ op ArmResourceCreateOrUpdateSync<
 
   @doc("Resource create parameters.")
   @body
-  resource: TResource
+  resource: TResource,
 ): ArmResponse<TResource> | ErrorResponse;
 
 /**
@@ -171,7 +171,7 @@ op ArmCustomPatchAsync<
 
   @doc("The resource properties to be updated.")
   @body
-  properties: TPatchModel
+  properties: TPatchModel,
 ): ArmResponse<TResource> | ArmAcceptedLroResponse<"Resource update request accepted."> | ErrorResponse;
 
 /**
@@ -215,7 +215,7 @@ op ArmCustomPatchSync<
 
   @doc("The resource properties to be updated.")
   @body
-  properties: TPatchModel
+  properties: TPatchModel,
 ): ArmResponse<TResource> | ErrorResponse;
 
 /**
@@ -256,7 +256,7 @@ op ArmResourceDeleteSync<
   TResource extends ArmResource,
   TBaseParameters = BaseParameters<TResource>
 >(
-  ...ResourceInstanceParameters<TResource, TBaseParameters>
+  ...ResourceInstanceParameters<TResource, TBaseParameters>,
 ): ArmDeletedResponse | ArmDeletedNoContentResponse | ErrorResponse;
 
 /**
@@ -286,7 +286,7 @@ op ArmResourceActionAsync<
 
   @doc("The content of the action request")
   @body
-  body: TRequest
+  body: TRequest,
 ): ArmAcceptedLroResponse | ArmResponse<TResponse> | ErrorResponse;
 
 /**
@@ -309,7 +309,7 @@ op ArmResourceActionSync<
 
   @doc("The content of the action request")
   @body
-  body: TRequest
+  body: TRequest,
 ): ArmResponse<TResponse> | ErrorResponse;
 
 /**
@@ -337,7 +337,7 @@ op ArmResourceActionNoContentAsync<
 
   @doc("The content of the action request")
   @body
-  body: TRequest
+  body: TRequest,
 ): ArmAcceptedLroResponse | ArmNoContentResponse<"Action completed successfully."> | ErrorResponse;
 
 /**
@@ -358,7 +358,7 @@ op ArmResourceActionNoContentSync<
 
   @doc("The content of the action request")
   @body
-  body: TRequest
+  body: TRequest,
 ): ArmNoContentResponse<"Action completed successfully."> | ErrorResponse;
 
 /**

package/lib/parameters.tsp

@@ -44,14 +44,15 @@ model SubscriptionIdParameter {
 }
 
 /**
- * The default subscriptionId parameter type.
+ * The default location parameter type.
  */
-@doc("The default subscriptionId parameter type.")
+@doc("The default location parameter type.")
 model LocationParameter {
   @path
   @minLength(1)
   @segment("locations")
   @doc("The location name.")
+  @armCommonParameter("LocationParameter")
   @resourceParameterBaseFor([ResourceHome.Location])
   location: string;
 }

package/lib/responses.tsp

@@ -36,12 +36,12 @@ model ArmDeletedResponse {
 }
 
 /**
- * The response for asynchronous ARM delete ACCEPTED
+ * @dev The response for asynchronous ARM delete ACCEPTED
  */
 model ArmDeleteAcceptedLroResponse is ArmAcceptedLroResponse<"Resource deletion accepted.">;
 
 /**
- * The response for synchronous ARM delete ACCEPTED
+ * @dev The response for synchronous ARM delete ACCEPTED
  */
 model ArmDeleteAcceptedResponse is ArmAcceptedResponse<"Resource deletion accepted.">;
 
@@ -59,6 +59,7 @@ model ArmAcceptedResponse<TMessage extends valueof string = "Resource operation
  * The standard ARM response for asynchronous PATCH, POST, and DELETE operations
  * @template TMessage The description of the response status (defaults to `Resource operation accepted`)
  */
+@doc(TMessage)
 model ArmAcceptedLroResponse<TMessage extends valueof string = "Resource operation accepted.">
   is ArmAcceptedResponse<TMessage> {
   @doc("The Location header contains the URL where the status of the long running operation can be checked.")
@@ -67,7 +68,7 @@ model ArmAcceptedLroResponse<TMessage extends valueof string = "Resource operati
 }
 
 /**
- * ARM response for a properly formed delete request, with no resource found
+ * @dev ARM response for a properly formed delete request, with no resource found
  */
 model ArmDeletedNoContentResponse is ArmNoContentResponse<"Resource deleted successfully.">;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-tools/typespec-azure-resource-manager",
-  "version": "0.32.0-dev.1",
+  "version": "0.32.0-dev.10",
   "author": "Microsoft Corporation",
   "description": "TypeSpec Azure Resource Manager library",
   "homepage": "https://azure.github.io/typespec-azure",
@@ -42,7 +42,7 @@
     "!dist/test/**"
   ],
   "peerDependencies": {
-    "@typespec/compiler": "~0.45.0 || >=0.46.0-dev <0.46.0",
+    "@typespec/compiler": "~0.45.2 || >=0.46.0-dev <0.46.0",
     "@azure-tools/typespec-azure-core": "~0.31.0 || >=0.32.0-dev <0.32.0",
     "@azure-tools/typespec-autorest": "~0.31.0 || >=0.32.0-dev <0.32.0",
     "@typespec/openapi": "~0.45.0 || >=0.46.0-dev <0.46.0",
@@ -54,24 +54,24 @@
     "@typespec/lint": "~0.45.0 || >=0.46.0-dev <0.46.0"
   },
   "devDependencies": {
-    "@typespec/compiler": "~0.45.0 || >=0.46.0-dev <0.46.0",
+    "@typespec/compiler": "~0.45.2 || >=0.46.0-dev <0.46.0",
     "@typespec/openapi": "~0.45.0 || >=0.46.0-dev <0.46.0",
     "@azure-tools/typespec-azure-core": "~0.31.0 || >=0.32.0-dev <0.32.0",
     "@azure-tools/typespec-autorest": "~0.31.0 || >=0.32.0-dev <0.32.0",
     "@typespec/rest": "~0.45.0 || >=0.46.0-dev <0.46.0",
     "@typespec/http": "~0.45.0 || >=0.46.0-dev <0.46.0",
     "@typespec/versioning": "~0.45.0 || >=0.46.0-dev <0.46.0",
-    "@types/mocha": "~10.0.0",
+    "@types/mocha": "~10.0.1",
     "@types/node": "~18.11.9",
     "@typespec/eslint-config-typespec": "~0.7.0 || >=0.8.0-dev <0.8.0",
     "@typespec/library-linter": "~0.45.0 || >=0.46.0-dev <0.46.0",
     "@typespec/eslint-plugin": "~0.45.0 || >=0.46.0-dev <0.46.0",
-    "eslint": "^8.36.0",
+    "eslint": "^8.42.0",
     "mocha": "~10.2.0",
     "mocha-junit-reporter": "~2.2.0",
     "mocha-multi-reporters": "~1.5.1",
-    "c8": "~7.14.0",
-    "rimraf": "~5.0.0",
+    "c8": "~8.0.0",
+    "rimraf": "~5.0.1",
     "typescript": "~5.1.3"
   },
   "scripts": {