[Issue #85] Update core library (#121)

* build(spec): Bumps to the latest typespec packages
* fix(spec): Syntax change from typespec bump
* feat(spec): Adds tag metadata
* refactor(spec): Removes unauthorized response code
* refactor: Update examples and templates to latest TypeSpec
* build(spec): Bumps prerelease version

Author: widal001

examples/custom-api/README.md

@@ -124,9 +124,7 @@ import "./routes.tsp"; // Import the overridden route from above
 using TypeSpec.Http;
 
 /** Add the Custom API description here */
-@service({
-    title: "Custom API",
-})
+@service(#{ title: "Custom API" })
 namespace CustomAPI;
 ```
 

specs/README.md

@@ -101,9 +101,7 @@ import "./routes.tsp"; // Import the routes from above
 using TypeSpec.Http;
 
 /** Description of your API goes here */
-@service({
-  title: "Custom API",
-})
+@service(#{ title: "Custom API" })
 namespace CustomAPI;
 ```
 

specs/lib/api.tsp

@@ -5,15 +5,26 @@ import "@typespec/openapi";
 
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
-
 /** The base OpenAPI specification for a CommonGrants API
  *
  * In order for an API to be "compliant" with the CommonGrants protocol,
  * it must implement all of the routes with the "required" tag in this specification.
  */
-@service({
-  title: "CommonGrants Base API",
-})
+@service(#{ title: "CommonGrants Base API" })
+@tagMetadata(
+  "Opportunities",
+  #{ description: "Endpoints related to funding opportunities" }
+)
+@tagMetadata(
+  "required",
+  #{
+    description: "Endpoints that MUST be implemented by all CommonGrants APIs",
+  }
+)
+@tagMetadata(
+  "optional",
+  #{ description: "Endpoints that MAY be implemented by CommonGrants APIs" }
+)
 namespace CommonGrants.API;
 
 @tag("Opportunities")

specs/lib/core/routes/opportunities.tsp

@@ -49,7 +49,7 @@ interface Opportunities {
   @list
   list<T extends Models.OpportunityBase = Models.OpportunityBase>(
     ...Pagination.PaginatedQueryParams,
-  ): Responses.Paginated<T> | Responses.Unauthorized;
+  ): Responses.Paginated<T>;
 
   // ##############################
   // View an opportunity
@@ -66,7 +66,7 @@ interface Opportunities {
   read<T extends Models.OpportunityBase = Models.OpportunityBase>(
     /** The ID of the opportunity to view */
     @path id: Types.uuid,
-  ): Responses.Ok<T> | Responses.NotFound | Responses.Unauthorized;
+  ): Responses.Ok<T> | Responses.NotFound;
 
   // ###############################
   // Search opportunities
@@ -94,5 +94,5 @@ interface Opportunities {
 
     /** Pagination instructions for the results */
     pagination?: Pagination.PaginatedBodyParams,
-  ): Responses.Filtered<T, Models.OppFilters> | Responses.Unauthorized;
+  ): Responses.Filtered<T, Models.OppFilters>;
 }