@uploadbox/core 0.1.0

package/dist/s3-multipart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-multipart.js","sourceRoot":"","sources":["../src/s3-multipart.ts"],"names":[],"mappings":"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"}

package/dist/s3.d.ts

@@ -0,0 +1,20 @@
+import { S3Client } from "@aws-sdk/client-s3";
+import type { UploadboxConfig } from "./types.js";
+export declare function createS3Client(config: UploadboxConfig): S3Client;
+export declare function generatePresignedPutUrl(client: S3Client, bucket: string, key: string, contentType: string, contentLength: number, expiresIn?: number): Promise<string>;
+export declare function generatePresignedGetUrl(client: S3Client, bucket: string, key: string, expiresIn?: number): Promise<string>;
+export declare function headObject(client: S3Client, bucket: string, key: string): Promise<{
+    contentLength: number;
+    contentType: string;
+} | null>;
+export declare function deleteObject(client: S3Client, bucket: string, key: string): Promise<void>;
+export declare function deleteObjects(client: S3Client, bucket: string, keys: string[]): Promise<void>;
+export declare function listObjects(client: S3Client, bucket: string, prefix?: string, limit?: number, continuationToken?: string): Promise<{
+    keys: {
+        key: string;
+        size: number;
+        lastModified: Date;
+    }[];
+    nextToken?: string;
+}>;
+//# sourceMappingURL=s3.d.ts.map

package/dist/s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../src/s3.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAOT,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,QAAQ,CAUhE;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAehE;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,GAAE,MAAa,EACpB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC;IACT,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,IAAI,CAAA;KAAE,EAAE,CAAC;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,CAqBD"}

package/dist/s3.js

@@ -0,0 +1,95 @@
+import { S3Client, PutObjectCommand, HeadObjectCommand, DeleteObjectCommand, DeleteObjectsCommand, ListObjectsV2Command, GetObjectCommand, } from "@aws-sdk/client-s3";
+import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
+import { UploadboxError } from "./errors.js";
+export function createS3Client(config) {
+    return new S3Client({
+        region: config.region ?? "us-east-1",
+        credentials: {
+            accessKeyId: config.accessKeyId,
+            secretAccessKey: config.secretAccessKey,
+        },
+        ...(config.endpoint ? { endpoint: config.endpoint } : {}),
+        ...(config.forcePathStyle ? { forcePathStyle: true } : {}),
+    });
+}
+export async function generatePresignedPutUrl(client, bucket, key, contentType, contentLength, expiresIn = 3600) {
+    try {
+        const command = new PutObjectCommand({
+            Bucket: bucket,
+            Key: key,
+            ContentType: contentType,
+            ContentLength: contentLength,
+        });
+        return await getSignedUrl(client, command, { expiresIn });
+    }
+    catch (err) {
+        throw UploadboxError.s3Error(err.message);
+    }
+}
+export async function generatePresignedGetUrl(client, bucket, key, expiresIn = 3600) {
+    try {
+        const command = new GetObjectCommand({ Bucket: bucket, Key: key });
+        return await getSignedUrl(client, command, { expiresIn });
+    }
+    catch (err) {
+        throw UploadboxError.s3Error(err.message);
+    }
+}
+export async function headObject(client, bucket, key) {
+    try {
+        const response = await client.send(new HeadObjectCommand({ Bucket: bucket, Key: key }));
+        return {
+            contentLength: response.ContentLength ?? 0,
+            contentType: response.ContentType ?? "application/octet-stream",
+        };
+    }
+    catch (err) {
+        if (err.name === "NotFound" || err.$metadata?.httpStatusCode === 404) {
+            return null;
+        }
+        throw UploadboxError.s3Error(err.message);
+    }
+}
+export async function deleteObject(client, bucket, key) {
+    try {
+        await client.send(new DeleteObjectCommand({ Bucket: bucket, Key: key }));
+    }
+    catch (err) {
+        throw UploadboxError.s3Error(err.message);
+    }
+}
+export async function deleteObjects(client, bucket, keys) {
+    if (keys.length === 0)
+        return;
+    try {
+        await client.send(new DeleteObjectsCommand({
+            Bucket: bucket,
+            Delete: { Objects: keys.map((Key) => ({ Key })) },
+        }));
+    }
+    catch (err) {
+        throw UploadboxError.s3Error(err.message);
+    }
+}
+export async function listObjects(client, bucket, prefix, limit = 1000, continuationToken) {
+    try {
+        const response = await client.send(new ListObjectsV2Command({
+            Bucket: bucket,
+            Prefix: prefix,
+            MaxKeys: limit,
+            ContinuationToken: continuationToken,
+        }));
+        return {
+            keys: (response.Contents ?? []).map((obj) => ({
+                key: obj.Key,
+                size: obj.Size ?? 0,
+                lastModified: obj.LastModified ?? new Date(),
+            })),
+            nextToken: response.NextContinuationToken,
+        };
+    }
+    catch (err) {
+        throw UploadboxError.s3Error(err.message);
+    }
+}
+//# sourceMappingURL=s3.js.map

