@tailor-platform/sdk 2.0.0-next.1 → 2.0.0-next.11

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

@@ -0,0 +1,16 @@
+import { AIGatewayInput } from "../../../types/aigateway.generated.mjs";
+import { AIGatewayConfig, AIGatewayDefinitionBrand } from "./types.mjs";
+//#region src/configure/services/aigateway/index.d.ts
+/**
+ * Define an AI Gateway configuration for the Tailor SDK.
+ * @param name - AI Gateway name
+ * @param config - AI Gateway configuration
+ * @returns Defined AI Gateway
+ */
+declare function defineAIGateway(name: string, config: Omit<AIGatewayInput, "name">): {
+  readonly name: string;
+  readonly cors?: string[] | undefined;
+  readonly authNamespace: string;
+} & AIGatewayDefinitionBrand;
+//#endregion
+export { type AIGatewayConfig, defineAIGateway };

package/dist/configure/services/aigateway/types.d.mts

@@ -0,0 +1,10 @@
+import { AIGatewayInput } from "../../../types/aigateway.generated.mjs";
+//#region src/configure/services/aigateway/types.d.ts
+declare const aiGatewayDefinitionBrand: unique symbol;
+type AIGatewayDefinitionBrand = {
+  readonly [aiGatewayDefinitionBrand]: true;
+};
+/** Type accepted by `AppConfig.aiGateways`. Only values returned by `defineAIGateway()` satisfy this. */
+type AIGatewayConfig = AIGatewayInput & AIGatewayDefinitionBrand;
+//#endregion
+export { AIGatewayConfig, AIGatewayDefinitionBrand };

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

@@ -0,0 +1,33 @@
+import { DefinedFieldMetadata, FieldMetadata, TailorField, TailorFieldType } from "../../types/field.types.mjs";
+import { AuthConnectionConfig, AuthConnectionOAuth2Config } from "../../../types/auth-connection.generated.mjs";
+import { BuiltinIdP, IDToken, IdProvider, OAuth2ClientInput, OIDC, SAML, SCIMAttribute, SCIMAttributeMapping, SCIMAuthorization, SCIMConfig, SCIMResource, TenantProvider } from "../../../types/auth.generated.mjs";
+import { AuthConfig, AuthConnectionTokenResult, AuthExternalConfig, AuthOwnConfig, AuthServiceInput, BeforeLoginClaims, BeforeLoginHookArgs, DefinedAuth, FederatedIdentity, FederatedIdentityClaims, FederatedIdentityProvider, OAuth2ClientGrantType, SCIMAttributeType, UserAttributeKey, UserAttributeListKey, UserAttributes, UsernameFieldKey, ValueOperand } from "./types.mjs";
+import { TailorDBInstance } from "../tailordb/schema.mjs";
+//#region src/configure/services/auth/index.d.ts
+type MachineUserAttributeFields = Record<string, TailorField<DefinedFieldMetadata, unknown, FieldMetadata, TailorFieldType>>;
+type PlaceholderUser = TailorDBInstance<Record<string, never>, Record<string, never>>;
+type PlaceholderAttributes = UserAttributes<PlaceholderUser>;
+type PlaceholderAttributeList = UserAttributeListKey<PlaceholderUser>[];
+type UserProfileAuthInput<User extends TailorDBInstance, Attributes extends UserAttributes<User>, AttributeList extends UserAttributeListKey<User>[], MachineUserNames extends string, ConnectionNames extends string = string> = Omit<AuthServiceInput<User, Attributes, AttributeList, MachineUserNames, undefined, ConnectionNames>, "userProfile" | "machineUserAttributes"> & {
+  userProfile: NonNullable<AuthServiceInput<User, Attributes, AttributeList, MachineUserNames, undefined>["userProfile"]>;
+  machineUserAttributes?: never;
+};
+type MachineUserOnlyAuthInput<MachineUserNames extends string, MachineUserAttributes extends MachineUserAttributeFields, ConnectionNames extends string = string> = Omit<AuthServiceInput<PlaceholderUser, PlaceholderAttributes, PlaceholderAttributeList, MachineUserNames, MachineUserAttributes, ConnectionNames>, "userProfile" | "machineUserAttributes"> & {
+  userProfile?: never;
+  machineUserAttributes: MachineUserAttributes;
+};
+/**
+ * Define an auth service for the Tailor SDK.
+ * @template Name
+ * @template User
+ * @template Attributes
+ * @template AttributeList
+ * @template MachineUserNames
+ * @param name - Auth service name
+ * @param config - Auth service configuration
+ * @returns Defined auth service
+ */
+declare function defineAuth<const Name extends string, const User extends TailorDBInstance, const Attributes extends UserAttributes<User>, const AttributeList extends UserAttributeListKey<User>[], const MachineUserNames extends string, const ConnectionNames extends string = string>(name: Name, config: UserProfileAuthInput<User, Attributes, AttributeList, MachineUserNames, ConnectionNames>): DefinedAuth<Name, UserProfileAuthInput<User, Attributes, AttributeList, MachineUserNames, ConnectionNames>>;
+declare function defineAuth<const Name extends string, const MachineUserAttributes extends MachineUserAttributeFields, const MachineUserNames extends string, const ConnectionNames extends string = string>(name: Name, config: MachineUserOnlyAuthInput<MachineUserNames, MachineUserAttributes, ConnectionNames>): DefinedAuth<Name, MachineUserOnlyAuthInput<MachineUserNames, MachineUserAttributes, ConnectionNames>>;
+//#endregion
+export { type AuthConfig, type AuthConnectionConfig, type AuthConnectionOAuth2Config, type AuthConnectionTokenResult, type AuthExternalConfig, type AuthOwnConfig, type AuthServiceInput, type BeforeLoginClaims, type BeforeLoginHookArgs, type BuiltinIdP, type DefinedAuth, type FederatedIdentity, type FederatedIdentityClaims, type FederatedIdentityProvider, type IDToken, type IdProvider as IdProviderConfig, type OAuth2ClientInput as OAuth2Client, type OAuth2ClientGrantType, type OIDC, type SAML, type SCIMAttribute, type SCIMAttributeMapping, type SCIMAttributeType, type SCIMAuthorization, type SCIMConfig, type SCIMResource, type TenantProvider as TenantProviderConfig, type UserAttributeKey, type UserAttributeListKey, type UserAttributes, type UsernameFieldKey, type ValueOperand, defineAuth };

