Skip to content

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

Release Flutter SDK from b2c2738d9c7527875b32daa3fa7faf869ad6ba79

vmodal-release-app326b4f52d7be
diff --git a/README.md b/README.md
index 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_METADATA
index 2b81400..4567a2c 100644
--- a/RELEASE_METADATA
+++ b/RELEASE_METADATA
@@ -1 +1 @@
-Source-vmx-api: 9ace1fb2ad558d5061b18eb1185cce9af9bd3d9e
+Source-vmx-api: b2c2738d9c7527875b32daa3fa7faf869ad6ba79
diff --git a/SOURCE_MANIFEST.sha256 b/SOURCE_MANIFEST.sha256
index dd6e9d6..3a704e5 100644
--- a/SOURCE_MANIFEST.sha256
+++ b/SOURCE_MANIFEST.sha256
@@ -4,10 +4,10 @@ a98f72526420d47e76b9b4e67ac86acd06b7088ad1f4c35617b11b09e59346ea ./.gitleaks.to
5115d06bd9913f466d50fcbf8ad8890372349060c54a4581f3481ea084cfdec6 ./.pubignore
0745f674359a58ea64d2d520f9bae88a57839b0aa812345ba6e49deff9f0d259 ./CHANGELOG.md
37b7148216ac6090e36adfb699d642b8dd1e1b8ba99870e65e88733947a59fa6 ./LICENSE
-c375e0f050a27469f4a9885e117f7f9351837d7141d9b6fe6cb15a3e3c2caead ./README.md
-4a0178fc13cce1bd2fafabf18d9992220b526fd0c88827a3c05bc4a8cf8c7497 ./RELEASE_METADATA
+f6dd9b72262243379a40c8f0d89bf368afa89ca5521bf2204aa673e6d7e2c1f2 ./README.md
+065725e3f477de8789d95b3e7577b0e265c665cb64993037f2d1e810e080b7c1 ./RELEASE_METADATA
def7e4f643adff5b01b877b6a7fa5b2381612b693c0bf06bd232ee0f7197d342 ./analysis_options.yaml
-8c2d096dc399d9bea2fcc5ae19d987e7458c8503cf2a7edf1f1497ae00d681aa ./build.sh
+b3b5b1619725c24005b9f9a64879d0039b1dbebc7bcc48e56df67533ae922aed ./build.sh
4f18642680fb433554a5523d00bd99e0d650af340bcaebe628f59f63ac84e458 ./dartdoc_options.yaml
75461620cf3a062f4dad10e034952b82cca461b483788de1f46c539aca8b0f0f ./doc/manage_api_key.md
a66d39da0983a994474fa516f81fd41bbb131efbd69c955891a41781a76daf24 ./doc/performance.md
@@ -93,6 +93,13 @@ b373342c889d099d99a3209cb01cea188b53eb5b43ae26cad952abf5fda833bd ./example/02_u
ba3e6fe312940da56de324b044529900a0bfb5f94065d730f5b6ca5a8e61b83b ./example/02_users/pubspec.lock
fa541e11cb4b9b791630b658c6856743ec4c31d957deb285ed031e7d4c2d48c6 ./example/02_users/pubspec.yaml
31f28ca22dfb931fe963d2f766d8b5cba3c2722bca839787a506f1a692393a8c ./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.dart
23756b83470b1f25f6a7e6b5a6270f123a5224e49fd8e2eda36001358951b688 ./install.sh
7becacd31a8d134fa435b39cd819798d5fbf58f89b9f30c50362e2dcf757aaed ./lib/src/adaptive_upload.dart
9464fff0c519a1ce70cddefb3e3eaa95d07b97ccdaf5b8381c01d7c88767ae83 ./lib/src/api_key_provider.dart
@@ -116,6 +123,7 @@ e4413678ceb7bdfc1f6aaa241c53d8ba2033fc5171dd0a30030b62946d14008e ./lib/src/vmod
99aef519729868a9134d5783788eca035446858911b2be3a1a4c3c8efbe4eb97 ./pubspec.yaml
a80b38547f5d9ca1874f60e71c648e3fc12ab5f7cb88d1bead6d5b863d3c0245 ./readme_assets/dev_homepage.jpg
c56419d129059b64551e06f074e88ef62676f25938dc2a1fe28a6ab3f2ba8547 ./readme_assets/logo_vmodal_owl.jpeg
+4506abc2673f8980fedde4079ba5ad0cc64eb6e3842e7e2f933deab8bf59df11 ./release_note.md
3198051c448338c5331baef7e17ff32bfbaf1265b59543a8aca2baf57513feed ./run.sh
d2dfce0e68717f8626ecaadb4552f7471ced1dbdfe6a51182e0d62c24a1b718b ./security_check.sh
75d9810c9d50fd1224462aba8d2d1669cbfa094bd9cc0e5275f3a6a9f1364cb5 ./test.sh
@@ -131,16 +139,16 @@ d132b6dceb89804a47418245845547a25fcf8f89f56b292ee70a404d63364865 ./test/fakes.d
14368b598ece0ce9b2e249148a10a92f2c80e38427c077013a1515826f4365bd ./test/fixtures/routes_contract.json
593b356ac3431de80e03e7a0e2f1df0d29589140f44746468213c1cac1c35bbe ./test/multipart_upload_test.dart
348b9581f6262acaaf96012a3d57685b0b45c3663c1497f14135663de7a60954 ./test/new_api_surface_test.dart
-58222c7f00e8aa8070df89d59278ce0d18842f53a7544261aa4a63ae4b1dd608 ./test/regression_manifest_test.dart
+08ceeca24b3550142c4b982109a92637fa700686533185ad0619fd249bfc94f2 ./test/regression_manifest_test.dart
8c87a4645a2e329477d070277f64b617da14ac90163bb734fbb5326c1a97a5c3 ./test/resources_models_test.dart
8619ce113bb8669612f9a2a16b1b334ac68435c5972e84828a789511467fcb77 ./test/shell_scripts_test.dart
efe4f1158e7d4b9ca8e57f3538ce296279817292a4356c1399cf5f2cbae4c52d ./test/transcode_upload_test.dart
b94c0fef25560e387c4de5de0e4032fce73aa22b23a4bf38594ea6ff241d914c ./test/transport_test.dart
c4aa3c091992668ee531412a7fc783106769df7d75147eb06271492027b0c100 ./test/upload_test.dart
-af4a5b0eaca0bc1b2ef86cb88900fb67185b619cd90e6b5598ff9276a147d0b5 ./test/workflow_layout_test.dart
+4ab7edd1ae7230060f8afb3d041a58ca46e16c1b63f618129b0ecd74e70ba05b ./test/workflow_layout_test.dart
406de1350b79662fcaf007cb0cacd7a6b71b83815dc7cd3c7b561fcfba5600a3 ./tool/check_route_sync.dart
d5f5f9246656a5c275c5ab5863dbf3945d8ef6b1c9042c9d1912cfafce93646f ./tool/flutter_checksums.txt
24ea8e3013e0ed3531ff2aa3c86ad5332bf315d3d26f6a0814d2d6c84c5dade2 ./tool/live_cctv_test.dart
d09e2ee68e0e238b86e54a8248a0da92db81c953ce691628708bffd63fa3e737 ./tool/live_test.dart
d0eb57dd08a93b8afe4dc8f078db8b7ba7bdfc926292c2cff183c6489104c776 ./tool/perf_benchmark.dart
-98c97292e3feb880f6412a1635364ddc09d0711e424db35e0d053c006d5476ec ./tool/release_manifest.dart
+685ff82afcd1d4696b52ac7e790756414b0d3c4b2e0b4ce177b5ec75c2792c83 ./tool/release_manifest.dart
diff --git a/build.sh b/build.sh
index 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.md
new file mode 100644
index 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.yaml
new file mode 100644
index 0000000..f04c6cf
--- /dev/null
+++ b/example/03_cctv/analysis_options.yaml
@@ -0,0 +1 @@
+include: ../../analysis_options.yaml
diff --git a/example/03_cctv/bin/main.dart b/example/03_cctv/bin/main.dart
new file mode 100644
index 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.dart
new file mode 100644
index 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.yaml
new file mode 100644
index 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: true
diff --git a/example/03_cctv/test/cctv_example_test.dart b/example/03_cctv/test/cctv_example_test.dart
new file mode 100644
index 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.md
new file mode 100644
index 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.dart
index 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.dart
index 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.dart
index 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',