Flatten the schema namespace

[ChiragAgg5k]

Every schema class sat under Model\Schema, which stuttered on the base class and repeated itself on each kind:

use Utopia\OpenAPI\Model\Schema\Schema;
use Utopia\OpenAPI\Model\Schema\ArraySchema;
use Utopia\OpenAPI\Model\Schema\ObjectSchema;

The segment carries no information the class names do not already carry. This moves the classes up beside the models they are part of:

use Utopia\OpenAPI\Model\Schema;
use Utopia\OpenAPI\Model\ArraySchema;
use Utopia\OpenAPI\Model\ObjectSchema;

Why not drop the suffix instead

The tidier-looking option — Model\Schema\Array, Model\Schema\Object — is not available. Those names are reserved in PHP:

Object   Cannot use "Object" as a class name as it is reserved
String   Cannot use "String" as a class name as it is reserved
Never    Cannot use "Never" as a class name as it is reserved
Array    declares, but is unusable as a type hint (parsed as the array type)

Integer  usable        Boolean  usable

So Schema\Array and its neighbours cannot exist, and dropping the suffix only where the language permits would leave Schema\Integer sitting beside Schema\ArraySchema. Removing the namespace segment keeps every kind named consistently while taking the redundancy out of the path.

Model is a flat namespace of value objects, so schemas now sit next to Parameter, Response and MediaType rather than one level below them.

Scope

No behaviour change — the classes, their properties and their relationships are untouched. 13 file renames, 23 files changed, +47 / -53.

composer check is green: pint, Rector, and 44 tests / 363 assertions.

Downstream

This is a breaking change for consumers. The migration is mechanical:

Utopia\OpenAPI\Model\Schema\  ->  Utopia\OpenAPI\Model\

appwrite/sdk-generator is the only consumer I know of; it has 22 files importing these names and pins a commit in composer.lock, so it is unaffected until it updates. I will land the rename there alongside the version bump.

[greptile-apps]

Greptile Summary

The PR flattens all schema model classes from Utopia\OpenAPI\Model\Schema into Utopia\OpenAPI\Model.

• Renames schema source files and updates their namespace declarations.
• Updates parser, specification, model, test, and README imports.
• Preserves the existing class structures and relationships while intentionally changing their public FQCNs.

Confidence Score: 5/5

The PR appears safe to merge; the namespace migration is internally consistent and its intentional downstream breaking impact is documented.

The renamed classes, internal imports, tests, and documentation consistently use the flattened namespace, Composer’s PSR-4 mapping resolves the new file locations, and no stale old-namespace references or symbol collisions were found.

Important Files Changed

Filename	Overview
src/Model/Schema.php	Moves the common schema base class into the flat model namespace; its implementation is otherwise unchanged.
src/Parser/Schema/Reader.php	Updates all schema model imports to the flattened namespace without changing parsing behavior.
src/Parser/OpenAPI2.php	Updates ObjectSchema to its new FQCN while preserving parser behavior.
src/Specification.php	Updates the schema base-class import used by the public specification model.
README.md	Documents the flattened schema namespace and updates the reference-schema example.
tests/Schema/ReaderTest.php	Updates test imports so existing schema-reader coverage exercises the renamed model classes.

_{Reviews (1): Last reviewed commit: "refactor: flatten the schema namespace" | Re-trigger Greptile}