[{"_1":2,"_166":-5,"_167":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_164":165},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":17},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_155":-5,"_156":11,"_157":17,"_158":11,"_159":-5,"_160":11,"_161":-5,"_162":163},"canonicalUrl","https://hub.docker.com/r/csarven/mayktso/builds/","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","csarven","reponame","mayktso","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":17,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2018-05-02T21:46:15.959988Z","description","Source: https://github.com/csarven/mayktso","is_private","last_updated","2021-06-04T11:10:26.204377Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",968,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# mayktso\nEncounters at an endpoint.\n\n\n[![Docker Automated build](https://img.shields.io/docker/automated/csarven/mayktso.svg)](https://hub.docker.com/r/csarven/mayktso/builds/)\n[![Docker Build Status](https://img.shields.io/docker/build/jrottenberg/ffmpeg.svg)](https://hub.docker.com/r/csarven/mayktso/)\n[![](https://images.microbadger.com/badges/image/csarven/mayktso.svg)](https://microbadger.com/images/csarven/mayktso \"Docker layers of csarven/mayktso\")\n\n## About\n* HTTP server and command-line RDF tool to get/send, serialise data.\n* Server can receive HTTP `HEAD`, `OPTIONS`, `GET`, `POST`, `PUT` requests.\nContent negotiation with `text/turtle`, `application/ld+json`, `text/html`,\n`application/xhtml+xml`. It can serialize from HTML+RDFa, but does not serialize\nto HTML+RDFa.\n* Spec coverage:\n * Tested: Conforming [Linked Data Notifications](https://www.w3.org/TR/ldn/) sender, receiver, sender.\n * Untested: [Linked Data Platform](https://www.w3.org/TR/ldp/) - probably does most things, and only BasicContainer.\n * Totally untested and probably only small parts: [Web Annotation Protocol](https://www.w3.org/TR/annotation-protocol/)\n * Basic implementation of the the [ActiviyPub](https://www.w3.org/TR/activitypub/) Outbox mechanism.\n* No authenication/authorisation mechanism\n* Basic configuration to set constraints on a directory (size/max)\n* Basic configuration to handle stuff like https://linkedresearch.org/cloud\n\nThis server was initially built for LDN tests but then decided to support/test [dokieli](https://dokie.li/)'s needs (source: https://github.com/linkeddata/dokieli) and do LDP etc.\n\nDive into [issues](https://github.com/csarven/mayktso/issues) because it is fun.\n\n\n## Docker\n\n\nIf you use [Docker](https://www.docker.com/), try the image [csarven/mayktso](https://hub.docker.com/r/csarven/mayktso/builds/):\n\n```shell\ndocker run -p 3000:3000 -d csarven/mayktso\n```\n### Persistent Docker container\n\n```shell\ndocker volume create mayktso-data\ndocker run --name mayktso --restart=always \\\n --mount source=mayktso-data,target=/mayktso \\\n -p 3000:3000 \\\n -d csarven/mayktso\n```\n\nTo update:\n\n```\ndocker pull csarven/mayktso\ndocker stop mayktso\ndocker rm mayktso\n```\n\n.. then recreate using the `docker run` from above.\n\n## Installation from source\n```shell\n$ git clone https://github.com/csarven/mayktso\n$ cd mayktso\n$ npm install\n```\n\n\n## Receiver\nServer runs on http://localhost:3000/ by default:\n\n```shell\n$ node index.js\n```\n\n### Config\nOptional config use: `cp config.json.default config.json`\n```json\n{\n \"port\": \"3000\",\n \"sslKey\": \"/path/to/privkey.pem\",\n \"sslCert\": \"/path/to/cert.pem\",\n \"proxyURL\": \"http://example.org/proxy?uri=\",\n \"rootPath\": \".\",\n \"basePath\": \"\",\n \"inboxPath\": \"inbox/\",\n \"queuePath\": \"queue/\",\n \"maxPayloadSize\": 100000,\n \"maxResourceCount\": 10,\n}\n```\n\n* Defaults will be used for omitted key/values (except `sslKey`/`sslCert` are\nunused)\n* `basePath` is useful when running as a reverse proxy in a dedicated directory\n(e.g., Apache)\n```apache\nProxyPass /foo/ https://localhost:3000/\nProxyPassReverse /foo/ https://localhost:3000/\n```\n\nso that http://example.org/foo/bar resolves, otherwise, server only sees /bar\ne.g., `basePath: \"/foo/bar/\"`\n\n* `inboxPath` and `queuePath` are relative to root e.g.,\nhttp://localhost:3000/{inbox,queue}/\n* queue is used for HTTP 202 responses (default for payload above maxPayloadSize\nin bytes). Status: Testing\n* `rootPath` defaults to the current directory (`.`) or a full path can be\nspecified. Requests are relative to this location.\n* `maxPayloadSize` is for POSTs (as the name suggests)\n* `maxResourceCount` is for number of notifications to keep in inbox/ or queue\n\n\n* Simple data shape check that's based off https://linkedresearch.org/cloud 's\nneeds. It is triggered by having a line like this\n`\"checkDataShape\": [ { \"uri\": \"inbox/linkedresearch.org/cloud/\" } ]`. This needs\nto be better documented and built further.\n\n## Sender and Consumer\n\n### Command line\n```shell\n$ node index.js --help\nmayktso: https://github.com/csarven/mayktso\n * Running without parameter/option starts server, otherwise:\n * Usage: node index.js [parameter] [options]\n [parameter]\n --help\n --discoverInbox Discover a target's Inbox\n --getNotifications Get the notifications contained in an Inbox\n --head Headers of a URI\n --options Check the options of a URI\n --get [options] Dereference a resource to RDF\n --post [options] Send notification to Inbox\n --put [options] Store data under a URI\n [options]\n --accept (m, default: application/ld+json)\n --contentType (m, default: application/ld+json)\n --slug string\n -d, --data \n -o, --outputType (m, default: application/ld+json)\n m: mimetype or format; jsonld, turtle\n```\n\n```shell\n$ node index.js --discoverInbox http://localhost:3000/ --accept \\\napplication/ld+json\n$ node index.js --getNotifications http://localhost:3000/inbox/abc --accept \\\napplication/ld+json\n$ node index.js --head http://localhost:3000/\n$ node index.js --get http://localhost:3000/ --accept application/ld+json\n$ node index.js --post http://localhost:3000/inbox/ --slug foo \\\n--contentType application/ld+json -d \\\n'[{\"@id\":\"http://example.org/foo\",\"http://schema.org/name\":\"Foo\"}]'\n$ node index.js --put http://localhost:3000/inbox/ --contentType \\\napplication/ld+json -d \\\n'[{\"@id\":\"http://example.org/foo\",\"http://schema.org/name\":\"Foo\"}]'\n```\n\nOr just curl:\n```shell\n# Get target URL\n$ curl -i -H'Accept: application/ld+json' http://localhost:3000/\n$ curl -I -H'Accept: application/ld+json' http://localhost:3000/\n$ curl -i -X OPTIONS -H'Accept: application/ld+json' http://localhost:3000/\n\n# Send to Inbox\n$ curl -i -X POST -H'Content-Type: application/ld+json' \\\n-d '[{\"@id\":\"\",\"http://schema.org/name\":\"Foo\"}]' http://localhost:3000/inbox/\n$ curl -i -X POST -H'Content-Type: text/turtle' \\\n-d '<> \"Bar\" .' http://localhost:3000/inbox/\n\n# Get Inbox URL\n$ curl -i -H'Accept: application/ld+json' http://localhost:3000/inbox/\n$ curl -i -H'Accept: application/ld+json, text/turtle' \\\nhttp://localhost:3000/inbox/\n$ curl -i -H'Accept: text/turtle, application/ld+json' \\\nhttp://localhost:3000/inbox/\n$ curl -I -H'Accept: application/ld+json' http://localhost:3000/inbox/\n$ curl -I -H'Accept: text/turtle' http://localhost:3000/inbox/\n\n# Location header in POST response\n$ curl -i http://localhost:3000/inbox/abc\n$ curl -i -H'Accept: application/ld+json' http://localhost:3000/inbox/abc\n$ curl -i -H'Accept: text/turtle' http://localhost:3000/inbox/abc\n$ curl -i -H'Accept: application/ld+json, text/turtle' \\\nhttp://localhost:3000/inbox/abc\n$ curl -i -H'Accept: text/turtle, application/ld+json' \\\nhttp://localhost:3000/inbox/abc\n$ curl -I http://localhost:3000/inbox/abc\n$ curl -I -H'Accept: application/ld+json' http://localhost:3000/inbox/abc\n$ curl -i -X OPTIONS -H'Accept: application/ld+json' \\\nhttp://localhost:3000/inbox/abc\n```\n\n## Dependencies\n* [SimpleRDF](https://github.com/simplerdf/simplerdf) (MIT License) used for RDF\n* [Express](https://github.com/expressjs/express)\n* and other node libraries for general plumbing\n\n## License\n[Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0)\n\nSee the files [LICENSE](LICENSE) and [NOTICE](NOTICE) for required notices.\n\n## See also\n* mayktso is based on [Linked Data Platform](https://www.w3.org/TR/ldp/)\nmechanisms\n* [Linked Data Notifications](https://www.w3.org/TR/ldn/) conformant (use\nmayktso as a receiver for your Inbox)\n* Motived by [node-solid-server](https://github.com/solid/node-solid-server)\n* Compliments [dokieli](https://github.com/linkeddata/dokieli)\n\n## Contributors\n* [Amy Guy](https://github.com/rhiaro)\n* [Benjamin Young](https://github.com/BigBlueHat)\n* [Dmitri Zagidulin](https://github.com/dmitrizagidulin)\n* [Ruben Taelman](https://github.com/rubensworks)\n* [Sarven Capadisli](https://github.com/csarven) (maintainer)\n* [Stian Soiland-Reyes](https://orcid.org/0000-0001-9842-9718)\n* Your name here. :)\n\n\n## How to contribute\n* Use it! Break things.\n* Report [issues](https://github.com/csarven/mayktso/issues/) and document.\n* Fix issues.\n* Request new features.\n* .. and however else you want to contribute.\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",953560054,"orgData","recentTags",[87,125,135,145],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},"content_type","creator",139533,"full_size",74029087,"id",26696085,"images",[97],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},"architecture","amd64","digest","sha256:044ea413d46c81447c5b2babd310b67e8b46cefb529fb0b62b73ccaed90fa5a1","features","","last_pulled","2026-09-26T14:51:07.852308269Z","last_pushed","2021-06-04T11:10:26Z","os","linux","os_features","os_version","size","variant","2021-06-04T11:10:25.814188Z","last_updater","last_updater_username","media_type","latest","repository",5456006,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_88":40,"_89":90,"_91":126,"_93":127,"_95":128,"_46":133,"_115":90,"_116":29,"_117":52,"_53":134,"_119":120,"_121":131,"_122":133,"_123":62,"_124":17},74024358,149185424,[129],{"_98":99,"_100":130,"_102":103,"_104":131,"_106":132,"_108":109,"_110":103,"_111":-5,"_112":126,"_59":62,"_113":-5},"sha256:3da0cf4382493276a89e97b885ed3fa2bddca5829db9c854a11ac8ea5f9c132d","2026-09-20T01:23:30.050356927Z","2021-05-11T05:06:54Z","2021-05-11T05:06:53.598659Z","dependabot_npm_and_yarn_hosted-git-info-2.8.9",{"_88":40,"_89":90,"_91":136,"_93":137,"_95":138,"_46":143,"_115":90,"_116":29,"_117":52,"_53":144,"_119":120,"_121":141,"_122":143,"_123":62,"_124":17},73786583,94157149,[139],{"_98":99,"_100":140,"_102":103,"_104":141,"_106":142,"_108":109,"_110":103,"_111":-5,"_112":136,"_59":62,"_113":-5},"sha256:ee555c331dbe97e935bcd3c920a1773ce15ff1b1f78dd0df82659c0d72389df4","2026-09-26T14:51:11.366205033Z","2020-04-06T07:19:10Z","2020-04-06T07:19:09.628832Z","dependabot_npm_and_yarn_minimist-1.2.3",{"_88":40,"_89":90,"_91":146,"_93":147,"_95":148,"_46":153,"_115":90,"_116":29,"_117":52,"_53":154,"_119":120,"_121":151,"_122":153,"_123":62,"_124":17},73767448,90948193,[149],{"_98":99,"_100":150,"_102":103,"_104":151,"_106":152,"_108":109,"_110":103,"_111":-5,"_112":146,"_59":62,"_113":-5},"sha256:0e7ce83b5e95589c384bf6f5d7c1f5bebead128cea9d6847a56c8da69c0c445e","2026-09-20T01:23:30.694663561Z","2020-03-17T07:44:45Z","2020-03-17T07:44:44.819831Z","dependabot_npm_and_yarn_minimist-1.2.2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.builds",{"_27":11,"_32":-5},"actionData","errors"]