@zs-soft/storage-engine 0.10.0

package/README.md

@@ -0,0 +1,64 @@
+# StorageEngine
+
+This project was generated using [Angular CLI](https://github.com/angular/angular-cli) version 21.0.0.
+
+## Code scaffolding
+
+Angular CLI includes powerful code scaffolding tools. To generate a new component, run:
+
+```bash
+ng generate component component-name
+```
+
+For a complete list of available schematics (such as `components`, `directives`, or `pipes`), run:
+
+```bash
+ng generate --help
+```
+
+## Building
+
+To build the library, run:
+
+```bash
+ng build storage-engine
+```
+
+This command will compile your project, and the build artifacts will be placed in the `dist/` directory.
+
+### Publishing the Library
+
+Once the project is built, you can publish your library by following these steps:
+
+1. Navigate to the `dist` directory:
+
+   ```bash
+   cd dist/storage-engine
+   ```
+
+2. Run the `npm publish` command to publish your library to the npm registry:
+   ```bash
+   npm publish
+   ```
+
+## Running unit tests
+
+To execute unit tests with the [Karma](https://karma-runner.github.io) test runner, use the following command:
+
+```bash
+ng test
+```
+
+## Running end-to-end tests
+
+For end-to-end (e2e) testing, run:
+
+```bash
+ng e2e
+```
+
+Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs.
+
+## Additional Resources
+
+For more information on using the Angular CLI, including detailed command references, visit the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.

package/fesm2022/zs-soft-storage-engine.mjs

@@ -0,0 +1,71 @@
+import * as i0 from '@angular/core';
+import { inject, Injectable } from '@angular/core';
+import { StorageEngine } from '@zs-soft/core-api';
+
+class Storage {
+    engine = inject(StorageEngine);
+    upload(path, file, options) {
+        return this.engine.upload(path, file, options);
+    }
+    download(path) {
+        return this.engine.download(path);
+    }
+    getDownloadUrl(path) {
+        return this.engine.getDownloadUrl(path);
+    }
+    getMetadata(path) {
+        return this.engine.getMetadata(path);
+    }
+    list(path, options) {
+        return this.engine.list(path, options);
+    }
+    delete(path, options) {
+        return this.engine.delete(path, options);
+    }
+    exists(path) {
+        return this.engine.exists(path);
+    }
+    copy(sourcePath, destinationPath) {
+        return this.engine.copy(sourcePath, destinationPath);
+    }
+    move(sourcePath, destinationPath) {
+        return this.engine.move(sourcePath, destinationPath);
+    }
+    /**
+     * Generate a safe file path with timestamp and random suffix
+     */
+    generatePath(folder, fileName) {
+        const timestamp = Date.now();
+        const randomSuffix = Math.random().toString(36).substring(2, 8);
+        const sanitizedName = fileName.replace(/[^a-zA-Z0-9.-]/g, '_');
+        return `${folder}/${timestamp}_${randomSuffix}_${sanitizedName}`;
+    }
+    /**
+     * Validate file before upload
+     */
+    validateFile(file, allowedTypes, maxSizeBytes) {
+        if (allowedTypes && !allowedTypes.includes(file.type)) {
+            throw new Error(`File type ${file.type} not allowed. Allowed: ${allowedTypes.join(', ')}`);
+        }
+        if (maxSizeBytes && file.size > maxSizeBytes) {
+            throw new Error(`File size ${file.size} exceeds maximum ${maxSizeBytes} bytes`);
+        }
+        return true;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.0.8", ngImport: i0, type: Storage, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.0.8", ngImport: i0, type: Storage });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.0.8", ngImport: i0, type: Storage, decorators: [{
+            type: Injectable
+        }] });
+
+/*
+ * Public API Surface of storage-engine
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { Storage };
+//# sourceMappingURL=zs-soft-storage-engine.mjs.map

package/fesm2022/zs-soft-storage-engine.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"zs-soft-storage-engine.mjs","sources":["../../../projects/storage-engine/src/lib/storage.ts","../../../projects/storage-engine/src/public-api.ts","../../../projects/storage-engine/src/zs-soft-storage-engine.ts"],"sourcesContent":["import { Observable } from 'rxjs';\n\nimport { inject, Injectable } from '@angular/core';\nimport {\n  StorageDeleteOptions,\n  StorageEngine,\n  StorageFile,\n  StorageListOptions,\n  StorageListResult,\n  StorageUploadOptions,\n} from '@zs-soft/core-api';\n\n@Injectable()\nexport class Storage {\n  private readonly engine = inject<StorageEngine>(StorageEngine);\n\n  upload(path: string, file: File | Blob, options?: StorageUploadOptions): Observable<StorageFile> {\n    return this.engine.upload(path, file, options);\n  }\n\n  download(path: string): Observable<Blob> {\n    return this.engine.download(path);\n  }\n\n  getDownloadUrl(path: string): Observable<string> {\n    return this.engine.getDownloadUrl(path);\n  }\n\n  getMetadata(path: string): Observable<StorageFile> {\n    return this.engine.getMetadata(path);\n  }\n\n  list(path: string, options?: StorageListOptions): Observable<StorageListResult> {\n    return this.engine.list(path, options);\n  }\n\n  delete(path: string, options?: StorageDeleteOptions): Observable<void> {\n    return this.engine.delete(path, options);\n  }\n\n  exists(path: string): Observable<boolean> {\n    return this.engine.exists(path);\n  }\n\n  copy(sourcePath: string, destinationPath: string): Observable<StorageFile> {\n    return this.engine.copy(sourcePath, destinationPath);\n  }\n\n  move(sourcePath: string, destinationPath: string): Observable<StorageFile> {\n    return this.engine.move(sourcePath, destinationPath);\n  }\n\n  /**\n   * Generate a safe file path with timestamp and random suffix\n   */\n  generatePath(folder: string, fileName: string): string {\n    const timestamp = Date.now();\n    const randomSuffix = Math.random().toString(36).substring(2, 8);\n    const sanitizedName = fileName.replace(/[^a-zA-Z0-9.-]/g, '_');\n    return `${folder}/${timestamp}_${randomSuffix}_${sanitizedName}`;\n  }\n\n  /**\n   * Validate file before upload\n   */\n  validateFile(file: File, allowedTypes?: string[], maxSizeBytes?: number): boolean {\n    if (allowedTypes && !allowedTypes.includes(file.type)) {\n      throw new Error(`File type ${file.type} not allowed. Allowed: ${allowedTypes.join(', ')}`);\n    }\n\n    if (maxSizeBytes && file.size > maxSizeBytes) {\n      throw new Error(`File size ${file.size} exceeds maximum ${maxSizeBytes} bytes`);\n    }\n\n    return true;\n  }\n}\n","/*\n * Public API Surface of storage-engine\n */\n\nexport * from './lib/storage';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;MAaa,OAAO,CAAA;AACD,IAAA,MAAM,GAAG,MAAM,CAAgB,aAAa,CAAC;AAE9D,IAAA,MAAM,CAAC,IAAY,EAAE,IAAiB,EAAE,OAA8B,EAAA;AACpE,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC;IAChD;AAEA,IAAA,QAAQ,CAAC,IAAY,EAAA;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;IACnC;AAEA,IAAA,cAAc,CAAC,IAAY,EAAA;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC;IACzC;AAEA,IAAA,WAAW,CAAC,IAAY,EAAA;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC;IACtC;IAEA,IAAI,CAAC,IAAY,EAAE,OAA4B,EAAA;QAC7C,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;IACxC;IAEA,MAAM,CAAC,IAAY,EAAE,OAA8B,EAAA;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC;IAC1C;AAEA,IAAA,MAAM,CAAC,IAAY,EAAA;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;IACjC;IAEA,IAAI,CAAC,UAAkB,EAAE,eAAuB,EAAA;QAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC;IACtD;IAEA,IAAI,CAAC,UAAkB,EAAE,eAAuB,EAAA;QAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC;IACtD;AAEA;;AAEG;IACH,YAAY,CAAC,MAAc,EAAE,QAAgB,EAAA;AAC3C,QAAA,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE;AAC5B,QAAA,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/D,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;QAC9D,OAAO,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,SAAS,IAAI,YAAY,CAAA,CAAA,EAAI,aAAa,CAAA,CAAE;IAClE;AAEA;;AAEG;AACH,IAAA,YAAY,CAAC,IAAU,EAAE,YAAuB,EAAE,YAAqB,EAAA;AACrE,QAAA,IAAI,YAAY,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;AACrD,YAAA,MAAM,IAAI,KAAK,CAAC,CAAA,UAAA,EAAa,IAAI,CAAC,IAAI,CAAA,uBAAA,EAA0B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE,CAAC;QAC5F;QAEA,IAAI,YAAY,IAAI,IAAI,CAAC,IAAI,GAAG,YAAY,EAAE;YAC5C,MAAM,IAAI,KAAK,CAAC,CAAA,UAAA,EAAa,IAAI,CAAC,IAAI,CAAA,iBAAA,EAAoB,YAAY,CAAA,MAAA,CAAQ,CAAC;QACjF;AAEA,QAAA,OAAO,IAAI;IACb;uGA9DW,OAAO,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA;2GAAP,OAAO,EAAA,CAAA;;2FAAP,OAAO,EAAA,UAAA,EAAA,CAAA;kBADnB;;;ACZD;;AAEG;;ACFH;;AAEG;;;;"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@zs-soft/storage-engine",
+  "version": "0.10.0",
+  "description": "Abstract storage service for Angular applications",
+  "author": "zssz-soft",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zssz-soft/libraries.git",
+    "directory": "projects/storage-engine"
+  },
+  "homepage": "https://github.com/zssz-soft/libraries/tree/main/projects/storage-engine",
+  "bugs": {
+    "url": "https://github.com/zssz-soft/libraries/issues"
+  },
+  "keywords": [
+    "angular",
+    "storage"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@angular/common": "^21.2.0",
+    "@angular/core": "^21.2.0",
+    "@zs-soft/core-api": "^0.10.0",
+    "rxjs": "^7.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "sideEffects": false,
+  "tags": [
+    "type:engine",
+    "scope:shared"
+  ],
+  "module": "fesm2022/zs-soft-storage-engine.mjs",
+  "typings": "types/zs-soft-storage-engine.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/zs-soft-storage-engine.d.ts",
+      "default": "./fesm2022/zs-soft-storage-engine.mjs"
+    }
+  }
+}

