@or-sdk/ccp 10.14.2-beta.930.0 → 10.14.3-beta.946.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +47 -0
- package/package.json +1 -1
package/AGENTS.md
ADDED
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# SDK Package Guide
|
|
2
|
+
|
|
3
|
+
## Responsibility
|
|
4
|
+
|
|
5
|
+
`@or-sdk/ccp`: TypeScript SDK for Customer Care Portal API contracts. It is a
|
|
6
|
+
published package consumed by the Customer Care Portal UI and downstream
|
|
7
|
+
clients.
|
|
8
|
+
|
|
9
|
+
## Local Rules
|
|
10
|
+
|
|
11
|
+
- Keep SDK APIs aligned with current backend contracts.
|
|
12
|
+
- Public API is exported from `src/index.ts`; additions or signature changes are
|
|
13
|
+
downstream-visible.
|
|
14
|
+
- Preserve strong typing; avoid `any`.
|
|
15
|
+
- Keep public SDK surface backward-compatible unless the task explicitly defines
|
|
16
|
+
a breaking change.
|
|
17
|
+
- Keep request parameter names, response shapes, pagination, sorting, and error
|
|
18
|
+
behavior consistent with the API.
|
|
19
|
+
- Do not manually edit generated `dist/` output; rebuild it with package
|
|
20
|
+
scripts when needed.
|
|
21
|
+
|
|
22
|
+
## Local Run and Validation
|
|
23
|
+
|
|
24
|
+
- Build the SDK with:
|
|
25
|
+
```bash
|
|
26
|
+
pnpm sdk build
|
|
27
|
+
```
|
|
28
|
+
- Watch ESM output during local development with:
|
|
29
|
+
```bash
|
|
30
|
+
pnpm sdk dev
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Release Notes
|
|
34
|
+
|
|
35
|
+
- Do not manually bump package or Lerna versions unless the release task
|
|
36
|
+
explicitly requires it.
|
|
37
|
+
- CI publishes prerelease SDK builds on merge requests and release builds from
|
|
38
|
+
the default branch.
|
|
39
|
+
- Call out SDK contract changes in the MR description under the `CCP SDK`
|
|
40
|
+
section.
|
|
41
|
+
|
|
42
|
+
## Local Documentation
|
|
43
|
+
|
|
44
|
+
- Document SDK contract or behavior changes in a focused feature doc under
|
|
45
|
+
`AGENTS/features/` when relevant.
|
|
46
|
+
- If contract strategy or cross-package architecture changes, add an ADR file.
|
|
47
|
+
- Avoid adding implementation notes to shared index README files.
|