Migrate existing Azure AI Face service to TypeSpec

cSpell.json

@@ -1240,7 +1240,7 @@
                  "WSUS"
             ]
         },
-        {          
+        {
             "filename": "**/specification/monitor/resource-manager/Microsoft.Insights/**/actionGroups_API.json",
             "words": [
                 "occurringlocation",
@@ -1250,6 +1250,14 @@
                 "tsgid",
                 "correlationid"
             ]
+        },
+        {
+            "filename": "**/specification/ai/data-plane/Face/**/*.json",
+            "words": [
+                "headwear",
+                "realface",
+                "spoofface"
+            ]
         }
     ],
     "enableFiletypes": [

specification/ai/Face/client.tsp

@@ -0,0 +1,201 @@
+import "@azure-tools/typespec-client-generator-core";
+import "@typespec/rest";
+import "@typespec/http";
+import "@typespec/versioning";
+import "./main.tsp";
+
+using Azure.ClientGenerator.Core;
+using Face;
+
+@TypeSpec.Versioning.useDependency(Azure.Core.Versions.v1_0_Preview_2)
+@TypeSpec.Versioning.useDependency(Face.Versions.v1_1_preview_1)
+namespace ClientCustomizations;
+
+@@clientName(RecognitionModel, "FaceRecognitionModel");
+@@clientName(DetectionModel, "FaceDetectionModel");
+@@clientName(OperationStatus, "FaceOperationStatus");
+@@clientName(TrainingResult, "FaceCollectionTrainingResult");
+@@clientName(IdentificationResult, "FaceIdentificationResult");
+@@clientName(IdentificationCandidate, "FaceIdentificationCandidate");
+@@clientName(VerificationResult, "FaceVerificationResult");
+@@clientName(FindSimilarResult, "FaceFindSimilarResult");
+@@clientName(GroupingResult, "FaceGroupingResult");
+@@clientName(OperationResult, "FaceOperationResult");
+@@clientName(LivenessDecision, "FaceLivenessDecision");
+@@clientName(ImageType, "FaceImageType");
+@@clientName(CreateLivenessSessionParameters,
+  "CreateLivenessSessionContent",
+  "csharp"
+);
+@@clientName(CreateLivenessWithVerifySessionParameters,
+  "CreateLivenessWithVerifySessionContent",
+  "csharp"
+);
+
+@@access(FaceAttributeType, Access.public);
+@@access(FaceDetectionResult, Access.public);
+@@access(FaceLandmarks, Access.public);
+@@access(LandmarkCoordinate, Access.public);
+@@access(FaceAttributes, Access.public);
+@@access(FacialHair, Access.public);
+@@access(GlassesType, Access.public);
+@@access(HeadPose, Access.public);
+@@access(HairProperties, Access.public);
+@@access(HairColor, Access.public);
+@@access(HairColorType, Access.public);
+@@access(OcclusionProperties, Access.public);
+@@access(AccessoryItem, Access.public);
+@@access(AccessoryType, Access.public);
+@@access(BlurProperties, Access.public);
+@@access(BlurLevel, Access.public);
+@@access(ExposureProperties, Access.public);
+@@access(ExposureLevel, Access.public);
+@@access(NoiseProperties, Access.public);
+@@access(NoiseLevel, Access.public);
+@@access(MaskProperties, Access.public);
+@@access(MaskType, Access.public);
+@@access(QualityForRecognition, Access.public);
+@@access(CreateLivenessWithVerifySessionResult, Access.public);
+
+@client({
+  name: "FaceClient",
+  service: Face,
+})
+interface FaceClient {
+  @access(Access.internal)
+  @convenientAPI(false, "java")
+  @convenientAPI(false, "csharp")
+  detectFromUrl is FaceDetectionOperations.detectFromUrl;
+  #suppress "@azure-tools/typespec-azure-core/byos" "It's an RPC call to detect face from an image, it doesn't store anything. There's a BYOS version of this call, but it's not this one."
+  @access(Access.internal)
+  @convenientAPI(false, "java")
+  @convenientAPI(false, "csharp")
+  detect is FaceDetectionOperations.detect;
+
+  findSimilar is FaceRecognitionOperations.findSimilar;
+  findSimilarFromFaceList is FaceRecognitionOperations.findSimilarFromFaceList;
+  findSimilarFromLargeFaceList is FaceRecognitionOperations.findSimilarFromLargeFaceList;
+  identifyFromPersonGroup is FaceRecognitionOperations.identifyFromPersonGroup;
+  identifyFromLargePersonGroup is FaceRecognitionOperations.identifyFromLargePersonGroup;
+  identifyFromPersonDirectory is FaceRecognitionOperations.identifyFromPersonDirectory;
+  identifyFromDynamicPersonGroup is FaceRecognitionOperations.identifyFromDynamicPersonGroup;
+  verifyFaceToFace is FaceRecognitionOperations.verifyFaceToFace;
+  verifyFromPersonGroup is FaceRecognitionOperations.verifyFromPersonGroup;
+  verifyFromLargePersonGroup is FaceRecognitionOperations.verifyFromLargePersonGroup;
+  verifyFromPersonDirectory is FaceRecognitionOperations.verifyFromPersonDirectory;
+  group is FaceRecognitionOperations.group;
+}
+
+@client({
+  name: "FaceAdministrationClient",
+  service: Face,
+})
+interface FaceAdministrationClient {
+  createFaceList is FaceListOperations.createFaceList;
+  deleteFaceList is FaceListOperations.deleteFaceList;
+  getFaceList is FaceListOperations.getFaceList;
+  updateFaceList is FaceListOperations.updateFaceList;
+  getFaceLists is FaceListOperations.getFaceLists;
+  addFaceListFaceFromUrl is FaceListOperations.addFaceListFaceFromUrl;
+  #suppress "@azure-tools/typespec-azure-core/byos" "It's an RPC call to detect face from an image, it doesn't store anything. There's a BYOS version of this call, but it's not this one."
+  addFaceListFace is FaceListOperations.addFaceListFace;
+  deleteFaceListFace is FaceListOperations.deleteFaceListFace;
+
+  createLargeFaceList is FaceListOperations.createLargeFaceList;
+  deleteLargeFaceList is FaceListOperations.deleteLargeFaceList;
+  getLargeFaceList is FaceListOperations.getLargeFaceList;
+  updateLargeFaceList is FaceListOperations.updateLargeFaceList;
+  getLargeFaceLists is FaceListOperations.getLargeFaceLists;
+  getLargeFaceListTrainingStatus is FaceListOperations.getLargeFaceListTrainingStatus;
+  trainLargeFaceList is FaceListOperations.trainLargeFaceList;
+  addLargeFaceListFaceFromUrl is FaceListOperations.addLargeFaceListFaceFromUrl;
+  #suppress "@azure-tools/typespec-azure-core/byos" "It's an RPC call to detect face from an image, it doesn't store anything. There's a BYOS version of this call, but it's not this one."
+  addLargeFaceListFace is FaceListOperations.addLargeFaceListFace;
+  deleteLargeFaceListFace is FaceListOperations.deleteLargeFaceListFace;
+  getLargeFaceListFace is FaceListOperations.getLargeFaceListFace;
+  updateLargeFaceListFace is FaceListOperations.updateLargeFaceListFace;
+  getLargeFaceListFaces is FaceListOperations.getLargeFaceListFaces;
+
+  createPersonGroup is PersonGroupOperations.createPersonGroup;
+  deletePersonGroup is PersonGroupOperations.deletePersonGroup;
+  getPersonGroup is PersonGroupOperations.getPersonGroup;
+  updatePersonGroup is PersonGroupOperations.updatePersonGroup;
+  getPersonGroups is PersonGroupOperations.getPersonGroups;
+  getPersonGroupTrainingStatus is PersonGroupOperations.getPersonGroupTrainingStatus;
+  trainPersonGroup is PersonGroupOperations.trainPersonGroup;
+  createPersonGroupPerson is PersonGroupOperations.createPersonGroupPerson;
+  deletePersonGroupPerson is PersonGroupOperations.deletePersonGroupPerson;
+  getPersonGroupPerson is PersonGroupOperations.getPersonGroupPerson;
+  updatePersonGroupPerson is PersonGroupOperations.updatePersonGroupPerson;
+  getPersonGroupPersons is PersonGroupOperations.getPersonGroupPersons;
+  addPersonGroupPersonFaceFromUrl is PersonGroupOperations.addPersonGroupPersonFaceFromUrl;
+  #suppress "@azure-tools/typespec-azure-core/byos" "It's an RPC call to detect face from an image, it doesn't store anything. There's a BYOS version of this call, but it's not this one."
+  addPersonGroupPersonFace is PersonGroupOperations.addPersonGroupPersonFace;
+  deletePersonGroupPersonFace is PersonGroupOperations.deletePersonGroupPersonFace;
+  getPersonGroupPersonFace is PersonGroupOperations.getPersonGroupPersonFace;
+  updatePersonGroupPersonFace is PersonGroupOperations.updatePersonGroupPersonFace;
+
+  createLargePersonGroup is PersonGroupOperations.createLargePersonGroup;
+  deleteLargePersonGroup is PersonGroupOperations.deleteLargePersonGroup;
+  getLargePersonGroup is PersonGroupOperations.getLargePersonGroup;
+  updateLargePersonGroup is PersonGroupOperations.updateLargePersonGroup;
+  getLargePersonGroups is PersonGroupOperations.getLargePersonGroups;
+  getLargePersonGroupTrainingStatus is PersonGroupOperations.getLargePersonGroupTrainingStatus;
+  trainLargePersonGroup is PersonGroupOperations.trainLargePersonGroup;
+  createLargePersonGroupPerson is PersonGroupOperations.createLargePersonGroupPerson;
+  deleteLargePersonGroupPerson is PersonGroupOperations.deleteLargePersonGroupPerson;
+  getLargePersonGroupPerson is PersonGroupOperations.getLargePersonGroupPerson;
+  updateLargePersonGroupPerson is PersonGroupOperations.updateLargePersonGroupPerson;
+  getLargePersonGroupPersons is PersonGroupOperations.getLargePersonGroupPersons;
+  addLargePersonGroupPersonFaceFromUrl is PersonGroupOperations.addLargePersonGroupPersonFaceFromUrl;
+  #suppress "@azure-tools/typespec-azure-core/byos" "It's an RPC call to detect face from an image, it doesn't store anything. There's a BYOS version of this call, but it's not this one."
+  addLargePersonGroupPersonFace is PersonGroupOperations.addLargePersonGroupPersonFace;
+  deleteLargePersonGroupPersonFace is PersonGroupOperations.deleteLargePersonGroupPersonFace;
+  getLargePersonGroupPersonFace is PersonGroupOperations.getLargePersonGroupPersonFace;
+  updateLargePersonGroupPersonFace is PersonGroupOperations.updateLargePersonGroupPersonFace;
+
+  createPerson is PersonDirectoryOperations.createPerson;
+  deletePerson is PersonDirectoryOperations.deletePerson;
+  getPerson is PersonDirectoryOperations.getPerson;
+  updatePerson is PersonDirectoryOperations.updatePerson;
+  getPersons is PersonDirectoryOperations.getPersons;
+  getDynamicPersonGroupReferences is PersonDirectoryOperations.getDynamicPersonGroupReferences;
+  addPersonFaceFromUrl is PersonDirectoryOperations.addPersonFaceFromUrl;
+  #suppress "@azure-tools/typespec-azure-core/byos" "It's an RPC call to detect face from an image, it doesn't store anything. There's a BYOS version of this call, but it's not this one."
+  addPersonFace is PersonDirectoryOperations.addPersonFace;
+  deletePersonFace is PersonDirectoryOperations.deletePersonFace;
+  getPersonFace is PersonDirectoryOperations.getPersonFace;
+  updatePersonFace is PersonDirectoryOperations.updatePersonFace;
+  getPersonFaces is PersonDirectoryOperations.getPersonFaces;
+
+  createDynamicPersonGroupWithPerson is PersonDirectoryOperations.createDynamicPersonGroupWithPerson;
+  createDynamicPersonGroup is PersonDirectoryOperations.createDynamicPersonGroup;
+  deleteDynamicPersonGroup is PersonDirectoryOperations.deleteDynamicPersonGroup;
+  getDynamicPersonGroup is PersonDirectoryOperations.getDynamicPersonGroup;
+  updateDynamicPersonGroupWithPersonChanges is PersonDirectoryOperations.updateDynamicPersonGroupWithPersonChanges;
+  updateDynamicPersonGroup is PersonDirectoryOperations.updateDynamicPersonGroup;
+  getDynamicPersonGroups is PersonDirectoryOperations.getDynamicPersonGroups;
+  getDynamicPersonGroupPersons is PersonDirectoryOperations.getDynamicPersonGroupPersons;
+}
+
+@client({
+  name: "FaceSessionClient",
+  service: Face,
+})
+interface FaceSessionClient {
+  createLivenessSession is LivenessSessionOperations.createLivenessSession;
+  deleteLivenessSession is LivenessSessionOperations.deleteLivenessSession;
+  getLivenessSessionResult is LivenessSessionOperations.getLivenessSessionResult;
+  getLivenessSessions is LivenessSessionOperations.getLivenessSessions;
+  getLivenessSessionAuditEntries is LivenessSessionOperations.getLivenessSessionAuditEntries;
+
+  @access(Access.internal)
+  createLivenessWithVerifySession is LivenessSessionOperations.createLivenessWithVerifySession;
+  #suppress "@azure-tools/typespec-azure-core/byos" "It's an RPC call to detect face from an image, it doesn't store anything. There's a BYOS version of this call, but it's not this one."
+  @access(Access.internal)
+  createLivenessWithVerifySessionWithVerifyImage is LivenessSessionOperations.createLivenessWithVerifySessionWithVerifyImage;
+  deleteLivenessWithVerifySession is LivenessSessionOperations.deleteLivenessWithVerifySession;
+  getLivenessWithVerifySessionResult is LivenessSessionOperations.getLivenessWithVerifySessionResult;
+  getLivenessWithVerifySessions is LivenessSessionOperations.getLivenessWithVerifySessions;
+  getLivenessWithVerifySessionAuditEntries is LivenessSessionOperations.getLivenessWithVerifySessionAuditEntries;
+}