fosmvvm-serverrequest-generator

What This Skill Does

The fosmvvm-serverrequest-generator is an essential developer tool designed to enforce standardized client-server communication within the FOSMVVM architecture. Instead of manually constructing URLs or implementing ad-hoc JSON serialization, this skill provides a scaffolding mechanism to generate robust ServerRequest types. It automates the boilerplate associated with CRUD operations, ensuring that all network requests adhere to the mandatory processRequest(mvvmEnv:) pattern. By abstracting the endpoint construction and environment configuration, it prevents common anti-patterns like hardcoded URLs and manual headers, ensuring consistency across iOS, macOS, Web, and backend environments.

Installation

To integrate this skill into your development workflow, use the OpenClaw CLI tool: clawhub install openclaw/skills/skills/foscomputerservices/fosmvvm-serverrequest-generator

Use Cases

1. Scaffolding new API endpoints: When adding a new resource, use this skill to generate the request model and corresponding response types instantly.
2. Migrating legacy fetch calls: Refactor raw fetch or URLRequest code into the unified FOSMVVM format to leverage centralized error handling.
3. Background Job/CLI integration: Rapidly generate client interfaces for non-UI environments that need to interact with the FOSMVVM backend, ensuring versioning and header compliance are maintained without manual overhead.

Example Prompts

1. "Generate a ServerRequest type for a PATCH operation on the /users/profile endpoint to update user display settings."
2. "Create a scaffolding for a new ServerRequest that fetches a list of dashboard widgets, including the typed response body and error handling boilerplate."
3. "Refactor my manual URLRequest code for the /api/v1/sync endpoint into a compliant FOSMVVM ServerRequest structure."

Tips & Limitations

• Configuration First: Always ensure your MVVMEnvironment is initialized at the application entry point. The generator assumes mvvmEnv is available in scope.
• Strict Adherence: This tool does not support non-ServerRequest networking patterns. Avoid using it if your architecture requires low-level sockets or non-JSON protocols.
• Shared Modules: Keep your SystemVersion definitions up to date in your shared ViewModels module to ensure header versioning remains accurate across all generated requests.
• Maintainability: Use this tool to generate the base structure, but always review the typed error handling blocks to match your specific domain requirements.