@dxos/functions 0.8.4-main.ae835ea → 0.8.4-main.bc2380dfbc

package/src/types/Trigger.ts

@@ -1,139 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import * as Schema from 'effect/Schema';
-import * as SchemaAST from 'effect/SchemaAST';
-
-import { Obj, QueryAST, Type } from '@dxos/echo';
-import { Expando, OptionsAnnotationId, Ref } from '@dxos/echo/internal';
-import { DXN } from '@dxos/keys';
-
-/**
- * Type discriminator for TriggerType.
- * Every spec has a type field of type TriggerKind that we can use to understand which type we're working with.
- * https://www.typescriptlang.org/docs/handbook/2/narrowing.html#discriminated-unions
- */
-export const Kinds = ['email', 'queue', 'subscription', 'timer', 'webhook'] as const;
-export type Kind = (typeof Kinds)[number];
-
-const kindLiteralAnnotations = { title: 'Kind' };
-
-export const EmailSpec = Schema.Struct({
-  kind: Schema.Literal('email').annotations(kindLiteralAnnotations),
-}).pipe(Schema.mutable);
-export type EmailSpec = Schema.Schema.Type<typeof EmailSpec>;
-
-export const QueueSpec = Schema.Struct({
-  kind: Schema.Literal('queue').annotations(kindLiteralAnnotations),
-
-  // TODO(dmaretskyi): Change to a reference.
-  queue: DXN.Schema,
-}).pipe(Schema.mutable);
-export type QueueSpec = Schema.Schema.Type<typeof QueueSpec>;
-
-/**
- * Subscription.
- */
-export const SubscriptionSpec = Schema.Struct({
-  kind: Schema.Literal('subscription').annotations(kindLiteralAnnotations),
-  query: Schema.Struct({
-    raw: Schema.optional(Schema.String.annotations({ title: 'Query' })),
-    ast: QueryAST.Query,
-  }).pipe(Schema.mutable),
-  options: Schema.optional(
-    Schema.Struct({
-      // Watch changes to object (not just creation).
-      deep: Schema.optional(Schema.Boolean.annotations({ title: 'Nested' })),
-      // Debounce changes (delay in ms).
-      delay: Schema.optional(Schema.Number.annotations({ title: 'Delay' })),
-    }).annotations({ title: 'Options' }),
-  ),
-}).pipe(Schema.mutable);
-export type SubscriptionSpec = Schema.Schema.Type<typeof SubscriptionSpec>;
-
-/**
- * Cron timer.
- */
-export const TimerSpec = Schema.Struct({
-  kind: Schema.Literal('timer').annotations(kindLiteralAnnotations),
-  cron: Schema.String.annotations({
-    title: 'Cron',
-    [SchemaAST.ExamplesAnnotationId]: ['0 0 * * *'],
-  }),
-}).pipe(Schema.mutable);
-export type TimerSpec = Schema.Schema.Type<typeof TimerSpec>;
-
-/**
- * Webhook.
- */
-export const WebhookSpec = Schema.Struct({
-  kind: Schema.Literal('webhook').annotations(kindLiteralAnnotations),
-  method: Schema.optional(
-    Schema.String.annotations({
-      title: 'Method',
-      [OptionsAnnotationId]: ['GET', 'POST'],
-    }),
-  ),
-  port: Schema.optional(
-    Schema.Number.annotations({
-      title: 'Port',
-    }),
-  ),
-}).pipe(Schema.mutable);
-export type WebhookSpec = Schema.Schema.Type<typeof WebhookSpec>;
-
-/**
- * Trigger schema.
- */
-export const Spec = Schema.Union(EmailSpec, QueueSpec, SubscriptionSpec, TimerSpec, WebhookSpec).annotations({
-  title: 'Trigger',
-});
-export type Spec = Schema.Schema.Type<typeof Spec>;
-
-/**
- * Function trigger.
- * Function is invoked with the `payload` passed as input data.
- * The event that triggers the function is available in the function context.
- */
-const Trigger_ = Schema.Struct({
-  /**
-   * Function or workflow to invoke.
-   */
-  // TODO(dmaretskyi): Can be a Ref(FunctionType) or Ref(ComputeGraphType).
-  function: Schema.optional(Ref(Expando).annotations({ title: 'Function' })),
-
-  /**
-   * Only used for workflowSchema.
-   * Specifies the input node in the circuit.
-   * @deprecated Remove and enforce a single input node in all compute graphSchema.
-   */
-  inputNodeId: Schema.optional(Schema.String.annotations({ title: 'Input Node ID' })),
-
-  enabled: Schema.optional(Schema.Boolean.annotations({ title: 'Enabled' })),
-
-  spec: Schema.optional(Spec),
-
-  /**
-   * Passed as the input data to the function.
-   * Must match the function's input schema.
-   *
-   * @example
-   * {
-   *   item: '{{$.trigger.event}}',
-   *   instructions: 'Summarize and perform entity-extraction'
-   *   mailbox: { '/': 'dxn:echo:AAA:ZZZ' }
-   * }
-   */
-  input: Schema.optional(Schema.mutable(Schema.Record({ key: Schema.String, value: Schema.Any }))),
-}).pipe(
-  Type.Obj({
-    typename: 'dxos.org/type/Trigger',
-    version: '0.1.0',
-  }),
-);
-export interface Trigger extends Schema.Schema.Type<typeof Trigger_> {}
-export interface TriggerEncoded extends Schema.Schema.Encoded<typeof Trigger_> {}
-export const Trigger: Schema.Schema<Trigger, TriggerEncoded> = Trigger_;
-
-export const make = (props: Obj.MakeProps<typeof Trigger>) => Obj.make(Trigger, props);

