@wix/auto_sdk_automations_action-catalog 1.0.31 → 1.0.33

package/build/es/index.typings.d.mts

@@ -334,6 +334,29 @@ interface GetRuntimeActionResponse {
     /** Action Configuration */
     action?: Action;
 }
+interface GetLatestActionRequest {
+    /**
+     * ID of the app that defines the action.
+     * @format GUID
+     */
+    appId: string;
+    /**
+     * Action key.
+     * @minLength 5
+     * @maxLength 50
+     */
+    actionKey: string;
+    /**
+     * Whether to apply translations to the action.
+     *
+     * Default: `false`
+     */
+    translate?: boolean | null;
+}
+interface GetLatestActionResponse {
+    /** The requested action. */
+    action?: Action;
+}
 interface GetActionDynamicInputSchemaRequest {
     /**
      * The App ID of the action's owner.
@@ -881,19 +904,19 @@ declare enum WebhookIdentityType {
 }
 /** @enumType */
 type WebhookIdentityTypeWithLiterals = WebhookIdentityType | 'UNKNOWN' | 'ANONYMOUS_VISITOR' | 'MEMBER' | 'WIX_USER' | 'APP';
-interface AccountDetails {
+interface AccountInfo {
     /**
-     * ID of the account.
+     * ID of the Wix account associated with the event.
      * @format GUID
      */
     accountId?: string | null;
     /**
-     * ID of the parent account.
+     * ID of the parent Wix account. Only included when accountId belongs to a child account.
      * @format GUID
      */
     parentAccountId?: string | null;
     /**
-     * ID of the site, if applicable.
+     * ID of the Wix site associated with the event. Only included when the event is tied to a specific site.
      * @format GUID
      */
     siteId?: string | null;
@@ -1060,6 +1083,39 @@ interface GetRuntimeActionIdentifiers {
     /** Action key */
     actionKey: string;
 }
+/**
+ * Retrieves the latest version of an action by its app ID and action key.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField identifiers
+ * @requiredField identifiers.actionKey
+ * @requiredField identifiers.appId
+ * @permissionId AUTOMATIONS.ACTION_READ
+ * @applicableIdentity APP
+ * @fqn wix.automations.actioncatalog.v1.ActionCatalogService.GetLatestAction
+ */
+declare function getLatestAction(identifiers: NonNullablePaths<GetLatestActionIdentifiers, `actionKey` | `appId`, 2>, options?: GetLatestActionOptions): Promise<NonNullablePaths<GetLatestActionResponse, `action.appId` | `action.actionKey` | `action.implementedMethods.validateConfiguration` | `action.implementedMethods.duplicateInputMapping` | `action.implementedMethods.generateApplicationAutomationInputMapping` | `action.implementedMethods.getQuotaInfo` | `action.implementedMethods.onBeforeSave` | `action.implementedMethods.onReset` | `action.implementedMethods.generateActionInputMappingFromTemplate` | `action.implementedMethods.onRemove` | `action.implementedMethods.getDynamicInputSchema` | `action.implementedMethods.mergeInputMappings` | `action.implementedMethods.getDynamicOutputSchema` | `action.implementedMethods.generateInputMappingFromIntent` | `action.executionType` | `action.interfaceConfiguration.type`, 4>>;
+interface GetLatestActionIdentifiers {
+    /**
+     * ID of the app that defines the action.
+     * @format GUID
+     */
+    appId: string;
+    /**
+     * Action key.
+     * @minLength 5
+     * @maxLength 50
+     */
+    actionKey: string;
+}
+interface GetLatestActionOptions {
+    /**
+     * Whether to apply translations to the action.
+     *
+     * Default: `false`
+     */
+    translate?: boolean | null;
+}
 /**
  * Returns action dynamic schema and ui schema for the given action key and input mapping (action config)
  * @param appId - The App ID of the action's owner.
@@ -1173,4 +1229,4 @@ interface GetActionDynamicOutputSchemaOptions {
  */
 declare function bulkGetActionDynamicOutputSchemas(actionsInputMappings: ActionInputMappings[]): Promise<NonNullablePaths<BulkGetActionDynamicOutputSchemasResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
 
-export { type AccountDetails, type Action, type ActionEvent, type ActionInputMappings, type ActionSpecInfo, type AdditionalInformationRequiredInfo, type ApplicationError, type BulkActionMetadata, type BulkActionOutputSchemaResult, type BulkGetActionDynamicOutputSchemasRequest, type BulkGetActionDynamicOutputSchemasResponse, type CommonCursorPaging, type CommonCursors, type CommonPaging, type CommonPagingMetadataV2, type CommonQueryV2, type CommonQueryV2PagingMethodOneOf, CommonSortOrder, type CommonSortOrderWithLiterals, type CommonSorting, type CopyInputMappingOptions, type CopyInputMappingRequest, type CopyInputMappingResponse, type CreateActionOptions, type CreateActionRequest, type CreateActionResponse, type CursorPaging, type Cursors, type DeleteActionOptions, type DeleteActionRequest, type DeleteActionResponse, type DomainEvent, type DomainEventBodyOneOf, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, ExecutionType, type ExecutionTypeWithLiterals, ExperimentActionType, type ExperimentActionTypeWithLiterals, type FocalPoint, type GenerateInputMappingFromIntentRequest, type GenerateInputMappingFromIntentResponse, type GenerateInputMappingFromIntentResponseStatusInfoOneOf, type GenericOptions, type GetActionDynamicInputSchemaOptions, type GetActionDynamicInputSchemaRequest, type GetActionDynamicInputSchemaResponse, type GetActionDynamicOutputSchemaOptions, type GetActionDynamicOutputSchemaRequest, type GetActionDynamicOutputSchemaResponse, type GetRuntimeActionIdentifiers, type GetRuntimeActionRequest, type GetRuntimeActionResponse, type IdentificationData, type IdentificationDataIdOneOf, type ImplementedMethods, type InputMappingGeneratedInfo, type IntegrationOptions, IntegrationType, type IntegrationTypeWithLiterals, type InterfaceConfiguration, type InterfaceConfigurationOptionsOneOf, type ItemMetadata, type MessageEnvelope, type Metadata, type MigrateComponentToActionRequest, type MigrateComponentToActionResponse, type Paging, type PagingMetadataV2, type QueryActionsRequest, type QueryActionsResponse, type QueryV2, type QueryV2PagingMethodOneOf, type ResolveActionsOptions, type ResolveActionsRequest, type ResolveActionsResponse, type RestoreInfo, type RetryExperimentCreation, SortOrder, type SortOrderWithLiterals, type Sorting, type Source, type SourceOptionsOneOf, SourceType, type SourceTypeWithLiterals, Status, type StatusWithLiterals, Type, type TypeWithLiterals, type UpdateActionOptions, type UpdateActionRequest, type UpdateActionResponse, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, type WidgetComponentOptions, type WixApiOptions, bulkGetActionDynamicOutputSchemas, copyInputMapping, createAction, deleteAction, getActionDynamicInputSchema, getActionDynamicOutputSchema, getRuntimeAction, resolveActions, updateAction };
+export { type AccountInfo, type Action, type ActionEvent, type ActionInputMappings, type ActionSpecInfo, type AdditionalInformationRequiredInfo, type ApplicationError, type BulkActionMetadata, type BulkActionOutputSchemaResult, type BulkGetActionDynamicOutputSchemasRequest, type BulkGetActionDynamicOutputSchemasResponse, type CommonCursorPaging, type CommonCursors, type CommonPaging, type CommonPagingMetadataV2, type CommonQueryV2, type CommonQueryV2PagingMethodOneOf, CommonSortOrder, type CommonSortOrderWithLiterals, type CommonSorting, type CopyInputMappingOptions, type CopyInputMappingRequest, type CopyInputMappingResponse, type CreateActionOptions, type CreateActionRequest, type CreateActionResponse, type CursorPaging, type Cursors, type DeleteActionOptions, type DeleteActionRequest, type DeleteActionResponse, type DomainEvent, type DomainEventBodyOneOf, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, ExecutionType, type ExecutionTypeWithLiterals, ExperimentActionType, type ExperimentActionTypeWithLiterals, type FocalPoint, type GenerateInputMappingFromIntentRequest, type GenerateInputMappingFromIntentResponse, type GenerateInputMappingFromIntentResponseStatusInfoOneOf, type GenericOptions, type GetActionDynamicInputSchemaOptions, type GetActionDynamicInputSchemaRequest, type GetActionDynamicInputSchemaResponse, type GetActionDynamicOutputSchemaOptions, type GetActionDynamicOutputSchemaRequest, type GetActionDynamicOutputSchemaResponse, type GetLatestActionIdentifiers, type GetLatestActionOptions, type GetLatestActionRequest, type GetLatestActionResponse, type GetRuntimeActionIdentifiers, type GetRuntimeActionRequest, type GetRuntimeActionResponse, type IdentificationData, type IdentificationDataIdOneOf, type ImplementedMethods, type InputMappingGeneratedInfo, type IntegrationOptions, IntegrationType, type IntegrationTypeWithLiterals, type InterfaceConfiguration, type InterfaceConfigurationOptionsOneOf, type ItemMetadata, type MessageEnvelope, type Metadata, type MigrateComponentToActionRequest, type MigrateComponentToActionResponse, type Paging, type PagingMetadataV2, type QueryActionsRequest, type QueryActionsResponse, type QueryV2, type QueryV2PagingMethodOneOf, type ResolveActionsOptions, type ResolveActionsRequest, type ResolveActionsResponse, type RestoreInfo, type RetryExperimentCreation, SortOrder, type SortOrderWithLiterals, type Sorting, type Source, type SourceOptionsOneOf, SourceType, type SourceTypeWithLiterals, Status, type StatusWithLiterals, Type, type TypeWithLiterals, type UpdateActionOptions, type UpdateActionRequest, type UpdateActionResponse, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, type WidgetComponentOptions, type WixApiOptions, bulkGetActionDynamicOutputSchemas, copyInputMapping, createAction, deleteAction, getActionDynamicInputSchema, getActionDynamicOutputSchema, getLatestAction, getRuntimeAction, resolveActions, updateAction };

package/build/es/index.typings.mjs

@@ -246,6 +246,44 @@ function getRuntimeAction(payload) {
   }
   return __getRuntimeAction;
 }
+function getLatestAction(payload) {
+  function __getLatestAction({ host }) {
+    const metadata = {
+      entityFqdn: "wix.automations.actioncatalog.v1.action",
+      method: "GET",
+      methodFqn: "wix.automations.actioncatalog.v1.ActionCatalogService.GetLatestAction",
+      packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
+      url: resolveWixAutomationsActioncatalogV1ActionCatalogServiceUrl({
+        protoPath: "/v1/actions/latest/apps/{appId}/keys/{actionKey}",
+        data: payload,
+        host
+      }),
+      params: toURLSearchParams(payload),
+      transformResponse: (payload2) => transformPaths(payload2, [
+        {
+          transformFn: transformRESTTimestampToSDKTimestamp,
+          paths: [
+            { path: "action.createdDate" },
+            { path: "action.updatedDate" },
+            { path: "action.icon.urlExpirationDate" }
+          ]
+        },
+        {
+          transformFn: transformRESTFloatToSDKFloat,
+          paths: [
+            { path: "action.icon.focalPoint.x" },
+            { path: "action.icon.focalPoint.y" }
+          ]
+        }
+      ])
+    };
+    return metadata;
+  }
+  return __getLatestAction;
+}
 function getActionDynamicInputSchema(payload) {
   function __getActionDynamicInputSchema({ host }) {
     const metadata = {
@@ -581,6 +619,44 @@ async function getRuntimeAction2(identifiers) {
     throw transformedError;
   }
 }
+async function getLatestAction2(identifiers, options) {
+  const { httpClient, sideEffects } = arguments[2];
+  const payload = renameKeysFromSDKRequestToRESTRequest({
+    appId: identifiers?.appId,
+    actionKey: identifiers?.actionKey,
+    translate: options?.translate
+  });
+  const reqOpts = getLatestAction(payload);
+  sideEffects?.onSiteCall?.();
+  try {
+    const result = await httpClient.request(reqOpts);
+    sideEffects?.onSuccess?.(result);
+    return renameKeysFromRESTResponseToSDKResponse(
+      transformPaths2(result.data, [
+        {
+          transformFn: transformRESTImageToSDKImage,
+          paths: [{ path: "action.icon" }]
+        }
+      ])
+    );
+  } catch (err) {
+    const transformedError = sdkTransformError(
+      err,
+      {
+        spreadPathsToArguments: {},
+        explicitPathsToArguments: {
+          appId: "$[0].appId",
+          actionKey: "$[0].actionKey",
+          translate: "$[1].translate"
+        },
+        singleArgumentUnchanged: false
+      },
+      ["identifiers", "options"]
+    );
+    sideEffects?.onError?.(err);
+    throw transformedError;
+  }
+}
 async function getActionDynamicInputSchema2(appId, options) {
   const { httpClient, sideEffects } = arguments[2];
   const payload = renameKeysFromSDKRequestToRESTRequest({
@@ -753,6 +829,7 @@ export {
   deleteAction2 as deleteAction,
   getActionDynamicInputSchema2 as getActionDynamicInputSchema,
   getActionDynamicOutputSchema2 as getActionDynamicOutputSchema,
+  getLatestAction2 as getLatestAction,
   getRuntimeAction2 as getRuntimeAction,
   resolveActions2 as resolveActions,
   updateAction2 as updateAction