@honestdigital/vehicle-service-types 1.0.13

package/dist/utilities/error.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Utility for standardized error handling in vehicle service
+ */
+export type ErrorCode = 'INTERNAL_ERROR' | 'NOT_FOUND' | 'INVALID_INPUT' | 'DATABASE_ERROR' | 'CACHE_ERROR' | 'UNAUTHORIZED' | 'VALIDATION_ERROR' | 'RATE_LIMITED' | 'EXTERNAL_API_ERROR';
+export declare class AppError extends Error {
+    code: ErrorCode;
+    statusCode: number;
+    context?: Record<string, unknown>;
+    constructor(code: ErrorCode, message: string, statusCode: number, context?: Record<string, unknown>);
+    /**
+     * Returns true if this is a client error (4xx status code)
+     * Client errors are expected conditions, not server failures
+     */
+    isClientError(): boolean;
+    /**
+     * Creates a safe version of the error for client consumption
+     * Removes sensitive information from context
+     */
+    toSafeError(): Omit<AppError, 'context'> & {
+        context?: Record<string, unknown>;
+    };
+}
+/**
+ * Common error factory functions
+ * Use these instead of direct AppError construction to ensure consistency
+ */
+export declare const API_ERRORS: {
+    NOT_FOUND: (resource?: string) => AppError;
+    INVALID_INPUT: (message?: string, context?: Record<string, unknown>) => AppError;
+    DATABASE_ERROR: (message?: string, context?: Record<string, unknown>) => AppError;
+    CACHE_ERROR: (message?: string, context?: Record<string, unknown>) => AppError;
+    UNAUTHORIZED: (message?: string) => AppError;
+    VALIDATION_ERROR: (message?: string, context?: Record<string, unknown>) => AppError;
+    RATE_LIMITED: (message?: string) => AppError;
+    EXTERNAL_API_ERROR: (message?: string, context?: Record<string, unknown>) => AppError;
+    INTERNAL_ERROR: (message?: string) => AppError;
+    FORBIDDEN: (message?: string) => AppError;
+};
+/**
+ * Serializes an error into a plain object that JSON.stringify can handle
+ * Captures message, name, stack, and any custom properties (like Postgres error details)
+ */
+export declare function serializeError(error: unknown): Record<string, unknown>;
+/**
+ * Safe error handler that ensures a consistent error response format
+ * and prevents sensitive error details from leaking to clients
+ */
+export declare function handleError(error: unknown): AppError;
+//# sourceMappingURL=error.d.ts.map

package/dist/utilities/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utilities/error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,MAAM,SAAS,GACjB,gBAAgB,GAChB,WAAW,GACX,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,kBAAkB,GAClB,cAAc,GACd,oBAAoB,CAAA;AAExB,qBAAa,QAAS,SAAQ,KAAK;IAC1B,IAAI,EAAE,SAAS,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;gBAGtC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IASnC;;;OAGG;IACI,aAAa,IAAI,OAAO;IAI/B;;;OAGG;IACI,WAAW,IAAI,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;CAexF;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU;;gDAGgC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;iDAGZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;8CAG7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;mDAKrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;qDAKpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;CAOvF,CAAA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuDtE;AAcD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAqCpD"}

package/package.json

