{"id":46917,"library":"ametnisi","title":"ametnisi","description":"A lightweight gRPC health check implementation using @grpc/grpc-js (v1.3.0). Provides a simple way to implement the standard gRPC health checking protocol for Node.js services. Compatible with gRPC health probes like Kubernetes liveness/readiness checks. Uses the stable @grpc/grpc-js library (not the deprecated grpc package). Release cadence is irregular; last update was 2 years ago.","status":"maintenance","version":"1.3.0","language":"javascript","source_language":"en","source_url":"https://github.com/NicholeReilly/ametnisi","tags":["javascript","eveniet","grpc","natus"],"install":[{"cmd":"npm install ametnisi","lang":"bash","label":"npm"},{"cmd":"yarn add ametnisi","lang":"bash","label":"yarn"},{"cmd":"pnpm add ametnisi","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency for gRPC client and server implementation","package":"@grpc/grpc-js","optional":true},{"reason":"Required for protocol buffer message handling","package":"protobufjs","optional":false}],"imports":[{"note":"ESM-only since v1.0; CommonJS require() will throw. Use ESM import.","wrong":"const { HealthCheckClient } = require('ametnisi')","symbol":"HealthCheckClient","correct":"import { HealthCheckClient } from 'ametnisi'"},{"note":"Named export; not a namespace import. Use named import.","wrong":"import * as ametnisi from 'ametnisi'","symbol":"HealthCheckServer","correct":"import { HealthCheckServer } from 'ametnisi'"},{"note":"Use type import for type-only exports (TS). Runtime import will fail.","wrong":"import { HealthCheckStatus } from 'ametnisi'","symbol":"Types","correct":"import type { HealthCheckStatus } from 'ametnisi'"}],"quickstart":{"code":"import { HealthCheckServer } from 'ametnisi';\nimport { credentials } from '@grpc/grpc-js';\n\nconst server = new HealthCheckServer({\n  url: 'localhost:50051',\n  credentials: credentials.createInsecure()\n});\n\nserver.start(() => {\n  console.log('Health check server started');\n});\n\nprocess.on('SIGINT', () => {\n  server.stop(() => process.exit(0));\n});","lang":"typescript","description":"Creates a gRPC health check server on localhost:50051 and logs a message on start. Handles graceful shutdown on SIGINT."},"warnings":[{"fix":"npm install @grpc/grpc-js@^1.4.0","message":"The package uses @grpc/grpc-js as a peer dependency; ensure @grpc/grpc-js >=1.4.0 is installed.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Update instantiation: new HealthCheckClient({ url: 'localhost:50051', credentials: creds })","message":"In v1.2.0, the HealthCheckClient constructor changed from (address, credentials) to ({ url, credentials }).","severity":"breaking","affected_versions":">=1.2.0"},{"fix":"Replace 'healthCheckStatus' with 'HealthCheckStatus'","message":"The 'healthCheckStatus' export (lowercase) was deprecated in v1.1.0. Use 'HealthCheckStatus' (PascalCase) instead.","severity":"deprecated","affected_versions":">=1.1.0 <2.0.0"}],"env_vars":null,"search_vec":"'2':52 'ago':54 'ametnisi':1 'cadenc':46 'check':6,21,34 'compat':26 'deprec':42 'eveniet':56 'grpc':4,19,28,43,57 'grpc/grpc-js':9,38 'health':5,20,29 'implement':7,16 'irregular':48 'javascript':55 'kubernet':32 'last':49 'librari':39 'lightweight':3 'like':31 'liveness/readiness':33 'natus':58 'node.js':24 'packag':44 'probe':30 'protocol':22 'provid':11 'releas':45 'servic':25 'simpl':13 'stabl':37 'standard':18 'updat':50 'use':8,35 'v1.3.0':10 'way':14 'year':53","created_at":"2026-06-07T16:48:13.623919+00:00","updated_at":"2026-06-07T16:48:13.623919+00:00","problems":[{"fix":"npm install @grpc/grpc-js","cause":"Missing peer dependency @grpc/grpc-js","error":"Error: Cannot find module '@grpc/grpc-js'"},{"fix":"Use 'import { HealthCheckServer } from 'ametnisi'' instead of require()","cause":"Using CommonJS require() instead of ESM import()","error":"TypeError: server.start is not a function"},{"fix":"Use { url: 'http://localhost:50051' } or just 'localhost:50051' if using the object config","cause":"Missing protocol in URL string (should be 'http://localhost:50051' or use object config)","error":"Error: Invalid URL: 'localhost:50051'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/NicholeReilly/ametnisi.git","github":"https://github.com/NicholeReilly/ametnisi","docs":null,"changelog":null,"pypi":null,"npm":"ametnisi","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}