feat: Implement Athena Classifier Service with gRPC support

- Added athena.ts to define protobuf messages and service for classification.
- Introduced empty.ts for handling empty messages in gRPC.
- Developed main.ts to compute image hashes and send classification requests to the Athena ClassifierService.
- Created ClassifyImageOptions interface for better request handling.
- Implemented classifyImage function to manage image classification requests and responses.

Author: abbottdev-kroll

README.md

@@ -1,121 +1,31 @@
-# node-typescript-boilerplate
+## Regenerating the TypeScript gRPC Client
 
-[![Sponsor][sponsor-badge]][sponsor]
-[![TypeScript version][ts-badge]][typescript-5-7]
-[![Node.js version][nodejs-badge]][nodejs]
-[![APLv2][license-badge]][license]
-[![Build Status - GitHub Actions][gha-badge]][gha-ci]
+This project uses [`@protobuf-ts/plugin`](https://github.com/timostamm/protobuf-ts) to generate TypeScript-native gRPC clients and message types for use with `@grpc/grpc-js`.
 
-👩🏻‍💻 Developer Ready: A comprehensive template. Works out of the box for most [Node.js][nodejs] projects.
+### How to update the generated client code
 
-🏃🏽 Instant Value: All basic tools included and configured:
+1. **Ensure dependencies are installed:**
+	```sh
+	npm install --save-dev @protobuf-ts/plugin
+	npm install --save @grpc/grpc-js
+	```
 
-- [TypeScript][typescript] [5.7][typescript-5-7]
-- [ESM][esm]
-- [ESLint][eslint] with some initial rules recommendation
-- [Vitest][vitest] for fast unit testing and code coverage
-- Type definitions for Node.js
-- [Prettier][prettier] to enforce consistent code style
-- NPM [scripts](#available-scripts) for common operations
-- [EditorConfig][editorconfig] for consistent coding style
-- Reproducible environments thanks to [Volta][volta]
-- Example configuration for [GitHub Actions][gh-actions]
-- Simple example of TypeScript code and unit test
+2. **Run the following command to regenerate the client and types:**
+	```sh
+	npx protoc \
+	  --plugin=protoc-gen-ts=./node_modules/.bin/protoc-gen-ts \
+	  --ts_out=client_grpc1:./src/athena \
+	  --proto_path=./athena-protobufs/athena \
+	  ./athena-protobufs/athena/athena.proto
+	```
+	- This will generate `.ts` files in `src/athena/` including a gRPC client compatible with `@grpc/grpc-js`.
 
-🤲 Free as in speech: available under the APLv2 license.
+3. **Update your imports in your code as needed:**
+	- The main client will be in `src/athena/athena.grpc-client.ts`.
+	- Message types and enums are in `src/athena/athena.ts`.
 
-## Getting Started
+### Notes
+- If you add or change proto files, rerun the above command to keep the TypeScript client in sync.
+- If you see TypeScript errors about missing modules, ensure your `tsconfig.json` includes the `src/athena` directory and restart your IDE/tsserver.
 
-This project is intended to be used with the latest Active LTS release of [Node.js][nodejs].
-
-### Use as a repository template
-
-To start, just click the **[Use template][repo-template-action]** link (or the green button). Start adding your code in the `src` and unit tests in the `__tests__` directories.
-
-### Clone repository
-
-To clone the repository, use the following commands:
-
-```sh
-git clone https://github.com/jsynowiec/node-typescript-boilerplate
-cd node-typescript-boilerplate
-npm install
-```
-
-### Download latest release
-
-Download and unzip the current **main** branch or one of the tags:
-
-```sh
-wget https://github.com/jsynowiec/node-typescript-boilerplate/archive/main.zip -O node-typescript-boilerplate.zip
-unzip node-typescript-boilerplate.zip && rm node-typescript-boilerplate.zip
-```
-
-## Available Scripts
-
-- `clean` - remove coverage data, cache and transpiled files,
-- `prebuild` - lint source files and tests before building,
-- `build` - transpile TypeScript to ES6,
-- `build:watch` - interactive watch mode to automatically transpile source files,
-- `lint` - lint source files and tests,
-- `prettier` - reformat files,
-- `test` - run tests,
-- `test:watch` - interactive watch mode to automatically re-run tests
-- `test:coverage` - run test and print out test coverage
-
-## Additional Information
-
-### Why include Volta
-
-I recommend to [install][volta-getting-started] Volta and use it to manage your project's toolchain.
-
-[Volta][volta]’s toolchain always keeps track of where you are, it makes sure the tools you use always respect the settings of the project you’re working on. This means you don’t have to worry about changing the state of your installed software when switching between projects. For example, it's [used by engineers at LinkedIn][volta-tomdale] to standardize tools and have reproducible development environments.
-
-### Why Vitest instead of Jest
-
-I recommend using [Vitest][vitest] for unit and integration testing of your TypeScript code.
-
-In 2023, my team and I gradually switched from Jest to [Vitest][vitest] in all the projects. We've found out that generally, Vitest is faster than Jest, especially for large test suits. Furthermore, Vitest has native support for ES modules, is easier to configure, and has a much nicer developer experience when used with TypeScript. For example, when working with mocks, spies and types.
-
-Nevertheless, the choice of specific tooling always depends on the specific requirements and characteristics of the project.
-
-### ES Modules
-
-This template uses native [ESM][esm]. Make sure to read [this][nodejs-esm], and [this][ts47-esm] first.
-
-If your project requires CommonJS, you will have to [convert to ESM][sindresorhus-esm].
-
-Please do not open issues for questions regarding CommonJS or ESM on this repo.
-
-## Backers & Sponsors
-
-Support this project by becoming a [sponsor][sponsor].
-
-## License
-
-Licensed under the APLv2. See the [LICENSE](https://github.com/jsynowiec/node-typescript-boilerplate/blob/main/LICENSE) file for details.
-
-[ts-badge]: https://img.shields.io/badge/TypeScript-5.7-blue.svg
-[nodejs-badge]: https://img.shields.io/badge/Node.js-22-blue.svg
-[nodejs]: https://nodejs.org/dist/latest-v22.x/docs/api/
-[gha-badge]: https://github.com/jsynowiec/node-typescript-boilerplate/actions/workflows/nodejs.yml/badge.svg
-[gha-ci]: https://github.com/jsynowiec/node-typescript-boilerplate/actions/workflows/nodejs.yml
-[typescript]: https://www.typescriptlang.org/
-[typescript-5-7]: https://devblogs.microsoft.com/typescript/announcing-typescript-5-7/
-[license-badge]: https://img.shields.io/badge/license-APLv2-blue.svg
-[license]: https://github.com/jsynowiec/node-typescript-boilerplate/blob/main/LICENSE
-[sponsor-badge]: https://img.shields.io/badge/♥-Sponsor-fc0fb5.svg
-[sponsor]: https://github.com/sponsors/jsynowiec
-[eslint]: https://github.com/eslint/eslint
-[prettier]: https://prettier.io
-[volta]: https://volta.sh
-[volta-getting-started]: https://docs.volta.sh/guide/getting-started
-[volta-tomdale]: https://twitter.com/tomdale/status/1162017336699838467
-[gh-actions]: https://github.com/features/actions
-[repo-template-action]: https://github.com/jsynowiec/node-typescript-boilerplate/generate
-[esm]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules
-[sindresorhus-esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
-[nodejs-esm]: https://nodejs.org/docs/latest-v16.x/api/esm.html
-[ts47-esm]: https://devblogs.microsoft.com/typescript/announcing-typescript-4-7/#esm-nodejs
-[editorconfig]: https://editorconfig.org
-[vitest]: https://vitest.dev
+---

__tests__/unit/Steamboat-willie.jpg

@@ -1,40 +1,33 @@
 import { describe, it, afterEach, beforeEach, vi, expect } from 'vitest';
-import { Delays, greeter } from '../../src/main.js';
-
-describe('greeter function', () => {
-  const name = 'John';
-
-  beforeEach(() => {
-    // Read more about fake timers
-    // https://vitest.dev/api/vi.html#vi-usefaketimers
-    vi.useFakeTimers();
-  });
-
-  afterEach(() => {
-    vi.useRealTimers();
-    vi.restoreAllMocks();
-  });
-
-  // Assert if setTimeout was called properly
-  it('delays the greeting by 2 seconds', async () => {
-    vi.spyOn(global, 'setTimeout');
-    const p = greeter(name);
-
-    await vi.runAllTimersAsync();
-    await p;
-
-    expect(setTimeout).toHaveBeenCalledTimes(1);
-    expect(setTimeout).toHaveBeenLastCalledWith(
-      expect.any(Function),
-      Delays.Long,
-    );
-  });
-
-  // Assert greeter result
-  it('greets a user with `Hello, {name}` message', async () => {
-    const p = greeter(name);
-    await vi.runAllTimersAsync();
-
-    expect(await p).toBe(`Hello, ${name}`);
+import { classifyImage, computeHashesFromStream, ClassifyImageOptions } from '../../src/main.js';
+
+
+import fs from 'fs';
+
+describe('classifyImage function', () => {
+  it('should classify Steamboat-willie.jpg and return responses (integration smoke test)', async () => {
+    // This is a smoke test. You must have a running gRPC server at localhost:50051 for this to pass.
+    // You may want to mock the gRPC client for true unit testing.
+    const imagePath = __dirname + '/Steamboat-willie.jpg';
+    const imageStream = fs.createReadStream(imagePath);
+    const options: ClassifyImageOptions = {
+      imageStream,
+      deploymentId: 'test-deployment',
+      affiliate: 'test-affiliate',
+      correlationId: 'test-correlation',
+      // encoding, format, grpcAddress use defaults
+    };
+    // This will fail if no server is running, but will exercise the code path.
+    let error: any = null;
+    try {
+      const responses = await classifyImage(options);
+      expect(Array.isArray(responses)).toBe(true);
+    } catch (err) {
+      error = err;
+    }
+    // Accept either a successful call or a connection error (for CI/dev convenience)
+    if (error) {
+      expect(error.message).toMatch(/connect|unavailable|ECONNREFUSED|14/);
+    }
   });
 });