@vitrine-kit/vitrine 0.3.0 → 0.4.0

package/kit/registry/product-page/docs/product-page.md

@@ -0,0 +1,16 @@
+# Feature: product-page
+
+The product detail page. Depends on `catalog` (registryDependencies).
+
+## Components
+- `components/product/ProductView` — the detail card. **Hosts the slots** `product.gallery`, `product.below-title`, `product.below-price`, `product.purchase`, `product.below-description`, `product.tabs` — other features (reviews, cart, wishlist) mount here.
+- `components/product/ProductGallery` — the image gallery.
+
+## Data
+- `lib/product/data` — `loadProduct(source, slug)` over `CatalogSource.getProduct`.
+
+## Slots
+The feature doesn't register slots, it **provides** them: so adding reviews/cart doesn't require editing `ProductView`.
+
+## Contracts
+Only `@vitrine-kit/contracts` (types) and `@vitrine-kit/core/react` (`<Slot>`).

package/kit/registry/product-page/feature.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "../../schemas/feature.schema.json",
+  "name": "product-page",
+  "title": "Product page",
+  "kitVersion": "0.4.0",
+  "requiresContracts": ">=1.0.0 <2.0.0",
+  "tier": [
+    "catalog",
+    "simple-store",
+    "full-store"
+  ],
+  "registryDependencies": [
+    "catalog"
+  ],
+  "corePackages": {
+    "@vitrine-kit/core": ">=0.1.0"
+  },
+  "npm": [],
+  "files": [
+    {
+      "from": "files/components/product/",
+      "to": "components/product/"
+    },
+    {
+      "from": "files/lib/product/",
+      "to": "lib/product/"
+    }
+  ],
+  "config": {
+    "set": {
+      "features.product-page": true
+    }
+  },
+  "slots": [],
+  "env": [],
+  "claudeDoc": "docs/product-page.md",
+  "conflicts": [],
+  "removable": false
+}

package/kit/registry/product-page/files/components/product/ProductGallery.tsx

@@ -0,0 +1,37 @@
+// Product gallery — presentational, neutral.
+import type { ProductImage } from '@vitrine-kit/contracts';
+
+export interface ProductGalleryProps {
+  images: ProductImage[];
+  title: string;
+}
+
+export function ProductGallery({ images, title }: ProductGalleryProps) {
+  const cover = images[0];
+  if (!cover) {
+    return <div className="aspect-square w-full rounded-md bg-muted" aria-hidden="true" />;
+  }
+  const rest = images.slice(1);
+  return (
+    <div className="vt-product-gallery">
+      <img
+        src={cover.url}
+        alt={cover.alt ?? title}
+        className="w-full rounded-md object-cover"
+      />
+      {rest.length > 0 ? (
+        <ul role="list" className="mt-gutter flex gap-gutter">
+          {rest.map((img, i) => (
+            <li key={img.url}>
+              <img
+                src={img.url}
+                alt={img.alt ?? `${title} — image ${i + 2}`}
+                className="h-16 w-16 rounded-md object-cover"
+              />
+            </li>
+          ))}
+        </ul>
+      ) : null}
+    </div>
+  );
+}

package/kit/registry/product-page/files/components/product/ProductView.tsx

@@ -0,0 +1,42 @@
+// Product detail card. HOSTS the product.* slots — other features (reviews,
+// cart, wishlist) mount into them without editing this component.
+import type { Product } from '@vitrine-kit/contracts';
+import { Slot } from '@vitrine-kit/core/react';
+import { ProductGallery } from './ProductGallery.js';
+import { formatPrice } from '../../lib/product/data.js';
+
+export interface ProductViewProps {
+  product: Product;
+}
+
+export function ProductView({ product }: ProductViewProps) {
+  const price = product.priceRange?.min ?? product.variants[0]?.price;
+  const currency = product.priceRange?.currency ?? product.variants[0]?.currency ?? 'USD';
+
+  return (
+    <article className="vt-product-view grid gap-section md:grid-cols-2">
+      <div>
+        <Slot
+          name="product.gallery"
+          fallback={<ProductGallery images={product.images} title={product.title} />}
+        />
+      </div>
+      <div className="flex flex-col gap-gutter">
+        <Slot name="product.below-title" />
+        <h1 className="font-heading text-fg">{product.title}</h1>
+        {price != null ? (
+          <p className="text-price text-xl">{formatPrice(price, currency)}</p>
+        ) : null}
+        <Slot name="product.below-price" />
+        <div className="vt-product-purchase">
+          <Slot name="product.purchase" product={product} />
+        </div>
+        {product.description ? (
+          <div className="vt-product-description text-fg">{product.description}</div>
+        ) : null}
+        <Slot name="product.below-description" />
+        <Slot name="product.tabs" />
+      </div>
+    </article>
+  );
+}

