@dxos/functions 0.3.7 → 0.3.8-main.0ab6c73

package/dist/lib/node/meta.json

@@ -1 +1 @@
-{"inputs":{"packages/core/functions/src/function.ts":{"bytes":1777,"imports":[],"format":"esm"},"packages/core/functions/src/runtime/dev-server.ts":{"bytes":14040,"imports":[{"path":"express","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"portfinder","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true}],"format":"esm"},"packages/core/functions/src/runtime/trigger-manager.ts":{"bytes":16473,"imports":[{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/context","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"packages/core/functions/src/runtime/index.ts":{"bytes":579,"imports":[{"path":"packages/core/functions/src/runtime/dev-server.ts","kind":"import-statement","original":"./dev-server"},{"path":"packages/core/functions/src/runtime/trigger-manager.ts","kind":"import-statement","original":"./trigger-manager"}],"format":"esm"},"packages/core/functions/src/index.ts":{"bytes":545,"imports":[{"path":"packages/core/functions/src/function.ts","kind":"import-statement","original":"./function"},{"path":"packages/core/functions/src/runtime/index.ts","kind":"import-statement","original":"./runtime"}],"format":"esm"}},"outputs":{"packages/core/functions/dist/lib/node/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":14580},"packages/core/functions/dist/lib/node/index.cjs":{"imports":[{"path":"express","kind":"require-call","external":true},{"path":"node:path","kind":"require-call","external":true},{"path":"portfinder","kind":"require-call","external":true},{"path":"@dxos/async","kind":"require-call","external":true},{"path":"@dxos/log","kind":"require-call","external":true},{"path":"@dxos/async","kind":"require-call","external":true},{"path":"@dxos/context","kind":"require-call","external":true},{"path":"@dxos/echo-schema","kind":"require-call","external":true},{"path":"@dxos/invariant","kind":"require-call","external":true},{"path":"@dxos/log","kind":"require-call","external":true},{"path":"@dxos/util","kind":"require-call","external":true}],"exports":[],"entryPoint":"packages/core/functions/src/index.ts","inputs":{"packages/core/functions/src/index.ts":{"bytesInOutput":163},"packages/core/functions/src/runtime/dev-server.ts":{"bytesInOutput":3394},"packages/core/functions/src/runtime/index.ts":{"bytesInOutput":0},"packages/core/functions/src/runtime/trigger-manager.ts":{"bytesInOutput":4520}},"bytes":9783}}}
+{"inputs":{"packages/core/functions/src/handler.ts":{"bytes":1313,"imports":[],"format":"esm"},"packages/core/functions/src/manifest.ts":{"bytes":1735,"imports":[],"format":"esm"},"packages/core/functions/src/runtime/dev-server.ts":{"bytes":18553,"imports":[{"path":"express","kind":"import-statement","external":true},{"path":"get-port-please","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"packages/core/functions/src/runtime/scheduler.ts":{"bytes":16641,"imports":[{"path":"cron","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/context","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"packages/core/functions/src/runtime/index.ts":{"bytes":566,"imports":[{"path":"packages/core/functions/src/runtime/dev-server.ts","kind":"import-statement","original":"./dev-server"},{"path":"packages/core/functions/src/runtime/scheduler.ts","kind":"import-statement","original":"./scheduler"}],"format":"esm"},"packages/core/functions/src/index.ts":{"bytes":637,"imports":[{"path":"packages/core/functions/src/handler.ts","kind":"import-statement","original":"./handler"},{"path":"packages/core/functions/src/manifest.ts","kind":"import-statement","original":"./manifest"},{"path":"packages/core/functions/src/runtime/index.ts","kind":"import-statement","original":"./runtime"}],"format":"esm"}},"outputs":{"packages/core/functions/dist/lib/node/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":16608},"packages/core/functions/dist/lib/node/index.cjs":{"imports":[{"path":"express","kind":"import-statement","external":true},{"path":"get-port-please","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"cron","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/context","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"exports":["DevServer","Scheduler"],"entryPoint":"packages/core/functions/src/index.ts","inputs":{"packages/core/functions/src/index.ts":{"bytesInOutput":0},"packages/core/functions/src/runtime/dev-server.ts":{"bytesInOutput":4729},"packages/core/functions/src/runtime/index.ts":{"bytesInOutput":0},"packages/core/functions/src/runtime/scheduler.ts":{"bytesInOutput":4189}},"bytes":9466}}}

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

@@ -0,0 +1,17 @@
+import { type Client } from '@dxos/client';
+export interface Response {
+    status(code: number): Response;
+}
+export interface FunctionContext {
+    client: Client;
+}
+export type FunctionHandler<T extends {}> = (params: {
+    event: T;
+    context: FunctionContext;
+    response: Response;
+}) => Promise<Response | void>;
+export type FunctionSubscriptionEvent = {
+    space: string;
+    objects: string[];
+};
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/handler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;CAChC;AAGD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE;IACnD,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC;CACpB,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;AAE/B,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}

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

@@ -1,3 +1,4 @@
-export * from './function';
+export * from './handler';
+export * from './manifest';
 export * from './runtime';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}

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

@@ -0,0 +1,25 @@
+export type FunctionDef = {
+    id: string;
+    name: string;
+    handler: string;
+    description?: string;
+};
+export type TriggerSubscription = {
+    type: string;
+    spaceKey: string;
+    props?: Record<string, any>;
+    nested?: string[];
+};
+export type FunctionTrigger = {
+    function: string;
+    schedule?: string;
+    subscription?: TriggerSubscription;
+};
+/**
+ * Function manifest file.
+ */
+export type FunctionManifest = {
+    functions: FunctionDef[];
+    triggers: FunctionTrigger[];
+};
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/manifest.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,WAAW,GAAG;IAExB,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IAEb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAKF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC"}

package/dist/types/src/runtime/dev-server.d.ts

@@ -1,8 +1,11 @@
 import { type Client } from '@dxos/client';
-import { type FunctionsManifest } from '../function';
+import { type FunctionHandler } from '../handler';
+import { type FunctionDef, type FunctionManifest } from '../manifest';
 export type DevServerOptions = {
+    port?: number;
     directory: string;
-    manifest: FunctionsManifest;
+    manifest: FunctionManifest;
+    reload?: boolean;
 };
 /**
  * Functions dev server provides a local HTTP server for testing functions.
@@ -14,12 +17,25 @@ export declare class DevServer {
     private _server?;
     private _port?;
     private _registrationId?;
+    private _proxy?;
+    private _seq;
     constructor(_client: Client, _options: DevServerOptions);
-    get port(): number | undefined;
-    get endpoint(): string | undefined;
-    get functions(): string[];
+    get endpoint(): string;
+    get proxy(): string | undefined;
+    get functions(): {
+        def: FunctionDef;
+        handler: FunctionHandler<any>;
+    }[];
     initialize(): Promise<void>;
     start(): Promise<void>;
     stop(): Promise<void>;
+    /**
+     * Load function.
+     */
+    private _load;
+    /**
+     * Invoke function handler.
+     */
+    private _invoke;
 }
 //# sourceMappingURL=dev-server.d.ts.map

package/dist/types/src/runtime/dev-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../../../src/runtime/dev-server.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EAA8C,KAAK,iBAAiB,EAAiB,MAAM,aAAa,CAAC;AAIhH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAS;IASlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAT3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IAEtE,OAAO,CAAC,OAAO,CAAC,CAAc;IAC9B,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,eAAe,CAAC,CAAS;gBAId,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,gBAAgB;IAG7C,IAAI,IAAI,uBAEP;IAED,IAAI,QAAQ,uBAEX;IAED,IAAI,SAAS,aAEZ;IAEK,UAAU;IAiBV,KAAK;IAoDL,IAAI;CAiBX"}
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../../../src/runtime/dev-server.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,OAAO,EAAwB,KAAK,eAAe,EAAiB,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAS;IAYlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAX3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2E;IAErG,OAAO,CAAC,OAAO,CAAC,CAAc;IAC9B,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,IAAI,CAAK;gBAIE,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,gBAAgB;IAG7C,IAAI,QAAQ,WAGX;IAED,IAAI,KAAK,uBAER;IAED,IAAI,SAAS;;;QAEZ;IAEK,UAAU;IAUV,KAAK;IAwCL,IAAI;IAqBV;;OAEG;YACW,KAAK;IAqBnB;;OAEG;YACW,OAAO;CAwBtB"}

package/dist/types/src/runtime/index.d.ts

@@ -1,3 +1,3 @@
 export * from './dev-server';
-export * from './trigger-manager';
+export * from './scheduler';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/types/src/runtime/scheduler.d.ts

@@ -0,0 +1,22 @@
+import { type Client } from '@dxos/client';
+import { type FunctionManifest } from '../manifest';
+type SchedulerOptions = {
+    endpoint: string;
+};
+/**
+ * Functions scheduler.
+ */
+export declare class Scheduler {
+    private readonly _client;
+    private readonly _manifest;
+    private readonly _options;
+    private readonly _mounts;
+    constructor(_client: Client, _manifest: FunctionManifest, _options: SchedulerOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private mount;
+    private unmount;
+    private execFunction;
+}
+export {};
+//# sourceMappingURL=scheduler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../../src/runtime/scheduler.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,MAAM,EAAkB,MAAM,cAAc,CAAC;AAQ3D,OAAO,EAAoB,KAAK,gBAAgB,EAAwB,MAAM,aAAa,CAAC;AAE5F,KAAK,gBAAgB,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AAEH,qBAAa,SAAS;IAQlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAR3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAG6B;gBAGlC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,gBAAgB;IAGvC,KAAK;IAWL,IAAI;YAMI,KAAK;YA+DL,OAAO;YASP,YAAY;CAiB3B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/functions",
-  "version": "0.3.7",
+  "version": "0.3.8-main.0ab6c73",
   "description": "Functions SDK and runtime.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -19,16 +19,17 @@
     "src"
   ],
   "dependencies": {
+    "cron": "^3.1.6",
     "express": "^4.17.1",
-    "portfinder": "^1.0.32",
-    "@dxos/async": "0.3.7",
-    "@dxos/client": "0.3.7",
-    "@dxos/context": "0.3.7",
-    "@dxos/echo-schema": "0.3.7",
-    "@dxos/invariant": "0.3.7",
-    "@dxos/log": "0.3.7",
-    "@dxos/node-std": "0.3.7",
-    "@dxos/util": "0.3.7"
+    "get-port-please": "^3.1.1",
+    "@dxos/async": "0.3.8-main.0ab6c73",
+    "@dxos/context": "0.3.8-main.0ab6c73",
+    "@dxos/echo-schema": "0.3.8-main.0ab6c73",
+    "@dxos/client": "0.3.8-main.0ab6c73",
+    "@dxos/invariant": "0.3.8-main.0ab6c73",
+    "@dxos/node-std": "0.3.8-main.0ab6c73",
+    "@dxos/log": "0.3.8-main.0ab6c73",
+    "@dxos/util": "0.3.8-main.0ab6c73"
   },
   "devDependencies": {
     "@types/express": "^4.17.17"

package/src/handler.ts

@@ -0,0 +1,28 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { type Client } from '@dxos/client';
+
+// TODO(burdon): No response?
+export interface Response {
+  status(code: number): Response;
+}
+
+// TODO(burdon): Limit access to individual space?
+export interface FunctionContext {
+  client: Client;
+}
+
+// TODO(burdon): Model after http request. Ref Lambda/OpenFaaS.
+// https://docs.aws.amazon.com/lambda/latest/dg/typescript-handler.html
+export type FunctionHandler<T extends {}> = (params: {
+  event: T;
+  context: FunctionContext;
+  response: Response;
+}) => Promise<Response | void>;
+
+export type FunctionSubscriptionEvent = {
+  space: string; // TODO(burdon): Convert to PublicKey.
+  objects: string[];
+};

package/src/index.ts

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

package/src/manifest.ts

@@ -0,0 +1,40 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+// Lambda-like function definitions.
+// See: https://www.serverless.com/framework/docs/providers/aws/guide/serverless.yml/#functions
+
+export type FunctionDef = {
+  // FQ function name.
+  id: string;
+  // URL path.
+  name: string;
+  // File path of handler.
+  handler: string;
+  description?: string;
+};
+
+export type TriggerSubscription = {
+  type: string;
+  spaceKey: string;
+  props?: Record<string, any>;
+  nested?: string[];
+};
+
+// TODO(burdon): Generalize binding.
+// https://www.npmjs.com/package/aws-lambda
+// https://docs.aws.amazon.com/lambda/latest/dg/typescript-handler.html
+export type FunctionTrigger = {
+  function: string;
+  schedule?: string;
+  subscription?: TriggerSubscription;
+};
+
+/**
+ * Function manifest file.
+ */
+export type FunctionManifest = {
+  functions: FunctionDef[];
+  triggers: FunctionTrigger[];
+};

package/src/runtime/dev-server.ts

@@ -3,32 +3,37 @@
 //
 
 import express from 'express';
+import { getPort } from 'get-port-please';
 import type http from 'http';
 import { join } from 'node:path';
-import { getPortPromise } from 'portfinder';
 
 import { Trigger } from '@dxos/async';
 import { type Client } from '@dxos/client';
+import { invariant } from '@dxos/invariant';
 import { log } from '@dxos/log';
 
-import { type FunctionContext, type FunctionHandler, type FunctionsManifest, type Response } from '../function';
-
-const DEFAULT_PORT = 7000;
+import { type FunctionContext, type FunctionHandler, type Response } from '../handler';
+import { type FunctionDef, type FunctionManifest } from '../manifest';
 
 export type DevServerOptions = {
+  port?: number;
   directory: string;
-  manifest: FunctionsManifest;
+  manifest: FunctionManifest;
+  reload?: boolean;
 };
 
 /**
  * Functions dev server provides a local HTTP server for testing functions.
  */
 export class DevServer {
-  private readonly _handlers: Record<string, FunctionHandler<any>> = {};
+  // Function handlers indexed by name (URL path).
+  private readonly _handlers: Record<string, { def: FunctionDef; handler: FunctionHandler<any> }> = {};
 
   private _server?: http.Server;
   private _port?: number;
   private _registrationId?: string;
+  private _proxy?: string;
+  private _seq = 0;
 
   // prettier-ignore
   constructor(
@@ -36,31 +41,25 @@ export class DevServer {
     private readonly _options: DevServerOptions,
   ) {}
 
-  get port() {
-    return this._port;
+  get endpoint() {
+    invariant(this._port);
+    return `http://localhost:${this._port}`;
   }
 
-  get endpoint() {
-    return this._port ? `http://localhost:${this._port}` : undefined;
+  get proxy() {
+    return this._proxy;
   }
 
   get functions() {
-    return Object.keys(this._handlers);
+    return Object.values(this._handlers);
   }
 
   async initialize() {
-    for (const { id } of this._options.manifest.functions) {
+    for (const def of this._options.manifest.functions) {
       try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const module = require(join(this._options.directory, id));
-        const handler = module.default;
-        if (typeof handler !== 'function') {
-          throw new Error(`Handler must export default function: ${id}`);
-        }
-
-        this._handlers[id] = handler;
+        await this._load(def);
       } catch (err) {
-        log.error('parsing function (check functions.yml manifest)', err);
+        log.error('parsing function (check manifest)', err);
       }
     }
   }
@@ -69,51 +68,39 @@ export class DevServer {
     const app = express();
     app.use(express.json());
 
-    app.post('/:functionName', async (req, res) => {
-      const functionName = req.params.functionName;
-      log('invoke', { function: functionName, data: req.body });
-
-      const builder: Response = {
-        status: (code: number) => {
-          res.statusCode = code;
-          return builder;
-        },
-        succeed: (result = {}) => {
-          res.end(JSON.stringify(result));
-          return builder;
-        },
-      };
-
-      const context: FunctionContext = {
-        client: this._client,
-        status: builder.status.bind(builder),
-      };
-
-      void (async () => {
-        try {
-          // TODO(burdon): Typed event handler.
-          await this._handlers[functionName]({ event: req.body, context });
-        } catch (err: any) {
-          res.statusCode = 500;
-          res.end(err.message);
+    app.post('/:name', async (req, res) => {
+      const { name } = req.params;
+      try {
+        if (this._options.reload) {
+          const { def } = this._handlers[name];
+          await this._load(def, true);
         }
-      })();
+
+        res.statusCode = await this._invoke(name, req.body);
+        res.end();
+      } catch (err: any) {
+        log.error(err);
+        res.statusCode = 500;
+        res.end();
+      }
     });
 
-    this._port = await getPortPromise({ startPort: DEFAULT_PORT });
+    this._port = await getPort({ port: 7200, portRange: [7200, 7299] });
     this._server = app.listen(this._port);
 
-    // TODO(burdon): Check plugin is registered.
-    //  TypeError: Cannot read properties of undefined (reading 'register')
     try {
-      const { registrationId } = await this._client.services.services.FunctionRegistryService!.register({
-        endpoint: this.endpoint!,
-        functions: this.functions.map((name) => ({ name })),
+      // Register functions.
+      const { registrationId, endpoint } = await this._client.services.services.FunctionRegistryService!.register({
+        endpoint: this.endpoint,
+        functions: this.functions.map(({ def: { name } }) => ({ name })),
       });
+
+      log.info('registered', { registrationId, endpoint });
       this._registrationId = registrationId;
+      this._proxy = endpoint;
     } catch (err: any) {
       await this.stop();
-      throw new Error('FunctionRegistryService not available; check config (agent.plugins.functions).');
+      throw new Error('FunctionRegistryService not available (check plugin is configured).');
     }
   }
 
@@ -124,14 +111,69 @@ export class DevServer {
         await this._client.services.services.FunctionRegistryService!.unregister({
           registrationId: this._registrationId,
         });
+
+        log.info('unregistered', { registrationId: this._registrationId });
         this._registrationId = undefined;
+        this._proxy = undefined;
       }
 
       trigger.wake();
     });
 
     await trigger.wait();
-    this._server = undefined;
     this._port = undefined;
+    this._server = undefined;
+  }
+
+  /**
+   * Load function.
+   */
+  private async _load(def: FunctionDef, flush = false) {
+    const { id, name, handler } = def;
+    const path = join(this._options.directory, handler);
+    log.info('loading', { id });
+
+    // Remove from cache.
+    if (flush) {
+      Object.keys(require.cache)
+        .filter((key) => key.startsWith(path))
+        .forEach((key) => delete require.cache[key]);
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const module = require(path);
+    if (typeof module.default !== 'function') {
+      throw new Error(`Handler must export default function: ${id}`);
+    }
+
+    this._handlers[name] = { def, handler: module.default };
+  }
+
+  /**
+   * Invoke function handler.
+   */
+  private async _invoke(name: string, event: any) {
+    const seq = ++this._seq;
+    const now = Date.now();
+
+    log.info('req', { seq, name });
+    const { handler } = this._handlers[name];
+
+    const context: FunctionContext = {
+      client: this._client,
+    };
+
+    let statusCode = 200;
+    const response: Response = {
+      status: (code: number) => {
+        statusCode = code;
+        return response;
+      },
+    };
+
+    await handler({ context, event, response });
+    log.info('res', { seq, name, statusCode, duration: Date.now() - now });
+
+    return statusCode;
   }
 }

package/src/runtime/index.ts

@@ -3,4 +3,4 @@
 //
 
 export * from './dev-server';
-export * from './trigger-manager';
+export * from './scheduler';