@wix/auto_sdk_fast-gallery_galleries 1.0.1 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,3 +1,5 @@
1
+ import { NonNullablePaths } from '@wix/sdk-types';
2
+
1
3
  /** Gallery is the main entity of GalleryService */
2
4
  interface Gallery {
3
5
  /**
@@ -561,6 +563,71 @@ interface GalleryRemovedFromTrashBinEnvelope {
561
563
  data: GalleryRemovedFromTrashBin;
562
564
  metadata: EventMetadata;
563
565
  }
566
+ /** @permissionScope Fast Gallery Manager
567
+ * @permissionScopeId SCOPE.FAST-GALLERY.MANAGE
568
+ * @permissionId FAST_GALLERY.READ
569
+ * @webhook
570
+ * @eventType wix.fastgallery.gallery.v1.gallery_gallery_removed_from_trash_bin
571
+ * @serviceIdentifier wix.fastgallery.gallery.v1.GalleryService
572
+ * @slug gallery_removed_from_trash_bin
573
+ * @documentationMaturity preview
574
+ */
575
+ declare function onGalleryRemovedFromTrashBin(handler: (event: GalleryRemovedFromTrashBinEnvelope) => void | Promise<void>): void;
576
+ type GalleryNonNullablePaths = `variant`;
577
+ /**
578
+ * Creates a new Gallery
579
+ * @param gallery - Gallery to be created.
580
+ * @public
581
+ * @documentationMaturity preview
582
+ * @requiredField gallery
583
+ * @permissionId FAST_GALLERY.MANAGE
584
+ * @applicableIdentity APP
585
+ * @returns The created Gallery.
586
+ * @fqn wix.fastgallery.gallery.v1.GalleryService.CreateGallery
587
+ */
588
+ declare function createGallery(gallery: Gallery): Promise<NonNullablePaths<Gallery, GalleryNonNullablePaths>>;
589
+ /**
590
+ * Get a Gallery by id
591
+ * @param galleryId - ID of the Gallery to retrieve.
592
+ * @public
593
+ * @documentationMaturity preview
594
+ * @requiredField galleryId
595
+ * @permissionId FAST_GALLERY.READ
596
+ * @applicableIdentity APP
597
+ * @applicableIdentity VISITOR
598
+ * @returns The requested Gallery.
599
+ * @fqn wix.fastgallery.gallery.v1.GalleryService.GetGallery
600
+ */
601
+ declare function getGallery(galleryId: string): Promise<NonNullablePaths<Gallery, GalleryNonNullablePaths>>;
602
+ /**
603
+ * Get a Gallery by draft gallery id
604
+ * @param draftGalleryId - Id of the draftGallery the Gallery originates from
605
+ * @public
606
+ * @documentationMaturity preview
607
+ * @requiredField draftGalleryId
608
+ * @permissionId FAST_GALLERY.READ
609
+ * @applicableIdentity APP
610
+ * @applicableIdentity VISITOR
611
+ * @fqn wix.fastgallery.gallery.v1.GalleryService.GetGalleryByDraftGalleryId
612
+ */
613
+ declare function getGalleryByDraftGalleryId(draftGalleryId: string): Promise<NonNullablePaths<GetGalleryByDraftGalleryIdResponse, {
614
+ [P in GalleryNonNullablePaths]: `gallery.${P}`;
615
+ }[GalleryNonNullablePaths]>>;
616
+ /**
617
+ * Update a Gallery, supports partial update
618
+ * Pass the latest `revision` for a successful update
619
+ * @param _id - Gallery ID.
620
+ * @public
621
+ * @documentationMaturity preview
622
+ * @requiredField _id
623
+ * @requiredField gallery
624
+ * @requiredField gallery.revision
625
+ * @permissionId FAST_GALLERY.MANAGE
626
+ * @applicableIdentity APP
627
+ * @returns Updated Gallery.
628
+ * @fqn wix.fastgallery.gallery.v1.GalleryService.UpdateGallery
629
+ */
630
+ declare function updateGallery(_id: string, gallery: NonNullablePaths<UpdateGallery, `revision`>): Promise<NonNullablePaths<Gallery, GalleryNonNullablePaths>>;
564
631
  interface UpdateGallery {
565
632
  /**
566
633
  * Gallery ID.
@@ -604,6 +671,22 @@ interface UpdateGallery {
604
671
  */
605
672
  variant?: VariantWithLiterals;
606
673
  }
674
+ /**
675
+ * Creates a query to retrieve a list of galleries.
676
+ *
677
+ * The `queryGalleries()` method builds a query to retrieve a list of galleries and returns a `GalleriesQueryBuilder` object.
678
+ *
679
+ * The returned object contains the query definition, which is used to run the query using the `find()` method.
680
+ *
681
+ * You can refine the query by chaining `GalleriesQueryBuilder` methods onto the query. `GalleriesQueryBuilder` methods enable you to filter, sort, and control the results that `queryGalleries()` returns.
682
+ * @public
683
+ * @documentationMaturity preview
684
+ * @permissionId FAST_GALLERY.READ
685
+ * @applicableIdentity APP
686
+ * @applicableIdentity VISITOR
687
+ * @fqn wix.fastgallery.gallery.v1.GalleryService.QueryGalleries
688
+ */
689
+ declare function queryGalleries(): GalleriesQueryBuilder;
607
690
  interface QueryCursorResult {
608
691
  cursors: Cursors;
609
692
  hasNext: () => boolean;
@@ -681,18 +764,97 @@ interface GalleriesQueryBuilder {
681
764
  /** @documentationMaturity preview */
682
765
  find: () => Promise<GalleriesQueryResult>;
683
766
  }
767
+ /**
768
+ * Updates extended fields of a Gallery without incrementing revision
769
+ * @param _id - ID of the entity to update.
770
+ * @param namespace - Identifier for the app whose extended fields are being updated.
771
+ * @public
772
+ * @documentationMaturity preview
773
+ * @requiredField _id
774
+ * @requiredField namespace
775
+ * @requiredField options
776
+ * @requiredField options.namespaceData
777
+ * @permissionId FAST_GALLERY.MANAGE
778
+ * @applicableIdentity APP
779
+ * @fqn wix.fastgallery.gallery.v1.GalleryService.UpdateExtendedFields
780
+ */
781
+ declare function updateExtendedFields(_id: string, namespace: string, options: NonNullablePaths<UpdateExtendedFieldsOptions, `namespaceData`>): Promise<NonNullablePaths<UpdateExtendedFieldsResponse, {
782
+ [P in GalleryNonNullablePaths]: `gallery.${P}`;
783
+ }[GalleryNonNullablePaths]>>;
684
784
  interface UpdateExtendedFieldsOptions {
685
785
  /** Data to update. Structured according to the [schema](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields#json-schema-for-extended-fields) defined when the extended fields were configured. */
686
786
  namespaceData: Record<string, any> | null;
687
787
  }
788
+ /**
789
+ * Create multiple Galleries in a single request. Works synchronously.
790
+ * @param galleries - List of Galleries to be created
791
+ * @public
792
+ * @documentationMaturity preview
793
+ * @requiredField galleries
794
+ * @permissionId FAST_GALLERY.MANAGE
795
+ * @applicableIdentity APP
796
+ * @fqn wix.fastgallery.gallery.v1.GalleryService.BulkCreateGalleries
797
+ */
798
+ declare function bulkCreateGalleries(galleries: Gallery[], options?: BulkCreateGalleriesOptions): Promise<NonNullablePaths<BulkCreateGalleriesResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | {
799
+ [P in GalleryNonNullablePaths]: `results.${number}.item.${P}`;
800
+ }[GalleryNonNullablePaths] | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`>>;
688
801
  interface BulkCreateGalleriesOptions {
689
802
  /** set to `true` if you wish to receive back the created Galleries in the response */
690
803
  returnEntity?: boolean;
691
804
  }
805
+ /**
806
+ * Update multiple Galleries in a single request. Works synchronously.
807
+ * @param galleries - List of Galleries to be updated.
808
+ * @public
809
+ * @documentationMaturity preview
810
+ * @requiredField galleries
811
+ * @requiredField galleries.gallery.revision
812
+ * @permissionId FAST_GALLERY.MANAGE
813
+ * @applicableIdentity APP
814
+ * @fqn wix.fastgallery.gallery.v1.GalleryService.BulkUpdateGalleries
815
+ */
816
+ declare function bulkUpdateGalleries(galleries: NonNullablePaths<MaskedGallery, `gallery.revision`>[], options?: BulkUpdateGalleriesOptions): Promise<NonNullablePaths<BulkUpdateGalleriesResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | {
817
+ [P in GalleryNonNullablePaths]: `results.${number}.item.${P}`;
818
+ }[GalleryNonNullablePaths] | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`>>;
692
819
  interface BulkUpdateGalleriesOptions {
693
820
  /** set to `true` if you wish to receive back the updated Galleries in the response */
694
821
  returnEntity?: boolean;
695
822
  }
823
+ /**
824
+ * Delete multiple Galleries in a single request. Works synchronously.
825
+ * @param galleryIds - Gallery ids to be deleted
826
+ * @public
827
+ * @documentationMaturity preview
828
+ * @requiredField galleryIds
829
+ * @permissionId FAST_GALLERY.MANAGE
830
+ * @applicableIdentity APP
831
+ * @fqn wix.fastgallery.gallery.v1.GalleryService.BulkDeleteGalleries
832
+ */
833
+ declare function bulkDeleteGalleries(galleryIds: string[]): Promise<NonNullablePaths<BulkDeleteGalleriesResponse, `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`>>;
834
+ /**
835
+ * Get a deleted Gallery by id
836
+ * @param galleryId - Id of the deleted Gallery to retrieve
837
+ * @public
838
+ * @documentationMaturity preview
839
+ * @requiredField galleryId
840
+ * @permissionId FAST_GALLERY.MANAGE
841
+ * @applicableIdentity APP
842
+ * @fqn wix.fastgallery.gallery.v1.GalleryService.GetDeletedGallery
843
+ */
844
+ declare function getDeletedGallery(galleryId: string): Promise<NonNullablePaths<GetDeletedGalleryResponse, {
845
+ [P in GalleryNonNullablePaths]: `gallery.${P}`;
846
+ }[GalleryNonNullablePaths]>>;
847
+ /**
848
+ * Get all deleted Galleries, or specific ones specified by ids
849
+ * @public
850
+ * @documentationMaturity preview
851
+ * @permissionId FAST_GALLERY.MANAGE
852
+ * @applicableIdentity APP
853
+ * @fqn wix.fastgallery.gallery.v1.GalleryService.ListDeletedGalleries
854
+ */
855
+ declare function listDeletedGalleries(options?: ListDeletedGalleriesOptions): Promise<NonNullablePaths<ListDeletedGalleriesResponse, {
856
+ [P in GalleryNonNullablePaths]: `galleries.${number}.${P}`;
857
+ }[GalleryNonNullablePaths]>>;
696
858
  interface ListDeletedGalleriesOptions {
697
859
  /** WQL expression */
698
860
  cursorPaging?: CursorPaging;
@@ -703,5 +865,29 @@ interface ListDeletedGalleriesOptions {
703
865
  */
704
866
  galleryIds?: string[];
705
867
  }
868
+ /**
869
+ * Restore a deleted Gallery from the trash bin by id
870
+ * @param galleryId - Id of the deleted Gallery to restore
871
+ * @public
872
+ * @documentationMaturity preview
873
+ * @requiredField galleryId
874
+ * @permissionId FAST_GALLERY.MANAGE
875
+ * @applicableIdentity APP
876
+ * @fqn wix.fastgallery.gallery.v1.GalleryService.RestoreGalleryFromTrashBin
877
+ */
878
+ declare function restoreGalleryFromTrashBin(galleryId: string): Promise<NonNullablePaths<RestoreGalleryFromTrashBinResponse, {
879
+ [P in GalleryNonNullablePaths]: `gallery.${P}`;
880
+ }[GalleryNonNullablePaths]>>;
881
+ /**
882
+ * Permanently delete a Gallery from the trash bin by id
883
+ * @param galleryId - Id of the Gallery to delete permanently
884
+ * @public
885
+ * @documentationMaturity preview
886
+ * @requiredField galleryId
887
+ * @permissionId FAST_GALLERY.MANAGE
888
+ * @applicableIdentity APP
889
+ * @fqn wix.fastgallery.gallery.v1.GalleryService.RemoveGalleryFromTrashBin
890
+ */
891
+ declare function removeGalleryFromTrashBin(galleryId: string): Promise<void>;
706
892
 
707
- export { type RemoveGalleryFromTrashBinResponse as $, type UpdateExtendedFieldsRequest as A, type BulkCreateGalleriesOptions as B, type CreateGalleryRequest as C, type DeleteGalleryRequest as D, type ExtendedFields as E, type BulkCreateGalleriesRequest as F, type Gallery as G, type ApplicationError as H, type ItemMetadata as I, type BulkGalleryResult as J, type BulkActionMetadata as K, type ListDeletedGalleriesOptions as L, type MaskedGallery as M, type BulkUpdateGalleriesRequest as N, type BulkUpdateGalleriesResponseBulkGalleryResult as O, type BulkDeleteGalleriesRequest as P, type QueryGalleriesRequest as Q, type RestoreGalleryFromTrashBinResponse as R, SortOrder as S, type BulkDeleteGalleriesResponseBulkGalleryResult as T, type UpdateGallery as U, Variant as V, WebhookIdentityType as W, type GetDeletedGalleryRequest as X, type ListDeletedGalleriesRequest as Y, type RestoreGalleryFromTrashBinRequest as Z, type RemoveGalleryFromTrashBinRequest as _, type GetGalleryByDraftGalleryIdResponse as a, type DeleteOutdatedGalleryVersionsRequest as a0, type DeleteOutdatedGalleryVersionsResponse as a1, type DomainEvent as a2, type DomainEventBodyOneOf as a3, type EntityCreatedEvent as a4, type RestoreInfo as a5, type EntityUpdatedEvent as a6, type EntityDeletedEvent as a7, type ActionEvent as a8, type MessageEnvelope as a9, type IdentificationData as aa, type IdentificationDataIdOneOf as ab, type BaseEventMetadata as ac, type EventMetadata as ad, type GalleriesQueryResult as ae, type GalleriesQueryBuilder as b, type UpdateExtendedFieldsOptions as c, type UpdateExtendedFieldsResponse as d, type BulkCreateGalleriesResponse as e, type BulkUpdateGalleriesOptions as f, type BulkUpdateGalleriesResponse as g, type BulkDeleteGalleriesResponse as h, type GetDeletedGalleryResponse as i, type ListDeletedGalleriesResponse as j, type GalleryRemovedFromTrashBinEnvelope as k, type GalleryRemovedFromTrashBin as l, type CreateGalleryResponse as m, type GetGalleryRequest as n, type GetGalleryResponse as o, type GetGalleryByDraftGalleryIdRequest as p, type UpdateGalleryRequest as q, type UpdateGalleryResponse as r, type DeleteGalleryResponse as s, type CursorQuery as t, type CursorQueryPagingMethodOneOf as u, type Sorting as v, type CursorPaging as w, type QueryGalleriesResponse as x, type CursorPagingMetadata as y, type Cursors as z };
893
+ export { type ActionEvent, type ApplicationError, type BaseEventMetadata, type BulkActionMetadata, type BulkCreateGalleriesOptions, type BulkCreateGalleriesRequest, type BulkCreateGalleriesResponse, type BulkDeleteGalleriesRequest, type BulkDeleteGalleriesResponse, type BulkDeleteGalleriesResponseBulkGalleryResult, type BulkGalleryResult, type BulkUpdateGalleriesOptions, type BulkUpdateGalleriesRequest, type BulkUpdateGalleriesResponse, type BulkUpdateGalleriesResponseBulkGalleryResult, type CreateGalleryRequest, type CreateGalleryResponse, type CursorPaging, type CursorPagingMetadata, type CursorQuery, type CursorQueryPagingMethodOneOf, type Cursors, type DeleteGalleryRequest, type DeleteGalleryResponse, type DeleteOutdatedGalleryVersionsRequest, type DeleteOutdatedGalleryVersionsResponse, type DomainEvent, type DomainEventBodyOneOf, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type EventMetadata, type ExtendedFields, type GalleriesQueryBuilder, type GalleriesQueryResult, type Gallery, type GalleryRemovedFromTrashBin, type GalleryRemovedFromTrashBinEnvelope, type GetDeletedGalleryRequest, type GetDeletedGalleryResponse, type GetGalleryByDraftGalleryIdRequest, type GetGalleryByDraftGalleryIdResponse, type GetGalleryRequest, type GetGalleryResponse, type IdentificationData, type IdentificationDataIdOneOf, type ItemMetadata, type ListDeletedGalleriesOptions, type ListDeletedGalleriesRequest, type ListDeletedGalleriesResponse, type MaskedGallery, type MessageEnvelope, type QueryGalleriesRequest, type QueryGalleriesResponse, type RemoveGalleryFromTrashBinRequest, type RemoveGalleryFromTrashBinResponse, type RestoreGalleryFromTrashBinRequest, type RestoreGalleryFromTrashBinResponse, type RestoreInfo, SortOrder, type SortOrderWithLiterals, type Sorting, type UpdateExtendedFieldsOptions, type UpdateExtendedFieldsRequest, type UpdateExtendedFieldsResponse, type UpdateGallery, type UpdateGalleryRequest, type UpdateGalleryResponse, Variant, type VariantWithLiterals, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, bulkCreateGalleries, bulkDeleteGalleries, bulkUpdateGalleries, createGallery, getDeletedGallery, getGallery, getGalleryByDraftGalleryId, listDeletedGalleries, onGalleryRemovedFromTrashBin, queryGalleries, removeGalleryFromTrashBin, restoreGalleryFromTrashBin, updateExtendedFields, updateGallery };