package/kit/registry/product-page/files/lib/product/data.ts

@@ -0,0 +1,10 @@
+import type { CatalogSource, Product } from '@vitrine-kit/contracts';
+
+export async function loadProduct(source: CatalogSource, slug: string): Promise<Product | null> {
+  return source.getProduct(slug);
+}
+
+/** Money — minor units (e.g. cents). */
+export function formatPrice(amount: number, currency: string, locale = 'en-US'): string {
+  return new Intl.NumberFormat(locale, { style: 'currency', currency }).format(amount / 100);
+}

package/kit/registry/seo/docs/seo.md

@@ -0,0 +1,14 @@
+# Feature: seo
+
+Page metadata and schema.org JSON-LD from domain types.
+
+## Modules
+- `lib/seo/metadata` — `buildProductMetadata(product)` → `SiteMetadata` (structurally compatible with Next `Metadata`; in the client it's returned from `generateMetadata`).
+- `lib/seo/jsonld` — `productJsonLd(product)` → a schema.org `Product`/`Offer` object.
+- `components/seo/JsonLd` — `<JsonLd data={…} />` embeds a `<script type="application/ld+json">`.
+
+## Contracts
+Only `@vitrine-kit/contracts` (the `Product` type). Registers no slots.
+
+## Note
+The price in JSON-LD is converted from minor units (`price/100`).

package/kit/registry/seo/feature.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "../../schemas/feature.schema.json",
+  "name": "seo",
+  "title": "SEO — metadata and JSON-LD",
+  "kitVersion": "0.4.0",
+  "requiresContracts": ">=1.0.0 <2.0.0",
+  "tier": [
+    "catalog",
+    "simple-store",
+    "full-store"
+  ],
+  "registryDependencies": [],
+  "corePackages": {},
+  "npm": [],
+  "files": [
+    {
+      "from": "files/components/seo/",
+      "to": "components/seo/"
+    },
+    {
+      "from": "files/lib/seo/",
+      "to": "lib/seo/"
+    }
+  ],
+  "config": {
+    "set": {
+      "features.seo": true
+    }
+  },
+  "slots": [],
+  "env": [],
+  "claudeDoc": "docs/seo.md",
+  "conflicts": [],
+  "removable": false
+}

package/kit/registry/seo/files/components/seo/JsonLd.tsx

@@ -0,0 +1,15 @@
+// Embeds JSON-LD into the page. Usage:
+//   <JsonLd data={productJsonLd(product, { baseUrl })} />
+export interface JsonLdProps {
+  data: Record<string, unknown>;
+}
+
+export function JsonLd({ data }: JsonLdProps) {
+  return (
+    <script
+      type="application/ld+json"
+      // biome-ignore lint/security/noDangerouslySetInnerHtml: JSON-LD is safe — serialized data, not user HTML.
+      dangerouslySetInnerHTML={{ __html: JSON.stringify(data) }}
+    />
+  );
+}

package/kit/registry/seo/files/lib/seo/jsonld.ts

@@ -0,0 +1,29 @@
+// schema.org JSON-LD from domain types.
+import type { Product } from '@vitrine-kit/contracts';
+
+export function productJsonLd(
+  product: Product,
+  opts: { baseUrl?: string } = {},
+): Record<string, unknown> {
+  const variant = product.variants[0];
+  const price = product.priceRange?.min ?? variant?.price;
+  const currency = product.priceRange?.currency ?? variant?.currency;
+
+  return {
+    '@context': 'https://schema.org',
+    '@type': 'Product',
+    name: product.title,
+    description: product.seo?.description ?? product.description,
+    image: product.images.map((image) => image.url),
+    sku: variant?.sku,
+    offers:
+      price != null
+        ? {
+            '@type': 'Offer',
+            price: (price / 100).toFixed(2),
+            priceCurrency: currency,
+            url: opts.baseUrl ? `${opts.baseUrl}/products/${product.slug}` : undefined,
+          }
+        : undefined,
+  };
+}