package/dist/configure/services/auth/types.d.mts

@@ -0,0 +1,168 @@
+import { DefinedFieldMetadata, FieldMetadata, TailorField, TailorFieldType } from "../../types/field.types.mjs";
+import { TailorEnv } from "../../../runtime/types.mjs";
+import { NullableToOptional, output } from "../../../types/helpers.mjs";
+import { TailorDBInstance } from "../tailordb/types.mjs";
+import { AuthConnectionConfig } from "../../../types/auth-connection.generated.mjs";
+import { IdProvider, OAuth2Client, OAuth2ClientInput, SCIMAttribute, SCIMConfig, TenantProvider } from "../../../types/auth.generated.mjs";
+import { IsAny, JsonObject, JsonValue } from "type-fest";
+//#region src/configure/services/auth/types.d.ts
+type OAuth2ClientGrantType = OAuth2Client["grantTypes"][number];
+type SCIMAttributeType = SCIMAttribute["type"];
+interface MachineUserNameRegistry {}
+/**
+ * Machine user name.
+ *
+ * When `tailor.d.ts` is generated (via `tailor deploy`/`generate`), this is narrowed
+ * to the union of defined machine user names. When no machine users are registered yet,
+ * falls back to `string` to avoid blocking editing before the first generate run.
+ */
+type MachineUserName = keyof MachineUserNameRegistry extends never ? string : keyof MachineUserNameRegistry & string;
+/** Result of retrieving a connection token at runtime. */
+type AuthConnectionTokenResult = {
+  access_token: string;
+};
+type ValueOperand = string | boolean | string[] | boolean[];
+type AuthAttributeValue = ValueOperand | null | undefined;
+type UserFieldKeys<User extends TailorDBInstance> = keyof output<User> & string;
+type FieldDefined<User extends TailorDBInstance, Key extends UserFieldKeys<User>> = User["fields"][Key] extends {
+  _defined: infer Defined;
+} ? Defined : never;
+type FieldOutput<User extends TailorDBInstance, Key extends UserFieldKeys<User>> = output<User>[Key];
+type FieldIsRequired<User extends TailorDBInstance, Key extends UserFieldKeys<User>> = undefined extends FieldOutput<User, Key> ? false : true;
+type FieldIsOfType<User extends TailorDBInstance, Key extends UserFieldKeys<User>, Type extends string> = FieldDefined<User, Key> extends {
+  type: Type;
+} ? true : false;
+type FieldIsArray<User extends TailorDBInstance, Key extends UserFieldKeys<User>> = FieldDefined<User, Key> extends {
+  array: true;
+} ? true : false;
+type FieldIsUnique<User extends TailorDBInstance, Key extends UserFieldKeys<User>> = FieldDefined<User, Key> extends {
+  unique: true;
+} ? true : false;
+type FieldSupportsValueOperand<User extends TailorDBInstance, Key extends UserFieldKeys<User>> = FieldOutput<User, Key> extends ValueOperand | null | undefined ? true : false;
+type UsernameFieldKey<User extends TailorDBInstance> = IsAny<User> extends true ? string : { [K in UserFieldKeys<User>]: FieldIsRequired<User, K> extends true ? FieldIsOfType<User, K, "string"> extends true ? FieldIsArray<User, K> extends true ? never : FieldIsUnique<User, K> extends true ? K : never : never : never; }[UserFieldKeys<User>];
+type UserAttributeKey<User extends TailorDBInstance> = { [K in UserFieldKeys<User>]: K extends "id" ? never : FieldSupportsValueOperand<User, K> extends true ? FieldIsOfType<User, K, "datetime" | "date" | "time"> extends true ? never : K : never; }[UserFieldKeys<User>];
+type UserAttributeListKey<User extends TailorDBInstance> = { [K in UserFieldKeys<User>]: K extends "id" ? never : FieldIsOfType<User, K, "uuid"> extends true ? FieldIsArray<User, K> extends true ? never : K : never; }[UserFieldKeys<User>];
+type UserAttributes<User extends TailorDBInstance> = { [K in UserAttributeKey<User>]?: true; };
+type DisallowExtraKeys<T, Allowed extends PropertyKey> = T & { [K in Exclude<keyof T, Allowed>]: never; };
+type AttributeListValue<User extends TailorDBInstance, Key extends UserAttributeListKey<User>> = Key extends keyof output<User> ? output<User>[Key] : never;
+type AttributeListToTuple<User extends TailorDBInstance, AttributeList extends readonly UserAttributeListKey<User>[]> = { [Index in keyof AttributeList]: AttributeList[Index] extends UserAttributeListKey<User> ? AttributeListValue<User, AttributeList[Index]> : never; };
+type SelectedAttributeKeys<User extends TailorDBInstance, Attributes extends UserAttributes<User>> = Extract<{ [K in keyof Attributes]-?: undefined extends Attributes[K] ? never : K; }[keyof Attributes], UserAttributeKey<User>>;
+type UserProfile<User extends TailorDBInstance, Attributes extends UserAttributes<User>, AttributeList extends UserAttributeListKey<User>[]> = {
+  /**
+   * TailorDB namespace where the user type is defined.
+   *
+   * Usually auto-resolved, so you don't need to specify this.
+   * Required only when multiple TailorDBs exist and the type is in an external TailorDB.
+   */
+  namespace?: string;
+  type: User;
+  usernameField: UsernameFieldKey<User>;
+  attributes?: DisallowExtraKeys<Attributes, UserAttributeKey<User>>;
+  attributeList?: AttributeList;
+};
+type MachineUserAttributeFields = Record<string, TailorField<DefinedFieldMetadata, unknown, FieldMetadata, TailorFieldType>>;
+type TailorFieldOutputValue<Field> = Field extends TailorField<DefinedFieldMetadata, infer Output, FieldMetadata, TailorFieldType> ? Output : never;
+type MachineUserAttributeValues<Fields extends MachineUserAttributeFields> = NullableToOptional<{ [K in keyof Fields]: TailorFieldOutputValue<Fields[K]> extends ValueOperand | null | undefined ? TailorFieldOutputValue<Fields[K]> : never; }>;
+type OptionalIfNoRequiredKeys<Attributes> = Record<never, never> extends Attributes ? {
+  attributes?: Attributes;
+} : {
+  attributes: Attributes;
+};
+type MachineUserFromAttributes<Fields extends MachineUserAttributeFields> = (keyof Fields extends never ? {
+  attributes?: never;
+} : OptionalIfNoRequiredKeys<DisallowExtraKeys<MachineUserAttributeValues<Fields>, keyof Fields>>) & {
+  attributeList?: string[];
+};
+type MachineUserProfileAttributes<User extends TailorDBInstance, Attributes extends UserAttributes<User>> = NullableToOptional<{ [K in SelectedAttributeKeys<User, Attributes>]: K extends keyof output<User> ? output<User>[K] : never; }> & { [K in Exclude<keyof output<User>, SelectedAttributeKeys<User, Attributes>>]?: never; };
+type MachineUserFromUserProfile<User extends TailorDBInstance, Attributes extends UserAttributes<User>, AttributeList extends UserAttributeListKey<User>[]> = (SelectedAttributeKeys<User, Attributes> extends never ? {
+  attributes?: never;
+} : OptionalIfNoRequiredKeys<MachineUserProfileAttributes<User, Attributes>>) & ([] extends AttributeList ? {
+  attributeList?: never;
+} : {
+  attributeList: AttributeListToTuple<User, AttributeList>;
+});
+type MachineUser<User extends TailorDBInstance, Attributes extends UserAttributes<User> = UserAttributes<User>, AttributeList extends UserAttributeListKey<User>[] = [], MachineUserAttributes extends MachineUserAttributeFields | undefined = undefined> = IsAny<MachineUserAttributes> extends true ? IsAny<User> extends true ? {
+  attributes?: Record<string, AuthAttributeValue>;
+  attributeList?: string[];
+} : MachineUserFromUserProfile<User, Attributes, AttributeList> : [MachineUserAttributes] extends [MachineUserAttributeFields] ? MachineUserFromAttributes<MachineUserAttributes> : IsAny<User> extends true ? {
+  attributes?: Record<string, AuthAttributeValue>;
+  attributeList?: string[];
+} : MachineUserFromUserProfile<User, Attributes, AttributeList>;
+/** Upstream OAuth provider that federated a login through the Built-in IdP. */
+type FederatedIdentityProvider = "google" | "microsoft";
+/**
+ * Profile claims forwarded from the upstream OAuth provider's ID token.
+ *
+ * Commonly present claims are typed; any other claim the provider issues is
+ * forwarded as-is and reachable through the index signature. Availability
+ * varies by provider (e.g. Microsoft does not issue `picture`).
+ */
+type FederatedIdentityClaims = {
+  name?: string;
+  given_name?: string;
+  family_name?: string;
+  picture?: string;
+  locale?: string;
+  [claim: string]: JsonValue | undefined;
+};
+/**
+ * The upstream identity that federated this login, populated when a user signs
+ * in through a Built-in IdP OAuth provider (Google or Microsoft).
+ *
+ * Available on {@link BeforeLoginClaims.federated_identity}; `undefined` for
+ * password logins.
+ */
+type FederatedIdentity = {
+  provider: FederatedIdentityProvider;
+  claims: FederatedIdentityClaims;
+};
+/**
+ * Token claims passed to the {@link BeforeLoginHook} handler. Carries the IdP's
+ * own claims (e.g. `sub`, `email`) plus, for federated logins, the upstream
+ * provider's profile under {@link BeforeLoginClaims.federated_identity}.
+ */
+type BeforeLoginClaims = JsonObject & {
+  /** Present only for federated (Google/Microsoft) logins; `undefined` for password logins. */
+  federated_identity?: FederatedIdentity;
+};
+type BeforeLoginHookArgs = {
+  claims: BeforeLoginClaims;
+  idpConfigName: string;
+  /** Environment variables defined in `defineConfig({ env })`. */
+  env: TailorEnv;
+};
+type BeforeLoginHook<MachineUserNames extends string> = {
+  handler(args: BeforeLoginHookArgs): Promise<void>;
+  invoker: NoInfer<MachineUserNames>;
+};
+type AuthHooks<MachineUserNames extends string> = {
+  beforeLogin?: BeforeLoginHook<MachineUserNames>;
+};
+type AuthServiceInput<User extends TailorDBInstance, Attributes extends UserAttributes<User>, AttributeList extends UserAttributeListKey<User>[], MachineUserNames extends string, MachineUserAttributes extends MachineUserAttributeFields | undefined = MachineUserAttributeFields | undefined, ConnectionNames extends string = string> = {
+  hooks?: AuthHooks<MachineUserNames>;
+  userProfile?: UserProfile<User, Attributes, AttributeList>;
+  machineUserAttributes?: MachineUserAttributes;
+  machineUsers?: Record<MachineUserNames, MachineUser<User, Attributes, AttributeList, MachineUserAttributes>>;
+  oauth2Clients?: Record<string, OAuth2ClientInput>;
+  idProvider?: IdProvider;
+  scim?: SCIMConfig;
+  tenantProvider?: TenantProvider;
+  connections?: Record<ConnectionNames, AuthConnectionConfig>;
+  publishSessionEvents?: boolean;
+};
+declare const authDefinitionBrand: unique symbol;
+type AuthDefinitionBrand = {
+  readonly [authDefinitionBrand]: true;
+};
+type DefinedAuth<Name extends string, Config> = Config & {
+  name: Name;
+} & AuthDefinitionBrand;
+type AuthExternalConfig = {
+  name: string;
+  external: true;
+};
+type AuthServiceInputLoose = AuthServiceInput<any, any, any, string, any>;
+type AuthOwnConfig = DefinedAuth<string, AuthServiceInputLoose>;
+type AuthConfig = AuthOwnConfig | AuthExternalConfig;
+//#endregion
+export { AuthAttributeValue, AuthConfig, AuthConnectionTokenResult, AuthDefinitionBrand, AuthExternalConfig, AuthHooks, AuthOwnConfig, AuthServiceInput, BeforeLoginClaims, BeforeLoginHook, BeforeLoginHookArgs, DefinedAuth, FederatedIdentity, FederatedIdentityClaims, FederatedIdentityProvider, MachineUserName, MachineUserNameRegistry, OAuth2ClientGrantType, SCIMAttributeType, UserAttributeKey, UserAttributeListKey, UserAttributes, UsernameFieldKey, ValueOperand };

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

