<?php

	#
	# $Id$
	#

	loadlib("http");

	#################################################################

	$GLOBALS['cfg']['flickr_api_endpoint'] = 'http://api.flickr.com/services/rest/';
	$GLOBALS['cfg']['flickr_upload_endpoint'] = 'http://api.flickr.com/services/upload/';
	$GLOBALS['cfg']['flickr_auth_endpoint'] = 'http://api.flickr.com/services/auth/';

	#################################################################

	function flickr_api_authtoken_perms_map($string_keys=0){

		$map = array(
			'0' => 'read',
			'1' => 'write',
			'2' => 'delete',
		);

		if ($string_keys){
			$map = array_flip($map);
		}

		return $map;
	}

	#################################################################

	function flickr_api_auth_url($perms, $extra=null, $frob=null){

		$args = array(
			'api_key' => $GLOBALS['cfg']['flickr_api_key'],
			'perms' => $perms,
		);

		# OH GOD... fix me...

		if ($frob){
			$args['frob'] = $frob;
		}

		if ($extra){

			$extra = http_build_query($extra);
			$args['extra'] = $extra;
		}

		$api_sig = _flickr_api_sign_args($args);
		$args['api_sig'] = $api_sig;

		$url = $GLOBALS['cfg']['flickr_auth_endpoint'] . "?" . http_build_query($args);
		return $url;
	}

	#################################################################

	function flickr_api_call_build($method, $args=array(), $more=array()){

		# untested (20130627/straup)

		if ((0) && ($GLOBALS['cfg']['flickr_api_use_oauth_bridge'])){

			$GLOBALS['cfg']['flickr_api_key'] = $GLOBALS['cfg']['flickr_oauth_key'];
			$GLOBALS['cfg']['flickr_api_key'] = $GLOBALS['cfg']['flickr_oauth_secret'];

			if (isset($args['auth_token'])){

				$flickr_user = flickr_users_get_by_auth_token($args['auth_token']);
				$more['user_key'] = $flickr_user['oauth_token'];
				$more['user_secret'] = $flickr_user['oauth_secret'];
			}

			loadlib("flickr_api_oauth");
			return flickr_api_oauth_call($method, $args, $more);
		}

		$args['api_key'] = $GLOBALS['cfg']['flickr_api_key'];

		$args['method'] = $method;
		$args['format'] = 'json';
		$args['nojsoncallback'] = 1;

		if ((isset($args['auth_token'])) || (isset($more['sign']))){
			$api_sig = _flickr_api_sign_args($args);
			$args['api_sig'] = $api_sig;
		}

		$url = $GLOBALS['cfg']['flickr_api_endpoint'];

		return array($url, $args);
	}

	#################################################################

	function flickr_api_call($method, $args=array(), $more=array()){

		list($url, $args) = flickr_api_call_build($method, $args, $more);

		$defaults = array(
			'http_timeout' => 10,
		);

		$more = array_merge($defaults, $more);

		$headers = array();

		$rsp = http_post($url, $args, $headers, $more);

		# $url = $url . "?" . http_build_query($args);
		# $rsp = http_get($url);

		return flickr_api_parse_response($rsp);
	}

	#################################################################

	function flickr_api_parse_response($rsp){

		if (! $rsp['ok']){
			return $rsp;
		}

		if (isset($more['raw'])){
			return $rsp;
		}

		$json = json_decode($rsp['body'], 'as a hash');

		if (! $json){
			return array( 'ok' => 0, 'error' => 'failed to parse response' );
		}

		if ($json['stat'] != 'ok'){
			return array( 'ok' => 0, 'error' => $json['message'], 'error_code' => $json['code']);
		}

		unset($json['stat']);
		return array( 'ok' => 1, 'rsp' => $json );
	}

	#################################################################

	function flickr_api_upload($file, $args, $more=array()){

		$args['api_key'] = $GLOBALS['cfg']['flickr_api_key'];

		# did we really never add json output for uploads?
		# why did we do that... (20120208/straup)
		#
		# $args['format'] = 'json';
		# $args['nojsoncallback'] = 1;

		$sig = _flickr_api_sign_args($args);

		$args['api_sig'] = $sig;
		$args['photo'] = "@{$file}";

		$defaults = array(
			'http_timeout' => 10,
		);

		$more = array_merge($defaults, $more);
		$headers = array();

		$url = $GLOBALS['cfg']['flickr_upload_endpoint'];

		$rsp = http_post($url, $args, $headers, $more);

		if (! $rsp['ok']){
			return $rsp;
		}

		# sigh... see above

		if ((isset($args['async'])) && ($args['async'])){

			if (preg_match("/<ticketid>(\d+-\d+)<\/ticketid>/m", $rsp['body'], $m)){
				return okay(array("ticket_id" => $m[1]));
			}
		}

		else {

			if (preg_match("/<photoid>(\d+)<\/photoid>/m", $rsp['body'], $m)){
				return okay(array("photo_id" => $m[1]));
			}
		}

		return not_okay("failed to parse response '{$rsp['body']}'");
	}

	#################################################################

	function _flickr_api_sign_args($args){

		$parts = array(
			$GLOBALS['cfg']['flickr_api_secret']
		);

		$keys = array_keys($args);
		sort($keys);

		foreach ($keys as $k){
			$parts[] = $k . $args[$k];
		}

		$raw = implode("", $parts);
		return md5($raw);
	}

	#################################################################
?>