@spaciv/sdk 0.1.9 → 0.1.10

package/dist/esm/models/DatacollectionChangelogBody.js

@@ -12,6 +12,7 @@
  * Do not edit the class manually.
  */
 import { DatacollectionAuthenticationFromJSON, DatacollectionAuthenticationToJSON, } from './DatacollectionAuthentication';
+import { DatacollectionContributorFromJSON, DatacollectionContributorToJSON, } from './DatacollectionContributor';
 import { StepFromJSON, StepToJSON, } from './Step';
 /**
  * Check if a given object implements the DatacollectionChangelogBody interface.
@@ -23,6 +24,10 @@ export function instanceOfDatacollectionChangelogBody(value) {
         return false;
     if (!('completeMessage' in value) || value['completeMessage'] === undefined)
         return false;
+    if (!('contributors' in value) || value['contributors'] === undefined)
+        return false;
+    if (!('contributorsUploaded' in value) || value['contributorsUploaded'] === undefined)
+        return false;
     if (!('description' in value) || value['description'] === undefined)
         return false;
     if (!('end' in value) || value['end'] === undefined)
@@ -56,6 +61,8 @@ export function DatacollectionChangelogBodyFromJSONTyped(json, ignoreDiscriminat
         'anonymisationProperty': json['anonymisationProperty'],
         'authenticationMode': DatacollectionAuthenticationFromJSON(json['authenticationMode']),
         'completeMessage': json['completeMessage'],
+        'contributors': (json['contributors'].map(DatacollectionContributorFromJSON)),
+        'contributorsUploaded': json['contributorsUploaded'],
         'description': json['description'],
         'end': json['end'],
         'inviteMessage': json['inviteMessage'],
@@ -79,6 +86,8 @@ export function DatacollectionChangelogBodyToJSONTyped(value, ignoreDiscriminato
         'anonymisationProperty': value['anonymisationProperty'],
         'authenticationMode': DatacollectionAuthenticationToJSON(value['authenticationMode']),
         'completeMessage': value['completeMessage'],
+        'contributors': (value['contributors'].map(DatacollectionContributorToJSON)),
+        'contributorsUploaded': value['contributorsUploaded'],
         'description': value['description'],
         'end': value['end'],
         'inviteMessage': value['inviteMessage'],

package/dist/esm/models/DatacollectionContributor.d.ts

@@ -0,0 +1,38 @@
+/**
+ * spaciv API
+ * The spaciv API powers workplace planning: modelling how many people an organisation has, how they work, and how much space that requires.  ## Getting started  1. Exchange credentials for an access token using one of the operations under    **Authentication**. 2. Send that token on every subsequent request as `Authorization: Bearer <token>`. 3. Access tokens are short lived. Call `POST /v1/auth/refresh-token` to obtain a new one    before the old one expires.  ## Conventions  Every operation is versioned under `/v1`. Collections are plural (`GET /v1/dashboards` lists, `POST /v1/dashboards` creates) and individual records live beneath them (`/v1/dashboards/{id}`). Singular paths such as `/v1/account`, `/v1/project` and `/v1/user` refer to the record the access token was issued for.  Request and response bodies are JSON. Timestamps are RFC 3339. Identifiers are opaque strings unless documented otherwise, and collection operations return the records visible to the account the token was issued for.  Failures return an [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) problem document with a `detail` field describing what went wrong.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@spaciv.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface DatacollectionContributor
+ */
+export interface DatacollectionContributor {
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof DatacollectionContributor
+     */
+    nodes: Array<string>;
+    /**
+     *
+     * @type {string}
+     * @memberof DatacollectionContributor
+     */
+    user: string;
+}
+/**
+ * Check if a given object implements the DatacollectionContributor interface.
+ */
+export declare function instanceOfDatacollectionContributor(value: object): value is DatacollectionContributor;
+export declare function DatacollectionContributorFromJSON(json: any): DatacollectionContributor;
+export declare function DatacollectionContributorFromJSONTyped(json: any, ignoreDiscriminator: boolean): DatacollectionContributor;
+export declare function DatacollectionContributorToJSON(json: any): DatacollectionContributor;
+export declare function DatacollectionContributorToJSONTyped(value?: DatacollectionContributor | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/DatacollectionContributor.js

@@ -0,0 +1,47 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * spaciv API
+ * The spaciv API powers workplace planning: modelling how many people an organisation has, how they work, and how much space that requires.  ## Getting started  1. Exchange credentials for an access token using one of the operations under    **Authentication**. 2. Send that token on every subsequent request as `Authorization: Bearer <token>`. 3. Access tokens are short lived. Call `POST /v1/auth/refresh-token` to obtain a new one    before the old one expires.  ## Conventions  Every operation is versioned under `/v1`. Collections are plural (`GET /v1/dashboards` lists, `POST /v1/dashboards` creates) and individual records live beneath them (`/v1/dashboards/{id}`). Singular paths such as `/v1/account`, `/v1/project` and `/v1/user` refer to the record the access token was issued for.  Request and response bodies are JSON. Timestamps are RFC 3339. Identifiers are opaque strings unless documented otherwise, and collection operations return the records visible to the account the token was issued for.  Failures return an [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) problem document with a `detail` field describing what went wrong.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@spaciv.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Check if a given object implements the DatacollectionContributor interface.
+ */
+export function instanceOfDatacollectionContributor(value) {
+    if (!('nodes' in value) || value['nodes'] === undefined)
+        return false;
+    if (!('user' in value) || value['user'] === undefined)
+        return false;
+    return true;
+}
+export function DatacollectionContributorFromJSON(json) {
+    return DatacollectionContributorFromJSONTyped(json, false);
+}
+export function DatacollectionContributorFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'nodes': json['nodes'],
+        'user': json['user'],
+    };
+}
+export function DatacollectionContributorToJSON(json) {
+    return DatacollectionContributorToJSONTyped(json, false);
+}
+export function DatacollectionContributorToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'nodes': value['nodes'],
+        'user': value['user'],
+    };
+}