package/kit/registry/seo/files/lib/seo/metadata.ts

@@ -0,0 +1,35 @@
+// Builds page metadata from domain types. SiteMetadata is structurally
+// compatible with Next Metadata — in the client, generateMetadata() returns this.
+import type { Product } from '@vitrine-kit/contracts';
+
+export interface SiteMetadata {
+  title: string;
+  description?: string;
+  canonical?: string;
+  openGraph?: {
+    title: string;
+    description?: string;
+    images?: string[];
+  };
+}
+
+export function buildProductMetadata(
+  product: Product,
+  opts: { baseUrl?: string } = {},
+): SiteMetadata {
+  const title = product.seo?.title ?? product.title;
+  const description = product.seo?.description ?? product.description;
+  const image = product.seo?.image ?? product.images[0]?.url;
+  const canonical = opts.baseUrl ? `${opts.baseUrl}/products/${product.slug}` : undefined;
+
+  return {
+    title,
+    description,
+    canonical,
+    openGraph: {
+      title,
+      description,
+      images: image ? [image] : undefined,
+    },
+  };
+}

package/kit/registry/stubs/route-glue.d.ts

@@ -0,0 +1,45 @@
+// Ambient stubs so registry API route glue typechecks in the monorepo without Next/Payload installed.
+// Real stack types are verified when the client is instantiated.
+
+declare module 'next/server' {
+  export class NextResponse {
+    static json(body: unknown, init?: ResponseInit): NextResponse;
+  }
+}
+
+declare module 'next/headers' {
+  interface CookieStore {
+    get(name: string): { value: string } | undefined;
+    set(name: string, value: string, options?: Record<string, unknown>): void;
+  }
+  export function cookies(): Promise<CookieStore>;
+}
+
+declare module '@/lib/adapter' {
+  import type { CatalogSource, CommerceBackend } from '@vitrine-kit/contracts';
+  export function getCatalogSource(): Promise<CatalogSource>;
+  export function getCommerceBackend(): Promise<CommerceBackend>;
+}
+
+declare module '@/lib/checkout/fulfill' {
+  import type { NormalizedPaymentEvent, PaymentProviderName } from '@vitrine-kit/core';
+  export function fulfillOrderFromEvent(
+    event: NormalizedPaymentEvent,
+    providerName: PaymentProviderName,
+  ): Promise<void>;
+}
+
+declare module '@/lib/checkout-stripe/provider' {
+  import type { PaymentProvider } from '@vitrine-kit/core';
+  export const stripeProvider: PaymentProvider;
+}
+
+declare module '@/lib/checkout-paddle/provider' {
+  import type { PaymentProvider } from '@vitrine-kit/core';
+  export const paddleProvider: PaymentProvider;
+}
+
+declare module '@/lib/checkout-yookassa/provider' {
+  import type { PaymentProvider } from '@vitrine-kit/core';
+  export const yookassaProvider: PaymentProvider;
+}

package/kit/registry/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "extends": "../tsconfig.base.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "types": ["react", "node"]
+  },
+  "//": "We typecheck the presentational components/ + the contract-based lib/ (they depend only on contracts/core). Next glue under files/app/** (routes, server actions, webhook) and payment glue (provider.ts pulls in the provider SDK, fulfill.ts — payload/@payload-config) are checked when the client is instantiated, not in the kit.",
+  "include": [
+    "*/files/components/**/*.ts",
+    "*/files/components/**/*.tsx",
+    "*/files/lib/**/*.ts",
+    "*/files/lib/**/*.tsx"
+  ],
+  "exclude": [
+    "**/node_modules",
+    "**/dist",
+    "*/files/lib/checkout-*/**",
+    "*/files/lib/checkout/fulfill.ts"
+  ]
+}