@@ -0,0 +1,112 @@
+{
+  "name": "@honestdigital/vehicle-service-types",
+  "version": "1.0.13",
+  "description": "Dedicated microservice for vehicle inventory management",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/types.d.ts",
+  "files": [
+    "dist/types.d.ts",
+    "dist/types.d.ts.map",
+    "dist/types.js",
+    "dist/types/**/*.d.ts",
+    "dist/types/**/*.d.ts.map",
+    "dist/routers/index.d.ts",
+    "dist/routers/index.d.ts.map",
+    "dist/schemas/**/*.d.ts",
+    "dist/schemas/**/*.d.ts.map",
+    "dist/services/mmt.d.ts",
+    "dist/services/mmt.d.ts.map",
+    "dist/services/lenderdesk.d.ts",
+    "dist/services/lenderdesk.d.ts.map",
+    "dist/context.d.ts",
+    "dist/context.d.ts.map",
+    "dist/utilities/error.d.ts",
+    "dist/utilities/error.d.ts.map",
+    "dist/repositories/vehicleConfigOptions.d.ts",
+    "dist/repositories/vehicleConfigOptions.d.ts.map",
+    "README.md"
+  ],
+  "exports": {
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "default": "./dist/types.js"
+    },
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build:types": "tsc --declaration --emitDeclarationOnly --outDir dist && bun build src/types.ts --outdir dist --target node",
+    "verify:package": "npm pack --dry-run",
+    "dev": "wrangler dev --port 3002 --ip 0.0.0.0",
+    "dev:stress": "wrangler dev -e stress --port 3002",
+    "dev:stress:local": "POSTGRES_URL=postgresql://stress_test:stress_test_local@localhost:5434/vehicle_stress DISABLE_RATE_LIMIT=true bun run stress-test/server.ts",
+    "dev:old": "tsx watch src/index.ts",
+    "build": "tsc && wrangler deploy --dry-run",
+    "deploy": "wrangler deploy",
+    "deploy:staging": "wrangler deploy --env staging",
+    "deploy:production": "wrangler deploy --env production",
+    "deploy:production:sentry": "wrangler deploy --env production --outdir ./dist --define __SENTRY_RELEASE__:\\\"$(git rev-parse --short HEAD)\\\" && bun run sentry:sourcemaps",
+    "sentry:sourcemaps": "sentry-cli sourcemaps inject ./dist && sentry-cli sourcemaps upload --release=$(git rev-parse --short HEAD) ./dist",
+    "deploy:legacy": "node scripts/deploy-legacy.js",
+    "test": "bun test",
+    "test:integration": "STRESS_TEST_DB=true POSTGRES_URL=postgresql://stress_test:stress_test_local@localhost:5434/vehicle_stress vitest run --config vitest.integration.config.ts",
+    "test:watch": "vitest",
+    "bench": "vitest bench",
+    "bench:live": "BENCH_DB=live vitest bench",
+    "bench:local": "STRESS_TEST_DB=true POSTGRES_URL=postgresql://stress_test:stress_test_local@localhost:5434/vehicle_stress BENCH_DB=local vitest bench",
+    "bench:staging": "POSTGRES_URL='postgresql://neondb_owner:npg_nqE6Wpj1arDZ@ep-long-base-aiysy8lg-pooler.c-4.us-east-1.aws.neon.tech/neondb?sslmode=require&channel_binding=require' BENCH_DB=staging vitest bench",
+    "bench:gate": "BENCH_DB=staging vitest run --config vitest.gate.config.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check --write --max-diagnostics 1000 ./src",
+    "lint:fix": "biome check --write --max-diagnostics 1000 ./src",
+    "format": "biome format --write --max-diagnostics 1000 ./src",
+    "sync": "bun scripts/run-sftp-sync.ts --latest --skip-images",
+    "sync:full": "bun scripts/run-sftp-sync.ts --latest",
+    "sync:images": "bun scripts/run-sftp-sync.ts --images-only",
+    "sync:all": "bun scripts/run-sftp-sync.ts",
+    "sync:list": "bun scripts/run-sftp-sync.ts --list",
+    "sync:status": "bun scripts/run-sftp-sync.ts --status"
+  },
+  "dependencies": {
+    "@hono/trpc-server": "^0.4.0",
+    "@neondatabase/serverless": "^1.0.2",
+    "@sentry/cloudflare": "^10.29.0",
+    "@trpc/server": "^11.6.0",
+    "dotenv": "^17.2.3",
+    "drizzle-kit": "^0.31.5",
+    "drizzle-orm": "^0.44.6",
+    "hono": "^4.7.11",
+    "pg": "^8.16.3",
+    "postgres": "^3.4.7",
+    "ssh2": "^1.17.0",
+    "ssh2-sftp-client": "^12.0.1",
+    "superjson": "^2.2.5",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.2",
+    "@cloudflare/workers-types": "^4.20250117.0",
+    "@sentry/cli": "^2.58.2",
+    "@types/node": "^22.18.10",
+    "@types/pg": "^8.16.0",
+    "@types/sharp": "^0.32.0",
+    "@types/ssh2": "^1.15.5",
+    "@types/ssh2-sftp-client": "9",
+    "@types/ws": "^8.18.1",
+    "sharp": "^0.34.5",
+    "tsx": "^4.20.6",
+    "typescript": "5.7.3",
+    "vitest": "^3.2.4",
+    "wrangler": "^3.100.0",
+    "ws": "^8.19.0"
+  },
+  "engines": {
+    "node": "^18.20.2 || >=20.9.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}