@medalsocial/sdk 1.1.6 → 1.2.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/README.md CHANGED
@@ -290,6 +290,27 @@ do {
290
290
  } while (cursor);
291
291
  ```
292
292
 
293
+ ## OpenAPI 3.1
294
+
295
+ The SDK publishes a validated OpenAPI 3.1 contract for the API surface covered by the typed client.
296
+
297
+ ```ts
298
+ import type { OpenApiComponents, OpenApiOperations, OpenApiPaths } from '@medalsocial/sdk';
299
+ import type { paths } from '@medalsocial/sdk/openapi-types';
300
+ ```
301
+
302
+ Package artifacts:
303
+
304
+ - `@medalsocial/sdk/openapi.yaml` - source OpenAPI 3.1 YAML document
305
+ - `@medalsocial/sdk/openapi.json` - bundled JSON document generated during build
306
+ - `@medalsocial/sdk/openapi-types` - generated TypeScript contract types
307
+
308
+ Validate the contract locally:
309
+
310
+ ```bash
311
+ pnpm openapi:check
312
+ ```
313
+
293
314
  ## Runtime Support
294
315
 
295
316
  Node.js 18+ and modern browsers. Uses native `fetch` — no polyfills required.