package/kit/registry/tsconfig.routes.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../tsconfig.base.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "types": ["node"]
+  },
+  "//": "Next API route glue (cart/checkout/webhooks). Uses registry/stubs/route-glue.d.ts instead of installing Next/Payload in the kit repo.",
+  "include": ["stubs/**/*.d.ts", "*/files/app/api/**/route.ts"]
+}

package/kit/templates/README.md

@@ -0,0 +1,27 @@
+# templates/ — client repository skeletons
+
+`vitrine init` assembles the client repository from these (spec §6). `templates/<name>/files`
+**mirrors the client root** (like `registry/<feature>/files`): the static skeleton is copied as-is,
+then the CLI generates managed files on top of it (site.config.ts, vitrine.json, CLAUDE.md,
+package.json, lib/slots.ts, lib/payments.ts, lib/blueprint.ts, theme/client.css).
+
+- `base` — Next.js (App Router, route group `(frontend)`) + Tailwind (Vitrine preset),
+  storefront routes (home/catalog, product, category), header/footer hosting slots,
+  `.gitignore` (with `.vitrine/`), `/design` README.
+- `backend-payload` — Payload config, the `(payload)` admin, a `PayloadCatalogSource`
+  adapter over the `CatalogSource` contract, zero-config dev
+  (SQLite fallback + demo seed + dev admin, §18), `Dockerfile` + `docker-compose.yml`
+  (app + Postgres, VPS hosting target).
+- `backend-vendure` — A Vendure server (`vendure-config.ts`, Postgres/SQLite-dev db,
+  superadmin from env), `VendureCatalogSource`/`VendureCommerceBackend` adapters over the Shop
+  GraphQL API, a populate guard (§18 equivalent), `Dockerfile` + `docker-compose.yml` (db + server + web).
+  The storefront (`app/(frontend)`) and the catalog/cart features are the same as on Payload
+  (portability via contracts). Full payments use the Vendure Stripe plugin; the GPL-3.0 legal review
+  is a separate track.
+
+## What is checked in the monorepo
+
+Template files that depend on Next/Payload are typechecked **when the client is instantiated**
+(the stack is installed there). The pure critical logic (Payload→contract mappers, the §18.1 DB
+selection table, demo-seed invariants, dev-procedure guards) depends only on the contracts and is
+covered by `pnpm typecheck:templates` + tests in `sandbox/`.

package/kit/templates/backend-payload/files/.dockerignore

@@ -0,0 +1,8 @@
+node_modules
+.next
+.git
+.vitrine
+.env
+.env.local
+**/*.tsbuildinfo
+npm-debug.log

package/kit/templates/backend-payload/files/Dockerfile

@@ -0,0 +1,29 @@
+# syntax=docker/dockerfile:1
+# Reference Vitrine client image (Next standalone + Payload). Target — VPS.
+# @vitrine-kit/* packages are public on npm — no token needed to install.
+FROM node:20-alpine AS base
+RUN corepack enable && corepack prepare pnpm@9.15.0 --activate
+WORKDIR /app
+
+# --- dependencies ----------------------------------------------------------
+FROM base AS deps
+COPY package.json pnpm-lock.yaml* ./
+RUN pnpm install --frozen-lockfile || pnpm install
+
+# --- build ------------------------------------------------------------------
+FROM base AS build
+ENV NEXT_TELEMETRY_DISABLED=1
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+RUN pnpm build
+
+# --- runtime ----------------------------------------------------------------
+FROM base AS runtime
+ENV NODE_ENV=production
+ENV NEXT_TELEMETRY_DISABLED=1
+WORKDIR /app
+COPY --from=build /app/public ./public
+COPY --from=build /app/.next/standalone ./
+COPY --from=build /app/.next/static ./.next/static
+EXPOSE 3000
+CMD ["node", "server.js"]

package/kit/templates/backend-payload/files/app/(payload)/admin/[[...segments]]/not-found.tsx

@@ -0,0 +1,18 @@
+/* Equivalent of the Payload-generated admin 404 page. */
+import type { Metadata } from 'next';
+import config from '@payload-config';
+import { generatePageMetadata, NotFoundPage } from '@payloadcms/next/views';
+import { importMap } from '../importMap.js';
+
+type Args = {
+  params: Promise<{ segments: string[] }>;
+  searchParams: Promise<{ [key: string]: string | string[] }>;
+};
+
+export const generateMetadata = ({ params, searchParams }: Args): Promise<Metadata> =>
+  generatePageMetadata({ config, params, searchParams });
+
+const NotFound = ({ params, searchParams }: Args) =>
+  NotFoundPage({ config, params, searchParams, importMap });
+
+export default NotFound;