package/dist/esm/models/GetDatacollectionRes.d.ts

@@ -34,6 +34,12 @@ export interface GetDatacollectionRes {
      * @memberof GetDatacollectionRes
      */
     id: string;
+    /**
+     *
+     * @type {number}
+     * @memberof GetDatacollectionRes
+     */
+    legacyContributors?: number;
     /**
      *
      * @type {number}

package/dist/esm/models/GetDatacollectionRes.js

@@ -39,6 +39,7 @@ export function GetDatacollectionResFromJSONTyped(json, ignoreDiscriminator) {
         'completed': json['completed'],
         'datacollection': DatacollectionChangelogBodyFromJSON(json['datacollection']),
         'id': json['id'],
+        'legacyContributors': json['legacyContributors'] == null ? undefined : json['legacyContributors'],
         'started': json['started'],
         'total': json['total'],
     };
@@ -54,6 +55,7 @@ export function GetDatacollectionResToJSONTyped(value, ignoreDiscriminator = fal
         'completed': value['completed'],
         'datacollection': DatacollectionChangelogBodyToJSON(value['datacollection']),
         'id': value['id'],
+        'legacyContributors': value['legacyContributors'],
         'started': value['started'],
         'total': value['total'],
     };

package/dist/esm/models/index.d.ts

@@ -146,6 +146,7 @@ export * from './DatacollectionAuthenticationOneOf2';
 export * from './DatacollectionAuthenticationOneOf3';
 export * from './DatacollectionBody';
 export * from './DatacollectionChangelogBody';
+export * from './DatacollectionContributor';
 export * from './DatasetAddResponseBody';
 export * from './DatasetChangelogBody';
 export * from './DatasetChangelogData';

package/dist/esm/models/index.js

@@ -148,6 +148,7 @@ export * from './DatacollectionAuthenticationOneOf2';
 export * from './DatacollectionAuthenticationOneOf3';
 export * from './DatacollectionBody';
 export * from './DatacollectionChangelogBody';
+export * from './DatacollectionContributor';
 export * from './DatasetAddResponseBody';
 export * from './DatasetChangelogBody';
 export * from './DatasetChangelogData';

package/dist/models/DatacollectionBody.d.ts

@@ -10,6 +10,7 @@
  * Do not edit the class manually.
  */
 import type { DatacollectionAuthentication } from './DatacollectionAuthentication';
+import type { DatacollectionContributor } from './DatacollectionContributor';
 import type { Step } from './Step';
 /**
  *
@@ -29,6 +30,12 @@ export interface DatacollectionBody {
      * @memberof DatacollectionBody
      */
     authenticationMode?: DatacollectionAuthentication;
+    /**
+     *
+     * @type {boolean}
+     * @memberof DatacollectionBody
+     */
+    clearContributors?: boolean;
     /**
      *
      * @type {boolean}
@@ -41,6 +48,12 @@ export interface DatacollectionBody {
      * @memberof DatacollectionBody
      */
     completeMessage?: string;
+    /**
+     *
+     * @type {Array<DatacollectionContributor>}
+     * @memberof DatacollectionBody
+     */
+    contributors?: Array<DatacollectionContributor>;
     /**
      *
      * @type {boolean}

package/dist/models/DatacollectionBody.js

@@ -19,6 +19,7 @@ exports.DatacollectionBodyFromJSONTyped = DatacollectionBodyFromJSONTyped;
 exports.DatacollectionBodyToJSON = DatacollectionBodyToJSON;
 exports.DatacollectionBodyToJSONTyped = DatacollectionBodyToJSONTyped;
 const DatacollectionAuthentication_1 = require("./DatacollectionAuthentication");
+const DatacollectionContributor_1 = require("./DatacollectionContributor");
 const Step_1 = require("./Step");
 /**
  * Check if a given object implements the DatacollectionBody interface.
@@ -44,8 +45,10 @@ function DatacollectionBodyFromJSONTyped(json, ignoreDiscriminator) {
     return {
         'anonymisationProperty': json['anonymisationProperty'] == null ? undefined : json['anonymisationProperty'],
         'authenticationMode': json['authenticationMode'] == null ? undefined : (0, DatacollectionAuthentication_1.DatacollectionAuthenticationFromJSON)(json['authenticationMode']),
+        'clearContributors': json['clearContributors'] == null ? undefined : json['clearContributors'],
         'clearSteps': json['clearSteps'],
         'completeMessage': json['completeMessage'] == null ? undefined : json['completeMessage'],
+        'contributors': json['contributors'] == null ? undefined : (json['contributors'].map(DatacollectionContributor_1.DatacollectionContributorFromJSON)),
         'delete': json['delete'],
         'description': json['description'] == null ? undefined : json['description'],
         'end': json['end'] == null ? undefined : json['end'],
@@ -70,8 +73,10 @@ function DatacollectionBodyToJSONTyped(value, ignoreDiscriminator = false) {
     return {
         'anonymisationProperty': value['anonymisationProperty'],
         'authenticationMode': (0, DatacollectionAuthentication_1.DatacollectionAuthenticationToJSON)(value['authenticationMode']),
+        'clearContributors': value['clearContributors'],
         'clearSteps': value['clearSteps'],
         'completeMessage': value['completeMessage'],
+        'contributors': value['contributors'] == null ? undefined : (value['contributors'].map(DatacollectionContributor_1.DatacollectionContributorToJSON)),
         'delete': value['delete'],
         'description': value['description'],
         'end': value['end'],

package/dist/models/DatacollectionChangelogBody.d.ts

@@ -10,6 +10,7 @@
  * Do not edit the class manually.
  */
 import type { DatacollectionAuthentication } from './DatacollectionAuthentication';
+import type { DatacollectionContributor } from './DatacollectionContributor';
 import type { Step } from './Step';
 /**
  *
@@ -35,6 +36,18 @@ export interface DatacollectionChangelogBody {
      * @memberof DatacollectionChangelogBody
      */
     completeMessage: string;
+    /**
+     *
+     * @type {Array<DatacollectionContributor>}
+     * @memberof DatacollectionChangelogBody
+     */
+    contributors: Array<DatacollectionContributor>;
+    /**
+     *
+     * @type {boolean}
+     * @memberof DatacollectionChangelogBody
+     */
+    contributorsUploaded: boolean;
     /**
      *
      * @type {string}

package/dist/models/DatacollectionChangelogBody.js

@@ -19,6 +19,7 @@ exports.DatacollectionChangelogBodyFromJSONTyped = DatacollectionChangelogBodyFr
 exports.DatacollectionChangelogBodyToJSON = DatacollectionChangelogBodyToJSON;
 exports.DatacollectionChangelogBodyToJSONTyped = DatacollectionChangelogBodyToJSONTyped;
 const DatacollectionAuthentication_1 = require("./DatacollectionAuthentication");
+const DatacollectionContributor_1 = require("./DatacollectionContributor");
 const Step_1 = require("./Step");
 /**
  * Check if a given object implements the DatacollectionChangelogBody interface.
@@ -30,6 +31,10 @@ function instanceOfDatacollectionChangelogBody(value) {
         return false;
     if (!('completeMessage' in value) || value['completeMessage'] === undefined)
         return false;
+    if (!('contributors' in value) || value['contributors'] === undefined)
+        return false;
+    if (!('contributorsUploaded' in value) || value['contributorsUploaded'] === undefined)
+        return false;
     if (!('description' in value) || value['description'] === undefined)
         return false;
     if (!('end' in value) || value['end'] === undefined)
@@ -63,6 +68,8 @@ function DatacollectionChangelogBodyFromJSONTyped(json, ignoreDiscriminator) {
         'anonymisationProperty': json['anonymisationProperty'],
         'authenticationMode': (0, DatacollectionAuthentication_1.DatacollectionAuthenticationFromJSON)(json['authenticationMode']),
         'completeMessage': json['completeMessage'],
+        'contributors': (json['contributors'].map(DatacollectionContributor_1.DatacollectionContributorFromJSON)),
+        'contributorsUploaded': json['contributorsUploaded'],
         'description': json['description'],
         'end': json['end'],
         'inviteMessage': json['inviteMessage'],
@@ -86,6 +93,8 @@ function DatacollectionChangelogBodyToJSONTyped(value, ignoreDiscriminator = fal
         'anonymisationProperty': value['anonymisationProperty'],
         'authenticationMode': (0, DatacollectionAuthentication_1.DatacollectionAuthenticationToJSON)(value['authenticationMode']),
         'completeMessage': value['completeMessage'],
+        'contributors': (value['contributors'].map(DatacollectionContributor_1.DatacollectionContributorToJSON)),
+        'contributorsUploaded': value['contributorsUploaded'],
         'description': value['description'],
         'end': value['end'],
         'inviteMessage': value['inviteMessage'],

package/dist/models/DatacollectionContributor.d.ts

@@ -0,0 +1,38 @@
+/**
+ * spaciv API
+ * The spaciv API powers workplace planning: modelling how many people an organisation has, how they work, and how much space that requires.  ## Getting started  1. Exchange credentials for an access token using one of the operations under    **Authentication**. 2. Send that token on every subsequent request as `Authorization: Bearer <token>`. 3. Access tokens are short lived. Call `POST /v1/auth/refresh-token` to obtain a new one    before the old one expires.  ## Conventions  Every operation is versioned under `/v1`. Collections are plural (`GET /v1/dashboards` lists, `POST /v1/dashboards` creates) and individual records live beneath them (`/v1/dashboards/{id}`). Singular paths such as `/v1/account`, `/v1/project` and `/v1/user` refer to the record the access token was issued for.  Request and response bodies are JSON. Timestamps are RFC 3339. Identifiers are opaque strings unless documented otherwise, and collection operations return the records visible to the account the token was issued for.  Failures return an [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) problem document with a `detail` field describing what went wrong.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@spaciv.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface DatacollectionContributor
+ */
+export interface DatacollectionContributor {
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof DatacollectionContributor
+     */
+    nodes: Array<string>;
+    /**
+     *
+     * @type {string}
+     * @memberof DatacollectionContributor
+     */
+    user: string;
+}
+/**
+ * Check if a given object implements the DatacollectionContributor interface.
+ */
+export declare function instanceOfDatacollectionContributor(value: object): value is DatacollectionContributor;
+export declare function DatacollectionContributorFromJSON(json: any): DatacollectionContributor;
+export declare function DatacollectionContributorFromJSONTyped(json: any, ignoreDiscriminator: boolean): DatacollectionContributor;
+export declare function DatacollectionContributorToJSON(json: any): DatacollectionContributor;
+export declare function DatacollectionContributorToJSONTyped(value?: DatacollectionContributor | null, ignoreDiscriminator?: boolean): any;

package/dist/models/DatacollectionContributor.js

@@ -0,0 +1,54 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * spaciv API
+ * The spaciv API powers workplace planning: modelling how many people an organisation has, how they work, and how much space that requires.  ## Getting started  1. Exchange credentials for an access token using one of the operations under    **Authentication**. 2. Send that token on every subsequent request as `Authorization: Bearer <token>`. 3. Access tokens are short lived. Call `POST /v1/auth/refresh-token` to obtain a new one    before the old one expires.  ## Conventions  Every operation is versioned under `/v1`. Collections are plural (`GET /v1/dashboards` lists, `POST /v1/dashboards` creates) and individual records live beneath them (`/v1/dashboards/{id}`). Singular paths such as `/v1/account`, `/v1/project` and `/v1/user` refer to the record the access token was issued for.  Request and response bodies are JSON. Timestamps are RFC 3339. Identifiers are opaque strings unless documented otherwise, and collection operations return the records visible to the account the token was issued for.  Failures return an [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) problem document with a `detail` field describing what went wrong.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@spaciv.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instanceOfDatacollectionContributor = instanceOfDatacollectionContributor;
+exports.DatacollectionContributorFromJSON = DatacollectionContributorFromJSON;
+exports.DatacollectionContributorFromJSONTyped = DatacollectionContributorFromJSONTyped;
+exports.DatacollectionContributorToJSON = DatacollectionContributorToJSON;
+exports.DatacollectionContributorToJSONTyped = DatacollectionContributorToJSONTyped;
+/**
+ * Check if a given object implements the DatacollectionContributor interface.
+ */
+function instanceOfDatacollectionContributor(value) {
+    if (!('nodes' in value) || value['nodes'] === undefined)
+        return false;
+    if (!('user' in value) || value['user'] === undefined)
+        return false;
+    return true;
+}
+function DatacollectionContributorFromJSON(json) {
+    return DatacollectionContributorFromJSONTyped(json, false);
+}
+function DatacollectionContributorFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'nodes': json['nodes'],
+        'user': json['user'],
+    };
+}
+function DatacollectionContributorToJSON(json) {
+    return DatacollectionContributorToJSONTyped(json, false);
+}
+function DatacollectionContributorToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'nodes': value['nodes'],
+        'user': value['user'],
+    };
+}

