@dxos/functions 0.7.4 → 0.7.5-labs.071a3e2

package/dist/types/src/{types.d.ts → types/types.d.ts}

@@ -7,7 +7,8 @@ import { S } from '@dxos/echo-schema';
 export declare enum TriggerKind {
     Timer = "timer",
     Webhook = "webhook",
-    Subscription = "subscription"
+    Subscription = "subscription",
+    Email = "email"
 }
 /**
  * Cron timer.
@@ -17,6 +18,10 @@ declare const TimerTriggerSchema: S.mutable<S.Struct<{
     cron: S.SchemaClass<string, string, never>;
 }>>;
 export type TimerTrigger = S.Schema.Type<typeof TimerTriggerSchema>;
+declare const EmailTriggerSchema: S.mutable<S.Struct<{
+    type: S.Literal<[TriggerKind.Email]>;
+}>>;
+export type EmailTrigger = S.Schema.Type<typeof EmailTriggerSchema>;
 /**
  * Webhook.
  */
@@ -61,6 +66,8 @@ export declare const TriggerSchema: S.Union<[S.mutable<S.Struct<{
         deep: S.optional<S.SchemaClass<boolean, boolean, never>>;
         delay: S.optional<S.SchemaClass<number, number, never>>;
     }>>;
+}>>, S.mutable<S.Struct<{
+    type: S.Literal<[TriggerKind.Email]>;
 }>>]>;
 export type TriggerType = S.Schema.Type<typeof TriggerSchema>;
 /**
@@ -86,39 +93,13 @@ export declare const FunctionTriggerSchema: S.Struct<{
             deep: S.optional<S.SchemaClass<boolean, boolean, never>>;
             delay: S.optional<S.SchemaClass<number, number, never>>;
         }>>;
+    }>>, S.mutable<S.Struct<{
+        type: S.Literal<[TriggerKind.Email]>;
     }>>]>>;
     meta: S.optional<S.mutable<S.Record$<typeof S.String, typeof S.Any>>>;
 }>;
 export type FunctionTriggerType = S.Schema.Type<typeof FunctionTriggerSchema>;
-declare const FunctionTrigger_base: import("@dxos/echo-schema").AbstractTypedObject<{
-    function?: string | undefined;
-    enabled?: boolean | undefined;
-    spec?: {
-        type: TriggerKind.Timer;
-        cron: string;
-    } | {
-        type: TriggerKind.Webhook;
-        method?: string | undefined;
-        port?: number | undefined;
-    } | {
-        filter: {
-            readonly type?: string | undefined;
-            readonly props?: {
-                readonly [x: string]: any;
-            } | undefined;
-        };
-        type: TriggerKind.Subscription;
-        options?: {
-            readonly deep?: boolean | undefined;
-            readonly delay?: number | undefined;
-        } | undefined;
-    } | undefined;
-    meta?: {
-        [x: string]: any;
-    } | undefined;
-} & {
-    id: string;
-}, S.Struct.Encoded<{
+declare const FunctionTrigger_base: import("@dxos/echo-schema").TypedObjectPrototype<import("packages/core/echo/echo-schema/dist/types/src/object/common").TypedObjectFields<{
     readonly function: S.optional<S.SchemaClass<string, string, never>>;
     readonly enabled: S.optional<S.SchemaClass<boolean, boolean, never>>;
     readonly spec: S.optional<S.Union<[S.mutable<S.Struct<{
@@ -138,6 +119,32 @@ declare const FunctionTrigger_base: import("@dxos/echo-schema").AbstractTypedObj
             deep: S.optional<S.SchemaClass<boolean, boolean, never>>;
             delay: S.optional<S.SchemaClass<number, number, never>>;
         }>>;
+    }>>, S.mutable<S.Struct<{
+        type: S.Literal<[TriggerKind.Email]>;
+    }>>]>>;
+    readonly meta: S.optional<S.mutable<S.Record$<typeof S.String, typeof S.Any>>>;
+}, import("packages/core/echo/echo-schema/dist/types/src/object/common").TypedObjectOptions>, S.Struct.Encoded<{
+    readonly function: S.optional<S.SchemaClass<string, string, never>>;
+    readonly enabled: S.optional<S.SchemaClass<boolean, boolean, never>>;
+    readonly spec: S.optional<S.Union<[S.mutable<S.Struct<{
+        type: S.Literal<[TriggerKind.Timer]>;
+        cron: S.SchemaClass<string, string, never>;
+    }>>, S.mutable<S.Struct<{
+        type: S.Literal<[TriggerKind.Webhook]>;
+        method: S.optional<S.SchemaClass<string, string, never>>;
+        port: S.optional<S.SchemaClass<number, number, never>>;
+    }>>, S.mutable<S.Struct<{
+        type: S.Literal<[TriggerKind.Subscription]>;
+        filter: S.Struct<{
+            type: S.optional<S.SchemaClass<string, string, never>>;
+            props: S.optional<S.Record$<typeof S.String, typeof S.Any>>;
+        }>;
+        options: S.optional<S.Struct<{
+            deep: S.optional<S.SchemaClass<boolean, boolean, never>>;
+            delay: S.optional<S.SchemaClass<number, number, never>>;
+        }>>;
+    }>>, S.mutable<S.Struct<{
+        type: S.Literal<[TriggerKind.Email]>;
     }>>]>>;
     readonly meta: S.optional<S.mutable<S.Record$<typeof S.String, typeof S.Any>>>;
 }>>;
@@ -146,14 +153,12 @@ declare const FunctionTrigger_base: import("@dxos/echo-schema").AbstractTypedObj
  */
 export declare class FunctionTrigger extends FunctionTrigger_base {
 }
