@common-grants/core 0.1.0-alpha.12 → 0.1.0-alpha.13

package/lib/api.tsp

@@ -5,6 +5,7 @@ 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,
@@ -12,8 +13,8 @@ using TypeSpec.OpenAPI;
  */
 @service(#{ title: "CommonGrants Base API" })
 @tagMetadata(
-  "Opportunities",
-  #{ description: "Endpoints related to funding opportunities" }
+  "optional",
+  #{ description: "Endpoints that MAY be implemented by CommonGrants APIs" }
 )
 @tagMetadata(
   "required",
@@ -22,8 +23,8 @@ using TypeSpec.OpenAPI;
   }
 )
 @tagMetadata(
-  "optional",
-  #{ description: "Endpoints that MAY be implemented by CommonGrants APIs" }
+  "Opportunities",
+  #{ description: "Endpoints related to funding opportunities" }
 )
 namespace CommonGrants.API;
 

package/lib/core/pagination.tsp

@@ -35,7 +35,7 @@ model PaginatedBodyParams {
 }
 
 /** Details about the paginated results */
-model PaginationInfo {
+model PaginatedResultsInfo {
   /** Current page number (indexing starts at 1) */
   @example(1)
   @minValue(1)

package/lib/core/responses/success.tsp

@@ -75,7 +75,7 @@ model Paginated<T> extends Success {
   items: T[];
 
   /** Details about the paginated results */
-  paginationInfo: Pagination.PaginationInfo;
+  paginationInfo: Pagination.PaginatedResultsInfo;
 }
 
 // ############################################################################
@@ -103,7 +103,7 @@ model Sorted<T> {
   ...Paginated<T>;
 
   /** The sort order of the items */
-  sortInfo: Sorting.SortInfo;
+  sortInfo: Sorting.SortedResultsInfo;
 }
 
 // ############################################################################
@@ -137,5 +137,10 @@ model Filtered<ItemsT, FilterT> extends Success {
   ...Sorted<ItemsT>;
 
   /** The filters applied to the response items */
-  filterInfo: FilterT;
+  filterInfo: {
+    filters: FilterT;
+
+    /** Non-fatal errors that occurred during filtering */
+    errors?: string[];
+  };
 }

package/lib/core/routes/opportunities.tsp

@@ -82,6 +82,10 @@ interface Opportunities {
   @post
   @route("/search")
   search<T extends Models.OpportunityBase = Models.OpportunityBase>(
+    /** Opportunity search query */
+    @example("Pre-school education")
+    search?: string,
+
     /** Filters to apply to the opportunity search
      *
      * Multiple filter conditions will be combined with AND logic, so that

package/lib/core/sorting.tsp

@@ -57,16 +57,19 @@ model SortBodyParams {
 }
 
 /** Information about the sort order of the items returned */
-model SortInfo {
-  /** The field to sort by */
+model SortedResultsInfo {
+  /** The field results are sorted by, or "custom" if an implementation-defined sort key is used */
   @example("lastModifiedAt")
   sortBy: string;
 
-  /** Implementation-defined sort key */
+  /** Implementation-defined sort key used to sort the results, if applicable */
   @example("customField")
   customSortBy?: string;
 
-  /** The order to sort by */
+  /** The order in which the results are sorted, e.g. ascending or descending */
   @example(SortOrder.asc)
-  sortOrder?: SortOrder;
+  sortOrder: SortOrder;
+
+  /** Non-fatal errors that occurred during sorting */
+  errors?: string[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@common-grants/core",
-  "version": "0.1.0-alpha.12",
+  "version": "0.1.0-alpha.13",
   "description": "TypeSpec library for defining grant opportunity data models and APIs",
   "type": "module",
   "main": "dist/src/index.js",