package/dist/s3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.js","sourceRoot":"","sources":["../src/s3.ts"],"names":[],"mappings":"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"}

package/dist/server-api.d.ts

@@ -0,0 +1,43 @@
+import type { S3Client } from "@aws-sdk/client-s3";
+import type { UploadboxConfig, ACL } from "./types.js";
+import { type ServerUploadInput, type ServerUploadResult } from "./server-upload.js";
+export interface FileRecord {
+    id: string;
+    key: string;
+    name: string;
+    size: number;
+    type: string;
+    url: string;
+    acl: ACL;
+    status: "pending" | "complete";
+    createdAt: Date;
+}
+export declare class UploadboxApi {
+    private s3Client;
+    private config;
+    constructor(s3Client: S3Client, config: UploadboxConfig);
+    private getFileUrl;
+    listFiles(opts?: {
+        prefix?: string;
+        limit?: number;
+        continuationToken?: string;
+    }): Promise<{
+        keys: {
+            key: string;
+            size: number;
+            lastModified: Date;
+        }[];
+        nextToken?: string;
+    }>;
+    deleteFile(key: string): Promise<void>;
+    deleteFiles(keys: string[]): Promise<void>;
+    getSignedUrl(key: string, expiresIn?: number): Promise<string>;
+    verifyUpload(key: string): Promise<{
+        contentLength: number;
+        contentType: string;
+    } | null>;
+    buildFileUrl(key: string): string;
+    uploadFile(input: ServerUploadInput): Promise<ServerUploadResult>;
+    uploadFiles(inputs: ServerUploadInput[], concurrency?: number): Promise<ServerUploadResult[]>;
+}
+//# sourceMappingURL=server-api.d.ts.map

package/dist/server-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-api.d.ts","sourceRoot":"","sources":["../src/server-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAQvD,OAAO,EAAkC,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAErH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;IAC/B,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,MAAM;gBADN,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,eAAe;IAGjC,OAAO,CAAC,UAAU;IAcZ,SAAS,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;IAUhF,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9D,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAI/F,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI3B,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIjE,WAAW,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;CAGpG"}

package/dist/server-api.js

