@venturialstd/file-system 0.0.1

package/dist/settings/file-system.settings.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SETTINGS = exports.FILE_SYSTEM_SETTINGS = void 0;
+const core_1 = require("@venturialstd/core");
+const file_system_provider_constant_1 = require("../constants/file-system-provider.constant");
+exports.FILE_SYSTEM_SETTINGS = [
+    {
+        scope: 'GLOBAL',
+        module: 'FILE-SYSTEM',
+        section: 'GENERAL',
+        key: 'PROVIDER',
+        label: 'File system storage provider',
+        description: 'Storage provider for file-system operations (e.g. Backblaze B2)',
+        type: core_1.SETTINGS_TYPE.SELECT,
+        value: file_system_provider_constant_1.FileSystemProviderName.BACKBLAZE,
+        options: [
+            { label: 'Backblaze B2', value: file_system_provider_constant_1.FileSystemProviderName.BACKBLAZE },
+        ],
+        sortOrder: 1,
+    },
+    {
+        scope: 'GLOBAL',
+        module: 'FILE-SYSTEM',
+        section: 'BACKBLAZE',
+        key: 'BUCKET_NAME',
+        label: 'Backblaze bucket name',
+        description: 'B2 bucket name used by the file-system for uploads and downloads',
+        type: core_1.SETTINGS_TYPE.TEXT,
+        value: '',
+        options: null,
+        sortOrder: 1,
+    },
+];
+/** Exported as SETTINGS so @venturialstd/core can discover and register these settings. */
+exports.SETTINGS = exports.FILE_SYSTEM_SETTINGS;
+//# sourceMappingURL=file-system.settings.js.map

package/dist/settings/file-system.settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.settings.js","sourceRoot":"","sources":["../../src/settings/file-system.settings.ts"],"names":[],"mappings":";;;AAAA,6CAA6D;AAE7D,8FAAoF;AAEvE,QAAA,oBAAoB,GAAuD;IACtF;QACE,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,SAAS;QAClB,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,8BAA8B;QACrC,WAAW,EAAE,iEAAiE;QAC9E,IAAI,EAAE,oBAAa,CAAC,MAAM;QAC1B,KAAK,EAAE,sDAAsB,CAAC,SAAS;QACvC,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,sDAAsB,CAAC,SAAS,EAAE;SACnE;QACD,SAAS,EAAE,CAAC;KACb;IACD;QACE,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,WAAW;QACpB,GAAG,EAAE,aAAa;QAClB,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,kEAAkE;QAC/E,IAAI,EAAE,oBAAa,CAAC,IAAI;QACxB,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,CAAC;KACb;CACF,CAAC;AAEF,2FAA2F;AAC9E,QAAA,QAAQ,GAAG,4BAAoB,CAAC"}

package/dist/types/file-metadata.type.d.ts

@@ -0,0 +1,12 @@
+/** Metadata returned by head/exists. */
+export interface FileMetadata {
+    key: string;
+    contentLength?: number;
+    contentType?: string;
+    etag?: string;
+    lastModified?: string;
+    metadata?: Record<string, string>;
+    /** Version ID for versioned buckets (e.g. Backblaze B2); required for permanent delete. */
+    versionId?: string;
+}
+//# sourceMappingURL=file-metadata.type.d.ts.map

package/dist/types/file-metadata.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-metadata.type.d.ts","sourceRoot":"","sources":["../../src/types/file-metadata.type.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,2FAA2F;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/file-metadata.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=file-metadata.type.js.map

package/dist/types/file-metadata.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-metadata.type.js","sourceRoot":"","sources":["../../src/types/file-metadata.type.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+export type { UploadOptions } from './upload-options.type';
+export type { ListOptions } from './list-options.type';
+export type { ListResultEntry } from './list-result-entry.type';
+export type { ListResult } from './list-result.type';
+export type { FileMetadata } from './file-metadata.type';
+export type { SignedUrlResult } from './signed-url-result.type';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/types/list-options.type.d.ts

@@ -0,0 +1,10 @@
+/** Options for list operation. */
+export interface ListOptions {
+    /** Maximum number of keys to return (pagination). */
+    maxKeys?: number;
+    /** Continuation token for next page. */
+    continuationToken?: string;
+    /** List objects after this key (cursor). */
+    startAfter?: string;
+}
+//# sourceMappingURL=list-options.type.d.ts.map

