pryv 2.4.4 → 2.4.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pryv",
-  "version": "2.4.4",
+  "version": "2.4.6",
   "description": "Pryv JavaScript library",
   "keywords": [
     "Pryv",
@@ -21,4 +21,4 @@
   "dependencies": {
     "superagent": "^9.0.0"
   }
-}
+}

package/src/Connection.js

@@ -81,7 +81,69 @@ class Connection {
     function httpHandler (batchCall) {
       return this.post('', batchCall);
     }
-    return await this._chunkedBatchCall(arrayOfAPICalls, progress, httpHandler.bind(this));
+    return await this._chunkedBatchCall(
+      arrayOfAPICalls,
+      progress,
+      httpHandler.bind(this)
+    );
+  }
+
+  /**
+   * Make one api Api call
+   * @param {string} method - methodId
+   * @param {Object|Array} [params] - the params associated with this methodId
+   * @param {string} [resultKey] - if given, returns the value or throws an error if not present
+   * @throws {Error} if .error is present the response
+   */
+  async apiOne (method, params = {}, expectedKey) {
+    const result = await this.api([{ method, params }]);
+    if (
+      result[0] == null ||
+      result[0].error ||
+      (expectedKey != null && result[0][expectedKey] == null)
+    ) {
+      const innerObject = result[0]?.error || result;
+      const error = new Error(
+        `Error for api method: "${method}" with params: ${JSON.stringify(
+          params
+        )} >> Result: ${JSON.stringify(innerObject)}"`
+      );
+      error.innerObject = innerObject;
+      throw error;
+    }
+    if (expectedKey != null) return result[0][expectedKey];
+    return result[0];
+  }
+
+  /**
+   * Revoke : Delete the accessId
+   * - Do not thow error if access is already revoked, just return null;
+   * @param {boolean} [throwOnFail = true] - if set to false do not throw Error on failure
+   * @param {Connection} [usingConnection] - specify which connection issues the revoke, might be necessary when selfRovke
+   */
+  async revoke (throwOnFail = true, usingConnection) {
+    usingConnection = usingConnection || this;
+    let accessInfo = null;
+    // get accessId
+    try {
+      accessInfo = await this.accessInfo();
+    } catch (e) {
+      if (e.response?.body?.error?.id === 'invalid-access-token') {
+        return null; // Already revoked OK..
+      }
+      if (throwOnFail) throw e;
+      return null;
+    }
+    // delete access
+    try {
+      const result = usingConnection.apiOne('accesses.delete', {
+        id: accessInfo.id
+      });
+      return result;
+    } catch (e) {
+      if (throwOnFail) throw e;
+      return null;
+    }
   }
 
   /**
@@ -94,32 +156,52 @@ class Connection {
 
     const res = [];
     let percent = 0;
-    for (let cursor = 0; arrayOfAPICalls.length >= cursor; cursor += this.options.chunkSize) {
+    for (
+      let cursor = 0;
+      arrayOfAPICalls.length >= cursor;
+      cursor += this.options.chunkSize
+    ) {
       const thisBatch = [];
-      const cursorMax = Math.min(cursor + this.options.chunkSize, arrayOfAPICalls.length);
+      const cursorMax = Math.min(
+        cursor + this.options.chunkSize,
+        arrayOfAPICalls.length
+      );
       // copy only method and params into a back call to be exuted
       for (let i = cursor; i < cursorMax; i++) {
-        thisBatch.push({ method: arrayOfAPICalls[i].method, params: arrayOfAPICalls[i].params });
+        thisBatch.push({
+          method: arrayOfAPICalls[i].method,
+          params: arrayOfAPICalls[i].params
+        });
       }
       const resRequest = await callHandler(thisBatch);
 
       // result checks
       if (!resRequest || !Array.isArray(resRequest.results)) {
-        throw new Error('API call result is not an Array: ' + JSON.stringify(resRequest));
+        throw new Error(
+          'API call result is not an Array: ' + JSON.stringify(resRequest)
+        );
       }
       if (resRequest.results.length !== thisBatch.length) {
-        throw new Error('API call result Array does not match request: ' + JSON.stringify(resRequest));
+        throw new Error(
+          'API call result Array does not match request: ' +
+            JSON.stringify(resRequest)
+        );
       }
 
       // eventually call handleResult
       for (let i = 0; i < resRequest.results.length; i++) {
         if (arrayOfAPICalls[i + cursor].handleResult) {
-          await arrayOfAPICalls[i + cursor].handleResult.call(null, resRequest.results[i]);
+          await arrayOfAPICalls[i + cursor].handleResult.call(
+            null,
+            resRequest.results[i]
+          );
         }
       }
       Array.prototype.push.apply(res, resRequest.results);
-      percent = Math.round(100 * res.length / arrayOfAPICalls.length);
-      if (progress) { progress(percent, res); }
+      percent = Math.round((100 * res.length) / arrayOfAPICalls.length);
+      if (progress) {
+        progress(percent, res);
+      }
     }
     return res;
   }
@@ -146,13 +228,12 @@ class Connection {
    * @returns {request.superagent}  Promise from superagent's post request
    */
   async postRaw (path, data, queryParams) {
-    return this._post(path)
-      .query(queryParams)
-      .send(data);
+    return this._post(path).query(queryParams).send(data);
   }
 
   _post (path) {
-    return utils.superagent.post(this.endpoint + path)
+    return utils.superagent
+      .post(this.endpoint + path)
       .set('Authorization', this.token)
       .set('accept', 'json');
   }
