V- Modal AI: Visual Video / Image Search - Flutter Video SDK
Dart android-sdkflutterflutter-appflutter-packageflutter-sdkflutter-videoflutter-video-editingflutter-video-playerflutter-video-sdkflutter-videosflutter-videosdkmobile-videomobile-video-editor-sdkmobile-video-sdkvideo-editingvideo-sdkvideo-searchvideo-search-enginevideo-streaming
Release Flutter SDK from b2c2738d9c7527875b32daa3fa7faf869ad6ba79
vmodal-release-app326b4f52d7be
diff --git a/README.md b/README.mdindex 10ba2db..c852e19 100644--- a/README.md+++ b/README.md@@ -330,6 +330,7 @@ Minimum toolchain: Flutter `3.44.0` and Dart `3.12.0`.- [Browse the public SDK reference](https://v-modal.github.io/vmodal_sdk_flutter/)- [Run the complete example app](https://github.com/v-modal/vmodal_sdk_flutter/tree/main/example/01_full_app)- [Organize global, per-user, multi-stream, and catalog indexes](https://github.com/v-modal/vmodal_sdk_flutter/tree/main/example/02_users)+- [Upload timestamped CCTV footage and search an absolute time range](https://github.com/v-modal/vmodal_sdk_flutter/tree/main/example/03_cctv)- [Read the SDK guide](https://github.com/v-modal/vmodal_sdk_flutter/blob/main/doc/sdk_doc.md)- [Manage API keys safely](https://github.com/v-modal/vmodal_sdk_flutter/blob/main/doc/manage_api_key.md)- [Build a search experience](https://github.com/v-modal/vmodal_sdk_flutter/blob/main/doc/search_app.md)diff --git a/RELEASE_METADATA b/RELEASE_METADATAindex 2b81400..4567a2c 100644--- a/RELEASE_METADATA+++ b/RELEASE_METADATA@@ -1 +1 @@-Source-vmx-api: 9ace1fb2ad558d5061b18eb1185cce9af9bd3d9e+Source-vmx-api: b2c2738d9c7527875b32daa3fa7faf869ad6ba79diff --git a/SOURCE_MANIFEST.sha256 b/SOURCE_MANIFEST.sha256index dd6e9d6..3a704e5 100644--- a/SOURCE_MANIFEST.sha256+++ b/SOURCE_MANIFEST.sha256@@ -4,10 +4,10 @@ a98f72526420d47e76b9b4e67ac86acd06b7088ad1f4c35617b11b09e59346ea ./.gitleaks.to5115d06bd9913f466d50fcbf8ad8890372349060c54a4581f3481ea084cfdec6 ./.pubignore0745f674359a58ea64d2d520f9bae88a57839b0aa812345ba6e49deff9f0d259 ./CHANGELOG.md37b7148216ac6090e36adfb699d642b8dd1e1b8ba99870e65e88733947a59fa6 ./LICENSE-c375e0f050a27469f4a9885e117f7f9351837d7141d9b6fe6cb15a3e3c2caead ./README.md-4a0178fc13cce1bd2fafabf18d9992220b526fd0c88827a3c05bc4a8cf8c7497 ./RELEASE_METADATA+f6dd9b72262243379a40c8f0d89bf368afa89ca5521bf2204aa673e6d7e2c1f2 ./README.md+065725e3f477de8789d95b3e7577b0e265c665cb64993037f2d1e810e080b7c1 ./RELEASE_METADATAdef7e4f643adff5b01b877b6a7fa5b2381612b693c0bf06bd232ee0f7197d342 ./analysis_options.yaml-8c2d096dc399d9bea2fcc5ae19d987e7458c8503cf2a7edf1f1497ae00d681aa ./build.sh+b3b5b1619725c24005b9f9a64879d0039b1dbebc7bcc48e56df67533ae922aed ./build.sh4f18642680fb433554a5523d00bd99e0d650af340bcaebe628f59f63ac84e458 ./dartdoc_options.yaml75461620cf3a062f4dad10e034952b82cca461b483788de1f46c539aca8b0f0f ./doc/manage_api_key.mda66d39da0983a994474fa516f81fd41bbb131efbd69c955891a41781a76daf24 ./doc/performance.md@@ -93,6 +93,13 @@ b373342c889d099d99a3209cb01cea188b53eb5b43ae26cad952abf5fda833bd ./example/02_uba3e6fe312940da56de324b044529900a0bfb5f94065d730f5b6ca5a8e61b83b ./example/02_users/pubspec.lockfa541e11cb4b9b791630b658c6856743ec4c31d957deb285ed031e7d4c2d48c6 ./example/02_users/pubspec.yaml31f28ca22dfb931fe963d2f766d8b5cba3c2722bca839787a506f1a692393a8c ./example/02_users/test/user_examples_test.dart+07f4acf99d24207114fa46b36147cbaebfa1c98f91d580bb2b1d499d3aeb91ed ./example/03_cctv/README.md+bf7d17dfdbc3aa4dcba00ef52506c50fd798bbcf3d0f907e875fa38bdfa9846f ./example/03_cctv/analysis_options.yaml+09ae9ca601d1c8c20db6251a99321b28ec84ed0ba1cac471eb6bafecefadb058 ./example/03_cctv/bin/main.dart+ea733b67f97cf5a32bf2b8ea1ee0d10460ac881690d6bc04ec15126ca166291c ./example/03_cctv/lib/cctv_example.dart+5b4267b88404647bfe3046d0a95eaa2593deb1c5ea53ea67dcc40f33bd6e1dc3 ./example/03_cctv/pubspec.lock+6cc52ddfa3d5b698f245b23cf4565367dafe232a8831daeb5fb3f5d25728cb07 ./example/03_cctv/pubspec.yaml+dd42921f5d6ee8fa50765aee06d59df7329d8bd27139eac02b716d14062e1c0c ./example/03_cctv/test/cctv_example_test.dart23756b83470b1f25f6a7e6b5a6270f123a5224e49fd8e2eda36001358951b688 ./install.sh7becacd31a8d134fa435b39cd819798d5fbf58f89b9f30c50362e2dcf757aaed ./lib/src/adaptive_upload.dart9464fff0c519a1ce70cddefb3e3eaa95d07b97ccdaf5b8381c01d7c88767ae83 ./lib/src/api_key_provider.dart@@ -116,6 +123,7 @@ e4413678ceb7bdfc1f6aaa241c53d8ba2033fc5171dd0a30030b62946d14008e ./lib/src/vmod99aef519729868a9134d5783788eca035446858911b2be3a1a4c3c8efbe4eb97 ./pubspec.yamla80b38547f5d9ca1874f60e71c648e3fc12ab5f7cb88d1bead6d5b863d3c0245 ./readme_assets/dev_homepage.jpgc56419d129059b64551e06f074e88ef62676f25938dc2a1fe28a6ab3f2ba8547 ./readme_assets/logo_vmodal_owl.jpeg+4506abc2673f8980fedde4079ba5ad0cc64eb6e3842e7e2f933deab8bf59df11 ./release_note.md3198051c448338c5331baef7e17ff32bfbaf1265b59543a8aca2baf57513feed ./run.shd2dfce0e68717f8626ecaadb4552f7471ced1dbdfe6a51182e0d62c24a1b718b ./security_check.sh75d9810c9d50fd1224462aba8d2d1669cbfa094bd9cc0e5275f3a6a9f1364cb5 ./test.sh@@ -131,16 +139,16 @@ d132b6dceb89804a47418245845547a25fcf8f89f56b292ee70a404d63364865 ./test/fakes.d14368b598ece0ce9b2e249148a10a92f2c80e38427c077013a1515826f4365bd ./test/fixtures/routes_contract.json593b356ac3431de80e03e7a0e2f1df0d29589140f44746468213c1cac1c35bbe ./test/multipart_upload_test.dart348b9581f6262acaaf96012a3d57685b0b45c3663c1497f14135663de7a60954 ./test/new_api_surface_test.dart-58222c7f00e8aa8070df89d59278ce0d18842f53a7544261aa4a63ae4b1dd608 ./test/regression_manifest_test.dart+08ceeca24b3550142c4b982109a92637fa700686533185ad0619fd249bfc94f2 ./test/regression_manifest_test.dart8c87a4645a2e329477d070277f64b617da14ac90163bb734fbb5326c1a97a5c3 ./test/resources_models_test.dart8619ce113bb8669612f9a2a16b1b334ac68435c5972e84828a789511467fcb77 ./test/shell_scripts_test.dartefe4f1158e7d4b9ca8e57f3538ce296279817292a4356c1399cf5f2cbae4c52d ./test/transcode_upload_test.dartb94c0fef25560e387c4de5de0e4032fce73aa22b23a4bf38594ea6ff241d914c ./test/transport_test.dartc4aa3c091992668ee531412a7fc783106769df7d75147eb06271492027b0c100 ./test/upload_test.dart-af4a5b0eaca0bc1b2ef86cb88900fb67185b619cd90e6b5598ff9276a147d0b5 ./test/workflow_layout_test.dart+4ab7edd1ae7230060f8afb3d041a58ca46e16c1b63f618129b0ecd74e70ba05b ./test/workflow_layout_test.dart406de1350b79662fcaf007cb0cacd7a6b71b83815dc7cd3c7b561fcfba5600a3 ./tool/check_route_sync.dartd5f5f9246656a5c275c5ab5863dbf3945d8ef6b1c9042c9d1912cfafce93646f ./tool/flutter_checksums.txt24ea8e3013e0ed3531ff2aa3c86ad5332bf315d3d26f6a0814d2d6c84c5dade2 ./tool/live_cctv_test.dartd09e2ee68e0e238b86e54a8248a0da92db81c953ce691628708bffd63fa3e737 ./tool/live_test.dartd0eb57dd08a93b8afe4dc8f078db8b7ba7bdfc926292c2cff183c6489104c776 ./tool/perf_benchmark.dart-98c97292e3feb880f6412a1635364ddc09d0711e424db35e0d053c006d5476ec ./tool/release_manifest.dart+685ff82afcd1d4696b52ac7e790756414b0d3c4b2e0b4ce177b5ec75c2792c83 ./tool/release_manifest.dartdiff --git a/build.sh b/build.shindex 779807c..ec45b1b 100755--- a/build.sh+++ b/build.sh@@ -41,6 +41,7 @@ sdk_pub_get() {sdk_flutter pub get(cd example/01_full_app && sdk_flutter pub get)(cd example/02_users && sdk_flutter pub get)+ (cd example/03_cctv && sdk_flutter pub get)}sdk_format() {@@ -48,7 +49,7 @@ sdk_format() {## Usage:bash build.sh format'- sdk_dart format --output=none --set-exit-if-changed lib test tool example/01_full_app/lib example/01_full_app/test example/02_users/lib example/02_users/test+ sdk_dart format --output=none --set-exit-if-changed lib test tool example/01_full_app/lib example/01_full_app/test example/02_users/lib example/02_users/test example/03_cctv/bin example/03_cctv/lib example/03_cctv/test}sdk_analyze() {@@ -59,6 +60,7 @@ sdk_analyze() {sdk_flutter analyze(cd example/01_full_app && sdk_flutter analyze)(cd example/02_users && sdk_flutter analyze)+ (cd example/03_cctv && sdk_flutter analyze)}sdk_test() {@@ -69,6 +71,7 @@ sdk_test() {sdk_flutter test(cd example/01_full_app && sdk_flutter test)(cd example/02_users && sdk_flutter test)+ (cd example/03_cctv && sdk_flutter test)}sdk_example_android() {diff --git a/example/03_cctv/README.md b/example/03_cctv/README.mdnew file mode 100644index 0000000..07134e6--- /dev/null+++ b/example/03_cctv/README.md@@ -0,0 +1,83 @@+# CCTV upload and absolute-time search++This compile-checked example demonstrates the Flutter SDK CCTV input contract.+It keeps the footage timestamp supplied by the camera, a caller-selected public+video filename, searchable metadata text, and every metadata tag.++## Progressive flow++Run operations in this order:++```text+runtime API key+ -> authenticate with auth.me()+ -> list project collections+ -> list index jobs for the camera collection+ -> upload timestamped CCTV footage+ -> create and wait for the frame index+ -> search metadata within an absolute time range+```++## New CCTV upload format++```dart+final input = CctvUploadInput(+ file: File('/camera/incoming/segment_001.mp4'),+ videoFilename: 'entrance_20260730_091500.mp4',+ startDatetimeUser: '2026-07-30T09:15:00+09:00',+ metadataText: 'Entrance camera during opening hours',+ metadataTags: const <String>['cctv', 'entrance', 'camera_01'],+ reProcess: false,+);++final task = example.upload(input);+final uploaded = await task.result;++print(uploaded.videoFilename);+print(uploaded.startDatetimeUser);+print(uploaded.startTsUnixUserMs);+print(uploaded.timestampSource);+```++`startDatetimeUser` must contain `Z` or an explicit UTC offset. The SDK sends+the original string, while the backend returns the canonical UTC epoch value in+`startTsUnixUserMs`. Tags are transmitted as repeated `metadata_tags` values.++## Absolute-time metadata search++After creating the index, search with paired inclusive-start and exclusive-end+bounds:++```dart+final found = await example.search(+ const CctvSearchInput(+ visualQuery: 'a person entering the building',+ metadataQuery: 'entrance',+ startDate: '2026-07-30T09:15:00+09:00',+ endDate: '2026-07-30T09:16:00+09:00',+ ),+);++print('matches=${found.cntActual}');+```++UTC-equivalent bounds such as `2026-07-30T00:15:00Z` address the same footage.++## Run the complete example++From `uinterface/sdk_flutter`:++```bash+bash build.sh pub_get+export VMODAL_API_KEY='your-runtime-api-key'+cd example/03_cctv+dart run bin/main.dart \+ /camera/incoming/segment_001.mp4 \+ entrance_20260730_091500.mp4 \+ 2026-07-30T09:15:00+09:00 \+ 2026-07-30T09:16:00+09:00+```++The command performs real upload, indexation, and search operations. Use a test+collection and a runtime key supplied by your application; do not embed keys in+source code or assets.diff --git a/example/03_cctv/analysis_options.yaml b/example/03_cctv/analysis_options.yamlnew file mode 100644index 0000000..f04c6cf--- /dev/null+++ b/example/03_cctv/analysis_options.yaml@@ -0,0 +1 @@+include: ../../analysis_options.yamldiff --git a/example/03_cctv/bin/main.dart b/example/03_cctv/bin/main.dartnew file mode 100644index 0000000..3c8b4bc--- /dev/null+++ b/example/03_cctv/bin/main.dart@@ -0,0 +1,76 @@+import 'dart:io';++import 'package:vmodal_cctv_example/cctv_example.dart';+import 'package:vmodal_sdk_flutter/vmodal_sdk_flutter.dart';++Future<void> main(List<String> args) async {+ if (args.length < 4) {+ stderr.writeln(+ 'Usage: dart run bin/main.dart VIDEO_PATH VIDEO_FILENAME '+ 'START_DATETIME END_DATETIME',+ );+ stderr.writeln(+ 'Example: dart run bin/main.dart camera.mp4 entrance_001.mp4 '+ '2026-07-30T09:15:00+09:00 2026-07-30T09:16:00+09:00',+ );+ exitCode = 2;+ return;+ }+ final apiKey = Platform.environment['VMODAL_API_KEY'] ?? '';+ if (apiKey.isEmpty) {+ stderr.writeln('VMODAL_API_KEY is required.');+ exitCode = 2;+ return;+ }++ final keys = MutableApiKeyProvider(apiKey);+ final example = CctvExample(apiKeyProvider: keys);+ final input = CctvUploadInput(+ file: File(args[0]),+ videoFilename: args[1],+ startDatetimeUser: args[2],+ metadataText: 'Entrance camera during opening hours',+ metadataTags: const <String>['cctv', 'entrance', 'camera_01'],+ );++ try {+ stdout.writeln('1. Authenticate');+ final profile = await example.authenticate();+ stdout.writeln(' authenticated type=${profile.type}');++ stdout.writeln('2. List collections');+ final collections = await example.listCollections();+ stdout.writeln(' collections=$collections');++ stdout.writeln('3. List index jobs');+ final jobs = await example.listIndexJobs();+ stdout.writeln(' index_jobs=${jobs.total}');++ stdout.writeln('4. Upload timestamped CCTV video');+ final uploaded = await example.upload(input).result;+ stdout.writeln(+ ' video=${uploaded.videoFilename} '+ 'start_ms=${uploaded.startTsUnixUserMs} '+ 'source=${uploaded.timestampSource}',+ );++ stdout.writeln('5. Create and wait for the frame index');+ final job = await example.createIndex();+ final status = await example.waitForIndex(job.jobId);+ stdout.writeln(' job=${job.jobId} status=${status.status}');++ stdout.writeln('6. Search metadata inside an absolute time range');+ final found = await example.search(+ CctvSearchInput(+ visualQuery: 'a person entering the building',+ metadataQuery: 'entrance',+ startDate: args[2],+ endDate: args[3],+ ),+ );+ stdout.writeln(' matches=${found.cntActual}');+ } finally {+ keys.clear();+ await example.close();+ }+}diff --git a/example/03_cctv/lib/cctv_example.dart b/example/03_cctv/lib/cctv_example.dartnew file mode 100644index 0000000..c1d6fae--- /dev/null+++ b/example/03_cctv/lib/cctv_example.dart@@ -0,0 +1,128 @@+import 'dart:async';+import 'dart:io';++import 'package:vmodal_sdk_flutter/vmodal_sdk_flutter.dart';++/// One CCTV video and its caller-owned timestamp and metadata.+final class CctvUploadInput {+ CctvUploadInput({+ required this.file,+ required this.videoFilename,+ required this.startDatetimeUser,+ required this.metadataText,+ required List<String> metadataTags,+ this.reProcess = false,+ }) : metadataTags = List<String>.unmodifiable(metadataTags);++ final File file;+ final String videoFilename;+ final String startDatetimeUser;+ final String metadataText;+ final List<String> metadataTags;+ final bool reProcess;++ VideoUploadOptions toUploadOptions() => VideoUploadOptions(+ videoFilename: videoFilename,+ startDatetimeUser: startDatetimeUser,+ metadataText: metadataText,+ metadataTags: metadataTags,+ reProcess: reProcess,+ );+}++/// Absolute-time search input for indexed CCTV frames.+final class CctvSearchInput {+ const CctvSearchInput({+ required this.visualQuery,+ required this.metadataQuery,+ required this.startDate,+ required this.endDate,+ this.versionLancedb,+ });++ final String visualQuery;+ final String metadataQuery;+ final String startDate;+ final String endDate;+ final int? versionLancedb;++ ScopedSearchOptions toSearchOptions() => ScopedSearchOptions(+ queryMetadataText: metadataQuery,+ searchSources: const <String>['image'],+ startDate: startDate,+ endDate: endDate,+ versionLancedb: versionLancedb,+ );+}++/// Progressive CCTV example: auth, discovery, upload, index, then search.+final class CctvExample {+ CctvExample({+ required ApiKeyProvider apiKeyProvider,+ this.projectId = 'cctv_app',+ this.collectionName = 'entrance_cameras',+ this.streamName = 'camera_01',+ }) : client = VmodalClient(+ config: SdkConfig(apiKeyProvider: apiKeyProvider),+ ) {+ project = VModal.fromClient(projectId: projectId, client: client);+ camera = project.scope(+ collectionName: collectionName,+ streamName: streamName,+ );+ }++ final String projectId;+ final String collectionName;+ final String streamName;+ final VmodalClient client;+ late final VModalProject project;+ late final VModalScope camera;++ Future<UserProfile> authenticate() => client.auth.me();++ Future<List<String>> listCollections() =>+ project.listCollections(mode: 'vid_file');++ Future<IndexationJobsListResponse> listIndexJobs() => camera.listIndexJobs();++ UploadTask<VideoUploadResponse> upload(CctvUploadInput input) =>+ camera.upload(+ UploadSource.fromFile(input.file),+ options: ScopedUploadOptions(uploadOptions: input.toUploadOptions()),+ );++ Future<IndexationSubmitResponse> createIndex() => camera.createIndex(+ options: const ScopedCreateIndexOptions(+ indexType: 'vid_img_emb',+ modality: 'vid_img_emb',+ ),+ );++ Future<IndexationStatusResponse> waitForIndex(+ String jobId, {+ Duration timeout = const Duration(minutes: 10),+ }) async {+ final deadline = DateTime.now().add(timeout);+ while (DateTime.now().isBefore(deadline)) {+ final status = await camera.indexStatus(jobId);+ if (const <String>{+ 'completed',+ 'success',+ 'done',+ }.contains(status.status)) {+ return status;+ }+ if (const <String>{'failed', 'error'}.contains(status.status)) {+ throw StateError('CCTV index job failed: ${status.status}');+ }+ await Future<void>.delayed(const Duration(seconds: 5));+ }+ throw TimeoutException('CCTV index job did not finish', timeout);+ }++ Future<SearchResponse> search(CctvSearchInput input) =>+ camera.search(input.visualQuery, options: input.toSearchOptions());++ Future<void> close() => project.close();+}diff --git a/example/03_cctv/pubspec.yaml b/example/03_cctv/pubspec.yamlnew file mode 100644index 0000000..954c9c9--- /dev/null+++ b/example/03_cctv/pubspec.yaml@@ -0,0 +1,22 @@+name: vmodal_cctv_example+description: Compile-checked VModal Flutter CCTV upload and search example.+publish_to: none+version: 1.0.0++environment:+ sdk: '>=3.12.0 <4.0.0'+ flutter: '>=3.44.0'++dependencies:+ flutter:+ sdk: flutter+ vmodal_sdk_flutter:+ path: ../..++dev_dependencies:+ flutter_lints: ^6.0.0+ flutter_test:+ sdk: flutter++flutter:+ uses-material-design: truediff --git a/example/03_cctv/test/cctv_example_test.dart b/example/03_cctv/test/cctv_example_test.dartnew file mode 100644index 0000000..4b8616f--- /dev/null+++ b/example/03_cctv/test/cctv_example_test.dart@@ -0,0 +1,67 @@+import 'dart:io';++import 'package:flutter_test/flutter_test.dart';+import 'package:vmodal_cctv_example/cctv_example.dart';+import 'package:vmodal_sdk_flutter/vmodal_sdk_flutter.dart';++void main() {+ test(+ 'CCTV input maps every new upload field without caller-list mutation',+ () {+ final tags = <String>['cctv', 'entrance', 'camera_01'];+ final input = CctvUploadInput(+ file: File('camera.mp4'),+ videoFilename: 'entrance_001.mp4',+ startDatetimeUser: '2026-07-30T09:15:00+09:00',+ metadataText: 'Entrance camera during opening hours',+ metadataTags: tags,+ reProcess: true,+ );+ tags.add('changed-after-construction');+ final options = input.toUploadOptions();++ expect(options.videoFilename, 'entrance_001.mp4');+ expect(options.startDatetimeUser, '2026-07-30T09:15:00+09:00');+ expect(options.metadataText, 'Entrance camera during opening hours');+ expect(options.metadataTags, <String>['cctv', 'entrance', 'camera_01']);+ expect(options.reProcess, isTrue);+ },+ );++ test('CCTV search maps metadata and offset-aware absolute time bounds', () {+ const input = CctvSearchInput(+ visualQuery: 'a person entering the building',+ metadataQuery: 'entrance',+ startDate: '2026-07-30T09:15:00+09:00',+ endDate: '2026-07-30T09:16:00+09:00',+ versionLancedb: 2,+ );+ final options = input.toSearchOptions();++ expect(options.queryMetadataText, 'entrance');+ expect(options.searchSources, <String>['image']);+ expect(options.startDate, '2026-07-30T09:15:00+09:00');+ expect(options.endDate, '2026-07-30T09:16:00+09:00');+ expect(options.versionLancedb, 2);+ });++ test('CCTV example exposes the progressive project and camera scope', () {+ final example = CctvExample(+ apiKeyProvider: MutableApiKeyProvider('runtime-key'),+ );+ addTearDown(example.close);++ expect(example.projectId, 'cctv_app');+ expect(example.collectionName, 'entrance_cameras');+ expect(example.streamName, 'camera_01');+ expect(example.camera.projectId, 'cctv_app');+ expect(example.camera.collectionName, 'entrance_cameras');+ expect(example.camera.streamName, 'camera_01');+ expect(example.authenticate, isA<Future<UserProfile> Function()>());+ expect(example.listCollections, isA<Future<List<String>> Function()>());+ expect(+ example.listIndexJobs,+ isA<Future<IndexationJobsListResponse> Function()>(),+ );+ });+}diff --git a/release_note.md b/release_note.mdnew file mode 100644index 0000000..bf4fa41--- /dev/null+++ b/release_note.md@@ -0,0 +1,12 @@+----------------------------------------------------------+date: 2026-09-01+origin_commit: 9ace1fb2ad558d5061b18eb1185cce9af9bd3d9e+title: Flutter SDK v1.2.0 CCTV timestamp and metadata contract+summary:+ - Added caller-selected CCTV video filenames, metadata text, repeated metadata tags, offset-aware start datetimes, and reprocessing options for direct and signed uploads.+ - Preserved the CCTV contract across single, multipart, resumed, bulk, adaptive, and transcoded upload paths, including the original public filename.+ - Added canonical timestamp response accessors for normalized start datetime, UTC epoch milliseconds, and timestamp source.+ - Added metadata-text and absolute-time video search support with timezone validation, paired date bounds, scoped API propagation, and legacy compatibility.+ - Added a compile-checked CCTV example covering authentication, collection and index-job discovery, timestamped upload, index creation, polling, and absolute-time search.+ - Added offline contract, multipart wire, transcode, workflow, and explicit CCTV live tests, plus synchronized documentation and generated Dart reference pages.+ - Released the public Flutter SDK source and documentation after analysis, SDK/example tests, security scanning, package validation, Android/iOS builds, and the production lifecycle passed.diff --git a/test/regression_manifest_test.dart b/test/regression_manifest_test.dartindex 51a77b0..1431a82 100644--- a/test/regression_manifest_test.dart+++ b/test/regression_manifest_test.dart@@ -45,6 +45,7 @@ void main() {test('required implementation and release artifacts exist', () {const files = <String>['dartdoc_options.yaml',+ 'release_note.md','lib/vmodal_sdk_flutter.dart','lib/src/client.dart','lib/src/content_scope.dart',@@ -59,6 +60,10 @@ void main() {'example/02_users/README.md','example/02_users/lib/user_examples.dart','example/02_users/test/user_examples_test.dart',+ 'example/03_cctv/README.md',+ 'example/03_cctv/bin/main.dart',+ 'example/03_cctv/lib/cctv_example.dart',+ 'example/03_cctv/test/cctv_example_test.dart','test/new_api_surface_test.dart',];for (final path in files) {@@ -117,6 +122,7 @@ void main() {expect(text, contains(path), reason: path);}expect(text, isNot(contains('dartdoc_options.yaml')));+ expect(text, isNot(contains('release_note.md')));});test('default all suite remains offline', () {@@ -146,6 +152,7 @@ void main() {expect(result.exitCode, 0, reason: '${result.stderr}');expect(File('${dir.path}/pubspec.lock').existsSync(), isTrue);expect(File('${dir.path}/dartdoc_options.yaml').existsSync(), isTrue);+ expect(File('${dir.path}/release_note.md').existsSync(), isTrue);expect(File('${dir.path}/.gitleaks.toml').existsSync(), isTrue);for (final path in <String>['install.sh',@@ -163,6 +170,10 @@ void main() {'example/02_users/lib/user_streams.dart','example/02_users/lib/product_catalog.dart','example/02_users/test/user_examples_test.dart',+ 'example/03_cctv/README.md',+ 'example/03_cctv/bin/main.dart',+ 'example/03_cctv/lib/cctv_example.dart',+ 'example/03_cctv/test/cctv_example_test.dart','doc/search_app.md','doc/sdk_doc.md','doc/manage_api_key.md',@@ -194,6 +205,8 @@ void main() {'example/01_full_app/ios/Runner/GeneratedPluginRegistrant.m','example/02_users/.dart_tool','example/02_users/build',+ 'example/03_cctv/.dart_tool',+ 'example/03_cctv/build','doc/todo/sdk_doc.md','docs_sdk','docs.py',diff --git a/test/workflow_layout_test.dart b/test/workflow_layout_test.dartindex 834afd4..0365d9a 100644--- a/test/workflow_layout_test.dart+++ b/test/workflow_layout_test.dart@@ -174,6 +174,7 @@ void checkWorkflow(String main, String tagged) {expect(main, contains('for attempt in {1..30}'));expect(main, contains('https://pub.dev/api/packages/vmodal_sdk_flutter'));expect(main, contains('dartdoc_options.yaml'));+ expect(main, contains('README.md release_note.md CHANGELOG.md'));expect(main, contains("--exclude='todo'"));final actions = RegExp(diff --git a/tool/release_manifest.dart b/tool/release_manifest.dartindex dc1de73..8b23bcf 100644--- a/tool/release_manifest.dart+++ b/tool/release_manifest.dart@@ -85,6 +85,7 @@ Future<void> _export(Directory root, Directory destination) async {'dartdoc_options.yaml','LICENSE','README.md',+ 'release_note.md','readme_assets','CHANGELOG.md','.flutter-version',