@echoppe/client 0.1.0

package/LICENSE

@@ -0,0 +1,31 @@
+# Licence CeCILL v2.1
+
+Ce logiciel est régi par la Licence CeCILL version 2.1 soumise au droit français et compatible avec la licence GNU GPL. Vous pouvez utiliser, modifier et redistribuer ce logiciel selon les termes de cette licence.
+
+Le texte complet de la licence est disponible ici : [CeCILL v2.1 (français)](https://cecill.info/licences/Licence_CeCILL_V2.1-fr.html)
+
+## Résumé des droits et obligations
+
+- **Utilisation** : vous pouvez utiliser ce logiciel pour tout usage, privé ou commercial.
+- **Modification** : vous pouvez modifier le logiciel et redistribuer vos modifications.
+- **Redistribution** : toute redistribution du logiciel original ou modifié doit se faire sous la même licence CeCILL v2.1.
+- **Garantie** : ce logiciel est fourni "tel quel", sans garantie d'aucune sorte.
+
+Pour plus de détails, consultez le texte complet de la licence via le lien ci-dessus.
+
+---
+
+# CeCILL v2.1 License – Échoppe
+
+This software, Échoppe, is governed by the CeCILL Version 2.1 License, under French law and compatible with the GNU GPL. You may use, modify, and redistribute this software under the terms of this license.
+
+The full license text is available here: [CeCILL v2.1 (English)](https://cecill.info/licences/Licence_CeCILL_V2.1-en.html)
+
+## Summary of Rights and Obligations
+
+- **Use**: You may use this software for any private or professional purpose.
+- **Modification**: You may modify the software and redistribute your modifications.
+- **Redistribution**: Any redistribution of the original or modified software must be under the same CeCILL v2.1 license.
+- **Warranty**: This software is provided "as is", without any warranty of any kind.
+
+For full details, please refer to the complete license text via the link above.

package/README.md

@@ -0,0 +1,68 @@
+# @echoppe/client
+
+SDK client **typé** pour l'API [Échoppe](https://github.com/) — généré depuis le
+contrat OpenAPI de l'API. Runtime-agnostique (navigateur, Bun, Node, edge) : repose
+uniquement sur `fetch`.
+
+## Installation
+
+```bash
+bun add @echoppe/client
+```
+
+## Utilisation
+
+```ts
+import { createEchoppeClient } from '@echoppe/client';
+
+const echoppe = createEchoppeClient({
+  baseUrl: 'https://api.maboutique.fr',
+});
+
+const { data, error } = await echoppe.GET('/products/');
+if (error) throw error;
+
+// `data` est entièrement typé depuis le contrat de l'API
+for (const product of data) {
+  console.log(product.name);
+}
+```
+
+Les méthodes suivent le contrat OpenAPI via [`openapi-fetch`](https://openapi-ts.dev/openapi-fetch/) :
+`GET`, `POST`, `PUT`, `PATCH`, `DELETE`, avec `params.path`, `params.query` et `body`
+typés par route.
+
+```ts
+const { data } = await echoppe.GET('/products/{id}', {
+  params: { path: { id: '…' } },
+});
+```
+
+### Authentification
+
+L'API utilise des **cookies de session HTTP-only**. Le client force
+`credentials: 'include'` — dans un navigateur, les cookies de session sont donc
+transmis automatiquement une fois l'utilisateur connecté via les routes d'auth.
+
+## Types
+
+Le contrat complet est réexporté pour dériver ses propres types :
+
+```ts
+import type { paths, components } from '@echoppe/client';
+
+type Product = components['schemas']['...'];
+```
+
+## Régénérer depuis l'API
+
+Le SDK est généré depuis l'OpenAPI d'une API en cours d'exécution :
+
+```bash
+# API sur http://localhost:7532 par défaut
+bun run generate
+# ou une autre instance
+ECHOPPE_API_URL=https://api.exemple.fr bun run generate
+```
+
+Cela met à jour `openapi.json` (snapshot figé du contrat) puis `src/openapi.ts`.

package/dist/client.d.ts

@@ -0,0 +1,21 @@
+import { type ClientOptions } from 'openapi-fetch';
+import type { paths } from './openapi';
+export interface EchoppeClientOptions {
+    /** URL de base de l'API Échoppe, ex. `https://api.maboutique.fr`. */
+    baseUrl: string;
+    /** En-têtes envoyés par défaut sur chaque requête (contexte SSR, etc.). */
+    headers?: Record<string, string>;
+    /**
+     * Implémentation de `fetch` à utiliser (SSR, tests). Défaut : `fetch` global.
+     */
+    fetch?: ClientOptions['fetch'];
+}
+/**
+ * Crée un client typé pour l'API Échoppe.
+ *
+ * L'authentification repose sur des cookies de session HTTP-only : le client
+ * force donc `credentials: 'include'` pour que les routes protégées fonctionnent.
+ */
+export declare function createEchoppeClient(options: EchoppeClientOptions): import("openapi-fetch").Client<paths, `${string}/${string}`>;
+export type EchoppeClient = ReturnType<typeof createEchoppeClient>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAA4B,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,gEAOhE;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/client.js

@@ -0,0 +1,16 @@
+import createOpenApiClient, {} from 'openapi-fetch';
+/**
+ * Crée un client typé pour l'API Échoppe.
+ *
+ * L'authentification repose sur des cookies de session HTTP-only : le client
+ * force donc `credentials: 'include'` pour que les routes protégées fonctionnent.
+ */
+export function createEchoppeClient(options) {
+    return createOpenApiClient({
+        baseUrl: options.baseUrl.replace(/\/+$/, ''),
+        credentials: 'include',
+        headers: options.headers,
+        fetch: options.fetch,
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,EAAE,EAAsB,MAAM,eAAe,CAAC;AAcxE;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,OAAO,mBAAmB,CAAQ;QAChC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5C,WAAW,EAAE,SAAS;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export type { EchoppeClient, EchoppeClientOptions } from './client';
+export { createEchoppeClient } from './client';
+export type { components, operations, paths } from './openapi';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createEchoppeClient } from './client';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}