@appweaver/cli 1.3.0 → 1.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appweaver/cli",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Appweaver - the backend framework for AI-first development (@cli)",
   "author": "Luka Matosevic",
   "license": "MIT",

package/skill/references/client.md

@@ -73,13 +73,18 @@ Reads an OpenAPI v3 schema and generates TypeScript types and a typed client cla
    `@maxLength`, `@minimum`, `@maximum`, `@pattern`, `@format`).
 3. Deduplicates union types and extracts inline schemas to named exported types, including the ones carrying a
    description (i.e. `PostQuerySort`).
-4. Hoists the enums the schema repeats inline into a single shared enum each, so every sortable field of every resource
-   shares one `SortDirection` rather than declaring an `asc | desc` enum of its own.
-5. Classifies all API paths into route groups: resources, auth, account, health, files, and custom.
-6. Emits a typed client class extending `FetchClient<Paths>` with a getter for each route group. Resources with
+4. Hoists the schemas the document repeats inline into a shared definition each, so the generated types declare them
+   once and reference them everywhere else. This covers the enums (every sortable field of every resource shares one
+   `SortDirection` rather than declaring an `asc | desc` enum of its own) and the value a filterable field accepts
+   (`QueryFilterValue`, built from the plain `QueryFilterScalar`), while every property keeps its own description.
+5. Emits every enum as a constant object plus a type alias of its values, so both the member (`SortDirection.asc`) and
+   the plain literal (`'asc'`) are accepted wherever the enum is used. When the types are written to a declaration file
+   (`.d.ts`), the constant is declared rather than initialized, since such a file carries no runtime values.
+6. Classifies all API paths into route groups: resources, auth, account, health, files, and custom.
+7. Emits a typed client class extending `FetchClient<Paths>` with a getter for each route group. Resources with
    unsupported operations are excluded at compile time using `Omit`.
-7. Formats all output with Prettier.
-8. Writes files with an autogenerated header comment.
+8. Formats all output with Prettier.
+9. Writes files with an autogenerated header comment.
 
 **Examples:**
 
@@ -146,6 +151,35 @@ const sort: PostQuerySort = { createdAt: SortDirection.desc, title: SortDirectio
 const posts = await client.post.query({ sort, page: 1, size: 20 });
 ```
 
+Enums are generated as a constant object together with a type alias of its values, so the members and the raw literals
+are interchangeable and no import is needed for the literal form:
+
+```ts
+export const SortDirection = { asc: 'asc', desc: 'desc' } as const;
+export type SortDirection = (typeof SortDirection)[keyof typeof SortDirection];
+
+// Both are valid and equally type safe
+const byMember: PostQuerySort = { createdAt: SortDirection.desc };
+const byLiteral: PostQuerySort = { createdAt: 'desc' };
+```
+
+The value a filterable field accepts is declared once as well, rather than being spelled out again for every field of
+every resource. A scalar field references `QueryFilterValue`, and a relation field adds the filter of the related
+resource to the plain values it accepts:
+
+```ts
+export type QueryFilterScalar = string | number | boolean | null;
+export type QueryFilterValue = QueryFilterScalar | QueryFilterScalar[] | QueryCondition;
+
+export type PostQueryFilter = {
+  /** @description Filter by the title field */
+  title?: QueryFilterValue;
+  /** @description Filter by the author relation, matching an id, a list of ids, or a nested User filter */
+  author?: QueryFilterScalar | QueryFilterScalar[] | UserQueryFilter | UserQueryFilter[];
+  // ...
+};
+```
+
 ### Client file
 
 ```ts