Feature: Define Artifact and Validator contracts

packages/core/src/index.ts

@@ -1 +1,3 @@
 export * from './lib/core';
+export * from './models';
+export * from './validators';

packages/core/src/models/artifact.ts

@@ -0,0 +1,57 @@
+/*
+=== Schema Sample Format ===
+name: user
+url: /user/:id
+request:
+  parameters:
+    id:
+      in: query # path / query / header
+      description: user id
+      validators:
+        - name: Date
+          args:
+            format: 'yyyy-MM-dd'
+        - name: required
+error:
+  - code: Forbidden
+    message: 'You are not allowed to access this resource'
+ */
+
+export enum FieldInType {
+  QUERY = 'QUERY',
+  HEADER = 'HEADER',
+}
+
+export interface ValidatorDefinition<T = any> {
+  name: string;
+  args: T;
+}
+
+export interface RequestParameter {
+  fieldName: string;
+  // the field put in query parameter or headers
+  fieldIn: FieldInType;
+  description: string;
+  validators: Array<ValidatorDefinition>;
+}
+
+export interface ErrorInfo {
+  code: string;
+  message: string;
+}
+
+export interface APISchema {
+  // graphql operation name
+  operationName: string;
+  // restful url path
+  urlPath: string;
+  // template, could be name or path
+  templateSource: string;
+  request: Array<RequestParameter>;
+  errors: Array<ErrorInfo>;
+  response: any;
+}
+
+export interface BuiltArtifact {
+  apiSchemas: Array<APISchema>;
+}

packages/core/src/models/index.ts

@@ -0,0 +1 @@
+export * from './artifact';

packages/core/src/validators/index.ts

@@ -0,0 +1 @@
+export * from './interface';

packages/core/src/validators/interface.ts

@@ -0,0 +1,8 @@
+export interface IValidator<T = any> {
+  // validator name
+  name: string;
+  // validate Schema format
+  validateSchema(args: T): boolean;
+  // validate input data
+  validateData(data: string, args: T): boolean;
+}