@cogenta/core 0.1.0

package/dist/storage/s3.js

@@ -0,0 +1,240 @@
+import { CogentaError } from '../errors/index.js';
+import { parseKey } from './key.js';
+/**
+ * Loads the AWS SDK if the host application installed it.
+ *
+ * It is an optional peer, and a large one — which is exactly why it must not be
+ * a hard dependency. A site on local storage installs none of it.
+ */
+export async function loadS3Modules() {
+    try {
+        const [s3, presigner, upload] = await Promise.all([
+            import('@aws-sdk/client-s3'),
+            import('@aws-sdk/s3-request-presigner'),
+            import('@aws-sdk/lib-storage'),
+        ]);
+        return { s3, presigner, upload };
+    }
+    catch {
+        return null;
+    }
+}
+function isNotFound(error) {
+    const status = error.$metadata?.httpStatusCode;
+    const name = error.name ?? '';
+    return status === 404 || name === 'NotFound' || name === 'NoSuchKey';
+}
+export function createS3Storage(options) {
+    const { client, bucket, modules } = options;
+    const prefix = options.prefix ?? '';
+    const baseUrl = (options.baseUrl ?? '').replace(/\/$/, '');
+    const objectKey = (key) => {
+        parseKey(key);
+        return `${prefix}${key}`;
+    };
+    return {
+        put: async (key, data, putOptions) => {
+            const input = {
+                Bucket: bucket,
+                Key: objectKey(key),
+                Body: data,
+                ...(putOptions?.contentType === undefined ? {} : { ContentType: putOptions.contentType }),
+                ...(putOptions?.cacheControl === undefined
+                    ? {}
+                    : { CacheControl: putOptions.cacheControl }),
+            };
+            try {
+                if (Buffer.isBuffer(data)) {
+                    await client.send(new modules.s3.PutObjectCommand(input));
+                }
+                else {
+                    // A stream has no known length, and PutObject requires one. Upload
+                    // splits it into parts instead, so a large video never has to be
+                    // buffered in memory to be stored.
+                    await new modules.upload.Upload({ client, params: input }).done();
+                }
+            }
+            catch (error) {
+                throw new CogentaError({
+                    code: 'STORAGE_FAILED',
+                    message: `Could not store the media object "${key}".`,
+                    hint: 'Check the bucket name, the region and the credentials in the environment.',
+                    cause: error,
+                    details: { key, bucket },
+                });
+            }
+        },
+        get: async (key) => {
+            try {
+                const result = await client.send(new modules.s3.GetObjectCommand({ Bucket: bucket, Key: objectKey(key) }));
+                if (result.Body === undefined)
+                    throw new Error('the response had no body');
+                return result.Body;
+            }
+            catch (error) {
+                throw new CogentaError({
+                    code: 'STORAGE_FAILED',
+                    message: `No media object stored under "${key}".`,
+                    hint: 'Check the key, or upload the object first.',
+                    cause: error,
+                    details: { key },
+                });
+            }
+        },
+        head: async (key) => {
+            try {
+                const result = await client.send(new modules.s3.HeadObjectCommand({ Bucket: bucket, Key: objectKey(key) }));
+                return {
+                    key,
+                    size: result.ContentLength ?? 0,
+                    contentType: result.ContentType,
+                    cacheControl: result.CacheControl,
+                };
+            }
+            catch (error) {
+                if (isNotFound(error))
+                    return null;
+                throw error;
+            }
+        },
+        delete: async (key) => {
+            await client.send(new modules.s3.DeleteObjectCommand({ Bucket: bucket, Key: objectKey(key) }));
+        },
+        exists: async (key) => {
+            // Validated outside the try, so an unsafe key raises rather than being
+            // reported as an ordinary miss.
+            const resolved = objectKey(key);
+            try {
+                await client.send(new modules.s3.HeadObjectCommand({ Bucket: bucket, Key: resolved }));
+                return true;
+            }
+            catch (error) {
+                if (isNotFound(error))
+                    return false;
+                throw error;
+            }
+        },
+        signedUrl: async (key, expiresIn) => {
+            const resolved = objectKey(key);
+            if (!Number.isFinite(expiresIn) || expiresIn <= 0) {
+                throw new CogentaError({
+                    code: 'STORAGE_FAILED',
+                    message: `A signed URL must expire in a positive number of seconds, received ${String(expiresIn)}.`,
+                    hint: 'Pass the lifetime in seconds, for example 300 for five minutes.',
+                });
+            }
+            return modules.presigner.getSignedUrl(client, new modules.s3.GetObjectCommand({ Bucket: bucket, Key: resolved }), { expiresIn: Math.floor(expiresIn) });
+        },
+        publicUrl: (key) => {
+            const resolved = objectKey(key);
+            if (baseUrl === '') {
+                throw new CogentaError({
+                    code: 'STORAGE_FAILED',
+                    message: 'This bucket has no public URL configured.',
+                    hint: 'Set storage.baseUrl to the CDN or bucket origin that serves these objects, or use signedUrl() for private media.',
+                });
+            }
+            return `${baseUrl}/${resolved}`;
+        },
+    };
+}
+export function s3StorageDriver(options = {}) {
+    let client;
+    let bucket;
+    const buildClient = (config, modules) => new modules.s3.S3Client({
+        region: config.region ?? 'us-east-1',
+        ...(config.endpoint === undefined
+            ? {}
+            : {
+                endpoint: config.endpoint,
+                // MinIO, R2 and most self-hosted gateways serve buckets as a path
+                // rather than a subdomain. Assuming virtual-host style breaks all
+                // of them, and the failure looks like a DNS error.
+                forcePathStyle: true,
+            }),
+        ...(config.accessKeyId === undefined || config.secretAccessKey === undefined
+            ? {}
+            : {
+                credentials: {
+                    accessKeyId: config.accessKeyId,
+                    secretAccessKey: config.secretAccessKey,
+                },
+            }),
+    });
+    return {
+        name: 's3',
+        tier: 'optimal',
+        available: async (config) => {
+            if (config.bucket === undefined)
+                return false;
+            const modules = await loadS3Modules();
+            if (modules === null)
+                return false;
+            let probe;
+            try {
+                probe = buildClient(config, modules);
+                // A HEAD on a key that does not exist still proves the endpoint answers
+                // and the credentials are accepted; only a missing object comes back.
+                await probe
+                    .send(new modules.s3.HeadObjectCommand({
+                    Bucket: config.bucket,
+                    Key: '.cogenta-availability-probe',
+                }))
+                    .catch((error) => {
+                    if (!isNotFound(error))
+                        throw error;
+                });
+                return true;
+            }
+            catch {
+                return false;
+            }
+            finally {
+                probe?.destroy();
+            }
+        },
+        init: async (config) => {
+            const modules = await loadS3Modules();
+            if (modules === null) {
+                throw new CogentaError({
+                    code: 'DRIVER_INIT_FAILED',
+                    message: 'The S3 storage driver needs the AWS SDK.',
+                    hint: 'Run `pnpm add @aws-sdk/client-s3 @aws-sdk/s3-request-presigner @aws-sdk/lib-storage`, or leave storage.driver unset to store media on disk.',
+                });
+            }
+            if (config.bucket === undefined) {
+                throw new CogentaError({
+                    code: 'CONFIG_INVALID',
+                    message: 'The S3 storage driver needs a bucket.',
+                    hint: 'Set storage.bucket, or the COGENTA_STORAGE_BUCKET environment variable.',
+                });
+            }
+            bucket = config.bucket;
+            client ??= buildClient(config, modules);
+            return createS3Storage({
+                ...options,
+                modules,
+                client,
+                bucket,
+                ...(config.baseUrl === undefined ? {} : { baseUrl: config.baseUrl }),
+            });
+        },
+        dispose: async () => {
+            client?.destroy();
+            client = undefined;
+        },
+        health: async () => {
+            if (client === undefined) {
+                return { status: 'down', driver: 's3', tier: 'optimal', message: 'Not connected.' };
+            }
+            return {
+                status: 'ok',
+                driver: 's3',
+                tier: 'optimal',
+                // The bucket is safe to name; the credentials and endpoint are not.
+                message: `Media in the "${bucket ?? 'unknown'}" bucket.`,
+            };
+        },
+    };
+}
+//# sourceMappingURL=s3.js.map

