{"id":19273977,"url":"https://github.com/rintoj/hypergraph-server","last_synced_at":"2026-06-15T03:33:31.504Z","repository":{"id":177255985,"uuid":"660159371","full_name":"rintoj/hypergraph-server","owner":"rintoj","description":null,"archived":false,"fork":false,"pushed_at":"2023-07-21T07:05:04.000Z","size":143,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-01-02T22:41:14.307Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/rintoj.png","metadata":{"files":{"readme":"README.md","changelog":null,"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}},"created_at":"2023-06-29T11:25:14.000Z","updated_at":"2023-06-29T11:25:48.000Z","dependencies_parsed_at":null,"dependency_job_id":"bffb0d61-7118-4519-9590-e7d4d27ff59c","html_url":"https://github.com/rintoj/hypergraph-server","commit_stats":{"total_commits":5,"total_committers":1,"mean_commits":5.0,"dds":0.0,"last_synced_commit":"70b647d5445033552c11f8be06ac69014657275a"},"previous_names":["rintoj/hypergraph-server"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/rintoj/hypergraph-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rintoj%2Fhypergraph-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rintoj%2Fhypergraph-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rintoj%2Fhypergraph-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rintoj%2Fhypergraph-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rintoj","download_url":"https://codeload.github.com/rintoj/hypergraph-server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rintoj%2Fhypergraph-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34346867,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"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-09T20:44:41.816Z","updated_at":"2026-06-15T03:33:31.489Z","avatar_url":"https://github.com/rintoj.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hypergraph Server\n\nWith the help of this package you can spin off a service to serve a REST or GraphQL endpoint\n\n## Install\n\nUsing npm:\n\n```sh\nnpm install @hgraph/server\n```\n\nUsing yarn:\n\n```sh\nyarn add @hgraph/server\n```\n\n## Usage\n\nSetup a service\n\n```sh\nmkdir my-service\ncd my-service\nyarn init -y\n```\n\nSetup `src/index.ts`\n\n```ts\nimport 'reflect-metadata'\n\nimport { initializeGraphqlServer } from 'hypergraph-graphql'\nimport { bootstrapServer, createMiddleware } from '@hgraph/server'\nimport { createSchema } from './schema'\n\nasync function run() {\n  await bootstrapServer({\n    port: 4000,\n    apiRoot: '/api',\n    controllers: [`${__dirname}/**/*-controller.ts`],\n  })\n}\n\nvoid run()\n```\n\nAdd controller\n\n```ts\nimport { Controller, Get } from '@hgraph/server'\n\n@Controller('/user')\nexport class UserController {\n  @Get('/me')\n  async findCurrentUser() {\n    return { user: null } // your logic\n  }\n}\n```\n\nStart the service\n\n```bash\nnpx ts-node src/index.ts\n```\n\nThis will expose a GET url [http://localhost:4000/api/user/me](http://localhost:4000/api/user/me)\n\n```bash\n[2023-06-29T16:43:35.723] [INFO ] [TSED] - Injector created... +3ms\n[2023-06-29T16:43:35.723] [INFO ] [TSED] - Build providers +0ms\n[2023-06-29T16:43:35.734] [INFO ] [TSED] - Settings and injector loaded... +11ms\n[2023-06-29T16:43:35.736] [INFO ] [TSED] - Load routes +2ms\n[2023-06-29T16:43:35.736] [INFO ] [TSED] - Routes mounted... +0ms\n[2023-06-29T16:43:35.737] [INFO ] [TSED] -\n┌───────────────┬──────────────┬──────────────────────────────────┐\n│ Method        │ Endpoint     │ Class method                     │\n│───────────────│──────────────│──────────────────────────────────│\n│ GET           │ /api/user/me │ UserController.findCurrentUser() │\n└───────────────┴──────────────┴──────────────────────────────────┘\n[2023-06-29T16:43:35.738] [INFO ] [TSED] - Listen server on http://0.0.0.0:4001\n[2023-06-29T16:43:35.738] [INFO ] [TSED] - Started in 18 ms +2ms\n```\n\n## Adding GraphQL\n\nCreate `src/schema.ts`\n\n```ts\nimport { createGraphqlSchema, referenceResolver } from 'hypergraph-graphql'\n\nexport async function createSchema() {\n  return await createGraphqlSchema({\n    resolvers: [`${__dirname}/**/*-resolver.ts`],\n    referenceResolvers: {\n      // User: referenceResolver(UserRepository),\n    },\n    authChecker: () =\u003e true,\n  })\n}\n```\n\nModify `src/index.ts`\n\n```ts\nasync function run() {\n  const schema = await createSchema()\n  const router = initializeGraphqlServer({ schema })\n  await bootstrapServer({\n    port: 4000,\n    apiRoot: '/api',\n    controllers: [`${__dirname}/**/*-controller.ts`],\n    middlewares: [createMiddleware(router)],\n  })\n}\n```\n\nCreate a user schema by adding `src/schema/user/user-schema.ts`\n\n```ts\nimport { Field, ObjectType } from 'type-graphql'\nimport { Repository } from 'hypergraph-storage'\n\n@ObjectType()\nexport class User {\n  @Field()\n  id!: string\n\n  @Field()\n  name?: string\n}\n```\n\nAdd resolver `src/resolver/user/user-resolver.ts`\n\n```ts\nimport { Query, Resolver } from 'type-graphql'\nimport { User } from '../../schema/user/user'\n\n@Resolver()\nexport class UserResolver {\n  @Query(() =\u003e User, { nullable: true })\n  me() {\n    return null\n  }\n}\n```\n\nNow start the service. This will expose a new endpoint\n[http://localhost:4000/graphql](http://localhost:4000/graphql)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frintoj%2Fhypergraph-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frintoj%2Fhypergraph-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frintoj%2Fhypergraph-server/lists"}