package/dist/types/list-options.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-options.type.d.ts","sourceRoot":"","sources":["../../src/types/list-options.type.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/list-options.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=list-options.type.js.map

package/dist/types/list-options.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-options.type.js","sourceRoot":"","sources":["../../src/types/list-options.type.ts"],"names":[],"mappings":""}

package/dist/types/list-result-entry.type.d.ts

@@ -0,0 +1,9 @@
+/** Single entry in a list result. */
+export interface ListResultEntry {
+    key: string;
+    lastModified?: string;
+    etag?: string;
+    size?: number;
+    storageClass?: string;
+}
+//# sourceMappingURL=list-result-entry.type.d.ts.map

package/dist/types/list-result-entry.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-result-entry.type.d.ts","sourceRoot":"","sources":["../../src/types/list-result-entry.type.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/types/list-result-entry.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=list-result-entry.type.js.map

package/dist/types/list-result-entry.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-result-entry.type.js","sourceRoot":"","sources":["../../src/types/list-result-entry.type.ts"],"names":[],"mappings":""}

package/dist/types/list-result.type.d.ts

@@ -0,0 +1,10 @@
+import type { ListResultEntry } from './list-result-entry.type';
+/** Result of list operation. */
+export interface ListResult {
+    entries: ListResultEntry[];
+    isTruncated: boolean;
+    keyCount: number;
+    nextContinuationToken?: string;
+    prefix?: string;
+}
+//# sourceMappingURL=list-result.type.d.ts.map

package/dist/types/list-result.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-result.type.d.ts","sourceRoot":"","sources":["../../src/types/list-result.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,gCAAgC;AAChC,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/list-result.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=list-result.type.js.map

package/dist/types/list-result.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-result.type.js","sourceRoot":"","sources":["../../src/types/list-result.type.ts"],"names":[],"mappings":""}

package/dist/types/signed-url-result.type.d.ts

@@ -0,0 +1,9 @@
+/** Result of signed URL generation (optional operation). */
+export interface SignedUrlResult {
+    url: string;
+    /** Optional auth token for upload (e.g. Backblaze). */
+    uploadAuthToken?: string;
+    /** Expires at (ISO string) if applicable. */
+    expiresAt?: string;
+}
+//# sourceMappingURL=signed-url-result.type.d.ts.map

package/dist/types/signed-url-result.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signed-url-result.type.d.ts","sourceRoot":"","sources":["../../src/types/signed-url-result.type.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/signed-url-result.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=signed-url-result.type.js.map

package/dist/types/signed-url-result.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signed-url-result.type.js","sourceRoot":"","sources":["../../src/types/signed-url-result.type.ts"],"names":[],"mappings":""}

package/dist/types/upload-options.type.d.ts

@@ -0,0 +1,12 @@
+/** Options for upload operation. */
+export interface UploadOptions {
+    /** Content-Type / MIME type. */
+    contentType?: string;
+    /** Custom metadata. */
+    metadata?: Record<string, string>;
+    /** Cache-Control header. */
+    cacheControl?: string;
+    /** Content-Disposition header. */
+    contentDisposition?: string;
+}
+//# sourceMappingURL=upload-options.type.d.ts.map

package/dist/types/upload-options.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-options.type.d.ts","sourceRoot":"","sources":["../../src/types/upload-options.type.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/types/upload-options.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=upload-options.type.js.map

package/dist/types/upload-options.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-options.type.js","sourceRoot":"","sources":["../../src/types/upload-options.type.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@venturialstd/file-system",
+  "version": "0.0.1",
+  "description": "Provider-agnostic file system module (Backblaze, extensible to AWS S3) with file/folder tree persistence",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "commonjs",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "prebuild": "rimraf dist",
+    "build": "tsc -p tsconfig.json",
+    "release:patch": "npm run build && npm version patch --no-git-tag-version && npm publish",
+    "prepublishOnly": "npm run build",
+    "pack": "rimraf *.tgz && npm run build && npm pack"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/typeorm": "^10.0.0",
+    "@venturialstd/backblaze": "^0.0.2",
+    "@venturialstd/core": "^2.0.0",
+    "typeorm": "^0.3.0"
+  },
+  "dependencies": {
+    "uuid": "^11.0.5"
+  },
+  "devDependencies": {
+    "@types/uuid": "^10.0.0",
+    "typescript": "^5.7.0"
+  }
+}