docpouch-client 1.1.4 → 1.2.0

package/coverage/lcov-report/index.html

@@ -23,30 +23,30 @@
         <div class='clearfix'>
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">63.89% </span>
+                <span class="strong">56.74% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>446/698</span>
+                <span class='fraction'>446/786</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">48.54% </span>
+                <span class="strong">42.16% </span>
                 <span class="quiet">Branches</span>
-                <span class='fraction'>234/482</span>
+                <span class='fraction'>234/555</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">80.53% </span>
+                <span class="strong">74.59% </span>
                 <span class="quiet">Functions</span>
-                <span class='fraction'>91/113</span>
+                <span class='fraction'>91/122</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">67.08% </span>
+                <span class="strong">59.25% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>432/644</span>
+                <span class='fraction'>432/729</span>
             </div>
         
             
@@ -79,18 +79,18 @@
 </tr>
 </thead>
 <tbody><tr>
-	<td class="file medium" data-value="src"><a href="src/index.html">src</a></td>
-	<td data-value="53.17" class="pic medium">
-	<div class="chart"><div class="cover-fill" style="width: 53%"></div><div class="cover-empty" style="width: 47%"></div></div>
+	<td class="file low" data-value="src"><a href="src/index.html">src</a></td>
+	<td data-value="43.13" class="pic low">
+	<div class="chart"><div class="cover-fill" style="width: 43%"></div><div class="cover-empty" style="width: 57%"></div></div>
 	</td>
-	<td data-value="53.17" class="pct medium">53.17%</td>
-	<td data-value="378" class="abs medium">201/378</td>
-	<td data-value="42.9" class="pct low">42.9%</td>
-	<td data-value="275" class="abs low">118/275</td>
-	<td data-value="76.19" class="pct medium">76.19%</td>
-	<td data-value="63" class="abs medium">48/63</td>
-	<td data-value="53.59" class="pct medium">53.59%</td>
-	<td data-value="362" class="abs medium">194/362</td>
+	<td data-value="43.13" class="pct low">43.13%</td>
+	<td data-value="466" class="abs low">201/466</td>
+	<td data-value="33.9" class="pct low">33.9%</td>
+	<td data-value="348" class="abs low">118/348</td>
+	<td data-value="66.66" class="pct medium">66.66%</td>
+	<td data-value="72" class="abs medium">48/72</td>
+	<td data-value="43.4" class="pct low">43.4%</td>
+	<td data-value="447" class="abs low">194/447</td>
 	</tr>
 
 <tr>
@@ -116,7 +116,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-06-08T21:00:52.221Z
+                at 2026-07-05T08:03:42.223Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov.info

@@ -36,34 +36,43 @@ FN:702,(anonymous_32)
 FN:709,(anonymous_33)
 FN:716,(anonymous_34)
 FN:726,(anonymous_35)
-FN:807,(anonymous_36)
-FN:818,(anonymous_37)
-FN:830,(anonymous_38)
-FN:841,(anonymous_39)
-FN:850,(anonymous_40)
-FN:852,(anonymous_41)
-FN:857,(anonymous_42)
-FN:862,(anonymous_43)
-FN:867,(anonymous_44)
-FN:878,(anonymous_45)
-FN:912,(anonymous_46)
-FN:926,(anonymous_47)
-FN:956,(anonymous_48)
-FN:962,(anonymous_49)
-FN:1004,(anonymous_50)
-FN:1009,(anonymous_51)
-FN:1018,(anonymous_52)
-FN:1029,(anonymous_53)
-FN:1041,(anonymous_54)
-FN:1047,(anonymous_55)
-FN:1078,(anonymous_56)
-FN:1082,(anonymous_57)
-FN:1085,(anonymous_58)
-FN:1095,(anonymous_59)
-FN:1098,(anonymous_60)
-FN:1106,(anonymous_61)
-FN:1113,(anonymous_62)
-FNF:63
+FN:812,(anonymous_36)
+FN:823,(anonymous_37)
+FN:835,(anonymous_38)
+FN:846,(anonymous_39)
+FN:855,(anonymous_40)
+FN:857,(anonymous_41)
+FN:862,(anonymous_42)
+FN:867,(anonymous_43)
+FN:872,(anonymous_44)
+FN:883,(anonymous_45)
+FN:917,(anonymous_46)
+FN:931,(anonymous_47)
+FN:961,(anonymous_48)
+FN:967,(anonymous_49)
+FN:1009,(anonymous_50)
+FN:1014,(anonymous_51)
+FN:1023,(anonymous_52)
+FN:1034,(anonymous_53)
+FN:1046,(anonymous_54)
+FN:1052,(anonymous_55)
+FN:1083,(anonymous_56)
+FN:1087,(anonymous_57)
+FN:1090,(anonymous_58)
+FN:1100,(anonymous_59)
+FN:1103,(anonymous_60)
+FN:1111,(anonymous_61)
+FN:1118,(anonymous_62)
+FN:1140,(anonymous_63)
+FN:1162,(anonymous_64)
+FN:1195,(anonymous_65)
+FN:1254,(anonymous_66)
+FN:1309,(anonymous_67)
+FN:1325,(anonymous_68)
+FN:1337,(anonymous_69)
+FN:1361,(anonymous_70)
+FN:1396,(anonymous_71)
+FNF:72
 FNH:48
 FNDA:69,(anonymous_0)
 FNDA:7,(anonymous_1)