package/dist/storage/s3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.js","sourceRoot":"","sources":["../../src/storage/s3.ts"],"names":[],"mappings":"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"}

package/dist/storage/types.d.ts

@@ -0,0 +1,45 @@
+import type { Readable } from 'node:stream';
+export interface StoragePutOptions {
+    readonly contentType?: string;
+    readonly cacheControl?: string;
+}
+export interface StorageObjectInfo {
+    readonly key: string;
+    readonly size: number;
+    readonly contentType: string | undefined;
+    readonly cacheControl: string | undefined;
+}
+/**
+ * Where media lives.
+ *
+ * Objects are addressed by key, never by path: a key is opaque text chosen by
+ * Cogenta, and every driver is responsible for mapping it somewhere safe.
+ */
+export interface StorageDriver {
+    put(key: string, data: Buffer | Readable, options?: StoragePutOptions): Promise<void>;
+    get(key: string): Promise<Readable>;
+    /** Metadata without the body. Needed to serve an object with its content type. */
+    head(key: string): Promise<StorageObjectInfo | null>;
+    delete(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    /** A time-limited URL for a private object. `expiresIn` is in seconds. */
+    signedUrl(key: string, expiresIn: number): Promise<string>;
+    /** The stable URL of a public object. */
+    publicUrl(key: string): string;
+}
+/** The resolved `storage` section of the configuration. */
+export interface StorageConfig {
+    readonly driver?: string;
+    readonly bucket?: string | undefined;
+    readonly region?: string | undefined;
+    readonly endpoint?: string | undefined;
+    readonly path?: string;
+    readonly baseUrl?: string | undefined;
+    readonly accessKeyId?: string | undefined;
+    readonly secretAccessKey?: string | undefined;
+}
+export interface StorageDriverOptions {
+    /** Injected so signed-URL expiry can be tested without waiting. Milliseconds. */
+    readonly now?: () => number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACnC,kFAAkF;IAClF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IACpD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACrC,0EAA0E;IAC1E,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC1D,yCAAyC;IACzC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAC/B;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC9C;AAED,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAC5B"}

package/dist/storage/types.js

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

package/dist/storage/types.js.map

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

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@cogenta/core",
+  "version": "0.1.0",
+  "description": "Configuration, typed errors, structured logging and the driver system behind Cogenta.",
+  "license": "MPL-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.11.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cogenta-cms/cogenta.git",
+    "directory": "packages/core"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
+    "test": "vitest run --passWithNoTests",
+    "test:integration": "vitest run --config vitest.integration.config.ts --passWithNoTests"
+  },
+  "dependencies": {
+    "zod": "catalog:",
+    "drizzle-orm": "catalog:"
+  },
+  "devDependencies": {
+    "typescript": "catalog:",
+    "vitest": "catalog:",
+    "@redis/client": "catalog:",
+    "postgres": "catalog:",
+    "mysql2": "catalog:",
+    "@aws-sdk/client-s3": "catalog:",
+    "@aws-sdk/s3-request-presigner": "catalog:",
+    "@aws-sdk/lib-storage": "catalog:",
+    "bullmq": "catalog:"
+  },
+  "peerDependencies": {
+    "@redis/client": "^6.2.1",
+    "postgres": "^3.4.9",
+    "mysql2": "^3.23.3",
+    "@aws-sdk/client-s3": "^3.1109.0",
+    "@aws-sdk/s3-request-presigner": "^3.1109.0",
+    "@aws-sdk/lib-storage": "^3.1109.0",
+    "bullmq": "^6.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@redis/client": {
+      "optional": true
+    },
+    "postgres": {
+      "optional": true
+    },
+    "mysql2": {
+      "optional": true
+    },
+    "@aws-sdk/client-s3": {
+      "optional": true
+    },
+    "@aws-sdk/s3-request-presigner": {
+      "optional": true
+    },
+    "@aws-sdk/lib-storage": {
+      "optional": true
+    },
+    "bullmq": {
+      "optional": true
+    }
+  }
+}