{"_id":"webfinger","_rev":"22-2517aef25043fd1bda893fd9a73b17f2","name":"webfinger","description":"Client library for Host Meta (RFC 6415) and Webfinger","dist-tags":{"latest":"0.4.2"},"versions":{"0.1.0":{"name":"webfinger","description":"Client library for Host Meta (RFC 6415) and Webfinger","homepage":"http://github.com/evanp/webfinger","version":"0.1.0","keywords":["webfinger","hostmeta","discovery","xrd","jrd","lrdd"],"engines":{"node":"0.8.x"},"author":{"name":"Evan Prodromou","email":"evan@status.net"},"scripts":{"test":"vows -i test/*-test.js"},"main":"./lib/webfinger.js","directories":{"lib":"./lib/"},"devDependencies":{"vows":"0.6.x","express":"3.0.x"},"dependencies":{"step":"0.0.x","xml2js":"0.1.x"},"repository":{"type":"git","url":"git://github.com/evanp/activitypump.git"},"licenses":[{"type":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}],"_id":"webfinger@0.1.0","dist":{"shasum":"bbe98330857aab175f55e8d019a1e0f6d5046289","tarball":"https://registry.npmjs.org/webfinger/-/webfinger-0.1.0.tgz","integrity":"sha512-P5Lx2g9VxWtkBf5Tem1eifPw1xAWcnsTudCrGQeNy2d7YoaiNDbUra9m+s92TdMw667fFpFf6pKqZGXaxPBvOA==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDek3DFvZqY0BfIHlftr53X9T9tgNYFMPvEr71z7ygUqwIhAIJWMp6O7fonvB1GUiHqPi1z9DcqkAHhPatxDpn1Md10"}]},"_npmVersion":"1.1.59","_npmUser":{"name":"evanp","email":"evan@status.net"},"maintainers":[{"name":"evanp","email":"evan@status.net"}]},"0.1.1":{"name":"webfinger","description":"Client library for Host Meta (RFC 6415) and Webfinger","homepage":"http://github.com/evanp/webfinger","version":"0.1.1","keywords":["webfinger","hostmeta","discovery","xrd","jrd","lrdd"],"engines":{"node":"0.8.x"},"author":{"name":"Evan Prodromou","email":"evan@status.net"},"scripts":{"test":"vows -i test/*-test.js"},"main":"./lib/webfinger.js","directories":{"lib":"./lib/"},"devDependencies":{"vows":"0.6.x","express":"3.0.x"},"dependencies":{"step":"0.0.x","xml2js":"0.1.x"},"repository":{"type":"git","url":"git://github.com/evanp/webfinger.git"},"licenses":[{"type":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}],"_id":"webfinger@0.1.1","dist":{"shasum":"473c5f88006517839c3db66fe0f9a649a64df42b","tarball":"https://registry.npmjs.org/webfinger/-/webfinger-0.1.1.tgz","integrity":"sha512-l7NXrGHHcWNWzRFXQBZnEP0frIEwt/UqyI1R8QOngVIXX3ZmcpfX1X9iAKNiYpsOpKO5tpGySXOV/YzknvKJyQ==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDx1xkkkz5Ex+b7Z5F8qY7fT0BmUKMCWGr4/+UGxAne1AIhAKGleMLBQLKSutvHeRo89Wf9jckztf7Ylr10hYPTDcxZ"}]},"_npmVersion":"1.1.62","_npmUser":{"name":"evanp","email":"evan@status.net"},"maintainers":[{"name":"evanp","email":"evan@status.net"}]},"0.2.0":{"name":"webfinger","description":"Client library for Host Meta (RFC 6415) and Webfinger","homepage":"http://github.com/evanp/webfinger","version":"0.2.0","keywords":["webfinger","hostmeta","discovery","xrd","jrd","lrdd"],"engines":{"node":"0.8.x"},"author":{"name":"Evan Prodromou","email":"evan@status.net"},"scripts":{"test":"vows -i test/*-test.js"},"main":"./lib/webfinger.js","directories":{"lib":"./lib/"},"devDependencies":{"vows":"0.6.x","express":"3.0.x"},"dependencies":{"step":"0.0.x","xml2js":"0.1.x"},"repository":{"type":"git","url":"git://github.com/evanp/webfinger.git"},"licenses":[{"type":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}],"_id":"webfinger@0.2.0","dist":{"shasum":"610962bab7e17603d3be6a82ab682b5beef163bf","tarball":"https://registry.npmjs.org/webfinger/-/webfinger-0.2.0.tgz","integrity":"sha512-vqgTR8c97VkzL9EGtkf0JmYRIiwDmW1cgJfC+jNvuoB7FiygErRTxTrAeQZmQXKoLsssCBssRg+JkJ+zvGtTlQ==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIFdTzvQqW9a/NzDjwDK1tFHN0XYvJNWoXzDBq6AKqQVFAiEAtCrj6WdegGwOYGAJz6js+k4suz7g9p+StVcitMVQFQw="}]},"_npmVersion":"1.1.69","_npmUser":{"name":"evanp","email":"evan@status.net"},"maintainers":[{"name":"evanp","email":"evan@status.net"}]},"0.3.0":{"name":"webfinger","description":"Client library for Host Meta (RFC 6415) and Webfinger","homepage":"http://github.com/evanp/webfinger","version":"0.3.0","keywords":["webfinger","hostmeta","discovery","xrd","jrd","lrdd"],"engines":{"node":"0.8.x"},"author":{"name":"Evan Prodromou","email":"evan@status.net"},"scripts":{"test":"vows -i test/*-test.js"},"main":"./lib/webfinger.js","directories":{"lib":"./lib/"},"devDependencies":{"vows":"0.6.x","express":"3.0.x"},"dependencies":{"step":"0.0.x","xml2js":"0.1.x"},"repository":{"type":"git","url":"git://github.com/evanp/webfinger.git"},"licenses":[{"type":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}],"_id":"webfinger@0.3.0","dist":{"shasum":"70d067504bfe902086f15827a7c1780bc79ad43c","tarball":"https://registry.npmjs.org/webfinger/-/webfinger-0.3.0.tgz","integrity":"sha512-TXWArXeVGkVPsHk0jWjPGIMKJcoCUt5E3vRSQu7O+LMyg3ZqjwetUGqAP8Ff1PG1FO4TimixQtbK8vcyT33KDw==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCAfNbhEaF9uH5svSBgN+iXLX5vvKxOg5mCIVrlGoso2wIgXBR8BTDdmj06RX19GqKQnxU3eGFRuDgwMChkA1Uh/SM="}]},"_npmVersion":"1.1.63","_npmUser":{"name":"evanp","email":"evan@status.net"},"maintainers":[{"name":"evanp","email":"evan@status.net"}]},"0.3.1":{"name":"webfinger","description":"Client library for Host Meta (RFC 6415) and Webfinger","homepage":"http://github.com/e14n/webfinger","version":"0.3.1","keywords":["webfinger","hostmeta","discovery","xrd","jrd","lrdd"],"engines":{"node":">=0.8.x"},"author":{"name":"Evan Prodromou","email":"evan@e14n.com"},"scripts":{"test":"vows -i test/*-test.js"},"main":"./lib/webfinger.js","directories":{"lib":"./lib/"},"devDependencies":{"vows":"0.7.x","express":"3.0.x"},"dependencies":{"step":"0.0.x","xml2js":"0.1.x"},"repository":{"type":"git","url":"git://github.com/e14n/webfinger.git"},"licenses":[{"type":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}],"_id":"webfinger@0.3.1","dist":{"shasum":"9958b0f5e442a4b6b62979dc0b58c0e498790cb6","tarball":"https://registry.npmjs.org/webfinger/-/webfinger-0.3.1.tgz","integrity":"sha512-Ra6cgaBMRyM0qTT6/uqHQDCKnCmtlOAYinNnQe08e0jTL25zCgssvoFfrv7SFoxsQ6pl70Z6GYRjGktQuSei8Q==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIFUeUdjLn8OTHuZVDxwuAL8ojFXQV5rdXsnQOQXEelNWAiEA7cGJSAKn9fWrTjege9UnUc9pysTHmLWzh0Sv5N4cE9M="}]},"_from":".","_npmVersion":"1.2.15","_npmUser":{"name":"evanp","email":"evan@e14n.com"},"maintainers":[{"name":"evanp","email":"evan@status.net"}]},"0.3.2":{"name":"webfinger","description":"Client library for Host Meta (RFC 6415) and Webfinger","homepage":"http://github.com/evanp/webfinger","version":"0.3.2","keywords":["webfinger","hostmeta","discovery","xrd","jrd","lrdd"],"engines":{"node":">= 0.8.0"},"author":{"name":"Evan Prodromou","email":"evan@status.net"},"scripts":{"test":"vows -i test/*-test.js"},"main":"./lib/webfinger.js","directories":{"lib":"./lib/"},"devDependencies":{"vows":"0.7.x","express":"3.0.x"},"dependencies":{"step":"0.0.x","xml2js":"0.1.x"},"repository":{"type":"git","url":"git://github.com/evanp/webfinger.git"},"licenses":[{"type":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}],"_id":"webfinger@0.3.2","dist":{"shasum":"e602a0fa2034badc13ab44cbaffdfe1ae9b89b2f","tarball":"https://registry.npmjs.org/webfinger/-/webfinger-0.3.2.tgz","integrity":"sha512-5zLz+9p31O2JYSeBwUdCR0OdDaGTz0mgboog/FP/brWFP4azBUz0K39fGBDA54nKcd3BHG0pl5GbN2TPy3kL5w==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIBoSJeeZuwVt01EWD5dlmPu0cb/9ITnsDwmfREzV+EKiAiEArJIcpaiOjkdQGVkKUOOoZR+umvzCV5GVS59fm5ALep4="}]},"_from":".","_npmVersion":"1.2.18","_npmUser":{"name":"evanp","email":"evan@e14n.com"},"maintainers":[{"name":"evanp","email":"evan@status.net"}]},"0.4.0":{"name":"webfinger","description":"Client library for Host Meta (RFC 6415) and Webfinger","homepage":"http://github.com/e14n/webfinger","version":"0.4.0","keywords":["webfinger","hostmeta","discovery","xrd","jrd","lrdd"],"engines":{"node":">=0.8.x"},"author":{"name":"Evan Prodromou","email":"evan@e14n.com"},"scripts":{"test":"vows -i test/*-test.js"},"main":"./lib/webfinger.js","directories":{"lib":"./lib/"},"devDependencies":{"vows":"0.7.x","express":"3.0.x"},"dependencies":{"step":"0.0.x","xml2js":"0.1.x"},"repository":{"type":"git","url":"git://github.com/e14n/webfinger.git"},"licenses":[{"type":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}],"_id":"webfinger@0.4.0","dist":{"shasum":"a3cf20a7f01323646eee6d6665b910b40e0d72cd","tarball":"https://registry.npmjs.org/webfinger/-/webfinger-0.4.0.tgz","integrity":"sha512-m8PmbJTfJikXSRQZNNWPr2F76Nr91g9SD+mzAZLttKHkYHG9eZfOh9gZDWyM/rTUS1KysiAlDmcr+CcUVnXdKg==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCrgEghXyxV27GPpi7B8kEO2hjRXU8yi9ABC/8lTCb8PgIhAMQ7TMOnOSYn63/bEhMllY3sME/ojsbO4Z+4DZBkl5hf"}]},"_from":".","_npmVersion":"1.2.17","_npmUser":{"name":"evanp","email":"evan@e14n.com"},"maintainers":[{"name":"evanp","email":"evan@status.net"}]},"0.4.1":{"name":"webfinger","description":"Client library for Host Meta (RFC 6415) and Webfinger","homepage":"http://github.com/e14n/webfinger","version":"0.4.1","keywords":["webfinger","hostmeta","discovery","xrd","jrd","lrdd"],"engines":{"node":">=0.8.x"},"author":{"name":"Evan Prodromou","email":"evan@e14n.com"},"scripts":{"test":"vows -i test/*-test.js"},"main":"./lib/webfinger.js","directories":{"lib":"./lib/"},"devDependencies":{"vows":"0.7.x","express":"3.0.x"},"dependencies":{"step":"0.0.x","xml2js":"0.1.x"},"repository":{"type":"git","url":"git://github.com/e14n/webfinger.git"},"licenses":[{"type":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}],"_id":"webfinger@0.4.1","dist":{"shasum":"5300d6e9f4da1e2158a21619dcbcbb4246e9a217","tarball":"https://registry.npmjs.org/webfinger/-/webfinger-0.4.1.tgz","integrity":"sha512-Wcgz8jnxojWPUM6AtuT6nbQMcDCLoq788D4Urve7Lvn+wJhJs0H3al151y/cI2fo7xJFe3/jtXZB0QvHeB4/Sw==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDJ8f4ZWkQfA7Jj+9vcBCenQ+MeAtaGbIi08B0N6yEomQIhAPIDwkQFhyruVWTg9hJuDMJ9f+OhBoaO3roU9gMFGnK+"}]},"_from":".","_npmVersion":"1.2.18","_npmUser":{"name":"evanp","email":"evan@e14n.com"},"maintainers":[{"name":"evanp","email":"evan@status.net"}]},"0.4.2":{"name":"webfinger","description":"Client library for Host Meta (RFC 6415) and Webfinger","homepage":"http://github.com/e14n/webfinger","version":"0.4.2","keywords":["webfinger","hostmeta","discovery","xrd","jrd","lrdd"],"engines":{"node":">=0.8.x"},"author":{"name":"Evan Prodromou","email":"evan@e14n.com"},"scripts":{"test":"vows -i test/*-test.js"},"main":"./lib/webfinger.js","directories":{"lib":"./lib/"},"devDependencies":{"vows":"0.7.x","express":"3.0.x"},"dependencies":{"step":"0.0.x","xml2js":"0.1.x"},"repository":{"type":"git","url":"git://github.com/e14n/webfinger.git"},"licenses":[{"type":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}],"bugs":{"url":"https://github.com/e14n/webfinger/issues"},"_id":"webfinger@0.4.2","dist":{"shasum":"3477a6d97799461896039fcffc650b73468ee76d","tarball":"https://registry.npmjs.org/webfinger/-/webfinger-0.4.2.tgz","integrity":"sha512-PvvQ/k74HkC3q5G7bGu4VYeKDt3ePZMzT5qFPtEnOL8eyIU1/06OtDn9X5vlkQ23BlegA3eN89rDLiYUife3xQ==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIBVFQeT13QUJzWb7+DATOMtpVR92NUKI5HZIuIBDa6TEAiEA1lAH3sfwFy7llXeKwnS51FVnJeGymWIwakcwqCj3zbE="}]},"_from":".","_npmVersion":"1.3.2","_npmUser":{"name":"evanp","email":"evan@e14n.com"},"maintainers":[{"name":"evanp","email":"evan@status.net"}]}},"readme":"# Webfinger\n\nWebfinger and host-meta client library for Node.js.\n\nIt supports:\n\n* XRD documents\n* JRD documents\n* host-meta\n* host-meta.json\n* http and https\n* RFC 6415 and the upcoming Webfinger RFC (up to draft 09)\n\n## License\n\nCopyright 2012,2013 E14N https://e14n.com/\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n\n## API\n\n### webfinger(address, callback)\n\nGets link data for the address `address` and returns it to function `callback`.\n\nThe `address` argument can be any kind of URL that node.js recognizes;\nacct: and http: and https: URLs are the most likely to work.\n\n`callback` should take two arguments: `err` for an error, and `jrd`\nfor a JRD representation of the Webfinger data.\n\nNote that the data is returned in JRD format even if it's in XRD\nformat on the server.\n\nThis method will first try the `/.well-known/webfinger` endpoint; if\nthat doesn't work it will fall back to RFC 6415 discovery.\n\n### webfinger(address, rel, callback)\n\nAs above, but passes the `rel` parameter to the\n`/.well-known/webfinger` endpoint if it's truthy.\n\nThis is mostly advisory. Some servers will send all links back\nanyways; others don't support the webfinger endpoint, so when we\nfallback to RFC 6415 everything is returned.\n\nEven if you pass a `rel` argument, you should still filter the\nresults. (But future versions of this library may do it for you.)\n\n### webfinger(address, rel, options, callback)\n\nAs above, but you can use the `options` object to control\nbehaviour. Currently, the options are:\n\n* `httpsOnly`: boolean flag, default `false` for whether to only use\n  HTTPS for communicating with the server. When this is set, it won't\n  use Webfinger, host-meta or LRDD endpoints that aren't HTTPS, and won't\n  follow redirect requests to HTTP endpoints.\n* `webfingerOnly`: boolean flag, default `false` for whether to only use\n  the .well-known/webfinger endpoint. When this is set, it won't\n  use host-meta and LRDD endpoints as a fallback.\n\n### lrdd(address, callback)\n\nExplicitly use Host Metadata + LRDD lookup per RFC 6415 and avoid the\n/.well-known/webfinger endpoint. Use this if you know a host only\nsupports LRDD.\n\n### lrdd(address, options, callback)\n\nAs above, but with fine control of options. Options include:\n\n* `httpsOnly`: boolean flag, default `false` for whether to only use\n  HTTPS for communicating with the server. When this is set, it won't\n  use Webfinger, host-meta or LRDD endpoints that aren't HTTPS, and won't\n  follow redirect requests to HTTP endpoints.\n\n### hostmeta(address, callback)\n\nGets link data for the host at `address` and returns it to function `callback`.\n\n`callback` works just like with `webfinger()`.\n\n### hostmeta(address, options, callback)\n\nAs above, but you can use the `options` object to control\nbehaviour. Currently, the options are:\n\n* `httpsOnly`: boolean flag, default `false`, for whether to only use\n  HTTPS for communicating with the server. When this is set, it won't\n  use host-meta or host-meta.json endpoints that aren't HTTPS, and won't\n  follow redirect requests to HTTP endpoints.\n\n### discover(address, callback)\n\nGets link data for `address` and returns it to function `callback`.\n\nIf you've got an address and you don't want to bother figuring out if it's a \nwebfinger or a hostname, call this and we'll do it for you.\n\n`callback` works just like with `webfinger()`.\n\n## Testing\n\nThe tests set up servers that listen on ports 80 and 443. On most\nUnix-like systems, you have to be root to listen on ports below 1024 or whatever.\n\nSo, to run the unit tests, you have to go:\n\n    sudo npm test\n\nIt's probably not a good idea to sudo any script without thinking\nabout it pretty hard. I suggest that if you're doing development, you\ndo it in a virtual machine so you're not sudo'ing dangerous stuff on\nyour main computer.\n\n# Bugs\n\nBugs welcome, see:\n\n https://github.com/e14n/webfinger/issues\n","maintainers":[{"email":"evan@e14n.com","name":"evanp"}],"time":{"modified":"2022-06-28T23:19:30.563Z","created":"2012-08-29T19:08:31.252Z","0.1.0":"2012-08-29T19:08:31.851Z","0.1.1":"2012-09-28T20:20:49.914Z","0.2.0":"2013-01-14T03:34:55.624Z","0.3.0":"2013-02-05T20:46:27.490Z","0.3.1":"2013-04-03T20:53:31.882Z","0.3.2":"2013-04-29T15:12:49.906Z","0.4.0":"2013-04-29T16:19:05.820Z","0.4.1":"2013-05-01T02:30:50.870Z","0.4.2":"2013-07-17T14:47:35.943Z"},"author":{"name":"Evan Prodromou","email":"evan@e14n.com"},"repository":{"type":"git","url":"git://github.com/e14n/webfinger.git"},"homepage":"http://github.com/e14n/webfinger","keywords":["webfinger","hostmeta","discovery","xrd","jrd","lrdd"],"bugs":{"url":"https://github.com/e14n/webfinger/issues"},"readmeFilename":"README.md"}