Skip to content

Commit 433d7bf

Browse files
docs: add padding and indentation for polish
1 parent c9800c6 commit 433d7bf

File tree

2 files changed

+64
-32
lines changed

2 files changed

+64
-32
lines changed

Source/Immutable/Public/Immutable/ImmutableDataTypes.h

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -75,8 +75,9 @@ struct IMMUTABLE_API FImmutablePassportInitData
7575

7676
/**
7777
* Converts the FImmutablePassportInitData structure to a JSON string representation.
78-
* @return A JSON string representation of the FImmutablePassportInitData structure.
79-
* Returns an empty string if the conversion fails.
78+
*
79+
* @return A JSON string representation of the FImmutablePassportInitData structure.
80+
* Returns an empty string if the conversion fails.
8081
*/
8182
FString ToJsonString() const;
8283
};

Source/Immutable/Public/Immutable/ImmutablePassport.h

Lines changed: 61 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -59,18 +59,20 @@ class IMMUTABLE_API UImmutablePassport : public UObject
5959

6060
/**
6161
* Initialises passport. This sets up the Passport instance, configures the web browser, and waits for the ready signal.
62-
* @param InitData Parameters to initialise the passport with.
63-
* @param ResponseDelegate Callback delegate.
62+
*
63+
* @param InitData Parameters to initialise the passport with.
64+
* @param ResponseDelegate Callback delegate.
6465
*/
6566
void Initialize(const FImmutablePassportInitData& InitData, const FImtblPassportResponseDelegate& ResponseDelegate);
6667

6768
/**
6869
* Logs the user into Passport via device code auth and sets up the Immutable X provider.
70+
*
6971
* This will open the user's default browser and take them through Passport login.
70-
* @param IsConnectImx If true, the "re-connect" method is used to authenticate into Passport with Immutable X.
71-
* Else, "re-login" is used for authentication. To access a wallet with Immutable X or zkEVM later, you must call "Connect" again with this value set to true, or use "ConnectEvm."
72-
* @param TryToRelogin If true, the game bridge will use a cached session to re-connect or re-login the user, avoiding the need for a web browser. If this attempt fails, it will fall back to device code authentication.
73-
* @param ResponseDelegate Callback delegate.
72+
* @param IsConnectImx If true, the "re-connect" method is used to authenticate into Passport with Immutable X.
73+
* Else, "re-login" is used for authentication. To access a wallet with Immutable X or zkEVM later, you must call "Connect" again with this value set to true, or use "ConnectEvm."
74+
* @param TryToRelogin If true, the game bridge will use a cached session to re-connect or re-login the user, avoiding the need for a web browser. If this attempt fails, it will fall back to device code authentication.
75+
* @param ResponseDelegate Callback delegate.
7476
*/
7577
void Connect(bool IsConnectImx, bool TryToRelogin, const FImtblPassportResponseDelegate& ResponseDelegate);
7678
#if PLATFORM_ANDROID | PLATFORM_IOS | PLATFORM_MAC
@@ -79,9 +81,10 @@ class IMMUTABLE_API UImmutablePassport : public UObject
7981

8082
/**
8183
* Logs the user out of Passport.
82-
* @param DoHardLogout If true, clears sessions and any stored credentials from both the SDK/plugin and the browser.
83-
* Else, clears session and any stored credentials from the SDK only, browser session and stored credentials are cleared when session expires.
84-
* @param ResponseDelegate Callback delegate.
84+
*
85+
* @param DoHardLogout If true, clears sessions and any stored credentials from both the SDK/plugin and the browser.
86+
* Else, clears session and any stored credentials from the SDK only, browser session and stored credentials are cleared when session expires.
87+
* @param ResponseDelegate Callback delegate.
8588
*/
8689
void Logout(bool DoHardLogout, const FImtblPassportResponseDelegate& ResponseDelegate);
8790

@@ -141,30 +144,35 @@ class IMMUTABLE_API UImmutablePassport : public UObject
141144

142145
/**
143146
* Gets the currently saved ID token without verifying its validity.
147+
*
144148
* @param ResponseDelegate Callback delegate.
145149
*/
146150
void GetIdToken(const FImtblPassportResponseDelegate& ResponseDelegate);
147151

