Skip to content

V- Modal AI: Visual Video / Image Search - Flutter Video SDK

Release Flutter SDK from b0b873a9e326ac40f40051d6750a5bfe676f4806

vmodal-release-app12adeaefd6f8
diff --git a/.pubignore b/.pubignore
index e44bfe8..879fc6f 100644
--- a/.pubignore
+++ b/.pubignore
@@ -10,7 +10,10 @@ docs/dev_plan_step.md
docs_sdk/
docs.py
release/
+test/routes_gen_test.dart
+tool/gen_routes.dart
tool/live_test.dart
+tool/routes_manifest.dart
utils.py
SOURCE_MANIFEST.sha256
*.iml
diff --git a/RELEASE_METADATA b/RELEASE_METADATA
index b03be7c..010975a 100644
--- a/RELEASE_METADATA
+++ b/RELEASE_METADATA
@@ -1 +1 @@
-Source-vmx-api: fb220f81fce410de282cf538cd0887d61ebb0e1e
+Source-vmx-api: b0b873a9e326ac40f40051d6750a5bfe676f4806
diff --git a/SOURCE_MANIFEST.sha256 b/SOURCE_MANIFEST.sha256
index 3f9d94d..97a4d9a 100644
--- a/SOURCE_MANIFEST.sha256
+++ b/SOURCE_MANIFEST.sha256
@@ -1,10 +1,10 @@
e789cd4d1bed8a78ec8014c5c5913e300f81b63ea56a56aacb0dfec3b5e7ce2b ./.flutter-version
fbbda2e7e29bbd860539a9ca18c478f3b02de140f25a872c19a6dbecd11bc94b ./.github/workflows/publish.yml
-1643ecc8f8b7aeb9d0571896b5d723a89d932be362df671e0d95a1f6214dd2ee ./.pubignore
+5115d06bd9913f466d50fcbf8ad8890372349060c54a4581f3481ea084cfdec6 ./.pubignore
44900e7c55f6cf8e5068d7a3f169fdf8590ae63bb20602ef67941b879e70582a ./CHANGELOG.md
37b7148216ac6090e36adfb699d642b8dd1e1b8ba99870e65e88733947a59fa6 ./LICENSE
691400d97ff36d07087f587b8d1d65bdf4bf7dd23a06816ac550ddff8b2bb1c8 ./README.md
-434426ea04c0e7ada347b0a04c37eef951b5a4c3d72cf624ee00ec47ac883392 ./RELEASE_METADATA
+f83deb28c8fe2365290bb521a5fcd806f2eb9e153dd874de32836d41868813f0 ./RELEASE_METADATA
def7e4f643adff5b01b877b6a7fa5b2381612b693c0bf06bd232ee0f7197d342 ./analysis_options.yaml
09a850ca6ebd5470138b7f20204d4dbe0fec89d268a205f14cf3bff0b99f365b ./build.sh
4f18642680fb433554a5523d00bd99e0d650af340bcaebe628f59f63ac84e458 ./dartdoc_options.yaml
@@ -84,12 +84,13 @@ f6bae8dec3f5ce5afd314198c9a107082d3172cfe0bc6e02efcbc528cabdac1a ./example/test
9464fff0c519a1ce70cddefb3e3eaa95d07b97ccdaf5b8381c01d7c88767ae83 ./lib/src/api_key_provider.dart
d796fc674bb0b8c784fac0f0470b6ff816c98d9ace4b90f593912e5479e45d4e ./lib/src/client.dart
ef4f3226baaefde24d45c7b4d8e9592665d85e1abbdafae4c7e59c462fd42b7d ./lib/src/collection_uploads.dart
-70901be6310dccada51c7b0ad993c6d3d1d99f4223dfd6a7279c49eed67e3fd0 ./lib/src/config.dart
+58e4e7162a6c46d2981935649a3f1d40c969dc1fc3a81cab34f518673a479e6a ./lib/src/config.dart
873d969cfed5c725d34df0fd0c8769462b56992cf523710fcf741a81fa1bbcad ./lib/src/errors.dart
2ad9b4183bce96eacd91c5514de9231b1f0a4f269392726e174507cfa507981a ./lib/src/http.dart
52d09295f014fc4f8f8ff1ad714a8be830729b7e29cd6aa5421678e58edd2f0e ./lib/src/models.dart
ed22b7665e09c9f2f4158c225affe6527b7d3eb921db0ccdf06c01c8cf31db96 ./lib/src/resources.dart
-c96728e339d8a5e83d3731226af832f53545839401e41620eef3f432ac1969c4 ./lib/src/routes.dart
+43770c621bffccf69eacebd1e3b297503ca288093c848f0e8ccbd118d7f0d88a ./lib/src/routes.dart
+27056230065682f3ea3aa747c39c08950dcdca87387f4733adfad18f4b345b06 ./lib/src/routes.g.dart
f0e69d1016f82fbad2a96434129a54a0129f095a0e138cce555db37c8120023f ./lib/src/transport.dart
d407a3846da3236f37c5dc6af6c231116cc4f23844f623eb22db5365c6616bb5 ./lib/src/upload.dart
732e7f2f942e1c427e19ee3bdb766053f625f69e87dcf770d969555dbc7a9881 ./lib/src/utils.dart
@@ -99,24 +100,25 @@ d407a3846da3236f37c5dc6af6c231116cc4f23844f623eb22db5365c6616bb5 ./lib/src/uplo
a80b38547f5d9ca1874f60e71c648e3fc12ab5f7cb88d1bead6d5b863d3c0245 ./readme_assets/dev_homepage.jpg
c56419d129059b64551e06f074e88ef62676f25938dc2a1fe28a6ab3f2ba8547 ./readme_assets/logo_vmodal_owl.jpeg
d31d6bb36542a9022c62d2d9940b0efd07f60b1cdfb30e35f8be8b15a226c843 ./run.sh
-5ee841b9f4a4e4bb682aac32c401b600bc972006ce158869496605d1df8fda60 ./security_check.sh
+d2dfce0e68717f8626ecaadb4552f7471ced1dbdfe6a51182e0d62c24a1b718b ./security_check.sh
3d4e4935fa33de6589ebf3303963a9cfe60adcbd7f8f38ba4ba3e58e85646c11 ./test.sh
be59599b9ba77d031e9b4bad7f8d5c59efd2687888c5b73be4fbea115902106b ./test/adaptive_upload_test.dart
002abcc5d95c0cf20375adefe4ee2472581a615e64f5726bf361dd5c679cdea7 ./test/auth_http_test.dart
29dbaadfb34d6c39048edc7e2caccd16ecfbdfaddfc29519326d719de4741936 ./test/client_test.dart
ba941377f1ee717091dd30522609d028f32cd60df575564c75ab0228c2543d35 ./test/config_routes_test.dart
7f8b5f0faaec667a991dcf800da5d56b509c1934206a8b5a6392c6167ac1fbba ./test/docs_reference_test.dart
+1e0c931471bbee5832c7186ffc67b526da4c1c3d6385b8dfebb8cf0b49b2a99e ./test/errors_leak_test.dart
a998f548e5e7bf975222cabd530302e47e45bd7cdc21697fbd333ae7d98965c2 ./test/fakes.dart
0a1394c90829b91541aa01e9786e3195aae04fc49a7b92775dbf404bf2802107 ./test/fakes_test.dart
14368b598ece0ce9b2e249148a10a92f2c80e38427c077013a1515826f4365bd ./test/fixtures/routes_contract.json
fd2bad0ad87fbf2f15f7e9845b830db58408bb4c502c6ff105f39e4e7cce1905 ./test/multipart_upload_test.dart
-eb72ddf861f09a8898442358138534d56fcd0266d5a2fddae51e2722dfaeaa47 ./test/regression_manifest_test.dart
+79983050ec8ff314c82661f2e242f19ec5cad1b1f072a5c00adde603b3dabdb1 ./test/regression_manifest_test.dart
ec2d3ab09457fdccf30fc338585b89cf466f5d8f7fc8ce5f6c0ae52357390277 ./test/resources_models_test.dart
-f7e75763ceec4bfba6f116fff23efd357a7a7ee9f141237443cf42c2300268d9 ./test/shell_scripts_test.dart
+a244d06cd27a4cbcf53ad5e8d6a8355fa8e01546293c7418ca836ea42ce95a35 ./test/shell_scripts_test.dart
79e3de3c03451cd9d62327430106edf861da6aeb97b546bbac2d93a0bcbbe3d3 ./test/transport_test.dart
c13557f89597f0be73f48dc8463aa7513e9e814c0e6a0ab871e441834687abb1 ./test/upload_test.dart
5781ecdda41052a0a68b3d5a2f6a976a47f20cedd01b708e33f9af758bccbd6d ./test/workflow_layout_test.dart
406de1350b79662fcaf007cb0cacd7a6b71b83815dc7cd3c7b561fcfba5600a3 ./tool/check_route_sync.dart
d5f5f9246656a5c275c5ab5863dbf3945d8ef6b1c9042c9d1912cfafce93646f ./tool/flutter_checksums.txt
d09e2ee68e0e238b86e54a8248a0da92db81c953ce691628708bffd63fa3e737 ./tool/live_test.dart
-7b1e5574aaf77db0de5a52fd87809ce3b10389e16d2e83c9f7816964e6da689f ./tool/release_manifest.dart
+84fe3892295b846e13fea3c3c791328f658efd7baa5a92e21a18500206cb0925 ./tool/release_manifest.dart
diff --git a/lib/src/config.dart b/lib/src/config.dart
index e2a8215..8dba791 100644
--- a/lib/src/config.dart
+++ b/lib/src/config.dart
@@ -11,7 +11,15 @@ const String publicGatewayUrlHash =
final String publicGatewayUrl = utf8.decode(base64Decode(publicGatewayUrlHash));
/// @nodoc
-const String devGatewayUrl = 'http://127.0.0.1:3099';
+const String devGatewayUrlHash = 'aHR0cDovLzEyNy4wLjAuMTozMDk5';
+
+/// @nodoc
+final String devGatewayUrl = utf8.decode(base64Decode(devGatewayUrlHash));
+
+const String _gatewayProxyPathHash = 'L2FwaS92MS9wcm94eS9zZWFyY2hfYXBp';
+final String _gatewayProxyPath = utf8.decode(
+ base64Decode(_gatewayProxyPathHash),
+);
/// Immutable client configuration and credential-provider binding.
///
@@ -186,14 +194,14 @@ class SdkConfig {
String strGatewayBaseUrl(String baseUrl, [String mode = '']) {
final base = baseUrl.trim().replaceFirst(RegExp(r'/+$'), '');
if (base.isEmpty || mode.trim().toLowerCase() != 'gateway') return base;
- const suffix = '/api/v1/proxy/search_api';
+ final suffix = _gatewayProxyPath;
return base.endsWith(suffix) ? base : '$base$suffix';
}
/// @nodoc
String strUsersBaseUrl(String baseUrl) {
final base = baseUrl.trim().replaceFirst(RegExp(r'/+$'), '');
- const suffix = '/api/v1/proxy/search_api';
+ final suffix = _gatewayProxyPath;
return base.endsWith(suffix)
? base.substring(0, base.length - suffix.length)
: base;
diff --git a/lib/src/routes.dart b/lib/src/routes.dart
index 91fd34c..61015c0 100644
--- a/lib/src/routes.dart
+++ b/lib/src/routes.dart
@@ -1,5 +1,9 @@
+import 'dart:convert';
+
import 'errors.dart';
+part 'routes.g.dart';
+
/// @nodoc
enum RouteCategory {
active,
@@ -30,340 +34,56 @@ class RouteSpec {
/// @nodoc
abstract final class Routes {
- static const String prefix = '/api/external/v1';
- static const String usersApiPrefix = '/api/v1';
+ static String get prefix => _routeValue('prefix');
+ static String get usersApiPrefix => _routeValue('usersApiPrefix');
- static const String health = '/health';
- static const String searchClient = '/search';
- static const String groups = '/collection/groups';
- static const String indexationJobs = '/indexation/jobs';
- static const String indexationSubmit = '/indexation/job/create';
- static const String indexationStatus = '/indexation/job/{job_id}';
- static const String indexationDelete = '/indexation/index/delete';
- static const String upload = '/collection/upload';
- static const String uploadFolder = '/upload/folder';
- static const String uploadGoogleDriveFolder =
- '/collection/upload/google_drive';
- static const String uploadMetadataJsonl = '/collection/upload/metadata';
- static const String collectionDescriptionUpdate =
- '/collection/description/update';
- static const String collectionDelete = '/collection/delete';
- static const String collectionAddAssets =
- '/collection/{collection_id}/assets/create';
- static const String adminUserStats = '/admin/user-stats';
- static const String uploadMetadataItemParquetInternal =
- '/api/internal/v1/collection/upload/metadata';
+ static String get health => _routeValue('health');
+ static String get searchClient => _routeValue('searchClient');
+ static String get groups => _routeValue('groups');
+ static String get indexationJobs => _routeValue('indexationJobs');
+ static String get indexationSubmit => _routeValue('indexationSubmit');
+ static String get indexationStatus => _routeValue('indexationStatus');
+ static String get indexationDelete => _routeValue('indexationDelete');
+ static String get upload => _routeValue('upload');
+ static String get uploadFolder => _routeValue('uploadFolder');
+ static String get uploadGoogleDriveFolder =>
+ _routeValue('uploadGoogleDriveFolder');
+ static String get uploadMetadataJsonl => _routeValue('uploadMetadataJsonl');
+ static String get collectionDescriptionUpdate =>
+ _routeValue('collectionDescriptionUpdate');
+ static String get collectionDelete => _routeValue('collectionDelete');
+ static String get collectionAddAssets => _routeValue('collectionAddAssets');
+ static String get adminUserStats => _routeValue('adminUserStats');
+ static String get uploadMetadataItemParquetInternal =>
+ _routeValue('uploadMetadataItemParquetInternal');
- static const String imageGetUrl = '/image/get_url';
- static const String imageGetUrlBulk = '/image/get_url_bulk';
- static const String imageGetImage = '/image/get_image';
- static const String imageGetImageBulk = '/image/get_image_bulk';
+ static String get imageGetUrl => _routeValue('imageGetUrl');
+ static String get imageGetUrlBulk => _routeValue('imageGetUrlBulk');
+ static String get imageGetImage => _routeValue('imageGetImage');
+ static String get imageGetImageBulk => _routeValue('imageGetImageBulk');
- static const String authMe = '/auth/me';
- static const String adminUsage = '/admin/usage';
- static const String adminCacheStats = '/admin/cache/stats';
- static const String r2Credentials = '/get_r2_credentials/';
- static const String r2UploadFile = '/upload_file/';
- static const String r2UploadFolderVideo = '/upload_folder_video/';
+ static String get authMe => _routeValue('authMe');
+ static String get adminUsage => _routeValue('adminUsage');
+ static String get adminCacheStats => _routeValue('adminCacheStats');
+ static String get r2Credentials => _routeValue('r2Credentials');
+ static String get r2UploadFile => _routeValue('r2UploadFile');
+ static String get r2UploadFolderVideo => _routeValue('r2UploadFolderVideo');
- static const String externalUploadGetSignedUrl =
- '/collections/external_upload_get_signed_url';
- static const String externalUploadDone = '/collection/upload/done';
- static const String externalUploadMultipartCreate =
- '/collections/external_upload_multipart/create';
- static const String externalUploadMultipartSignParts =
- '/collections/external_upload_multipart/sign_parts';
- static const String externalUploadMultipartStatus =
- '/collections/external_upload_multipart/status';
- static const String externalUploadMultipartComplete =
- '/collections/external_upload_multipart/complete';
- static const String externalUploadMultipartAbort =
- '/collections/external_upload_multipart/abort';
+ static String get externalUploadGetSignedUrl =>
+ _routeValue('externalUploadGetSignedUrl');
+ static String get externalUploadDone => _routeValue('externalUploadDone');
+ static String get externalUploadMultipartCreate =>
+ _routeValue('externalUploadMultipartCreate');
+ static String get externalUploadMultipartSignParts =>
+ _routeValue('externalUploadMultipartSignParts');
+ static String get externalUploadMultipartStatus =>
+ _routeValue('externalUploadMultipartStatus');
+ static String get externalUploadMultipartComplete =>
+ _routeValue('externalUploadMultipartComplete');
+ static String get externalUploadMultipartAbort =>
+ _routeValue('externalUploadMultipartAbort');
- static const List<RouteSpec> specs = <RouteSpec>[
- RouteSpec('auth.health', 'GET', health, RouteCategory.active, 'upstream'),
- RouteSpec(
- 'auth.auth_check',
- 'GET',
- health,
- RouteCategory.active,
- 'upstream',
- ),
- RouteSpec(
- 'searches.search_video',
- 'POST',
- searchClient,
- RouteCategory.active,
- 'upstream',
- ),
- RouteSpec(
- 'collections.list_groups',
- 'GET',
- groups,
- RouteCategory.active,
- 'upstream',
- ),
- RouteSpec(
- 'collections.upload_file',
- 'POST',
- upload,
- RouteCategory.active,
- 'upstream',
- ),
- RouteSpec(
- 'collections.upload_metadata_jsonl',
- 'POST',
- uploadMetadataJsonl,
- RouteCategory.active,
- 'upstream',
- ),
- RouteSpec(
- 'collections.update_description',
- 'POST',
- collectionDescriptionUpdate,
- RouteCategory.active,
- 'upstream',
- ),
- RouteSpec(
- 'collections.delete',
- 'DELETE',
- collectionDelete,
- RouteCategory.active,
- 'upstream',
- ),
- RouteSpec(
- 'collections.add_assets',
- 'POST',
- collectionAddAssets,
- RouteCategory.active,
- 'upstream',
- ),
- RouteSpec(
- 'indexes.jobs_list',
- 'GET',
- indexationJobs,
- RouteCategory.active,
- 'upstream',
- ),
- RouteSpec(
- 'indexes.create_index',
- 'POST',
- indexationSubmit,
- RouteCategory.active,
- 'upstream',
- ),
- RouteSpec(
- 'indexes.index_status',
- 'GET',
- indexationStatus,
- RouteCategory.active,
- 'upstream',
- ),
- RouteSpec(
- 'indexes.delete_index',
- 'DELETE',
- indexationDelete,
- RouteCategory.active,
- 'upstream',
- ),
- RouteSpec(
- 'admin.user_stats',
- 'GET',
- adminUserStats,
- RouteCategory.active,
- 'upstream',
- ),
- RouteSpec(
- 'collections.upload_google_drive_folder',
- 'POST',
- uploadGoogleDriveFolder,
- RouteCategory.deprecated,
- 'upstream',
- ),
- RouteSpec(
- 'collections.upload_folder',
- 'POST',
- uploadFolder,
- RouteCategory.disabled,
- 'upstream',
- ),
- RouteSpec(
- 'indexes.embedding_models',
- 'GET',
- '/indexes/embedding_models',
- RouteCategory.disabled,
- 'upstream',
- ),
- RouteSpec(
- 'collections.auto_index_get',
- 'GET',
- '/collection/auto_index',
- RouteCategory.disabled,
- 'upstream',
- ),
- RouteSpec(
- 'collections.auto_index_set',
- 'POST',
- '/collection/auto_index',
- RouteCategory.disabled,
- 'upstream',
- ),
- RouteSpec(
- 'gdrive.private_auth_url',
- 'POST',
- '/gdrive/private/auth-url',
- RouteCategory.disabled,
- 'upstream',
- ),
- RouteSpec(
- 'gdrive.private_download',
- 'POST',
- '/gdrive/private/folder/download',
- RouteCategory.disabled,
- 'upstream',
- ),
- RouteSpec(
- 'sql.query',
- 'POST',
- '/sql/query',
- RouteCategory.disabled,
- 'upstream',
- ),
- RouteSpec(
- 'collections.create',
- 'NONE',
- '',
- RouteCategory.disabled,
- 'sdk_contract',
- ),
- RouteSpec(
- 'collections.edit',
- 'NONE',
- '',
- RouteCategory.disabled,
- 'sdk_contract',
- ),
- RouteSpec(
- 'images.get_url',
- 'POST',
- imageGetUrl,
- RouteCategory.image,
- 'apionly_serve_img.py',
- ),
- RouteSpec(
- 'images.get_url_bulk',
- 'POST',
- imageGetUrlBulk,
- RouteCategory.image,
- 'apionly_serve_img.py',
- ),
- RouteSpec(
- 'images.get_image_from_url',
- 'POST',
- imageGetImage,
- RouteCategory.image,
- 'apionly_serve_img.py',
- ),
- RouteSpec(
- 'images.get_image_bulk_from_urls',
- 'POST',
- imageGetImageBulk,
- RouteCategory.image,
- 'apionly_serve_img.py',
- ),
- RouteSpec('auth.me', 'GET', authMe, RouteCategory.usersApi, 'users_api'),
- RouteSpec(
- 'admin.usage',
- 'GET',
- adminUsage,
- RouteCategory.usersApi,
- 'users_api',
- ),
- RouteSpec(
- 'admin.cache_stats',
- 'GET',
- adminCacheStats,
- RouteCategory.usersApi,
- 'users_api',
- ),
- RouteSpec(
- 'r2.credentials',
- 'GET',
- r2Credentials,
- RouteCategory.usersApi,
- 'users_api',
- ),
- RouteSpec(
- 'r2.presign_upload_file',
- 'GET',
- r2UploadFile,
- RouteCategory.usersApi,
- 'users_api',
- ),
- RouteSpec(
- 'r2.presign_upload_folder_video',
- 'POST',
- r2UploadFolderVideo,
- RouteCategory.usersApi,
- 'users_api',
- ),
- RouteSpec(
- 'collections.video_upload.presign',
- 'POST',
- externalUploadGetSignedUrl,
- RouteCategory.signedSingle,
- 'sdk_python',
- ),
- RouteSpec(
- 'collections.video_upload.done',
- 'POST',
- externalUploadDone,
- RouteCategory.signedSingle,
- 'sdk_python',
- ),
- RouteSpec(
- 'multipart.create',
- 'POST',
- externalUploadMultipartCreate,
- RouteCategory.multipartExperimental,
- 'sdk_python',
- ),
- RouteSpec(
- 'multipart.sign_parts',
- 'POST',
- externalUploadMultipartSignParts,
- RouteCategory.multipartExperimental,
- 'sdk_python',
- ),
- RouteSpec(
- 'multipart.status',
- 'GET',
- externalUploadMultipartStatus,
- RouteCategory.multipartExperimental,
- 'sdk_python',
- ),
- RouteSpec(
- 'multipart.complete',
- 'POST',
- externalUploadMultipartComplete,
- RouteCategory.multipartExperimental,
- 'sdk_python',
- ),
- RouteSpec(
- 'multipart.abort',
- 'POST',
- externalUploadMultipartAbort,
- RouteCategory.multipartExperimental,
- 'sdk_python',
- ),
- RouteSpec(
- 'metadata.internal_fallback',
- 'POST',
- uploadMetadataItemParquetInternal,
- RouteCategory.active,
- 'sdk_python',
- ),
- ];
+ static List<RouteSpec> get specs => _routeSpecs;
static String full(String path) => _addPrefix(path, prefix);
static String usersFull(String path) => _addPrefix(path, usersApiPrefix);
diff --git a/lib/src/routes.g.dart b/lib/src/routes.g.dart
new file mode 100644
index 0000000..9c6d481
--- /dev/null
+++ b/lib/src/routes.g.dart
@@ -0,0 +1,361 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND.
+// Obfuscation is anti-grep only, not security.
+part of 'routes.dart';
+
+const _encodedRouteValues = <String, String>{
+ "prefix": "L2FwaS9leHRlcm5hbC92MQ==",
+ "usersApiPrefix": "L2FwaS92MQ==",
+ "health": "L2hlYWx0aA==",
+ "searchClient": "L3NlYXJjaA==",
+ "groups": "L2NvbGxlY3Rpb24vZ3JvdXBz",
+ "indexationJobs": "L2luZGV4YXRpb24vam9icw==",
+ "indexationSubmit": "L2luZGV4YXRpb24vam9iL2NyZWF0ZQ==",
+ "indexationStatus": "L2luZGV4YXRpb24vam9iL3tqb2JfaWR9",
+ "indexationDelete": "L2luZGV4YXRpb24vaW5kZXgvZGVsZXRl",
+ "upload": "L2NvbGxlY3Rpb24vdXBsb2Fk",
+ "uploadFolder": "L3VwbG9hZC9mb2xkZXI=",
+ "uploadGoogleDriveFolder": "L2NvbGxlY3Rpb24vdXBsb2FkL2dvb2dsZV9kcml2ZQ==",
+ "uploadMetadataJsonl": "L2NvbGxlY3Rpb24vdXBsb2FkL21ldGFkYXRh",
+ "collectionDescriptionUpdate": "L2NvbGxlY3Rpb24vZGVzY3JpcHRpb24vdXBkYXRl",
+ "collectionDelete": "L2NvbGxlY3Rpb24vZGVsZXRl",
+ "collectionAddAssets":
+ "L2NvbGxlY3Rpb24ve2NvbGxlY3Rpb25faWR9L2Fzc2V0cy9jcmVhdGU=",
+ "adminUserStats": "L2FkbWluL3VzZXItc3RhdHM=",
+ "uploadMetadataItemParquetInternal":
+ "L2FwaS9pbnRlcm5hbC92MS9jb2xsZWN0aW9uL3VwbG9hZC9tZXRhZGF0YQ==",
+ "imageGetUrl": "L2ltYWdlL2dldF91cmw=",
+ "imageGetUrlBulk": "L2ltYWdlL2dldF91cmxfYnVsaw==",
+ "imageGetImage": "L2ltYWdlL2dldF9pbWFnZQ==",
+ "imageGetImageBulk": "L2ltYWdlL2dldF9pbWFnZV9idWxr",
+ "authMe": "L2F1dGgvbWU=",
+ "adminUsage": "L2FkbWluL3VzYWdl",
+ "adminCacheStats": "L2FkbWluL2NhY2hlL3N0YXRz",
+ "r2Credentials": "L2dldF9yMl9jcmVkZW50aWFscy8=",
+ "r2UploadFile": "L3VwbG9hZF9maWxlLw==",
+ "r2UploadFolderVideo": "L3VwbG9hZF9mb2xkZXJfdmlkZW8v",
+ "externalUploadGetSignedUrl":
+ "L2NvbGxlY3Rpb25zL2V4dGVybmFsX3VwbG9hZF9nZXRfc2lnbmVkX3VybA==",
+ "externalUploadDone": "L2NvbGxlY3Rpb24vdXBsb2FkL2RvbmU=",
+ "externalUploadMultipartCreate":
+ "L2NvbGxlY3Rpb25zL2V4dGVybmFsX3VwbG9hZF9tdWx0aXBhcnQvY3JlYXRl",
+ "externalUploadMultipartSignParts":
+ "L2NvbGxlY3Rpb25zL2V4dGVybmFsX3VwbG9hZF9tdWx0aXBhcnQvc2lnbl9wYXJ0cw==",
+ "externalUploadMultipartStatus":
+ "L2NvbGxlY3Rpb25zL2V4dGVybmFsX3VwbG9hZF9tdWx0aXBhcnQvc3RhdHVz",
+ "externalUploadMultipartComplete":
+ "L2NvbGxlY3Rpb25zL2V4dGVybmFsX3VwbG9hZF9tdWx0aXBhcnQvY29tcGxldGU=",
+ "externalUploadMultipartAbort":
+ "L2NvbGxlY3Rpb25zL2V4dGVybmFsX3VwbG9hZF9tdWx0aXBhcnQvYWJvcnQ=",
+ "embeddingModels": "L2luZGV4ZXMvZW1iZWRkaW5nX21vZGVscw==",
+ "autoIndex": "L2NvbGxlY3Rpb24vYXV0b19pbmRleA==",
+ "gdrivePrivateAuthUrl": "L2dkcml2ZS9wcml2YXRlL2F1dGgtdXJs",
+ "gdrivePrivateDownload": "L2dkcml2ZS9wcml2YXRlL2ZvbGRlci9kb3dubG9hZA==",
+ "sqlQuery": "L3NxbC9xdWVyeQ==",
+ "empty": "",
+};
+
+final _decodedRouteValues = <String, String>{};
+
+String _routeValue(String key) => _decodedRouteValues.putIfAbsent(
+ key,
+ () => utf8.decode(base64Decode(_encodedRouteValues[key]!)),
+);
+
+List<RouteSpec>? _routeSpecsCache;
+
+List<RouteSpec> get _routeSpecs => _routeSpecsCache ??= <RouteSpec>[
+ RouteSpec(
+ "auth.health",
+ "GET",
+ _routeValue("health"),
+ RouteCategory.active,
+ "upstream",
+ ),
+ RouteSpec(
+ "auth.auth_check",
+ "GET",
+ _routeValue("health"),
+ RouteCategory.active,
+ "upstream",
+ ),
+ RouteSpec(
+ "searches.search_video",
+ "POST",
+ _routeValue("searchClient"),
+ RouteCategory.active,
+ "upstream",
+ ),
+ RouteSpec(
+ "collections.list_groups",
+ "GET",
+ _routeValue("groups"),
+ RouteCategory.active,
+ "upstream",
+ ),
+ RouteSpec(
+ "collections.upload_file",
+ "POST",
+ _routeValue("upload"),
+ RouteCategory.active,
+ "upstream",
+ ),
+ RouteSpec(
+ "collections.upload_metadata_jsonl",
+ "POST",
+ _routeValue("uploadMetadataJsonl"),
+ RouteCategory.active,
+ "upstream",
+ ),
+ RouteSpec(
+ "collections.update_description",
+ "POST",
+ _routeValue("collectionDescriptionUpdate"),
+ RouteCategory.active,
+ "upstream",
+ ),
+ RouteSpec(
+ "collections.delete",
+ "DELETE",
+ _routeValue("collectionDelete"),
+ RouteCategory.active,
+ "upstream",
+ ),
+ RouteSpec(
+ "collections.add_assets",
+ "POST",
+ _routeValue("collectionAddAssets"),
+ RouteCategory.active,
+ "upstream",
+ ),
+ RouteSpec(
+ "indexes.jobs_list",
+ "GET",
+ _routeValue("indexationJobs"),
+ RouteCategory.active,
+ "upstream",
+ ),
+ RouteSpec(
+ "indexes.create_index",
+ "POST",
+ _routeValue("indexationSubmit"),
+ RouteCategory.active,
+ "upstream",
+ ),
+ RouteSpec(
+ "indexes.index_status",
+ "GET",
+ _routeValue("indexationStatus"),
+ RouteCategory.active,
+ "upstream",
+ ),
+ RouteSpec(
+ "indexes.delete_index",
+ "DELETE",
+ _routeValue("indexationDelete"),
+ RouteCategory.active,
+ "upstream",
+ ),
+ RouteSpec(
+ "admin.user_stats",
+ "GET",
+ _routeValue("adminUserStats"),
+ RouteCategory.active,
+ "upstream",
+ ),
+ RouteSpec(
+ "collections.upload_google_drive_folder",
+ "POST",
+ _routeValue("uploadGoogleDriveFolder"),
+ RouteCategory.deprecated,
+ "upstream",
+ ),
+ RouteSpec(
+ "collections.upload_folder",
+ "POST",
+ _routeValue("uploadFolder"),
+ RouteCategory.disabled,
+ "upstream",
+ ),
+ RouteSpec(
+ "indexes.embedding_models",
+ "GET",
+ _routeValue("embeddingModels"),
+ RouteCategory.disabled,
+ "upstream",
+ ),
+ RouteSpec(
+ "collections.auto_index_get",
+ "GET",
+ _routeValue("autoIndex"),
+ RouteCategory.disabled,
+ "upstream",
+ ),
+ RouteSpec(
+ "collections.auto_index_set",
+ "POST",
+ _routeValue("autoIndex"),
+ RouteCategory.disabled,
+ "upstream",
+ ),
+ RouteSpec(
+ "gdrive.private_auth_url",
+ "POST",
+ _routeValue("gdrivePrivateAuthUrl"),
+ RouteCategory.disabled,
+ "upstream",
+ ),
+ RouteSpec(
+ "gdrive.private_download",
+ "POST",
+ _routeValue("gdrivePrivateDownload"),
+ RouteCategory.disabled,
+ "upstream",
+ ),
+ RouteSpec(
+ "sql.query",
+ "POST",
+ _routeValue("sqlQuery"),
+ RouteCategory.disabled,
+ "upstream",
+ ),
+ RouteSpec(
+ "collections.create",
+ "NONE",
+ _routeValue("empty"),
+ RouteCategory.disabled,
+ "sdk_contract",
+ ),
+ RouteSpec(
+ "collections.edit",
+ "NONE",
+ _routeValue("empty"),
+ RouteCategory.disabled,
+ "sdk_contract",
+ ),
+ RouteSpec(
+ "images.get_url",
+ "POST",
+ _routeValue("imageGetUrl"),
+ RouteCategory.image,
+ "apionly_serve_img.py",
+ ),
+ RouteSpec(
+ "images.get_url_bulk",
+ "POST",
+ _routeValue("imageGetUrlBulk"),
+ RouteCategory.image,
+ "apionly_serve_img.py",
+ ),
+ RouteSpec(
+ "images.get_image_from_url",
+ "POST",
+ _routeValue("imageGetImage"),
+ RouteCategory.image,
+ "apionly_serve_img.py",
+ ),
+ RouteSpec(
+ "images.get_image_bulk_from_urls",
+ "POST",
+ _routeValue("imageGetImageBulk"),
+ RouteCategory.image,
+ "apionly_serve_img.py",
+ ),
+ RouteSpec(
+ "auth.me",
+ "GET",
+ _routeValue("authMe"),
+ RouteCategory.usersApi,
+ "users_api",
+ ),
+ RouteSpec(
+ "admin.usage",
+ "GET",
+ _routeValue("adminUsage"),
+ RouteCategory.usersApi,
+ "users_api",
+ ),
+ RouteSpec(
+ "admin.cache_stats",
+ "GET",
+ _routeValue("adminCacheStats"),
+ RouteCategory.usersApi,
+ "users_api",
+ ),
+ RouteSpec(
+ "r2.credentials",
+ "GET",
+ _routeValue("r2Credentials"),
+ RouteCategory.usersApi,
+ "users_api",
+ ),
+ RouteSpec(
+ "r2.presign_upload_file",
+ "GET",
+ _routeValue("r2UploadFile"),
+ RouteCategory.usersApi,
+ "users_api",
+ ),
+ RouteSpec(
+ "r2.presign_upload_folder_video",
+ "POST",
+ _routeValue("r2UploadFolderVideo"),
+ RouteCategory.usersApi,
+ "users_api",
+ ),
+ RouteSpec(
+ "collections.video_upload.presign",
+ "POST",
+ _routeValue("externalUploadGetSignedUrl"),
+ RouteCategory.signedSingle,
+ "sdk_python",
+ ),
+ RouteSpec(
+ "collections.video_upload.done",
+ "POST",
+ _routeValue("externalUploadDone"),
+ RouteCategory.signedSingle,
+ "sdk_python",
+ ),
+ RouteSpec(
+ "multipart.create",
+ "POST",
+ _routeValue("externalUploadMultipartCreate"),
+ RouteCategory.multipartExperimental,
+ "sdk_python",
+ ),
+ RouteSpec(
+ "multipart.sign_parts",
+ "POST",
+ _routeValue("externalUploadMultipartSignParts"),
+ RouteCategory.multipartExperimental,
+ "sdk_python",
+ ),
+ RouteSpec(
+ "multipart.status",
+ "GET",
+ _routeValue("externalUploadMultipartStatus"),
+ RouteCategory.multipartExperimental,
+ "sdk_python",
+ ),
+ RouteSpec(
+ "multipart.complete",
+ "POST",
+ _routeValue("externalUploadMultipartComplete"),
+ RouteCategory.multipartExperimental,
+ "sdk_python",
+ ),
+ RouteSpec(
+ "multipart.abort",
+ "POST",
+ _routeValue("externalUploadMultipartAbort"),
+ RouteCategory.multipartExperimental,
+ "sdk_python",
+ ),
+ RouteSpec(
+ "metadata.internal_fallback",
+ "POST",
+ _routeValue("uploadMetadataItemParquetInternal"),
+ RouteCategory.active,
+ "sdk_python",
+ ),
+];
diff --git a/security_check.sh b/security_check.sh
index 9ed1263..3d629f4 100755
--- a/security_check.sh
+++ b/security_check.sh
@@ -4,6 +4,7 @@ help='
Examples:
bash security_check.sh workflow
+ bash security_check.sh routes
bash security_check.sh all
'
set -euo pipefail
@@ -68,6 +69,60 @@ sdk_security_license() {
grep -q '^license: MIT$' pubspec.yaml
}
+sdk_security_routes() {
+ local help='
+ ## Usage:
+ bash security_check.sh routes
+ '
+ local dart literal temp status=0
+ dart="$(bash install.sh dart_bin)"
+ for literal in \
+ '/api/external/v1' \
+ '/api/internal/v1' \
+ '/api/v1/proxy/search_api' \
+ 'http://127.0.0.1:3099' \
+ 'searchapi-test.v-modal.com'; do
+ if grep -R -F -n --include='*.dart' "$literal" lib; then
+ echo "Plaintext SDK endpoint found in lib/: $literal" >&2
+ status=3
+ fi
+ done
+ while IFS= read -r literal; do
+ [[ -n "$literal" ]] || continue
+ if grep -R -F -n --include='*.dart' "$literal" lib; then
+ echo "Plaintext route found in lib/: $literal" >&2
+ status=3
+ fi
+ done < <(
+ grep -o '"path":"[^"]*"' test/fixtures/routes_contract.json |
+ sed -e 's/^"path":"//' -e 's/"$//' |
+ sort -u
+ )
+ if [[ -f tool/routes_manifest.dart && -f tool/gen_routes.dart ]]; then
+ while IFS= read -r literal; do
+ [[ -n "$literal" ]] || continue
+ if grep -R -F -n --include='*.dart' "$literal" lib; then
+ echo "Plaintext route found in lib/: $literal" >&2
+ status=3
+ fi
+ done < <("$dart" run tool/gen_routes.dart literals)
+ temp="$(mktemp "${TMPDIR:-/tmp}/vmodal-routes.XXXXXX.dart")"
+ trap 'rm -f "${temp:-}"' RETURN
+ "$dart" run tool/gen_routes.dart "$temp"
+ if ! cmp -s lib/src/routes.g.dart "$temp"; then
+ echo 'Generated route table is stale. Run dart run tool/gen_routes.dart.' >&2
+ diff -u lib/src/routes.g.dart "$temp" || true
+ status=3
+ fi
+ elif [[ -f tool/routes_manifest.dart || -f tool/gen_routes.dart ]]; then
+ echo 'Route generator and manifest must exist together.' >&2
+ status=3
+ else
+ echo 'Route freshness check skipped in the public source export.'
+ fi
+ return "$status"
+}
+
sdk_security_package() {
local help='
## Usage:
@@ -128,6 +183,7 @@ sdk_security_all() {
sdk_security_toolchain
sdk_security_version
sdk_security_license
+ sdk_security_routes
sdk_security_package
sdk_security_secrets
}
@@ -145,6 +201,7 @@ case "${1:-help}" in
toolchain) sdk_security_toolchain ;;
version) sdk_security_version ;;
license) sdk_security_license ;;
+ routes) sdk_security_routes ;;
package) sdk_security_package ;;
secrets) sdk_security_secrets ;;
all) sdk_security_all ;;
diff --git a/test/errors_leak_test.dart b/test/errors_leak_test.dart
new file mode 100644
index 0000000..4618c3b
--- /dev/null
+++ b/test/errors_leak_test.dart
@@ -0,0 +1,31 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:vmodal_sdk_flutter/vmodal_sdk_flutter.dart';
+
+void main() {
+ test('exception strings do not expose decoded endpoint values', () {
+ final route = Routes.full(Routes.searchClient);
+ final errors = <SdkException>[
+ const ValidationException('invalid request'),
+ ApiException('request failed', body: <String, String>{'path': route}),
+ TransportException(Exception(route)),
+ ];
+ for (final error in errors) {
+ final text = error.toString();
+ expect(
+ text,
+ isNot(contains(route)),
+ reason: error.runtimeType.toString(),
+ );
+ expect(
+ text,
+ isNot(contains(publicGatewayUrl)),
+ reason: error.runtimeType.toString(),
+ );
+ expect(
+ text,
+ isNot(contains(devGatewayUrl)),
+ reason: error.runtimeType.toString(),
+ );
+ }
+ });
+}
diff --git a/test/regression_manifest_test.dart b/test/regression_manifest_test.dart
index d353891..4880d96 100644
--- a/test/regression_manifest_test.dart
+++ b/test/regression_manifest_test.dart
@@ -50,8 +50,11 @@ void main() {
'lib/src/transport.dart',
'lib/src/upload.dart',
'lib/src/adaptive_upload.dart',
+ 'lib/src/routes.g.dart',
'tool/check_route_sync.dart',
+ 'tool/gen_routes.dart',
'tool/release_manifest.dart',
+ 'tool/routes_manifest.dart',
'example/lib/main.dart',
];
for (final path in files) {
@@ -101,6 +104,9 @@ void main() {
'docs_sdk/',
'docs.py',
'utils.py',
+ 'test/routes_gen_test.dart',
+ 'tool/gen_routes.dart',
+ 'tool/routes_manifest.dart',
]) {
expect(text, contains(path), reason: path);
}
@@ -159,6 +165,9 @@ void main() {
'docs_sdk',
'docs.py',
'utils.py',
+ 'test/routes_gen_test.dart',
+ 'tool/gen_routes.dart',
+ 'tool/routes_manifest.dart',
]) {
expect(
FileSystemEntity.typeSync('${dir.path}/$path'),
diff --git a/test/shell_scripts_test.dart b/test/shell_scripts_test.dart
index 39984f1..301b000 100644
--- a/test/shell_scripts_test.dart
+++ b/test/shell_scripts_test.dart
@@ -3,6 +3,7 @@ import 'dart:io';
import 'package:flutter_test/flutter_test.dart';
const scripts = <String>[
+ 'cli.sh',
'install.sh',
'build.sh',
'run.sh',
@@ -74,6 +75,7 @@ void main() {
'toolchain',
'version',
'license',
+ 'routes',
'package',
'secrets',
'all',
@@ -89,6 +91,7 @@ void main() {
'sdk_security_toolchain',
'sdk_security_version',
'sdk_security_license',
+ 'sdk_security_routes',
'sdk_security_package',
'sdk_security_secrets',
]) {
@@ -107,4 +110,14 @@ void main() {
expect(live, contains('?.latestLancedbVersion'));
expect(live, contains('versionLancedb: version'));
});
+
+ test('pre-commit regenerates the SDK reference for Flutter changes', () {
+ final config = File('../../.pre-commit-config.yaml').readAsStringSync();
+ final cli = File('cli.sh').readAsStringSync();
+ expect(config, contains('files: ^uinterface/sdk_flutter/'));
+ expect(config, contains('cli.sh docs_precommit'));
+ expect(cli, contains('docs.py" generate'));
+ expect(cli, contains('docs.py" check'));
+ expect(cli, contains('diff --cached --name-only'));
+ });
}
diff --git a/tool/release_manifest.dart b/tool/release_manifest.dart
index 57592eb..7fc7cf5 100644
--- a/tool/release_manifest.dart
+++ b/tool/release_manifest.dart
@@ -113,6 +113,9 @@ Future<void> _export(Directory root, Directory destination) async {
await _copyDirectory(
Directory('${root.path}/$name'),
Directory('${destination.path}/$name'),
+ excluded: name == 'test'
+ ? const <String>{'routes_gen_test.dart'}
+ : const <String>{},
);
} else {
throw StateError('export source missing: $name');