From 0f12935ad9957c6926e1f588e410fad41fd894e8 Mon Sep 17 00:00:00 2001 From: Evgenii Khramkov Date: Thu, 7 Mar 2019 16:19:01 +0300 Subject: [PATCH 01/17] bootstrap V3 App Center Distribute task --- .../resources.resjson/de-de/resources.resjson | 41 + .../resources.resjson/en-US/resources.resjson | 43 + .../resources.resjson/es-es/resources.resjson | 41 + .../resources.resjson/fr-fr/resources.resjson | 41 + .../resources.resjson/it-IT/resources.resjson | 41 + .../resources.resjson/ja-jp/resources.resjson | 41 + .../resources.resjson/ko-KR/resources.resjson | 41 + .../resources.resjson/ru-RU/resources.resjson | 41 + .../resources.resjson/zh-CN/resources.resjson | 41 + .../resources.resjson/zh-TW/resources.resjson | 41 + Tasks/AppCenterDistributeV3/Tests/L0.ts | 207 + .../Tests/L0ApiRejectsFail.ts | 38 + .../Tests/L0MultipleIpaFail.ts | 44 + .../Tests/L0NoSymbolsConditionallyPass.ts | 95 + .../Tests/L0NoSymbolsFails.ts | 41 + .../Tests/L0OneIpaPass.ts | 121 + .../Tests/L0PublishCommitInfo_1.ts | 134 + .../Tests/L0PublishCommitInfo_2.ts | 132 + .../Tests/L0PublishCommitInfo_3.ts | 132 + .../Tests/L0PublishCommitInfo_4.ts | 132 + .../Tests/L0PublishMandatoryUpdate.ts | 133 + .../Tests/L0PublishMultipleDestinations.ts | 137 + .../Tests/L0SymIncludeParent.ts | 172 + .../Tests/L0SymMultipleDSYMs_flat_1.ts | 208 + .../Tests/L0SymMultipleDSYMs_flat_2.ts | 218 ++ .../Tests/L0SymMultipleDSYMs_single.ts | 199 + .../Tests/L0SymMultipleDSYMs_tree.ts | 232 ++ .../Tests/L0SymPDBs_multiple.ts | 196 + .../Tests/L0SymPDBs_single.ts | 190 + .../Tests/package-lock.json | 124 + .../AppCenterDistributeV3/Tests/package.json | 22 + .../appcenterdistribute.ts | 492 +++ Tasks/AppCenterDistributeV3/icon.png | Bin 0 -> 1079 bytes Tasks/AppCenterDistributeV3/package-lock.json | 469 +++ Tasks/AppCenterDistributeV3/package.json | 24 + Tasks/AppCenterDistributeV3/task.json | 200 + Tasks/AppCenterDistributeV3/task.loc.json | 200 + Tasks/AppCenterDistributeV3/tsconfig.json | 6 + Tasks/AppCenterDistributeV3/typings.json | 10 + .../typings/globals/form-data/index.d.ts | 20 + .../typings/globals/form-data/typings.json | 8 + .../typings/globals/mocha/index.d.ts | 202 + .../typings/globals/mocha/typings.json | 8 + .../typings/globals/node/index.d.ts | 3464 +++++++++++++++++ .../typings/globals/node/typings.json | 8 + .../typings/globals/q/index.d.ts | 357 ++ .../typings/globals/q/typings.json | 8 + .../typings/globals/request/index.d.ts | 254 ++ .../typings/globals/request/typings.json | 8 + .../AppCenterDistributeV3/typings/index.d.ts | 5 + Tasks/AppCenterDistributeV3/utils.ts | 240 ++ 51 files changed, 9302 insertions(+) create mode 100644 Tasks/AppCenterDistributeV3/Strings/resources.resjson/de-de/resources.resjson create mode 100644 Tasks/AppCenterDistributeV3/Strings/resources.resjson/en-US/resources.resjson create mode 100644 Tasks/AppCenterDistributeV3/Strings/resources.resjson/es-es/resources.resjson create mode 100644 Tasks/AppCenterDistributeV3/Strings/resources.resjson/fr-fr/resources.resjson create mode 100644 Tasks/AppCenterDistributeV3/Strings/resources.resjson/it-IT/resources.resjson create mode 100644 Tasks/AppCenterDistributeV3/Strings/resources.resjson/ja-jp/resources.resjson create mode 100644 Tasks/AppCenterDistributeV3/Strings/resources.resjson/ko-KR/resources.resjson create mode 100644 Tasks/AppCenterDistributeV3/Strings/resources.resjson/ru-RU/resources.resjson create mode 100644 Tasks/AppCenterDistributeV3/Strings/resources.resjson/zh-CN/resources.resjson create mode 100644 Tasks/AppCenterDistributeV3/Strings/resources.resjson/zh-TW/resources.resjson create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0ApiRejectsFail.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0MultipleIpaFail.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0NoSymbolsConditionallyPass.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0NoSymbolsFails.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0OneIpaPass.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_1.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_2.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_3.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_4.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0PublishMandatoryUpdate.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0PublishMultipleDestinations.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0SymIncludeParent.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_flat_1.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_flat_2.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_single.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_tree.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0SymPDBs_multiple.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0SymPDBs_single.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/package-lock.json create mode 100644 Tasks/AppCenterDistributeV3/Tests/package.json create mode 100644 Tasks/AppCenterDistributeV3/appcenterdistribute.ts create mode 100644 Tasks/AppCenterDistributeV3/icon.png create mode 100644 Tasks/AppCenterDistributeV3/package-lock.json create mode 100644 Tasks/AppCenterDistributeV3/package.json create mode 100644 Tasks/AppCenterDistributeV3/task.json create mode 100644 Tasks/AppCenterDistributeV3/task.loc.json create mode 100644 Tasks/AppCenterDistributeV3/tsconfig.json create mode 100644 Tasks/AppCenterDistributeV3/typings.json create mode 100644 Tasks/AppCenterDistributeV3/typings/globals/form-data/index.d.ts create mode 100644 Tasks/AppCenterDistributeV3/typings/globals/form-data/typings.json create mode 100644 Tasks/AppCenterDistributeV3/typings/globals/mocha/index.d.ts create mode 100644 Tasks/AppCenterDistributeV3/typings/globals/mocha/typings.json create mode 100644 Tasks/AppCenterDistributeV3/typings/globals/node/index.d.ts create mode 100644 Tasks/AppCenterDistributeV3/typings/globals/node/typings.json create mode 100644 Tasks/AppCenterDistributeV3/typings/globals/q/index.d.ts create mode 100644 Tasks/AppCenterDistributeV3/typings/globals/q/typings.json create mode 100644 Tasks/AppCenterDistributeV3/typings/globals/request/index.d.ts create mode 100644 Tasks/AppCenterDistributeV3/typings/globals/request/typings.json create mode 100644 Tasks/AppCenterDistributeV3/typings/index.d.ts create mode 100644 Tasks/AppCenterDistributeV3/utils.ts diff --git a/Tasks/AppCenterDistributeV3/Strings/resources.resjson/de-de/resources.resjson b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/de-de/resources.resjson new file mode 100644 index 000000000000..1535dc15200e --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/de-de/resources.resjson @@ -0,0 +1,41 @@ +{ + "loc.friendlyName": "App Center-Verteilung", + "loc.helpMarkDown": "Hilfe zu dieser Aufgabe finden Sie auf der Visual Studio App Center-[Supportwebsite](https://aka.ms/appcentersupport/).", + "loc.description": "Hiermit verteilen Sie App-Builds über App Center an Tester und Benutzer.", + "loc.instanceNameFormat": "\"$(app)\" in Visual Studio App Center bereitstellen", + "loc.releaseNotes": "Fügen Sie Unterstützung für die Verteilung auf Speicher hinzu.", + "loc.group.displayName.symbols": "Symbole", + "loc.input.label.serverEndpoint": "App Center-Dienstverbindung", + "loc.input.help.serverEndpoint": "Wählen Sie die Dienstverbindung für Visual Studio App Center aus. Um eine Dienstverbindung zu erstellen, klicken Sie auf den Link \"Verwalten\", und erstellen Sie eine neue Dienstverbindung.", + "loc.input.label.appSlug": "App-Datenfeld", + "loc.input.help.appSlug": "Das App-Datenfeld weist das Format **{username}/{app_identifier}** auf. Um **{username}** und **{app_identifier}** für eine App zu suchen, klicken Sie unter https://appcenter.ms/apps auf den Namen der App. Die resultierende URL liegt im Format [https://appcenter.ms/users/{username}/apps/{app_identifier}](https://appcenter.ms/users/{username}/apps/{app_identifier}) vor. Wenn Sie Organisationen verwenden, weist das App-Datenfeld das Format **{orgname}/{app_identifier}** auf.", + "loc.input.label.app": "Pfad zur Binärdatei", + "loc.input.help.app": "Der relative Pfad vom Repositorystamm zur APK- oder IPA-Datei, die Sie veröffentlichen möchten.", + "loc.input.label.symbolsType": "Symboltyp", + "loc.input.label.symbolsPath": "Symbolpfad", + "loc.input.help.symbolsPath": "Der relative Pfad vom Repositorystamm zum Symbolordner.", + "loc.input.label.pdbPath": "Symbolpfad (*.pdb)", + "loc.input.help.pdbPath": "Relativer Pfad vom Repositorystamm zu PDB-Symboldateien. Der Pfad enthält unter Umständen Platzhalter.", + "loc.input.label.dsymPath": "dSYM-Pfad", + "loc.input.help.dsymPath": "Der relative Pfad vom Repositorystamm zum dSYM-Ordner. Der Pfad enthält unter Umständen Platzhalter.", + "loc.input.label.mappingTxtPath": "Zuordnungsdatei", + "loc.input.help.mappingTxtPath": "Der relative Pfad vom Repositorystamm zur mapping.txt-Datei von Android.", + "loc.input.label.packParentFolder": "Alle Elemente im übergeordneten Ordner einschließen", + "loc.input.help.packParentFolder": "Laden Sie die ausgewählte Symboldatei bzw. den ausgewählten Ordner und alle weiteren Elemente innerhalb desselben übergeordneten Ordners hoch. Dies ist für React Native-Apps erforderlich.", + "loc.input.label.releaseNotesSelection": "Anmerkungen zu dieser Version erstellen", + "loc.input.label.releaseNotesInput": "Anmerkungen zu dieser Version", + "loc.input.help.releaseNotesInput": "Anmerkungen zu dieser Version.", + "loc.input.label.releaseNotesFile": "Datei mit Anmerkungen zu dieser Version", + "loc.input.help.releaseNotesFile": "Wählen Sie eine UTF-8-codierte Textdatei aus, die die Anmerkungen zu dieser Version enthält.", + "loc.input.label.destinationIds": "Ziel-ID", + "loc.input.help.destinationIds": "Die ID der Verteilergruppe oder des Speichers, in der bzw. dem die App bereitgestellt wird. Lassen Sie den Eintrag leer, um die Standardgruppe zu verwenden.", + "loc.messages.CannotDecodeEndpoint": "Der Endpunkt konnte nicht decodiert werden.", + "loc.messages.NoResponseFromServer": "Keine Antwort vom Server.", + "loc.messages.FailedToUploadFile": "Fehler beim Abschließen des Dateiuploads.", + "loc.messages.NoApiTokenFound": "In der Visual Studio App Center-Dienstverbindung wurde kein API-Token gefunden.", + "loc.messages.Succeeded": "Die Aufgabe zur App Center-Verteilung wurde erfolgreich durchgeführt.", + "loc.messages.CannotFindAnyFile": "Es kann keine auf \"%s\" basierende Datei gefunden werden.", + "loc.messages.FoundMultipleFiles": "Es wurden mehrere Dateien gefunden, die \"%s\" entsprechen.", + "loc.messages.FailedToCreateFile": "Fehler beim Erstellen von \"%s\": %s.", + "loc.messages.FailedToFindFile": "%s wurde unter %s nicht gefunden." +} \ No newline at end of file diff --git a/Tasks/AppCenterDistributeV3/Strings/resources.resjson/en-US/resources.resjson b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/en-US/resources.resjson new file mode 100644 index 000000000000..436c994a4dc6 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/en-US/resources.resjson @@ -0,0 +1,43 @@ +{ + "loc.friendlyName": "App Center Distribute", + "loc.helpMarkDown": "For help with this task, visit the Visual Studio App Center [support site](https://aka.ms/appcentersupport/).", + "loc.description": "Distribute app builds to testers and users via App Center", + "loc.instanceNameFormat": "Deploy $(app) to Visual Studio App Center", + "loc.releaseNotes": "Added support for multiple destinations.", + "loc.group.displayName.symbols": "Symbols", + "loc.input.label.serverEndpoint": "App Center service connection", + "loc.input.help.serverEndpoint": "Select the service connection for Visual Studio App Center. To create one, click the Manage link and create a new service connection.", + "loc.input.label.appSlug": "App slug", + "loc.input.help.appSlug": "The app slug is in the format of **{username}/{app_identifier}**. To locate **{username}** and **{app_identifier}** for an app, click on its name from https://appcenter.ms/apps, and the resulting URL is in the format of [https://appcenter.ms/users/{username}/apps/{app_identifier}](https://appcenter.ms/users/{username}/apps/{app_identifier}). If you are using orgs, the app slug is of the format **{orgname}/{app_identifier}**.", + "loc.input.label.app": "Binary file path", + "loc.input.help.app": "Relative path from the repo root to the APK or IPA file you want to publish", + "loc.input.label.symbolsType": "Symbols type", + "loc.input.label.symbolsPath": "Symbols path", + "loc.input.help.symbolsPath": "Relative path from the repo root to the symbols folder.", + "loc.input.label.pdbPath": "Symbols path (*.pdb)", + "loc.input.help.pdbPath": "Relative path from the repo root to PDB symbols files. Path may contain wildcards.", + "loc.input.label.dsymPath": "dSYM path", + "loc.input.help.dsymPath": "Relative path from the repo root to dSYM folder. Path may contain wildcards.", + "loc.input.label.mappingTxtPath": "Mapping file", + "loc.input.help.mappingTxtPath": "Relative path from the repo root to Android's mapping.txt file.", + "loc.input.label.packParentFolder": "Include all items in parent folder", + "loc.input.help.packParentFolder": "Upload the selected symbols file or folder and all other items inside the same parent folder. This is required for React Native apps.", + "loc.input.label.releaseNotesSelection": "Create release notes", + "loc.input.label.releaseNotesInput": "Release notes", + "loc.input.help.releaseNotesInput": "Release notes for this version.", + "loc.input.label.releaseNotesFile": "Release notes file", + "loc.input.help.releaseNotesFile": "Select a UTF-8 encoded text file which contains the Release Notes for this version.", + "loc.input.label.isMandatory": "Require users to update to this release", + "loc.input.label.destinationIds": "Destination IDs", + "loc.input.help.destinationIds": "IDs of the distribution groups or stores the app will deploy to. Leave it empty to use the default group and use commas or semicolons to separate multiple IDs.", + "loc.messages.CannotDecodeEndpoint": "Could not decode the endpoint.", + "loc.messages.NoResponseFromServer": "No response from server.", + "loc.messages.FailedToUploadFile": "Failed to complete file upload.", + "loc.messages.NoApiTokenFound": "No API token found on the Visual Studio App Center service connection.", + "loc.messages.InvalidDestinationInput": "The destination input provided was invalid", + "loc.messages.Succeeded": "App Center Distribute task succeeded", + "loc.messages.CannotFindAnyFile": "Cannot find any file based on %s.", + "loc.messages.FoundMultipleFiles": "Found multiple files matching %s.", + "loc.messages.FailedToCreateFile": "Failed to create %s with error: %s.", + "loc.messages.FailedToFindFile": "Failed to find %s at %s." +} \ No newline at end of file diff --git a/Tasks/AppCenterDistributeV3/Strings/resources.resjson/es-es/resources.resjson b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/es-es/resources.resjson new file mode 100644 index 000000000000..246044ba3622 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/es-es/resources.resjson @@ -0,0 +1,41 @@ +{ + "loc.friendlyName": "Distribución de App Center", + "loc.helpMarkDown": "Para obtener ayuda con esta tarea, visite el [sitio de soporte técnico](https://aka.ms/appcentersupport/) de Visual Studio App Center.", + "loc.description": "Distribuye compilaciones de la aplicación a los evaluadores y los usuarios a través de App Center.", + "loc.instanceNameFormat": "Implementar $(app) en Visual Studio App Center", + "loc.releaseNotes": "Agregue compatibilidad para la distribución a almacenes.", + "loc.group.displayName.symbols": "Símbolos", + "loc.input.label.serverEndpoint": "Conexión de servicio de App Center", + "loc.input.help.serverEndpoint": "Seleccione la conexión de servicio para Visual Studio App Center. Para crear una, haga clic en el vínculo Administrar y cree un nuevo servicio.", + "loc.input.label.appSlug": "Slug de aplicación", + "loc.input.help.appSlug": "El slug de aplicación tiene el formato **{nombreUsuario}/{identificador_aplicación}**. Para buscar **{nombreUsuario}** e **{identificador_aplicación}** para una aplicación, haga clic en su nombre en https://appcenter.ms/apps. La dirección URL resultante tiene el formato [https://appcenter.ms/users/{nombreUsuario}/apps/{identificador_aplicación}](https://appcenter.ms/users/{nombreUsuario}/apps/{identificador_aplicación}). Si usa organizaciones, el slug de aplicación tiene el formato **{nombreOrganización}/{identificador_aplicación}**.", + "loc.input.label.app": "Ruta de acceso a archivo binario", + "loc.input.help.app": "Ruta de acceso relativa desde la raíz del repositorio al archivo APK o IPA que desea publicar", + "loc.input.label.symbolsType": "Tipo de símbolos", + "loc.input.label.symbolsPath": "Ruta de acceso a símbolos", + "loc.input.help.symbolsPath": "Ruta de acceso relativa de la raíz del repositorio a la carpeta de símbolos.", + "loc.input.label.pdbPath": "Ruta de acceso de símbolos (*.pdb)", + "loc.input.help.pdbPath": "Ruta de acceso relativa desde la raíz del repositorio hasta los archivos de símbolos PDB. Puede contener comodines.", + "loc.input.label.dsymPath": "Ruta de acceso a dSYM", + "loc.input.help.dsymPath": "Ruta de acceso relativa desde la raíz del repositorio a la carpeta dSYM. Puede contener comodines.", + "loc.input.label.mappingTxtPath": "Archivo de asignación", + "loc.input.help.mappingTxtPath": "Ruta de acceso relativa desde la raíz del repositorio al archivo mapping.txt de Android.", + "loc.input.label.packParentFolder": "Incluir todos los elementos en la carpeta principal", + "loc.input.help.packParentFolder": "Suba la carpeta o el archivo de símbolos que se seleccionó y todos los otros elementos dentro de la carpeta principal. Esta acción es necesaria para las aplicaciones nativas de React.", + "loc.input.label.releaseNotesSelection": "Crear notas de la versión", + "loc.input.label.releaseNotesInput": "Notas de la versión", + "loc.input.help.releaseNotesInput": "Notas de esta versión.", + "loc.input.label.releaseNotesFile": "Archivo de notas de la versión", + "loc.input.help.releaseNotesFile": "Seleccione un archivo de texto con codificación UTF-8 que contenga las notas de esta versión.", + "loc.input.label.destinationIds": "Destination IDs", + "loc.input.help.destinationIds": "IDs of the distribution groups or stores the app will deploy to. Leave it empty to use the default group and use commas or semicolons to separate multiple IDs.", + "loc.messages.CannotDecodeEndpoint": "No se pudo descodificar el punto de conexión.", + "loc.messages.NoResponseFromServer": "No hay respuesta desde el servidor.", + "loc.messages.FailedToUploadFile": "Error al completar la carga de archivo.", + "loc.messages.NoApiTokenFound": "No se encontró ningún token de API en la conexión de servicio de Visual Studio App Center.", + "loc.messages.Succeeded": "La tarea de distribución de App Center se realizó correctamente.", + "loc.messages.CannotFindAnyFile": "No se puede encontrar ningún archivo basado en %s.", + "loc.messages.FoundMultipleFiles": "Se encontraron varios archivos que coinciden con %s.", + "loc.messages.FailedToCreateFile": "Error al crear %s: %s.", + "loc.messages.FailedToFindFile": "No se encuentra %s en %s." +} \ No newline at end of file diff --git a/Tasks/AppCenterDistributeV3/Strings/resources.resjson/fr-fr/resources.resjson b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/fr-fr/resources.resjson new file mode 100644 index 000000000000..d0e5c98ffe4a --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/fr-fr/resources.resjson @@ -0,0 +1,41 @@ +{ + "loc.friendlyName": "Distribution App Center", + "loc.helpMarkDown": "Pour obtenir de l'aide sur cette tâche, visitez Visual Studio App Center [site de support](https://aka.ms/appcentersupport/).", + "loc.description": "Distribuer les builds d'applications aux testeurs et aux utilisateurs via App Center", + "loc.instanceNameFormat": "Déployer $(app) sur Visual Studio App Center", + "loc.releaseNotes": "Ajoutez une prise en charge de la distribution aux Stores.", + "loc.group.displayName.symbols": "Symboles", + "loc.input.label.serverEndpoint": "Connexion de service App Center", + "loc.input.help.serverEndpoint": "Sélectionnez la connexion de service pour Visual Studio App Center. Pour en créer une, cliquez sur le lien Gérer, puis créez une connexion de service.", + "loc.input.label.appSlug": "Slug de l'application", + "loc.input.help.appSlug": "Le slug de l'application est au format **{nom_utilisateur}/{identificateur_application}**. Pour localiser les éléments **{nom_utilisateur}** et **{identificateur_application}** d'une application, cliquez sur son nom à partir de https://appcenter.ms/apps. L'URL qui en résulte est au format [https://appcenter.ms/users/{nom_utilisateur}/apps/{identificateur_application}](https://appcenter.ms/users/{nom_utilisateur}/apps/{identificateur_application}). Si vous utilisez des organisations, le slug de l'application est au format **{nom_organisation}/{identificateur_application}**.", + "loc.input.label.app": "Chemin du fichier binaire", + "loc.input.help.app": "Chemin d'accès relatif de la racine de référentiel vers le fichier APK ou IPA que vous souhaitez publier", + "loc.input.label.symbolsType": "Type des symboles", + "loc.input.label.symbolsPath": "Chemin des symboles", + "loc.input.help.symbolsPath": "Chemin d'accès relatif de la racine de référentiel vers le dossier de symboles.", + "loc.input.label.pdbPath": "Chemin des symboles (*.pdb)", + "loc.input.help.pdbPath": "Chemin relatif de la racine de dépôt vers les fichiers de symboles PDB. Le chemin peut contenir des caractères génériques.", + "loc.input.label.dsymPath": "Chemin dSYM", + "loc.input.help.dsymPath": "Chemin relatif de la racine de dépôt vers le dossier dSYM. Le chemin peut contenir des caractères génériques.", + "loc.input.label.mappingTxtPath": "Fichier de mappage", + "loc.input.help.mappingTxtPath": "Chemin d'accès relatif de la racine de référentiel vers le fichier mapping.txt Android.", + "loc.input.label.packParentFolder": "Inclure tous les éléments dans le dossier parent", + "loc.input.help.packParentFolder": "Chargez le fichier ou dossier de symboles sélectionné, ainsi que tous les autres éléments à l'intérieur du même dossier parent. Cela est obligatoire pour les applications React Native.", + "loc.input.label.releaseNotesSelection": "Créer des notes de publication", + "loc.input.label.releaseNotesInput": "Notes de publication", + "loc.input.help.releaseNotesInput": "Notes de publication de cette version.", + "loc.input.label.releaseNotesFile": "Fichier de notes de publication", + "loc.input.help.releaseNotesFile": "Sélectionnez un fichier texte UTF-8 contenant les notes de publication de cette version.", + "loc.input.label.destinationIds": "Destination IDs", + "loc.input.help.destinationIds": "IDs of the distribution groups or stores the app will deploy to. Leave it empty to use the default group and use commas or semicolons to separate multiple IDs.", + "loc.messages.CannotDecodeEndpoint": "Impossible de décoder le point de terminaison.", + "loc.messages.NoResponseFromServer": "Aucune réponse du serveur.", + "loc.messages.FailedToUploadFile": "Impossible de terminer le téléchargement du fichier.", + "loc.messages.NoApiTokenFound": "Jeton d'API introuvable dans la connexion de service Visual Studio App Center.", + "loc.messages.Succeeded": "Tâche de distribution via App Center réussie", + "loc.messages.CannotFindAnyFile": "Impossible de trouver un fichier basé sur %s.", + "loc.messages.FoundMultipleFiles": "Plusieurs fichiers correspondant à %s ont été trouvés.", + "loc.messages.FailedToCreateFile": "Impossible de créer %s avec l'erreur : %s.", + "loc.messages.FailedToFindFile": "%s est introuvable sur %s." +} \ No newline at end of file diff --git a/Tasks/AppCenterDistributeV3/Strings/resources.resjson/it-IT/resources.resjson b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/it-IT/resources.resjson new file mode 100644 index 000000000000..5f829b987bea --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/it-IT/resources.resjson @@ -0,0 +1,41 @@ +{ + "loc.friendlyName": "Distribuzione App Center", + "loc.helpMarkDown": "Per informazioni su questa attività, visitare il [sito del supporto](https://aka.ms/appcentersupport/) di Visual Studio App Center.", + "loc.description": "Consente di distribuire build di app a tester e utenti tramite App Center", + "loc.instanceNameFormat": "Distribuisci $(app) in Visual Studio App Center", + "loc.releaseNotes": "Aggiungere il supporto per la distribuzione negli store.", + "loc.group.displayName.symbols": "Simboli", + "loc.input.label.serverEndpoint": "Connessione al servizio App Center", + "loc.input.help.serverEndpoint": "Consente di selezionare la connessione al servizio per Visual Studio App Center. Per crearne una, fare clic sul collegamento Gestisci e creare una nuova connessione al servizio.", + "loc.input.label.appSlug": "Campo dati dinamico dell'app", + "loc.input.help.appSlug": "Il campo dati dinamico dell'app è in formato **{nome_utente}/{identificatore_app}**. Per individuare **{nome_utente}** e **{identificatore_app}** per un'app, fare clic sul relativo nome da https://appcenter.ms/apps. L'URL risultante è in formato [https://appcenter.ms/users/{nome_utente}/apps/{identificatore_app}](https://appcenter.ms/users/{nome_utente}/apps/{identificatore_app}). Se si usano organizzazioni, il campo dati dinamico dell'app è in formato **{nome_organizzazione}/{identificatore_app}**.", + "loc.input.label.app": "Percorso dei file binari", + "loc.input.help.app": "Percorso relativo dalla radice del repository al file APK o IPA che si vuole pubblicare", + "loc.input.label.symbolsType": "Tipo di simboli", + "loc.input.label.symbolsPath": "Percorso dei simboli", + "loc.input.help.symbolsPath": "Percorso relativo dalla radice del repository alla cartella dei simboli.", + "loc.input.label.pdbPath": "Percorso dei simboli (*.pdb)", + "loc.input.help.pdbPath": "Percorso relativo dalla radice del repository ai file di simboli PDB. Può includere caratteri jolly.", + "loc.input.label.dsymPath": "Percorso di dSYM", + "loc.input.help.dsymPath": "Percorso relativo dalla radice del repository alla cartella dSYM. Può includere caratteri jolly.", + "loc.input.label.mappingTxtPath": "File di mapping", + "loc.input.help.mappingTxtPath": "Percorso relativo dalla radice del repository al file mapping.txt di Android.", + "loc.input.label.packParentFolder": "Includi tutti gli elementi nella cartella padre", + "loc.input.help.packParentFolder": "Consente di caricare la cartella o il file dei simboli selezionati, nonché tutti gli altri elementi presenti all'interno della stessa cartella padre. Questa operazione è obbligatoria per le app React Native.", + "loc.input.label.releaseNotesSelection": "Crea note sulla versione", + "loc.input.label.releaseNotesInput": "Note sulla versione", + "loc.input.help.releaseNotesInput": "Note sulla versione per questa versione.", + "loc.input.label.releaseNotesFile": "File delle note sulla versione", + "loc.input.help.releaseNotesFile": "Consente di selezionare un file di testo con codifica UTF-8 che contiene le note sulla versione per questa versione.", + "loc.input.label.destinationIds": "Destination IDs", + "loc.input.help.destinationIds": "IDs of the distribution groups or stores the app will deploy to. Leave it empty to use the default group and use commas or semicolons to separate multiple IDs.", + "loc.messages.CannotDecodeEndpoint": "Non è stato possibile decodificare l'endpoint.", + "loc.messages.NoResponseFromServer": "Non è stata ricevuta alcuna risposta dal server.", + "loc.messages.FailedToUploadFile": "Non è stato possibile completare il caricamento dei file.", + "loc.messages.NoApiTokenFound": "Non è stato trovato alcun token API per la connessione al servizio Visual Studio App Center.", + "loc.messages.Succeeded": "Attività Distribuzione App Center completata", + "loc.messages.CannotFindAnyFile": "Non è stato trovato alcun file basato su %s.", + "loc.messages.FoundMultipleFiles": "Sono stati trovati più file corrispondenti a %s.", + "loc.messages.FailedToCreateFile": "Non è stato possibile creare %s. Errore: %s.", + "loc.messages.FailedToFindFile": "%s non è stato trovato alla posizione %s." +} \ No newline at end of file diff --git a/Tasks/AppCenterDistributeV3/Strings/resources.resjson/ja-jp/resources.resjson b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/ja-jp/resources.resjson new file mode 100644 index 000000000000..8a1e7acb7970 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/ja-jp/resources.resjson @@ -0,0 +1,41 @@ +{ + "loc.friendlyName": "App Center 配布", + "loc.helpMarkDown": "このタスクに関するヘルプは、Visual Studio App Center [サポート サイト](https://aka.ms/appcentersupport/) をご覧ください。", + "loc.description": "App Center 経由でテスト担当者とユーザーにアプリのビルドを配布します", + "loc.instanceNameFormat": "$(app) を Visual Studio App Center に配置する", + "loc.releaseNotes": "ストアへの配布のサポートを追加します。", + "loc.group.displayName.symbols": "シンボル", + "loc.input.label.serverEndpoint": "App Center サービス接続", + "loc.input.help.serverEndpoint": "Visual Studio App Center のサービス接続を選択します。作成するには、[管理] リンクをクリックして、新しいサービス接続を作成します。", + "loc.input.label.appSlug": "アプリ置換", + "loc.input.help.appSlug": "アプリ置換の形式は **{username}/{app_identifier}** です。アプリの **{username}** や **{app_identifier}** を見つけるには、https://appcenter.ms/apps からその名前をクリックします。その結果の URL は [https://appcenter.ms/users/{username}/apps/{app_identifier}](https://appcenter.ms/users/{username}/apps/{app_identifier}) の形式になります。org を使用している場合は、アプリ置換の形式は **{orgname}/{app_identifier}** です。", + "loc.input.label.app": "バイナリ ファイル パス", + "loc.input.help.app": "リポジトリのルートから発行する APK または IPA ファイルへの相対パス", + "loc.input.label.symbolsType": "シンボルの種類", + "loc.input.label.symbolsPath": "シンボル パス", + "loc.input.help.symbolsPath": "リポジトリのルートからシンボル フォルダーへの相対パス。", + "loc.input.label.pdbPath": "シンボル パス (*.pdb)", + "loc.input.help.pdbPath": "リポジトリのルートから PDB シンボル ファイルへの相対パス。パスにはワイルドカードを含めることができます。", + "loc.input.label.dsymPath": "dSYM パス", + "loc.input.help.dsymPath": "リポジトリのルートから dSYM フォルダーへの相対パス。パスにはワイルドカードを含めることができます。", + "loc.input.label.mappingTxtPath": "マッピング ファイル", + "loc.input.help.mappingTxtPath": "リポジトリのルートから Android の mapping.txt ファイルへの相対パス。", + "loc.input.label.packParentFolder": "親フォルダー内のアイテムをすべて含める", + "loc.input.help.packParentFolder": "選択したシンボル ファイルまたはフォルダー、および同じ親フォルダー内の他のすべてのアイテムをアップロードします。React Native アプリの場合は必須です。", + "loc.input.label.releaseNotesSelection": "リリース ノートの作成", + "loc.input.label.releaseNotesInput": "リリース ノート", + "loc.input.help.releaseNotesInput": "このバージョンのリリース ノート。", + "loc.input.label.releaseNotesFile": "リリース ノート ファイル", + "loc.input.help.releaseNotesFile": "このバージョンのリリース ノートが含まれる、UTF-8 でエンコードされたテキスト ファイルを選択します。", + "loc.input.label.destinationIds": "Destination IDs", + "loc.input.help.destinationIds": "IDs of the distribution groups or stores the app will deploy to. Leave it empty to use the default group and use commas or semicolons to separate multiple IDs.", + "loc.messages.CannotDecodeEndpoint": "エンドポイントをデコードできませんでした。", + "loc.messages.NoResponseFromServer": "サーバーから応答がありません。", + "loc.messages.FailedToUploadFile": "ファイルの完全アップロードに失敗しました。", + "loc.messages.NoApiTokenFound": "Visual Studio App Center サービス接続上に API トークンが見つかりませんでした。", + "loc.messages.Succeeded": "App Center 配布タスクが正常に実行されました", + "loc.messages.CannotFindAnyFile": "%s に基づくファイルが見つかりません。", + "loc.messages.FoundMultipleFiles": "%s と一致しているファイルが複数見つかりました。", + "loc.messages.FailedToCreateFile": "次のエラーで %s を作成できませんでした: %s。", + "loc.messages.FailedToFindFile": "%s が %s で見つかりませんでした。" +} \ No newline at end of file diff --git a/Tasks/AppCenterDistributeV3/Strings/resources.resjson/ko-KR/resources.resjson b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/ko-KR/resources.resjson new file mode 100644 index 000000000000..2f58f9643e54 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/ko-KR/resources.resjson @@ -0,0 +1,41 @@ +{ + "loc.friendlyName": "App Center 배포", + "loc.helpMarkDown": "이 작업에 대한 도움말이 필요하면 Visual Studio App Center [지원 사이트](https://aka.ms/appcentersupport/)를 방문하세요.", + "loc.description": "App Center를 통해 테스트와 사용자에게 앱 빌드를 배포합니다.", + "loc.instanceNameFormat": "Visual Studio App Center에 $(app) 배포", + "loc.releaseNotes": "저장소로 배포에 대한 지원을 추가합니다.", + "loc.group.displayName.symbols": "기호", + "loc.input.label.serverEndpoint": "App Center 서비스 연결", + "loc.input.help.serverEndpoint": "Visual Studio App Center에 대한 서비스 연결을 선택합니다. 서비스 연결을 만들려면 [관리] 링크를 클릭하고 새 서비스 연결을 만듭니다.", + "loc.input.label.appSlug": "앱 동적 필드", + "loc.input.help.appSlug": "앱 동적 필드는 **{username}/{app_identifier}** 형식입니다. 앱의 **{username}** 및 **{app_identifier}**를 찾으려면 https://appcenter.ms/apps에서 앱 이름을 클릭하세요. 결과 URL은 [https://appcenter.ms/users/{username}/apps/{app_identifier}](https://appcenter.ms/users/{username}/apps/{app_identifier}) 형식입니다. 조직을 사용하는 경우 앱 동적 필드는 **{orgname}/{app_identifier}** 형식입니다.", + "loc.input.label.app": "이진 파일 경로", + "loc.input.help.app": "게시할 APK 또는 IPA 파일의 리포 루트로부터의 상대 경로입니다.", + "loc.input.label.symbolsType": "기호 형식", + "loc.input.label.symbolsPath": "기호 경로", + "loc.input.help.symbolsPath": "기호 폴더의 리포 루트로부터의 상대 경로입니다.", + "loc.input.label.pdbPath": "기호 경로(*.pdb)", + "loc.input.help.pdbPath": "PDB 기호 파일의 리포 루트로부터의 상대 경로입니다. 경로에는 와일드카드가 포함될 수 있습니다.", + "loc.input.label.dsymPath": "dSYM 경로", + "loc.input.help.dsymPath": "dSYM 폴더의 리포 루트로부터의 상대 경로입니다. 경로에는 와일드카드가 포함될 수 있습니다.", + "loc.input.label.mappingTxtPath": "매핑 파일", + "loc.input.help.mappingTxtPath": "Android mapping.txt 파일의 리포 루트로부터의 상대 경로입니다.", + "loc.input.label.packParentFolder": "부모 폴더의 모든 항목 포함", + "loc.input.help.packParentFolder": "선택한 기호 파일 또는 폴더 및 동일한 부모 폴더에 있는 다른 모든 항목을 업로드합니다. 이는 React Native 앱에 필요합니다.", + "loc.input.label.releaseNotesSelection": "릴리스 정보 만들기", + "loc.input.label.releaseNotesInput": "릴리스 정보", + "loc.input.help.releaseNotesInput": "이 버전의 릴리스 정보입니다.", + "loc.input.label.releaseNotesFile": "릴리스 정보 파일", + "loc.input.help.releaseNotesFile": "이 버전의 릴리스 정보를 포함하는 UTF-8로 인코드된 텍스트 파일을 선택합니다.", + "loc.input.label.destinationIds": "Destination IDs", + "loc.input.help.destinationIds": "IDs of the distribution groups or stores the app will deploy to. Leave it empty to use the default group and use commas or semicolons to separate multiple IDs.", + "loc.messages.CannotDecodeEndpoint": "엔드포인트를 디코드할 수 없습니다.", + "loc.messages.NoResponseFromServer": "서버의 응답이 없습니다.", + "loc.messages.FailedToUploadFile": "파일 업로드를 완료하지 못했습니다.", + "loc.messages.NoApiTokenFound": "Visual Studio App Center 서비스 연결에서 API 토큰을 찾을 수 없습니다.", + "loc.messages.Succeeded": "App Center 배포 작업 성공", + "loc.messages.CannotFindAnyFile": "%s을(를) 기반으로 하는 파일을 찾을 수 없습니다.", + "loc.messages.FoundMultipleFiles": "%s과(와) 일치하는 파일을 여러 개 찾았습니다.", + "loc.messages.FailedToCreateFile": "%s을(를) 만들지 못했습니다(오류: %s).", + "loc.messages.FailedToFindFile": "%s을(를) %s에서 찾지 못했습니다." +} \ No newline at end of file diff --git a/Tasks/AppCenterDistributeV3/Strings/resources.resjson/ru-RU/resources.resjson b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/ru-RU/resources.resjson new file mode 100644 index 000000000000..ed4f0642ecd9 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/ru-RU/resources.resjson @@ -0,0 +1,41 @@ +{ + "loc.friendlyName": "Распространение через Центр приложений", + "loc.helpMarkDown": "Чтобы получить помощь в выполнении этой задачи, посетите [сайт службы поддержки](https://aka.ms/appcentersupport/) Центра приложений Visual Studio.", + "loc.description": "Распространять сборки приложений среди тест-инженеров и пользователей через Центр приложений", + "loc.instanceNameFormat": "Развертывание $(app) в Центре приложений Visual Studio", + "loc.releaseNotes": "Добавьте поддержку распространения в хранилищах.", + "loc.group.displayName.symbols": "Символы", + "loc.input.label.serverEndpoint": "Подключение к службе Центра приложений", + "loc.input.help.serverEndpoint": "Выберите подключение службы для Центра приложений Visual Studio. Чтобы создать подключение, щелкните ссылку \"Управление\".", + "loc.input.label.appSlug": "Динамический идентификатор приложения", + "loc.input.help.appSlug": "Динамический идентификатор приложения имеет формат **{имя_пользователя}/{идентификатор_приложения}**. Чтобы найти значения **{имя_пользователя}** и **{идентификатор_приложения}** для приложения, щелкните его имя на сайте https://appcenter.ms/apps. Полученный URL-адрес будет иметь формат [https://appcenter.ms/users/{имя_пользователя}/apps/{идентификатор_приложения}](https://appcenter.ms/users/{имя_пользователя}/apps/{идентификатор_приложения}). При использовании названия организации динамический идентификатор приложения имеет формат **{название_организации}/{идентификатор_приложения}**.", + "loc.input.label.app": "Путь к двоичному файлу", + "loc.input.help.app": "Относительный путь от корня репозитория к APK- или IPA-файлу для публикации", + "loc.input.label.symbolsType": "Тип символов", + "loc.input.label.symbolsPath": "Путь к символам", + "loc.input.help.symbolsPath": "Относительный путь от корня репозитория к папке символов.", + "loc.input.label.pdbPath": "Путь к символам (*.pdb)", + "loc.input.help.pdbPath": "Относительный путь от корня репозитория к файлам символов PDB. Путь может содержать подстановочные знаки.", + "loc.input.label.dsymPath": "Путь dSYM", + "loc.input.help.dsymPath": "Относительный путь от корня репозитория к папке dSYM. Путь может содержать подстановочные знаки.", + "loc.input.label.mappingTxtPath": "Файл сопоставления", + "loc.input.help.mappingTxtPath": "Относительный путь от корня репозитория к файлу mapping.txt для Android.", + "loc.input.label.packParentFolder": "Включить все элементы в родительской папке", + "loc.input.help.packParentFolder": "Отправьте файл или папку выбранных символов, а также все прочие элементы в той же родительской папке. Это обязательно для приложений React Native.", + "loc.input.label.releaseNotesSelection": "Создание заметок о выпуске", + "loc.input.label.releaseNotesInput": "Заметки о выпуске", + "loc.input.help.releaseNotesInput": "Заметки о выпуске для этой версии.", + "loc.input.label.releaseNotesFile": "Файл заметок о выпуске", + "loc.input.help.releaseNotesFile": "Выберите текстовый файл в кодировке UTF-8, содержащий заметки о выпуске этой версии.", + "loc.input.label.destinationIds": "Destination IDs", + "loc.input.help.destinationIds": "IDs of the distribution groups or stores the app will deploy to. Leave it empty to use the default group and use commas or semicolons to separate multiple IDs.", + "loc.messages.CannotDecodeEndpoint": "Не удалось декодировать конечную точку.", + "loc.messages.NoResponseFromServer": "Нет ответа от сервера.", + "loc.messages.FailedToUploadFile": "Не удалось завершить отправку файла.", + "loc.messages.NoApiTokenFound": "У подключения к службе Центра приложений Visual Studio не найден токен API.", + "loc.messages.Succeeded": "Задача распространения через Центр приложений выполнена успешно", + "loc.messages.CannotFindAnyFile": "Не удается найти файл на основе %s.", + "loc.messages.FoundMultipleFiles": "Найдено несколько файлов, соответствующих %s.", + "loc.messages.FailedToCreateFile": "Не удалось создать %s, ошибка: %s", + "loc.messages.FailedToFindFile": "Не удалось найти %s в %s." +} \ No newline at end of file diff --git a/Tasks/AppCenterDistributeV3/Strings/resources.resjson/zh-CN/resources.resjson b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/zh-CN/resources.resjson new file mode 100644 index 000000000000..8ec1b33a4f65 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/zh-CN/resources.resjson @@ -0,0 +1,41 @@ +{ + "loc.friendlyName": "App Center 分布", + "loc.helpMarkDown": "有关此任务的帮助信息，请访问 Visual Studio App Center [支持站点](https://aka.ms/appcentersupport/)。", + "loc.description": "通过 App Center 向测试人员和用户分布应用生成", + "loc.instanceNameFormat": "将 $(app)部署到 Visual Studio App Center", + "loc.releaseNotes": "添加商店分发支持。", + "loc.group.displayName.symbols": "符号", + "loc.input.label.serverEndpoint": "App Center 服务连接", + "loc.input.help.serverEndpoint": "选择 Visual Studio App Center 的服务连接。若要创建一个连接，请单击“管理”链接并创建新的服务连接。", + "loc.input.label.appSlug": "应用数据域", + "loc.input.help.appSlug": "应用数据域的格式为 **{username}/{app_identifier}**。要查找应用的 **{username}** 和 **{app_identifier}**，请在 https://appcenter.ms/apps 上单击其名称，生成的 URL 格式为 [https://appcenter.ms/users/{username}/apps/{app_identifier}](https://appcenter.ms/users/{username}/apps/{app_identifier})。如果使用的是组织，则应用数据域的格式为 **{orgname}/{app_identifier}**。", + "loc.input.label.app": "二进制文件路径", + "loc.input.help.app": "从存储库根路径到要发布的 APK 或 IPA 文件的相对路径", + "loc.input.label.symbolsType": "符号类型", + "loc.input.label.symbolsPath": "符号路径", + "loc.input.help.symbolsPath": "从存储库根路径到符号文件夹的相对路径。", + "loc.input.label.pdbPath": "符号路径(*.pdb)", + "loc.input.help.pdbPath": "从存储库根路径到 PDB 符号文件的相对路径。路径可能包含通配符。", + "loc.input.label.dsymPath": "dSYM 路径", + "loc.input.help.dsymPath": "从存储库根路径到 dSYM 文件夹的相对路径。路径可能包含通配符。", + "loc.input.label.mappingTxtPath": "映射文件", + "loc.input.help.mappingTxtPath": "从存储库根路径到 Android 的 mapping.txt 文件的相对路径。", + "loc.input.label.packParentFolder": "包含父文件夹中的所有项", + "loc.input.help.packParentFolder": "上传所选的符号文件或文件夹以及在同一父级文件夹中的所有其他项。对于 React 本机应用，这是必需的。", + "loc.input.label.releaseNotesSelection": "创建发行说明", + "loc.input.label.releaseNotesInput": "发行说明", + "loc.input.help.releaseNotesInput": "此版本的发行说明。", + "loc.input.label.releaseNotesFile": "发行说明文件", + "loc.input.help.releaseNotesFile": "选择包含此版本的发行说明的 UTF-8 编码文本文件。", + "loc.input.label.destinationIds": "Destination IDs", + "loc.input.help.destinationIds": "IDs of the distribution groups or stores the app will deploy to. Leave it empty to use the default group and use commas or semicolons to separate multiple IDs.", + "loc.messages.CannotDecodeEndpoint": "无法解码终结点。", + "loc.messages.NoResponseFromServer": "服务器无响应。", + "loc.messages.FailedToUploadFile": "未能完成文件上传。", + "loc.messages.NoApiTokenFound": "Visual Studio App Center 服务连接上找不到 API 令牌。", + "loc.messages.Succeeded": "App Center 分布任务已完成", + "loc.messages.CannotFindAnyFile": "找不到基于 %s 的任何文件。", + "loc.messages.FoundMultipleFiles": "找到与 %s 匹配的多个文件。", + "loc.messages.FailedToCreateFile": "未能创建 %s，出现错误: %s。", + "loc.messages.FailedToFindFile": "未能找到 %s，查找位置: %s。" +} \ No newline at end of file diff --git a/Tasks/AppCenterDistributeV3/Strings/resources.resjson/zh-TW/resources.resjson b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/zh-TW/resources.resjson new file mode 100644 index 000000000000..7dabbd12df63 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/zh-TW/resources.resjson @@ -0,0 +1,41 @@ +{ + "loc.friendlyName": "App Center 散發", + "loc.helpMarkDown": "如需此工作的說明，請瀏覽 Visual Studio App Center [支援網站](https://aka.ms/appcentersupport/)。", + "loc.description": "透過 App Center 將應用程式組建散發給測試人員及使用者", + "loc.instanceNameFormat": "將 $(app) 部署到 Visual Studio App Center", + "loc.releaseNotes": "新增散發到市集的支援。", + "loc.group.displayName.symbols": "符號", + "loc.input.label.serverEndpoint": "App Center 服務連線", + "loc.input.help.serverEndpoint": "選取 Visual Studio App Center 的服務連線。若要建立服務連線，請按一下 [管理] 連結，然後建立新的服務連線。", + "loc.input.label.appSlug": "應用程式動態資料欄位", + "loc.input.help.appSlug": "應用程式動態資料欄位的格式為 **{username}/{app_identifier}**。若要尋找應用程式的 **{username}** 及 **{app_identifier}**，請在 https://appcenter.ms/apps 中按一下其名稱。產生的 URL 格式為 [https://appcenter.ms/users/{username}/apps/{app_identifier}](https://appcenter.ms/users/{username}/apps/{app_identifier})。若目前使用 orgs，則應用程式動態資料欄位的格式為 **{orgname}/{app_identifier}**。", + "loc.input.label.app": "二進位檔案路徑", + "loc.input.help.app": "從存放庫根路徑到要發佈之 APK 或 IPA 檔案的相對路徑", + "loc.input.label.symbolsType": "符號類型", + "loc.input.label.symbolsPath": "符號路徑", + "loc.input.help.symbolsPath": "從存放庫根路徑到符號資料夾的相對路徑。", + "loc.input.label.pdbPath": "符號路徑 (*.pdb)", + "loc.input.help.pdbPath": "從存放庫根目錄到 PDB 符號檔案的相對路徑。路徑中可以包含萬用字元。", + "loc.input.label.dsymPath": "dSYM 路徑", + "loc.input.help.dsymPath": "從存放庫根目錄到 dSYM 資料夾的相對路徑。路徑中可以包含萬用字元。", + "loc.input.label.mappingTxtPath": "對應檔案", + "loc.input.help.mappingTxtPath": "從存放庫根路徑到 Android mapping.txt 檔案的相對路徑。", + "loc.input.label.packParentFolder": "包括父資料夾中所有項目", + "loc.input.help.packParentFolder": "上傳選取的符號檔或資料夾，以及相同父資料夾中的所有其他項目。這對 React Native 應用程式而言是必要動作。", + "loc.input.label.releaseNotesSelection": "建立版本資訊", + "loc.input.label.releaseNotesInput": "版本資訊", + "loc.input.help.releaseNotesInput": "此版本的版本資訊。", + "loc.input.label.releaseNotesFile": "版本資訊檔案", + "loc.input.help.releaseNotesFile": "選取包含此版本版本資訊的 UTF-8 編碼文字檔。", + "loc.input.label.destinationIds": "Destination IDs", + "loc.input.help.destinationIds": "IDs of the distribution groups or stores the app will deploy to. Leave it empty to use the default group and use commas or semicolons to separate multiple IDs.", + "loc.messages.CannotDecodeEndpoint": "無法將端點解碼。", + "loc.messages.NoResponseFromServer": "伺服器沒有任何回應。", + "loc.messages.FailedToUploadFile": "無法完成檔案上傳。", + "loc.messages.NoApiTokenFound": "在 Visual Studio App Center 服務連線上找不到任何 API 權杖。", + "loc.messages.Succeeded": "App Center 散發工作已成功", + "loc.messages.CannotFindAnyFile": "無法依據 %s 找到任何檔案。", + "loc.messages.FoundMultipleFiles": "找到多個符合 %s 的檔案。", + "loc.messages.FailedToCreateFile": "無法建立 %s，發生錯誤: %s。", + "loc.messages.FailedToFindFile": "在下列位置上找不到 %s: %s。" +} \ No newline at end of file diff --git a/Tasks/AppCenterDistributeV3/Tests/L0.ts b/Tasks/AppCenterDistributeV3/Tests/L0.ts new file mode 100644 index 000000000000..21e890d718f7 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0.ts @@ -0,0 +1,207 @@ + +// npm install mocha --save-dev +// typings install dt~mocha --save --global + +import * as path from 'path'; +import * as assert from 'assert'; +import * as ttm from 'vsts-task-lib/mock-test'; + +describe('AppCenterDistribute L0 Suite', function () { + before(() => { + //Enable this for output + //process.env['TASK_TEST_TRACE'] = 1; + + //setup endpoint + process.env["ENDPOINT_AUTH_MyTestEndpoint"] = "{\"parameters\":{\"apitoken\":\"mytoken123\"},\"scheme\":\"apitoken\"}"; + process.env["ENDPOINT_URL_MyTestEndpoint"] = "https://example.test/v0.1"; + process.env["ENDPOINT_AUTH_PARAMETER_MyTestEndpoint_APITOKEN"] = "mytoken123"; + process.env["SYSTEM_DEFAULTWORKINGDIRECTORY"]="/agent/1/_work"; + }); + + after(() => { + delete process.env['BUILD_BUILDID']; + delete process.env['BUILD_SOURCEBRANCH']; + delete process.env['BUILD_SOURCEVERSION']; + delete process.env['LASTCOMMITMESSAGE']; + }); + + it('Positive path: upload one ipa file', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0OneIpaPass.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + }); + + it('Negative path: can not upload multiple files', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0MultipleIpaFail.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.failed, 'task should have failed'); + }); + + it('Negative path: cannot continue upload without symbols', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0NoSymbolsFails.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.failed, 'task should have failed'); + }); + + it('Postiive path: can continue upload without symbols if variable VSMobileCenterUpload.ContinueIfSymbolsNotFound is true', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0NoSymbolsConditionallyPass.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + }); + + it('Negative path: mobile center api rejects fail the task', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0ApiRejectsFail.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.failed, 'task should have failed'); + }); + + it('Positive path: single file with Include Parent', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0SymIncludeParent.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + }); + + it('Positive path: multiple dSYMs in the same foder', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0SymMultipleDSYMs_flat_1.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + }); + + it('Positive path: multiple dSYMs in parallel foders', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0SymMultipleDSYMs_flat_2.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + }); + + it('Positive path: multiple dSYMs in a tree', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0SymMultipleDSYMs_tree.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + }); + + it('Positive path: a single dSYM', function () { + this.timeout(6000); + + let tp = path.join(__dirname, 'L0SymMultipleDSYMs_single.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + }); + + it('Positive path: a single PDB', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0SymPDBs_single.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + }); + + + it('Positive path: multiple PDBs', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0SymPDBs_multiple.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + }); + + it('Positive path: publish commit info (including commit message)', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0PublishCommitInfo_1.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + }); + + it('Positive path: publish commit info (excluding commit message)', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0PublishCommitInfo_2.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + }); + + it('Positive path: publish commit info for feature branch', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0PublishCommitInfo_3.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + }); + + it('Positive path: publish commit info for tfvc branch', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0PublishCommitInfo_4.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + }); + + it('Positive path: publish mandatory update', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0PublishMandatoryUpdate.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + }); + it('Positive path: publish multiple destinations', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0PublishMultipleDestinations.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + }); +}); diff --git a/Tasks/AppCenterDistributeV3/Tests/L0ApiRejectsFail.ts b/Tasks/AppCenterDistributeV3/Tests/L0ApiRejectsFail.ts new file mode 100644 index 000000000000..acd18dde3440 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0ApiRejectsFail.ts @@ -0,0 +1,38 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/package_uploads') + .reply(403); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + "checkPath" : { + "/test/path/to/my.ipa": true + }, + "findMatch" : { + "/test/path/to/my.ipa": [ + "/test/path/to/my.ipa" + ] + } +}; +tmr.setAnswers(a); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0MultipleIpaFail.ts b/Tasks/AppCenterDistributeV3/Tests/L0MultipleIpaFail.ts new file mode 100644 index 000000000000..cc5b932b4f3f --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0MultipleIpaFail.ts @@ -0,0 +1,44 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/*.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + "checkPath" : { + "/test/path/to/one.ipa": true, + "/test/path/to/two.ipa": true + }, + "findMatch" : { + "/test/path/to/*.ipa": [ + "/test/path/to/one.ipa", + "/test/path/to/two.ipa" + ] + } +}; +tmr.setAnswers(a); + +tmr.registerMock('./utils.js', { + resolveSinglePath: function(s, b1, b2) { + throw new Error("Matched multiple files"); + }, + checkAndFixFilePath: function(p, name) { + return p; + } +}); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0NoSymbolsConditionallyPass.ts b/Tasks/AppCenterDistributeV3/Tests/L0NoSymbolsConditionallyPass.ts new file mode 100644 index 000000000000..33cc1eabf238 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0NoSymbolsConditionallyPass.ts @@ -0,0 +1,95 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable +var Stats = require('fs').Stats + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +process.env['VSMOBILECENTERUPLOAD_CONTINUEIFSYMBOLSNOTFOUND']='true'; + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/one.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('symbolsType', 'Apple'); +tmr.setInput('dsymPath', '/test/path/to/symbols.dSYM'); + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/release_uploads/1", { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +nock('https://example.test') + .patch("/my_release_location", { + status: "available", + destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + release_notes: "my release notes" + }) + .reply(200); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + "findMatch": { + "/test/path/to/one.ipa": [ + "/test/path/to/one.ipa" + ], + "/test/path/to/symbols.dSYM": [ + "/test/path/to/symbols.dSYM" + ] + }, + "checkPath" : { + "/test/path/to/one.ipa": true + }, + "exist": { + "/test/path/to/symbols.dSYM": false + } +}; +tmr.setAnswers(a); + +fs.createReadStream = (s) => { + let stream = new Readable; + stream.push(s); + stream.push(null); + + return stream; +}; + +fs.statSync = (s) => { + let stat = new Stats; + stat.isFile = () => { + return true; + } + + return stat; +} +tmr.registerMock('fs', fs); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0NoSymbolsFails.ts b/Tasks/AppCenterDistributeV3/Tests/L0NoSymbolsFails.ts new file mode 100644 index 000000000000..3a7e5d6a3483 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0NoSymbolsFails.ts @@ -0,0 +1,41 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/one.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('symbolsType', 'Apple'); +tmr.setInput('dsymPath', '/test/path/to/symbols.dSYM'); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + "findMatch": { + "/test/path/to/one.ipa": [ + "/test/path/to/one.ipa" + ], + "/test/path/to/symbols.dSYM": [ + "/test/path/to/symbols.dSYM" + ] + }, + "checkPath" : { + "/test/path/to/one.ipa": true + }, + "exist": { + "/test/path/to/symbols.dSYM": false + } +}; +tmr.setAnswers(a); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0OneIpaPass.ts b/Tasks/AppCenterDistributeV3/Tests/L0OneIpaPass.ts new file mode 100644 index 000000000000..8efcca5b7994 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0OneIpaPass.ts @@ -0,0 +1,121 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable +var Stats = require('fs').Stats + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('symbolsType', 'AndroidJava'); +tmr.setInput('mappingTxtPath', '/test/path/to/mappings.txt'); + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/release_uploads/1", { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +nock('https://example.test') + .patch("/my_release_location", { + status: "available", + destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + release_notes: "my release notes" + }) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: "AndroidJava" + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/symbol_uploads/100", { + status: 'committed' + }) + .reply(200); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + "checkPath" : { + "/test/path/to/my.ipa": true, + "/test/path/to/mappings.txt": true + }, + "findMatch" : { + "/test/path/to/mappings.txt": [ + "/test/path/to/mappings.txt" + ], + "/test/path/to/my.ipa": [ + "/test/path/to/my.ipa" + ] + } +}; +tmr.setAnswers(a); + +fs.createReadStream = (s: string) => { + let stream = new Readable; + stream.push(s); + stream.push(null); + + return stream; +}; + +fs.statSync = (s: string) => { + let stat = new Stats; + + stat.isFile = () => { + return !s.toLowerCase().endsWith(".dsym"); + } + stat.isDirectory = () => { + return s.toLowerCase().endsWith(".dsym"); + } + stat.size = 100; + + return stat; +} +tmr.registerMock('fs', fs); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_1.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_1.ts new file mode 100644 index 000000000000..661cbbce4736 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_1.ts @@ -0,0 +1,134 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable +var Stats = require('fs').Stats + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('symbolsType', 'AndroidJava'); +tmr.setInput('mappingTxtPath', '/test/path/to/mappings.txt'); + +process.env['BUILD_BUILDID'] = '2'; +process.env['BUILD_SOURCEBRANCH'] = 'refs/heads/master'; +process.env['BUILD_SOURCEVERSION'] = 'commitsha'; +process.env['LASTCOMMITMESSAGE'] = 'commit message'; + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/release_uploads/1", { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +//JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 +nock('https://example.test') + .patch("/my_release_location", JSON.stringify({ + status: "available", + release_notes: "my release notes", + mandatory_update: false, + destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + build: { + id: '2', + branch: 'master', + commit_hash: 'commitsha', + commit_message: 'commit message' + } + })) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: "AndroidJava" + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/symbol_uploads/100", { + status: 'committed' + }) + .reply(200); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + "checkPath" : { + "/test/path/to/my.ipa": true, + "/test/path/to/mappings.txt": true + }, + "findMatch" : { + "/test/path/to/mappings.txt": [ + "/test/path/to/mappings.txt" + ], + "/test/path/to/my.ipa": [ + "/test/path/to/my.ipa" + ] + } +}; +tmr.setAnswers(a); + +fs.createReadStream = (s: string) => { + let stream = new Readable; + stream.push(s); + stream.push(null); + + return stream; +}; + +fs.statSync = (s: string) => { + let stat = new Stats; + + stat.isFile = () => { + return !s.toLowerCase().endsWith(".dsym"); + } + stat.isDirectory = () => { + return s.toLowerCase().endsWith(".dsym"); + } + stat.size = 100; + + return stat; +} +tmr.registerMock('fs', fs); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_2.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_2.ts new file mode 100644 index 000000000000..95651e0515ca --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_2.ts @@ -0,0 +1,132 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable +var Stats = require('fs').Stats + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('symbolsType', 'AndroidJava'); +tmr.setInput('mappingTxtPath', '/test/path/to/mappings.txt'); + +process.env['BUILD_BUILDID'] = '2'; +process.env['BUILD_SOURCEBRANCH'] = 'refs/heads/master'; +process.env['BUILD_SOURCEVERSION'] = 'commitsha'; + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/release_uploads/1", { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +//JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 +nock('https://example.test') + .patch("/my_release_location", JSON.stringify({ + status: "available", + release_notes: "my release notes", + mandatory_update: false, + destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + build: { + id: '2', + branch: 'master', + commit_hash: 'commitsha' + } + })) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: "AndroidJava" + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/symbol_uploads/100", { + status: 'committed' + }) + .reply(200); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + "checkPath" : { + "/test/path/to/my.ipa": true, + "/test/path/to/mappings.txt": true + }, + "findMatch" : { + "/test/path/to/mappings.txt": [ + "/test/path/to/mappings.txt" + ], + "/test/path/to/my.ipa": [ + "/test/path/to/my.ipa" + ] + } +}; +tmr.setAnswers(a); + +fs.createReadStream = (s: string) => { + let stream = new Readable; + stream.push(s); + stream.push(null); + + return stream; +}; + +fs.statSync = (s: string) => { + let stat = new Stats; + + stat.isFile = () => { + return !s.toLowerCase().endsWith(".dsym"); + } + stat.isDirectory = () => { + return s.toLowerCase().endsWith(".dsym"); + } + stat.size = 100; + + return stat; +} +tmr.registerMock('fs', fs); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_3.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_3.ts new file mode 100644 index 000000000000..5d3921293038 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_3.ts @@ -0,0 +1,132 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable +var Stats = require('fs').Stats + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('symbolsType', 'AndroidJava'); +tmr.setInput('mappingTxtPath', '/test/path/to/mappings.txt'); + +process.env['BUILD_BUILDID'] = '2'; +process.env['BUILD_SOURCEBRANCH'] = 'refs/heads/feature/foobar'; +process.env['BUILD_SOURCEVERSION'] = 'commitsha'; + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/release_uploads/1", { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +//JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 +nock('https://example.test') + .patch("/my_release_location", JSON.stringify({ + status: "available", + release_notes: "my release notes", + mandatory_update: false, + destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + build: { + id: '2', + branch: 'feature/foobar', + commit_hash: 'commitsha' + } + })) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: "AndroidJava" + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/symbol_uploads/100", { + status: 'committed' + }) + .reply(200); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + "checkPath" : { + "/test/path/to/my.ipa": true, + "/test/path/to/mappings.txt": true + }, + "findMatch" : { + "/test/path/to/mappings.txt": [ + "/test/path/to/mappings.txt" + ], + "/test/path/to/my.ipa": [ + "/test/path/to/my.ipa" + ] + } +}; +tmr.setAnswers(a); + +fs.createReadStream = (s: string) => { + let stream = new Readable; + stream.push(s); + stream.push(null); + + return stream; +}; + +fs.statSync = (s: string) => { + let stat = new Stats; + + stat.isFile = () => { + return !s.toLowerCase().endsWith(".dsym"); + } + stat.isDirectory = () => { + return s.toLowerCase().endsWith(".dsym"); + } + stat.size = 100; + + return stat; +} +tmr.registerMock('fs', fs); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_4.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_4.ts new file mode 100644 index 000000000000..4401f9d988fc --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_4.ts @@ -0,0 +1,132 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable +var Stats = require('fs').Stats + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('symbolsType', 'AndroidJava'); +tmr.setInput('mappingTxtPath', '/test/path/to/mappings.txt'); + +process.env['BUILD_BUILDID'] = '2'; +process.env['BUILD_SOURCEBRANCH'] = '$/teamproject/main'; +process.env['BUILD_SOURCEVERSION'] = 'commitsha'; + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/release_uploads/1", { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +//JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 +nock('https://example.test') + .patch("/my_release_location", JSON.stringify({ + status: "available", + release_notes: "my release notes", + mandatory_update: false, + destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + build: { + id: '2', + branch: '$/teamproject/main', + commit_hash: 'commitsha' + } + })) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: "AndroidJava" + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/symbol_uploads/100", { + status: 'committed' + }) + .reply(200); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + "checkPath" : { + "/test/path/to/my.ipa": true, + "/test/path/to/mappings.txt": true + }, + "findMatch" : { + "/test/path/to/mappings.txt": [ + "/test/path/to/mappings.txt" + ], + "/test/path/to/my.ipa": [ + "/test/path/to/my.ipa" + ] + } +}; +tmr.setAnswers(a); + +fs.createReadStream = (s: string) => { + let stream = new Readable; + stream.push(s); + stream.push(null); + + return stream; +}; + +fs.statSync = (s: string) => { + let stat = new Stats; + + stat.isFile = () => { + return !s.toLowerCase().endsWith(".dsym"); + } + stat.isDirectory = () => { + return s.toLowerCase().endsWith(".dsym"); + } + stat.size = 100; + + return stat; +} +tmr.registerMock('fs', fs); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishMandatoryUpdate.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishMandatoryUpdate.ts new file mode 100644 index 000000000000..5333c12417a7 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishMandatoryUpdate.ts @@ -0,0 +1,133 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable +var Stats = require('fs').Stats + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('isMandatory', 'True'); +tmr.setInput('symbolsType', 'AndroidJava'); +tmr.setInput('mappingTxtPath', '/test/path/to/mappings.txt'); + +process.env['BUILD_BUILDID'] = '2'; +process.env['BUILD_SOURCEBRANCH'] = 'refs/heads/master'; +process.env['BUILD_SOURCEVERSION'] = 'commitsha'; + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/release_uploads/1", { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +//JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 +nock('https://example.test') + .patch("/my_release_location", JSON.stringify({ + status: "available", + release_notes: "my release notes", + mandatory_update: true, + destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + build: { + id: '2', + branch: 'master', + commit_hash: 'commitsha' + } + })) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: "AndroidJava" + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/symbol_uploads/100", { + status: 'committed' + }) + .reply(200); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + "checkPath" : { + "/test/path/to/my.ipa": true, + "/test/path/to/mappings.txt": true + }, + "findMatch" : { + "/test/path/to/mappings.txt": [ + "/test/path/to/mappings.txt" + ], + "/test/path/to/my.ipa": [ + "/test/path/to/my.ipa" + ] + } +}; +tmr.setAnswers(a); + +fs.createReadStream = (s: string) => { + let stream = new Readable; + stream.push(s); + stream.push(null); + + return stream; +}; + +fs.statSync = (s: string) => { + let stat = new Stats; + + stat.isFile = () => { + return !s.toLowerCase().endsWith(".dsym"); + } + stat.isDirectory = () => { + return s.toLowerCase().endsWith(".dsym"); + } + stat.size = 100; + + return stat; +} +tmr.registerMock('fs', fs); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishMultipleDestinations.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishMultipleDestinations.ts new file mode 100644 index 000000000000..40f70e4aebae --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishMultipleDestinations.ts @@ -0,0 +1,137 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable +var Stats = require('fs').Stats + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('isMandatory', 'True'); +tmr.setInput('destinationIds', '11111111-1111-1111-1111-111111111111,22222222-2222-2222-2222-222222222222; 33333333-3333-3333-3333-333333333333, 44444444-4444-4444-4444-444444444444;; '); +tmr.setInput('symbolsType', 'AndroidJava'); +tmr.setInput('mappingTxtPath', '/test/path/to/mappings.txt'); + +process.env['BUILD_BUILDID'] = '2'; +process.env['BUILD_SOURCEBRANCH'] = 'refs/heads/master'; +process.env['BUILD_SOURCEVERSION'] = 'commitsha'; + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/release_uploads/1", { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +//JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 +nock('https://example.test') + .patch("/my_release_location", JSON.stringify({ + status: "available", + release_notes: "my release notes", + mandatory_update: true, + destinations: [{ id: "11111111-1111-1111-1111-111111111111" }, + { id: "22222222-2222-2222-2222-222222222222" }, + { id: "33333333-3333-3333-3333-333333333333" }, + { id: "44444444-4444-4444-4444-444444444444" }], + build: { + id: '2', + branch: 'master', + commit_hash: 'commitsha' + } + })) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: "AndroidJava" + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/symbol_uploads/100", { + status: 'committed' + }) + .reply(200); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + "checkPath" : { + "/test/path/to/my.ipa": true, + "/test/path/to/mappings.txt": true + }, + "findMatch" : { + "/test/path/to/mappings.txt": [ + "/test/path/to/mappings.txt" + ], + "/test/path/to/my.ipa": [ + "/test/path/to/my.ipa" + ] + } +}; +tmr.setAnswers(a); + +fs.createReadStream = (s: string) => { + let stream = new Readable; + stream.push(s); + stream.push(null); + + return stream; +}; + +fs.statSync = (s: string) => { + let stat = new Stats; + + stat.isFile = () => { + return !s.toLowerCase().endsWith(".dsym"); + } + stat.isDirectory = () => { + return s.toLowerCase().endsWith(".dsym"); + } + stat.size = 100; + + return stat; +} +tmr.registerMock('fs', fs); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0SymIncludeParent.ts b/Tasks/AppCenterDistributeV3/Tests/L0SymIncludeParent.ts new file mode 100644 index 000000000000..6c6a92cc4854 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0SymIncludeParent.ts @@ -0,0 +1,172 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable +var Writable = require('stream').Writable +var Stats = require('fs').Stats + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('symbolsType', 'AndroidJava'); +tmr.setInput('mappingTxtPath', '/test/path/to/mappings.txt'); +tmr.setInput('packParentFolder', 'true'); + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch('/v0.1/apps/testuser/testapp/release_uploads/1', { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +nock('https://example.test') + .patch('/my_release_location', { + status: 'available', + destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + release_notes: 'my release notes' + }) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: 'AndroidJava' + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch('/v0.1/apps/testuser/testapp/symbol_uploads/100', { + status: 'committed' + }) + .reply(200); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + 'checkPath' : { + '/test/path/to/my.ipa': true, + '/test/path/to/mappings.txt': true, + '/test/path/to': true, + '/test/path/to/f1.txt': true, + '/test/path/to/f2.txt': true, + '/test/path/to/folder': true, + '/test/path/to/folder/f11.txt': true, + '/test/path/to/folder/f12.txt': true + }, + 'findMatch' : { + '/test/path/to/mappings.txt': [ + '/test/path/to/mappings.txt' + ], + '/test/path/to/my.ipa': [ + '/test/path/to/my.ipa' + ] + } +}; +tmr.setAnswers(a); + +fs.createReadStream = (s: string) => { + let stream = new Readable; + stream.push(s); + stream.push(null); + + return stream; +}; + +fs.createWriteStream = (s: string) => { + let stream = new Writable; + + stream.write = () => {}; + + return stream; +}; + +fs.readdirSync = (folder: string) => { + let files: string[] = []; + + if (folder === '/test/path/to') { + files = [ + 'mappings.txt', + 'f1.txt', + 'f2.txt', + 'folder' + ] + } else if (folder === '/test/path/to/folder') { + files = [ + 'f11.txt', + 'f12.txt' + ] + } + + return files; +}; + +fs.statSync = (s: string) => { + let stat = new Stats; +// s = s.replace("\\", "/"); + + stat.isFile = () => { + if (s === '/test/path/to') { + return false; + } else if (s === '/test/path/to/folder') { + return false; + } else { + return true; + } + } + + stat.isDirectory = () => { + if (s === '/test/path/to') { + return true; + } else if (s === '/test/path/to/folder') { + return true; + } else { + return false; + } + } + + stat.size = 100; + + return stat; +} +tmr.registerMock('fs', fs); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_flat_1.ts b/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_flat_1.ts new file mode 100644 index 000000000000..acd238a7844d --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_flat_1.ts @@ -0,0 +1,208 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable +var Writable = require('stream').Writable +var Stats = require('fs').Stats + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('symbolsType', 'Apple'); +tmr.setInput('dsymPath', 'a/b/c/(x|y).dsym'); + +/* + dSyms folder structure: + a + f.txt + b + f.txt + c + d + f.txt + f.txt + x.dsym + x1.txt + x2.txt + y.dsym + y1.txt +*/ + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch('/v0.1/apps/testuser/testapp/release_uploads/1', { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +nock('https://example.test') + .patch('/my_release_location', { + status: 'available', + destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + release_notes: 'my release notes' + }) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: 'Apple' + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch('/v0.1/apps/testuser/testapp/symbol_uploads/100', { + status: 'committed' + }) + .reply(200); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + 'checkPath' : { + '/test/path/to/my.ipa': true, + 'a': true, + 'a/f.txt': true, + 'a/b': true, + 'a/b/f.txt': true, + 'a/b/c': true, + 'a/b/c/f.txt': true, + 'a/b/c/d': true, + 'a/b/c/d/f.txt': true, + 'a/b/c/x.dsym': true, + 'a/b/c/x.dsym/x1.txt': true, + 'a/b/c/x.dsym/x2.txt': true, + 'a/b/c/y.dsym': true, + 'a/b/c/y.dsym/y1.txt': true + }, + 'findMatch' : { + 'a/b/c/(x|y).dsym': [ + 'a/b/c/x.dsym', + 'a/b/c/y.dsym' + ], + '/test/path/to/my.ipa': [ + '/test/path/to/my.ipa' + ] + } +}; +tmr.setAnswers(a); + +fs.createReadStream = (s: string) => { + let stream = new Readable; + stream.push(s); + stream.push(null); + + return stream; +}; + +fs.createWriteStream = (s: string) => { + let stream = new Writable; + + stream.write = () => {}; + + return stream; +}; + +fs.readdirSync = (folder: string) => { + let files: string[] = []; + + if (folder === 'a') { + files = [ + 'f.txt', + 'b' + ] + } else if (folder === 'a/b') { + files = [ + 'f.txt', + 'c' + ] + } else if (folder === 'a/b/c') { + files = [ + 'f.txt', + 'd', + 'x.dsym', + 'y.dsym' + ] + } else if (folder === 'a/b/c/d') { + files = [ + 'f.txt' + ] + } else if (folder === 'a/b/c/x.dsym') { + files = [ + 'x1.txt', + 'x2.txt' + ] + } else if (folder === 'a/b/c/y.dsym') { + files = [ + 'y1.txt' + ] + } + + return files; +}; + +fs.statSync = (s: string) => { + let stat = new Stats; + + stat.isFile = () => { + if (s.endsWith('.txt')) { + return true; + } else { + return false; + } + } + + stat.isDirectory = () => { + if (s.endsWith('.txt')) { + return false; + } else { + return true; + } + } + + stat.size = 100; + + return stat; +} +tmr.registerMock('fs', fs); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_flat_2.ts b/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_flat_2.ts new file mode 100644 index 000000000000..7a6c71cab772 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_flat_2.ts @@ -0,0 +1,218 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable +var Writable = require('stream').Writable +var Stats = require('fs').Stats + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('symbolsType', 'Apple'); +tmr.setInput('dsymPath', 'a/**/(x|y).dsym'); + +/* + dSyms folder structure: + a + f.txt + b + f.txt + c + d + f.txt + f.txt + x.dsym + x1.txt + x2.txt + d + f.txt + y.dsym + y1.txt +*/ + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch('/v0.1/apps/testuser/testapp/release_uploads/1', { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +nock('https://example.test') + .patch('/my_release_location', { + status: 'available', + destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + release_notes: 'my release notes' + }) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: 'Apple' + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch('/v0.1/apps/testuser/testapp/symbol_uploads/100', { + status: 'committed' + }) + .reply(200); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + 'checkPath' : { + '/test/path/to/my.ipa': true, + 'a': true, + 'a/f.txt': true, + 'a/b': true, + 'a/b/f.txt': true, + 'a/b/c': true, + 'a/b/c/f.txt': true, + 'a/b/c/d': true, + 'a/b/c/d/f.txt': true, + 'a/b/c/x.dsym': true, + 'a/b/c/x.dsym/x1.txt': true, + 'a/b/c/x.dsym/x2.txt': true, + 'a/b/d': true, + 'a/b/d/f.txt': true, + 'a/b/d/y.dsym': true, + 'a/b/d/y.dsym/y1.txt': true + }, + 'findMatch' : { + 'a/**/(x|y).dsym': [ + 'a/b/c/x.dsym', + 'a/b/d/y.dsym' + ], + '/test/path/to/my.ipa': [ + '/test/path/to/my.ipa' + ] + } +}; +tmr.setAnswers(a); + +fs.createReadStream = (s: string) => { + let stream = new Readable; + stream.push(s); + stream.push(null); + + return stream; +}; + +fs.createWriteStream = (s: string) => { + let stream = new Writable; + + stream.write = () => {}; + + return stream; +}; + +fs.readdirSync = (folder: string) => { + let files: string[] = []; + + if (folder === 'a') { + files = [ + 'f.txt', + 'b' + ] + } else if (folder === 'a/b') { + files = [ + 'f.txt', + 'c', + 'd' + ] + } else if (folder === 'a/b/c') { + files = [ + 'f.txt', + 'd', + 'x.dsym', + 'y.dsym' + ] + } else if (folder === 'a/b/c/d') { + files = [ + 'f.txt' + ] + } else if (folder === 'a/b/c/x.dsym') { + files = [ + 'x1.txt', + 'x2.txt' + ] + } else if (folder === 'a/b/d') { + files = [ + 'f.txt', + 'y.dsym' + ] + } else if (folder === 'a/b/d/y.dsym') { + files = [ + 'y1.txt' + ] + } + + return files; +}; + +fs.statSync = (s: string) => { + let stat = new Stats; + + stat.isFile = () => { + if (s.endsWith('.txt')) { + return true; + } else { + return false; + } + } + + stat.isDirectory = () => { + if (s.endsWith('.txt')) { + return false; + } else { + return true; + } + } + + stat.size = 100; + + return stat; +} +tmr.registerMock('fs', fs); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_single.ts b/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_single.ts new file mode 100644 index 000000000000..a514f8ac2f1b --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_single.ts @@ -0,0 +1,199 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable +var Writable = require('stream').Writable +var Stats = require('fs').Stats + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('symbolsType', 'Apple'); +tmr.setInput('dsymPath', 'a/**/*.dsym'); + +/* + dSyms folder structure: + a + f.txt + b + f.txt + c + d + f.txt + f.txt + x.dsym + x1.txt + x2.txt +*/ + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch('/v0.1/apps/testuser/testapp/release_uploads/1', { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +nock('https://example.test') + .patch('/my_release_location', { + status: 'available', + destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + release_notes: 'my release notes' + }) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: 'Apple' + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch('/v0.1/apps/testuser/testapp/symbol_uploads/100', { + status: 'committed' + }) + .reply(200); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + 'checkPath' : { + '/test/path/to/my.ipa': true, + 'a': true, + 'a/f.txt': true, + 'a/b': true, + 'a/b/f.txt': true, + 'a/b/c': true, + 'a/b/c/f.txt': true, + 'a/b/c/d': true, + 'a/b/c/d/f.txt': true, + 'a/b/c/x.dsym': true, + 'a/b/c/x.dsym/x1.txt': true, + 'a/b/c/x.dsym/x2.txt': true + }, + 'findMatch' : { + 'a/**/*.dsym': [ + 'a/b/c/x.dsym' + ], + '/test/path/to/my.ipa': [ + '/test/path/to/my.ipa' + ] + } +}; +tmr.setAnswers(a); + +fs.createReadStream = (s: string) => { + let stream = new Readable; + stream.push(s); + stream.push(null); + + return stream; +}; + +fs.createWriteStream = (s: string) => { + let stream = new Writable; + + stream.write = () => {}; + + return stream; +}; + +fs.readdirSync = (folder: string) => { + let files: string[] = []; + + if (folder === 'a') { + files = [ + 'f.txt', + 'b' + ] + } else if (folder === 'a/b') { + files = [ + 'f.txt', + 'c', + 'd' + ] + } else if (folder === 'a/b/c') { + files = [ + 'f.txt', + 'd', + 'x.dsym' + ] + } else if (folder === 'a/b/c/x.dsym') { + files = [ + 'x1.txt', + 'x2.txt' + ] + } else if (folder === 'a/b/c/d') { + files = [ + 'f.txt' + ] + } + + return files; +}; + +fs.statSync = (s: string) => { + let stat = new Stats; + + stat.isFile = () => { + if (s.endsWith('.txt')) { + return true; + } else { + return false; + } + } + + stat.isDirectory = () => { + if (s.endsWith('.txt')) { + return false; + } else { + return true; + } + } + + stat.size = 100; + + return stat; +} +tmr.registerMock('fs', fs); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_tree.ts b/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_tree.ts new file mode 100644 index 000000000000..a84e3f334f0a --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_tree.ts @@ -0,0 +1,232 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable +var Writable = require('stream').Writable +var Stats = require('fs').Stats + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('symbolsType', 'Apple'); +tmr.setInput('dsymPath', 'a/**/(x|y).dsym'); + +/* + dSyms folder structure: + a + f.txt + b + f.txt + c + d + f.txt + f.txt + x.dsym + x1.txt + x2.txt + d + f.txt + e + f.txt + f + f.txt + y.dsym + y1.txt +*/ + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch('/v0.1/apps/testuser/testapp/release_uploads/1', { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +nock('https://example.test') + .patch('/my_release_location', { + status: 'available', + destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + release_notes: 'my release notes' + }) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: 'Apple' + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch('/v0.1/apps/testuser/testapp/symbol_uploads/100', { + status: 'committed' + }) + .reply(200); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + 'checkPath' : { + '/test/path/to/my.ipa': true, + 'a': true, + 'a/f.txt': true, + 'a/b': true, + 'a/b/f.txt': true, + 'a/b/c': true, + 'a/b/c/f.txt': true, + 'a/b/c/d': true, + 'a/b/c/d/f.txt': true, + 'a/b/c/x.dsym': true, + 'a/b/c/x.dsym/x1.txt': true, + 'a/b/c/x.dsym/x2.txt': true, + 'a/b/d/f.txt': true, + 'a/b/d': true, + 'a/b/d/e': true, + 'a/b/d/e/f.txt': true, + 'a/b/d/e/f': true, + 'a/b/d/e/f/f.txt': true, + 'a/b/d/e/f/y.dsym': true, + 'a/b/d/e/f/y.dsym/y1.txt': true + }, + 'findMatch' : { + 'a/**/(x|y).dsym': [ + 'a/b/c/x.dsym', + 'a/b/d/e/f/y.dsym' + ], + '/test/path/to/my.ipa': [ + '/test/path/to/my.ipa' + ] + } +}; +tmr.setAnswers(a); + +fs.createReadStream = (s: string) => { + let stream = new Readable; + stream.push(s); + stream.push(null); + + return stream; +}; + +fs.createWriteStream = (s: string) => { + let stream = new Writable; + + stream.write = () => {}; + + return stream; +}; + +fs.readdirSync = (folder: string) => { + let files: string[] = []; + + if (folder === 'a') { + files = [ + 'f.txt', + 'b' + ] + } else if (folder === 'a/b') { + files = [ + 'f.txt', + 'c', + 'd' + ] + } else if (folder === 'a/b/c') { + files = [ + 'f.txt', + 'd', + 'x.dsym', + 'y.dsym' + ] + } else if (folder === 'a/b/c/x.dsym') { + files = [ + 'x1.txt', + 'x2.txt' + ] + } else if (folder === 'a/b/c/d') { + files = [ + 'f.txt', + 'e' + ] + } else if (folder === 'a/b/c/d/e') { + files = [ + 'f.txt', + 'f' + ] + } else if (folder === 'a/b/d/e/f') { + files = [ + 'f.txt', + 'y.dsym' + ] + } else if (folder === 'a/b/d/e/f/y.dsym') { + files = [ + 'y1.txt' + ] + } + + return files; +}; + +fs.statSync = (s: string) => { + let stat = new Stats; + + stat.isFile = () => { + if (s.endsWith('.txt')) { + return true; + } else { + return false; + } + } + + stat.isDirectory = () => { + if (s.endsWith('.txt')) { + return false; + } else { + return true; + } + } + + stat.size = 100; + + return stat; +} +tmr.registerMock('fs', fs); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0SymPDBs_multiple.ts b/Tasks/AppCenterDistributeV3/Tests/L0SymPDBs_multiple.ts new file mode 100644 index 000000000000..43f0c385359c --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0SymPDBs_multiple.ts @@ -0,0 +1,196 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable +var Writable = require('stream').Writable +var Stats = require('fs').Stats + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('symbolsType', 'UWP'); +tmr.setInput('pdbPath', 'a/**/*.pdb'); + +/* + dSyms folder structure: + a + f.txt + b + f.txt + c + d + f.txt + y.pdb + x.pdb + z.pdb +*/ + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch('/v0.1/apps/testuser/testapp/release_uploads/1', { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +nock('https://example.test') + .patch('/my_release_location', { + status: 'available', + destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + release_notes: 'my release notes' + }) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: 'UWP' + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch('/v0.1/apps/testuser/testapp/symbol_uploads/100', { + status: 'committed' + }) + .reply(200); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + 'checkPath' : { + '/test/path/to/my.ipa': true, + 'a': true, + 'a/f.txt': true, + 'a/b': true, + 'a/b/f.txt': true, + 'a/b/c': true, + 'a/b/c/f.txt': true, + 'a/b/c/d': true, + 'a/b/c/d/f.txt': true, + 'a/b/c/x.pdb': true, + 'a/b/c/y.pdb': true, + 'a/b/c/z.pdb': true + }, + 'findMatch' : { + 'a/**/*.pdb': [ + 'a/b/c/x.pdb', + 'a/b/c/y.pdb', + 'a/b/c/z.pdb' + ], + '/test/path/to/my.ipa': [ + '/test/path/to/my.ipa' + ] + } +}; +tmr.setAnswers(a); + +fs.createReadStream = (s: string) => { + let stream = new Readable; + stream.push(s); + stream.push(null); + + return stream; +}; + +fs.createWriteStream = (s: string) => { + let stream = new Writable; + + stream.write = () => {}; + + return stream; +}; + +fs.readdirSync = (folder: string) => { + let files: string[] = []; + + if (folder === 'a') { + files = [ + 'f.txt', + 'b' + ] + } else if (folder === 'a/b') { + files = [ + 'f.txt', + 'c', + 'd' + ] + } else if (folder === 'a/b/c') { + files = [ + 'd', + 'x.pdb', + 'y.pdb', + 'z.pdb' + ] + } else if (folder === 'a/b/c/d') { + files = [ + 'f.txt' + ] + } + + return files; +}; + +fs.statSync = (s: string) => { + let stat = new Stats; + + stat.isFile = () => { + if (s.endsWith('.txt') || s.endsWith('.pdb')) { + return true; + } else { + return false; + } + } + + stat.isDirectory = () => { + if (s.endsWith('.txt') || s.endsWith('.pdb')) { + return false; + } else { + return true; + } + } + + stat.size = 100; + + return stat; +} +tmr.registerMock('fs', fs); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0SymPDBs_single.ts b/Tasks/AppCenterDistributeV3/Tests/L0SymPDBs_single.ts new file mode 100644 index 000000000000..6d7508d6bfb3 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0SymPDBs_single.ts @@ -0,0 +1,190 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable +var Writable = require('stream').Writable +var Stats = require('fs').Stats + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('symbolsType', 'UWP'); +tmr.setInput('pdbPath', 'a/**/*.pdb'); + +/* + dSyms folder structure: + a + f.txt + b + f.txt + c + d + f.txt + f.txt + x.pdb +*/ + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch('/v0.1/apps/testuser/testapp/release_uploads/1', { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +nock('https://example.test') + .patch('/my_release_location', { + status: 'available', + destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + release_notes: 'my release notes' + }) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: 'UWP' + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch('/v0.1/apps/testuser/testapp/symbol_uploads/100', { + status: 'committed' + }) + .reply(200); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + 'checkPath' : { + '/test/path/to/my.ipa': true, + 'a': true, + 'a/f.txt': true, + 'a/b': true, + 'a/b/f.txt': true, + 'a/b/c': true, + 'a/b/c/f.txt': true, + 'a/b/c/d': true, + 'a/b/c/d/f.txt': true, + 'a/b/c/x.pdb': true + }, + 'findMatch' : { + 'a/**/*.pdb': [ + 'a/b/c/x.pdb' + ], + '/test/path/to/my.ipa': [ + '/test/path/to/my.ipa' + ] + } +}; +tmr.setAnswers(a); + +fs.createReadStream = (s: string) => { + let stream = new Readable; + stream.push(s); + stream.push(null); + + return stream; +}; + +fs.createWriteStream = (s: string) => { + let stream = new Writable; + + stream.write = () => {}; + + return stream; +}; + +fs.readdirSync = (folder: string) => { + let files: string[] = []; + + if (folder === 'a') { + files = [ + 'f.txt', + 'b' + ] + } else if (folder === 'a/b') { + files = [ + 'f.txt', + 'c', + 'd' + ] + } else if (folder === 'a/b/c') { + files = [ + 'f.txt', + 'd', + 'x.pdb' + ] + } else if (folder === 'a/b/c/d') { + files = [ + 'f.txt' + ] + } + + return files; +}; + +fs.statSync = (s: string) => { + let stat = new Stats; + + stat.isFile = () => { + if (s.endsWith('.txt') || s.endsWith('.pdb')) { + return true; + } else { + return false; + } + } + + stat.isDirectory = () => { + if (s.endsWith('.txt') || s.endsWith('.pdb')) { + return false; + } else { + return true; + } + } + + stat.size = 100; + + return stat; +} +tmr.registerMock('fs', fs); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/package-lock.json b/Tasks/AppCenterDistributeV3/Tests/package-lock.json new file mode 100644 index 000000000000..39a39411a49b --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/package-lock.json @@ -0,0 +1,124 @@ +{ + "name": "vsts-tasks-appcenterdistribute", + "version": "1.0.0", + "lockfileVersion": 1, + "requires": true, + "dependencies": { + "assertion-error": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-1.1.0.tgz", + "integrity": "sha512-jgsaNduz+ndvGyFt3uSuWqvy4lCnIJiovtouQN5JZHOKCS2QuhEdbcQHFhVksz2N2U9hXJo8odG7ETyWlEeuDw==", + "dev": true + }, + "chai": { + "version": "3.5.0", + "resolved": "https://registry.npmjs.org/chai/-/chai-3.5.0.tgz", + "integrity": "sha1-TQJjewZ/6Vi9v906QOxW/vc3Mkc=", + "dev": true, + "requires": { + "assertion-error": "^1.0.1", + "deep-eql": "^0.1.3", + "type-detect": "^1.0.0" + } + }, + "debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "dev": true, + "requires": { + "ms": "2.0.0" + } + }, + "deep-eql": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/deep-eql/-/deep-eql-0.1.3.tgz", + "integrity": "sha1-71WKyrjeJSBs1xOQbXTlaTDrafI=", + "dev": true, + "requires": { + "type-detect": "0.1.1" + }, + "dependencies": { + "type-detect": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-0.1.1.tgz", + "integrity": "sha1-C6XsKohWQORw6k6FBZcZANrFiCI=", + "dev": true + } + } + }, + "deep-equal": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/deep-equal/-/deep-equal-1.0.1.tgz", + "integrity": "sha1-9dJgKStmDghO/0zbyfCK0yR0SLU=", + "dev": true + }, + "json-stringify-safe": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz", + "integrity": "sha1-Epai1Y/UXxmg9s4B1lcB4sc1tus=", + "dev": true + }, + "lodash": { + "version": "4.9.0", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.9.0.tgz", + "integrity": "sha1-TCDXQvA86F3HAODderm8q4Xm/BQ=", + "dev": true + }, + "minimist": { + "version": "0.0.8", + "resolved": "https://registry.npmjs.org/minimist/-/minimist-0.0.8.tgz", + "integrity": "sha1-hX/Kv8M5fSYluCKCYuhqp6ARsF0=", + "dev": true + }, + "mkdirp": { + "version": "0.5.1", + "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.1.tgz", + "integrity": "sha1-MAV0OOrGz3+MR2fzhkjWaX11yQM=", + "dev": true, + "requires": { + "minimist": "0.0.8" + } + }, + "ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha1-VgiurfwAvmwpAd9fmGF4jeDVl8g=", + "dev": true + }, + "nock": { + "version": "9.0.2", + "resolved": "https://registry.npmjs.org/nock/-/nock-9.0.2.tgz", + "integrity": "sha1-9qX0qNVg1h9Ita1CjM/43JticB4=", + "dev": true, + "requires": { + "chai": ">=1.9.2 <4.0.0", + "debug": "^2.2.0", + "deep-equal": "^1.0.0", + "json-stringify-safe": "^5.0.1", + "lodash": "~4.9.0", + "mkdirp": "^0.5.0", + "propagate": "0.4.0", + "qs": "^6.0.2" + } + }, + "propagate": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/propagate/-/propagate-0.4.0.tgz", + "integrity": "sha1-8/zKCm/gZzanulcpZgaWF8EwtIE=", + "dev": true + }, + "qs": { + "version": "6.5.1", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.5.1.tgz", + "integrity": "sha512-eRzhrN1WSINYCDCbrz796z37LOe3m5tmW7RQf6oBntukAG1nmovJvhnwHHRMAfeoItc1m2Hk02WER2aQ/iqs+A==", + "dev": true + }, + "type-detect": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-1.0.0.tgz", + "integrity": "sha1-diIXzAbbJY7EiQihKY6LlRIejqI=", + "dev": true + } + } +} diff --git a/Tasks/AppCenterDistributeV3/Tests/package.json b/Tasks/AppCenterDistributeV3/Tests/package.json new file mode 100644 index 000000000000..5dd9fc888d87 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/package.json @@ -0,0 +1,22 @@ +{ + "name": "vsts-tasks-appcenterdistribute", + "version": "1.0.0", + "description": "Visual Studio App Center Upload Task", + "main": "appcenterdistribute.js", + "scripts": { + "test": "echo \"Error: no test specified\" && exit 1" + }, + "repository": { + "type": "git", + "url": "git+https://github.com/Microsoft/azure-pipelines-tasks.git" + }, + "author": "Microsoft Corporation", + "license": "MIT", + "bugs": { + "url": "https://github.com/Microsoft/azure-pipelines-tasks/issues" + }, + "homepage": "https://github.com/Microsoft/azure-pipelines-tasks", + "devDependencies": { + "nock": "9.0.2" + } +} diff --git a/Tasks/AppCenterDistributeV3/appcenterdistribute.ts b/Tasks/AppCenterDistributeV3/appcenterdistribute.ts new file mode 100644 index 000000000000..fbd814c6c6e4 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/appcenterdistribute.ts @@ -0,0 +1,492 @@ +import path = require('path'); +import tl = require('vsts-task-lib/task'); +import request = require('request'); +import Q = require('q'); +import fs = require('fs'); +import os = require('os'); + +import { ToolRunner } from 'vsts-task-lib/toolrunner'; + +import utils = require('./utils'); + +class UploadInfo { + upload_id: string; + upload_url: string; +} + +class SymbolsUploadInfo { + symbol_upload_id: string; + upload_url: string; + expiration_date: string; +} + +function getEndpointDetails(endpointInputFieldName) { + var errorMessage = tl.loc("CannotDecodeEndpoint"); + var endpoint = tl.getInput(endpointInputFieldName, true); + + if (!endpoint) { + throw new Error(errorMessage); + } + + let url = tl.getEndpointUrl(endpoint, false); + let apiServer = url.substr(0, url.lastIndexOf('/')); + let apiVersion = url.substr(url.lastIndexOf('/') + 1); + let authToken = tl.getEndpointAuthorizationParameter(endpoint, 'apitoken', false); + + return { + apiServer: apiServer, + apiVersion: apiVersion, + authToken: authToken + }; +} + +function responseHandler(defer, err, res, body, handler: () => void) { + if (body) { + tl.debug(`---- ${JSON.stringify(body)}`); + } + + if (err) { + tl.debug(`---- Failed with error: ${err}`); + defer.reject(err); + return; + } + + if (!res) { + defer.reject(tl.loc("NoResponseFromServer")); + return; + } + + tl.debug(`---- http call status code: ${res.statusCode}`); + if (res.statusCode < 200 || res.statusCode >= 300) { + let message = JSON.stringify(body); + if (!message) { + message = `http response code: ${res.statusCode}`; + } else { + message = message.concat(os.EOL + `http response code: ${res.statusCode}`); + } + defer.reject(message); + return; + } + + handler(); +} + +function beginReleaseUpload(apiServer: string, apiVersion: string, appSlug: string, token: string, userAgent: string): Q.Promise { + tl.debug("-- Prepare for uploading release."); + let defer = Q.defer(); + let beginUploadUrl: string = `${apiServer}/${apiVersion}/apps/${appSlug}/release_uploads`; + tl.debug(`---- url: ${beginUploadUrl}`); + + let headers = { + "Content-Type": "application/json", + "X-API-Token": token, + "User-Agent": userAgent, + "internal-request-source": "VSTS" + }; + request.post({ url: beginUploadUrl, headers: headers }, (err, res, body) => { + responseHandler(defer, err, res, body, () => { + let response = JSON.parse(body); + let uploadInfo: UploadInfo = { + upload_id: response['upload_id'], + upload_url: response['upload_url'] + } + + defer.resolve(uploadInfo); + }); + }); + + return defer.promise; +} + +function uploadRelease(uploadUrl: string, file: string, userAgent: string): Q.Promise { + tl.debug("-- Uploading release..."); + let defer = Q.defer(); + tl.debug(`---- url: ${uploadUrl}`); + let headers = { + "User-Agent": userAgent, + "internal-request-source": "VSTS" + }; + let req = request.post({ url: uploadUrl, headers: headers }, (err, res, body) => { + responseHandler(defer, err, res, body, () => { + tl.debug('-- File uploaded.'); + defer.resolve(); + }); + }); + + let form = req.form(); + form.append('ipa', fs.createReadStream(file)); + + return defer.promise; +} + +function commitRelease(apiServer: string, apiVersion: string, appSlug: string, upload_id: string, token: string, userAgent: string): Q.Promise { + tl.debug("-- Finishing uploading release..."); + let defer = Q.defer(); + let commitReleaseUrl: string = `${apiServer}/${apiVersion}/apps/${appSlug}/release_uploads/${upload_id}`; + tl.debug(`---- url: ${commitReleaseUrl}`); + let headers = { + "X-API-Token": token, + "User-Agent": userAgent, + "internal-request-source": "VSTS" + }; + + let commitBody = { "status": "committed" }; + + request.patch({ url: commitReleaseUrl, headers: headers, json: commitBody }, (err, res, body) => { + responseHandler(defer, err, res, body, () => { + if (body && body['release_url']) { + defer.resolve(body['release_url']); + } else { + defer.reject(tl.loc("FailedToUploadFile")); + } + }); + }) + + return defer.promise; +} + +function publishRelease(apiServer: string, releaseUrl: string, isMandatory: boolean, releaseNotes: string, destinationIds: string[], token: string, userAgent: string) { + tl.debug("-- Mark package available."); + let defer = Q.defer(); + let publishReleaseUrl: string = `${apiServer}/${releaseUrl}`; + tl.debug(`---- url: ${publishReleaseUrl}`); + + let headers = { + "X-API-Token": token, + "User-Agent": userAgent, + "internal-request-source": "VSTS" + }; + const destinations = destinationIds.map(id => { return { "id": id }; }); + let publishBody = { + "status": "available", + "release_notes": releaseNotes, + "mandatory_update": isMandatory, + "destinations": destinations + }; + + let branchName = process.env['BUILD_SOURCEBRANCH']; + branchName = getBranchName(branchName); + const sourceVersion = process.env['BUILD_SOURCEVERSION']; + const buildId = process.env['BUILD_BUILDID']; + + // Builds started by App Center has the commit message set when distribution is enabled + const commitMessage = process.env['LASTCOMMITMESSAGE']; + // Updating the internal_request_source to distinguish the AppCenter triggered build and custom build + if (!!commitMessage) { + headers["internal-request-source"] = "VSTS-APPCENTER"; + } + + // Including these information for distribution notification to have additional context + // Commit message is optional + if (branchName && sourceVersion) { + const build = { + id: buildId, + branch: branchName, + commit_hash: sourceVersion + } + + if (commitMessage) { + build['commit_message'] = commitMessage; + } + + publishBody = Object.assign(publishBody, { build: build }); + } + + request.patch({ url: publishReleaseUrl, headers: headers, json: publishBody }, (err, res, body) => { + responseHandler(defer, err, res, body, () => { + defer.resolve(); + }); + }) + + return defer.promise; +} + +function getBranchName(ref: string): string { + const gitRefsHeadsPrefix = 'refs/heads/'; + if (ref) { + return ref.indexOf(gitRefsHeadsPrefix) === 0 ? ref.substr(gitRefsHeadsPrefix.length) : ref; + } +} + +/** + * If the input is a single file, upload this file without any processing. + * If the input is a single folder, zip it's content. The archive name is the folder's name + * If the input is a set of folders or files, zip them so they appear on the root of the archive. The archive name is the parent folder's name. + */ +function prepareSymbols(symbolsPaths: string[]): Q.Promise { + tl.debug("-- Prepare symbols"); + let defer = Q.defer(); + + if (symbolsPaths.length === 1 && fs.statSync(symbolsPaths[0]).isFile()) { + tl.debug(`.. a single symbols file: ${symbolsPaths[0]}`) + + // single file - Android source mapping txt file + defer.resolve(symbolsPaths[0]); + } else if (symbolsPaths.length > 0) { + tl.debug(`.. archiving: ${symbolsPaths}`); + + let symbolsRoot = utils.findCommonParent(symbolsPaths); + let zipPath = utils.getArchivePath(symbolsRoot); + let zipStream = utils.createZipStream(symbolsPaths, symbolsRoot); + + utils.createZipFile(zipStream, zipPath). + then(() => { + tl.debug(`---- symbols arechive file: ${zipPath}`) + defer.resolve(zipPath); + }); + } else { + defer.resolve(null); + } + + + return defer.promise; +} + +function beginSymbolUpload(apiServer: string, apiVersion: string, appSlug: string, symbol_type: string, token: string, userAgent: string): Q.Promise { + tl.debug("-- Begin symbols upload") + let defer = Q.defer(); + + let beginSymbolUploadUrl: string = `${apiServer}/${apiVersion}/apps/${appSlug}/symbol_uploads`; + tl.debug(`---- url: ${beginSymbolUploadUrl}`); + + let headers = { + "X-API-Token": token, + "User-Agent": userAgent, + "internal-request-source": "VSTS" + }; + + let symbolsUploadBody = { "symbol_type": symbol_type }; + + request.post({ url: beginSymbolUploadUrl, headers: headers, json: symbolsUploadBody }, (err, res, body) => { + responseHandler(defer, err, res, body, () => { + let symbolsUploadInfo: SymbolsUploadInfo = { + symbol_upload_id: body['symbol_upload_id'], + upload_url: body['upload_url'], + expiration_date: body['expiration_date'] + } + + defer.resolve(symbolsUploadInfo); + }); + }) + + return defer.promise; +} + +function uploadSymbols(uploadUrl: string, file: string, userAgent: string): Q.Promise { + tl.debug("-- Uploading symbols..."); + let defer = Q.defer(); + tl.debug(`---- url: ${uploadUrl}`); + + let stat = fs.statSync(file); + let headers = { + "x-ms-blob-type": "BlockBlob", + "Content-Length": stat.size, + "User-Agent": userAgent, + "internal-request-source": "VSTS" + }; + + fs.createReadStream(file).pipe(request.put({ url: uploadUrl, headers: headers }, (err, res, body) => { + responseHandler(defer, err, res, body, () => { + tl.debug('-- Symbol uploaded.'); + defer.resolve(); + }); + })); + + return defer.promise; +} + +function commitSymbols(apiServer: string, apiVersion: string, appSlug: string, symbol_upload_id: string, token: string, userAgent: string): Q.Promise { + tl.debug("-- Finishing uploading symbols..."); + let defer = Q.defer(); + let commitSymbolsUrl: string = `${apiServer}/${apiVersion}/apps/${appSlug}/symbol_uploads/${symbol_upload_id}`; + tl.debug(`---- url: ${commitSymbolsUrl}`); + let headers = { + "X-API-Token": token, + "User-Agent": userAgent, + "internal-request-source": "VSTS" + }; + + let commitBody = { "status": "committed" }; + + request.patch({ url: commitSymbolsUrl, headers: headers, json: commitBody }, (err, res, body) => { + responseHandler(defer, err, res, body, () => { + defer.resolve(); + }); + }) + + return defer.promise; +} + +function expandSymbolsPaths(symbolsType: string, pattern: string, continueOnError: boolean, packParentFolder: boolean): string[] { + tl.debug("-- Expanding symbols path pattern to a list of paths"); + + let symbolsPaths: string[] = []; + + if (symbolsType === "Apple") { + // User can specifay a symbols path pattern that selects + // multiple dSYM folder paths for Apple application. + let dsymPaths = utils.resolvePaths(pattern, continueOnError, packParentFolder); + + // Resolved paths can be null if continueIfSymbolsNotFound is true and the file/folder does not exist. + if (dsymPaths) { + dsymPaths.forEach(dsymFolder => { + if (dsymFolder) { + let folderPath = utils.checkAndFixFilePath(dsymFolder, continueOnError); + // The path can be null if continueIfSymbolsNotFound is true and the folder does not exist. + if (folderPath) { + symbolsPaths.push(folderPath); + } + } + }) + } + } else if (symbolsType === "UWP") { + // User can specifay a symbols path pattern that selects + // multiple PDB paths for UWP application. + let pdbPaths = utils.resolvePaths(pattern, continueOnError, packParentFolder); + + // Resolved paths can be null if continueIfSymbolsNotFound is true and the file/folder does not exist. + if (pdbPaths) { + pdbPaths.forEach(pdbFile => { + if (pdbFile) { + let pdbPath = utils.checkAndFixFilePath(pdbFile, continueOnError); + // The path can be null if continueIfSymbolsNotFound is true and the file does not exist. + if (pdbPath) { + symbolsPaths.push(pdbPath); + } + } + }) + } + } else { + // For all other application types user can specifay a symbols path pattern + // that selects only one file or one folder. + let symbolsFile = utils.resolveSinglePath(pattern, continueOnError, packParentFolder); + + // Resolved paths can be null if continueIfSymbolsNotFound is true and the file/folder does not exist. + if (symbolsFile) { + let filePath = utils.checkAndFixFilePath(symbolsFile, continueOnError); + // The path can be null if continueIfSymbolsNotFound is true and the file/folder does not exist. + if (filePath) { + symbolsPaths.push(filePath); + } + } + } + + return symbolsPaths; +} + +async function run() { + try { + tl.setResourcePath(path.join(__dirname, 'task.json')); + + // Get build inputs + let apiEndpointData = getEndpointDetails('serverEndpoint'); + let apiToken: string = apiEndpointData.authToken; + let apiServer: string = apiEndpointData.apiServer; + let apiVersion: string = apiEndpointData.apiVersion; + + let userAgent = tl.getVariable('MSDEPLOY_HTTP_USER_AGENT'); + if (!userAgent) { + userAgent = 'VSTS'; + } + userAgent = userAgent + ' (Task:VSMobileCenterUpload)'; + + var effectiveApiServer = process.env['SONOMA_API_SERVER'] || apiServer; + var effectiveApiVersion = process.env['SONOMA_API_VERSION'] || apiVersion; + + tl.debug(`Effective API Url: ${effectiveApiServer}/${effectiveApiVersion}`); + + let appSlug: string = tl.getInput('appSlug', true); + let appFilePattern: string = tl.getInput('app', true); + + /* The task has support for different symbol types but App Center server only support Apple currently, add back these types in the task.json when support is available in App Center. + "AndroidJava": "Android (Java)", + "AndroidNative": "Android (native C/C++)", + "Windows": "Windows 8.1", + "UWP": "Universal Windows Platform (UWP)" + */ + let symbolsType: string = tl.getInput('symbolsType', false); + let symbolVariableName = null; + switch (symbolsType) { + case "Apple": + symbolVariableName = "dsymPath"; + break; + case "AndroidJava": + symbolVariableName = "mappingTxtPath"; + break; + case "UWP": + symbolVariableName = "pdbPath"; + break; + default: + symbolVariableName = "symbolsPath"; + } + let symbolsPathPattern: string = tl.getInput(symbolVariableName, false); + let packParentFolder: boolean = tl.getBoolInput('packParentFolder', false); + + let releaseNotesSelection = tl.getInput('releaseNotesSelection', true); + let releaseNotes: string = null; + if (releaseNotesSelection === 'file') { + let releaseNotesFile = tl.getPathInput('releaseNotesFile', true, true); + releaseNotes = fs.readFileSync(releaseNotesFile).toString('utf8'); + } else { + releaseNotes = tl.getInput('releaseNotesInput', true); + } + + let isMandatory: boolean = tl.getBoolInput('isMandatory', false); + + let destinations = tl.getInput('destinationIds', false) || '00000000-0000-0000-0000-000000000000'; + tl.debug(`Effective destinationIds: ${destinations}`); + let destinationIds = destinations.split(/[, ;]+/).filter(id => id); + + // Validate inputs + if (!apiToken) { + throw new Error(tl.loc("NoApiTokenFound")); + } + if (!destinationIds.length) { + throw new Error(tl.loc("InvalidDestinationInput")); + } + + let app = utils.resolveSinglePath(appFilePattern); + tl.checkPath(app, "Binary file"); + + let continueIfSymbolsNotFoundVariable = tl.getVariable('VSMobileCenterUpload.ContinueIfSymbolsNotFound'); + let continueIfSymbolsNotFound = false; + if (continueIfSymbolsNotFoundVariable && continueIfSymbolsNotFoundVariable.toLowerCase() === 'true') { + continueIfSymbolsNotFound = true; + } + + // Expand symbols path pattern to a list of paths + let symbolsPaths = expandSymbolsPaths(symbolsType, symbolsPathPattern, continueIfSymbolsNotFound, packParentFolder); + + // Prepare symbols + let symbolsFile = await prepareSymbols(symbolsPaths); + + // Begin release upload + let uploadInfo: UploadInfo = await beginReleaseUpload(effectiveApiServer, effectiveApiVersion, appSlug, apiToken, userAgent); + + // Perform the upload + await uploadRelease(uploadInfo.upload_url, app, userAgent); + + // Commit the upload + let packageUrl = await commitRelease(effectiveApiServer, effectiveApiVersion, appSlug, uploadInfo.upload_id, apiToken, userAgent); + + // Publish + await publishRelease(effectiveApiServer, packageUrl, isMandatory, releaseNotes, destinationIds, apiToken, userAgent); + + if (symbolsFile) { + // Begin preparing upload symbols + let symbolsUploadInfo = await beginSymbolUpload(effectiveApiServer, effectiveApiVersion, appSlug, symbolsType, apiToken, userAgent); + + // upload symbols + await uploadSymbols(symbolsUploadInfo.upload_url, symbolsFile, userAgent); + + // Commit the symbols upload + await commitSymbols(effectiveApiServer, effectiveApiVersion, appSlug, symbolsUploadInfo.symbol_upload_id, apiToken, userAgent); + } + + tl.setResult(tl.TaskResult.Succeeded, tl.loc("Succeeded")); + } catch (err) { + tl.setResult(tl.TaskResult.Failed, `${err}`); + } +} + +run(); diff --git a/Tasks/AppCenterDistributeV3/icon.png b/Tasks/AppCenterDistributeV3/icon.png new file mode 100644 index 0000000000000000000000000000000000000000..6372ed81265e7788f4dddb805447053173c46328 GIT binary patch literal 1079 zcmV-71jze|P)Px&@kvBMR9FeUS6ygaMHD_Wdw0{-l9pD`2U97EN<(+^w-leOBD8`Q5z-eQ3Y)~j z77K+&s81>CgGML_Noi{qeGuC8tq4^RX&)ro-A&R!@{p^wH9{?v(5Pe+ckdj(+2r2b zJKZ05U31~?%$f7|%{gbz+!gdcKbd&)h7e+8=k~TsyRQwcnC^tR&}=#rOY)jcu_z>^ zBjL!|Smx|4*Uu&bScgHxK=iecVx;?xwyT>Cz}KH-tsUj!{cjSh zy&@F8+%u9kc`egFXPAF^_b3!_T$0M70*2}-fz&rL;p-#e{K`Q=X)t0N_zQy4dEzA%+1I|p7|T3Mcf+?w-s0i3Np zifG7`uSI(R@()&Dg)m-mg)A#kE~MFxzG3C4@0j_iT895E-vi((pvn$V!5O}}um4GR z%^i`Bli2y1ju1tp=)B8obo2l`9&P=KNDi}L3rfcd|1%t{h4O#9q)T!{E0vM5nr@#fQx|Kl|xH7HmVwc~J9Jkv8X zcFeSj&V;Ynp`7%zy9h286?Ez@NHu_i3j$Mba!waRZrivLfo+GB= zuBi*xw{3Yu*GQmC>h4KWo;Kxc(Kyx*Kl(DlP56P%x1XDsNe5_s87V=rkO+;J>zrD5 zcD?ml5eNYAv@j_H#$!WCACLw7*yss1TKBvp zXbhT~gA;ZK20bKArn$$uFnp{{TB1jq_{-&~pF)002ovPDHLkV1nP$0x{username}/apps/{app_identifier}](https://appcenter.ms/users/{username}/apps/{app_identifier}). If you are using orgs, the app slug is of the format **{orgname}/{app_identifier}**." + }, + { + "name": "app", + "aliases": [ + "appFile" + ], + "type": "filePath", + "label": "Binary file path", + "defaultValue": "", + "required": true, + "helpMarkDown": "Relative path from the repo root to the APK or IPA file you want to publish" + }, + { + "name": "symbolsType", + "aliases": [ + "symbolsOption" + ], + "type": "pickList", + "label": "Symbols type", + "required": false, + "defaultValue": "Apple", + "groupName": "symbols", + "options": { + "Apple": "Apple" + } + }, + { + "name": "symbolsPath", + "type": "filePath", + "label": "Symbols path", + "groupName": "symbols", + "required": false, + "helpMarkDown": "Relative path from the repo root to the symbols folder.", + "visibleRule": "symbolsType == AndroidNative || symbolsType = Windows" + }, + { + "name": "pdbPath", + "aliases": [ + "symbolsPdbFiles" + ], + "type": "filePath", + "label": "Symbols path (*.pdb)", + "defaultValue": "**/*.pdb", + "groupName": "symbols", + "required": false, + "helpMarkDown": "Relative path from the repo root to PDB symbols files. Path may contain wildcards.", + "visibleRule": "symbolsType = UWP" + }, + { + "name": "dsymPath", + "aliases": [ + "symbolsDsymFiles" + ], + "type": "filePath", + "label": "dSYM path", + "groupName": "symbols", + "required": false, + "helpMarkDown": "Relative path from the repo root to dSYM folder. Path may contain wildcards.", + "visibleRule": "symbolsType = Apple" + }, + { + "name": "mappingTxtPath", + "aliases": [ + "symbolsMappingTxtFile" + ], + "type": "filePath", + "label": "Mapping file", + "groupName": "symbols", + "required": false, + "helpMarkDown": "Relative path from the repo root to Android's mapping.txt file.", + "visibleRule": "symbolsType = AndroidJava" + }, + { + "name": "packParentFolder", + "aliases": [ + "symbolsIncludeParentDirectory" + ], + "type": "boolean", + "label": "Include all items in parent folder", + "groupName": "symbols", + "required": false, + "helpMarkDown": "Upload the selected symbols file or folder and all other items inside the same parent folder. This is required for React Native apps." + }, + { + "name": "releaseNotesSelection", + "aliases": [ + "releaseNotesOption" + ], + "type": "radio", + "label": "Create release notes", + "required": true, + "defaultValue": "input", + "options": { + "input": "Enter Release Notes", + "file": "Select Release Notes File" + } + }, + { + "name": "releaseNotesInput", + "type": "multiLine", + "label": "Release notes", + "required": true, + "helpMarkDown": "Release notes for this version.", + "visibleRule": "releaseNotesSelection = input", + "properties": { + "resizable": "true", + "rows": "10", + "maxLength": "5000" + } + }, + { + "name": "releaseNotesFile", + "type": "filePath", + "label": "Release notes file", + "required": true, + "helpMarkDown": "Select a UTF-8 encoded text file which contains the Release Notes for this version.", + "visibleRule": "releaseNotesSelection = file" + }, + { + "name": "isMandatory", + "type": "boolean", + "label": "Require users to update to this release", + "defaultValue": "false", + "required": false + }, + { + "name": "destinationIds", + "aliases": [ + "distributionGroupId", + "destinationId" + ], + "type": "string", + "defaultValue": "", + "label": "Destination IDs", + "helpMarkDown": "IDs of the distribution groups or stores the app will deploy to. Leave it empty to use the default group and use commas or semicolons to separate multiple IDs.", + "required": false + } + ], + "instanceNameFormat": "Deploy $(app) to Visual Studio App Center", + "execution": { + "Node": { + "target": "appcenterdistribute.js", + "argumentFormat": "" + } + }, + "messages": { + "CannotDecodeEndpoint": "Could not decode the endpoint.", + "NoResponseFromServer": "No response from server.", + "FailedToUploadFile": "Failed to complete file upload.", + "NoApiTokenFound": "No API token found on the Visual Studio App Center service connection.", + "InvalidDestinationInput": "The destination input provided was invalid", + "Succeeded": "App Center Distribute task succeeded", + "CannotFindAnyFile": "Cannot find any file based on %s.", + "FoundMultipleFiles": "Found multiple files matching %s.", + "FailedToCreateFile": "Failed to create %s with error: %s.", + "FailedToFindFile": "Failed to find %s at %s." + } +} \ No newline at end of file diff --git a/Tasks/AppCenterDistributeV3/task.loc.json b/Tasks/AppCenterDistributeV3/task.loc.json new file mode 100644 index 000000000000..b4ceaecff96a --- /dev/null +++ b/Tasks/AppCenterDistributeV3/task.loc.json @@ -0,0 +1,200 @@ +{ + "id": "B832BEC5-8C27-4FEF-9FB8-6BEC8524AD8A", + "name": "AppCenterDistribute", + "friendlyName": "ms-resource:loc.friendlyName", + "description": "ms-resource:loc.description", + "helpUrl": "https://aka.ms/appcentersupport/", + "helpMarkDown": "ms-resource:loc.helpMarkDown", + "category": "Deploy", + "visibility": [ + "Build", + "Release" + ], + "author": "Microsoft Corporation", + "version": { + "Major": 3, + "Minor": 150, + "Patch": 0 + }, + "releaseNotes": "ms-resource:loc.releaseNotes", + "groups": [ + { + "name": "symbols", + "displayName": "ms-resource:loc.group.displayName.symbols", + "isExpanded": true + } + ], + "inputs": [ + { + "name": "serverEndpoint", + "type": "connectedService:vsmobilecenter", + "label": "ms-resource:loc.input.label.serverEndpoint", + "defaultValue": "", + "required": true, + "helpMarkDown": "ms-resource:loc.input.help.serverEndpoint" + }, + { + "name": "appSlug", + "type": "string", + "label": "ms-resource:loc.input.label.appSlug", + "defaultValue": "", + "required": true, + "helpMarkDown": "ms-resource:loc.input.help.appSlug" + }, + { + "name": "app", + "aliases": [ + "appFile" + ], + "type": "filePath", + "label": "ms-resource:loc.input.label.app", + "defaultValue": "", + "required": true, + "helpMarkDown": "ms-resource:loc.input.help.app" + }, + { + "name": "symbolsType", + "aliases": [ + "symbolsOption" + ], + "type": "pickList", + "label": "ms-resource:loc.input.label.symbolsType", + "required": false, + "defaultValue": "Apple", + "groupName": "symbols", + "options": { + "Apple": "Apple" + } + }, + { + "name": "symbolsPath", + "type": "filePath", + "label": "ms-resource:loc.input.label.symbolsPath", + "groupName": "symbols", + "required": false, + "helpMarkDown": "ms-resource:loc.input.help.symbolsPath", + "visibleRule": "symbolsType == AndroidNative || symbolsType = Windows" + }, + { + "name": "pdbPath", + "aliases": [ + "symbolsPdbFiles" + ], + "type": "filePath", + "label": "ms-resource:loc.input.label.pdbPath", + "defaultValue": "**/*.pdb", + "groupName": "symbols", + "required": false, + "helpMarkDown": "ms-resource:loc.input.help.pdbPath", + "visibleRule": "symbolsType = UWP" + }, + { + "name": "dsymPath", + "aliases": [ + "symbolsDsymFiles" + ], + "type": "filePath", + "label": "ms-resource:loc.input.label.dsymPath", + "groupName": "symbols", + "required": false, + "helpMarkDown": "ms-resource:loc.input.help.dsymPath", + "visibleRule": "symbolsType = Apple" + }, + { + "name": "mappingTxtPath", + "aliases": [ + "symbolsMappingTxtFile" + ], + "type": "filePath", + "label": "ms-resource:loc.input.label.mappingTxtPath", + "groupName": "symbols", + "required": false, + "helpMarkDown": "ms-resource:loc.input.help.mappingTxtPath", + "visibleRule": "symbolsType = AndroidJava" + }, + { + "name": "packParentFolder", + "aliases": [ + "symbolsIncludeParentDirectory" + ], + "type": "boolean", + "label": "ms-resource:loc.input.label.packParentFolder", + "groupName": "symbols", + "required": false, + "helpMarkDown": "ms-resource:loc.input.help.packParentFolder" + }, + { + "name": "releaseNotesSelection", + "aliases": [ + "releaseNotesOption" + ], + "type": "radio", + "label": "ms-resource:loc.input.label.releaseNotesSelection", + "required": true, + "defaultValue": "input", + "options": { + "input": "Enter Release Notes", + "file": "Select Release Notes File" + } + }, + { + "name": "releaseNotesInput", + "type": "multiLine", + "label": "ms-resource:loc.input.label.releaseNotesInput", + "required": true, + "helpMarkDown": "ms-resource:loc.input.help.releaseNotesInput", + "visibleRule": "releaseNotesSelection = input", + "properties": { + "resizable": "true", + "rows": "10", + "maxLength": "5000" + } + }, + { + "name": "releaseNotesFile", + "type": "filePath", + "label": "ms-resource:loc.input.label.releaseNotesFile", + "required": true, + "helpMarkDown": "ms-resource:loc.input.help.releaseNotesFile", + "visibleRule": "releaseNotesSelection = file" + }, + { + "name": "isMandatory", + "type": "boolean", + "label": "ms-resource:loc.input.label.isMandatory", + "defaultValue": "false", + "required": false + }, + { + "name": "destinationIds", + "aliases": [ + "distributionGroupId", + "destinationId" + ], + "type": "string", + "defaultValue": "", + "label": "ms-resource:loc.input.label.destinationIds", + "helpMarkDown": "ms-resource:loc.input.help.destinationIds", + "required": false + } + ], + "instanceNameFormat": "ms-resource:loc.instanceNameFormat", + "execution": { + "Node": { + "target": "appcenterdistribute.js", + "argumentFormat": "" + } + }, + "messages": { + "CannotDecodeEndpoint": "ms-resource:loc.messages.CannotDecodeEndpoint", + "NoResponseFromServer": "ms-resource:loc.messages.NoResponseFromServer", + "FailedToUploadFile": "ms-resource:loc.messages.FailedToUploadFile", + "NoApiTokenFound": "ms-resource:loc.messages.NoApiTokenFound", + "InvalidDestinationInput": "ms-resource:loc.messages.InvalidDestinationInput", + "Succeeded": "ms-resource:loc.messages.Succeeded", + "CannotFindAnyFile": "ms-resource:loc.messages.CannotFindAnyFile", + "FoundMultipleFiles": "ms-resource:loc.messages.FoundMultipleFiles", + "FailedToCreateFile": "ms-resource:loc.messages.FailedToCreateFile", + "FailedToFindFile": "ms-resource:loc.messages.FailedToFindFile" + } +} \ No newline at end of file diff --git a/Tasks/AppCenterDistributeV3/tsconfig.json b/Tasks/AppCenterDistributeV3/tsconfig.json new file mode 100644 index 000000000000..0438b79f69ac --- /dev/null +++ b/Tasks/AppCenterDistributeV3/tsconfig.json @@ -0,0 +1,6 @@ +{ + "compilerOptions": { + "target": "ES6", + "module": "commonjs" + } +} \ No newline at end of file diff --git a/Tasks/AppCenterDistributeV3/typings.json b/Tasks/AppCenterDistributeV3/typings.json new file mode 100644 index 000000000000..f4049100cc93 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/typings.json @@ -0,0 +1,10 @@ +{ + "name": "Agent.Tasks.MobileCenterDistribute", + "globalDependencies": { + "mocha": "registry:dt/mocha#2.2.5+20160720003353", + "form-data": "registry:dt/form-data#0.0.0+20160724024111", + "node": "registry:dt/node#6.0.0+20160921192128", + "q": "registry:dt/q#0.0.0+20160613154756", + "request": "registry:dt/request#0.0.0+20160726020908" + } +} diff --git a/Tasks/AppCenterDistributeV3/typings/globals/form-data/index.d.ts b/Tasks/AppCenterDistributeV3/typings/globals/form-data/index.d.ts new file mode 100644 index 000000000000..487593aa807f --- /dev/null +++ b/Tasks/AppCenterDistributeV3/typings/globals/form-data/index.d.ts @@ -0,0 +1,20 @@ +// Generated by typings +// Source: https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/8de2997128443fbde32d9b04f7af78cd0c8c9593/form-data/form-data.d.ts +declare module "form-data" { + class FormData { + append(key: string, value: any, options?: any): void; + getHeaders(): FormData.Dictionary; + // TODO expand pipe + pipe(to: any): any; + submit(params: string | Object, callback: (error: any, response: any) => void): any; + getBoundary(): string; + } + + namespace FormData { + interface Dictionary { + [key: string]: T; + } + } + + export = FormData; +} diff --git a/Tasks/AppCenterDistributeV3/typings/globals/form-data/typings.json b/Tasks/AppCenterDistributeV3/typings/globals/form-data/typings.json new file mode 100644 index 000000000000..47b14b8d41df --- /dev/null +++ b/Tasks/AppCenterDistributeV3/typings/globals/form-data/typings.json @@ -0,0 +1,8 @@ +{ + "resolution": "main", + "tree": { + "src": "https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/8de2997128443fbde32d9b04f7af78cd0c8c9593/form-data/form-data.d.ts", + "raw": "registry:dt/form-data#0.0.0+20160724024111", + "typings": "https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/8de2997128443fbde32d9b04f7af78cd0c8c9593/form-data/form-data.d.ts" + } +} diff --git a/Tasks/AppCenterDistributeV3/typings/globals/mocha/index.d.ts b/Tasks/AppCenterDistributeV3/typings/globals/mocha/index.d.ts new file mode 100644 index 000000000000..ae7de0faa03c --- /dev/null +++ b/Tasks/AppCenterDistributeV3/typings/globals/mocha/index.d.ts @@ -0,0 +1,202 @@ +// Generated by typings +// Source: https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/a361a8ab3c327f208d3f82ad206971d4a63d8c25/mocha/mocha.d.ts +interface MochaSetupOptions { + //milliseconds to wait before considering a test slow + slow?: number; + + // timeout in milliseconds + timeout?: number; + + // ui name "bdd", "tdd", "exports" etc + ui?: string; + + //array of accepted globals + globals?: any[]; + + // reporter instance (function or string), defaults to `mocha.reporters.Spec` + reporter?: any; + + // bail on the first test failure + bail?: boolean; + + // ignore global leaks + ignoreLeaks?: boolean; + + // grep string or regexp to filter tests with + grep?: any; +} + +declare var mocha: Mocha; +declare var describe: Mocha.IContextDefinition; +declare var xdescribe: Mocha.IContextDefinition; +// alias for `describe` +declare var context: Mocha.IContextDefinition; +// alias for `describe` +declare var suite: Mocha.IContextDefinition; +declare var it: Mocha.ITestDefinition; +declare var xit: Mocha.ITestDefinition; +// alias for `it` +declare var test: Mocha.ITestDefinition; +declare var specify: Mocha.ITestDefinition; + +interface MochaDone { + (error?: any): any; +} + +interface ActionFunction { + (done: MochaDone): any | PromiseLike +} + +declare function setup(action: ActionFunction): void; +declare function teardown(action: ActionFunction): void; +declare function suiteSetup(action: ActionFunction): void; +declare function suiteTeardown(action: ActionFunction): void; +declare function before(action: ActionFunction): void; +declare function before(description: string, action: ActionFunction): void; +declare function after(action: ActionFunction): void; +declare function after(description: string, action: ActionFunction): void; +declare function beforeEach(action: ActionFunction): void; +declare function beforeEach(description: string, action: ActionFunction): void; +declare function afterEach(action: ActionFunction): void; +declare function afterEach(description: string, action: ActionFunction): void; + +declare class Mocha { + currentTest: Mocha.ITestDefinition; + constructor(options?: { + grep?: RegExp; + ui?: string; + reporter?: string; + timeout?: number; + bail?: boolean; + }); + + /** Setup mocha with the given options. */ + setup(options: MochaSetupOptions): Mocha; + bail(value?: boolean): Mocha; + addFile(file: string): Mocha; + /** Sets reporter by name, defaults to "spec". */ + reporter(name: string): Mocha; + /** Sets reporter constructor, defaults to mocha.reporters.Spec. */ + reporter(reporter: (runner: Mocha.IRunner, options: any) => any): Mocha; + ui(value: string): Mocha; + grep(value: string): Mocha; + grep(value: RegExp): Mocha; + invert(): Mocha; + ignoreLeaks(value: boolean): Mocha; + checkLeaks(): Mocha; + /** + * Function to allow assertion libraries to throw errors directly into mocha. + * This is useful when running tests in a browser because window.onerror will + * only receive the 'message' attribute of the Error. + */ + throwError(error: Error): void; + /** Enables growl support. */ + growl(): Mocha; + globals(value: string): Mocha; + globals(values: string[]): Mocha; + useColors(value: boolean): Mocha; + useInlineDiffs(value: boolean): Mocha; + timeout(value: number): Mocha; + slow(value: number): Mocha; + enableTimeouts(value: boolean): Mocha; + asyncOnly(value: boolean): Mocha; + noHighlighting(value: boolean): Mocha; + /** Runs tests and invokes `onComplete()` when finished. */ + run(onComplete?: (failures: number) => void): Mocha.IRunner; +} + +// merge the Mocha class declaration with a module +declare namespace Mocha { + /** Partial interface for Mocha's `Runnable` class. */ + interface IRunnable { + title: string; + fn: Function; + async: boolean; + sync: boolean; + timedOut: boolean; + } + + /** Partial interface for Mocha's `Suite` class. */ + interface ISuite { + parent: ISuite; + title: string; + + fullTitle(): string; + } + + /** Partial interface for Mocha's `Test` class. */ + interface ITest extends IRunnable { + parent: ISuite; + pending: boolean; + + fullTitle(): string; + } + + /** Partial interface for Mocha's `Runner` class. */ + interface IRunner {} + + interface IContextDefinition { + (description: string, spec: () => void): ISuite; + only(description: string, spec: () => void): ISuite; + skip(description: string, spec: () => void): void; + timeout(ms: number): void; + } + + interface ITestDefinition { + (expectation: string, assertion?: ActionFunction): ITest; + only(expectation: string, assertion?: ActionFunction): ITest; + skip(expectation: string, assertion?: ActionFunction): void; + timeout(ms: number): void; + state: "failed" | "passed"; + } + + export module reporters { + export class Base { + stats: { + suites: number; + tests: number; + passes: number; + pending: number; + failures: number; + }; + + constructor(runner: IRunner); + } + + export class Doc extends Base {} + export class Dot extends Base {} + export class HTML extends Base {} + export class HTMLCov extends Base {} + export class JSON extends Base {} + export class JSONCov extends Base {} + export class JSONStream extends Base {} + export class Landing extends Base {} + export class List extends Base {} + export class Markdown extends Base {} + export class Min extends Base {} + export class Nyan extends Base {} + export class Progress extends Base { + /** + * @param options.open String used to indicate the start of the progress bar. + * @param options.complete String used to indicate a complete test on the progress bar. + * @param options.incomplete String used to indicate an incomplete test on the progress bar. + * @param options.close String used to indicate the end of the progress bar. + */ + constructor(runner: IRunner, options?: { + open?: string; + complete?: string; + incomplete?: string; + close?: string; + }); + } + export class Spec extends Base {} + export class TAP extends Base {} + export class XUnit extends Base { + constructor(runner: IRunner, options?: any); + } + } +} + +declare module "mocha" { + export = Mocha; +} diff --git a/Tasks/AppCenterDistributeV3/typings/globals/mocha/typings.json b/Tasks/AppCenterDistributeV3/typings/globals/mocha/typings.json new file mode 100644 index 000000000000..aab9d1c1302c --- /dev/null +++ b/Tasks/AppCenterDistributeV3/typings/globals/mocha/typings.json @@ -0,0 +1,8 @@ +{ + "resolution": "main", + "tree": { + "src": "https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/a361a8ab3c327f208d3f82ad206971d4a63d8c25/mocha/mocha.d.ts", + "raw": "registry:dt/mocha#2.2.5+20160720003353", + "typings": "https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/a361a8ab3c327f208d3f82ad206971d4a63d8c25/mocha/mocha.d.ts" + } +} diff --git a/Tasks/AppCenterDistributeV3/typings/globals/node/index.d.ts b/Tasks/AppCenterDistributeV3/typings/globals/node/index.d.ts new file mode 100644 index 000000000000..05880e63ff67 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/typings/globals/node/index.d.ts @@ -0,0 +1,3464 @@ +// Generated by typings +// Source: https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/66484e9f11a93a89d972ba009e81957338e26ed7/node/node.d.ts +interface Error { + stack?: string; +} + +interface ErrorConstructor { + captureStackTrace(targetObject: Object, constructorOpt?: Function): void; + stackTraceLimit: number; +} + +// compat for TypeScript 1.8 +// if you use with --target es3 or --target es5 and use below definitions, +// use the lib.es6.d.ts that is bundled with TypeScript 1.8. +interface MapConstructor { } +interface WeakMapConstructor { } +interface SetConstructor { } +interface WeakSetConstructor { } + +/************************************************ +* * +* GLOBAL * +* * +************************************************/ +declare var process: NodeJS.Process; +declare var global: NodeJS.Global; + +declare var __filename: string; +declare var __dirname: string; + +declare function setTimeout(callback: (...args: any[]) => void, ms: number, ...args: any[]): NodeJS.Timer; +declare function clearTimeout(timeoutId: NodeJS.Timer): void; +declare function setInterval(callback: (...args: any[]) => void, ms: number, ...args: any[]): NodeJS.Timer; +declare function clearInterval(intervalId: NodeJS.Timer): void; +declare function setImmediate(callback: (...args: any[]) => void, ...args: any[]): any; +declare function clearImmediate(immediateId: any): void; + +interface NodeRequireFunction { + (id: string): any; +} + +interface NodeRequire extends NodeRequireFunction { + resolve(id: string): string; + cache: any; + extensions: any; + main: any; +} + +declare var require: NodeRequire; + +interface NodeModule { + exports: any; + require: NodeRequireFunction; + id: string; + filename: string; + loaded: boolean; + parent: any; + children: any[]; +} + +declare var module: NodeModule; + +// Same as module.exports +declare var exports: any; +declare var SlowBuffer: { + new (str: string, encoding?: string): Buffer; + new (size: number): Buffer; + new (size: Uint8Array): Buffer; + new (array: any[]): Buffer; + prototype: Buffer; + isBuffer(obj: any): boolean; + byteLength(string: string, encoding?: string): number; + concat(list: Buffer[], totalLength?: number): Buffer; +}; + + +// Buffer class +type BufferEncoding = "ascii" | "utf8" | "utf16le" | "ucs2" | "binary" | "hex"; +interface Buffer extends NodeBuffer { } + +/** + * Raw data is stored in instances of the Buffer class. + * A Buffer is similar to an array of integers but corresponds to a raw memory allocation outside the V8 heap. A Buffer cannot be resized. + * Valid string encodings: 'ascii'|'utf8'|'utf16le'|'ucs2'(alias of 'utf16le')|'base64'|'binary'(deprecated)|'hex' + */ +declare var Buffer: { + /** + * Allocates a new buffer containing the given {str}. + * + * @param str String to store in buffer. + * @param encoding encoding to use, optional. Default is 'utf8' + */ + new (str: string, encoding?: string): Buffer; + /** + * Allocates a new buffer of {size} octets. + * + * @param size count of octets to allocate. + */ + new (size: number): Buffer; + /** + * Allocates a new buffer containing the given {array} of octets. + * + * @param array The octets to store. + */ + new (array: Uint8Array): Buffer; + /** + * Produces a Buffer backed by the same allocated memory as + * the given {ArrayBuffer}. + * + * + * @param arrayBuffer The ArrayBuffer with which to share memory. + */ + new (arrayBuffer: ArrayBuffer): Buffer; + /** + * Allocates a new buffer containing the given {array} of octets. + * + * @param array The octets to store. + */ + new (array: any[]): Buffer; + /** + * Copies the passed {buffer} data onto a new {Buffer} instance. + * + * @param buffer The buffer to copy. + */ + new (buffer: Buffer): Buffer; + prototype: Buffer; + /** + * Allocates a new Buffer using an {array} of octets. + * + * @param array + */ + from(array: any[]): Buffer; + /** + * When passed a reference to the .buffer property of a TypedArray instance, + * the newly created Buffer will share the same allocated memory as the TypedArray. + * The optional {byteOffset} and {length} arguments specify a memory range + * within the {arrayBuffer} that will be shared by the Buffer. + * + * @param arrayBuffer The .buffer property of a TypedArray or a new ArrayBuffer() + * @param byteOffset + * @param length + */ + from(arrayBuffer: ArrayBuffer, byteOffset?: number, length?: number): Buffer; + /** + * Copies the passed {buffer} data onto a new Buffer instance. + * + * @param buffer + */ + from(buffer: Buffer): Buffer; + /** + * Creates a new Buffer containing the given JavaScript string {str}. + * If provided, the {encoding} parameter identifies the character encoding. + * If not provided, {encoding} defaults to 'utf8'. + * + * @param str + */ + from(str: string, encoding?: string): Buffer; + /** + * Returns true if {obj} is a Buffer + * + * @param obj object to test. + */ + isBuffer(obj: any): obj is Buffer; + /** + * Returns true if {encoding} is a valid encoding argument. + * Valid string encodings in Node 0.12: 'ascii'|'utf8'|'utf16le'|'ucs2'(alias of 'utf16le')|'base64'|'binary'(deprecated)|'hex' + * + * @param encoding string to test. + */ + isEncoding(encoding: string): boolean; + /** + * Gives the actual byte length of a string. encoding defaults to 'utf8'. + * This is not the same as String.prototype.length since that returns the number of characters in a string. + * + * @param string string to test. + * @param encoding encoding used to evaluate (defaults to 'utf8') + */ + byteLength(string: string, encoding?: string): number; + /** + * Returns a buffer which is the result of concatenating all the buffers in the list together. + * + * If the list has no items, or if the totalLength is 0, then it returns a zero-length buffer. + * If the list has exactly one item, then the first item of the list is returned. + * If the list has more than one item, then a new Buffer is created. + * + * @param list An array of Buffer objects to concatenate + * @param totalLength Total length of the buffers when concatenated. + * If totalLength is not provided, it is read from the buffers in the list. However, this adds an additional loop to the function, so it is faster to provide the length explicitly. + */ + concat(list: Buffer[], totalLength?: number): Buffer; + /** + * The same as buf1.compare(buf2). + */ + compare(buf1: Buffer, buf2: Buffer): number; + /** + * Allocates a new buffer of {size} octets. + * + * @param size count of octets to allocate. + * @param fill if specified, buffer will be initialized by calling buf.fill(fill). + * If parameter is omitted, buffer will be filled with zeros. + * @param encoding encoding used for call to buf.fill while initalizing + */ + alloc(size: number, fill?: string | Buffer | number, encoding?: string): Buffer; + /** + * Allocates a new buffer of {size} octets, leaving memory not initialized, so the contents + * of the newly created Buffer are unknown and may contain sensitive data. + * + * @param size count of octets to allocate + */ + allocUnsafe(size: number): Buffer; + /** + * Allocates a new non-pooled buffer of {size} octets, leaving memory not initialized, so the contents + * of the newly created Buffer are unknown and may contain sensitive data. + * + * @param size count of octets to allocate + */ + allocUnsafeSlow(size: number): Buffer; +}; + +/************************************************ +* * +* GLOBAL INTERFACES * +* * +************************************************/ +declare namespace NodeJS { + export interface ErrnoException extends Error { + errno?: string; + code?: string; + path?: string; + syscall?: string; + stack?: string; + } + + export class EventEmitter { + addListener(event: string | symbol, listener: Function): this; + on(event: string | symbol, listener: Function): this; + once(event: string | symbol, listener: Function): this; + removeListener(event: string | symbol, listener: Function): this; + removeAllListeners(event?: string | symbol): this; + setMaxListeners(n: number): this; + getMaxListeners(): number; + listeners(event: string | symbol): Function[]; + emit(event: string | symbol, ...args: any[]): boolean; + listenerCount(type: string | symbol): number; + // Added in Node 6... + prependListener(event: string | symbol, listener: Function): this; + prependOnceListener(event: string | symbol, listener: Function): this; + eventNames(): (string | symbol)[]; + } + + export interface ReadableStream extends EventEmitter { + readable: boolean; + read(size?: number): string | Buffer; + setEncoding(encoding: string): void; + pause(): ReadableStream; + resume(): ReadableStream; + pipe(destination: T, options?: { end?: boolean; }): T; + unpipe(destination?: T): void; + unshift(chunk: string): void; + unshift(chunk: Buffer): void; + wrap(oldStream: ReadableStream): ReadableStream; + } + + export interface WritableStream extends EventEmitter { + writable: boolean; + write(buffer: Buffer | string, cb?: Function): boolean; + write(str: string, encoding?: string, cb?: Function): boolean; + end(): void; + end(buffer: Buffer, cb?: Function): void; + end(str: string, cb?: Function): void; + end(str: string, encoding?: string, cb?: Function): void; + } + + export interface ReadWriteStream extends ReadableStream, WritableStream { + pause(): ReadWriteStream; + resume(): ReadWriteStream; + } + + export interface Events extends EventEmitter { } + + export interface Domain extends Events { + run(fn: Function): void; + add(emitter: Events): void; + remove(emitter: Events): void; + bind(cb: (err: Error, data: any) => any): any; + intercept(cb: (data: any) => any): any; + dispose(): void; + + addListener(event: string, listener: Function): this; + on(event: string, listener: Function): this; + once(event: string, listener: Function): this; + removeListener(event: string, listener: Function): this; + removeAllListeners(event?: string): this; + } + + export interface MemoryUsage { + rss: number; + heapTotal: number; + heapUsed: number; + } + + export interface ProcessVersions { + http_parser: string; + node: string; + v8: string; + ares: string; + uv: string; + zlib: string; + modules: string; + openssl: string; + } + + export interface Process extends EventEmitter { + stdout: WritableStream; + stderr: WritableStream; + stdin: ReadableStream; + argv: string[]; + execArgv: string[]; + execPath: string; + abort(): void; + chdir(directory: string): void; + cwd(): string; + env: any; + exit(code?: number): void; + exitCode: number; + getgid(): number; + setgid(id: number): void; + setgid(id: string): void; + getuid(): number; + setuid(id: number): void; + setuid(id: string): void; + version: string; + versions: ProcessVersions; + config: { + target_defaults: { + cflags: any[]; + default_configuration: string; + defines: string[]; + include_dirs: string[]; + libraries: string[]; + }; + variables: { + clang: number; + host_arch: string; + node_install_npm: boolean; + node_install_waf: boolean; + node_prefix: string; + node_shared_openssl: boolean; + node_shared_v8: boolean; + node_shared_zlib: boolean; + node_use_dtrace: boolean; + node_use_etw: boolean; + node_use_openssl: boolean; + target_arch: string; + v8_no_strict_aliasing: number; + v8_use_snapshot: boolean; + visibility: string; + }; + }; + kill(pid: number, signal?: string | number): void; + pid: number; + title: string; + arch: string; + platform: string; + memoryUsage(): MemoryUsage; + nextTick(callback: Function, ...args: any[]): void; + umask(mask?: number): number; + uptime(): number; + hrtime(time?: number[]): number[]; + domain: Domain; + + // Worker + send?(message: any, sendHandle?: any): void; + disconnect(): void; + connected: boolean; + } + + export interface Global { + Array: typeof Array; + ArrayBuffer: typeof ArrayBuffer; + Boolean: typeof Boolean; + Buffer: typeof Buffer; + DataView: typeof DataView; + Date: typeof Date; + Error: typeof Error; + EvalError: typeof EvalError; + Float32Array: typeof Float32Array; + Float64Array: typeof Float64Array; + Function: typeof Function; + GLOBAL: Global; + Infinity: typeof Infinity; + Int16Array: typeof Int16Array; + Int32Array: typeof Int32Array; + Int8Array: typeof Int8Array; + Intl: typeof Intl; + JSON: typeof JSON; + Map: MapConstructor; + Math: typeof Math; + NaN: typeof NaN; + Number: typeof Number; + Object: typeof Object; + Promise: Function; + RangeError: typeof RangeError; + ReferenceError: typeof ReferenceError; + RegExp: typeof RegExp; + Set: SetConstructor; + String: typeof String; + Symbol: Function; + SyntaxError: typeof SyntaxError; + TypeError: typeof TypeError; + URIError: typeof URIError; + Uint16Array: typeof Uint16Array; + Uint32Array: typeof Uint32Array; + Uint8Array: typeof Uint8Array; + Uint8ClampedArray: Function; + WeakMap: WeakMapConstructor; + WeakSet: WeakSetConstructor; + clearImmediate: (immediateId: any) => void; + clearInterval: (intervalId: NodeJS.Timer) => void; + clearTimeout: (timeoutId: NodeJS.Timer) => void; + console: typeof console; + decodeURI: typeof decodeURI; + decodeURIComponent: typeof decodeURIComponent; + encodeURI: typeof encodeURI; + encodeURIComponent: typeof encodeURIComponent; + escape: (str: string) => string; + eval: typeof eval; + global: Global; + isFinite: typeof isFinite; + isNaN: typeof isNaN; + parseFloat: typeof parseFloat; + parseInt: typeof parseInt; + process: Process; + root: Global; + setImmediate: (callback: (...args: any[]) => void, ...args: any[]) => any; + setInterval: (callback: (...args: any[]) => void, ms: number, ...args: any[]) => NodeJS.Timer; + setTimeout: (callback: (...args: any[]) => void, ms: number, ...args: any[]) => NodeJS.Timer; + undefined: typeof undefined; + unescape: (str: string) => string; + gc: () => void; + v8debug?: any; + } + + export interface Timer { + ref(): void; + unref(): void; + } +} + +interface IterableIterator { } + +/** + * @deprecated + */ +interface NodeBuffer extends Uint8Array { + write(string: string, offset?: number, length?: number, encoding?: string): number; + toString(encoding?: string, start?: number, end?: number): string; + toJSON(): { type: 'Buffer', data: any[] }; + equals(otherBuffer: Buffer): boolean; + compare(otherBuffer: Buffer, targetStart?: number, targetEnd?: number, sourceStart?: number, sourceEnd?: number): number; + copy(targetBuffer: Buffer, targetStart?: number, sourceStart?: number, sourceEnd?: number): number; + slice(start?: number, end?: number): Buffer; + writeUIntLE(value: number, offset: number, byteLength: number, noAssert?: boolean): number; + writeUIntBE(value: number, offset: number, byteLength: number, noAssert?: boolean): number; + writeIntLE(value: number, offset: number, byteLength: number, noAssert?: boolean): number; + writeIntBE(value: number, offset: number, byteLength: number, noAssert?: boolean): number; + readUIntLE(offset: number, byteLength: number, noAssert?: boolean): number; + readUIntBE(offset: number, byteLength: number, noAssert?: boolean): number; + readIntLE(offset: number, byteLength: number, noAssert?: boolean): number; + readIntBE(offset: number, byteLength: number, noAssert?: boolean): number; + readUInt8(offset: number, noAssert?: boolean): number; + readUInt16LE(offset: number, noAssert?: boolean): number; + readUInt16BE(offset: number, noAssert?: boolean): number; + readUInt32LE(offset: number, noAssert?: boolean): number; + readUInt32BE(offset: number, noAssert?: boolean): number; + readInt8(offset: number, noAssert?: boolean): number; + readInt16LE(offset: number, noAssert?: boolean): number; + readInt16BE(offset: number, noAssert?: boolean): number; + readInt32LE(offset: number, noAssert?: boolean): number; + readInt32BE(offset: number, noAssert?: boolean): number; + readFloatLE(offset: number, noAssert?: boolean): number; + readFloatBE(offset: number, noAssert?: boolean): number; + readDoubleLE(offset: number, noAssert?: boolean): number; + readDoubleBE(offset: number, noAssert?: boolean): number; + swap16(): Buffer; + swap32(): Buffer; + swap64(): Buffer; + writeUInt8(value: number, offset: number, noAssert?: boolean): number; + writeUInt16LE(value: number, offset: number, noAssert?: boolean): number; + writeUInt16BE(value: number, offset: number, noAssert?: boolean): number; + writeUInt32LE(value: number, offset: number, noAssert?: boolean): number; + writeUInt32BE(value: number, offset: number, noAssert?: boolean): number; + writeInt8(value: number, offset: number, noAssert?: boolean): number; + writeInt16LE(value: number, offset: number, noAssert?: boolean): number; + writeInt16BE(value: number, offset: number, noAssert?: boolean): number; + writeInt32LE(value: number, offset: number, noAssert?: boolean): number; + writeInt32BE(value: number, offset: number, noAssert?: boolean): number; + writeFloatLE(value: number, offset: number, noAssert?: boolean): number; + writeFloatBE(value: number, offset: number, noAssert?: boolean): number; + writeDoubleLE(value: number, offset: number, noAssert?: boolean): number; + writeDoubleBE(value: number, offset: number, noAssert?: boolean): number; + fill(value: any, offset?: number, end?: number): this; + indexOf(value: string | number | Buffer, byteOffset?: number, encoding?: string): number; + lastIndexOf(value: string | number | Buffer, byteOffset?: number, encoding?: string): number; + entries(): IterableIterator<[number, number]>; + includes(value: string | number | Buffer, byteOffset?: number, encoding?: string): boolean; + keys(): IterableIterator; + values(): IterableIterator; +} + +/************************************************ +* * +* MODULES * +* * +************************************************/ +declare module "buffer" { + export var INSPECT_MAX_BYTES: number; + var BuffType: typeof Buffer; + var SlowBuffType: typeof SlowBuffer; + export { BuffType as Buffer, SlowBuffType as SlowBuffer }; +} + +declare module "querystring" { + export interface StringifyOptions { + encodeURIComponent?: Function; + } + + export interface ParseOptions { + maxKeys?: number; + decodeURIComponent?: Function; + } + + export function stringify(obj: T, sep?: string, eq?: string, options?: StringifyOptions): string; + export function parse(str: string, sep?: string, eq?: string, options?: ParseOptions): any; + export function parse(str: string, sep?: string, eq?: string, options?: ParseOptions): T; + export function escape(str: string): string; + export function unescape(str: string): string; +} + +declare module "events" { + export class EventEmitter extends NodeJS.EventEmitter { + static EventEmitter: EventEmitter; + static listenerCount(emitter: EventEmitter, event: string | symbol): number; // deprecated + static defaultMaxListeners: number; + + addListener(event: string | symbol, listener: Function): this; + on(event: string | symbol, listener: Function): this; + once(event: string | symbol, listener: Function): this; + prependListener(event: string | symbol, listener: Function): this; + prependOnceListener(event: string | symbol, listener: Function): this; + removeListener(event: string | symbol, listener: Function): this; + removeAllListeners(event?: string | symbol): this; + setMaxListeners(n: number): this; + getMaxListeners(): number; + listeners(event: string | symbol): Function[]; + emit(event: string | symbol, ...args: any[]): boolean; + eventNames(): (string | symbol)[]; + listenerCount(type: string | symbol): number; + } +} + +declare module "http" { + import * as events from "events"; + import * as net from "net"; + import * as stream from "stream"; + + export interface RequestOptions { + protocol?: string; + host?: string; + hostname?: string; + family?: number; + port?: number; + localAddress?: string; + socketPath?: string; + method?: string; + path?: string; + headers?: { [key: string]: any }; + auth?: string; + agent?: Agent | boolean; + } + + export interface Server extends net.Server { + setTimeout(msecs: number, callback: Function): void; + maxHeadersCount: number; + timeout: number; + listening: boolean; + } + /** + * @deprecated Use IncomingMessage + */ + export interface ServerRequest extends IncomingMessage { + connection: net.Socket; + } + export interface ServerResponse extends stream.Writable { + // Extended base methods + write(buffer: Buffer): boolean; + write(buffer: Buffer, cb?: Function): boolean; + write(str: string, cb?: Function): boolean; + write(str: string, encoding?: string, cb?: Function): boolean; + write(str: string, encoding?: string, fd?: string): boolean; + + writeContinue(): void; + writeHead(statusCode: number, reasonPhrase?: string, headers?: any): void; + writeHead(statusCode: number, headers?: any): void; + statusCode: number; + statusMessage: string; + headersSent: boolean; + setHeader(name: string, value: string | string[]): void; + setTimeout(msecs: number, callback: Function): ServerResponse; + sendDate: boolean; + getHeader(name: string): string; + removeHeader(name: string): void; + write(chunk: any, encoding?: string): any; + addTrailers(headers: any): void; + finished: boolean; + + // Extended base methods + end(): void; + end(buffer: Buffer, cb?: Function): void; + end(str: string, cb?: Function): void; + end(str: string, encoding?: string, cb?: Function): void; + end(data?: any, encoding?: string): void; + } + export interface ClientRequest extends stream.Writable { + // Extended base methods + write(buffer: Buffer): boolean; + write(buffer: Buffer, cb?: Function): boolean; + write(str: string, cb?: Function): boolean; + write(str: string, encoding?: string, cb?: Function): boolean; + write(str: string, encoding?: string, fd?: string): boolean; + + write(chunk: any, encoding?: string): void; + abort(): void; + setTimeout(timeout: number, callback?: Function): void; + setNoDelay(noDelay?: boolean): void; + setSocketKeepAlive(enable?: boolean, initialDelay?: number): void; + + setHeader(name: string, value: string | string[]): void; + getHeader(name: string): string; + removeHeader(name: string): void; + addTrailers(headers: any): void; + + // Extended base methods + end(): void; + end(buffer: Buffer, cb?: Function): void; + end(str: string, cb?: Function): void; + end(str: string, encoding?: string, cb?: Function): void; + end(data?: any, encoding?: string): void; + } + export interface IncomingMessage extends stream.Readable { + httpVersion: string; + httpVersionMajor: number; + httpVersionMinor: number; + connection: net.Socket; + headers: any; + rawHeaders: string[]; + trailers: any; + rawTrailers: any; + setTimeout(msecs: number, callback: Function): NodeJS.Timer; + /** + * Only valid for request obtained from http.Server. + */ + method?: string; + /** + * Only valid for request obtained from http.Server. + */ + url?: string; + /** + * Only valid for response obtained from http.ClientRequest. + */ + statusCode?: number; + /** + * Only valid for response obtained from http.ClientRequest. + */ + statusMessage?: string; + socket: net.Socket; + destroy(error?: Error): void; + } + /** + * @deprecated Use IncomingMessage + */ + export interface ClientResponse extends IncomingMessage { } + + export interface AgentOptions { + /** + * Keep sockets around in a pool to be used by other requests in the future. Default = false + */ + keepAlive?: boolean; + /** + * When using HTTP KeepAlive, how often to send TCP KeepAlive packets over sockets being kept alive. Default = 1000. + * Only relevant if keepAlive is set to true. + */ + keepAliveMsecs?: number; + /** + * Maximum number of sockets to allow per host. Default for Node 0.10 is 5, default for Node 0.12 is Infinity + */ + maxSockets?: number; + /** + * Maximum number of sockets to leave open in a free state. Only relevant if keepAlive is set to true. Default = 256. + */ + maxFreeSockets?: number; + } + + export class Agent { + maxSockets: number; + sockets: any; + requests: any; + + constructor(opts?: AgentOptions); + + /** + * Destroy any sockets that are currently in use by the agent. + * It is usually not necessary to do this. However, if you are using an agent with KeepAlive enabled, + * then it is best to explicitly shut down the agent when you know that it will no longer be used. Otherwise, + * sockets may hang open for quite a long time before the server terminates them. + */ + destroy(): void; + } + + export var METHODS: string[]; + + export var STATUS_CODES: { + [errorCode: number]: string; + [errorCode: string]: string; + }; + export function createServer(requestListener?: (request: IncomingMessage, response: ServerResponse) => void): Server; + export function createClient(port?: number, host?: string): any; + export function request(options: RequestOptions, callback?: (res: IncomingMessage) => void): ClientRequest; + export function get(options: any, callback?: (res: IncomingMessage) => void): ClientRequest; + export var globalAgent: Agent; +} + +declare module "cluster" { + import * as child from "child_process"; + import * as events from "events"; + import * as net from "net"; + + // interfaces + export interface ClusterSettings { + execArgv?: string[]; // default: process.execArgv + exec?: string; + args?: string[]; + silent?: boolean; + stdio?: any[]; + uid?: number; + gid?: number; + } + + export interface ClusterSetupMasterSettings { + exec?: string; // default: process.argv[1] + args?: string[]; // default: process.argv.slice(2) + silent?: boolean; // default: false + stdio?: any[]; + } + + export interface Address { + address: string; + port: number; + addressType: number | "udp4" | "udp6"; // 4, 6, -1, "udp4", "udp6" + } + + export class Worker extends events.EventEmitter { + id: string; + process: child.ChildProcess; + suicide: boolean; + send(message: any, sendHandle?: any): boolean; + kill(signal?: string): void; + destroy(signal?: string): void; + disconnect(): void; + isConnected(): boolean; + isDead(): boolean; + exitedAfterDisconnect: boolean; + + /** + * events.EventEmitter + * 1. disconnect + * 2. error + * 3. exit + * 4. listening + * 5. message + * 6. online + */ + addListener(event: string, listener: Function): this; + addListener(event: "disconnect", listener: () => void): this; + addListener(event: "error", listener: (code: number, signal: string) => void): this; + addListener(event: "exit", listener: (code: number, signal: string) => void): this; + addListener(event: "listening", listener: (address: Address) => void): this; + addListener(event: "message", listener: (message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + addListener(event: "online", listener: () => void): this; + + on(event: string, listener: Function): this; + on(event: "disconnect", listener: () => void): this; + on(event: "error", listener: (code: number, signal: string) => void): this; + on(event: "exit", listener: (code: number, signal: string) => void): this; + on(event: "listening", listener: (address: Address) => void): this; + on(event: "message", listener: (message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + on(event: "online", listener: () => void): this; + + once(event: string, listener: Function): this; + once(event: "disconnect", listener: () => void): this; + once(event: "error", listener: (code: number, signal: string) => void): this; + once(event: "exit", listener: (code: number, signal: string) => void): this; + once(event: "listening", listener: (address: Address) => void): this; + once(event: "message", listener: (message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + once(event: "online", listener: () => void): this; + + prependListener(event: string, listener: Function): this; + prependListener(event: "disconnect", listener: () => void): this; + prependListener(event: "error", listener: (code: number, signal: string) => void): this; + prependListener(event: "exit", listener: (code: number, signal: string) => void): this; + prependListener(event: "listening", listener: (address: Address) => void): this; + prependListener(event: "message", listener: (message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + prependListener(event: "online", listener: () => void): this; + + prependOnceListener(event: string, listener: Function): this; + prependOnceListener(event: "disconnect", listener: () => void): this; + prependOnceListener(event: "error", listener: (code: number, signal: string) => void): this; + prependOnceListener(event: "exit", listener: (code: number, signal: string) => void): this; + prependOnceListener(event: "listening", listener: (address: Address) => void): this; + prependOnceListener(event: "message", listener: (message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + prependOnceListener(event: "online", listener: () => void): this; + } + + export interface Cluster extends events.EventEmitter { + Worker: Worker; + disconnect(callback?: Function): void; + fork(env?: any): Worker; + isMaster: boolean; + isWorker: boolean; + // TODO: cluster.schedulingPolicy + settings: ClusterSettings; + setupMaster(settings?: ClusterSetupMasterSettings): void; + worker: Worker; + workers: { + [index: string]: Worker + }; + + /** + * events.EventEmitter + * 1. disconnect + * 2. exit + * 3. fork + * 4. listening + * 5. message + * 6. online + * 7. setup + */ + addListener(event: string, listener: Function): this; + addListener(event: "disconnect", listener: (worker: Worker) => void): this; + addListener(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): this; + addListener(event: "fork", listener: (worker: Worker) => void): this; + addListener(event: "listening", listener: (worker: Worker, address: Address) => void): this; + addListener(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + addListener(event: "online", listener: (worker: Worker) => void): this; + addListener(event: "setup", listener: (settings: any) => void): this; + + on(event: string, listener: Function): this; + on(event: "disconnect", listener: (worker: Worker) => void): this; + on(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): this; + on(event: "fork", listener: (worker: Worker) => void): this; + on(event: "listening", listener: (worker: Worker, address: Address) => void): this; + on(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + on(event: "online", listener: (worker: Worker) => void): this; + on(event: "setup", listener: (settings: any) => void): this; + + once(event: string, listener: Function): this; + once(event: "disconnect", listener: (worker: Worker) => void): this; + once(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): this; + once(event: "fork", listener: (worker: Worker) => void): this; + once(event: "listening", listener: (worker: Worker, address: Address) => void): this; + once(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + once(event: "online", listener: (worker: Worker) => void): this; + once(event: "setup", listener: (settings: any) => void): this; + + prependListener(event: string, listener: Function): this; + prependListener(event: "disconnect", listener: (worker: Worker) => void): this; + prependListener(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): this; + prependListener(event: "fork", listener: (worker: Worker) => void): this; + prependListener(event: "listening", listener: (worker: Worker, address: Address) => void): this; + prependListener(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + prependListener(event: "online", listener: (worker: Worker) => void): this; + prependListener(event: "setup", listener: (settings: any) => void): this; + + prependOnceListener(event: string, listener: Function): this; + prependOnceListener(event: "disconnect", listener: (worker: Worker) => void): this; + prependOnceListener(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): this; + prependOnceListener(event: "fork", listener: (worker: Worker) => void): this; + prependOnceListener(event: "listening", listener: (worker: Worker, address: Address) => void): this; + prependOnceListener(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): this; // the handle is a net.Socket or net.Server object, or undefined. + prependOnceListener(event: "online", listener: (worker: Worker) => void): this; + prependOnceListener(event: "setup", listener: (settings: any) => void): this; + + } + + export function disconnect(callback?: Function): void; + export function fork(env?: any): Worker; + export var isMaster: boolean; + export var isWorker: boolean; + // TODO: cluster.schedulingPolicy + export var settings: ClusterSettings; + export function setupMaster(settings?: ClusterSetupMasterSettings): void; + export var worker: Worker; + export var workers: { + [index: string]: Worker + }; + + /** + * events.EventEmitter + * 1. disconnect + * 2. exit + * 3. fork + * 4. listening + * 5. message + * 6. online + * 7. setup + */ + export function addListener(event: string, listener: Function): Cluster; + export function addListener(event: "disconnect", listener: (worker: Worker) => void): Cluster; + export function addListener(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): Cluster; + export function addListener(event: "fork", listener: (worker: Worker) => void): Cluster; + export function addListener(event: "listening", listener: (worker: Worker, address: Address) => void): Cluster; + export function addListener(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): Cluster; // the handle is a net.Socket or net.Server object, or undefined. + export function addListener(event: "online", listener: (worker: Worker) => void): Cluster; + export function addListener(event: "setup", listener: (settings: any) => void): Cluster; + + export function on(event: string, listener: Function): Cluster; + export function on(event: "disconnect", listener: (worker: Worker) => void): Cluster; + export function on(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): Cluster; + export function on(event: "fork", listener: (worker: Worker) => void): Cluster; + export function on(event: "listening", listener: (worker: Worker, address: Address) => void): Cluster; + export function on(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): Cluster; // the handle is a net.Socket or net.Server object, or undefined. + export function on(event: "online", listener: (worker: Worker) => void): Cluster; + export function on(event: "setup", listener: (settings: any) => void): Cluster; + + export function once(event: string, listener: Function): Cluster; + export function once(event: "disconnect", listener: (worker: Worker) => void): Cluster; + export function once(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): Cluster; + export function once(event: "fork", listener: (worker: Worker) => void): Cluster; + export function once(event: "listening", listener: (worker: Worker, address: Address) => void): Cluster; + export function once(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): Cluster; // the handle is a net.Socket or net.Server object, or undefined. + export function once(event: "online", listener: (worker: Worker) => void): Cluster; + export function once(event: "setup", listener: (settings: any) => void): Cluster; + + export function removeListener(event: string, listener: Function): Cluster; + export function removeAllListeners(event?: string): Cluster; + export function setMaxListeners(n: number): Cluster; + export function getMaxListeners(): number; + export function listeners(event: string): Function[]; + export function emit(event: string, ...args: any[]): boolean; + export function listenerCount(type: string): number; + + export function prependListener(event: string, listener: Function): Cluster; + export function prependListener(event: "disconnect", listener: (worker: Worker) => void): Cluster; + export function prependListener(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): Cluster; + export function prependListener(event: "fork", listener: (worker: Worker) => void): Cluster; + export function prependListener(event: "listening", listener: (worker: Worker, address: Address) => void): Cluster; + export function prependListener(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): Cluster; // the handle is a net.Socket or net.Server object, or undefined. + export function prependListener(event: "online", listener: (worker: Worker) => void): Cluster; + export function prependListener(event: "setup", listener: (settings: any) => void): Cluster; + + export function prependOnceListener(event: string, listener: Function): Cluster; + export function prependOnceListener(event: "disconnect", listener: (worker: Worker) => void): Cluster; + export function prependOnceListener(event: "exit", listener: (worker: Worker, code: number, signal: string) => void): Cluster; + export function prependOnceListener(event: "fork", listener: (worker: Worker) => void): Cluster; + export function prependOnceListener(event: "listening", listener: (worker: Worker, address: Address) => void): Cluster; + export function prependOnceListener(event: "message", listener: (worker: Worker, message: any, handle: net.Socket | net.Server) => void): Cluster; // the handle is a net.Socket or net.Server object, or undefined. + export function prependOnceListener(event: "online", listener: (worker: Worker) => void): Cluster; + export function prependOnceListener(event: "setup", listener: (settings: any) => void): Cluster; + + export function eventNames(): string[]; +} + +declare module "zlib" { + import * as stream from "stream"; + export interface ZlibOptions { chunkSize?: number; windowBits?: number; level?: number; memLevel?: number; strategy?: number; dictionary?: any; } + + export interface Gzip extends stream.Transform { } + export interface Gunzip extends stream.Transform { } + export interface Deflate extends stream.Transform { } + export interface Inflate extends stream.Transform { } + export interface DeflateRaw extends stream.Transform { } + export interface InflateRaw extends stream.Transform { } + export interface Unzip extends stream.Transform { } + + export function createGzip(options?: ZlibOptions): Gzip; + export function createGunzip(options?: ZlibOptions): Gunzip; + export function createDeflate(options?: ZlibOptions): Deflate; + export function createInflate(options?: ZlibOptions): Inflate; + export function createDeflateRaw(options?: ZlibOptions): DeflateRaw; + export function createInflateRaw(options?: ZlibOptions): InflateRaw; + export function createUnzip(options?: ZlibOptions): Unzip; + + export function deflate(buf: Buffer, callback: (error: Error, result: any) => void): void; + export function deflateSync(buf: Buffer, options?: ZlibOptions): any; + export function deflateRaw(buf: Buffer, callback: (error: Error, result: any) => void): void; + export function deflateRawSync(buf: Buffer, options?: ZlibOptions): any; + export function gzip(buf: Buffer, callback: (error: Error, result: any) => void): void; + export function gzipSync(buf: Buffer, options?: ZlibOptions): any; + export function gunzip(buf: Buffer, callback: (error: Error, result: any) => void): void; + export function gunzipSync(buf: Buffer, options?: ZlibOptions): any; + export function inflate(buf: Buffer, callback: (error: Error, result: any) => void): void; + export function inflateSync(buf: Buffer, options?: ZlibOptions): any; + export function inflateRaw(buf: Buffer, callback: (error: Error, result: any) => void): void; + export function inflateRawSync(buf: Buffer, options?: ZlibOptions): any; + export function unzip(buf: Buffer, callback: (error: Error, result: any) => void): void; + export function unzipSync(buf: Buffer, options?: ZlibOptions): any; + + // Constants + export var Z_NO_FLUSH: number; + export var Z_PARTIAL_FLUSH: number; + export var Z_SYNC_FLUSH: number; + export var Z_FULL_FLUSH: number; + export var Z_FINISH: number; + export var Z_BLOCK: number; + export var Z_TREES: number; + export var Z_OK: number; + export var Z_STREAM_END: number; + export var Z_NEED_DICT: number; + export var Z_ERRNO: number; + export var Z_STREAM_ERROR: number; + export var Z_DATA_ERROR: number; + export var Z_MEM_ERROR: number; + export var Z_BUF_ERROR: number; + export var Z_VERSION_ERROR: number; + export var Z_NO_COMPRESSION: number; + export var Z_BEST_SPEED: number; + export var Z_BEST_COMPRESSION: number; + export var Z_DEFAULT_COMPRESSION: number; + export var Z_FILTERED: number; + export var Z_HUFFMAN_ONLY: number; + export var Z_RLE: number; + export var Z_FIXED: number; + export var Z_DEFAULT_STRATEGY: number; + export var Z_BINARY: number; + export var Z_TEXT: number; + export var Z_ASCII: number; + export var Z_UNKNOWN: number; + export var Z_DEFLATED: number; + export var Z_NULL: number; +} + +declare module "os" { + export interface CpuInfo { + model: string; + speed: number; + times: { + user: number; + nice: number; + sys: number; + idle: number; + irq: number; + }; + } + + export interface NetworkInterfaceInfo { + address: string; + netmask: string; + family: string; + mac: string; + internal: boolean; + } + + export function hostname(): string; + export function loadavg(): number[]; + export function uptime(): number; + export function freemem(): number; + export function totalmem(): number; + export function cpus(): CpuInfo[]; + export function type(): string; + export function release(): string; + export function networkInterfaces(): { [index: string]: NetworkInterfaceInfo[] }; + export function homedir(): string; + export function userInfo(options?: { encoding: string }): { username: string, uid: number, gid: number, shell: any, homedir: string } + export var constants: { + UV_UDP_REUSEADDR: number, + errno: { + SIGHUP: number; + SIGINT: number; + SIGQUIT: number; + SIGILL: number; + SIGTRAP: number; + SIGABRT: number; + SIGIOT: number; + SIGBUS: number; + SIGFPE: number; + SIGKILL: number; + SIGUSR1: number; + SIGSEGV: number; + SIGUSR2: number; + SIGPIPE: number; + SIGALRM: number; + SIGTERM: number; + SIGCHLD: number; + SIGSTKFLT: number; + SIGCONT: number; + SIGSTOP: number; + SIGTSTP: number; + SIGTTIN: number; + SIGTTOU: number; + SIGURG: number; + SIGXCPU: number; + SIGXFSZ: number; + SIGVTALRM: number; + SIGPROF: number; + SIGWINCH: number; + SIGIO: number; + SIGPOLL: number; + SIGPWR: number; + SIGSYS: number; + SIGUNUSED: number; + }, + signals: { + E2BIG: number; + EACCES: number; + EADDRINUSE: number; + EADDRNOTAVAIL: number; + EAFNOSUPPORT: number; + EAGAIN: number; + EALREADY: number; + EBADF: number; + EBADMSG: number; + EBUSY: number; + ECANCELED: number; + ECHILD: number; + ECONNABORTED: number; + ECONNREFUSED: number; + ECONNRESET: number; + EDEADLK: number; + EDESTADDRREQ: number; + EDOM: number; + EDQUOT: number; + EEXIST: number; + EFAULT: number; + EFBIG: number; + EHOSTUNREACH: number; + EIDRM: number; + EILSEQ: number; + EINPROGRESS: number; + EINTR: number; + EINVAL: number; + EIO: number; + EISCONN: number; + EISDIR: number; + ELOOP: number; + EMFILE: number; + EMLINK: number; + EMSGSIZE: number; + EMULTIHOP: number; + ENAMETOOLONG: number; + ENETDOWN: number; + ENETRESET: number; + ENETUNREACH: number; + ENFILE: number; + ENOBUFS: number; + ENODATA: number; + ENODEV: number; + ENOENT: number; + ENOEXEC: number; + ENOLCK: number; + ENOLINK: number; + ENOMEM: number; + ENOMSG: number; + ENOPROTOOPT: number; + ENOSPC: number; + ENOSR: number; + ENOSTR: number; + ENOSYS: number; + ENOTCONN: number; + ENOTDIR: number; + ENOTEMPTY: number; + ENOTSOCK: number; + ENOTSUP: number; + ENOTTY: number; + ENXIO: number; + EOPNOTSUPP: number; + EOVERFLOW: number; + EPERM: number; + EPIPE: number; + EPROTO: number; + EPROTONOSUPPORT: number; + EPROTOTYPE: number; + ERANGE: number; + EROFS: number; + ESPIPE: number; + ESRCH: number; + ESTALE: number; + ETIME: number; + ETIMEDOUT: number; + ETXTBSY: number; + EWOULDBLOCK: number; + EXDEV: number; + }, + }; + export function arch(): string; + export function platform(): string; + export function tmpdir(): string; + export var EOL: string; + export function endianness(): "BE" | "LE"; +} + +declare module "https" { + import * as tls from "tls"; + import * as events from "events"; + import * as http from "http"; + + export interface ServerOptions { + pfx?: any; + key?: any; + passphrase?: string; + cert?: any; + ca?: any; + crl?: any; + ciphers?: string; + honorCipherOrder?: boolean; + requestCert?: boolean; + rejectUnauthorized?: boolean; + NPNProtocols?: any; + SNICallback?: (servername: string, cb: (err: Error, ctx: tls.SecureContext) => any) => any; + } + + export interface RequestOptions extends http.RequestOptions { + pfx?: any; + key?: any; + passphrase?: string; + cert?: any; + ca?: any; + ciphers?: string; + rejectUnauthorized?: boolean; + secureProtocol?: string; + } + + export interface Agent extends http.Agent { } + + export interface AgentOptions extends http.AgentOptions { + pfx?: any; + key?: any; + passphrase?: string; + cert?: any; + ca?: any; + ciphers?: string; + rejectUnauthorized?: boolean; + secureProtocol?: string; + maxCachedSessions?: number; + } + + export var Agent: { + new (options?: AgentOptions): Agent; + }; + export interface Server extends tls.Server { } + export function createServer(options: ServerOptions, requestListener?: Function): Server; + export function request(options: RequestOptions, callback?: (res: http.IncomingMessage) => void): http.ClientRequest; + export function get(options: RequestOptions, callback?: (res: http.IncomingMessage) => void): http.ClientRequest; + export var globalAgent: Agent; +} + +declare module "punycode" { + export function decode(string: string): string; + export function encode(string: string): string; + export function toUnicode(domain: string): string; + export function toASCII(domain: string): string; + export var ucs2: ucs2; + interface ucs2 { + decode(string: string): number[]; + encode(codePoints: number[]): string; + } + export var version: any; +} + +declare module "repl" { + import * as stream from "stream"; + import * as readline from "readline"; + + export interface ReplOptions { + prompt?: string; + input?: NodeJS.ReadableStream; + output?: NodeJS.WritableStream; + terminal?: boolean; + eval?: Function; + useColors?: boolean; + useGlobal?: boolean; + ignoreUndefined?: boolean; + writer?: Function; + completer?: Function; + replMode?: any; + breakEvalOnSigint?: any; + } + + export interface REPLServer extends readline.ReadLine { + defineCommand(keyword: string, cmd: Function | { help: string, action: Function }): void; + displayPrompt(preserveCursor?: boolean): void + } + + export function start(options: ReplOptions): REPLServer; +} + +declare module "readline" { + import * as events from "events"; + import * as stream from "stream"; + + export interface Key { + sequence?: string; + name?: string; + ctrl?: boolean; + meta?: boolean; + shift?: boolean; + } + + export interface ReadLine extends events.EventEmitter { + setPrompt(prompt: string): void; + prompt(preserveCursor?: boolean): void; + question(query: string, callback: (answer: string) => void): void; + pause(): ReadLine; + resume(): ReadLine; + close(): void; + write(data: string | Buffer, key?: Key): void; + } + + export interface Completer { + (line: string): CompleterResult; + (line: string, callback: (err: any, result: CompleterResult) => void): any; + } + + export interface CompleterResult { + completions: string[]; + line: string; + } + + export interface ReadLineOptions { + input: NodeJS.ReadableStream; + output?: NodeJS.WritableStream; + completer?: Completer; + terminal?: boolean; + historySize?: number; + } + + export function createInterface(input: NodeJS.ReadableStream, output?: NodeJS.WritableStream, completer?: Completer, terminal?: boolean): ReadLine; + export function createInterface(options: ReadLineOptions): ReadLine; + + export function cursorTo(stream: NodeJS.WritableStream, x: number, y: number): void; + export function moveCursor(stream: NodeJS.WritableStream, dx: number | string, dy: number | string): void; + export function clearLine(stream: NodeJS.WritableStream, dir: number): void; + export function clearScreenDown(stream: NodeJS.WritableStream): void; +} + +declare module "vm" { + export interface Context { } + export interface ScriptOptions { + filename?: string; + lineOffset?: number; + columnOffset?: number; + displayErrors?: boolean; + timeout?: number; + cachedData?: Buffer; + produceCachedData?: boolean; + } + export interface RunningScriptOptions { + filename?: string; + lineOffset?: number; + columnOffset?: number; + displayErrors?: boolean; + timeout?: number; + } + export class Script { + constructor(code: string, options?: ScriptOptions); + runInContext(contextifiedSandbox: Context, options?: RunningScriptOptions): any; + runInNewContext(sandbox?: Context, options?: RunningScriptOptions): any; + runInThisContext(options?: RunningScriptOptions): any; + } + export function createContext(sandbox?: Context): Context; + export function isContext(sandbox: Context): boolean; + export function runInContext(code: string, contextifiedSandbox: Context, options?: RunningScriptOptions): any; + export function runInDebugContext(code: string): any; + export function runInNewContext(code: string, sandbox?: Context, options?: RunningScriptOptions): any; + export function runInThisContext(code: string, options?: RunningScriptOptions): any; +} + +declare module "child_process" { + import * as events from "events"; + import * as stream from "stream"; + + export interface ChildProcess extends events.EventEmitter { + stdin: stream.Writable; + stdout: stream.Readable; + stderr: stream.Readable; + stdio: [stream.Writable, stream.Readable, stream.Readable]; + pid: number; + kill(signal?: string): void; + send(message: any, sendHandle?: any): boolean; + connected: boolean; + disconnect(): void; + unref(): void; + ref(): void; + } + + export interface SpawnOptions { + cwd?: string; + env?: any; + stdio?: any; + detached?: boolean; + uid?: number; + gid?: number; + shell?: boolean | string; + } + export function spawn(command: string, args?: string[], options?: SpawnOptions): ChildProcess; + + export interface ExecOptions { + cwd?: string; + env?: any; + shell?: string; + timeout?: number; + maxBuffer?: number; + killSignal?: string; + uid?: number; + gid?: number; + } + export interface ExecOptionsWithStringEncoding extends ExecOptions { + encoding: BufferEncoding; + } + export interface ExecOptionsWithBufferEncoding extends ExecOptions { + encoding: string; // specify `null`. + } + export function exec(command: string, callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + export function exec(command: string, options: ExecOptionsWithStringEncoding, callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + // usage. child_process.exec("tsc", {encoding: null as string}, (err, stdout, stderr) => {}); + export function exec(command: string, options: ExecOptionsWithBufferEncoding, callback?: (error: Error, stdout: Buffer, stderr: Buffer) => void): ChildProcess; + export function exec(command: string, options: ExecOptions, callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + + export interface ExecFileOptions { + cwd?: string; + env?: any; + timeout?: number; + maxBuffer?: number; + killSignal?: string; + uid?: number; + gid?: number; + } + export interface ExecFileOptionsWithStringEncoding extends ExecFileOptions { + encoding: BufferEncoding; + } + export interface ExecFileOptionsWithBufferEncoding extends ExecFileOptions { + encoding: string; // specify `null`. + } + export function execFile(file: string, callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + export function execFile(file: string, options?: ExecFileOptionsWithStringEncoding, callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + // usage. child_process.execFile("file.sh", {encoding: null as string}, (err, stdout, stderr) => {}); + export function execFile(file: string, options?: ExecFileOptionsWithBufferEncoding, callback?: (error: Error, stdout: Buffer, stderr: Buffer) => void): ChildProcess; + export function execFile(file: string, options?: ExecFileOptions, callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + export function execFile(file: string, args?: string[], callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + export function execFile(file: string, args?: string[], options?: ExecFileOptionsWithStringEncoding, callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + // usage. child_process.execFile("file.sh", ["foo"], {encoding: null as string}, (err, stdout, stderr) => {}); + export function execFile(file: string, args?: string[], options?: ExecFileOptionsWithBufferEncoding, callback?: (error: Error, stdout: Buffer, stderr: Buffer) => void): ChildProcess; + export function execFile(file: string, args?: string[], options?: ExecFileOptions, callback?: (error: Error, stdout: string, stderr: string) => void): ChildProcess; + + export interface ForkOptions { + cwd?: string; + env?: any; + execPath?: string; + execArgv?: string[]; + silent?: boolean; + uid?: number; + gid?: number; + } + export function fork(modulePath: string, args?: string[], options?: ForkOptions): ChildProcess; + + export interface SpawnSyncOptions { + cwd?: string; + input?: string | Buffer; + stdio?: any; + env?: any; + uid?: number; + gid?: number; + timeout?: number; + killSignal?: string; + maxBuffer?: number; + encoding?: string; + shell?: boolean | string; + } + export interface SpawnSyncOptionsWithStringEncoding extends SpawnSyncOptions { + encoding: BufferEncoding; + } + export interface SpawnSyncOptionsWithBufferEncoding extends SpawnSyncOptions { + encoding: string; // specify `null`. + } + export interface SpawnSyncReturns { + pid: number; + output: string[]; + stdout: T; + stderr: T; + status: number; + signal: string; + error: Error; + } + export function spawnSync(command: string): SpawnSyncReturns; + export function spawnSync(command: string, options?: SpawnSyncOptionsWithStringEncoding): SpawnSyncReturns; + export function spawnSync(command: string, options?: SpawnSyncOptionsWithBufferEncoding): SpawnSyncReturns; + export function spawnSync(command: string, options?: SpawnSyncOptions): SpawnSyncReturns; + export function spawnSync(command: string, args?: string[], options?: SpawnSyncOptionsWithStringEncoding): SpawnSyncReturns; + export function spawnSync(command: string, args?: string[], options?: SpawnSyncOptionsWithBufferEncoding): SpawnSyncReturns; + export function spawnSync(command: string, args?: string[], options?: SpawnSyncOptions): SpawnSyncReturns; + + export interface ExecSyncOptions { + cwd?: string; + input?: string | Buffer; + stdio?: any; + env?: any; + shell?: string; + uid?: number; + gid?: number; + timeout?: number; + killSignal?: string; + maxBuffer?: number; + encoding?: string; + } + export interface ExecSyncOptionsWithStringEncoding extends ExecSyncOptions { + encoding: BufferEncoding; + } + export interface ExecSyncOptionsWithBufferEncoding extends ExecSyncOptions { + encoding: string; // specify `null`. + } + export function execSync(command: string): Buffer; + export function execSync(command: string, options?: ExecSyncOptionsWithStringEncoding): string; + export function execSync(command: string, options?: ExecSyncOptionsWithBufferEncoding): Buffer; + export function execSync(command: string, options?: ExecSyncOptions): Buffer; + + export interface ExecFileSyncOptions { + cwd?: string; + input?: string | Buffer; + stdio?: any; + env?: any; + uid?: number; + gid?: number; + timeout?: number; + killSignal?: string; + maxBuffer?: number; + encoding?: string; + } + export interface ExecFileSyncOptionsWithStringEncoding extends ExecFileSyncOptions { + encoding: BufferEncoding; + } + export interface ExecFileSyncOptionsWithBufferEncoding extends ExecFileSyncOptions { + encoding: string; // specify `null`. + } + export function execFileSync(command: string): Buffer; + export function execFileSync(command: string, options?: ExecFileSyncOptionsWithStringEncoding): string; + export function execFileSync(command: string, options?: ExecFileSyncOptionsWithBufferEncoding): Buffer; + export function execFileSync(command: string, options?: ExecFileSyncOptions): Buffer; + export function execFileSync(command: string, args?: string[], options?: ExecFileSyncOptionsWithStringEncoding): string; + export function execFileSync(command: string, args?: string[], options?: ExecFileSyncOptionsWithBufferEncoding): Buffer; + export function execFileSync(command: string, args?: string[], options?: ExecFileSyncOptions): Buffer; +} + +declare module "url" { + export interface Url { + href?: string; + protocol?: string; + auth?: string; + hostname?: string; + port?: string; + host?: string; + pathname?: string; + search?: string; + query?: string | any; + slashes?: boolean; + hash?: string; + path?: string; + } + + export function parse(urlStr: string, parseQueryString?: boolean, slashesDenoteHost?: boolean): Url; + export function format(url: Url): string; + export function resolve(from: string, to: string): string; +} + +declare module "dns" { + export interface MxRecord { + exchange: string, + priority: number + } + + export function lookup(domain: string, family: number, callback: (err: Error, address: string, family: number) => void): string; + export function lookup(domain: string, callback: (err: Error, address: string, family: number) => void): string; + export function resolve(domain: string, rrtype: string, callback: (err: Error, addresses: string[]) => void): string[]; + export function resolve(domain: string, callback: (err: Error, addresses: string[]) => void): string[]; + export function resolve4(domain: string, callback: (err: Error, addresses: string[]) => void): string[]; + export function resolve6(domain: string, callback: (err: Error, addresses: string[]) => void): string[]; + export function resolveMx(domain: string, callback: (err: Error, addresses: MxRecord[]) => void): string[]; + export function resolveTxt(domain: string, callback: (err: Error, addresses: string[]) => void): string[]; + export function resolveSrv(domain: string, callback: (err: Error, addresses: string[]) => void): string[]; + export function resolveNs(domain: string, callback: (err: Error, addresses: string[]) => void): string[]; + export function resolveCname(domain: string, callback: (err: Error, addresses: string[]) => void): string[]; + export function reverse(ip: string, callback: (err: Error, domains: string[]) => void): string[]; + export function setServers(servers: string[]): void; + + //Error codes + export var NODATA: string; + export var FORMERR: string; + export var SERVFAIL: string; + export var NOTFOUND: string; + export var NOTIMP: string; + export var REFUSED: string; + export var BADQUERY: string; + export var BADNAME: string; + export var BADFAMILY: string; + export var BADRESP: string; + export var CONNREFUSED: string; + export var TIMEOUT: string; + export var EOF: string; + export var FILE: string; + export var NOMEM: string; + export var DESTRUCTION: string; + export var BADSTR: string; + export var BADFLAGS: string; + export var NONAME: string; + export var BADHINTS: string; + export var NOTINITIALIZED: string; + export var LOADIPHLPAPI: string; + export var ADDRGETNETWORKPARAMS: string; + export var CANCELLED: string; +} + +declare module "net" { + import * as stream from "stream"; + + export interface Socket extends stream.Duplex { + // Extended base methods + write(buffer: Buffer): boolean; + write(buffer: Buffer, cb?: Function): boolean; + write(str: string, cb?: Function): boolean; + write(str: string, encoding?: string, cb?: Function): boolean; + write(str: string, encoding?: string, fd?: string): boolean; + + connect(port: number, host?: string, connectionListener?: Function): void; + connect(path: string, connectionListener?: Function): void; + bufferSize: number; + setEncoding(encoding?: string): void; + write(data: any, encoding?: string, callback?: Function): void; + destroy(): void; + pause(): Socket; + resume(): Socket; + setTimeout(timeout: number, callback?: Function): void; + setNoDelay(noDelay?: boolean): void; + setKeepAlive(enable?: boolean, initialDelay?: number): void; + address(): { port: number; family: string; address: string; }; + unref(): void; + ref(): void; + + remoteAddress: string; + remoteFamily: string; + remotePort: number; + localAddress: string; + localPort: number; + bytesRead: number; + bytesWritten: number; + + // Extended base methods + end(): void; + end(buffer: Buffer, cb?: Function): void; + end(str: string, cb?: Function): void; + end(str: string, encoding?: string, cb?: Function): void; + end(data?: any, encoding?: string): void; + + /** + * events.EventEmitter + * 1. close + * 2. connect + * 3. data + * 4. drain + * 5. end + * 6. error + * 7. lookup + * 8. timeout + */ + addListener(event: string, listener: Function): this; + addListener(event: "close", listener: (had_error: boolean) => void): this; + addListener(event: "connect", listener: () => void): this; + addListener(event: "data", listener: (data: Buffer) => void): this; + addListener(event: "drain", listener: () => void): this; + addListener(event: "end", listener: () => void): this; + addListener(event: "error", listener: (err: Error) => void): this; + addListener(event: "lookup", listener: (err: Error, address: string, family: string | number, host: string) => void): this; + addListener(event: "timeout", listener: () => void): this; + + emit(event: string, ...args: any[]): boolean; + emit(event: "close", had_error: boolean): boolean; + emit(event: "connect"): boolean; + emit(event: "data", data: Buffer): boolean; + emit(event: "drain"): boolean; + emit(event: "end"): boolean; + emit(event: "error", err: Error): boolean; + emit(event: "lookup", err: Error, address: string, family: string | number, host: string): boolean; + emit(event: "timeout"): boolean; + + on(event: string, listener: Function): this; + on(event: "close", listener: (had_error: boolean) => void): this; + on(event: "connect", listener: () => void): this; + on(event: "data", listener: (data: Buffer) => void): this; + on(event: "drain", listener: () => void): this; + on(event: "end", listener: () => void): this; + on(event: "error", listener: (err: Error) => void): this; + on(event: "lookup", listener: (err: Error, address: string, family: string | number, host: string) => void): this; + on(event: "timeout", listener: () => void): this; + + once(event: string, listener: Function): this; + once(event: "close", listener: (had_error: boolean) => void): this; + once(event: "connect", listener: () => void): this; + once(event: "data", listener: (data: Buffer) => void): this; + once(event: "drain", listener: () => void): this; + once(event: "end", listener: () => void): this; + once(event: "error", listener: (err: Error) => void): this; + once(event: "lookup", listener: (err: Error, address: string, family: string | number, host: string) => void): this; + once(event: "timeout", listener: () => void): this; + + prependListener(event: string, listener: Function): this; + prependListener(event: "close", listener: (had_error: boolean) => void): this; + prependListener(event: "connect", listener: () => void): this; + prependListener(event: "data", listener: (data: Buffer) => void): this; + prependListener(event: "drain", listener: () => void): this; + prependListener(event: "end", listener: () => void): this; + prependListener(event: "error", listener: (err: Error) => void): this; + prependListener(event: "lookup", listener: (err: Error, address: string, family: string | number, host: string) => void): this; + prependListener(event: "timeout", listener: () => void): this; + + prependOnceListener(event: string, listener: Function): this; + prependOnceListener(event: "close", listener: (had_error: boolean) => void): this; + prependOnceListener(event: "connect", listener: () => void): this; + prependOnceListener(event: "data", listener: (data: Buffer) => void): this; + prependOnceListener(event: "drain", listener: () => void): this; + prependOnceListener(event: "end", listener: () => void): this; + prependOnceListener(event: "error", listener: (err: Error) => void): this; + prependOnceListener(event: "lookup", listener: (err: Error, address: string, family: string | number, host: string) => void): this; + prependOnceListener(event: "timeout", listener: () => void): this; + } + + export var Socket: { + new (options?: { fd?: string; type?: string; allowHalfOpen?: boolean; }): Socket; + }; + + export interface ListenOptions { + port?: number; + host?: string; + backlog?: number; + path?: string; + exclusive?: boolean; + } + + export interface Server extends Socket { + listen(port: number, hostname?: string, backlog?: number, listeningListener?: Function): Server; + listen(port: number, hostname?: string, listeningListener?: Function): Server; + listen(port: number, backlog?: number, listeningListener?: Function): Server; + listen(port: number, listeningListener?: Function): Server; + listen(path: string, backlog?: number, listeningListener?: Function): Server; + listen(path: string, listeningListener?: Function): Server; + listen(handle: any, backlog?: number, listeningListener?: Function): Server; + listen(handle: any, listeningListener?: Function): Server; + listen(options: ListenOptions, listeningListener?: Function): Server; + close(callback?: Function): Server; + address(): { port: number; family: string; address: string; }; + getConnections(cb: (error: Error, count: number) => void): void; + ref(): Server; + unref(): Server; + maxConnections: number; + connections: number; + + /** + * events.EventEmitter + * 1. close + * 2. connection + * 3. error + * 4. listening + */ + addListener(event: string, listener: Function): this; + addListener(event: "close", listener: () => void): this; + addListener(event: "connection", listener: (socket: Socket) => void): this; + addListener(event: "error", listener: (err: Error) => void): this; + addListener(event: "listening", listener: () => void): this; + + emit(event: string, ...args: any[]): boolean; + emit(event: "close"): boolean; + emit(event: "connection", socket: Socket): boolean; + emit(event: "error", err: Error): boolean; + emit(event: "listening"): boolean; + + on(event: string, listener: Function): this; + on(event: "close", listener: () => void): this; + on(event: "connection", listener: (socket: Socket) => void): this; + on(event: "error", listener: (err: Error) => void): this; + on(event: "listening", listener: () => void): this; + + once(event: string, listener: Function): this; + once(event: "close", listener: () => void): this; + once(event: "connection", listener: (socket: Socket) => void): this; + once(event: "error", listener: (err: Error) => void): this; + once(event: "listening", listener: () => void): this; + + prependListener(event: string, listener: Function): this; + prependListener(event: "close", listener: () => void): this; + prependListener(event: "connection", listener: (socket: Socket) => void): this; + prependListener(event: "error", listener: (err: Error) => void): this; + prependListener(event: "listening", listener: () => void): this; + + prependOnceListener(event: string, listener: Function): this; + prependOnceListener(event: "close", listener: () => void): this; + prependOnceListener(event: "connection", listener: (socket: Socket) => void): this; + prependOnceListener(event: "error", listener: (err: Error) => void): this; + prependOnceListener(event: "listening", listener: () => void): this; + } + export function createServer(connectionListener?: (socket: Socket) => void): Server; + export function createServer(options?: { allowHalfOpen?: boolean; }, connectionListener?: (socket: Socket) => void): Server; + export function connect(options: { port: number, host?: string, localAddress?: string, localPort?: string, family?: number, allowHalfOpen?: boolean; }, connectionListener?: Function): Socket; + export function connect(port: number, host?: string, connectionListener?: Function): Socket; + export function connect(path: string, connectionListener?: Function): Socket; + export function createConnection(options: { port: number, host?: string, localAddress?: string, localPort?: string, family?: number, allowHalfOpen?: boolean; }, connectionListener?: Function): Socket; + export function createConnection(port: number, host?: string, connectionListener?: Function): Socket; + export function createConnection(path: string, connectionListener?: Function): Socket; + export function isIP(input: string): number; + export function isIPv4(input: string): boolean; + export function isIPv6(input: string): boolean; +} + +declare module "dgram" { + import * as events from "events"; + + interface RemoteInfo { + address: string; + port: number; + size: number; + } + + interface AddressInfo { + address: string; + family: string; + port: number; + } + + interface BindOptions { + port: number; + address?: string; + exclusive?: boolean; + } + + interface SocketOptions { + type: "udp4" | "udp6"; + reuseAddr?: boolean; + } + + export function createSocket(type: string, callback?: (msg: Buffer, rinfo: RemoteInfo) => void): Socket; + export function createSocket(options: SocketOptions, callback?: (msg: Buffer, rinfo: RemoteInfo) => void): Socket; + + export interface Socket extends events.EventEmitter { + send(msg: Buffer | String | any[], port: number, address: string, callback?: (error: Error, bytes: number) => void): void; + send(msg: Buffer | String | any[], offset: number, length: number, port: number, address: string, callback?: (error: Error, bytes: number) => void): void; + bind(port?: number, address?: string, callback?: () => void): void; + bind(options: BindOptions, callback?: Function): void; + close(callback?: any): void; + address(): AddressInfo; + setBroadcast(flag: boolean): void; + setTTL(ttl: number): void; + setMulticastTTL(ttl: number): void; + setMulticastLoopback(flag: boolean): void; + addMembership(multicastAddress: string, multicastInterface?: string): void; + dropMembership(multicastAddress: string, multicastInterface?: string): void; + ref(): void; + unref(): void; + } +} + +declare module "fs" { + import * as stream from "stream"; + import * as events from "events"; + + interface Stats { + isFile(): boolean; + isDirectory(): boolean; + isBlockDevice(): boolean; + isCharacterDevice(): boolean; + isSymbolicLink(): boolean; + isFIFO(): boolean; + isSocket(): boolean; + dev: number; + ino: number; + mode: number; + nlink: number; + uid: number; + gid: number; + rdev: number; + size: number; + blksize: number; + blocks: number; + atime: Date; + mtime: Date; + ctime: Date; + birthtime: Date; + } + + interface FSWatcher extends events.EventEmitter { + close(): void; + + /** + * events.EventEmitter + * 1. change + * 2. error + */ + addListener(event: string, listener: Function): this; + addListener(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this; + addListener(event: "error", listener: (code: number, signal: string) => void): this; + + on(event: string, listener: Function): this; + on(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this; + on(event: "error", listener: (code: number, signal: string) => void): this; + + once(event: string, listener: Function): this; + once(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this; + once(event: "error", listener: (code: number, signal: string) => void): this; + + prependListener(event: string, listener: Function): this; + prependListener(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this; + prependListener(event: "error", listener: (code: number, signal: string) => void): this; + + prependOnceListener(event: string, listener: Function): this; + prependOnceListener(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this; + prependOnceListener(event: "error", listener: (code: number, signal: string) => void): this; + } + + export interface ReadStream extends stream.Readable { + close(): void; + destroy(): void; + + /** + * events.EventEmitter + * 1. open + * 2. close + */ + addListener(event: string, listener: Function): this; + addListener(event: "open", listener: (fd: number) => void): this; + addListener(event: "close", listener: () => void): this; + + on(event: string, listener: Function): this; + on(event: "open", listener: (fd: number) => void): this; + on(event: "close", listener: () => void): this; + + once(event: string, listener: Function): this; + once(event: "open", listener: (fd: number) => void): this; + once(event: "close", listener: () => void): this; + + prependListener(event: string, listener: Function): this; + prependListener(event: "open", listener: (fd: number) => void): this; + prependListener(event: "close", listener: () => void): this; + + prependOnceListener(event: string, listener: Function): this; + prependOnceListener(event: "open", listener: (fd: number) => void): this; + prependOnceListener(event: "close", listener: () => void): this; + } + + export interface WriteStream extends stream.Writable { + close(): void; + bytesWritten: number; + path: string | Buffer; + + /** + * events.EventEmitter + * 1. open + * 2. close + */ + addListener(event: string, listener: Function): this; + addListener(event: "open", listener: (fd: number) => void): this; + addListener(event: "close", listener: () => void): this; + + on(event: string, listener: Function): this; + on(event: "open", listener: (fd: number) => void): this; + on(event: "close", listener: () => void): this; + + once(event: string, listener: Function): this; + once(event: "open", listener: (fd: number) => void): this; + once(event: "close", listener: () => void): this; + + prependListener(event: string, listener: Function): this; + prependListener(event: "open", listener: (fd: number) => void): this; + prependListener(event: "close", listener: () => void): this; + + prependOnceListener(event: string, listener: Function): this; + prependOnceListener(event: "open", listener: (fd: number) => void): this; + prependOnceListener(event: "close", listener: () => void): this; + } + + /** + * Asynchronous rename. + * @param oldPath + * @param newPath + * @param callback No arguments other than a possible exception are given to the completion callback. + */ + export function rename(oldPath: string, newPath: string, callback?: (err?: NodeJS.ErrnoException) => void): void; + /** + * Synchronous rename + * @param oldPath + * @param newPath + */ + export function renameSync(oldPath: string, newPath: string): void; + export function truncate(path: string | Buffer, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function truncate(path: string | Buffer, len: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function truncateSync(path: string | Buffer, len?: number): void; + export function ftruncate(fd: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function ftruncate(fd: number, len: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function ftruncateSync(fd: number, len?: number): void; + export function chown(path: string | Buffer, uid: number, gid: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function chownSync(path: string | Buffer, uid: number, gid: number): void; + export function fchown(fd: number, uid: number, gid: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function fchownSync(fd: number, uid: number, gid: number): void; + export function lchown(path: string | Buffer, uid: number, gid: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function lchownSync(path: string | Buffer, uid: number, gid: number): void; + export function chmod(path: string | Buffer, mode: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function chmod(path: string | Buffer, mode: string, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function chmodSync(path: string | Buffer, mode: number): void; + export function chmodSync(path: string | Buffer, mode: string): void; + export function fchmod(fd: number, mode: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function fchmod(fd: number, mode: string, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function fchmodSync(fd: number, mode: number): void; + export function fchmodSync(fd: number, mode: string): void; + export function lchmod(path: string | Buffer, mode: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function lchmod(path: string | Buffer, mode: string, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function lchmodSync(path: string | Buffer, mode: number): void; + export function lchmodSync(path: string | Buffer, mode: string): void; + export function stat(path: string | Buffer, callback?: (err: NodeJS.ErrnoException, stats: Stats) => any): void; + export function lstat(path: string | Buffer, callback?: (err: NodeJS.ErrnoException, stats: Stats) => any): void; + export function fstat(fd: number, callback?: (err: NodeJS.ErrnoException, stats: Stats) => any): void; + export function statSync(path: string | Buffer): Stats; + export function lstatSync(path: string | Buffer): Stats; + export function fstatSync(fd: number): Stats; + export function link(srcpath: string | Buffer, dstpath: string | Buffer, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function linkSync(srcpath: string | Buffer, dstpath: string | Buffer): void; + export function symlink(srcpath: string | Buffer, dstpath: string | Buffer, type?: string, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function symlinkSync(srcpath: string | Buffer, dstpath: string | Buffer, type?: string): void; + export function readlink(path: string | Buffer, callback?: (err: NodeJS.ErrnoException, linkString: string) => any): void; + export function readlinkSync(path: string | Buffer): string; + export function realpath(path: string | Buffer, callback?: (err: NodeJS.ErrnoException, resolvedPath: string) => any): void; + export function realpath(path: string | Buffer, cache: { [path: string]: string }, callback: (err: NodeJS.ErrnoException, resolvedPath: string) => any): void; + export function realpathSync(path: string | Buffer, cache?: { [path: string]: string }): string; + /* + * Asynchronous unlink - deletes the file specified in {path} + * + * @param path + * @param callback No arguments other than a possible exception are given to the completion callback. + */ + export function unlink(path: string | Buffer, callback?: (err?: NodeJS.ErrnoException) => void): void; + /* + * Synchronous unlink - deletes the file specified in {path} + * + * @param path + */ + export function unlinkSync(path: string | Buffer): void; + /* + * Asynchronous rmdir - removes the directory specified in {path} + * + * @param path + * @param callback No arguments other than a possible exception are given to the completion callback. + */ + export function rmdir(path: string | Buffer, callback?: (err?: NodeJS.ErrnoException) => void): void; + /* + * Synchronous rmdir - removes the directory specified in {path} + * + * @param path + */ + export function rmdirSync(path: string | Buffer): void; + /* + * Asynchronous mkdir - creates the directory specified in {path}. Parameter {mode} defaults to 0777. + * + * @param path + * @param callback No arguments other than a possible exception are given to the completion callback. + */ + export function mkdir(path: string | Buffer, callback?: (err?: NodeJS.ErrnoException) => void): void; + /* + * Asynchronous mkdir - creates the directory specified in {path}. Parameter {mode} defaults to 0777. + * + * @param path + * @param mode + * @param callback No arguments other than a possible exception are given to the completion callback. + */ + export function mkdir(path: string | Buffer, mode: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + /* + * Asynchronous mkdir - creates the directory specified in {path}. Parameter {mode} defaults to 0777. + * + * @param path + * @param mode + * @param callback No arguments other than a possible exception are given to the completion callback. + */ + export function mkdir(path: string | Buffer, mode: string, callback?: (err?: NodeJS.ErrnoException) => void): void; + /* + * Synchronous mkdir - creates the directory specified in {path}. Parameter {mode} defaults to 0777. + * + * @param path + * @param mode + * @param callback No arguments other than a possible exception are given to the completion callback. + */ + export function mkdirSync(path: string | Buffer, mode?: number): void; + /* + * Synchronous mkdir - creates the directory specified in {path}. Parameter {mode} defaults to 0777. + * + * @param path + * @param mode + * @param callback No arguments other than a possible exception are given to the completion callback. + */ + export function mkdirSync(path: string | Buffer, mode?: string): void; + /* + * Asynchronous mkdtemp - Creates a unique temporary directory. Generates six random characters to be appended behind a required prefix to create a unique temporary directory. + * + * @param prefix + * @param callback The created folder path is passed as a string to the callback's second parameter. + */ + export function mkdtemp(prefix: string, callback?: (err: NodeJS.ErrnoException, folder: string) => void): void; + /* + * Synchronous mkdtemp - Creates a unique temporary directory. Generates six random characters to be appended behind a required prefix to create a unique temporary directory. + * + * @param prefix + * @returns Returns the created folder path. + */ + export function mkdtempSync(prefix: string): string; + export function readdir(path: string | Buffer, callback?: (err: NodeJS.ErrnoException, files: string[]) => void): void; + export function readdirSync(path: string | Buffer): string[]; + export function close(fd: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function closeSync(fd: number): void; + export function open(path: string | Buffer, flags: string | number, callback: (err: NodeJS.ErrnoException, fd: number) => void): void; + export function open(path: string | Buffer, flags: string | number, mode: number, callback: (err: NodeJS.ErrnoException, fd: number) => void): void; + export function openSync(path: string | Buffer, flags: string | number, mode?: number): number; + export function utimes(path: string | Buffer, atime: number, mtime: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function utimes(path: string | Buffer, atime: Date, mtime: Date, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function utimesSync(path: string | Buffer, atime: number, mtime: number): void; + export function utimesSync(path: string | Buffer, atime: Date, mtime: Date): void; + export function futimes(fd: number, atime: number, mtime: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function futimes(fd: number, atime: Date, mtime: Date, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function futimesSync(fd: number, atime: number, mtime: number): void; + export function futimesSync(fd: number, atime: Date, mtime: Date): void; + export function fsync(fd: number, callback?: (err?: NodeJS.ErrnoException) => void): void; + export function fsyncSync(fd: number): void; + export function write(fd: number, buffer: Buffer, offset: number, length: number, position: number, callback?: (err: NodeJS.ErrnoException, written: number, buffer: Buffer) => void): void; + export function write(fd: number, buffer: Buffer, offset: number, length: number, callback?: (err: NodeJS.ErrnoException, written: number, buffer: Buffer) => void): void; + export function write(fd: number, data: any, callback?: (err: NodeJS.ErrnoException, written: number, str: string) => void): void; + export function write(fd: number, data: any, offset: number, callback?: (err: NodeJS.ErrnoException, written: number, str: string) => void): void; + export function write(fd: number, data: any, offset: number, encoding: string, callback?: (err: NodeJS.ErrnoException, written: number, str: string) => void): void; + export function writeSync(fd: number, buffer: Buffer, offset: number, length: number, position?: number): number; + export function writeSync(fd: number, data: any, position?: number, enconding?: string): number; + export function read(fd: number, buffer: Buffer, offset: number, length: number, position: number, callback?: (err: NodeJS.ErrnoException, bytesRead: number, buffer: Buffer) => void): void; + export function readSync(fd: number, buffer: Buffer, offset: number, length: number, position: number): number; + /* + * Asynchronous readFile - Asynchronously reads the entire contents of a file. + * + * @param fileName + * @param encoding + * @param callback - The callback is passed two arguments (err, data), where data is the contents of the file. + */ + export function readFile(filename: string, encoding: string, callback: (err: NodeJS.ErrnoException, data: string) => void): void; + /* + * Asynchronous readFile - Asynchronously reads the entire contents of a file. + * + * @param fileName + * @param options An object with optional {encoding} and {flag} properties. If {encoding} is specified, readFile returns a string; otherwise it returns a Buffer. + * @param callback - The callback is passed two arguments (err, data), where data is the contents of the file. + */ + export function readFile(filename: string, options: { encoding: string; flag?: string; }, callback: (err: NodeJS.ErrnoException, data: string) => void): void; + /* + * Asynchronous readFile - Asynchronously reads the entire contents of a file. + * + * @param fileName + * @param options An object with optional {encoding} and {flag} properties. If {encoding} is specified, readFile returns a string; otherwise it returns a Buffer. + * @param callback - The callback is passed two arguments (err, data), where data is the contents of the file. + */ + export function readFile(filename: string, options: { flag?: string; }, callback: (err: NodeJS.ErrnoException, data: Buffer) => void): void; + /* + * Asynchronous readFile - Asynchronously reads the entire contents of a file. + * + * @param fileName + * @param callback - The callback is passed two arguments (err, data), where data is the contents of the file. + */ + export function readFile(filename: string, callback: (err: NodeJS.ErrnoException, data: Buffer) => void): void; + /* + * Synchronous readFile - Synchronously reads the entire contents of a file. + * + * @param fileName + * @param encoding + */ + export function readFileSync(filename: string, encoding: string): string; + /* + * Synchronous readFile - Synchronously reads the entire contents of a file. + * + * @param fileName + * @param options An object with optional {encoding} and {flag} properties. If {encoding} is specified, readFileSync returns a string; otherwise it returns a Buffer. + */ + export function readFileSync(filename: string, options: { encoding: string; flag?: string; }): string; + /* + * Synchronous readFile - Synchronously reads the entire contents of a file. + * + * @param fileName + * @param options An object with optional {encoding} and {flag} properties. If {encoding} is specified, readFileSync returns a string; otherwise it returns a Buffer. + */ + export function readFileSync(filename: string, options?: { flag?: string; }): Buffer; + export function writeFile(filename: string, data: any, callback?: (err: NodeJS.ErrnoException) => void): void; + export function writeFile(filename: string, data: any, options: { encoding?: string; mode?: number; flag?: string; }, callback?: (err: NodeJS.ErrnoException) => void): void; + export function writeFile(filename: string, data: any, options: { encoding?: string; mode?: string; flag?: string; }, callback?: (err: NodeJS.ErrnoException) => void): void; + export function writeFileSync(filename: string, data: any, options?: { encoding?: string; mode?: number; flag?: string; }): void; + export function writeFileSync(filename: string, data: any, options?: { encoding?: string; mode?: string; flag?: string; }): void; + export function appendFile(filename: string, data: any, options: { encoding?: string; mode?: number; flag?: string; }, callback?: (err: NodeJS.ErrnoException) => void): void; + export function appendFile(filename: string, data: any, options: { encoding?: string; mode?: string; flag?: string; }, callback?: (err: NodeJS.ErrnoException) => void): void; + export function appendFile(filename: string, data: any, callback?: (err: NodeJS.ErrnoException) => void): void; + export function appendFileSync(filename: string, data: any, options?: { encoding?: string; mode?: number; flag?: string; }): void; + export function appendFileSync(filename: string, data: any, options?: { encoding?: string; mode?: string; flag?: string; }): void; + export function watchFile(filename: string, listener: (curr: Stats, prev: Stats) => void): void; + export function watchFile(filename: string, options: { persistent?: boolean; interval?: number; }, listener: (curr: Stats, prev: Stats) => void): void; + export function unwatchFile(filename: string, listener?: (curr: Stats, prev: Stats) => void): void; + export function watch(filename: string, listener?: (event: string, filename: string) => any): FSWatcher; + export function watch(filename: string, encoding: string, listener?: (event: string, filename: string | Buffer) => any): FSWatcher; + export function watch(filename: string, options: { persistent?: boolean; recursive?: boolean; encoding?: string }, listener?: (event: string, filename: string | Buffer) => any): FSWatcher; + export function exists(path: string | Buffer, callback?: (exists: boolean) => void): void; + export function existsSync(path: string | Buffer): boolean; + + interface Constants { + /** Constant for fs.access(). File is visible to the calling process. */ + F_OK: number; + + /** Constant for fs.access(). File can be read by the calling process. */ + R_OK: number; + + /** Constant for fs.access(). File can be written by the calling process. */ + W_OK: number; + + /** Constant for fs.access(). File can be executed by the calling process. */ + X_OK: number; + } + + export const constants: Constants; + + /** Tests a user's permissions for the file specified by path. */ + export function access(path: string | Buffer, callback: (err: NodeJS.ErrnoException) => void): void; + export function access(path: string | Buffer, mode: number, callback: (err: NodeJS.ErrnoException) => void): void; + /** Synchronous version of fs.access. This throws if any accessibility checks fail, and does nothing otherwise. */ + export function accessSync(path: string | Buffer, mode?: number): void; + export function createReadStream(path: string | Buffer, options?: { + flags?: string; + encoding?: string; + fd?: number; + mode?: number; + autoClose?: boolean; + start?: number; + end?: number; + }): ReadStream; + export function createWriteStream(path: string | Buffer, options?: { + flags?: string; + encoding?: string; + fd?: number; + mode?: number; + }): WriteStream; + export function fdatasync(fd: number, callback: Function): void; + export function fdatasyncSync(fd: number): void; +} + +declare module "path" { + + /** + * A parsed path object generated by path.parse() or consumed by path.format(). + */ + export interface ParsedPath { + /** + * The root of the path such as '/' or 'c:\' + */ + root: string; + /** + * The full directory path such as '/home/user/dir' or 'c:\path\dir' + */ + dir: string; + /** + * The file name including extension (if any) such as 'index.html' + */ + base: string; + /** + * The file extension (if any) such as '.html' + */ + ext: string; + /** + * The file name without extension (if any) such as 'index' + */ + name: string; + } + + /** + * Normalize a string path, reducing '..' and '.' parts. + * When multiple slashes are found, they're replaced by a single one; when the path contains a trailing slash, it is preserved. On Windows backslashes are used. + * + * @param p string path to normalize. + */ + export function normalize(p: string): string; + /** + * Join all arguments together and normalize the resulting path. + * Arguments must be strings. In v0.8, non-string arguments were silently ignored. In v0.10 and up, an exception is thrown. + * + * @param paths string paths to join. + */ + export function join(...paths: any[]): string; + /** + * Join all arguments together and normalize the resulting path. + * Arguments must be strings. In v0.8, non-string arguments were silently ignored. In v0.10 and up, an exception is thrown. + * + * @param paths string paths to join. + */ + export function join(...paths: string[]): string; + /** + * The right-most parameter is considered {to}. Other parameters are considered an array of {from}. + * + * Starting from leftmost {from} paramter, resolves {to} to an absolute path. + * + * If {to} isn't already absolute, {from} arguments are prepended in right to left order, until an absolute path is found. If after using all {from} paths still no absolute path is found, the current working directory is used as well. The resulting path is normalized, and trailing slashes are removed unless the path gets resolved to the root directory. + * + * @param pathSegments string paths to join. Non-string arguments are ignored. + */ + export function resolve(...pathSegments: any[]): string; + /** + * Determines whether {path} is an absolute path. An absolute path will always resolve to the same location, regardless of the working directory. + * + * @param path path to test. + */ + export function isAbsolute(path: string): boolean; + /** + * Solve the relative path from {from} to {to}. + * At times we have two absolute paths, and we need to derive the relative path from one to the other. This is actually the reverse transform of path.resolve. + * + * @param from + * @param to + */ + export function relative(from: string, to: string): string; + /** + * Return the directory name of a path. Similar to the Unix dirname command. + * + * @param p the path to evaluate. + */ + export function dirname(p: string): string; + /** + * Return the last portion of a path. Similar to the Unix basename command. + * Often used to extract the file name from a fully qualified path. + * + * @param p the path to evaluate. + * @param ext optionally, an extension to remove from the result. + */ + export function basename(p: string, ext?: string): string; + /** + * Return the extension of the path, from the last '.' to end of string in the last portion of the path. + * If there is no '.' in the last portion of the path or the first character of it is '.', then it returns an empty string + * + * @param p the path to evaluate. + */ + export function extname(p: string): string; + /** + * The platform-specific file separator. '\\' or '/'. + */ + export var sep: string; + /** + * The platform-specific file delimiter. ';' or ':'. + */ + export var delimiter: string; + /** + * Returns an object from a path string - the opposite of format(). + * + * @param pathString path to evaluate. + */ + export function parse(pathString: string): ParsedPath; + /** + * Returns a path string from an object - the opposite of parse(). + * + * @param pathString path to evaluate. + */ + export function format(pathObject: ParsedPath): string; + + export module posix { + export function normalize(p: string): string; + export function join(...paths: any[]): string; + export function resolve(...pathSegments: any[]): string; + export function isAbsolute(p: string): boolean; + export function relative(from: string, to: string): string; + export function dirname(p: string): string; + export function basename(p: string, ext?: string): string; + export function extname(p: string): string; + export var sep: string; + export var delimiter: string; + export function parse(p: string): ParsedPath; + export function format(pP: ParsedPath): string; + } + + export module win32 { + export function normalize(p: string): string; + export function join(...paths: any[]): string; + export function resolve(...pathSegments: any[]): string; + export function isAbsolute(p: string): boolean; + export function relative(from: string, to: string): string; + export function dirname(p: string): string; + export function basename(p: string, ext?: string): string; + export function extname(p: string): string; + export var sep: string; + export var delimiter: string; + export function parse(p: string): ParsedPath; + export function format(pP: ParsedPath): string; + } +} + +declare module "string_decoder" { + export interface NodeStringDecoder { + write(buffer: Buffer): string; + end(buffer?: Buffer): string; + } + export var StringDecoder: { + new (encoding?: string): NodeStringDecoder; + }; +} + +declare module "tls" { + import * as crypto from "crypto"; + import * as net from "net"; + import * as stream from "stream"; + + var CLIENT_RENEG_LIMIT: number; + var CLIENT_RENEG_WINDOW: number; + + export interface Certificate { + /** + * Country code. + */ + C: string; + /** + * Street. + */ + ST: string; + /** + * Locality. + */ + L: string; + /** + * Organization. + */ + O: string; + /** + * Organizational unit. + */ + OU: string; + /** + * Common name. + */ + CN: string; + } + + export interface CipherNameAndProtocol { + /** + * The cipher name. + */ + name: string; + /** + * SSL/TLS protocol version. + */ + version: string; + } + + export class TLSSocket extends stream.Duplex { + /** + * Returns the bound address, the address family name and port of the underlying socket as reported by + * the operating system. + * @returns {any} - An object with three properties, e.g. { port: 12346, family: 'IPv4', address: '127.0.0.1' }. + */ + address(): { port: number; family: string; address: string }; + /** + * A boolean that is true if the peer certificate was signed by one of the specified CAs, otherwise false. + */ + authorized: boolean; + /** + * The reason why the peer's certificate has not been verified. + * This property becomes available only when tlsSocket.authorized === false. + */ + authorizationError: Error; + /** + * Static boolean value, always true. + * May be used to distinguish TLS sockets from regular ones. + */ + encrypted: boolean; + /** + * Returns an object representing the cipher name and the SSL/TLS protocol version of the current connection. + * @returns {CipherNameAndProtocol} - Returns an object representing the cipher name + * and the SSL/TLS protocol version of the current connection. + */ + getCipher(): CipherNameAndProtocol; + /** + * Returns an object representing the peer's certificate. + * The returned object has some properties corresponding to the field of the certificate. + * If detailed argument is true the full chain with issuer property will be returned, + * if false only the top certificate without issuer property. + * If the peer does not provide a certificate, it returns null or an empty object. + * @param {boolean} detailed - If true; the full chain with issuer property will be returned. + * @returns {any} - An object representing the peer's certificate. + */ + getPeerCertificate(detailed?: boolean): { + subject: Certificate; + issuerInfo: Certificate; + issuer: Certificate; + raw: any; + valid_from: string; + valid_to: string; + fingerprint: string; + serialNumber: string; + }; + /** + * Could be used to speed up handshake establishment when reconnecting to the server. + * @returns {any} - ASN.1 encoded TLS session or undefined if none was negotiated. + */ + getSession(): any; + /** + * NOTE: Works only with client TLS sockets. + * Useful only for debugging, for session reuse provide session option to tls.connect(). + * @returns {any} - TLS session ticket or undefined if none was negotiated. + */ + getTLSTicket(): any; + /** + * The string representation of the local IP address. + */ + localAddress: string; + /** + * The numeric representation of the local port. + */ + localPort: string; + /** + * The string representation of the remote IP address. + * For example, '74.125.127.100' or '2001:4860:a005::68'. + */ + remoteAddress: string; + /** + * The string representation of the remote IP family. 'IPv4' or 'IPv6'. + */ + remoteFamily: string; + /** + * The numeric representation of the remote port. For example, 443. + */ + remotePort: number; + /** + * Initiate TLS renegotiation process. + * + * NOTE: Can be used to request peer's certificate after the secure connection has been established. + * ANOTHER NOTE: When running as the server, socket will be destroyed with an error after handshakeTimeout timeout. + * @param {TlsOptions} options - The options may contain the following fields: rejectUnauthorized, + * requestCert (See tls.createServer() for details). + * @param {Function} callback - callback(err) will be executed with null as err, once the renegotiation + * is successfully completed. + */ + renegotiate(options: TlsOptions, callback: (err: Error) => any): any; + /** + * Set maximum TLS fragment size (default and maximum value is: 16384, minimum is: 512). + * Smaller fragment size decreases buffering latency on the client: large fragments are buffered by + * the TLS layer until the entire fragment is received and its integrity is verified; + * large fragments can span multiple roundtrips, and their processing can be delayed due to packet + * loss or reordering. However, smaller fragments add extra TLS framing bytes and CPU overhead, + * which may decrease overall server throughput. + * @param {number} size - TLS fragment size (default and maximum value is: 16384, minimum is: 512). + * @returns {boolean} - Returns true on success, false otherwise. + */ + setMaxSendFragment(size: number): boolean; + } + + export interface TlsOptions { + host?: string; + port?: number; + pfx?: string | Buffer[]; + key?: string | string[] | Buffer | any[]; + passphrase?: string; + cert?: string | string[] | Buffer | Buffer[]; + ca?: string | string[] | Buffer | Buffer[]; + crl?: string | string[]; + ciphers?: string; + honorCipherOrder?: boolean; + requestCert?: boolean; + rejectUnauthorized?: boolean; + NPNProtocols?: string[] | Buffer; + SNICallback?: (servername: string, cb: (err: Error, ctx: SecureContext) => any) => any; + ecdhCurve?: string; + dhparam?: string | Buffer; + handshakeTimeout?: number; + ALPNProtocols?: string[] | Buffer; + sessionTimeout?: number; + ticketKeys?: any; + sessionIdContext?: string; + secureProtocol?: string; + } + + export interface ConnectionOptions { + host?: string; + port?: number; + socket?: net.Socket; + pfx?: string | Buffer + key?: string | string[] | Buffer | Buffer[]; + passphrase?: string; + cert?: string | string[] | Buffer | Buffer[]; + ca?: string | Buffer | (string | Buffer)[]; + rejectUnauthorized?: boolean; + NPNProtocols?: (string | Buffer)[]; + servername?: string; + path?: string; + ALPNProtocols?: (string | Buffer)[]; + checkServerIdentity?: (servername: string, cert: string | Buffer | (string | Buffer)[]) => any; + secureProtocol?: string; + secureContext?: Object; + session?: Buffer; + minDHSize?: number; + } + + export interface Server extends net.Server { + close(): Server; + address(): { port: number; family: string; address: string; }; + addContext(hostName: string, credentials: { + key: string; + cert: string; + ca: string; + }): void; + maxConnections: number; + connections: number; + } + + export interface ClearTextStream extends stream.Duplex { + authorized: boolean; + authorizationError: Error; + getPeerCertificate(): any; + getCipher: { + name: string; + version: string; + }; + address: { + port: number; + family: string; + address: string; + }; + remoteAddress: string; + remotePort: number; + } + + export interface SecurePair { + encrypted: any; + cleartext: any; + } + + export interface SecureContextOptions { + pfx?: string | Buffer; + key?: string | Buffer; + passphrase?: string; + cert?: string | Buffer; + ca?: string | Buffer; + crl?: string | string[] + ciphers?: string; + honorCipherOrder?: boolean; + } + + export interface SecureContext { + context: any; + } + + export function createServer(options: TlsOptions, secureConnectionListener?: (cleartextStream: ClearTextStream) => void): Server; + export function connect(options: ConnectionOptions, secureConnectionListener?: () => void): ClearTextStream; + export function connect(port: number, host?: string, options?: ConnectionOptions, secureConnectListener?: () => void): ClearTextStream; + export function connect(port: number, options?: ConnectionOptions, secureConnectListener?: () => void): ClearTextStream; + export function createSecurePair(credentials?: crypto.Credentials, isServer?: boolean, requestCert?: boolean, rejectUnauthorized?: boolean): SecurePair; + export function createSecureContext(details: SecureContextOptions): SecureContext; +} + +declare module "crypto" { + export interface Certificate { + exportChallenge(spkac: string | Buffer): Buffer; + exportPublicKey(spkac: string | Buffer): Buffer; + verifySpkac(spkac: Buffer): boolean; + } + export var Certificate: { + new (): Certificate; + (): Certificate; + } + + export var fips: boolean; + + export interface CredentialDetails { + pfx: string; + key: string; + passphrase: string; + cert: string; + ca: string | string[]; + crl: string | string[]; + ciphers: string; + } + export interface Credentials { context?: any; } + export function createCredentials(details: CredentialDetails): Credentials; + export function createHash(algorithm: string): Hash; + export function createHmac(algorithm: string, key: string | Buffer): Hmac; + + type Utf8AsciiLatin1Encoding = "utf8" | "ascii" | "latin1"; + type HexBase64Latin1Encoding = "latin1" | "hex" | "base64"; + type Utf8AsciiBinaryEncoding = "utf8" | "ascii" | "binary"; + type HexBase64BinaryEncoding = "binary" | "base64" | "hex"; + type ECDHKeyFormat = "compressed" | "uncompressed" | "hybrid"; + + export interface Hash extends NodeJS.ReadWriteStream { + update(data: string | Buffer): Hash; + update(data: string | Buffer, input_encoding: Utf8AsciiLatin1Encoding): Hash; + digest(): Buffer; + digest(encoding: HexBase64Latin1Encoding): string; + } + export interface Hmac extends NodeJS.ReadWriteStream { + update(data: string | Buffer): Hmac; + update(data: string | Buffer, input_encoding: Utf8AsciiLatin1Encoding): Hmac; + digest(): Buffer; + digest(encoding: HexBase64Latin1Encoding): string; + } + export function createCipher(algorithm: string, password: any): Cipher; + export function createCipheriv(algorithm: string, key: any, iv: any): Cipher; + export interface Cipher extends NodeJS.ReadWriteStream { + update(data: Buffer): Buffer; + update(data: string, input_encoding: Utf8AsciiBinaryEncoding): Buffer; + update(data: Buffer, input_encoding: any, output_encoding: HexBase64BinaryEncoding): string; + update(data: string, input_encoding: Utf8AsciiBinaryEncoding, output_encoding: HexBase64BinaryEncoding): string; + final(): Buffer; + final(output_encoding: string): string; + setAutoPadding(auto_padding?: boolean): void; + getAuthTag(): Buffer; + setAAD(buffer: Buffer): void; + } + export function createDecipher(algorithm: string, password: any): Decipher; + export function createDecipheriv(algorithm: string, key: any, iv: any): Decipher; + export interface Decipher extends NodeJS.ReadWriteStream { + update(data: Buffer): Buffer; + update(data: string, input_encoding: HexBase64BinaryEncoding): Buffer; + update(data: Buffer, input_encoding: any, output_encoding: Utf8AsciiBinaryEncoding): string; + update(data: string, input_encoding: HexBase64BinaryEncoding, output_encoding: Utf8AsciiBinaryEncoding): string; + final(): Buffer; + final(output_encoding: string): string; + setAutoPadding(auto_padding?: boolean): void; + setAuthTag(tag: Buffer): void; + setAAD(buffer: Buffer): void; + } + export function createSign(algorithm: string): Signer; + export interface Signer extends NodeJS.WritableStream { + update(data: string | Buffer): Signer; + update(data: string | Buffer, input_encoding: Utf8AsciiLatin1Encoding): Signer; + sign(private_key: string | { key: string; passphrase: string }): Buffer; + sign(private_key: string | { key: string; passphrase: string }, output_format: HexBase64Latin1Encoding): string; + } + export function createVerify(algorith: string): Verify; + export interface Verify extends NodeJS.WritableStream { + update(data: string | Buffer): Verify; + update(data: string | Buffer, input_encoding: Utf8AsciiLatin1Encoding): Verify; + verify(object: string, signature: Buffer): boolean; + verify(object: string, signature: string, signature_format: HexBase64Latin1Encoding): boolean; + } + export function createDiffieHellman(prime_length: number, generator?: number): DiffieHellman; + export function createDiffieHellman(prime: Buffer): DiffieHellman; + export function createDiffieHellman(prime: string, prime_encoding: HexBase64Latin1Encoding): DiffieHellman; + export function createDiffieHellman(prime: string, prime_encoding: HexBase64Latin1Encoding, generator: number | Buffer): DiffieHellman; + export function createDiffieHellman(prime: string, prime_encoding: HexBase64Latin1Encoding, generator: string, generator_encoding: HexBase64Latin1Encoding): DiffieHellman; + export interface DiffieHellman { + generateKeys(): Buffer; + generateKeys(encoding: HexBase64Latin1Encoding): string; + computeSecret(other_public_key: Buffer): Buffer; + computeSecret(other_public_key: string, input_encoding: HexBase64Latin1Encoding): Buffer; + computeSecret(other_public_key: string, input_encoding: HexBase64Latin1Encoding, output_encoding: HexBase64Latin1Encoding): string; + getPrime(): Buffer; + getPrime(encoding: HexBase64Latin1Encoding): string; + getGenerator(): Buffer; + getGenerator(encoding: HexBase64Latin1Encoding): string; + getPublicKey(): Buffer; + getPublicKey(encoding: HexBase64Latin1Encoding): string; + getPrivateKey(): Buffer; + getPrivateKey(encoding: HexBase64Latin1Encoding): string; + setPublicKey(public_key: Buffer): void; + setPublicKey(public_key: string, encoding: string): void; + setPrivateKey(private_key: Buffer): void; + setPrivateKey(private_key: string, encoding: string): void; + verifyError: number; + } + export function getDiffieHellman(group_name: string): DiffieHellman; + export function pbkdf2(password: string | Buffer, salt: string | Buffer, iterations: number, keylen: number, digest: string, callback: (err: Error, derivedKey: Buffer) => any): void; + export function pbkdf2Sync(password: string | Buffer, salt: string | Buffer, iterations: number, keylen: number, digest: string): Buffer; + export function randomBytes(size: number): Buffer; + export function randomBytes(size: number, callback: (err: Error, buf: Buffer) => void): void; + export function pseudoRandomBytes(size: number): Buffer; + export function pseudoRandomBytes(size: number, callback: (err: Error, buf: Buffer) => void): void; + export interface RsaPublicKey { + key: string; + padding?: number; + } + export interface RsaPrivateKey { + key: string; + passphrase?: string, + padding?: number; + } + export function publicEncrypt(public_key: string | RsaPublicKey, buffer: Buffer): Buffer + export function privateDecrypt(private_key: string | RsaPrivateKey, buffer: Buffer): Buffer + export function privateEncrypt(private_key: string | RsaPrivateKey, buffer: Buffer): Buffer + export function publicDecrypt(public_key: string | RsaPublicKey, buffer: Buffer): Buffer + export function getCiphers(): string[]; + export function getCurves(): string[]; + export function getHashes(): string[]; + export interface ECDH { + generateKeys(): Buffer; + generateKeys(encoding: HexBase64Latin1Encoding): string; + generateKeys(encoding: HexBase64Latin1Encoding, format: ECDHKeyFormat): string; + computeSecret(other_public_key: Buffer): Buffer; + computeSecret(other_public_key: string, input_encoding: HexBase64Latin1Encoding): Buffer; + computeSecret(other_public_key: string, input_encoding: HexBase64Latin1Encoding, output_encoding: HexBase64Latin1Encoding): string; + getPrivateKey(): Buffer; + getPrivateKey(encoding: HexBase64Latin1Encoding): string; + getPublicKey(): Buffer; + getPublicKey(encoding: HexBase64Latin1Encoding): string; + getPublicKey(encoding: HexBase64Latin1Encoding, format: ECDHKeyFormat): string; + setPrivateKey(private_key: Buffer): void; + setPrivateKey(private_key: string, encoding: HexBase64Latin1Encoding): void; + } + export function createECDH(curve_name: string): ECDH; + export var DEFAULT_ENCODING: string; +} + +declare module "stream" { + import * as events from "events"; + + class internal extends events.EventEmitter { + pipe(destination: T, options?: { end?: boolean; }): T; + } + namespace internal { + + export class Stream extends internal { } + + export interface ReadableOptions { + highWaterMark?: number; + encoding?: string; + objectMode?: boolean; + read?: (size?: number) => any; + } + + export class Readable extends events.EventEmitter implements NodeJS.ReadableStream { + readable: boolean; + constructor(opts?: ReadableOptions); + _read(size: number): void; + read(size?: number): any; + setEncoding(encoding: string): void; + pause(): Readable; + resume(): Readable; + pipe(destination: T, options?: { end?: boolean; }): T; + unpipe(destination?: T): void; + unshift(chunk: any): void; + wrap(oldStream: NodeJS.ReadableStream): NodeJS.ReadableStream; + push(chunk: any, encoding?: string): boolean; + + /** + * Event emitter + * The defined events on documents including: + * 1. close + * 2. data + * 3. end + * 4. readable + * 5. error + **/ + addListener(event: string, listener: Function): this; + addListener(event: string, listener: Function): this; + addListener(event: "close", listener: () => void): this; + addListener(event: "data", listener: (chunk: Buffer | string) => void): this; + addListener(event: "end", listener: () => void): this; + addListener(event: "readable", listener: () => void): this; + addListener(event: "error", listener: (err: Error) => void): this; + + emit(event: string, ...args: any[]): boolean; + emit(event: "close"): boolean; + emit(event: "data", chunk: Buffer | string): boolean; + emit(event: "end"): boolean; + emit(event: "readable"): boolean; + emit(event: "error", err: Error): boolean; + + on(event: string, listener: Function): this; + on(event: "close", listener: () => void): this; + on(event: "data", listener: (chunk: Buffer | string) => void): this; + on(event: "end", listener: () => void): this; + on(event: "readable", listener: () => void): this; + on(event: "error", listener: (err: Error) => void): this; + + once(event: string, listener: Function): this; + once(event: "close", listener: () => void): this; + once(event: "data", listener: (chunk: Buffer | string) => void): this; + once(event: "end", listener: () => void): this; + once(event: "readable", listener: () => void): this; + once(event: "error", listener: (err: Error) => void): this; + + prependListener(event: string, listener: Function): this; + prependListener(event: "close", listener: () => void): this; + prependListener(event: "data", listener: (chunk: Buffer | string) => void): this; + prependListener(event: "end", listener: () => void): this; + prependListener(event: "readable", listener: () => void): this; + prependListener(event: "error", listener: (err: Error) => void): this; + + prependOnceListener(event: string, listener: Function): this; + prependOnceListener(event: "close", listener: () => void): this; + prependOnceListener(event: "data", listener: (chunk: Buffer | string) => void): this; + prependOnceListener(event: "end", listener: () => void): this; + prependOnceListener(event: "readable", listener: () => void): this; + prependOnceListener(event: "error", listener: (err: Error) => void): this; + + removeListener(event: string, listener: Function): this; + removeListener(event: "close", listener: () => void): this; + removeListener(event: "data", listener: (chunk: Buffer | string) => void): this; + removeListener(event: "end", listener: () => void): this; + removeListener(event: "readable", listener: () => void): this; + removeListener(event: "error", listener: (err: Error) => void): this; + } + + export interface WritableOptions { + highWaterMark?: number; + decodeStrings?: boolean; + objectMode?: boolean; + write?: (chunk: string | Buffer, encoding: string, callback: Function) => any; + writev?: (chunks: { chunk: string | Buffer, encoding: string }[], callback: Function) => any; + } + + export class Writable extends events.EventEmitter implements NodeJS.WritableStream { + writable: boolean; + constructor(opts?: WritableOptions); + _write(chunk: any, encoding: string, callback: Function): void; + write(chunk: any, cb?: Function): boolean; + write(chunk: any, encoding?: string, cb?: Function): boolean; + end(): void; + end(chunk: any, cb?: Function): void; + end(chunk: any, encoding?: string, cb?: Function): void; + + /** + * Event emitter + * The defined events on documents including: + * 1. close + * 2. drain + * 3. error + * 4. finish + * 5. pipe + * 6. unpipe + **/ + addListener(event: string, listener: Function): this; + addListener(event: "close", listener: () => void): this; + addListener(event: "drain", listener: () => void): this; + addListener(event: "error", listener: (err: Error) => void): this; + addListener(event: "finish", listener: () => void): this; + addListener(event: "pipe", listener: (src: Readable) => void): this; + addListener(event: "unpipe", listener: (src: Readable) => void): this; + + emit(event: string, ...args: any[]): boolean; + emit(event: "close"): boolean; + emit(event: "drain", chunk: Buffer | string): boolean; + emit(event: "error", err: Error): boolean; + emit(event: "finish"): boolean; + emit(event: "pipe", src: Readable): boolean; + emit(event: "unpipe", src: Readable): boolean; + + on(event: string, listener: Function): this; + on(event: "close", listener: () => void): this; + on(event: "drain", listener: () => void): this; + on(event: "error", listener: (err: Error) => void): this; + on(event: "finish", listener: () => void): this; + on(event: "pipe", listener: (src: Readable) => void): this; + on(event: "unpipe", listener: (src: Readable) => void): this; + + once(event: string, listener: Function): this; + once(event: "close", listener: () => void): this; + once(event: "drain", listener: () => void): this; + once(event: "error", listener: (err: Error) => void): this; + once(event: "finish", listener: () => void): this; + once(event: "pipe", listener: (src: Readable) => void): this; + once(event: "unpipe", listener: (src: Readable) => void): this; + + prependListener(event: string, listener: Function): this; + prependListener(event: "close", listener: () => void): this; + prependListener(event: "drain", listener: () => void): this; + prependListener(event: "error", listener: (err: Error) => void): this; + prependListener(event: "finish", listener: () => void): this; + prependListener(event: "pipe", listener: (src: Readable) => void): this; + prependListener(event: "unpipe", listener: (src: Readable) => void): this; + + prependOnceListener(event: string, listener: Function): this; + prependOnceListener(event: "close", listener: () => void): this; + prependOnceListener(event: "drain", listener: () => void): this; + prependOnceListener(event: "error", listener: (err: Error) => void): this; + prependOnceListener(event: "finish", listener: () => void): this; + prependOnceListener(event: "pipe", listener: (src: Readable) => void): this; + prependOnceListener(event: "unpipe", listener: (src: Readable) => void): this; + + removeListener(event: string, listener: Function): this; + removeListener(event: "close", listener: () => void): this; + removeListener(event: "drain", listener: () => void): this; + removeListener(event: "error", listener: (err: Error) => void): this; + removeListener(event: "finish", listener: () => void): this; + removeListener(event: "pipe", listener: (src: Readable) => void): this; + removeListener(event: "unpipe", listener: (src: Readable) => void): this; + } + + export interface DuplexOptions extends ReadableOptions, WritableOptions { + allowHalfOpen?: boolean; + readableObjectMode?: boolean; + writableObjectMode?: boolean; + } + + // Note: Duplex extends both Readable and Writable. + export class Duplex extends Readable implements NodeJS.ReadWriteStream { + // Readable + pause(): Duplex; + resume(): Duplex; + // Writeable + writable: boolean; + constructor(opts?: DuplexOptions); + _write(chunk: any, encoding: string, callback: Function): void; + write(chunk: any, cb?: Function): boolean; + write(chunk: any, encoding?: string, cb?: Function): boolean; + end(): void; + end(chunk: any, cb?: Function): void; + end(chunk: any, encoding?: string, cb?: Function): void; + } + + export interface TransformOptions extends ReadableOptions, WritableOptions { + transform?: (chunk: string | Buffer, encoding: string, callback: Function) => any; + flush?: (callback: Function) => any; + } + + // Note: Transform lacks the _read and _write methods of Readable/Writable. + export class Transform extends events.EventEmitter implements NodeJS.ReadWriteStream { + readable: boolean; + writable: boolean; + constructor(opts?: TransformOptions); + _transform(chunk: any, encoding: string, callback: Function): void; + _flush(callback: Function): void; + read(size?: number): any; + setEncoding(encoding: string): void; + pause(): Transform; + resume(): Transform; + pipe(destination: T, options?: { end?: boolean; }): T; + unpipe(destination?: T): void; + unshift(chunk: any): void; + wrap(oldStream: NodeJS.ReadableStream): NodeJS.ReadableStream; + push(chunk: any, encoding?: string): boolean; + write(chunk: any, cb?: Function): boolean; + write(chunk: any, encoding?: string, cb?: Function): boolean; + end(): void; + end(chunk: any, cb?: Function): void; + end(chunk: any, encoding?: string, cb?: Function): void; + } + + export class PassThrough extends Transform { } + } + + export = internal; +} + +declare module "util" { + export interface InspectOptions { + showHidden?: boolean; + depth?: number; + colors?: boolean; + customInspect?: boolean; + } + + export function format(format: any, ...param: any[]): string; + export function debug(string: string): void; + export function error(...param: any[]): void; + export function puts(...param: any[]): void; + export function print(...param: any[]): void; + export function log(string: string): void; + export function inspect(object: any, showHidden?: boolean, depth?: number, color?: boolean): string; + export function inspect(object: any, options: InspectOptions): string; + export function isArray(object: any): boolean; + export function isRegExp(object: any): boolean; + export function isDate(object: any): boolean; + export function isError(object: any): boolean; + export function inherits(constructor: any, superConstructor: any): void; + export function debuglog(key: string): (msg: string, ...param: any[]) => void; + export function isBoolean(object: any): boolean; + export function isBuffer(object: any): boolean; + export function isFunction(object: any): boolean; + export function isNull(object: any): boolean; + export function isNullOrUndefined(object: any): boolean; + export function isNumber(object: any): boolean; + export function isObject(object: any): boolean; + export function isPrimitive(object: any): boolean; + export function isString(object: any): boolean; + export function isSymbol(object: any): boolean; + export function isUndefined(object: any): boolean; + export function deprecate(fn: Function, message: string): Function; +} + +declare module "assert" { + function internal(value: any, message?: string): void; + namespace internal { + export class AssertionError implements Error { + name: string; + message: string; + actual: any; + expected: any; + operator: string; + generatedMessage: boolean; + + constructor(options?: { + message?: string; actual?: any; expected?: any; + operator?: string; stackStartFunction?: Function + }); + } + + export function fail(actual: any, expected: any, message: string, operator: string): void; + export function ok(value: any, message?: string): void; + export function equal(actual: any, expected: any, message?: string): void; + export function notEqual(actual: any, expected: any, message?: string): void; + export function deepEqual(actual: any, expected: any, message?: string): void; + export function notDeepEqual(acutal: any, expected: any, message?: string): void; + export function strictEqual(actual: any, expected: any, message?: string): void; + export function notStrictEqual(actual: any, expected: any, message?: string): void; + export function deepStrictEqual(actual: any, expected: any, message?: string): void; + export function notDeepStrictEqual(actual: any, expected: any, message?: string): void; + export var throws: { + (block: Function, message?: string): void; + (block: Function, error: Function, message?: string): void; + (block: Function, error: RegExp, message?: string): void; + (block: Function, error: (err: any) => boolean, message?: string): void; + }; + + export var doesNotThrow: { + (block: Function, message?: string): void; + (block: Function, error: Function, message?: string): void; + (block: Function, error: RegExp, message?: string): void; + (block: Function, error: (err: any) => boolean, message?: string): void; + }; + + export function ifError(value: any): void; + } + + export = internal; +} + +declare module "tty" { + import * as net from "net"; + + export function isatty(fd: number): boolean; + export interface ReadStream extends net.Socket { + isRaw: boolean; + setRawMode(mode: boolean): void; + isTTY: boolean; + } + export interface WriteStream extends net.Socket { + columns: number; + rows: number; + isTTY: boolean; + } +} + +declare module "domain" { + import * as events from "events"; + + export class Domain extends events.EventEmitter implements NodeJS.Domain { + run(fn: Function): void; + add(emitter: events.EventEmitter): void; + remove(emitter: events.EventEmitter): void; + bind(cb: (err: Error, data: any) => any): any; + intercept(cb: (data: any) => any): any; + dispose(): void; + members: any[]; + enter(): void; + exit(): void; + } + + export function create(): Domain; +} + +declare module "constants" { + export var E2BIG: number; + export var EACCES: number; + export var EADDRINUSE: number; + export var EADDRNOTAVAIL: number; + export var EAFNOSUPPORT: number; + export var EAGAIN: number; + export var EALREADY: number; + export var EBADF: number; + export var EBADMSG: number; + export var EBUSY: number; + export var ECANCELED: number; + export var ECHILD: number; + export var ECONNABORTED: number; + export var ECONNREFUSED: number; + export var ECONNRESET: number; + export var EDEADLK: number; + export var EDESTADDRREQ: number; + export var EDOM: number; + export var EEXIST: number; + export var EFAULT: number; + export var EFBIG: number; + export var EHOSTUNREACH: number; + export var EIDRM: number; + export var EILSEQ: number; + export var EINPROGRESS: number; + export var EINTR: number; + export var EINVAL: number; + export var EIO: number; + export var EISCONN: number; + export var EISDIR: number; + export var ELOOP: number; + export var EMFILE: number; + export var EMLINK: number; + export var EMSGSIZE: number; + export var ENAMETOOLONG: number; + export var ENETDOWN: number; + export var ENETRESET: number; + export var ENETUNREACH: number; + export var ENFILE: number; + export var ENOBUFS: number; + export var ENODATA: number; + export var ENODEV: number; + export var ENOENT: number; + export var ENOEXEC: number; + export var ENOLCK: number; + export var ENOLINK: number; + export var ENOMEM: number; + export var ENOMSG: number; + export var ENOPROTOOPT: number; + export var ENOSPC: number; + export var ENOSR: number; + export var ENOSTR: number; + export var ENOSYS: number; + export var ENOTCONN: number; + export var ENOTDIR: number; + export var ENOTEMPTY: number; + export var ENOTSOCK: number; + export var ENOTSUP: number; + export var ENOTTY: number; + export var ENXIO: number; + export var EOPNOTSUPP: number; + export var EOVERFLOW: number; + export var EPERM: number; + export var EPIPE: number; + export var EPROTO: number; + export var EPROTONOSUPPORT: number; + export var EPROTOTYPE: number; + export var ERANGE: number; + export var EROFS: number; + export var ESPIPE: number; + export var ESRCH: number; + export var ETIME: number; + export var ETIMEDOUT: number; + export var ETXTBSY: number; + export var EWOULDBLOCK: number; + export var EXDEV: number; + export var WSAEINTR: number; + export var WSAEBADF: number; + export var WSAEACCES: number; + export var WSAEFAULT: number; + export var WSAEINVAL: number; + export var WSAEMFILE: number; + export var WSAEWOULDBLOCK: number; + export var WSAEINPROGRESS: number; + export var WSAEALREADY: number; + export var WSAENOTSOCK: number; + export var WSAEDESTADDRREQ: number; + export var WSAEMSGSIZE: number; + export var WSAEPROTOTYPE: number; + export var WSAENOPROTOOPT: number; + export var WSAEPROTONOSUPPORT: number; + export var WSAESOCKTNOSUPPORT: number; + export var WSAEOPNOTSUPP: number; + export var WSAEPFNOSUPPORT: number; + export var WSAEAFNOSUPPORT: number; + export var WSAEADDRINUSE: number; + export var WSAEADDRNOTAVAIL: number; + export var WSAENETDOWN: number; + export var WSAENETUNREACH: number; + export var WSAENETRESET: number; + export var WSAECONNABORTED: number; + export var WSAECONNRESET: number; + export var WSAENOBUFS: number; + export var WSAEISCONN: number; + export var WSAENOTCONN: number; + export var WSAESHUTDOWN: number; + export var WSAETOOMANYREFS: number; + export var WSAETIMEDOUT: number; + export var WSAECONNREFUSED: number; + export var WSAELOOP: number; + export var WSAENAMETOOLONG: number; + export var WSAEHOSTDOWN: number; + export var WSAEHOSTUNREACH: number; + export var WSAENOTEMPTY: number; + export var WSAEPROCLIM: number; + export var WSAEUSERS: number; + export var WSAEDQUOT: number; + export var WSAESTALE: number; + export var WSAEREMOTE: number; + export var WSASYSNOTREADY: number; + export var WSAVERNOTSUPPORTED: number; + export var WSANOTINITIALISED: number; + export var WSAEDISCON: number; + export var WSAENOMORE: number; + export var WSAECANCELLED: number; + export var WSAEINVALIDPROCTABLE: number; + export var WSAEINVALIDPROVIDER: number; + export var WSAEPROVIDERFAILEDINIT: number; + export var WSASYSCALLFAILURE: number; + export var WSASERVICE_NOT_FOUND: number; + export var WSATYPE_NOT_FOUND: number; + export var WSA_E_NO_MORE: number; + export var WSA_E_CANCELLED: number; + export var WSAEREFUSED: number; + export var SIGHUP: number; + export var SIGINT: number; + export var SIGILL: number; + export var SIGABRT: number; + export var SIGFPE: number; + export var SIGKILL: number; + export var SIGSEGV: number; + export var SIGTERM: number; + export var SIGBREAK: number; + export var SIGWINCH: number; + export var SSL_OP_ALL: number; + export var SSL_OP_ALLOW_UNSAFE_LEGACY_RENEGOTIATION: number; + export var SSL_OP_CIPHER_SERVER_PREFERENCE: number; + export var SSL_OP_CISCO_ANYCONNECT: number; + export var SSL_OP_COOKIE_EXCHANGE: number; + export var SSL_OP_CRYPTOPRO_TLSEXT_BUG: number; + export var SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS: number; + export var SSL_OP_EPHEMERAL_RSA: number; + export var SSL_OP_LEGACY_SERVER_CONNECT: number; + export var SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER: number; + export var SSL_OP_MICROSOFT_SESS_ID_BUG: number; + export var SSL_OP_MSIE_SSLV2_RSA_PADDING: number; + export var SSL_OP_NETSCAPE_CA_DN_BUG: number; + export var SSL_OP_NETSCAPE_CHALLENGE_BUG: number; + export var SSL_OP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG: number; + export var SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG: number; + export var SSL_OP_NO_COMPRESSION: number; + export var SSL_OP_NO_QUERY_MTU: number; + export var SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION: number; + export var SSL_OP_NO_SSLv2: number; + export var SSL_OP_NO_SSLv3: number; + export var SSL_OP_NO_TICKET: number; + export var SSL_OP_NO_TLSv1: number; + export var SSL_OP_NO_TLSv1_1: number; + export var SSL_OP_NO_TLSv1_2: number; + export var SSL_OP_PKCS1_CHECK_1: number; + export var SSL_OP_PKCS1_CHECK_2: number; + export var SSL_OP_SINGLE_DH_USE: number; + export var SSL_OP_SINGLE_ECDH_USE: number; + export var SSL_OP_SSLEAY_080_CLIENT_DH_BUG: number; + export var SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG: number; + export var SSL_OP_TLS_BLOCK_PADDING_BUG: number; + export var SSL_OP_TLS_D5_BUG: number; + export var SSL_OP_TLS_ROLLBACK_BUG: number; + export var ENGINE_METHOD_DSA: number; + export var ENGINE_METHOD_DH: number; + export var ENGINE_METHOD_RAND: number; + export var ENGINE_METHOD_ECDH: number; + export var ENGINE_METHOD_ECDSA: number; + export var ENGINE_METHOD_CIPHERS: number; + export var ENGINE_METHOD_DIGESTS: number; + export var ENGINE_METHOD_STORE: number; + export var ENGINE_METHOD_PKEY_METHS: number; + export var ENGINE_METHOD_PKEY_ASN1_METHS: number; + export var ENGINE_METHOD_ALL: number; + export var ENGINE_METHOD_NONE: number; + export var DH_CHECK_P_NOT_SAFE_PRIME: number; + export var DH_CHECK_P_NOT_PRIME: number; + export var DH_UNABLE_TO_CHECK_GENERATOR: number; + export var DH_NOT_SUITABLE_GENERATOR: number; + export var NPN_ENABLED: number; + export var RSA_PKCS1_PADDING: number; + export var RSA_SSLV23_PADDING: number; + export var RSA_NO_PADDING: number; + export var RSA_PKCS1_OAEP_PADDING: number; + export var RSA_X931_PADDING: number; + export var RSA_PKCS1_PSS_PADDING: number; + export var POINT_CONVERSION_COMPRESSED: number; + export var POINT_CONVERSION_UNCOMPRESSED: number; + export var POINT_CONVERSION_HYBRID: number; + export var O_RDONLY: number; + export var O_WRONLY: number; + export var O_RDWR: number; + export var S_IFMT: number; + export var S_IFREG: number; + export var S_IFDIR: number; + export var S_IFCHR: number; + export var S_IFBLK: number; + export var S_IFIFO: number; + export var S_IFSOCK: number; + export var S_IRWXU: number; + export var S_IRUSR: number; + export var S_IWUSR: number; + export var S_IXUSR: number; + export var S_IRWXG: number; + export var S_IRGRP: number; + export var S_IWGRP: number; + export var S_IXGRP: number; + export var S_IRWXO: number; + export var S_IROTH: number; + export var S_IWOTH: number; + export var S_IXOTH: number; + export var S_IFLNK: number; + export var O_CREAT: number; + export var O_EXCL: number; + export var O_NOCTTY: number; + export var O_DIRECTORY: number; + export var O_NOATIME: number; + export var O_NOFOLLOW: number; + export var O_SYNC: number; + export var O_SYMLINK: number; + export var O_DIRECT: number; + export var O_NONBLOCK: number; + export var O_TRUNC: number; + export var O_APPEND: number; + export var F_OK: number; + export var R_OK: number; + export var W_OK: number; + export var X_OK: number; + export var UV_UDP_REUSEADDR: number; + export var SIGQUIT: number; + export var SIGTRAP: number; + export var SIGIOT: number; + export var SIGBUS: number; + export var SIGUSR1: number; + export var SIGUSR2: number; + export var SIGPIPE: number; + export var SIGALRM: number; + export var SIGCHLD: number; + export var SIGSTKFLT: number; + export var SIGCONT: number; + export var SIGSTOP: number; + export var SIGTSTP: number; + export var SIGTTIN: number; + export var SIGTTOU: number; + export var SIGURG: number; + export var SIGXCPU: number; + export var SIGXFSZ: number; + export var SIGVTALRM: number; + export var SIGPROF: number; + export var SIGIO: number; + export var SIGPOLL: number; + export var SIGPWR: number; + export var SIGSYS: number; + export var SIGUNUSED: number; + export var defaultCoreCipherList: string; + export var defaultCipherList: string; + export var ENGINE_METHOD_RSA: number; + export var ALPN_ENABLED: number; +} + +declare module "process" { + export = process; +} + +declare module "v8" { + interface HeapSpaceInfo { + space_name: string; + space_size: number; + space_used_size: number; + space_available_size: number; + physical_space_size: number; + } + export function getHeapStatistics(): { total_heap_size: number, total_heap_size_executable: number, total_physical_size: number, total_avaialble_size: number, used_heap_size: number, heap_size_limit: number }; + export function getHeapSpaceStatistics(): HeapSpaceInfo[]; + export function setFlagsFromString(flags: string): void; +} + +declare module "timers" { + export function setTimeout(callback: (...args: any[]) => void, ms: number, ...args: any[]): NodeJS.Timer; + export function clearTimeout(timeoutId: NodeJS.Timer): void; + export function setInterval(callback: (...args: any[]) => void, ms: number, ...args: any[]): NodeJS.Timer; + export function clearInterval(intervalId: NodeJS.Timer): void; + export function setImmediate(callback: (...args: any[]) => void, ...args: any[]): any; + export function clearImmediate(immediateId: any): void; +} + +declare module "console" { + export = console; +} diff --git a/Tasks/AppCenterDistributeV3/typings/globals/node/typings.json b/Tasks/AppCenterDistributeV3/typings/globals/node/typings.json new file mode 100644 index 000000000000..80c02bb5f5ef --- /dev/null +++ b/Tasks/AppCenterDistributeV3/typings/globals/node/typings.json @@ -0,0 +1,8 @@ +{ + "resolution": "main", + "tree": { + "src": "https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/66484e9f11a93a89d972ba009e81957338e26ed7/node/node.d.ts", + "raw": "registry:dt/node#6.0.0+20160921192128", + "typings": "https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/66484e9f11a93a89d972ba009e81957338e26ed7/node/node.d.ts" + } +} diff --git a/Tasks/AppCenterDistributeV3/typings/globals/q/index.d.ts b/Tasks/AppCenterDistributeV3/typings/globals/q/index.d.ts new file mode 100644 index 000000000000..9d6e825bd75b --- /dev/null +++ b/Tasks/AppCenterDistributeV3/typings/globals/q/index.d.ts @@ -0,0 +1,357 @@ +// Generated by typings +// Source: https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/623f30ab194a3486e014ca39bc7f2089897d6ce4/q/Q.d.ts +declare function Q(promise: Q.IPromise): Q.Promise; +/** + * If value is not a promise, returns a promise that is fulfilled with value. + */ +declare function Q(value: T): Q.Promise; + +declare namespace Q { + interface IPromise { + then(onFulfill?: (value: T) => U | IPromise, onReject?: (error: any) => U | IPromise): IPromise; + } + + interface Deferred { + promise: Promise; + resolve(value?: T): void; + resolve(value?: IPromise): void; + reject(reason: any): void; + notify(value: any): void; + makeNodeResolver(): (reason: any, value: T) => void; + } + + interface Promise { + /** + * Like a finally clause, allows you to observe either the fulfillment or rejection of a promise, but to do so without modifying the final value. This is useful for collecting resources regardless of whether a job succeeded, like closing a database connection, shutting a server down, or deleting an unneeded key from an object. + + * finally returns a promise, which will become resolved with the same fulfillment value or rejection reason as promise. However, if callback returns a promise, the resolution of the returned promise will be delayed until the promise returned from callback is finished. + */ + fin(finallyCallback: () => any): Promise; + /** + * Like a finally clause, allows you to observe either the fulfillment or rejection of a promise, but to do so without modifying the final value. This is useful for collecting resources regardless of whether a job succeeded, like closing a database connection, shutting a server down, or deleting an unneeded key from an object. + + * finally returns a promise, which will become resolved with the same fulfillment value or rejection reason as promise. However, if callback returns a promise, the resolution of the returned promise will be delayed until the promise returned from callback is finished. + */ + finally(finallyCallback: () => any): Promise; + + /** + * The then method from the Promises/A+ specification, with an additional progress handler. + */ + then(onFulfill?: (value: T) => U | IPromise, onReject?: (error: any) => U | IPromise, onProgress?: Function): Promise; + + /** + * Like then, but "spreads" the array into a variadic fulfillment handler. If any of the promises in the array are rejected, instead calls onRejected with the first rejected promise's rejection reason. + * + * This is especially useful in conjunction with all + */ + spread(onFulfill: (...args: any[]) => IPromise | U, onReject?: (reason: any) => IPromise | U): Promise; + + fail(onRejected: (reason: any) => U | IPromise): Promise; + + /** + * A sugar method, equivalent to promise.then(undefined, onRejected). + */ + catch(onRejected: (reason: any) => U | IPromise): Promise; + + /** + * A sugar method, equivalent to promise.then(undefined, undefined, onProgress). + */ + progress(onProgress: (progress: any) => any): Promise; + + /** + * Much like then, but with different behavior around unhandled rejection. If there is an unhandled rejection, either because promise is rejected and no onRejected callback was provided, or because onFulfilled or onRejected threw an error or returned a rejected promise, the resulting rejection reason is thrown as an exception in a future turn of the event loop. + * + * This method should be used to terminate chains of promises that will not be passed elsewhere. Since exceptions thrown in then callbacks are consumed and transformed into rejections, exceptions at the end of the chain are easy to accidentally, silently ignore. By arranging for the exception to be thrown in a future turn of the event loop, so that it won't be caught, it causes an onerror event on the browser window, or an uncaughtException event on Node.js's process object. + * + * Exceptions thrown by done will have long stack traces, if Q.longStackSupport is set to true. If Q.onerror is set, exceptions will be delivered there instead of thrown in a future turn. + * + * The Golden Rule of done vs. then usage is: either return your promise to someone else, or if the chain ends with you, call done to terminate it. + */ + done(onFulfilled?: (value: T) => any, onRejected?: (reason: any) => any, onProgress?: (progress: any) => any): void; + + /** + * If callback is a function, assumes it's a Node.js-style callback, and calls it as either callback(rejectionReason) when/if promise becomes rejected, or as callback(null, fulfillmentValue) when/if promise becomes fulfilled. If callback is not a function, simply returns promise. + */ + nodeify(callback: (reason: any, value: any) => void): Promise; + + /** + * Returns a promise to get the named property of an object. Essentially equivalent to + * + * promise.then(function (o) { + * return o[propertyName]; + * }); + */ + get(propertyName: String): Promise; + set(propertyName: String, value: any): Promise; + delete(propertyName: String): Promise; + /** + * Returns a promise for the result of calling the named method of an object with the given array of arguments. The object itself is this in the function, just like a synchronous method call. Essentially equivalent to + * + * promise.then(function (o) { + * return o[methodName].apply(o, args); + * }); + */ + post(methodName: String, args: any[]): Promise; + /** + * Returns a promise for the result of calling the named method of an object with the given variadic arguments. The object itself is this in the function, just like a synchronous method call. + */ + invoke(methodName: String, ...args: any[]): Promise; + fapply(args: any[]): Promise; + fcall(...args: any[]): Promise; + + /** + * Returns a promise for an array of the property names of an object. Essentially equivalent to + * + * promise.then(function (o) { + * return Object.keys(o); + * }); + */ + keys(): Promise; + + /** + * A sugar method, equivalent to promise.then(function () { return value; }). + */ + thenResolve(value: U): Promise; + /** + * A sugar method, equivalent to promise.then(function () { throw reason; }). + */ + thenReject(reason: any): Promise; + + /** + * Attaches a handler that will observe the value of the promise when it becomes fulfilled, returning a promise for that same value, perhaps deferred but not replaced by the promise returned by the onFulfilled handler. + */ + tap(onFulfilled: (value: T) => any): Promise; + + timeout(ms: number, message?: string): Promise; + /** + * Returns a promise that will have the same result as promise, but will only be fulfilled or rejected after at least ms milliseconds have passed. + */ + delay(ms: number): Promise; + + /** + * Returns whether a given promise is in the fulfilled state. When the static version is used on non-promises, the result is always true. + */ + isFulfilled(): boolean; + /** + * Returns whether a given promise is in the rejected state. When the static version is used on non-promises, the result is always false. + */ + isRejected(): boolean; + /** + * Returns whether a given promise is in the pending state. When the static version is used on non-promises, the result is always false. + */ + isPending(): boolean; + + valueOf(): any; + + /** + * Returns a "state snapshot" object, which will be in one of three forms: + * + * - { state: "pending" } + * - { state: "fulfilled", value: } + * - { state: "rejected", reason: } + */ + inspect(): PromiseState; + } + + interface PromiseState { + /** + * "fulfilled", "rejected", "pending" + */ + state: string; + value?: T; + reason?: any; + } + + // If no value provided, returned promise will be of void type + export function when(): Promise; + + // if no fulfill, reject, or progress provided, returned promise will be of same type + export function when(value: T | IPromise): Promise; + + // If a non-promise value is provided, it will not reject or progress + export function when(value: T | IPromise, onFulfilled: (val: T) => U | IPromise, onRejected?: (reason: any) => U | IPromise, onProgress?: (progress: any) => any): Promise; + + /** + * Currently "impossible" (and I use the term loosely) to implement due to TypeScript limitations as it is now. + * See: https://github.com/Microsoft/TypeScript/issues/1784 for discussion on it. + */ + // export function try(method: Function, ...args: any[]): Promise; + + export function fbind(method: (...args: any[]) => T | IPromise, ...args: any[]): (...args: any[]) => Promise; + + export function fcall(method: (...args: any[]) => T, ...args: any[]): Promise; + + export function send(obj: any, functionName: string, ...args: any[]): Promise; + export function invoke(obj: any, functionName: string, ...args: any[]): Promise; + export function mcall(obj: any, functionName: string, ...args: any[]): Promise; + + export function denodeify(nodeFunction: Function, ...args: any[]): (...args: any[]) => Promise; + export function nbind(nodeFunction: Function, thisArg: any, ...args: any[]): (...args: any[]) => Promise; + export function nfbind(nodeFunction: Function, ...args: any[]): (...args: any[]) => Promise; + export function nfcall(nodeFunction: Function, ...args: any[]): Promise; + export function nfapply(nodeFunction: Function, args: any[]): Promise; + + export function ninvoke(nodeModule: any, functionName: string, ...args: any[]): Promise; + export function npost(nodeModule: any, functionName: string, args: any[]): Promise; + export function nsend(nodeModule: any, functionName: string, ...args: any[]): Promise; + export function nmcall(nodeModule: any, functionName: string, ...args: any[]): Promise; + + /** + * Returns a promise that is fulfilled with an array containing the fulfillment value of each promise, or is rejected with the same rejection reason as the first promise to be rejected. + */ + export function all(promises: [IPromise, IPromise, IPromise, IPromise, IPromise, IPromise]): Promise<[A, B, C, D, E, F]>; + /** + * Returns a promise that is fulfilled with an array containing the fulfillment value of each promise, or is rejected with the same rejection reason as the first promise to be rejected. + */ + export function all(promises: [IPromise, IPromise, IPromise, IPromise, IPromise]): Promise<[A, B, C, D, E]>; + /** + * Returns a promise that is fulfilled with an array containing the fulfillment value of each promise, or is rejected with the same rejection reason as the first promise to be rejected. + */ + export function all(promises: [IPromise, IPromise, IPromise, IPromise]): Promise<[A, B, C, D]>; + /** + * Returns a promise that is fulfilled with an array containing the fulfillment value of each promise, or is rejected with the same rejection reason as the first promise to be rejected. + */ + export function all(promises: [IPromise, IPromise, IPromise]): Promise<[A, B, C]>; + /** + * Returns a promise that is fulfilled with an array containing the fulfillment value of each promise, or is rejected with the same rejection reason as the first promise to be rejected. + */ + export function all(promises: [IPromise, IPromise]): Promise<[A, B]>; + /** + * Returns a promise that is fulfilled with an array containing the fulfillment value of each promise, or is rejected with the same rejection reason as the first promise to be rejected. + */ + export function all(promises: IPromise[]): Promise; + + /** + * Returns a promise for the first of an array of promises to become settled. + */ + export function race(promises: IPromise[]): Promise; + + /** + * Returns a promise that is fulfilled with an array of promise state snapshots, but only after all the original promises have settled, i.e. become either fulfilled or rejected. + */ + export function allSettled(promises: IPromise[]): Promise[]>; + + export function allResolved(promises: IPromise[]): Promise[]>; + + /** + * Like then, but "spreads" the array into a variadic fulfillment handler. If any of the promises in the array are rejected, instead calls onRejected with the first rejected promise's rejection reason. + * This is especially useful in conjunction with all. + */ + export function spread(promises: IPromise[], onFulfilled: (...args: T[]) => U | IPromise, onRejected?: (reason: any) => U | IPromise): Promise; + + /** + * Returns a promise that will have the same result as promise, except that if promise is not fulfilled or rejected before ms milliseconds, the returned promise will be rejected with an Error with the given message. If message is not supplied, the message will be "Timed out after " + ms + " ms". + */ + export function timeout(promise: Promise, ms: number, message?: string): Promise; + + /** + * Returns a promise that will have the same result as promise, but will only be fulfilled or rejected after at least ms milliseconds have passed. + */ + export function delay(promise: Promise, ms: number): Promise; + /** + * Returns a promise that will have the same result as promise, but will only be fulfilled or rejected after at least ms milliseconds have passed. + */ + export function delay(value: T, ms: number): Promise; + /** + * Returns a promise that will be fulfilled with undefined after at least ms milliseconds have passed. + */ + export function delay(ms: number): Promise ; + /** + * Returns whether a given promise is in the fulfilled state. When the static version is used on non-promises, the result is always true. + */ + export function isFulfilled(promise: Promise): boolean; + /** + * Returns whether a given promise is in the rejected state. When the static version is used on non-promises, the result is always false. + */ + export function isRejected(promise: Promise): boolean; + /** + * Returns whether a given promise is in the pending state. When the static version is used on non-promises, the result is always false. + */ + export function isPending(promise: Promise): boolean; + + /** + * Returns a "deferred" object with a: + * promise property + * resolve(value) method + * reject(reason) method + * notify(value) method + * makeNodeResolver() method + */ + export function defer(): Deferred; + + /** + * Returns a promise that is rejected with reason. + */ + export function reject(reason?: any): Promise; + + export function Promise(resolver: (resolve: (val: T | IPromise) => void , reject: (reason: any) => void , notify: (progress: any) => void ) => void ): Promise; + + /** + * Creates a new version of func that accepts any combination of promise and non-promise values, converting them to their fulfillment values before calling the original func. The returned version also always returns a promise: if func does a return or throw, then Q.promised(func) will return fulfilled or rejected promise, respectively. + * + * This can be useful for creating functions that accept either promises or non-promise values, and for ensuring that the function always returns a promise even in the face of unintentional thrown exceptions. + */ + export function promised(callback: (...args: any[]) => T): (...args: any[]) => Promise; + + /** + * Returns whether the given value is a Q promise. + */ + export function isPromise(object: any): boolean; + /** + * Returns whether the given value is a promise (i.e. it's an object with a then function). + */ + export function isPromiseAlike(object: any): boolean; + /** + * Returns whether a given promise is in the pending state. When the static version is used on non-promises, the result is always false. + */ + export function isPending(object: any): boolean; + /** + * If an object is not a promise, it is as "near" as possible. + * If a promise is rejected, it is as "near" as possible too. + * If it’s a fulfilled promise, the fulfillment value is nearer. + * If it’s a deferred promise and the deferred has been resolved, the + * resolution is "nearer". + */ + export function nearer(promise: Promise): T; + + /** + * This is an experimental tool for converting a generator function into a deferred function. This has the potential of reducing nested callbacks in engines that support yield. + */ + export function async(generatorFunction: any): (...args: any[]) => Promise; + export function nextTick(callback: Function): void; + + /** + * A settable property that will intercept any uncaught errors that would otherwise be thrown in the next tick of the event loop, usually as a result of done. Can be useful for getting the full stack trace of an error in browsers, which is not usually possible with window.onerror. + */ + export var onerror: (reason: any) => void; + /** + * A settable property that lets you turn on long stack trace support. If turned on, "stack jumps" will be tracked across asynchronous promise operations, so that if an uncaught error is thrown by done or a rejection reason's stack property is inspected in a rejection callback, a long stack trace is produced. + */ + export var longStackSupport: boolean; + + /** + * Calling resolve with a pending promise causes promise to wait on the passed promise, becoming fulfilled with its fulfillment value or rejected with its rejection reason (or staying pending forever, if the passed promise does). + * Calling resolve with a rejected promise causes promise to be rejected with the passed promise's rejection reason. + * Calling resolve with a fulfilled promise causes promise to be fulfilled with the passed promise's fulfillment value. + * Calling resolve with a non-promise value causes promise to be fulfilled with that value. + */ + export function resolve(object: IPromise): Promise; + /** + * Calling resolve with a pending promise causes promise to wait on the passed promise, becoming fulfilled with its fulfillment value or rejected with its rejection reason (or staying pending forever, if the passed promise does). + * Calling resolve with a rejected promise causes promise to be rejected with the passed promise's rejection reason. + * Calling resolve with a fulfilled promise causes promise to be fulfilled with the passed promise's fulfillment value. + * Calling resolve with a non-promise value causes promise to be fulfilled with that value. + */ + export function resolve(object: T): Promise; + + /** + * Resets the global "Q" variable to the value it has before Q was loaded. + * This will either be undefined if there was no version or the version of Q which was already loaded before. + * @returns { The last version of Q. } + */ + export function noConflict(): typeof Q; +} + +declare module "q" { + export = Q; +} diff --git a/Tasks/AppCenterDistributeV3/typings/globals/q/typings.json b/Tasks/AppCenterDistributeV3/typings/globals/q/typings.json new file mode 100644 index 000000000000..3d59355a87e8 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/typings/globals/q/typings.json @@ -0,0 +1,8 @@ +{ + "resolution": "main", + "tree": { + "src": "https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/623f30ab194a3486e014ca39bc7f2089897d6ce4/q/Q.d.ts", + "raw": "registry:dt/q#0.0.0+20160613154756", + "typings": "https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/623f30ab194a3486e014ca39bc7f2089897d6ce4/q/Q.d.ts" + } +} diff --git a/Tasks/AppCenterDistributeV3/typings/globals/request/index.d.ts b/Tasks/AppCenterDistributeV3/typings/globals/request/index.d.ts new file mode 100644 index 000000000000..22df52cd927d --- /dev/null +++ b/Tasks/AppCenterDistributeV3/typings/globals/request/index.d.ts @@ -0,0 +1,254 @@ +// Generated by typings +// Source: https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/658d360c6a8611e76f7cc75c07fcd0f02055ffc4/request/request.d.ts +declare module 'request' { + import stream = require('stream'); + import http = require('http'); + import https = require('https'); + import url = require('url'); + import fs = require('fs'); + import FormData = require('form-data'); + + namespace request { + export interface RequestAPI { + + defaults(options: TOptions): RequestAPI; + defaults(options: RequiredUriUrl & TOptions): DefaultUriUrlRequestApi; + + (uri: string, options?: TOptions, callback?: RequestCallback): TRequest; + (uri: string, callback?: RequestCallback): TRequest; + (options: TUriUrlOptions & TOptions, callback?: RequestCallback): TRequest; + + get(uri: string, options?: TOptions, callback?: RequestCallback): TRequest; + get(uri: string, callback?: RequestCallback): TRequest; + get(options: TUriUrlOptions & TOptions, callback?: RequestCallback): TRequest; + + post(uri: string, options?: TOptions, callback?: RequestCallback): TRequest; + post(uri: string, callback?: RequestCallback): TRequest; + post(options: TUriUrlOptions & TOptions, callback?: RequestCallback): TRequest; + + put(uri: string, options?: TOptions, callback?: RequestCallback): TRequest; + put(uri: string, callback?: RequestCallback): TRequest; + put(options: TUriUrlOptions & TOptions, callback?: RequestCallback): TRequest; + + head(uri: string, options?: TOptions, callback?: RequestCallback): TRequest; + head(uri: string, callback?: RequestCallback): TRequest; + head(options: TUriUrlOptions & TOptions, callback?: RequestCallback): TRequest; + + patch(uri: string, options?: TOptions, callback?: RequestCallback): TRequest; + patch(uri: string, callback?: RequestCallback): TRequest; + patch(options: TUriUrlOptions & TOptions, callback?: RequestCallback): TRequest; + + del(uri: string, options?: TOptions, callback?: RequestCallback): TRequest; + del(uri: string, callback?: RequestCallback): TRequest; + del(options: TUriUrlOptions & TOptions, callback?: RequestCallback): TRequest; + + forever(agentOptions: any, optionsArg: any): TRequest; + jar(): CookieJar; + cookie(str: string): Cookie; + + initParams: any; + debug: boolean; + } + + interface DefaultUriUrlRequestApi extends RequestAPI { + + defaults(options: TOptions): DefaultUriUrlRequestApi; + (): TRequest; + get(): TRequest; + post(): TRequest; + put(): TRequest; + head(): TRequest; + patch(): TRequest; + del(): TRequest; + } + + interface CoreOptions { + baseUrl?: string; + callback?: (error: any, response: http.IncomingMessage, body: any) => void; + jar?: any; // CookieJar + formData?: any; // Object + form?: any; // Object or string + auth?: AuthOptions; + oauth?: OAuthOptions; + aws?: AWSOptions; + hawk?: HawkOptions; + qs?: any; + json?: any; + multipart?: RequestPart[] | Multipart; + agent?: http.Agent | https.Agent; + agentOptions?: any; + agentClass?: any; + forever?: any; + host?: string; + port?: number; + method?: string; + headers?: Headers; + body?: any; + followRedirect?: boolean | ((response: http.IncomingMessage) => boolean); + followAllRedirects?: boolean; + maxRedirects?: number; + encoding?: string; + pool?: any; + timeout?: number; + proxy?: any; + strictSSL?: boolean; + gzip?: boolean; + preambleCRLF?: boolean; + postambleCRLF?: boolean; + key?: Buffer; + cert?: Buffer; + passphrase?: string; + ca?: string | Buffer | string[] | Buffer[]; + har?: HttpArchiveRequest; + useQuerystring?: boolean; + } + + interface UriOptions { + uri: string; + } + interface UrlOptions { + url: string; + } + export type RequiredUriUrl = UriOptions | UrlOptions; + + interface OptionalUriUrl { + uri?: string; + url?: string; + } + + export type OptionsWithUri = UriOptions & CoreOptions; + export type OptionsWithUrl = UrlOptions & CoreOptions; + export type Options = OptionsWithUri | OptionsWithUrl; + + export interface RequestCallback { + (error: any, response: http.IncomingMessage, body: any): void; + } + + export interface HttpArchiveRequest { + url?: string; + method?: string; + headers?: NameValuePair[]; + postData?: { + mimeType?: string; + params?: NameValuePair[]; + } + } + + export interface NameValuePair { + name: string; + value: string; + } + + export interface Multipart { + chunked?: boolean; + data?: { + 'content-type'?: string, + body: string + }[]; + } + + export interface RequestPart { + headers?: Headers; + body: any; + } + + export interface Request extends stream.Stream { + readable: boolean; + writable: boolean; + + getAgent(): http.Agent; + //start(): void; + //abort(): void; + pipeDest(dest: any): void; + setHeader(name: string, value: string, clobber?: boolean): Request; + setHeaders(headers: Headers): Request; + qs(q: Object, clobber?: boolean): Request; + form(): FormData; + form(form: any): Request; + multipart(multipart: RequestPart[]): Request; + json(val: any): Request; + aws(opts: AWSOptions, now?: boolean): Request; + auth(username: string, password: string, sendInmediately?: boolean, bearer?: string): Request; + oauth(oauth: OAuthOptions): Request; + jar(jar: CookieJar): Request; + + on(event: string, listener: Function): this; + on(event: 'request', listener: (req: http.ClientRequest) => void): this; + on(event: 'response', listener: (resp: http.IncomingMessage) => void): this; + on(event: 'data', listener: (data: Buffer | string) => void): this; + on(event: 'error', listener: (e: Error) => void): this; + on(event: 'complete', listener: (resp: http.IncomingMessage, body?: string | Buffer) => void): this; + + write(buffer: Buffer, cb?: Function): boolean; + write(str: string, cb?: Function): boolean; + write(str: string, encoding: string, cb?: Function): boolean; + write(str: string, encoding?: string, fd?: string): boolean; + end(): void; + end(chunk: Buffer, cb?: Function): void; + end(chunk: string, cb?: Function): void; + end(chunk: string, encoding: string, cb?: Function): void; + pause(): void; + resume(): void; + abort(): void; + destroy(): void; + toJSON(): Object; + } + + export interface Headers { + [key: string]: any; + } + + export interface AuthOptions { + user?: string; + username?: string; + pass?: string; + password?: string; + sendImmediately?: boolean; + bearer?: string; + } + + export interface OAuthOptions { + callback?: string; + consumer_key?: string; + consumer_secret?: string; + token?: string; + token_secret?: string; + verifier?: string; + } + + export interface HawkOptions { + credentials: any; + } + + export interface AWSOptions { + secret: string; + bucket?: string; + } + + export interface CookieJar { + setCookie(cookie: Cookie, uri: string | url.Url, options?: any): void + getCookieString(uri: string | url.Url): string + getCookies(uri: string | url.Url): Cookie[] + } + + export interface CookieValue { + name: string; + value: any; + httpOnly: boolean; + } + + export interface Cookie extends Array { + constructor(name: string, req: Request): void; + str: string; + expires: Date; + path: string; + toString(): string; + } + } + var request: request.RequestAPI; + export = request; +} diff --git a/Tasks/AppCenterDistributeV3/typings/globals/request/typings.json b/Tasks/AppCenterDistributeV3/typings/globals/request/typings.json new file mode 100644 index 000000000000..ba8acce019b0 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/typings/globals/request/typings.json @@ -0,0 +1,8 @@ +{ + "resolution": "main", + "tree": { + "src": "https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/658d360c6a8611e76f7cc75c07fcd0f02055ffc4/request/request.d.ts", + "raw": "registry:dt/request#0.0.0+20160726020908", + "typings": "https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/658d360c6a8611e76f7cc75c07fcd0f02055ffc4/request/request.d.ts" + } +} diff --git a/Tasks/AppCenterDistributeV3/typings/index.d.ts b/Tasks/AppCenterDistributeV3/typings/index.d.ts new file mode 100644 index 000000000000..505efb7f6e1b --- /dev/null +++ b/Tasks/AppCenterDistributeV3/typings/index.d.ts @@ -0,0 +1,5 @@ +/// +/// +/// +/// +/// diff --git a/Tasks/AppCenterDistributeV3/utils.ts b/Tasks/AppCenterDistributeV3/utils.ts new file mode 100644 index 000000000000..94b5790a0c8e --- /dev/null +++ b/Tasks/AppCenterDistributeV3/utils.ts @@ -0,0 +1,240 @@ +import path = require("path"); +import tl = require("vsts-task-lib/task"); +import fs = require("fs"); +import Q = require('q'); + +var Zip = require('jszip'); + +var workDir = tl.getVariable("System.DefaultWorkingDirectory"); + +export function checkAndFixFilePath(filePath: string, continueOnError: boolean ): string { + if (filePath) { + if (arePathEqual(filePath, workDir)) { + // Path points to the source root, ignore it + filePath = null; + } else { + if (continueOnError) { + if (!tl.exist(filePath)) { + tl.warning(tl.loc("FailedToFindFile", "symbolsPath", filePath)); + filePath = null; + } + } else { + // will error and fail task if it doesn't exist. + tl.checkPath(filePath, "symbolsPath"); + } + } + } + + return filePath; +} + +export function getArchivePath(symbolsRoot: string): string { + // If symbol paths do not have anything common, e.g /a/b/c and /x/y/z, + // let's use some default name for the archive. + let zipName = symbolsRoot ? path.basename(symbolsRoot) : "symbols"; + tl.debug(`---- Zip file name=${zipName}`); + + let zipPath = path.join(workDir, `${zipName}.zip`); + tl.debug(`.... Zip file path=${zipPath}`); + + return zipPath; +} + +function arePathEqual(p1: string, p2: string): boolean { + if (!p1 && !p2) return true; + else if (!p1 || !p2) return false; + else return path.normalize(p1 || "") === path.normalize(p2 || ""); +} + +function getAllFiles(rootPath: string, recursive: boolean): string[] { + let files: string[] = []; + + let folders: string[] = []; + folders.push(rootPath); + + while (folders.length > 0) { + let folderPath = folders.shift(); + + let children = fs.readdirSync(folderPath); + for (let i = 0; i < children.length; i++) { + let childPath = [folderPath, children[i]].join( "/"); + if (fs.statSync(childPath).isDirectory()) { + if (recursive) { + folders.push(childPath); + } + } else { + files.push(childPath); + } + } + } + + return files; +} + +export function createZipStream(symbolsPaths: string[], symbolsRoot: string): NodeJS.ReadableStream { + tl.debug("---- Creating Zip stream"); + let zip = new Zip(); + + symbolsPaths.forEach(rootPath => { + let filePaths = getAllFiles(rootPath, /*recursive=*/ true); + tl.debug(`------ Adding files: ${filePaths}`); + + for (let i = 0; i < filePaths.length; i++) { + let filePath = filePaths[i]; + + let relativePath: string = null; + if (symbolsRoot) { + relativePath = path.relative(symbolsRoot, filePath); + } else { + // If symbol paths do not have anything common, + // e.g "/a/b/c" and "/x/y/z", or "C:/u/v/w" and "D:/u/v/w", + // let's use "a/b/c" and "x/y/z", or "C/u/v/w" and "D/u/v/w" + // as relative paths in the archive. + relativePath = filePath.replace(/^\/+/,"").replace(":", ""); + } + + tl.debug(`...... zip-entry: ${relativePath}`); + zip.file(relativePath, fs.createReadStream(filePath), { compression: 'DEFLATE' }); + } + }); + + let currentFile = null; + let zipStream = zip.generateNodeStream({ + base64: false, + compression: 'DEFLATE', + type: 'nodebuffer', + streamFiles: true + }, function (chunk) { + if (chunk.currentFile != currentFile) { + currentFile = chunk.currentFile; + tl.debug(chunk.currentFile ? "Deflating file: " + chunk.currentFile + ", progress %" + chunk.percent : "done"); + } + }); + + return zipStream; +} + +export function createZipFile(zipStream: NodeJS.ReadableStream, filename: string): Q.Promise { + var defer = Q.defer(); + + zipStream.pipe(fs.createWriteStream(filename)) + .on('finish', function () { + defer.resolve(); + }) + .on('error', function (err) { + defer.reject(tl.loc("FailedToCreateFile", filename, err)); + }); + + return defer.promise; +} + +export function resolveSinglePath(pattern: string, continueOnError?: boolean, packParentFolder?: boolean): string { + tl.debug("---- Resolving a single path"); + + let matches = resolvePaths(pattern, continueOnError, packParentFolder); + + if (matches && matches.length > 0) { + if (matches.length != 1) { + if (continueOnError) { + tl.warning(tl.loc("FoundMultipleFiles", pattern)); + } else { + throw new Error(tl.loc("FoundMultipleFiles", pattern)); + } + } + + return matches[0]; + } + + return null; +} + +export function resolvePaths(pattern: string, continueOnError?: boolean, packParentFolder?: boolean): string[] { + tl.debug("------- Resolving multiple paths"); + tl.debug("....... path pattern: " + (pattern || "")); + + if (pattern) { + let matches = tl.findMatch(null, pattern); + + if (!matches || matches.length === 0) { + if (continueOnError) { + tl.warning(tl.loc("CannotFindAnyFile", pattern)); + return null; + } else { + throw new Error(tl.loc("CannotFindAnyFile", pattern)); + } + } + + let selectedPaths = matches.map(v => packParentFolder ? path.dirname(v) : v); + tl.debug("....... selectedPaths: " + selectedPaths); + + let uniquePaths = removeDuplicates(selectedPaths); + tl.debug("....... uniquePaths: " + uniquePaths); + + return uniquePaths; + } + + return null; +} + +export function removeDuplicates(list: string[]): string[] { + + interface IStringDictionary { [name: string]: number }; + let unique: IStringDictionary = {}; + + list.forEach(s => { + unique[s] = 0; + }); + + return Object.keys(unique); +} + +export function findCommonParent(list: string[]): string { + tl.debug("---- Detecting the common parent of all symbols paths to define the archive's internal folder structure.") + + function cutTail(list: string[], n: number) { + while (n-- > 0) { + list.pop(); + } + } + + if (!list) { + return null; + } + + let commonSegments: string[] = []; + let parentPath: string = null; + + list.forEach((nextPath, idx) => { + tl.debug(`------ next path[${idx}]\t ${nextPath}`); + + if (idx === 0) { + // Take the first path as the common parent candidate + commonSegments = nextPath.split("/"); + } else if (commonSegments.length === 0) { + // We've already detected that the paths do not have a common parent. + // No sense to check the rest of paths. + return null; + } else { + let pathSegmants: string[] = nextPath.split("/"); + + // If the current path contains less segments than the common path calculated so far, + // the trailing segmants in the latter cannot be a part of the resulting common path. + cutTail(commonSegments, commonSegments.length - pathSegmants.length); + + for (let i = 0; i < pathSegmants.length; i++) { + if (pathSegmants[i] !== commonSegments[i]) { + // Segments i, i+1, etc. cannot be a part of the resulting common path. + cutTail(commonSegments, commonSegments.length - i); + break; + } + } + } + + parentPath = commonSegments.join("/"); + tl.debug(`...... parent path \t ${parentPath}`); + }) + + return parentPath; +} + + From fbf71f035d6c08f4526f57f5cd9f99c9d7f05889 Mon Sep 17 00:00:00 2001 From: Evgenii Khramkov Date: Thu, 7 Mar 2019 18:10:42 +0300 Subject: [PATCH 02/17] add destination type and silent release options --- .../resources.resjson/en-US/resources.resjson | 9 +- .../appcenterdistribute.ts | 20 ++- Tasks/AppCenterDistributeV3/package-lock.json | 138 +++++++++--------- Tasks/AppCenterDistributeV3/task.json | 41 +++++- Tasks/AppCenterDistributeV3/task.loc.json | 43 +++++- 5 files changed, 169 insertions(+), 82 deletions(-) diff --git a/Tasks/AppCenterDistributeV3/Strings/resources.resjson/en-US/resources.resjson b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/en-US/resources.resjson index 436c994a4dc6..37f4ca904bf5 100644 --- a/Tasks/AppCenterDistributeV3/Strings/resources.resjson/en-US/resources.resjson +++ b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/en-US/resources.resjson @@ -28,13 +28,18 @@ "loc.input.label.releaseNotesFile": "Release notes file", "loc.input.help.releaseNotesFile": "Select a UTF-8 encoded text file which contains the Release Notes for this version.", "loc.input.label.isMandatory": "Require users to update to this release", - "loc.input.label.destinationIds": "Destination IDs", - "loc.input.help.destinationIds": "IDs of the distribution groups or stores the app will deploy to. Leave it empty to use the default group and use commas or semicolons to separate multiple IDs.", + "loc.input.label.destinationType": "Release destination", + "loc.input.label.destinationGroupIds": "Destination IDs", + "loc.input.help.destinationGroupIds": "IDs of the distribution groups to release to. Leave it empty to use the default group and use commas or semicolons to separate multiple IDs.", + "loc.input.label.destinationStoreId": "Destination ID", + "loc.input.help.destinationStoreId": "ID of the distribution store to deploy to.", + "loc.input.label.silentRelease": "Do not notify testers. Release will still be available to install.", "loc.messages.CannotDecodeEndpoint": "Could not decode the endpoint.", "loc.messages.NoResponseFromServer": "No response from server.", "loc.messages.FailedToUploadFile": "Failed to complete file upload.", "loc.messages.NoApiTokenFound": "No API token found on the Visual Studio App Center service connection.", "loc.messages.InvalidDestinationInput": "The destination input provided was invalid", + "loc.messages.CanNotDistributeToMultipleStores": "Cannot distribute to multiple stores", "loc.messages.Succeeded": "App Center Distribute task succeeded", "loc.messages.CannotFindAnyFile": "Cannot find any file based on %s.", "loc.messages.FoundMultipleFiles": "Found multiple files matching %s.", diff --git a/Tasks/AppCenterDistributeV3/appcenterdistribute.ts b/Tasks/AppCenterDistributeV3/appcenterdistribute.ts index fbd814c6c6e4..7856a95041fc 100644 --- a/Tasks/AppCenterDistributeV3/appcenterdistribute.ts +++ b/Tasks/AppCenterDistributeV3/appcenterdistribute.ts @@ -145,7 +145,7 @@ function commitRelease(apiServer: string, apiVersion: string, appSlug: string, u return defer.promise; } -function publishRelease(apiServer: string, releaseUrl: string, isMandatory: boolean, releaseNotes: string, destinationIds: string[], token: string, userAgent: string) { +function publishRelease(apiServer: string, releaseUrl: string, isMandatory: boolean, isSilent: boolean, releaseNotes: string, destinationIds: string[], token: string, userAgent: string) { tl.debug("-- Mark package available."); let defer = Q.defer(); let publishReleaseUrl: string = `${apiServer}/${releaseUrl}`; @@ -164,6 +164,10 @@ function publishRelease(apiServer: string, releaseUrl: string, isMandatory: bool "destinations": destinations }; + if (isSilent) { + publishBody["notify_testers"] = false; + } + let branchName = process.env['BUILD_SOURCEBRANCH']; branchName = getBranchName(branchName); const sourceVersion = process.env['BUILD_SOURCEVERSION']; @@ -433,9 +437,12 @@ async function run() { let isMandatory: boolean = tl.getBoolInput('isMandatory', false); - let destinations = tl.getInput('destinationIds', false) || '00000000-0000-0000-0000-000000000000'; + const destinationType = tl.getInput('destinationType', true) || "groups"; + const destinationsInputName = destinationType === 'groups' ? 'destinationGroupIds' : 'destinationStoreId'; + + let destinations = tl.getInput(destinationsInputName, true); tl.debug(`Effective destinationIds: ${destinations}`); - let destinationIds = destinations.split(/[, ;]+/).filter(id => id); + let destinationIds = destinations.split(/[, ;]+/).map(id => id.trim()).filter(id => id); // Validate inputs if (!apiToken) { @@ -444,6 +451,11 @@ async function run() { if (!destinationIds.length) { throw new Error(tl.loc("InvalidDestinationInput")); } + if (destinationType === "store" && destinationIds.length > 1) { + throw new Error(tl.loc("CanNotDistributeToMultipleStores")); + } + + const isSilent: boolean = destinationType === "groups" && tl.getBoolInput('silentRelease', false) || false; let app = utils.resolveSinglePath(appFilePattern); tl.checkPath(app, "Binary file"); @@ -470,7 +482,7 @@ async function run() { let packageUrl = await commitRelease(effectiveApiServer, effectiveApiVersion, appSlug, uploadInfo.upload_id, apiToken, userAgent); // Publish - await publishRelease(effectiveApiServer, packageUrl, isMandatory, releaseNotes, destinationIds, apiToken, userAgent); + await publishRelease(effectiveApiServer, packageUrl, isMandatory, isSilent, releaseNotes, destinationIds, apiToken, userAgent); if (symbolsFile) { // Begin preparing upload symbols diff --git a/Tasks/AppCenterDistributeV3/package-lock.json b/Tasks/AppCenterDistributeV3/package-lock.json index 720d6613e120..11850ee71ae6 100644 --- a/Tasks/AppCenterDistributeV3/package-lock.json +++ b/Tasks/AppCenterDistributeV3/package-lock.json @@ -9,10 +9,10 @@ "resolved": "https://registry.npmjs.org/ajv/-/ajv-5.5.2.tgz", "integrity": "sha1-c7Xuyj+rZT49P5Qis0GtQiBdyWU=", "requires": { - "co": "^4.6.0", - "fast-deep-equal": "^1.0.0", - "fast-json-stable-stringify": "^2.0.0", - "json-schema-traverse": "^0.3.0" + "co": "4.6.0", + "fast-deep-equal": "1.1.0", + "fast-json-stable-stringify": "2.0.0", + "json-schema-traverse": "0.3.1" } }, "asn1": { @@ -51,7 +51,7 @@ "integrity": "sha1-Y7xdy2EzG5K8Bf1SiVPDNGKgb40=", "optional": true, "requires": { - "tweetnacl": "^0.14.3" + "tweetnacl": "0.14.5" } }, "brace-expansion": { @@ -59,7 +59,7 @@ "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.8.tgz", "integrity": "sha1-wHshHHyVLsH479Uad+8NHTmQopI=", "requires": { - "balanced-match": "^1.0.0", + "balanced-match": "1.0.0", "concat-map": "0.0.1" } }, @@ -78,7 +78,7 @@ "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.6.tgz", "integrity": "sha1-cj599ugBrFYTETp+RFqbactjKBg=", "requires": { - "delayed-stream": "~1.0.0" + "delayed-stream": "1.0.0" } }, "concat-map": { @@ -101,7 +101,7 @@ "resolved": "https://registry.npmjs.org/dashdash/-/dashdash-1.14.1.tgz", "integrity": "sha1-hTz6D3y+L+1d4gMmuN1YEDX24vA=", "requires": { - "assert-plus": "^1.0.0" + "assert-plus": "1.0.0" } }, "delayed-stream": { @@ -115,7 +115,7 @@ "integrity": "sha1-D8c6ntXw1Tw4GTOYUj735UN3dQU=", "optional": true, "requires": { - "jsbn": "~0.1.0" + "jsbn": "0.1.1" } }, "es6-promise": { @@ -153,9 +153,9 @@ "resolved": "https://registry.npmjs.org/form-data/-/form-data-2.3.2.tgz", "integrity": "sha1-SXBJi+YEwgwAXU9cI67NIda0kJk=", "requires": { - "asynckit": "^0.4.0", + "asynckit": "0.4.0", "combined-stream": "1.0.6", - "mime-types": "^2.1.12" + "mime-types": "2.1.18" } }, "getpass": { @@ -163,7 +163,7 @@ "resolved": "https://registry.npmjs.org/getpass/-/getpass-0.1.7.tgz", "integrity": "sha1-Xv+OPmhNVprkyysSgmBOi6YhSfo=", "requires": { - "assert-plus": "^1.0.0" + "assert-plus": "1.0.0" } }, "har-schema": { @@ -176,8 +176,8 @@ "resolved": "https://registry.npmjs.org/har-validator/-/har-validator-5.0.3.tgz", "integrity": "sha1-ukAsJmGU8VlW7xXg/PJCmT9qff0=", "requires": { - "ajv": "^5.1.0", - "har-schema": "^2.0.0" + "ajv": "5.5.2", + "har-schema": "2.0.0" } }, "http-signature": { @@ -185,9 +185,9 @@ "resolved": "https://registry.npmjs.org/http-signature/-/http-signature-1.2.0.tgz", "integrity": "sha1-muzZJRFHcvPZW2WmCruPfBj7rOE=", "requires": { - "assert-plus": "^1.0.0", - "jsprim": "^1.2.2", - "sshpk": "^1.7.0" + "assert-plus": "1.0.0", + "jsprim": "1.4.1", + "sshpk": "1.14.1" } }, "immediate": { @@ -252,11 +252,11 @@ "resolved": "https://registry.npmjs.org/jszip/-/jszip-3.1.5.tgz", "integrity": "sha512-5W8NUaFRFRqTOL7ZDDrx5qWHJyBXy6velVudIzQUSoqAAYqzSh2Z7/m0Rf1QbmQJccegD0r+YZxBjzqoBiEeJQ==", "requires": { - "core-js": "~2.3.0", - "es6-promise": "~3.0.2", - "lie": "~3.1.0", - "pako": "~1.0.2", - "readable-stream": "~2.0.6" + "core-js": "2.3.0", + "es6-promise": "3.0.2", + "lie": "3.1.1", + "pako": "1.0.6", + "readable-stream": "2.0.6" } }, "lie": { @@ -264,7 +264,7 @@ "resolved": "https://registry.npmjs.org/lie/-/lie-3.1.1.tgz", "integrity": "sha1-mkNrLMd0bKWd56QfpGmz77dr2H4=", "requires": { - "immediate": "~3.0.5" + "immediate": "3.0.6" } }, "mime-db": { @@ -277,7 +277,7 @@ "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.18.tgz", "integrity": "sha512-lc/aahn+t4/SWV/qcmumYjymLsWfN3ELhpmVuUFjgsORruuZPVSwAQryq+HHGvO/SI2KVX26bx+En+zhM8g8hQ==", "requires": { - "mime-db": "~1.33.0" + "mime-db": "1.33.0" } }, "minimatch": { @@ -285,7 +285,7 @@ "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.0.4.tgz", "integrity": "sha512-yJHVQEhyqPLUTgt9B83PXu6W3rx4MvvHvSUvToogpwoGDOUQ+yDrR0HRot+yOCdCO7u4hX3pWft6kWBBcqh0UA==", "requires": { - "brace-expansion": "^1.1.7" + "brace-expansion": "1.1.8" } }, "mockery": { @@ -333,12 +333,12 @@ "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.0.6.tgz", "integrity": "sha1-j5A0HmilPMySh4jaz80Rs265t44=", "requires": { - "core-util-is": "~1.0.0", - "inherits": "~2.0.1", - "isarray": "~1.0.0", - "process-nextick-args": "~1.0.6", - "string_decoder": "~0.10.x", - "util-deprecate": "~1.0.1" + "core-util-is": "1.0.2", + "inherits": "2.0.3", + "isarray": "1.0.0", + "process-nextick-args": "1.0.7", + "string_decoder": "0.10.31", + "util-deprecate": "1.0.2" } }, "request": { @@ -346,26 +346,26 @@ "resolved": "https://registry.npmjs.org/request/-/request-2.87.0.tgz", "integrity": "sha512-fcogkm7Az5bsS6Sl0sibkbhcKsnyon/jV1kF3ajGmF0c8HrttdKTPRT9hieOaQHA5HEq6r8OyWOo/o781C1tNw==", "requires": { - "aws-sign2": "~0.7.0", - "aws4": "^1.6.0", - "caseless": "~0.12.0", - "combined-stream": "~1.0.5", - "extend": "~3.0.1", - "forever-agent": "~0.6.1", - "form-data": "~2.3.1", - "har-validator": "~5.0.3", - "http-signature": "~1.2.0", - "is-typedarray": "~1.0.0", - "isstream": "~0.1.2", - "json-stringify-safe": "~5.0.1", - "mime-types": "~2.1.17", - "oauth-sign": "~0.8.2", - "performance-now": "^2.1.0", - "qs": "~6.5.1", - "safe-buffer": "^5.1.1", - "tough-cookie": "~2.3.3", - "tunnel-agent": "^0.6.0", - "uuid": "^3.1.0" + "aws-sign2": "0.7.0", + "aws4": "1.7.0", + "caseless": "0.12.0", + "combined-stream": "1.0.6", + "extend": "3.0.1", + "forever-agent": "0.6.1", + "form-data": "2.3.2", + "har-validator": "5.0.3", + "http-signature": "1.2.0", + "is-typedarray": "1.0.0", + "isstream": "0.1.2", + "json-stringify-safe": "5.0.1", + "mime-types": "2.1.18", + "oauth-sign": "0.8.2", + "performance-now": "2.1.0", + "qs": "6.5.2", + "safe-buffer": "5.1.2", + "tough-cookie": "2.3.4", + "tunnel-agent": "0.6.0", + "uuid": "3.2.1" } }, "safe-buffer": { @@ -388,14 +388,14 @@ "resolved": "https://registry.npmjs.org/sshpk/-/sshpk-1.14.1.tgz", "integrity": "sha1-Ew9Zde3a2WPx1W+SuaxsUfqfg+s=", "requires": { - "asn1": "~0.2.3", - "assert-plus": "^1.0.0", - "bcrypt-pbkdf": "^1.0.0", - "dashdash": "^1.12.0", - "ecc-jsbn": "~0.1.1", - "getpass": "^0.1.1", - "jsbn": "~0.1.0", - "tweetnacl": "~0.14.0" + "asn1": "0.2.3", + "assert-plus": "1.0.0", + "bcrypt-pbkdf": "1.0.1", + "dashdash": "1.14.1", + "ecc-jsbn": "0.1.1", + "getpass": "0.1.7", + "jsbn": "0.1.1", + "tweetnacl": "0.14.5" } }, "string_decoder": { @@ -408,7 +408,7 @@ "resolved": "https://registry.npmjs.org/tough-cookie/-/tough-cookie-2.3.4.tgz", "integrity": "sha512-TZ6TTfI5NtZnuyy/Kecv+CnoROnyXn2DN97LontgQpCwsX2XyLYCC0ENhYkehSOwAp8rTQKc/NUIF7BkQ5rKLA==", "requires": { - "punycode": "^1.4.1" + "punycode": "1.4.1" } }, "tunnel-agent": { @@ -416,7 +416,7 @@ "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz", "integrity": "sha1-J6XeoGs2sEoKmWZ3SykIaPD8QP0=", "requires": { - "safe-buffer": "^5.0.1" + "safe-buffer": "5.1.2" } }, "tweetnacl": { @@ -440,9 +440,9 @@ "resolved": "https://registry.npmjs.org/verror/-/verror-1.10.0.tgz", "integrity": "sha1-OhBcoXBTr1XW4nDB+CiGguGNpAA=", "requires": { - "assert-plus": "^1.0.0", + "assert-plus": "1.0.0", "core-util-is": "1.0.2", - "extsprintf": "^1.2.0" + "extsprintf": "1.3.0" } }, "vsts-task-lib": { @@ -450,12 +450,12 @@ "resolved": "https://registry.npmjs.org/vsts-task-lib/-/vsts-task-lib-2.0.5.tgz", "integrity": "sha1-y9WrIy6rtxDJaXkFMYcmlZHA1RA=", "requires": { - "minimatch": "^3.0.0", - "mockery": "^1.7.0", - "q": "^1.1.2", - "semver": "^5.1.0", - "shelljs": "^0.3.0", - "uuid": "^3.0.1" + "minimatch": "3.0.4", + "mockery": "1.7.0", + "q": "1.5.1", + "semver": "5.5.0", + "shelljs": "0.3.0", + "uuid": "3.2.1" }, "dependencies": { "uuid": { diff --git a/Tasks/AppCenterDistributeV3/task.json b/Tasks/AppCenterDistributeV3/task.json index d0c29a67dea2..849f328293e5 100644 --- a/Tasks/AppCenterDistributeV3/task.json +++ b/Tasks/AppCenterDistributeV3/task.json @@ -166,16 +166,50 @@ "required": false }, { - "name": "destinationIds", + "name": "destinationType", + "type": "radio", + "label": "Release destination", + "required": true, + "defaultValue": "groups", + "options": { + "groups": "Groups", + "store": "Store" + } + }, + { + "name": "destinationGroupIds", "aliases": [ + "destinationIds", "distributionGroupId", "destinationId" ], "type": "string", "defaultValue": "", "label": "Destination IDs", - "helpMarkDown": "IDs of the distribution groups or stores the app will deploy to. Leave it empty to use the default group and use commas or semicolons to separate multiple IDs.", - "required": false + "helpMarkDown": "IDs of the distribution groups to release to. Leave it empty to use the default group and use commas or semicolons to separate multiple IDs.", + "required": false, + "visibleRule": "destinationType = groups" + }, + { + "name": "destinationStoreId", + "aliases": [ + "destinationIds", + "distributionGroupId", + "destinationId" + ], + "type": "string", + "defaultValue": "", + "label": "Destination ID", + "helpMarkDown": "ID of the distribution store to deploy to.", + "required": false, + "visibleRule": "destinationType = store" + }, + { + "name": "silentRelease", + "type": "boolean", + "label": "Do not notify testers. Release will still be available to install.", + "required": false, + "visibleRule": "destinationType = groups" } ], "instanceNameFormat": "Deploy $(app) to Visual Studio App Center", @@ -191,6 +225,7 @@ "FailedToUploadFile": "Failed to complete file upload.", "NoApiTokenFound": "No API token found on the Visual Studio App Center service connection.", "InvalidDestinationInput": "The destination input provided was invalid", + "CanNotDistributeToMultipleStores": "Cannot distribute to multiple stores", "Succeeded": "App Center Distribute task succeeded", "CannotFindAnyFile": "Cannot find any file based on %s.", "FoundMultipleFiles": "Found multiple files matching %s.", diff --git a/Tasks/AppCenterDistributeV3/task.loc.json b/Tasks/AppCenterDistributeV3/task.loc.json index b4ceaecff96a..9516795d5702 100644 --- a/Tasks/AppCenterDistributeV3/task.loc.json +++ b/Tasks/AppCenterDistributeV3/task.loc.json @@ -166,16 +166,50 @@ "required": false }, { - "name": "destinationIds", + "name": "destinationType", + "type": "radio", + "label": "ms-resource:loc.input.label.destinationType", + "required": true, + "defaultValue": "groups", + "options": { + "groups": "Groups", + "store": "Store" + } + }, + { + "name": "destinationGroupIds", "aliases": [ + "destinationIds", "distributionGroupId", "destinationId" ], "type": "string", "defaultValue": "", - "label": "ms-resource:loc.input.label.destinationIds", - "helpMarkDown": "ms-resource:loc.input.help.destinationIds", - "required": false + "label": "ms-resource:loc.input.label.destinationGroupIds", + "helpMarkDown": "ms-resource:loc.input.help.destinationGroupIds", + "required": false, + "visibleRule": "destinationType = groups" + }, + { + "name": "destinationStoreId", + "aliases": [ + "destinationIds", + "distributionGroupId", + "destinationId" + ], + "type": "string", + "defaultValue": "", + "label": "ms-resource:loc.input.label.destinationStoreId", + "helpMarkDown": "ms-resource:loc.input.help.destinationStoreId", + "required": false, + "visibleRule": "destinationType = store" + }, + { + "name": "silentRelease", + "type": "boolean", + "label": "ms-resource:loc.input.label.silentRelease", + "required": false, + "visibleRule": "destinationType = groups" } ], "instanceNameFormat": "ms-resource:loc.instanceNameFormat", @@ -191,6 +225,7 @@ "FailedToUploadFile": "ms-resource:loc.messages.FailedToUploadFile", "NoApiTokenFound": "ms-resource:loc.messages.NoApiTokenFound", "InvalidDestinationInput": "ms-resource:loc.messages.InvalidDestinationInput", + "CanNotDistributeToMultipleStores": "ms-resource:loc.messages.CanNotDistributeToMultipleStores", "Succeeded": "ms-resource:loc.messages.Succeeded", "CannotFindAnyFile": "ms-resource:loc.messages.CannotFindAnyFile", "FoundMultipleFiles": "ms-resource:loc.messages.FoundMultipleFiles", From 91e0b9ae0873895e2338e7ae5a1f4f5a245e012c Mon Sep 17 00:00:00 2001 From: Evgenii Khramkov Date: Thu, 7 Mar 2019 22:57:18 +0300 Subject: [PATCH 03/17] make destinations optinal for groups and mandatory for store --- Tasks/AppCenterDistributeV3/appcenterdistribute.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Tasks/AppCenterDistributeV3/appcenterdistribute.ts b/Tasks/AppCenterDistributeV3/appcenterdistribute.ts index 7856a95041fc..3919c764dbc4 100644 --- a/Tasks/AppCenterDistributeV3/appcenterdistribute.ts +++ b/Tasks/AppCenterDistributeV3/appcenterdistribute.ts @@ -437,10 +437,10 @@ async function run() { let isMandatory: boolean = tl.getBoolInput('isMandatory', false); - const destinationType = tl.getInput('destinationType', true) || "groups"; + const destinationType = tl.getInput('destinationType', false) || "groups"; const destinationsInputName = destinationType === 'groups' ? 'destinationGroupIds' : 'destinationStoreId'; - let destinations = tl.getInput(destinationsInputName, true); + let destinations = tl.getInput(destinationsInputName, destinationType === 'stores') || destinationType === "groups" ? "00000000-0000-0000-0000-000000000000" : ""; tl.debug(`Effective destinationIds: ${destinations}`); let destinationIds = destinations.split(/[, ;]+/).map(id => id.trim()).filter(id => id); From 5b90e121fd8b60d8d29500836a9c1c3c576a73f1 Mon Sep 17 00:00:00 2001 From: Evgenii Khramkov Date: Thu, 7 Mar 2019 23:16:19 +0300 Subject: [PATCH 04/17] fix expression --- Tasks/AppCenterDistributeV3/appcenterdistribute.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Tasks/AppCenterDistributeV3/appcenterdistribute.ts b/Tasks/AppCenterDistributeV3/appcenterdistribute.ts index 3919c764dbc4..b39838f86077 100644 --- a/Tasks/AppCenterDistributeV3/appcenterdistribute.ts +++ b/Tasks/AppCenterDistributeV3/appcenterdistribute.ts @@ -440,7 +440,7 @@ async function run() { const destinationType = tl.getInput('destinationType', false) || "groups"; const destinationsInputName = destinationType === 'groups' ? 'destinationGroupIds' : 'destinationStoreId'; - let destinations = tl.getInput(destinationsInputName, destinationType === 'stores') || destinationType === "groups" ? "00000000-0000-0000-0000-000000000000" : ""; + let destinations = tl.getInput(destinationsInputName, destinationType === 'stores') || (destinationType === "groups" ? "00000000-0000-0000-0000-000000000000" : ""); tl.debug(`Effective destinationIds: ${destinations}`); let destinationIds = destinations.split(/[, ;]+/).map(id => id.trim()).filter(id => id); From b04cf1d6fc8054277152651ea3f9c1878c3afa60 Mon Sep 17 00:00:00 2001 From: Evgenii Khramkov Date: Thu, 7 Mar 2019 23:16:53 +0300 Subject: [PATCH 05/17] update unit tests --- Tasks/AppCenterDistributeV3/Tests/L0.ts | 31 ++++ .../Tests/L0PublishMultipleDestinations.ts | 16 ++- .../Tests/L0PublishMultipleStoresFails.ts | 17 +++ .../Tests/L0PublishSilentUpdate.ts | 135 ++++++++++++++++++ .../Tests/L0PublishStore.ts | 87 +++++++++++ 5 files changed, 279 insertions(+), 7 deletions(-) create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0PublishMultipleStoresFails.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0PublishSilentUpdate.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0PublishStore.ts diff --git a/Tasks/AppCenterDistributeV3/Tests/L0.ts b/Tasks/AppCenterDistributeV3/Tests/L0.ts index 21e890d718f7..c07d2184131a 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0.ts @@ -75,6 +75,26 @@ describe('AppCenterDistribute L0 Suite', function () { assert(tr.failed, 'task should have failed'); }); + it('Negative path: publish multiple stores destinations fail the task', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0PublishMultipleStoresFails.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.failed, 'task should have failed'); + }); + + it('Positive path: publish single store destination', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0PublishStore.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.failed, 'task should have failed'); + }); + it('Positive path: single file with Include Parent', function () { this.timeout(4000); @@ -195,6 +215,17 @@ describe('AppCenterDistribute L0 Suite', function () { tr.run(); assert(tr.succeeded, 'task should have succeeded'); }); + + it('Positive path: publish silent update', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0PublishSilentUpdate.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.succeeded, 'task should have succeeded'); + }); + it('Positive path: publish multiple destinations', function () { this.timeout(4000); diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishMultipleDestinations.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishMultipleDestinations.ts index 40f70e4aebae..cebfbe0eb898 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0PublishMultipleDestinations.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishMultipleDestinations.ts @@ -17,7 +17,7 @@ tmr.setInput('app', '/test/path/to/my.ipa'); tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); tmr.setInput('releaseNotesInput', 'my release notes'); tmr.setInput('isMandatory', 'True'); -tmr.setInput('destinationIds', '11111111-1111-1111-1111-111111111111,22222222-2222-2222-2222-222222222222; 33333333-3333-3333-3333-333333333333, 44444444-4444-4444-4444-444444444444;; '); +tmr.setInput('destinationGroupIds', '11111111-1111-1111-1111-111111111111,22222222-2222-2222-2222-222222222222; 33333333-3333-3333-3333-333333333333, 44444444-4444-4444-4444-444444444444;; '); tmr.setInput('symbolsType', 'AndroidJava'); tmr.setInput('mappingTxtPath', '/test/path/to/mappings.txt'); @@ -56,10 +56,12 @@ nock('https://example.test') status: "available", release_notes: "my release notes", mandatory_update: true, - destinations: [{ id: "11111111-1111-1111-1111-111111111111" }, - { id: "22222222-2222-2222-2222-222222222222" }, - { id: "33333333-3333-3333-3333-333333333333" }, - { id: "44444444-4444-4444-4444-444444444444" }], + destinations: [ + { id: "11111111-1111-1111-1111-111111111111" }, + { id: "22222222-2222-2222-2222-222222222222" }, + { id: "33333333-3333-3333-3333-333333333333" }, + { id: "44444444-4444-4444-4444-444444444444" } + ], build: { id: '2', branch: 'master', @@ -95,11 +97,11 @@ nock('https://example.test') // provide answers for task mock let a: ma.TaskLibAnswers = { - "checkPath" : { + "checkPath": { "/test/path/to/my.ipa": true, "/test/path/to/mappings.txt": true }, - "findMatch" : { + "findMatch": { "/test/path/to/mappings.txt": [ "/test/path/to/mappings.txt" ], diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishMultipleStoresFails.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishMultipleStoresFails.ts new file mode 100644 index 000000000000..fc4e08c22712 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishMultipleStoresFails.ts @@ -0,0 +1,17 @@ +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('isMandatory', 'True'); +tmr.setInput('destinationType', 'stores'); +tmr.setInput('destinationStoreId', '11111111-1111-1111-1111-111111111111,22222222-2222-2222-2222-222222222222; 33333333-3333-3333-3333-333333333333, 44444444-4444-4444-4444-444444444444;; '); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishSilentUpdate.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishSilentUpdate.ts new file mode 100644 index 000000000000..86f8ffd6da59 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishSilentUpdate.ts @@ -0,0 +1,135 @@ + +import ma = require('vsts-task-lib/mock-answer'); +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); +import fs = require('fs'); +var Readable = require('stream').Readable +var Stats = require('fs').Stats + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('isMandatory', 'True'); +tmr.setInput('silentRelease', 'True'); +tmr.setInput('symbolsType', 'AndroidJava'); +tmr.setInput('mappingTxtPath', '/test/path/to/mappings.txt'); + +process.env['BUILD_BUILDID'] = '2'; +process.env['BUILD_SOURCEBRANCH'] = 'refs/heads/master'; +process.env['BUILD_SOURCEVERSION'] = 'commitsha'; + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/release_uploads/1", { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +//JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 +nock('https://example.test') + .patch("/my_release_location", JSON.stringify({ + status: "available", + release_notes: "my release notes", + mandatory_update: true, + destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + notify_testers: false, + build: { + id: '2', + branch: 'master', + commit_hash: 'commitsha' + } + })) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: "AndroidJava" + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/symbol_uploads/100", { + status: 'committed' + }) + .reply(200); + +// provide answers for task mock +let a: ma.TaskLibAnswers = { + "checkPath" : { + "/test/path/to/my.ipa": true, + "/test/path/to/mappings.txt": true + }, + "findMatch" : { + "/test/path/to/mappings.txt": [ + "/test/path/to/mappings.txt" + ], + "/test/path/to/my.ipa": [ + "/test/path/to/my.ipa" + ] + } +}; +tmr.setAnswers(a); + +fs.createReadStream = (s: string) => { + let stream = new Readable; + stream.push(s); + stream.push(null); + + return stream; +}; + +fs.statSync = (s: string) => { + let stat = new Stats; + + stat.isFile = () => { + return !s.toLowerCase().endsWith(".dsym"); + } + stat.isDirectory = () => { + return s.toLowerCase().endsWith(".dsym"); + } + stat.size = 100; + + return stat; +} +tmr.registerMock('fs', fs); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishStore.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishStore.ts new file mode 100644 index 000000000000..2df880545bf6 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishStore.ts @@ -0,0 +1,87 @@ +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('isMandatory', 'True'); +tmr.setInput('destinationType', 'stores'); +tmr.setInput('destinationStoreId', '11111111-1111-1111-1111-111111111111'); + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/release_uploads/1", { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +//JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 +nock('https://example.test') + .patch("/my_release_location", JSON.stringify({ + status: "available", + release_notes: "my release notes", + mandatory_update: true, + destinations: [ + { id: "11111111-1111-1111-1111-111111111111" } + ], + build: { + id: '2', + branch: 'master', + commit_hash: 'commitsha' + } + })) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: "AndroidJava" + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/symbol_uploads/100", { + status: 'committed' + }) + .reply(200); + + +tmr.run(); + From b84b6b7eb77fb2485e78ff2f0da38aed6633c454 Mon Sep 17 00:00:00 2001 From: Evgenii Khramkov Date: Thu, 7 Mar 2019 23:32:18 +0300 Subject: [PATCH 06/17] fix isSilent parameter name, refactor types --- .../resources.resjson/en-US/resources.resjson | 2 +- Tasks/AppCenterDistributeV3/Tests/L0.ts | 20 +++++ .../Tests/L0PublishNoStoresFails.ts | 16 ++++ .../Tests/L0PublishSilentUpdate.ts | 2 +- .../Tests/L0PublishStoreIgnoreSilent.ts | 88 +++++++++++++++++++ .../appcenterdistribute.ts | 17 ++-- Tasks/AppCenterDistributeV3/task.json | 2 +- Tasks/AppCenterDistributeV3/task.loc.json | 4 +- 8 files changed, 141 insertions(+), 10 deletions(-) create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0PublishNoStoresFails.ts create mode 100644 Tasks/AppCenterDistributeV3/Tests/L0PublishStoreIgnoreSilent.ts diff --git a/Tasks/AppCenterDistributeV3/Strings/resources.resjson/en-US/resources.resjson b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/en-US/resources.resjson index 37f4ca904bf5..2a9bce8b4f37 100644 --- a/Tasks/AppCenterDistributeV3/Strings/resources.resjson/en-US/resources.resjson +++ b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/en-US/resources.resjson @@ -33,7 +33,7 @@ "loc.input.help.destinationGroupIds": "IDs of the distribution groups to release to. Leave it empty to use the default group and use commas or semicolons to separate multiple IDs.", "loc.input.label.destinationStoreId": "Destination ID", "loc.input.help.destinationStoreId": "ID of the distribution store to deploy to.", - "loc.input.label.silentRelease": "Do not notify testers. Release will still be available to install.", + "loc.input.label.isSilent": "Do not notify testers. Release will still be available to install.", "loc.messages.CannotDecodeEndpoint": "Could not decode the endpoint.", "loc.messages.NoResponseFromServer": "No response from server.", "loc.messages.FailedToUploadFile": "Failed to complete file upload.", diff --git a/Tasks/AppCenterDistributeV3/Tests/L0.ts b/Tasks/AppCenterDistributeV3/Tests/L0.ts index c07d2184131a..b56e3243f3e2 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0.ts @@ -85,6 +85,16 @@ describe('AppCenterDistribute L0 Suite', function () { assert(tr.failed, 'task should have failed'); }); + it('Negative path: publish stores without destintation fail the task', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0PublishNoStoresFails.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.failed, 'task should have failed'); + }); + it('Positive path: publish single store destination', function () { this.timeout(4000); @@ -95,6 +105,16 @@ describe('AppCenterDistribute L0 Suite', function () { assert(tr.failed, 'task should have failed'); }); + it('Positive path: publish single store destination and ignores isSilent property', function () { + this.timeout(4000); + + let tp = path.join(__dirname, 'L0PublishStoreIgnoreSilent.js'); + let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); + + tr.run(); + assert(tr.failed, 'task should have failed'); + }); + it('Positive path: single file with Include Parent', function () { this.timeout(4000); diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishNoStoresFails.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishNoStoresFails.ts new file mode 100644 index 000000000000..8b8da49808df --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishNoStoresFails.ts @@ -0,0 +1,16 @@ +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('isMandatory', 'True'); +tmr.setInput('destinationType', 'stores'); + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishSilentUpdate.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishSilentUpdate.ts index 86f8ffd6da59..79fc1aa2ed0a 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0PublishSilentUpdate.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishSilentUpdate.ts @@ -17,7 +17,7 @@ tmr.setInput('app', '/test/path/to/my.ipa'); tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); tmr.setInput('releaseNotesInput', 'my release notes'); tmr.setInput('isMandatory', 'True'); -tmr.setInput('silentRelease', 'True'); +tmr.setInput('isSilent', 'True'); tmr.setInput('symbolsType', 'AndroidJava'); tmr.setInput('mappingTxtPath', '/test/path/to/mappings.txt'); diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishStoreIgnoreSilent.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishStoreIgnoreSilent.ts new file mode 100644 index 000000000000..c23b5758eb78 --- /dev/null +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishStoreIgnoreSilent.ts @@ -0,0 +1,88 @@ +import tmrm = require('vsts-task-lib/mock-run'); +import path = require('path'); + +var nock = require('nock'); + +let taskPath = path.join(__dirname, '..', 'appcenterdistribute.js'); +let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath); + +tmr.setInput('serverEndpoint', 'MyTestEndpoint'); +tmr.setInput('appSlug', 'testuser/testapp'); +tmr.setInput('app', '/test/path/to/my.ipa'); +tmr.setInput('releaseNotesSelection', 'releaseNotesInput'); +tmr.setInput('releaseNotesInput', 'my release notes'); +tmr.setInput('isMandatory', 'True'); +tmr.setInput('isSilent', 'True'); +tmr.setInput('destinationType', 'stores'); +tmr.setInput('destinationStoreId', '11111111-1111-1111-1111-111111111111'); + +//prepare upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/release_uploads') + .reply(201, { + upload_id: 1, + upload_url: 'https://example.upload.test/release_upload' + }); + +//upload +nock('https://example.upload.test') + .post('/release_upload') + .reply(201, { + status: 'success' + }); + +//finishing upload, commit the package +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/release_uploads/1", { + status: 'committed' + }) + .reply(200, { + release_url: 'my_release_location' + }); + +//make it available +//JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 +nock('https://example.test') + .patch("/my_release_location", JSON.stringify({ + status: "available", + release_notes: "my release notes", + mandatory_update: true, + destinations: [ + { id: "11111111-1111-1111-1111-111111111111" } + ], + build: { + id: '2', + branch: 'master', + commit_hash: 'commitsha' + } + })) + .reply(200); + +//begin symbol upload +nock('https://example.test') + .post('/v0.1/apps/testuser/testapp/symbol_uploads', { + symbol_type: "AndroidJava" + }) + .reply(201, { + symbol_upload_id: 100, + upload_url: 'https://example.upload.test/symbol_upload', + expiration_date: 1234567 + }); + +//upload symbols +nock('https://example.upload.test') + .put('/symbol_upload') + .reply(201, { + status: 'success' + }); + +//finishing symbol upload, commit the symbol +nock('https://example.test') + .patch("/v0.1/apps/testuser/testapp/symbol_uploads/100", { + status: 'committed' + }) + .reply(200); + + +tmr.run(); + diff --git a/Tasks/AppCenterDistributeV3/appcenterdistribute.ts b/Tasks/AppCenterDistributeV3/appcenterdistribute.ts index b39838f86077..c23d5cbef539 100644 --- a/Tasks/AppCenterDistributeV3/appcenterdistribute.ts +++ b/Tasks/AppCenterDistributeV3/appcenterdistribute.ts @@ -20,6 +20,12 @@ class SymbolsUploadInfo { expiration_date: string; } +type DestinationType = "groups" | "store"; +const DestinationType = { + Groups: "groups" as DestinationType, + Store: "store" as DestinationType +} + function getEndpointDetails(endpointInputFieldName) { var errorMessage = tl.loc("CannotDecodeEndpoint"); var endpoint = tl.getInput(endpointInputFieldName, true); @@ -437,10 +443,11 @@ async function run() { let isMandatory: boolean = tl.getBoolInput('isMandatory', false); - const destinationType = tl.getInput('destinationType', false) || "groups"; - const destinationsInputName = destinationType === 'groups' ? 'destinationGroupIds' : 'destinationStoreId'; + const destinationType = tl.getInput('destinationType', false) as DestinationType || DestinationType.Groups; + const destinationsInputName = destinationType === DestinationType.Groups ? 'destinationGroupIds' : 'destinationStoreId'; + const destinationIsMandatory = destinationType === DestinationType.Store; - let destinations = tl.getInput(destinationsInputName, destinationType === 'stores') || (destinationType === "groups" ? "00000000-0000-0000-0000-000000000000" : ""); + let destinations = tl.getInput(destinationsInputName, destinationIsMandatory) || "00000000-0000-0000-0000-000000000000"; tl.debug(`Effective destinationIds: ${destinations}`); let destinationIds = destinations.split(/[, ;]+/).map(id => id.trim()).filter(id => id); @@ -451,11 +458,11 @@ async function run() { if (!destinationIds.length) { throw new Error(tl.loc("InvalidDestinationInput")); } - if (destinationType === "store" && destinationIds.length > 1) { + if (destinationType === DestinationType.Store && destinationIds.length > 1) { throw new Error(tl.loc("CanNotDistributeToMultipleStores")); } - const isSilent: boolean = destinationType === "groups" && tl.getBoolInput('silentRelease', false) || false; + const isSilent: boolean = destinationType === DestinationType.Groups && (tl.getBoolInput('isSilent', false) || false); let app = utils.resolveSinglePath(appFilePattern); tl.checkPath(app, "Binary file"); diff --git a/Tasks/AppCenterDistributeV3/task.json b/Tasks/AppCenterDistributeV3/task.json index 849f328293e5..1babb0f8405d 100644 --- a/Tasks/AppCenterDistributeV3/task.json +++ b/Tasks/AppCenterDistributeV3/task.json @@ -205,7 +205,7 @@ "visibleRule": "destinationType = store" }, { - "name": "silentRelease", + "name": "isSilent", "type": "boolean", "label": "Do not notify testers. Release will still be available to install.", "required": false, diff --git a/Tasks/AppCenterDistributeV3/task.loc.json b/Tasks/AppCenterDistributeV3/task.loc.json index 9516795d5702..258f6163074f 100644 --- a/Tasks/AppCenterDistributeV3/task.loc.json +++ b/Tasks/AppCenterDistributeV3/task.loc.json @@ -205,9 +205,9 @@ "visibleRule": "destinationType = store" }, { - "name": "silentRelease", + "name": "isSilent", "type": "boolean", - "label": "ms-resource:loc.input.label.silentRelease", + "label": "ms-resource:loc.input.label.isSilent", "required": false, "visibleRule": "destinationType = groups" } From d75565af1366d83ed2ebdae089ad2834dee74de2 Mon Sep 17 00:00:00 2001 From: Evgenii Khramkov Date: Fri, 8 Mar 2019 20:43:43 +0300 Subject: [PATCH 07/17] make store destination required --- Tasks/AppCenterDistributeV3/task.json | 3 +-- Tasks/AppCenterDistributeV3/task.loc.json | 3 +-- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/Tasks/AppCenterDistributeV3/task.json b/Tasks/AppCenterDistributeV3/task.json index 1babb0f8405d..b7a0f07d77e7 100644 --- a/Tasks/AppCenterDistributeV3/task.json +++ b/Tasks/AppCenterDistributeV3/task.json @@ -198,10 +198,9 @@ "destinationId" ], "type": "string", - "defaultValue": "", "label": "Destination ID", "helpMarkDown": "ID of the distribution store to deploy to.", - "required": false, + "required": true, "visibleRule": "destinationType = store" }, { diff --git a/Tasks/AppCenterDistributeV3/task.loc.json b/Tasks/AppCenterDistributeV3/task.loc.json index 258f6163074f..df8a91ea7151 100644 --- a/Tasks/AppCenterDistributeV3/task.loc.json +++ b/Tasks/AppCenterDistributeV3/task.loc.json @@ -198,10 +198,9 @@ "destinationId" ], "type": "string", - "defaultValue": "", "label": "ms-resource:loc.input.label.destinationStoreId", "helpMarkDown": "ms-resource:loc.input.help.destinationStoreId", - "required": false, + "required": true, "visibleRule": "destinationType = store" }, { From 929375a326e87f2bd49dc81c7dec4af1624166fe Mon Sep 17 00:00:00 2001 From: Evgenii Khramkov Date: Fri, 8 Mar 2019 22:00:07 +0300 Subject: [PATCH 08/17] use new post api for publishing release to destination; move updating api notes in a separate call --- .../appcenterdistribute.ts | 66 +++++++++++++++---- 1 file changed, 52 insertions(+), 14 deletions(-) diff --git a/Tasks/AppCenterDistributeV3/appcenterdistribute.ts b/Tasks/AppCenterDistributeV3/appcenterdistribute.ts index c23d5cbef539..b47a39574499 100644 --- a/Tasks/AppCenterDistributeV3/appcenterdistribute.ts +++ b/Tasks/AppCenterDistributeV3/appcenterdistribute.ts @@ -26,6 +26,11 @@ const DestinationType = { Store: "store" as DestinationType } +const DestinationTypeParameter = { + [DestinationType.Groups]: "groups", + [DestinationType.Store]: "stores" +} + function getEndpointDetails(endpointInputFieldName) { var errorMessage = tl.loc("CannotDecodeEndpoint"); var endpoint = tl.getInput(endpointInputFieldName, true); @@ -141,7 +146,7 @@ function commitRelease(apiServer: string, apiVersion: string, appSlug: string, u request.patch({ url: commitReleaseUrl, headers: headers, json: commitBody }, (err, res, body) => { responseHandler(defer, err, res, body, () => { if (body && body['release_url']) { - defer.resolve(body['release_url']); + defer.resolve(body['release_id']); } else { defer.reject(tl.loc("FailedToUploadFile")); } @@ -151,10 +156,10 @@ function commitRelease(apiServer: string, apiVersion: string, appSlug: string, u return defer.promise; } -function publishRelease(apiServer: string, releaseUrl: string, isMandatory: boolean, isSilent: boolean, releaseNotes: string, destinationIds: string[], token: string, userAgent: string) { +function publishRelease(apiServer: string, apiVersion: string, appSlug: string, releaseId: string, destinationType: DestinationType, isMandatory: boolean, isSilent: boolean, destinationId: string, token: string, userAgent: string) { tl.debug("-- Mark package available."); let defer = Q.defer(); - let publishReleaseUrl: string = `${apiServer}/${releaseUrl}`; + let publishReleaseUrl: string = `${apiServer}/${apiVersion}/apps/${appSlug}/releases/${releaseId}/${DestinationTypeParameter[destinationType]}`; tl.debug(`---- url: ${publishReleaseUrl}`); let headers = { @@ -162,18 +167,48 @@ function publishRelease(apiServer: string, releaseUrl: string, isMandatory: bool "User-Agent": userAgent, "internal-request-source": "VSTS" }; - const destinations = destinationIds.map(id => { return { "id": id }; }); let publishBody = { - "status": "available", - "release_notes": releaseNotes, - "mandatory_update": isMandatory, - "destinations": destinations + "id": destinationId }; - if (isSilent) { - publishBody["notify_testers"] = false; + if (destinationType === DestinationType.Groups) { + publishBody["mandatory_update"] = isMandatory; + if (isSilent) { + publishBody["notify_testers"] = false; + } } + // Builds started by App Center has the commit message set when distribution is enabled + const commitMessage = process.env['LASTCOMMITMESSAGE']; + // Updating the internal_request_source to distinguish the AppCenter triggered build and custom build + if (!!commitMessage) { + headers["internal-request-source"] = "VSTS-APPCENTER"; + } + + request.post({ url: publishReleaseUrl, headers: headers, json: publishBody }, (err, res, body) => { + responseHandler(defer, err, res, body, () => { + defer.resolve(); + }); + }) + + return defer.promise; +} + +function updateRelease(apiServer: string, apiVersion: string, appSlug: string, releaseId: string, releaseNotes: string, token: string, userAgent: string) { + tl.debug("-- Updating release."); + let defer = Q.defer(); + let publishReleaseUrl: string = `${apiServer}/${apiVersion}/apps/${appSlug}/releases/${releaseId}`; + tl.debug(`---- url: ${publishReleaseUrl}`); + + let headers = { + "X-API-Token": token, + "User-Agent": userAgent, + "internal-request-source": "VSTS" + }; + let publishBody = { + "release_notes": releaseNotes + }; + let branchName = process.env['BUILD_SOURCEBRANCH']; branchName = getBranchName(branchName); const sourceVersion = process.env['BUILD_SOURCEVERSION']; @@ -202,7 +237,7 @@ function publishRelease(apiServer: string, releaseUrl: string, isMandatory: bool publishBody = Object.assign(publishBody, { build: build }); } - request.patch({ url: publishReleaseUrl, headers: headers, json: publishBody }, (err, res, body) => { + request.put({ url: publishReleaseUrl, headers: headers, json: publishBody }, (err, res, body) => { responseHandler(defer, err, res, body, () => { defer.resolve(); }); @@ -486,10 +521,13 @@ async function run() { await uploadRelease(uploadInfo.upload_url, app, userAgent); // Commit the upload - let packageUrl = await commitRelease(effectiveApiServer, effectiveApiVersion, appSlug, uploadInfo.upload_id, apiToken, userAgent); + let releaseId = await commitRelease(effectiveApiServer, effectiveApiVersion, appSlug, uploadInfo.upload_id, apiToken, userAgent); - // Publish - await publishRelease(effectiveApiServer, packageUrl, isMandatory, isSilent, releaseNotes, destinationIds, apiToken, userAgent); + await updateRelease(effectiveApiServer, effectiveApiVersion, appSlug, releaseId, releaseNotes, apiToken, userAgent); + + await Q.all(destinationIds.map(destinationId => { + return publishRelease(effectiveApiServer, effectiveApiVersion, appSlug, releaseId, destinationType, isMandatory, isSilent, destinationId, apiToken, userAgent); + })); if (symbolsFile) { // Begin preparing upload symbols From 02d22692646ebd7d2ec3666882bcb08c5b49e8fd Mon Sep 17 00:00:00 2001 From: Evgenii Khramkov Date: Fri, 8 Mar 2019 22:00:17 +0300 Subject: [PATCH 09/17] update unit tests --- .../Tests/L0NoSymbolsConditionallyPass.ts | 13 ++++++--- .../Tests/L0OneIpaPass.ts | 13 ++++++--- .../Tests/L0PublishCommitInfo_1.ts | 15 +++++++---- .../Tests/L0PublishCommitInfo_2.ts | 23 +++++++++------- .../Tests/L0PublishCommitInfo_3.ts | 23 +++++++++------- .../Tests/L0PublishCommitInfo_4.ts | 23 +++++++++------- .../Tests/L0PublishMandatoryUpdate.ts | 23 +++++++++------- .../Tests/L0PublishMultipleDestinations.ts | 27 ++++++++++--------- .../Tests/L0PublishSilentUpdate.ts | 21 +++++++++------ .../Tests/L0PublishStore.ts | 16 ++++++----- .../Tests/L0PublishStoreIgnoreSilent.ts | 16 ++++++----- .../Tests/L0SymIncludeParent.ts | 13 ++++++--- .../Tests/L0SymMultipleDSYMs_flat_1.ts | 13 ++++++--- .../Tests/L0SymMultipleDSYMs_flat_2.ts | 13 ++++++--- .../Tests/L0SymMultipleDSYMs_single.ts | 13 ++++++--- .../Tests/L0SymMultipleDSYMs_tree.ts | 13 ++++++--- .../Tests/L0SymPDBs_multiple.ts | 13 ++++++--- .../Tests/L0SymPDBs_single.ts | 13 ++++++--- 18 files changed, 193 insertions(+), 111 deletions(-) diff --git a/Tasks/AppCenterDistributeV3/Tests/L0NoSymbolsConditionallyPass.ts b/Tasks/AppCenterDistributeV3/Tests/L0NoSymbolsConditionallyPass.ts index 33cc1eabf238..0aa6108bdb61 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0NoSymbolsConditionallyPass.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0NoSymbolsConditionallyPass.ts @@ -42,18 +42,23 @@ nock('https://example.test') status: 'committed' }) .reply(200, { + release_id: '1', release_url: 'my_release_location' }); //make it available nock('https://example.test') - .patch("/my_release_location", { - status: "available", - destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], - release_notes: "my release notes" + .post("/v0.1/apps/testuser/testapp/releases/1/groups", { + id: "00000000-0000-0000-0000-000000000000" }) .reply(200); +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes' + })) + .reply(200); + // provide answers for task mock let a: ma.TaskLibAnswers = { "findMatch": { diff --git a/Tasks/AppCenterDistributeV3/Tests/L0OneIpaPass.ts b/Tasks/AppCenterDistributeV3/Tests/L0OneIpaPass.ts index 8efcca5b7994..9cac0061be92 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0OneIpaPass.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0OneIpaPass.ts @@ -40,18 +40,23 @@ nock('https://example.test') status: 'committed' }) .reply(200, { + release_id: '1', release_url: 'my_release_location' }); //make it available nock('https://example.test') - .patch("/my_release_location", { - status: "available", - destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], - release_notes: "my release notes" + .post("/v0.1/apps/testuser/testapp/releases/1/groups", { + id: "00000000-0000-0000-0000-000000000000" }) .reply(200); +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes' + })) + .reply(200); + //begin symbol upload nock('https://example.test') .post('/v0.1/apps/testuser/testapp/symbol_uploads', { diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_1.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_1.ts index 661cbbce4736..1f494f0a976f 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_1.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_1.ts @@ -45,17 +45,22 @@ nock('https://example.test') status: 'committed' }) .reply(200, { + release_id: '1', release_url: 'my_release_location' }); //make it available //JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 nock('https://example.test') - .patch("/my_release_location", JSON.stringify({ - status: "available", - release_notes: "my release notes", - mandatory_update: false, - destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + .post("/v0.1/apps/testuser/testapp/releases/1/groups", JSON.stringify({ + id: "00000000-0000-0000-0000-000000000000", + mandatory_update: false + })) + .reply(200); + +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes', build: { id: '2', branch: 'master', diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_2.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_2.ts index 95651e0515ca..f0aeacfddbdc 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_2.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_2.ts @@ -44,17 +44,22 @@ nock('https://example.test') status: 'committed' }) .reply(200, { - release_url: 'my_release_location' + release_id: '1', + release_url: 'my_release_location' }); //make it available //JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 nock('https://example.test') - .patch("/my_release_location", JSON.stringify({ - status: "available", - release_notes: "my release notes", - mandatory_update: false, - destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + .post("/v0.1/apps/testuser/testapp/releases/1/groups", JSON.stringify({ + id: "00000000-0000-0000-0000-000000000000", + mandatory_update: false + })) + .reply(200); + +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes', build: { id: '2', branch: 'master', @@ -90,11 +95,11 @@ nock('https://example.test') // provide answers for task mock let a: ma.TaskLibAnswers = { - "checkPath" : { + "checkPath": { "/test/path/to/my.ipa": true, "/test/path/to/mappings.txt": true }, - "findMatch" : { + "findMatch": { "/test/path/to/mappings.txt": [ "/test/path/to/mappings.txt" ], @@ -115,7 +120,7 @@ fs.createReadStream = (s: string) => { fs.statSync = (s: string) => { let stat = new Stats; - + stat.isFile = () => { return !s.toLowerCase().endsWith(".dsym"); } diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_3.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_3.ts index 5d3921293038..bb6772338097 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_3.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_3.ts @@ -44,17 +44,22 @@ nock('https://example.test') status: 'committed' }) .reply(200, { - release_url: 'my_release_location' + release_id: '1', + release_url: 'my_release_location' }); //make it available //JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 nock('https://example.test') - .patch("/my_release_location", JSON.stringify({ - status: "available", - release_notes: "my release notes", - mandatory_update: false, - destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + .post("/v0.1/apps/testuser/testapp/releases/1/groups", JSON.stringify({ + id: "00000000-0000-0000-0000-000000000000", + mandatory_update: false + })) + .reply(200); + +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes', build: { id: '2', branch: 'feature/foobar', @@ -90,11 +95,11 @@ nock('https://example.test') // provide answers for task mock let a: ma.TaskLibAnswers = { - "checkPath" : { + "checkPath": { "/test/path/to/my.ipa": true, "/test/path/to/mappings.txt": true }, - "findMatch" : { + "findMatch": { "/test/path/to/mappings.txt": [ "/test/path/to/mappings.txt" ], @@ -115,7 +120,7 @@ fs.createReadStream = (s: string) => { fs.statSync = (s: string) => { let stat = new Stats; - + stat.isFile = () => { return !s.toLowerCase().endsWith(".dsym"); } diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_4.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_4.ts index 4401f9d988fc..e6e5ebc07595 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_4.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishCommitInfo_4.ts @@ -44,17 +44,22 @@ nock('https://example.test') status: 'committed' }) .reply(200, { - release_url: 'my_release_location' + release_id: '1', + release_url: 'my_release_location' }); //make it available //JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 nock('https://example.test') - .patch("/my_release_location", JSON.stringify({ - status: "available", - release_notes: "my release notes", - mandatory_update: false, - destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + .post("/v0.1/apps/testuser/testapp/releases/1/groups", JSON.stringify({ + id: "00000000-0000-0000-0000-000000000000", + mandatory_update: false + })) + .reply(200); + +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes', build: { id: '2', branch: '$/teamproject/main', @@ -90,11 +95,11 @@ nock('https://example.test') // provide answers for task mock let a: ma.TaskLibAnswers = { - "checkPath" : { + "checkPath": { "/test/path/to/my.ipa": true, "/test/path/to/mappings.txt": true }, - "findMatch" : { + "findMatch": { "/test/path/to/mappings.txt": [ "/test/path/to/mappings.txt" ], @@ -115,7 +120,7 @@ fs.createReadStream = (s: string) => { fs.statSync = (s: string) => { let stat = new Stats; - + stat.isFile = () => { return !s.toLowerCase().endsWith(".dsym"); } diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishMandatoryUpdate.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishMandatoryUpdate.ts index 5333c12417a7..46bb29750757 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0PublishMandatoryUpdate.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishMandatoryUpdate.ts @@ -45,17 +45,22 @@ nock('https://example.test') status: 'committed' }) .reply(200, { - release_url: 'my_release_location' + release_id: '1', + release_url: 'my_release_location' }); //make it available //JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 nock('https://example.test') - .patch("/my_release_location", JSON.stringify({ - status: "available", - release_notes: "my release notes", - mandatory_update: true, - destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], + .post("/v0.1/apps/testuser/testapp/releases/1/groups", JSON.stringify({ + id: "00000000-0000-0000-0000-000000000000", + mandatory_update: true + })) + .reply(200); + +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes', build: { id: '2', branch: 'master', @@ -91,11 +96,11 @@ nock('https://example.test') // provide answers for task mock let a: ma.TaskLibAnswers = { - "checkPath" : { + "checkPath": { "/test/path/to/my.ipa": true, "/test/path/to/mappings.txt": true }, - "findMatch" : { + "findMatch": { "/test/path/to/mappings.txt": [ "/test/path/to/mappings.txt" ], @@ -116,7 +121,7 @@ fs.createReadStream = (s: string) => { fs.statSync = (s: string) => { let stat = new Stats; - + stat.isFile = () => { return !s.toLowerCase().endsWith(".dsym"); } diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishMultipleDestinations.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishMultipleDestinations.ts index cebfbe0eb898..9abd1820ec85 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0PublishMultipleDestinations.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishMultipleDestinations.ts @@ -46,22 +46,25 @@ nock('https://example.test') status: 'committed' }) .reply(200, { + release_id: '1', release_url: 'my_release_location' }); -//make it available -//JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 +[ + "11111111-1111-1111-1111-111111111111", + "22222222-2222-2222-2222-222222222222", + "33333333-3333-3333-3333-333333333333", + "44444444-4444-4444-4444-444444444444", +].forEach(id => nock('https://example.test') + .post("/v0.1/apps/testuser/testapp/releases/1/groups", JSON.stringify({ + id, + mandatory_update: true + })) + .reply(200)); + nock('https://example.test') - .patch("/my_release_location", JSON.stringify({ - status: "available", - release_notes: "my release notes", - mandatory_update: true, - destinations: [ - { id: "11111111-1111-1111-1111-111111111111" }, - { id: "22222222-2222-2222-2222-222222222222" }, - { id: "33333333-3333-3333-3333-333333333333" }, - { id: "44444444-4444-4444-4444-444444444444" } - ], + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes', build: { id: '2', branch: 'master', diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishSilentUpdate.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishSilentUpdate.ts index 79fc1aa2ed0a..1e33a5979f14 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0PublishSilentUpdate.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishSilentUpdate.ts @@ -46,18 +46,23 @@ nock('https://example.test') status: 'committed' }) .reply(200, { - release_url: 'my_release_location' + release_id: '1', + release_url: 'my_release_location' }); //make it available //JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 nock('https://example.test') - .patch("/my_release_location", JSON.stringify({ - status: "available", - release_notes: "my release notes", + .post("/v0.1/apps/testuser/testapp/releases/1/groups", JSON.stringify({ + id: "00000000-0000-0000-0000-000000000000", mandatory_update: true, - destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], notify_testers: false, + })) + .reply(200); + +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes', build: { id: '2', branch: 'master', @@ -93,11 +98,11 @@ nock('https://example.test') // provide answers for task mock let a: ma.TaskLibAnswers = { - "checkPath" : { + "checkPath": { "/test/path/to/my.ipa": true, "/test/path/to/mappings.txt": true }, - "findMatch" : { + "findMatch": { "/test/path/to/mappings.txt": [ "/test/path/to/mappings.txt" ], @@ -118,7 +123,7 @@ fs.createReadStream = (s: string) => { fs.statSync = (s: string) => { let stat = new Stats; - + stat.isFile = () => { return !s.toLowerCase().endsWith(".dsym"); } diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishStore.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishStore.ts index 2df880545bf6..a751bfd1314e 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0PublishStore.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishStore.ts @@ -36,19 +36,21 @@ nock('https://example.test') status: 'committed' }) .reply(200, { + release_id: '1', release_url: 'my_release_location' }); //make it available //JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 nock('https://example.test') - .patch("/my_release_location", JSON.stringify({ - status: "available", - release_notes: "my release notes", - mandatory_update: true, - destinations: [ - { id: "11111111-1111-1111-1111-111111111111" } - ], + .post("/v0.1/apps/testuser/testapp/releases/1/stores", JSON.stringify({ + id: "11111111-1111-1111-1111-111111111111" + })) + .reply(200); + +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes', build: { id: '2', branch: 'master', diff --git a/Tasks/AppCenterDistributeV3/Tests/L0PublishStoreIgnoreSilent.ts b/Tasks/AppCenterDistributeV3/Tests/L0PublishStoreIgnoreSilent.ts index c23b5758eb78..4e57c8ef1b61 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0PublishStoreIgnoreSilent.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0PublishStoreIgnoreSilent.ts @@ -37,19 +37,21 @@ nock('https://example.test') status: 'committed' }) .reply(200, { + release_id: '1', release_url: 'my_release_location' }); //make it available //JSON.stringify to verify exact match of request body: https://github.com/node-nock/nock/issues/571 nock('https://example.test') - .patch("/my_release_location", JSON.stringify({ - status: "available", - release_notes: "my release notes", - mandatory_update: true, - destinations: [ - { id: "11111111-1111-1111-1111-111111111111" } - ], + .post("/v0.1/apps/testuser/testapp/releases/1/stores", JSON.stringify({ + id: "11111111-1111-1111-1111-111111111111" + })) + .reply(200); + +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes', build: { id: '2', branch: 'master', diff --git a/Tasks/AppCenterDistributeV3/Tests/L0SymIncludeParent.ts b/Tasks/AppCenterDistributeV3/Tests/L0SymIncludeParent.ts index 6c6a92cc4854..b03c593a6425 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0SymIncludeParent.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0SymIncludeParent.ts @@ -42,18 +42,23 @@ nock('https://example.test') status: 'committed' }) .reply(200, { + release_id: '1', release_url: 'my_release_location' }); //make it available nock('https://example.test') - .patch('/my_release_location', { - status: 'available', - destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], - release_notes: 'my release notes' + .post('/v0.1/apps/testuser/testapp/releases/1/groups', { + id: "00000000-0000-0000-0000-000000000000", }) .reply(200); +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes' + })) + .reply(200); + //begin symbol upload nock('https://example.test') .post('/v0.1/apps/testuser/testapp/symbol_uploads', { diff --git a/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_flat_1.ts b/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_flat_1.ts index acd238a7844d..a6fe8ab373ea 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_flat_1.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_flat_1.ts @@ -58,18 +58,23 @@ nock('https://example.test') status: 'committed' }) .reply(200, { + release_id: '1', release_url: 'my_release_location' }); //make it available nock('https://example.test') - .patch('/my_release_location', { - status: 'available', - destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], - release_notes: 'my release notes' + .post('/v0.1/apps/testuser/testapp/releases/1/groups', { + id: "00000000-0000-0000-0000-000000000000", }) .reply(200); +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes' + })) + .reply(200); + //begin symbol upload nock('https://example.test') .post('/v0.1/apps/testuser/testapp/symbol_uploads', { diff --git a/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_flat_2.ts b/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_flat_2.ts index 7a6c71cab772..7d3aab5073e1 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_flat_2.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_flat_2.ts @@ -60,18 +60,23 @@ nock('https://example.test') status: 'committed' }) .reply(200, { + release_id: '1', release_url: 'my_release_location' }); //make it available nock('https://example.test') - .patch('/my_release_location', { - status: 'available', - destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], - release_notes: 'my release notes' + .post('/v0.1/apps/testuser/testapp/releases/1/groups', { + id: "00000000-0000-0000-0000-000000000000" }) .reply(200); +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes' + })) + .reply(200); + //begin symbol upload nock('https://example.test') .post('/v0.1/apps/testuser/testapp/symbol_uploads', { diff --git a/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_single.ts b/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_single.ts index a514f8ac2f1b..ae53b04410c6 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_single.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_single.ts @@ -56,18 +56,23 @@ nock('https://example.test') status: 'committed' }) .reply(200, { + release_id: '1', release_url: 'my_release_location' }); //make it available nock('https://example.test') - .patch('/my_release_location', { - status: 'available', - destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], - release_notes: 'my release notes' + .post('/v0.1/apps/testuser/testapp/releases/1/groups', { + id: "00000000-0000-0000-0000-000000000000" }) .reply(200); +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes' + })) + .reply(200); + //begin symbol upload nock('https://example.test') .post('/v0.1/apps/testuser/testapp/symbol_uploads', { diff --git a/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_tree.ts b/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_tree.ts index a84e3f334f0a..e999ce18113e 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_tree.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0SymMultipleDSYMs_tree.ts @@ -64,18 +64,23 @@ nock('https://example.test') status: 'committed' }) .reply(200, { + release_id: '1', release_url: 'my_release_location' }); //make it available nock('https://example.test') - .patch('/my_release_location', { - status: 'available', - destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], - release_notes: 'my release notes' + .post('/v0.1/apps/testuser/testapp/releases/1/groups', { + id: "00000000-0000-0000-0000-000000000000", }) .reply(200); +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes' + })) + .reply(200); + //begin symbol upload nock('https://example.test') .post('/v0.1/apps/testuser/testapp/symbol_uploads', { diff --git a/Tasks/AppCenterDistributeV3/Tests/L0SymPDBs_multiple.ts b/Tasks/AppCenterDistributeV3/Tests/L0SymPDBs_multiple.ts index 43f0c385359c..92783e2eefe8 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0SymPDBs_multiple.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0SymPDBs_multiple.ts @@ -55,18 +55,23 @@ nock('https://example.test') status: 'committed' }) .reply(200, { + release_id: '1', release_url: 'my_release_location' }); //make it available nock('https://example.test') - .patch('/my_release_location', { - status: 'available', - destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], - release_notes: 'my release notes' + .post('/v0.1/apps/testuser/testapp/releases/1/groups', { + id: "00000000-0000-0000-0000-000000000000" }) .reply(200); +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes' + })) + .reply(200); + //begin symbol upload nock('https://example.test') .post('/v0.1/apps/testuser/testapp/symbol_uploads', { diff --git a/Tasks/AppCenterDistributeV3/Tests/L0SymPDBs_single.ts b/Tasks/AppCenterDistributeV3/Tests/L0SymPDBs_single.ts index 6d7508d6bfb3..e483e1345b7f 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0SymPDBs_single.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0SymPDBs_single.ts @@ -54,18 +54,23 @@ nock('https://example.test') status: 'committed' }) .reply(200, { + release_id: '1', release_url: 'my_release_location' }); //make it available nock('https://example.test') - .patch('/my_release_location', { - status: 'available', - destinations: [{ id: "00000000-0000-0000-0000-000000000000" }], - release_notes: 'my release notes' + .post('/v0.1/apps/testuser/testapp/releases/1/groups', { + id: "00000000-0000-0000-0000-000000000000", }) .reply(200); +nock('https://example.test') + .put('/v0.1/apps/testuser/testapp/releases/1', JSON.stringify({ + release_notes: 'my release notes' + })) + .reply(200); + //begin symbol upload nock('https://example.test') .post('/v0.1/apps/testuser/testapp/symbol_uploads', { From 60aa06e20e49fd6ce7904560c2502eea36bb6f63 Mon Sep 17 00:00:00 2001 From: Evgenii Khramkov Date: Mon, 11 Mar 2019 09:55:10 +0300 Subject: [PATCH 10/17] trigger checks From 44649c7071d71d213f28305d83a6df0cbefbc9b6 Mon Sep 17 00:00:00 2001 From: Evgenii Khramkov Date: Mon, 11 Mar 2019 11:46:06 +0300 Subject: [PATCH 11/17] DEBUG output test contents --- make.js | 2 ++ 1 file changed, 2 insertions(+) diff --git a/make.js b/make.js index face28ddf711..bb1d0d09005a 100644 --- a/make.js +++ b/make.js @@ -326,6 +326,8 @@ target.test = function() { mkdir('-p', path.join(buildTestsPath, 'lib')); matchCopy(path.join('**', '@(*.ps1|*.psm1)'), path.join(__dirname, 'Tests', 'lib'), path.join(buildTestsPath, 'lib')); + console.log(run(`cat ${path.join(__dirname, '_build/Tasks/AppCenterDistributeV3/Tests/L0OneIpaPass.js')}`)) + // find the tests var suiteType = options.suite || 'L0'; var taskType = options.task || '*'; From 28aed322b059cb348485c9adda99bc2de8342353 Mon Sep 17 00:00:00 2001 From: Evgenii Khramkov Date: Mon, 11 Mar 2019 11:50:12 +0300 Subject: [PATCH 12/17] Revert "DEBUG output test contents" This reverts commit 44649c7071d71d213f28305d83a6df0cbefbc9b6. --- make.js | 2 -- 1 file changed, 2 deletions(-) diff --git a/make.js b/make.js index bb1d0d09005a..face28ddf711 100644 --- a/make.js +++ b/make.js @@ -326,8 +326,6 @@ target.test = function() { mkdir('-p', path.join(buildTestsPath, 'lib')); matchCopy(path.join('**', '@(*.ps1|*.psm1)'), path.join(__dirname, 'Tests', 'lib'), path.join(buildTestsPath, 'lib')); - console.log(run(`cat ${path.join(__dirname, '_build/Tasks/AppCenterDistributeV3/Tests/L0OneIpaPass.js')}`)) - // find the tests var suiteType = options.suite || 'L0'; var taskType = options.task || '*'; From 71baee0189807f9218831328555a3f7dfe2660e2 Mon Sep 17 00:00:00 2001 From: Evgenii Khramkov Date: Mon, 11 Mar 2019 12:03:01 +0300 Subject: [PATCH 13/17] output failed tests --- Tasks/AppCenterDistributeV3/Tests/L0.ts | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/Tasks/AppCenterDistributeV3/Tests/L0.ts b/Tasks/AppCenterDistributeV3/Tests/L0.ts index b56e3243f3e2..5e2e9ea420d3 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0.ts @@ -32,6 +32,7 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); + console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); @@ -62,6 +63,7 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); + console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); @@ -122,6 +124,7 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); + console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); @@ -132,6 +135,7 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); + console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); @@ -142,6 +146,7 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); + console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); @@ -152,6 +157,7 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); + console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); @@ -162,6 +168,7 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); + console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); @@ -172,6 +179,7 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); + console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); @@ -183,6 +191,7 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); + console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); From 47ffbd6a846864d749e0c6284d4dfd5637a8c8fe Mon Sep 17 00:00:00 2001 From: Evgenii Khramkov Date: Mon, 11 Mar 2019 12:08:38 +0300 Subject: [PATCH 14/17] clear env before running a test --- Tasks/AppCenterDistributeV3/Tests/L0.ts | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Tasks/AppCenterDistributeV3/Tests/L0.ts b/Tasks/AppCenterDistributeV3/Tests/L0.ts index 5e2e9ea420d3..516f4d7bb2f3 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0.ts @@ -10,6 +10,10 @@ describe('AppCenterDistribute L0 Suite', function () { before(() => { //Enable this for output //process.env['TASK_TEST_TRACE'] = 1; + delete process.env['BUILD_BUILDID']; + delete process.env['BUILD_SOURCEBRANCH']; + delete process.env['BUILD_SOURCEVERSION']; + delete process.env['LASTCOMMITMESSAGE']; //setup endpoint process.env["ENDPOINT_AUTH_MyTestEndpoint"] = "{\"parameters\":{\"apitoken\":\"mytoken123\"},\"scheme\":\"apitoken\"}"; From 1825cd211e82b6817904eca5907543a25a4e0dfa Mon Sep 17 00:00:00 2001 From: Evgenii Khramkov Date: Mon, 11 Mar 2019 12:11:13 +0300 Subject: [PATCH 15/17] remove debug output --- Tasks/AppCenterDistributeV3/Tests/L0.ts | 9 --------- 1 file changed, 9 deletions(-) diff --git a/Tasks/AppCenterDistributeV3/Tests/L0.ts b/Tasks/AppCenterDistributeV3/Tests/L0.ts index 516f4d7bb2f3..486dd27e59c2 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0.ts @@ -36,7 +36,6 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); - console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); @@ -67,7 +66,6 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); - console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); @@ -128,7 +126,6 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); - console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); @@ -139,7 +136,6 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); - console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); @@ -150,7 +146,6 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); - console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); @@ -161,7 +156,6 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); - console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); @@ -172,7 +166,6 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); - console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); @@ -183,7 +176,6 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); - console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); @@ -195,7 +187,6 @@ describe('AppCenterDistribute L0 Suite', function () { let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp); tr.run(); - console.log(tr.stdout); assert(tr.succeeded, 'task should have succeeded'); }); From 94d7f0e5f558a6c52177804e81b7923d5a517916 Mon Sep 17 00:00:00 2001 From: Evgenii Khramkov Date: Mon, 11 Mar 2019 12:11:36 +0300 Subject: [PATCH 16/17] add comment --- Tasks/AppCenterDistributeV3/Tests/L0.ts | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Tasks/AppCenterDistributeV3/Tests/L0.ts b/Tasks/AppCenterDistributeV3/Tests/L0.ts index 486dd27e59c2..b6f88d2863df 100644 --- a/Tasks/AppCenterDistributeV3/Tests/L0.ts +++ b/Tasks/AppCenterDistributeV3/Tests/L0.ts @@ -10,6 +10,8 @@ describe('AppCenterDistribute L0 Suite', function () { before(() => { //Enable this for output //process.env['TASK_TEST_TRACE'] = 1; + + //clean env variables delete process.env['BUILD_BUILDID']; delete process.env['BUILD_SOURCEBRANCH']; delete process.env['BUILD_SOURCEVERSION']; From 683e9e561f2d29022605f34ce9d338bae51c1895 Mon Sep 17 00:00:00 2001 From: JacobRoberts Date: Tue, 12 Mar 2019 10:30:47 -0700 Subject: [PATCH 17/17] Change ui strings to be more specific Addressing https://github.com/Microsoft/azure-pipelines-tasks/pull/9759#pullrequestreview-212019948 --- .../Strings/resources.resjson/en-US/resources.resjson | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Tasks/AppCenterDistributeV3/Strings/resources.resjson/en-US/resources.resjson b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/en-US/resources.resjson index 2a9bce8b4f37..52aee811a4ac 100644 --- a/Tasks/AppCenterDistributeV3/Strings/resources.resjson/en-US/resources.resjson +++ b/Tasks/AppCenterDistributeV3/Strings/resources.resjson/en-US/resources.resjson @@ -29,9 +29,9 @@ "loc.input.help.releaseNotesFile": "Select a UTF-8 encoded text file which contains the Release Notes for this version.", "loc.input.label.isMandatory": "Require users to update to this release", "loc.input.label.destinationType": "Release destination", - "loc.input.label.destinationGroupIds": "Destination IDs", + "loc.input.label.destinationGroupIds": "Distribution Group IDs", "loc.input.help.destinationGroupIds": "IDs of the distribution groups to release to. Leave it empty to use the default group and use commas or semicolons to separate multiple IDs.", - "loc.input.label.destinationStoreId": "Destination ID", + "loc.input.label.destinationStoreId": "Store ID", "loc.input.help.destinationStoreId": "ID of the distribution store to deploy to.", "loc.input.label.isSilent": "Do not notify testers. Release will still be available to install.", "loc.messages.CannotDecodeEndpoint": "Could not decode the endpoint.", @@ -45,4 +45,4 @@ "loc.messages.FoundMultipleFiles": "Found multiple files matching %s.", "loc.messages.FailedToCreateFile": "Failed to create %s with error: %s.", "loc.messages.FailedToFindFile": "Failed to find %s at %s." -} \ No newline at end of file +}