148152
/**
149153
* Gets the currently saved access token without verifying its validity.
154+
*
150155
* @param ResponseDelegate Callback delegate.
151156
*/
152157
void GetAccessToken(const FImtblPassportResponseDelegate& ResponseDelegate);
153158

154159
/**
155160
* Gets the wallet address of the logged in user.
161+
*
156162
* @param ResponseDelegate Callback delegate.
157163
*/
158164
void GetAddress(const FImtblPassportResponseDelegate& ResponseDelegate);
159165

160166
/**
161167
* Retrieves the email address of the user whose credentials are currently stored.
168+
*
162169
* @param ResponseDelegate Callback delegate.
163170
*/
164171
void GetEmail(const FImtblPassportResponseDelegate& ResponseDelegate);
165172

166173
/**
167174
* Gets the list of external wallets the user has linked to their Passport account via the
175+
*
168176
* @param ResponseDelegate Callback delegate.
169177
*/
170178
void GetLinkedAddresses(const FImtblPassportResponseDelegate& ResponseDelegate);
@@ -212,22 +220,28 @@ class IMMUTABLE_API UImmutablePassport : public UObject
212220

213221
/**
214222
* Retrieves the "result" as string field from Response.JsonObject.
215-
* @param Response The response to use to retrieve the "result" as string field.
216-
* @return The "result" as string field from Response.JsonObject if Response.JsonObject is valid, otherwise, an empty string.
223+
*
224+
* @param Response The response to use to retrieve the "result" as string field.
225+
*
226+
* @return The "result" as string field from Response.JsonObject if Response.JsonObject is valid, otherwise, an empty string.
217227
*/
218228
static FString GetResponseResultAsString(const FImtblJSResponse& Response);
219229

220230
/**
221231
* Retrieves the "result" as bool field from Response.JsonObject.
222-
* @param Response The response to use to retrieve the "result" as bool field.
223-
* @return True if Response.JsonObject is valid, otherwise, false.
232+
*
233+
* @param Response The response to use to retrieve the "result" as bool field.
234+
*
235+
* @return True if Response.JsonObject is valid, otherwise, false.
224236
*/
225237
static bool GetResponseResultAsBool(const FImtblJSResponse& Response);
226238

227239
/**
228240
* Retrieves the "result" as array field from Response.JsonObject and extracting them into an array of FString.
229-
* @param Response The response to use to retrieve and extract.
230-
* @return An array of FString extracted from the "result" field if Response.JsonObject is valid, otherwise, an empty array.
241+
*
242+
* @param Response The response to use to retrieve and extract.
243+
*
244+
* @return An array of FString extracted from the "result" field if Response.JsonObject is valid, otherwise, an empty array.
231245
*/
232246
static TArray<FString> GetResponseResultAsStringArray(const FImtblJSResponse& Response);
233247

@@ -249,75 +263,88 @@ class IMMUTABLE_API UImmutablePassport : public UObject
249263

250264
/**
251265
* Calls JavaScript function to the connected browser with specified parameters.
252-
* @param Action The name of the JavaScript action to be called.
253-
* @param Data The data to be passed to the JavaScript action as FString.
254-
* @param ClientResponseDelegate Delegate to handle the response from the client.
255-
* @param HandleJSResponse Delegate to handle the response from the JavaScript function.
256-
* @param bCheckInitialized (Optional) If true, check if the passport is initialised. Else, initialised checks are skipped.
266+
*
267+
* @param Action The name of the JavaScript action to be called.
268+
* @param Data The data to be passed to the JavaScript action as FString.
269+
* @param ClientResponseDelegate Delegate to handle the response from the client.
270+
* @param HandleJSResponse Delegate to handle the response from the JavaScript function.
271+
* @param bCheckInitialized (Optional) If true, check if the passport is initialised. Else, initialised checks are skipped.
257272
*/
258273
void CallJS(const FString& Action, const FString& Data, const FImtblPassportResponseDelegate& ClientResponseDelegate, const FImtblJSResponseDelegate& HandleJSResponse, const bool bCheckInitialized = true);
259274

260275
/**
261276
* Sets up passport with the JavaScript connector
277+
*
262278
* @param Connector A weak pointer to the JavaScript Connector. If the connector is invalid set up will be aborted.
263279
*/
264280
void Setup(TWeakObjectPtr<class UImtblJSConnector> Connector);
265281

