@lssm/lib.files 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217073102

package/dist/storage/index.js

@@ -1 +1,268 @@
-import*as e from"node:crypto";import*as t from"node:fs/promises";import*as n from"node:path";var r=class{provider=`LOCAL`;basePath;baseUrl;constructor(e){this.basePath=e.basePath,this.baseUrl=e.baseUrl}async upload(r){let i=n.join(this.basePath,r.path),a=n.dirname(i);await t.mkdir(a,{recursive:!0});let o=typeof r.content==`string`?Buffer.from(r.content,`base64`):r.content;await t.writeFile(i,o);let s=e.createHash(`sha256`).update(o).digest(`hex`);return{path:r.path,size:o.length,mimeType:r.mimeType,checksum:s,metadata:r.metadata}}async download(e){let r=n.join(this.basePath,e);return t.readFile(r)}async delete(e){let r=n.join(this.basePath,e);await t.unlink(r)}async exists(e){let r=n.join(this.basePath,e);try{return await t.access(r),!0}catch{return!1}}async getMetadata(e){let r=n.join(this.basePath,e);try{return{path:e,size:(await t.stat(r)).size,mimeType:`application/octet-stream`}}catch{return null}}async list(e){let r=e?.prefix?n.join(this.basePath,e.prefix):this.basePath;try{let i=await t.readdir(r,{withFileTypes:!0}),a=[];for(let o of i)if(o.isFile()){let i=e?.prefix?n.join(e.prefix,o.name):o.name,s=await t.stat(n.join(r,o.name));a.push({path:i,size:s.size,mimeType:`application/octet-stream`})}let o=e?.limit||a.length;return{files:a.slice(0,o),hasMore:a.length>o}}catch{return{files:[],hasMore:!1}}}async createPresignedUpload(e){let t=e.expiresIn||3600,n=new Date(Date.now()+t*1e3);return{url:this.baseUrl?`${this.baseUrl}/upload?path=${encodeURIComponent(e.path)}`:`/upload?path=${encodeURIComponent(e.path)}`,fields:{path:e.path,mimeType:e.mimeType},expiresAt:n}}async createPresignedDownload(e){let t=e.expiresIn||3600,n=new Date(Date.now()+t*1e3);return{url:this.baseUrl?`${this.baseUrl}/download/${e.path}`:`/download/${e.path}`,expiresAt:n}}getPublicUrl(e){return this.baseUrl?`${this.baseUrl}/${e}`:null}async copy(e,r){let i=n.join(this.basePath,e),a=n.join(this.basePath,r),o=n.dirname(a);return await t.mkdir(o,{recursive:!0}),await t.copyFile(i,a),{path:r,size:(await t.stat(a)).size,mimeType:`application/octet-stream`}}},i=class{provider=`S3`;config;constructor(e){this.config=e}async upload(e){throw Error(`S3 adapter requires @aws-sdk/client-s3. Install it and implement the upload method.`)}async download(e){throw Error(`S3 adapter requires @aws-sdk/client-s3. Install it and implement the download method.`)}async delete(e){throw Error(`S3 adapter requires @aws-sdk/client-s3. Install it and implement the delete method.`)}async exists(e){throw Error(`S3 adapter requires @aws-sdk/client-s3. Install it and implement the exists method.`)}async getMetadata(e){throw Error(`S3 adapter requires @aws-sdk/client-s3. Install it and implement the getMetadata method.`)}async list(e){throw Error(`S3 adapter requires @aws-sdk/client-s3. Install it and implement the list method.`)}async createPresignedUpload(e){throw Error(`S3 adapter requires @aws-sdk/client-s3. Install it and implement the createPresignedUpload method.`)}async createPresignedDownload(e){throw Error(`S3 adapter requires @aws-sdk/client-s3. Install it and implement the createPresignedDownload method.`)}getPublicUrl(e){let{bucket:t,region:n,endpoint:r}=this.config;return r?`${r}/${t}/${e}`:`https://${t}.s3.${n}.amazonaws.com/${e}`}async copy(e,t){throw Error(`S3 adapter requires @aws-sdk/client-s3. Install it and implement the copy method.`)}},a=class{provider=`LOCAL`;files=new Map;async upload(t){let n=typeof t.content==`string`?Buffer.from(t.content,`base64`):t.content,r=e.createHash(`sha256`).update(n).digest(`hex`),i={path:t.path,size:n.length,mimeType:t.mimeType,checksum:r,metadata:t.metadata};return this.files.set(t.path,{content:n,metadata:i}),i}async download(e){let t=this.files.get(e);if(!t)throw Error(`File not found: ${e}`);return t.content}async delete(e){this.files.delete(e)}async exists(e){return this.files.has(e)}async getMetadata(e){return this.files.get(e)?.metadata||null}async list(e){let t=e?.prefix||``,n=[];for(let[e,r]of this.files)e.startsWith(t)&&n.push(r.metadata);let r=e?.limit||n.length;return{files:n.slice(0,r),hasMore:n.length>r}}async createPresignedUpload(e){let t=new Date(Date.now()+(e.expiresIn||3600)*1e3);return{url:`/upload?path=${encodeURIComponent(e.path)}`,fields:{path:e.path},expiresAt:t}}async createPresignedDownload(e){let t=new Date(Date.now()+(e.expiresIn||3600)*1e3);return{url:`/download/${e.path}`,expiresAt:t}}getPublicUrl(e){return`/files/${e}`}async copy(e,t){let n=this.files.get(e);if(!n)throw Error(`Source file not found: ${e}`);let r={...n.metadata,path:t};return this.files.set(t,{content:n.content,metadata:r}),r}clear(){this.files.clear()}};function o(e){switch(e.provider){case`LOCAL`:if(!e.local)throw Error(`Local storage configuration required`);return new r(e.local);case`S3`:if(!e.s3)throw Error(`S3 storage configuration required`);return new i(e.s3);default:throw Error(`Unsupported storage provider: ${e.provider}`)}}export{a as InMemoryStorageAdapter,r as LocalStorageAdapter,i as S3StorageAdapter,o as createStorageAdapter};
+import * as crypto from "node:crypto";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+
+//#region src/storage/index.ts
+/**
+* Local filesystem storage adapter.
+* For development and testing purposes.
+*/
+var LocalStorageAdapter = class {
+	provider = "LOCAL";
+	basePath;
+	baseUrl;
+	constructor(options) {
+		this.basePath = options.basePath;
+		this.baseUrl = options.baseUrl;
+	}
+	async upload(options) {
+		const fullPath = path.join(this.basePath, options.path);
+		const dir = path.dirname(fullPath);
+		await fs.mkdir(dir, { recursive: true });
+		const content = typeof options.content === "string" ? Buffer.from(options.content, "base64") : options.content;
+		await fs.writeFile(fullPath, content);
+		const checksum = crypto.createHash("sha256").update(content).digest("hex");
+		return {
+			path: options.path,
+			size: content.length,
+			mimeType: options.mimeType,
+			checksum,
+			metadata: options.metadata
+		};
+	}
+	async download(filePath) {
+		const fullPath = path.join(this.basePath, filePath);
+		return fs.readFile(fullPath);
+	}
+	async delete(filePath) {
+		const fullPath = path.join(this.basePath, filePath);
+		await fs.unlink(fullPath);
+	}
+	async exists(filePath) {
+		const fullPath = path.join(this.basePath, filePath);
+		try {
+			await fs.access(fullPath);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	async getMetadata(filePath) {
+		const fullPath = path.join(this.basePath, filePath);
+		try {
+			return {
+				path: filePath,
+				size: (await fs.stat(fullPath)).size,
+				mimeType: "application/octet-stream"
+			};
+		} catch {
+			return null;
+		}
+	}
+	async list(options) {
+		const dir = options?.prefix ? path.join(this.basePath, options.prefix) : this.basePath;
+		try {
+			const entries = await fs.readdir(dir, { withFileTypes: true });
+			const files = [];
+			for (const entry of entries) if (entry.isFile()) {
+				const filePath = options?.prefix ? path.join(options.prefix, entry.name) : entry.name;
+				const stat = await fs.stat(path.join(dir, entry.name));
+				files.push({
+					path: filePath,
+					size: stat.size,
+					mimeType: "application/octet-stream"
+				});
+			}
+			const limit = options?.limit || files.length;
+			return {
+				files: files.slice(0, limit),
+				hasMore: files.length > limit
+			};
+		} catch {
+			return {
+				files: [],
+				hasMore: false
+			};
+		}
+	}
+	async createPresignedUpload(options) {
+		const expiresIn = options.expiresIn || 3600;
+		const expiresAt = new Date(Date.now() + expiresIn * 1e3);
+		return {
+			url: this.baseUrl ? `${this.baseUrl}/upload?path=${encodeURIComponent(options.path)}` : `/upload?path=${encodeURIComponent(options.path)}`,
+			fields: {
+				path: options.path,
+				mimeType: options.mimeType
+			},
+			expiresAt
+		};
+	}
+	async createPresignedDownload(options) {
+		const expiresIn = options.expiresIn || 3600;
+		const expiresAt = new Date(Date.now() + expiresIn * 1e3);
+		return {
+			url: this.baseUrl ? `${this.baseUrl}/download/${options.path}` : `/download/${options.path}`,
+			expiresAt
+		};
+	}
+	getPublicUrl(filePath) {
+		if (!this.baseUrl) return null;
+		return `${this.baseUrl}/${filePath}`;
+	}
+	async copy(sourcePath, destinationPath) {
+		const sourceFullPath = path.join(this.basePath, sourcePath);
+		const destFullPath = path.join(this.basePath, destinationPath);
+		const destDir = path.dirname(destFullPath);
+		await fs.mkdir(destDir, { recursive: true });
+		await fs.copyFile(sourceFullPath, destFullPath);
+		return {
+			path: destinationPath,
+			size: (await fs.stat(destFullPath)).size,
+			mimeType: "application/octet-stream"
+		};
+	}
+};
+/**
+* S3 storage adapter interface.
+* Implementation would use AWS SDK or compatible client.
+*
+* This is a placeholder that defines the interface.
+* Actual implementation would require @aws-sdk/client-s3 dependency.
+*/
+var S3StorageAdapter = class {
+	provider = "S3";
+	config;
+	constructor(options) {
+		this.config = options;
+	}
+	async upload(options) {
+		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the upload method.");
+	}
+	async download(filePath) {
+		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the download method.");
+	}
+	async delete(filePath) {
+		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the delete method.");
+	}
+	async exists(filePath) {
+		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the exists method.");
+	}
+	async getMetadata(filePath) {
+		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the getMetadata method.");
+	}
+	async list(options) {
+		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the list method.");
+	}
+	async createPresignedUpload(options) {
+		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the createPresignedUpload method.");
+	}
+	async createPresignedDownload(options) {
+		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the createPresignedDownload method.");
+	}
+	getPublicUrl(filePath) {
+		const { bucket, region, endpoint } = this.config;
+		if (endpoint) return `${endpoint}/${bucket}/${filePath}`;
+		return `https://${bucket}.s3.${region}.amazonaws.com/${filePath}`;
+	}
+	async copy(sourcePath, destinationPath) {
+		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the copy method.");
+	}
+};
+/**
+* In-memory storage adapter for testing.
+*/
+var InMemoryStorageAdapter = class {
+	provider = "LOCAL";
+	files = /* @__PURE__ */ new Map();
+	async upload(options) {
+		const content = typeof options.content === "string" ? Buffer.from(options.content, "base64") : options.content;
+		const checksum = crypto.createHash("sha256").update(content).digest("hex");
+		const metadata = {
+			path: options.path,
+			size: content.length,
+			mimeType: options.mimeType,
+			checksum,
+			metadata: options.metadata
+		};
+		this.files.set(options.path, {
+			content,
+			metadata
+		});
+		return metadata;
+	}
+	async download(filePath) {
+		const file = this.files.get(filePath);
+		if (!file) throw new Error(`File not found: ${filePath}`);
+		return file.content;
+	}
+	async delete(filePath) {
+		this.files.delete(filePath);
+	}
+	async exists(filePath) {
+		return this.files.has(filePath);
+	}
+	async getMetadata(filePath) {
+		return this.files.get(filePath)?.metadata || null;
+	}
+	async list(options) {
+		const prefix = options?.prefix || "";
+		const files = [];
+		for (const [path$1, file] of this.files) if (path$1.startsWith(prefix)) files.push(file.metadata);
+		const limit = options?.limit || files.length;
+		return {
+			files: files.slice(0, limit),
+			hasMore: files.length > limit
+		};
+	}
+	async createPresignedUpload(options) {
+		const expiresAt = new Date(Date.now() + (options.expiresIn || 3600) * 1e3);
+		return {
+			url: `/upload?path=${encodeURIComponent(options.path)}`,
+			fields: { path: options.path },
+			expiresAt
+		};
+	}
+	async createPresignedDownload(options) {
+		const expiresAt = new Date(Date.now() + (options.expiresIn || 3600) * 1e3);
+		return {
+			url: `/download/${options.path}`,
+			expiresAt
+		};
+	}
+	getPublicUrl(filePath) {
+		return `/files/${filePath}`;
+	}
+	async copy(sourcePath, destinationPath) {
+		const source = this.files.get(sourcePath);
+		if (!source) throw new Error(`Source file not found: ${sourcePath}`);
+		const metadata = {
+			...source.metadata,
+			path: destinationPath
+		};
+		this.files.set(destinationPath, {
+			content: source.content,
+			metadata
+		});
+		return metadata;
+	}
+	clear() {
+		this.files.clear();
+	}
+};
+/**
+* Create a storage adapter based on configuration.
+*/
+function createStorageAdapter(config) {
+	switch (config.provider) {
+		case "LOCAL":
+			if (!config.local) throw new Error("Local storage configuration required");
+			return new LocalStorageAdapter(config.local);
+		case "S3":
+			if (!config.s3) throw new Error("S3 storage configuration required");
+			return new S3StorageAdapter(config.s3);
+		default: throw new Error(`Unsupported storage provider: ${config.provider}`);
+	}
+}
+
+//#endregion
+export { InMemoryStorageAdapter, LocalStorageAdapter, S3StorageAdapter, createStorageAdapter };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.files",
-  "version": "0.0.0-canary-20251217063201",
+  "version": "0.0.0-canary-20251217073102",
   "description": "Files, documents and attachments module for ContractSpec applications",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,13 +18,13 @@
     "lint:check": "eslint src"
   },
   "dependencies": {
-    "@lssm/lib.schema": "0.0.0-canary-20251217063201",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217063201",
+    "@lssm/lib.schema": "0.0.0-canary-20251217073102",
+    "@lssm/lib.contracts": "0.0.0-canary-20251217073102",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.typescript": "0.0.0-canary-20251217063201",
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217063201",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217073102",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217073102",
     "typescript": "^5.9.3"
   },
   "exports": {