@tailor-platform/sdk 1.72.0 → 1.73.0

package/dist/{types-v_ErzNUF.d.mts → configure/services/auth/types.d.mts}

@@ -1,175 +1,11 @@
-import { o as TailorEnv } from "./types-DTcZ2Yax.mjs";
-import { C as FieldMetadata, D as TailorField, F as output, O as TailorFieldType, m as TailorDBInstance, x as DefinedFieldMetadata } from "./types-rj8YJcEe.mjs";
+import { TailorEnv } from "../../../runtime/types.mjs";
+import { output } from "../../../types/helpers.mjs";
+import { DefinedFieldMetadata, FieldMetadata, TailorField, TailorFieldType } from "../../types/field.types.mjs";
+import { TailorDBInstance } from "../tailordb/types.mjs";
+import { AuthConnectionConfig } from "../../../types/auth-connection.generated.mjs";
+import { AuthInvoker, IdProvider, OAuth2Client, OAuth2ClientInput, SCIMAttribute, SCIMConfig, TenantProvider } from "../../../types/auth.generated.mjs";
 import { IsAny, JsonObject, JsonValue } from "type-fest";
 
-//#region src/types/auth-connection.generated.d.ts
-type AuthConnectionOAuth2Config = {
-  /** OAuth2 provider URL */providerUrl: string; /** OAuth2 issuer URL */
-  issuerUrl: string; /** OAuth2 client ID */
-  clientId: string; /** OAuth2 client secret */
-  clientSecret: string; /** OAuth2 authorization endpoint override */
-  authUrl?: string | undefined; /** OAuth2 token endpoint override */
-  tokenUrl?: string | undefined;
-};
-type AuthConnectionConfig = {
-  type: "oauth2";
-  providerUrl: string;
-  issuerUrl: string;
-  clientId: string;
-  clientSecret: string;
-  authUrl?: string | undefined;
-  tokenUrl?: string | undefined;
-};
-//#endregion
-//#region src/types/auth.generated.d.ts
-type AuthInvokerObject = {
-  /** Auth namespace */namespace: string; /** Machine user name for authentication */
-  machineUserName: string;
-};
-type AuthInvoker = AuthInvokerObject;
-type OIDC = {
-  /** Identity provider name */name: string;
-  kind: "OIDC"; /** OAuth2 client ID */
-  clientID: string; /** OAuth2 client secret */
-  clientSecret: {
-    vaultName: string;
-    secretKey: string;
-  }; /** OIDC provider URL */
-  providerURL: string; /** OIDC issuer URL (defaults to providerURL) */
-  issuerURL?: string | undefined; /** JWT claim to use as username */
-  usernameClaim?: string | undefined;
-};
-type SAML = {
-  /** Identity provider name */name: string;
-  kind: "SAML"; /** Enable signing of SAML requests */
-  enableSignRequest: boolean; /** URL to fetch SAML metadata (mutually exclusive with rawMetadata) */
-  metadataURL?: string | undefined; /** Raw SAML metadata XML (mutually exclusive with metadataURL) */
-  rawMetadata?: string | undefined; /** URL to redirect to when SAML ACS receives a response with an empty RelayState. */
-  defaultRedirectURL?: string | undefined;
-};
-type IDToken = {
-  /** Identity provider name */name: string;
-  kind: "IDToken"; /** ID token provider URL */
-  providerURL: string; /** Client ID for ID token validation */
-  clientID: string; /** ID token issuer URL */
-  issuerURL?: string | undefined; /** JWT claim to use as username */
-  usernameClaim?: string | undefined;
-};
-type BuiltinIdP = {
-  /** Identity provider name */name: string;
-  kind: "BuiltInIdP"; /** IdP namespace */
-  namespace: string; /** OAuth2 client name in the IdP */
-  clientName: string;
-};
-type IdProvider = OIDC | SAML | IDToken | BuiltinIdP;
-type OAuth2ClientInput = {
-  /** Allowed redirect URIs */redirectURIs: (`https://${string}` | `http://${string}` | `${string}:url` | `${string}:url/${string}`)[]; /** Client description */
-  description?: string | undefined; /** Allowed OAuth2 grant types */
-  grantTypes?: ("authorization_code" | "refresh_token")[] | undefined; /** OAuth2 client type */
-  clientType?: "confidential" | "public" | "browser" | undefined; /** Access token lifetime in seconds (60-86400) */
-  accessTokenLifetimeSeconds?: number | undefined; /** Refresh token lifetime in seconds (60-604800) */
-  refreshTokenLifetimeSeconds?: number | undefined; /** Require DPoP (Demonstrating Proof-of-Possession) for token requests */
-  requireDpop?: boolean | undefined;
-};
-type OAuth2Client = {
-  /** Allowed OAuth2 grant types */grantTypes: ("authorization_code" | "refresh_token")[]; /** Allowed redirect URIs */
-  redirectURIs: (`https://${string}` | `http://${string}` | `${string}:url` | `${string}:url/${string}`)[]; /** Access token lifetime in seconds (60-86400) */
-  accessTokenLifetimeSeconds: {
-    seconds: bigint;
-    nanos: number;
-  } | undefined; /** Refresh token lifetime in seconds (60-604800) */
-  refreshTokenLifetimeSeconds: {
-    seconds: bigint;
-    nanos: number;
-  } | undefined; /** Client description */
-  description?: string | undefined; /** OAuth2 client type */
-  clientType?: "confidential" | "public" | "browser" | undefined; /** Require DPoP (Demonstrating Proof-of-Possession) for token requests */
-  requireDpop?: boolean | undefined;
-};
-type SCIMAuthorization = {
-  /** SCIM authorization type */type: "oauth2" | "bearer"; /** Bearer token secret (required for bearer type) */
-  bearerSecret?: {
-    vaultName: string;
-    secretKey: string;
-  } | undefined;
-};
-type SCIMAttribute = {
-  /** Attribute data type */type: "string" | "number" | "boolean" | "datetime" | "complex"; /** Attribute name */
-  name: string; /** Attribute description */
-  description?: string | undefined; /** Attribute mutability */
-  mutability?: "readOnly" | "readWrite" | "writeOnly" | undefined; /** Whether the attribute is required */
-  required?: boolean | undefined; /** Whether the attribute can have multiple values */
-  multiValued?: boolean | undefined; /** Uniqueness constraint */
-  uniqueness?: "none" | "server" | "global" | undefined; /** List of canonical values */
-  canonicalValues?: string[] | null | undefined;
-  subAttributes?: SCIMAttribute[] | null | undefined;
-};
-type SCIMAttributeMapping = {
-  /** TailorDB field name to map to */tailorDBField: string; /** SCIM attribute path */
-  scimPath: string;
-};
-type SCIMResource = {
-  /** SCIM resource name */name: string; /** TailorDB namespace for the resource */
-  tailorDBNamespace: string; /** TailorDB type name for the resource */
-  tailorDBType: string; /** Core SCIM schema definition */
-  coreSchema: {
-    /** SCIM resource name */name: string;
-    attributes: {
-      type: "string" | "number" | "boolean" | "datetime" | "complex"; /** SCIM resource name */
-      name: string;
-      description?: string | undefined;
-      mutability?: "readOnly" | "readWrite" | "writeOnly" | undefined;
-      required?: boolean | undefined;
-      multiValued?: boolean | undefined;
-      uniqueness?: "none" | "server" | "global" | undefined;
-      canonicalValues?: string[] | null | undefined;
-      subAttributes?: any[] | null | undefined;
-    }[];
-  }; /** Attribute mapping configuration */
-  attributeMapping: {
-    tailorDBField: string;
-    scimPath: string;
-  }[];
-};
-type SCIMConfig = {
-  /** Machine user name for SCIM operations */machineUserName: string; /** SCIM authorization configuration */
-  authorization: {
-    type: "oauth2" | "bearer";
-    bearerSecret?: {
-      vaultName: string;
-      secretKey: string;
-    } | undefined;
-  }; /** SCIM resource definitions */
-  resources: {
-    name: string;
-    tailorDBNamespace: string;
-    tailorDBType: string;
-    coreSchema: {
-      name: string;
-      attributes: {
-        type: "string" | "number" | "boolean" | "datetime" | "complex";
-        name: string;
-        description?: string | undefined;
-        mutability?: "readOnly" | "readWrite" | "writeOnly" | undefined;
-        required?: boolean | undefined;
-        multiValued?: boolean | undefined;
-        uniqueness?: "none" | "server" | "global" | undefined;
-        canonicalValues?: string[] | null | undefined;
-        subAttributes?: any[] | null | undefined;
-      }[];
-    };
-    attributeMapping: {
-      tailorDBField: string;
-      scimPath: string;
-    }[];
-  }[];
-};
-type TenantProvider = {
-  /** TailorDB namespace for the tenant type */namespace: string; /** TailorDB type name for tenants */
-  type: string; /** Field used as the tenant signature */
-  signatureField: string;
-};
-//#endregion
 //#region src/configure/services/auth/types.d.ts
 type OAuth2ClientGrantType = OAuth2Client["grantTypes"][number];
 type SCIMAttributeType = SCIMAttribute["type"];
