feat(contracts): openapi base, error codes, type generation

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-17 17:04:12 +08:00
parent 9dc530feaf
commit 656498d748
10 changed files with 4360 additions and 8 deletions
@@ -0,0 +1,33 @@
+{
+  "name": "@photo/contracts",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "API contract single source of truth (OpenAPI 3.1 + error codes); types generated via openapi-typescript and committed under src/generated/",
+  "//": "lint script is a placeholder (exit 0): eslint flat config arrives in Task 7. test is a minimal ts-jest scaffold: real type tests arrive in Task 6.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./openapi.yaml": "./openapi.yaml"
+  },
+  "scripts": {
+    "gen": "openapi-typescript openapi.yaml -o src/generated/openapi.d.ts",
+    "lint:api": "redocly lint openapi.yaml",
+    "build": "tsc -p tsconfig.json && node -e \"require('fs').cpSync('src/generated', 'dist/generated', { recursive: true })\"",
+    "typecheck": "tsc --noEmit",
+    "test": "jest",
+    "lint": "exit 0"
+  },
+  "devDependencies": {
+    "@redocly/cli": "^1.0.0",
+    "@types/jest": "^29.5.0",
+    "jest": "^29.7.0",
+    "openapi-typescript": "^7.0.0",
+    "ts-jest": "^29.2.0",
+    "typescript": "^5.6.0"
+  }
+}