package/src/types/TriggerEvent.ts

@@ -1,62 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Schema from 'effect/Schema';
-
-import { DXN, Obj, Type } from '@dxos/echo';
-
-export type TriggerEvent = EmailEvent | QueueEvent | SubscriptionEvent | TimerEvent | WebhookEvent;
-
-// TODO(burdon): Reuse trigger schema from @dxos/functions (TriggerType).
-export const EmailEvent = Schema.mutable(
-  Schema.Struct({
-    from: Schema.String,
-    to: Schema.String,
-    subject: Schema.String,
-    created: Schema.String,
-    body: Schema.String,
-  }),
-);
-export type EmailEvent = Schema.Schema.Type<typeof EmailEvent>;
-
-export const QueueEvent = Schema.mutable(
-  Schema.Struct({
-    queue: DXN.Schema,
-    item: Schema.Any,
-    cursor: Schema.String,
-  }),
-);
-export type QueueEvent = Schema.Schema.Type<typeof QueueEvent>;
-
-export const SubscriptionEvent = Schema.Struct({
-  /**
-   * Type of the mutation.
-   */
-  // TODO(dmaretskyi): Specify enum.
-  type: Schema.String,
-
-  /**
-   * Reference to the object that was changed or created.
-   */
-  subject: Type.Ref(Obj.Any),
-
-  /**
-   * @deprecated
-   */
-  changedObjectId: Schema.optional(Schema.String),
-}).pipe(Schema.mutable);
-export type SubscriptionEvent = Schema.Schema.Type<typeof SubscriptionEvent>;
-
-export const TimerEvent = Schema.mutable(Schema.Struct({ tick: Schema.Number }));
-export type TimerEvent = Schema.Schema.Type<typeof TimerEvent>;
-
-export const WebhookEvent = Schema.mutable(
-  Schema.Struct({
-    url: Schema.String,
-    method: Schema.Literal('GET', 'POST'),
-    headers: Schema.Record({ key: Schema.String, value: Schema.String }),
-    bodyText: Schema.String,
-  }),
-);
-export type WebhookEvent = Schema.Schema.Type<typeof WebhookEvent>;

package/src/url.ts

@@ -1,55 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { type ObjectMeta } from '@dxos/echo/internal';
-import { type SpaceId } from '@dxos/keys';
-
-// TODO: use URL scheme for source?
-export const FUNCTIONS_META_KEY = 'dxos.org/service/function';
-
-export const FUNCTIONS_PRESET_META_KEY = 'dxos.org/service/function-preset';
-
-const isSecure = (protocol: string) => {
-  return protocol === 'https:' || protocol === 'wss:';
-};
-
-/**
- * NOTE: functionId is backend ID, not ECHO object id.
- */
-export const getUserFunctionIdInMetadata = (meta: ObjectMeta) => {
-  return meta.keys.find((key) => key.source === FUNCTIONS_META_KEY)?.id;
-};
-
-/**
- * NOTE: functionId is backend ID, not ECHO object id.
- */
-export const setUserFunctionIdInMetadata = (meta: ObjectMeta, functionId: string) => {
-  const key = meta.keys.find((key) => key.source === FUNCTIONS_META_KEY);
-  if (key) {
-    if (key.id !== functionId) {
-      throw new Error('Metadata mismatch');
-    }
-  } else {
-    meta.keys.push({ source: FUNCTIONS_META_KEY, id: functionId });
-  }
-};
-
-/**
- * NOTE: functionId is backend ID, not ECHO object id.
- */
-export const getInvocationUrl = (functionId: string, edgeUrl: string, options: InvocationOptions = {}) => {
-  const baseUrl = new URL('functions/', edgeUrl);
-
-  // Leading slashes cause the URL to be treated as an absolute path.
-  const url = new URL(`./${functionId}`, 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();
-};
-
-export type InvocationOptions = {
-  spaceId?: SpaceId;
-  subjectId?: string;
-};