@valencets/plugin-cloud-storage 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 valencets
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cloud-storage-plugin.d.ts

@@ -0,0 +1,10 @@
+import type { CmsConfig } from '@valencets/cms';
+import type { CloudStorageAdapter } from './storage-adapter.js';
+export interface CloudStoragePluginOptions {
+    readonly adapter: CloudStorageAdapter;
+}
+export interface CmsConfigWithStorage extends CmsConfig {
+    readonly storageAdapter: CloudStorageAdapter;
+}
+export declare function cloudStoragePlugin(opts: CloudStoragePluginOptions): (config: CmsConfig) => CmsConfigWithStorage;
+//# sourceMappingURL=cloud-storage-plugin.d.ts.map

package/dist/cloud-storage-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-storage-plugin.d.ts","sourceRoot":"","sources":["../src/cloud-storage-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE/D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAA;CACtC;AAED,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,QAAQ,CAAC,cAAc,EAAE,mBAAmB,CAAA;CAC7C;AAED,wBAAgB,kBAAkB,CAAE,IAAI,EAAE,yBAAyB,GAAG,CAAC,MAAM,EAAE,SAAS,KAAK,oBAAoB,CAKhH"}

package/dist/cloud-storage-plugin.js

@@ -0,0 +1,7 @@
+export function cloudStoragePlugin(opts) {
+    return (config) => ({
+        ...config,
+        storageAdapter: opts.adapter
+    });
+}
+//# sourceMappingURL=cloud-storage-plugin.js.map

package/dist/cloud-storage-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-storage-plugin.js","sourceRoot":"","sources":["../src/cloud-storage-plugin.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,kBAAkB,CAAE,IAA+B;IACjE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClB,GAAG,MAAM;QACT,cAAc,EAAE,IAAI,CAAC,OAAO;KAC7B,CAAC,CAAA;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { createS3Adapter } from './s3-adapter.js';
+export type { S3AdapterOptions, S3Credentials } from './s3-adapter.js';
+export { cloudStoragePlugin } from './cloud-storage-plugin.js';
+export type { CloudStoragePluginOptions, CmsConfigWithStorage } from './cloud-storage-plugin.js';
+export type { CloudStorageAdapter, StorageError } from './storage-adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,YAAY,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChG,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+// @valencets/plugin-cloud-storage — S3-compatible cloud storage adapter for Valence CMS
+export { createS3Adapter } from './s3-adapter.js';
+export { cloudStoragePlugin } from './cloud-storage-plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wFAAwF;AAExF,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/s3-adapter.d.ts

@@ -0,0 +1,14 @@
+import type { CloudStorageAdapter } from './storage-adapter.js';
+export interface S3Credentials {
+    readonly accessKeyId: string;
+    readonly secretAccessKey: string;
+}
+export interface S3AdapterOptions {
+    readonly bucket: string;
+    readonly region: string;
+    readonly credentials: S3Credentials;
+    readonly prefix?: string | undefined;
+    readonly publicUrl?: string | undefined;
+}
+export declare function createS3Adapter(opts: S3AdapterOptions): CloudStorageAdapter;
+//# sourceMappingURL=s3-adapter.d.ts.map

package/dist/s3-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-adapter.d.ts","sourceRoot":"","sources":["../src/s3-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAgB,MAAM,sBAAsB,CAAA;AAE7E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAA;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACxC;AAiBD,wBAAgB,eAAe,CAAE,IAAI,EAAE,gBAAgB,GAAG,mBAAmB,CAgD5E"}

package/dist/s3-adapter.js

