npm - @lssm/lib.files - Versions diffs - 0.0.0-canary-20251219202229 → 0.0.0-canary-20251220002821 - Mend

@lssm/lib.files 0.0.0-canary-20251219202229 → 0.0.0-canary-20251220002821

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (64) hide show

package/dist/contracts/dist/spec.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"spec.js","names":[],"sources":["../../../../contracts/dist/spec.js"],"sourcesContent":["//#region src/spec.ts\nconst isEmitDeclRef = (e) => \"ref\" in e;\n/*\n Helper to define a Command (write operation).\n* Sets `kind: 'command'` and defaults `idempotent: false`.\n/\nconst defineCommand = (spec) => ({\n\t...spec,\n\tmeta: {\n\t\t...spec.meta,\n\t\tkind: \"command\"\n\t},\n\tpolicy: {\n\t\t...spec.policy,\n\t\tidempotent: spec.policy?.[\"policy\"]?.idempotent ?? false\n\t}\n});\n/\n Helper to define a Query (read-only operation).\n* Sets `kind: 'query'` and forces `idempotent: true`.\n*/\nconst defineQuery = (spec) => ({\n\t...spec,\n\tmeta: {\n\t\t...spec.meta,\n\t\tkind: \"query\"\n\t},\n\tpolicy: {\n\t\t...spec.policy,\n\t\tidempotent: true\n\t}\n});\n\n//#endregion\nexport { defineCommand, defineQuery, isEmitDeclRef }~~;\n//# sourceMappingURL=spec.js.map~~"],"mappings":";;;;;AAMA,MAAM,iBAAiB,UAAU;CAChC,GAAG;CACH,MAAM;EACL,GAAG,KAAK;EACR,MAAM;EACN;CACD,QAAQ;EACP,GAAG,KAAK;EACR,YAAY,KAAK,SAAS,WAAW,cAAc;EACnD;CACD;;;;;AAKD,MAAM,eAAe,UAAU;CAC9B,GAAG;CACH,MAAM;EACL,GAAG,KAAK;EACR,MAAM;EACN;CACD,QAAQ;EACP,GAAG,KAAK;EACR,YAAY;EACZ;CACD"}
1	+ {"version":3,"file":"spec.js","names":[],"sources":["../../../../contracts/dist/spec.js"],"sourcesContent":["//#region src/spec.ts\nconst isEmitDeclRef = (e) => \"ref\" in e;\n/*\n Helper to define a Command (write operation).\n* Sets `kind: 'command'` and defaults `idempotent: false`.\n/\nconst defineCommand = (spec) => ({\n\t...spec,\n\tmeta: {\n\t\t...spec.meta,\n\t\tkind: \"command\"\n\t},\n\tpolicy: {\n\t\t...spec.policy,\n\t\tidempotent: spec.policy?.[\"policy\"]?.idempotent ?? false\n\t}\n});\n/\n Helper to define a Query (read-only operation).\n* Sets `kind: 'query'` and forces `idempotent: true`.\n*/\nconst defineQuery = (spec) => ({\n\t...spec,\n\tmeta: {\n\t\t...spec.meta,\n\t\tkind: \"query\"\n\t},\n\tpolicy: {\n\t\t...spec.policy,\n\t\tidempotent: true\n\t}\n});\n\n//#endregion\nexport { defineCommand, defineQuery, isEmitDeclRef };"],"mappings":";;;;;AAMA,MAAM,iBAAiB,UAAU;CAChC,GAAG;CACH,MAAM;EACL,GAAG,KAAK;EACR,MAAM;EACN;CACD,QAAQ;EACP,GAAG,KAAK;EACR,YAAY,KAAK,SAAS,WAAW,cAAc;EACnD;CACD;;;;;AAKD,MAAM,eAAe,UAAU;CAC9B,GAAG;CACH,MAAM;EACL,GAAG,KAAK;EACR,MAAM;EACN;CACD,QAAQ;EACP,GAAG,KAAK;EACR,YAAY;EACZ;CACD"}

package/dist/storage/index.d.ts CHANGED Viewed

