@superfiles/types

Shared runtime Zod contracts and inferred TypeScript types for SuperFiles.

Use these schemas at every API boundary so the API implementation, OpenAPI specification, SDKs, MCP server, and web app validate the same wire shapes.

import { BucketListResponseSchema } from "@superfiles/types";

const response = await fetch(`${apiUrl}/v1/teams/${teamId}/buckets`, {
  headers: { Authorization: `Bearer ${apiKey}` },
});

const buckets = BucketListResponseSchema.parse(await response.json());

Every exported type is inferred from its schema. Prefer importing the schema value and parsing runtime data instead of asserting a generic response type.

Releases

Publish @superfiles/types before publishing matching files-sdk-superfiles or @superfiles/mcp releases. Both published consumers declare this package as a runtime dependency.