@@ -0,0 +1,55 @@
+import { ResultAsync } from '@valencets/resultkit';
+import { S3Client, PutObjectCommand, DeleteObjectCommand } from '@aws-sdk/client-s3';
+function buildKey(key, prefix) {
+    const segments = key.split('/').filter(s => s !== '..' && s !== '.');
+    const sanitized = segments.join('/');
+    return prefix !== undefined && prefix !== '' ? `${prefix}/${sanitized}` : sanitized;
+}
+function buildDefaultUrl(key, bucket, region) {
+    return `https://${bucket}.s3.${region}.amazonaws.com/${key}`;
+}
+function buildPublicUrl(key, publicUrl) {
+    const base = publicUrl.replace(/\/$/, '');
+    return `${base}/${key}`;
+}
+export function createS3Adapter(opts) {
+    const client = new S3Client({
+        region: opts.region,
+        credentials: {
+            accessKeyId: opts.credentials.accessKeyId,
+            secretAccessKey: opts.credentials.secretAccessKey
+        }
+    });
+    return {
+        upload(key, buffer, contentType) {
+            const fullKey = buildKey(key, opts.prefix);
+            const command = new PutObjectCommand({
+                Bucket: opts.bucket,
+                Key: fullKey,
+                Body: buffer,
+                ContentType: contentType
+            });
+            return ResultAsync.fromPromise(client.send(command).then(() => fullKey), (e) => ({
+                message: e instanceof Error ? e.message : 'Upload failed'
+            }));
+        },
+        delete(key) {
+            const fullKey = buildKey(key, opts.prefix);
+            const command = new DeleteObjectCommand({
+                Bucket: opts.bucket,
+                Key: fullKey
+            });
+            return ResultAsync.fromPromise(client.send(command).then(() => undefined), (e) => ({
+                message: e instanceof Error ? e.message : 'Delete failed'
+            }));
+        },
+        getUrl(key) {
+            const fullKey = buildKey(key, opts.prefix);
+            if (opts.publicUrl !== undefined && opts.publicUrl !== '') {
+                return buildPublicUrl(fullKey, opts.publicUrl);
+            }
+            return buildDefaultUrl(fullKey, opts.bucket, opts.region);
+        }
+    };
+}
+//# sourceMappingURL=s3-adapter.js.map

package/dist/s3-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-adapter.js","sourceRoot":"","sources":["../src/s3-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAgBpF,SAAS,QAAQ,CAAE,GAAW,EAAE,MAA0B;IACxD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAA;IACpE,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACpC,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AACrF,CAAC;AAED,SAAS,eAAe,CAAE,GAAW,EAAE,MAAc,EAAE,MAAc;IACnE,OAAO,WAAW,MAAM,OAAO,MAAM,kBAAkB,GAAG,EAAE,CAAA;AAC9D,CAAC;AAED,SAAS,cAAc,CAAE,GAAW,EAAE,SAAiB;IACrD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACzC,OAAO,GAAG,IAAI,IAAI,GAAG,EAAE,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,eAAe,CAAE,IAAsB;IACrD,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC;QAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE;YACX,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,WAAW;YACzC,eAAe,EAAE,IAAI,CAAC,WAAW,CAAC,eAAe;SAClD;KACF,CAAC,CAAA;IAEF,OAAO;QACL,MAAM,CAAE,GAAW,EAAE,MAAc,EAAE,WAAoB;YACvD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;YAC1C,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC;gBACnC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,GAAG,EAAE,OAAO;gBACZ,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,WAAW;aACzB,CAAC,CAAA;YACF,OAAO,WAAW,CAAC,WAAW,CAC5B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EACxC,CAAC,CAAU,EAAgB,EAAE,CAAC,CAAC;gBAC7B,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAC1D,CAAC,CACH,CAAA;QACH,CAAC;QAED,MAAM,CAAE,GAAW;YACjB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;YAC1C,MAAM,OAAO,GAAG,IAAI,mBAAmB,CAAC;gBACtC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,GAAG,EAAE,OAAO;aACb,CAAC,CAAA;YACF,OAAO,WAAW,CAAC,WAAW,CAC5B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAiB,CAAC,EAClD,CAAC,CAAU,EAAgB,EAAE,CAAC,CAAC;gBAC7B,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAC1D,CAAC,CACH,CAAA;QACH,CAAC;QAED,MAAM,CAAE,GAAW;YACjB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;YAC1C,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,EAAE,EAAE,CAAC;gBAC1D,OAAO,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;YAChD,CAAC;YACD,OAAO,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QAC3D,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/storage-adapter.d.ts

@@ -0,0 +1,10 @@
+import type { ResultAsync } from '@valencets/resultkit';
+export interface StorageError {
+    readonly message: string;
+}
+export interface CloudStorageAdapter {
+    upload(key: string, buffer: Buffer, contentType?: string): ResultAsync<string, StorageError>;
+    delete(key: string): ResultAsync<void, StorageError>;
+    getUrl(key: string): string;
+}
+//# sourceMappingURL=storage-adapter.d.ts.map

package/dist/storage-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter.d.ts","sourceRoot":"","sources":["../src/storage-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAC5F,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;IACpD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAC5B"}

package/dist/storage-adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=storage-adapter.js.map

package/dist/storage-adapter.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@valencets/plugin-cloud-storage",
+  "version": "0.1.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "@valencets/cms": "0.12.0"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.782.0",
+    "@valencets/resultkit": "^0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.4.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18",
+    "@valencets/cms": "0.12.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  }
+}