Extension Email Calendar Events

作者 caffeinelabs362f51ae96f0无许可证2 个星标收录于 2026年10月8日更新于 2026年10月8日仓库今天更新

Support for organising events/meetings and sending invitations by email.

仅含说明CommunicationProductivity & Workflow
AI 生成的概览

为 Caffeine AI 应用添加 Motoko 日历事件增删改查及邮件 iCalendar 邀请功能。

功能
该技能说明了一个预制 Motoko 模块，用于创建、更新、取消、删除、获取和列出日历事件，并向参会者发送 iCalendar 邀请邮件。它会为每位参会者构建 iCalendar 附件，并通过邮件网关或传输容器发送。内容还涵盖组织者模型、更新与取消的序列号处理，以及从早期版本迁移的步骤。
适用场景
适用于构建需要组织会议或活动并通过电子邮件发送日历邀请的 Caffeine AI 后端。适合需要事件增删改查加邀请发送的应用，包括让参会者日历移除事件的取消操作。
运行要求
需要 Motoko 工具链以及 mops 包 caffeineai-email-calendar-events、caffeineai-email 和 caffeineai-authorization，并需要 Caffeine AI plus 或 pro 订阅。发送邮件在启用时使用邮件网关及 INTEGRATIONS_GATEWAY_URL 和 INTEGRATIONS_GATEWAY_API_KEY，否则使用传输容器。不附带脚本，仅为说明与模块引用。

Email — Calendar Events

Calendar events email extension for Caffeine AI.

Overview

This skill adds support for organising events/meetings and sending iCalendar invitations by email. It provides CRUD operations for calendar events and email-based invitation delivery.

Backend

This component is for organising events/meetings and sending invitations by email

  • Internally it builds and attaches an iCalendar file to each attendees's email
  • This component does not yet support receiving RSVPs from attendees

To add/update/cancel/delete/get/list calendar events

  • Use the prefabricated module mo:caffeineai-email-calendar-events/calendarEvents.mo which cannot be modified.
