Provide type support when decoding JSON string

[pali]

JSON decoder fills optional third argument of Cpanel::JSON::XS::decode_json function and optional second argument of ->decode method with original JSON types from input string.

Examples:

my $value = decode_json('false', 1, my $type);
# $value is 0 and $type is JSON_TYPE_BOOL

my $value = decode_json('0', 1, my $type);
# $value is 0 and $type is JSON_TYPE_INT

my $value = decode_json('"0"', 1, my $type);
# $value is 0 and $type is JSON_TYPE_STRING

my $struct = Cpanel::JSON::XS->new->decode('[null,1,1.1,"1",[0],true]', my $type);
# $struct is [undef, 1, 1.1, '1', [0], 1]
# $value is [JSON_TYPE_NULL, JSON_TYPE_INT, JSON_TYPE_FLOAT, JSON_TYPE_STRING, [JSON_TYPE_INT], JSON_TYPE_BOOL]

This allows users to correctly distinguish between booleans, integers, floats and strings in Perl language where perl interpreter can coerce between these types at any time.

[rurban]

Can you also the missing JSON_TYPE_NULL pod? pod_coverage complains
Other than that looks good.

[rurban]

JSON_TYPE_NULL missing pod

[pali]

Now I extended POD documentation.

[rurban]

Great. But I cannot release this before my holidays, starting tommorow. I believe I'll have no wifi in the French Alps

[rurban]

Released 4.05 without WiFi, only Phone hotspot. Thanks for the Glasgow talk!