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

package/transpiled/test/util.d.ts

@@ -1,29 +1,136 @@
+import type { Secrets } from '../Secrets.ts';
+import type { providers, S3Options, SpacesOptions, CloudinaryOptions, FileSystemOptions, TemporaryOptions } from '../providers/index.ts';
 export declare const suites: ({
     run: true;
     provider: "tmp";
     options: {
         directory: string;
         endpoint?: undefined;
-        region?: undefined;
         bucket?: undefined;
+        space?: undefined;
+        region?: undefined;
+        environment?: undefined;
+        type?: undefined;
+        prefix?: undefined;
+        transformations?: undefined;
     };
     secrets?: undefined;
-} | {
-    run: true;
-    provider: "mem";
-    options?: undefined;
-    secrets?: undefined;
 } | {
     run: boolean;
     provider: "s3";
     options: {
+        directory?: undefined;
         endpoint: string;
         region: string;
         bucket: string;
+        space?: undefined;
+        environment?: undefined;
+        type?: undefined;
+        prefix?: undefined;
+        transformations?: undefined;
+    };
+    secrets: {
+        ACCESS_KEY_ID: string;
+        SECRET_ACCESS_KEY: string;
+        API_KEY?: undefined;
+        API_SECRET?: undefined;
+    };
+} | {
+    run: boolean;
+    provider: "spaces";
+    options: {
         directory?: undefined;
+        endpoint?: undefined;
+        bucket?: undefined;
+        space: string;
+        region: string;
+        environment?: undefined;
+        type?: undefined;
+        prefix?: undefined;
+        transformations?: undefined;
     };
     secrets: {
         ACCESS_KEY_ID: string;
         SECRET_ACCESS_KEY: string;
+        API_KEY?: undefined;
+        API_SECRET?: undefined;
+    };
+} | {
+    run: boolean;
+    provider: "cloudinary";
+    options: {
+        directory?: undefined;
+        endpoint?: undefined;
+        bucket?: undefined;
+        space?: undefined;
+        region?: undefined;
+        environment: string;
+        type: "image";
+        prefix: string;
+        transformations: ({
+            extension: string;
+            transformation: {
+                width: string;
+                height: string;
+                zoom: string;
+                crop: string;
+                gravity: string;
+                angle?: undefined;
+                fetch_format?: undefined;
+            };
+            optional: true;
+            condition?: undefined;
+        } | {
+            extension: string;
+            transformation: {
+                gravity?: undefined;
+                width: string;
+                height: string;
+                zoom: string;
+                crop: string;
+                angle?: undefined;
+                fetch_format?: undefined;
+            };
+            optional: true;
+            condition?: undefined;
+        } | {
+            extension: string;
+            condition: string;
+            transformation: {
+                gravity?: undefined;
+                width?: undefined;
+                height?: undefined;
+                zoom?: undefined;
+                crop?: undefined;
+                angle: number;
+                fetch_format?: undefined;
+            };
+            optional: true;
+        } | {
+            condition?: undefined;
+            extension: string;
+            transformation: {
+                gravity?: undefined;
+                width?: undefined;
+                height?: undefined;
+                zoom?: undefined;
+                crop?: undefined;
+                angle?: undefined;
+                fetch_format: string;
+            };
+            optional: true;
+        })[];
+    };
+    secrets: {
+        ACCESS_KEY_ID?: undefined;
+        SECRET_ACCESS_KEY?: undefined;
+        API_KEY: string;
+        API_SECRET: string;
     };
 })[];
+export interface Suite {
+    run: boolean;
+    provider: keyof typeof providers;
+    options?: S3Options | SpacesOptions | CloudinaryOptions | FileSystemOptions | TemporaryOptions;
+    secrets?: Secrets;
+}

package/transpiled/test/util.js

@@ -1,13 +1,7 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.suites = void 0;
-const node_path_1 = require("node:path");
-const dotenv_1 = __importDefault(require("dotenv"));
-dotenv_1.default.config({ path: (0, node_path_1.join)(__dirname, '.env') });
-exports.suites = [
+import { join } from 'node:path';
+import dotenv from 'dotenv';
+dotenv.config({ path: join(import.meta.dirname, '.env') });
+export const suites = [
     {
         run: true,
         provider: 'tmp',
@@ -15,15 +9,11 @@ exports.suites = [
             directory: 'toa-storages-temp'
         }
     },
-    {
-        run: true,
-        provider: 'mem'
-    },
     {
         run: process.env.RUN_S3 === '1',
         provider: 's3',
         options: {
-            endpoint: 'http://localhost:4566',
+            endpoint: 'http://localhost:31050',
             region: 'us-west-1',
             bucket: 'test-bucket'
         },
@@ -31,6 +21,69 @@ exports.suites = [
             ACCESS_KEY_ID: 'developer',
             SECRET_ACCESS_KEY: 'secret'
         }
+    },
+    {
+        run: process.env.RUN_SPACES === '1',
+        provider: 'spaces',
+        options: {
+            space: 'ants',
+            region: 'fra1'
+        },
+        secrets: {
+            ACCESS_KEY_ID: process.env.SPACES_KEY_ID ?? '',
+            SECRET_ACCESS_KEY: process.env.SPACES_ACCESS_KEY ?? ''
+        }
+    },
+    {
+        run: process.env.RUN_CLOUDINARY === '1',
+        provider: 'cloudinary',
+        options: {
+            environment: 'dl5z4zgth',
+            type: 'image',
+            prefix: 'toa-dev',
+            transformations: [
+                {
+                    extension: '(?<width>\\d*)x(?<height>\\d*)(z(?<zoom>\\d*))?',
+                    transformation: {
+                        width: '<width>',
+                        height: '<height>',
+                        zoom: '<zoom>',
+                        crop: 'thumb',
+                        gravity: 'face'
+                    },
+                    optional: true
+                },
+                {
+                    extension: '\\[(?<width>\\d*)x(?<height>\\d*)\\](z(?<zoom>\\d+))?',
+                    transformation: {
+                        width: '<width>',
+                        height: '<height>',
+                        zoom: '<zoom>',
+                        crop: 'fit'
+                    },
+                    optional: true
+                },
+                {
+                    extension: 'vertical',
+                    condition: 'w_gt_h',
+                    transformation: {
+                        angle: 90
+                    },
+                    optional: true
+                },
+                {
+                    extension: '(?<format>jpeg|webp)',
+                    transformation: {
+                        fetch_format: '<format>'
+                    },
+                    optional: true
+                }
+            ]
+        },
+        secrets: {
+            API_KEY: process.env.CLOUDINARY_API_KEY ?? '',
+            API_SECRET: process.env.CLOUDINARY_API_SECRET ?? ''
+        }
     }
     // add more providers here, use `run` as a condition to run the test
     // e.g.: `run: process.env.ACCESS_KEY_ID !== undefined`

package/transpiled/test/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["../../source/test/util.ts"],"names":[],"mappings":";;;;;;AAAA,yCAAgC;AAChC,oDAA2B;AAO3B,gBAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAA,gBAAI,EAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;AAEnC,QAAA,MAAM,GAAG;IACpB;QACE,GAAG,EAAE,IAAI;QACT,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE;YACP,SAAS,EAAE,mBAAmB;SAC/B;KACF;IACD;QACE,GAAG,EAAE,IAAI;QACT,QAAQ,EAAE,KAAK;KAChB;IACD;QACE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG;QAC/B,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE;YACP,QAAQ,EAAE,uBAAuB;YACjC,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE,aAAa;SACtB;QACD,OAAO,EAAE;YACP,aAAa,EAAE,WAAW;YAC1B,iBAAiB,EAAE,QAAQ;SAC5B;KACF;IACD,oEAAoE;IACpE,uDAAuD;CACtC,CAAA"}
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../source/test/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,MAAM,MAAM,QAAQ,CAAA;AAW3B,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;AAE1D,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB;QACE,GAAG,EAAE,IAAI;QACT,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE;YACP,SAAS,EAAE,mBAAmB;SAC/B;KACF;IACD;QACE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG;QAC/B,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE;YACP,QAAQ,EAAE,wBAAwB;YAClC,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE,aAAa;SACtB;QACD,OAAO,EAAE;YACP,aAAa,EAAE,WAAW;YAC1B,iBAAiB,EAAE,QAAQ;SAC5B;KACF;IACD;QACE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,GAAG;QACnC,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE;YACP,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,MAAM;SACf;QACD,OAAO,EAAE;YACP,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE;YAC9C,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE;SACvD;KACF;IACD;QACE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,GAAG;QACvC,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE;YACP,WAAW,EAAE,WAAW;YACxB,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,SAAS;YACjB,eAAe,EAAE;gBACf;oBACE,SAAS,EAAE,iDAAiD;oBAC5D,cAAc,EAAE;wBACd,KAAK,EAAE,SAAS;wBAChB,MAAM,EAAE,UAAU;wBAClB,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,OAAO;wBACb,OAAO,EAAE,MAAM;qBAChB;oBACD,QAAQ,EAAE,IAAI;iBACf;gBACD;oBACE,SAAS,EAAE,uDAAuD;oBAClE,cAAc,EAAE;wBACd,KAAK,EAAE,SAAS;wBAChB,MAAM,EAAE,UAAU;wBAClB,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,KAAK;qBACZ;oBACD,QAAQ,EAAE,IAAI;iBACf;gBACD;oBACE,SAAS,EAAE,UAAU;oBACrB,SAAS,EAAE,QAAQ;oBACnB,cAAc,EAAE;wBACd,KAAK,EAAE,EAAE;qBACV;oBACD,QAAQ,EAAE,IAAI;iBACf;gBACD;oBACE,SAAS,EAAE,sBAAsB;oBACjC,cAAc,EAAE;wBACd,YAAY,EAAE,UAAU;qBACzB;oBACD,QAAQ,EAAE,IAAI;iBACf;aACF;SACF;QACD,OAAO,EAAE;YACP,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE;YAC7C,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE;SACpD;KACF;IACD,oEAAoE;IACpE,uDAAuD;CACtC,CAAA"}

package/schemas/annotation.cos.yaml

@@ -1,10 +0,0 @@
-type: object
-patternProperties:
-  '^[a-z0-9_]{1,32}$':
-    oneOf:
-      - $ref: s3
-      - $ref: fs
-      - $ref: tmp
-      - $ref: mem
-      - $ref: test
-additionalProperties: false

package/schemas/fs.cos.yaml

@@ -1,9 +0,0 @@
-type: object
-properties:
-  provider:
-    const: fs
-  path:
-    type: string
-    maxLength: 4096
-required: [provider, path]
-additionalProperties: false

package/schemas/mem.cos.yaml

@@ -1,6 +0,0 @@
-type: object
-properties:
-  provider:
-    const: mem
-required: [provider]
-additionalProperties: false

package/schemas/s3.cos.yaml

@@ -1,16 +0,0 @@
-type: object
-properties:
-  provider:
-    const: s3
-  bucket:
-    type: string
-    minLength: 3
-    maxLength: 63
-  region:
-    type: string
-  prefix:
-    type: string
-  endpoint:
-    type: string
-    format: uri
-required: [provider, bucket]

package/schemas/test.cos.yaml

@@ -1,8 +0,0 @@
-type: object
-properties:
-  provider:
-    const: test
-  directory:
-    type: string
-required: [provider, directory]
-additionalProperties: false

package/schemas/tmp.cos.yaml

@@ -1,9 +0,0 @@
-type: object
-properties:
-  provider:
-    type: string
-    const: tmp
-  directory:
-    type: string
-required: [provider, directory]
-additionalProperties: false

package/source/Annotation.ts

@@ -1,39 +0,0 @@
-import assert from 'node:assert'
-import { providers } from './providers'
-import * as schemas from './schemas'
-import type { Declaration } from './providers'
-import type { Schema } from '@toa.io/schemas'
-
-export type Annotation = Record<string, Declaration>
-
-export function validateAnnotation (annotation: unknown): asserts annotation is Annotation {
-  try {
-    schemas.annotation.validate(annotation)
-  } catch (error) {
-    explain(annotation)
-
-    // if all declarations are valid, re-throw the error
-    throw error
-  }
-}
-
-/*
-It is required because `oneOf` schema is used for the annotation validation.
- */
-function explain (annotation: unknown): void {
-  assert.ok(typeof annotation === 'object' && annotation !== null,
-    'TOA_STORAGES is not an object')
-
-  for (const declaration of Object.values(annotation)) {
-    assert.ok(typeof declaration === 'object' && declaration !== null &&
-      declaration.provider in providers,
-      `Unknown provider '${declaration.provider}'`)
-
-    assert.ok(declaration.provider in schemas,
-      `No schema for provider '${declaration.provider}'`)
-
-    const schema: Schema<Declaration> = schemas[declaration.provider as keyof typeof providers]
-
-    schema.validate(declaration, `Storage '${declaration.provider}' annotation`)
-  }
-}

package/source/Aspect.ts

@@ -1,25 +0,0 @@
-import assert from 'node:assert'
-import { Connector, type extensions } from '@toa.io/core'
-import { type Storage, type Storages } from './Storage'
-
-export class Aspect extends Connector implements extensions.Aspect {
-  public readonly name = 'storages'
-
-  private readonly storages: Storages
-
-  public constructor (storages: Storages) {
-    super()
-
-    this.storages = storages
-  }
-
-  public invoke (name: string, method: keyof Storage, ...args: unknown[]): unknown {
-    const storage = this.storages[name]
-
-    assert.ok(storage !== undefined, `Storage '${name}' is not defined`)
-
-    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-    // @ts-expect-error
-    return storage[method](...args)
-  }
-}

package/source/Entry.ts

@@ -1,14 +0,0 @@
-export interface Entry {
-  id: string
-  size: number
-  type: string
-  created: number
-  variants: Variant[]
-  meta: Record<string, unknown>
-}
-
-interface Variant {
-  name: string
-  size: number
-  type: string
-}

package/source/Factory.ts

@@ -1,68 +0,0 @@
-import assert from 'node:assert'
-import { decode } from '@toa.io/generic'
-import { providers } from './providers'
-import { Storage, type Storages } from './Storage'
-import { Aspect } from './Aspect'
-import { SERIALIZATION_PREFIX } from './deployment'
-import { validateAnnotation } from './Annotation'
-import type { Declaration } from './providers'
-import type { Annotation } from './Annotation'
-import type { ProviderConstructor, ProviderSecrets } from './Provider'
-
-export class Factory {
-  private readonly annotation: Annotation
-
-  public constructor () {
-    const env = process.env.TOA_STORAGES
-
-    assert.ok(env !== undefined, 'TOA_STORAGES is not defined')
-
-    this.annotation = decode(env)
-
-    validateAnnotation(this.annotation)
-  }
-
-  public aspect (): Aspect {
-    const storages = this.createStorages()
-
-    return new Aspect(storages)
-  }
-
-  private createStorages (): Storages {
-    const storages: Storages = {}
-
-    for (const [name, declaration] of Object.entries(this.annotation))
-      storages[name] = this.createStorage(name, declaration)
-
-    return storages
-  }
-
-  private createStorage (name: string, declaration: Declaration): Storage {
-    const { provider: providerId, ...options } = declaration
-    const Provider: ProviderConstructor = providers[providerId]
-    const secrets = this.resolveSecrets(name, Provider)
-    const provider = new Provider(options, secrets)
-
-    return new Storage(provider)
-  }
-
-  private resolveSecrets (storageName: string,
-    Class: ProviderConstructor): ProviderSecrets {
-    if (Class.SECRETS === undefined)
-      return {}
-
-    const secrets: Record<string, string | undefined> = {}
-
-    for (const secret of Class.SECRETS) {
-      const variable = `${SERIALIZATION_PREFIX}_${storageName}_${secret.name}`.toUpperCase()
-      const value = process.env[variable]
-
-      assert.ok(secret.optional === true || value !== undefined,
-        `'${variable}' is not defined`)
-
-      secrets[secret.name] = value
-    }
-
-    return secrets
-  }
-}

package/source/Provider.ts

@@ -1,37 +0,0 @@
-import { type Readable } from 'node:stream'
-import * as assert from 'node:assert'
-
-export type ProviderSecrets<K extends string = string> = Record<K | string, string | undefined>
-
-export interface ProviderSecret {
-  readonly name: string
-  readonly optional?: boolean
-}
-
-export abstract class Provider<Options = void> {
-  public static readonly SECRETS: readonly ProviderSecret[] = []
-
-  public constructor (_: Options, secrets?: ProviderSecrets) {
-    for (const { name, optional = false } of new.target.SECRETS)
-      assert.ok(optional || secrets?.[name] !== undefined, `Missing secret '${name}'`)
-  }
-
-  public abstract get (path: string): Promise<Readable | null>
-
-  public abstract list (path: string): Promise<string[]>
-
-  public abstract put (path: string, filename: string, stream: Readable): Promise<void>
-
-  public abstract delete (path: string): Promise<void>
-
-  public abstract move (from: string, to: string): Promise<void>
-
-  public abstract moveDir (from: string, to: string): Promise<void>
-}
-
-export interface ProviderConstructor {
-  readonly SECRETS: readonly ProviderSecret[]
-  prototype: Provider
-
-  new (options: any, secrets?: ProviderSecrets): Provider
-}

package/source/Scanner.ts

@@ -1,153 +0,0 @@
-import { PassThrough, type TransformCallback } from 'node:stream'
-import { createHash } from 'node:crypto'
-import { negotiate } from '@toa.io/agent'
-import { Err } from 'error-value'
-
-export class Scanner extends PassThrough {
-  public size = 0
-  public type = 'application/octet-stream'
-  public error: Error | null = null
-
-  private readonly hash = createHash('md5')
-  private readonly claim?: string
-  private readonly accept?: string
-  private position = 0
-  private detected = false
-  private readonly chunks: Buffer[] = []
-
-  public constructor (control?: ScanOptions) {
-    super()
-
-    this.claim = control?.claim
-    this.accept = control?.accept
-  }
-
-  public digest (): string {
-    return this.hash.digest('hex')
-  }
-
-  public override _transform
-  (buffer: Buffer, encoding: BufferEncoding, callback: TransformCallback): void {
-    super._transform(buffer, encoding, callback)
-
-    this.process(buffer)
-  }
-
-  private readonly process = (buffer: Buffer): void => {
-    this.size += buffer.length
-    this.hash.update(buffer)
-
-    if (this.detected)
-      return
-
-    if (this.position + buffer.length > HEADER_SIZE)
-      buffer = buffer.subarray(0, HEADER_SIZE - this.position)
-
-    this.chunks.push(buffer)
-    this.position += buffer.length
-
-    if (this.position === HEADER_SIZE)
-      this.complete()
-  }
-
-  private complete (): void {
-    const header = Buffer.concat(this.chunks).toString('hex')
-
-    const signature = SIGNATURES
-      .find(({ off, hex, expression }) => {
-        const sig = header.slice(off, off + hex.length)
-
-        return expression === undefined
-          ? sig === hex
-          : expression.test(sig)
-      })
-
-    const type = signature?.type ?? this.claim
-
-    if (type !== undefined) {
-      this.match(type)
-      this.type = type
-    }
-
-    this.verify(signature)
-    this.detected = true
-  }
-
-  private verify (signature: Signature | undefined): void {
-    if (this.claim === undefined || this.claim === 'application/octet-stream')
-      return
-
-    const mismatch = signature === undefined
-      ? KNOWN_TYPES.has(this.claim)
-      : this.claim !== signature.type
-
-    if (mismatch)
-      this.interrupt(ERR_TYPE_MISMATCH)
-  }
-
-  private match (type: string): void {
-    if (this.accept === undefined)
-      return
-
-    const unacceptable = negotiate(this.accept, [type]) === null
-
-    if (unacceptable)
-      this.interrupt(ERR_NOT_ACCEPTABLE)
-  }
-
-  private interrupt (error: Error): void {
-    this.error = error
-    this.end()
-  }
-}
-
-// https://en.wikipedia.org/wiki/List_of_file_signatures
-const SIGNATURES: Signature[] = [
-  { hex: 'ff d8 ff e0', off: 0, type: 'image/jpeg' },
-  { hex: 'ff d8 ff e1', 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' },
-  { hex: '47 49 46 38', off: 0, type: 'image/gif' },
-  { hex: '52 49 46 46 ?? ?? ?? ?? 57 45 42 50', off: 0, type: 'image/webp' },
-  { hex: '4a 58 4c 20 0d 0a 87 0a', off: 8, type: 'image/jxl' },
-  { hex: '66 74 79 70 68 65 69 63', off: 8, type: 'image/heic' },
-  { hex: '66 74 79 70 61 76 69 66', off: 8, type: 'image/avif' },
-  { hex: '52 49 46 46 ?? ?? ?? ?? 41 56 49 20', off: 0, type: 'video/avi' },
-  { 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`.
-   */
-].map((signature: Signature) => {
-  signature.hex = signature.hex.replaceAll(' ', '')
-
-  if (signature.hex.includes('??')) {
-    const expression = signature.hex.replaceAll(/(?<wildcards>\?{1,24})/g,
-      (_, wildcards) => `[0-9a-f]{${wildcards.length}}`)
-
-    signature.expression = new RegExp(expression, 'i')
-  }
-
-  return signature
-})
-
-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 = Err('TYPE_MISMATCH')
-const ERR_NOT_ACCEPTABLE = Err('NOT_ACCEPTABLE')
-
-export interface ScanOptions {
-  claim?: string
-  accept?: string
-}
-
-interface Signature {
-  type: string
-  off: number
-  hex: string
-  expression?: RegExp
-}