{"id":16397314,"url":"https://github.com/foxriver76/node-bring-api","last_synced_at":"2025-04-05T15:09:55.606Z","repository":{"id":34392958,"uuid":"175035933","full_name":"foxriver76/node-bring-api","owner":"foxriver76","description":"Node module to mange Bring! shopping lists","archived":false,"fork":false,"pushed_at":"2025-01-21T17:01:14.000Z","size":257,"stargazers_count":64,"open_issues_count":10,"forks_count":10,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-29T14:11:22.397Z","etag":null,"topics":["bring","node","shopping-list","typescript","zero-dependency"],"latest_commit_sha":null,"homepage":"","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/foxriver76.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"foxriver76","custom":"https://www.paypal.me/foxriver76"}},"created_at":"2019-03-11T16:02:06.000Z","updated_at":"2025-03-28T07:34:09.000Z","dependencies_parsed_at":"2024-06-18T22:46:44.508Z","dependency_job_id":"62532266-7362-45b3-b5c4-154592bb5cb7","html_url":"https://github.com/foxriver76/node-bring-api","commit_stats":{"total_commits":37,"total_committers":4,"mean_commits":9.25,"dds":"0.10810810810810811","last_synced_commit":"96c78ca00831cbd705d6a13025b1e5a5646c0db2"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foxriver76%2Fnode-bring-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foxriver76%2Fnode-bring-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foxriver76%2Fnode-bring-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foxriver76%2Fnode-bring-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/foxriver76","download_url":"https://codeload.github.com/foxriver76/node-bring-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247353749,"owners_count":20925329,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["bring","node","shopping-list","typescript","zero-dependency"],"created_at":"2024-10-11T05:09:48.538Z","updated_at":"2025-04-05T15:09:55.588Z","avatar_url":"https://github.com/foxriver76.png","language":"TypeScript","readme":"# Node-Bring-Shopping\n[![NPM version](http://img.shields.io/npm/v/bring-shopping.svg)](https://www.npmjs.com/package/bring-shopping)\n[![Downloads](https://img.shields.io/npm/dm/bring-shopping.svg)](https://www.npmjs.com/package/bring-shopping)\n![Build Status](https://github.com/foxriver76/node-bring-api/workflows/Test%20and%20Release/badge.svg)\n\nA __zero dependency__ node module for Bring! shopping lists __entirely written in TypeScript__.\n\n## Disclaimer\nThe developers of this module are in no way endorsed by or affiliated with\nBring! Labs AG, or any associated subsidiaries, logos or trademarks.\n\n## Installation\n```npm install bring-shopping --production```\n\n## Usage Example\n\n```javascript\nconst bringApi = require(`bring-shopping`);\n\nmain();\n\nasync function main () {\n    // provide user and email to login\n    const bring = new bringApi({mail: `example@example.com`, password: `secret`});\n    \n    // login to get your uuid and Bearer token\n    try {\n        await bring.login();\n        console.log(`Successfully logged in as ${bring.name}`);\n    } catch (e) {\n        console.error(`Error on Login: ${e.message}`);\n    }   \n    \n    // get all lists and their listUuid\n    const lists = await bring.loadLists();\n    \n    // get items of a list by its list uuid\n    const items = await bring.getItems('9b3ba561-02ad-4744-a737-c43k7e5b93ec');\n    \n    // get translations\n    const translations = await bring.loadTranslations('de-DE');\n} \n```\n\nMore important methods are `getItems(listUUID)`, `getItemsDetails(listUUID)`, `saveItem(listUuid, itemName, specificaiton)`, \n`moveToRecentList(listUuid, itemName)` and `getAllUsersFromList(listUuid)`.\n\n## Changelog\n### 2.0.1 (2025-01-21)\n* (@foxriver76) also throw on http errors\n\n### 2.0.0 (2024-11-27)\n* (@foxriver76) ported to native `fetch` module (BREAKING: Requires Node.js 18 or above)\n\n### 1.5.1 (2022-10-31)\n* (foxriver76) updated types\n* (foxriver76) fixed `removeItemImage` as headers were missing\n\n### 1.5.0 (2022-10-31)\n* (Aliyss) added methods to link an image to an item (PR #221)\n\n### 1.4.3 (2022-05-01)\n* (foxriver76) fixed typos in types (thanks to @Squawnchy)\n\n### 1.4.2 (2021-08-12)\n* (foxriver76) restructure to typescript\n\n### 1.3.1 (2021-04-29)\n* (foxriver76) fixed issue where error was used instead of the mssage on `getPendingInvitations`\n\n### 1.3.0 (2020-10-05)\n* (mdhom) added `getItemsDetails` method\n* (foxriver76) now reject with real errors instead of strings\n\n### 1.2.3 (2019-09-22)\n* (foxriver76) on new call of login overwrite bearer header to allow reauth\n\n### 1.2.2\n* (foxriver76) More information on rejection of getItems\n\n### 1.2.1\n* (foxriver76) minor fix\n\n### 1.2.0\n* (foxriver76) new functionalities -\u003e getTranslations, getCatalog and getPendingInvitations\n\n### 1.1.0\n* (foxriver76) use API version v2\n\n### 1.0.2\n* (foxriver76) minor code optimization, nothing functional\n\n### 1.0.1\n* (foxriver76) fix links in package\n\n### 1.0.0\n* (foxriver76) offical release\n\n","funding_links":["https://github.com/sponsors/foxriver76","https://www.paypal.me/foxriver76"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoxriver76%2Fnode-bring-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffoxriver76%2Fnode-bring-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoxriver76%2Fnode-bring-api/lists"}