package/kit/templates/backend-payload/files/app/(payload)/admin/[[...segments]]/page.tsx

@@ -0,0 +1,18 @@
+/* Equivalent of the Payload-generated admin page. */
+import type { Metadata } from 'next';
+import config from '@payload-config';
+import { generatePageMetadata, RootPage } from '@payloadcms/next/views';
+import { importMap } from '../importMap.js';
+
+type Args = {
+  params: Promise<{ segments: string[] }>;
+  searchParams: Promise<{ [key: string]: string | string[] }>;
+};
+
+export const generateMetadata = ({ params, searchParams }: Args): Promise<Metadata> =>
+  generatePageMetadata({ config, params, searchParams });
+
+const Page = ({ params, searchParams }: Args) =>
+  RootPage({ config, params, searchParams, importMap });
+
+export default Page;

package/kit/templates/backend-payload/files/app/(payload)/admin/importMap.js

@@ -0,0 +1,3 @@
+// Import map for custom admin components. Regenerated by
+// `payload generate:importmap` when custom view/field components are added.
+export const importMap = {};

package/kit/templates/backend-payload/files/app/(payload)/api/[...slug]/route.ts

@@ -0,0 +1,18 @@
+/* Payload REST API (equivalent of the generated file). */
+import config from '@payload-config';
+import '@payloadcms/next/css';
+import {
+  REST_DELETE,
+  REST_GET,
+  REST_OPTIONS,
+  REST_PATCH,
+  REST_POST,
+  REST_PUT,
+} from '@payloadcms/next/routes';
+
+export const GET = REST_GET(config);
+export const POST = REST_POST(config);
+export const DELETE = REST_DELETE(config);
+export const PATCH = REST_PATCH(config);
+export const PUT = REST_PUT(config);
+export const OPTIONS = REST_OPTIONS(config);

package/kit/templates/backend-payload/files/app/(payload)/api/graphql/route.ts

@@ -0,0 +1,6 @@
+/* Payload GraphQL API (equivalent of the generated file). */
+import config from '@payload-config';
+import { GRAPHQL_POST, GRAPHQL_OPTIONS } from '@payloadcms/next/routes';
+
+export const POST = GRAPHQL_POST(config);
+export const OPTIONS = GRAPHQL_OPTIONS(config);

package/kit/templates/backend-payload/files/app/(payload)/api/graphql-playground/route.ts

@@ -0,0 +1,5 @@
+/* Payload GraphQL Playground (equivalent of the generated file). */
+import config from '@payload-config';
+import { GRAPHQL_PLAYGROUND_GET } from '@payloadcms/next/routes';
+
+export const GET = GRAPHQL_PLAYGROUND_GET(config);

package/kit/templates/backend-payload/files/app/(payload)/custom.scss

@@ -0,0 +1 @@
+/* Custom Payload admin styles (optional). */

package/kit/templates/backend-payload/files/app/(payload)/layout.tsx

@@ -0,0 +1,23 @@
+/* Payload admin layout (route group (payload)). Equivalent of the Payload-generated
+   file — renders its own <html> separately from the storefront ((frontend)). */
+import type { ServerFunctionClient } from 'payload';
+import config from '@payload-config';
+import '@payloadcms/next/css';
+import { handleServerFunctions, RootLayout } from '@payloadcms/next/layouts';
+import type React from 'react';
+import { importMap } from './admin/importMap.js';
+import './custom.scss';
+
+// biome-ignore lint/complexity/useArrowFunction: mirrors the Payload-generated file ('use server' boundary).
+const serverFunction: ServerFunctionClient = async function (args) {
+  'use server';
+  return handleServerFunctions({ ...args, config, importMap });
+};
+
+const Layout = ({ children }: { children: React.ReactNode }) => (
+  <RootLayout config={config} importMap={importMap} serverFunction={serverFunction}>
+    {children}
+  </RootLayout>
+);
+
+export default Layout;

