{"id":19111031,"url":"https://github.com/merokudao/storekit-sdk","last_synced_at":"2026-02-09T03:04:11.416Z","repository":{"id":65173767,"uuid":"585508318","full_name":"merokudao/storekit-sdk","owner":"merokudao","description":"NodeJS SDK for Meroku StoreKit","archived":false,"fork":false,"pushed_at":"2024-01-10T10:31:46.000Z","size":581,"stargazers_count":1,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-19T21:47:55.281Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://merokudao.github.io/storekit-sdk/","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/merokudao.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,"zenodo":null}},"created_at":"2023-01-05T10:55:34.000Z","updated_at":"2023-08-01T07:27:55.000Z","dependencies_parsed_at":"2025-04-18T22:43:54.075Z","dependency_job_id":"99ec651b-2c6f-4786-8f18-b4312d8d0a06","html_url":"https://github.com/merokudao/storekit-sdk","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/merokudao/storekit-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/merokudao%2Fstorekit-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/merokudao%2Fstorekit-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/merokudao%2Fstorekit-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/merokudao%2Fstorekit-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/merokudao","download_url":"https://codeload.github.com/merokudao/storekit-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/merokudao%2Fstorekit-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29255394,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-09T01:52:29.835Z","status":"online","status_checked_at":"2026-02-09T02:00:09.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-11-09T04:26:52.516Z","updated_at":"2026-02-09T03:04:11.401Z","avatar_url":"https://github.com/merokudao.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## @merokudao/storekit-sdk\n\nThis is the NodeJS Typescript SDK for API described at [https://github.com/merokudao/storekit/blob/main/apps/docs/public/api-specs/meroku-server.yml](https://github.com/merokudao/storekit/blob/main/apps/docs/public/api-specs/meroku-server.yml) and hosted at [https://docs.meroku.store](https://docs.meroku.store).\n\nThis package is generated using Swagger CodeGen. More details on that follows the usage section.\n\nThe versioning of this package is consistent with the API spec version. So if you are using OpenAPI Spec\nv 1.21, then the package should be `1.21`.\n\n**T O C**\n\n- [Install](#install)\n- [Registry Use](#registry-use)\n- [Analytics](#analytics)\n  * [Visit a dApp's Home Page](#visit-a-dapp-s-home-page)\n  * [Download a dApp's Build](#download-a-dapp-s-build)\n  * [Post a rating for dapp by user](#post-a-rating-for-dapp-by-user)\n  * [Get a rating for dapp by user](#get-a-rating-for-dapp-by-user)\n- [Featured Section](#featured-section)\n  * [Get Featured Sections and the dapps in them.](#get-featured-sections-and-the-dapps-in-them)\n  * [Get Store Title](#get-store-title)\n\n\n# Install\n\n`npm install @merokudao/storekit-sdk`\n\nor\n\n`yarn add @merokudao/storekit-sdk`\n\n\n\n# Registry Use\n\n```typescript\n\nimport {\n  DAppRegistryApi,\n  Dapp,\n  DappAvailableOnPlatformEnum,\n  StoreRegistryApi,\n  DappCategoryEnum,\n  DappWithDevCreds,\n  DeveloperProfilesApi,\n} from '@merokudao/storekit-sdk';\n\nconst baseURL = process.env.STOREKIT_API_URL as string | 'https://api.meroku.store';\n\n// Configure the API and instantiate\nconst dAppRegistryAPI = new DAppRegistryApi(\n  {\n    basePath: baseURL\n  },\n  undefined,\n  undefined\n);\n\n// Get the dApps list\nconst dApps: Dapp[] = await dAppRegistryAPI.searchDapps();\n```\n\n\n# Analytics\n\nThere are URLs that support visit to an app's webapp or download the\nbuild for an app. These methods should be used instead of raw linking,\nbecause these store details about visits, downloads, installs and uninstalls.\nThese metrics are used to prepare trending dapps.\n\nGetting a dapp will always send it's global metrics.\n\n\n## Visit a dApp's Home Page\n\n\nThe URL to visit a dapp's home page should be constructed as below. The return\nvalue of `getViewURL` should be shown on the UI. When user clicks on it,\nthey will be redirected to the dapp home page.\n\n```typescript\n\n\nconst basePath = process.env.STOREKIT_API_URL as string | 'https://api.meroku.store';\n\nconst dappId = \"example.app\";\n\nconst getViewURL = (base_path: string,\n  dappId: string,\n  userId: string | undefined,\n  userAddress: string | undefined) =\u003e {\n    if (!userId \u0026\u0026 !userAddress) {\n      throw Error(\"One of userId or userAddress must be defined\");\n    }\n\n    if (userId) {\n      return `${base_path}/api/v1/o/view/${dappId}?userId=${userId}`;\n    } else if (userAddress) {\n      return `${base_path}/api/v1/o/view/${dappId}?userAddress=${userAddress}`;\n    }\n}\n\n```\n\n\n## Download a dApp's Build\n\n```typescript\n\nAnalyticsApi.new()\n\nconst getDownloadURL = (base_path: string,\n  dappId: string,\n  userId: string | undefined,\n  userAddress: string | undefined) =\u003e {\n    if (!userId \u0026\u0026 !userAddress) {\n      throw Error(\"One of userId or userAddress must be defined\");\n    }\n\n    if (userId) {\n      return `${base_path}/api/v1/o/download/${dappId}?userId=${userId}`;\n    } else if (userAddress) {\n      return `${base_path}/api/v1/o/download/${dappId}?userAddress=${userAddress}`;\n    }\n}\n\n```\n\n\nIn the UI the return value of `getDownloadURL` should be shown. When user\nclicks on it, they will be redirected to the download URL and the file will\nbe automatically downloaded.\n\n\n## Post a rating for dapp by user\n\n\n```typescript\n\nconst analyticsApi = new AnalyticsApi({\n    basePath: baseURL\n});\n\nconst body: DappRating = {\n  dappId: 'test_example.app',\n  rating: 4,\n  comment: 'comment from user',\n  userId: 12\n};\nconst response: DappRating = await analyticsApi.apiV1DappRatePost(body)\n\n```\n\n## Get a rating for dapp by user\n\n```typescript\n\nconst dappId = 'test_example.dapp';\nconst userId = 2;\nconst userAddress = undefined;\nconst response: DappRating = await analyticsApi.apiV1DappRateGet(dappId, userId, userAddress);\n\n```\n\n# Featured Section\n\nInitialise the API as below.\n\n```typescript\nconst featuredApi = new FeaturedSectionApi({\n\t    basePath: baseURL\n\t});\n\n```\n\n## Get Featured Sections and the dapps in them.\n\n```typescript\nconst featuredSections: Array\u003cFeaturedSection\u003e = await featuredApi.getFeaturedDAppsV1()\n```\n\nThis should be iterated and shown on ui.\n\n## Get Store Title\n\nGets the title of the registry\n\n```typescript\nconst title: string = await featuredApi.getStoreTitleV1()\n```\n\n# AppStores\n\n```typescript\n  const storeApi = new StoreRegistryApi()\n```\n\nAPis to interact with appStore's\n\n## Get/Search appStore's\n\n```typescript\nconst stores = await storeApi.searchStores()\n```\n\n## Search store by storeId/key\n\n```typescript\nconst stores = await storeApi.searchStoresByStoreId('kailash')\n```\n## Get appStore's by owner address\n\n```typescript\nconst stores = await storeApi.searchStoresByOwnerAddress('0xA0B867319e3fBb15181D118097b1069C6380222E')\n```\n\n## Search for Autocomplete appStore's search\n\n```typescript\nconst stores = await storeApi.autocompleteStores('unstoppable')\n```\n\n\n# Developers\n\n```typescript\n  const developerApi = new DeveloperProfilesApi()\n```\n\nAPis to interact with developer's\n\n## Get/Search developer's\n\n```typescript\nconst developers = await developerApi.searchDeveloperProfile()\n```\n\n## Search store by storeId/key\n\n```typescript\nconst developers = await developerApi.searchDeveloperByDevId('kai.dev')\n```\n## Get developer's by owner address\n\n```typescript\nconst developers = await developerApi.searchDeveloperByOwnerAddress('0xA0B867319e3fBb15181D118097b1069C6380222E')\n```\n\n## Search for Autocomplete developer's search\n\n```typescript\nconst developers = await developerApi.autocompleteDeveloper('kai')\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmerokudao%2Fstorekit-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmerokudao%2Fstorekit-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmerokudao%2Fstorekit-sdk/lists"}