feat(repository): helper function for getting Model metadata

packages/repository/src/decorators/metadata.ts

@@ -0,0 +1,39 @@
+import {InspectionOptions, MetadataInspector} from '@loopback/context';
+import {MODEL_KEY, MODEL_PROPERTIES_KEY} from '../';
+import {ModelDefinition, PropertyDefinition} from '../../index';
+
+export class ModelMetadataHelper {
+  /**
+   * A utility function to simplify retrieving metadata from a target model and
+   * its properties.
+   * @param target The class from which to retrieve metadata.
+   * @param options An options object for the MetadataInspector to customize
+   * the output of the metadata retrieval functions.
+   */
+  static getModelMetadata(target: Function, options?: InspectionOptions) {
+    const classDef = MetadataInspector.getClassMetadata(
+      MODEL_KEY,
+      target,
+      options,
+    );
+    const meta = new ModelDefinition(
+      Object.assign(
+        {
+          name: target.name,
+          properties: {},
+        },
+        classDef,
+      ),
+    );
+
+    meta.properties = Object.assign(
+      <PropertyDefinition>{},
+      MetadataInspector.getAllPropertyMetadata(
+        MODEL_PROPERTIES_KEY,
+        target.prototype,
+        options,
+      ),
+    );
+    return meta;
+  }
+}

packages/repository/src/index.ts

@@ -7,6 +7,7 @@ export * from './common-types';
 export * from './decorators/model';
 export * from './decorators/repository';
 export * from './decorators/relation';
+export * from './decorators/metadata';
 export * from './types';
 export * from './model';
 export * from './query';

packages/repository/test/unit/decorator/metadata.ts

@@ -0,0 +1,55 @@
+import {ModelMetadataHelper} from '../../../src';
+import {property, model, ModelDefinition} from '../../..';
+import {expect} from '@loopback/testlab';
+
+describe('Repository', () => {
+  describe('getAllClassMetadata', () => {
+    @model()
+    class Colour {
+      @property({})
+      rgb: string;
+    }
+    @model()
+    class Widget {
+      @property() id: number;
+      @property.array(Colour) colours: Colour[];
+    }
+
+    @model()
+    class Samoflange {
+      id: number;
+      name: string;
+      canRotate: boolean;
+    }
+
+    it('retrieves metadata for classes with @model', () => {
+      const meta = ModelMetadataHelper.getModelMetadata(Samoflange);
+      expect(meta).to.deepEqual(
+        new ModelDefinition({
+          name: 'Samoflange',
+          properties: {},
+          settings: new Map(),
+        }),
+      );
+    });
+
+    it('retrieves metadata for classes with @model and @property', () => {
+      const meta = ModelMetadataHelper.getModelMetadata(Widget);
+      expect(meta).to.deepEqual(
+        new ModelDefinition({
+          properties: {
+            id: {
+              type: Number,
+            },
+            colours: {
+              array: true,
+              type: Colour,
+            },
+          },
+          settings: new Map(),
+          name: 'Widget',
+        }),
+      );
+    });
+  });
+});