@happyvertical/files 0.74.8

package/dist/shared/types.d.ts

@@ -0,0 +1,464 @@
+/**
+ * Core types and interfaces for the Files library
+ */
+/**
+ * Options for reading files
+ */
+export interface ReadOptions {
+    /**
+     * Text encoding for reading the file
+     */
+    encoding?: BufferEncoding;
+    /**
+     * Whether to return raw buffer data instead of string
+     */
+    raw?: boolean;
+}
+/**
+ * Options for writing files
+ */
+export interface WriteOptions {
+    /**
+     * Text encoding for writing the file
+     */
+    encoding?: BufferEncoding;
+    /**
+     * File mode (permissions)
+     */
+    mode?: number;
+    /**
+     * Whether to create parent directories if they don't exist
+     */
+    createParents?: boolean;
+}
+/**
+ * Options for creating directories
+ */
+export interface CreateDirOptions {
+    /**
+     * Whether to create parent directories recursively
+     */
+    recursive?: boolean;
+    /**
+     * Directory mode (permissions)
+     */
+    mode?: number;
+}
+/**
+ * Options for listing directory contents
+ */
+export interface ListOptions {
+    /**
+     * Whether to include subdirectories
+     */
+    recursive?: boolean;
+    /**
+     * Filter pattern for file names
+     */
+    filter?: RegExp | string;
+    /**
+     * Whether to return full file information
+     */
+    detailed?: boolean;
+}
+/**
+ * Options for file upload operations
+ */
+export interface UploadOptions {
+    /**
+     * Content type for the upload
+     */
+    contentType?: string;
+    /**
+     * Whether to overwrite existing files
+     */
+    overwrite?: boolean;
+    /**
+     * Custom metadata to attach to the file
+     */
+    metadata?: Record<string, string>;
+    /**
+     * Progress callback function
+     */
+    onProgress?: (progress: {
+        loaded: number;
+        total: number;
+    }) => void;
+}
+/**
+ * Options for file download operations
+ */
+export interface DownloadOptions {
+    /**
+     * Whether to force download even if local copy exists
+     */
+    force?: boolean;
+    /**
+     * Progress callback function
+     */
+    onProgress?: (progress: {
+        loaded: number;
+        total: number;
+    }) => void;
+}
+/**
+ * Options for caching operations
+ */
+export interface CacheOptions {
+    /**
+     * Cache expiry time in milliseconds
+     */
+    expiry?: number;
+    /**
+     * Whether to force download even if cached
+     */
+    force?: boolean;
+}
+/**
+ * Options for listing files (legacy compatibility)
+ */
+export interface ListFilesOptions {
+    /**
+     * Optional regular expression to filter files by name
+     */
+    match?: RegExp;
+}
+/**
+ * File information structure
+ */
+export interface FileInfo {
+    /**
+     * File name
+     */
+    name: string;
+    /**
+     * Full path to the file
+     */
+    path: string;
+    /**
+     * File size in bytes
+     */
+    size: number;
+    /**
+     * Whether this is a directory
+     */
+    isDirectory: boolean;
+    /**
+     * Last modified date
+     */
+    lastModified: Date;
+    /**
+     * MIME type of the file
+     */
+    mimeType?: string;
+    /**
+     * File extension
+     */
+    extension?: string;
+}
+/**
+ * File statistics structure
+ */
+export interface FileStats {
+    /**
+     * File size in bytes
+     */
+    size: number;
+    /**
+     * Whether this is a directory
+     */
+    isDirectory: boolean;
+    /**
+     * Whether this is a regular file
+     */
+    isFile: boolean;
+    /**
+     * Creation time
+     */
+    birthtime: Date;
+    /**
+     * Last access time
+     */
+    atime: Date;
+    /**
+     * Last modification time
+     */
+    mtime: Date;
+    /**
+     * Last status change time
+     */
+    ctime: Date;
+    /**
+     * File mode (permissions)
+     */
+    mode: number;
+    /**
+     * User ID of file owner
+     */
+    uid: number;
+    /**
+     * Group ID of file owner
+     */
+    gid: number;
+}
+/**
+ * Filesystem capabilities structure
+ */
+export interface FilesystemCapabilities {
+    /**
+     * Whether the filesystem supports streaming
+     */
+    streaming: boolean;
+    /**
+     * Whether the filesystem supports atomic operations
+     */
+    atomicOperations: boolean;
+    /**
+     * Whether the filesystem supports file versioning
+     */
+    versioning: boolean;
+    /**
+     * Whether the filesystem supports sharing/permissions
+     */
+    sharing: boolean;
+    /**
+     * Whether the filesystem supports real-time synchronization
+     */
+    realTimeSync: boolean;
+    /**
+     * Whether the filesystem can work offline
+     */
+    offlineCapable: boolean;
+    /**
+     * Maximum file size supported (in bytes)
+     */
+    maxFileSize?: number;
+    /**
+     * Supported file operations
+     */
+    supportedOperations: string[];
+}
+/**
+ * Core filesystem interface that all providers must implement
+ */
+export interface FilesystemInterface {
+    /**
+     * Check if a file or directory exists
+     */
+    exists(path: string): Promise<boolean>;
+    /**
+     * Read file contents
+     */
+    read(path: string, options?: ReadOptions): Promise<string | Buffer>;
+    /**
+     * Write content to a file
+     */
+    write(path: string, content: string | Buffer, options?: WriteOptions): Promise<void>;
+    /**
+     * Delete a file or directory
+     */
+    delete(path: string): Promise<void>;
+    /**
+     * Copy a file from source to destination
+     */
+    copy(sourcePath: string, destPath: string): Promise<void>;
+    /**
+     * Move a file from source to destination
+     */
+    move(sourcePath: string, destPath: string): Promise<void>;
+    /**
+     * Create a directory
+     */
+    createDirectory(path: string, options?: CreateDirOptions): Promise<void>;
+    /**
+     * List directory contents
+     */
+    list(path: string, options?: ListOptions): Promise<FileInfo[]>;
+    /**
+     * Get file statistics
+     */
+    getStats(path: string): Promise<FileStats>;
+    /**
+     * Get MIME type for a file
+     */
+    getMimeType(path: string): Promise<string>;
+    /**
+     * Upload a file (for remote providers)
+     */
+    upload(localPath: string, remotePath: string, options?: UploadOptions): Promise<void>;
+    /**
+     * Download a file (for remote providers)
+     */
+    download(remotePath: string, localPath?: string, options?: DownloadOptions): Promise<string>;
+    /**
+     * Download file with caching
+     */
+    downloadWithCache(remotePath: string, options?: CacheOptions): Promise<string>;
+    /**
+     * Caching operations
+     */
+    cache: {
+        get(key: string, expiry?: number): Promise<string | undefined>;
+        set(key: string, data: string): Promise<void>;
+        clear(key?: string): Promise<void>;
+    };
+    /**
+     * Get provider capabilities
+     */
+    getCapabilities(): Promise<FilesystemCapabilities>;
+    /**
+     * Check if a path is a file (legacy)
+     */
+    isFile(file: string): Promise<false | FileStats>;
+    /**
+     * Check if a path is a directory (legacy)
+     */
+    isDirectory(dir: string): Promise<boolean>;
+    /**
+     * Create a directory if it doesn't exist (legacy)
+     */
+    ensureDirectoryExists(dir: string): Promise<void>;
+    /**
+     * Upload data to a URL using PUT method (legacy)
+     */
+    uploadToUrl(url: string, data: string | Buffer): Promise<Response>;
+    /**
+     * Download a file from a URL and save it to a local file (legacy)
+     */
+    downloadFromUrl(url: string, filepath: string): Promise<void>;
+    /**
+     * Download a file with caching support (legacy)
+     */
+    downloadFileWithCache(url: string, targetPath?: string | null): Promise<string>;
+    /**
+     * List files in a directory with optional filtering (legacy)
+     */
+    listFiles(dirPath: string, options?: ListFilesOptions): Promise<string[]>;
+    /**
+     * Get data from cache if available and not expired (legacy)
+     */
+    getCached(file: string, expiry?: number): Promise<string | undefined>;
+    /**
+     * Set data in cache (legacy)
+     */
+    setCached(file: string, data: string): Promise<void>;
+}
+/**
+ * Base configuration options for all providers
+ */
+export interface BaseProviderOptions {
+    /**
+     * Base path for operations
+     */
+    basePath?: string;
+    /**
+     * Whether shared path normalization should prefix basePath.
+     * Providers that map basePath into their own storage root can disable this.
+     */
+    applyBasePath?: boolean;
+    /**
+     * Cache directory location
+     */
+    cacheDir?: string;
+    /**
+     * Whether to create missing directories
+     */
+    createMissing?: boolean;
+}
+/**
+ * Local filesystem provider options
+ */
+export interface LocalOptions extends BaseProviderOptions {
+    type?: 'local';
+}
+/**
+ * S3-compatible provider options
+ */
+export interface S3Options extends BaseProviderOptions {
+    type: 's3';
+    region: string;
+    bucket: string;
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    endpoint?: string;
+    forcePathStyle?: boolean;
+}
+/**
+ * Google Drive provider options
+ *
+ * Supports three authentication modes:
+ * 1. OAuth2: clientId + clientSecret + refreshToken
+ * 2. Service account: serviceAccountKey (JSON string)
+ * 3. Access token: accessToken (short-lived, no auto-refresh)
+ */
+export interface GoogleDriveOptions extends BaseProviderOptions {
+    type: 'gdrive';
+    /** OAuth2 client ID */
+    clientId?: string;
+    /** OAuth2 client secret */
+    clientSecret?: string;
+    /** OAuth2 refresh token */
+    refreshToken?: string;
+    /** Short-lived access token (no auto-refresh) */
+    accessToken?: string;
+    /** Service account key as JSON string */
+    serviceAccountKey?: string;
+    /** Root folder ID to scope operations (defaults to 'root') */
+    folderId?: string;
+    /** OAuth2 scopes (defaults to drive.file) */
+    scopes?: string[];
+    /** TTL for path-to-ID cache in ms (default 300000 / 5 min) */
+    pathCacheTTL?: number;
+    /** Page size for list pagination (default 100) */
+    pageSize?: number;
+}
+/**
+ * WebDAV provider options (supports Nextcloud, ownCloud, Apache, etc.)
+ */
+export interface WebDAVOptions extends BaseProviderOptions {
+    type: 'webdav';
+    baseUrl: string;
+    username: string;
+    password: string;
+    davPath?: string;
+}
+/**
+ * Browser storage provider options (uses IndexedDB for app storage)
+ */
+export interface BrowserStorageOptions extends BaseProviderOptions {
+    type: 'browser-storage';
+    /**
+     * Database name for IndexedDB
+     */
+    databaseName?: string;
+    /**
+     * Maximum storage quota to request (in bytes)
+     */
+    storageQuota?: number;
+}
+/**
+ * Union type for all provider options
+ */
+export type GetFilesystemOptions = LocalOptions | S3Options | GoogleDriveOptions | WebDAVOptions | BrowserStorageOptions;
+/**
+ * Error types for filesystem operations
+ */
+export declare class FilesystemError extends Error {
+    code: string;
+    path?: string | undefined;
+    provider?: string | undefined;
+    constructor(message: string, code: string, path?: string | undefined, provider?: string | undefined);
+}
+export declare class FileNotFoundError extends FilesystemError {
+    constructor(path: string, provider?: string);
+}
+export declare class PermissionError extends FilesystemError {
+    constructor(path: string, provider?: string);
+}
+export declare class DirectoryNotEmptyError extends FilesystemError {
+    constructor(path: string, provider?: string);
+}
+export declare class InvalidPathError extends FilesystemError {
+    constructor(path: string, provider?: string);
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/metadata.json

@@ -0,0 +1,35 @@
+{
+  "name": "@happyvertical/files",
+  "path": "packages/files",
+  "position": {
+    "index": 11,
+    "count": 30
+  },
+  "description": "File system utilities for local and remote file operations",
+  "provides": [
+    "File system utilities for local and remote file operations"
+  ],
+  "implements": [],
+  "requires": {
+    "workspace": [
+      "@happyvertical/utils"
+    ],
+    "externalHappyVertical": [],
+    "external": [
+      "@aws-sdk/client-s3",
+      "google-auth-library",
+      "googleapis"
+    ]
+  },
+  "dependents": [
+    "@happyvertical/documents",
+    "@happyvertical/sdk-mcp"
+  ],
+  "stability": {
+    "level": "stable",
+    "reason": "Primary package surface is described as implemented and production-oriented."
+  },
+  "keywords": [
+    "files"
+  ]
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@happyvertical/files",
+  "version": "0.74.8",
+  "description": "File system utilities for local and remote file operations",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.1034.0",
+    "google-auth-library": "^9.15.1",
+    "googleapis": "^144.0.0",
+    "@happyvertical/utils": "0.74.8"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "6.9.1",
+    "@testing-library/svelte": "5.3.1",
+    "@types/node": "25.0.10",
+    "happy-dom": "20.9.0",
+    "jsdom": "27.4.0",
+    "typescript": "^5.9.3",
+    "vite": "7.3.2",
+    "vite-plugin-dts": "4.5.4",
+    "vitest": "^4.1.5"
+  },
+  "bin": {
+    "have-files-context": "./dist/cli/claude-context.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "AGENT.md",
+    "metadata.json"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/sdk.git",
+    "directory": "packages/files"
+  },
+  "bugs": {
+    "url": "https://github.com/happyvertical/sdk/issues"
+  },
+  "homepage": "https://github.com/happyvertical/sdk/tree/main/packages/files#readme",
+  "license": "MIT",
+  "scripts": {
+    "test": "npx vitest run",
+    "test:watch": "npx vitest",
+    "build": "vite build",
+    "build:watch": "vite build --watch",
+    "docs": "typedoc --plugin typedoc-plugin-markdown --out docs --entryPoints ./src/index.ts --tsconfig ./tsconfig.json --excludePrivate --excludeInternal --hideGenerator --fileExtension .md --readme none --categorizeByGroup false --includeVersion false --hidePageHeader --hidePageTitle false --outputFileStrategy modules",
+    "docs:watch": "typedoc --plugin typedoc-plugin-markdown --out docs --entryPoints ./src/index.ts --tsconfig ./tsconfig.json --excludePrivate --excludeInternal --hideGenerator --fileExtension .md --readme none --categorizeByGroup false --includeVersion false --hidePageHeader --hidePageTitle false --outputFileStrategy modules --watch",
+    "clean": "rm -rf dist docs",
+    "dev": "npm run build:watch & npm run test:watch"
+  }
+}