@@ -0,0 +1,48 @@
+import { listObjects, deleteObject, deleteObjects, generatePresignedGetUrl, headObject, } from "./s3.js";
+import { serverUpload, serverUploadMany } from "./server-upload.js";
+export class UploadboxApi {
+    s3Client;
+    config;
+    constructor(s3Client, config) {
+        this.s3Client = s3Client;
+        this.config = config;
+    }
+    getFileUrl(key) {
+        if (this.config.cdnBaseUrl) {
+            return `${this.config.cdnBaseUrl.replace(/\/$/, "")}/${key}`;
+        }
+        if (this.config.endpoint) {
+            const base = this.config.endpoint.replace(/\/$/, "");
+            if (this.config.forcePathStyle) {
+                return `${base}/${this.config.bucket}/${key}`;
+            }
+            return `${base}/${key}`;
+        }
+        return `https://${this.config.bucket}.s3.${this.config.region ?? "us-east-1"}.amazonaws.com/${key}`;
+    }
+    async listFiles(opts) {
+        return listObjects(this.s3Client, this.config.bucket, opts?.prefix, opts?.limit, opts?.continuationToken);
+    }
+    async deleteFile(key) {
+        await deleteObject(this.s3Client, this.config.bucket, key);
+    }
+    async deleteFiles(keys) {
+        await deleteObjects(this.s3Client, this.config.bucket, keys);
+    }
+    async getSignedUrl(key, expiresIn) {
+        return generatePresignedGetUrl(this.s3Client, this.config.bucket, key, expiresIn);
+    }
+    async verifyUpload(key) {
+        return headObject(this.s3Client, this.config.bucket, key);
+    }
+    buildFileUrl(key) {
+        return this.getFileUrl(key);
+    }
+    async uploadFile(input) {
+        return serverUpload(this.s3Client, this.config, input);
+    }
+    async uploadFiles(inputs, concurrency) {
+        return serverUploadMany(this.s3Client, this.config, inputs, concurrency);
+    }
+}
+//# sourceMappingURL=server-api.js.map

package/dist/server-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-api.js","sourceRoot":"","sources":["../src/server-api.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,aAAa,EACb,uBAAuB,EACvB,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAmD,MAAM,oBAAoB,CAAC;AAcrH,MAAM,OAAO,YAAY;IAEb;IACA;IAFV,YACU,QAAkB,EAClB,MAAuB;QADvB,aAAQ,GAAR,QAAQ,CAAU;QAClB,WAAM,GAAN,MAAM,CAAiB;IAC9B,CAAC;IAEI,UAAU,CAAC,GAAW;QAC5B,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC3B,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC;QAC/D,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrD,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;gBAC/B,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YAChD,CAAC;YACD,OAAO,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,WAAW,IAAI,CAAC,MAAM,CAAC,MAAM,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,WAAW,kBAAkB,GAAG,EAAE,CAAC;IACtG,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAsE;QACpF,OAAO,WAAW,CAChB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,MAAM,CAAC,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,iBAAiB,CACxB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAW;QAC1B,MAAM,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAc;QAC9B,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAW,EAAE,SAAkB;QAChD,OAAO,uBAAuB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IACpF,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAW;QAC5B,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5D,CAAC;IAED,YAAY,CAAC,GAAW;QACtB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAwB;QACvC,OAAO,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAA2B,EAAE,WAAoB;QACjE,OAAO,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/dist/server-upload.d.ts

@@ -0,0 +1,19 @@
+import type { S3Client } from "@aws-sdk/client-s3";
+import type { UploadboxConfig } from "./types.js";
+import type { Readable } from "stream";
+export interface ServerUploadInput {
+    name: string;
+    body: Buffer | Uint8Array | Readable;
+    contentType?: string;
+    metadata?: Record<string, string>;
+    acl?: "public-read" | "private";
+}
+export interface ServerUploadResult {
+    key: string;
+    name: string;
+    url: string;
+    contentType: string;
+}
+export declare function serverUpload(s3Client: S3Client, config: UploadboxConfig, input: ServerUploadInput): Promise<ServerUploadResult>;
+export declare function serverUploadMany(s3Client: S3Client, config: UploadboxConfig, inputs: ServerUploadInput[], concurrency?: number): Promise<ServerUploadResult[]>;
+//# sourceMappingURL=server-upload.d.ts.map

package/dist/server-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-upload.d.ts","sourceRoot":"","sources":["../src/server-upload.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAgBD,wBAAsB,YAAY,CAChC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAyB7B;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,iBAAiB,EAAE,EAC3B,WAAW,GAAE,MAAU,GACtB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAe/B"}

package/dist/server-upload.js

