onecore 0.0.16 → 0.0.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "onecore",
-  "version": "0.0.16",
+  "version": "0.0.20",
   "description": "onecore",
   "main": "./lib/index.js",
   "types": "./src/index.ts",
@@ -17,7 +17,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git@github.com/common-ts/onecore"
+    "url": "git@github.com/core-ts/onecore"
   },
   "keywords": [
     "one",

package/src/index.ts

@@ -7,8 +7,7 @@ export {LocaleFormatter} from './formatter';
 export {StringFormatter} from './formatter';
 export {LocaleStringFormatter} from './formatter';
 
-export {Model} from './metadata';
-export {Attribute} from './metadata';
+export * from './metadata';
 
 export {CacheService} from './cache';
 export {SyncCacheService} from './cache';
@@ -27,12 +26,18 @@ export {DataLoader} from './loader';
 
 export * from './model';
 
+import {GenericSearchRepository} from './repository/GenericSearchRepository';
+export {GenericSearchRepository as Repository};
+
 export * from './repository/ViewRepository';
 export * from './repository/GenericRepository';
 export * from './repository/SearchRepository';
 export * from './repository/ViewSearchRepository';
 export * from './repository/GenericSearchRepository';
 
+import {GenericSearchService} from './service/GenericSearchService';
+export {GenericSearchService as Service};
+
 export * from './service/ViewService';
 export * from './service/GenericService';
 export * from './service/SearchService';

package/src/location.ts

@@ -1,19 +1,22 @@
-import {SearchModel} from './model';
+import {DateRange, Filter, NumberRange} from './model';
 
 export interface Article {
   id?: string;
   title?: string;
+  type?: string;
   description?: string;
   content?: string;
   tags?: string[];
   status?: string;
 }
-export interface ArticleSM extends SearchModel {
+export interface ArticleFilter extends Filter {
   id?: string;
-  name?: string;
+  title?: string;
   type?: string;
+  tags?: string[];
   status?: string[]|string;
 }
+
 export interface Location {
   id?: string;
   name?: string;
@@ -23,11 +26,11 @@ export interface Location {
   imageURL?: string;
   latitude?: number;
   longitude?: number;
-  customUrl?: string;
+  customURL?: string;
   info?: LocationInfo;
 }
 export interface LocationInfo {
-  id?: string; // locationID
+  id?: string;
   viewCount: number;
   rate: number;
   rate1: number;
@@ -36,6 +39,16 @@ export interface LocationInfo {
   rate4: number;
   rate5: number;
 }
+export interface LocationFilter extends Filter {
+  id?: string;
+  name?: string;
+  type?: string;
+  status?: string[]|string;
+  latitude?: number;
+  longitude?: number;
+  radius?: number;
+}
+
 export interface Event {
   id?: string;
   name?: string;
@@ -43,12 +56,25 @@ export interface Event {
   description?: string;
   status?: string;
   imageURL?: string;
-  startTime: Date;
-  endTime: Date;
+  startTime?: Date;
+  endTime?: Date;
   latitude?: number;
   longitude?: number;
+  customURL?: string;
   locationId?: string;
 }
+export interface EventFilter extends Filter {
+  id?: string;
+  name?: string;
+  type?: string;
+  status?: string[]|string;
+  startTime?: Date|DateRange;
+  endTime?: Date|DateRange;
+  latitude?: number;
+  longitude?: number;
+  locationId?: string[]|string;
+}
+
 export interface Bookable {
   id?: string;
   name?: string;
@@ -56,9 +82,19 @@ export interface Bookable {
   description?: string;
   status?: string;
   imageURL?: string;
+  customURL?: string;
   capacity?: number;
   locationId?: string;
 }
+export interface BookableFilter extends Filter {
+  id?: string;
+  name?: string;
+  type?: string;
+  status?: string[]|string;
+  capacity?: number|NumberRange;
+  locationId?: string[]|string;
+}
+
 export interface Booking {
   bookingId?: string;
   id?: string;
@@ -71,27 +107,37 @@ export interface Booking {
   endTime: Date;
   status?: string;
 }
-export interface LocationSM extends SearchModel {
+export interface BookingFilter extends Filter {
+  bookingId?: string;
   id?: string;
+  userId?: string;
   name?: string;
   type?: string;
-  status?: string[]|string;
-  latitude?: number;
-  longitude?: number;
+  description?: string;
+  subject?: string;
+  startTime?: Date|DateRange;
+  endTime?: Date|DateRange;
+  status?: string;
 }
-export interface EventSM extends SearchModel {
+
+export interface Tour {
   id?: string;
   name?: string;
   type?: string;
-  status?: string[]|string;
-  latitude?: number;
-  longitude?: number;
-  locationId?: string[]|string;
+  description?: string;
+  status?: string;
+  imageURL?: string;
+  startTime?: Date;
+  endTime?: Date;
+  locations: string[]|Location[];
+  customURL?: string;
 }
-export interface BookableSM extends SearchModel {
+export interface TourFilter extends Filter {
   id?: string;
   name?: string;
   type?: string;
   status?: string[]|string;
-  locationId?: string[]|string;
+  startTime?: Date|DateRange;
+  endTime?: Date|DateRange;
+  locations?: string[];
 }

package/src/metadata.ts

@@ -1,6 +1,7 @@
 export type DataType = 'ObjectId' | 'date' | 'datetime' | 'time'
     | 'boolean' | 'number' | 'integer' | 'string' | 'text'
-    | 'object' | 'array' | 'primitives' | 'binary';
+    | 'object' | 'array' | 'binary'
+    | 'primitives' | 'booleans' | 'numbers' | 'integers' | 'strings' | 'dates' | 'datetimes' | 'times';
 export type FormatType = 'currency' | 'percentage' | 'email' | 'url' | 'phone' | 'fax' | 'ipv4' | 'ipv6';
 export type MatchType = 'equal' | 'prefix' | 'contain' | 'max' | 'min'; // contain: default for string, min: default for Date, number
 

package/src/model.ts

@@ -58,21 +58,31 @@ export interface CodeText {
 }
 
 export interface DateRange {
+  min?: Date;
+  max?: Date;
+  bottom?: Date;
+  top?: Date;
   startDate?: Date;
   endDate?: Date;
 }
 export interface TimeRange {
+  min?: Date;
+  max?: Date;
+  bottom?: Date;
+  top?: Date;
   startTime?: Date;
   endTime?: Date;
 }
 export interface NumberRange {
   min?: number;
   max?: number;
+  bottom?: number;
+  top?: number;
   lower?: number;
   upper?: number;
 }
 
-export interface SearchModel {
+export interface Filter {
   page?: number;
   limit?: number;
   firstLimit?: number;
@@ -114,14 +124,14 @@ export interface DiffModel<T, ID> {
   value: T;
 }
 
-export interface UserSM extends SearchModel {
+export interface UserFilter extends Filter {
   userId?: string;
   username?: string;
   email?: string;
   displayName?: string;
   status?: string[]|string;
 }
-export interface RoleSM extends SearchModel {
+export interface RoleFilter extends Filter {
   roleId?: string;
   roleName?: string;
   status?: string[]|string;

package/src/mq.ts

@@ -0,0 +1,61 @@
+interface StringMap {
+  [key: string]: string;
+}
+export interface Message<T, ID, R> {
+  id?: ID;
+  data?: T;
+  attributes?: StringMap;
+  timestamp?: Date;
+  raw?: R;
+}
+export interface Producer<T, R, ID> {
+  produce(data: T, attributes?: StringMap, id?: ID): Promise<R>;
+}
+export interface Publisher<T, R, ID> {
+  publish(data: T, attributes?: StringMap, id?: ID): Promise<R>;
+}
+export interface Sender<T, R, ID> {
+  send(data: T, attributes?: StringMap, id?: ID): Promise<R>;
+}
+export interface Writer<T, R, ID> {
+  write(data: T, attributes?: StringMap, id?: ID): Promise<R>;
+}
+
+export interface SimpleProducer<T, R, ID> {
+  produce(to: string, data: T, attributes?: StringMap, id?: ID): Promise<R>;
+}
+export interface SimplePublisher<T, R, ID> {
+  publish(to: string, data: T, attributes?: StringMap, id?: ID): Promise<R>;
+}
+export interface SimpleSender<T, R, ID> {
+  send(to: string, data: T, attributes?: StringMap, id?: ID): Promise<R>;
+}
+export interface SimpleWriter<T, R, ID> {
+  write(to: string, data: T, attributes?: StringMap, id?: ID): Promise<R>;
+}
+
+export interface SimpleConsumer<T> {
+  consume(handle: (data: T, attributes?: StringMap) => Promise<number>): void;
+}
+export interface SimpleSubscriber<T, R> {
+  subscribe(handle: (data: T, attributes?: StringMap) => Promise<number>): void;
+}
+export interface SimpleReceiver<T> {
+  receive(handle: (data: T, attributes?: StringMap) => Promise<number>): void;
+}
+export interface SimpleReader<T> {
+  read(handle: (data: T, attributes?: StringMap) => Promise<number>): void;
+}
+
+export interface Consumer<T, ID, R> {
+  consume(data: Message<T, ID, R>): void;
+}
+export interface Subscriber<T, ID, R> {
+  subscribe(handle: (data: Message<T, ID, R>) => Promise<number>): void;
+}
+export interface Receiver<T, ID, R> {
+  receive(handle: (data: Message<T, ID, R>) => Promise<number>): void;
+}
+export interface Reader<T, ID, R> {
+  read(handle: (data: Message<T, ID, R>) => Promise<number>): void;
+}

package/src/repository/GenericSearchRepository.ts

@@ -1,7 +1,7 @@
-import {SearchModel} from '../model';
+import {Filter} from '../model';
 import {GenericRepository} from './GenericRepository';
 import {SearchRepository} from './SearchRepository';
 
-export interface GenericSearchRepository<T, ID, R, S extends SearchModel>
+export interface GenericSearchRepository<T, ID, R, S extends Filter>
   extends GenericRepository<T, ID, R>, SearchRepository<T, S> {
 }

package/src/repository/SearchRepository.ts

@@ -1,6 +1,6 @@
-import {SearchModel} from '../model';
+import {Filter} from '../model';
 import {SearchResult} from '../model';
 
-export interface SearchRepository<T, S extends SearchModel> {
+export interface SearchRepository<T, S extends Filter> {
   search(s: S, limit?: number, offset?: number|string, fields?: string[], ctx?: any): Promise<SearchResult<T>>;
 }

package/src/repository/ViewRepository.ts

@@ -1,9 +1,9 @@
 import {Attributes} from '../metadata';
 
 export interface ViewRepository<T, ID> {
-  metadata(): Attributes;
-  keys(): string[];
+  metadata?(): Attributes|undefined;
+  keys?(): string[];
   all?(ctx?: any): Promise<T[]>;
-  load(id: ID, ctx?: any): Promise<T>;
+  load(id: ID, ctx?: any): Promise<T|null>;
   exist?(id: ID, ctx?: any): Promise<boolean>;
 }

package/src/repository/ViewSearchRepository.ts

@@ -1,7 +1,7 @@
-import {SearchModel} from '../model';
+import {Filter} from '../model';
 import {SearchRepository} from './SearchRepository';
 import {ViewRepository} from './ViewRepository';
 
-export interface ViewSearchRepository<T, ID, S extends SearchModel>
+export interface ViewSearchRepository<T, ID, S extends Filter>
   extends ViewRepository<T, ID>, SearchRepository<T, S> {
 }

package/src/service/GenericSearchDiffApprService.ts

@@ -1,7 +1,7 @@
-import {SearchModel} from '../model';
+import {Filter} from '../model';
 import {DiffApprService} from './DiffApprService';
 import {GenericSearchService} from './GenericSearchService';
 
-export interface GenericSearchDiffApprService<T, ID, R, S extends SearchModel> extends GenericSearchService<T, ID, R, S>, DiffApprService<T, ID> {
+export interface GenericSearchDiffApprService<T, ID, R, S extends Filter> extends GenericSearchService<T, ID, R, S>, DiffApprService<T, ID> {
 
 }

package/src/service/GenericSearchService.ts

@@ -1,7 +1,7 @@
-import {SearchModel} from '../model';
+import {Filter} from '../model';
 import {GenericService} from './GenericService';
 import {SearchService} from './SearchService';
 
-export interface GenericSearchService<T, ID, R, S extends SearchModel>
+export interface GenericSearchService<T, ID, R, S extends Filter>
   extends GenericService<T, ID, R>, SearchService<T, S> {
 }

package/src/service/SearchService.ts

@@ -1,7 +1,7 @@
-import {SearchModel} from '../model';
+import {Filter} from '../model';
 import {SearchResult} from '../model';
 
-export interface SearchService<T, S extends SearchModel> {
+export interface SearchService<T, S extends Filter> {
   keys?(): string[];
   search(s: S, limit?: number, offset?: number|string, fields?: string[], ctx?: any): Promise<SearchResult<T>>;
 }

package/src/service/ViewSearchService.ts

@@ -1,7 +1,7 @@
-import {SearchModel} from '../model';
+import {Filter} from '../model';
 import {SearchService} from './SearchService';
 import {ViewService} from './ViewService';
 
-export interface ViewSearchService<T, ID, S extends SearchModel>
+export interface ViewSearchService<T, ID, S extends Filter>
   extends ViewService<T, ID>, SearchService<T, S> {
 }

package/src/service/ViewService.ts

@@ -1,9 +1,9 @@
 import {Attributes} from '../metadata';
 
 export interface ViewService<T, ID> {
-  metadata?(): Attributes;
+  metadata?(): Attributes|undefined;
   keys?(): string[];
   all?(ctx?: any): Promise<T[]>;
-  load(id: ID, ctx?: any): Promise<T>;
+  load(id: ID, ctx?: any): Promise<T|null>;
   exist?(id: ID, ctx?: any): Promise<boolean>;
 }

package/src/video.ts

@@ -1,13 +1,72 @@
+export interface TopLevelCommentSnippet {
+  videoId: string;
+  topLevelComment: TopLevelComment;
+  canReply: boolean;
+  totalReplyCount: number;
+  isPublic: boolean;
+}
+export interface TopLevelComment {
+  kind: string;
+  etag: string;
+  id: string;
+  snippet: TopLevelCommentSubSnippet;
+}
+export interface TopLevelCommentSubSnippet extends CommentInfo, YoutubeAuthor {
+  videoId: string;
+}
+
+export interface CommentThead extends Author, CommentInfo {
+  videoId: string;
+  canReply: boolean;
+  totalReplyCount: number;
+  isPublic: boolean;
+  nextPageToken?: string;
+}
+
+export interface Comment extends Author, CommentInfo {
+  parentId: string;
+}
+export interface AuthorChannelId {
+  value: string;
+}
+export interface AuthorInfo {
+  authorDisplayName: string;
+  authorChannelUrl: string;
+  authorProfileImageUrl: string;
+}
+export interface Author extends AuthorInfo {
+  authorChannelId: string;
+}
+export interface YoutubeAuthor extends AuthorInfo {
+  authorChannelId: AuthorChannelId;
+}
+export interface CommentInfo {
+  id: string;
+  textDisplay: string;
+  textOriginal: string;
+  canRate: boolean;
+  viewerRating: string;
+  likeCount: number;
+  publishedAt: Date;
+  updatedAt: Date;
+}
+export interface CommentSnippet extends CommentInfo, YoutubeAuthor {
+  parentId: string;
+}
+
+export interface StringMap {
+  [key: string]: string;
+}
 export interface ListResult<T> {
   list?: T[];
   total?: number;
   limit?: number;
   nextPageToken?: string;
 }
+export type ChannelSortType = 'title' | 'count' | 'date';
 export interface ChannelSM {
-  keyword?: string;
-  order?: string; // date, rating, relevance, title, videoCount (for channels), viewCount (for live broadcast)
-  nextPageToken?: string;
+  q?: string;
+  sort?: SortType; // date, rating, relevance, title, count (for channels)
   forMine?: boolean;
   channelId?: string;
   channelType?: string; // any, show
@@ -18,10 +77,10 @@ export interface ChannelSM {
   safeSearch?: string; // moderate, none, strict
   topicId?: string;
 }
+export type PlaylistSortType = 'title' | 'count' | 'date';
 export interface PlaylistSM {
-  keyword?: string;
-  order?: string; // date, rating, relevance, title, videoCount (for channels), viewCount (for live broadcast)
-  nextPageToken?: string;
+  q?: string;
+  sort?: SortType; // date, rating, relevance, title, count (for channels), viewCount (for live broadcast)
   forMine?: boolean;
   channelId?: string;
   channelType?: string; // any, show
@@ -31,31 +90,42 @@ export interface PlaylistSM {
   relevanceLanguage?: string;
   safeSearch?: string; // moderate, none, strict
 }
+export type ChannelType = 'show' | 'any' | '';
+export type EventType = 'completed' | 'live' | 'upcoming' | '';
+export type ItemType = 'video' | 'channel' | 'playlist' | 'any' | '';
+export type Duration = 'long' | 'medium' | 'short' | 'any' | '';
+export type Caption = 'closedCaption' | 'none' | 'any' | '';
+export type Definition = 'high' | 'standard' | 'any' | '';
+export type Dimension = '2d' | '3d' | 'any' | '';
+export type EmbeddableType = 'true' | 'any' | '';
+export type LicenseType = 'creativeCommon' | 'youtube' | 'any' | '';
+export type SyndicatedType = 'true' | 'any' | '';
+export type VideoType = 'movie' | 'episode' | 'any' | '';
+export type SortType = 'rating' | 'date' | 'count' | 'relevance' | 'title' | 'viewCount' | '';
 export interface ItemSM {
-  keyword?: string;
-  type?: string; // video, channel, playlist
-  videoDuration?: string; // any, long (more than 20 minutes), medium (from 4 minutes to 20 minutes), short (less than 4 minutes)
-  order?: string; // date, rating, relevance, title, videoCount (for channels), viewCount (for live broadcast)
-  nextPageToken?: string;
+  q?: string;
+  type?: ItemType; // video, channel, playlist
+  duration?: Duration; // any, long (more than 20 minutes), medium (from 4 minutes to 20 minutes), short (less than 4 minutes)
+  sort?: SortType; // date, rating, relevance, title, videoCount (for channels), viewCount (for live broadcast) => title, date => publishedAt, relevance => rank, count => videoCount
   relatedToVideoId?: string;
   forMine?: boolean;
   channelId?: string;
-  channelType?: string; // any, show
-  eventType?: string; // completed, live, upcoming
+  channelType?: ChannelType; // any, show
+  eventType?: EventType; // completed, live, upcoming
   publishedAfter?: Date;
   publishedBefore?: Date;
   regionCode?: string;
   relevanceLanguage?: string;
   safeSearch?: string; // moderate, none, strict
   topicId?: string;
-  videoCaption?: string; // any, closedCaption, none
-  videoCategoryId?: string;
-  videoDefinition?: string; // any, high, standard
-  videoDimension?: string; // 2d, 3d, any
-  videoEmbeddable?: string; // any, true
-  videoLicense?: string; // any, creativeCommon, youtube
-  videoSyndicated?: string; // any, true
-  videoType?: string; // any, episode, movie
+  categoryId?: string;
+  caption?: Caption; // any, closedCaption, none
+  definition?: Definition; // any, high, standard
+  dimension?: Dimension; // 2d, 3d, any
+  embeddable?: EmbeddableType; // any, true
+  license?: LicenseType; // any, creativeCommon, youtube
+  syndicated?: SyndicatedType; // any, true
+  videoType?: SyndicatedType; // any, episode, movie
 }
 export interface Item extends Title, Thumbnail, ChannelInfo {
   kind?: string; // video, channel, playlist
@@ -79,13 +149,14 @@ export interface Channel extends ItemInfo {
   likes?: string;
   favorites?: string;
   uploads?: string;
-  timestamp?: Date;
+  lastUpload?: Date;
   count?: number;
   itemCount?: number;
   playlistCount?: number;
   playlistItemCount?: number;
   playlistVideoCount?: number;
   playlistVideoItemCount?: number;
+  channels?: string[]|Channel[];
 }
 export interface Playlist extends ItemInfo, BigThumbnail {
   count?: number;
@@ -98,6 +169,12 @@ export interface PlaylistItemInfo {
   videoOwnerChannelTitle?: string;
 }
 export interface PlaylistVideo extends ItemInfo, BigThumbnail, PlaylistItemInfo {
+  duration?: number;
+  dimension?: string;
+  definition?: number; // 0: 144, 1: 240, 2: 360, 3: 480, 4: 720, 5: 1080, 6: 1440, 7: 2160
+  caption?: boolean;
+  licensedContent?: boolean;
+  projection?: string;
 }
 export interface VideoInfo {
   tags?: string[];
@@ -109,6 +186,8 @@ export interface VideoInfo {
 export interface Video extends ItemInfo, BigThumbnail, VideoDetail, VideoInfo {
   videoOwnerChannelId?: string;
   videoOwnerChannelTitle?: string;
+  blockedRegions?: string[];
+  allowedRegions?: string[];
 }
 export interface VideoDetail {
   duration: number;
@@ -171,6 +250,10 @@ export interface VideoItemDetail {
   videoId: string;
   videoPublishedAt: Date;
 }
+export interface RegionRestriction {
+  allow?: string[];
+  blocked?: string[];
+}
 export interface YoutubeVideoDetail {
   duration: string;
   dimension: string;
@@ -178,6 +261,7 @@ export interface YoutubeVideoDetail {
   caption: string;
   licensedContent: boolean;
   projection: string;
+  regionRestriction?: RegionRestriction;
 }
 export interface BaseSnippet extends Title, ChannelInfo {
   thumbnails: Thumbnails;
@@ -229,73 +313,35 @@ export interface CategorySnippet {
   assignable: boolean;
   channelId: string;
 }
-
-export interface TopLevelCommentSnippet {
-  videoId: string;
-  topLevelComment: TopLevelComment;
-  canReply: boolean;
-  totalReplyCount: number;
-  isPublic: boolean;
-}
-export interface TopLevelComment {
-  kind: string;
-  etag: string;
+export interface ChannelSubscriptions {
   id: string;
-  snippet: TopLevelCommentSubSnippet;
-}
-export interface TopLevelCommentSubSnippet extends CommentInfo, YoutubeAuthor {
-  videoId: string;
-}
-
-export interface CommentThead extends Author, CommentInfo {
-  videoId: string;
-  canReply: boolean;
-  totalReplyCount: number;
-  isPublic: boolean;
-  nextPageToken?: string;
-}
-
-export interface Comment extends Author, CommentInfo {
-  parentId: string;
-}
-export interface AuthorChannelId {
-  value: string;
+  data: Channel[]|string[];
 }
-export interface AuthorInfo {
-  authorDisplayName: string;
-  authorChannelUrl: string;
-  authorProfileImageUrl: string;
-}
-export interface Author extends AuthorInfo {
-  authorChannelId: string;
-}
-export interface YoutubeAuthor extends AuthorInfo {
-  authorChannelId: AuthorChannelId;
-}
-export interface CommentInfo {
-  id: string;
-  textDisplay: string;
-  textOriginal: string;
-  canRate: boolean;
-  viewerRating: string;
-  likeCount: number;
-  publishedAt: Date;
-  updatedAt: Date;
+export interface SubscriptionSnippet extends Title {
+  title: string;
+  resourceId: SubscriptionResource;
+  thumbnails: Thumbnails;
 }
-export interface CommentSnippet extends CommentInfo, YoutubeAuthor {
-  parentId: string;
+export interface SubscriptionResource {
+  kind: string;
+  channelId: string;
 }
 
 export interface ChannelSync {
   id: string;
   uploads?: string;
-  timestamp?: Date;
+  syncTime?: Date;
   level?: number;
 }
 export interface PlaylistCollection {
   id: string;
   videos: string[];
 }
+export interface CategoryCollection {
+  id: string;
+  data: VideoCategory[];
+}
+
 export interface SyncRepository {
   getChannelSync(channelId: string): Promise<ChannelSync>;
   saveChannel(channel: Channel): Promise<number>;
@@ -311,7 +357,8 @@ export interface SyncClient {
   getPlaylist(id: string): Promise<Playlist>;
   getChannelPlaylists(channelId: string, max?: number, nextPageToken?: string): Promise<ListResult<Playlist>>;
   getPlaylistVideos(playlistId: string, max?: number, nextPageToken?: string): Promise<ListResult<PlaylistVideo>>;
-  getVideos(ids: string[], noSnippet?: boolean): Promise<Video[]>;
+  getVideos(ids: string[]): Promise<Video[]>;
+  getSubscriptions(channelId: string): Promise<Channel[]>;
 }
 export interface SyncService {
   syncChannel(channelId: string): Promise<number>;
@@ -320,32 +367,37 @@ export interface SyncService {
   syncPlaylists(playlistIds: string[], level?: number): Promise<number>;
 }
 
+export interface SubscriptionsService {
+  getSubscriptions(channelId: string, fields?: string[]): Promise<Channel[]>;
+}
+export type CommentOrder = 'time' | 'relevance' | '';
+export type TextFormat = 'html' | 'plainText' | '';
 export interface VideoService {
   getCagetories(regionCode?: string): Promise<VideoCategory[]>;
-  getChannels(ids: string[]): Promise<Channel[]>;
-  getChannel(id: string): Promise<Channel>;
-  getChannelPlaylists(channelId: string, max?: number, nextPageToken?: string): Promise<ListResult<Playlist>>;
-  getPlaylists(ids: string[]): Promise<Playlist[]>;
-  getPlaylist(id: string): Promise<Playlist>;
-  getChannelVideos(channelId: string, max?: number, nextPageToken?: string): Promise<ListResult<PlaylistVideo>>;
-  getPlaylistVideos(playlistId: string, max?: number, nextPageToken?: string): Promise<ListResult<PlaylistVideo>>;
-  getPopularVideos(regionCode?: string, videoCategoryId?: string, max?: number, nextPageToken?: string): Promise<ListResult<Video>>;
-  getPopularVideosByRegion(regionCode?: string, max?: number, nextPageToken?: string): Promise<ListResult<Video>>;
-  getPopularVideosByCategory(videoCategoryId?: string, max?: number, nextPageToken?: string): Promise<ListResult<Video>>;
-  getVideos(ids: string[], noSnippet?: boolean): Promise<Video[]>;
-  getVideo(id: string, noSnippet?: boolean): Promise<Video>;
-  search(sm: ItemSM, max?: number, nextPageToken?: string|number): Promise<ListResult<Item>>;
-  getRelatedVideos?(videoId: string, max?: number, nextPageToken?: string): Promise<ListResult<Item>>;
-  searchVideos?(sm: ItemSM, max?: number, nextPageToken?: string|number): Promise<ListResult<Item>>;
-  searchPlaylists?(sm: PlaylistSM, max?: number, nextPageToken?: string|number): Promise<ListResult<Playlist>>;
-  searchChannels?(sm: ChannelSM, max?: number, nextPageToken?: string|number): Promise<ListResult<Channel>>;
+  getChannels(ids: string[], fields?: string[]): Promise<Channel[]>;
+  getChannel(id: string, fields?: string[]): Promise<Channel>;
+  getChannelPlaylists(channelId: string, max?: number, nextPageToken?: string, fields?: string[]): Promise<ListResult<Playlist>>;
+  getPlaylists(ids: string[], fields?: string[]): Promise<Playlist[]>;
+  getPlaylist(id: string, fields?: string[]): Promise<Playlist>;
+  getChannelVideos(channelId: string, max?: number, nextPageToken?: string, fields?: string[]): Promise<ListResult<PlaylistVideo>>;
+  getPlaylistVideos(playlistId: string, max?: number, nextPageToken?: string, fields?: string[]): Promise<ListResult<PlaylistVideo>>;
+  getPopularVideos(regionCode?: string, videoCategoryId?: string, max?: number, nextPageToken?: string, fields?: string[]): Promise<ListResult<Video>>;
+  getVideos(ids: string[], fields?: string[]): Promise<Video[]>;
+  getVideo(id: string, fields?: string[]): Promise<Video>;
+  search(sm: ItemSM, max?: number, nextPageToken?: string | number, fields?: string[]): Promise<ListResult<Item>>;
+  getRelatedVideos?(videoId: string, max?: number, nextPageToken?: string, fields?: string[]): Promise<ListResult<Item>>;
+  searchVideos?(sm: ItemSM, max?: number, nextPageToken?: string | number, fields?: string[]): Promise<ListResult<Item>>;
+  searchPlaylists?(sm: PlaylistSM, max?: number, nextPageToken?: string | number, fields?: string[]): Promise<ListResult<Playlist>>;
+  searchChannels?(sm: ChannelSM, max?: number, nextPageToken?: string | number, fields?: string[]): Promise<ListResult<Channel>>;
   /**
    * @param videoId
    * @param order relevance, time (default)
    * @param nextPageToken
    */
-  getCommentThreads?(videoId: string, order?: string, max?: number, nextPageToken?: string): Promise<ListResult<CommentThead>>;
+  getCommentThreads?(videoId: string, order?: CommentOrder, max?: number, nextPageToken?: string): Promise<ListResult<CommentThead>>;
   getComments?(id: string, max?: number, nextPageToken?: string): Promise<ListResult<Comment>>;
+  getPopularVideosByRegion?(regionCode?: string, max?: number, nextPageToken?: string, fields?: string[]): Promise<ListResult<Video>>;
+  getPopularVideosByCategory?(videoCategoryId?: string, max?: number, nextPageToken?: string, fields?: string[]): Promise<ListResult<Video>>;
 }
 export interface CacheItem<T> {
   item: T;

package/tsconfig.json

@@ -6,6 +6,7 @@
     "outDir": "./lib",
     "module": "commonjs",
     "moduleResolution": "node",
+    "strict": true,
     "pretty": true,
     "sourceMap": false,
     "declaration": false,