mirror of
https://github.com/gosticks/DefinitelyTyped.git
synced 2025-10-16 12:05:41 +00:00
83 lines
2.9 KiB
TypeScript
83 lines
2.9 KiB
TypeScript
// Type definitions for Angular JS 1.0 (ngResource module)
|
|
// Project: http://angularjs.org
|
|
// Definitions by: Diego Vilar <http://github.com/diegovilar>
|
|
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
|
|
|
|
|
|
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
// ngResource module (angular-resource.js)
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
declare namespace ng.resource {
|
|
|
|
///////////////////////////////////////////////////////////////////////////
|
|
// ResourceService
|
|
// see http://docs.angularjs.org/api/ngResource.$resource
|
|
// Most part of the following definitions were achieved by analyzing the
|
|
// actual implementation, since the documentation doesn't seem to cover
|
|
// that deeply.
|
|
///////////////////////////////////////////////////////////////////////////
|
|
interface IResourceService {
|
|
(url: string, paramDefaults?: any,
|
|
/** example: {update: { method: 'PUT' }, delete: deleteDescriptor }
|
|
where deleteDescriptor : IActionDescriptor */
|
|
actionDescriptors?: any): IResourceClass;
|
|
}
|
|
|
|
// Just a reference to facilitate describing new actions
|
|
interface IActionDescriptor {
|
|
method: string;
|
|
isArray?: boolean;
|
|
params?: any;
|
|
headers?: any;
|
|
}
|
|
|
|
// Baseclass for everyresource with default actions.
|
|
// If you define your new actions for the resource, you will need
|
|
// to extend this interface and typecast the ResourceClass to it.
|
|
interface IResourceClass {
|
|
get: IActionCall;
|
|
save: IActionCall;
|
|
query: IActionCall;
|
|
remove: IActionCall;
|
|
delete: IActionCall;
|
|
}
|
|
|
|
// In case of passing the first argument as anything but a function,
|
|
// it's gonna be considered data if the action method is POST, PUT or
|
|
// PATCH (in other words, methods with body). Otherwise, it's going
|
|
// to be considered as parameters to the request.
|
|
interface IActionCall {
|
|
(): IResource;
|
|
(dataOrParams: any): IResource;
|
|
(dataOrParams: any, success: Function): IResource;
|
|
(success: Function, error?: Function): IResource;
|
|
(params: any, data: any, success?: Function, error?: Function): IResource;
|
|
}
|
|
|
|
interface IResource {
|
|
$save: IActionCall;
|
|
$remove: IActionCall;
|
|
$delete: IActionCall;
|
|
|
|
// No documented, but they are there, just as any custom action will be
|
|
$query: IActionCall;
|
|
$get: IActionCall;
|
|
}
|
|
|
|
/** when creating a resource factory via IModule.factory */
|
|
interface IResourceServiceFactoryFunction {
|
|
($resource: ng.resource.IResourceService): ng.resource.IResourceClass;
|
|
}
|
|
}
|
|
|
|
/** extensions to base ng based on using angular-resource */
|
|
declare namespace ng {
|
|
|
|
interface IModule {
|
|
/** creating a resource service factory */
|
|
factory(name: string, resourceServiceFactoryFunction: ng.resource.IResourceServiceFactoryFunction): IModule;
|
|
}
|
|
}
|