266282
/**
267283
* Reinstate the connection based on the provided JavaScript response.
284+
*
268285
* @param Response The JavaScript response object to reinstate the connection.
269286
*/
270287
void ReinstateConnection(FImtblJSResponse Response);
271288

272289
/**
273290
* Checks if the passport has been initialised before allowing an action to proceed.
274-
* @param Action The name of the JavaScript action to be called. Used for logging purposes.
275-
* @param ResponseDelegate Delegate to handle the response if the passport is not initialised.
276-
* @return True if the passport is initialised, otherwise, false.
291+
*
292+
* @param Action The name of the JavaScript action to be called. Used for logging purposes.
293+
* @param ResponseDelegate Delegate to handle the response if the passport is not initialised.
294+
*
295+
* @return True if the passport is initialised, otherwise, false.
277296
*/
278297
bool CheckIsInitialized(const FString& Action, const FImtblPassportResponseDelegate& ResponseDelegate) const;
279298

280299
/**
281300
* Retrieves the response delegate associated with a given JavaScript response from ResponseDelegates TMap.
282-
* @param Response The Javascript response object containing the request Id.
283-
* @return A TOptional containing the response delegate if found, otherwise, an empty TOptional.
301+
*
302+
* @param Response The Javascript response object containing the request Id.
303+
*
304+
* @return A TOptional containing the response delegate if found, otherwise, an empty TOptional.
284305
*/
285306
TOptional<FImtblPassportResponseDelegate> GetResponseDelegate(const FImtblJSResponse& Response);
286307

287308
/**
288309
* Confirms the device code by calling the appropriate JavaScript action.
289-
* @param DeviceCode The device code to be confirmed.
290-
* @param Interval The time interval to wait between attempts.
291-
* @param ResponseDelegate A delegate to handle the response from the confirmation request.
310+
*
311+
* @param DeviceCode The device code to be confirmed.
312+
* @param Interval The time interval to wait between attempts.
313+
* @param ResponseDelegate A delegate to handle the response from the confirmation request.
292314
*/
293315
void ConfirmCode(const FString& DeviceCode, const float Interval, const FImtblPassportResponseDelegate& ResponseDelegate);
294316

295317
/**
296318
* Common callback that handles the responses from game bridge
319+
*
297320
* @param Response The JavaScript response object containing the result of the callback.
298321
*/
299322
void OnBridgeCallbackResponse(FImtblJSResponse Response);
300323

301324
/**
302325
* Callback from init (passport).
326+
*
303327
* @param Response The JavaScript response object containing the result of the callback.
304328
*/
305329
void OnInitializeResponse(FImtblJSResponse Response);
306330

307331
/**
308332
* Callback from init device flow (device code auth login flow).
333+
*
309334
* @param Response The JavaScript response object containing the result of the callback.
310335
*/
311336
void OnInitDeviceFlowResponse(FImtblJSResponse Response);
312337

313338
/**
314339
* Callback from logout.
340+
*
315341
* @param Response The JavaScript response object containing the result of the callback.
316342
*/
317343
void OnLogoutResponse(FImtblJSResponse Response);
318344

319345
/**
320346
* Callback from confirm code.
347+
*
321348
* @param Response The JavaScript response object containing the result of the callback.
322349
*/
323350
void OnConfirmCodeResponse(FImtblJSResponse Response);
@@ -338,20 +365,24 @@ class IMMUTABLE_API UImmutablePassport : public UObject
338365

339366
/**
340367
* Sets the specified state flags by applying a bitwise OR operation.
368+
*
341369
* @param StateIn The state flags to be set.
342370
*/
343371
void SetStateFlags(uint8 StateIn);
344372

345373
/**
346374
* Resets the specified state flags by applying a bitwise AND operation with the negated flags.
375+
*
347376
* @param StateIn The state flags to be reset.
348377
*/
349378
void ResetStateFlags(uint8 StateIn);
350379

351380
/**
352381
* Checks if the specified state flags are set.
353-
* @param StateIn The state flags to check.
354-
* @return True if all StateIn flags are set, otherwise, false.
382+
*
383+
* @param StateIn The state flags to check.
384+
*
385+
* @return True if all StateIn flags are set, otherwise, false.
355386
*/
356387
bool IsStateFlagsSet(uint8 StateIn) const;
357388

0 commit comments

Comments
 (0)