@@ -341,5 +177,4 @@ type AuthServiceInputLoose = AuthServiceInput<any, any, any, string, any>;
 type AuthOwnConfig = DefinedAuth<string, AuthServiceInputLoose, string>;
 type AuthConfig = AuthOwnConfig | AuthExternalConfig;
 //#endregion
-export { SCIMConfig as A, OAuth2Client as C, SCIMAttribute as D, SAML as E, TenantProvider as M, AuthConnectionConfig as N, SCIMAttributeMapping as O, AuthConnectionOAuth2Config as P, IdProvider as S, OIDC as T, UsernameFieldKey as _, AuthServiceInput as a, BuiltinIdP as b, DefinedAuth as c, FederatedIdentityProvider as d, OAuth2ClientGrantType as f, UserAttributeMap as g, UserAttributeListKey as h, AuthOwnConfig as i, SCIMResource as j, SCIMAuthorization as k, FederatedIdentity as l, UserAttributeKey as m, AuthConnectionTokenResult as n, BeforeLoginClaims as o, SCIMAttributeType as p, AuthExternalConfig as r, BeforeLoginHookArgs as s, AuthConfig as t, FederatedIdentityClaims as u, ValueOperand as v, OAuth2ClientInput as w, IDToken as x, AuthInvoker as y };
-//# sourceMappingURL=types-v_ErzNUF.d.mts.map
+export { AuthAttributeValue, AuthConfig, AuthConnectionTokenResult, AuthDefinitionBrand, AuthExternalConfig, AuthHooks, AuthInvokerWithName, AuthOwnConfig, AuthServiceInput, BeforeLoginClaims, BeforeLoginHook, BeforeLoginHookArgs, DefinedAuth, FederatedIdentity, FederatedIdentityClaims, FederatedIdentityProvider, OAuth2ClientGrantType, SCIMAttributeType, UserAttributeKey, UserAttributeListKey, UserAttributeMap, UsernameFieldKey, ValueOperand };

