feat: configure ci/cd workflows and resolve eslint warnings (#15)

Author: AteebNoOne

.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run lint
+        run: npm run lint
+
+      - name: Run tests
+        run: npm run test:ci
+
+      - name: Build package
+        run: npm run build

.github/workflows/publish.yml

@@ -0,0 +1,47 @@
+name: Publish to NPM
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: 'https://registry.npmjs.org/'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run lint
+        run: npm run lint
+
+      - name: Run tests
+        run: npm run test:ci
+
+      - name: Build package
+        run: npm run build
+
+      - name: Publish to NPM
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -26,4 +26,7 @@ build/
 
 __tests__
 
-*.tgz
+*.tgz
+
+# Test coverage
+coverage/

CONTRIBUTING.md

@@ -82,6 +82,16 @@ Discussions: GitHub Discussions
 
 Pull Requests: Always create a PR to the main branch
 
+## 🚀 CI/CD & Releases
+
+We use GitHub Actions to automate testing and package publishing.
+
+1. **Pull Requests**: Every PR targeting the `main` branch triggers the **CI** workflow which runs `npm run lint`, `npm run test:ci`, and `npm run build`. The PR cannot be merged if any check fails.
+2. **Releasing a New Version**:
+   - Bump the version locally: `npm version patch` (or `minor` / `major`). This will update `package.json` and create a Git tag.
+   - Push the code and the tag: `git push origin main --tags`.
+   - The push of a tag matching `v*` triggers the **Publish to NPM** workflow, which automatically runs all tests, builds the ESM and CommonJS bundles, publishes the package to the public NPM registry, and creates a GitHub Release with autogenerated release notes.
+
 🙏 Credits
 
 Maintained with ❤️ by iTeebot

SECURITY.md

@@ -16,7 +16,7 @@ We actively support the latest major release and security patches for the previo
 If you discover a security vulnerability, **DO NOT** open a public GitHub issue.
 
 Instead, please report it privately by emailing:  
-**security@realteebot.dev**
+**security-npm-ai-hooks@iteebot.com**
 
 We take all security issues seriously and will respond within 48 hours.
 

eslint.config.mjs

@@ -0,0 +1,17 @@
+import eslint from "@eslint/js";
+import tseslint from "typescript-eslint";
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    ignores: ["dist/**", "node_modules/**", "coverage/**", "jest.config.js", "tsconfig*.json"]
+  },
+  {
+    files: ["**/*.ts"],
+    rules: {
+      "@typescript-eslint/no-explicit-any": "warn",
+      "@typescript-eslint/no-unused-vars": ["warn", { "argsIgnorePattern": "^_" }]
+    }
+  }
+);

examples/demo.ts

@@ -18,7 +18,7 @@ async function testAllProviders() {
   console.log('🚀 Testing All AI Providers\n');
 
   // Initialize with all available providers
-  const providers: Array<{ provider: string; key: string; defaultModel: string }> = [];
+  const providers: Array<{ provider: 'openai' | 'claude' | 'gemini' | 'groq' | 'openrouter' | 'deepseek' | 'xai' | 'perplexity' | 'mistral'; key: string; defaultModel: string }> = [];
 
   // Check for API keys in various environment variable formats
   if (process.env.OPENAI_KEY || process.env.OPENAI_API_KEY || process.env.OPENAI_KEY) {
@@ -111,10 +111,9 @@ async function testAllProviders() {
   providers.forEach(p => console.log(`   - ${p.provider}`));
   console.log('');
 
-  // Initialize with all providers
   initAIHooks({
-    providers: providers as any, // Type assertion for compatibility
-    defaultProvider: 'groq' as any // Prefer Groq if available
+    providers, // Type assertion for compatibility
+    defaultProvider: 'groq' // Prefer Groq if available
   });
 
   console.log('Available providers:', getAvailableProviders());
@@ -154,7 +153,7 @@ async function testAllProviders() {
     try {
       const summarize = wrap((text: string) => text, { 
         task: "summarize", 
-        provider: providerName as any
+        provider: providerName
       });
 
       const result = await summarize(testText);
@@ -181,10 +180,9 @@ async function testAllProviders() {
   const { provider: selectedProvider } = getProvider();
   console.log(`Selected default provider: ${selectedProvider}`);
 
-  // Test specific provider selection
   if (providers.length > 1) {
     const secondProvider = providers[1].provider;
-    const { provider: specificProvider } = getProvider(secondProvider as any);
+    const { provider: specificProvider } = getProvider(secondProvider);
     console.log(`Selected specific provider (${secondProvider}): ${specificProvider}`);
   }
 

examples/express/src/routes/summarize.ts

@@ -6,7 +6,7 @@ import { wrap } from "npm-ai-hooks";
 // dotenv.config();
 
 // Initialize providers with environment variables
-const providers: Array<{ provider: string; key: string; defaultModel?: string }> = [];
+const providers: Array<{ provider: 'openai' | 'groq' | 'claude' | 'gemini' | 'openrouter'; key: string; defaultModel?: string }> = [];
 
 if (process.env.OPENAI_KEY) {
   providers.push({
@@ -50,8 +50,8 @@ if (process.env.OPENROUTER_KEY) {
 // Initialize with available providers
 if (providers.length > 0) {
   initAIHooks({
-    providers: providers as any,
-    defaultProvider: 'gemini' as any
+    providers,
+    defaultProvider: 'gemini'
   });
   console.log(`✅ Initialized ${providers.length} AI providers for Express server`);
 } else {
@@ -77,11 +77,12 @@ router.get("/", async (req: Request, res: Response) => {
       summary: result.output,
       meta: result.meta
     });
-  } catch (error: any) {
-    console.error("Summarize Error:", error);
+  } catch (error: unknown) {
+    const err = error as Error & { provider?: string };
+    console.error("Summarize Error:", err);
     return res.status(500).json({
-      error: error.message || "Internal Server Error",
-      provider: error.provider || null
+      error: err.message || "Internal Server Error",
+      provider: err.provider || null
     });
   }
 });

examples/model-switch/wrong-models.ts

@@ -3,15 +3,15 @@ import { wrap } from "../../src/wrap";
 async function run() {
   // Wrong OpenRouter model
   try {
-    const wrongOpenRouter = wrap((text: string) => text, { task: "summarize", provider: "openrouter", model: "invalid-model" as any });
+    const wrongOpenRouter = wrap((text: string) => text, { task: "summarize", provider: "openrouter", model: "invalid-model" as never });
     await wrongOpenRouter("Test text");
   } catch (err: unknown) {
     console.error("❌ OpenRouter error:", err);
   }
 
   // Wrong Groq model
   try {
-    const wrongGroq = wrap((text: string) => text, { task: "explain", provider: "groq", model: "invalid-groq-model" as any });
+    const wrongGroq = wrap((text: string) => text, { task: "explain", provider: "groq", model: "invalid-groq-model" as never });
     await wrongGroq("Test text");
   } catch (err: unknown) {
     console.error("❌ Groq error:", err);

examples/multimodal/vision-example.ts

@@ -161,6 +161,7 @@ export {
   extractTextFromImage,
   reviewCodeScreenshot,
   analyzeDocument,
-  compareImages
+  compareImages,
+  main
 };