onecore 0.5.17 → 0.6.1

package/README.md

@@ -1 +1,400 @@
-# onecore
+# onecore
+
+> The shared foundation for the Core TS ecosystem.
+
+`onecore` provides the common contracts, metadata model, and reusable application-layer base classes used throughout the Core TS ecosystem.
+
+It allows libraries such as **sql-core**, **mysql2-core**, **postgres-kit**, **mongodb-kit**, **validation-core**, **cache-plus**, **redis-plus**, **message-processing**, **nats-plus**, **redis-messaging**, **rabbitmq-transport**, **logger-core**, and **health-service** to work together through a unified API.
+
+## Features
+
+* Common interfaces for enterprise applications
+* Unified metadata model (`Attribute`)
+* Reusable CRUD and Search use-case base classes
+* Zero-cost abstractions through TypeScript interfaces
+* Tree-shakeable architecture
+* Works in both backend and frontend applications
+* No framework dependency
+* Fully written in TypeScript
+
+---
+
+# Installation
+
+```bash
+npm install onecore
+```
+
+---
+
+# Why onecore?
+
+Enterprise applications often use many infrastructure libraries.
+
+For example:
+
+* Database
+* Validation
+* Cache
+* Message Queue
+* Logging
+* Health Check
+* Import/Export
+
+Without a shared foundation, every library exposes its own interfaces and metadata.
+
+```text
+Repository      (sql)
+Validator       (validation)
+Producer        (mq)
+Logger          (logger)
+Cache           (cache)
+```
+
+`onecore` provides a single common language for the entire ecosystem.
+
+```ts
+import {
+    Repository,
+    Validator,
+    Producer,
+    CachePort,
+    Logger,
+    HealthChecker
+} from "onecore";
+```
+
+Applications only depend on **onecore**, while implementation libraries implement these contracts.
+
+---
+
+# Ecosystem
+
+```
+                                 Applications
+        ┌───────────────────────────────────────────────────────────────┐
+        │                                                               │
+        │  React Apps • REST APIs • Microservices • Workers • CLI       │
+        │                                                               │
+        └───────────────────────────────────────────────────────────────┘
+                                      ▲
+                                      │
+                           Reusable Use Cases (Optional)
+                     CRUD • Search • View • Generic Services
+                                      ▲
+                                      │
+    ┌─────────────────────────────────────────────────────────────────────────────────┐
+    │                                onecore                                          │
+    │                                                                                 │
+    │  • Common Interfaces                                                            │
+    │  • Unified Attribute Metadata                                                   │
+    │  • Locale & Currency                                                            │
+    │  • Shared Models                                                                │
+    │  • Reusable Service Layer                                                       │
+    └─────────────────────────────────────────────────────────────────────────────────┘
+         ▲                  ▲                  ▲                  ▲                 ▲
+         │                  │                  │                  │                 │
+         │                  │                  │                  │                 │
+┌────────────────┐ ┌────────────────┐ ┌──────────────────┐ ┌────────────────┐ ┌────────────────┐
+│    Database    │ │   Validation   │ │   Messaging      │ │ Import / Export│ │     Cache      │
+├────────────────┤ ├────────────────┤ ├──────────────────┤ ├────────────────┤ ├────────────────┤
+│ sql-core       │ │validation-core │ │message-processing│ │import-service  │ │ cache-plus     │
+│ mysql2-core    │ │                │ │nats-plus         │ │export-kit      │ │ redis-plus     │
+│ postgres-kit   │ │                │ │redis-messaging   │ │                │ │                │
+│ oracle-core    │ │                │ │rabbitmq-transport│ │                │ │                │
+│ mssql-core     │ │                │ │activemq          │ │                │ │                │
+│ mongodb-kit    │ │                │ │ibmmq-plus        │ │                │ │                │
+└────────────────┘ └────────────────┘ └──────────────────┘ └────────────────┘ └────────────────┘
+
+```
+
+All libraries share the same interfaces defined by `onecore`.
+
+---
+
+# Zero-Cost Abstractions
+
+One of the goals of `onecore` is to provide a common API **without adding runtime overhead**.
+
+## Interfaces
+
+Interfaces disappear after TypeScript compilation.
+
+```ts
+import { Repository, Validator } from "onecore";
+```
+
+The generated JavaScript contains no implementation from `onecore`.
+
+## Base Classes
+
+If an application extends one of the reusable CRUD or Search use-case classes, only those classes are included in the final bundle.
+
+Modern bundlers such as Webpack, Rollup, Vite, and esbuild tree-shake unused code automatically.
+
+This allows frontend and backend projects to share the same package while keeping bundles minimal.
+
+---
+
+# Unified Metadata
+
+The most important type in `onecore` is `Attribute`.
+
+Unlike persistence-specific or validation-specific metadata, `Attribute` is the canonical metadata model shared across the entire ecosystem.
+
+```
+                  Attribute
+                      │
+      ┌───────────────┼────────────────┐
+      │               │                │
+ Validation       Database        Import/Export
+      │               │                │
+validation-core   sql-core        import-service
+                 mysql2-core        export-kit
+                 postgres-kit
+                 mongodb-kit
+```
+
+Each library consumes only the properties that it understands.
+
+For example:
+
+Validation libraries use
+
+* required
+* format
+* gt
+* lt
+* resource
+* noValidate
+
+Database libraries use
+
+* noInsert
+* noUpdate
+* version
+* createdAt
+* updatedAt
+* length
+* type
+
+The same metadata definition can therefore be used for
+
+* Validation
+* Database mapping
+* CSV Import
+* CSV Export
+* Search
+* Formatting
+* Localization
+
+without duplication.
+
+---
+
+# Shared Interfaces
+
+`onecore` defines the common contracts used by the ecosystem.
+
+## Database
+
+* Repository
+* GenericRepository
+* SearchRepository
+* Transaction
+* Statement
+* QueryBuilder
+
+Implemented by
+
+* sql-core
+* mysql2-core
+* postgres-kit
+* mongodb-kit
+
+---
+
+## Validation
+
+* Validator<T>
+
+Implemented by
+
+* validation-core
+
+---
+
+## Cache
+
+* CachePort
+
+Implemented by
+
+* cache-plus
+* redis-plus
+
+---
+
+## Message Queue
+
+* Producer
+* Consumer
+* Publisher
+* Subscriber
+
+Implemented by
+
+* message-processing
+* redis-messaging
+* nats-plus
+* rabbitmq-transport
+* ActiveMQ libraries
+
+---
+
+## Logging
+
+* Logger
+
+Implemented by
+
+* logger-core
+
+---
+
+## Health Check
+
+* HealthChecker
+
+Implemented by
+
+* health-service
+
+---
+
+## HTTP
+
+* HttpRequest
+* HttpOptionsService
+
+Implemented by
+
+* web-clients
+
+---
+
+## Localization
+
+* Locale
+* Currency
+
+Implemented by
+
+* locale-service
+
+---
+
+# Reusable Use Cases
+
+`onecore` also provides reusable application-layer base classes.
+
+Examples include
+
+* CRUD services
+* Search services
+* View services
+
+Applications can extend these classes instead of implementing common CRUD logic repeatedly.
+
+Projects that do not use these classes pay no runtime cost.
+
+---
+
+# Frontend Support
+
+`onecore` works in frontend applications.
+
+React applications commonly use
+
+* Attribute
+* Locale
+* Currency
+* Validator interfaces
+
+without importing any backend service classes.
+
+The final JavaScript bundle remains minimal because interfaces are removed during compilation and unused code is tree-shaken.
+
+---
+
+# Backend Support
+
+Infrastructure services often depend only on interfaces.
+
+Examples include
+
+* Message Queue services
+* Import services
+* Export services
+* Background workers
+
+Since these projects do not use application-layer base classes, the generated JavaScript contains virtually no runtime code from `onecore`.
+
+---
+
+# Sample Projects
+
+The following sample applications demonstrate different ways of using `onecore`.
+
+### CRUD Applications
+
+* [**sql-modular-sample**](https://github.com/source-code-template/sql-modular-sample) — SQL modular microservice using MySQL
+* [**sql-simple-modular-sample**](https://github.com/source-code-template/sql-simple-modular-sample) — SQL modular microservice using PosgreSQL
+* [**mongo-simple-modular-sample**](https://github.com/source-code-template/mongo-simple-modular-sample) — MongoDB modular microservice
+
+These projects extend the reusable CRUD and Search use-case classes.
+
+### Import Data
+- [import-sample](https://github.com/typescript-sample/import-sample): import a fix-length file to MySql.
+- [import-csv-sample](https://github.com/typescript-sample/import-csv-sample): import a CSV file to MySql.
+
+These projects depend only on interfaces and the shared `Attribute` metadata model.
+
+### Export Data
+- [postgres-export-sample](https://github.com/typescript-sample/postgres-export-sample): export data from Postgres to CSV.
+- [mssql-export-sample](https://github.com/typescript-sample/mssql-export-sample): export data from MS SQL to CSV.
+- [oracle-export-sample](https://github.com/typescript-sample/oracle-export-sample): export data from Oracle to CSV.
+- [mysql-export-sample](https://github.com/typescript-sample/mysql-export-sample): export data from MySql to CSV.
+
+These projects depend only on interfaces and the shared `Attribute` metadata model.
+
+### Message Queue services
+- [redis-messaging-sample](https://github.com/typescript-tutorial/redis-messaging-sample): An example to consume message from Redis.
+- [rabbitmq-sample](https://github.com/typescript-tutorial/rabbitmq-sample): An example to consume message from rabbitmq.
+- [activemq-sample](https://github.com/typescript-tutorial/activemq-sample): An example to consume message from activemq.
+- [pubsub-sample](https://github.com/typescript-tutorial/pubsub-sample): An example to consume message from pubsub.
+- [ibmmq-sample](https://github.com/typescript-tutorial/ibmmq-sample): An example to consume message from ibmmq.
+- [kafka-sample](https://github.com/typescript-tutorial/kafka-sample): An example to consume message from kafka.
+- [nats-sample](https://github.com/typescript-tutorial/nats-sample): An example to consume message from nats.
+- [sqs-sample](https://github.com/typescript-tutorial/sqs-sample): An example to consume message from AWS sqs.
+
+These projects depend only on interfaces and the shared `Attribute` metadata model.
+
+---
+
+# Design Principles
+
+* Interface-first architecture
+* Dependency inversion
+* Clean Architecture
+* Hexagonal Architecture
+* Tree-shakeable design
+* Shared metadata model
+* Framework independent
+* Enterprise ready
+
+---
+
+# License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "onecore",
-  "version": "0.5.17",
+  "version": "0.6.1",
   "description": "onecore",
   "main": "./lib/index.js",
   "types": "./src/index.ts",

package/src/cache.ts

@@ -1,4 +1,4 @@
-export interface CacheService<K, V> {
+export interface CachePort<K, V> {
   isEnabled?(): boolean;
   put(key: K, obj: V, expiresInSeconds?: number): Promise<boolean>;
   expire(key: K, timeToLive: number): Promise<boolean>;
@@ -7,12 +7,12 @@ export interface CacheService<K, V> {
   containsKey(key: K): Promise<boolean>;
   remove(key: K): Promise<boolean>;
   clear(): Promise<boolean>;
-  keys?(): Promise<string[]>;
-  count?(): Promise<number>;
-  size?(): Promise<number>;
+  keys(): Promise<string[]>;
+  count(): Promise<number>;
+  size(): Promise<number>;
 }
 
-export interface SyncCacheService<K, V> {
+export interface SyncCachePort<K, V> {
   put(key: K, obj: V, expiresInMilliseconds?: number): boolean;
   expire(key: K, timeToLive: number): boolean;
   get(key: K): V;
@@ -20,6 +20,7 @@ export interface SyncCacheService<K, V> {
   containsKey(key: K): boolean;
   remove(key: K): boolean;
   clear(): boolean;
-  keys?(): Promise<string[]>;
-  count?(): Promise<number>;
+  keys(): string[];
+  count(): number;
+  size(): number;
 }

package/src/formatter.ts

@@ -1,5 +1,5 @@
 export interface Locale {
-  id?: string;
+  id: string;
   countryCode: string;
   dateFormat: string;
   firstDayOfWeek: number;
@@ -11,6 +11,11 @@ export interface Locale {
   currencyPattern: number;
   currencySample?: string;
 }
+export interface Currency {
+  code: string;
+  decimalDigits: number;
+  symbol: string;
+}
 
 export interface StringFormatter<T> {
   format(obj: T): string;

package/src/index.ts

@@ -6,6 +6,10 @@ export * from './cache';
 export * from './validator';
 export * from './loader';
 export * from './model';
+export * from './health';
+export * from './logger';
+
+export * from './io';
 
 import { GenericRepository, SearchRepository, GenericSearchRepository, Transaction } from './db';
 import { GenericSearchService, GenericService } from './service';
@@ -22,9 +26,8 @@ export * from './mail/model/ASMOptions';
 export * from './mail/config';
 
 export * from './location';
+export * from './job';
 export * from './video';
-export * from './health';
-export * from './logger';
 
 export type DeleteFile = (name: string, directory?: string) => Promise<boolean>;
 export type Delete = (delFile: DeleteFile, url: string) => Promise<boolean>;

package/src/io.ts

@@ -0,0 +1,24 @@
+import { ErrorMessage } from "./model"
+
+export interface Parser<T, S> {
+  parse: (data: S) => Promise<T>
+}
+export interface Transformer<T, S> {
+  transform: (data: S) => Promise<T>
+}
+
+export interface ICSVFieldParser<T> {
+  name: string
+  toString(data: T, key: string, v: string): void
+}
+
+export interface Writer<T> {
+  write: (obj: T) => Promise<number>
+  flush?: () => Promise<number>
+}
+export interface ErrorHandler<T> {
+  handleError(rs: T, errors: ErrorMessage[], i?: number, filename?: string): void
+}
+export interface ExceptionHandler<S> {
+  handleException(res: S, err: any, i?: number, filename?: string): void
+}

package/src/job.ts

@@ -0,0 +1,172 @@
+import { DateRange, Filter, SearchResult, TimeRange } from "./model";
+
+export interface Attachment {
+  originalFilename: string;
+  filename: string;
+  url: string;
+  size: number;
+}
+
+export interface Article {
+  id: string
+  slug: string
+  title: string
+  description?: string
+  publishedAt?: Date
+  tags?: string[]
+  thumbnail?: string
+  status?: string
+  createdAt?: Date
+  authorId?: string
+  savedAt?: Date
+}
+export interface ArticleFilter extends Filter {
+  id?: string
+  slug?: string
+  title?: string
+  description?: string
+  status?: string
+  publishedAt: TimeRange
+  tags?: string[]
+  authorId?: string
+  userId?: string
+  isSaved?: boolean
+}
+export interface ArticleRepository {
+  search(filter: ArticleFilter, limit: number, page?: number, fields?: string[]): Promise<SearchResult<Article>>
+  load(slug: string, userId?: string): Promise<Article | null>
+  getIdBySlug(slug: string): Promise<string>
+}
+
+export interface Achievement {
+  subject: string;
+  description: string;
+}
+export interface Skill {
+  skill: string;
+  hirable: boolean;
+}
+export interface UserFilter extends Filter {
+  userId?: string;
+  username?: string;
+  email?: string;
+  displayName?: string;
+  dateOfBirth?: DateRange;
+  status?: string[]|string;
+  interests?: string[];
+  skills?: Skill[];
+  achievements?: Achievement[];
+}
+export interface RoleFilter extends Filter {
+  roleId?: string;
+  roleName?: string;
+  status?: string[]|string;
+  remark?: string;
+  description?: string;
+}
+
+export interface ReviewComment {
+  commentId: string;
+  id: string;
+  author: string;
+  userId: string;
+  comment: string;
+  time: Date;
+  updatedAt?: Date;
+  histories?: ShortComment[];
+  userURL?: string;
+  authorURL?: string;
+}
+export interface ShortComment {
+  comment: string;
+  time: Date;
+}
+
+export interface ReviewCommentFilter extends Filter {
+  commentId?: string;
+  id?: string;
+  author?: string;
+  userId?: string;
+  comment?: string;
+  time?: DateRange;
+  updatedAt?: DateRange;
+}
+export interface Info {
+  id: string;
+  rate: number;
+  rate1: number;
+  rate2: number;
+  rate3: number;
+  rate4: number;
+  rate5: number;
+  count: number;
+  score: number;
+}
+export interface Info10 {
+  id: string;
+  rate: number;
+  rate1: number;
+  rate2: number;
+  rate3: number;
+  rate4: number;
+  rate5: number;
+  rate6: number;
+  rate7: number;
+  rate8: number;
+  rate9: number;
+  rate10: number;
+  count: number;
+  score: number;
+}
+export interface InfoRepository<ID> {
+  exist(id: ID, ctx?: any): Promise<boolean>;
+}
+
+export interface Company {
+  id: string
+  slug: string
+  name: string
+  overview: string
+  website?: string
+  industry?: string
+  size?: string
+  logo?: string
+  coverURL?: string
+  status: string
+
+  followerCount?: number
+  followingAt?: Date
+  followedAt?: Date
+}
+
+export interface Job {
+  id: string
+  slug: string
+  title: string
+  description: string
+  publishedAt?: Date
+  expiredAt?: Date
+  position?: string
+  quantity?: number
+  location?: string
+  applicantCount?: number
+  skills?: string[]
+  minSalary?: number
+  maxSalary?: number
+  companyId?: string
+  status: string
+}
+export interface JobFilter extends Filter {
+  id?: string
+  slug?: string
+  title?: string
+  description?: string
+  publishedAt?: TimeRange
+  expiredAt?: TimeRange
+  skills?: string[]
+  location?: string
+  quantity?: number
+  applicantCount?: number
+  companyId?: string
+  status?: string
+}

package/src/location.ts

@@ -1,27 +1,5 @@
 import {DateRange, Filter, NumberRange} from './model';
 
-export interface Article {
-  id: string
-  slug: string
-  title: string
-  description?: string
-  content?: string
-  publishedAt?: Date
-  tags?: string[]
-  thumbnail?: string
-  status?: string
-  createdAt?: Date
-  authorId?: string
-  savedAt?: Date
-}
-export interface ArticleFilter extends Filter {
-  id?: string;
-  title?: string;
-  type?: string;
-  tags?: string[];
-  status?: string[]|string;
-}
-
 export interface Location {
   id?: string;
   name?: string;

package/src/logger.ts

@@ -1,5 +1,8 @@
+export interface NumberMap {
+  [key: string]: number;
+}
 export interface SimpleMap {
-  [key: string]: string|number|boolean|Date;
+  [key: string]: string | number | boolean | Date;
 }
 export interface LogMap {
   time: string;
@@ -11,8 +14,30 @@ export interface LogMapConfig {
   level?: string;
   msg?: string;
 }
+export interface Config {
+  level?: string;
+  map?: LogMapConfig;
+  constants?: SimpleMap;
+  name?: Name;
+}
+export type LogConf = Config;
+export interface LogConfig {
+  log: Config;
+}
+export interface Name {
+  trace: string;
+  debug: string;
+  info: string;
+  warn: string;
+  error: string;
+  panic: string;
+  fatal: string;
+}
 export interface Logger {
+  name: Name;
   level: number;
+  map: LogMap;
+  constants?: SimpleMap;
   trace(msg: string, m?: SimpleMap, ctx?: any): void;
   debug(msg: string, m?: SimpleMap, ctx?: any): void;
   info(msg: string, m?: SimpleMap, ctx?: any): void;

package/src/model.ts

@@ -1,3 +1,5 @@
+import { Transaction } from "./db";
+
 export interface Headers {
   [key: string]: any;
 }
@@ -125,9 +127,6 @@ export interface ErrorMessage {
   param?: string|number|Date;
   message?: string;
 }
-export interface ErrorHandler<T> {
-  handleError(rs: T, errors: ErrorMessage[], i?: number, filename?: string): void;
-}
 
 export interface ResultInfo<T> {
   status: number|string;
@@ -149,143 +148,31 @@ export interface User {
   url?: string;
 }
 export interface History<T> {
-  id: string;
-  data: T;
-  time: Date;
+  id: string
+  author: string
+  time: Date
+  action: string
+  data: T
   user: User;
   note?: string;
 }
-export interface Notification {
-  id: string;
-  time: Date;
-  notifier?: User;
-  message: string;
-  url?: string;
-  read: boolean;
-}
-export interface Attachment {
-  originalFilename: string;
-  filename: string;
-  url: string;
-  size: number;
-}
-export interface Achievement {
-  subject: string;
-  description: string;
-}
-export interface Skill {
-  skill: string;
-  hirable: boolean;
-}
-export interface UserFilter extends Filter {
-  userId?: string;
-  username?: string;
-  email?: string;
-  displayName?: string;
-  dateOfBirth?: DateRange;
-  status?: string[]|string;
-  interests?: string[];
-  skills?: Skill[];
-  achievements?: Achievement[];
-}
-export interface RoleFilter extends Filter {
-  roleId?: string;
-  roleName?: string;
-  status?: string[]|string;
-  remark?: string;
-  description?: string;
-}
+
 export type Validate<T> = (obj: T, patch?: boolean) => Promise<ErrorMessage[]>;
 export type Save<T> = (obj: T, ctx?: any) => Promise<number|ResultInfo<T>>;
 export type Load<T, ID> = ((id: ID, ctx?: any) => Promise<T|null>);
 
-export interface ReviewComment {
-  commentId: string;
-  id: string;
-  author: string;
-  userId: string;
-  comment: string;
-  time: Date;
-  updatedAt?: Date;
-  histories?: ShortComment[];
-  userURL?: string;
-  authorURL?: string;
-}
-export interface ShortComment {
-  comment: string;
-  time: Date;
-}
-
-export interface ReviewCommentFilter extends Filter {
-  commentId?: string;
-  id?: string;
-  author?: string;
-  userId?: string;
-  comment?: string;
-  time?: DateRange;
-  updatedAt?: DateRange;
-}
-export interface Info {
-  id: string;
-  rate: number;
-  rate1: number;
-  rate2: number;
-  rate3: number;
-  rate4: number;
-  rate5: number;
-  count: number;
-  score: number;
-}
-export interface Info10 {
-  id: string;
-  rate: number;
-  rate1: number;
-  rate2: number;
-  rate3: number;
-  rate4: number;
-  rate5: number;
-  rate6: number;
-  rate7: number;
-  rate8: number;
-  rate9: number;
-  rate10: number;
-  count: number;
-  score: number;
-}
-export interface InfoRepository<ID> {
-  exist(id: ID, ctx?: any): Promise<boolean>;
-}
-
-export interface Company {
-  id: string
-  slug: string
-  name: string
-  overview: string
-  website?: string
-  industry?: string
-  size?: string
-  logo?: string
-  coverURL?: string
-  status: string
-  
-  followerCount?: number
-  followingAt?: Date
-  followedAt?: Date
-}
-export interface Job {
-  id: string
-  slug: string
-  title: string
-  description: string
-  publishedAt?: Date
-  expiredAt?: Date
-  position?: string
-  quantity?: number
-  location?: string
-  applicantCount?: number
-  skills?: string[]
-  minSalary?: number
-  maxSalary?: number
-  companyId?: string
-  status: string
+export interface Notification {
+  id?: string
+  sender: string
+  receiver: string
+  url?: string
+  message: string
+}
+export interface NotificationPort {
+  push(notification: Notification): Promise<number>
+  pushNotifications(notifications: Notification[]): Promise<number>
+}
+export interface NotificationRepository {
+  push(notification: Notification): Promise<number>
+  pushNotifications(notifications: Notification[]): Promise<number>
 }

package/src/mq.ts

@@ -4,7 +4,8 @@ interface StringMap {
 export interface NumberMap {
   [key: number]: number;
 }
-export type Handle<T> = (data: T, header?: StringMap) => Promise<number>;
+export type Process<T, R, M> = (data: T, attributes?: StringMap, msg?: M) => Promise<R>
+export type Handle<T, R, M> = (data: T, attributes?: StringMap, msg?: M) => Promise<R>
 export type Consume<T> = (handle: (data: T, header?: StringMap) => Promise<number>) => void;
 export type Read<T> = Consume<T>;
 export type Subscribe<T> = Consume<T>;
@@ -39,9 +40,6 @@ export interface Publisher<T, R, ID> {
 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 Producer<T, R, ID> {
   produce(to: string, data: T, attributes?: StringMap, id?: ID): Promise<R>;
@@ -52,10 +50,11 @@ export interface Publisher<T, R, ID> {
 export interface Sender<T, R, ID> {
   send(to: string, data: T, attributes?: StringMap, id?: ID): Promise<R>;
 }
+/*
 export interface Writer<T, R, ID> {
   write(to: string, data: T, attributes?: StringMap, id?: ID): Promise<R>;
 }
-
+*/
 export interface SimpleConsumer<T, R> {
   consume(handle: (data: T, attributes?: StringMap, raw?: R) => Promise<number>): void;
 }

package/src/validator.ts

@@ -4,11 +4,13 @@ interface ErrorMessage {
   param?: string|number|Date;
   message?: string;
 }
-
+export interface StringMap {
+  [key: string]: string;
+}
 export interface Validator<T> {
-  validate(model: T, ctx?: any): Promise<ErrorMessage[]>;
+  validate(model: T, resource?: StringMap, patch?: boolean): Promise<ErrorMessage[]>;
 }
 
 export interface SyncValidator<T> {
-  validate(model: T, ctx?: any): ErrorMessage[];
+  validate(model: T, resource?: StringMap, patch?: boolean): ErrorMessage[];
 }

package/src/video.ts

@@ -54,9 +54,6 @@ export interface CommentSnippet extends CommentInfo, YoutubeAuthor {
   parentId: string;
 }
 
-export interface StringMap {
-  [key: string]: string;
-}
 export interface ListResult<T> {
   list: T[];
   total?: number;