package/dist/configure/services/executor/executor.d.mts

@@ -0,0 +1,82 @@
+import { ExecutorInput } from "../../../types/executor.generated.mjs";
+import { MachineUserName } from "../../types/machine-user.mjs";
+import { AuthInvoker } from "../auth/index.mjs";
+import { Workflow } from "../workflow/workflow.mjs";
+import { Operation } from "./operation.mjs";
+import { Trigger } from "./trigger/index.mjs";
+
+//#region src/configure/services/executor/executor.d.ts
+/**
+ * Extract mainJob's Input type from Workflow.
+ */
+type WorkflowInput<W extends Workflow> = Parameters<W["trigger"]>[0];
+type TriggerArgs<T extends Trigger<unknown>> = T extends {
+  __args: infer Args;
+} ? Args : never;
+type ExecutorBase<T extends Trigger<unknown>> = Omit<ExecutorInput, "trigger" | "operation"> & {
+  trigger: T;
+};
+/**
+ * Executor type with conditional inference for workflow operations.
+ * When operation.kind is "workflow", infers W from the workflow property
+ * to ensure args type matches the workflow's mainJob input type.
+ */
+type Executor<T extends Trigger<unknown>, O> = O extends {
+  kind: "workflow";
+  workflow: infer W extends Workflow;
+} ? ExecutorBase<T> & {
+  operation: {
+    kind: "workflow";
+    workflow: W;
+    args?: WorkflowInput<W> | ((args: TriggerArgs<T>) => WorkflowInput<W>);
+    authInvoker?: AuthInvoker<string> | MachineUserName;
+  };
+} : ExecutorBase<T> & {
+  operation: O;
+};
+/**
+ * Create an executor configuration for the Tailor SDK.
+ *
+ * Executors are event-driven handlers that respond to record changes,
+ * resolver executions, or other events.
+ *
+ * Operation kinds: "function", "graphql", "webhook", "workflow".
+ * @template T
+ * @template O
+ * @param config - Executor configuration
+ * @returns The same executor configuration
+ * @example
+ * import { createExecutor, recordCreatedTrigger } from "@tailor-platform/sdk";
+ * import { order } from "../tailordb/order";
+ *
+ * export default createExecutor({
+ *   name: "order-created",
+ *   description: "Handles new order creation",
+ *   trigger: recordCreatedTrigger({ type: order }),
+ *   operation: {
+ *     kind: "function",
+ *     body: async ({ newRecord }) => {
+ *       console.log("New order:", newRecord.id);
+ *     },
+ *   },
+ * });
+ */
+declare function createExecutor<T extends Trigger<unknown>, O extends Operation<TriggerArgs<T>> | {
+  kind: "workflow";
+  workflow: Workflow;
+}>(config: Executor<T, O>): Executor<T, O>;
+/**
+ * Create an executor configuration for the Tailor SDK.
+ * This overload preserves source compatibility for legacy explicit generic calls,
+ * where the first generic argument represents trigger args.
+ * @template Args
+ * @template O
+ * @param config - Executor configuration
+ * @returns The same executor configuration
+ */
+declare function createExecutor<Args, O extends Operation<Args> | {
+  kind: "workflow";
+  workflow: Workflow;
+}>(config: Executor<Trigger<Args>, O>): Executor<Trigger<Args>, O>;
+//#endregion
+export { createExecutor };

package/dist/configure/services/executor/index.d.mts

@@ -0,0 +1,8 @@
+import { ExecutorServiceConfig, ExecutorServiceInput } from "../../config/types.mjs";
+import { FunctionOperation, GqlOperation, Operation, WebhookOperation, WorkflowOperation } from "./operation.mjs";
+import { AuthAccessTokenArgs, AuthAccessTokenIssuedArgs, AuthAccessTokenRefreshedArgs, AuthAccessTokenRevokedArgs, AuthAccessTokenTrigger, IdpUserArgs, IdpUserCreatedArgs, IdpUserDeletedArgs, IdpUserTrigger, IdpUserUpdatedArgs, RecordCreatedArgs, RecordDeletedArgs, RecordUpdatedArgs, ResolverExecutedArgs, ResolverExecutedTrigger, TailorDBTrigger, authAccessTokenIssuedTrigger, authAccessTokenRefreshedTrigger, authAccessTokenRevokedTrigger, authAccessTokenTrigger, idpUserCreatedTrigger, idpUserDeletedTrigger, idpUserTrigger, idpUserUpdatedTrigger, recordCreatedTrigger, recordDeletedTrigger, recordTrigger, recordUpdatedTrigger, resolverExecutedTrigger } from "./trigger/event.mjs";
+import { ScheduleArgs, ScheduleTrigger, scheduleTrigger } from "./trigger/schedule.mjs";
+import { IncomingWebhookArgs, IncomingWebhookRequest, IncomingWebhookResponse, IncomingWebhookResponseConfig, IncomingWebhookTrigger, IncomingWebhookTriggerOptions, incomingWebhookTrigger } from "./trigger/webhook.mjs";
+import { Trigger } from "./trigger/index.mjs";
+import { createExecutor } from "./executor.mjs";
+export { AuthAccessTokenArgs, AuthAccessTokenIssuedArgs, AuthAccessTokenRefreshedArgs, AuthAccessTokenRevokedArgs, AuthAccessTokenTrigger, type ExecutorServiceConfig, type ExecutorServiceInput, FunctionOperation, GqlOperation, IdpUserArgs, IdpUserCreatedArgs, IdpUserDeletedArgs, IdpUserTrigger, IdpUserUpdatedArgs, IncomingWebhookArgs, IncomingWebhookRequest, IncomingWebhookResponse, IncomingWebhookResponseConfig, IncomingWebhookTrigger, IncomingWebhookTriggerOptions, Operation, RecordCreatedArgs, RecordDeletedArgs, RecordUpdatedArgs, ResolverExecutedArgs, ResolverExecutedTrigger, ScheduleArgs, ScheduleTrigger, TailorDBTrigger, Trigger, WebhookOperation, WorkflowOperation, authAccessTokenIssuedTrigger, authAccessTokenRefreshedTrigger, authAccessTokenRevokedTrigger, authAccessTokenTrigger, createExecutor, idpUserCreatedTrigger, idpUserDeletedTrigger, idpUserTrigger, idpUserUpdatedTrigger, incomingWebhookTrigger, recordCreatedTrigger, recordDeletedTrigger, recordTrigger, recordUpdatedTrigger, resolverExecutedTrigger, scheduleTrigger };

