@focus-at/zs3 0.0.14 → 0.0.15

package/README.md

@@ -1,49 +1,45 @@
-# ZeroS3
+# ZeroS3 (zs3)
 ![GitHub License](https://img.shields.io/github/license/focus-at/zs3)
 ![GitHub Stars](https://img.shields.io/github/stars/focus-at/zs3)
 
-An ultra-lightweight (~3 KB) and high-performance client for S3-compatible cloud storage (AWS S3, MinIO, Cloudflare R2, Backblaze B2), built purely on modern Web Standards (`fetch`, `crypto.subtle`).
+> ⚠️ **Status: WIP (Work in Progress)**
+> This project is currently under active development (**WHIP**). The public API is highly experimental, subject to breaking changes, and the specification is still stabilizing.
 
-**Zero external dependencies.** Engineered for custom JS runtimes, Edge functions, Serverless environments, or any setup highly sensitive to bundle size and cold-start times.
+## Overview
+**ZeroS3 (zs3)** is an ultra-lightweight (~3 KB), zero-dependency S3 client designed for performance-critical environments, edge workers, and client-side integration (**BYOS3** model). Built purely on modern Web Standards (`fetch`, `crypto.subtle`), it provides lightning-fast execution for AWS S3, MinIO, Cloudflare R2, and Backblaze B2.
 
-## Installation
-
-```js
-import { zs3 } from 'zeros3';
-```
+## Features
+- **Zero Dependencies:** Built entirely on native Web APIs (`fetch`, `crypto.subtle`).
+- **Unified API:** One simple `execute()` method returning a native Web `Response`.
+- **Drop-in Web Compatibility:** Seamlessly stream files straight into your web server responses or client-side components.
 
 ## Quick Start
 
-```js
-const storage = zs3({
-  endpoint: '127.0.0.1:9000',
-  accessKeyId: 'your-access-key-id',
-  secretAccessKey: 'your-secret-access-key',
-  bucket: 'production-assets'
-});
+```typescript
+import type { S3Client } from '@focus-at/zs3';
+import { zs3 } from '@focus-at/zs3';
 
-// 1. Upload a file (String, Buffer, or Web Stream)
-await storage.put('bundles/app.tar', tarStream, {
-  headers: { contentType: 'application/x-tar' }
+const s3 = zs3({
+  endpoint: "s3.amazonaws.com",
+  accessKeyId: "YOUR_ACCESS_KEY",
+  secretAccessKey: "YOUR_SECRET_KEY",
+  bucket: "my-bucket",
+  region: "us-east-1"
 });
 
-// 2. Download a file (returns fetch Response, stream is in .body)
-const res = await storage.get('bundles/app.tar');
-const downloadStream = res.body;
+// 1. List objects (Returns JSON Response)
+const listRes = await s3.execute({ method: "GET" });
+const data = await listRes.json();
+console.log(data.Contents); // Array of files or undefined if empty
 
-// 3. List files (pass an object containing a prefix)
-const files = await storage.get({ prefix: 'bundles/' });
-console.log(files.contents);
+// 2. Download a file (Proxy straight to your web framework Response)
+const fileRes = await s3.execute({ method: "GET", key: "videos/movie.mp4" });
+return new Response(fileRes.body, { headers: fileRes.headers });
 
-// 4. Retrieve metadata (HEAD request)
-const meta = await storage.stat('bundles/app.tar');
-console.log(meta.size, meta['x-amz-meta-version']);
-
-// 5. Delete an object
-await storage.del('bundles/app.tar');
+// 3. Upload an object
+await s3.execute({ 
+  method: "PUT", 
+  key: "uploads/image.png", 
+  body: fileBuffer 
+});
 ```
-
-## Features
-- **Closure-Based Design (No `this`)**: Every single client method can be safely destructured and decoupled without losing context: `const { get, put } = zs3(opts);`.
-- **Inlined Micro XML Parser**: Seamlessly converts S3 object listings without bloating your `node_modules` or running a heavy general-purpose parser.
-- **Robust AWS v4 Signatures**: Automatically manages query parameter alphabetical sorting, whitespace trimming, and strict URI hex-encoding under the hood.

package/dist/index.js

@@ -0,0 +1,8 @@
+var l="HMAC",G="SHA-256",T="AWS4",U=[T,l,"SHA256"].join("-"),Q=/[:-]|\.\d{3}/g,X=/<(\w[-\w]*)(?:\/|[^>]*>((?:(?!<\1)[\s\S])*)<\/\1)>/gm,J=/\B[A-Z]/g,Y=/[!'()*]/g,Z=/^\/*/,I=new TextEncoder;var{subtle:m}=crypto,h=(e)=>e instanceof ArrayBuffer?e:e?.buffer?.constructor===ArrayBuffer?e.buffer:I.encode(e==null?"":`${e}`).buffer,K=(e)=>Array.from(new Uint8Array(e)).map((s)=>s.toString(16).padStart(2,"0")).join(""),g=async(e,s)=>{let a=await m.importKey("raw",h(e),{name:l,hash:G},!1,["sign"]);return new Uint8Array(await m.sign(l,a,I.encode(s)))},H=async(e)=>K(await m.digest(G,h(e))),P=(e)=>e.replace(J,"-$&").toLowerCase(),L=(e,s,a)=>{if(s)Object.keys(s).forEach((t)=>{let r=P(a+t);if(s[t]&&typeof s[t]!=="object")e[r]=`${s[t]}`});return e},F=(e)=>encodeURIComponent(e).replace(Y,(s)=>`%${s.charCodeAt(0).toString(16).toUpperCase()}`),A=(e)=>{let s={"":"",true:!0,false:!1},a=[...e.matchAll(X)];return a.length?a.reduce((t,[,r="",i=""])=>{let o=s[i]??(isNaN(+i)?A(i):+i);return t[r]=Array.isArray(t[r])?[...t[r],o]:t[r]!=null?[t[r],o]:r==="Contents"?[o]:o,t},{}):e};function V(e){let s={region:"us-east-1",bucket:"",...e};return{execute:async(t,r={})=>{let{method:i}=t,o="body"in t?t.body:null,b=t.bucket!==void 0?t.bucket:s.bucket,w="key"in t&&t.key?t.key.replace(Z,""):"",x=b?`/${b}/${w}`:`/${w}`,N=i==="GET"&&!("key"in t),y=Object.entries({...r.query,...N&&{listType:2,maxKeys:t.maxKeys||1000,prefix:t.prefix||""}}).sort().map(([n,p])=>`${P(n)}=${F(String(p??""))}`).join("&"),{endpoint:f,region:O,accessKeyId:B,secretAccessKey:z}=s,R=new URL(f.startsWith("http")?f:`https://${f.replace("://","")}`),d=new Date().toISOString().replace(Q,""),E=d.slice(0,8),C=o&&typeof o.getReader==="function",j=C?"UNSIGNED-PAYLOAD":await H(o||""),u=L(L({host:R.host,"x-amz-date":d,"x-amz-content-sha256":j,...o&&!C?{"content-length":`${h(o).byteLength}`}:{}},r.headers,""),r.meta,"x-amz-meta-"),S=Object.keys(u).map((n)=>n.toLowerCase()).sort(),M=[i,x||"/",y,S.map((n)=>`${n}:${u[n]?.trim()}`).join(`
+`)+`
+`,S.join(";"),j].join(`
+`),k=`${E}/${O}/s3/aws4_request`,W=await g(await g(await g(await g(`${T}${z}`,E),O),"s3"),"aws4_request"),v=K(await g(W,[U,d,k,await H(M)].join(`
+`)));u.Authorization=`${U} Credential=${B}/${k}, SignedHeaders=${S.join(";")}, Signature=${v}`;let _=new URL(x,R);if(y)_.search=y;try{let n=await fetch(_,{method:i,headers:u,body:o});if(!n.ok)throw{status:n.status,...A(await n.text())};if(i==="GET"&&!t.key){let p=new Headers(n.headers),c=A((await n.text()).trim());if(c&&typeof c==="object"){let D=Object.keys(c);if(D.length===1)c=c[D[0]]}return p.set("content-type","application/json"),new Response(JSON.stringify(c),{status:n.status,statusText:n.statusText,headers:p})}return n}catch(n){if(n.status)throw n;throw{status:500,Error:{Code:n?.code||"InternalServerError",Message:n?.message||String(n)}}}},config:s,clone:(t={})=>V({...s,...t})}}export{H as hash,g as hmac,K as toHex,V as zs3};
+
+//# debugId=A52263D00FB93F3664756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../index.ts"],
+  "sourcesContent": [
+    "\nexport interface S3Config {\n  endpoint: string;\n  accessKeyId: string;\n  secretAccessKey: string;\n  bucket?: string;\n  region?: string;\n  [key: string]: any;\n}\n\nexport interface S3Options {\n  headers?: Record<string, string>;\n  meta?: Record<string, string>;\n  query?: Record<string, string | number | boolean>;\n}\n\n// 1. Самый полный интерфейс (для GET)\nexport interface S3GetOptions {\n  key?: string;\n  bucket?: string;\n  prefix?: string;\n  maxKeys?: number;\n}\n\n// 2. Для точечных операций забираем только key и bucket, делая key ОБЯЗАТЕЛЬНЫМ\nexport interface S3ObjectOptions extends Pick<S3GetOptions, 'bucket'> {\n  key: string;\n}\n\n// 3. Для PUT добавляем к ним body\nexport interface S3PutOptions extends S3ObjectOptions {\n  body?: any;\n}\n\n// 1. Возвращаем строгий Union-тип\nexport type S3RequestOptions =\n  | ({ method: 'GET' } & S3GetOptions)\n  | ({ method: 'PUT' } & S3PutOptions)\n  | ({ method: 'DELETE' } & S3ObjectOptions)\n  | ({ method: 'HEAD' } & S3ObjectOptions);\n\n// 2. Упрощаем интерфейс S3Client, убирая перегрузки\nexport interface S3Client {\n  /** Execute an S3 request (supports GET, PUT, DELETE, HEAD) */\n  execute(req: S3RequestOptions, options?: S3Options): Promise<Response>;\n  config: S3Config & { region: string; bucket: string };\n  clone(newConfig?: Partial<S3Config>): S3Client;\n}\n\nexport interface S3StatResponse extends Record<string, any> {\n  size: number;\n  mtime: Date;\n}\n\nconst ALG_NAME = ('HMAC' + '');\nconst ALG_HASH = ('SHA-256' + '');\nconst AWS4 = ('AWS4' + '');\nconst SIGN_P = [AWS4, ALG_NAME, 'SHA256'].join('-');\nconst RE_ISO_DATE = /[:-]|\\.\\d{3}/g;\nconst RE_XML_TAGS = /<(\\w[-\\w]*)(?:\\/|[^>]*>((?:(?!<\\1)[\\s\\S])*)<\\/\\1)>/gm;\nconst RE_DASH_CASE = /\\B[A-Z]/g;\nconst RE_ENCODE_URI = /[!'()*]/g;\nconst RE_LEADING_SLASHES = /^\\/*/;\n\nconst encoder = new TextEncoder();\nconst decoder = new TextDecoder();\nconst { subtle } = crypto;\n\nconst toArrayBuffer = (d: any): ArrayBuffer =>\n  d instanceof ArrayBuffer ? d : d?.buffer?.constructor === ArrayBuffer ? d.buffer : encoder.encode(d == null ? '' : `${d}`).buffer;\n\nexport const toHex = (buf: ArrayBuffer | Uint8Array):string =>\n  Array.from(new Uint8Array(buf)).map(b => b.toString(16).padStart(2, '0')).join('');\n\nexport const hmac = async (key: string | Uint8Array | ArrayBuffer, data: string): Promise<Uint8Array> => {\n  const cryptoKey = await subtle.importKey('raw', toArrayBuffer(key), { name: ALG_NAME, hash: ALG_HASH}, false, ['sign']);\n  return new Uint8Array(await subtle.sign(ALG_NAME, cryptoKey, encoder.encode(data)));\n};\n\nexport const hash = async (data: any) => toHex(await subtle.digest(ALG_HASH, toArrayBuffer(data)));\n\nconst toKebabCase = (str: string): string =>\n  str.replace(RE_DASH_CASE, \"-$&\").toLowerCase();\n\nconst assignDashCase = (target: Record<string, string>, source: Record<string, any> | undefined, prefix: string): Record<string, string> => {\n  if (source) Object.keys(source).forEach(key => {\n    const name = toKebabCase(prefix + key);\n    if (source[key] && typeof source[key] !== 'object') target[name] = `${source[key]}`;\n  });\n  return target;\n};\n\nconst awsEncodeURI = (str: string): string =>\n  encodeURIComponent(str).replace(RE_ENCODE_URI, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);\n\nconst parseXml = (str: string): any => {\n  const types: Record<string, any> = { \"\": \"\", \"true\": true, \"false\": false };\n  const m = [...str.matchAll(RE_XML_TAGS)];\n  return m.length ? m.reduce((acc: any, [, key = '', content = '']) => {\n    const value = types[content] ?? (isNaN(+content) ? parseXml(content) : +content);\n    acc[key] = Array.isArray(acc[key]) ? [...acc[key], value] : acc[key] != null ? [acc[key], value] : key === \"Contents\" ? [value] : value;\n    return acc;\n  }, {}) : str;\n};\n\nexport function zs3(opts: S3Config): S3Client {\n  const config = { region: 'us-east-1', bucket: '', ...opts };\n  const execute = async (req: S3RequestOptions, options: S3Options = {}) => {\n    const { method } = req;\n    const body = 'body' in req ? req.body : null;\n\n    // Build uri\n    const targetBucket = req.bucket !== undefined ? req.bucket : config.bucket;\n    const cleanKey = 'key' in req && req.key ? req.key.replace(RE_LEADING_SLASHES, '') : '';\n    const uri = targetBucket ? `/${targetBucket}/${cleanKey}` : `/${cleanKey}`;\n    const isListQuery = method === 'GET' && !('key' in req);\n    const sortedQuery = Object.entries({\n      ...options.query,\n      ...(isListQuery && {\n        listType: 2,\n        maxKeys: req.maxKeys || 1000,\n        prefix: req.prefix || ''\n      })\n    })\n      .sort()\n      .map(([key, val]) => `${toKebabCase(key)}=${awsEncodeURI(String(val ?? ''))}`)\n      .join('&');\n\n    // --- Оригинальный блок конфигурации ---\n    const { endpoint, region, accessKeyId, secretAccessKey } = config;\n    const base = new URL(endpoint.startsWith('http') ? endpoint : `https://${endpoint.replace('://', '')}`);\n    const isoDate = new Date().toISOString().replace(RE_ISO_DATE, '');\n    const sDate = isoDate.slice(0, 8);\n\n    const isStream = body && typeof body.getReader === 'function';\n    const payloadHash = isStream ? 'UNSIGNED-PAYLOAD' : await hash(body || '');\n\n    const headers: Record<string, string> = assignDashCase(assignDashCase({\n      host: base.host,\n      'x-amz-date': isoDate,\n      'x-amz-content-sha256': payloadHash,\n      ...(body && !isStream ? { 'content-length': `${toArrayBuffer(body).byteLength}` } : {})\n    }, options.headers, \"\"), options.meta, \"x-amz-meta-\");\n\n    const sortedHeaders = Object.keys(headers).map(k => k.toLowerCase()).sort();\n\n    // 4. Формируем Canonical Request (используем уже готовые uri и sortedQuery)\n    const canonical = [\n      method,\n      uri || '/',\n      sortedQuery,\n      sortedHeaders.map(k => `${k}:${headers[k]?.trim()}`).join('\\n') + '\\n',\n      sortedHeaders.join(';'),\n      payloadHash\n    ].join('\\n');\n\n    const scope = `${sDate}/${region}/s3/aws4_request`;\n\n    const kSign = await hmac(await hmac(await hmac(await hmac(`${AWS4}${secretAccessKey}`, sDate), region), 's3'), 'aws4_request');\n    const signature = toHex(await hmac(kSign, [SIGN_P, isoDate, scope, await hash(canonical)].join('\\n')));\n\n    headers['Authorization'] = `${SIGN_P} Credential=${accessKeyId}/${scope}, SignedHeaders=${sortedHeaders.join(';')}, Signature=${signature}`;\n\n    const requestUrl = new URL(uri, base);\n\n    if (sortedQuery) {\n      requestUrl.search = sortedQuery;\n    }\n\n    try {\n      const res = await fetch(requestUrl, { method, headers, body });\n\n      if (!res.ok) {\n        throw { status: res.status, ...parseXml(await res.text()) };\n      }\n\n      if (method === 'GET' && !req.key) {\n        const headers = new Headers(res.headers);\n\n        let data = parseXml((await res.text()).trim());\n\n        if (data && typeof data === 'object') {\n          const keys = Object.keys(data);\n          if (keys.length === 1) data = data[keys[0] as string];\n        }\n\n        headers.set('content-type', 'application/json');\n\n        return new Response(JSON.stringify(data), {\n          status: res.status,\n          statusText: res.statusText,\n          headers\n        });\n      }\n\n      return res;\n    } catch (err: any) {\n      if (err.status) throw err;\n      throw { status: 500, Error: { Code: err?.code || 'InternalServerError', Message: err?.message || String(err) } };\n    }\n  };\n\n  return {\n    execute,\n    config,\n    clone: (newConfig: Partial<S3Config> = {}) => zs3({ ...config, ...newConfig })\n  };\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "A52263D00FB93F3664756E2164756E21",
+  "names": []
+}

package/index.ts

@@ -1,3 +1,4 @@
+
 export interface S3Config {
   endpoint: string;
   accessKeyId: string;
@@ -10,13 +11,42 @@ export interface S3Config {
 export interface S3Options {
   headers?: Record<string, string>;
   meta?: Record<string, string>;
+  query?: Record<string, string | number | boolean>;
 }
 
-export interface ListOptions {
+// 1. Самый полный интерфейс (для GET)
+export interface S3GetOptions {
+  key?: string;
+  bucket?: string;
   prefix?: string;
   maxKeys?: number;
 }
 
+// 2. Для точечных операций забираем только key и bucket, делая key ОБЯЗАТЕЛЬНЫМ
+export interface S3ObjectOptions extends Pick<S3GetOptions, 'bucket'> {
+  key: string;
+}
+
+// 3. Для PUT добавляем к ним body
+export interface S3PutOptions extends S3ObjectOptions {
+  body?: any;
+}
+
+// 1. Возвращаем строгий Union-тип
+export type S3RequestOptions =
+  | ({ method: 'GET' } & S3GetOptions)
+  | ({ method: 'PUT' } & S3PutOptions)
+  | ({ method: 'DELETE' } & S3ObjectOptions)
+  | ({ method: 'HEAD' } & S3ObjectOptions);
+
+// 2. Упрощаем интерфейс S3Client, убирая перегрузки
+export interface S3Client {
+  /** Execute an S3 request (supports GET, PUT, DELETE, HEAD) */
+  execute(req: S3RequestOptions, options?: S3Options): Promise<Response>;
+  config: S3Config & { region: string; bucket: string };
+  clone(newConfig?: Partial<S3Config>): S3Client;
+}
+
 export interface S3StatResponse extends Record<string, any> {
   size: number;
   mtime: Date;
@@ -27,30 +57,34 @@ const ALG_HASH = ('SHA-256' + '');
 const AWS4 = ('AWS4' + '');
 const SIGN_P = [AWS4, ALG_NAME, 'SHA256'].join('-');
 const RE_ISO_DATE = /[:-]|\.\d{3}/g;
-const RE_XML_TAGS = /<(\w)([-\w]*)(?:\/|[^>]*>((?:(?!<\1\2)[\s\S])*)<\/\1\2)>/gm;
+const RE_XML_TAGS = /<(\w[-\w]*)(?:\/|[^>]*>((?:(?!<\1)[\s\S])*)<\/\1)>/gm;
 const RE_DASH_CASE = /\B[A-Z]/g;
 const RE_ENCODE_URI = /[!'()*]/g;
 const RE_LEADING_SLASHES = /^\/*/;
 
-const enc = new TextEncoder();
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
 const { subtle } = crypto;
 
 const toArrayBuffer = (d: any): ArrayBuffer =>
-  d instanceof ArrayBuffer ? d : d?.buffer?.constructor === ArrayBuffer ? d.buffer : enc.encode(d == null ? '' : `${d}`).buffer;
+  d instanceof ArrayBuffer ? d : d?.buffer?.constructor === ArrayBuffer ? d.buffer : encoder.encode(d == null ? '' : `${d}`).buffer;
 
 export const toHex = (buf: ArrayBuffer | Uint8Array):string =>
   Array.from(new Uint8Array(buf)).map(b => b.toString(16).padStart(2, '0')).join('');
 
 export const hmac = async (key: string | Uint8Array | ArrayBuffer, data: string): Promise<Uint8Array> => {
   const cryptoKey = await subtle.importKey('raw', toArrayBuffer(key), { name: ALG_NAME, hash: ALG_HASH}, false, ['sign']);
-  return new Uint8Array(await subtle.sign(ALG_NAME, cryptoKey, enc.encode(data)));
+  return new Uint8Array(await subtle.sign(ALG_NAME, cryptoKey, encoder.encode(data)));
 };
 
 export const hash = async (data: any) => toHex(await subtle.digest(ALG_HASH, toArrayBuffer(data)));
 
+const toKebabCase = (str: string): string =>
+  str.replace(RE_DASH_CASE, "-$&").toLowerCase();
+
 const assignDashCase = (target: Record<string, string>, source: Record<string, any> | undefined, prefix: string): Record<string, string> => {
   if (source) Object.keys(source).forEach(key => {
-    const name = (prefix + (key === "expires" ? key : key.replace(RE_DASH_CASE, "-$&"))).toLowerCase();
+    const name = toKebabCase(prefix + key);
     if (source[key] && typeof source[key] !== 'object') target[name] = `${source[key]}`;
   });
   return target;
@@ -62,42 +96,42 @@ const awsEncodeURI = (str: string): string =>
 const parseXml = (str: string): any => {
   const types: Record<string, any> = { "": "", "true": true, "false": false };
   const m = [...str.matchAll(RE_XML_TAGS)];
-  return m.length ? m.reduce((acc: any, [, tag = '', suffix = '', content = '']) => {
-    const k = tag.toLowerCase() + suffix;
-    const v = types[content] ?? (isNaN(+content) ? parseXml(content) : +content);
-    acc[k] = Array.isArray(acc[k]) ? [...acc[k], v] : acc[k] != null ? [acc[k], v] : k === "contents" ? [v] : v;
+  return m.length ? m.reduce((acc: any, [, key = '', content = '']) => {
+    const value = types[content] ?? (isNaN(+content) ? parseXml(content) : +content);
+    acc[key] = Array.isArray(acc[key]) ? [...acc[key], value] : acc[key] != null ? [acc[key], value] : key === "Contents" ? [value] : value;
     return acc;
   }, {}) : str;
 };
 
-export class S3XmlTransformStream extends TransformStream<Uint8Array, any> {
-  constructor() {
-    const decoder = new TextDecoder();
-    let acc = "";
-    super({
-      transform(chunk) { acc += decoder.decode(chunk, { stream: true }); },
-      flush(c) {
-        const res = parseXml((acc + decoder.decode()).trim());
-        c.enqueue(res?.listBucketResult || res);
-      }
-    });
-  }
-}
-
-export function zs3(opts: S3Config) {
+export function zs3(opts: S3Config): S3Client {
   const config = { region: 'us-east-1', bucket: '', ...opts };
-  const execute = async (method: string, path: string, body: any = null, options: S3Options = {}): Promise<Response | any> => {
-    const {
-      endpoint,
-      bucket,
-      region,
-      accessKeyId,
-      secretAccessKey
-    } = config;
+  const execute = async (req: S3RequestOptions, options: S3Options = {}) => {
+    const { method } = req;
+    const body = 'body' in req ? req.body : null;
+
+    // Build uri
+    const targetBucket = req.bucket !== undefined ? req.bucket : config.bucket;
+    const cleanKey = 'key' in req && req.key ? req.key.replace(RE_LEADING_SLASHES, '') : '';
+    const uri = targetBucket ? `/${targetBucket}/${cleanKey}` : `/${cleanKey}`;
+    const isListQuery = method === 'GET' && !('key' in req);
+    const sortedQuery = Object.entries({
+      ...options.query,
+      ...(isListQuery && {
+        listType: 2,
+        maxKeys: req.maxKeys || 1000,
+        prefix: req.prefix || ''
+      })
+    })
+      .sort()
+      .map(([key, val]) => `${toKebabCase(key)}=${awsEncodeURI(String(val ?? ''))}`)
+      .join('&');
+
+    // --- Оригинальный блок конфигурации ---
+    const { endpoint, region, accessKeyId, secretAccessKey } = config;
     const base = new URL(endpoint.startsWith('http') ? endpoint : `https://${endpoint.replace('://', '')}`);
     const isoDate = new Date().toISOString().replace(RE_ISO_DATE, '');
     const sDate = isoDate.slice(0, 8);
-    const pathname = bucket ? `/${bucket}/${path.replace(RE_LEADING_SLASHES, '')}` : path;
+
     const isStream = body && typeof body.getReader === 'function';
     const payloadHash = isStream ? 'UNSIGNED-PAYLOAD' : await hash(body || '');
 
@@ -108,11 +142,18 @@ export function zs3(opts: S3Config) {
       ...(body && !isStream ? { 'content-length': `${toArrayBuffer(body).byteLength}` } : {})
     }, options.headers, ""), options.meta, "x-amz-meta-");
 
-    const [uri, query = ''] = pathname.split('?');
     const sortedHeaders = Object.keys(headers).map(k => k.toLowerCase()).sort();
-    const sortedQuery = query ? query.split('&').sort().join('&') : '';
 
-    const canonical = [method, uri || '/', sortedQuery, sortedHeaders.map(k => `${k}:${headers[k]?.trim()}`).join('\n') + '\n', sortedHeaders.join(';'), payloadHash].join('\n');
+    // 4. Формируем Canonical Request (используем уже готовые uri и sortedQuery)
+    const canonical = [
+      method,
+      uri || '/',
+      sortedQuery,
+      sortedHeaders.map(k => `${k}:${headers[k]?.trim()}`).join('\n') + '\n',
+      sortedHeaders.join(';'),
+      payloadHash
+    ].join('\n');
+
     const scope = `${sDate}/${region}/s3/aws4_request`;
 
     const kSign = await hmac(await hmac(await hmac(await hmac(`${AWS4}${secretAccessKey}`, sDate), region), 's3'), 'aws4_request');
@@ -120,33 +161,48 @@ export function zs3(opts: S3Config) {
 
     headers['Authorization'] = `${SIGN_P} Credential=${accessKeyId}/${scope}, SignedHeaders=${sortedHeaders.join(';')}, Signature=${signature}`;
 
-    const res = await fetch(new URL(pathname, base), { method, headers, body });
-    if (!res.ok) throw new Error(`S3 Error: ${res.status} - ${await res.text()}`);
+    const requestUrl = new URL(uri, base);
 
-    return method === 'HEAD' ? {
-      size: +res.headers.get("content-length")!,
-      mtime: new Date(res.headers.get("last-modified")!),
-      ...Object.fromEntries(res.headers)
-    } : res;
-  };
+    if (sortedQuery) {
+      requestUrl.search = sortedQuery;
+    }
 
-  return {
-    get: async (keyOrOpts: string | ListOptions, options: S3Options = {}) => {
-      if (typeof keyOrOpts !== 'object' || keyOrOpts === null) {
-        return execute('GET', keyOrOpts, null, options);
+    try {
+      const res = await fetch(requestUrl, { method, headers, body });
+
+      if (!res.ok) {
+        throw { status: res.status, ...parseXml(await res.text()) };
       }
 
-      const query = `?list-type=2&max-keys=${keyOrOpts.maxKeys || 1000}&prefix=${awsEncodeURI(keyOrOpts.prefix || '')}`;
-      const res = await execute('GET', query, null, options);
+      if (method === 'GET' && !req.key) {
+        const headers = new Headers(res.headers);
+
+        let data = parseXml((await res.text()).trim());
 
-      const reader = res.body?.pipeThrough(new S3XmlTransformStream()).getReader();
+        if (data && typeof data === 'object') {
+          const keys = Object.keys(data);
+          if (keys.length === 1) data = data[keys[0] as string];
+        }
 
-      return (await reader?.read()).value
-    },
-    put: (path: string, body: any = null, options: S3Options = {}) => execute('PUT', path, body, options),
-    del: (path: string, options: S3Options = {}) => execute('DELETE', path, null, options),
-    stat: (path: string, options: S3Options = {}) => execute('HEAD', path, null, options),
+        headers.set('content-type', 'application/json');
+
+        return new Response(JSON.stringify(data), {
+          status: res.status,
+          statusText: res.statusText,
+          headers
+        });
+      }
+
+      return res;
+    } catch (err: any) {
+      if (err.status) throw err;
+      throw { status: 500, Error: { Code: err?.code || 'InternalServerError', Message: err?.message || String(err) } };
+    }
+  };
+
+  return {
     execute,
-    config
+    config,
+    clone: (newConfig: Partial<S3Config> = {}) => zs3({ ...config, ...newConfig })
   };
 }

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@focus-at/zs3",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "description": "Zero-dependency micro S3 client built on Web Standards",
   "homepage": "https://github.com/focus-at/zs3",
   "type": "module",
   "exports": {
     ".": {
       "types": "./index.ts",
-      "import": "./dist/zeros3.js"
+      "default": "./dist/index.js"
     }
   },
   "scripts": {
-    "build": "bun build --minify --sourcemap ./index.ts --outdir=dist && mv dist/index.js dist/zeros3.js && mv dist/index.js.map dist/zeros3.js.map",
+    "build": "bun build --minify --sourcemap ./index.ts --outdir=dist",
     "release": "npm version patch && git push origin main --tags",
     "postinstall": "node -e \"if(!process.env.DISABLE_OPENCOLLECTIVE && !process.env.CI){process.stdout.write('\\u001b[35mThanks for installing ZeroS3! Consider giving it a star on GitHub: https://github.com\\u001b[0m\\n')}\""
   },
@@ -58,7 +58,7 @@
     "LICENSE"
   ],
   "peerDependencies": {
-    "typescript": "^5.0.0 || ^6.0.0"
+    "typescript": "^6.0.0"
   },
   "peerDependenciesMeta": {
     "typescript": {

package/dist/zeros3.js

@@ -1,8 +0,0 @@
-var y="HMAC",C="SHA-256",H="AWS4",_=[H,y,"SHA256"].join("-"),M=/[:-]|\.\d{3}/g,W=/<(\w)([-\w]*)(?:\/|[^>]*>((?:(?!<\1\2)[\s\S])*)<\/\1\2)>/gm,v=/\B[A-Z]/g,X=/[!'()*]/g,k=/^\/*/,b=new TextEncoder,{subtle:A}=crypto,m=(e)=>e instanceof ArrayBuffer?e:e?.buffer?.constructor===ArrayBuffer?e.buffer:b.encode(e==null?"":`${e}`).buffer,I=(e)=>Array.from(new Uint8Array(e)).map((n)=>n.toString(16).padStart(2,"0")).join(""),u=async(e,n)=>{let r=await A.importKey("raw",m(e),{name:y,hash:C},!1,["sign"]);return new Uint8Array(await A.sign(y,r,b.encode(n)))},U=async(e)=>I(await A.digest(C,m(e))),j=(e,n,r)=>{if(n)Object.keys(n).forEach((t)=>{let s=(r+(t==="expires"?t:t.replace(v,"-$&"))).toLowerCase();if(n[t]&&typeof n[t]!=="object")e[s]=`${n[t]}`});return e},Q=(e)=>encodeURIComponent(e).replace(X,(n)=>`%${n.charCodeAt(0).toString(16).toUpperCase()}`),T=(e)=>{let n={"":"",true:!0,false:!1},r=[...e.matchAll(W)];return r.length?r.reduce((t,[,s="",a="",i=""])=>{let o=s.toLowerCase()+a,c=n[i]??(isNaN(+i)?T(i):+i);return t[o]=Array.isArray(t[o])?[...t[o],c]:t[o]!=null?[t[o],c]:o==="contents"?[c]:c,t},{}):e};class B extends TransformStream{constructor(){let e=new TextDecoder,n="";super({transform(r){n+=e.decode(r,{stream:!0})},flush(r){let t=T((n+e.decode()).trim());r.enqueue(t?.listBucketResult||t)}})}}function Y(e){let n={region:"us-east-1",bucket:"",...e},r=async(t,s,a=null,i={})=>{let{endpoint:o,bucket:c,region:S,accessKeyId:G,secretAccessKey:K}=n,w=new URL(o.startsWith("http")?o:`https://${o.replace("://","")}`),l=new Date().toISOString().replace(M,""),h=l.slice(0,8),x=c?`/${c}/${s.replace(k,"")}`:s,E=a&&typeof a.getReader==="function",R=E?"UNSIGNED-PAYLOAD":await U(a||""),f=j(j({host:w.host,"x-amz-date":l,"x-amz-content-sha256":R,...a&&!E?{"content-length":`${m(a).byteLength}`}:{}},i.headers,""),i.meta,"x-amz-meta-"),[N,D=""]=x.split("?"),d=Object.keys(f).map((p)=>p.toLowerCase()).sort(),z=D?D.split("&").sort().join("&"):"",O=[t,N||"/",z,d.map((p)=>`${p}:${f[p]?.trim()}`).join(`
-`)+`
-`,d.join(";"),R].join(`
-`),L=`${h}/${S}/s3/aws4_request`,q=await u(await u(await u(await u(`${H}${K}`,h),S),"s3"),"aws4_request"),P=I(await u(q,[_,l,L,await U(O)].join(`
-`)));f.Authorization=`${_} Credential=${G}/${L}, SignedHeaders=${d.join(";")}, Signature=${P}`;let g=await fetch(new URL(x,w),{method:t,headers:f,body:a});if(!g.ok)throw Error(`S3 Error: ${g.status} - ${await g.text()}`);return t==="HEAD"?{size:+g.headers.get("content-length"),mtime:new Date(g.headers.get("last-modified")),...Object.fromEntries(g.headers)}:g};return{get:async(t,s={})=>{if(typeof t!=="object"||t===null)return r("GET",t,null,s);let a=`?list-type=2&max-keys=${t.maxKeys||1000}&prefix=${Q(t.prefix||"")}`;return(await(await r("GET",a,null,s)).body?.pipeThrough(new B).getReader()?.read()).value},put:(t,s=null,a={})=>r("PUT",t,s,a),del:(t,s={})=>r("DELETE",t,null,s),stat:(t,s={})=>r("HEAD",t,null,s),execute:r,config:n}}export{B as S3XmlTransformStream,U as hash,u as hmac,I as toHex,Y as zs3};
-
-//# debugId=84835880639AD3D564756E2164756E21
-//# sourceMappingURL=index.js.map

package/dist/zeros3.js.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../index.ts"],
-  "sourcesContent": [
-    "export interface S3Config {\n  endpoint: string;\n  accessKeyId: string;\n  secretAccessKey: string;\n  bucket?: string;\n  region?: string;\n  [key: string]: any;\n}\n\nexport interface S3Options {\n  headers?: Record<string, string>;\n  meta?: Record<string, string>;\n}\n\nexport interface ListOptions {\n  prefix?: string;\n  maxKeys?: number;\n}\n\nexport interface S3StatResponse extends Record<string, any> {\n  size: number;\n  mtime: Date;\n}\n\nconst ALG_NAME = ('HMAC' + '');\nconst ALG_HASH = ('SHA-256' + '');\nconst AWS4 = ('AWS4' + '');\nconst SIGN_P = [AWS4, ALG_NAME, 'SHA256'].join('-');\nconst RE_ISO_DATE = /[:-]|\\.\\d{3}/g;\nconst RE_XML_TAGS = /<(\\w)([-\\w]*)(?:\\/|[^>]*>((?:(?!<\\1\\2)[\\s\\S])*)<\\/\\1\\2)>/gm;\nconst RE_DASH_CASE = /\\B[A-Z]/g;\nconst RE_ENCODE_URI = /[!'()*]/g;\nconst RE_LEADING_SLASHES = /^\\/*/;\n\nconst enc = new TextEncoder();\nconst { subtle } = crypto;\n\nconst toArrayBuffer = (d: any): ArrayBuffer =>\n  d instanceof ArrayBuffer ? d : d?.buffer?.constructor === ArrayBuffer ? d.buffer : enc.encode(d == null ? '' : `${d}`).buffer;\n\nexport const toHex = (buf: ArrayBuffer | Uint8Array):string =>\n  Array.from(new Uint8Array(buf)).map(b => b.toString(16).padStart(2, '0')).join('');\n\nexport const hmac = async (key: string | Uint8Array | ArrayBuffer, data: string): Promise<Uint8Array> => {\n  const cryptoKey = await subtle.importKey('raw', toArrayBuffer(key), { name: ALG_NAME, hash: ALG_HASH}, false, ['sign']);\n  return new Uint8Array(await subtle.sign(ALG_NAME, cryptoKey, enc.encode(data)));\n};\n\nexport const hash = async (data: any) => toHex(await subtle.digest(ALG_HASH, toArrayBuffer(data)));\n\nconst assignDashCase = (target: Record<string, string>, source: Record<string, any> | undefined, prefix: string): Record<string, string> => {\n  if (source) Object.keys(source).forEach(key => {\n    const name = (prefix + (key === \"expires\" ? key : key.replace(RE_DASH_CASE, \"-$&\"))).toLowerCase();\n    if (source[key] && typeof source[key] !== 'object') target[name] = `${source[key]}`;\n  });\n  return target;\n};\n\nconst awsEncodeURI = (str: string): string =>\n  encodeURIComponent(str).replace(RE_ENCODE_URI, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);\n\nconst parseXml = (str: string): any => {\n  const types: Record<string, any> = { \"\": \"\", \"true\": true, \"false\": false };\n  const m = [...str.matchAll(RE_XML_TAGS)];\n  return m.length ? m.reduce((acc: any, [, tag = '', suffix = '', content = '']) => {\n    const k = tag.toLowerCase() + suffix;\n    const v = types[content] ?? (isNaN(+content) ? parseXml(content) : +content);\n    acc[k] = Array.isArray(acc[k]) ? [...acc[k], v] : acc[k] != null ? [acc[k], v] : k === \"contents\" ? [v] : v;\n    return acc;\n  }, {}) : str;\n};\n\nexport class S3XmlTransformStream extends TransformStream<Uint8Array, any> {\n  constructor() {\n    const decoder = new TextDecoder();\n    let acc = \"\";\n    super({\n      transform(chunk) { acc += decoder.decode(chunk, { stream: true }); },\n      flush(c) {\n        const res = parseXml((acc + decoder.decode()).trim());\n        c.enqueue(res?.listBucketResult || res);\n      }\n    });\n  }\n}\n\nexport function zs3(opts: S3Config) {\n  const config = { region: 'us-east-1', bucket: '', ...opts };\n  const execute = async (method: string, path: string, body: any = null, options: S3Options = {}): Promise<Response | any> => {\n    const {\n      endpoint,\n      bucket,\n      region,\n      accessKeyId,\n      secretAccessKey\n    } = config;\n    const base = new URL(endpoint.startsWith('http') ? endpoint : `https://${endpoint.replace('://', '')}`);\n    const isoDate = new Date().toISOString().replace(RE_ISO_DATE, '');\n    const sDate = isoDate.slice(0, 8);\n    const pathname = bucket ? `/${bucket}/${path.replace(RE_LEADING_SLASHES, '')}` : path;\n    const isStream = body && typeof body.getReader === 'function';\n    const payloadHash = isStream ? 'UNSIGNED-PAYLOAD' : await hash(body || '');\n\n    const headers: Record<string, string> = assignDashCase(assignDashCase({\n      host: base.host,\n      'x-amz-date': isoDate,\n      'x-amz-content-sha256': payloadHash,\n      ...(body && !isStream ? { 'content-length': `${toArrayBuffer(body).byteLength}` } : {})\n    }, options.headers, \"\"), options.meta, \"x-amz-meta-\");\n\n    const [uri, query = ''] = pathname.split('?');\n    const sortedHeaders = Object.keys(headers).map(k => k.toLowerCase()).sort();\n    const sortedQuery = query ? query.split('&').sort().join('&') : '';\n\n    const canonical = [method, uri || '/', sortedQuery, sortedHeaders.map(k => `${k}:${headers[k]?.trim()}`).join('\\n') + '\\n', sortedHeaders.join(';'), payloadHash].join('\\n');\n    const scope = `${sDate}/${region}/s3/aws4_request`;\n\n    const kSign = await hmac(await hmac(await hmac(await hmac(`${AWS4}${secretAccessKey}`, sDate), region), 's3'), 'aws4_request');\n    const signature = toHex(await hmac(kSign, [SIGN_P, isoDate, scope, await hash(canonical)].join('\\n')));\n\n    headers['Authorization'] = `${SIGN_P} Credential=${accessKeyId}/${scope}, SignedHeaders=${sortedHeaders.join(';')}, Signature=${signature}`;\n\n    const res = await fetch(new URL(pathname, base), { method, headers, body });\n    if (!res.ok) throw new Error(`S3 Error: ${res.status} - ${await res.text()}`);\n\n    return method === 'HEAD' ? {\n      size: +res.headers.get(\"content-length\")!,\n      mtime: new Date(res.headers.get(\"last-modified\")!),\n      ...Object.fromEntries(res.headers)\n    } : res;\n  };\n\n  return {\n    get: async (keyOrOpts: string | ListOptions, options: S3Options = {}) => {\n      if (typeof keyOrOpts !== 'object' || keyOrOpts === null) {\n        return execute('GET', keyOrOpts, null, options);\n      }\n\n      const query = `?list-type=2&max-keys=${keyOrOpts.maxKeys || 1000}&prefix=${awsEncodeURI(keyOrOpts.prefix || '')}`;\n      const res = await execute('GET', query, null, options);\n\n      const reader = res.body?.pipeThrough(new S3XmlTransformStream()).getReader();\n\n      return (await reader?.read()).value\n    },\n    put: (path: string, body: any = null, options: S3Options = {}) => execute('PUT', path, body, options),\n    del: (path: string, options: S3Options = {}) => execute('DELETE', path, null, options),\n    stat: (path: string, options: S3Options = {}) => execute('HEAD', path, null, options),\n    execute,\n    config\n  };\n}\n"
-  ],
-  "mappings": "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",
-  "debugId": "84835880639AD3D564756E2164756E21",
-  "names": []
-}