feat: apply feedback

Applied feedback.

Signed-off-by: Hage Yaapa <[email protected]>

types/observer-mixin.d.ts

@@ -5,7 +5,16 @@
 
 import {Callback, PromiseOrVoid} from './common';
 
-export interface OperationHookContext {
+export interface OperationHookContext<T extends typeof PersistedModel> {
+  /**
+   * The constructor of the model that triggered the operation.
+   */
+  Model: T;
+
+  /**
+   * Additional context properties, not typed yet.
+   * See https://loopback.io/doc/en/lb3/Operation-hooks.html#hooks
+   */
   [property: string]: any;
 }
 

types/persisted-model.d.ts

@@ -521,9 +521,66 @@ export declare class PersistedModel extends ModelBase {
    */
   static getIdName(): string;
 
-  definePersistedModel<T>(entityClass: T): PersistedModel;
-
+  /**
+  * Register an asynchronous observer for the given operation (event).
+  *
+  * Example:
+  *
+  * Registers a `before save` observer for a given model.
+  *
+  * ```js
+  * MyModel.observe('before save', function filterProperties(ctx, next) {
+  if (ctx.options && ctx.options.skipPropertyFilter) return next();
+  if (ctx.instance) {
+    FILTERED_PROPERTIES.forEach(function(p) {
+      ctx.instance.unsetAttribute(p);
+    });
+  } else {
+    FILTERED_PROPERTIES.forEach(function(p) {
+      delete ctx.data[p];
+    });
+  }
+  next();
+  });
+  * ```
+  *
+  * @param {String} operation The operation name.
+  * @callback {function} listener The listener function. It will be invoked with
+  * `this` set to the model constructor, e.g. `User`.
+  */
   static observe(operation: string, handler: Listener): void;
+
+  /**
+  * Unregister an asynchronous observer for the given operation (event).
+  *
+  * Example:
+  *
+  * ```js
+  * MyModel.removeObserver('before save', function removedObserver(ctx, next) {
+    // some logic user want to apply to the removed observer...
+    next();
+  });
+  * ```
+  *
+  * @param {String} operation The operation name.
+  * @callback {function} listener The listener function.
+  */
+  static removeObserver(operation: string, handler: Listener): void;
+
+  /**
+  * Unregister all asynchronous observers for the given operation (event).
+  *
+  * Example:
+  *
+  * Remove all observers connected to the `before save` operation.
+  *
+  * ```js
+  * MyModel.clearObservers('before save');
+  * ```
+  *
+  * @param {String} operation The operation name.
+  */
+  static clearObservers(operation: string): void;
 }
 
 export type PersistedModelClass = typeof PersistedModel;