zinkee 0.1.7 → 0.1.9

package/README.md

@@ -131,50 +131,75 @@ Simple field types use `--type`, `--slug`, `--label`:
 
 ```bash
 zinkee schemas fields create projects --type text --slug name --label "Name"
-zinkee schemas fields create projects --type number --slug budget --label "Budget"
+zinkee schemas fields create projects --type number --slug budget --label "Budget" --required true --default 0
 zinkee schemas fields create projects --type date --slug start-date --label "Start Date"
 zinkee schemas fields create projects --type file --slug attachment --label "Attachment"
 zinkee schemas fields create projects --type autoincremental --slug code --label "Code"
 zinkee schemas fields create projects --type member --slug owner --label "Owner"
 ```
 
-Valid types: `text`, `number`, `date`, `file`, `autoincremental`, `member`, `option`, `reference`, `formula`.
+Valid types: `text`, `number`, `date`, `file`, `autoincremental`, `member`, `option`, `reference`, `formula`, `schedule`.
 
-Complex types require `--raw`:
+Complex types require `--raw`. The JSON `type` uses the backend ClassName (`TextField`, `OptionField`, …) and type-specific fields go inside `config`:
 
 ```bash
 # Option field
 zinkee schemas fields create projects --raw '{
-  "type":"option","slug":"status","label":"Status",
-  "options":[
-    {"id":1,"name":"Open","color":"default"},
-    {"id":2,"name":"In Progress","color":"primary"},
-    {"id":3,"name":"Done","color":"success"}
-  ]
+  "type":"OptionField","slug":"status","label":"Status",
+  "config":{
+    "options":[
+      {"id":1,"name":"Open","color":"default"},
+      {"id":2,"name":"In Progress","color":"primary"},
+      {"id":3,"name":"Done","color":"success"}
+    ]
+  }
 }'
 
 # Reference field (targetSchema and targetDisplayField must be UUIDs)
 zinkee schemas fields create tasks --raw '{
-  "type":"reference","slug":"project","label":"Project",
-  "targetSchema":"<schema-uuid>",
-  "targetDisplayField":"<field-uuid>",
-  "deleteBehavior":"SET_NULL"
+  "type":"ReferenceField","slug":"project","label":"Project",
+  "config":{
+    "targetSchema":"<schema-uuid>",
+    "targetDisplayField":"<field-uuid>",
+    "deleteBehavior":"SET_NULL"
+  }
 }'
 
 # Formula field (use formulaText, not expression)
 zinkee schemas fields create projects --raw '{
-  "type":"formula","slug":"code","label":"Code",
-  "formulaText":"concat(\"PRJ-\", <_id-field-uuid>)"
+  "type":"FormulaField","slug":"code","label":"Code",
+  "config":{
+    "formulaText":"concat(\"PRJ-\", <_id-field-uuid>)"
+  }
+}'
+
+# Schedule field (frequency: monthly | daily). Bound to one NumberField (referenceField)
+# and two DateField UUIDs (beginning/ending). Cannot be required.
+zinkee schemas fields create projects --raw '{
+  "type":"ScheduleField","slug":"recurrence","label":"Recurrence",
+  "config":{
+    "referenceField":"<number-field-uuid>",
+    "beginningPeriodField":"<date-field-uuid>",
+    "endingPeriodField":"<date-field-uuid>",
+    "frequency":"monthly"
+  }
 }'
 ```
 
 ### Update field config
 
-Config properties must be wrapped inside a `config` key:
+Use `--default <value>` for the common default-value case:
+
+```bash
+zinkee schemas fields update projects budget --default 0
+```
+
+PATCH bodies are flat (no `set` / `unset` wrapper). Config properties must be wrapped inside a `config` key:
 
 ```bash
 # Number formatting
 zinkee schemas fields update projects budget --raw '{
+  "type":"NumberField",
   "config":{
     "defaultValue":"0",
     "formatOptions":{
@@ -186,11 +211,12 @@ zinkee schemas fields update projects budget --raw '{
 
 # Date formatting
 zinkee schemas fields update projects start-date --raw '{
+  "type":"DateField",
   "config":{"formatOptions":{"format":"date","dateFormat":"L","showTime":false}}
 }'
 
 # Text type (valid values: NORMAL, LONG)
-zinkee schemas fields update projects description --raw '{"config":{"textType":"LONG"}}'
+zinkee schemas fields update projects description --raw '{"type":"TextField","config":{"textType":"LONG"}}'
 ```
 
 ### Formula syntax