@tangle-network/agent-integrations 0.70.0 → 0.72.0

package/dist/triggers/index.d.ts

@@ -0,0 +1,78 @@
+import { i as TriggerEventCatalog } from "../router-D9qd9HmR.js";
+//#region src/triggers/types.d.ts
+/** Types for hosted triggers; see `./index.ts` for the runtime contract. */
+interface HostedTriggerPerson {
+  email: string | null;
+  name: string | null;
+  company: string | null;
+}
+interface HostedTriggerEvent {
+  /** Stable across polls: the delivery id a host deduplicates on. */
+  id: string;
+  /** The trigger's event id, e.g. `typeform.response.submitted`. */
+  type: string;
+  /** ISO-8601 time the record was created upstream. */
+  occurredAt: string;
+  person: HostedTriggerPerson | null;
+  summary: string;
+  /** The record trimmed to the fields a workflow needs. */
+  record: Record<string, unknown>;
+}
+interface HostedTriggerCursor {
+  /** ISO-8601 time: records created at or after it are new. */
+  since: string;
+  /** Keys emitted at or near `since`, newest last, so a boundary record is never emitted twice. */
+  seen: string[];
+}
+/** Run one READ capability of the trigger's connector on the subscribed connection; resolves to its data. */
+type HostedTriggerRead = (capability: string, args: Record<string, unknown>) => Promise<unknown>;
+interface PolledRecord {
+  key: string;
+  occurredAt: string;
+  person: HostedTriggerPerson | null;
+  summary: string;
+  record: Record<string, unknown>;
+}
+interface HostedTriggerDefinition {
+  /** Connector kind, which is also the Hub provider id. */
+  provider: string;
+  /** Event id, namespaced by the provider: `<provider>.<noun>.<verb>`. */
+  event: string;
+  description: string;
+  /** Minimum seconds between polls of one subscription. */
+  intervalSeconds: number;
+  /** Every capability `list` may read; each must be a READ on this connector. */
+  reads: readonly string[];
+  /** Candidate records created at or after `since`; the runner filters and orders them. */
+  list(context: {
+    read: HostedTriggerRead;
+    since: string;
+    now: Date;
+  }): Promise<PolledRecord[]>;
+}
+//#endregion
+//#region src/triggers/definitions.d.ts
+export declare const HOSTED_TRIGGER_DEFINITIONS: readonly HostedTriggerDefinition[];
+//#endregion
+//#region src/triggers/index.d.ts
+export declare const MAX_EVENTS_PER_POLL = 50;
+export interface HostedTriggerPollResult {
+  events: HostedTriggerEvent[];
+  cursor: HostedTriggerCursor;
+  /** True when more new records remain than one poll emits. */
+  more: boolean;
+}
+/** Poll one subscription once. `cursor` is null on the first poll after it is created. */
+export declare function pollHostedTrigger(trigger: HostedTriggerDefinition, context: {
+  read: HostedTriggerRead;
+  cursor: HostedTriggerCursor | null;
+  now: Date;
+}): Promise<HostedTriggerPollResult>;
+export declare function hostedTrigger(provider: string, event: string): HostedTriggerDefinition | undefined;
+/** Providers with at least one hosted trigger. */
+export declare const HOSTED_TRIGGER_PROVIDER_IDS: readonly string[];
+/** The closed catalog of a provider's hosted trigger events, for validating `on.provider_event.event`. */
+export declare function hostedTriggerEventCatalog(provider: string): TriggerEventCatalog | undefined;
+//#endregion
+export type { HostedTriggerCursor, HostedTriggerDefinition, HostedTriggerEvent, HostedTriggerPerson, HostedTriggerRead, PolledRecord };
+//# sourceMappingURL=index.d.ts.map

package/dist/triggers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/triggers/types.ts","../../src/triggers/definitions.ts","../../src/triggers/index.ts"],"mappings":";;;UAEiB;EACf;EACA;EACA;;UAGe;;EAEf;;EAEA;;EAEA;EACA,QAAQ;EACR;;EAEA,QAAQ;;UAGO;;EAEf;;EAEA;;;KAIU,qBAAqB,oBAAoB,MAAM,4BAA4B;UAEtE;EACf;EACA;EACA,QAAQ;EACR;EACA,QAAQ;;UAGO;;EAEf;;EAEA;EACA;;EAEA;;EAEA;;EAEA,KAAK;IAAW,MAAM;IAAmB;IAAe,KAAK;MAAS,QAAQ;;;;qBC+YnE,qCAAqC;;;qBCparC;iBAGI;EACf,QAAQ;EACR,QAAQ;;EAER;;;wBAIoB,kBACpB,SAAS,yBACT;EAAW,MAAM;EAAmB,QAAQ;EAA4B,KAAK;IAC5E,QAAQ;wBA0BK,cAAc,kBAAkB,gBAAgB;;qBAKnD;;wBAGG,0BAA0B,mBAAmB"}