{"id":15392707,"url":"https://github.com/aaronvanston/up-graph","last_synced_at":"2025-10-17T18:03:16.964Z","repository":{"id":49991873,"uuid":"285977408","full_name":"aaronvanston/up-graph","owner":"aaronvanston","description":"Unofficial GraphQL layer for Up bank API","archived":false,"fork":false,"pushed_at":"2024-04-11T11:58:14.000Z","size":290,"stargazers_count":5,"open_issues_count":11,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-04-14T06:19:06.032Z","etag":null,"topics":["banking","banking-api","graphql","graphql-server","upbank"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aaronvanston.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2020-08-08T05:09:00.000Z","updated_at":"2024-06-28T11:25:28.908Z","dependencies_parsed_at":"2023-12-29T14:30:31.795Z","dependency_job_id":"2c7613bb-f396-48b2-8007-72aeb6ec3f86","html_url":"https://github.com/aaronvanston/up-graph","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronvanston%2Fup-graph","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronvanston%2Fup-graph/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronvanston%2Fup-graph/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronvanston%2Fup-graph/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aaronvanston","download_url":"https://codeload.github.com/aaronvanston/up-graph/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241212185,"owners_count":19927897,"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":["banking","banking-api","graphql","graphql-server","upbank"],"created_at":"2024-10-01T15:15:45.278Z","updated_at":"2025-10-17T18:03:11.933Z","avatar_url":"https://github.com/aaronvanston.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg alt=\"up-graph\" src=\"./assets/up-graph.png\" /\u003e\n\u003c/div\u003e\n\n# up-graph 😎\n\nUnofficial GraphQL layer for [Up bank API](https://developer.up.com.au/)\n\n**Built using:**\n\n- [Koa node framework](https://github.com/koajs/koa)\n- [GraphQL Modules](https://graphql-modules.com/)\n- [TypeScript](https://www.typescriptlang.org/)\n\n## Supported functionality\n\n- Accounts - `list`, `get`\n- Ping - `get`\n- Tags - `list`, `add to transaction`, `remove from transaction`\n- Transactions - `list`, `get`, `list by account`\n- Webhooks - `list`, `get`, `create`, `delete`, `ping`, `list logs`\n\nView the [GitHub project for this repo](https://github.com/aaronvanston/up-graph/projects) to track real time progress of functionality.\n\n## Running Locally\n\n### Starting the dev server\n\n1. Install dependencies\n\n```bash\nyarn install\n```\n\n2. Start the server\n\n```bash\nyarn start\n```\n\nThe local dev server will now start on [http://localhost:3000](http://localhost:3000)\n\n### Playground\n\nAccess and use the GraphQL playground after starting your server at [http://localhost:3000/graphql](http://localhost:3000/graphql)\n\nTo test and verify successful connection you can query the version of the GraphQL server:\n\n**Query:**\n\n```graphql\nquery {\n  version\n}\n```\n\n**Response:**\n\n```json\n{\n  \"data\": {\n    \"version\": \"local\"\n  }\n}\n```\n\n### Authorisation\n\nTo access the UP API An `Authorization` HTTP header is required.\nThis GraphQL servers forwards across any supplied `Authorization` to UP.\n\nTo get your very own personal access token for UP, visit their [getting started page](https://api.up.com.au/getting_started).\n\nFor all secure operations (every query/mutation other than version).\nYou are required to ad the auth token. Inside of the Playground you can add an `Authorization` HTTP header under the `HTTP HEADER` tab, and add your unique token.\n\n```json\n{\n  \"Authorization\": \"Bearer up:yeah:\u003ctoken\u003e\"\n}\n```\n\nOnce authorised, you may run a secure operation such as the ping query to test full end-to-end.\n\n**Query:**\n\n```graphql\nquery {\n  ping {\n    meta {\n      id\n      statusEmoji\n    }\n  }\n}\n```\n\n**Response:**\n\n```json\n{\n  \"data\": {\n    \"ping\": {\n      \"meta\": {\n        \"id\": \"\u003cid\u003e\",\n        \"statusEmoji\": \"⚡️\"\n      }\n    }\n  }\n}\n```\n\n### Testing and linting\n\n#### Running test suite\n\nComing soon™\n\n#### Running code linting\n\nTo run and verify tslint, you can run\n\n```bash\nyarn lint\n```\n\n### Generating Types\n\nThe schema for this GraphQL server is automatically generated by the type definitions for the queries and mutations.\n\nThese are auto-generated using [GraphQL code generator](https://graphql-code-generator.com/) at build.\nYou can manually trigger it by running:\n\n```bash\nyarn codegen\n```\n\nThis will refresh the schema `src/modules/schema.d.ts`.\n\n## Adding a new module\n\nTo add a new module (resource) to up-graph:\n\n1. Create new folder within `src/modules`\n1. Build out the type definitions for the resource, query and mutations by creating a `type-defs.ts` file.\n1. Run `yarn codegen` to generate the schema from these types\n1. Create your resolvers if required\n1. Create a `index.ts` within the modules, wiring up the data source, types and resolvers\n1. Add the module to `src/modules/index.ts`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaronvanston%2Fup-graph","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faaronvanston%2Fup-graph","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaronvanston%2Fup-graph/lists"}