Add support for the Media API

Closes gh-49

Author: NathanKleekamp

lib/fields.js

@@ -202,6 +202,78 @@ maps.file = createFieldMaps({
 	postId: /* int */ "post_id"
 });
 
+maps.media = createFieldMaps({
+	attachmentId: /* string */ "attachment_id", /* readonly */
+	caption: /* string */ "caption",
+	description: /* string */ "description",
+	link: /* string */ "link",
+	parent: /* int */ "parent",
+	thumbnail: /* string */ "thumbnail",
+	title: /* string */ "title",
+	type: /* string */ "type"
+}, {}, {
+	date_created_gmt: /* datetime */ function( date ) {
+		return {
+			date: new Date( date )
+		};
+	},
+
+	metadata: /* struct */ function( data ) {
+		return {
+			metadata: mapFields( data, maps.mediaItemMetadata.from )
+		};
+	}
+});
+
+maps.mediaItemMetadata = createFieldMaps({
+	file: /* string */ "file",
+	height: /* int */ "height",
+	sizes: /* struct */ "sizes",
+	width: /* int */ "width"
+}, {}, {
+	sizes: /* struct */ function( size ) {
+		var keys = Object.keys( size ),
+		    results = {};
+
+		// Loop through the available sizes and map the fields
+		keys.forEach(function( key, i ) {
+			results[ keys[ i ] ] = mapFields( size[ keys[ i ] ], maps.mediaItemSize.from );
+		});
+
+		return {
+			sizes: results
+		};
+	},
+
+	image_meta: /* struct */ function( data ) {
+		return {
+			imageMeta: mapFields( data, maps.postThumbnailImageMeta.from )
+		};
+	}
+});
+
+maps.mediaItemSize = createFieldMaps({
+	file: /* string */ "file",
+	height: /* string */ "height",
+	mimeType: /* string */ "mime-type",
+	width: /* string */ "width"
+});
+
+maps.postThumbnailImageMeta = createFieldMaps({
+	aperture: /* int */ "aperture",
+	camera: /* string */ "camera",
+	caption: /* string */ "caption",
+	copyright: /* string */ "copyright",
+	createdTimestamp: /* int */ "created_timestamp",
+	credit: /* string */ "credit",
+	focalLength: /* int */ "focal_length",
+	iso: /* int */ "iso",
+	keywords: /* array */ "keywords",
+	orientation: /* string */ "orientation",
+	shutterSpeed: /* int */ "shutter_speed",
+	title: /* string */ "title"
+});
+
 module.exports = {
 	to: function( data, type ) {
 		return mapFields( data, maps[ type ].to );

lib/wordpress.js

@@ -150,10 +150,12 @@ extend( Client.prototype, {
 			filter.post_type = filter.type;
 			delete filter.type;
 		}
+
 		if ( filter.status ) {
 			filter.post_status = filter.status;
 			delete filter.status;
 		}
+
 		if ( filter.orderby ) {
 			filter.orderby = fieldMap.array( [ filter.orderby ], "post" )[ 0 ];
 		}
@@ -313,6 +315,33 @@ extend( Client.prototype, {
 });
 
 extend( Client.prototype, {
+	getMediaItem: function( id, fn ) {
+		this.authenticatedCall( "wp.getMediaItem", id, function( error, media ) {
+			if ( error ) {
+				return fn( error );
+			}
+
+			fn( null, fieldMap.from( media, "media" ) );
+		});
+	},
+
+	getMediaLibrary: function( filter, fn ) {
+		if ( typeof filter === "function" ) {
+			fn = filter;
+			filter = {};
+		}
+
+		this.authenticatedCall( "wp.getMediaLibrary", filter, function( error, media ) {
+			if ( error ) {
+				return fn( error );
+			}
+
+			fn( null, media.map(function( item ) {
+				return fieldMap.from( item, "media" );
+			}));
+		});
+	},
+
 	uploadFile: function( data, fn ) {
 		this.authenticatedCall( "wp.uploadFile", fieldMap.to( data, "file" ), fn );
 	}

readme.md

@@ -188,6 +188,18 @@ Deletes a taxonomy term.
 
 ### Media
 
+#### client.getMediaItem( id, callback )
+
+Gets a piece of media by ID.
+
+* `id`: The ID of the piece of media to get.
+* `callback` (`function( error, media )` ): A callback to invoke when the API call is complete.
+
+#### client.getMediaLibrary( [filter], callback )
+
+* `filter` (optional): A hash of key/value pairs for filtering which posts to get.
+* `callback` (`function( error, media )` ): A callback to invoke when the API call is complete.
+
 #### client.uploadFile( data, callback )
 
 Uploads a file to Wordpress.
@@ -360,6 +372,41 @@ Invokes a method with the username and password provided by the client.
 * termId
 * termTaxonomyId
 
+#### Media
+
+* attachmentId
+* caption
+* date
+* description
+* link
+* metadata
+  * file
+  * height
+  * imageMeta
+    * aperture
+    * camera
+    * caption
+    * copyright
+    * createdTimestamp
+    * credit
+    * focalLength
+    * iso
+    * keywords
+    * orientation
+    * shutterSpeed
+    * title
+  * sizes
+    * file
+    * height
+    * mimeType
+    * width
+  * width
+* parent
+* thumbnail
+* title
+* type
+
+
 
 
 ## License