callable sample

Author: jhuleatt

.github/workflows/test_dart.yml

@@ -43,14 +43,15 @@ jobs:
         with:
           sdk: ${{ matrix.dart-version }}
 
-      - name: HTTPS Time Server - Install dependencies
-        working-directory: ./Dart/quickstarts/https-time-server
-        run: dart pub get
-
-      - name: HTTPS Time Server - Format
-        working-directory: ./Dart/quickstarts/https-time-server
-        run: dart format --set-exit-if-changed .
-
-      - name: HTTPS Time Server - Analyze
-        working-directory: ./Dart/quickstarts/https-time-server
-        run: dart analyze .
+      - name: Test Dart Samples
+        run: |
+          set -e
+          for dir in $(find Dart -name pubspec.yaml -exec dirname {} \;); do
+            echo "::group::Testing $dir"
+            cd "$dir"
+            dart pub get
+            dart format --set-exit-if-changed .
+            dart analyze .
+            cd - > /dev/null
+            echo "::endgroup::"
+          done

Dart/quickstarts/callable-functions/.gitignore

@@ -0,0 +1,5 @@
+.dart_tool/
+.packages
+build/
+*.dart_tool
+pubspec.lock

Dart/quickstarts/callable-functions/README.md

@@ -0,0 +1,29 @@
+# Firebase SDK for Cloud Functions Quickstart - Callable Functions
+
+This quickstart demonstrates how to send requests to a server-side function and get a response back using one of the Client SDKs.
+
+## Introduction
+
+The function `addNumbers` Returns the sum of two numbers.
+
+Further reading:
+
+ - [Read more about Cloud Functions for Firebase](https://firebase.google.com/docs/functions/)
+
+## Deploy the app to prod
+
+First you need to get the `dart` dependencies of the functions:
+
+```bash
+dart pub get
+```
+
+Deploy to Firebase using the following command:
+
+```bash
+firebase deploy --only functions
+```
+
+## License
+
+© Google, 2026. Licensed under an [Apache-2](../../../LICENSE) license.

Dart/quickstarts/callable-functions/bin/server.dart

@@ -0,0 +1,70 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// [START imports]
+// Dependencies for callable functions.
+import 'package:firebase_functions/firebase_functions.dart';
+// [END imports]
+
+void main(List<String> args) async {
+  await fireUp(args, (firebase) {
+    // [START allAdd]
+    // [START addFunctionTrigger]
+    // Adds two numbers to each other.
+    firebase.https.onCall(name: 'addNumbers', (request, response) async {
+      // [END addFunctionTrigger]
+      // [START readAddData]
+      // Numbers passed from the client.
+      final data = request.data as Map<String, Object?>?;
+      final firstNumber = data?['firstNumber'];
+      final secondNumber = data?['secondNumber'];
+      // [END readAddData]
+
+      // [START addHttpsError]
+      // Checking that attributes are present and are numbers.
+      if (firstNumber is! num || secondNumber is! num) {
+        // Throwing an HttpsError so that the client gets the error details.
+        throw InvalidArgumentError(
+          'The function must be called with two arguments "firstNumber" and "secondNumber" which must both be numbers.',
+        );
+      }
+      // [END addHttpsError]
+
+      // [START authIntegration]
+      // Authentication / user information is automatically added to the request.
+      final uid = request.auth?.uid;
+      final token = request.auth?.token;
+      final name = token?['name'];
+      final picture = token?['picture'];
+      final email = token?['email'];
+
+      // Use variables to suppress 'unused' lint warnings
+      print(
+        'User details: uid=$uid, name=$name, picture=$picture, email=$email',
+      );
+      // [END authIntegration]
+
+      // [START returnAddData]
+      // returning result.
+      return CallableResult({
+        'firstNumber': firstNumber,
+        'secondNumber': secondNumber,
+        'operator': '+',
+        'operationResult': firstNumber + secondNumber,
+      });
+      // [END returnAddData]
+    });
+    // [END allAdd]
+  });
+}

Dart/quickstarts/callable-functions/firebase.json

@@ -0,0 +1,6 @@
+{
+  "functions": {
+    "source": ".",
+    "codebase": "dart-quickstarts-callable-functions"
+  }
+}

Dart/quickstarts/callable-functions/pubspec.yaml

@@ -0,0 +1,32 @@
+name: callable_functions
+description: Callable examples for Firebase Functions for Dart
+publish_to: none
+
+environment:
+  sdk: ^3.11.0
+
+dependencies:
+  firebase_functions:
+    git:
+      url: https://github.com/firebase/firebase-functions-dart
+      ref: main
+
+dev_dependencies:
+  build_runner: ^2.10.5
+  lints: ^6.0.0
+
+dependency_overrides:
+  firebase_functions:
+    git:
+      url: https://github.com/firebase/firebase-functions-dart
+      ref: main
+  dart_firebase_admin:
+      git:
+        url: https://github.com/firebase/firebase-admin-dart
+        path: packages/dart_firebase_admin
+        ref: main
+  google_cloud_firestore:
+      git:
+        url: https://github.com/firebase/firebase-admin-dart
+        path: packages/google_cloud_firestore
+        ref: main