@@ -128,6 +137,15 @@ FNDA:3,(anonymous_59)
 FNDA:96,(anonymous_60)
 FNDA:0,(anonymous_61)
 FNDA:2,(anonymous_62)
+FNDA:0,(anonymous_63)
+FNDA:0,(anonymous_64)
+FNDA:0,(anonymous_65)
+FNDA:0,(anonymous_66)
+FNDA:0,(anonymous_67)
+FNDA:0,(anonymous_68)
+FNDA:0,(anonymous_69)
+FNDA:0,(anonymous_70)
+FNDA:0,(anonymous_71)
 DA:45,69
 DA:52,69
 DA:53,69
@@ -345,57 +363,56 @@ DA:717,1
 DA:728,0
 DA:732,0
 DA:733,0
-DA:737,0
 DA:738,0
-DA:741,0
+DA:739,0
+DA:742,0
 DA:743,0
-DA:744,0
 DA:746,0
-DA:750,0
-DA:752,0
-DA:753,0
-DA:756,0
+DA:748,0
+DA:749,0
+DA:751,0
+DA:755,0
 DA:757,0
 DA:758,0
-DA:759,0
-DA:760,0
-DA:766,0
-DA:769,0
-DA:770,0
-DA:772,0
-DA:773,0
-DA:776,0
+DA:761,0
+DA:762,0
+DA:763,0
+DA:764,0
+DA:765,0
+DA:771,0
+DA:774,0
+DA:775,0
 DA:777,0
 DA:778,0
-DA:779,0
-DA:780,0
+DA:781,0
+DA:782,0
+DA:783,0
 DA:784,0
 DA:785,0
-DA:787,0
+DA:789,0
+DA:790,0
 DA:792,0
-DA:793,0
-DA:795,0
-DA:808,10
-DA:819,3
-DA:831,1
-DA:842,2
-DA:852,69
-DA:853,0
-DA:854,0
+DA:797,0
+DA:798,0
+DA:800,0
+DA:813,10
+DA:824,3
+DA:836,1
+DA:847,2
 DA:857,69
-DA:858,5
-DA:859,5
+DA:858,0
+DA:859,0
 DA:862,69
 DA:863,5
 DA:864,5
 DA:867,69
-DA:868,0
-DA:869,0
-DA:879,5
-DA:880,5
+DA:868,5
+DA:869,5
+DA:872,69
+DA:873,0
+DA:874,0
+DA:884,5
 DA:885,5
-DA:886,0
-DA:887,0
 DA:890,5
 DA:891,0
 DA:892,0
@@ -403,94 +420,180 @@ DA:895,5
 DA:896,0
 DA:897,0
 DA:900,5
-DA:902,5
-DA:903,5
-DA:906,5
-DA:909,5
-DA:912,5
-DA:913,2
-DA:914,1
-DA:915,1
-DA:916,1
-DA:917,1
-DA:922,5
-DA:923,5
-DA:926,5
-DA:927,0
-DA:928,0
-DA:929,0
+DA:901,0
+DA:902,0
+DA:905,5
+DA:907,5
+DA:908,5
+DA:911,5
+DA:914,5
+DA:917,5
+DA:918,2
+DA:919,1
+DA:920,1
+DA:921,1
+DA:922,1
+DA:927,5
+DA:928,5
+DA:931,5
 DA:932,0
 DA:933,0
 DA:934,0
-DA:935,0
+DA:937,0
+DA:938,0
+DA:939,0
 DA:940,0
-DA:941,0
-DA:957,99
-DA:961,99
-DA:962,0
-DA:965,99
-DA:966,59
-DA:967,99
-DA:968,0
+DA:945,0
+DA:946,0
+DA:962,99
+DA:966,99
+DA:967,0
 DA:970,99
-DA:976,99
-DA:977,99
-DA:983,99
-DA:984,99
-DA:987,99
+DA:971,59
+DA:972,99
+DA:973,0
+DA:975,99
+DA:981,99
+DA:982,99
 DA:988,99
-DA:990,98
-DA:991,14
-DA:992,7
-DA:994,14
-DA:997,84
-DA:999,83
-DA:1005,1
-DA:1006,1
+DA:989,99
+DA:992,99
+DA:993,99
+DA:995,98
+DA:996,14
+DA:997,7
+DA:999,14
+DA:1002,84
+DA:1004,83
 DA:1010,1
 DA:1011,1
-DA:1012,1
-DA:1013,1
-DA:1014,1
 DA:1015,1