@@ -0,0 +1,53 @@
+import { PutObjectCommand } from "@aws-sdk/client-s3";
+import { generateFileKey, getContentTypeFromExt } from "./utils.js";
+import { UploadboxError } from "./errors.js";
+function buildUrl(config, key) {
+    if (config.cdnBaseUrl) {
+        return `${config.cdnBaseUrl.replace(/\/$/, "")}/${key}`;
+    }
+    if (config.endpoint) {
+        const base = config.endpoint.replace(/\/$/, "");
+        if (config.forcePathStyle) {
+            return `${base}/${config.bucket}/${key}`;
+        }
+        return `${base}/${key}`;
+    }
+    return `https://${config.bucket}.s3.${config.region ?? "us-east-1"}.amazonaws.com/${key}`;
+}
+export async function serverUpload(s3Client, config, input) {
+    const key = generateFileKey(input.name);
+    const contentType = input.contentType ?? getContentTypeFromExt(input.name);
+    try {
+        await s3Client.send(new PutObjectCommand({
+            Bucket: config.bucket,
+            Key: key,
+            Body: input.body,
+            ContentType: contentType,
+            ...(input.acl ? { ACL: input.acl } : {}),
+            ...(input.metadata ? { Metadata: input.metadata } : {}),
+        }));
+    }
+    catch (err) {
+        throw UploadboxError.s3Error(err.message);
+    }
+    return {
+        key,
+        name: input.name,
+        url: buildUrl(config, key),
+        contentType,
+    };
+}
+export async function serverUploadMany(s3Client, config, inputs, concurrency = 5) {
+    const results = [];
+    const queue = [...inputs];
+    async function worker() {
+        while (queue.length > 0) {
+            const input = queue.shift();
+            results.push(await serverUpload(s3Client, config, input));
+        }
+    }
+    const workers = Array.from({ length: Math.min(concurrency, inputs.length) }, () => worker());
+    await Promise.all(workers);
+    return results;
+}
+//# sourceMappingURL=server-upload.js.map

