@toa.io/extensions.storages 1.0.0-alpha.31 → 1.0.0-alpha.310

package/transpiled/Scanner.js

@@ -1,24 +1,22 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Scanner = void 0;
-const node_stream_1 = require("node:stream");
-const node_crypto_1 = require("node:crypto");
-const agent_1 = require("@toa.io/agent");
-const error_value_1 = require("error-value");
-class Scanner extends node_stream_1.PassThrough {
+import { PassThrough } from 'node:stream';
+import { createHash } from 'node:crypto';
+import Negotiator from 'negotiator';
+export class Scanner extends PassThrough {
     size = 0;
     type = 'application/octet-stream';
-    error = null;
-    hash = (0, node_crypto_1.createHash)('md5');
+    error;
+    hash = createHash('md5');
     claim;
     accept;
+    limit;
     position = 0;
-    detected = false;
+    completed = false;
     chunks = [];
     constructor(control) {
         super();
         this.claim = control?.claim;
         this.accept = control?.accept;
+        this.limit = control?.limit;
     }
     digest() {
         return this.hash.digest('hex');
@@ -30,7 +28,7 @@ class Scanner extends node_stream_1.PassThrough {
     process = (buffer) => {
         this.size += buffer.length;
         this.hash.update(buffer);
-        if (this.detected)
+        if (this.completed)
             return;
         if (this.position + buffer.length > HEADER_SIZE)
             buffer = buffer.subarray(0, HEADER_SIZE - this.position);
@@ -38,15 +36,14 @@ class Scanner extends node_stream_1.PassThrough {
         this.position += buffer.length;
         if (this.position === HEADER_SIZE)
             this.complete();
+        if (this.limit !== undefined && this.size > this.limit)
+            this.interrupt(ERR_LIMIT_EXCEEDED);
     };
     complete() {
         const header = Buffer.concat(this.chunks).toString('hex');
-        const signature = SIGNATURES
-            .find(({ off, hex, expression }) => {
+        const signature = SIGNATURES.find(({ off, hex, expression }) => {
             const sig = header.slice(off, off + hex.length);
-            return expression === undefined
-                ? sig === hex
-                : expression.test(sig);
+            return expression === undefined ? sig === hex : expression.test(sig);
         });
         const type = signature?.type ?? this.claim;
         if (type !== undefined) {
@@ -54,7 +51,7 @@ class Scanner extends node_stream_1.PassThrough {
             this.type = type;
         }
         this.verify(signature);
-        this.detected = true;
+        this.completed = true;
     }
     verify(signature) {
         if (this.claim === undefined || this.claim === 'application/octet-stream')
@@ -68,20 +65,24 @@ class Scanner extends node_stream_1.PassThrough {
     match(type) {
         if (this.accept === undefined)
             return;
-        const unacceptable = (0, agent_1.negotiate)(this.accept, [type]) === null;
+        const unacceptable = this.negotiate(this.accept, [type]) === null;
         if (unacceptable)
             this.interrupt(ERR_NOT_ACCEPTABLE);
     }
+    negotiate(accept, type) {
+        return new Negotiator({ headers: { accept } }).mediaType(type) ?? null;
+    }
     interrupt(error) {
+        this.completed = true;
         this.error = error;
-        this.end();
+        this.destroy(error);
     }
 }
-exports.Scanner = Scanner;
 // https://en.wikipedia.org/wiki/List_of_file_signatures
 const SIGNATURES = [
     { hex: 'ff d8 ff e0', off: 0, type: 'image/jpeg' },
     { hex: 'ff d8 ff e1', off: 0, type: 'image/jpeg' },
+    { hex: 'ff d8 ff e2', off: 0, type: 'image/jpeg' },
     { hex: 'ff d8 ff ee', off: 0, type: 'image/jpeg' },
     { hex: 'ff d8 ff db', off: 0, type: 'image/jpeg' },
     { hex: '89 50 4e 47', off: 0, type: 'image/png' },
@@ -94,7 +95,7 @@ const SIGNATURES = [
     { hex: '52 49 46 46 ?? ?? ?? ?? 57 41 56 45', off: 0, type: 'audio/wav' }
     /*
     When adding a new signature, include a copyright-free sample file in the `.tests` directory
-    and update the 'signatures' test group in `Storage.test.ts`.
+    and update the `signatures` test group in `Storage.test.ts`.
      */
 ].map((signature) => {
     signature.hex = signature.hex.replaceAll(' ', '');
@@ -104,9 +105,15 @@ const SIGNATURES = [
     }
     return signature;
 });
-const HEADER_SIZE = SIGNATURES
-    .reduce((max, { off, hex }) => Math.max(max, off + hex.length), 0) / 2;
+const HEADER_SIZE = SIGNATURES.reduce((max, { off, hex }) => Math.max(max, off + hex.length), 0) / 2;
 const KNOWN_TYPES = new Set(SIGNATURES.map(({ type }) => type));
-const ERR_TYPE_MISMATCH = (0, error_value_1.Err)('TYPE_MISMATCH');
-const ERR_NOT_ACCEPTABLE = (0, error_value_1.Err)('NOT_ACCEPTABLE');
+const ERR_TYPE_MISMATCH = new (class TypeMismatchError extends Error {
+    code = 'TYPE_MISMATCH';
+})();
+const ERR_NOT_ACCEPTABLE = new (class NotAcceptableError extends Error {
+    code = 'NOT_ACCEPTABLE';
+})();
+const ERR_LIMIT_EXCEEDED = new (class LimitExceededError extends Error {
+    code = 'LIMIT_EXCEEDED';
+})();
 //# sourceMappingURL=Scanner.js.map

package/transpiled/Scanner.js.map

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

package/transpiled/Secrets.d.ts

@@ -0,0 +1,5 @@
+export type Secrets<K extends string = string> = Record<K | string, string | undefined>;
+export interface Secret {
+    readonly name: string;
+    readonly optional?: boolean;
+}

package/transpiled/Secrets.js

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

package/transpiled/Secrets.js.map

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

package/transpiled/Storage.d.ts

@@ -1,30 +1,31 @@
-/// <reference types="node" />
-import { Readable } from 'node:stream';
-import type { ScanOptions } from './Scanner';
-import type { Provider } from './Provider';
-import type { Entry } from './Entry';
-export declare class Storage {
+import type { Readable } from 'node:stream';
+import type { Attributes, Entry, Stream } from './Entry.ts';
+import type { ScanOptions } from './Scanner.ts';
+import type { Provider } from './Provider.ts';
+export declare class Storage<T extends Provider = Provider> {
     private readonly provider;
-    constructor(provider: Provider);
+    private readonly scope?;
+    constructor(provider: T, scope?: Scope);
+    options(): T['options'];
     put(path: string, stream: Readable, options?: Options): Maybe<Entry>;
-    get(path: string): Maybe<Entry>;
-    list(path: string): Promise<string[]>;
-    fetch(path: string): Maybe<Readable>;
+    get(path: string, options?: unknown): Maybe<Stream>;
+    head(path: string): Promise<Maybe<Entry>>;
     delete(path: string): Maybe<void>;
-    move(path: string, to: string): Maybe<void>;
-    diversify(path: string, name: string, stream: Readable): Maybe<void>;
-    annotate(path: string, key: string, value?: unknown): Maybe<void>;
-    private transit;
-    private persist;
-    private create;
-    private save;
-    private parse;
-    private destruct;
+    path(): string | null;
+    private locate;
+    private span;
 }
-type Maybe<T> = Promise<T | Error>;
-type Meta = Record<string, string>;
 interface Options extends ScanOptions {
-    meta?: Meta;
+    id?: string;
+    origin?: string;
+    attributes?: Attributes;
+}
+type Maybe<T> = Promise<T | Error>;
+export interface Scope {
+    /** the logical storage name, e.g. `octets` */
+    name: string;
+    /** the provider id, e.g. `s3` */
+    provider: string;
 }
 export type Storages = Record<string, Storage>;
 export {};

package/transpiled/Storage.js

@@ -1,157 +1,94 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Storage = void 0;
-const node_stream_1 = require("node:stream");
-const node_path_1 = require("node:path");
-const consumers_1 = require("node:stream/consumers");
-const msgpackr_1 = require("msgpackr");
-const generic_1 = require("@toa.io/generic");
-const error_value_1 = require("error-value");
-const Scanner_1 = require("./Scanner");
-class Storage {
+import { basename, dirname, join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { console } from 'openspan';
+import { Scanner } from './Scanner.js';
+import { operation } from './measurements.js';
+export class Storage {
     provider;
-    constructor(provider) {
+    scope;
+    constructor(provider, scope) {
         this.provider = provider;
+        this.scope = scope;
     }
-    async put(path, stream, options) {
-        const scanner = new Scanner_1.Scanner(options);
-        const pipe = stream.pipe(scanner);
-        const tempname = await this.transit(pipe);
-        if (scanner.error !== null)
-            return scanner.error;
-        const id = scanner.digest();
-        await this.persist(tempname, id);
-        return await this.create(path, id, scanner.size, scanner.type, options?.meta);
+    options() {
+        return this.provider.options;
     }
-    async get(path) {
-        const paths = this.destruct(path);
-        const result = await this.provider.get(paths.metafile);
-        if (result === null)
-            return ERR_NOT_FOUND;
-        else
-            return (0, msgpackr_1.decode)(await (0, consumers_1.buffer)(result));
+    async put(path, stream, options) {
+        return await console.span(this.span('put', path), async () => {
+            const scanner = new Scanner(options);
+            const pipe = stream.pipe(scanner).on('error', () => undefined);
+            const id = options?.id ?? randomUUID().replace(/-/g, '');
+            const location = this.locate(path, id);
+            /**
+             * Provider can return or throw an error.
+             * If thrown error is TYPE_MISMATCH from the Scanner, it should be returned.
+             */
+            const error = await this.provider
+                .put(location, pipe)
+                .catch((error) => {
+                if (error === scanner.error)
+                    return error;
+                else
+                    throw error;
+            });
+            if (error instanceof Error)
+                return error;
+            const metadata = {
+                id,
+                size: scanner.size,
+                type: scanner.type,
+                checksum: scanner.digest(),
+                created: new Date().toISOString(),
+                attributes: options?.attributes ?? {}
+            };
+            if (options?.origin !== undefined)
+                metadata.attributes.origin = options.origin;
+            await this.provider.commit(location, metadata);
+            return metadata;
+        });
     }
-    async list(path) {
-        const dir = node_path_1.posix.join(ENTRIES_ROOT, path, ENTRIES_DIR);
-        return await this.provider.list(dir);
+    async get(path, options) {
+        return await console.span(this.span('get', dirname(path)), async () => {
+            const location = this.locate(path);
+            return await this.provider.get(location, options);
+        });
     }
-    async fetch(path) {
-        const { rel, id, variant } = this.parse(path);
-        if (variant === null && rel !== '') {
-            const entry = await this.get(path);
-            if (entry instanceof Error)
-                return entry;
-        }
-        const blob = variant === null
-            ? node_path_1.posix.join(BLOBs, id)
-            : node_path_1.posix.join(ENTRIES_ROOT, rel, id, variant);
-        const stream = await this.provider.get(blob);
-        if (stream === null)
-            return ERR_NOT_FOUND;
-        else
-            return stream;
+    async head(path) {
+        return await console.span(this.span('head', dirname(path)), async () => {
+            const id = basename(path).split('.')[0];
+            const location = this.locate(path);
+            const metadata = await this.provider.head(location);
+            if (metadata instanceof Error)
+                return metadata;
+            return {
+                id,
+                ...metadata
+            };
+        });
     }
     async delete(path) {
-        const entry = await this.get(path);
-        if (entry instanceof Error)
-            return entry;
-        const paths = this.destruct(path);
-        await Promise.all([
-            this.provider.delete(paths.metafile),
-            this.provider.delete(paths.vardir)
-        ]);
-    }
-    async move(path, to) {
-        const source = this.destruct(path);
-        const rel = to.startsWith('.');
-        const dir = to.endsWith('/');
-        if (rel)
-            to = node_path_1.posix.resolve(source.rel + '/', to);
-        if (dir)
-            to = node_path_1.posix.join(to, source.ent);
-        const target = this.destruct(to);
-        await Promise.all([
-            this.provider.move(source.metafile, target.metafile),
-            this.provider.moveDir(source.vardir, target.vardir)
-        ]);
-    }
-    async diversify(path, name, stream) {
-        const scanner = new Scanner_1.Scanner();
-        const pipe = stream.pipe(scanner);
-        await this.provider.put(node_path_1.posix.join(ENTRIES_ROOT, path), name, pipe);
-        if (scanner.error !== null)
-            return scanner.error;
-        const { size, type } = scanner;
-        const entry = await this.get(path);
-        if (entry instanceof Error)
-            return entry;
-        entry.variants = entry.variants.filter((variant) => variant.name !== name);
-        entry.variants.push({ name, size, type });
-        await this.save(path, entry);
+        return await console.span(this.span('delete', dirname(path)), async () => {
+            const location = this.locate(path);
+            return await this.provider.delete(location);
+        });
     }
-    async annotate(path, key, value) {
-        const entry = await this.get(path);
-        if (entry instanceof Error)
-            return entry;
-        // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
-        if (value === undefined)
-            delete entry.meta[key];
-        else
-            entry.meta[key] = value;
-        await this.save(path, entry);
+    path() {
+        return this.provider.root ?? null;
     }
-    async transit(stream) {
-        const tempname = (0, generic_1.newid)();
-        await this.provider.put(TEMP, tempname, stream);
-        return tempname;
+    locate(...rel) {
+        return join(ENTRIES, ...rel);
     }
-    async persist(tempname, id) {
-        const temp = node_path_1.posix.join(TEMP, tempname);
-        const blob = node_path_1.posix.join(BLOBs, id);
-        await this.provider.move(temp, blob);
-    }
-    // eslint-disable-next-line max-params
-    async create(path, id, size, type, meta = {}) {
-        const entry = {
-            id,
-            size,
-            type,
-            created: Date.now(),
-            variants: [],
-            meta
+    span(method, path) {
+        return {
+            name: `${method} ${this.scope?.name ?? 'storage'}`,
+            kind: 'client',
+            attributes: {
+                ...(this.scope === undefined ? {} : { provider: this.scope.provider }),
+                path
+            },
+            measure: operation(method, this.scope)
         };
-        const metafile = node_path_1.posix.join(path, entry.id);
-        const existing = await this.get(metafile);
-        if (existing instanceof Error)
-            await this.save(metafile, entry);
-        return entry;
-    }
-    async save(path, entry) {
-        const paths = this.destruct(path);
-        const stream = node_stream_1.Readable.from((0, msgpackr_1.encode)(entry));
-        await this.provider.put(paths.metadir, paths.ent, stream);
-    }
-    parse(path) {
-        const [last, ...segments] = path.split('/').reverse();
-        const [id, ...rest] = last.split('.');
-        const variant = rest.length > 0 ? rest.join('.') : null;
-        const rel = segments.reverse().join('/');
-        return { rel, id, variant };
-    }
-    destruct(path) {
-        const rel = node_path_1.posix.dirname(path);
-        const dir = node_path_1.posix.join(ENTRIES_ROOT, rel);
-        const ent = node_path_1.posix.basename(path);
-        const metadir = node_path_1.posix.join(dir, ENTRIES_DIR);
-        const metafile = node_path_1.posix.join(metadir, ent);
-        const vardir = node_path_1.posix.join(dir, ent);
-        return { rel, dir, ent, metadir, metafile, vardir };
     }
 }
-exports.Storage = Storage;
-const ERR_NOT_FOUND = (0, error_value_1.Err)('NOT_FOUND');
-const TEMP = '/temp';
-const BLOBs = '/blobs';
-const ENTRIES_ROOT = '/entries';
-const ENTRIES_DIR = '.meta';
+const ENTRIES = '/';
 //# sourceMappingURL=Storage.js.map

package/transpiled/Storage.js.map

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

package/transpiled/errors.d.ts

@@ -0,0 +1,7 @@
+export declare const ERR_NOT_FOUND: {
+    readonly code: "NOT_FOUND";
+    name: string;
+    message: string;
+    stack?: string;
+    cause?: unknown;
+};

package/transpiled/errors.js

@@ -0,0 +1,4 @@
+export const ERR_NOT_FOUND = new (class NotFoundError extends Error {
+    code = 'NOT_FOUND';
+})();
+//# sourceMappingURL=errors.js.map

package/transpiled/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../source/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,aAAc,SAAQ,KAAK;IACjD,IAAI,GAAG,WAAW,CAAA;CACnC,CAAC,EAAE,CAAA"}

package/transpiled/index.d.ts

@@ -1,4 +1,4 @@
-export { Factory } from './Factory';
-export { deployment } from './deployment';
-export { manifest } from './manifest';
-export type { Entry } from './Entry';
+export { Factory } from './Factory.ts';
+export type { Entry, Stream } from './Entry.ts';
+export type { Storage } from './Storage.ts';
+export type * from './providers/index.ts';

package/transpiled/index.js

@@ -1,10 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.manifest = exports.deployment = exports.Factory = void 0;
-var Factory_1 = require("./Factory");
-Object.defineProperty(exports, "Factory", { enumerable: true, get: function () { return Factory_1.Factory; } });
-var deployment_1 = require("./deployment");
-Object.defineProperty(exports, "deployment", { enumerable: true, get: function () { return deployment_1.deployment; } });
-var manifest_1 = require("./manifest");
-Object.defineProperty(exports, "manifest", { enumerable: true, get: function () { return manifest_1.manifest; } });
+export { Factory } from './Factory.js';
 //# sourceMappingURL=index.js.map

package/transpiled/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":";;;AAAA,qCAAmC;AAA1B,kGAAA,OAAO,OAAA;AAChB,2CAAyC;AAAhC,wGAAA,UAAU,OAAA;AACnB,uCAAqC;AAA5B,oGAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/transpiled/measurements.d.ts

@@ -0,0 +1,3 @@
+import type { Measure } from 'openspan';
+import type { Scope } from './Storage.ts';
+export declare function operation(method: string, scope?: Scope): Measure;

package/transpiled/measurements.js

@@ -0,0 +1,23 @@
+import { registry } from 'openspan';
+/**
+ * What a BLOB storage measures. Network I/O to a third party, and nothing else reports it.
+ *
+ * `storage` is the name the component declared it under and `provider` is what stands behind it:
+ * a component declares several and uses them for different things, so the provider alone does not
+ * say which one was slow where two declarations share one.
+ */
+const meters = registry();
+/** Wider than a query's, because a third party over the network is slower than a database. */
+const DURATIONS = [0.01, 0.05, 0.1, 0.5, 1, 2.5, 5, 10, 30];
+const duration = meters.histogram('toa.blob.operation.duration', { buckets: DURATIONS, unit: 's' }, { storage: null, provider: null, operation: null });
+export function operation(method, scope) {
+    return {
+        histogram: duration,
+        labels: {
+            storage: scope?.name,
+            provider: scope?.provider,
+            operation: method
+        }
+    };
+}
+//# sourceMappingURL=measurements.js.map

package/transpiled/measurements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurements.js","sourceRoot":"","sources":["../source/measurements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAInC;;;;;;GAMG;AACH,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAA;AAEzB,8FAA8F;AAC9F,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;AAE3D,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAC/B,6BAA6B,EAC7B,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,EACjC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CACnD,CAAA;AAED,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,KAAa;IACrD,OAAO;QACL,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE;YACN,OAAO,EAAE,KAAK,EAAE,IAAI;YACpB,QAAQ,EAAE,KAAK,EAAE,QAAQ;YACzB,SAAS,EAAE,MAAM;SAClB;KACF,CAAA;AACH,CAAC"}

package/transpiled/providers/Cloudinary.d.ts

@@ -0,0 +1,50 @@
+import { Readable } from 'node:stream';
+import { Provider } from '../Provider.ts';
+import type { Maybe } from '@toa.io/core/types';
+import type { Metadata, Stream } from '../Entry.ts';
+import type { Secret, Secrets } from '../Secrets.ts';
+import type { TransformationOptions } from 'cloudinary';
+export type CloudinarySecrets = Secrets<'API_KEY' | 'API_SECRET'>;
+export declare class Cloudinary extends Provider<CloudinaryOptions> {
+    static readonly SECRETS: readonly Secret[];
+    private readonly type;
+    private readonly eager;
+    private readonly transformations;
+    private readonly config;
+    private readonly prefix;
+    constructor(options: CloudinaryOptions, secrets?: CloudinarySecrets);
+    get(path: string, options?: GetOptions): Promise<Maybe<Stream>>;
+    head(path: string): Promise<Maybe<Metadata>>;
+    put(path: string, stream: Readable): Promise<void>;
+    commit(): Promise<void>;
+    delete(path: string): Promise<void>;
+    move(from: string, to: string): Promise<void | Error>;
+    private fetch;
+    private url;
+    private toTransformation;
+    private mapTransformation;
+    private metadata;
+    private cloudinary;
+}
+interface GetOptions {
+    agent?: string;
+    range?: string;
+}
+export interface CloudinaryOptions {
+    environment: string;
+    type: StorageType;
+    prefix?: string;
+    eager?: TransformationOptions[];
+    transformations?: TransformationDeclaration[];
+}
+type TransformationDeclaration = Omit<Transformation, 'extension'> & {
+    extension: string;
+};
+interface Transformation {
+    extension: RegExp;
+    condition?: string;
+    transformation: Record<string, unknown> | Array<Record<string, unknown>>;
+    optional?: boolean;
+}
+type StorageType = 'image' | 'video';
+export {};