package/dist/configure/services/executor/operation.d.mts

@@ -0,0 +1,46 @@
+import { TailorInvoker } from "../../../runtime/types.mjs";
+import { FunctionOperation as FunctionOperation$1, GqlOperation as GqlOperation$1, WebhookOperation as WebhookOperation$1, WorkflowOperation as WorkflowOperation$1 } from "../../../types/executor.generated.mjs";
+import { MachineUserName } from "../../types/machine-user.mjs";
+import { AuthInvoker } from "../auth/index.mjs";
+import { Workflow } from "../workflow/workflow.mjs";
+import { Client } from "@urql/core";
+
+//#region src/configure/services/executor/operation.d.ts
+/** Function-based executor operation. The body receives the trigger args and the `invoker`. */
+type FunctionOperation<Args> = Omit<FunctionOperation$1, "body" | "authInvoker"> & {
+  body: (args: Args & {
+    invoker?: TailorInvoker;
+  }) => void | Promise<void>;
+  authInvoker?: AuthInvoker<string> | MachineUserName;
+};
+type UrqlOperationArgs = Parameters<Client["query"] | Client["mutation"]>;
+/** GraphQL-based executor operation. Executes a GraphQL query or mutation. */
+type GqlOperation<Args> = Omit<GqlOperation$1, "query" | "variables" | "authInvoker"> & {
+  query: UrqlOperationArgs[0];
+  variables?: (args: Args) => UrqlOperationArgs[1];
+  authInvoker?: AuthInvoker<string> | MachineUserName;
+};
+type RequestHeader = "A-IM" | "Accept" | "Accept-Additions" | "Accept-CH" | "Accept-Charset" | "Accept-Datetime" | "Accept-Encoding" | "Accept-Features" | "Accept-Language" | "Accept-Patch" | "Accept-Post" | "Accept-Ranges" | "Accept-Signature" | "Access-Control" | "Access-Control-Allow-Credentials" | "Access-Control-Allow-Headers" | "Access-Control-Allow-Methods" | "Access-Control-Allow-Origin" | "Access-Control-Expose-Headers" | "Access-Control-Max-Age" | "Access-Control-Request-Headers" | "Access-Control-Request-Method" | "Age" | "Allow" | "ALPN" | "Alt-Svc" | "Alt-Used" | "Alternates" | "AMP-Cache-Transform" | "Apply-To-Redirect-Ref" | "Authentication-Control" | "Authentication-Info" | "Authorization" | "Available-Dictionary" | "C-Ext" | "C-Man" | "C-Opt" | "C-PEP" | "C-PEP-Info" | "Cache-Control" | "Cache-Status" | "Cal-Managed-ID" | "CalDAV-Timezones" | "Capsule-Protocol" | "CDN-Cache-Control" | "CDN-Loop" | "Cert-Not-After" | "Cert-Not-Before" | "Clear-Site-Data" | "Client-Cert" | "Client-Cert-Chain" | "Close" | "CMCD-Object" | "CMCD-Request" | "CMCD-Session" | "CMCD-Status" | "CMSD-Dynamic" | "CMSD-Static" | "Concealed-Auth-Export" | "Configuration-Context" | "Connection" | "Content-Base" | "Content-Digest" | "Content-Disposition" | "Content-Encoding" | "Content-ID" | "Content-Language" | "Content-Length" | "Content-Location" | "Content-MD5" | "Content-Range" | "Content-Script-Type" | "Content-Security-Policy" | "Content-Security-Policy-Report-Only" | "Content-Style-Type" | "Content-Type" | "Content-Version" | "Cookie" | "Cookie2" | "Cross-Origin-Embedder-Policy" | "Cross-Origin-Embedder-Policy-Report-Only" | "Cross-Origin-Opener-Policy" | "Cross-Origin-Opener-Policy-Report-Only" | "Cross-Origin-Resource-Policy" | "CTA-Common-Access-Token" | "DASL" | "Date" | "DAV" | "Default-Style" | "Delta-Base" | "Deprecation" | "Depth" | "Derived-From" | "Destination" | "Differential-ID" | "Dictionary-ID" | "Digest" | "DPoP" | "DPoP-Nonce" | "Early-Data" | "EDIINT-Features" | "ETag" | "Expect" | "Expect-CT" | "Expires" | "Ext" | "Forwarded" | "From" | "GetProfile" | "Hobareg" | "Host" | "HTTP2-Settings" | "If" | "If-Match" | "If-Modified-Since" | "If-None-Match" | "If-Range" | "If-Schedule-Tag-Match" | "If-Unmodified-Since" | "IM" | "Include-Referred-Token-Binding-ID" | "Isolation" | "Keep-Alive" | "Label" | "Last-Event-ID" | "Last-Modified" | "Link" | "Link-Template" | "Location" | "Lock-Token" | "Man" | "Max-Forwards" | "Memento-Datetime" | "Meter" | "Method-Check" | "Method-Check-Expires" | "MIME-Version" | "Negotiate" | "NEL" | "OData-EntityId" | "OData-Isolation" | "OData-MaxVersion" | "OData-Version" | "Opt" | "Optional-WWW-Authenticate" | "Ordering-Type" | "Origin" | "Origin-Agent-Cluster" | "OSCORE" | "OSLC-Core-Version" | "Overwrite" | "P3P" | "PEP" | "PEP-Info" | "Permissions-Policy" | "PICS-Label" | "Ping-From" | "Ping-To" | "Position" | "Pragma" | "Prefer" | "Preference-Applied" | "Priority" | "ProfileObject" | "Protocol" | "Protocol-Info" | "Protocol-Query" | "Protocol-Request" | "Proxy-Authenticate" | "Proxy-Authentication-Info" | "Proxy-Authorization" | "Proxy-Features" | "Proxy-Instruction" | "Proxy-Status" | "Public" | "Public-Key-Pins" | "Public-Key-Pins-Report-Only" | "Range" | "Redirect-Ref" | "Referer" | "Referer-Root" | "Referrer-Policy" | "Refresh" | "Repeatability-Client-ID" | "Repeatability-First-Sent" | "Repeatability-Request-ID" | "Repeatability-Result" | "Replay-Nonce" | "Reporting-Endpoints" | "Repr-Digest" | "Retry-After" | "Safe" | "Schedule-Reply" | "Schedule-Tag" | "Sec-GPC" | "Sec-Purpose" | "Sec-Token-Binding" | "Sec-WebSocket-Accept" | "Sec-WebSocket-Extensions" | "Sec-WebSocket-Key" | "Sec-WebSocket-Protocol" | "Sec-WebSocket-Version" | "Security-Scheme" | "Server" | "Server-Timing" | "Set-Cookie" | "Set-Cookie2" | "SetProfile" | "Signature" | "Signature-Input" | "SLUG" | "SoapAction" | "Status-URI" | "Strict-Transport-Security" | "Sunset" | "Surrogate-Capability" | "Surrogate-Control" | "TCN" | "TE" | "Timeout" | "Timing-Allow-Origin" | "Topic" | "Traceparent" | "Tracestate" | "Trailer" | "Transfer-Encoding" | "TTL" | "Upgrade" | "Urgency" | "URI" | "Use-As-Dictionary" | "User-Agent" | "Variant-Vary" | "Vary" | "Via" | "Want-Content-Digest" | "Want-Digest" | "Want-Repr-Digest" | "Warning" | "WWW-Authenticate" | "X-Content-Type-Options" | "X-Frame-Options" | (string & {});
+/** Outbound webhook executor operation. Sends HTTP requests to external URLs. */
+type WebhookOperation<Args> = Omit<WebhookOperation$1, "url" | "requestBody" | "headers"> & {
+  url: (args: Args) => string;
+  requestBody?: (args: Args) => Record<string, unknown>;
+  headers?: { [key in RequestHeader]?: string | {
+    vault: string;
+    key: string;
+  } };
+};
+/**
+ * Extract mainJob's Input type from Workflow.
+ * Workflow<Job> -> Job is WorkflowJob<Name, Input, Output> -> Input
+ */
+type WorkflowInput<W extends Workflow> = Parameters<W["trigger"]>[0];
+/** Workflow-triggering executor operation. Triggers a workflow in response to an event. */
+type WorkflowOperation<Args, W extends Workflow = Workflow> = Omit<WorkflowOperation$1, "workflowName" | "args" | "authInvoker"> & {
+  workflow: W;
+  args?: WorkflowInput<W> | ((args: Args) => WorkflowInput<W>);
+  authInvoker?: AuthInvoker<string> | MachineUserName;
+};
+type Operation<Args> = FunctionOperation<Args> | GqlOperation<Args> | WebhookOperation<Args> | WorkflowOperation<Args>;
+//#endregion
+export { FunctionOperation, GqlOperation, Operation, WebhookOperation, WorkflowOperation };