package/kit/templates/backend-payload/files/docker-compose.yml

@@ -0,0 +1,35 @@
+# Reference Vitrine deployment on a VPS: app (Next+Payload) + Postgres.
+# Run: PAYLOAD_SECRET=... docker compose up --build
+services:
+  db:
+    image: postgres:16-alpine
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: vitrine
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-vitrine}
+      POSTGRES_DB: vitrine
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ['CMD-SHELL', 'pg_isready -U vitrine']
+      interval: 5s
+      timeout: 5s
+      retries: 10
+
+  app:
+    build:
+      context: .
+    restart: unless-stopped
+    environment:
+      NODE_ENV: production
+      DATABASE_URL: postgres://vitrine:${POSTGRES_PASSWORD:-vitrine}@db:5432/vitrine
+      PAYLOAD_SECRET: ${PAYLOAD_SECRET:?set PAYLOAD_SECRET}
+      NEXT_PUBLIC_SITE_URL: ${NEXT_PUBLIC_SITE_URL:-http://localhost:3000}
+    ports:
+      - '3000:3000'
+    depends_on:
+      db:
+        condition: service_healthy
+
+volumes:
+  pgdata:

package/kit/templates/backend-payload/files/lib/adapter/db-decision.ts

@@ -0,0 +1,43 @@
+// Pure DB adapter selection logic (§18.1 of the spec). No dependencies or side
+// effects — so it's covered by unit tests as the single source of truth for the
+// decision table. The wrapper with real Payload adapters lives in db.ts.
+
+export interface DbDecisionInput {
+  /** Value of DATABASE_URL (null/'' = not set). */
+  url: string | null;
+  /** Whether we managed to connect to Postgres (ping). */
+  canConnect: boolean;
+  isProd: boolean;
+  /** VITRINE_DB_STRICT=1 — disallows fallback even in dev. */
+  strict: boolean;
+}
+
+export type DbDecision =
+  | { kind: 'postgres' }
+  | { kind: 'sqlite'; warn?: string }
+  | { kind: 'error'; message: string };
+
+/**
+ * Table §18.1:
+ *  url + connect           → postgres
+ *  url, !connect, prod|strict → error (never fail silently in production)
+ *  url, !connect, dev      → sqlite + warn
+ *  !url, prod              → error
+ *  !url, dev               → sqlite
+ */
+export function decideDbAdapter(input: DbDecisionInput): DbDecision {
+  const { url, canConnect, isProd, strict } = input;
+
+  if (url) {
+    if (canConnect) return { kind: 'postgres' };
+    if (isProd || strict) {
+      return { kind: 'error', message: '[vitrine] DATABASE_URL is set, but the DB is unreachable' };
+    }
+    return { kind: 'sqlite', warn: '[vitrine] Postgres unreachable → falling back to SQLite (dev)' };
+  }
+
+  if (isProd) {
+    return { kind: 'error', message: '[vitrine] DATABASE_URL is required in production' };
+  }
+  return { kind: 'sqlite' };
+}

package/kit/templates/backend-payload/files/lib/adapter/db-ping.ts

@@ -0,0 +1,29 @@
+// Short TCP ping to Postgres with a timeout (~2s), then close. Uses node:net,
+// no driver dependency — no need to distinguish unavailable/timeout/error:
+// any failure in dev → fallback (see db-decision.ts).
+import net from 'node:net';
+
+export function canConnectPostgres(url: string, timeoutMs = 2000): Promise<boolean> {
+  let host = 'localhost';
+  let port = 5432;
+  try {
+    const u = new URL(url);
+    if (u.hostname) host = u.hostname;
+    if (u.port) port = Number(u.port);
+  } catch {
+    return Promise.resolve(false);
+  }
+
+  return new Promise((resolve) => {
+    const socket = new net.Socket();
+    const finish = (ok: boolean): void => {
+      socket.destroy();
+      resolve(ok);
+    };
+    socket.setTimeout(timeoutMs);
+    socket.once('connect', () => finish(true));
+    socket.once('timeout', () => finish(false));
+    socket.once('error', () => finish(false));
+    socket.connect(port, host);
+  });
+}