Extensions TSDoc edits

src/extensions/extensions-api.ts

@@ -16,14 +16,22 @@
  */
 
 /**
- * SettableProcessingState represents all the Processing states that can be set on an ExtensionInstance's runtimeData.
+ * SettableProcessingState represents all the Processing states that can be set
+ * on an Extension instance's runtimeData.
  * 
+ * @remarks
  * - NONE: No relevant lifecycle event work has been done. Set this to clear out old statuses.
+ * 
  * - PROCESSING_COMPLETE: Lifecycle event work completed with no errors.
+ * 
  * - PROCESSING_WARNING: Lifecycle event work succeeded partially,
  *                        or something happened that the user should be warned about.
+ * 
  * - PROCESSING_FAILED: Lifecycle event work failed completely,
  *                        but the instance will still work correctly going forward.
- * - If the extension instance is in a broken state due to the errors, instead set FatalError.
+ * 
+ * - If the extension instance is in a broken state due to errors, instead set FatalError.
+ * 
+ * - To report ongoing (non-final) status, use `console.log` or the Cloud Functions logger SDK.
  */
 export type SettableProcessingState = 'NONE' | 'PROCESSING_COMPLETE' | 'PROCESSING_WARNING' | 'PROCESSING_FAILED';

src/extensions/extensions.ts

@@ -37,6 +37,7 @@ export class Extensions {
   /**
    * The runtime() method returns a new Runtime, which provides methods to modify an extension instance's runtime data.
    *
+   * @remarks
    * This method will throw an error if called outside an Extensions environment.
    * 
    * @returns A new {@link Runtime} object.
@@ -78,6 +79,7 @@ export class Runtime {
   /**
    * Sets the processing state of an extension instance.
    *
+   * @remarks
    * Use this method to report the results of a lifecycle event handler. If the 
    * lifecycle event failed & the extension instance will no longer work 
    * correctly, use `setFatalError` instead.
@@ -101,6 +103,7 @@ export class Runtime {
   /**
    * Reports a fatal error while running a lifecycle event handler.
    *
+   * @remarks
    * Call this method when a lifecycle event handler fails in a way that makes 
    * the Instance inoperable.
    * If the lifecycle event failed but the instance will still work as expected,