Regenerated library to pick up latest schema changes

Author: petemoore

codegenerator/model/model-data.txt

@@ -4985,20 +4985,92 @@ with TaskCluster, this is probably *not* the service you are looking for.
 Instead, use the federated login support in the tools site.'
 Base URL    = 'https://login.taskcluster.net/v1'
 Entry 0     =
+    Entry Type        = 'function'
+    Entry Method      = 'post'
+    Entry Route       = '/persona'
+    Entry Args        = '[]'
+    Entry Query        = '[]'
+    Entry Name        = 'credentialsFromPersonaAssertion'
+    Entry Stability   = 'experimental'
+    Entry Scopes      = '[]'
+    Entry Input       = 'http://schemas.taskcluster.net/login/v1/persona-request.json'
+    Entry Output      = 'http://schemas.taskcluster.net/login/v1/credentials-response.json'
+    Entry Title       = 'Get TaskCluster credentials given a Persona assertion'
+    Entry Description = 'Given an [assertion](https://developer.mozilla.org/en-US/Persona/Quick_setup), return an appropriate set of temporary credentials.
+
+The supplied audience must be on a whitelist of TaskCluster-related
+sites configured in the login service.  This is not a general-purpose
+assertion-verification service!'
+Entry 1     =
     Entry Type        = 'function'
     Entry Method      = 'get'
     Entry Route       = '/ping'
     Entry Args        = '[]'
     Entry Query        = '[]'
     Entry Name        = 'ping'
-    Entry Stability   = 'experimental'
+    Entry Stability   = 'stable'
     Entry Scopes      = '[]'
     Entry Input       = ''
     Entry Output      = ''
     Entry Title       = 'Ping Server'
-    Entry Description = 'Documented later...
+    Entry Description = 'Respond without doing anything.
+This endpoint is used to check that the service is up.'
 
-**Warning** this api end-point is **not stable**.'
+
+http://schemas.taskcluster.net/login/v1/credentials-response.json#
+==================================================================
+Additional Properties  = 'false'
+Description            = 'A response containing temporary credentials.
+'
+ID                     = 'http://schemas.taskcluster.net/login/v1/credentials-response.json#'
+Properties
+  Property 'accessToken' =
+    Pattern                = '^[a-zA-Z0-9_-]{22,66}$'
+    Type                   = 'string'
+    TypeName               = 'AccessToken'
+    SourceURL              = 'http://schemas.taskcluster.net/login/v1/credentials-response.json#/properties/accessToken'
+  Property 'certificate' =
+    Type                   = 'string'
+    TypeName               = 'Certificate'
+    SourceURL              = 'http://schemas.taskcluster.net/login/v1/credentials-response.json#/properties/certificate'
+  Property 'clientId' =
+    Pattern                = '^[A-Za-z0-9@/:._-]+$'
+    Type                   = 'string'
+    TypeName               = 'ClientId'
+    SourceURL              = 'http://schemas.taskcluster.net/login/v1/credentials-response.json#/properties/clientId'
+Required               = '[clientId accessToken certificate]'
+Schema                 = 'http://json-schema.org/draft-04/schema#'
+Title                  = 'Credentials Response'
+Type                   = 'object'
+TypeName               = 'CredentialsResponse'
+SourceURL              = 'http://schemas.taskcluster.net/login/v1/credentials-response.json#'
+
+
+http://schemas.taskcluster.net/login/v1/persona-request.json#
+=============================================================
+Additional Properties  = 'false'
+ID                     = 'http://schemas.taskcluster.net/login/v1/persona-request.json#'
+Properties
+  Property 'assertion' =
+    Description            = 'The Persona assertion from `navigator.id.get`
+    '
+    Type                   = 'string'
+    TypeName               = 'Assertion'
+    SourceURL              = 'http://schemas.taskcluster.net/login/v1/persona-request.json#/properties/assertion'
+  Property 'audience' =
+    Description            = 'The audience against which to verify the assertion, in the format
+    `https://site.com:443`.  This must be from a whitelist of sites
+    configured in the login service.
+    '
+    Type                   = 'string'
+    TypeName               = 'Audience'
+    SourceURL              = 'http://schemas.taskcluster.net/login/v1/persona-request.json#/properties/audience'
+Required               = '[assertion audience]'
+Schema                 = 'http://json-schema.org/draft-04/schema#'
+Title                  = 'Persona Assertion Request'
+Type                   = 'object'
+TypeName               = 'PersonaAssertionRequest'
+SourceURL              = 'http://schemas.taskcluster.net/login/v1/persona-request.json#'
 
 
 http://references.taskcluster.net/notify/v1/api.json

src/main/java/org/mozilla/taskcluster/client/login/CredentialsResponse.java

@@ -0,0 +1,30 @@
+package org.mozilla.taskcluster.client.login;
+
+/**
+ * A response containing temporary credentials.
+ *
+ * See http://schemas.taskcluster.net/login/v1/credentials-response.json#
+ */
+public class CredentialsResponse {
+
+    /**
+     *
+     * Syntax:     ^[a-zA-Z0-9_-]{22,66}$
+     *
+     * See http://schemas.taskcluster.net/login/v1/credentials-response.json#/properties/accessToken
+     */
+    public String accessToken;
+
+    /**
+     * See http://schemas.taskcluster.net/login/v1/credentials-response.json#/properties/certificate
+     */
+    public String certificate;
+
+    /**
+     *
+     * Syntax:     ^[A-Za-z0-9@/:._-]+$
+     *
+     * See http://schemas.taskcluster.net/login/v1/credentials-response.json#/properties/clientId
+     */
+    public String clientId;
+}

src/main/java/org/mozilla/taskcluster/client/login/Login.java

@@ -48,9 +48,21 @@ public Login() {
     }
 
     /**
-     * Documented later...
+     * Given an [assertion](https://developer.mozilla.org/en-US/Persona/Quick_setup), return an appropriate set of temporary credentials.
      * 
-     * **Warning** this api end-point is **not stable**.
+     * The supplied audience must be on a whitelist of TaskCluster-related
+     * sites configured in the login service.  This is not a general-purpose
+     * assertion-verification service!
+     *
+     * @see "[Get TaskCluster credentials given a Persona assertion API Documentation](https://docs.taskcluster.net/reference/core/login/api-docs#credentialsFromPersonaAssertion)"
+     */
+    public CallSummary<PersonaAssertionRequest, CredentialsResponse> credentialsFromPersonaAssertion(PersonaAssertionRequest payload) throws APICallFailure {
+        return apiCall(payload, "POST", "/persona", CredentialsResponse.class);
+    }
+
+    /**
+     * Respond without doing anything.
+     * This endpoint is used to check that the service is up.
      *
      * @see "[Ping Server API Documentation](https://docs.taskcluster.net/reference/core/login/api-docs#ping)"
      */

src/main/java/org/mozilla/taskcluster/client/login/PersonaAssertionRequest.java

@@ -0,0 +1,23 @@
+package org.mozilla.taskcluster.client.login;
+
+/**
+ * See http://schemas.taskcluster.net/login/v1/persona-request.json#
+ */
+public class PersonaAssertionRequest {
+
+    /**
+     * The Persona assertion from `navigator.id.get`
+     *
+     * See http://schemas.taskcluster.net/login/v1/persona-request.json#/properties/assertion
+     */
+    public String assertion;
+
+    /**
+     * The audience against which to verify the assertion, in the format
+     * `https://site.com:443`.  This must be from a whitelist of sites
+     * configured in the login service.
+     *
+     * See http://schemas.taskcluster.net/login/v1/persona-request.json#/properties/audience
+     */
+    public String audience;
+}