blitzreels 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +69 -1
  2. package/dist/index.js +2027 -38
  3. package/dist/index.js.map +1 -1
  4. package/package.json +2 -2
package/README.md CHANGED
@@ -44,18 +44,58 @@ API keys are environment-bounded:
44
44
  ## Commands
45
45
 
46
46
  ```bash
47
+ blitzreels workspace settings get --json
48
+ blitzreels workspace settings update --name "Creator Studio" --protected-words "Brand,Product"
49
+
50
+ blitzreels projects list --status active --json
51
+ blitzreels projects create --name "Launch short" --aspect-ratio 9:16
52
+ blitzreels projects get --project-id PROJECT_ID --json
53
+ blitzreels projects rename --project-id PROJECT_ID --name "New title"
54
+ blitzreels projects update --project-id PROJECT_ID --description "New description"
55
+ blitzreels projects delete --project-id PROJECT_ID --confirm-delete
56
+
57
+ blitzreels media list --asset-type video --json
58
+ blitzreels media get --asset-id ASSET_ID --json
59
+ blitzreels media delete --asset-id ASSET_ID --confirm-delete
60
+ blitzreels media upload --file ./video.mp4 --auto-transcribe true
61
+ blitzreels media import-youtube --url "https://www.youtube.com/watch?v=..."
62
+ blitzreels media rename --asset-id ASSET_ID --name "New media name"
63
+ blitzreels media update --asset-id ASSET_ID --description "B-roll" --folder-id FOLDER_ID
64
+ blitzreels media move --asset-id ASSET_ID --target-folder-id FOLDER_ID
65
+ blitzreels media attach --project-id PROJECT_ID --asset-id ASSET_ID --at 0 --duration 4
66
+ blitzreels media attach --project-id PROJECT_ID --asset-id IMAGE_ID --at 6 --duration 1.6 --position-preset center --position-y -230 --width-px 561 --height-px 212 --animation-preset popIn
67
+ blitzreels media folders list --json
68
+ blitzreels media folders create --name "B-roll" --icon-type video
69
+ blitzreels media folders rename --folder-id FOLDER_ID --name "New folder name"
70
+ blitzreels media folders update --folder-id FOLDER_ID --parent-folder-id root
71
+ blitzreels media folders delete --folder-id FOLDER_ID --confirm-delete
72
+
47
73
  blitzreels project inspect --project-id PROJECT_ID --json
48
74
  blitzreels project timeline --project-id PROJECT_ID --json
49
75
  blitzreels project snapshot --project-id PROJECT_ID --at 00:03
50
76
  blitzreels project snapshots --project-id PROJECT_ID --at 00:01,00:03
51
77
 
78
+ blitzreels timeline transform --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --position-x 0 --position-y -230 --width-px 561 --height-px 212 --keep-aspect-ratio true
79
+ blitzreels timeline move --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --at 00:06 --layer-index 2
80
+ blitzreels timeline delete --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --auto-pack false
81
+
52
82
  blitzreels text add --project-id PROJECT_ID --text "Hook" --at 0 --duration 4
83
+ blitzreels text add --project-id PROJECT_ID --text "SERVEURS MCP" --at 24.33 --duration 2.8 --font-family Pacifico --font-size 82 --color "#17FFA6" --background-color "rgba(3,7,18,0.82)" --top "24%"
53
84
  blitzreels text list --project-id PROJECT_ID --json
54
- blitzreels text update --project-id PROJECT_ID --content-item-id CONTENT_ITEM_ID --text "New hook"
85
+ blitzreels text update --project-id PROJECT_ID --content-item-id CONTENT_ITEM_ID --text "New hook" --font-family Inter --font-size 64 --color "#FFFFFF"
55
86
  blitzreels text remove --project-id PROJECT_ID --content-item-id CONTENT_ITEM_ID
56
87
 
57
88
  blitzreels audio add --project-id PROJECT_ID --asset-id ASSET_ID --at 0 --volume 0.6
58
89
 
90
+ blitzreels captions words list --project-id PROJECT_ID --match-text "Supabase" --json
91
+ blitzreels captions words text --project-id PROJECT_ID --word-id WORD_ID --text "Supabase"
92
+ blitzreels captions words batch-text --project-id PROJECT_ID --updates-json '[{"word_id":"WORD_ID","new_text":"Supabase"}]'
93
+ blitzreels captions words style --project-id PROJECT_ID --word-id WORD_ID --font-family Pacifico --color "#17FFA6" --scale 1.45
94
+ blitzreels captions words emphasis --project-id PROJECT_ID --match-text "MCP" --emphasis true
95
+ blitzreels captions words delete --project-id PROJECT_ID --word-id WORD_ID
96
+ blitzreels captions words merge --project-id PROJECT_ID --word-ids WORD_ID_1,WORD_ID_2 --text "serveurs MCP"
97
+ blitzreels captions words split --project-id PROJECT_ID --word-id WORD_ID --words "serveurs,MCP"
98
+
59
99
  blitzreels silence plan --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --json
60
100
  blitzreels silence apply --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --confirm-preview
61
101
 
@@ -75,3 +115,31 @@ blitzreels api spec
75
115
  ```
76
116
 
77
117
  Use `--json` for script and AI-agent workflows.
118
+
119
+ ## Faulty Commands
120
+
121
+ The CLI validates commands and flags before making API calls. Faulty commands
122
+ print the closest known command or flag, then the command-specific usage.
123
+
124
+ ```bash
125
+ blitzreels caption words list --project-id PROJECT_ID
126
+ # Unknown command: caption words list
127
+ # Did you mean?
128
+ # blitzreels captions words list --project-id ID ...
129
+ ```
130
+
131
+ With `--json`, errors are structured on stderr:
132
+
133
+ ```json
134
+ {
135
+ "error": {
136
+ "code": "unknown_flag",
137
+ "message": "Unknown flag --poject-id for `projects get`.",
138
+ "suggestions": ["--project-id"],
139
+ "usage": "blitzreels projects get --project-id ID [--json]"
140
+ }
141
+ }
142
+ ```
143
+
144
+ Use `blitzreels <command> --help` for command-specific flags without requiring
145
+ auth.