package/dist/server-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-upload.js","sourceRoot":"","sources":["../src/server-upload.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,94 @@
+export type FileType = "image" | "video" | "audio" | "pdf" | "text" | "blob";
+export type FileSize = `${number}${"B" | "KB" | "MB" | "GB"}`;
+export type ACL = "public-read" | "private";
+export type ContentDisposition = "inline" | "attachment";
+export type FileRouteConfig = {
+    [K in FileType]?: {
+        maxFileSize?: FileSize;
+        maxFileCount?: number;
+        minFileCount?: number;
+        acl?: ACL;
+        contentDisposition?: ContentDisposition;
+        presignedUrlExpiry?: number;
+        defaultTtlSeconds?: number;
+        maxTtlSeconds?: number;
+    };
+};
+export interface FileInfo {
+    name: string;
+    size: number;
+    type: string;
+    customMetadata?: Record<string, string>;
+    ttlSeconds?: number;
+}
+export interface UploadedFileData {
+    key: string;
+    name: string;
+    size: number;
+    type: string;
+    url: string;
+    acl: ACL;
+    customMetadata?: Record<string, string>;
+}
+export interface AuthContext {
+    apiKeyId: string;
+    apiKeyName: string;
+    projectId?: string;
+}
+export type MiddlewareFn<TMetadata> = (ctx: {
+    req: Request;
+    files: FileInfo[];
+    auth?: AuthContext;
+}) => Promise<TMetadata> | TMetadata;
+export type OnUploadCompleteFn<TMetadata, TReturn> = (ctx: {
+    metadata: TMetadata;
+    file: UploadedFileData;
+}) => Promise<TReturn> | TReturn;
+export interface FileRoute<TMetadata = Record<string, unknown>, TReturn = unknown> {
+    _config: FileRouteConfig;
+    _middleware: MiddlewareFn<TMetadata>;
+    _onUploadComplete: OnUploadCompleteFn<TMetadata, TReturn>;
+}
+export type FileRouter = Record<string, FileRoute<any, any>>;
+export interface PresignedUrlResponse {
+    uploadId: string;
+    key: string;
+    url: string;
+    fields?: Record<string, string>;
+}
+export interface UploadCompleteResponse<TReturn = unknown> {
+    file: UploadedFileData;
+    serverData: TReturn;
+}
+export interface UploadboxConfig {
+    region?: string;
+    bucket: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    cdnBaseUrl?: string;
+    endpoint?: string;
+    forcePathStyle?: boolean;
+    presignedUrlExpiry?: number;
+}
+export type RouterConfig = {
+    [routeKey: string]: {
+        config: FileRouteConfig;
+    };
+};
+export declare const MULTIPART_THRESHOLD: number;
+export declare const DEFAULT_PART_SIZE: number;
+export interface MultipartPresignedResponse {
+    fileKey: string;
+    uploadId: string;
+    parts: {
+        partNumber: number;
+        url: string;
+    }[];
+    partSize: number;
+    totalParts: number;
+}
+export interface CompletedPartInfo {
+    partNumber: number;
+    etag: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,3 @@
+export const MULTIPART_THRESHOLD = 10 * 1024 * 1024; // 10MB
+export const DEFAULT_PART_SIZE = 10 * 1024 * 1024; // 10MB
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA0FA,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO;AAC5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO"}

package/dist/utils.d.ts

@@ -0,0 +1,7 @@
+import type { FileSize } from "./types.js";
+export declare function parseFileSize(size: FileSize): number;
+export declare function formatFileSize(bytes: number): string;
+export declare function generateFileKey(originalName: string): string;
+export declare function generateUploadId(): string;
+export declare function getContentTypeFromExt(filename: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAU3C,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAMpD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAS5D;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY9D"}

package/dist/utils.js

@@ -0,0 +1,50 @@
+import { randomBytes } from "crypto";
+const SIZE_UNITS = {
+    B: 1,
+    KB: 1024,
+    MB: 1024 * 1024,
+    GB: 1024 * 1024 * 1024,
+};
+export function parseFileSize(size) {
+    const match = size.match(/^(\d+(?:\.\d+)?)(B|KB|MB|GB)$/);
+    if (!match)
+        throw new Error(`Invalid file size format: ${size}`);
+    const value = parseFloat(match[1]);
+    const unit = match[2];
+    return Math.floor(value * SIZE_UNITS[unit]);
+}
+export function formatFileSize(bytes) {
+    if (bytes === 0)
+        return "0 B";
+    const units = ["B", "KB", "MB", "GB"];
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    const value = bytes / Math.pow(1024, i);
+    return `${value.toFixed(value % 1 === 0 ? 0 : 1)} ${units[i]}`;
+}
+export function generateFileKey(originalName) {
+    const id = randomBytes(16).toString("hex");
+    const ext = originalName.includes(".") ? originalName.slice(originalName.lastIndexOf(".")) : "";
+    const safeName = originalName
+        .replace(/\.[^.]+$/, "")
+        .replace(/[^a-zA-Z0-9-_]/g, "-")
+        .replace(/-+/g, "-")
+        .slice(0, 100);
+    return `${safeName}-${id}${ext}`;
+}
+export function generateUploadId() {
+    return randomBytes(12).toString("base64url");
+}
+export function getContentTypeFromExt(filename) {
+    const ext = filename.slice(filename.lastIndexOf(".") + 1).toLowerCase();
+    const map = {
+        jpg: "image/jpeg", jpeg: "image/jpeg", png: "image/png", gif: "image/gif",
+        webp: "image/webp", svg: "image/svg+xml", avif: "image/avif",
+        mp4: "video/mp4", webm: "video/webm", ogg: "video/ogg", mov: "video/quicktime",
+        mp3: "audio/mpeg", wav: "audio/wav", flac: "audio/flac", aac: "audio/aac",
+        pdf: "application/pdf",
+        txt: "text/plain", csv: "text/csv", html: "text/html", css: "text/css",
+        js: "text/javascript", json: "application/json", xml: "application/xml",
+    };
+    return map[ext] || "application/octet-stream";
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/dist/validation.d.ts

@@ -0,0 +1,3 @@
+import type { FileRouteConfig, FileInfo } from "./types.js";
+export declare function validateFiles(files: FileInfo[], config: FileRouteConfig): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAY,MAAM,YAAY,CAAC;AAKtE,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA8C9E"}

package/dist/validation.js

@@ -0,0 +1,44 @@
+import { UploadboxError } from "./errors.js";
+import { parseFileSize } from "./utils.js";
+import { DEFAULT_MAX_FILE_SIZES, getFileTypeFromMime } from "./file-types.js";
+export function validateFiles(files, config) {
+    const allowedTypes = Object.keys(config);
+    // Compute total max/min file count across all types
+    let totalMaxCount = 0;
+    let totalMinCount = 0;
+    for (const type of allowedTypes) {
+        const typeConfig = config[type];
+        totalMaxCount += typeConfig.maxFileCount ?? 1;
+        totalMinCount += typeConfig.minFileCount ?? 0;
+    }
+    if (files.length > totalMaxCount) {
+        throw UploadboxError.tooManyFiles(totalMaxCount);
+    }
+    if (files.length < totalMinCount) {
+        throw UploadboxError.tooFewFiles(totalMinCount);
+    }
+    for (const file of files) {
+        const fileType = getFileTypeFromMime(file.type);
+        // If blob is allowed, any type is OK
+        if (!allowedTypes.includes("blob")) {
+            if (!fileType || !allowedTypes.includes(fileType)) {
+                throw UploadboxError.invalidFileType(file.type);
+            }
+        }
+        // Find the matching config for this file's type
+        const matchedType = fileType && allowedTypes.includes(fileType) ? fileType : "blob";
+        const typeConfig = config[matchedType];
+        if (!typeConfig && !config.blob) {
+            throw UploadboxError.invalidFileType(file.type);
+        }
+        const effectiveConfig = typeConfig || config.blob;
+        const maxSize = effectiveConfig.maxFileSize ?? DEFAULT_MAX_FILE_SIZES[matchedType];
+        if (maxSize) {
+            const maxBytes = parseFileSize(maxSize);
+            if (file.size > maxBytes) {
+                throw UploadboxError.fileTooLarge(maxSize);
+            }
+        }
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAsB,MAAM,iBAAiB,CAAC;AAElG,MAAM,UAAU,aAAa,CAAC,KAAiB,EAAE,MAAuB;IACtE,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAe,CAAC;IAEvD,oDAAoD;IACpD,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAE,CAAC;QACjC,aAAa,IAAI,UAAU,CAAC,YAAY,IAAI,CAAC,CAAC;QAC9C,aAAa,IAAI,UAAU,CAAC,YAAY,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;QACjC,MAAM,cAAc,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;QACjC,MAAM,cAAc,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhD,qCAAqC;QACrC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClD,MAAM,cAAc,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,gDAAgD;QAChD,MAAM,WAAW,GAAG,QAAQ,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QACpF,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACvC,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAChC,MAAM,cAAc,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,eAAe,GAAG,UAAU,IAAI,MAAM,CAAC,IAAK,CAAC;QACnD,MAAM,OAAO,GAAG,eAAe,CAAC,WAAW,IAAK,sBAAsB,CAAC,WAAW,CAAS,CAAC;QAC5F,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;gBACzB,MAAM,cAAc,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@uploadbox/core",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./hooks/image-resize": {
+      "types": "./dist/hooks/image-resize.d.ts",
+      "import": "./dist/hooks/image-resize.js"
+    },
+    "./hooks/virus-scan": {
+      "types": "./dist/hooks/virus-scan.d.ts",
+      "import": "./dist/hooks/virus-scan.js"
+    }
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.700.0",
+    "@aws-sdk/s3-request-presigner": "^3.700.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  },
+  "description": "Core utilities for Uploadbox — S3 operations, file validation, builder pattern",
+  "keywords": [
+    "uploadbox",
+    "s3",
+    "upload",
+    "file-upload",
+    "presigned-url",
+    "multipart"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/federicostarace/uploadbox",
+    "directory": "packages/core"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}