@kanjijs/contracts 0.2.0-beta.1

package/README.md

@@ -0,0 +1,46 @@
+# @kanjijs/contracts
+
+This package defines the pure interfaces and types that power the **Contract-First** architecture of Kanjijs. It contains zero runtime logic and is designed to be lightweight.
+
+## 🔑 Key Concepts
+
+### `SchemaLike`
+
+An abstract type (`unknown` by default) representing a validation schema.
+This allows the framework to be agnostic of the validation library (Zod, Yup, TypeBox, etc.).
+
+```typescript
+export type SchemaLike = unknown;
+```
+
+### `ContractSpec<T>`
+
+The blueprint of an API endpoint. It defines what strict shapes are expected for inputs and outputs.
+It uses Generics `<T>` (defaulting to `SchemaLike`) to allow you to pass specific Schema types if needed.
+
+```typescript
+export interface ContractSpec<T = SchemaLike> {
+  request?: {
+    params?: T;
+    query?: T;
+    headers?: T;
+    body?: T;
+  };
+  response?: {
+    [status: number]: T;
+  };
+}
+```
+
+### `ValidatorAdapter<S>`
+
+The interface that any validation library must implement to work with Kanjijs.
+
+```typescript
+export interface ValidatorAdapter<S = SchemaLike> {
+  parse<O = unknown>(
+    schema: S,
+    data: unknown,
+  ): Promise<{ success: true; data: O } | { success: false; issues: unknown[] }>;
+}
+```

package/dist/index.js

@@ -0,0 +1 @@
+// @bun

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@kanjijs/contracts",
+  "version": "0.2.0-beta.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target bun"
+  },
+  "dependencies": {
+    "@kanjijs/common": "workspace:*"
+  },
+  "devDependencies": {
+    "zod": "^3.0.0"
+  }
+}