@djust-b2b/djust-front-sdk 3.0.0-beta.9 → 3.0.1

package/README.md

@@ -48,13 +48,24 @@
 ## 📦 Installation
 
 ```bash
-# npm
-npm install @djust-b2b/djust-front-sdk
+# Stable v3 (npm tag: latest)
+npm install @djust-b2b/djust-front-sdk@latest
 
-# yarn
-yarn add @djust-b2b/djust-front-sdk
+# Maintenance v2 (npm tag: v2) — legacy portails
+npm install @djust-b2b/djust-front-sdk@v2
+```
+
+| npm tag | Version | Use when |
+|---------|---------|----------|
+| `latest` | 3.0.0+ | New projects, SSR with `createDjustClient` (published from `preprod`) |
+| `v2` | 2.19.1 | Legacy portails not yet migrated |
+| `beta` | 3.0.0-beta.* | RC validation (`beta` branch) |
 
-# pnpm
+**Legacy imports:** paths like `@djust-b2b/djust-front-sdk/lib/interfaces/models/product` remain valid on v3.
+
+```bash
+# yarn / pnpm
+yarn add @djust-b2b/djust-front-sdk
 pnpm add @djust-b2b/djust-front-sdk
 ```
 
@@ -146,37 +157,29 @@ export const useCart = () => {
 
 ### For Users
 
-- **[Getting Started Guide](https://djust-sdk-docs-530629704769.europe-west1.run.app/docs/getting-started/introduction)** - Complete setup guide
-- **[API Reference](https://djust-sdk-docs-530629704769.europe-west1.run.app/docs/api)** - Full API documentation
-- **[Error Handling Guide](https://djust-sdk-docs-530629704769.europe-west1.run.app/docs/guides/error-handling)** - Comprehensive error handling with metadata
-- **[Versioning Guide](https://djust-sdk-docs-530629704769.europe-west1.run.app/docs/guides/versioning)** - Version management and npm version retrieval
-- **[Guides](https://djust-sdk-docs-530629704769.europe-west1.run.app/docs/guides)** - Performance, SSR, and more
-- **[Examples](https://djust-sdk-docs-530629704769.europe-west1.run.app/docs/examples)** - Code examples and patterns
-
-### For Developers
+- **[Getting Started](./docs/getting-started/introduction.mdx)** — setup guide (Mintlify site in [`docs/`](./docs/))
+- **[API Reference](./docs/api-reference/overview.mdx)** — typed client methods per service
+- **[Error Handling](./docs/guides/error-handling.mdx)** — `SDKError` hierarchy and retries
+- **[Versioning](./docs/guides/versioning.mdx)** — npm tags and release policy
+- **[Guides](./docs/guides/)** — SSR, sessions, performance, MCP, and more
 
-All development documentation is located in [`doc/development/`](./doc/development/):
+Run locally: `cd docs && npm install && npx mint dev` (Node 20–22). Deployed via the Mintlify GitLab app.
 
-- **[Guidelines Index](./doc/development/GUIDELINES_INDEX.md)** - 📖 Quick reference to all guidelines
-- **[Developer Guide](./doc/development/DEVELOPER_GUIDE.md)** - Architecture and development patterns
-- **[Development Guidelines](./doc/development/GUIDELINES.md)** - Coding standards and best practices
-- **[Code Review Guidelines](./doc/development/GUIDELINES_CODE_REVIEW.md)** - Review process and checklist
-- **[Contributing Guide](./doc/development/CONTRIBUTING.md)** - How to contribute
-- **[Service Templates](./doc/development/.templates/)** - Templates for creating services
+### For Developers
 
-> 📁 See [doc/development/README.md](./doc/development/README.md) for documentation structure
+- **[CLAUDE.md](./CLAUDE.md)** — repo layout, golden rule, service anatomy, conventions
+- **[ARCHITECTURE_AUDIT.md](./ARCHITECTURE_AUDIT.md)** — staff engineer architecture audit
+- **[docs/README.md](./docs/README.md)** — regenerate and validate the Mintlify site
 
 ### Quick Links
 
 | Topic | Link |
 |-------|------|
-| Architecture | [Architecture Overview](./doc/development/DEVELOPER_GUIDE.md#architecture-overview) |
-| Creating Services | [Creating a New Service](./doc/development/DEVELOPER_GUIDE.md#creating-a-new-service) |
-| Code Style | [Code Style Guidelines](./doc/development/GUIDELINES.md#code-style-guidelines) |
-| TypeScript | [TypeScript Guidelines](./doc/development/GUIDELINES.md#typescript-guidelines) |
-| Error Handling | [Error Handling Guidelines](./doc/development/GUIDELINES.md#error-handling-guidelines) |
-| Testing | [Testing Guidelines](./doc/development/GUIDELINES.md#testing-guidelines) |
-| Code Review | [Review Checklist](./doc/development/GUIDELINES_CODE_REVIEW.md#review-checklist) |
+| Architecture | [Overview](./docs/overview/architecture.mdx) |
+| Services | [Services guide](./docs/guides/services.mdx) |
+| SSR | [SSR usage](./docs/guides/ssr-usage.mdx) |
+| Error Handling | [Error handling](./docs/guides/error-handling.mdx) |
+| API playground | [OpenAPI](./docs/openapi.json) (interactive on deployed site) |
 
 ---
 
@@ -332,7 +335,7 @@ The SDK follows a modular, service-based architecture:
 - **Navigation** - Category navigation
 - And more...
 
-See [Services Reference](./doc/docs/guides/services.mdx) for complete list.
+See [Services Reference](./docs/guides/services.mdx) for complete list.
 
 ---
 
@@ -552,6 +555,7 @@ console.log('Cache misses:', metrics.cacheMisses);
 console.log('Average response time:', metrics.avgResponseTime);
 ```
 
+
 ---
 
 ## 🤝 Contributing
@@ -562,7 +566,7 @@ We welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md)
 
 1. Fork the repository
 2. Create a feature branch: `git checkout -b feat/your-feature`
-3. Make your changes following our [Guidelines](./doc/development/GUIDELINES.md)
+3. Make your changes following [CLAUDE.md](./CLAUDE.md) conventions
 4. Write tests for your changes
 5. Commit using conventional commits: `npm run commit`
 6. Push and create a Merge Request