package/types/zs-soft-storage-engine.d.ts

@@ -0,0 +1,28 @@
+import { Observable } from 'rxjs';
+import { StorageUploadOptions, StorageFile, StorageListOptions, StorageListResult, StorageDeleteOptions } from '@zs-soft/core-api';
+import * as i0 from '@angular/core';
+
+declare class Storage {
+    private readonly engine;
+    upload(path: string, file: File | Blob, options?: StorageUploadOptions): Observable<StorageFile>;
+    download(path: string): Observable<Blob>;
+    getDownloadUrl(path: string): Observable<string>;
+    getMetadata(path: string): Observable<StorageFile>;
+    list(path: string, options?: StorageListOptions): Observable<StorageListResult>;
+    delete(path: string, options?: StorageDeleteOptions): Observable<void>;
+    exists(path: string): Observable<boolean>;
+    copy(sourcePath: string, destinationPath: string): Observable<StorageFile>;
+    move(sourcePath: string, destinationPath: string): Observable<StorageFile>;
+    /**
+     * Generate a safe file path with timestamp and random suffix
+     */
+    generatePath(folder: string, fileName: string): string;
+    /**
+     * Validate file before upload
+     */
+    validateFile(file: File, allowedTypes?: string[], maxSizeBytes?: number): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<Storage, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<Storage>;
+}
+
+export { Storage };