package/dist/models/GetDatacollectionRes.d.ts

@@ -34,6 +34,12 @@ export interface GetDatacollectionRes {
      * @memberof GetDatacollectionRes
      */
     id: string;
+    /**
+     *
+     * @type {number}
+     * @memberof GetDatacollectionRes
+     */
+    legacyContributors?: number;
     /**
      *
      * @type {number}

package/dist/models/GetDatacollectionRes.js

@@ -46,6 +46,7 @@ function GetDatacollectionResFromJSONTyped(json, ignoreDiscriminator) {
         'completed': json['completed'],
         'datacollection': (0, DatacollectionChangelogBody_1.DatacollectionChangelogBodyFromJSON)(json['datacollection']),
         'id': json['id'],
+        'legacyContributors': json['legacyContributors'] == null ? undefined : json['legacyContributors'],
         'started': json['started'],
         'total': json['total'],
     };
@@ -61,6 +62,7 @@ function GetDatacollectionResToJSONTyped(value, ignoreDiscriminator = false) {
         'completed': value['completed'],
         'datacollection': (0, DatacollectionChangelogBody_1.DatacollectionChangelogBodyToJSON)(value['datacollection']),
         'id': value['id'],
+        'legacyContributors': value['legacyContributors'],
         'started': value['started'],
         'total': value['total'],
     };

package/dist/models/index.d.ts

@@ -146,6 +146,7 @@ export * from './DatacollectionAuthenticationOneOf2';
 export * from './DatacollectionAuthenticationOneOf3';
 export * from './DatacollectionBody';
 export * from './DatacollectionChangelogBody';
+export * from './DatacollectionContributor';
 export * from './DatasetAddResponseBody';
 export * from './DatasetChangelogBody';
 export * from './DatasetChangelogData';

package/dist/models/index.js

@@ -164,6 +164,7 @@ __exportStar(require("./DatacollectionAuthenticationOneOf2"), exports);
 __exportStar(require("./DatacollectionAuthenticationOneOf3"), exports);
 __exportStar(require("./DatacollectionBody"), exports);
 __exportStar(require("./DatacollectionChangelogBody"), exports);
+__exportStar(require("./DatacollectionContributor"), exports);
 __exportStar(require("./DatasetAddResponseBody"), exports);
 __exportStar(require("./DatasetChangelogBody"), exports);
 __exportStar(require("./DatasetChangelogData"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spaciv/sdk",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "OpenAPI client for @spaciv/sdk",
   "author": "OpenAPI-Generator",
   "repository": {

package/src/apis/ContributionsApi.ts

@@ -51,7 +51,7 @@ export interface ContributionsApiGetDataCollectionsContributionRequest {
  */
 export interface ContributionsApiInterface {
     /**
-     * Saves the contributor\'s answers and state for a survey contribution. The body carries the current node, answer data, and completion status; for identified surveys, the server records the contributor\'s anonymisation membership when the contribution is completed and returns `404` if the contribution ID is unknown. Requires the *Edit contribution* permission.
+     * Saves the contributor\'s answers and state for a survey contribution. The body carries the current node, answer data, and completion status; for identified surveys, the server records the contributor\'s anonymisation nodes when the contribution is completed, from the survey\'s contributor list or, if none was ever uploaded, from the object group named by its authentication mode, and returns `404` if the contribution ID is unknown. Requires the *Edit contribution* permission.
      * @summary Save a contribution
      * @param {string} id 
      * @param {string} [datacollectionId] The survey the contribution belongs to. Required when submitting on behalf of an anonymous or public contributor whose contribution ID differs from the survey ID.
@@ -63,7 +63,7 @@ export interface ContributionsApiInterface {
     createDataCollectionsContributionRaw(requestParameters: ContributionsApiCreateDataCollectionsContributionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>>;
 
     /**
-     * Saves the contributor\'s answers and state for a survey contribution. The body carries the current node, answer data, and completion status; for identified surveys, the server records the contributor\'s anonymisation membership when the contribution is completed and returns `404` if the contribution ID is unknown. Requires the *Edit contribution* permission.
+     * Saves the contributor\'s answers and state for a survey contribution. The body carries the current node, answer data, and completion status; for identified surveys, the server records the contributor\'s anonymisation nodes when the contribution is completed, from the survey\'s contributor list or, if none was ever uploaded, from the object group named by its authentication mode, and returns `404` if the contribution ID is unknown. Requires the *Edit contribution* permission.
      * Save a contribution
      */
     createDataCollectionsContribution(requestParameters: ContributionsApiCreateDataCollectionsContributionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object>;
@@ -109,7 +109,7 @@ export interface ContributionsApiInterface {
 export class ContributionsApi extends runtime.BaseAPI implements ContributionsApiInterface {
 
     /**
-     * Saves the contributor\'s answers and state for a survey contribution. The body carries the current node, answer data, and completion status; for identified surveys, the server records the contributor\'s anonymisation membership when the contribution is completed and returns `404` if the contribution ID is unknown. Requires the *Edit contribution* permission.
+     * Saves the contributor\'s answers and state for a survey contribution. The body carries the current node, answer data, and completion status; for identified surveys, the server records the contributor\'s anonymisation nodes when the contribution is completed, from the survey\'s contributor list or, if none was ever uploaded, from the object group named by its authentication mode, and returns `404` if the contribution ID is unknown. Requires the *Edit contribution* permission.
      * Save a contribution
      */
     async createDataCollectionsContributionRaw(requestParameters: ContributionsApiCreateDataCollectionsContributionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>> {
@@ -154,7 +154,7 @@ export class ContributionsApi extends runtime.BaseAPI implements ContributionsAp
     }
 
     /**
-     * Saves the contributor\'s answers and state for a survey contribution. The body carries the current node, answer data, and completion status; for identified surveys, the server records the contributor\'s anonymisation membership when the contribution is completed and returns `404` if the contribution ID is unknown. Requires the *Edit contribution* permission.
+     * Saves the contributor\'s answers and state for a survey contribution. The body carries the current node, answer data, and completion status; for identified surveys, the server records the contributor\'s anonymisation nodes when the contribution is completed, from the survey\'s contributor list or, if none was ever uploaded, from the object group named by its authentication mode, and returns `404` if the contribution ID is unknown. Requires the *Edit contribution* permission.
      * Save a contribution
      */
     async createDataCollectionsContribution(requestParameters: ContributionsApiCreateDataCollectionsContributionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object> {

package/src/apis/DataCollectionApi.ts

@@ -101,7 +101,7 @@ export interface DataCollectionApiInterface {
     delete(requestParameters: DataCollectionApiDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object>;
 
     /**
-     * Returns the survey and a summary of contribution progress: how many contributors have started, completed, and the total invited. Requires the *View crowd modelling* permission.
+     * Returns the survey and a summary of contribution progress: how many contributors have started, completed, and the total invited. Requires the *View crowd modelling*, *View data collection preview* or *View public data collection* permission; drafts need one of the first two. Callers without *View crowd modelling* receive the survey without its `contributors` list or progress counts. For an email or preferred-channel survey whose contributors were never uploaded, `legacyContributors` counts the contributors it takes from the object group named by its authentication mode.
      * @summary Get a data collection survey
      * @param {string} id 
      * @param {*} [options] Override http request option.
@@ -111,7 +111,7 @@ export interface DataCollectionApiInterface {
     getRaw(requestParameters: DataCollectionApiGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetDatacollectionRes>>;
 
     /**
-     * Returns the survey and a summary of contribution progress: how many contributors have started, completed, and the total invited. Requires the *View crowd modelling* permission.
+     * Returns the survey and a summary of contribution progress: how many contributors have started, completed, and the total invited. Requires the *View crowd modelling*, *View data collection preview* or *View public data collection* permission; drafts need one of the first two. Callers without *View crowd modelling* receive the survey without its `contributors` list or progress counts. For an email or preferred-channel survey whose contributors were never uploaded, `legacyContributors` counts the contributors it takes from the object group named by its authentication mode.
      * Get a data collection survey
      */
     get(requestParameters: DataCollectionApiGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetDatacollectionRes>;
@@ -164,7 +164,7 @@ export interface DataCollectionApiInterface {
     list(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetDatacollectionListRes>;
 
     /**
-     * Returns every invited contributor for the survey, each with their current contribution state and contact details. For email-authenticated surveys the list is derived from the configured audience (object group or dataset); for anonymous and public surveys it reflects submitted contributions. Requires the *View crowd modelling* permission.
+     * Returns every contributor of an email or preferred-channel survey, each with their current contribution state and contact details: the survey\'s uploaded contributors or, if none were ever uploaded, the users in the object group named by its authentication mode. Anonymous and public surveys have no contributor list and return an empty list. Requires the *View crowd modelling* permission.
      * @summary List contributors for a survey
      * @param {string} id 
      * @param {*} [options] Override http request option.
@@ -174,13 +174,13 @@ export interface DataCollectionApiInterface {
     listContributorsRaw(requestParameters: DataCollectionApiListContributorsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetContributionListRes>>;
 
     /**
-     * Returns every invited contributor for the survey, each with their current contribution state and contact details. For email-authenticated surveys the list is derived from the configured audience (object group or dataset); for anonymous and public surveys it reflects submitted contributions. Requires the *View crowd modelling* permission.
+     * Returns every contributor of an email or preferred-channel survey, each with their current contribution state and contact details: the survey\'s uploaded contributors or, if none were ever uploaded, the users in the object group named by its authentication mode. Anonymous and public surveys have no contributor list and return an empty list. Requires the *View crowd modelling* permission.
      * List contributors for a survey
      */
     listContributors(requestParameters: DataCollectionApiListContributorsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetContributionListRes>;
 
     /**
-     * Partially updates the survey\'s name, steps, authentication mode, status, and other configurable fields. Only fields present in the request body are changed. Requires the *Configure crowd modelling* permission. Returns 400 if `anonymisationProperty` names a property that does not exist, or that is not a tree property for email or preferred-channel authentication. Also returns 400 if an already-set anonymisation property or authentication mode is changed, or status is moved back to draft, once the survey has left draft; an empty property or mode may still be set.
+     * Partially updates the survey\'s name, steps, authentication mode, status, and other configurable fields. Only fields present in the request body are changed. Requires the *Configure crowd modelling* permission. Returns 400 if `anonymisationProperty` names a property that does not exist, or that is not a tree property for email or preferred-channel authentication. Also returns 400 if an already-set anonymisation property or authentication mode is changed, or status is moved back to draft, once the survey has left draft; an empty property or mode may still be set. The object group ID in an email or preferred-channel authentication mode is only locked until contributors have been uploaded. For email or preferred-channel authentication, `contributors` lists each contributor\'s user ID and their nodes on the anonymisation property; a non-empty list replaces the stored one and `clearContributors` empties it. Sending either requires the *Upload data collection contributors* permission as well, and sending both returns 400. Switching a draft to anonymous or public authentication clears its contributors. Returns 400 if contributors are uploaded for anonymous or public authentication, if a contributor is listed twice, is not a user of the account, or names a node that is not on the anonymisation property, if the contributors change or are cleared once the survey has left draft, or if the survey leaves draft without contributors. Also returns 400 if the stored survey, contributors included, would exceed 300 KiB; at one node ID per contributor that is roughly 5,000 contributors. A survey that leaves draft without ever having had contributors uploaded takes them from the object group named by its authentication mode, if any.
      * @summary Update a data collection survey
      * @param {string} id 
      * @param {DatacollectionBody} [datacollectionBody] 
@@ -191,7 +191,7 @@ export interface DataCollectionApiInterface {
     updateRaw(requestParameters: DataCollectionApiUpdateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>>;
 
     /**
-     * Partially updates the survey\'s name, steps, authentication mode, status, and other configurable fields. Only fields present in the request body are changed. Requires the *Configure crowd modelling* permission. Returns 400 if `anonymisationProperty` names a property that does not exist, or that is not a tree property for email or preferred-channel authentication. Also returns 400 if an already-set anonymisation property or authentication mode is changed, or status is moved back to draft, once the survey has left draft; an empty property or mode may still be set.
+     * Partially updates the survey\'s name, steps, authentication mode, status, and other configurable fields. Only fields present in the request body are changed. Requires the *Configure crowd modelling* permission. Returns 400 if `anonymisationProperty` names a property that does not exist, or that is not a tree property for email or preferred-channel authentication. Also returns 400 if an already-set anonymisation property or authentication mode is changed, or status is moved back to draft, once the survey has left draft; an empty property or mode may still be set. The object group ID in an email or preferred-channel authentication mode is only locked until contributors have been uploaded. For email or preferred-channel authentication, `contributors` lists each contributor\'s user ID and their nodes on the anonymisation property; a non-empty list replaces the stored one and `clearContributors` empties it. Sending either requires the *Upload data collection contributors* permission as well, and sending both returns 400. Switching a draft to anonymous or public authentication clears its contributors. Returns 400 if contributors are uploaded for anonymous or public authentication, if a contributor is listed twice, is not a user of the account, or names a node that is not on the anonymisation property, if the contributors change or are cleared once the survey has left draft, or if the survey leaves draft without contributors. Also returns 400 if the stored survey, contributors included, would exceed 300 KiB; at one node ID per contributor that is roughly 5,000 contributors. A survey that leaves draft without ever having had contributors uploaded takes them from the object group named by its authentication mode, if any.
      * Update a data collection survey
      */
     update(requestParameters: DataCollectionApiUpdateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object>;
@@ -290,7 +290,7 @@ export class DataCollectionApi extends runtime.BaseAPI implements DataCollection
     }
 
     /**
-     * Returns the survey and a summary of contribution progress: how many contributors have started, completed, and the total invited. Requires the *View crowd modelling* permission.
+     * Returns the survey and a summary of contribution progress: how many contributors have started, completed, and the total invited. Requires the *View crowd modelling*, *View data collection preview* or *View public data collection* permission; drafts need one of the first two. Callers without *View crowd modelling* receive the survey without its `contributors` list or progress counts. For an email or preferred-channel survey whose contributors were never uploaded, `legacyContributors` counts the contributors it takes from the object group named by its authentication mode.
      * Get a data collection survey
      */
     async getRaw(requestParameters: DataCollectionApiGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetDatacollectionRes>> {
@@ -328,7 +328,7 @@ export class DataCollectionApi extends runtime.BaseAPI implements DataCollection
     }
 
     /**
-     * Returns the survey and a summary of contribution progress: how many contributors have started, completed, and the total invited. Requires the *View crowd modelling* permission.
+     * Returns the survey and a summary of contribution progress: how many contributors have started, completed, and the total invited. Requires the *View crowd modelling*, *View data collection preview* or *View public data collection* permission; drafts need one of the first two. Callers without *View crowd modelling* receive the survey without its `contributors` list or progress counts. For an email or preferred-channel survey whose contributors were never uploaded, `legacyContributors` counts the contributors it takes from the object group named by its authentication mode.
      * Get a data collection survey
      */
     async get(requestParameters: DataCollectionApiGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetDatacollectionRes> {
@@ -478,7 +478,7 @@ export class DataCollectionApi extends runtime.BaseAPI implements DataCollection
     }
 
     /**
-     * Returns every invited contributor for the survey, each with their current contribution state and contact details. For email-authenticated surveys the list is derived from the configured audience (object group or dataset); for anonymous and public surveys it reflects submitted contributions. Requires the *View crowd modelling* permission.
+     * Returns every contributor of an email or preferred-channel survey, each with their current contribution state and contact details: the survey\'s uploaded contributors or, if none were ever uploaded, the users in the object group named by its authentication mode. Anonymous and public surveys have no contributor list and return an empty list. Requires the *View crowd modelling* permission.
      * List contributors for a survey
      */
     async listContributorsRaw(requestParameters: DataCollectionApiListContributorsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetContributionListRes>> {
@@ -516,7 +516,7 @@ export class DataCollectionApi extends runtime.BaseAPI implements DataCollection
     }
 
     /**
-     * Returns every invited contributor for the survey, each with their current contribution state and contact details. For email-authenticated surveys the list is derived from the configured audience (object group or dataset); for anonymous and public surveys it reflects submitted contributions. Requires the *View crowd modelling* permission.
+     * Returns every contributor of an email or preferred-channel survey, each with their current contribution state and contact details: the survey\'s uploaded contributors or, if none were ever uploaded, the users in the object group named by its authentication mode. Anonymous and public surveys have no contributor list and return an empty list. Requires the *View crowd modelling* permission.
      * List contributors for a survey
      */
     async listContributors(requestParameters: DataCollectionApiListContributorsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetContributionListRes> {
@@ -525,7 +525,7 @@ export class DataCollectionApi extends runtime.BaseAPI implements DataCollection
     }
 
     /**
-     * Partially updates the survey\'s name, steps, authentication mode, status, and other configurable fields. Only fields present in the request body are changed. Requires the *Configure crowd modelling* permission. Returns 400 if `anonymisationProperty` names a property that does not exist, or that is not a tree property for email or preferred-channel authentication. Also returns 400 if an already-set anonymisation property or authentication mode is changed, or status is moved back to draft, once the survey has left draft; an empty property or mode may still be set.
+     * Partially updates the survey\'s name, steps, authentication mode, status, and other configurable fields. Only fields present in the request body are changed. Requires the *Configure crowd modelling* permission. Returns 400 if `anonymisationProperty` names a property that does not exist, or that is not a tree property for email or preferred-channel authentication. Also returns 400 if an already-set anonymisation property or authentication mode is changed, or status is moved back to draft, once the survey has left draft; an empty property or mode may still be set. The object group ID in an email or preferred-channel authentication mode is only locked until contributors have been uploaded. For email or preferred-channel authentication, `contributors` lists each contributor\'s user ID and their nodes on the anonymisation property; a non-empty list replaces the stored one and `clearContributors` empties it. Sending either requires the *Upload data collection contributors* permission as well, and sending both returns 400. Switching a draft to anonymous or public authentication clears its contributors. Returns 400 if contributors are uploaded for anonymous or public authentication, if a contributor is listed twice, is not a user of the account, or names a node that is not on the anonymisation property, if the contributors change or are cleared once the survey has left draft, or if the survey leaves draft without contributors. Also returns 400 if the stored survey, contributors included, would exceed 300 KiB; at one node ID per contributor that is roughly 5,000 contributors. A survey that leaves draft without ever having had contributors uploaded takes them from the object group named by its authentication mode, if any.
      * Update a data collection survey
      */
     async updateRaw(requestParameters: DataCollectionApiUpdateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>> {
@@ -566,7 +566,7 @@ export class DataCollectionApi extends runtime.BaseAPI implements DataCollection
     }
 
     /**
-     * Partially updates the survey\'s name, steps, authentication mode, status, and other configurable fields. Only fields present in the request body are changed. Requires the *Configure crowd modelling* permission. Returns 400 if `anonymisationProperty` names a property that does not exist, or that is not a tree property for email or preferred-channel authentication. Also returns 400 if an already-set anonymisation property or authentication mode is changed, or status is moved back to draft, once the survey has left draft; an empty property or mode may still be set.
+     * Partially updates the survey\'s name, steps, authentication mode, status, and other configurable fields. Only fields present in the request body are changed. Requires the *Configure crowd modelling* permission. Returns 400 if `anonymisationProperty` names a property that does not exist, or that is not a tree property for email or preferred-channel authentication. Also returns 400 if an already-set anonymisation property or authentication mode is changed, or status is moved back to draft, once the survey has left draft; an empty property or mode may still be set. The object group ID in an email or preferred-channel authentication mode is only locked until contributors have been uploaded. For email or preferred-channel authentication, `contributors` lists each contributor\'s user ID and their nodes on the anonymisation property; a non-empty list replaces the stored one and `clearContributors` empties it. Sending either requires the *Upload data collection contributors* permission as well, and sending both returns 400. Switching a draft to anonymous or public authentication clears its contributors. Returns 400 if contributors are uploaded for anonymous or public authentication, if a contributor is listed twice, is not a user of the account, or names a node that is not on the anonymisation property, if the contributors change or are cleared once the survey has left draft, or if the survey leaves draft without contributors. Also returns 400 if the stored survey, contributors included, would exceed 300 KiB; at one node ID per contributor that is roughly 5,000 contributors. A survey that leaves draft without ever having had contributors uploaded takes them from the object group named by its authentication mode, if any.
      * Update a data collection survey
      */
     async update(requestParameters: DataCollectionApiUpdateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object> {