fix(typescript): updates d.ts files

Fixes #18

packages/casl-ability/extra/extra.d.ts

@@ -1,3 +1,9 @@
-import { Rule } from '@casl/ability'
+import { Ability, Rule } from '@casl/ability'
 
-export function rulesToQuery(rules: Rule[], convert: (rule: Rule) => Object): Object | null
+export function rulesToQuery(ability: Ability, action: string, subject: any, convert: (rule: Rule) => Object): Object | null
+
+export interface PermittedFieldsOptions {
+  fieldsFrom?: (rule: Rule) => string[] | null | undefined
+}
+
+export function permittedFieldsOf(ability: Ability, action: string, subject: any, options?: PermittedFieldsOptions): string[]

packages/casl-ability/index.d.ts

@@ -1,38 +1,52 @@
-export interface Rule {
+export interface RawRule {
   subject: string | string[],
   actions: string | string[],
+  fields?: string[],
   conditions?: Object,
   inverted?: boolean
 }
 
+export interface Rule extends RawRule {
+  matches(subject: any): boolean
+  isRelevantFor(subject: any, field?: string): boolean
+}
+
 export interface AbilityOptions {
   subjectName: (subject: any) => string
 }
 
 export class Ability {
-  rules: Rule[]
+  rules: RawRule[]
 
   static addAlias(alias: string, fields: string | string[]): void
 
-  constructor(rules?: Rule[], options?: AbilityOptions)
+  constructor(rules?: RawRule[], options?: AbilityOptions)
+
+  update(rules: RawRule[]): Ability
 
-  update(rules: Rule[]): Ability
+  can(action: string, subject: any, field?: string): boolean
 
-  can(action: string, subject: any): boolean
+  cannot(action: string, subject: any, field?: string): boolean
 
-  cannot(action: string, subject: any): boolean
+  possibleRulesFor(action: string, subject: any): Rule[]
 
-  rulesFor(action: string, subject: any): Rule[]
+  rulesFor(action: string, subject: any, field?: string): Rule[]
+
+  throwUnlessCan(action: string, subject: any, field?: string): void
+}
 
-  throwUnlessCan(action: string, subject: any): void
+export class RuleBuilder {
+  rule: RawRule
 }
 
 export abstract class AbilityBuilderParts {
-  rules: Rule[]
+  rules: RawRule[]
 
-  can(action: string | string[], subject: string | string[], conditions?: Object): Rule
+  can(action: string | string[], subject: string | string[], conditions?: Object): RuleBuilder
+  can(action: string | string[], subject: string | string[], fields?: string[], conditions?: Object): RuleBuilder
 
-  cannot(action: string | string[], subject: string | string[], conditions?: Object): Rule
+  cannot(action: string | string[], subject: string | string[], conditions?: Object): RuleBuilder
+  cannot(action: string | string[], subject: string | string[], fields?: string[], conditions?: Object): RuleBuilder
 }
 
 export class AbilityBuilder extends AbilityBuilderParts {

packages/casl-mongoose/index.d.ts

@@ -1,5 +1,5 @@
-import { Rule } from '@casl/ability'
+import { Ability } from '@casl/ability'
 
-export function toMongoQuery(rules: Rule[]): Object | null
+export function toMongoQuery(ability: Ability, subject: any, action?: string): Object | null
 
 export function mongoosePlugin(schema: any): any