-DA:1019,2
-DA:1020,2
-DA:1021,2
-DA:1022,2
-DA:1023,2
+DA:1016,1
+DA:1017,1
+DA:1018,1
+DA:1019,1
+DA:1020,1
 DA:1024,2
 DA:1025,2
 DA:1026,2
-DA:1030,1
-DA:1031,0
-DA:1037,0
-DA:1042,2
-DA:1043,0
+DA:1027,2
+DA:1028,2
+DA:1029,2
+DA:1030,2
+DA:1031,2
+DA:1035,1
+DA:1036,0
+DA:1042,0
+DA:1047,2
 DA:1048,0
-DA:1049,0
-DA:1050,0
-DA:1056,0
-DA:1062,0
-DA:1063,0
-DA:1064,0
-DA:1066,0
+DA:1053,0
+DA:1054,0
+DA:1055,0
+DA:1061,0
 DA:1067,0
-DA:1075,0
-DA:1079,3
-DA:1080,3
-DA:1081,3
-DA:1082,192
+DA:1068,0
+DA:1069,0
+DA:1071,0
+DA:1072,0
+DA:1080,0
+DA:1084,3
+DA:1085,3
 DA:1086,3
-DA:1087,3
-DA:1088,3
-DA:1089,3
-DA:1096,3
-DA:1097,3
-DA:1098,96
-DA:1107,0
-DA:1114,2
-DA:1115,0
-LF:362
+DA:1087,192
+DA:1091,3
+DA:1092,3
+DA:1093,3
+DA:1094,3
+DA:1101,3
+DA:1102,3
+DA:1103,96
+DA:1112,0
+DA:1119,2
+DA:1120,0
+DA:1141,0
+DA:1142,0
+DA:1143,0
+DA:1146,0
+DA:1147,0
+DA:1148,0
+DA:1150,0
+DA:1163,0
+DA:1164,0
+DA:1166,0
+DA:1199,0
+DA:1200,0
+DA:1202,0
+DA:1206,0
+DA:1210,0
+DA:1220,0
+DA:1221,0
+DA:1222,0
+DA:1223,0
+DA:1229,0
+DA:1230,0
+DA:1231,0
+DA:1233,0
+DA:1234,0
+DA:1236,0
+DA:1256,0
+DA:1257,0
+DA:1258,0
+DA:1259,0
+DA:1260,0
+DA:1261,0
+DA:1265,0
+DA:1266,0
+DA:1267,0
+DA:1268,0
+DA:1269,0
+DA:1270,0
+DA:1271,0
+DA:1275,0
+DA:1279,0
+DA:1280,0
+DA:1281,0
+DA:1282,0
+DA:1283,0
+DA:1288,0
+DA:1289,0
+DA:1290,0
+DA:1291,0
+DA:1292,0
+DA:1293,0
+DA:1297,0
+DA:1310,0
+DA:1311,0
+DA:1312,0
+DA:1313,0
+DA:1314,0
+DA:1316,0
+DA:1326,0
+DA:1327,0
+DA:1338,0
+DA:1339,0
+DA:1340,0
+DA:1341,0
+DA:1342,0
+DA:1343,0
+DA:1344,0
+DA:1345,0
+DA:1362,0
+DA:1363,0
+DA:1364,0
+DA:1366,0
+DA:1367,0
+DA:1370,0
+DA:1373,0
+DA:1374,0
+DA:1382,0
+DA:1383,0
+DA:1385,0
+DA:1386,0
+DA:1397,0
+DA:1398,0
+DA:1399,0
+DA:1402,0
+LF:447
 LH:194
 BRDA:89,0,0,64
 BRDA:92,1,0,69
@@ -668,106 +771,179 @@ BRDA:728,81,0,0
 BRDA:728,81,1,0
 BRDA:732,82,0,0
 BRDA:732,82,1,0
-BRDA:741,83,0,0
-BRDA:741,83,1,0
+BRDA:739,83,0,0
+BRDA:739,83,1,0
 BRDA:743,84,0,0
 BRDA:743,84,1,0
