@visulima/storage 1.0.9 → 1.0.11

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+## @visulima/storage [1.0.11](https://github.com/visulima/visulima/compare/%40visulima%2Fstorage%401.0.10...%40visulima%2Fstorage%401.0.11) (2026-08-02)
+
+
+### Dependencies
+
+* **@visulima/pagination:** upgraded to 6.0.0
+* **@visulima/fs:** upgraded to 5.1.0
+* **@visulima/humanizer:** upgraded to 3.1.0
+* **@visulima/path:** upgraded to 3.1.0
+
+## @visulima/storage [1.0.10](https://github.com/visulima/visulima/compare/%40visulima%2Fstorage%401.0.9...%40visulima%2Fstorage%401.0.10) (2026-07-27)
+
+
+### Dependencies
+
+* **@visulima/fs:** upgraded to 5.0.11
+
 ## @visulima/storage [1.0.9](https://github.com/visulima/visulima/compare/%40visulima%2Fstorage%401.0.8...%40visulima%2Fstorage%401.0.9) (2026-07-27)
 
 

package/dist/adapter/nuxt/module.d.ts

@@ -1,16 +1,17 @@
-import { U as UploadOptions } from "../../packem_shared/types.d-CggTCgXr.js";
-import { U as UploadFile, B as BaseStorage } from "../../packem_shared/storage.d-CEM1upWM.js";
+import { U as UploadOptions } from "../../packem_shared/types.d-D7Zlz5RE.js";
+import { U as UploadFile, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
 import 'node:stream';
 import 'node:events';
 import 'node:http';
 import '@visulima/pagination';
-import "../../packem_shared/media-transformer.d-Quf4ai47.js";
-import "../../packem_shared/types.d-CrUWY4On.js";
+import "../../packem_shared/media-transformer.d-C8tn4J2Z.js";
+import "../../packem_shared/types.d-BEUv414z.js";
+import 'node:timers';
 import 'node:crypto';
 import 'lru-cache';
 /**
-* CORS configuration for upload endpoints
-*/
+ * CORS configuration for upload endpoints
+ */
 interface CorsOptions {
   /** Allowed CORS headers */
   headers?: string[];
@@ -20,8 +21,8 @@ interface CorsOptions {
   origin?: string | string[];
 }
 /**
-* Configuration options for the Nuxt storage module
-*/
+ * Configuration options for the Nuxt storage module
+ */
 interface ModuleOptions {
   /** Base path for upload routes (default: '/api/upload') */
   basePath?: string;

package/dist/ai/ai-sdk/index.d.ts

@@ -1,26 +1,27 @@
-import { F as Files } from "../../packem_shared/files.d-CH0iLBNC.js";
+import { F as Files } from "../../packem_shared/files.d-CmSZi3M0.js";
 import 'node:stream';
+import 'node:timers';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
-import { C as CopyFileInput, D as DeleteFileInput, a as DownloadFileInput, G as GetFileMetadataInput, b as GetFileUrlInput, L as ListFilesInput, S as SignUploadUrlInput, U as UploadFileInput, F as FileToolName, A as ApprovalConfig, c as FileReadToolName } from "../../packem_shared/approval.d-CMAYH9GF.js";
-export type { d as FileWriteToolName } from "../../packem_shared/approval.d-CMAYH9GF.js";
+import { C as CopyFileInput, D as DeleteFileInput, a as DownloadFileInput, G as GetFileMetadataInput, b as GetFileUrlInput, L as ListFilesInput, S as SignUploadUrlInput, U as UploadFileInput, F as FileToolName, A as ApprovalConfig, c as FileReadToolName } from "../../packem_shared/approval.d-C-d-t94D.js";
+export type { d as FileWriteToolName } from "../../packem_shared/approval.d-C-d-t94D.js";
 import { Tool } from 'ai';
-import { e as executors } from "../../packem_shared/executors.d-BZP2rWo3.js";
-import "../../packem_shared/storage.d-CEM1upWM.js";
+import { e as executors } from "../../packem_shared/executors.d-B9dIy3NT.js";
+import "../../packem_shared/storage.d-DwdJrArF.js";
 import 'zod';
 /**
-* Common options accepted by every write-tool factory.
-*/
+ * Common options accepted by every write-tool factory.
+ */
 interface ToolOptions {
   needsApproval?: boolean;
 }
 /**
-* Per-tool overrides for customizing AI SDK `tool()` properties without
-* changing the underlying implementation. Core properties (`execute`,
-* `inputSchema`, `outputSchema`) are intentionally excluded — those drive
-* the tool's behavior and contract and shouldn't be patched at this layer.
-*/
+ * Per-tool overrides for customizing AI SDK `tool()` properties without
+ * changing the underlying implementation. Core properties (`execute`,
+ * `inputSchema`, `outputSchema`) are intentionally excluded — those drive
+ * the tool's behavior and contract and shouldn't be patched at this layer.
+ */
 type ToolOverrides = Partial<Pick<Tool, "description" | "needsApproval" | "onInputAvailable" | "onInputDelta" | "onInputStart" | "providerOptions" | "toModelOutput">>;
 type ListFilesOutput = Awaited<ReturnType<typeof executors.listFiles>>;
 type GetFileMetadataOutput = Awaited<ReturnType<typeof executors.getFileMetadata>>;
@@ -34,40 +35,32 @@ declare const listFiles: (files: Files) => Tool<ListFilesInput, ListFilesOutput>
 declare const getFileMetadata: (files: Files) => Tool<GetFileMetadataInput, GetFileMetadataOutput>;
 declare const downloadFile: (files: Files) => Tool<DownloadFileInput, DownloadFileOutput>;
 declare const getFileUrl: (files: Files) => Tool<GetFileUrlInput, GetFileUrlOutput>;
-declare const uploadFile: (files: Files, {
-  needsApproval
-}?: ToolOptions) => Tool<UploadFileInput, UploadFileOutput>;
-declare const deleteFile: (files: Files, {
-  needsApproval
-}?: ToolOptions) => Tool<DeleteFileInput, DeleteFileOutput>;
-declare const copyFile: (files: Files, {
-  needsApproval
-}?: ToolOptions) => Tool<CopyFileInput, CopyFileOutput>;
-declare const signUploadUrl: (files: Files, {
-  needsApproval
-}?: ToolOptions) => Tool<SignUploadUrlInput, SignUploadUrlOutput>;
+declare const uploadFile: (files: Files, { needsApproval }?: ToolOptions) => Tool<UploadFileInput, UploadFileOutput>;
+declare const deleteFile: (files: Files, { needsApproval }?: ToolOptions) => Tool<DeleteFileInput, DeleteFileOutput>;
+declare const copyFile: (files: Files, { needsApproval }?: ToolOptions) => Tool<CopyFileInput, CopyFileOutput>;
+declare const signUploadUrl: (files: Files, { needsApproval }?: ToolOptions) => Tool<SignUploadUrlInput, SignUploadUrlOutput>;
 interface FileToolsOptions {
   /**
-  * The configured `Files` instance the tools will operate against.
-  * Each tool delegates to the methods on this instance.
-  */
+   * The configured `Files` instance the tools will operate against.
+   * Each tool delegates to the methods on this instance.
+   */
   files: Files;
   /**
-  * Per-tool overrides for customizing tool behavior (description, title,
-  * needsApproval, etc.) without changing the underlying implementation.
-  * `execute` and `inputSchema` cannot be overridden.
-  */
+   * Per-tool overrides for customizing tool behavior (description, title,
+   * needsApproval, etc.) without changing the underlying implementation.
+   * `execute` and `inputSchema` cannot be overridden.
+   */
   overrides?: Partial<Record<FileToolName, ToolOverrides>>;
   /**
-  * When `true`, write tools (`uploadFile`, `deleteFile`, `copyFile`,
-  * `signUploadUrl`) are omitted entirely. The model cannot mutate the
-  * bucket regardless of approval configuration.
-  */
+   * When `true`, write tools (`uploadFile`, `deleteFile`, `copyFile`,
+   * `signUploadUrl`) are omitted entirely. The model cannot mutate the
+   * bucket regardless of approval configuration.
+   */
   readOnly?: boolean;
   /**
-  * Approval gating for write tools. Defaults to `true` (all writes
-  * require approval). See {@link ApprovalConfig}.
-  */
+   * Approval gating for write tools. Defaults to `true` (all writes
+   * require approval). See {@link ApprovalConfig}.
+   */
   requireApproval?: ApprovalConfig;
 }
 interface FileTools {
@@ -82,27 +75,27 @@ interface FileTools {
 }
 type ReadOnlyFileTools = Pick<FileTools, FileReadToolName>;
 /**
-* Create a set of visulima/storage tools for the Vercel AI SDK.
-*
-* Write operations require user approval by default. Control globally or
-* per-tool via `requireApproval`, or strip writes entirely with
-* `readOnly: true`.
-* @example
-* ```ts
-* import { Files } from "@visulima/storage";
-* import { S3Storage } from "@visulima/storage/provider/aws";
-* import { createFileTools } from "@visulima/storage/ai/sdk";
-* import { generateText } from "ai";
-*
-* const files = new Files({ adapter: new S3Storage({ bucket: "uploads" }) });
-*
-* const result = await generateText({
-*   model,
-*   tools: createFileTools({ files }),
-*   prompt: "Find every CSV under reports/ and summarize the latest one.",
-* });
-* ```
-*/
+ * Create a set of visulima/storage tools for the Vercel AI SDK.
+ *
+ * Write operations require user approval by default. Control globally or
+ * per-tool via `requireApproval`, or strip writes entirely with
+ * `readOnly: true`.
+ * @example
+ * ```ts
+ * import { Files } from "@visulima/storage";
+ * import { S3Storage } from "@visulima/storage/provider/aws";
+ * import { createFileTools } from "@visulima/storage/ai/sdk";
+ * import { generateText } from "ai";
+ *
+ * const files = new Files({ adapter: new S3Storage({ bucket: "uploads" }) });
+ *
+ * const result = await generateText({
+ *   model,
+ *   tools: createFileTools({ files }),
+ *   prompt: "Find every CSV under reports/ and summarize the latest one.",
+ * });
+ * ```
+ */
 declare function createFileTools(options: FileToolsOptions & {
   readOnly: true;
 }): ReadOnlyFileTools;

package/dist/ai/claude/index.d.ts

@@ -1,25 +1,26 @@
 import { SdkMcpToolDefinition, CanUseTool, McpSdkServerConfigWithInstance } from '@anthropic-ai/claude-agent-sdk';
-import { F as Files } from "../../packem_shared/files.d-CH0iLBNC.js";
+import { F as Files } from "../../packem_shared/files.d-CmSZi3M0.js";
 import 'node:stream';
+import 'node:timers';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
-import { T as TOOL_SCHEMAS, F as FileToolName, A as ApprovalConfig } from "../../packem_shared/approval.d-CMAYH9GF.js";
-export type { c as FileReadToolName, d as FileWriteToolName } from "../../packem_shared/approval.d-CMAYH9GF.js";
-import "../../packem_shared/storage.d-CEM1upWM.js";
+import { T as TOOL_SCHEMAS, F as FileToolName, A as ApprovalConfig } from "../../packem_shared/approval.d-C-d-t94D.js";
+export type { c as FileReadToolName, d as FileWriteToolName } from "../../packem_shared/approval.d-C-d-t94D.js";
+import "../../packem_shared/storage.d-DwdJrArF.js";
 import 'zod';
 /**
-* MCP tool annotations as accepted by `tool()` and exposed on
-* `SdkMcpToolDefinition`. Re-derived from the SDK rather than imported from
-* `@modelcontextprotocol/sdk` directly to avoid taking on a second peer
-* dependency.
-*/
+ * MCP tool annotations as accepted by `tool()` and exposed on
+ * `SdkMcpToolDefinition`. Re-derived from the SDK rather than imported from
+ * `@modelcontextprotocol/sdk` directly to avoid taking on a second peer
+ * dependency.
+ */
 type ToolAnnotations = NonNullable<SdkMcpToolDefinition["annotations"]>;
 /**
-* Per-tool overrides for `createClaudeFileTools`. `name`, `inputSchema`, and
-* `handler` are intentionally not overridable — the contract that drives tool
-* behavior should not be patched at this layer.
-*/
+ * Per-tool overrides for `createClaudeFileTools`. `name`, `inputSchema`, and
+ * `handler` are intentionally not overridable — the contract that drives tool
+ * behavior should not be patched at this layer.
+ */
 interface ClaudeToolOverrides {
   annotations?: ToolAnnotations;
   description?: string;
@@ -39,139 +40,124 @@ declare const claudeListFiles: (files: Files) => SdkMcpToolDefinition<ListFilesS
 declare const claudeGetFileMetadata: (files: Files) => SdkMcpToolDefinition<GetFileMetadataShape>;
 declare const claudeDownloadFile: (files: Files) => SdkMcpToolDefinition<DownloadFileShape>;
 declare const claudeGetFileUrl: (files: Files) => SdkMcpToolDefinition<GetFileUrlShape>;
-declare const claudeUploadFile: (files: Files, {
-  annotations
-}?: ClaudeWriteToolOptions) => SdkMcpToolDefinition<UploadFileShape>;
-declare const claudeDeleteFile: (files: Files, {
-  annotations
-}?: ClaudeWriteToolOptions) => SdkMcpToolDefinition<DeleteFileShape>;
-declare const claudeCopyFile: (files: Files, {
-  annotations
-}?: ClaudeWriteToolOptions) => SdkMcpToolDefinition<CopyFileShape>;
-declare const claudeSignUploadUrl: (files: Files, {
-  annotations
-}?: ClaudeWriteToolOptions) => SdkMcpToolDefinition<SignUploadUrlShape>;
+declare const claudeUploadFile: (files: Files, { annotations }?: ClaudeWriteToolOptions) => SdkMcpToolDefinition<UploadFileShape>;
+declare const claudeDeleteFile: (files: Files, { annotations }?: ClaudeWriteToolOptions) => SdkMcpToolDefinition<DeleteFileShape>;
+declare const claudeCopyFile: (files: Files, { annotations }?: ClaudeWriteToolOptions) => SdkMcpToolDefinition<CopyFileShape>;
+declare const claudeSignUploadUrl: (files: Files, { annotations }?: ClaudeWriteToolOptions) => SdkMcpToolDefinition<SignUploadUrlShape>;
 interface ClaudeFileToolsOptions {
   /**
-  * The configured `Files` instance the tools will operate against.
-  */
+   * The configured `Files` instance the tools will operate against.
+   */
   files: Files;
   /**
-  * Per-tool overrides for `description` / `annotations` without touching
-  * the underlying handler or input schema.
-  */
+   * Per-tool overrides for `description` / `annotations` without touching
+   * the underlying handler or input schema.
+   */
   overrides?: Partial<Record<FileToolName, ClaudeToolOverrides>>;
   /**
-  * When `true`, write tools (`uploadFile`, `deleteFile`, `copyFile`,
-  * `signUploadUrl`) are omitted from the MCP server. The model cannot
-  * mutate the bucket regardless of approval configuration.
-  */
+   * When `true`, write tools (`uploadFile`, `deleteFile`, `copyFile`,
+   * `signUploadUrl`) are omitted from the MCP server. The model cannot
+   * mutate the bucket regardless of approval configuration.
+   */
   readOnly?: boolean;
   /**
-  * Approval gating reflected by {@link ClaudeFileTools.needsApproval} and
-  * the bundled {@link ClaudeFileTools.canUseTool}. Defaults to `true`
-  * (every write requires approval). Pass `false` to disable, or an object
-  * keyed by write-tool name for fine-grained control.
-  */
+   * Approval gating reflected by {@link ClaudeFileTools.needsApproval} and
+   * the bundled {@link ClaudeFileTools.canUseTool}. Defaults to `true`
+   * (every write requires approval). Pass `false` to disable, or an object
+   * keyed by write-tool name for fine-grained control.
+   */
   requireApproval?: ApprovalConfig;
   /**
-  * Name of the in-process MCP server that wraps these tools. Affects the
-  * `mcp__&lt;server-name>__&lt;tool-name>` strings the agent uses to address
-  * each tool. Defaults to `"files"`.
-  */
+   * Name of the in-process MCP server that wraps these tools. Affects the
+   * `mcp__&lt;server-name>__&lt;tool-name>` strings the agent uses to address
+   * each tool. Defaults to `"files"`.
+   */
   serverName?: string;
   /**
-  * MCP server `version` metadata. Defaults to `"1.0.0"`.
-  */
+   * MCP server `version` metadata. Defaults to `"1.0.0"`.
+   */
   serverVersion?: string;
 }
 interface ClaudeFileTools {
   /**
-  * Pass into `query({ options: { allowedTools: tools.allowedTools } })`.
-  * Each entry is of the form `mcp__&lt;serverName>__&lt;toolName>`.
-  */
+   * Pass into `query({ options: { allowedTools: tools.allowedTools } })`.
+   * Each entry is of the form `mcp__&lt;serverName>__&lt;toolName>`.
+   */
   allowedTools: string[];
   /**
-  * Ready-made `canUseTool` callback. Allows reads unconditionally, allows
-  * writes whose `needsApproval` resolves to `false`, denies the rest with
-  * a `"requires approval"` message. Pass directly into `query()`, or
-  * compose your own using {@link ClaudeFileTools.needsApproval}.
-  */
+   * Ready-made `canUseTool` callback. Allows reads unconditionally, allows
+   * writes whose `needsApproval` resolves to `false`, denies the rest with
+   * a `"requires approval"` message. Pass directly into `query()`, or
+   * compose your own using {@link ClaudeFileTools.needsApproval}.
+   */
   canUseTool: CanUseTool;
   /**
-  * Pass into `query({ options: { mcpServers: tools.mcpServers } })`.
-  */
+   * Pass into `query({ options: { mcpServers: tools.mcpServers } })`.
+   */
   mcpServers: Record<string, McpSdkServerConfigWithInstance>;
   /**
-  * Whether the named tool is approval-gated under the configured
-  * `requireApproval`. Accepts both bare names (`"uploadFile"`) and the
-  * MCP-prefixed form (`"mcp__files__uploadFile"`). Read tools and unknown
-  * names return `false`.
-  */
+   * Whether the named tool is approval-gated under the configured
+   * `requireApproval`. Accepts both bare names (`"uploadFile"`) and the
+   * MCP-prefixed form (`"mcp__files__uploadFile"`). Read tools and unknown
+   * names return `false`.
+   */
   needsApproval: (toolName: string) => boolean;
   /**
-  * The raw SDK MCP server instance — same value as
-  * `mcpServers[serverName]`. Exposed for callers that want to compose it
-  * into a larger `mcpServers` map.
-  */
+   * The raw SDK MCP server instance — same value as
+   * `mcpServers[serverName]`. Exposed for callers that want to compose it
+   * into a larger `mcpServers` map.
+   */
   server: McpSdkServerConfigWithInstance;
   /**
-  * The MCP server name used in the `mcp__&lt;server>__*` prefix.
-  */
+   * The MCP server name used in the `mcp__&lt;server>__*` prefix.
+   */
   serverName: string;
 }
 /**
-* Create storage tools shaped for the Claude Agent SDK
-* (`@anthropic-ai/claude-agent-sdk`).
-*
-* The Claude Agent SDK consumes tools by way of an in-process MCP server +
-* an `allowedTools` allow-list + a `canUseTool` approval callback. The
-* returned bundle gives you all three, plus the raw server instance and a
-* `needsApproval()` helper if you want to wire your own `canUseTool`.
-* @example
-* ```ts
-* import { query } from "@anthropic-ai/claude-agent-sdk";
-* import { Files } from "@visulima/storage";
-* import { S3Storage } from "@visulima/storage/provider/aws";
-* import { createClaudeFileTools } from "@visulima/storage/ai/claude";
-*
-* const files = new Files({ adapter: new S3Storage({ bucket: "uploads" }) });
-* const tools = createClaudeFileTools({ files });
-*
-* for await (const message of query({
-*   prompt: "List my files.",
-*   options: {
-*     mcpServers: tools.mcpServers,
-*     allowedTools: tools.allowedTools,
-*     canUseTool: tools.canUseTool,
-*   },
-* })) {
-*   // handle messages
-* }
-* ```
-* @example Read-only agent
-* ```ts
-* createClaudeFileTools({ files, readOnly: true })
-* ```
-* @example Granular approval
-* ```ts
-* createClaudeFileTools({
-*   files,
-*   requireApproval: {
-*     copyFile: false,
-*     deleteFile: true,
-*     signUploadUrl: true,
-*     uploadFile: false,
-*   },
-* })
-* ```
-*/
-declare const createClaudeFileTools: ({
-  files,
-  overrides,
-  readOnly,
-  requireApproval,
-  serverName,
-  serverVersion
-}: ClaudeFileToolsOptions) => ClaudeFileTools;
+ * Create storage tools shaped for the Claude Agent SDK
+ * (`@anthropic-ai/claude-agent-sdk`).
+ *
+ * The Claude Agent SDK consumes tools by way of an in-process MCP server +
+ * an `allowedTools` allow-list + a `canUseTool` approval callback. The
+ * returned bundle gives you all three, plus the raw server instance and a
+ * `needsApproval()` helper if you want to wire your own `canUseTool`.
+ * @example
+ * ```ts
+ * import { query } from "@anthropic-ai/claude-agent-sdk";
+ * import { Files } from "@visulima/storage";
+ * import { S3Storage } from "@visulima/storage/provider/aws";
+ * import { createClaudeFileTools } from "@visulima/storage/ai/claude";
+ *
+ * const files = new Files({ adapter: new S3Storage({ bucket: "uploads" }) });
+ * const tools = createClaudeFileTools({ files });
+ *
+ * for await (const message of query({
+ *   prompt: "List my files.",
+ *   options: {
+ *     mcpServers: tools.mcpServers,
+ *     allowedTools: tools.allowedTools,
+ *     canUseTool: tools.canUseTool,
+ *   },
+ * })) {
+ *   // handle messages
+ * }
+ * ```
+ * @example Read-only agent
+ * ```ts
+ * createClaudeFileTools({ files, readOnly: true })
+ * ```
+ * @example Granular approval
+ * ```ts
+ * createClaudeFileTools({
+ *   files,
+ *   requireApproval: {
+ *     copyFile: false,
+ *     deleteFile: true,
+ *     signUploadUrl: true,
+ *     uploadFile: false,
+ *   },
+ * })
+ * ```
+ */
+declare const createClaudeFileTools: ({ files, overrides, readOnly, requireApproval, serverName, serverVersion }: ClaudeFileToolsOptions) => ClaudeFileTools;
 export { type ApprovalConfig, ClaudeFileTools, ClaudeFileToolsOptions, type ClaudeToolOverrides, type ClaudeWriteToolOptions, type FileToolName, type ToolAnnotations, claudeCopyFile, claudeDeleteFile, claudeDownloadFile, claudeGetFileMetadata, claudeGetFileUrl, claudeListFiles, claudeSignUploadUrl, claudeUploadFile, createClaudeFileTools };