{"id":48039073,"url":"https://github.com/dnrovs/mineos-market-js","last_synced_at":"2026-04-04T14:05:08.072Z","repository":{"id":301000802,"uuid":"1007814359","full_name":"dnrovs/mineos-market-js","owner":"dnrovs","description":"Client to interact with the MineOS App Market API","archived":false,"fork":false,"pushed_at":"2025-12-16T15:01:50.000Z","size":327,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-18T20:48:39.844Z","etag":null,"topics":["api","app-market","minecraft","mineos","opencomputers"],"latest_commit_sha":null,"homepage":"https://dnrovs.github.io/mineos-market-js/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dnrovs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-24T15:11:10.000Z","updated_at":"2025-12-16T15:01:53.000Z","dependencies_parsed_at":"2025-06-24T17:35:15.611Z","dependency_job_id":"e9a8e580-323a-47ba-b8f8-8cdd8013c8ce","html_url":"https://github.com/dnrovs/mineos-market-js","commit_stats":null,"previous_names":["dnrovs/mineos-market-js"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/dnrovs/mineos-market-js","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnrovs%2Fmineos-market-js","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnrovs%2Fmineos-market-js/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnrovs%2Fmineos-market-js/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnrovs%2Fmineos-market-js/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dnrovs","download_url":"https://codeload.github.com/dnrovs/mineos-market-js/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnrovs%2Fmineos-market-js/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31402277,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","app-market","minecraft","mineos","opencomputers"],"created_at":"2026-04-04T14:05:07.433Z","updated_at":"2026-04-04T14:05:08.062Z","avatar_url":"https://github.com/dnrovs.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mineos-market-js\n\n![NPM Version](https://img.shields.io/npm/v/mineos-market-client?style=flat)\n![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/dnrovs/mineos-market-js/ci-cd.yml?style=flat)\n![NPM Last Update](https://img.shields.io/npm/last-update/mineos-market-client?style=flat)\n![NPM Downloads](https://img.shields.io/npm/d18m/mineos-market-client?style=flat)\n\nA TypeScript/JavaScript client to interact with the MineOS App Market API.\n\n**[Documentation](https://dnrovs.github.io/mineos-market-js) | [MineOS](https://github.com/IgorTimofeev/MineOS)**\n\n## Installation\n```shell\nnpm i mineos-market-client\n```\n\n## Importing\n### ES Modules\n```javascript\nimport { MarketClient } from 'mineos-market-client'\n```\n### CommonJS\n```javascript\nconst { MarketClient } = require('mineos-market-client')\n```\n### Browser (CDN)\n```html\n\u003cscript src=\"https://cdn.jsdelivr.net/npm/mineos-market-client@3/dist/index.umd.min.js\"\u003e\u003c/script\u003e\n```\nIn this case, use `MineOSMarket` browser global.\n### Browser (module)\n```html\n\u003cscript type=\"importmap\"\u003e\n    {\n        \"imports\": {\n            \"mineos-market-client\": \"https://cdn.jsdelivr.net/npm/mineos-market-client@3/dist/index.js\",\n\n            \"camelcase-keys\": \"https://cdn.jsdelivr.net/npm/camelcase-keys@10.0.0/+esm\",\n            \"lua-json\": \"https://cdn.jsdelivr.net/npm/lua-json@1.0.1/+esm\",\n            \"zod\": \"https://cdn.jsdelivr.net/npm/zod@4.0.17/+esm\"\n        }\n    }\n\u003c/script\u003e\n```\n\n## Usage\n### First steps\nTo start using the client, you need to initialize an instance of the client and log in (optionally). To log in, use either username or e-mail.\n```javascript\nconst client = new MarketClient()\n\n// Authenticate and log the user's credentials.\n// You still can access some endpoints without this step.\nconsole.log(\n    await client.login({\n        userName: 'gooner',\n        password: '••••••••'\n    })\n)\n    \n// Also, you can retrieve the user's credentials without logging in (using the Auth service):\n// await client.auth.login({ userName: 'gooner', password: '••••••••' })\n\n// Or you can manually set the token:\n// client.useToken('87cf38207ffecd80eatmyass7aa8c85dd7ba5e677f7820c5cf')\n\n// Log the current token\nconsole.log(\n    client.getToken()\n)\n```\n### API Usage\nAll API methods are grouped into services.  \nEach service corresponds to a set of related endpoints (for example: `statistics`, `publications`, `messages`, etc.).\n\nYou can find the full list of services and their methods in the [API reference](https://dnrovs.github.io/mineos-market-js/modules.html#:~:text=Services).\n```javascript\n// Log the statistics data\nconsole.log(\n    await client.statistics.getStatistic()\n)\n    \n// Find and log 10 first publications with 'femboys' in the name\nconsole.log(\n    await client.publications.getPublications({ search: 'femboys', count: 10 })\n)\n\n// Send a message (this one requires auth)\nawait client.messages.sendMessage({ userName: 'dnrovs', text: 'you stink' })\n```\n### Configuration\nYou can configure some aspects of the client, such as changing the host URL or adding custom HTTP headers. Config type reference is [here](https://dnrovs.github.io/mineos-market-js/types/Config.html).\n```javascript\n// Partially rewrite a default config\nclient.useConfig({\n    hostUrl: 'https://custom-market-api.cc/',        // Custom host URL.\n    proxyUrl: 'https://corsproxy.io/?url=',          // Proxy URL. Appends before the host URL, useful for CORS bypass.\n    userAgent: 'Mozilla/1.4.88 (Linux, Android 10)', // Custom UA. Set to 'undefined' to remove it from the headers.\n    headers: { Accept: 'image/*' }                   // Custom request headers.\n})\n\n// Log the current client config \nconsole.log(\n    client.getConfig()\n)\n```\n\n## Credits\n- [MineOS-Market-Client](https://github.com/CoolCat467/MineOS-Market-Client) by [CoolCat467](https://github.com/CoolCat467)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdnrovs%2Fmineos-market-js","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdnrovs%2Fmineos-market-js","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdnrovs%2Fmineos-market-js/lists"}