@@ -178,7 +259,8 @@ class Connection {
    */
   getRaw (path, queryParams) {
     path = path || '';
-    return utils.superagent.get(this.endpoint + path)
+    return utils.superagent
+      .get(this.endpoint + path)
       .set('Authorization', this.token)
       .set('accept', 'json')
       .query(queryParams);
@@ -189,12 +271,11 @@ class Connection {
    * https://api.pryv.com/reference/#add-hf-series-data-points
    */
   async addPointsToHFEvent (eventId, fields, points) {
-    const res = await this.post('events/' + eventId + '/series',
-      {
-        format: 'flatJSON',
-        fields: fields,
-        points: points
-      });
+    const res = await this.post('events/' + eventId + '/series', {
+      format: 'flatJSON',
+      fields: fields,
+      points: points
+    });
     if (!res.status === 'ok') {
       throw new Error('Failed loading serie: ' + JSON.stringify(res.status));
     }
@@ -212,14 +293,22 @@ class Connection {
   async getEventsStreamed (queryParams, forEachEvent) {
     const myParser = jsonParser(forEachEvent, queryParams.includeDeletions);
     let res = null;
-    if (typeof window === 'undefined') { // node
+    if (typeof window === 'undefined') {
+      // node
       res = await this.getRaw('events', queryParams)
         .buffer(false)
         .parse(myParser);
-    } else if (typeof fetch !== 'undefined' && !(typeof navigator !== 'undefined' && navigator.product === 'ReactNative')) { // browser supports fetch and it is not react native
+    } else if (
+      typeof fetch !== 'undefined' &&
+      !(typeof navigator !== 'undefined' && navigator.product === 'ReactNative')
+    ) {
+      // browser supports fetch and it is not react native
       res = await browserGetEventStreamed(this, queryParams, myParser);
-    } else { // browser no fetch supports
-      console.log('WARNING: Browser does not support fetch() required by pryv.Connection.getEventsStreamed()');
+    } else {
+      // browser no fetch supports
+      console.log(
+        'WARNING: Browser does not support fetch() required by pryv.Connection.getEventsStreamed()'
+      );
       res = await this.getRaw('events', queryParams);
       res.body.eventsCount = 0;
       if (res.body.events) {
@@ -227,7 +316,8 @@ class Connection {
         res.body.eventsCount += res.body.events.length;
         delete res.body.events;
       }
-      if (res.body.eventDeletions) { // deletions are in a seprated Array
+      if (res.body.eventDeletions) {
+        // deletions are in a seprated Array
         res.body.eventDeletions.forEach(forEachEvent);
         res.body.eventsCount += res.body.eventDeletions.length;
         delete res.body.eventDeletions;
@@ -262,7 +352,8 @@ class Connection {
    * @param {string} fileName
    */
   async createEventWithFileFromBuffer (event, bufferData, filename) {
-    if (typeof window === 'undefined') { // node
+    if (typeof window === 'undefined') {
+      // node
       const res = await this._post('events')
         .field('event', JSON.stringify(event))
         .attach('file', bufferData, filename);
@@ -280,11 +371,11 @@ class Connection {
   }
 
   /**
- * Create an event with attached formData
- * !! BROWSER ONLY
- * @param {Event} event
- * @param {FormData} formData https://developer.mozilla.org/en-US/docs/Web/API/FormData/FormData
- */
+   * Create an event with attached formData
+   * !! BROWSER ONLY
+   * @param {Event} event
+   * @param {FormData} formData https://developer.mozilla.org/en-US/docs/Web/API/FormData/FormData
+   */
   async createEventWithFormData (event, formData) {
     formData.append('event', JSON.stringify(event));
     const res = await this._post('events').send(formData);
@@ -313,10 +404,14 @@ class Connection {
   // private method that handle meta data parsing
   _handleMeta (res, requestLocalTimestamp) {
     if (!res.meta) throw new Error('Cannot find .meta in response.');
-    if (!res.meta.serverTime) throw new Error('Cannot find .meta.serverTime in response.');
+    if (!res.meta.serverTime) { throw new Error('Cannot find .meta.serverTime in response.'); }
 
     // update deltaTime and weight it
-    this._deltaTime.value = (this._deltaTime.value * this._deltaTime.weight + res.meta.serverTime - requestLocalTimestamp) / ++this._deltaTime.weight;
+    this._deltaTime.value =
+      (this._deltaTime.value * this._deltaTime.weight +
+        res.meta.serverTime -
+        requestLocalTimestamp) /
+      ++this._deltaTime.weight;
   }
 }
 

package/src/index.d.ts

@@ -17,7 +17,7 @@ declare module 'pryv' {
     name: string;
     parentId?: Identifier;
     clientData?: KeyValue;
-    children: Identifier[];
+    children: Stream[];
     trashed?: boolean;
     created: Timestamp;
     createdBy: Identifier;
@@ -575,8 +575,17 @@ declare module 'pryv' {
     username(): Promise<string>;
     api<Calls extends APICall[] = APICall[]>(
       apiCalls: Calls,
-      res?: APICallProgressHandler[],
+      progress?: APICallProgressHandler,
     ): Promise<Array<TypedAPICallResult>>;
+    apiOne<T extends keyof APICallMethods>(
+      method: T, 
+      params: APICallMethods[T]['params'], 
+    ): Promise<APICallMethods[T]['res']>;
+    apiOne<T extends keyof APICallMethods, U extends keyof APICallMethods[T]['res']>(
+      method: T, 
+      params: APICallMethods[T]['params'], 
+      expectedKey: U
+    ): Promise<APICallMethods[T]['res'][U]>;
     getEventsStreamed(
       queryParams: Partial<EventQueryParamsStreamQuery>,
       forEachEvent: StreamedEventsHandler,
@@ -598,8 +607,11 @@ declare module 'pryv' {
       id: Identifier,
       fields: string[],
       values: Array<string | number>,
-    ): Promise<void>;
+    ): Promise<any>;
     accessInfo(): Promise<AccessInfo>;
+    revoke(throwOnFail?: boolean, usingConnection?: Connection)
+    readonly deltaTime: number;
+    readonly apiEndpoint: string;
 
     post(
       path: string,
@@ -650,14 +662,27 @@ declare module 'pryv' {
     [key: string]: any;
   };
 
+  export class ServiceAssets {
+    static setup(pryvServiceAssetsSourceUrl: string): Promise<ServiceAssets>;
+    get(keyPath?: string): any;
+    getUrl(keyPath?: string): string;
+    relativeURL(url: string): string;
+    setAllDefaults(): Promise<void>;
+    setFavicon(): void;
+    loadCSS(): Promise<void>;
+    loginButtonLoadCSS(): Promise<void>;
+    loginButtonGetHTML(): Promise<string>;
+    loginButtonGetMessages(): Promise<KeyValue>;
+  }
+
   export class Service {
     constructor (
       serviceInfoUrl: string,
       serviceCustomizations?: serviceCustomizations,
     );
     info(forceFetch?: boolean): Promise<ServiceInfo>;
-    setServiceInfo(serviceInfo: Partial<ServiceInfo>): Promise<void>;
-    assets(forceFetch?: boolean): Promise<AssetsConfig>;
+    setServiceInfo(serviceInfo: Partial<ServiceInfo>): void;
+    assets(forceFetch?: boolean): Promise<ServiceAssets | null>;
     infoSync(): ServiceInfo | null;
     apiEndpointFor(username: string, token: string): Promise<string>;
     login(
@@ -666,6 +691,9 @@ declare module 'pryv' {
       appId: string,
       originHeader?: string,
     ): Promise<Connection>;
+
+    supportsHF(): Promise<boolean>;
+    isDnsLess(): Promise<boolean>;
   }
 
   export type AuthRequestedPermission = {
@@ -755,12 +783,13 @@ declare module 'pryv' {
   };
 
   export type CustomLoginButton = {
-    init?: () => Promise<void>;
-    getAuthorizationData(): string;
+    init?: () => Promise<Service>;
+    getAuthorizationData(): any;
     onStateChange(state: AuthStatePayload): Promise<void>;
     onClick(): void;
-    saveAuthorizationData?: (authData: string) => void;
+    saveAuthorizationData?: (authData: any) => void;
     deleteAuthorizationData?: () => Promise<void>;
+    finishAuthProcessAfterRedirection?: (authController: AuthController) => Promise<void>;
   }
 
   export class AuthController {
@@ -769,16 +798,15 @@ declare module 'pryv' {
       service: Service,
       loginButton: CustomLoginButton,
     );
-    init(): Promise<void>;
+    init(): Promise<Service>;
     stopAuthRequest(msg: string): void;
     handleClick(): Promise<void>;
     getReturnURL(
       returnURL: string,
-      windowLocationForTest: string,
-      navigatorForTests: string,
+      windowLocationForTest?: string,
+      navigatorForTests?: string,
     ): string | boolean;
     startAuthRequest(): Promise<any>;
-    doPolling(): Promise<void>;
     set state(newState: AuthStatePayload);
     get state(): AuthStatePayload;
   }
@@ -805,7 +833,7 @@ declare module 'pryv' {
 
   export type TokenAndAPIEndpoint = {
     endpoint: string;
-    token: string;
+    token: string | null;
   };
 
   export const utils: {
@@ -820,6 +848,32 @@ declare module 'pryv' {
   type version = string;
 
   let pryv: {
+    Service: typeof Service;
+    Connection: typeof Connection;
+    Auth: {
+      setupAuth: SetupAuth;
+      AuthStates: AuthStates;
+      AuthController: typeof AuthController;
+    };
+    Browser: {
+      LoginButton: CustomLoginButton;
+      CookieUtils: {
+        set(cookieKey: string, value: any, expireInDays: number): void;
+        get(cookieKey: string): any;
+        del(cookieKey: string): void;
+      };
+      AuthStates: AuthStates;
+      setupAuth: SetupAuth;
+      serviceInfoFromUrl: getServiceInfoFromURL;
+    };
+    utils: {
+      isBrowser(): boolean;
+      extractTokenAndAPIEndpoint(apiEndpoint: string): TokenAndAPIEndpoint;
+      buildAPIEndpoint(tokenAndAPI: TokenAndAPIEndpoint): string;
+      browserIsMobileOrTablet(navigator: string): boolean;
+      cleanURLFromPrYvParams(url: string): string;
+      getQueryParamsFromURL(url: string): KeyValue;
+    };
     version: version;
   };
 

package/test/Connection.test.js

@@ -89,6 +89,18 @@ describe('Connection', () => {
     });
   });
 
+  describe('.apiOne()', function () {
+    this.timeout(15000);
+    it('.apiOne("events.get")', async () => {
+      const res = await conn.apiOne('events.get');
+      expect(res.events).to.exist;
+    });
+    it('.apiOne("events.get")', async () => {
+      const res = await conn.apiOne('events.get', {}, 'events');
+      expect(Array.isArray(res)).to.equal(true);
+    });
+  });
+
   describe('.api()', function () {
     this.timeout(15000);
     it('.api() events.get', async () => {