cozy-client 58.2.0 → 58.3.0

package/dist/CozyClient.js

@@ -3143,7 +3143,7 @@ var CozyClient = /*#__PURE__*/function () {
 CozyClient.hooks = CozyClient.hooks || {};
 CozyClient.fetchPolicies = _policies.default; //COZY_CLIENT_VERSION_PACKAGE in replaced by babel. See babel config
 
-CozyClient.version = "58.2.0";
+CozyClient.version = "58.3.0";
 
 _microee.default.mixin(CozyClient);
 

package/dist/helpers/index.js

@@ -27,6 +27,12 @@ Object.defineProperty(exports, "ensureFirstSlash", {
     return _urlHelper.ensureFirstSlash;
   }
 });
+Object.defineProperty(exports, "fetchRegistrationDetails", {
+  enumerable: true,
+  get: function get() {
+    return _urlHelper.fetchRegistrationDetails;
+  }
+});
 Object.defineProperty(exports, "rootCozyUrl", {
   enumerable: true,
   get: function get() {

package/dist/helpers/urlHelper.js

@@ -5,7 +5,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.rootCozyUrl = exports.InvalidCozyUrlError = exports.BlockedCozyError = exports.InvalidProtocolError = exports.InvalidRedirectLinkError = exports.deconstructRedirectLink = exports.deconstructCozyWebLinkWithSlug = exports.generateWebLink = exports.ensureFirstSlash = void 0;
+exports.fetchRegistrationDetails = exports.rootCozyUrl = exports.InvalidCozyUrlError = exports.BlockedCozyError = exports.InvalidProtocolError = exports.InvalidRedirectLinkError = exports.deconstructRedirectLink = exports.deconstructCozyWebLinkWithSlug = exports.generateWebLink = exports.ensureFirstSlash = void 0;
 
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 
@@ -263,7 +263,7 @@ var uri = function uri(_ref2) {
       port = _ref2.port;
   return (protocol !== '' ? "".concat(protocol, "//") : 'https://') + hostname + (port !== '' ? ":".concat(port) : '');
 };
-/* wellKnownUrl - Returns a valid URL string to a Well Known password change page
+/* publicPreloginUrl - Returns a valid URL string to the /public/prelogin API endpoint
  *
  * The built URL will point to the origin generated from the given protocol,
  * hostname and port.
@@ -277,8 +277,8 @@ var uri = function uri(_ref2) {
  */
 
 
-var wellKnownUrl = function wellKnownUrl(url) {
-  return uri(url) + '/.well-known/change-password';
+var publicPreloginUrl = function publicPreloginUrl(url) {
+  return uri(url) + '/public/prelogin';
 };
 /* isValidOrigin - Checks whether a given URL is a valid Cozy origin
  *
@@ -307,13 +307,13 @@ var wellKnownUrl = function wellKnownUrl(url) {
 
 var isValidOrigin = /*#__PURE__*/function () {
   var _ref3 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(url) {
-    var response, status, responseUri, wasRedirected;
+    var response, status, responseUri, wasRedirected, contentType;
     return _regenerator.default.wrap(function _callee$(_context) {
       while (1) {
         switch (_context.prev = _context.next) {
           case 0:
             _context.next = 2;
-            return fetch(wellKnownUrl(url));
+            return fetch(publicPreloginUrl(url));
 
           case 2:
             response = _context.sent;
@@ -339,10 +339,37 @@ var isValidOrigin = /*#__PURE__*/function () {
             throw new BlockedCozyError(url);
 
           case 10:
-            wasRedirected = url.origin !== new URL(responseUri).origin;
-            return _context.abrupt("return", status === 200 && !wasRedirected);
+            if (!(status !== 200)) {
+              _context.next = 12;
+              break;
+            }
+
+            return _context.abrupt("return");
 
           case 12:
+            wasRedirected = responseUri && url.origin !== new URL(responseUri).origin;
+
+            if (!wasRedirected) {
+              _context.next = 15;
+              break;
+            }
+
+            return _context.abrupt("return", false);
+
+          case 15:
+            contentType = response.headers.get('content-type');
+
+            if (!(!contentType || contentType.indexOf('application/json') === -1)) {
+              _context.next = 18;
+              break;
+            }
+
+            return _context.abrupt("return", false);
+
+          case 18:
+            return _context.abrupt("return", response.json());
+
+          case 19:
           case "end":
             return _context.stop();
         }
@@ -399,83 +426,19 @@ var isValidOrigin = /*#__PURE__*/function () {
 
 var rootCozyUrl = /*#__PURE__*/function () {
   var _ref4 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(url) {
-    var _url$hostname$split, _url$hostname$split2, subDomain, domain, _hostname, noSlugUrl, hostname, noSubUrl;
-
+    var detail;
     return _regenerator.default.wrap(function _callee2$(_context2) {
       while (1) {
         switch (_context2.prev = _context2.next) {
           case 0:
-            if (['http:', 'https:'].includes(url.protocol)) {
-              _context2.next = 2;
-              break;
-            }
-
-            throw new InvalidProtocolError(url);
+            _context2.next = 2;
+            return fetchRegistrationDetails(url);
 
           case 2:
-            _context2.next = 4;
-            return isValidOrigin(url);
+            detail = _context2.sent;
+            return _context2.abrupt("return", detail.rootUrl);
 
           case 4:
-            if (!_context2.sent) {
-              _context2.next = 6;
-              break;
-            }
-
-            return _context2.abrupt("return", new URL(uri({
-              protocol: url.protocol,
-              hostname: url.hostname,
-              port: url.port
-            })));
-
-          case 6:
-            if (!/^[^.-][^.]+-[^.-]+\./.test(url.hostname)) {
-              _context2.next = 14;
-              break;
-            }
-
-            _url$hostname$split = url.hostname.split('.'), _url$hostname$split2 = (0, _toArray2.default)(_url$hostname$split), subDomain = _url$hostname$split2[0], domain = _url$hostname$split2.slice(1);
-            _hostname = [subDomain.replace(/-.+/, '')].concat((0, _toConsumableArray2.default)(domain)).join('.');
-            noSlugUrl = new URL(uri({
-              protocol: url.protocol,
-              hostname: _hostname,
-              port: url.port
-            }));
-            _context2.next = 12;
-            return isValidOrigin(noSlugUrl);
-
-          case 12:
-            if (!_context2.sent) {
-              _context2.next = 14;
-              break;
-            }
-
-            return _context2.abrupt("return", noSlugUrl);
-
-          case 14:
-            // Try to remove the first sub-domain in case its a nested app name
-            // eslint-disable-next-line no-unused-vars
-            hostname = url.hostname.split('.').splice(1).join('.');
-            noSubUrl = new URL(uri({
-              protocol: url.protocol,
-              hostname: hostname,
-              port: url.port
-            }));
-            _context2.next = 18;
-            return isValidOrigin(noSubUrl);
-
-          case 18:
-            if (!_context2.sent) {
-              _context2.next = 20;
-              break;
-            }
-
-            return _context2.abrupt("return", noSubUrl);
-
-          case 20:
-            throw new InvalidCozyUrlError(url);
-
-          case 21:
           case "end":
             return _context2.stop();
         }
@@ -545,4 +508,188 @@ var isResponseAboutBlockedCozy = /*#__PURE__*/function () {
   return function isResponseAboutBlockedCozy(_x3) {
     return _ref5.apply(this, arguments);
   };
-}();
+}();
+/**
+ * Check if the given url uses the expected protocols (http or https). Throws otherwise
+ *
+ * @param {URL} url - URL to validate
+ */
+
+
+var throwIfInvalidProtocol = function throwIfInvalidProtocol(url) {
+  if (!['http:', 'https:'].includes(url.protocol)) {
+    throw new InvalidProtocolError(url);
+  }
+};
+
+var mayHaveSlug = function mayHaveSlug(url) {
+  return /^[^.-][^.]+-[^.-]+\./.test(url.hostname);
+};
+
+var removeSlug = function removeSlug(url) {
+  var _url$hostname$split = url.hostname.split('.'),
+      _url$hostname$split2 = (0, _toArray2.default)(_url$hostname$split),
+      subDomain = _url$hostname$split2[0],
+      domain = _url$hostname$split2.slice(1);
+
+  var hostname = [subDomain.replace(/-.+/, '')].concat((0, _toConsumableArray2.default)(domain)).join('.');
+  var noSlugUrl = new URL(uri({
+    protocol: url.protocol,
+    hostname: hostname,
+    port: url.port
+  }));
+  return noSlugUrl;
+};
+
+var removeSubdomain = function removeSubdomain(url) {
+  var hostname = url.hostname.split('.').splice(1).join('.');
+  var noSubUrl = new URL(uri({
+    protocol: url.protocol,
+    hostname: hostname,
+    port: url.port
+  }));
+  return noSubUrl;
+};
+/**
+ * @typedef {object} RegistrationDetails
+ * @property {URL} rootUrl - The Cozy's root URL
+ * @property {boolean} isOIDC - True if the Cozy's uses OIDC for login
+ */
+
+/**
+ * registrationDetails - Get the root URL and prelogin info of a Cozy from more
+ * precise ones
+ *
+ * The goal is to allow users to use any URL copied from their browser as their
+ * Cozy URL rather than trying to explain to them what we expect (e.g. when
+ * requesting the Cozy URL to connect an app).
+ * If we can't get the root URL either because there's no Cozy or the domain
+ * does not exist or anything else, we'll throw an InvalidCozyUrlError.
+ * Also, since we communicate only via HTTP or HTTPS, we'll throw an
+ * InvalidProtocolError if any other protocol is used.
+ *
+ * This function expects a fully qualified URL thus with a protocol and a valid
+ * hostname. If your application accepts Cozy intances as input (e.g. `claude`
+ * when the Cozy can be found at `https://claude.mycozy.cloud`), it is your
+ * responsibility to add the appropriate domain to the hostname before calling
+ * this function.
+ *
+ * Examples:
+ *
+ * 1. getting the root URL when your user gives you its instance name
+ *
+ *   const userInput = 'claude'
+ *   const details = await fetchRegistrationDetails(new URL(`https://${userInput}.mycozy.cloud`))
+ *   // → returns { rootUrl: new URL('https://claude.mycozy.cloud'), isOIDC: false }
+ *
+ * 2. getting the root URL when your user gives you a Cozy Drive URL
+ *
+ *   const userInput = 'https://claude-drive.mycozy.cloud/#/folder/io.cozy.files.root-dir'
+ *   const rootUrl = await fetchRegistrationDetails(new URL(userInput))
+ *   // → returns { rootUrl: new URL('https://claude.mycozy.cloud'), isOIDC: false }
+ *
+ * 3. getting the root URL when the Cozy uses nested sub-domains
+ *
+ *   const userInput = 'http://photos.camille.nimbus.com:8080/#/album/1234567890'
+ *   const rootCozyUrl = await fetchRegistrationDetails(new URL(userInput))
+ *   // → returns { rootUrl: new URL('http://camille.nimbus.com:8080'), isOIDC: false }
+ *
+ * 4. getting the root URL when your user gives you an instance from OIDC partners
+ *
+ *   const details = await fetchRegistrationDetails(new URL(`https://alice.someoidcpartener.com`))
+ *   // → returns { rootUrl: new URL('https://alice.someoidcpartener.com'), isOIDC: true }
+ *
+ * @param {URL} url The URL from which we'll try to get the root Cozy URL
+ *
+ * @returns {Promise<RegistrationDetails>} The root Cozy URL
+ */
+
+
+var fetchRegistrationDetails = /*#__PURE__*/function () {
+  var _ref6 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee4(url) {
+    var preloginData, noSlugUrl, noSlugPreloginData, noSubUrl, noSubPreloginData;
+    return _regenerator.default.wrap(function _callee4$(_context4) {
+      while (1) {
+        switch (_context4.prev = _context4.next) {
+          case 0:
+            throwIfInvalidProtocol(url);
+            _context4.next = 3;
+            return isValidOrigin(url);
+
+          case 3:
+            preloginData = _context4.sent;
+
+            if (!preloginData) {
+              _context4.next = 6;
+              break;
+            }
+
+            return _context4.abrupt("return", {
+              rootUrl: new URL(uri({
+                protocol: url.protocol,
+                hostname: url.hostname,
+                port: url.port
+              })),
+              isOIDC: preloginData.OIDC
+            });
+
+          case 6:
+            if (!mayHaveSlug(url)) {
+              _context4.next = 13;
+              break;
+            }
+
+            noSlugUrl = removeSlug(url);
+            _context4.next = 10;
+            return isValidOrigin(noSlugUrl);
+
+          case 10:
+            noSlugPreloginData = _context4.sent;
+
+            if (!noSlugPreloginData) {
+              _context4.next = 13;
+              break;
+            }
+
+            return _context4.abrupt("return", {
+              rootUrl: noSlugUrl,
+              isOIDC: noSlugPreloginData.OIDC
+            });
+
+          case 13:
+            // Try to remove the first sub-domain in case its a nested app name
+            // eslint-disable-next-line no-unused-vars
+            noSubUrl = removeSubdomain(url);
+            _context4.next = 16;
+            return isValidOrigin(noSubUrl);
+
+          case 16:
+            noSubPreloginData = _context4.sent;
+
+            if (!noSubPreloginData) {
+              _context4.next = 19;
+              break;
+            }
+
+            return _context4.abrupt("return", {
+              rootUrl: noSubUrl,
+              isOIDC: noSubPreloginData.OIDC
+            });
+
+          case 19:
+            throw new InvalidCozyUrlError(url);
+
+          case 20:
+          case "end":
+            return _context4.stop();
+        }
+      }
+    }, _callee4);
+  }));
+
+  return function fetchRegistrationDetails(_x4) {
+    return _ref6.apply(this, arguments);
+  };
+}();
+
+exports.fetchRegistrationDetails = fetchRegistrationDetails;

package/dist/helpers/urlHelper.spec.js

@@ -4,6 +4,7 @@ import {
   deconstructCozyWebLinkWithSlug,
   deconstructRedirectLink,
   generateWebLink,
+  fetchRegistrationDetails,
   rootCozyUrl,
   InvalidRedirectLinkError,
   InvalidCozyUrlError,
@@ -203,11 +204,14 @@ describe('rootCozyUrl', () => {
 
   it('should handle cozy-hosted https', async () => {
     fetch.mockOnceIf(
-      'https://camillenimbus.mycozy.cloud/.well-known/change-password',
-      {},
+      'https://camillenimbus.mycozy.cloud/public/prelogin',
+      fakeCozyPrelogin(),
       {
         status: 200,
-        url: 'https://camillenimbus.mycozy.cloud/.well-known/change-password'
+        url: 'https://camillenimbus.mycozy.cloud/public/prelogin',
+        headers: {
+          'content-type': 'application/json'
+        }
       }
     )
 
@@ -218,11 +222,14 @@ describe('rootCozyUrl', () => {
 
   it('should handle cozy-hosted https trailing slash', async () => {
     fetch.mockOnceIf(
-      'https://camillenimbus.mycozy.cloud/.well-known/change-password',
-      {},
+      'https://camillenimbus.mycozy.cloud/public/prelogin',
+      fakeCozyPrelogin(),
       {
         status: 200,
-        url: 'https://camillenimbus.mycozy.cloud/.well-known/change-password'
+        url: 'https://camillenimbus.mycozy.cloud/public/prelogin',
+        headers: {
+          'content-type': 'application/json'
+        }
       }
     )
 
@@ -233,11 +240,14 @@ describe('rootCozyUrl', () => {
 
   it('should handle cozy-hosted https trailing path', async () => {
     fetch.mockOnceIf(
-      'https://camillenimbus.mycozy.cloud/.well-known/change-password',
-      {},
+      'https://camillenimbus.mycozy.cloud/public/prelogin',
+      fakeCozyPrelogin(),
       {
         status: 200,
-        url: 'https://camillenimbus.mycozy.cloud/.well-known/change-password'
+        url: 'https://camillenimbus.mycozy.cloud/public/prelogin',
+        headers: {
+          'content-type': 'application/json'
+        }
       }
     )
 
@@ -248,20 +258,22 @@ describe('rootCozyUrl', () => {
 
   it('should handle cozy-hosted drive web app url', async () => {
     fetch.mockOnceIf(
-      'https://camillenimbus-drive.mycozy.cloud/.well-known/change-password',
+      'https://camillenimbus-drive.mycozy.cloud/public/prelogin',
       {},
       {
         status: 401,
-        url:
-          'https://camillenimbus-drive.mycozy.cloud/.well-known/change-password'
+        url: 'https://camillenimbus-drive.mycozy.cloud/public/prelogin'
       }
     )
     fetch.mockOnceIf(
-      'https://camillenimbus.mycozy.cloud/.well-known/change-password',
-      {},
+      'https://camillenimbus.mycozy.cloud/public/prelogin',
+      fakeCozyPrelogin(),
       {
         status: 200,
-        url: 'https://camillenimbus.mycozy.cloud/.well-known/change-password'
+        url: 'https://camillenimbus.mycozy.cloud/public/prelogin',
+        headers: {
+          'content-type': 'application/json'
+        }
       }
     )
 
@@ -272,20 +284,22 @@ describe('rootCozyUrl', () => {
 
   it('should handle cozy-hosted photos album url', async () => {
     fetch.mockOnceIf(
-      'https://camillenimbus-photos.mycozy.cloud/.well-known/change-password',
+      'https://camillenimbus-photos.mycozy.cloud/public/prelogin',
       {},
       {
         status: 401,
-        url:
-          'https://camillenimbus-photos.mycozy.cloud/.well-known/change-password'
+        url: 'https://camillenimbus-photos.mycozy.cloud/public/prelogin'
       }
     )
     fetch.mockOnceIf(
-      'https://camillenimbus.mycozy.cloud/.well-known/change-password',
-      {},
+      'https://camillenimbus.mycozy.cloud/public/prelogin',
+      fakeCozyPrelogin(),
       {
         status: 200,
-        url: 'https://camillenimbus.mycozy.cloud/.well-known/change-password'
+        url: 'https://camillenimbus.mycozy.cloud/public/prelogin',
+        headers: {
+          'content-type': 'application/json'
+        }
       }
     )
 
@@ -300,20 +314,22 @@ describe('rootCozyUrl', () => {
 
   it('should handle cozy-hosted app name', async () => {
     fetch.mockOnceIf(
-      'https://camillenimbus-drive.mycozy.cloud/.well-known/change-password',
+      'https://camillenimbus-drive.mycozy.cloud/public/prelogin',
       {},
       {
         status: 401,
-        url:
-          'https://camillenimbus-drive.mycozy.cloud/.well-known/change-password'
+        url: 'https://camillenimbus-drive.mycozy.cloud/public/prelogin'
       }
     )
     fetch.mockOnceIf(
-      'https://camillenimbus.mycozy.cloud/.well-known/change-password',
-      {},
+      'https://camillenimbus.mycozy.cloud/public/prelogin',
+      fakeCozyPrelogin(),
       {
         status: 200,
-        url: 'https://camillenimbus.mycozy.cloud/.well-known/change-password'
+        url: 'https://camillenimbus.mycozy.cloud/public/prelogin',
+        headers: {
+          'content-type': 'application/json'
+        }
       }
     )
 
@@ -327,7 +343,7 @@ describe('rootCozyUrl', () => {
     // `onboarding`) to the Home app (via the login page if the user is not
     // logged in).
     fetch.mockOnceIf(
-      'https://camillenimbus-onboarding.mycozy.cloud/.well-known/change-password',
+      'https://camillenimbus-onboarding.mycozy.cloud/public/prelogin',
       {},
       {
         status: 200,
@@ -336,11 +352,14 @@ describe('rootCozyUrl', () => {
       }
     )
     fetch.mockOnceIf(
-      'https://camillenimbus.mycozy.cloud/.well-known/change-password',
-      {},
+      'https://camillenimbus.mycozy.cloud/public/prelogin',
+      fakeCozyPrelogin(),
       {
         status: 200,
-        url: 'https://camillenimbus.mycozy.cloud/.well-known/change-password'
+        url: 'https://camillenimbus.mycozy.cloud/public/prelogin',
+        headers: {
+          'content-type': 'application/json'
+        }
       }
     )
 
@@ -351,11 +370,14 @@ describe('rootCozyUrl', () => {
 
   it('should handle self-hosted https', async () => {
     fetch.mockOnceIf(
-      'https://camillenimbus.com/.well-known/change-password',
-      {},
+      'https://camillenimbus.com/public/prelogin',
+      fakeCozyPrelogin(),
       {
         status: 200,
-        url: 'https://camillenimbus.com/.well-known/change-password'
+        url: 'https://camillenimbus.com/public/prelogin',
+        headers: {
+          'content-type': 'application/json'
+        }
       }
     )
 
@@ -366,11 +388,14 @@ describe('rootCozyUrl', () => {
 
   it('should handle self-hosted with dash', async () => {
     fetch.mockOnceIf(
-      'https://camille-nimbus.com/.well-known/change-password',
-      {},
+      'https://camille-nimbus.com/public/prelogin',
+      fakeCozyPrelogin(),
       {
         status: 200,
-        url: 'https://camille-nimbus.com/.well-known/change-password'
+        url: 'https://camille-nimbus.com/public/prelogin',
+        headers: {
+          'content-type': 'application/json'
+        }
       }
     )
 
@@ -381,11 +406,14 @@ describe('rootCozyUrl', () => {
 
   it('should handle self-hosted http', async () => {
     fetch.mockOnceIf(
-      'http://camille-nimbus.com/.well-known/change-password',
-      {},
+      'http://camille-nimbus.com/public/prelogin',
+      fakeCozyPrelogin(),
       {
         status: 200,
-        url: 'http://camille-nimbus.com/.well-known/change-password'
+        url: 'http://camille-nimbus.com/public/prelogin',
+        headers: {
+          'content-type': 'application/json'
+        }
       }
     )
 
@@ -396,11 +424,14 @@ describe('rootCozyUrl', () => {
 
   it('should handle self-hosted https with port', async () => {
     fetch.mockOnceIf(
-      'https://camillenimbus.com:666/.well-known/change-password',
-      {},
+      'https://camillenimbus.com:666/public/prelogin',
+      fakeCozyPrelogin(),
       {
         status: 200,
-        url: 'https://camillenimbus.com:666/.well-known/change-password'
+        url: 'https://camillenimbus.com:666/public/prelogin',
+        headers: {
+          'content-type': 'application/json'
+        }
       }
     )
 
@@ -411,19 +442,22 @@ describe('rootCozyUrl', () => {
 
   it('should handle self-hosted nested drive web app url', async () => {
     fetch.mockOnceIf(
-      'https://drive.camillenimbus.com/.well-known/change-password',
+      'https://drive.camillenimbus.com/public/prelogin',
       {},
       {
         status: 401,
-        url: 'https://drive.camillenimbus.com/.well-known/change-password'
+        url: 'https://drive.camillenimbus.com/public/prelogin'
       }
     )
     fetch.mockOnceIf(
-      'https://camillenimbus.com/.well-known/change-password',
-      {},
+      'https://camillenimbus.com/public/prelogin',
+      fakeCozyPrelogin(),
       {
         status: 200,
-        url: 'https://camillenimbus.com/.well-known/change-password'
+        url: 'https://camillenimbus.com/public/prelogin',
+        headers: {
+          'content-type': 'application/json'
+        }
       }
     )
 
@@ -434,19 +468,22 @@ describe('rootCozyUrl', () => {
 
   it('should handle self-hosted flat drive web app url', async () => {
     fetch.mockOnceIf(
-      'https://camille-drive.nimbus.com/.well-known/change-password',
+      'https://camille-drive.nimbus.com/public/prelogin',
       {},
       {
         status: 401,
-        url: 'https://camille-drive.nimbus.com/.well-known/change-password'
+        url: 'https://camille-drive.nimbus.com/public/prelogin'
       }
     )
     fetch.mockOnceIf(
-      'https://camille.nimbus.com/.well-known/change-password',
-      {},
+      'https://camille.nimbus.com/public/prelogin',
+      fakeCozyPrelogin(),
       {
         status: 200,
-        url: 'https://camille.nimbus.com/.well-known/change-password'
+        url: 'https://camille.nimbus.com/public/prelogin',
+        headers: {
+          'content-type': 'application/json'
+        }
       }
     )
 
@@ -457,11 +494,14 @@ describe('rootCozyUrl', () => {
 
   it('should handle cozy.localhost', async () => {
     fetch.mockOnceIf(
-      'http://cozy.localhost:8080/.well-known/change-password',
-      {},
+      'http://cozy.localhost:8080/public/prelogin',
+      fakeCozyPrelogin(),
       {
         status: 200,
-        url: 'http://cozy.localhost:8080/.well-known/change-password'
+        url: 'http://cozy.localhost:8080/public/prelogin',
+        headers: {
+          'content-type': 'application/json'
+        }
       }
     )
     await expect(
@@ -471,11 +511,11 @@ describe('rootCozyUrl', () => {
 
   it('expects an http or https protocol', async () => {
     fetch.mockOnceIf(
-      'ftp://camillenimbus.com/.well-known/change-password',
+      'ftp://camillenimbus.com/public/prelogin',
       {},
       {
         status: 200,
-        url: 'ftp://camillenimbus.com/.well-known/change-password'
+        url: 'ftp://camillenimbus.com/public/prelogin'
       }
     )
 
@@ -486,11 +526,11 @@ describe('rootCozyUrl', () => {
 
   it('rejects if URL points to a valid cozy-stack but no valid Cozy instance', async () => {
     fetch.mockOnceIf(
-      'https://missing.mycozy.cloud/.well-known/change-password',
+      'https://missing.mycozy.cloud/public/prelogin',
       {},
       {
         status: 404,
-        url: 'https://missing.mycozy.cloud/.well-known/change-password'
+        url: 'https://missing.mycozy.cloud/public/prelogin'
       }
     )
 
@@ -518,7 +558,7 @@ describe('rootCozyUrl', () => {
         status: 503,
         statusText: '',
         type: 'default',
-        url: 'https://camillenimbus.com/.well-known/change-password'
+        url: 'https://camillenimbus.com/public/prelogin'
       })
     })
 
@@ -546,7 +586,7 @@ describe('rootCozyUrl', () => {
         status: 503,
         statusText: '',
         type: 'default',
-        url: 'https://camillenimbus.com/.well-known/change-password'
+        url: 'https://camillenimbus.com/public/prelogin'
       })
     })
 
@@ -555,3 +595,431 @@ describe('rootCozyUrl', () => {
     ).rejects.toBeInstanceOf(InvalidCozyUrlError)
   })
 })
+
+describe('fetchRegistrationDetails', () => {
+  beforeAll(() => {
+    enableFetchMocks()
+  })
+
+  beforeEach(() => {
+    fetch.resetMocks()
+  })
+
+  afterAll(() => {
+    disableFetchMocks()
+  })
+
+  it('should handle cozy-hosted https', async () => {
+    mockFetchJsonOnce(
+      'https://camillenimbus.mycozy.cloud/public/prelogin',
+      fakeCozyPrelogin()
+    )
+
+    await expect(
+      fetchRegistrationDetails(new URL('https://camillenimbus.mycozy.cloud'))
+    ).resolves.toStrictEqual({
+      rootUrl: new URL('https://camillenimbus.mycozy.cloud/'),
+      isOIDC: false
+    })
+  })
+
+  it('should handle cozy-hosted https trailing slash', async () => {
+    mockFetchJsonOnce(
+      'https://camillenimbus.mycozy.cloud/public/prelogin',
+      fakeCozyPrelogin()
+    )
+
+    await expect(
+      fetchRegistrationDetails(new URL('https://camillenimbus.mycozy.cloud/'))
+    ).resolves.toStrictEqual({
+      rootUrl: new URL('https://camillenimbus.mycozy.cloud/'),
+      isOIDC: false
+    })
+  })
+
+  it('should handle cozy-hosted https trailing path', async () => {
+    mockFetchJsonOnce(
+      'https://camillenimbus.mycozy.cloud/public/prelogin',
+      fakeCozyPrelogin()
+    )
+
+    await expect(
+      fetchRegistrationDetails(
+        new URL('https://camillenimbus.mycozy.cloud/some-path')
+      )
+    ).resolves.toStrictEqual({
+      rootUrl: new URL('https://camillenimbus.mycozy.cloud/'),
+      isOIDC: false
+    })
+  })
+
+  it('should handle cozy-hosted drive web app url', async () => {
+    mockUnauthorizedOnce(
+      'https://camillenimbus-drive.mycozy.cloud/public/prelogin'
+    )
+    mockFetchJsonOnce(
+      'https://camillenimbus.mycozy.cloud/public/prelogin',
+      fakeCozyPrelogin()
+    )
+
+    await expect(
+      fetchRegistrationDetails(
+        new URL('https://camillenimbus-drive.mycozy.cloud/#/folder')
+      )
+    ).resolves.toStrictEqual({
+      rootUrl: new URL('https://camillenimbus.mycozy.cloud/'),
+      isOIDC: false
+    })
+  })
+
+  it('should handle cozy-hosted photos album url', async () => {
+    mockUnauthorizedOnce(
+      'https://camillenimbus-photos.mycozy.cloud/public/prelogin'
+    )
+    mockFetchJsonOnce(
+      'https://camillenimbus.mycozy.cloud/public/prelogin',
+      fakeCozyPrelogin()
+    )
+
+    await expect(
+      fetchRegistrationDetails(
+        new URL(
+          'https://camillenimbus-photos.mycozy.cloud/#/albums/68b5cda502ae29f5fa73fd89f1be4f92'
+        )
+      )
+    ).resolves.toStrictEqual({
+      rootUrl: new URL('https://camillenimbus.mycozy.cloud/'),
+      isOIDC: false
+    })
+  })
+
+  it('should handle cozy-hosted app name', async () => {
+    mockUnauthorizedOnce(
+      'https://camillenimbus-someslug.mycozy.cloud/public/prelogin'
+    )
+    mockFetchJsonOnce(
+      'https://camillenimbus.mycozy.cloud/public/prelogin',
+      fakeCozyPrelogin()
+    )
+
+    await expect(
+      fetchRegistrationDetails(
+        new URL('https://camillenimbus-someslug.mycozy.cloud')
+      )
+    ).resolves.toStrictEqual({
+      rootUrl: new URL('https://camillenimbus.mycozy.cloud/'),
+      isOIDC: false
+    })
+  })
+
+  it('should handle cozy-hosted special app name', async () => {
+    // XXX: `cozy-stack` redirects requests for deprecated apps (e.g.
+    // `onboarding`) to the Home app (via the login page if the user is not
+    // logged in).
+    mockRedirectOnce(
+      'https://camillenimbus-onboarding.mycozy.cloud/public/prelogin',
+      'https://camillenimbus.mycozy.cloud/auth/login?redirect=https%3A%2F%2Fcamillenimbus-home.mycozy.cloud%2F'
+    )
+    mockFetchJsonOnce(
+      'https://camillenimbus.mycozy.cloud/public/prelogin',
+      fakeCozyPrelogin()
+    )
+
+    await expect(
+      fetchRegistrationDetails(
+        new URL('https://camillenimbus-onboarding.mycozy.cloud')
+      )
+    ).resolves.toStrictEqual({
+      rootUrl: new URL('https://camillenimbus.mycozy.cloud/'),
+      isOIDC: false
+    })
+  })
+
+  it('should handle self-hosted https', async () => {
+    mockFetchJsonOnce(
+      'https://camillenimbus.com/public/prelogin',
+      fakeCozyPrelogin()
+    )
+
+    await expect(
+      fetchRegistrationDetails(new URL('https://camillenimbus.com'))
+    ).resolves.toStrictEqual({
+      rootUrl: new URL('https://camillenimbus.com/'),
+      isOIDC: false
+    })
+  })
+
+  it('should handle self-hosted with dash', async () => {
+    mockFetchJsonOnce(
+      'https://camille-nimbus.com/public/prelogin',
+      fakeCozyPrelogin()
+    )
+
+    await expect(
+      fetchRegistrationDetails(new URL('https://camille-nimbus.com'))
+    ).resolves.toStrictEqual({
+      rootUrl: new URL('https://camille-nimbus.com/'),
+      isOIDC: false
+    })
+  })
+
+  it('should handle self-hosted http', async () => {
+    mockFetchJsonOnce(
+      'http://camille-nimbus.com/public/prelogin',
+      fakeCozyPrelogin()
+    )
+
+    await expect(
+      fetchRegistrationDetails(new URL('http://camille-nimbus.com'))
+    ).resolves.toStrictEqual({
+      rootUrl: new URL('http://camille-nimbus.com/'),
+      isOIDC: false
+    })
+  })
+
+  it('should handle self-hosted https with port', async () => {
+    mockFetchJsonOnce(
+      'https://camillenimbus.com:666/public/prelogin',
+      fakeCozyPrelogin()
+    )
+
+    await expect(
+      fetchRegistrationDetails(new URL('https://camillenimbus.com:666'))
+    ).resolves.toStrictEqual({
+      rootUrl: new URL('https://camillenimbus.com:666/'),
+      isOIDC: false
+    })
+  })
+
+  it('should handle self-hosted nested drive web app url', async () => {
+    mockUnauthorizedOnce('https://drive.camillenimbus.com/public/prelogin')
+    mockFetchJsonOnce(
+      'https://camillenimbus.com/public/prelogin',
+      fakeCozyPrelogin()
+    )
+
+    await expect(
+      fetchRegistrationDetails(
+        new URL('https://drive.camillenimbus.com/#/folder')
+      )
+    ).resolves.toStrictEqual({
+      rootUrl: new URL('https://camillenimbus.com/'),
+      isOIDC: false
+    })
+  })
+
+  it('should handle self-hosted flat drive web app url', async () => {
+    mockUnauthorizedOnce('https://camille-drive.nimbus.com/public/prelogin')
+    mockFetchJsonOnce(
+      'https://camille.nimbus.com/public/prelogin',
+      fakeCozyPrelogin()
+    )
+
+    await expect(
+      fetchRegistrationDetails(
+        new URL('https://camille-drive.nimbus.com/#/folder')
+      )
+    ).resolves.toStrictEqual({
+      rootUrl: new URL('https://camille.nimbus.com/'),
+      isOIDC: false
+    })
+  })
+
+  it('should handle cozy.localhost', async () => {
+    mockFetchJsonOnce(
+      'http://cozy.localhost:8080/public/prelogin',
+      fakeCozyPrelogin()
+    )
+    await expect(
+      fetchRegistrationDetails(new URL('http://cozy.localhost:8080'))
+    ).resolves.toStrictEqual({
+      rootUrl: new URL('http://cozy.localhost:8080/'),
+      isOIDC: false
+    })
+  })
+
+  it('expects an http or https protocol', async () => {
+    mockFetchJsonOnce(
+      'ftp://camillenimbus.com/public/prelogin',
+      fakeCozyPrelogin()
+    )
+
+    await expect(
+      fetchRegistrationDetails(new URL('ftp://camillenimbus.com'))
+    ).rejects.toBeInstanceOf(InvalidProtocolError)
+  })
+
+  it('rejects if URL points to a valid cozy-stack but no valid Cozy instance', async () => {
+    mockNotFoundOnce('https://missing.mycozy.cloud/public/prelogin')
+
+    await expect(
+      fetchRegistrationDetails(new URL('https://missing.mycozy.cloud/'))
+    ).rejects.toBeInstanceOf(InvalidCozyUrlError)
+  })
+
+  it('should reject if Blocked cozy', async () => {
+    mockBlockedCozy('https://camillenimbus.com/public/prelogin')
+
+    await expect(
+      fetchRegistrationDetails(new URL('https://camillenimbus.com'))
+    ).rejects.toBeInstanceOf(BlockedCozyError)
+  })
+
+  it('should reject on 503 error (if not Blocked)', async () => {
+    mock503Error('https://camillenimbus.com/public/prelogin')
+
+    await expect(
+      fetchRegistrationDetails(new URL('https://camillenimbus.com'))
+    ).rejects.toBeInstanceOf(InvalidCozyUrlError)
+  })
+
+  it('should handle OIDC cozy', async () => {
+    mockFetchJsonOnce(
+      'https://camillenimbus.mycozy.cloud/public/prelogin',
+      fakeOidcPrelogin()
+    )
+
+    await expect(
+      fetchRegistrationDetails(new URL('https://camillenimbus.mycozy.cloud'))
+    ).resolves.toStrictEqual({
+      rootUrl: new URL('https://camillenimbus.mycozy.cloud/'),
+      isOIDC: true
+    })
+  })
+
+  it('should reject if non Json response', async () => {
+    mockFetchHtmlOnce(
+      'https://camillenimbus.com/public/prelogin',
+      '<html>Some HTML content</html>'
+    )
+
+    await expect(
+      fetchRegistrationDetails(new URL('https://camillenimbus.com'))
+    ).rejects.toBeInstanceOf(InvalidCozyUrlError)
+  })
+})
+
+const mockFetchHtmlOnce = (url, response) => {
+  fetch.mockOnceIf(url, response, {
+    status: 200,
+    url: url,
+    headers: {
+      'content-type': 'text/html; charset=UTF-8'
+    }
+  })
+}
+
+const mockFetchJsonOnce = (url, response) => {
+  fetch.mockOnceIf(url, response, {
+    status: 200,
+    url: url,
+    headers: {
+      'content-type': 'application/json'
+    }
+  })
+}
+
+const mockRedirectOnce = (url, redirectedUrl) => {
+  fetch.mockOnceIf(
+    url,
+    {},
+    {
+      status: 200,
+      url: redirectedUrl
+    }
+  )
+}
+
+const mockUnauthorizedOnce = url => {
+  fetch.mockOnceIf(
+    url,
+    {},
+    {
+      status: 401,
+      url: url
+    }
+  )
+}
+
+const mockNotFoundOnce = url => {
+  fetch.mockOnceIf(
+    url,
+    {},
+    {
+      status: 404,
+      url: url
+    }
+  )
+}
+
+const mockBlockedCozy = url => {
+  fetch.mockResponse(() => {
+    return Promise.resolve({
+      headers: {
+        'content-type': 'application/json; charset=UTF-8'
+      },
+      body: JSON.stringify([
+        {
+          status: '503',
+          title: 'Blocked',
+          code: 'UNKNOWN',
+          detail: 'The Cozy is blocked for an unknown reason',
+          source: {}
+        }
+      ]),
+      ok: false,
+      status: 503,
+      statusText: '',
+      type: 'default',
+      url: url
+    })
+  })
+}
+
+const mock503Error = url => {
+  fetch.mockResponse(() => {
+    return Promise.resolve({
+      headers: {
+        'content-type': 'application/json; charset=UTF-8'
+      },
+      body: JSON.stringify([
+        {
+          status: '503',
+          title: 'Some error',
+          code: 'UNKNOWN',
+          detail: 'Some error description',
+          source: {}
+        }
+      ]),
+      ok: false,
+      status: 503,
+      statusText: '',
+      type: 'default',
+      url: url
+    })
+  })
+}
+
+const fakeOidcPrelogin = () => {
+  return JSON.stringify({
+    FranceConnect: false,
+    Kdf: 0,
+    KdfIterations: 100000,
+    OIDC: true,
+    locale: 'fr',
+    magic_link: false,
+    name: 'claude'
+  })
+}
+
+const fakeCozyPrelogin = () => {
+  return JSON.stringify({
+    FranceConnect: false,
+    Kdf: 0,
+    KdfIterations: 100000,
+    OIDC: false,
+    locale: 'fr',
+    magic_link: false,
+    name: 'claude'
+  })
+}

package/dist/index.js

@@ -33,6 +33,7 @@ var _exportNames = {
   dehydrate: true,
   generateWebLink: true,
   ensureFirstSlash: true,
+  fetchRegistrationDetails: true,
   rootCozyUrl: true,
   InvalidRedirectLinkError: true,
   InvalidCozyUrlError: true,
@@ -219,6 +220,12 @@ Object.defineProperty(exports, "ensureFirstSlash", {
     return _helpers2.ensureFirstSlash;
   }
 });
+Object.defineProperty(exports, "fetchRegistrationDetails", {
+  enumerable: true,
+  get: function get() {
+    return _helpers2.fetchRegistrationDetails;
+  }
+});
 Object.defineProperty(exports, "rootCozyUrl", {
   enumerable: true,
   get: function get() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cozy-client",
-  "version": "58.2.0",
+  "version": "58.3.0",
   "license": "MIT",
   "main": "dist/index.node.js",
   "browser": "dist/index.js",
@@ -74,5 +74,5 @@
     "react-native-ios11-devicecheck": "^0.0.3"
   },
   "sideEffects": false,
-  "gitHead": "3a6e5104325605d3d9c74ae5a1738e16289b659d"
+  "gitHead": "648e72735558114a377f9d3afc2b549bdb6de463"
 }

package/types/helpers/index.d.ts

@@ -1,3 +1,3 @@
 export { dehydrate } from "./dehydrateHelper";
-export { deconstructCozyWebLinkWithSlug, deconstructRedirectLink, generateWebLink, ensureFirstSlash, rootCozyUrl, InvalidRedirectLinkError, InvalidCozyUrlError, InvalidProtocolError, BlockedCozyError } from "./urlHelper";
+export { deconstructCozyWebLinkWithSlug, deconstructRedirectLink, generateWebLink, ensureFirstSlash, fetchRegistrationDetails, rootCozyUrl, InvalidRedirectLinkError, InvalidCozyUrlError, InvalidProtocolError, BlockedCozyError } from "./urlHelper";
 export { editSettings, getQuery, getSettings, normalizeSettings, saveAfterFetchSettings } from "./settings";

package/types/helpers/urlHelper.d.ts

@@ -26,3 +26,14 @@ export class InvalidCozyUrlError extends Error {
     url: any;
 }
 export function rootCozyUrl(url: URL): Promise<URL>;
+export function fetchRegistrationDetails(url: URL): Promise<RegistrationDetails>;
+export type RegistrationDetails = {
+    /**
+     * - The Cozy's root URL
+     */
+    rootUrl: URL;
+    /**
+     * - True if the Cozy's uses OIDC for login
+     */
+    isOIDC: boolean;
+};

package/types/index.d.ts

@@ -22,7 +22,7 @@ export { manifest, models };
 export { QueryDefinition, Q, Mutations, MutationTypes, getDoctypeFromOperation } from "./queries/dsl";
 export { Association, HasMany, HasOne, HasOneInPlace, HasManyInPlace, HasManyTriggers } from "./associations";
 export { isReferencedBy, isReferencedById, getReferencedBy, getReferencedById } from "./associations/helpers";
-export { deconstructCozyWebLinkWithSlug, deconstructRedirectLink, dehydrate, generateWebLink, ensureFirstSlash, rootCozyUrl, InvalidRedirectLinkError, InvalidCozyUrlError, InvalidProtocolError, BlockedCozyError } from "./helpers";
+export { deconstructCozyWebLinkWithSlug, deconstructRedirectLink, dehydrate, generateWebLink, ensureFirstSlash, fetchRegistrationDetails, rootCozyUrl, InvalidRedirectLinkError, InvalidCozyUrlError, InvalidProtocolError, BlockedCozyError } from "./helpers";
 export { cancelable, isQueryLoading, hasQueryBeenLoaded, isQueriesLoading, hasQueriesBeenLoaded } from "./utils";
 export { getQueryFromState, dispatchCreate, dispatchUpdate, dispatchDelete } from "./store";
 export { queryConnect, queryConnectFlat, withClient } from "./hoc";