Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

nodejs-service-foundations

/nodejs-service-foundations

Ustawia lub utwardza podstawy usługi Node.js: walidację zmiennych środowiskowych, logowanie, typowane błędy i podpinanie wyłączania.

Repozytorium
dalcom-skills ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
10.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 10.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Ustawia lub utwardza podstawy usługi Node.js: walidację zmiennych środowiskowych, logowanie, typowane błędy i podpinanie wyłączania.

Oryginalny opis (EN)

Use when asked to set up or harden Node.js service foundations: env validation, logging, typed errors, type stripping, and shutdown wiring. Not for dedicated shutdown: use nodejs-graceful-shutdown.

Jak działa

  1. Validate env before the server binds
  2. Log structured JSON with secrets redacted
  3. Throw errors the middleware can route
  4. Wire the shutdown spine
  5. Confirm startup, failure, types, and redaction
  6. What you hand back
Sekcje z nagłówków SKILL.md, w oryginale · 46 linii, 640 słów
Podgląd SKILL.md
---
name: nodejs-service-foundations
description: 'Use when asked to set up or harden Node.js service foundations: env validation, logging, typed errors, type stripping, and shutdown wiring. Not for dedicated shutdown: use nodejs-graceful-shutdown.'
---

# Node.js service foundations

You give a new or rough Node.js service a solid base: config that fails fast, logs that never leak secrets, errors the middleware can actually route, and a startup that runs clean under the compiler. When the job needs a full drain sequence with health flip and dependency teardown, hand that part to nodejs-graceful-shutdown; here you only wire the shutdown spine (signal to abort to exit).

This stays local and reversible. You write only the named local artifacts (env schema, logger, error classes, tsconfig, package scripts) and install the dependencies they declare. Rollback is version control: `git checkout -- <written files>` or deleting the listed untracked files. No remote mutation.

What you need before starting:

- Project root: directory containing or to receive `package.json`. Required.
- Environment variables: each name with its type and whether it is required or optional with a default. Required.
- Secret field names: env keys whose values must be redacted in log output. Required.
- Error catalogue: list of `{ code, message, httpStatus }` tuples for the domain errors. Required.
- Logger dependency: the structured logger in use (for example pino). Required, stated up front, not discovered midstream.

## Validate env before the server binds

Create `src/env.ts`. It reads `process.env` at import time and parses each declared variable against its type (string, number, boolean, URL). A required variable that is missing or malformed throws a descriptive error and the process exits with code 1 before any server binding. Export the frozen validated config object. The service never starts on invalid or missing config.

## Log structured JSON with secrets redacted

Create `src/logger.ts` on the stated logger dependency. Configure the level from env, ISO-8601 timestamps, and a request-id correlation field. Add a redaction serializer that replaces the value of every secret field name with `[REDACTED]` at every log level. Export a singleton instance. If a secret value ever appears unredacted in output, stop: the field-name list or serializer is misconfigured, and you fix it before proceeding.

## Throw errors the middleware can route

Create `src/errors.ts`. It exports a base `ServiceError` with `code: string`, `message: string`, `httpStatus: number`, and `cause?: Error`, plus one named subclass or factory per catalogue entry. Every entry keeps a working `instanceof ServiceError` check so middleware can map codes to HTTP responses, and every code maps to its declared status. A catalogue entry with no subclass or status is a defect: add the missing piece before moving on.

## Wire the shutdown spine

In the service entry point, create an `AbortController`. Listen for `SIGTERM` and `SIGINT`, call `controller.abort()`, pass the signal to in-flight operations, drain active requests, then exit `0` on a clean drain or non-zero on timeout. This is the spine only. The full handler with health flip and dependency teardown is the job of nodejs-graceful-shutdown.

## Confirm startup, failure, types, and redaction

Run these checks and keep every result:

- Start with valid env: the server binds and the startup log is structured JSON with secrets redacted.
- Start with a required variable missing: the process exits code 1 with a descriptive message before binding.
- Run `tsc --noEmit`: zero errors. Fix type errors directly; never suppress with `@ts-ignore` or `any`.
- Instantiate one error subclass: `instanceof ServiceError` is true and its `httpStatus` matches the catalogue.
- Log a record containing a secret field name: the output shows `[REDACTED]`.
- If a stated logger or required package is missing, install it with the project package manager. If installation fails, stop and report it.

## What you hand back

Local named files: `src/env.ts` (validated schema), `src/logger.ts` (structured JSON with redaction), `src/errors.ts` (typed `ServiceError` base and subclasses), `tsconfig.json` (strict type-stripping config), `package.json` (ESM, engines, scripts). All reversible through the stated rollback path, with proof covering startup logs, the invalid-env exit, `tsc`, the instanceof check, the HTTP mapping, and redaction.
Pliki w paczce (2)
  • SKILL.md 4 KB
  • agents/openai.yaml 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · gosuda/dalcom-skills100Apache-2.0
OutlineDriven/outline-driven-development90Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki 0b146258d9d2 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100nodejs-graceful-shutdown
    Wdraża lub naprawia łagodne zamykanie usługi Node.js: sygnały SIGTERM i SIGINT, dokańczanie połączeń i sygnał health-check.
  • 100nodejs-graceful-shutdown
    Wdraża lub naprawia zamykanie usługi Node.js: obsługa SIGTERM i SIGINT, opróżnianie połączeń i sygnalizowanie w health checku.
  • 100nodejs-best-practices
    Pomaga podejmować decyzje dla usług Node.js: framework, warstwy, błędy, asynchroniczność, walidację i bezpieczeństwo.
  • 90node-backend-setup
    Zakłada backend Node.js z ESM, typowaną konfiguracją, łagodnym zamykaniem i ustrukturyzowanym logowaniem od początku, także przy utwardzaniu usługi rozrosłej bez fundamentów.
  • 91nodejs-development
    Buduje, debuguje i optymalizuje aplikacje Node.js: serwery Fastify, TypeScript, OAuth 2.1 i diagnozę wydajności.
  • 100scaffold-go-service
    Zakłada serwis HTTP w Go na net/http: warstwy cmd i internal, logi slog w JSON, konfigurację ze zmiennych środowiskowych i graceful shutdown.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.