Implement Phase 1 tasks 1.1-1.4 (scaffold + core types + config + Postgres)

Scaffold mirrors tcp-ingestion conventions: ESM, strict TS, pnpm, vitest with unit/integration split, ESLint flat config with no-floating-promises + no-misused-promises + import/no-restricted-paths (the new src/core/ → src/domain/ boundary that protects Phase 1 from Phase 2 churn). Core types in src/core/types.ts (Position, StreamRecord, DeviceState, Metrics, AttributeValue) — Position is byte-equivalent to tcp-ingestion's output. Codec in src/core/codec.ts implements sentinel reversal: {__bigint:"..."} → bigint, {__buffer_b64:"..."} → Buffer, ISO timestamp string → Date. CodecError surfaces malformed payload reasons with the failing field named. Config in src/config/load.ts (zod schema, all 13 env vars with defaults and bounded numerics). Logger in src/observability/logger.ts matches tcp-ingestion exactly: ISO timestamps, string level labels, pino-pretty in development. Postgres in src/db/: createPool with sane defaults and application_name, connectWithRetry mirroring the ioredis retry pattern, a 30-line migration runner using a schema_migrations table, and 0001_positions.sql with the hypertable + (device_id, ts) unique index + ts DESC index. Migration runner unit-tested against a mocked pg.Pool; the real TimescaleDB round-trip is deferred to task 1.10 per spec. Verification: typecheck, lint, build all clean; 73 unit tests passing across 4 files. import/no-restricted-paths verified live by temporarily adding a forbidden src/domain/ import.
2026-04-30 21:35:16 +02:00
parent c314ba0902
commit 95efc23139
28 changed files with 7427 additions and 13 deletions
@@ -0,0 +1,74 @@
+// @ts-check
+import tseslint from '@typescript-eslint/eslint-plugin';
+import tsParser from '@typescript-eslint/parser';
+import importPlugin from 'eslint-plugin-import';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+/** @type {import('eslint').Linter.Config[]} */
+export default [
+  {
+    ignores: ['dist/**', 'node_modules/**', 'coverage/**'],
+  },
+  {
+    files: ['src/**/*.ts', 'test/**/*.ts'],
+    plugins: {
+      '@typescript-eslint': tseslint,
+      import: importPlugin,
+    },
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        project: './tsconfig.test.json',
+        tsconfigRootDir: __dirname,
+        ecmaVersion: 2022,
+        sourceType: 'module',
+      },
+    },
+    settings: {
+      'import/resolver': {
+        typescript: {
+          project: join(__dirname, 'tsconfig.test.json'),
+        },
+      },
+    },
+    rules: {
+      // TypeScript strict promise rules — critical in a stream consumer where
+      // unhandled rejection silently loses work.
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/no-misused-promises': 'error',
+
+      // General quality
+      '@typescript-eslint/no-explicit-any': 'error',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
+      ],
+      '@typescript-eslint/consistent-type-imports': [
+        'error',
+        { prefer: 'type-imports' },
+      ],
+
+      // Domain isolation: core/ must NEVER import from domain/.
+      // src/domain/ does not exist yet — this rule is preemptive so Phase 2
+      // cannot violate the boundary by accident.
+      'import/no-restricted-paths': [
+        'error',
+        {
+          basePath: __dirname,
+          zones: [
+            {
+              target: 'src/core',
+              from: 'src/domain',
+              message:
+                'src/core must not import from src/domain — domain logic depends on core, not the reverse.',
+            },
+          ],
+        },
+      ],
+    },
+  },
+];