package/dist/configure/services/executor/trigger/event.d.mts

@@ -0,0 +1,272 @@
+import { TailorActor, TailorEnv } from "../../../../runtime/types.mjs";
+import { output } from "../../../../types/helpers.mjs";
+import { AuthAccessTokenTrigger as AuthAccessTokenTrigger$1, IdpUserTrigger as IdpUserTrigger$1, ResolverExecutedTrigger as ResolverExecutedTrigger$1, TailorDBTrigger as TailorDBTrigger$1 } from "../../../../types/executor.generated.mjs";
+import { TailorDBType } from "../../tailordb/schema.mjs";
+import { IdpName } from "../../../types/idp-name.mjs";
+import { ResolverConfig } from "../../resolver/resolver.mjs";
+
+//#region src/configure/services/executor/trigger/event.d.ts
+interface EventArgs {
+  workspaceId: string;
+  appNamespace: string;
+  env: TailorEnv;
+  actor: TailorActor | null;
+}
+interface RecordArgs extends EventArgs {
+  typeName: string;
+}
+interface RecordCreatedArgs<T extends TailorDBType> extends RecordArgs {
+  event: "created";
+  rawEvent: "tailordb.type_record.created";
+  newRecord: output<T>;
+}
+interface RecordUpdatedArgs<T extends TailorDBType> extends RecordArgs {
+  event: "updated";
+  rawEvent: "tailordb.type_record.updated";
+  newRecord: output<T>;
+  oldRecord: output<T>;
+}
+interface RecordDeletedArgs<T extends TailorDBType> extends RecordArgs {
+  event: "deleted";
+  rawEvent: "tailordb.type_record.deleted";
+  oldRecord: output<T>;
+}
+/**
+ * Args for resolverExecutedTrigger. This is a discriminated union on `success`.
+ *
+ * When `success` is true, `result` contains the resolver output and `error` is never.
+ * When `success` is false, `error` contains the error message and `result` is never.
+ *
+ * Narrow on `success` to safely access either `result` or `error`.
+ * @example
+ * body: async (args) => {
+ *   if (args.success) {
+ *     console.log(args.result);
+ *   } else {
+ *     console.error(args.error);
+ *   }
+ * }
+ */
+type ResolverExecutedArgs<R extends ResolverConfig> = EventArgs & {
+  resolverName: string;
+} & ({
+  success: true;
+  result: output<R["output"]>;
+  error?: never;
+} | {
+  success: false;
+  result?: never;
+  error: string;
+});
+interface IdpUserCreatedArgs extends EventArgs {
+  event: "created";
+  rawEvent: "idp.user.created";
+  namespaceName: string;
+  userId: string;
+}
+interface IdpUserUpdatedArgs extends EventArgs {
+  event: "updated";
+  rawEvent: "idp.user.updated";
+  namespaceName: string;
+  userId: string;
+}
+interface IdpUserDeletedArgs extends EventArgs {
+  event: "deleted";
+  rawEvent: "idp.user.deleted";
+  namespaceName: string;
+  userId: string;
+}
+type IdpUserArgs = IdpUserCreatedArgs | IdpUserUpdatedArgs | IdpUserDeletedArgs;
+interface AuthAccessTokenIssuedArgs extends EventArgs {
+  event: "issued";
+  rawEvent: "auth.access_token.issued";
+  namespaceName: string;
+  userId: string;
+}
+interface AuthAccessTokenRefreshedArgs extends EventArgs {
+  event: "refreshed";
+  rawEvent: "auth.access_token.refreshed";
+  namespaceName: string;
+  userId: string;
+}
+interface AuthAccessTokenRevokedArgs extends EventArgs {
+  event: "revoked";
+  rawEvent: "auth.access_token.revoked";
+  namespaceName: string;
+  userId: string;
+}
+type AuthAccessTokenArgs = AuthAccessTokenIssuedArgs | AuthAccessTokenRefreshedArgs | AuthAccessTokenRevokedArgs;
+declare const recordEventMap: {
+  readonly created: "tailordb.type_record.created";
+  readonly updated: "tailordb.type_record.updated";
+  readonly deleted: "tailordb.type_record.deleted";
+};
+type RecordEventMap = typeof recordEventMap;
+type RecordEventKind = keyof RecordEventMap;
+type RecordArgsMap<T extends TailorDBType> = {
+  created: RecordCreatedArgs<T>;
+  updated: RecordUpdatedArgs<T>;
+  deleted: RecordDeletedArgs<T>;
+};
+type RecordMultiArgs<T extends TailorDBType, K extends RecordEventKind[]> = RecordArgsMap<T>[K[number]];
+type TailorDBTrigger<Args> = TailorDBTrigger$1 & {
+  __args: Args;
+};
+type RecordTriggerOptions<T extends TailorDBType, Args> = {
+  type: T;
+  condition?: (args: Args) => boolean;
+};
+/**
+ * Create a trigger that fires when a TailorDB record is created.
+ * @template T
+ * @param options - Trigger options
+ * @returns Record created trigger
+ */
+declare function recordCreatedTrigger<T extends TailorDBType>(options: RecordTriggerOptions<T, RecordCreatedArgs<T>>): TailorDBTrigger<RecordCreatedArgs<T>>;
+/**
+ * Create a trigger that fires when a TailorDB record is updated.
+ * @template T
+ * @param options - Trigger options
+ * @returns Record updated trigger
+ */
+declare function recordUpdatedTrigger<T extends TailorDBType>(options: RecordTriggerOptions<T, RecordUpdatedArgs<T>>): TailorDBTrigger<RecordUpdatedArgs<T>>;
+/**
+ * Create a trigger that fires when a TailorDB record is deleted.
+ * @template T
+ * @param options - Trigger options
+ * @returns Record deleted trigger
+ */
+declare function recordDeletedTrigger<T extends TailorDBType>(options: RecordTriggerOptions<T, RecordDeletedArgs<T>>): TailorDBTrigger<RecordDeletedArgs<T>>;
+type RecordTriggerMultiOptions<T extends TailorDBType, K extends RecordEventKind[]> = {
+  type: T;
+  events: K;
+  condition?: (args: RecordMultiArgs<T, K>) => boolean;
+};
+/**
+ * Create a trigger that fires on multiple TailorDB record event types.
+ * @template T
+ * @template K
+ * @param options - Trigger options with events array
+ * @returns TailorDB record trigger
+ */
+declare function recordTrigger<T extends TailorDBType, const K extends [RecordEventKind, ...RecordEventKind[]]>(options: RecordTriggerMultiOptions<T, K>): TailorDBTrigger<RecordMultiArgs<T, K>>;
+type ResolverExecutedTrigger<Args> = ResolverExecutedTrigger$1 & {
+  __args: Args;
+};
+type ResolverExecutedTriggerOptions<R extends ResolverConfig> = {
+  resolver: R;
+  condition?: (args: ResolverExecutedArgs<R>) => boolean;
+};
+/**
+ * Create a trigger that fires when a resolver is executed.
+ * @template R
+ * @param options - Trigger options
+ * @returns Resolver executed trigger
+ */
+declare function resolverExecutedTrigger<R extends ResolverConfig>(options: ResolverExecutedTriggerOptions<R>): ResolverExecutedTrigger<ResolverExecutedArgs<R>>;
+declare const idpUserEventMap: {
+  readonly created: "idp.user.created";
+  readonly updated: "idp.user.updated";
+  readonly deleted: "idp.user.deleted";
+};
+type IdpUserEventMap = typeof idpUserEventMap;
+type IdpUserEventKind = keyof IdpUserEventMap;
+type IdpUserArgsMap = {
+  created: IdpUserCreatedArgs;
+  updated: IdpUserUpdatedArgs;
+  deleted: IdpUserDeletedArgs;
+};
+type IdpUserMultiArgs<K extends IdpUserEventKind[]> = IdpUserArgsMap[K[number]];
+type IdpUserTrigger<Args> = IdpUserTrigger$1 & {
+  __args: Args;
+};
+type IdpUserSingleTriggerOptions = {
+  /**
+   * IdP namespace name to subscribe to. Required when the project defines
+   * multiple IdPs; optional when a single IdP exists. Must match an IdP name
+   * declared in `defineConfig({ idp: [...] })`.
+   */
+  idp?: IdpName;
+};
+/**
+ * Create a trigger that fires when an IdP user is created.
+ * @param options - Trigger options
+ * @param options.idp - IdP namespace name to subscribe to
+ * @returns IdP user created trigger
+ */
+declare function idpUserCreatedTrigger(options?: IdpUserSingleTriggerOptions): IdpUserTrigger<IdpUserCreatedArgs>;
+/**
+ * Create a trigger that fires when an IdP user is updated.
+ * @param options - Trigger options
+ * @param options.idp - IdP namespace name to subscribe to
+ * @returns IdP user updated trigger
+ */
+declare function idpUserUpdatedTrigger(options?: IdpUserSingleTriggerOptions): IdpUserTrigger<IdpUserUpdatedArgs>;
+/**
+ * Create a trigger that fires when an IdP user is deleted.
+ * @param options - Trigger options
+ * @param options.idp - IdP namespace name to subscribe to
+ * @returns IdP user deleted trigger
+ */
+declare function idpUserDeletedTrigger(options?: IdpUserSingleTriggerOptions): IdpUserTrigger<IdpUserDeletedArgs>;
+type IdpUserTriggerOptions<K extends IdpUserEventKind[]> = {
+  events: K;
+  /**
+   * IdP namespace name to subscribe to. Required when the project defines
+   * multiple IdPs; optional when a single IdP exists. Must match an IdP name
+   * declared in `defineConfig({ idp: [...] })`.
+   */
+  idp?: IdpName;
+};
+/**
+ * Create a trigger that fires on multiple IdP user event types.
+ * @template K
+ * @param options - Trigger options with events array
+ * @param options.events - IdP user event kinds to subscribe to
+ * @param options.idp - IdP namespace name to subscribe to
+ * @returns IdP user trigger
+ */
+declare function idpUserTrigger<const K extends [IdpUserEventKind, ...IdpUserEventKind[]]>(options: IdpUserTriggerOptions<K>): IdpUserTrigger<IdpUserMultiArgs<K>>;
+declare const authAccessTokenEventMap: {
+  readonly issued: "auth.access_token.issued";
+  readonly refreshed: "auth.access_token.refreshed";
+  readonly revoked: "auth.access_token.revoked";
+};
+type AuthAccessTokenEventMap = typeof authAccessTokenEventMap;
+type AuthAccessTokenEventKind = keyof AuthAccessTokenEventMap;
+type AuthAccessTokenArgsMap = {
+  issued: AuthAccessTokenIssuedArgs;
+  refreshed: AuthAccessTokenRefreshedArgs;
+  revoked: AuthAccessTokenRevokedArgs;
+};
+type AuthAccessTokenMultiArgs<K extends AuthAccessTokenEventKind[]> = AuthAccessTokenArgsMap[K[number]];
+type AuthAccessTokenTrigger<Args> = AuthAccessTokenTrigger$1 & {
+  __args: Args;
+};
+/**
+ * Create a trigger that fires when an access token is issued.
+ * @returns Auth access token issued trigger
+ */
+declare function authAccessTokenIssuedTrigger(): AuthAccessTokenTrigger<AuthAccessTokenIssuedArgs>;
+/**
+ * Create a trigger that fires when an access token is refreshed.
+ * @returns Auth access token refreshed trigger
+ */
+declare function authAccessTokenRefreshedTrigger(): AuthAccessTokenTrigger<AuthAccessTokenRefreshedArgs>;
+/**
+ * Create a trigger that fires when an access token is revoked.
+ * @returns Auth access token revoked trigger
+ */
+declare function authAccessTokenRevokedTrigger(): AuthAccessTokenTrigger<AuthAccessTokenRevokedArgs>;
+type AuthAccessTokenTriggerOptions<K extends AuthAccessTokenEventKind[]> = {
+  events: K;
+};
+/**
+ * Create a trigger that fires on multiple auth access token event types.
+ * @template K
+ * @param options - Trigger options with events array
+ * @returns Auth access token trigger
+ */
+declare function authAccessTokenTrigger<const K extends [AuthAccessTokenEventKind, ...AuthAccessTokenEventKind[]]>(options: AuthAccessTokenTriggerOptions<K>): AuthAccessTokenTrigger<AuthAccessTokenMultiArgs<K>>;
+//#endregion
+export { AuthAccessTokenArgs, AuthAccessTokenIssuedArgs, AuthAccessTokenRefreshedArgs, AuthAccessTokenRevokedArgs, AuthAccessTokenTrigger, IdpUserArgs, IdpUserCreatedArgs, IdpUserDeletedArgs, IdpUserTrigger, IdpUserUpdatedArgs, RecordCreatedArgs, RecordDeletedArgs, RecordUpdatedArgs, ResolverExecutedArgs, ResolverExecutedTrigger, TailorDBTrigger, authAccessTokenIssuedTrigger, authAccessTokenRefreshedTrigger, authAccessTokenRevokedTrigger, authAccessTokenTrigger, idpUserCreatedTrigger, idpUserDeletedTrigger, idpUserTrigger, idpUserUpdatedTrigger, recordCreatedTrigger, recordDeletedTrigger, recordTrigger, recordUpdatedTrigger, resolverExecutedTrigger };