@@ -0,0 +1,70 @@
+import { ExecutorInput } from "../../../types/executor.generated.mjs";
+import { Workflow } from "../workflow/workflow.mjs";
+import { Operation, WorkflowOperation } from "./operation.mjs";
+import { Trigger } from "./trigger/index.mjs";
+//#region src/configure/services/executor/executor.d.ts
+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: WorkflowOperation<TriggerArgs<T>, W>;
+} : 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,9 @@
+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, WorkflowExecutionArgs, WorkflowExecutionCompletedArgs, WorkflowExecutionResumedArgs, WorkflowExecutionRetriedArgs, WorkflowExecutionStartedArgs, WorkflowExecutionTrigger, WorkflowExecutionWaitResolvedArgs, WorkflowExecutionWaitStartedArgs, WorkflowJobExecutionArgs, WorkflowJobExecutionCompletedArgs, WorkflowJobExecutionStartedArgs, WorkflowJobExecutionTrigger, WorkflowJobExecutionWaitResolvedArgs, WorkflowJobExecutionWaitStartedArgs, authAccessTokenIssuedTrigger, authAccessTokenRefreshedTrigger, authAccessTokenRevokedTrigger, authAccessTokenTrigger, idpUserCreatedTrigger, idpUserDeletedTrigger, idpUserTrigger, idpUserUpdatedTrigger, recordCreatedTrigger, recordDeletedTrigger, recordTrigger, recordUpdatedTrigger, resolverExecutedTrigger, workflowExecutionCompletedTrigger, workflowExecutionResumedTrigger, workflowExecutionRetriedTrigger, workflowExecutionStartedTrigger, workflowExecutionTrigger, workflowExecutionWaitResolvedTrigger, workflowExecutionWaitStartedTrigger, workflowJobExecutionCompletedTrigger, workflowJobExecutionStartedTrigger, workflowJobExecutionTrigger, workflowJobExecutionWaitResolvedTrigger, workflowJobExecutionWaitStartedTrigger } 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";
+import "./types.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, WorkflowExecutionArgs, WorkflowExecutionCompletedArgs, WorkflowExecutionResumedArgs, WorkflowExecutionRetriedArgs, WorkflowExecutionStartedArgs, WorkflowExecutionTrigger, WorkflowExecutionWaitResolvedArgs, WorkflowExecutionWaitStartedArgs, WorkflowJobExecutionArgs, WorkflowJobExecutionCompletedArgs, WorkflowJobExecutionStartedArgs, WorkflowJobExecutionTrigger, WorkflowJobExecutionWaitResolvedArgs, WorkflowJobExecutionWaitStartedArgs, WorkflowOperation, authAccessTokenIssuedTrigger, authAccessTokenRefreshedTrigger, authAccessTokenRevokedTrigger, authAccessTokenTrigger, createExecutor, idpUserCreatedTrigger, idpUserDeletedTrigger, idpUserTrigger, idpUserUpdatedTrigger, incomingWebhookTrigger, recordCreatedTrigger, recordDeletedTrigger, recordTrigger, recordUpdatedTrigger, resolverExecutedTrigger, scheduleTrigger, workflowExecutionCompletedTrigger, workflowExecutionResumedTrigger, workflowExecutionRetriedTrigger, workflowExecutionStartedTrigger, workflowExecutionTrigger, workflowExecutionWaitResolvedTrigger, workflowExecutionWaitStartedTrigger, workflowJobExecutionCompletedTrigger, workflowJobExecutionStartedTrigger, workflowJobExecutionTrigger, workflowJobExecutionWaitResolvedTrigger, workflowJobExecutionWaitStartedTrigger };

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