-declare const FunctionDef_base: import("@dxos/echo-schema").AbstractTypedObject<{
-    handler: string;
-    uri: string;
-    description?: string | undefined;
-    route: string;
-} & {
-    id: string;
-}, S.Struct.Encoded<{
+declare const FunctionDef_base: import("@dxos/echo-schema").TypedObjectPrototype<import("packages/core/echo/echo-schema/dist/types/src/object/common").TypedObjectFields<{
+    uri: typeof S.String;
+    description: S.optional<typeof S.String>;
+    route: typeof S.String;
+    handler: typeof S.String;
+}, import("packages/core/echo/echo-schema/dist/types/src/object/common").TypedObjectOptions>, S.Struct.Encoded<{
     uri: typeof S.String;
     description: S.optional<typeof S.String>;
     route: typeof S.String;
@@ -169,48 +174,42 @@ export declare class FunctionDef extends FunctionDef_base {
  * Function manifest file.
  */
 export declare const FunctionManifestSchema: S.Struct<{
-    functions: S.optional<S.mutable<S.Array$<S.Schema<import("@dxos/echo-schema").ExcludeId<{
-        handler: string;
-        uri: string;
-        description?: string | undefined;
-        route: string;
-    } & {
-        id: string;
-    }> & import("@dxos/echo-schema").WithMeta, S.Struct.Encoded<{
+    functions: S.optional<S.mutable<S.Array$<S.Schema<import("@dxos/echo-schema").ExcludeId<import("packages/core/echo/echo-schema/dist/types/src/object/common").TypedObjectFields<{
+        uri: typeof S.String;
+        description: S.optional<typeof S.String>;
+        route: typeof S.String;
+        handler: typeof S.String;
+    }, import("packages/core/echo/echo-schema/dist/types/src/object/common").TypedObjectOptions>> & import("@dxos/echo-schema").WithMeta, S.Struct.Encoded<{
         uri: typeof S.String;
         description: S.optional<typeof S.String>;
         route: typeof S.String;
         handler: typeof S.String;
     }>, never>>>>;
-    triggers: S.optional<S.mutable<S.Array$<S.Schema<import("@dxos/echo-schema").ExcludeId<{
-        function?: string | undefined;
-        enabled?: boolean | undefined;
-        spec?: {
-            type: TriggerKind.Timer;
-            cron: string;
-        } | {
-            type: TriggerKind.Webhook;
-            method?: string | undefined;
-            port?: number | undefined;
-        } | {
-            filter: {
-                readonly type?: string | undefined;
-                readonly props?: {
-                    readonly [x: string]: any;
-                } | undefined;
-            };
-            type: TriggerKind.Subscription;
-            options?: {
-                readonly deep?: boolean | undefined;
-                readonly delay?: number | undefined;
-            } | undefined;
-        } | undefined;
-        meta?: {
-            [x: string]: any;
-        } | undefined;
-    } & {
-        id: string;
-    }> & import("@dxos/echo-schema").WithMeta, S.Struct.Encoded<{
+    triggers: S.optional<S.mutable<S.Array$<S.Schema<import("@dxos/echo-schema").ExcludeId<import("packages/core/echo/echo-schema/dist/types/src/object/common").TypedObjectFields<{
+        readonly function: S.optional<S.SchemaClass<string, string, never>>;
+        readonly enabled: S.optional<S.SchemaClass<boolean, boolean, never>>;
+        readonly spec: S.optional<S.Union<[S.mutable<S.Struct<{
+            type: S.Literal<[TriggerKind.Timer]>;
+            cron: S.SchemaClass<string, string, never>;
+        }>>, S.mutable<S.Struct<{
+            type: S.Literal<[TriggerKind.Webhook]>;
+            method: S.optional<S.SchemaClass<string, string, never>>;
+            port: S.optional<S.SchemaClass<number, number, never>>;
+        }>>, S.mutable<S.Struct<{
+            type: S.Literal<[TriggerKind.Subscription]>;
+            filter: S.Struct<{
+                type: S.optional<S.SchemaClass<string, string, never>>;
+                props: S.optional<S.Record$<typeof S.String, typeof S.Any>>;
+            }>;
+            options: S.optional<S.Struct<{
+                deep: S.optional<S.SchemaClass<boolean, boolean, never>>;
+                delay: S.optional<S.SchemaClass<number, number, never>>;
+            }>>;
+        }>>, S.mutable<S.Struct<{
+            type: S.Literal<[TriggerKind.Email]>;
+        }>>]>>;
+        readonly meta: S.optional<S.mutable<S.Record$<typeof S.String, typeof S.Any>>>;
+    }, import("packages/core/echo/echo-schema/dist/types/src/object/common").TypedObjectOptions>> & import("@dxos/echo-schema").WithMeta, S.Struct.Encoded<{
         readonly function: S.optional<S.SchemaClass<string, string, never>>;
         readonly enabled: S.optional<S.SchemaClass<boolean, boolean, never>>;
         readonly spec: S.optional<S.Union<[S.mutable<S.Struct<{
@@ -230,6 +229,8 @@ export declare const FunctionManifestSchema: S.Struct<{
                 deep: S.optional<S.SchemaClass<boolean, boolean, never>>;
                 delay: S.optional<S.SchemaClass<number, number, never>>;
             }>>;
+        }>>, S.mutable<S.Struct<{
+            type: S.Literal<[TriggerKind.Email]>;
         }>>]>>;
         readonly meta: S.optional<S.mutable<S.Record$<typeof S.String, typeof S.Any>>>;
     }>, never>>>>;

package/dist/types/src/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/types/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuC,CAAC,EAAe,MAAM,mBAAmB,CAAC;AAExF;;;;GAIG;AACH,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,YAAY,iBAAiB;IAC7B,KAAK,UAAU;CAChB;AAKD;;GAEG;AACH,QAAA,MAAM,kBAAkB;;;GAMN,CAAC;AAEnB,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,QAAA,MAAM,kBAAkB;;GAEN,CAAC;AAEnB,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;GAEG;AACH,QAAA,MAAM,oBAAoB;;;;GAaR,CAAC;AAEnB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAQxE;;GAEG;AACH,QAAA,MAAM,yBAAyB;;;;;;;;;;GAYb,CAAC;AAEnB,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;KAQxB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EAYhC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,qBAAqB,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE9E;;GAEG;AACH,qBAAa,eAAgB,SAAQ,oBAGL;CAAG;;;;;;;;;;;;AAEnC;;;GAGG;AAEH,qBAAa,WAAY,SAAQ,gBAQ/B;CAAG;AAEL;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E,eAAO,MAAM,cAAc,iDAAiC,CAAC"}

package/dist/types/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"version":"5.7.3"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/functions",
-  "version": "0.7.4",
+  "version": "0.7.5-labs.071a3e2",
   "description": "Functions API and runtime.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -13,15 +13,20 @@
       "browser": "./dist/lib/browser/index.mjs",
       "node": "./dist/lib/node-esm/index.mjs"
     },
+    "./edge": {
+      "types": "./dist/types/src/edge/index.d.ts",
+      "browser": "./dist/lib/browser/edge/index.mjs",
+      "node": "./dist/lib/node-esm/edge/index.mjs"
+    },
     "./testing": {
       "types": "./dist/types/src/testing/index.d.ts",
       "browser": "./dist/lib/browser/testing/index.mjs",
       "node": "./dist/lib/node-esm/testing/index.mjs"
     },
     "./types": {
-      "types": "./dist/types/src/types.d.ts",
-      "browser": "./dist/lib/browser/types.mjs",
-      "node": "./dist/lib/node-esm/types.mjs"
+      "types": "./dist/types/src/types/index.d.ts",
+      "browser": "./dist/lib/browser/types/index.mjs",
+      "node": "./dist/lib/node-esm/types/index.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
@@ -44,29 +49,31 @@
     "@effect/schema": "^0.75.5",
     "@preact/signals-core": "^1.6.0",
     "cron": "^3.1.6",
-    "effect": "^3.9.2",
+    "effect": "^3.12.3",
     "express": "^4.19.2",
     "get-port-please": "^3.1.1",
+    "iso-did": "^1.6.0",
     "ws": "^8.14.2",
-    "@dxos/async": "0.7.4",
-    "@dxos/client": "0.7.4",
-    "@dxos/context": "0.7.4",
-    "@dxos/echo-db": "0.7.4",
-    "@dxos/echo-protocol": "0.7.4",
-    "@dxos/invariant": "0.7.4",
-    "@dxos/echo-schema": "0.7.4",
-    "@dxos/keys": "0.7.4",
-    "@dxos/log": "0.7.4",
-    "@dxos/live-object": "0.7.4",
-    "@dxos/protocols": "0.7.4",
-    "@dxos/schema": "0.7.4",
-    "@dxos/util": "0.7.4",
-    "@dxos/node-std": "0.7.4"
+    "@dxos/async": "0.7.5-labs.071a3e2",
+    "@dxos/context": "0.7.5-labs.071a3e2",
+    "@dxos/client": "0.7.5-labs.071a3e2",
+    "@dxos/echo-db": "0.7.5-labs.071a3e2",
+    "@dxos/echo-schema": "0.7.5-labs.071a3e2",
+    "@dxos/edge-client": "0.7.5-labs.071a3e2",
+    "@dxos/invariant": "0.7.5-labs.071a3e2",
+    "@dxos/echo-protocol": "0.7.5-labs.071a3e2",
+    "@dxos/keys": "0.7.5-labs.071a3e2",
+    "@dxos/log": "0.7.5-labs.071a3e2",
+    "@dxos/live-object": "0.7.5-labs.071a3e2",
+    "@dxos/node-std": "0.7.5-labs.071a3e2",
+    "@dxos/protocols": "0.7.5-labs.071a3e2",
+    "@dxos/schema": "0.7.5-labs.071a3e2",
+    "@dxos/util": "0.7.5-labs.071a3e2"
   },
   "devDependencies": {
     "@types/express": "^4.17.17",
     "@types/ws": "^7.4.0",
-    "@dxos/agent": "0.7.4"
+    "@dxos/agent": "0.7.5-labs.071a3e2"
   },
   "publishConfig": {
     "access": "public"

package/src/edge/functions.ts

@@ -0,0 +1,120 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { type DID } from 'iso-did/types';
+
+import { type Client } from '@dxos/client';
+import { type ObjectMeta } from '@dxos/echo-schema';
+import { EdgeHttpClient, type EdgeIdentity } from '@dxos/edge-client';
+import { invariant } from '@dxos/invariant';
+import type { PublicKey, SpaceId } from '@dxos/keys';
+import { log } from '@dxos/log';
+import { type UploadFunctionResponseBody } from '@dxos/protocols';
+
+// TODO: use URL scheme for source?
+const FUNCTIONS_META_KEY = 'dxos.org/service/function';
+
+export const FUNCTIONS_PRESET_META_KEY = 'dxos.org/service/function-preset';
+
+export type UploadWorkerArgs = {
+  client: Client;
+  name?: string;
+  source: string;
+  version: string;
+  functionId?: string;
+  spaceId: SpaceId;
+};
+
+export const uploadWorkerFunction = async ({
+  client,
+  name,
+  version,
+  source,
+  spaceId,
+  functionId,
+}: UploadWorkerArgs): Promise<UploadFunctionResponseBody> => {
+  const edgeUrl = client.config.values.runtime?.services?.edge?.url;
+  invariant(edgeUrl, 'Edge is not configured.');
+  const edgeClient = new EdgeHttpClient(edgeUrl);
+  const edgeIdentity = createEdgeIdentity(client);
+  edgeClient.setIdentity(edgeIdentity);
+  const response = await edgeClient.uploadFunction({ spaceId, functionId }, { name, version, script: source });
+
+  log('Uploaded', {
+    functionId,
+    source,
+    name,
+    identityKey: edgeIdentity.identityKey,
+    response,
+  });
+
+  return response;
+};
+
+export const getUserFunctionUrlInMetadata = (meta: ObjectMeta) => {
+  return meta.keys.find((key) => key.source === FUNCTIONS_META_KEY)?.id;
+};
+
+export const setUserFunctionUrlInMetadata = (meta: ObjectMeta, functionUrl: string) => {
+  const key = meta.keys.find((key) => key.source === FUNCTIONS_META_KEY);
+  if (key) {
+    if (key.id !== functionUrl) {
+      throw new Error('Metadata mismatch');
+    }
+  } else {
+    meta.keys.push({ source: FUNCTIONS_META_KEY, id: functionUrl });
+  }
+};
+
+export const getInvocationUrl = (functionUrl: string, edgeUrl: string, options: InvocationOptions = {}) => {
+  const baseUrl = new URL('functions/', edgeUrl);
+
+  // Leading slashes cause the URL to be treated as an absolute path.
+  const relativeUrl = functionUrl.replace(/^\//, '');
+  const url = new URL(`./${relativeUrl}`, baseUrl.toString());
+  options.spaceId && url.searchParams.set('spaceId', options.spaceId);
+  options.subjectId && url.searchParams.set('subjectId', options.subjectId);
+  url.protocol = isSecure(url.protocol) ? 'https' : 'http';
+  return url.toString();
+};
+
+const isSecure = (protocol: string) => {
+  return protocol === 'https:' || protocol === 'wss:';
+};
+
+const createEdgeIdentity = (client: Client): EdgeIdentity => {
+  const identity = client.halo.identity.get();
+  const device = client.halo.device;
+  if (!identity || !device) {
+    throw new Error('Identity not available');
+  }
+  return {
+    identityKey: identity.identityKey.toHex(),
+    peerKey: device.deviceKey.toHex(),
+    presentCredentials: async ({ challenge }) => {
+      const identityService = client.services.services.IdentityService!;
+      const authCredential = await identityService.createAuthCredential();
+      return identityService.signPresentation({
+        presentation: { credentials: [authCredential] },
+        nonce: challenge,
+      });
+    },
+  };
+};
+
+export const incrementSemverPatch = (version: string): string => {
+  const [major, minor, patch] = version.split('.');
+  const patchNum = Number(patch);
+  invariant(!Number.isNaN(patchNum), 'Unexpected function version format.');
+  return [major, minor, String(patchNum + 1)].join('.');
+};
+
+export const publicKeyToDid = (key: PublicKey): DID => {
+  return `did:key:${key.toHex()}`;
+};
+
+export type InvocationOptions = {
+  spaceId?: SpaceId;
+  subjectId?: string;
+};

package/src/edge/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+export * from './functions';

package/src/handler.ts

@@ -61,6 +61,7 @@ export interface FunctionContextAi {
 /**
  * Event payload.
  */
+// TODO(dmaretskyi): Update type definitions to match the actual payload.
 export type FunctionEvent<TData = {}, TMeta = {}> = {
   data: FunctionEventMeta<TMeta> & TData;
 };

package/src/index.ts

@@ -2,6 +2,7 @@
 // Copyright 2023 DXOS.org
 //
 
+export * from './edge';
 export * from './function';
 export * from './handler';
 // export * from './runtime';

package/src/translations.ts

@@ -0,0 +1,15 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { ScriptType } from './types';
+
+export default [
+  {
+    'en-US': {
+      [ScriptType.typename]: {
+        'typename label': 'Script',
+      },
+    },
+  },
+];

package/src/trigger/trigger-registry.test.ts

@@ -236,7 +236,9 @@ describe('trigger registry', () => {
       const triggers = createTriggers(space, 3);
 
       const triggerLoaded = new Trigger();
-      registry.registered.on((fn) => triggerLoaded.wake());
+      registry.registered.on(() => {
+        triggerLoaded.wake();
+      });
 
       const triggerRemoved = new Trigger<FunctionTrigger>();
       registry.removed.on((fn) => {

package/src/types/index.ts

@@ -0,0 +1,6 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+export * from './schema';
+export * from './types';

package/src/types/schema.ts

@@ -0,0 +1,46 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { JsonSchemaType, Ref, S, TypedObject } from '@dxos/echo-schema';
+import { TextType } from '@dxos/schema';
+
+/**
+ * Source script.
+ */
+export class ScriptType extends TypedObject({
+  typename: 'dxos.org/type/Script',
+  version: '0.1.0',
+})({
+  // TODO(burdon): Change to URI?
+  name: S.optional(S.String),
+  description: S.optional(S.String),
+  // TODO(burdon): Change to hash of deployed content.
+  // Whether source has changed since last deploy.
+  changed: S.optional(S.Boolean),
+  source: Ref(TextType),
+}) {}
+
+/**
+ * Function deployment.
+ */
+// TODO(burdon): Move to core/functions.
+export class FunctionType extends TypedObject({
+  typename: 'dxos.org/type/Function',
+  version: '0.1.0',
+})({
+  // TODO(burdon): Rename to id/uri?
+  name: S.NonEmptyString,
+  version: S.String,
+
+  description: S.optional(S.String),
+
+  // Reference to a source script if it exists within ECHO.
+  // TODO(burdon): Don't ref ScriptType directly (core).
+  source: S.optional(Ref(ScriptType)),
+
+  inputSchema: S.optional(JsonSchemaType),
+
+  // Local binding to a function name.
+  binding: S.optional(S.String),
+}) {}

package/src/{types.ts → types/types.ts}

@@ -13,6 +13,7 @@ export enum TriggerKind {
   Timer = 'timer',
   Webhook = 'webhook',
   Subscription = 'subscription',
+  Email = 'email',
 }
 
 // TODO(burdon): Rename prop kind.
@@ -31,6 +32,12 @@ const TimerTriggerSchema = S.Struct({
 
 export type TimerTrigger = S.Schema.Type<typeof TimerTriggerSchema>;
 
+const EmailTriggerSchema = S.Struct({
+  type: S.Literal(TriggerKind.Email).annotations(typeLiteralAnnotations),
+}).pipe(S.mutable);
+
+export type EmailTrigger = S.Schema.Type<typeof EmailTriggerSchema>;
+
 /**
  * Webhook.
  */
@@ -84,6 +91,7 @@ export const TriggerSchema = S.Union(
   TimerTriggerSchema,
   WebhookTriggerSchema,
   SubscriptionTriggerSchema,
+  EmailTriggerSchema,
 ).annotations({
   [AST.TitleAnnotationId]: 'Trigger',
 });