feat: migrate to version 1.0.0 with TypeScript support and improved module structure

- Refactored codebase to use TypeScript, enhancing type safety and developer experience.
- Updated package version from 0.15.0 to 1.0.0 in package.json and package-lock.json.
- Introduced new entry points and exports in package.json for better module resolution.
- Added migration guide (MIGRATION.md) detailing changes from v0.15.0 to v1.0.0.
- Created src/index.ts and src/openapi-to-har.ts files to encapsulate core functionality.
- Updated webpack configuration to point to the compiled TypeScript output.
- Included TypeScript configuration (tsconfig.json) for project compilation settings.
- Enhanced dependency management by updating devDependencies and ensuring compatibility.

Author: aeltorio

MIGRATION.md

@@ -0,0 +1,115 @@
+# Migration vers v1.0.0
+
+## Changements principaux
+
+La version 1.0.0 de `@sctg/openapi-snippet` a été refactorisée pour une meilleure utilisation :
+
+### ✅ Avant (v0.15.0)
+```javascript
+import '@sctg/openapi-snippet/dist/openapisnippet.js';
+const snippets = (window as any).OpenAPISnippets.getEndpointSnippets(data, path, method, targets);
+```
+
+### ✅ Après (v1.0.0)
+```typescript
+import { getEndpointSnippets } from '@sctg/openapi-snippet';
+const snippets = getEndpointSnippets(data, path, method, targets);
+```
+
+## Améliorations
+
+1. **TypeScript natif** - Le module est écrit en TypeScript pur avec types générés automatiquement
+2. **Exports corrects** - Les exports ES6 sont correctement configurés dans `package.json`
+3. **Pas de build dans les projets consommateurs** - Plus besoin de faire `npm run build` ou d'accéder à `node_modules`
+4. **Utilisation directe** - Simple import des fonctions nécessaires
+
+## Structure du projet
+
+```
+src/
+├── index.ts           # Point d'entrée principal
+└── openapi-to-har.ts  # Conversion OpenAPI vers HAR
+
+dist/
+├── index.js           # ES Module compilé
+├── index.d.ts         # Fichier de types TypeScript
+├── openapi-to-har.js
+├── openapi-to-har.d.ts
+├── openapisnippet.js      # UMD pour le navigateur (non-minifié)
+└── openapisnippet.min.js  # UMD pour le navigateur (minifié)
+```
+
+## Utilisation en Node.js
+
+```typescript
+import { getSnippets, getEndpointSnippets } from '@sctg/openapi-snippet';
+
+// Obtenir tous les snippets
+const allSnippets = getSnippets(openApiDocument, ['shell_curl', 'javascript_fetch']);
+
+// Obtenir les snippets pour un endpoint spécifique
+const endpointSnippets = getEndpointSnippets(
+  openApiDocument, 
+  '/pets', 
+  'get', 
+  ['shell_curl', 'javascript_fetch']
+);
+```
+
+## Utilisation en navigateur
+
+Pour le navigateur, incluez le fichier UMD et utilisez la variable globale `OpenAPISnippets` :
+
+```html
+<script src="node_modules/@sctg/openapi-snippet/dist/openapisnippet.min.js"></script>
+<script>
+  const snippets = OpenAPISnippets.getEndpointSnippets(data, path, method, targets);
+</script>
+```
+
+## Types TypeScript
+
+Les types sont inclus automatiquement :
+
+```typescript
+interface SnippetItem {
+  id: string;
+  mimeType?: string;
+  title: string;
+  content: string;
+}
+
+interface EndpointSnippetResult {
+  method: string;
+  url: string;
+  description?: string;
+  resource?: string;
+  snippets: SnippetItem[];
+}
+
+function getEndpointSnippets(
+  openApi: any,
+  path: string,
+  method: string,
+  targets: string[],
+  values?: Record<string, any>
+): EndpointSnippetResult;
+
+function getSnippets(
+  openApi: any,
+  targets: string[]
+): EndpointSnippetResult[];
+```
+
+## Build
+
+```bash
+npm install
+npm run build
+```
+
+## Tests
+
+```bash
+npm test
+```

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@sctg/openapi-snippet",
-  "version": "0.15.0",
+  "version": "1.0.0",
   "description": "Generates code snippets from Open API (previously Swagger) documents.",
   "type": "module",
   "repository": {
@@ -15,10 +15,17 @@
   ],
   "author": "Erik Wittern",
   "license": "MIT",
-  "main": "index.js",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "scripts": {
     "test": "node test/test.js | tap-spec",
-    "build": "webpack"
+    "build": "tsc && webpack --config webpack.config.mjs"
   },
   "dependencies": {
     "@sctg/httpsnippet": "^3.0.12",
@@ -33,6 +40,7 @@
   },
   "devDependencies": {
     "@babel/preset-env": "^7.25.8",
+    "@types/node": "^20.0.0",
     "babel-loader": "^10.0.0",
     "process": "^0.11.10",
     "stream-browserify": "^3.0.0",
@@ -41,6 +49,7 @@
     "vm-browserify": "^1.1.0",
     "tap-spec": "^5.0.0",
     "tape": "^5.9.0",
+    "typescript": "^5.0.0",
     "uglifyify": "^5.0.0",
     "webpack": "^5.95.0",
     "webpack-cli": "^6.0.1"