feat: add secrets support

.github/workflows/test.yml

@@ -296,6 +296,15 @@ jobs:
           fi
           echo "✓ functions.yaml exists"
 
+      - name: Create .env.local for params
+        run: |
+          cat > example/basic/.env.local << 'EOF'
+          WELCOME_MESSAGE=Hello from Dart Functions!
+          MIN_INSTANCES=0
+          IS_PRODUCTION=false
+          EOF
+          echo "✓ Created .env.local with default param values"
+
       - name: Run E2E tests
         run: dart test test/e2e/e2e_test.dart --reporter=expanded
         timeout-minutes: 5

example/basic/lib/main.dart

@@ -1,11 +1,67 @@
 import 'package:firebase_functions/firebase_functions.dart';
 
+// =============================================================================
+// Parameterized Configuration Examples
+// =============================================================================
+
+// Define parameters - these are read from environment variables at runtime
+// and can be configured at deploy time via .env files or CLI prompts.
+final welcomeMessage = defineString(
+  'WELCOME_MESSAGE',
+  ParamOptions(
+    defaultValue: 'Hello from Dart Functions!',
+    label: 'Welcome Message',
+    description: 'The greeting message returned by the helloWorld function',
+  ),
+);
+
+final minInstances = defineInt(
+  'MIN_INSTANCES',
+  ParamOptions(
+    defaultValue: 0,
+    label: 'Minimum Instances',
+    description: 'Minimum number of instances to keep warm',
+  ),
+);
+
+final isProduction = defineBoolean(
+  'IS_PRODUCTION',
+  ParamOptions(
+    defaultValue: false,
+    description: 'Whether this is a production deployment',
+  ),
+);
+
 void main(List<String> args) {
   fireUp(args, (firebase) {
-    // HTTPS onRequest example
+    // HTTPS onRequest example - using parameterized configuration
     firebase.https.onRequest(
       name: 'helloWorld',
-      (request) async => Response.ok('Hello from Dart Functions!'),
+      // ignore: non_const_argument_for_const_parameter
+      options: HttpsOptions(
+        // Use parameters in options - evaluated at deploy time
+        minInstances: DeployOption.param(minInstances),
+      ),
+      (request) async {
+        // Access parameter value at runtime
+        return Response.ok(welcomeMessage.value());
+      },
+    );
+
+    // Conditional configuration based on boolean parameter
+    firebase.https.onRequest(
+      name: 'configuredEndpoint',
+      // ignore: non_const_argument_for_const_parameter
+      options: HttpsOptions(
+        // Use thenElse for conditional configuration at deploy time
+        // isProduction.thenElse(trueValue, falseValue) returns an expression
+        memory: Memory.expression(isProduction.thenElse(2048, 512)),
+      ),
+      (request) async {
+        // Access parameter value at runtime
+        final env = isProduction.value() ? 'production' : 'development';
+        return Response.ok('Running in $env mode');
+      },
     );
 
     // Pub/Sub trigger example

example/nodejs_reference/index.js

@@ -6,12 +6,57 @@
 
 const { onRequest } = require("firebase-functions/v2/https");
 const { onMessagePublished } = require("firebase-functions/v2/pubsub");
+const { defineString, defineInt, defineBoolean } = require("firebase-functions/params");
 
-// HTTPS onRequest example
-exports.helloWorld = onRequest((request, response) => {
-  response.send("Hello from Dart Functions!");
+// =============================================================================
+// Parameterized Configuration Examples
+// =============================================================================
+
+// Define parameters - these are read from environment variables at runtime
+// and can be configured at deploy time via .env files or CLI prompts.
+const welcomeMessage = defineString("WELCOME_MESSAGE", {
+  default: "Hello from Dart Functions!",
+  label: "Welcome Message",
+  description: "The greeting message returned by the helloWorld function",
+});
+
+const minInstances = defineInt("MIN_INSTANCES", {
+  default: 0,
+  label: "Minimum Instances",
+  description: "Minimum number of instances to keep warm",
 });
 
+const isProduction = defineBoolean("IS_PRODUCTION", {
+  default: false,
+  description: "Whether this is a production deployment",
+});
+
+// HTTPS onRequest example - using parameterized configuration
+exports.helloWorld = onRequest(
+  {
+    // Use parameters in options - evaluated at deploy time
+    minInstances: minInstances,
+  },
+  (request, response) => {
+    // Access parameter value at runtime
+    response.send(welcomeMessage.value());
+  }
+);
+
+// Conditional configuration based on boolean parameter
+exports.configuredEndpoint = onRequest(
+  {
+    // Use thenElse for conditional configuration at deploy time
+    // isProduction.thenElse(trueValue, falseValue) returns an expression
+    memory: isProduction.thenElse(2048, 512),
+  },
+  (request, response) => {
+    // Access parameter value at runtime
+    const env = isProduction.value() ? "production" : "development";
+    response.send(`Running in ${env} mode`);
+  }
+);
+
 // Pub/Sub trigger example
 exports.onMessagePublished_mytopic = onMessagePublished(
   "my-topic",