package/dist/configure/services/executor/trigger/index.d.mts

@@ -0,0 +1,8 @@
+import { AuthAccessTokenArgs, AuthAccessTokenIssuedArgs, AuthAccessTokenRefreshedArgs, AuthAccessTokenRevokedArgs, AuthAccessTokenTrigger, IdpUserArgs, IdpUserCreatedArgs, IdpUserDeletedArgs, IdpUserTrigger, IdpUserUpdatedArgs, RecordCreatedArgs, RecordDeletedArgs, RecordUpdatedArgs, ResolverExecutedArgs, ResolverExecutedTrigger, TailorDBTrigger, authAccessTokenIssuedTrigger, authAccessTokenRefreshedTrigger, authAccessTokenRevokedTrigger, authAccessTokenTrigger, idpUserCreatedTrigger, idpUserDeletedTrigger, idpUserTrigger, idpUserUpdatedTrigger, recordCreatedTrigger, recordDeletedTrigger, recordTrigger, recordUpdatedTrigger, resolverExecutedTrigger } from "./event.mjs";
+import { ScheduleArgs, ScheduleTrigger, scheduleTrigger } from "./schedule.mjs";
+import { IncomingWebhookArgs, IncomingWebhookRequest, IncomingWebhookResponse, IncomingWebhookResponseConfig, IncomingWebhookTrigger, IncomingWebhookTriggerOptions, incomingWebhookTrigger } from "./webhook.mjs";
+
+//#region src/configure/services/executor/trigger/index.d.ts
+type Trigger<Args> = TailorDBTrigger<Args> | ResolverExecutedTrigger<Args> | ScheduleTrigger<Args> | IncomingWebhookTrigger<Args> | IdpUserTrigger<Args> | AuthAccessTokenTrigger<Args>;
+//#endregion
+export { AuthAccessTokenArgs, AuthAccessTokenIssuedArgs, AuthAccessTokenRefreshedArgs, AuthAccessTokenRevokedArgs, AuthAccessTokenTrigger, IdpUserArgs, IdpUserCreatedArgs, IdpUserDeletedArgs, IdpUserTrigger, IdpUserUpdatedArgs, IncomingWebhookArgs, IncomingWebhookRequest, IncomingWebhookResponse, IncomingWebhookResponseConfig, IncomingWebhookTrigger, IncomingWebhookTriggerOptions, RecordCreatedArgs, RecordDeletedArgs, RecordUpdatedArgs, ResolverExecutedArgs, ResolverExecutedTrigger, ScheduleArgs, ScheduleTrigger, TailorDBTrigger, Trigger, authAccessTokenIssuedTrigger, authAccessTokenRefreshedTrigger, authAccessTokenRevokedTrigger, authAccessTokenTrigger, idpUserCreatedTrigger, idpUserDeletedTrigger, idpUserTrigger, idpUserUpdatedTrigger, incomingWebhookTrigger, recordCreatedTrigger, recordDeletedTrigger, recordTrigger, recordUpdatedTrigger, resolverExecutedTrigger, scheduleTrigger };