@rx-ted/packages-honest-plugins 1.0.1

package/s3/dist/s3.driver.js

@@ -0,0 +1,221 @@
+let awsS3 = null;
+async function getAwsS3() {
+    if (!awsS3) {
+        const name = '@aws-sdk/client-s3';
+        awsS3 = await import(name);
+    }
+    return awsS3;
+}
+let awsPresigner = null;
+async function getAwsPresigner() {
+    if (!awsPresigner) {
+        const name = '@aws-sdk/s3-request-presigner';
+        awsPresigner = await import(name);
+    }
+    return awsPresigner;
+}
+export async function createS3Driver(options) {
+    const logger = options.logger;
+    if (logger) {
+        logger.debug({
+            bucket: options.bucket,
+            endpoint: options.endpoint,
+            region: options.region,
+        }, 'S3Driver: initializing');
+    }
+    const s3 = await getAwsS3();
+    const client = new s3.S3Client({
+        endpoint: options.endpoint,
+        region: options.region || 'us-east-1',
+        credentials: {
+            accessKeyId: options.accessKeyId,
+            secretAccessKey: options.secretAccessKey,
+        },
+        forcePathStyle: options.forcePathStyle,
+    });
+    const driver = new S3Driver(client, options, logger);
+    if (logger) {
+        logger.info('S3Driver: initialized');
+    }
+    return driver;
+}
+class S3Driver {
+    client;
+    options;
+    logger;
+    constructor(client, options, logger) {
+        this.client = client;
+        this.options = options;
+        this.logger = logger;
+    }
+    async upload(key, data, uploadOptions) {
+        let body;
+        if (data instanceof Uint8Array) {
+            body = data;
+        }
+        else {
+            const chunks = [];
+            const reader = data.getReader();
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                chunks.push(value);
+            }
+            const totalLength = chunks.reduce((sum, c) => sum + c.byteLength, 0);
+            const merged = new Uint8Array(totalLength);
+            let offset = 0;
+            for (const chunk of chunks) {
+                merged.set(chunk, offset);
+                offset += chunk.byteLength;
+            }
+            body = merged;
+        }
+        const s3 = await getAwsS3();
+        const command = new s3.PutObjectCommand({
+            Bucket: this.options.bucket,
+            Key: key,
+            Body: body,
+            ContentType: uploadOptions?.contentType,
+            Metadata: uploadOptions?.metadata,
+        });
+        await this.client.send(command);
+        const url = this.options.baseUrl
+            ? `${this.options.baseUrl.replace(/\/$/, '')}/${key}`
+            : undefined;
+        if (this.logger) {
+            this.logger.debug({ key, size: body?.length }, 'S3Driver: uploaded');
+        }
+        return {
+            key,
+            size: body?.length || 0,
+            contentType: uploadOptions?.contentType || this.guessContentType(key),
+            lastModified: new Date(),
+            url,
+        };
+    }
+    async download(key) {
+        const s3 = await getAwsS3();
+        const command = new s3.GetObjectCommand({
+            Bucket: this.options.bucket,
+            Key: key,
+        });
+        const response = await this.client.send(command);
+        if (!response.Body) {
+            return new Uint8Array();
+        }
+        const chunks = [];
+        for await (const chunk of response.Body) {
+            chunks.push(chunk);
+        }
+        const totalLength = chunks.reduce((sum, c) => sum + c.byteLength, 0);
+        const merged = new Uint8Array(totalLength);
+        let offset = 0;
+        for (const chunk of chunks) {
+            merged.set(chunk, offset);
+            offset += chunk.byteLength;
+        }
+        return merged;
+    }
+    async getUrl(key, expiresIn) {
+        if (this.options.baseUrl) {
+            return `${this.options.baseUrl.replace(/\/$/, '')}/${key}`;
+        }
+        const [s3, presigner] = await Promise.all([getAwsS3(), getAwsPresigner()]);
+        const command = new s3.GetObjectCommand({
+            Bucket: this.options.bucket,
+            Key: key,
+        });
+        return presigner.getSignedUrl(this.client, command, {
+            expiresIn: expiresIn || 3600,
+        });
+    }
+    async delete(key) {
+        try {
+            const s3 = await getAwsS3();
+            const command = new s3.DeleteObjectCommand({
+                Bucket: this.options.bucket,
+                Key: key,
+            });
+            await this.client.send(command);
+            if (this.logger) {
+                this.logger.debug({ key }, 'S3Driver: deleted');
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async exists(key) {
+        try {
+            const s3 = await getAwsS3();
+            const command = new s3.HeadObjectCommand({
+                Bucket: this.options.bucket,
+                Key: key,
+            });
+            await this.client.send(command);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async list(prefix) {
+        const s3 = await getAwsS3();
+        const command = new s3.ListObjectsV2Command({
+            Bucket: this.options.bucket,
+            Prefix: prefix,
+        });
+        const response = await this.client.send(command);
+        const results = [];
+        if (response.Contents) {
+            for (const item of response.Contents) {
+                results.push({
+                    key: item.Key || '',
+                    size: item.Size || 0,
+                    contentType: this.guessContentType(item.Key || ''),
+                    lastModified: item.LastModified || new Date(),
+                });
+            }
+        }
+        return results;
+    }
+    async close() {
+        this.client.destroy();
+        if (this.logger) {
+            this.logger.info('S3Driver: closed');
+        }
+    }
+    async healthCheck() {
+        try {
+            const s3 = await getAwsS3();
+            const command = new s3.ListObjectsV2Command({
+                Bucket: this.options.bucket,
+                MaxKeys: 1,
+            });
+            await this.client.send(command);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    guessContentType(key) {
+        const ext = key.split('.').pop()?.toLowerCase() || '';
+        const mimeTypes = {
+            html: 'text/html',
+            css: 'text/css',
+            js: 'application/javascript',
+            json: 'application/json',
+            png: 'image/png',
+            jpg: 'image/jpeg',
+            jpeg: 'image/jpeg',
+            gif: 'image/gif',
+            svg: 'image/svg+xml',
+            pdf: 'application/pdf',
+            txt: 'text/plain',
+        };
+        return mimeTypes[ext] || 'application/octet-default';
+    }
+}

package/s3/dist/s3.plugin.d.ts

@@ -0,0 +1,24 @@
+import type { Hono } from 'hono';
+import type { ILogger } from '@rx-ted/packages-core';
+import type { Application, IPlugin } from '@rx-ted/packages-honest';
+import type { FileDriver, S3Options } from './types';
+export declare const S3_CONTEXT_KEY = "honest:s3";
+export declare const S3_GLOBAL_KEY = "s3";
+export interface S3PluginOptions {
+    connection: S3Options;
+    contextKey?: string;
+}
+export declare class S3Plugin implements IPlugin {
+    static readonly globalKey = "s3";
+    readonly name = "s3-plugin";
+    readonly version = "1.0.0";
+    logger?: ILogger;
+    private driver;
+    private readonly connection;
+    private readonly contextKey;
+    constructor(options: S3PluginOptions);
+    getClient(): FileDriver;
+    beforeModulesRegistered(app: Application, _hono: Hono): Promise<void>;
+    afterModulesRegistered(_app: Application, _hono: Hono): Promise<void>;
+    close(): Promise<void>;
+}

package/s3/dist/s3.plugin.js

@@ -0,0 +1,58 @@
+import { ComponentManager, maskSensitive } from '@rx-ted/packages-honest';
+import { createS3Driver } from './s3.driver';
+export const S3_CONTEXT_KEY = 'honest:s3';
+export const S3_GLOBAL_KEY = 's3';
+export class S3Plugin {
+    static globalKey = S3_GLOBAL_KEY;
+    name = 's3-plugin';
+    version = '1.0.0';
+    logger;
+    driver = null;
+    connection;
+    contextKey;
+    constructor(options) {
+        this.connection = options.connection;
+        this.contextKey = options.contextKey ?? S3_CONTEXT_KEY;
+    }
+    getClient() {
+        if (!this.driver) {
+            throw new Error('S3 not connected. Ensure beforeModulesRegistered has run.');
+        }
+        return this.driver;
+    }
+    async beforeModulesRegistered(app, _hono) {
+        this.logger?.info('S3: initializing...');
+        const connInfo = {
+            category: 'plugins',
+            endpoint: this.connection.endpoint,
+            region: this.connection.region,
+            bucket: this.connection.bucket,
+            accessKeyId: maskSensitive(this.connection.accessKeyId),
+        };
+        try {
+            this.driver = await createS3Driver(this.connection);
+            app.getContext().set(this.contextKey, this.driver);
+            ComponentManager.registerPlugin(S3_GLOBAL_KEY, this.driver);
+            const ok = await this.driver.healthCheck();
+            if (!ok)
+                throw new Error('S3: health check failed');
+            this.logger?.info(connInfo, 'success to s3');
+        }
+        catch (error) {
+            this.logger?.error({ ...connInfo, error: error instanceof Error ? error.message : String(error) }, 'fail to connect s3');
+            throw error;
+        }
+    }
+    async afterModulesRegistered(_app, _hono) {
+        if (this.driver) {
+            const ok = await this.driver.healthCheck();
+            if (ok) {
+                this.logger?.info('S3: health check passed');
+            }
+        }
+    }
+    async close() {
+        await this.driver?.close();
+        this.driver = null;
+    }
+}

package/s3/dist/types.d.ts

@@ -0,0 +1,30 @@
+export interface FileUploadOptions {
+    contentType?: string;
+    metadata?: Record<string, string>;
+}
+export interface FileMetadata {
+    key: string;
+    size: number;
+    contentType: string;
+    lastModified: Date;
+    url?: string;
+}
+export interface S3Options {
+    endpoint?: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    bucket: string;
+    region?: string;
+    forcePathStyle?: boolean;
+    baseUrl?: string;
+}
+export interface FileDriver {
+    upload(key: string, data: Uint8Array | ReadableStream, options?: FileUploadOptions): Promise<FileMetadata>;
+    download(key: string): Promise<Uint8Array>;
+    getUrl(key: string, expiresIn?: number): Promise<string>;
+    delete(key: string): Promise<boolean>;
+    exists(key: string): Promise<boolean>;
+    list(prefix?: string): Promise<FileMetadata[]>;
+    close(): Promise<void>;
+    healthCheck(): Promise<boolean>;
+}

package/s3/dist/types.js

@@ -0,0 +1 @@
+export {};

package/s3/node_modules/.bin/esbuild

@@ -0,0 +1,22 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/ben/projects/app/node_modules/.pnpm/esbuild@0.28.1/node_modules/esbuild/node_modules:/Users/ben/projects/app/node_modules/.pnpm/esbuild@0.28.1/node_modules:/Users/ben/projects/app/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/ben/projects/app/node_modules/.pnpm/esbuild@0.28.1/node_modules/esbuild/node_modules:/Users/ben/projects/app/node_modules/.pnpm/esbuild@0.28.1/node_modules:/Users/ben/projects/app/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/esbuild@0.28.1/node_modules/esbuild/bin/esbuild" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/esbuild@0.28.1/node_modules/esbuild/bin/esbuild" "$@"
+fi
+# cmd-shim-target=/Users/ben/projects/app/node_modules/.pnpm/esbuild@0.28.1/node_modules/esbuild/bin/esbuild

package/s3/node_modules/.bin/jiti

@@ -0,0 +1,22 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/ben/projects/app/node_modules/.pnpm/jiti@2.6.1/node_modules/jiti/node_modules:/Users/ben/projects/app/node_modules/.pnpm/jiti@2.6.1/node_modules:/Users/ben/projects/app/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/ben/projects/app/node_modules/.pnpm/jiti@2.6.1/node_modules/jiti/node_modules:/Users/ben/projects/app/node_modules/.pnpm/jiti@2.6.1/node_modules:/Users/ben/projects/app/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/jiti@2.6.1/node_modules/jiti/lib/jiti-cli.mjs" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/jiti@2.6.1/node_modules/jiti/lib/jiti-cli.mjs" "$@"
+fi
+# cmd-shim-target=/Users/ben/projects/app/node_modules/.pnpm/jiti@2.6.1/node_modules/jiti/lib/jiti-cli.mjs

package/s3/node_modules/.bin/sass

@@ -0,0 +1,22 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/ben/projects/app/node_modules/.pnpm/sass@1.100.0/node_modules/sass/node_modules:/Users/ben/projects/app/node_modules/.pnpm/sass@1.100.0/node_modules:/Users/ben/projects/app/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/ben/projects/app/node_modules/.pnpm/sass@1.100.0/node_modules/sass/node_modules:/Users/ben/projects/app/node_modules/.pnpm/sass@1.100.0/node_modules:/Users/ben/projects/app/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/sass@1.100.0/node_modules/sass/sass.js" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/sass@1.100.0/node_modules/sass/sass.js" "$@"
+fi
+# cmd-shim-target=/Users/ben/projects/app/node_modules/.pnpm/sass@1.100.0/node_modules/sass/sass.js

package/s3/node_modules/.bin/tsx

@@ -0,0 +1,22 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/ben/projects/app/node_modules/.pnpm/tsx@4.23.0/node_modules/tsx/node_modules:/Users/ben/projects/app/node_modules/.pnpm/tsx@4.23.0/node_modules:/Users/ben/projects/app/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/ben/projects/app/node_modules/.pnpm/tsx@4.23.0/node_modules/tsx/node_modules:/Users/ben/projects/app/node_modules/.pnpm/tsx@4.23.0/node_modules:/Users/ben/projects/app/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/tsx@4.23.0/node_modules/tsx/dist/cli.mjs" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/tsx@4.23.0/node_modules/tsx/dist/cli.mjs" "$@"
+fi
+# cmd-shim-target=/Users/ben/projects/app/node_modules/.pnpm/tsx@4.23.0/node_modules/tsx/dist/cli.mjs

package/s3/node_modules/.bin/vite

@@ -0,0 +1,22 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/ben/projects/app/node_modules/.pnpm/vite@8.0.16_@types+node@25.9.2_esbuild@0.28.1_jiti@2.6.1_sass@1.100.0_tsx@4.23.0_yaml@2.9.0/node_modules/vite/node_modules:/Users/ben/projects/app/node_modules/.pnpm/vite@8.0.16_@types+node@25.9.2_esbuild@0.28.1_jiti@2.6.1_sass@1.100.0_tsx@4.23.0_yaml@2.9.0/node_modules:/Users/ben/projects/app/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/ben/projects/app/node_modules/.pnpm/vite@8.0.16_@types+node@25.9.2_esbuild@0.28.1_jiti@2.6.1_sass@1.100.0_tsx@4.23.0_yaml@2.9.0/node_modules/vite/node_modules:/Users/ben/projects/app/node_modules/.pnpm/vite@8.0.16_@types+node@25.9.2_esbuild@0.28.1_jiti@2.6.1_sass@1.100.0_tsx@4.23.0_yaml@2.9.0/node_modules:/Users/ben/projects/app/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/vite@8.0.16_@types+node@25.9.2_esbuild@0.28.1_jiti@2.6.1_sass@1.100.0_tsx@4.23.0_yaml@2.9.0/node_modules/vite/bin/vite.js" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/vite@8.0.16_@types+node@25.9.2_esbuild@0.28.1_jiti@2.6.1_sass@1.100.0_tsx@4.23.0_yaml@2.9.0/node_modules/vite/bin/vite.js" "$@"
+fi
+# cmd-shim-target=/Users/ben/projects/app/node_modules/.pnpm/vite@8.0.16_@types+node@25.9.2_esbuild@0.28.1_jiti@2.6.1_sass@1.100.0_tsx@4.23.0_yaml@2.9.0/node_modules/vite/bin/vite.js

package/s3/node_modules/.bin/vitest

@@ -0,0 +1,22 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/ben/projects/app/node_modules/.pnpm/vitest@4.1.8_@types+node@25.9.2_@vitest+coverage-v8@4.1.7_jsdom@29.1.1_@noble+hashes@1._7bccdcabe1f1ec543f47b71e54a2d105/node_modules/vitest/node_modules:/Users/ben/projects/app/node_modules/.pnpm/vitest@4.1.8_@types+node@25.9.2_@vitest+coverage-v8@4.1.7_jsdom@29.1.1_@noble+hashes@1._7bccdcabe1f1ec543f47b71e54a2d105/node_modules:/Users/ben/projects/app/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/ben/projects/app/node_modules/.pnpm/vitest@4.1.8_@types+node@25.9.2_@vitest+coverage-v8@4.1.7_jsdom@29.1.1_@noble+hashes@1._7bccdcabe1f1ec543f47b71e54a2d105/node_modules/vitest/node_modules:/Users/ben/projects/app/node_modules/.pnpm/vitest@4.1.8_@types+node@25.9.2_@vitest+coverage-v8@4.1.7_jsdom@29.1.1_@noble+hashes@1._7bccdcabe1f1ec543f47b71e54a2d105/node_modules:/Users/ben/projects/app/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../vitest/vitest.mjs" "$@"
+else
+  exec node  "$basedir/../vitest/vitest.mjs" "$@"
+fi
+# cmd-shim-target=/Users/ben/projects/app/packages/honest-plugins/s3/node_modules/vitest/vitest.mjs

package/s3/node_modules/.bin/yaml

@@ -0,0 +1,22 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/ben/projects/app/node_modules/.pnpm/yaml@2.9.0/node_modules/yaml/node_modules:/Users/ben/projects/app/node_modules/.pnpm/yaml@2.9.0/node_modules:/Users/ben/projects/app/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/ben/projects/app/node_modules/.pnpm/yaml@2.9.0/node_modules/yaml/node_modules:/Users/ben/projects/app/node_modules/.pnpm/yaml@2.9.0/node_modules:/Users/ben/projects/app/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/yaml@2.9.0/node_modules/yaml/bin.mjs" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/yaml@2.9.0/node_modules/yaml/bin.mjs" "$@"
+fi
+# cmd-shim-target=/Users/ben/projects/app/node_modules/.pnpm/yaml@2.9.0/node_modules/yaml/bin.mjs

package/s3/node_modules/.vite/vitest/da39a3ee5e6b4b0d3255bfef95601890afd80709/results.json

@@ -0,0 +1 @@
+{"version":"4.1.8","results":[[":src/index.test.ts",{"duration":1.224082999999979,"failed":false}]]}

package/s3/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@rx-ted/packages-honest-plugins-s3",
+  "version": "1.0.1",
+  "private": true,
+  "description": "S3 plugin for @rx-ted/packages-honest",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "vitest": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": [
+    "./dist/index.js"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rx-ted/honest.git"
+  },
+  "author": "rx-ted",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.1056.0",
+    "@aws-sdk/s3-request-presigner": "^3.1056.0",
+    "@rx-ted/packages-core": "workspace:^"
+  },
+  "peerDependencies": {
+    "@rx-ted/packages-honest": "workspace:^",
+    "hono": "^4.12.18"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "vitest": "^4.1.7"
+  }
+}

package/s3/src/index.test.ts

@@ -0,0 +1,20 @@
+import { describe, it, expect } from 'vitest';
+import { S3Plugin, S3_CONTEXT_KEY, S3_GLOBAL_KEY, createS3Driver } from './index';
+
+describe('S3 plugin exports', () => {
+  it('exports S3Plugin', () => {
+    expect(S3Plugin).toBeDefined();
+  });
+
+  it('exports S3_CONTEXT_KEY', () => {
+    expect(S3_CONTEXT_KEY).toBe('honest:s3');
+  });
+
+  it('exports S3_GLOBAL_KEY', () => {
+    expect(S3_GLOBAL_KEY).toBe('s3');
+  });
+
+  it('exports createS3Driver', () => {
+    expect(createS3Driver).toBeDefined();
+  });
+});

package/s3/src/index.ts

@@ -0,0 +1,13 @@
+export { S3Plugin, S3_CONTEXT_KEY, S3_GLOBAL_KEY } from './s3.plugin';
+export type { S3PluginOptions } from './s3.plugin';
+export { createS3Driver } from './s3.driver';
+export type { S3DriverOptions } from './s3.driver';
+export type {
+  FileDriver,
+  FileMetadata,
+  FileUploadOptions,
+  S3Options,
+} from './types';
+
+// DI service
+export { S3Service } from './s3-service';

package/s3/src/s3-service.ts

@@ -0,0 +1,14 @@
+import { Service, ComponentManager } from '@rx-ted/packages-honest';
+import type { FileDriver } from './types';
+import { S3_GLOBAL_KEY } from './s3.plugin';
+
+@Service()
+class S3Service {
+  constructor() {
+    return ComponentManager.getPlugin<FileDriver>(S3_GLOBAL_KEY);
+  }
+}
+
+interface S3Service extends FileDriver {}
+
+export { S3Service };