@@ -158,16 +158,16 @@ declare class S3StorageAdapter implements StorageAdapter {
   readonly provider: StorageProvider;
   private config;
   constructor(options: S3StorageOptions);
-  upload(options: UploadOptions): Promise<StorageFile>;
-  download(filePath: string): Promise<Buffer>;
-  delete(filePath: string): Promise<void>;
-  exists(filePath: string): Promise<boolean>;
-  getMetadata(filePath: string): Promise<StorageFile | null>;
-  list(options?: ListOptions): Promise<ListResult>;
-  createPresignedUpload(options: PresignedUploadOptions): Promise<PresignedUrl>;
-  createPresignedDownload(options: PresignedDownloadOptions): Promise<PresignedUrl>;
+  upload(_options: UploadOptions): Promise<StorageFile>;
+  download(_filePath: string): Promise<Buffer>;
+  delete(_filePath: string): Promise<void>;
+  exists(_filePath: string): Promise<boolean>;
+  getMetadata(_filePath: string): Promise<StorageFile | null>;
+  list(_options?: ListOptions): Promise<ListResult>;
+  createPresignedUpload(_options: PresignedUploadOptions): Promise<PresignedUrl>;
+  createPresignedDownload(_options: PresignedDownloadOptions): Promise<PresignedUrl>;
   getPublicUrl(filePath: string): string | null;
-  copy(sourcePath: string, destinationPath: string): Promise<StorageFile>;
+  copy(_sourcePath: string, _destinationPath: string): Promise<StorageFile>;
 }
 /**
  * In-memory storage adapter for testing.

package/dist/storage/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","names":[],"sources":["../../src/storage/index.ts"],"sourcesContent":[],"mappings":";;AAMA;AAEA;AASiB,KAXL,eAAA,GAWkB,OAInB,GAIE,IAAA,GAAM,KAAA,GAAA,OAAA,GAAA,YAAA;AAKF,UAtBA,WAAA,CAsBsB;EAatB,IAAA,EAAA,MAAA;EASA,IAAA,EAAA,MAAA;EAMA,QAAA,EAAA,MAAW;EASX,QAAA,CAAA,EAAA,MAAU;EAQV,IAAA,CAAA,EAAA,MAAA;EAEI,QAAA,CAAA,EA/DR,MA+DQ,CAAA,MAAA,EAAA,MAAA,CAAA;;AAKqB,UAjEzB,aAAA,CAiEyB;EAAR;EAKA,IAAA,EAAA,MAAA;EAAR;EAKF,OAAA,EAvEb,MAuEa,GAAA,MAAA;EAKA;EAKa,QAAA,EAAA,MAAA;EAAR;EAKZ,QAAA,CAAA,EAlFJ,MAkFI,CAAA,MAAA,EAAA,MAAA,CAAA;EAAsB;EAAR,QAAA,CAAA,EAAA,OAAA;;AAKmC,UAlFjD,sBAAA,CAkFiD;EAAR;EAM7C,IAAA,EAAA,MAAA;EACA;EAAR,QAAA,EAAA,MAAA;EAUwD;EAAR,IAAA,EAAA,MAAA;EAAO;EAS3C,SAAA,CAAA,EAAA,MAAA;EAWJ;EACQ,UAAA,CAAA,EA9GN,MA8GM,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA;;AASG,UApHP,wBAAA,CAoHO;EAAwB;EAAR,IAAA,EAAA,MAAA;EA2BI;EAAR,SAAA,CAAA,EAAA,MAAA;EAKF;EAKA,kBAAA,CAAA,EAAA,MAAA;;AAUK,UA1JtB,YAAA,CA0JsB;EAchB,GAAA,EAAA,MAAA;EAAsB,MAAA,CAAA,EAtKlC,MAsKkC,CAAA,MAAA,EAAA,MAAA,CAAA;EAAR,SAAA,EArKxB,IAqKwB;;AAmCxB,UArMI,WAAA,CAqMJ;EAAR;EAmBQ,MAAA,CAAA,EAAA,MAAA;EACA;EAAR,KAAA,CAAA,EAAA,MAAA;EAoBQ;EAAR,MAAA,CAAA,EAAA,MAAA;;AAlJqD,UAlFzC,UAAA,CAkFyC;EAqKzC,KAAA,EAtPR,WAsPQ,EAAgB;EAwBpB,MAAA,CAAA,EAAA,MAAA;EACQ,OAAA,EAAA,OAAA;;~~AAOG~~,UA/QP,cAAA,CA+QO;EAAwB;EAAR,SAAA,QAAA,~~EA7QnB~~,~~eA6QmB~~;EAOI;;;EAYV,MAAA,CAAA,OAAA,~~EA3RhB~~,~~aA2RgB~~,CAAA,~~EA3RA~~,~~OA2RA~~,~~CA3RQ~~,~~WA2RR~~,CAAA;EAMa;;;EAMF,QAAA,CAAA,IAAA,EAAA,MAAA,CAAA,~~EAlSnB~~,~~OAkSmB~~,~~CAlSX~~,~~MAkSW~~,CAAA;EAAR;;;~~EAQhC~~,MAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EArSmB,OAqSnB,CAAA,IAAA,CAAA;~~EAOQ~~;;;~~EAkBA~~,MAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAzTW,OAyTX,CAAA,OAAA,CAAA;EAAR;;;EAYQ,WAAA,CAAA,IAAA,EAAA,MAAA,CAAuB,EAhUP,OAgUO,CAhUC,WAgUD,GAAA,IAAA,CAAA;EACf;;;EAGmB,IAAA,CAAA,OAAA,CAAA,EA/TvB,WA+TuB,CAAA,EA/TT,OA+TS,CA/TD,UA+TC,CAAA;EAoBI;;;EAYV,qBAAA,CAAA,OAAA,EA1VD,sBA0VC,CAAA,EA1VwB,OA0VxB,CA1VgC,YA0VhC,CAAA;EAIa;;;EAKF,uBAAA,CAAA,OAAA,EA7VhC,wBA6VgC,CAAA,EA5VxC,OA4VwC,CA5VhC,YA4VgC,CAAA;EAAR;;;EAmBhC,YAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAUQ;;;EAgBA,IAAA,CAAA,UAAA,EAAA,MAAA,EAAA,eAAA,EAAA,MAAA,CAAA,EA/XwC,OA+XxC,CA/XgD,WA+XhD,CAAA;;AA1FkC,UA5R9B,mBAAA,CA4R8B;EAAc;EAgH5C,QAAA,EAAA,MAAa;EAClB;EACF,OAAA,CAAA,EAAA,MAAA;;;AAOV;;;cA1Ya,mBAAA,YAA+B;qBACvB;;;uBAIE;kBAKC,gBAAgB,QAAQ;8BA2BZ,QAAQ;4BAKV;4BAKA;iCAUK,QAAQ;iBAcxB,cAAc,QAAQ;iCAkChC,yBACR,QAAQ;mCAmBA,2BACR,QAAQ;;qDAoBR,QAAQ;;UAmBI,gBAAA;;;;;;;;;;;;;;;;;;;;;;;cAwBJ,gBAAA,YAA4B;qBACpB;;uBAGE;~~kBAIC~~,gBAAgB,QAAQ~~;8BAOZ~~,QAAQ;~~4BAMV~~;~~4BAMA~~;~~iCAMK~~,QAAQ;~~iBAMxB~~,cAAc,QAAQ;~~iCAOhC~~,~~yBACR~~,QAAQ;~~mCAOA~~,~~2BACR~~,QAAQ;;~~qDAiBR~~,QAAQ;;;;;cAYA,sBAAA,YAAkC;qBAC1B;;kBAGG,gBAAgB,QAAQ;8BAoBZ,QAAQ;4BAQV;4BAIA;iCAIK,QAAQ;iBAKxB,cAAc,QAAQ;iCAkBhC,yBACR,QAAQ;mCAUA,2BACR,QAAQ;;qDAeR,QAAQ;;;UAsBI,aAAA;YACL;UACF;OACH;;;;;iBAMS,oBAAA,SAA6B,gBAAgB"}
1	+ {"version":3,"file":"index.d.ts","names":[],"sources":["../../src/storage/index.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/storage/index.js CHANGED Viewed

@@ -135,28 +135,28 @@ var S3StorageAdapter = class {
 	constructor(options) {
 		this.config = options;
 	}
-	async upload(options) {
+	async upload(_options) {
 		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the upload method.");
 	}
-	async download(filePath) {
+	async download(_filePath) {
 		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the download method.");
 	}
-	async delete(filePath) {
+	async delete(_filePath) {
 		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the delete method.");
 	}
-	async exists(filePath) {
+	async exists(_filePath) {
 		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the exists method.");
 	}
-	async getMetadata(filePath) {
+	async getMetadata(_filePath) {
 		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the getMetadata method.");
 	}
-	async list(options) {
+	async list(_options) {
 		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the list method.");
 	}
-	async createPresignedUpload(options) {
+	async createPresignedUpload(_options) {
 		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the createPresignedUpload method.");
 	}
-	async createPresignedDownload(options) {
+	async createPresignedDownload(_options) {
 		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the createPresignedDownload method.");
 	}
 	getPublicUrl(filePath) {
@@ -164,7 +164,7 @@ var S3StorageAdapter = class {
 		if (endpoint) return `${endpoint}/${bucket}/${filePath}`;
 		return `https://${bucket}.s3.${region}.amazonaws.com/${filePath}`;
 	}
-	async copy(sourcePath, destinationPath) {
+	async copy(_sourcePath, _destinationPath) {
 		throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the copy method.");
 	}
 };

package/dist/storage/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","names":["files: StorageFile[]","metadata: StorageFile","path"],"sources":["../../src/storage/index.ts"],"sourcesContent":["/*\n File storage adapters for different backends.\n /\n\n// ============ Types ============\n\nexport type StorageProvider = 'LOCAL' \| 'S3' \| 'GCS' \| 'AZURE' \| 'CLOUDFLARE';\n\nexport interface StorageFile {\n path: string;\n size: number;\n mimeType: string;\n checksum?: string;\n etag?: string;\n metadata?: Record<string, string>;\n}\n\nexport interface UploadOptions {\n /* Target path in storage /\n path: string;\n /* File content /\n content: Buffer \| string;\n /* MIME type /\n mimeType: string;\n /* Additional metadata /\n metadata?: Record<string, string>;\n /* Whether file should be publicly accessible /\n isPublic?: boolean;\n}\n\nexport interface PresignedUploadOptions {\n /* Target path in storage /\n path: string;\n /* MIME type /\n mimeType: string;\n /* File size in bytes /\n size: number;\n /* Expiration time in seconds /\n expiresIn?: number;\n /* Additional conditions /\n conditions?: Record<string, unknown>[];\n}\n\nexport interface PresignedDownloadOptions {\n /* File path in storage /\n path: string;\n /* Expiration time in seconds /\n expiresIn?: number;\n /* Response content disposition /\n contentDisposition?: string;\n}\n\nexport interface PresignedUrl {\n url: string;\n fields?: Record<string, string>;\n expiresAt: Date;\n}\n\nexport interface ListOptions {\n /* Path prefix /\n prefix?: string;\n /* Maximum results /\n limit?: number;\n /* Continuation token /\n cursor?: string;\n}\n\nexport interface ListResult {\n files: StorageFile[];\n cursor?: string;\n hasMore: boolean;\n}\n\n// ============ Storage Adapter Interface ============\n\nexport interface StorageAdapter {\n /* Storage provider type /\n readonly provider: StorageProvider;\n\n /\n Upload a file to storage.\n /\n upload(options: UploadOptions): Promise<StorageFile>;\n\n /\n Download a file from storage.\n /\n download(path: string): Promise<Buffer>;\n\n /\n Delete a file from storage.\n /\n delete(path: string): Promise<void>;\n\n /\n Check if a file exists.\n /\n exists(path: string): Promise<boolean>;\n\n /\n Get file metadata.\n /\n getMetadata(path: string): Promise<StorageFile \| null>;\n\n /\n List files in a directory.\n /\n list(options?: ListOptions): Promise<ListResult>;\n\n /\n Generate a presigned URL for uploading.\n /\n createPresignedUpload(options: PresignedUploadOptions): Promise<PresignedUrl>;\n\n /\n Generate a presigned URL for downloading.\n /\n createPresignedDownload(\n options: PresignedDownloadOptions\n ): Promise<PresignedUrl>;\n\n /\n Get public URL for a file (if applicable).\n /\n getPublicUrl(path: string): string \| null;\n\n /\n Copy a file within storage.\n /\n copy(sourcePath: string, destinationPath: string): Promise<StorageFile>;\n}\n\n// ============ Local Storage Adapter ============\n\nimport as fs from 'node:fs/promises';\nimport * as path from 'node:path';\nimport * as crypto from 'node:crypto';\n\nexport interface LocalStorageOptions {\n /** Base directory for file storage /\n basePath: string;\n /* Base URL for serving files (optional) /\n baseUrl?: string;\n}\n\n/\n Local filesystem storage adapter.\n * For development and testing purposes.\n /\nexport class LocalStorageAdapter implements StorageAdapter {\n readonly provider: StorageProvider = 'LOCAL';\n private basePath: string;\n private baseUrl?: string;\n\n constructor(options: LocalStorageOptions) {\n this.basePath = options.basePath;\n this.baseUrl = options.baseUrl;\n }\n\n async upload(options: UploadOptions): Promise<StorageFile> {\n const fullPath = path.join(this.basePath, options.path);\n const dir = path.dirname(fullPath);\n\n // Ensure directory exists\n await fs.mkdir(dir, { recursive: true });\n\n // Write file\n const content =\n typeof options.content === 'string'\n ? Buffer.from(options.content, 'base64')\n : options.content;\n\n await fs.writeFile(fullPath, content);\n\n // Calculate checksum\n const checksum = crypto.createHash('sha256').update(content).digest('hex');\n\n return {\n path: options.path,\n size: content.length,\n mimeType: options.mimeType,\n checksum,\n metadata: options.metadata,\n };\n }\n\n async download(filePath: string): Promise<Buffer> {\n const fullPath = path.join(this.basePath, filePath);\n return fs.readFile(fullPath);\n }\n\n async delete(filePath: string): Promise<void> {\n const fullPath = path.join(this.basePath, filePath);\n await fs.unlink(fullPath);\n }\n\n async exists(filePath: string): Promise<boolean> {\n const fullPath = path.join(this.basePath, filePath);\n try {\n await fs.access(fullPath);\n return true;\n } catch {\n return false;\n }\n }\n\n async getMetadata(filePath: string): Promise<StorageFile \| null> {\n const fullPath = path.join(this.basePath, filePath);\n try {\n const stat = await fs.stat(fullPath);\n return {\n path: filePath,\n size: stat.size,\n mimeType: 'application/octet-stream', // Would need mime type detection\n };\n } catch {\n return null;\n }\n }\n\n async list(options?: ListOptions): Promise<ListResult> {\n const dir = options?.prefix\n ? path.join(this.basePath, options.prefix)\n : this.basePath;\n\n try {\n const entries = await fs.readdir(dir, { withFileTypes: true });\n const files: StorageFile[] = [];\n\n for (const entry of entries) {\n if (entry.isFile()) {\n const filePath = options?.prefix\n ? path.join(options.prefix, entry.name)\n : entry.name;\n const stat = await fs.stat(path.join(dir, entry.name));\n files.push({\n path: filePath,\n size: stat.size,\n mimeType: 'application/octet-stream',\n });\n }\n }\n\n const limit = options?.limit \|\| files.length;\n return {\n files: files.slice(0, limit),\n hasMore: files.length > limit,\n };\n } catch {\n return { files: [], hasMore: false };\n }\n }\n\n async createPresignedUpload(\n options: PresignedUploadOptions\n ): Promise<PresignedUrl> {\n // Local storage doesn't support real presigned URLs\n // Return a placeholder that would work with a local upload endpoint\n const expiresIn = options.expiresIn \|\| 3600;\n const expiresAt = new Date(Date.now() + expiresIn 1000);\n\n return {\n url: this.baseUrl\n ? `${this.baseUrl}/upload?path=${encodeURIComponent(options.path)}`\n : `/upload?path=${encodeURIComponent(options.path)}`,\n fields: {\n path: options.path,\n mimeType: options.mimeType,\n },\n expiresAt,\n };\n }\n\n async createPresignedDownload(\n options: PresignedDownloadOptions\n ): Promise<PresignedUrl> {\n const expiresIn = options.expiresIn \|\| 3600;\n const expiresAt = new Date(Date.now() + expiresIn * 1000);\n\n return {\n url: this.baseUrl\n ? `${this.baseUrl}/download/${options.path}`\n : `/download/${options.path}`,\n expiresAt,\n };\n }\n\n getPublicUrl(filePath: string): string \| null {\n if (!this.baseUrl) return null;\n return `${this.baseUrl}/${filePath}`;\n }\n\n async copy(\n sourcePath: string,\n destinationPath: string\n ): Promise<StorageFile> {\n const sourceFullPath = path.join(this.basePath, sourcePath);\n const destFullPath = path.join(this.basePath, destinationPath);\n const destDir = path.dirname(destFullPath);\n\n await fs.mkdir(destDir, { recursive: true });\n await fs.copyFile(sourceFullPath, destFullPath);\n\n const stat = await fs.stat(destFullPath);\n return {\n path: destinationPath,\n size: stat.size,\n mimeType: 'application/octet-stream',\n };\n }\n}\n\n// ============ S3 Storage Adapter Interface ============\n\nexport interface S3StorageOptions {\n /** S3 bucket name /\n bucket: string;\n /* AWS region /\n region: string;\n /* AWS access key ID /\n accessKeyId?: string;\n /* AWS secret access key /\n secretAccessKey?: string;\n /* Endpoint URL (for S3-compatible services) /\n endpoint?: string;\n /* Force path style (for S3-compatible services) /\n forcePathStyle?: boolean;\n /* Default ACL for uploads /\n defaultAcl?: 'private' \| 'public-read';\n}\n\n/\n S3 storage adapter interface.\n * Implementation would use AWS SDK or compatible client.\n \n This is a placeholder that defines the interface.\n * Actual implementation would require @aws-sdk/client-s3 dependency.\n /\nexport class S3StorageAdapter implements StorageAdapter {\n readonly provider: StorageProvider = 'S3';\n private config: S3StorageOptions;\n\n constructor(options: S3StorageOptions) {\n this.config = options;\n }\n\n async upload(options: UploadOptions): Promise<StorageFile> {\n // Placeholder - actual implementation would use S3 SDK\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the upload method.'\n );\n }\n\n async download(filePath: string): Promise<Buffer> {\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the download method.'\n );\n }\n\n async delete(filePath: string): Promise<void> {\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the delete method.'\n );\n }\n\n async exists(filePath: string): Promise<boolean> {\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the exists method.'\n );\n }\n\n async getMetadata(filePath: string): Promise<StorageFile \| null> {\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the getMetadata method.'\n );\n }\n\n async list(options?: ListOptions): Promise<ListResult> {\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the list method.'\n );\n }\n\n async createPresignedUpload(\n options: PresignedUploadOptions\n ): Promise<PresignedUrl> {\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the createPresignedUpload method.'\n );\n }\n\n async createPresignedDownload(\n options: PresignedDownloadOptions\n ): Promise<PresignedUrl> {\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the createPresignedDownload method.'\n );\n }\n\n getPublicUrl(filePath: string): string \| null {\n const { bucket, region, endpoint } = this.config;\n if (endpoint) {\n return `${endpoint}/${bucket}/${filePath}`;\n }\n return `https://${bucket}.s3.${region}.amazonaws.com/${filePath}`;\n }\n\n async copy(\n sourcePath: string,\n destinationPath: string\n ): Promise<StorageFile> {\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the copy method.'\n );\n }\n}\n\n// ============ In-Memory Storage Adapter ============\n\n/\n In-memory storage adapter for testing.\n /\nexport class InMemoryStorageAdapter implements StorageAdapter {\n readonly provider: StorageProvider = 'LOCAL';\n private files = new Map<string, { content: Buffer; metadata: StorageFile }>();\n\n async upload(options: UploadOptions): Promise<StorageFile> {\n const content =\n typeof options.content === 'string'\n ? Buffer.from(options.content, 'base64')\n : options.content;\n\n const checksum = crypto.createHash('sha256').update(content).digest('hex');\n\n const metadata: StorageFile = {\n path: options.path,\n size: content.length,\n mimeType: options.mimeType,\n checksum,\n metadata: options.metadata,\n };\n\n this.files.set(options.path, { content, metadata });\n return metadata;\n }\n\n async download(filePath: string): Promise<Buffer> {\n const file = this.files.get(filePath);\n if (!file) {\n throw new Error(`File not found: ${filePath}`);\n }\n return file.content;\n }\n\n async delete(filePath: string): Promise<void> {\n this.files.delete(filePath);\n }\n\n async exists(filePath: string): Promise<boolean> {\n return this.files.has(filePath);\n }\n\n async getMetadata(filePath: string): Promise<StorageFile \| null> {\n const file = this.files.get(filePath);\n return file?.metadata \|\| null;\n }\n\n async list(options?: ListOptions): Promise<ListResult> {\n const prefix = options?.prefix \|\| '';\n const files: StorageFile[] = [];\n\n for (const [path, file] of this.files) {\n if (path.startsWith(prefix)) {\n files.push(file.metadata);\n }\n }\n\n const limit = options?.limit \|\| files.length;\n return {\n files: files.slice(0, limit),\n hasMore: files.length > limit,\n };\n }\n\n async createPresignedUpload(\n options: PresignedUploadOptions\n ): Promise<PresignedUrl> {\n const expiresAt = new Date(Date.now() + (options.expiresIn \|\| 3600) 1000);\n return {\n url: `/upload?path=${encodeURIComponent(options.path)}`,\n fields: { path: options.path },\n expiresAt,\n };\n }\n\n async createPresignedDownload(\n options: PresignedDownloadOptions\n ): Promise<PresignedUrl> {\n const expiresAt = new Date(Date.now() + (options.expiresIn \|\| 3600) * 1000);\n return {\n url: `/download/${options.path}`,\n expiresAt,\n };\n }\n\n getPublicUrl(filePath: string): string \| null {\n return `/files/${filePath}`;\n }\n\n async copy(\n sourcePath: string,\n destinationPath: string\n ): Promise<StorageFile> {\n const source = this.files.get(sourcePath);\n if (!source) {\n throw new Error(`Source file not found: ${sourcePath}`);\n }\n\n const metadata: StorageFile = {\n ...source.metadata,\n path: destinationPath,\n };\n\n this.files.set(destinationPath, { content: source.content, metadata });\n return metadata;\n }\n\n clear(): void {\n this.files.clear();\n }\n}\n\n// ============ Factory ============\n\nexport interface StorageConfig {\n provider: StorageProvider;\n local?: LocalStorageOptions;\n s3?: S3StorageOptions;\n}\n\n/*\n Create a storage adapter based on configuration.\n */\nexport function createStorageAdapter(config: StorageConfig): StorageAdapter {\n switch (config.provider) {\n case 'LOCAL':\n if (!config.local) {\n throw new Error('Local storage configuration required');\n }\n return new LocalStorageAdapter(config.local);\n\n case 'S3':\n if (!config.s3) {\n throw new Error('S3 storage configuration required');\n }\n return new S3StorageAdapter(config.s3);\n\n default:\n throw new Error(`Unsupported storage provider: ${config.provider}`);\n }\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"index.js","names":["files: StorageFile[]","metadata: StorageFile","path"],"sources":["../../src/storage/index.ts"],"sourcesContent":["/*\n File storage adapters for different backends.\n /\n\n// ============ Types ============\n\nexport type StorageProvider = 'LOCAL' \| 'S3' \| 'GCS' \| 'AZURE' \| 'CLOUDFLARE';\n\nexport interface StorageFile {\n path: string;\n size: number;\n mimeType: string;\n checksum?: string;\n etag?: string;\n metadata?: Record<string, string>;\n}\n\nexport interface UploadOptions {\n /* Target path in storage /\n path: string;\n /* File content /\n content: Buffer \| string;\n /* MIME type /\n mimeType: string;\n /* Additional metadata /\n metadata?: Record<string, string>;\n /* Whether file should be publicly accessible /\n isPublic?: boolean;\n}\n\nexport interface PresignedUploadOptions {\n /* Target path in storage /\n path: string;\n /* MIME type /\n mimeType: string;\n /* File size in bytes /\n size: number;\n /* Expiration time in seconds /\n expiresIn?: number;\n /* Additional conditions /\n conditions?: Record<string, unknown>[];\n}\n\nexport interface PresignedDownloadOptions {\n /* File path in storage /\n path: string;\n /* Expiration time in seconds /\n expiresIn?: number;\n /* Response content disposition /\n contentDisposition?: string;\n}\n\nexport interface PresignedUrl {\n url: string;\n fields?: Record<string, string>;\n expiresAt: Date;\n}\n\nexport interface ListOptions {\n /* Path prefix /\n prefix?: string;\n /* Maximum results /\n limit?: number;\n /* Continuation token /\n cursor?: string;\n}\n\nexport interface ListResult {\n files: StorageFile[];\n cursor?: string;\n hasMore: boolean;\n}\n\n// ============ Storage Adapter Interface ============\n\nexport interface StorageAdapter {\n /* Storage provider type /\n readonly provider: StorageProvider;\n\n /\n Upload a file to storage.\n /\n upload(options: UploadOptions): Promise<StorageFile>;\n\n /\n Download a file from storage.\n /\n download(path: string): Promise<Buffer>;\n\n /\n Delete a file from storage.\n /\n delete(path: string): Promise<void>;\n\n /\n Check if a file exists.\n /\n exists(path: string): Promise<boolean>;\n\n /\n Get file metadata.\n /\n getMetadata(path: string): Promise<StorageFile \| null>;\n\n /\n List files in a directory.\n /\n list(options?: ListOptions): Promise<ListResult>;\n\n /\n Generate a presigned URL for uploading.\n /\n createPresignedUpload(options: PresignedUploadOptions): Promise<PresignedUrl>;\n\n /\n Generate a presigned URL for downloading.\n /\n createPresignedDownload(\n options: PresignedDownloadOptions\n ): Promise<PresignedUrl>;\n\n /\n Get public URL for a file (if applicable).\n /\n getPublicUrl(path: string): string \| null;\n\n /\n Copy a file within storage.\n /\n copy(sourcePath: string, destinationPath: string): Promise<StorageFile>;\n}\n\n// ============ Local Storage Adapter ============\n\nimport as fs from 'node:fs/promises';\nimport * as path from 'node:path';\nimport * as crypto from 'node:crypto';\n\nexport interface LocalStorageOptions {\n /** Base directory for file storage /\n basePath: string;\n /* Base URL for serving files (optional) /\n baseUrl?: string;\n}\n\n/\n Local filesystem storage adapter.\n * For development and testing purposes.\n /\nexport class LocalStorageAdapter implements StorageAdapter {\n readonly provider: StorageProvider = 'LOCAL';\n private basePath: string;\n private baseUrl?: string;\n\n constructor(options: LocalStorageOptions) {\n this.basePath = options.basePath;\n this.baseUrl = options.baseUrl;\n }\n\n async upload(options: UploadOptions): Promise<StorageFile> {\n const fullPath = path.join(this.basePath, options.path);\n const dir = path.dirname(fullPath);\n\n // Ensure directory exists\n await fs.mkdir(dir, { recursive: true });\n\n // Write file\n const content =\n typeof options.content === 'string'\n ? Buffer.from(options.content, 'base64')\n : options.content;\n\n await fs.writeFile(fullPath, content);\n\n // Calculate checksum\n const checksum = crypto.createHash('sha256').update(content).digest('hex');\n\n return {\n path: options.path,\n size: content.length,\n mimeType: options.mimeType,\n checksum,\n metadata: options.metadata,\n };\n }\n\n async download(filePath: string): Promise<Buffer> {\n const fullPath = path.join(this.basePath, filePath);\n return fs.readFile(fullPath);\n }\n\n async delete(filePath: string): Promise<void> {\n const fullPath = path.join(this.basePath, filePath);\n await fs.unlink(fullPath);\n }\n\n async exists(filePath: string): Promise<boolean> {\n const fullPath = path.join(this.basePath, filePath);\n try {\n await fs.access(fullPath);\n return true;\n } catch {\n return false;\n }\n }\n\n async getMetadata(filePath: string): Promise<StorageFile \| null> {\n const fullPath = path.join(this.basePath, filePath);\n try {\n const stat = await fs.stat(fullPath);\n return {\n path: filePath,\n size: stat.size,\n mimeType: 'application/octet-stream', // Would need mime type detection\n };\n } catch {\n return null;\n }\n }\n\n async list(options?: ListOptions): Promise<ListResult> {\n const dir = options?.prefix\n ? path.join(this.basePath, options.prefix)\n : this.basePath;\n\n try {\n const entries = await fs.readdir(dir, { withFileTypes: true });\n const files: StorageFile[] = [];\n\n for (const entry of entries) {\n if (entry.isFile()) {\n const filePath = options?.prefix\n ? path.join(options.prefix, entry.name)\n : entry.name;\n const stat = await fs.stat(path.join(dir, entry.name));\n files.push({\n path: filePath,\n size: stat.size,\n mimeType: 'application/octet-stream',\n });\n }\n }\n\n const limit = options?.limit \|\| files.length;\n return {\n files: files.slice(0, limit),\n hasMore: files.length > limit,\n };\n } catch {\n return { files: [], hasMore: false };\n }\n }\n\n async createPresignedUpload(\n options: PresignedUploadOptions\n ): Promise<PresignedUrl> {\n // Local storage doesn't support real presigned URLs\n // Return a placeholder that would work with a local upload endpoint\n const expiresIn = options.expiresIn \|\| 3600;\n const expiresAt = new Date(Date.now() + expiresIn 1000);\n\n return {\n url: this.baseUrl\n ? `${this.baseUrl}/upload?path=${encodeURIComponent(options.path)}`\n : `/upload?path=${encodeURIComponent(options.path)}`,\n fields: {\n path: options.path,\n mimeType: options.mimeType,\n },\n expiresAt,\n };\n }\n\n async createPresignedDownload(\n options: PresignedDownloadOptions\n ): Promise<PresignedUrl> {\n const expiresIn = options.expiresIn \|\| 3600;\n const expiresAt = new Date(Date.now() + expiresIn * 1000);\n\n return {\n url: this.baseUrl\n ? `${this.baseUrl}/download/${options.path}`\n : `/download/${options.path}`,\n expiresAt,\n };\n }\n\n getPublicUrl(filePath: string): string \| null {\n if (!this.baseUrl) return null;\n return `${this.baseUrl}/${filePath}`;\n }\n\n async copy(\n sourcePath: string,\n destinationPath: string\n ): Promise<StorageFile> {\n const sourceFullPath = path.join(this.basePath, sourcePath);\n const destFullPath = path.join(this.basePath, destinationPath);\n const destDir = path.dirname(destFullPath);\n\n await fs.mkdir(destDir, { recursive: true });\n await fs.copyFile(sourceFullPath, destFullPath);\n\n const stat = await fs.stat(destFullPath);\n return {\n path: destinationPath,\n size: stat.size,\n mimeType: 'application/octet-stream',\n };\n }\n}\n\n// ============ S3 Storage Adapter Interface ============\n\nexport interface S3StorageOptions {\n /** S3 bucket name /\n bucket: string;\n /* AWS region /\n region: string;\n /* AWS access key ID /\n accessKeyId?: string;\n /* AWS secret access key /\n secretAccessKey?: string;\n /* Endpoint URL (for S3-compatible services) /\n endpoint?: string;\n /* Force path style (for S3-compatible services) /\n forcePathStyle?: boolean;\n /* Default ACL for uploads /\n defaultAcl?: 'private' \| 'public-read';\n}\n\n/\n S3 storage adapter interface.\n * Implementation would use AWS SDK or compatible client.\n \n This is a placeholder that defines the interface.\n * Actual implementation would require @aws-sdk/client-s3 dependency.\n /\nexport class S3StorageAdapter implements StorageAdapter {\n readonly provider: StorageProvider = 'S3';\n private config: S3StorageOptions;\n\n constructor(options: S3StorageOptions) {\n this.config = options;\n }\n\n async upload(_options: UploadOptions): Promise<StorageFile> {\n // Placeholder - actual implementation would use S3 SDK\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the upload method.'\n );\n }\n\n async download(_filePath: string): Promise<Buffer> {\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the download method.'\n );\n }\n\n async delete(_filePath: string): Promise<void> {\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the delete method.'\n );\n }\n\n async exists(_filePath: string): Promise<boolean> {\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the exists method.'\n );\n }\n\n async getMetadata(_filePath: string): Promise<StorageFile \| null> {\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the getMetadata method.'\n );\n }\n\n async list(_options?: ListOptions): Promise<ListResult> {\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the list method.'\n );\n }\n\n async createPresignedUpload(\n _options: PresignedUploadOptions\n ): Promise<PresignedUrl> {\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the createPresignedUpload method.'\n );\n }\n\n async createPresignedDownload(\n _options: PresignedDownloadOptions\n ): Promise<PresignedUrl> {\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the createPresignedDownload method.'\n );\n }\n\n getPublicUrl(filePath: string): string \| null {\n const { bucket, region, endpoint } = this.config;\n if (endpoint) {\n return `${endpoint}/${bucket}/${filePath}`;\n }\n return `https://${bucket}.s3.${region}.amazonaws.com/${filePath}`;\n }\n\n async copy(\n _sourcePath: string,\n _destinationPath: string\n ): Promise<StorageFile> {\n throw new Error(\n 'S3 adapter requires @aws-sdk/client-s3. Install it and implement the copy method.'\n );\n }\n}\n\n// ============ In-Memory Storage Adapter ============\n\n/\n In-memory storage adapter for testing.\n /\nexport class InMemoryStorageAdapter implements StorageAdapter {\n readonly provider: StorageProvider = 'LOCAL';\n private files = new Map<string, { content: Buffer; metadata: StorageFile }>();\n\n async upload(options: UploadOptions): Promise<StorageFile> {\n const content =\n typeof options.content === 'string'\n ? Buffer.from(options.content, 'base64')\n : options.content;\n\n const checksum = crypto.createHash('sha256').update(content).digest('hex');\n\n const metadata: StorageFile = {\n path: options.path,\n size: content.length,\n mimeType: options.mimeType,\n checksum,\n metadata: options.metadata,\n };\n\n this.files.set(options.path, { content, metadata });\n return metadata;\n }\n\n async download(filePath: string): Promise<Buffer> {\n const file = this.files.get(filePath);\n if (!file) {\n throw new Error(`File not found: ${filePath}`);\n }\n return file.content;\n }\n\n async delete(filePath: string): Promise<void> {\n this.files.delete(filePath);\n }\n\n async exists(filePath: string): Promise<boolean> {\n return this.files.has(filePath);\n }\n\n async getMetadata(filePath: string): Promise<StorageFile \| null> {\n const file = this.files.get(filePath);\n return file?.metadata \|\| null;\n }\n\n async list(options?: ListOptions): Promise<ListResult> {\n const prefix = options?.prefix \|\| '';\n const files: StorageFile[] = [];\n\n for (const [path, file] of this.files) {\n if (path.startsWith(prefix)) {\n files.push(file.metadata);\n }\n }\n\n const limit = options?.limit \|\| files.length;\n return {\n files: files.slice(0, limit),\n hasMore: files.length > limit,\n };\n }\n\n async createPresignedUpload(\n options: PresignedUploadOptions\n ): Promise<PresignedUrl> {\n const expiresAt = new Date(Date.now() + (options.expiresIn \|\| 3600) 1000);\n return {\n url: `/upload?path=${encodeURIComponent(options.path)}`,\n fields: { path: options.path },\n expiresAt,\n };\n }\n\n async createPresignedDownload(\n options: PresignedDownloadOptions\n ): Promise<PresignedUrl> {\n const expiresAt = new Date(Date.now() + (options.expiresIn \|\| 3600) * 1000);\n return {\n url: `/download/${options.path}`,\n expiresAt,\n };\n }\n\n getPublicUrl(filePath: string): string \| null {\n return `/files/${filePath}`;\n }\n\n async copy(\n sourcePath: string,\n destinationPath: string\n ): Promise<StorageFile> {\n const source = this.files.get(sourcePath);\n if (!source) {\n throw new Error(`Source file not found: ${sourcePath}`);\n }\n\n const metadata: StorageFile = {\n ...source.metadata,\n path: destinationPath,\n };\n\n this.files.set(destinationPath, { content: source.content, metadata });\n return metadata;\n }\n\n clear(): void {\n this.files.clear();\n }\n}\n\n// ============ Factory ============\n\nexport interface StorageConfig {\n provider: StorageProvider;\n local?: LocalStorageOptions;\n s3?: S3StorageOptions;\n}\n\n/*\n Create a storage adapter based on configuration.\n */\nexport function createStorageAdapter(config: StorageConfig): StorageAdapter {\n switch (config.provider) {\n case 'LOCAL':\n if (!config.local) {\n throw new Error('Local storage configuration required');\n }\n return new LocalStorageAdapter(config.local);\n\n case 'S3':\n if (!config.s3) {\n throw new Error('S3 storage configuration required');\n }\n return new S3StorageAdapter(config.s3);\n\n default:\n throw new Error(`Unsupported storage provider: ${config.provider}`);\n }\n}\n"],"mappings":";;;;;;;;;AAqJA,IAAa,sBAAb,MAA2D;CACzD,AAAS,WAA4B;CACrC,AAAQ;CACR,AAAQ;CAER,YAAY,SAA8B;AACxC,OAAK,WAAW,QAAQ;AACxB,OAAK,UAAU,QAAQ;;CAGzB,MAAM,OAAO,SAA8C;EACzD,MAAM,WAAW,KAAK,KAAK,KAAK,UAAU,QAAQ,KAAK;EACvD,MAAM,MAAM,KAAK,QAAQ,SAAS;AAGlC,QAAM,GAAG,MAAM,KAAK,EAAE,WAAW,MAAM,CAAC;EAGxC,MAAM,UACJ,OAAO,QAAQ,YAAY,WACvB,OAAO,KAAK,QAAQ,SAAS,SAAS,GACtC,QAAQ;AAEd,QAAM,GAAG,UAAU,UAAU,QAAQ;EAGrC,MAAM,WAAW,OAAO,WAAW,SAAS,CAAC,OAAO,QAAQ,CAAC,OAAO,MAAM;AAE1E,SAAO;GACL,MAAM,QAAQ;GACd,MAAM,QAAQ;GACd,UAAU,QAAQ;GAClB;GACA,UAAU,QAAQ;GACnB;;CAGH,MAAM,SAAS,UAAmC;EAChD,MAAM,WAAW,KAAK,KAAK,KAAK,UAAU,SAAS;AACnD,SAAO,GAAG,SAAS,SAAS;;CAG9B,MAAM,OAAO,UAAiC;EAC5C,MAAM,WAAW,KAAK,KAAK,KAAK,UAAU,SAAS;AACnD,QAAM,GAAG,OAAO,SAAS;;CAG3B,MAAM,OAAO,UAAoC;EAC/C,MAAM,WAAW,KAAK,KAAK,KAAK,UAAU,SAAS;AACnD,MAAI;AACF,SAAM,GAAG,OAAO,SAAS;AACzB,UAAO;UACD;AACN,UAAO;;;CAIX,MAAM,YAAY,UAA+C;EAC/D,MAAM,WAAW,KAAK,KAAK,KAAK,UAAU,SAAS;AACnD,MAAI;AAEF,UAAO;IACL,MAAM;IACN,OAHW,MAAM,GAAG,KAAK,SAAS,EAGvB;IACX,UAAU;IACX;UACK;AACN,UAAO;;;CAIX,MAAM,KAAK,SAA4C;EACrD,MAAM,MAAM,SAAS,SACjB,KAAK,KAAK,KAAK,UAAU,QAAQ,OAAO,GACxC,KAAK;AAET,MAAI;GACF,MAAM,UAAU,MAAM,GAAG,QAAQ,KAAK,EAAE,eAAe,MAAM,CAAC;GAC9D,MAAMA,QAAuB,EAAE;AAE/B,QAAK,MAAM,SAAS,QAClB,KAAI,MAAM,QAAQ,EAAE;IAClB,MAAM,WAAW,SAAS,SACtB,KAAK,KAAK,QAAQ,QAAQ,MAAM,KAAK,GACrC,MAAM;IACV,MAAM,OAAO,MAAM,GAAG,KAAK,KAAK,KAAK,KAAK,MAAM,KAAK,CAAC;AACtD,UAAM,KAAK;KACT,MAAM;KACN,MAAM,KAAK;KACX,UAAU;KACX,CAAC;;GAIN,MAAM,QAAQ,SAAS,SAAS,MAAM;AACtC,UAAO;IACL,OAAO,MAAM,MAAM,GAAG,MAAM;IAC5B,SAAS,MAAM,SAAS;IACzB;UACK;AACN,UAAO;IAAE,OAAO,EAAE;IAAE,SAAS;IAAO;;;CAIxC,MAAM,sBACJ,SACuB;EAGvB,MAAM,YAAY,QAAQ,aAAa;EACvC,MAAM,YAAY,IAAI,KAAK,KAAK,KAAK,GAAG,YAAY,IAAK;AAEzD,SAAO;GACL,KAAK,KAAK,UACN,GAAG,KAAK,QAAQ,eAAe,mBAAmB,QAAQ,KAAK,KAC/D,gBAAgB,mBAAmB,QAAQ,KAAK;GACpD,QAAQ;IACN,MAAM,QAAQ;IACd,UAAU,QAAQ;IACnB;GACD;GACD;;CAGH,MAAM,wBACJ,SACuB;EACvB,MAAM,YAAY,QAAQ,aAAa;EACvC,MAAM,YAAY,IAAI,KAAK,KAAK,KAAK,GAAG,YAAY,IAAK;AAEzD,SAAO;GACL,KAAK,KAAK,UACN,GAAG,KAAK,QAAQ,YAAY,QAAQ,SACpC,aAAa,QAAQ;GACzB;GACD;;CAGH,aAAa,UAAiC;AAC5C,MAAI,CAAC,KAAK,QAAS,QAAO;AAC1B,SAAO,GAAG,KAAK,QAAQ,GAAG;;CAG5B,MAAM,KACJ,YACA,iBACsB;EACtB,MAAM,iBAAiB,KAAK,KAAK,KAAK,UAAU,WAAW;EAC3D,MAAM,eAAe,KAAK,KAAK,KAAK,UAAU,gBAAgB;EAC9D,MAAM,UAAU,KAAK,QAAQ,aAAa;AAE1C,QAAM,GAAG,MAAM,SAAS,EAAE,WAAW,MAAM,CAAC;AAC5C,QAAM,GAAG,SAAS,gBAAgB,aAAa;AAG/C,SAAO;GACL,MAAM;GACN,OAHW,MAAM,GAAG,KAAK,aAAa,EAG3B;GACX,UAAU;GACX;;;;;;;;;;AA8BL,IAAa,mBAAb,MAAwD;CACtD,AAAS,WAA4B;CACrC,AAAQ;CAER,YAAY,SAA2B;AACrC,OAAK,SAAS;;CAGhB,MAAM,OAAO,UAA+C;AAE1D,QAAM,IAAI,MACR,sFACD;;CAGH,MAAM,SAAS,WAAoC;AACjD,QAAM,IAAI,MACR,wFACD;;CAGH,MAAM,OAAO,WAAkC;AAC7C,QAAM,IAAI,MACR,sFACD;;CAGH,MAAM,OAAO,WAAqC;AAChD,QAAM,IAAI,MACR,sFACD;;CAGH,MAAM,YAAY,WAAgD;AAChE,QAAM,IAAI,MACR,2FACD;;CAGH,MAAM,KAAK,UAA6C;AACtD,QAAM,IAAI,MACR,oFACD;;CAGH,MAAM,sBACJ,UACuB;AACvB,QAAM,IAAI,MACR,qGACD;;CAGH,MAAM,wBACJ,UACuB;AACvB,QAAM,IAAI,MACR,uGACD;;CAGH,aAAa,UAAiC;EAC5C,MAAM,EAAE,QAAQ,QAAQ,aAAa,KAAK;AAC1C,MAAI,SACF,QAAO,GAAG,SAAS,GAAG,OAAO,GAAG;AAElC,SAAO,WAAW,OAAO,MAAM,OAAO,iBAAiB;;CAGzD,MAAM,KACJ,aACA,kBACsB;AACtB,QAAM,IAAI,MACR,oFACD;;;;;;AASL,IAAa,yBAAb,MAA8D;CAC5D,AAAS,WAA4B;CACrC,AAAQ,wBAAQ,IAAI,KAAyD;CAE7E,MAAM,OAAO,SAA8C;EACzD,MAAM,UACJ,OAAO,QAAQ,YAAY,WACvB,OAAO,KAAK,QAAQ,SAAS,SAAS,GACtC,QAAQ;EAEd,MAAM,WAAW,OAAO,WAAW,SAAS,CAAC,OAAO,QAAQ,CAAC,OAAO,MAAM;EAE1E,MAAMC,WAAwB;GAC5B,MAAM,QAAQ;GACd,MAAM,QAAQ;GACd,UAAU,QAAQ;GAClB;GACA,UAAU,QAAQ;GACnB;AAED,OAAK,MAAM,IAAI,QAAQ,MAAM;GAAE;GAAS;GAAU,CAAC;AACnD,SAAO;;CAGT,MAAM,SAAS,UAAmC;EAChD,MAAM,OAAO,KAAK,MAAM,IAAI,SAAS;AACrC,MAAI,CAAC,KACH,OAAM,IAAI,MAAM,mBAAmB,WAAW;AAEhD,SAAO,KAAK;;CAGd,MAAM,OAAO,UAAiC;AAC5C,OAAK,MAAM,OAAO,SAAS;;CAG7B,MAAM,OAAO,UAAoC;AAC/C,SAAO,KAAK,MAAM,IAAI,SAAS;;CAGjC,MAAM,YAAY,UAA+C;AAE/D,SADa,KAAK,MAAM,IAAI,SAAS,EACxB,YAAY;;CAG3B,MAAM,KAAK,SAA4C;EACrD,MAAM,SAAS,SAAS,UAAU;EAClC,MAAMD,QAAuB,EAAE;AAE/B,OAAK,MAAM,CAACE,QAAM,SAAS,KAAK,MAC9B,KAAIA,OAAK,WAAW,OAAO,CACzB,OAAM,KAAK,KAAK,SAAS;EAI7B,MAAM,QAAQ,SAAS,SAAS,MAAM;AACtC,SAAO;GACL,OAAO,MAAM,MAAM,GAAG,MAAM;GAC5B,SAAS,MAAM,SAAS;GACzB;;CAGH,MAAM,sBACJ,SACuB;EACvB,MAAM,YAAY,IAAI,KAAK,KAAK,KAAK,IAAI,QAAQ,aAAa,QAAQ,IAAK;AAC3E,SAAO;GACL,KAAK,gBAAgB,mBAAmB,QAAQ,KAAK;GACrD,QAAQ,EAAE,MAAM,QAAQ,MAAM;GAC9B;GACD;;CAGH,MAAM,wBACJ,SACuB;EACvB,MAAM,YAAY,IAAI,KAAK,KAAK,KAAK,IAAI,QAAQ,aAAa,QAAQ,IAAK;AAC3E,SAAO;GACL,KAAK,aAAa,QAAQ;GAC1B;GACD;;CAGH,aAAa,UAAiC;AAC5C,SAAO,UAAU;;CAGnB,MAAM,KACJ,YACA,iBACsB;EACtB,MAAM,SAAS,KAAK,MAAM,IAAI,WAAW;AACzC,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,0BAA0B,aAAa;EAGzD,MAAMD,WAAwB;GAC5B,GAAG,OAAO;GACV,MAAM;GACP;AAED,OAAK,MAAM,IAAI,iBAAiB;GAAE,SAAS,OAAO;GAAS;GAAU,CAAC;AACtE,SAAO;;CAGT,QAAc;AACZ,OAAK,MAAM,OAAO;;;;;;AAetB,SAAgB,qBAAqB,QAAuC;AAC1E,SAAQ,OAAO,UAAf;EACE,KAAK;AACH,OAAI,CAAC,OAAO,MACV,OAAM,IAAI,MAAM,uCAAuC;AAEzD,UAAO,IAAI,oBAAoB,OAAO,MAAM;EAE9C,KAAK;AACH,OAAI,CAAC,OAAO,GACV,OAAM,IAAI,MAAM,oCAAoC;AAEtD,UAAO,IAAI,iBAAiB,OAAO,GAAG;EAExC,QACE,OAAM,IAAI,MAAM,iCAAiC,OAAO,WAAW"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.files",
-  "version": "0.0.0-canary-20251219202229",
+  "version": "0.0.0-canary-20251220002821",
   "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-20251219202229",
-    "@lssm/lib.contracts": "0.0.0-canary-20251219202229",
+    "@lssm/lib.schema": "0.0.0-canary-20251220002821",
+    "@lssm/lib.contracts": "0.0.0-canary-20251220002821",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.typescript": "0.0.0-canary-20251219202229",
-    "@lssm/tool.tsdown": "0.0.0-canary-20251219202229",
+    "@lssm/tool.typescript": "0.0.0-canary-20251220002821",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251220002821",
     "typescript": "^5.9.3"
   },
   "exports": {
@@ -55,7 +55,13 @@
       "./files.feature": "./dist/files.feature.js",
       "./storage": "./dist/storage/index.js",
       "./*": "./*"
-    }
+    },
+    "registry": "https://registry.npmjs.org/"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/libs/files"
+  }
 }