@abapify/adt-contracts 0.0.0 → 0.3.5

package/README.md

@@ -1,3 +1,115 @@
 # @abapify/adt-contracts
 
-Placeholder. The real release is published via CI/CD.
+[![version](https://img.shields.io/github/package-json/v/abapify/adt-cli?filename=packages/adt-contracts/package.json)](https://github.com/abapify/adt-cli/pkgs/npm/%40abapify%2Fadt-contracts)
+
+**SAP ADT REST API contracts** — typed endpoint definitions using `speci` + `ts-xsd` schemas.
+
+Part of the [abapify monorepo](../../README.md).
+
+## What is it?
+
+This package is the **contract layer** between `adt-client` and `adt-schemas`. It provides declarative REST API contracts for SAP ADT (ABAP Development Tools) endpoints.
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                      adt-client                               │
+│              (HTTP Client + Request Execution)                   │
+└─────────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────────┐
+│                      adt-contracts (this package)                │
+│         (REST API Contracts using speci + ts-xsd)                │
+└─────────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────────┐
+│                     adt-schemas                              │
+│        (TypeScript schemas from SAP XSD definitions)             │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+Contracts are pure data structures that define:
+
+- **Endpoint URLs** - REST paths
+- **HTTP methods** - GET, POST, PUT, DELETE
+- **Request/Response schemas** - Using `ts-xsd` generated from SAP XSD definitions
+- **Content-Types** - SAP vendor-specific media types
+
+## Installation
+
+```bash
+bun add adt-contracts
+```
+
+## Usage
+
+### With speci client
+
+```typescript
+import { adtContract } from 'adt-contracts';
+import { createClient } from 'speci/rest';
+
+const client = createClient(adtContract, {
+  baseUrl: 'https://sap-server.example.com/sap/bc/adt',
+  adapter: myAdapter,
+});
+
+// Full type inference from XSD schemas!
+const transport = await client.cts.getTransportRequests();
+const classInfo = await client.oo.getClass('ZCL_MY_CLASS');
+```
+
+### Individual contracts
+
+```typescript
+import { ctsContract, atcContract, ooContract } from 'adt-contracts';
+
+// Use specific contracts
+const cts = createClient(ctsContract, config);
+const atc = createClient(atcContract, config);
+```
+
+## Available Contracts
+
+| Contract       | Description                           |
+| -------------- | ------------------------------------- |
+| `coreContract` | Core ADT object operations            |
+| `ctsContract`  | Change and Transport System           |
+| `atcContract`  | ABAP Test Cockpit                     |
+| `ooContract`   | Object-Oriented (classes, interfaces) |
+
+## Architecture
+
+```
+adt-contracts (this package)
+    ├── speci contracts (endpoint definitions)
+    └── adt-schemas (ts-xsd schemas)
+            └── ts-xsd (XSD → TypeScript)
+```
+
+**Contracts are pure data** - no HTTP client, no business logic. Use with any `speci`-compatible adapter.
+
+## Adding New Contracts
+
+1. Ensure schema exists in `adt-schemas`
+2. Create contract file in `src/adt/<feature>/index.ts`
+3. Define endpoints using `adtHttp.get/post/put/delete`
+4. Export from `src/adt/index.ts`
+
+```typescript
+import { adtHttp } from '../../base';
+import { mySchema } from 'adt-schemas';
+
+export const myContract = {
+  getResource: (id: string) =>
+    adtHttp.get(`/my/endpoint/${id}`, {
+      responses: { 200: mySchema },
+      headers: { Accept: 'application/vnd.sap.adt.my.v1+xml' },
+    }),
+};
+```
+
+## License
+
+MIT

package/package.json

@@ -1,5 +1,36 @@
 {
   "name": "@abapify/adt-contracts",
-  "version": "0.0.0",
-  "description": "Placeholder — real package is published via CI/CD (trusted publishing)."
-}
+  "version": "0.3.5",
+  "description": "SAP ADT REST API contracts using speci + ts-xsd",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./base": "./dist/base.mjs",
+    "./schemas": "./dist/schemas.mjs",
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@abapify/speci": "0.3.5",
+    "@abapify/adt-schemas": "0.3.5"
+  },
+  "devDependencies": {
+    "@abapify/adt-fixtures": "0.3.5"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/abapify/adt-cli.git",
+    "directory": "packages/adt-contracts"
+  },
+  "homepage": "https://github.com/abapify/adt-cli/tree/main/packages/adt-contracts#readme",
+  "bugs": {
+    "url": "https://github.com/abapify/adt-cli/issues"
+  }
+}