run402-mcp 3.7.2 → 3.7.4

package/sdk/dist/namespaces/deploy.js

@@ -38,6 +38,7 @@ const SECRET_KEY_RE = /^[A-Z_][A-Z0-9_]{0,127}$/;
 const APPLY_SAFE_RETRY_CODES = new Set([
     "BASE_RELEASE_CONFLICT",
 ]);
+const EMAIL_TRIGGER_EVENTS = new Set(["reply_received", "delivery", "bounced", "complained"]);
 const STATIC_ACTIVATION_FAILURE_CODES = new Set([
     "BAD_FIELD",
     "INVALID_SPEC",
@@ -718,6 +719,7 @@ function functionToCoreSpec(fn) {
         ...(fn.entrypoint !== undefined ? { entrypoint: fn.entrypoint } : {}),
         ...(fn.config !== undefined ? { config: fn.config } : {}),
         ...(fn.deps !== undefined ? { deps: fn.deps } : {}),
+        ...(fn.triggers !== undefined ? { triggers: fn.triggers } : {}),
         ...(fn.schedule !== undefined ? { schedule: fn.schedule } : {}),
         ...(fn.requireAuth !== undefined ? { requireAuth: fn.requireAuth } : {}),
         ...(fn.requireRole !== undefined ? { requireRole: fn.requireRole } : {}),
@@ -740,6 +742,7 @@ function functionToWire(fn) {
             }
             : {}),
         ...(fn.deps !== undefined ? { deps: fn.deps } : {}),
+        ...(fn.triggers !== undefined ? { triggers: fn.triggers } : {}),
         ...(fn.schedule !== undefined ? { schedule: fn.schedule } : {}),
         ...(fn.requireAuth !== undefined ? { require_auth: fn.requireAuth } : {}),
         ...(fn.requireRole !== undefined
@@ -1016,11 +1019,14 @@ async function preflightTierFunctionLimits(client, spec, ciCredentials) {
                 max_function_memory_mb: limits.maxMemoryMb.value,
             });
         }
-        if (isScheduledCron(entry.fn.schedule) && limits.minCronIntervalMinutes) {
-            const intervalMinutes = estimateCronMinimumIntervalMinutes(entry.fn.schedule);
+        for (const trigger of scheduleTriggersForFunction(entry.fn)) {
+            if (!limits.minCronIntervalMinutes)
+                continue;
+            const intervalMinutes = estimateCronMinimumIntervalMinutes(trigger.cron);
             if (intervalMinutes !== null &&
                 intervalMinutes < limits.minCronIntervalMinutes.value) {
-                throw tierLimitError(`Function ${entry.name} schedule runs every ${intervalMinutes} minute(s), below the ${limits.tier} tier minimum interval of ${limits.minCronIntervalMinutes.value} minutes.`, `${entry.fieldPrefix}.schedule`, entry.fn.schedule, limits, limits.minCronIntervalMinutes, {
+                const triggerLabel = trigger.id === "__legacy__" ? "schedule" : `trigger ${trigger.id}`;
+                throw tierLimitError(`Function ${entry.name} ${triggerLabel} runs every ${intervalMinutes} minute(s), below the ${limits.tier} tier minimum interval of ${limits.minCronIntervalMinutes.value} minutes.`, `${entry.fieldPrefix}.${trigger.fieldSuffix}`, trigger.cron, limits, limits.minCronIntervalMinutes, {
                     interval_minutes: intervalMinutes,
                     min_interval_minutes: limits.minCronIntervalMinutes.value,
                     min_cron_interval_minutes: limits.minCronIntervalMinutes.value,
@@ -1044,7 +1050,7 @@ function hasFunctionTierPreflightInputs(functions) {
         return false;
     return collectFunctionPreflightEntries(functions).some((entry) => (entry.fn.config?.timeoutSeconds !== undefined ||
         entry.fn.config?.memoryMb !== undefined ||
-        isScheduledCron(entry.fn.schedule)));
+        scheduleTriggersForFunction(entry.fn).length > 0));
 }
 function collectFunctionPreflightEntries(functions) {
     if (!functions)
@@ -1160,23 +1166,21 @@ async function computeDesiredScheduledFunctionCount(client, spec) {
 function countScheduledFunctionsInSetEntries(functions) {
     if (!functions)
         return 0;
-    const names = new Set();
-    for (const [name, fn] of Object.entries(functions.replace ?? {})) {
-        if (isScheduledCron(fn.schedule))
-            names.add(name);
+    let count = 0;
+    for (const fn of Object.values(functions.replace ?? {})) {
+        count += scheduleTriggersForFunction(fn).length;
     }
-    for (const [name, fn] of Object.entries(functions.patch?.set ?? {})) {
-        if (isScheduledCron(fn.schedule))
-            names.add(name);
+    for (const fn of Object.values(functions.patch?.set ?? {})) {
+        count += scheduleTriggersForFunction(fn).length;
     }
-    return names.size;
+    return count;
 }
 function scheduledFunctionNames(functions) {
     if (!functions)
         return null;
     const scheduled = new Set();
     for (const [name, fn] of Object.entries(functions)) {
-        if (isScheduledCron(fn.schedule))
+        if (scheduleTriggersForFunction(fn).length > 0)
             scheduled.add(name);
     }
     return scheduled;
@@ -1188,7 +1192,7 @@ function applyScheduledFunctionPatch(scheduled, patch) {
     for (const [name, fn] of Object.entries(patch?.set ?? {})) {
         if (fn.schedule === null)
             scheduled.delete(name);
-        else if (isScheduledCron(fn.schedule))
+        else if (scheduleTriggersForFunction(fn).length > 0)
             scheduled.add(name);
     }
 }
@@ -1205,11 +1209,33 @@ async function readActiveScheduledFunctionNames(client, projectId) {
     }
     const scheduled = new Set();
     for (const fn of inventory.functions ?? []) {
-        if (isScheduledCron(fn.schedule))
+        if (isScheduledCron(fn.schedule) || scheduleTriggersForFunction(fn).length > 0)
             scheduled.add(fn.name);
     }
     return scheduled;
 }
+function scheduleTriggersForFunction(fn) {
+    if (fn.triggers && fn.triggers.length > 0) {
+        return fn.triggers
+            .filter((trigger) => trigger.type === "schedule")
+            .map((trigger) => ({
+            ...trigger,
+            fieldSuffix: `triggers.${trigger.id}.cron`,
+        }));
+    }
+    return isScheduledCron(fn.schedule)
+        ? [{
+                id: "__legacy__",
+                type: "schedule",
+                cron: fn.schedule,
+                timezone: "UTC",
+                misfire_policy: "skip",
+                overlap_policy: "allow",
+                run: { event_type: "legacy.schedule", payload: {} },
+                fieldSuffix: "schedule",
+            }]
+        : [];
+}
 function scheduledCountTierLimitError(count, limits, limit, countSource) {
     return tierLimitError(`Deploy would have ${count} scheduled function(s), exceeding the ${limits.tier} tier maximum of ${limit.value}.`, "functions.scheduled_count", count, limits, limit, {
         tier_max: limit.value,
@@ -1890,6 +1916,7 @@ const FUNCTION_SPEC_FIELDS = new Set([
     "entrypoint",
     "config",
     "deps",
+    "triggers",
     "schedule",
     "requireAuth",
     "requireRole",
@@ -1897,6 +1924,8 @@ const FUNCTION_SPEC_FIELDS = new Set([
     "capabilities",
 ]);
 const FUNCTION_CONFIG_FIELDS = new Set(["timeoutSeconds", "memoryMb"]);
+const FUNCTION_TRIGGER_FIELDS = new Set(["id", "type", "cron", "timezone", "misfire_policy", "overlap_policy", "mailbox", "events", "run"]);
+const FUNCTION_TRIGGER_RUN_FIELDS = new Set(["event_type", "payload", "retry", "expires_after_seconds"]);
 const SITE_SPEC_FIELDS = new Set(["replace", "patch", "public_paths"]);
 const SITE_PATCH_FIELDS = new Set(["put", "delete"]);
 const SITE_PUBLIC_PATHS_FIELDS = new Set(["mode", "replace"]);
@@ -2029,6 +2058,81 @@ function validateFunctionMap(value, resource) {
         if (entry.files !== undefined) {
             requireObject(entry.files, `${resource}.${name}.files`);
         }
+        validateFunctionTriggers(entry.triggers, `${resource}.${name}.triggers`);
+    }
+}
+function validateFunctionTriggers(value, resource) {
+    if (value === undefined)
+        return;
+    if (!Array.isArray(value))
+        throw invalidSpec(`ReleaseSpec.${resource} must be an array`, resource);
+    const seen = new Set();
+    for (const [index, trigger] of value.entries()) {
+        const path = `${resource}.${index}`;
+        const obj = requireObject(trigger, path);
+        validateKnownFields(obj, path, FUNCTION_TRIGGER_FIELDS, {
+            delivery: "Remove delivery; schedule triggers always start durable function runs.",
+        });
+        if (typeof obj.id !== "string" || obj.id.trim() === "") {
+            throw invalidSpec(`ReleaseSpec.${path}.id is required for function triggers`, `${path}.id`);
+        }
+        if (seen.has(obj.id))
+            throw invalidSpec(`ReleaseSpec.${path}.id duplicates ${JSON.stringify(obj.id)}`, `${path}.id`);
+        seen.add(obj.id);
+        if (obj.type === "schedule") {
+            if (obj.mailbox !== undefined || obj.events !== undefined) {
+                throw invalidSpec(`ReleaseSpec.${path} schedule triggers cannot include mailbox or events`, path);
+            }
+            if (typeof obj.cron !== "string" || obj.cron.trim().split(/\s+/).length !== 5) {
+                throw invalidSpec(`ReleaseSpec.${path}.cron must be a 5-field cron expression`, `${path}.cron`);
+            }
+            if (obj.timezone !== undefined && typeof obj.timezone !== "string") {
+                throw invalidSpec(`ReleaseSpec.${path}.timezone must be a string`, `${path}.timezone`);
+            }
+            if (obj.misfire_policy !== undefined && obj.misfire_policy !== "skip") {
+                throw invalidSpec(`ReleaseSpec.${path}.misfire_policy must be "skip"`, `${path}.misfire_policy`);
+            }
+            if (obj.overlap_policy !== undefined && obj.overlap_policy !== "allow") {
+                throw invalidSpec(`ReleaseSpec.${path}.overlap_policy must be "allow"`, `${path}.overlap_policy`);
+            }
+        }
+        else if (obj.type === "email") {
+            if (obj.cron !== undefined ||
+                obj.timezone !== undefined ||
+                obj.misfire_policy !== undefined ||
+                obj.overlap_policy !== undefined) {
+                throw invalidSpec(`ReleaseSpec.${path} email triggers cannot include schedule fields`, path);
+            }
+            if (typeof obj.mailbox !== "string" || obj.mailbox.trim() === "") {
+                throw invalidSpec(`ReleaseSpec.${path}.mailbox is required`, `${path}.mailbox`);
+            }
+            if (!Array.isArray(obj.events) || obj.events.length === 0) {
+                throw invalidSpec(`ReleaseSpec.${path}.events must be a non-empty array`, `${path}.events`);
+            }
+            for (const [eventIndex, event] of obj.events.entries()) {
+                if (typeof event !== "string" || !EMAIL_TRIGGER_EVENTS.has(event)) {
+                    throw invalidSpec(`ReleaseSpec.${path}.events.${eventIndex} must be one of reply_received, delivery, bounced, complained`, `${path}.events.${eventIndex}`);
+                }
+            }
+        }
+        else {
+            throw invalidSpec(`ReleaseSpec.${path}.type must be "schedule" or "email"`, `${path}.type`);
+        }
+        const run = requireObject(obj.run, `${path}.run`);
+        validateKnownFields(run, `${path}.run`, FUNCTION_TRIGGER_RUN_FIELDS);
+        if (typeof run.event_type !== "string" || run.event_type.trim() === "") {
+            throw invalidSpec(`ReleaseSpec.${path}.run.event_type is required`, `${path}.run.event_type`);
+        }
+        if (run.payload !== undefined)
+            requireObject(run.payload, `${path}.run.payload`);
+        if (run.retry !== undefined)
+            requireObject(run.retry, `${path}.run.retry`);
+        if (run.expires_after_seconds !== undefined &&
+            (typeof run.expires_after_seconds !== "number" ||
+                !Number.isSafeInteger(run.expires_after_seconds) ||
+                run.expires_after_seconds <= 0)) {
+            throw invalidSpec(`ReleaseSpec.${path}.run.expires_after_seconds must be a positive integer`, `${path}.run.expires_after_seconds`);
+        }
     }
 }
 /**
@@ -2934,6 +3038,8 @@ async function normalizeFunction(fn, remember) {
         out.config = fn.config;
     if (fn.deps !== undefined)
         out.deps = fn.deps;
+    if (fn.triggers !== undefined)
+        out.triggers = normalizeFunctionTriggers(fn.triggers);
     if (fn.schedule !== undefined)
         out.schedule = fn.schedule;
     if (fn.entrypoint)
@@ -2955,6 +3061,38 @@ async function normalizeFunction(fn, remember) {
     }
     return out;
 }
+function normalizeFunctionTriggers(triggers) {
+    return triggers
+        .map((trigger) => {
+        const run = {
+            event_type: trigger.run.event_type,
+            payload: trigger.run.payload ?? {},
+            ...(trigger.run.retry !== undefined ? { retry: { ...trigger.run.retry } } : {}),
+            ...(trigger.run.expires_after_seconds !== undefined
+                ? { expires_after_seconds: trigger.run.expires_after_seconds }
+                : {}),
+        };
+        if (trigger.type === "email") {
+            return {
+                id: trigger.id,
+                type: "email",
+                mailbox: trigger.mailbox,
+                events: [...trigger.events].sort(),
+                run,
+            };
+        }
+        return {
+            id: trigger.id,
+            type: "schedule",
+            cron: trigger.cron,
+            timezone: trigger.timezone ?? "UTC",
+            misfire_policy: trigger.misfire_policy ?? "skip",
+            overlap_policy: trigger.overlap_policy ?? "allow",
+            run,
+        };
+    })
+        .sort((a, b) => a.id.localeCompare(b.id));
+}
 async function normalizeFileSet(set, remember) {
     // `dir(path)` produces a LocalDirRef sentinel that is documented as a
     // valid site.replace / site.patch.put input. Expand it to a plain FileSet