{"id":22727759,"url":"https://github.com/pagopa/io-wallet","last_synced_at":"2026-04-16T09:01:05.293Z","repository":{"id":171671953,"uuid":"648251545","full_name":"pagopa/io-wallet","owner":"pagopa","description":"Wallet Provider implementation for IT-Wallet","archived":false,"fork":false,"pushed_at":"2026-04-14T08:04:42.000Z","size":11055,"stargazers_count":15,"open_issues_count":0,"forks_count":3,"subscribers_count":31,"default_branch":"master","last_synced_at":"2026-04-14T09:29:59.266Z","etag":null,"topics":["eudiw","io","it-wallet"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":false,"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/pagopa.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":"CODEOWNERS","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":"2023-06-01T14:38:34.000Z","updated_at":"2026-04-14T08:04:45.000Z","dependencies_parsed_at":"2024-03-27T09:27:03.462Z","dependency_job_id":"fa8ca9f0-3249-4fb3-b1c0-1ab41a9b3dd7","html_url":"https://github.com/pagopa/io-wallet","commit_stats":null,"previous_names":["pagopa/io-wallet"],"tags_count":208,"template":false,"template_full_name":null,"purl":"pkg:github/pagopa/io-wallet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pagopa%2Fio-wallet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pagopa%2Fio-wallet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pagopa%2Fio-wallet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pagopa%2Fio-wallet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pagopa","download_url":"https://codeload.github.com/pagopa/io-wallet/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pagopa%2Fio-wallet/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31878830,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T07:36:03.521Z","status":"ssl_error","status_checked_at":"2026-04-16T07:35:53.576Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["eudiw","io","it-wallet"],"created_at":"2024-12-10T17:13:28.691Z","updated_at":"2026-04-16T09:01:05.267Z","avatar_url":"https://github.com/pagopa.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IO Wallet\n\n## Introduction\n\nWelcome! 😊\n\nThis is the `io-wallet` project mono-repository containing applications and packages for the IO Wallet app:\n\n- `apps/io-wallet-support-func`: Contains functionalities for assistance and support.\n- `apps/io-wallet-user-func`: Contains functionalities for end users.\n- `packages/io-wallet-common`: Contains shared code among the workspaces.\n- `infra`: Contains Terraform code for provisioning and managing the IO Wallet infrastructure on Azure.\n\n## Architecture\n\nThe diagram below shows the cloud architecture of the resources deployed.\n\n![architecture-diagram](./architecture/cloud_architecture.svg)\n\n## Technologies\n\nThis project is built with [NodeJS](https://nodejs.org/) and deployed on [Azure Cloud](https://learn.microsoft.com/en-us/azure/?product=popular), utilizing [Azure Functions](https://learn.microsoft.com/en-us/azure/azure-functions/) and [Azure CosmosDB](https://learn.microsoft.com/en-us/azure/cosmos-db/).\n\nIt leverages [TypeScript](https://www.typescriptlang.org/), [fp-ts](https://gcanti.github.io/fp-ts/), and several [Azure SDKs](https://azure.github.io/azure-sdk/#javascript).\n\nWe use [pnpm](https://pnpm.io/) as the dependencies manager and [Turborepo](https://turbo.build/repo/docs) as the monorepo manager.\n\nInfrastructure is managed with [Terraform](https://www.terraform.io/).\n\nChangelog and versioning are managed with [Changesets](https://github.com/changesets/changesets).\n\n### Setting the Azure Subscription to Access the Dev CosmosDB\n\nTo start the function apps `io-wallet-support-func` and `io-wallet-user-func`, you must first log in on Azure and set the subscription you want to use. Ensure you have the Azure `az-cli` package installed. If not, follow the instructions on the [official website](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli).\n\nThis process is necessary for local function apps to connect to the development CosmosDB instance on Azure:\n\n```bash\naz login                                        # Redirects to your main browser for login.\n\naz account set --subscription DEV-IO            # Sets the DEV-IO subscription for backend apps to connect to the dev CosmosDB.\n\naz ad user show --id YOUR_EMAIL                 # Retrieves user info by email. Copy the \"id\" value from the output and use it as PRINCIPAL_ID in the next command.\n\naz cosmosdb sql role assignment create\n    --account-name io-d-itn-common-cosno-01\n    --resource-group io-d-itn-common-rg-01\n    --scope \"/\" --principal-id PRINCIPAL_ID\n    --role-definition-id\n        00000000-0000-0000-0000-000000000002    # Grants read and write access to the dev CosmosDB.\n```\n\n### Install the Azure Functions Core Tools\n\nTo run Azure Functions locally, you need to install the Azure Functions Core Tools.\nPlease follow the official instructions here:\n\nhttps://learn.microsoft.com/en-us/azure/azure-functions/functions-run-local?tabs=macos%2Cisolated-process%2Cnode-v4%2Cpython-v2%2Chttp-trigger%2Ccontainer-apps\u0026pivots=programming-language-javascript#install-the-azure-functions-core-tools\n\n### Installation\n\n```bash\npnpm install\n```\n\n### Tasks\n\nAt the root level, you can run the following commands:\n\n```bash\npnpm test           # Run all unit tests (performed by vitest) for all projects and packages.\n\npnpm format         # Run code formatting (performed by prettier) for all projects and packages.\n\npnpm lint           # Run code linting (performed by ESLint) for all projects and packages without fixing errors or warnings.\n\npnpm lint:fix       # Run code linting (performed by ESLint) for all projects and packages, attempting to fix correctable errors/warnings.\n\npnpm build          # Run a build (performed by tsup-node) for all projects and packages. Build results are stored under the dist/ directory.\n\npnpm code-review    # Run typechecking, code linting, and unit testing for each project and package. This command ensures code quality in PRs.\n```\n\nYou can also run specific commands using `pnpm --filter \u003cpackage-selector\u003e` for a specific project or package. Replace `PROJECT_NAME` with the actual project name:\n\n```bash\n# Typecheck\n\n# Linting and formatting\npnpm --filter PROJECT_NAME run lint\npnpm --filter PROJECT_NAME run lint:fix\npnpm --filter PROJECT_NAME run format\n\n# Unit testing\npnpm --filter PROJECT_NAME run test\npnpm --filter PROJECT_NAME run test:coverage # Not available for io-wallet-common\n\n# Build\npnpm --filter PROJECT_NAME run build\npnpm --filter PROJECT_NAME run build:watch # Not available for io-wallet-common\n\n# Start\npnpm --filter PROJECT_NAME run start # Not available for io-wallet-common\n```\n\n`PROJECT_NAME` can be one of the following:\n\n- `io-wallet-support-func`\n- `io-wallet-user-func`\n- `io-wallet-common`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpagopa%2Fio-wallet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpagopa%2Fio-wallet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpagopa%2Fio-wallet/lists"}