@@ -0,0 +1,50 @@
+import { TailorPrincipal } from "../../../runtime/types.mjs";
+import { MachineUserName } from "../auth/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 "../../types/machine-user.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" | "invoker"> & {
+  body: (args: Args & {
+    invoker: TailorPrincipal | null;
+  }) => void | Promise<void>;
+  invoker?: 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" | "invoker"> & {
+  query: UrqlOperationArgs[0];
+  variables?: (args: Args) => UrqlOperationArgs[1];
+  invoker?: 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["start"]>[0];
+type WorkflowArgs<Args, W extends Workflow> = WorkflowInput<W> | ((args: Args) => WorkflowInput<W>);
+type WorkflowArgsProperty<Args, W extends Workflow> = undefined extends WorkflowInput<W> ? {
+  args?: WorkflowArgs<Args, W>;
+} : {
+  args: WorkflowArgs<Args, W>;
+};
+/** Workflow-triggering executor operation. Triggers a workflow in response to an event. */
+type WorkflowOperation<Args, W extends Workflow = Workflow> = Omit<WorkflowOperation$1, "workflowName" | "args" | "invoker"> & {
+  workflow: W;
+  invoker?: MachineUserName;
+} & WorkflowArgsProperty<Args, W>;
+type Operation<Args> = FunctionOperation<Args> | GqlOperation<Args> | WebhookOperation<Args> | WorkflowOperation<Args>;
+//#endregion
+export { FunctionOperation, GqlOperation, Operation, WebhookOperation, WorkflowOperation };