Release v0.11.0

Author: hugobessa

.husky/pre-commit

@@ -0,0 +1 @@
+npm run lint:implementations && npm run format:implementations

ATTACHMENTS.md

@@ -444,8 +444,7 @@ See [src/implementations/vintasend-implementation-template/src/attachment-manage
 Your custom `AttachmentManager` must implement:
 
 ```typescript
-import { BaseAttachmentManager } from 'vintasend/dist/services/attachment-manager/base-attachment-manager';
-import type { AttachmentFile } from 'vintasend/dist/types/attachment';
+import { BaseAttachmentManager, type AttachmentFile } from 'vintasend';
 
 export class MyAttachmentManager extends BaseAttachmentManager {
   /**
@@ -518,7 +517,7 @@ You can override these utility methods from `BaseAttachmentManager`:
 ### Example: Azure Blob Storage
 
 ```typescript
-import { BaseAttachmentManager } from 'vintasend/dist/services/attachment-manager/base-attachment-manager';
+import { BaseAttachmentManager } from 'vintasend';
 import { BlobServiceClient, ContainerClient } from '@azure/storage-blob';
 
 export class AzureBlobAttachmentManager extends BaseAttachmentManager {
@@ -879,8 +878,7 @@ await vintaSend.sendNotification({
 To add attachment support to a custom adapter:
 
 ```typescript
-import { BaseNotificationAdapter } from 'vintasend';
-import type { StoredAttachment } from 'vintasend/dist/types/attachment';
+import { BaseNotificationAdapter, type StoredAttachment } from 'vintasend';
 
 export class MyAdapter extends BaseNotificationAdapter {
   // Declare that this adapter supports attachments

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+# Version 0.11.0
+
+* Centralized most type exports in the root package, so all usages can import directly from 'vintasend'.
+* Adjusted linter/formatter rules and scripts to ensure consistency between the root package and all implementations.
+
 ## Version 0.10.0
 
 * Support vintasend-react-email.

biome.json

@@ -34,5 +34,22 @@
       "semicolons": "always",
       "trailingCommas": "all"
     }
-  }
+  },
+  "overrides": [
+    {
+      "includes": [
+        "**/*.test.ts",
+        "**/*.test.tsx",
+        "**/__tests__/**/*.ts",
+        "**/__tests__/**/*.tsx"
+      ],
+      "linter": {
+        "rules": {
+          "suspicious": {
+            "noExplicitAny": "off"
+          }
+        }
+      }
+    }
+  ]
 }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "vintasend",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "main": "dist/index.js",
   "files": [
     "dist"
@@ -9,27 +9,33 @@
   "license": "MIT",
   "scripts": {
     "lint": "biome check .",
-    "format": "biome format .",
+    "format": "biome check --write .",
     "check": "biome check --write .",
     "build": "tsc",
     "prepublishOnly": "npm run build",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "implementation:generate": "node scripts/generate-implementation.js",
+    "lint:implementations": "node scripts/run-implementations-script.js lint",
+    "format:implementations": "node scripts/run-implementations-script.js format",
     "test:implementations:local": "node scripts/test-implementations-local.js",
+    "build:implementations:local": "node scripts/test-implementations-local.js --command=build",
+    "release:prepare": "npm run format:implementations && npm run test:implementations:local && npm run build:implementations:local",
     "release:bump": "node scripts/release-bump.js",
     "release:bump:patch": "node scripts/release-bump.js --bump=patch",
     "release:bump:minor": "node scripts/release-bump.js --bump=minor",
     "release:bump:alpha": "node scripts/release-bump.js --bump=alpha",
     "release:bump:promote": "node scripts/release-bump.js --bump=promote",
-    "release:publish": "node scripts/release-publish.js"
+    "release:publish": "node scripts/release-publish.js",
+    "prepare": "husky"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.11",
+    "@biomejs/biome": "^2.4.5",
     "@types/mime-types": "^3.0.1",
     "@types/node": "^25.0.8",
     "@vitest/coverage-v8": "4.0.18",
+    "husky": "^9.1.7",
     "typescript": "^5.9.3",
     "vitest": "4.0.18"
   },

scripts/run-implementations-script.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const { spawnSync } = require("child_process");
+
+function run(command, args, cwd) {
+  const result = spawnSync(command, args, {
+    cwd,
+    stdio: "inherit",
+    shell: false,
+  });
+
+  if (result.status !== 0) {
+    throw new Error(`Command failed: ${command} ${args.join(" ")}`);
+  }
+}
+
+function getImplementationsRoot(repoRoot) {
+  return path.join(repoRoot, "src", "implementations");
+}
+
+function getImplementationDirs(implementationsRoot) {
+  return fs
+    .readdirSync(implementationsRoot, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory() && entry.name !== 'vintasend-implementation-template')
+    .map((entry) => path.join(implementationsRoot, entry.name))
+    .filter((dirPath) => fs.existsSync(path.join(dirPath, "package.json")))
+    .sort((a, b) => a.localeCompare(b));
+}
+
+const scriptName = process.argv[2];
+
+if (!scriptName) {
+  console.error("Usage: node scripts/run-implementations-script.js <script>");
+  process.exit(1);
+}
+
+const repoRoot = process.cwd();
+const implementationsRoot = getImplementationsRoot(repoRoot);
+const implementationDirs = getImplementationDirs(implementationsRoot);
+
+if (implementationDirs.length === 0) {
+  console.log("No implementation packages found.");
+  process.exit(0);
+}
+
+for (const packageDir of implementationDirs) {
+  const name = path.basename(packageDir);
+  console.log(`\nRunning ${scriptName} in ${name}...`);
+  run("npm", ["run", scriptName], packageDir);
+}

scripts/test-implementations-local.js

@@ -61,7 +61,39 @@ function ensureLocalVintaSend(pkgJson, localSpec) {
 const repoRoot = process.cwd();
 const implementationsRoot = path.join(repoRoot, "src", "implementations");
 const originalContents = new Map();
-const requestedImplementations = process.argv.slice(2);
+
+function parseArgs(argv) {
+  let command = "test";
+  const implementations = [];
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+
+    if (arg.startsWith("--command=")) {
+      command = arg.slice("--command=".length);
+      continue;
+    }
+
+    if (arg === "--command") {
+      const next = argv[i + 1];
+      if (!next) {
+        throw new Error("Missing value for --command");
+      }
+
+      command = next;
+      i += 1;
+      continue;
+    }
+
+    implementations.push(arg);
+  }
+
+  return { command, implementations };
+}
+
+const { command, implementations: requestedImplementations } = parseArgs(
+  process.argv.slice(2),
+);
 
 const allImplementationDirs = fs
   .readdirSync(implementationsRoot, { withFileTypes: true })
@@ -99,6 +131,7 @@ if (implementationDirs.length === 0) {
 }
 
 try {
+  console.log(`Running implementation script: ${command}`);
   console.log("Building local vintasend...");
   run("npm", ["run", "build"], repoRoot);
 
@@ -117,9 +150,9 @@ try {
 
   for (const packageDir of implementationDirs) {
     const name = path.basename(packageDir);
-    console.log(`\nTesting ${name} with local vintasend...`);
+    console.log(`\nRunning ${command} on ${name} with local vintasend...`);
     run("npm", ["install", "--no-package-lock"], packageDir);
-    run("npm", ["test"], packageDir);
+    run("npm", ["run", command], packageDir);
   }
 } catch (error) {
   console.error(error instanceof Error ? error.message : error);

src/implementations/vintasend-implementation-template/.husky/pre-commit

@@ -0,0 +1 @@
+npm run lint && npm run format

src/implementations/vintasend-implementation-template/README.md

@@ -250,7 +250,7 @@ See [`vintasend-aws-s3-attachments`](../vintasend-aws-s3-attachments) for a comp
 - **Deduplication**: Implement `findFileByChecksum()` to prevent storing duplicate files
 - **Presigned URLs**: Generate temporary URLs for secure file access without exposing credentials
 - **Streaming**: Support streaming for large files to avoid memory issues
-- **Type Safety**: All methods use strict TypeScript types from `vintasend/dist/types/attachment`
+- **Type Safety**: All methods use strict TypeScript types from `vintasend`
 
 ### Logger
 

src/implementations/vintasend-implementation-template/biome.json

@@ -1,22 +1,26 @@
 {
-  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.4.5/schema.json",
   "vcs": {
     "enabled": false,
     "clientKind": "git",
     "useIgnoreFile": false
   },
   "files": {
     "ignoreUnknown": false,
-    "ignore": []
+    "includes": ["src/**/*.{ts,tsx}", "!dist", "!node_modules"]
   },
   "formatter": {
     "enabled": true,
     "indentStyle": "space",
     "indentWidth": 2,
     "lineWidth": 100
   },
-  "organizeImports": {
-    "enabled": true
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
   },
   "linter": {
     "enabled": true,
@@ -30,5 +34,22 @@
       "semicolons": "always",
       "trailingCommas": "all"
     }
-  }
+  },
+  "overrides": [
+    {
+      "includes": [
+        "**/*.test.ts",
+        "**/*.test.tsx",
+        "**/__tests__/**/*.ts",
+        "**/__tests__/**/*.tsx"
+      ],
+      "linter": {
+        "rules": {
+          "suspicious": {
+            "noExplicitAny": "off"
+          }
+        }
+      }
+    }
+  ]
 }