-BRDA:743,85,0,0
-BRDA:743,85,1,0
-BRDA:750,86,0,0
-BRDA:750,86,1,0
-BRDA:750,87,0,0
-BRDA:750,87,1,0
-BRDA:752,88,0,0
-BRDA:752,88,1,0
-BRDA:752,89,0,0
-BRDA:752,89,1,0
-BRDA:759,90,0,0
-BRDA:759,90,1,0
-BRDA:766,91,0,0
-BRDA:766,91,1,0
-BRDA:770,92,0,0
-BRDA:770,92,1,0
-BRDA:772,93,0,0
-BRDA:772,93,1,0
-BRDA:772,94,0,0
-BRDA:772,94,1,0
-BRDA:779,95,0,0
-BRDA:779,95,1,0
-BRDA:784,96,0,0
-BRDA:784,96,1,0
-BRDA:784,97,0,0
-BRDA:784,97,1,0
-BRDA:792,98,0,0
-BRDA:792,98,1,0
-BRDA:792,99,0,0
-BRDA:792,99,1,0
-BRDA:879,100,0,0
-BRDA:879,100,1,5
-BRDA:885,101,0,0
-BRDA:885,101,1,5
-BRDA:890,102,0,0
-BRDA:890,102,1,5
-BRDA:895,103,0,0
-BRDA:895,103,1,5
-BRDA:913,104,0,1
-BRDA:913,104,1,1
-BRDA:916,105,0,1
-BRDA:916,105,1,0
-BRDA:927,106,0,0
-BRDA:927,106,1,0
-BRDA:932,107,0,0
-BRDA:932,107,1,0
-BRDA:956,108,0,45
-BRDA:961,109,0,99
-BRDA:961,109,1,84
-BRDA:961,110,0,0
-BRDA:961,110,1,84
-BRDA:965,111,0,59
-BRDA:965,111,1,40
-BRDA:965,112,0,99
-BRDA:965,112,1,61
-BRDA:967,113,0,0
-BRDA:967,113,1,99
-BRDA:973,114,0,71
-BRDA:973,114,1,28
-BRDA:976,115,0,99
-BRDA:976,115,1,0
-BRDA:977,116,0,1
-BRDA:977,116,1,98
-BRDA:984,117,0,2
-BRDA:984,117,1,97
-BRDA:984,118,0,99
-BRDA:984,118,1,2
-BRDA:990,119,0,14
-BRDA:990,119,1,84
-BRDA:991,120,0,7
-BRDA:991,120,1,7
-BRDA:991,121,0,14
-BRDA:991,121,1,7
-BRDA:997,122,0,1
-BRDA:997,122,1,83
-BRDA:1012,123,0,1
-BRDA:1012,123,1,0
-BRDA:1013,124,0,1
-BRDA:1013,124,1,0
-BRDA:1025,125,0,0
-BRDA:1025,125,1,2
-BRDA:1030,126,0,0
-BRDA:1030,126,1,1
-BRDA:1030,127,0,1
-BRDA:1030,127,1,1
-BRDA:1042,128,0,0
-BRDA:1042,128,1,2
-BRDA:1042,129,0,2
-BRDA:1042,129,1,2
-BRDA:1048,130,0,0
-BRDA:1048,130,1,0
-BRDA:1062,131,0,0
-BRDA:1062,131,1,0
-BRDA:1114,132,0,0
-BRDA:1114,132,1,2
-BRF:275
+BRDA:746,85,0,0
+BRDA:746,85,1,0
+BRDA:748,86,0,0
+BRDA:748,86,1,0
+BRDA:748,87,0,0
+BRDA:748,87,1,0
+BRDA:755,88,0,0
+BRDA:755,88,1,0
+BRDA:755,89,0,0
+BRDA:755,89,1,0
+BRDA:757,90,0,0
+BRDA:757,90,1,0
+BRDA:757,91,0,0
+BRDA:757,91,1,0
+BRDA:764,92,0,0
+BRDA:764,92,1,0
+BRDA:771,93,0,0
+BRDA:771,93,1,0
+BRDA:774,94,0,0
+BRDA:774,94,1,0
+BRDA:775,95,0,0
+BRDA:775,95,1,0
+BRDA:777,96,0,0
+BRDA:777,96,1,0
+BRDA:777,97,0,0
+BRDA:777,97,1,0
+BRDA:784,98,0,0
+BRDA:784,98,1,0
+BRDA:789,99,0,0
+BRDA:789,99,1,0
+BRDA:789,100,0,0
+BRDA:789,100,1,0
+BRDA:797,101,0,0
+BRDA:797,101,1,0
+BRDA:797,102,0,0
+BRDA:797,102,1,0
+BRDA:884,103,0,0
+BRDA:884,103,1,5
+BRDA:890,104,0,0
+BRDA:890,104,1,5
+BRDA:895,105,0,0
+BRDA:895,105,1,5
+BRDA:900,106,0,0
+BRDA:900,106,1,5
+BRDA:918,107,0,1
+BRDA:918,107,1,1
+BRDA:921,108,0,1
+BRDA:921,108,1,0
+BRDA:932,109,0,0
+BRDA:932,109,1,0
+BRDA:937,110,0,0
+BRDA:937,110,1,0
+BRDA:961,111,0,45
+BRDA:966,112,0,99
+BRDA:966,112,1,84
+BRDA:966,113,0,0
+BRDA:966,113,1,84
+BRDA:970,114,0,59
+BRDA:970,114,1,40
+BRDA:970,115,0,99
+BRDA:970,115,1,61
+BRDA:972,116,0,0
+BRDA:972,116,1,99
+BRDA:978,117,0,71
+BRDA:978,117,1,28
+BRDA:981,118,0,99
+BRDA:981,118,1,0
+BRDA:982,119,0,1
+BRDA:982,119,1,98
+BRDA:989,120,0,2
+BRDA:989,120,1,97
+BRDA:989,121,0,99
+BRDA:989,121,1,2
+BRDA:995,122,0,14
+BRDA:995,122,1,84
+BRDA:996,123,0,7
+BRDA:996,123,1,7
+BRDA:996,124,0,14
+BRDA:996,124,1,7
+BRDA:1002,125,0,1
+BRDA:1002,125,1,83
+BRDA:1017,126,0,1
+BRDA:1017,126,1,0
+BRDA:1018,127,0,1
+BRDA:1018,127,1,0
+BRDA:1030,128,0,0
+BRDA:1030,128,1,2
+BRDA:1035,129,0,0
+BRDA:1035,129,1,1
+BRDA:1035,130,0,1
+BRDA:1035,130,1,1
+BRDA:1047,131,0,0
+BRDA:1047,131,1,2
+BRDA:1047,132,0,2
+BRDA:1047,132,1,2
+BRDA:1053,133,0,0
+BRDA:1053,133,1,0
+BRDA:1067,134,0,0
+BRDA:1067,134,1,0
+BRDA:1119,135,0,0
+BRDA:1119,135,1,2
+BRDA:1143,136,0,0
+BRDA:1143,136,1,0
+BRDA:1146,137,0,0
+BRDA:1146,137,1,0
+BRDA:1147,138,0,0
+BRDA:1147,138,1,0
+BRDA:1199,139,0,0
+BRDA:1199,139,1,0
+BRDA:1202,140,0,0
+BRDA:1202,140,1,0
+BRDA:1202,141,0,0
+BRDA:1202,141,1,0
+BRDA:1206,142,0,0
+BRDA:1206,142,1,0
+BRDA:1220,143,0,0
+BRDA:1220,143,1,0
+BRDA:1230,144,0,0
+BRDA:1230,144,1,0
+BRDA:1230,145,0,0
+BRDA:1230,145,1,0
+BRDA:1233,146,0,0
+BRDA:1233,146,1,0
+BRDA:1233,147,0,0
+BRDA:1233,147,1,0
+BRDA:1233,147,2,0
+BRDA:1256,148,0,0
+BRDA:1256,148,1,0
+BRDA:1267,149,0,0
+BRDA:1267,149,1,0
+BRDA:1269,150,0,0
+BRDA:1269,150,1,0
+BRDA:1279,151,0,0
+BRDA:1279,151,1,0
+BRDA:1281,152,0,0
+BRDA:1281,152,1,0
+BRDA:1288,153,0,0
+BRDA:1288,153,1,0
+BRDA:1288,154,0,0
+BRDA:1288,154,1,0
+BRDA:1290,155,0,0
+BRDA:1290,155,1,0
+BRDA:1313,156,0,0
+BRDA:1313,156,1,0
+BRDA:1326,157,0,0
+BRDA:1326,157,1,0
+BRDA:1326,158,0,0
+BRDA:1326,158,1,0
+BRDA:1338,159,0,0
+BRDA:1338,159,1,0
+BRDA:1338,160,0,0
+BRDA:1338,160,1,0
+BRDA:1363,161,0,0
+BRDA:1363,161,1,0
+BRDA:1366,162,0,0
+BRDA:1366,162,1,0
+BRDA:1366,163,0,0
+BRDA:1366,163,1,0
+BRDA:1367,164,0,0
+BRDA:1367,164,1,0
+BRDA:1382,165,0,0
+BRDA:1382,165,1,0
+BRDA:1397,166,0,0
+BRDA:1397,166,1,0
+BRDA:1399,167,0,0
+BRDA:1399,167,1,0
+BRDA:1399,168,0,0
+BRDA:1399,168,1,0
+BRF:348
 BRH:118
 end_of_record
 TN:

