fix(winget): align API with official REST Source spec v1.9.0

- Fix search SQL performance by creating missing indexes on tags_map and commands_map
- Fix nested Inclusions/Filters structure in search request types
- Fix Publisher field population (prefer non-empty across versions)
- Fix DefaultLocale type in packageManifests (string, not object)
- Add UnsupportedQueryParameters, RequiredQueryParameters, Authentication to information
- Align defineRouteMeta tags with spec (Packages, Versions, Locale, Installers, etc.)
- Fix packages/[id] response schema to match PackageSingleResponse
- Export all functions in winget.ts
- Remove unnecessary await on synchronous getVersionManifests calls

Author: DemoMacro

server/routes/api/winget/information.ts

@@ -3,7 +3,7 @@ import { defineHandler } from "nitro/h3";
 
 defineRouteMeta({
   openAPI: {
-    tags: ["WinGet API"],
+    tags: ["Server", "Get"],
     summary: "Get server information",
     description: "Returns server information including supported API versions and capabilities",
     responses: {
@@ -50,6 +50,9 @@ export default defineHandler(() => {
       ServerSupportedVersions: ["1.4.0", "1.9.0"],
       RequiredPackageMatchFields: ["PackageIdentifier"],
       UnsupportedPackageMatchFields: ["Market", "HasInstallerType"],
+      UnsupportedQueryParameters: ["FetchAllManifests"],
+      RequiredQueryParameters: [],
+      Authentication: null,
     },
   };
 });

server/routes/api/winget/manifestSearch.ts

@@ -1,12 +1,12 @@
 import { defineRouteMeta } from "nitro";
 import { defineHandler, getQuery, readBody } from "nitro/h3";
 
-import type { MatchType, ManifestSearchRequest, ManifestSearchResult } from "../../../utils/winget";
+import type { ManifestSearchRequest, ManifestSearchResult, MatchType } from "../../../utils/winget";
 import { getIndexDb, searchPackages } from "../../../utils/winget";
 
 defineRouteMeta({
   openAPI: {
-    tags: ["WinGet API"],
+    tags: ["Package Manifests"],
     summary: "Search WinGet packages",
     description: "Search for WinGet packages by keyword with various match types",
     parameters: [
@@ -104,8 +104,8 @@ defineRouteMeta({
  *   "MaximumResults": 10,
  *   "FetchAllManifests": false,
  *   "Query": { "KeyWord": "Adobe", "MatchType": "CaseInsensitive" },
- *   "Inclusions": [{ "KeyWord": "Microsoft", "PackageMatchField": "PackageName", "MatchType": "CaseInsensitive" }],
- *   "Filters": [{ "KeyWord": "preview", "PackageMatchField": "Tag", "MatchType": "CaseInsensitive" }]
+ *   "Inclusions": [{ "PackageMatchField": "PackageName", "RequestMatch": { "KeyWord": "Microsoft", "MatchType": "CaseInsensitive" } }],
+ *   "Filters": [{ "PackageMatchField": "Tag", "RequestMatch": { "KeyWord": "preview", "MatchType": "CaseInsensitive" } }]
  * }
  */
 export default defineHandler(async (event) => {

server/routes/api/winget/packageManifests/[id].ts

@@ -12,7 +12,7 @@ import {
 
 defineRouteMeta({
   openAPI: {
-    tags: ["WinGet API"],
+    tags: ["Package Manifests", "Get"],
     summary: "Get package manifest",
     description: "Retrieve a full package manifest with all versions, locales, and installers",
     parameters: [
@@ -51,10 +51,11 @@ defineRouteMeta({
 
 interface VersionManifest {
   PackageVersion: string;
-  DefaultLocale?: Record<string, any>;
+  DefaultLocale?: string;
   Channel?: string | null;
   Locales?: Record<string, any>[];
   Installers?: Record<string, any>[];
+  Manifest?: Record<string, any>;
 }
 
 /**
@@ -99,7 +100,7 @@ export default defineHandler(async (event: H3Event) => {
 
   await Promise.allSettled(
     sortedVersions.map(async (version) => {
-      const manifestFiles = await getVersionManifests(packageId, version);
+      const manifestFiles = getVersionManifests(packageId, version);
       if (manifestFiles.length === 0) return;
 
       const versionEntry: VersionManifest = { PackageVersion: version };
@@ -111,8 +112,9 @@ export default defineHandler(async (event: H3Event) => {
 
         if (filename === `${packageId}.yaml`) {
           // Version manifest
-          versionEntry.DefaultLocale = parsed;
+          versionEntry.DefaultLocale = parsed.DefaultLocale;
           versionEntry.Channel = parsed.Channel;
+          versionEntry.Manifest = parsed;
         } else if (filename.match(/\.installer\.yaml$/)) {
           // Installer manifest
           versionEntry.Installers = parsed.Installers;

server/routes/api/winget/packages.ts

@@ -6,7 +6,7 @@ import { buildPackageIndex } from "../../../utils/winget";
 
 defineRouteMeta({
   openAPI: {
-    tags: ["WinGet API"],
+    tags: ["Packages", "Get"],
     summary: "Get all WinGet packages",
     description: "Retrieve a paginated list of all WinGet packages with their versions",
     parameters: [

server/routes/api/winget/packages/[id].ts

@@ -6,7 +6,7 @@ import { buildPackageIndex, createWinGetError } from "../../../../utils/winget";
 
 defineRouteMeta({
   openAPI: {
-    tags: ["WinGet API"],
+    tags: ["Packages", "Get"],
     summary: "Get specific WinGet package",
     description: "Retrieve details of a specific WinGet package by its identifier",
     parameters: [
@@ -28,9 +28,15 @@ defineRouteMeta({
             schema: {
               type: "object",
               properties: {
-                PackageIdentifier: { type: "string" },
-                Versions: { type: "array", items: { type: "string" } },
+                Data: {
+                  type: "object",
+                  properties: {
+                    PackageIdentifier: { type: "string" },
+                  },
+                  required: ["PackageIdentifier"],
+                },
               },
+              required: ["Data"],
             },
           },
         },

server/routes/api/winget/packages/[id]/versions.ts

@@ -12,7 +12,7 @@ import {
 
 defineRouteMeta({
   openAPI: {
-    tags: ["WinGet API"],
+    tags: ["Versions", "Get"],
     summary: "Get all versions of a WinGet package",
     description: "Retrieve all available versions for a specific WinGet package",
     parameters: [

server/routes/api/winget/packages/[id]/versions/[version].ts

@@ -11,7 +11,7 @@ import {
 
 defineRouteMeta({
   openAPI: {
-    tags: ["WinGet API"],
+    tags: ["Versions", "Get"],
     summary: "Get specific version of a WinGet package",
     description: "Retrieve version metadata for a specific package version",
     parameters: [
@@ -76,7 +76,7 @@ export default defineHandler(async (event) => {
   }
 
   // Get all manifest files for this version
-  const manifestFiles = await getVersionManifests(packageId, version);
+  const manifestFiles = getVersionManifests(packageId, version);
 
   if (manifestFiles.length === 0) {
     return createWinGetError(event, 404, `Version ${version} of package '${packageId}' not found`);

server/routes/api/winget/packages/[id]/versions/[version]/installers.ts

@@ -11,7 +11,7 @@ import {
 
 defineRouteMeta({
   openAPI: {
-    tags: ["WinGet API"],
+    tags: ["Installers", "Get"],
     summary: "Get all installers for a package version",
     description: "Retrieve all available installers for a specific package version",
     parameters: [
@@ -82,7 +82,7 @@ export default defineHandler(async (event) => {
   }
 
   // Get all manifest files for this version
-  const manifestFiles = await getVersionManifests(packageId, version);
+  const manifestFiles = getVersionManifests(packageId, version);
 
   if (manifestFiles.length === 0) {
     return createWinGetError(event, 404, `Version ${version} of package '${packageId}' not found`);

server/routes/api/winget/packages/[id]/versions/[version]/installers/[installer].ts

@@ -14,7 +14,7 @@ import {
 
 defineRouteMeta({
   openAPI: {
-    tags: ["WinGet API"],
+    tags: ["Installers", "Get"],
     summary: "Get specific installer for a package version",
     description: "Retrieve detailed installer information for a specific package version",
     parameters: [
@@ -93,7 +93,7 @@ export default defineHandler(async (event) => {
   }
 
   // Get all manifest files for this version
-  const manifestFiles = await getVersionManifests(packageId, version);
+  const manifestFiles = getVersionManifests(packageId, version);
 
   if (manifestFiles.length === 0) {
     return createWinGetError(event, 404, `Version ${version} of package '${packageId}' not found`);

server/routes/api/winget/packages/[id]/versions/[version]/locales.ts

@@ -11,7 +11,7 @@ import {
 
 defineRouteMeta({
   openAPI: {
-    tags: ["WinGet API"],
+    tags: ["Locale", "Get"],
     summary: "Get all locales for a package version",
     description: "Retrieve all available locales for a specific package version",
     parameters: [
@@ -82,7 +82,7 @@ export default defineHandler(async (event) => {
   }
 
   // Get all manifest files for this version
-  const manifestFiles = await getVersionManifests(packageId, version);
+  const manifestFiles = getVersionManifests(packageId, version);
 
   if (manifestFiles.length === 0) {
     return createWinGetError(event, 404, `Version ${version} of package '${packageId}' not found`);