mo:caffeineai-email-calendar-events/calendarEvents.mo
module {  public type CalendarEvent = {    uid : Text;    sequence : Nat32;    method : CalendarEventMethod;    summary : Text;    description : Text;    location : Text;    startTime : Nat64;    endTime : Nat64;    organizer : Organizer;    attendees : [Attendee];  };
  public type CalendarEventMethod = {    #request;    #publish;    #cancel;  };
  // The organizer is the sender: the invitation comes from  // `<fromUsername>@<app domain>` and that mailbox, under this display name,  // is the ICS ORGANIZER and the first guest. Only attendees carry addresses.  public type Organizer = {    name : ?Text;  };
  public type Mailbox = {    email : Text;    name : ?Text;  };
  public type Attendee = {    who : Mailbox;    role : CalendarEventRole;  };
  public type CalendarEventRole = {    #chair;    #required;    #optional;    #notParticipating;  };
  public type State = {    var events : List.List<CalendarEvent>;    var uidMap : Map.Map<Text, Nat>;  };
  public func add(    self : State,    uid : Text,    summary : Text,    description : Text,    location : Text,    startTime : Nat64,    endTime : Nat64,    organizer : Organizer,    attendees : [Attendee]  ) : ?CalendarEvent;
  // update, addAttendees, removeAttendees and cancel store the change with  // the next sequence number and return the stored record. Send that record:  // calendars apply an update or a cancellation only when its sequence is  // higher than the one they hold.  public func update(    self : State,    uid : Text,    summary : ?Text,    description : ?Text,    location : ?Text,    startTime : ?Nat64,    endTime : ?Nat64,    organizer : ?Organizer,    attendees : ?[Attendee]  ) : ?CalendarEvent;
  public func addAttendees(    self : State,    uid : Text,    attendees : [Attendee]  ) : ?CalendarEvent;
  public func removeAttendees(    self : State,    uid : Text,    attendees : [Text]  ) : ?CalendarEvent;
  public func cancel(self : State, uid : Text) : ?CalendarEvent;
  public func delete(self : State, uid : Text);
  public func get(self : State, uid : Text) : ?CalendarEvent;
  // Iterate over all calendar events older to newer  public func iter(self : State) : Iter.Iter<CalendarEvent>;
  // Iterate over all calendar events newer to older  public func reverse(self : State) : Iter.Iter<CalendarEvent>;
  // One invitation copy per attendee from `<fromUsername>@<app domain>`, the  // organizer's mailbox, through the mail gateway or the transport canister.  public func sendCalendarEvent(fromUsername : Text, event : CalendarEvent) : async { #ok; #err : Text };}

For sending calendar event invitations to attendees by email

  • Use the sendCalendarEvent function of the same module. It sends one copy per attendee through the mail gateway when the canister has the gateway key (INTEGRATIONS_GATEWAY_URL / INTEGRATIONS_GATEWAY_API_KEY, injected by the platform where the gateway is enabled) and through the transport canister otherwise; the app code is the same either way. caffeineai-email is a dependency of this package, and the app does not call it for calendar mail.
  • fromUsername is the local part of the sender only, such as events or no-reply. The invitation comes from <fromUsername>@<app domain>, and the app domain is the project's own, resolved by the mail gateway. Never pass a full address and never read or guess the domain in the app.
  • The organizer is that same mailbox. CalendarEvent.organizer carries only a display name, { name = ?"Community Team" }, shown as the ICS ORGANIZER and the first guest, so calendars see the invitation arrive from its organizer. Attendees are the only mailboxes with addresses; the organizer receives a copy only when also listed as an attendee. Do not model the organizer as a user with an email address.
  • It returns #ok once the invitation was accepted for every attendee, otherwise #err(error) with the error text.

Example usage for an app which can add/update/cancel/delete/get/list calendar events and send invitations to them by email

motoko
import Runtime "mo:core/Runtime";import Principal "mo:core/Principal";import Map "mo:core/Map";import Random "mo:core/Random";import Set "mo:core/Set";import Iter "mo:core/Iter";import Option "mo:core/Option";import Text "mo:core/Text";import AccessControl "mo:caffeineai-authorization/access-control";import MixinAuthorization "mo:caffeineai-authorization/MixinAuthorization";import CalendarEvents "mo:caffeineai-email-calendar-events/calendarEvents";import Uuid "mo:caffeineai-email-calendar-events/uuid";
actor {  public type UserProfile = {    name : Text;    email : Text;  };
  // Include authorization component  let accessControlState : AccessControl.AccessControlState;  include MixinAuthorization(accessControlState, null);
  // Store a map of caller principal to UserProfile  var userProfiles : Map.Map<Principal, UserProfile>;
  // Store a set of emails for uniqueness check  var emails : Set.Set<Text>;
  // Store the calendar events  let calendarEvents : CalendarEvents.State;
  public shared ({ caller }) func registerUser(name : Text, email : Text) : async () {    // Check if the user already exists    if (userProfiles.containsKey(caller)) {      Runtime.trap("User already registered");    };
    // Check if the email is already used    if (emails.contains(email)) {      Runtime.trap("Email already taken");    };
    // Add a user record    userProfiles.add(      caller,      {        name;        email;      }    );    emails.add(email);  };
  public shared ({ caller }) func addCalendarEvent(summary : Text, description : Text, location : Text, startTimeMs : Nat64, endTimeMs : Nat64) : async () {    if (not (AccessControl.hasPermission(accessControlState, caller, #admin))) {      Runtime.trap("Unauthorized: Only admins can add calendar events");    };
    let organiser = userProfiles.get(caller)      ?? Runtime.trap("Admin profile not found");
    let seed = await Random.blob();    let uid = Uuid.generateV4(seed);
    if (      calendarEvents.add(        uid,        summary,        description,        location,        startTimeMs,        endTimeMs,        { name = ?organiser.name },        userProfiles.values().map(          func({ name; email }) {            {              who = { name = ?name; email };              role = #required;            };          }        ).toArray()      ).isNull()    ) {      Runtime.trap("Failed to add calendar event");    };  };
  public shared ({ caller }) func updateEventDetails(uid : Text, summary : ?Text, description : ?Text, location : ?Text, startTimeMs : ?Nat64, endTimeMs : ?Nat64) : async () {    if (not (AccessControl.hasPermission(accessControlState, caller, #admin))) {      Runtime.trap("Unauthorized: Only admins can update calendar events");    };
    if (      calendarEvents.update(        uid,        summary,        description,        location,        startTimeMs,        endTimeMs,        null,        null      ).isNull()    ) {      Runtime.trap("Failed to update calendar event");    };  };
  public shared ({ caller }) func addEventAttendees(uid : Text, attendees : [CalendarEvents.Attendee]) : async () {    if (not (AccessControl.hasPermission(accessControlState, caller, #admin))) {      Runtime.trap("Unauthorized: Only admins can add calendar event attendees");    };
    if (calendarEvents.addAttendees(uid, attendees).isNull()) {      Runtime.trap("Failed to add attendees to calendar event");    };  };
  public shared ({ caller }) func removeEventAttendees(uid : Text, attendees : [Text]) : async () {    if (not (AccessControl.hasPermission(accessControlState, caller, #admin))) {      Runtime.trap("Unauthorized: Only admins can remove calendar event attendees");    };
    if (calendarEvents.removeAttendees(uid, attendees).isNull()) {      Runtime.trap("Failed to remove attendees from calendar event");    };  };
  public shared ({ caller }) func cancelEvent(uid : Text) : async () {    if (not (AccessControl.hasPermission(accessControlState, caller, #admin))) {      Runtime.trap("Unauthorized: Only admins can cancel calendar events");    };
    // The returned record carries method #cancel and the bumped sequence,    // which is what tells the attendees' calendars to drop the event.    let cancelled = calendarEvents.cancel(uid)      ?? Runtime.trap("Failed to cancel calendar event");
    switch (await CalendarEvents.sendCalendarEvent("events", cancelled)) {      case (#ok) {};      case (#err(error)) {        Runtime.trap("Failed to send the cancellation: " # error);      };    };  };
  public shared ({ caller }) func listEvents() : async [CalendarEvents.CalendarEvent] {    if (not (AccessControl.hasPermission(accessControlState, caller, #admin))) {      Runtime.trap("Unauthorized: Only admins can list calendar events");    };
    calendarEvents.iter().toArray();  };
  public shared ({ caller }) func deleteEvent(uid : Text) : async () {    if (not (AccessControl.hasPermission(accessControlState, caller, #admin))) {      Runtime.trap("Unauthorized: Only admins can delete calendar events");    };
    calendarEvents.delete(uid);  };
  public shared ({ caller }) func sendEventInvitation(uid : Text) : async () {    if (not (AccessControl.hasPermission(accessControlState, caller, #admin))) {      Runtime.trap("Unauthorized: Only admins can send calendar event invitations");    };
    let event = calendarEvents.get(uid)      ?? Runtime.trap("Calendar event not found");
    ignore await CalendarEvents.sendCalendarEvent(      "events",      event    );  };};

The migration chain head:

motoko
import Map "mo:core/Map";import Set "mo:core/Set";import AccessControl "mo:caffeineai-authorization/access-control";import CalendarEvents "mo:caffeineai-email-calendar-events/calendarEvents";
module {  type UserProfile = {    name : Text;    email : Text;  };
  type NewActor = {    accessControlState : AccessControl.AccessControlState;    var userProfiles : Map.Map<Principal, UserProfile>;    var emails : Set.Set<Text>;    calendarEvents : CalendarEvents.State;  };
  public func migration(_old : {}) : NewActor {    {      accessControlState = AccessControl.initState();      var userProfiles = Map.empty<Principal, UserProfile>();      var emails = Set.empty<Text>();      calendarEvents = CalendarEvents.new();    };  };};

Upgrading from the previous version

An app built with caffeineai-email-calendar-events 0.2.x re-pins with mops add [email protected] and mops add [email protected]. CalendarEvent.organizer is now an Organizer ({ name : ?Text }) instead of a Mailbox: the organizer address is the sender's, <fromUsername>@<app domain>, built by the mail gateway, so the app no longer supplies one. add and update take the new type, and an app that stored events adds a migration step that maps each stored organizer to { name = old.organizer.name }.

An app built with caffeineai-email-calendar-events 0.1.x re-pins with mops add [email protected] and mops add [email protected]. sendCalendarEvent keeps its signature but moves from EmailClient to this module (CalendarEvents.sendCalendarEvent), and the event types (CalendarEvent, Attendee, Mailbox, CalendarEventMethod, CalendarEventRole) are this module's; an app that imported them from EmailClient switches the import and drops EmailClient when nothing else uses it. Invitations are now composed and sent by the mail gateway. update, addAttendees, removeAttendees and cancel now return the stored record (with the bumped sequence) instead of the previous one, so an app that sends the returned record after a change sends the right sequence.

来源与署名

来源：caffeinelabs/skills位于skills/extension-email-calendar-events提交362f51a

许可证： 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

更多来自 caffeinelabs/skills 的技能

Writing Motoko

caffeinelabs

编写 Internet Computer 上 Motoko 后端代码的参考与架构指南，含 mops 工具链说明。

Software Development2今天更新

Migrating Motoko Actors

caffeinelabs

指导使用 mops 管理的迁移链进行 Motoko actor 迁移，以应对状态与结构变更。

Software Development2今天更新

Troubleshooting Motoko Migrations

caffeinelabs

用于排查 Motoko 迁移链故障的参考，涵盖兼容性错误、冻结文件和已转换项目。

Software Development2今天更新

Extension Querying Oql

caffeinelabs

通过 icp CLI 查询暴露 OQL 的 canister 的参考：读取 schema、构造 JSON 查询、解析 Candid 结果行。

Data & Analytics2今天更新

Extension Qr Code

caffeinelabs

通过预制 React hook 为 Caffeine AI 应用添加基于摄像头的二维码扫描功能。

Software Development2今天更新

Extension Object Storage

caffeinelabs

为 Caffeine AI Motoko 容器添加链下文件与对象存储，并在链上保存引用。

Software Development2今天更新

更多Communication技能

Internal Comms

anthropics

精选

按公司惯用格式撰写内部沟通文稿，如 3P 更新、公司通讯、FAQ、状态报告与事故报告。

Communication180K3天前更新

Stakeholder Update

anthropics

精选

按受众和节奏生成干系人更新，从高管简报一直到客户公告。

Communication27K今天更新

Call Summary

anthropics

精选

将通话记录或笔记整理成客户跟进邮件草稿、内部摘要和拟议的 CRM 更新。

Communication27K今天更新

Draft Outreach

anthropics

精选

撰写个性化的冷启动或跟进销售外联邮件，并生成可供审阅的草稿。

Communication27K今天更新

Status Report

anthropics

精选

生成结构化状态报告，包含 KPI、风险、待决事项与行动项，供管理层或相关方阅读。

Communication27K今天更新

Compose Outreach

anthropics

精选

根据 Common Room 信号，生成邮件、电话话术和 LinkedIn 消息三种个性化外联草稿。

Communication27K今天更新