package/dist/index.d.ts

@@ -364,6 +364,120 @@ export default class docPouchClient {
      * Emit an event
      */
     private emit;
+    /**
+     * Fetches the OIDC client configuration from the server's
+     * `/api/oidc-client-config` endpoint. This is the first step in any
+     * OIDC flow: call this method to discover whether OIDC is configured
+     * and, if so, obtain the issuer, clientId, redirectUri, etc.
+     *
+     * The returned object matches the {@link I_OidcClientConfig} shape which
+     * can be passed directly to {@link setOidcConfig} or
+     * {@link loginWithOidc}.
+     *
+     * @returns {Promise<I_OidcClientConfig | null>} The client config if
+     *   OIDC is configured, or null if the server reports OIDC is not
+     *   available.
+     */
+    fetchOidcClientConfig(): Promise<I_OidcClientConfig | null>;
+    /**
+     * Fetches the currently authenticated user's profile from the
+     * `/users/whoami` endpoint. Works with both JWT and OIDC
+     * authentication — the correct token is sent automatically.
+     *
+     * @returns {Promise<I_UserEntry | null>} The user profile, or null
+     *   if the request fails or the user is not authenticated.
+     */
+    getCurrentUser(): Promise<I_UserEntry | null>;
+    /**
+     * Ensures an OIDC client is registered with the DocPouch server
+     * (dynamic client registration). If a `clientId` is found in
+     * localStorage under `docpouch_oidc_client_id`, it attempts to
+     * update the existing registration. If that fails (or no stored ID
+     * exists), a new client is registered via
+     * {@link registerOidcClient}.
+     *
+     * This method manages the `docpouch_oidc_client_id` localStorage
+     * key automatically. Call it before {@link loginWithOidc} when
+     * acting as a third-party relying party (i.e. not the built-in
+     * admin UI).
+     *
+     * @param {string} redirectUri - The URI the IdP should redirect to
+     *   after login.
+     * @param {string} [registrationToken] - Initial access token for
+     *   the `/oidc/reg` endpoint. If omitted the current auth token is
+     *   used.
+     * @param {object} [options] - Additional options.
+     * @param {string} [options.clientName] - Display name for the
+     *   client registration (default `'DocPouch Client'`).
+     * @param {string} [options.postLogoutRedirectUri] - If provided,
+     *   also registers this URI as a post-logout redirect.
+     * @returns {Promise<string>} The resolved clientId.
+     */
+    ensureOidcClient(redirectUri: string, registrationToken?: string, options?: {
+        clientName?: string;
+        postLogoutRedirectUri?: string;
+    }): Promise<string>;
+    /**
+     * Attempts to restore an existing authentication session (JWT or
+     * OIDC) from browser storage. This is the recommended entry point
+     * on page load:
+     *
+     * 1. If an OIDC logout redirect was just completed, clears local
+     *    state and returns `{method: 'none'}`.
+     * 2. If the URL contains `code` and `state` params, exchanges them
+     *    for OIDC tokens via {@link handleOidcCallback}.
+     * 3. If a persisted OIDC session exists, restores it.
+     * 4. Falls back to a JWT token in localStorage.
+     *
+     * @returns {Promise<I_AuthState>} The authentication state after
+     *   attempting restoration.
+     */
+    initAuth(): Promise<I_AuthState>;
+    /**
+     * Clears all local authentication state — JWT token, OIDC tokens,
+     * persisted sessions, and localStorage keys managed by this library.
+     * Disconnects the WebSocket if connected.
+     *
+     * This does NOT redirect to an OIDC end-session endpoint. For a
+     * full RP-initiated logout use {@link logout} or
+     * {@link logoutOidc}.
+     */
+    clearAuth(): void;
+    /**
+     * Persists the current authentication method to localStorage so it
+     * can be restored after a page reload.
+     *
+     * @param {'jwt' | 'oidc'} method - The auth method to persist.
+     */
+    persistAuthMethod(method: 'jwt' | 'oidc'): void;
+    /**
+     * Removes all localStorage keys managed by docpouch-client:
+     * `authToken`, `authMethod`, `docpouch_oidc_session`,
+     * `docpouch_oidc_client_id`, `docpouch_registration_token`,
+     * `isAdmin`, and `postLogoutRedirectUri`.
+     */
+    clearPersistedAuthState(): void;
+    /**
+     * Convenience method to fetch the OIDC client config from the server
+     * and immediately initiate the OIDC login redirect. This combines
+     * {@link fetchOidcClientConfig} and {@link loginWithOidc} into a
+     * single call.
+     *
+     * @param {string} [registrationToken] - Optional initial access
+     *   token for dynamic client registration. If provided and no
+     *   client config is available from the server, the method attempts
+     *   dynamic registration via {@link ensureOidcClient}.
+     * @returns {Promise<void>}
+     */
+    startOidcLogin(registrationToken?: string): Promise<void>;
+    /**
+     * Derives the OIDC issuer URL from the client's baseUrl. By
+     * convention the DocPouch OIDC provider is mounted at
+     * `${baseUrl}/oidc`.
+     *
+     * @returns {string} The issuer URL.
+     */
+    getOidcIssuer(): string;
 }
 export interface I_UserEntry extends I_UserCreation {
     _id: string;
@@ -416,6 +530,10 @@ export interface I_OidcConfig {
     clientSecret?: string;
     postLogoutRedirectUri?: string;
 }
+export interface I_OidcClientConfig extends I_OidcConfig {
+    configured?: boolean;
+    apiBaseUrl?: string;
+}
 export interface I_OidcTokenResponse {
     accessToken: string;
     refreshToken?: string;

package/dist/index.js

@@ -970,4 +970,270 @@ export default class docPouchClient {
             this.events[event]();
         }
     }
+    // Convenience OIDC methods
+    /**
+     * Fetches the OIDC client configuration from the server's
+     * `/api/oidc-client-config` endpoint. This is the first step in any
+     * OIDC flow: call this method to discover whether OIDC is configured
+     * and, if so, obtain the issuer, clientId, redirectUri, etc.
+     *
+     * The returned object matches the {@link I_OidcClientConfig} shape which
+     * can be passed directly to {@link setOidcConfig} or
+     * {@link loginWithOidc}.
+     *
+     * @returns {Promise<I_OidcClientConfig | null>} The client config if
+     *   OIDC is configured, or null if the server reports OIDC is not
+     *   available.
+     */
+    async fetchOidcClientConfig() {
+        try {
+            const data = await this.request('/api/oidc-client-config', 'GET', undefined, false);
+            if (!data)
+                return null;
+            // The server may or may not include `configured`. If it has an
+            // `issuer` field we consider it valid regardless.
+            if (data.configured === false)
+                return null;
+            if (!data.issuer)
+                return null;
+            return data;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Fetches the currently authenticated user's profile from the
+     * `/users/whoami` endpoint. Works with both JWT and OIDC
+     * authentication — the correct token is sent automatically.
+     *
+     * @returns {Promise<I_UserEntry | null>} The user profile, or null
+     *   if the request fails or the user is not authenticated.
+     */
+    async getCurrentUser() {
+        try {
+            return await this.request('/users/whoami', 'GET');
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Ensures an OIDC client is registered with the DocPouch server
+     * (dynamic client registration). If a `clientId` is found in
+     * localStorage under `docpouch_oidc_client_id`, it attempts to
+     * update the existing registration. If that fails (or no stored ID
+     * exists), a new client is registered via
+     * {@link registerOidcClient}.
+     *
+     * This method manages the `docpouch_oidc_client_id` localStorage
+     * key automatically. Call it before {@link loginWithOidc} when
+     * acting as a third-party relying party (i.e. not the built-in
+     * admin UI).
+     *
+     * @param {string} redirectUri - The URI the IdP should redirect to
+     *   after login.
+     * @param {string} [registrationToken] - Initial access token for
+     *   the `/oidc/reg` endpoint. If omitted the current auth token is
+     *   used.
+     * @param {object} [options] - Additional options.
+     * @param {string} [options.clientName] - Display name for the
+     *   client registration (default `'DocPouch Client'`).
+     * @param {string} [options.postLogoutRedirectUri] - If provided,
+     *   also registers this URI as a post-logout redirect.
+     * @returns {Promise<string>} The resolved clientId.
+     */
+    async ensureOidcClient(redirectUri, registrationToken, options) {
+        const clientName = options?.clientName || 'DocPouch Client';
+        const postLogoutRedirectUri = options?.postLogoutRedirectUri;
+        const storedClientId = typeof window !== 'undefined' && window.localStorage
+            ? localStorage.getItem('docpouch_oidc_client_id')
+            : null;
+        const postLogoutUris = postLogoutRedirectUri
+            ? [redirectUri, postLogoutRedirectUri]
+            : [redirectUri];
+        const payload = {
+            client_name: clientName,
+            redirect_uris: [redirectUri],
+            post_logout_redirect_uris: postLogoutUris,
+            grant_types: ['authorization_code', 'refresh_token'],
+            response_types: ['code'],
+            token_endpoint_auth_method: 'none',
+            application_type: 'web',
+        };
+        if (storedClientId) {
+            try {
+                await this.updateOidcClient(storedClientId, payload, registrationToken);
+                return storedClientId;
+            }
+            catch {
+                // Update failed, will re-register below
+            }
+        }
+        const response = await this.registerOidcClient(payload, registrationToken);
+        if (typeof window !== 'undefined' && window.localStorage) {
+            localStorage.setItem('docpouch_oidc_client_id', response.client_id);
+        }
+        if (response.registration_access_token && typeof window !== 'undefined' && window.localStorage) {
+            localStorage.setItem('docpouch_registration_token', response.registration_access_token);
+        }
+        return response.client_id;
+    }
+    /**
+     * Attempts to restore an existing authentication session (JWT or
+     * OIDC) from browser storage. This is the recommended entry point
+     * on page load:
+     *
+     * 1. If an OIDC logout redirect was just completed, clears local
+     *    state and returns `{method: 'none'}`.
+     * 2. If the URL contains `code` and `state` params, exchanges them
+     *    for OIDC tokens via {@link handleOidcCallback}.
+     * 3. If a persisted OIDC session exists, restores it.
+     * 4. Falls back to a JWT token in localStorage.
+     *
+     * @returns {Promise<I_AuthState>} The authentication state after
+     *   attempting restoration.
+     */
+    async initAuth() {
+        // 1. Check for logout redirect
+        if (this.wasJustLoggedOut()) {
+            this.authToken = null;
+            this.clearOidcTokens();
+            this.authMethod = 'none';
+            this.clearPersistedAuthState();
+            return { method: 'none', token: null, isAdmin: false, userName: '' };
+        }
+        // 2. Try OIDC callback (code/state in URL)
+        try {
+            const handled = await this.handleOidcCallback();
+            if (handled) {
+                const token = this.getToken();
+                if (token) {
+                    this.persistAuthMethod('oidc');
+                    return { method: 'oidc', token, isAdmin: false, userName: '' };
+                }
+            }
+        }
+        catch (e) {
+            console.error('OIDC callback error:', e);
+        }
+        // 3. Try OIDC session restore
+        if (this.restoreOidcSession()) {
+            const token = this.getToken();
+            if (token) {
+                this.persistAuthMethod('oidc');
+                return { method: 'oidc', token, isAdmin: false, userName: '' };
+            }
+        }
+        // 4. Fallback to JWT token
+        if (typeof window !== 'undefined' && window.localStorage) {
+            const storedToken = localStorage.getItem('authToken');
+            if (storedToken) {
+                this.authToken = storedToken;
+                this.authMethod = 'jwt';
+                return { method: 'jwt', token: storedToken, isAdmin: false, userName: '' };
+            }
+        }
+        return { method: 'none', token: null, isAdmin: false, userName: '' };
+    }
+    /**
+     * Clears all local authentication state — JWT token, OIDC tokens,
+     * persisted sessions, and localStorage keys managed by this library.
+     * Disconnects the WebSocket if connected.
+     *
+     * This does NOT redirect to an OIDC end-session endpoint. For a
+     * full RP-initiated logout use {@link logout} or
+     * {@link logoutOidc}.
+     */
+    clearAuth() {
+        this.authToken = null;
+        this.clearOidcTokens();
+        this.authMethod = 'none';
+        if (this.socket.connected) {
+            this.socket.disconnect();
+        }
+        this.clearPersistedAuthState();
+    }
+    /**
+     * Persists the current authentication method to localStorage so it
+     * can be restored after a page reload.
+     *
+     * @param {'jwt' | 'oidc'} method - The auth method to persist.
+     */
+    persistAuthMethod(method) {
+        if (typeof window !== 'undefined' && window.localStorage) {
+            localStorage.setItem('authMethod', method);
+        }
+    }
+    /**
+     * Removes all localStorage keys managed by docpouch-client:
+     * `authToken`, `authMethod`, `docpouch_oidc_session`,
+     * `docpouch_oidc_client_id`, `docpouch_registration_token`,
+     * `isAdmin`, and `postLogoutRedirectUri`.
+     */
+    clearPersistedAuthState() {
+        if (typeof window !== 'undefined' && window.localStorage) {
+            localStorage.removeItem('authToken');
+            localStorage.removeItem('authMethod');
+            localStorage.removeItem('docpouch_oidc_session');
+            localStorage.removeItem('docpouch_oidc_client_id');
+            localStorage.removeItem('docpouch_registration_token');
+            localStorage.removeItem('isAdmin');
+            localStorage.removeItem('postLogoutRedirectUri');
+        }
+    }
+    /**
+     * Convenience method to fetch the OIDC client config from the server
+     * and immediately initiate the OIDC login redirect. This combines
+     * {@link fetchOidcClientConfig} and {@link loginWithOidc} into a
+     * single call.
+     *
+     * @param {string} [registrationToken] - Optional initial access
+     *   token for dynamic client registration. If provided and no
+     *   client config is available from the server, the method attempts
+     *   dynamic registration via {@link ensureOidcClient}.
+     * @returns {Promise<void>}
+     */
+    async startOidcLogin(registrationToken) {
+        let config = this.oidcConfig;
+        if (!config) {
+            config = await this.fetchOidcClientConfig();
+        }
+        if (!config && registrationToken) {
+            const redirectUri = typeof window !== 'undefined'
+                ? window.location.origin + window.location.pathname
+                : '';
+            const clientId = await this.ensureOidcClient(redirectUri, registrationToken, {
+                postLogoutRedirectUri: redirectUri,
+            });
+            const issuer = this.getOidcIssuer();
+            config = {
+                issuer,
+                clientId,
+                redirectUri,
+                postLogoutRedirectUri: redirectUri,
+                scope: 'openid profile email offline_access',
+            };
+        }
+        if (!config) {
+            throw new Error('OIDC is not configured on this server');
+        }
+        this.setOidcConfig(config);
+        await this.loginWithOidc(config);
+    }
+    /**
+     * Derives the OIDC issuer URL from the client's baseUrl. By
+     * convention the DocPouch OIDC provider is mounted at
+     * `${baseUrl}/oidc`.
+     *
+     * @returns {string} The issuer URL.
+     */
+    getOidcIssuer() {
+        const trimmedBaseUrl = this.baseUrl.endsWith('/') ? this.baseUrl.slice(0, -1) : this.baseUrl;
+        const hasExplicitPort = /:\d+(?=\/|$)/.test(trimmedBaseUrl);
+        const normalizedBaseUrl = !hasExplicitPort && this.port
+            ? `${trimmedBaseUrl}:${this.port}`
+            : trimmedBaseUrl;
+        return `${normalizedBaseUrl}/oidc`;
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docpouch-client",
-  "version": "1.1.4",
+  "version": "1.2.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {