@stacksjs/storage 0.70.87 → 0.70.88

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/storage",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.87",
+  "version": "0.70.88",
   "description": "The Stacks file system.",
   "author": "Chris Breuer",
   "contributors": [
@@ -63,12 +63,12 @@
     }
   },
   "devDependencies": {
-    "@stacksjs/arrays": "0.70.87",
+    "@stacksjs/arrays": "0.70.88",
     "better-dx": "^0.2.16",
-    "@stacksjs/error-handling": "0.70.87",
-    "@stacksjs/path": "0.70.87",
-    "@stacksjs/strings": "0.70.87",
-    "@stacksjs/types": "0.70.87",
+    "@stacksjs/error-handling": "0.70.88",
+    "@stacksjs/path": "0.70.88",
+    "@stacksjs/strings": "0.70.88",
+    "@stacksjs/types": "0.70.88",
     "sharp": "^0.35.3"
   }
 }

package/dist/adapters/bun.d.ts

@@ -1,31 +0,0 @@
-import { Buffer } from 'node:buffer';
-import type { ChecksumOptions, DirectoryListing, FileContents, GetStreamOptions, ListOptions, MimeTypeOptions, PublicUrlOptions, PutResult, PutStreamOptions, SignedUrlOptions, StatEntry, StorageAdapter, StorageAdapterConfig, TemporaryUrlOptions, Visibility } from '../types';
-export declare function createBunStorage(config?: StorageAdapterConfig): BunStorageAdapter;
-export declare class BunStorageAdapter implements StorageAdapter {
-  constructor(config?: StorageAdapterConfig);
-  write(path: string, contents: FileContents): Promise<PutResult>;
-  read(path: string): Promise<FileContents>;
-  getStream(path: string, _options?: GetStreamOptions): Promise<ReadableStream<Uint8Array>>;
-  putStream(path: string, stream: ReadableStream<Uint8Array>, options?: PutStreamOptions): Promise<PutResult>;
-  readToString(path: string): Promise<string>;
-  readToBuffer(path: string): Promise<Buffer>;
-  readToUint8Array(path: string): Promise<Uint8Array>;
-  deleteFile(path: string): Promise<void>;
-  deleteDirectory(path: string): Promise<void>;
-  createDirectory(path: string): Promise<void>;
-  moveFile(from: string, to: string): Promise<void>;
-  copyFile(from: string, to: string): Promise<void>;
-  stat(path: string): Promise<StatEntry>;
-  list(path: string, options?: ListOptions): DirectoryListing;
-  changeVisibility(path: string, vis: Visibility): Promise<void>;
-  visibility(path: string): Promise<Visibility>;
-  fileExists(path: string): Promise<boolean>;
-  directoryExists(path: string): Promise<boolean>;
-  publicUrl(path: string, options?: PublicUrlOptions): Promise<string>;
-  temporaryUrl(path: string, options: TemporaryUrlOptions): Promise<string>;
-  signedUrl(path: string, options: SignedUrlOptions): Promise<string>;
-  checksum(path: string, options?: ChecksumOptions): Promise<string>;
-  mimeType(path: string, _options?: MimeTypeOptions): Promise<string>;
-  lastModified(path: string): Promise<number>;
-  fileSize(path: string): Promise<number>;
-}

package/dist/adapters/index.d.ts

@@ -1,6 +0,0 @@
-export * from './local';
-export * from './memory';
-export * from './s3';
-export * from './bun';
-// Per-tenant prefix scoping wrapper (stacksjs/stacks#1887 S-11)
-export * from './scoped';

package/dist/adapters/local.d.ts

@@ -1,38 +0,0 @@
-import { Buffer } from 'node:buffer';
-import { copyFile, stat } from 'node:fs/promises';
-import type { ChecksumOptions, DirectoryListing, FileContents, GetStreamOptions, ListOptions, MimeTypeOptions, PublicUrlOptions, PutResult, PutStreamOptions, SignedUrlOptions, StatEntry, StorageAdapter, StorageAdapterConfig, TemporaryUrlOptions, Visibility } from '../types';
-/**
- * Create a local storage adapter instance
- */
-export declare function createLocalStorage(config?: StorageAdapterConfig): LocalStorageAdapter;
-/**
- * Local filesystem storage adapter using Node.js fs APIs
- */
-export declare class LocalStorageAdapter implements StorageAdapter {
-  constructor(config?: StorageAdapterConfig);
-  write(path: string, contents: FileContents): Promise<PutResult>;
-  read(path: string): Promise<FileContents>;
-  getStream(path: string, options?: GetStreamOptions): Promise<ReadableStream<Uint8Array>>;
-  putStream(path: string, stream: ReadableStream<Uint8Array>, options?: PutStreamOptions): Promise<PutResult>;
-  readToString(path: string): Promise<string>;
-  readToBuffer(path: string): Promise<Buffer>;
-  readToUint8Array(path: string): Promise<Uint8Array>;
-  deleteFile(path: string): Promise<void>;
-  deleteDirectory(path: string): Promise<void>;
-  createDirectory(path: string): Promise<void>;
-  moveFile(from: string, to: string): Promise<void>;
-  copyFile(from: string, to: string): Promise<void>;
-  stat(path: string): Promise<StatEntry>;
-  list(path: string, options?: ListOptions): DirectoryListing;
-  changeVisibility(path: string, vis: Visibility): Promise<void>;
-  visibility(path: string): Promise<Visibility>;
-  fileExists(path: string): Promise<boolean>;
-  directoryExists(path: string): Promise<boolean>;
-  publicUrl(path: string, options?: PublicUrlOptions): Promise<string>;
-  temporaryUrl(path: string, options: TemporaryUrlOptions): Promise<string>;
-  signedUrl(path: string, options: SignedUrlOptions): Promise<string>;
-  checksum(path: string, options?: ChecksumOptions): Promise<string>;
-  mimeType(path: string, options?: MimeTypeOptions): Promise<string>;
-  lastModified(path: string): Promise<number>;
-  fileSize(path: string): Promise<number>;
-}

package/dist/adapters/memory.d.ts

@@ -1,38 +0,0 @@
-import { Buffer } from 'node:buffer';
-import type { ChecksumOptions, DirectoryListing, FileContents, GetStreamOptions, ListOptions, MimeTypeOptions, PublicUrlOptions, PutResult, PutStreamOptions, SignedUrlOptions, StatEntry, StorageAdapter, TemporaryUrlOptions, Visibility } from '../types';
-/**
- * Create an in-memory storage adapter instance
- */
-export declare function createMemoryStorage(): InMemoryStorageAdapter;
-/**
- * In-memory storage adapter for testing and temporary storage
- */
-export declare class InMemoryStorageAdapter implements StorageAdapter {
-  constructor();
-  write(path: string, contents: FileContents): Promise<PutResult>;
-  read(path: string): Promise<FileContents>;
-  getStream(path: string, _options?: GetStreamOptions): Promise<ReadableStream<Uint8Array>>;
-  putStream(path: string, stream: ReadableStream<Uint8Array>, options?: PutStreamOptions): Promise<PutResult>;
-  readToString(path: string): Promise<string>;
-  readToBuffer(path: string): Promise<Buffer>;
-  readToUint8Array(path: string): Promise<Uint8Array>;
-  deleteFile(path: string): Promise<void>;
-  deleteDirectory(path: string): Promise<void>;
-  createDirectory(path: string): Promise<void>;
-  moveFile(from: string, to: string): Promise<void>;
-  copyFile(from: string, to: string): Promise<void>;
-  stat(path: string): Promise<StatEntry>;
-  list(path: string, options?: ListOptions): DirectoryListing;
-  changeVisibility(path: string, visibility: Visibility): Promise<void>;
-  visibility(path: string): Promise<Visibility>;
-  fileExists(path: string): Promise<boolean>;
-  directoryExists(path: string): Promise<boolean>;
-  publicUrl(path: string, options?: PublicUrlOptions): Promise<string>;
-  temporaryUrl(path: string, options: TemporaryUrlOptions): Promise<string>;
-  signedUrl(_path: string, _options: SignedUrlOptions): Promise<string>;
-  checksum(path: string, options?: ChecksumOptions): Promise<string>;
-  mimeType(path: string, _options?: MimeTypeOptions): Promise<string>;
-  lastModified(path: string): Promise<number>;
-  fileSize(path: string): Promise<number>;
-  clear(): void;
-}

package/dist/adapters/s3.d.ts

@@ -1,53 +0,0 @@
-import { Buffer } from 'node:buffer';
-import type { ChecksumOptions, DirectoryListing, FileContents, GetStreamOptions, ListOptions, MimeTypeOptions, PresignedUploadPolicy, PresignedUploadPolicyOptions, PresignedUploadUrl, PresignedUploadUrlOptions, PublicUrlOptions, PutResult, PutStreamOptions, SignedUrlOptions, StatEntry, StorageAdapter, StorageAdapterConfig, TemporaryUrlOptions, Visibility } from '../types';
-import type { S3Client } from '@stacksjs/ts-cloud';
-/**
- * Create an S3 storage adapter instance
- */
-export declare function createS3Storage(client: S3Client | null, config: StorageAdapterConfig): S3StorageAdapter;
-/**
- * Append-and-take byte buffer used by the multipart pipeline
- * (stacksjs/stacks#1886). Holds incoming chunks until they reach
- * the configured part size, then yields them as a single Uint8Array
- * via `take(n)` or `flush()`.
- */
-declare class ChunkBuffer {
-  constructor(_partSize: number);
-  get length(): number;
-  push(c: Uint8Array): void;
-  take(n: number): Uint8Array;
-  flush(): Uint8Array;
-}
-/**
- * AWS S3 storage adapter using ts-cloud S3Client
- */
-export declare class S3StorageAdapter implements StorageAdapter {
-  constructor(client: S3Client | null, config: StorageAdapterConfig);
-  write(path: string, contents: FileContents): Promise<PutResult>;
-  read(path: string): Promise<FileContents>;
-  getStream(path: string, _options?: GetStreamOptions): Promise<ReadableStream<Uint8Array>>;
-  putStream(path: string, stream: ReadableStream<Uint8Array>, options?: PutStreamOptions): Promise<PutResult>;
-  readToString(path: string): Promise<string>;
-  readToBuffer(path: string): Promise<Buffer>;
-  readToUint8Array(path: string): Promise<Uint8Array>;
-  deleteFile(path: string): Promise<void>;
-  deleteDirectory(path: string): Promise<void>;
-  createDirectory(_path: string): Promise<void>;
-  moveFile(from: string, to: string): Promise<void>;
-  copyFile(from: string, to: string): Promise<void>;
-  stat(path: string): Promise<StatEntry>;
-  list(path: string, options?: ListOptions): DirectoryListing;
-  changeVisibility(path: string, vis: Visibility): Promise<void>;
-  visibility(path: string): Promise<Visibility>;
-  fileExists(path: string): Promise<boolean>;
-  directoryExists(path: string): Promise<boolean>;
-  publicUrl(path: string, options?: PublicUrlOptions): Promise<string>;
-  temporaryUrl(path: string, options: TemporaryUrlOptions): Promise<string>;
-  signedUrl(path: string, options: SignedUrlOptions): Promise<string>;
-  presignedUploadUrl(options: PresignedUploadUrlOptions): Promise<PresignedUploadUrl>;
-  presignedUploadPolicy(options: PresignedUploadPolicyOptions): Promise<PresignedUploadPolicy>;
-  checksum(path: string, options?: ChecksumOptions): Promise<string>;
-  mimeType(path: string, _options?: MimeTypeOptions): Promise<string>;
-  lastModified(path: string): Promise<number>;
-  fileSize(path: string): Promise<number>;
-}

package/dist/adapters/scoped.d.ts

@@ -1,68 +0,0 @@
-import type { ChecksumOptions, DirectoryListing, FileContents, GetStreamOptions, ListOptions, MimeTypeOptions, PresignedUploadPolicy, PresignedUploadPolicyOptions, PresignedUploadUrl, PresignedUploadUrlOptions, PublicUrlOptions, PutResult, PutStreamOptions, SignedUrlOptions, StatEntry, StorageAdapter, TemporaryUrlOptions, Visibility } from '../types';
-/**
- * Convenience factory — most app code reads cleaner with the
- * function form than `new ScopedStorageAdapter(...)`.
- *
- * @example
- * ```ts
- * const tenantDisk = scoped(Storage.disk('s3'), { scope: `tenant-${id}` })
- * ```
- */
-export declare function scoped(inner: StorageAdapter, options: ScopedAdapterOptions): ScopedStorageAdapter;
-/**
- * Configuration for a scoped adapter.
- */
-export declare interface ScopedAdapterOptions {
-  scope: string
-  scopePattern?: RegExp
-}
-/**
- * Wrap any `StorageAdapter` to scope every operation under a
- * per-tenant prefix. The wrapped instance presents the same
- * `StorageAdapter` interface so the session middleware /
- * `Storage.disk()` / cross-disk copy all work transparently.
- *
- * Construction validates the scope against
- * {@link ScopedAdapterOptions.scopePattern} so a hostile or
- * malformed tenant id can't escape via `..` segments or path
- * separators.
- *
- * @example
- * ```ts
- * const tenantDisk = new ScopedStorageAdapter(
- *   Storage.disk('s3'),
- *   { scope: `tenant-${tenantId}` },
- * )
- * await tenantDisk.write('avatar.jpg', file)  // → tenant-42/avatar.jpg
- * ```
- */
-export declare class ScopedStorageAdapter implements StorageAdapter {
-  constructor(inner: StorageAdapter, options: ScopedAdapterOptions);
-  write(path: string, contents: FileContents): Promise<PutResult>;
-  read(path: string): Promise<FileContents>;
-  readToString(path: string): Promise<string>;
-  readToBuffer(path: string): Promise<Buffer>;
-  readToUint8Array(path: string): Promise<Uint8Array>;
-  deleteFile(path: string): Promise<void>;
-  deleteDirectory(path: string): Promise<void>;
-  createDirectory(path: string): Promise<void>;
-  moveFile(from: string, to: string): Promise<void>;
-  copyFile(from: string, to: string): Promise<void>;
-  stat(path: string): Promise<StatEntry>;
-  list(path: string, options?: ListOptions): DirectoryListing;
-  changeVisibility(path: string, visibility: Visibility): Promise<void>;
-  visibility(path: string): Promise<Visibility>;
-  fileExists(path: string): Promise<boolean>;
-  directoryExists(path: string): Promise<boolean>;
-  publicUrl(path: string, options?: PublicUrlOptions): Promise<string>;
-  temporaryUrl(path: string, options: TemporaryUrlOptions): Promise<string>;
-  signedUrl(path: string, options: SignedUrlOptions): Promise<string>;
-  presignedUploadUrl(options: PresignedUploadUrlOptions): Promise<PresignedUploadUrl>;
-  presignedUploadPolicy(options: PresignedUploadPolicyOptions): Promise<PresignedUploadPolicy>;
-  getStream(path: string, options?: GetStreamOptions): Promise<ReadableStream<Uint8Array>>;
-  putStream(path: string, stream: ReadableStream<Uint8Array>, options?: PutStreamOptions): Promise<PutResult>;
-  checksum(path: string, options?: ChecksumOptions): Promise<string>;
-  mimeType(path: string, options?: MimeTypeOptions): Promise<string>;
-  lastModified(path: string): Promise<number>;
-  fileSize(path: string): Promise<number>;
-}

package/dist/copy.d.ts

@@ -1,3 +0,0 @@
-export declare function copy(src: string | string[], dest: string, exclude?: string[]): void;
-export declare function copyFile(src: string, dest: string): void;
-export declare function copyFolder(src: string, dest: string, exclude?: string[]): void;

package/dist/delete.d.ts

@@ -1,8 +0,0 @@
-import type { Result } from '@stacksjs/error-handling';
-export declare function deleteFolder(path: string): Promise<Result<string, Error>>;
-export declare function isDirectoryEmpty(path: string): Promise<Result<boolean, Error>>;
-export declare function deleteEmptyFolder(path: string): Promise<Result<string, Error>>;
-export declare function deleteEmptyFolders(dir: string): Promise<Result<string, Error>>;
-export declare function deleteFile(path: string): Promise<Result<string, Error>>;
-export declare function deleteGlob(path: string): Promise<Result<string, Error>>;
-export declare function del(path: string): Promise<Result<string, Error>>;

package/dist/drivers/aws.d.ts

@@ -1,4 +0,0 @@
-import type { StorageAdapter } from '../types';
-import type { StorageDriver } from '@stacksjs/types';
-export declare function getAwsStorage(): Promise<StorageAdapter>;
-export declare const aws: StorageDriver;

package/dist/drivers/bun.d.ts

@@ -1,4 +0,0 @@
-import type { StorageAdapter } from '../types';
-import type { StorageDriver } from '@stacksjs/types';
-export declare function getBunStorage(): Promise<StorageAdapter>;
-export declare const bun: StorageDriver;

package/dist/drivers/index.d.ts

@@ -1,4 +0,0 @@
-export * from './aws';
-export * from './local';
-export * from './memory';
-export * from './bun';

package/dist/drivers/local.d.ts

@@ -1,4 +0,0 @@
-import type { StorageAdapter } from '../types';
-import type { StorageDriver } from '@stacksjs/types';
-export declare function getLocalStorage(): Promise<StorageAdapter>;
-export declare const local: StorageDriver;

package/dist/drivers/memory.d.ts

@@ -1,4 +0,0 @@
-import type { StorageDriver } from '@stacksjs/types';
-declare const adapter: unknown;
-export declare const memoryStorage: unknown;
-export declare const memory: StorageDriver;

package/dist/facade.d.ts

@@ -1,53 +0,0 @@
-import type { DiskConfig, DiskName, FilesystemConfig, LocalDiskConfig, S3DiskConfig } from './types/filesystem';
-import type { GetStreamOptions, PresignedUploadPolicy, PresignedUploadPolicyOptions, PresignedUploadUrl, PresignedUploadUrlOptions, PutResult, PutStreamOptions, SignedUrlOptions, StatEntry, StorageAdapter } from './types';
-import type { PutFileOptions, UploadedFileLike } from './put-file';
-export type {
-  DiskConfig,
-  FilesystemConfig,
-  LocalDiskConfig,
-  S3DiskConfig,
-} from './types/filesystem';
-// =============================================================================
-// Exports
-// =============================================================================
-export declare const Storage: StorageManager;
-// =============================================================================
-// Storage Manager
-// =============================================================================
-declare class StorageManager {
-  init(config: Partial<FilesystemConfig>): this;
-  disk(name?: DiskName): StorageAdapter;
-  put(path: string, contents: string | Uint8Array | Buffer): Promise<PutResult>;
-  put(file: UploadedFileLike, opts?: PutFileOptions): Promise<PutResult & { url: string }>;
-  put(pathOrFile: string | UploadedFileLike, contentsOrOpts?: string | Uint8Array | Buffer | PutFileOptions): Promise<PutResult | (PutResult & { url: string })>;
-  stat(path: string): Promise<StatEntry>;
-  getStream(path: string, options?: GetStreamOptions): Promise<ReadableStream<Uint8Array>>;
-  putStream(path: string, stream: ReadableStream<Uint8Array>, options?: PutStreamOptions): Promise<PutResult>;
-  copyAcross(source: string, dest: string): Promise<PutResult>;
-  moveAcross(source: string, dest: string): Promise<PutResult>;
-  get(path: string): Promise<string>;
-  exists(path: string): Promise<boolean>;
-  missing(path: string): Promise<boolean>;
-  delete(path: string): Promise<void>;
-  copy(from: string, to: string): Promise<void>;
-  move(from: string, to: string): Promise<void>;
-  url(path: string): Promise<string>;
-  signedUrl(path: string, options: SignedUrlOptions): Promise<string>;
-  presignedUploadUrl(options: PresignedUploadUrlOptions): Promise<PresignedUploadUrl>;
-  presignedUploadPolicy(options: PresignedUploadPolicyOptions): Promise<PresignedUploadPolicy>;
-  size(path: string): Promise<number>;
-  lastModified(path: string): Promise<number>;
-  mimeType(path: string): Promise<string>;
-  checksum(path: string, algorithm?: 'md5' | 'sha1' | 'sha256'): Promise<string>;
-  makeDirectory(path: string): Promise<void>;
-  deleteDirectory(path: string): Promise<void>;
-  files(path?: string): AsyncIterable<{ path: string; type: 'file' | 'directory' }>;
-  allFiles(path?: string): AsyncIterable<{ path: string; type: 'file' | 'directory' }>;
-  configure(name: string, config: DiskConfig): this;
-  setDefaultDisk(name: string): this;
-  getDiskConfig(name?: string): DiskConfig | undefined;
-  getConfiguredDisks(): string[];
-  getDefaultDisk(): string;
-  reset(): this;
-}
-export { StorageManager };

package/dist/files.d.ts

@@ -1,52 +0,0 @@
-import type { JsonFile, PackageJson, TextFile } from '@stacksjs/types';
-/**
- * Reads a JSON file and returns the parsed data.
- */
-export declare function readJsonFile(name: string, cwd?: string): Promise<JsonFile>;
-/**
- * Reads a package.json file and returns the parsed data.
- */
-export declare function readPackageJson(name: string, cwd?: string): Promise<PackageJson>;
-/**
- * Writes the given text to the specified file.
- */
-export declare function writeFile(path: string, data: any): Promise<number>;
-/**
- * Writes the given data to the specified JSON file.
- */
-export declare function writeJsonFile(file: JsonFile): Promise<number>;
-/**
- * Reads a text file and returns its contents.
- */
-export declare function readTextFile(name: string, cwd?: string): Promise<TextFile>;
-/**
- * Writes the given text to the specified file.
- */
-export declare function writeTextFile(file: TextFile): Promise<number>;
-export declare function doesExist(path: string): boolean;
-export declare function doesNotExist(path: string): boolean;
-/**
- * Determine whether a folder has any files in it.
- */
-export declare function hasFiles(folder: string): boolean;
-export declare function hasComponents(): boolean;
-export declare function hasFunctions(): boolean;
-export declare function deleteFiles(dir: string, exclude?: string[]): void;
-export declare function getFiles(dir: string, exclude?: string[]): string[];
-export declare function put(path: string, contents: string): void;
-export declare function get(path: string): Promise<string>;
-export declare const files: Files;
-export declare interface Files {
-  readJsonFile: typeof readJsonFile
-  readPackageJson: typeof readPackageJson
-  readTextFile: typeof readTextFile
-  writeJsonFile: typeof writeJsonFile
-  writeTextFile: typeof writeTextFile
-  hasFiles: typeof hasFiles
-  hasComponents: typeof hasComponents
-  hasFunctions: typeof hasFunctions
-  deleteFiles: typeof deleteFiles
-  getFiles: typeof getFiles
-  put: typeof put
-  get: typeof get
-}

package/dist/folders.d.ts

@@ -1,18 +0,0 @@
-/**
- * Determine whether a path is a folder.
- */
-export declare function isFolder(path: string): boolean;
-// export function isDirectory(path: string): boolean {
-//   return isFolder(path)
-// }
-export declare function isDir(path: string): boolean;
-export declare function doesFolderExist(path: string): boolean;
-export declare function createFolder(dir: string): Promise<void>;
-export declare function getFolders(dir: string): string[];
-export declare const folders: Folders;
-export declare interface Folders {
-  isFolder: (path: string) => boolean
-  doesFolderExist: (path: string) => boolean
-  createFolder: (dir: string) => Promise<void>
-  getFolders: (dir: string) => string[]
-}

package/dist/fs.d.ts

@@ -1,4 +0,0 @@
-import { existsSync, watch as fsWatch, mkdirSync, readFileSync, watchFile, writeFileSync } from 'node:fs';
-import * as fs from 'node:fs';
-export declare function exists(path: string): boolean;
-export { existsSync, fsWatch, mkdirSync, readFileSync, watchFile, writeFileSync, fs };

package/dist/glob.d.ts

@@ -1,13 +0,0 @@
-export declare function globSync(patterns: string | string[], options?: Omit<GlobOptions, 'patterns'>): string[];
-export declare function glob(patterns: string | string[], options?: Omit<GlobOptions, 'patterns'>): Promise<string[]>;
-export declare interface GlobOptions {
-  absolute?: boolean
-  cwd?: string
-  patterns?: string[]
-  ignore?: string[]
-  dot?: boolean
-  deep?: number
-  expandDirectories?: boolean
-  onlyDirectories?: boolean
-  onlyFiles?: boolean
-}

package/dist/hash.d.ts

@@ -1,5 +0,0 @@
-import type { Hash } from 'node:crypto';
-export declare function hashFileOrDirectory(path: string, hash: Hash): void;
-export declare function hashDirectory(directory: string): string;
-export declare function hashPath(path: string): string;
-export declare function hashPaths(paths: string | string[]): string;

package/dist/helpers.d.ts

@@ -1,7 +0,0 @@
-export declare function updateConfigFile(filePath: string, newConfig: Record<string, unknown>): Promise<void>;
-export declare const _dirname: string;
-export declare const helpers: Helpers;
-declare interface Helpers {
-  _dirname: string
-  updateConfigFile: (filePath: string, newConfig: Record<string, unknown>) => Promise<void>
-}

package/dist/image.d.ts

@@ -1,55 +0,0 @@
-/**
- * Wrap a Sharp pipeline so it composes with
- * `Storage.put(file, { transform })`. The pipeline function receives a
- * fresh Sharp instance preloaded with the file's bytes; its return
- * value is the final pipeline chain (sharp's methods are chainable so
- * "return img.resize(...)" is the normal shape).
- *
- * The wrapper handles the buffer normalisation + final `.toBuffer()`
- * call so callers don't have to.
- */
-export declare function transform(pipeline: (img: SharpInstance) => SharpInstance | Promise<SharpInstance>): (input: Uint8Array | Buffer | ArrayBuffer) => Promise<Buffer>;
-/**
- * Common preset for square avatars — resizes + crops to fit, encodes
- * as WebP at quality 85. Covers the by-far most common
- * `Storage.put(file, { transform: ... })` callsite.
- *
- * @example
- * ```ts
- * import { avatar } from '@stacksjs/storage/image'
- *
- * await Storage.put(file, {
- *   dir: 'avatars',
- *   transform: avatar(512),
- * })
- * ```
- */
-export declare function avatar(size?: number, quality?: number): (input: Uint8Array | Buffer | ArrayBuffer) => Promise<Buffer>;
-/**
- * Generic resize preset. `fit` defaults to `'inside'` (preserve aspect
- * ratio, don't crop) which is the most common non-avatar case.
- */
-export declare function resize(width: number, height: number, fit?: 'cover' | 'contain' | 'fill' | 'inside' | 'outside'): (input: Uint8Array | Buffer | ArrayBuffer) => Promise<Buffer>;
-/**
- * Strip EXIF + colour profile + other embedded metadata. Useful when
- * accepting user uploads where you don't want to leak GPS coordinates
- * embedded in phone photos. Pairs well with resize/format presets via
- * the explicit `transform()` form when needed.
- *
- * sharp strips metadata by default unless `withMetadata()` is called;
- * this preset just makes the intent explicit.
- */
-export declare function stripMetadata(): (input: Uint8Array | Buffer | ArrayBuffer) => Promise<Buffer>;
-declare interface SharpInstance {
-  toBuffer(): Promise<Buffer>
-  resize: (...args: unknown[]) => SharpInstance
-  jpeg: (...args: unknown[]) => SharpInstance
-  png: (...args: unknown[]) => SharpInstance
-  webp: (...args: unknown[]) => SharpInstance
-  avif: (...args: unknown[]) => SharpInstance
-  gif: (...args: unknown[]) => SharpInstance
-  rotate: (...args: unknown[]) => SharpInstance
-  blur: (...args: unknown[]) => SharpInstance
-  withMetadata: (...args: unknown[]) => SharpInstance
-  [k: string]: unknown
-}

package/dist/image.js

@@ -1,43 +0,0 @@
-// @bun
-var __require = import.meta.require;
-
-// src/image.ts
-var cachedSharp = null;
-async function loadSharp() {
-  if (cachedSharp)
-    return cachedSharp;
-  try {
-    const mod = await import("sharp");
-    cachedSharp = mod.default ?? mod;
-    return cachedSharp;
-  } catch (err) {
-    throw new Error(`[storage/image] \`sharp\` is not installed. Image transforms require it as a peer dependency.
-  Install with: \`bun add sharp\`
-  Original load error: ${err instanceof Error ? err.message : String(err)}`);
-  }
-}
-function transform(pipeline) {
-  return async (input) => {
-    const sharp = await loadSharp();
-    const bytes = input instanceof ArrayBuffer ? new Uint8Array(input) : input;
-    const buf = Buffer.isBuffer(bytes) ? bytes : Buffer.from(bytes);
-    const img = sharp(buf);
-    const piped = await pipeline(img);
-    return piped.toBuffer();
-  };
-}
-function avatar(size = 512, quality = 85) {
-  return transform((img) => img.resize(size, size, { fit: "cover" }).webp({ quality }));
-}
-function resize(width, height, fit = "inside") {
-  return transform((img) => img.resize(width, height, { fit }));
-}
-function stripMetadata() {
-  return transform((img) => img);
-}
-export {
-  transform,
-  stripMetadata,
-  resize,
-  avatar
-};

package/dist/index.d.ts

@@ -1,60 +0,0 @@
-export type { ServeFileOptions } from './static-serve';
-export type { DiskConfig, FilesystemConfig, LocalDiskConfig, S3DiskConfig } from './facade';
-export type { FilenameStrategy, PutFileOptions, UploadedFileLike } from './put-file';
-// Disk-name autocomplete: userland augments `KnownDisks` to get
-// completion on `Storage.disk('…')` (stacksjs/stacks#1924).
-export type { DiskName, KnownDisks } from './types/filesystem';
-export type { SignedTokenVerification } from './signed-url';
-export type { SignedUrlOptions } from './types';
-export type { ParsedDiskPath } from './path-sanitize';
-export type { MimeVerifyResult } from './mime-verify';
-export type { S3PresignedPostInput, S3PresignedPostResult } from './s3-presigned-post';
-export type {
-  GetStreamOptions,
-  PresignedUploadPolicy,
-  PresignedUploadPolicyOptions,
-  PutResult,
-  PutStreamOptions,
-} from './types';
-export * from './copy';
-export * from './delete';
-export * from './files';
-export * from './folders';
-export * from './fs';
-export * from './glob';
-export * from './hash';
-export * from './helpers';
-export * as storage from './storage';
-export * from './zip';
-// Storage adapters and types
-export * from './adapters/index';
-export * from './types';
-export * from './drivers/index';
-// Static asset serving with ETag/Last-Modified/Cache-Control
-export { serveFile } from './static-serve';
-// Laravel-style Storage facade and UploadedFile
-export { Storage, StorageManager } from './facade';
-export { UploadedFile, uploadedFile, uploadedFiles } from './uploaded-file';
-// Filesystem type helpers
-export { configFromEnv, localDisk, s3Disk } from './types/filesystem';
-// Signed-URL helpers (used by Storage.disk('local').signedUrl())
-export {
-  clearRevokedSignedStorageTokens,
-  createSignedStorageToken,
-  isSignedStorageTokenRevoked,
-  revokeSignedStorageToken,
-  verifySignedStorageToken,
-} from './signed-url';
-// Path-sanitization helpers (used internally by S3 presignedUploadUrl;
-// also re-exported so user code can pre-validate input from request
-// bodies and surface 400s with a clean `PathSanitizeError`.)
-export { parseDiskPath, PathSanitizeError, sanitizePresignedDir, sanitizePresignedFilename } from './path-sanitize';
-// MIME re-verification — server-side check that uploaded bytes match
-// the claimed content type. Run this after a presigned upload
-// completes since `Content-Type` on a presigned PUT is caller-attested.
-export { detectMimeFromMagicBytes, verifyUploadedMime } from './mime-verify';
-// S3 presigned-POST policy signer (stacksjs/stacks#1888 Phase B).
-// Exposed as a standalone for callers that have their own S3 client
-// and just need the policy-signing logic; the Storage facade wraps
-// it as `presignedUploadPolicy()`.
-export { signS3PresignedPost } from './s3-presigned-post';